From b472b56883521f2ced95e9f827efd23fcdbcce29 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Tue, 16 Jan 2024 17:09:24 +0200
Subject: [PATCH 001/273] perf(emqx_cm): use a dedicated pool for channel
 cleanup

This is to isolate channels cleanup from other async tasks (like routes cleanup),
as channels cleanup can be quite slow under high network latency conditions.

Fixes: EMQX-11743
---
 apps/emqx/include/emqx_cm.hrl    |  2 +
 apps/emqx/src/emqx_cm.erl        |  6 ++-
 apps/emqx/src/emqx_cm_sup.erl    |  4 ++
 apps/emqx/src/emqx_pool.erl      | 64 +++++++++++++++++++++++---------
 apps/emqx/test/emqx_cm_SUITE.erl | 10 +++--
 changes/ce/perf-12336.en.md      |  2 +
 6 files changed, 66 insertions(+), 22 deletions(-)
 create mode 100644 changes/ce/perf-12336.en.md

diff --git a/apps/emqx/include/emqx_cm.hrl b/apps/emqx/include/emqx_cm.hrl
index ae70f131f..6478a6162 100644
--- a/apps/emqx/include/emqx_cm.hrl
+++ b/apps/emqx/include/emqx_cm.hrl
@@ -30,4 +30,6 @@
 -define(T_GET_INFO, 5_000).
 -define(T_TAKEOVER, 15_000).
 
+-define(CM_POOL, emqx_cm_pool).
+
 -endif.
diff --git a/apps/emqx/src/emqx_cm.erl b/apps/emqx/src/emqx_cm.erl
index 660ac3cfe..2e6714e7f 100644
--- a/apps/emqx/src/emqx_cm.erl
+++ b/apps/emqx/src/emqx_cm.erl
@@ -670,7 +670,11 @@ handle_info({'DOWN', _MRef, process, Pid, _Reason}, State = #{chan_pmon := PMon}
     ChanPids = [Pid | emqx_utils:drain_down(BatchSize)],
     {Items, PMon1} = emqx_pmon:erase_all(ChanPids, PMon),
     lists:foreach(fun mark_channel_disconnected/1, ChanPids),
-    ok = emqx_pool:async_submit(fun lists:foreach/2, [fun ?MODULE:clean_down/1, Items]),
+    ok = emqx_pool:async_submit_to_pool(
+        ?CM_POOL,
+        fun lists:foreach/2,
+        [fun ?MODULE:clean_down/1, Items]
+    ),
     {noreply, State#{chan_pmon := PMon1}};
 handle_info(Info, State) ->
     ?SLOG(error, #{msg => "unexpected_info", info => Info}),
diff --git a/apps/emqx/src/emqx_cm_sup.erl b/apps/emqx/src/emqx_cm_sup.erl
index e7420b4da..622921f1d 100644
--- a/apps/emqx/src/emqx_cm_sup.erl
+++ b/apps/emqx/src/emqx_cm_sup.erl
@@ -25,6 +25,8 @@
 %% for test
 -export([restart_flapping/0]).
 
+-include("emqx_cm.hrl").
+
 %%--------------------------------------------------------------------
 %% API
 %%--------------------------------------------------------------------
@@ -45,6 +47,7 @@ init([]) ->
     Banned = child_spec(emqx_banned, 1000, worker),
     Flapping = child_spec(emqx_flapping, 1000, worker),
     Locker = child_spec(emqx_cm_locker, 5000, worker),
+    CmPool = emqx_pool_sup:spec(emqx_cm_pool_sup, [?CM_POOL, random, {emqx_pool, start_link, []}]),
     Registry = child_spec(emqx_cm_registry, 5000, worker),
     Manager = child_spec(emqx_cm, 5000, worker),
     DSSessionGCSup = child_spec(emqx_persistent_session_ds_sup, infinity, supervisor),
@@ -53,6 +56,7 @@ init([]) ->
             Banned,
             Flapping,
             Locker,
+            CmPool,
             Registry,
             Manager,
             DSSessionGCSup
diff --git a/apps/emqx/src/emqx_pool.erl b/apps/emqx/src/emqx_pool.erl
index 1cb5f429c..39c585133 100644
--- a/apps/emqx/src/emqx_pool.erl
+++ b/apps/emqx/src/emqx_pool.erl
@@ -28,11 +28,15 @@
     submit/1,
     submit/2,
     async_submit/1,
-    async_submit/2
+    async_submit/2,
+    submit_to_pool/2,
+    submit_to_pool/3,
+    async_submit_to_pool/2,
+    async_submit_to_pool/3
 ]).
 
 -ifdef(TEST).
--export([worker/0, flush_async_tasks/0]).
+-export([worker/0, flush_async_tasks/0, flush_async_tasks/1]).
 -endif.
 
 %% gen_server callbacks
@@ -57,7 +61,7 @@
 -spec start_link(atom(), pos_integer()) -> startlink_ret().
 start_link(Pool, Id) ->
     gen_server:start_link(
-        {local, emqx_utils:proc_name(?MODULE, Id)},
+        {local, emqx_utils:proc_name(Pool, Id)},
         ?MODULE,
         [Pool, Id],
         [{hibernate_after, 1000}]
@@ -66,32 +70,48 @@ start_link(Pool, Id) ->
 %% @doc Submit work to the pool.
 -spec submit(task()) -> any().
 submit(Task) ->
-    call({submit, Task}).
+    submit_to_pool(?POOL, Task).
 
 -spec submit(fun(), list(any())) -> any().
 submit(Fun, Args) ->
-    call({submit, {Fun, Args}}).
-
-%% @private
-call(Req) ->
-    gen_server:call(worker(), Req, infinity).
+    submit_to_pool(?POOL, Fun, Args).
 
 %% @doc Submit work to the pool asynchronously.
 -spec async_submit(task()) -> ok.
 async_submit(Task) ->
-    cast({async_submit, Task}).
+    async_submit_to_pool(?POOL, Task).
 
 -spec async_submit(fun(), list(any())) -> ok.
 async_submit(Fun, Args) ->
-    cast({async_submit, {Fun, Args}}).
+    async_submit_to_pool(?POOL, Fun, Args).
+
+-spec submit_to_pool(any(), task()) -> any().
+submit_to_pool(Pool, Task) ->
+    call(Pool, {submit, Task}).
+
+-spec submit_to_pool(any(), fun(), list(any())) -> any().
+submit_to_pool(Pool, Fun, Args) ->
+    call(Pool, {submit, {Fun, Args}}).
+
+-spec async_submit_to_pool(any(), task()) -> ok.
+async_submit_to_pool(Pool, Task) ->
+    cast(Pool, {async_submit, Task}).
+
+-spec async_submit_to_pool(any(), fun(), list(any())) -> ok.
+async_submit_to_pool(Pool, Fun, Args) ->
+    cast(Pool, {async_submit, {Fun, Args}}).
 
 %% @private
-cast(Msg) ->
-    gen_server:cast(worker(), Msg).
+call(Pool, Req) ->
+    gen_server:call(worker(Pool), Req, infinity).
 
 %% @private
-worker() ->
-    gproc_pool:pick_worker(?POOL).
+cast(Pool, Msg) ->
+    gen_server:cast(worker(Pool), Msg).
+
+%% @private
+worker(Pool) ->
+    gproc_pool:pick_worker(Pool).
 
 %%--------------------------------------------------------------------
 %% gen_server callbacks
@@ -146,15 +166,25 @@ run(Fun) when is_function(Fun) ->
     Fun().
 
 -ifdef(TEST).
+
+worker() ->
+    worker(?POOL).
+
+flush_async_tasks() ->
+    flush_async_tasks(?POOL).
+
 %% This help function creates a large enough number of async tasks
 %% to force flush the pool workers.
 %% The number of tasks should be large enough to ensure all workers have
 %% the chance to work on at least one of the tasks.
-flush_async_tasks() ->
+flush_async_tasks(Pool) ->
     Ref = make_ref(),
     Self = self(),
     L = lists:seq(1, 997),
-    lists:foreach(fun(I) -> emqx_pool:async_submit(fun() -> Self ! {done, Ref, I} end, []) end, L),
+    lists:foreach(
+        fun(I) -> emqx_pool:async_submit_to_pool(Pool, fun() -> Self ! {done, Ref, I} end, []) end,
+        L
+    ),
     lists:foreach(
         fun(I) ->
             receive
diff --git a/apps/emqx/test/emqx_cm_SUITE.erl b/apps/emqx/test/emqx_cm_SUITE.erl
index 4ecea9a4b..e175b4349 100644
--- a/apps/emqx/test/emqx_cm_SUITE.erl
+++ b/apps/emqx/test/emqx_cm_SUITE.erl
@@ -221,7 +221,7 @@ t_open_session_race_condition(_) ->
     end,
     %% sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = emqx_pool:flush_async_tasks(),
+    ok = emqx_pool:flush_async_tasks(?CM_POOL),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
 t_kick_session_discard_normal(_) ->
@@ -343,7 +343,7 @@ test_stepdown_session(Action, Reason) ->
     end,
     % sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = flush_emqx_pool(),
+    ok = flush_emqx_cm_pool(),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
 %% Channel deregistration is delegated to emqx_pool as a sync tasks.
@@ -353,10 +353,12 @@ test_stepdown_session(Action, Reason) ->
 %% to sync with the pool workers.
 %% The number of tasks should be large enough to ensure all workers have
 %% the chance to work on at least one of the tasks.
-flush_emqx_pool() ->
+flush_emqx_cm_pool() ->
     Self = self(),
     L = lists:seq(1, 1000),
-    lists:foreach(fun(I) -> emqx_pool:async_submit(fun() -> Self ! {done, I} end, []) end, L),
+    lists:foreach(
+        fun(I) -> emqx_pool:async_submit_to_pool(?CM_POOL, fun() -> Self ! {done, I} end, []) end, L
+    ),
     lists:foreach(
         fun(I) ->
             receive
diff --git a/changes/ce/perf-12336.en.md b/changes/ce/perf-12336.en.md
new file mode 100644
index 000000000..5c385e6b6
--- /dev/null
+++ b/changes/ce/perf-12336.en.md
@@ -0,0 +1,2 @@
+Isolate channels cleanup from other async tasks (like routes cleanup) by using a dedicated pool,
+as this task can be quite slow under high network latency conditions.

From 80e82db28249544df5f4e720a66014e0fc47f983 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Tue, 16 Jan 2024 19:42:37 +0200
Subject: [PATCH 002/273] test(emqx_cm_SUITE): use one helper function:
 `emqx_pool:flush_async_tasks/1`

---
 apps/emqx/test/emqx_cm_SUITE.erl | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/apps/emqx/test/emqx_cm_SUITE.erl b/apps/emqx/test/emqx_cm_SUITE.erl
index e175b4349..aba4bc744 100644
--- a/apps/emqx/test/emqx_cm_SUITE.erl
+++ b/apps/emqx/test/emqx_cm_SUITE.erl
@@ -343,31 +343,9 @@ test_stepdown_session(Action, Reason) ->
     end,
     % sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = flush_emqx_cm_pool(),
+    ok = emqx_pool:flush_async_tasks(?CM_POOL),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
-%% Channel deregistration is delegated to emqx_pool as a sync tasks.
-%% The emqx_pool is pool of workers, and there is no way to know
-%% which worker was picked for the last deregistration task.
-%% This help function creates a large enough number of async tasks
-%% to sync with the pool workers.
-%% The number of tasks should be large enough to ensure all workers have
-%% the chance to work on at least one of the tasks.
-flush_emqx_cm_pool() ->
-    Self = self(),
-    L = lists:seq(1, 1000),
-    lists:foreach(
-        fun(I) -> emqx_pool:async_submit_to_pool(?CM_POOL, fun() -> Self ! {done, I} end, []) end, L
-    ),
-    lists:foreach(
-        fun(I) ->
-            receive
-                {done, I} -> ok
-            end
-        end,
-        L
-    ).
-
 t_discard_session_race(_) ->
     ClientId = rand_client_id(),
     ?check_trace(

From 6a0c54b40e15a7e99c7a67ae6448c54b9e254859 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 16 Jan 2024 17:31:28 -0300
Subject: [PATCH 003/273] ci(dev): add `.git/` to `.gitignore`

For some reason, some tools like [ripgrep](https://github.com/BurntSushi/ripgrep) will
search `.git` when using the `-.`/`--hidden` flag, even when not using `--no-ignore-vcs`.
This leads to several unwanted results.
---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 0a76c3807..7068c1c7d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -73,3 +73,4 @@ apps/emqx_conf/etc/emqx.conf.all.rendered*
 rebar-git-cache.tar
 # build docker image locally
 .docker_image_tag
+.git/

From 0a0bf3123bfbd97cc473f95feb8a97808d3f9a07 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 17 Jan 2024 15:18:03 +0100
Subject: [PATCH 004/273] ci: bump actions versions

---
 .github/actions/package-macos/action.yaml    |  2 +-
 .github/workflows/_pr_entrypoint.yaml        |  2 +-
 .github/workflows/_push-entrypoint.yaml      |  2 +-
 .github/workflows/build_docker_for_test.yaml |  2 +-
 .github/workflows/build_packages.yaml        |  2 +-
 .github/workflows/build_packages_cron.yaml   |  4 ++--
 .github/workflows/build_slim_packages.yaml   |  6 +++---
 .github/workflows/check_deps_integrity.yaml  |  2 +-
 .github/workflows/performance_test.yaml      | 18 +++++++++---------
 .github/workflows/run_conf_tests.yaml        |  2 +-
 .github/workflows/run_emqx_app_tests.yaml    |  2 +-
 .github/workflows/run_jmeter_tests.yaml      | 14 +++++++-------
 .github/workflows/run_relup_tests.yaml       |  4 ++--
 .github/workflows/run_test_cases.yaml        | 10 +++++-----
 .github/workflows/scorecard.yaml             |  2 +-
 .github/workflows/static_checks.yaml         |  2 +-
 16 files changed, 38 insertions(+), 38 deletions(-)

diff --git a/.github/actions/package-macos/action.yaml b/.github/actions/package-macos/action.yaml
index bae335cf0..64d179b46 100644
--- a/.github/actions/package-macos/action.yaml
+++ b/.github/actions/package-macos/action.yaml
@@ -51,7 +51,7 @@ runs:
             echo "SELF_HOSTED=false" >> $GITHUB_OUTPUT
             ;;
         esac
-    - uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+    - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
       id: cache
       if: steps.prepare.outputs.SELF_HOSTED != 'true'
       with:
diff --git a/.github/workflows/_pr_entrypoint.yaml b/.github/workflows/_pr_entrypoint.yaml
index 86e676ebe..1f7e8e466 100644
--- a/.github/workflows/_pr_entrypoint.yaml
+++ b/.github/workflows/_pr_entrypoint.yaml
@@ -144,7 +144,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index 1e0dd941b..a6d0e178e 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -152,7 +152,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/build_docker_for_test.yaml b/.github/workflows/build_docker_for_test.yaml
index ccff642f9..25adea083 100644
--- a/.github/workflows/build_docker_for_test.yaml
+++ b/.github/workflows/build_docker_for_test.yaml
@@ -57,7 +57,7 @@ jobs:
       - name: export docker image
         run: |
           docker save $EMQX_IMAGE_TAG | gzip > $EMQX_NAME-docker-$PKG_VSN.tar.gz
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: "${{ env.EMQX_NAME }}-docker"
           path: "${{ env.EMQX_NAME }}-docker-${{ env.PKG_VSN }}.tar.gz"
diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index 3382bbeed..abde2672e 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -95,7 +95,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: ${{ matrix.profile }}-${{ matrix.otp }}-${{ matrix.os }}
diff --git a/.github/workflows/build_packages_cron.yaml b/.github/workflows/build_packages_cron.yaml
index 56d5c37f2..5e90be8c4 100644
--- a/.github/workflows/build_packages_cron.yaml
+++ b/.github/workflows/build_packages_cron.yaml
@@ -66,7 +66,7 @@ jobs:
           set -eu
           ./scripts/pkg-tests.sh "${PROFILE}-tgz"
           ./scripts/pkg-tests.sh "${PROFILE}-pkg"
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: success()
         with:
           name: ${{ matrix.profile[0] }}-${{ matrix.os }}
@@ -111,7 +111,7 @@ jobs:
           apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
           apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
           apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: success()
         with:
           name: ${{ matrix.profile }}-${{ matrix.os }}
diff --git a/.github/workflows/build_slim_packages.yaml b/.github/workflows/build_slim_packages.yaml
index 4b9ca76b9..45dee2b3d 100644
--- a/.github/workflows/build_slim_packages.yaml
+++ b/.github/workflows/build_slim_packages.yaml
@@ -88,13 +88,13 @@ jobs:
       run: |
         make ${EMQX_NAME}-elixir-pkg
         ./scripts/pkg-tests.sh ${EMQX_NAME}-elixir-pkg
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: "${{ matrix.profile[0] }}-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: _packages/${{ matrix.profile[0] }}/*
         retention-days: 7
         compression-level: 0
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: "${{ matrix.profile[0] }}-schema-dump-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: |
@@ -128,7 +128,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: ${{ matrix.os }}
         path: _packages/**/*
diff --git a/.github/workflows/check_deps_integrity.yaml b/.github/workflows/check_deps_integrity.yaml
index 30d788500..cfe6cfbae 100644
--- a/.github/workflows/check_deps_integrity.yaml
+++ b/.github/workflows/check_deps_integrity.yaml
@@ -36,7 +36,7 @@ jobs:
           MIX_ENV: emqx-enterprise
           PROFILE: emqx-enterprise
       - name: Upload produced lock files
-        uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: produced_lock_files
diff --git a/.github/workflows/performance_test.yaml b/.github/workflows/performance_test.yaml
index ede8abf07..629e8fcdb 100644
--- a/.github/workflows/performance_test.yaml
+++ b/.github/workflows/performance_test.yaml
@@ -52,7 +52,7 @@ jobs:
       id: package_file
       run: |
         echo "PACKAGE_FILE=$(find _packages/emqx -name 'emqx-*.deb' | head -n 1 | xargs basename)" >> $GITHUB_OUTPUT
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: emqx-ubuntu20.04
         path: _packages/emqx/${{ steps.package_file.outputs.PACKAGE_FILE }}
@@ -113,13 +113,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -184,13 +184,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -257,13 +257,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -330,13 +330,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
diff --git a/.github/workflows/run_conf_tests.yaml b/.github/workflows/run_conf_tests.yaml
index cac63910b..913f4e5a4 100644
--- a/.github/workflows/run_conf_tests.yaml
+++ b/.github/workflows/run_conf_tests.yaml
@@ -40,7 +40,7 @@ jobs:
         if: failure()
         run: |
           cat _build/${{ matrix.profile }}/rel/emqx/logs/erlang.log.*
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: conftest-logs-${{ matrix.profile }}
diff --git a/.github/workflows/run_emqx_app_tests.yaml b/.github/workflows/run_emqx_app_tests.yaml
index f7c645aeb..e6326b96c 100644
--- a/.github/workflows/run_emqx_app_tests.yaml
+++ b/.github/workflows/run_emqx_app_tests.yaml
@@ -58,7 +58,7 @@ jobs:
         ./rebar3 eunit -v --name 'eunit@127.0.0.1'
         ./rebar3 as standalone_test ct --name 'test@127.0.0.1' -v --readable=true
         ./rebar3 proper -d test/props
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: logs-emqx-app-tests
diff --git a/.github/workflows/run_jmeter_tests.yaml b/.github/workflows/run_jmeter_tests.yaml
index 86cbf220f..14ee999ef 100644
--- a/.github/workflows/run_jmeter_tests.yaml
+++ b/.github/workflows/run_jmeter_tests.yaml
@@ -16,7 +16,7 @@ jobs:
     steps:
     - name: Cache Jmeter
       id: cache-jmeter
-      uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+      uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
       with:
         path: /tmp/apache-jmeter.tgz
         key: apache-jmeter-5.4.3.tgz
@@ -35,7 +35,7 @@ jobs:
         else
           wget --no-verbose --no-check-certificate -O /tmp/apache-jmeter.tgz $ARCHIVE_URL
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: apache-jmeter.tgz
         path: /tmp/apache-jmeter.tgz
@@ -86,7 +86,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-advanced_feat-${{ matrix.scripts_type }}
@@ -153,7 +153,7 @@ jobs:
       if: failure()
       run: |
         docker compose -f .ci/docker-compose-file/docker-compose-emqx-cluster.yaml logs --no-color > ./jmeter_logs/emqx.log
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-pgsql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.pgsql_tag }}
@@ -213,7 +213,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-mysql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.mysql_tag }}
@@ -265,7 +265,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-JWT_authn-${{ matrix.scripts_type }}
@@ -309,7 +309,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-built_in_database_authn_authz-${{ matrix.scripts_type }}
diff --git a/.github/workflows/run_relup_tests.yaml b/.github/workflows/run_relup_tests.yaml
index db8cef69d..b5016d71c 100644
--- a/.github/workflows/run_relup_tests.yaml
+++ b/.github/workflows/run_relup_tests.yaml
@@ -45,7 +45,7 @@ jobs:
       run: |
         export PROFILE='emqx-enterprise'
         make emqx-enterprise-tgz
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       name: Upload built emqx and test scenario
       with:
         name: relup_tests_emqx_built
@@ -111,7 +111,7 @@ jobs:
           docker logs node2.emqx.io | tee lux_logs/emqx2.log
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       name: Save debug data
       if: failure()
       with:
diff --git a/.github/workflows/run_test_cases.yaml b/.github/workflows/run_test_cases.yaml
index 8841c845b..ca478a381 100644
--- a/.github/workflows/run_test_cases.yaml
+++ b/.github/workflows/run_test_cases.yaml
@@ -64,7 +64,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}
         run: make proper
 
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.otp }}
           path: _build/test/cover
@@ -108,7 +108,7 @@ jobs:
           ENABLE_COVER_COMPILE: 1
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: ./scripts/ct/run.sh --ci --app ${{ matrix.app }}
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -116,7 +116,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
@@ -155,7 +155,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: |
           make "${{ matrix.app }}-ct"
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -164,7 +164,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
diff --git a/.github/workflows/scorecard.yaml b/.github/workflows/scorecard.yaml
index f43892d01..aabe4e5b0 100644
--- a/.github/workflows/scorecard.yaml
+++ b/.github/workflows/scorecard.yaml
@@ -40,7 +40,7 @@ jobs:
           publish_results: true
 
       - name: "Upload artifact"
-        uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: SARIF file
           path: results.sarif
diff --git a/.github/workflows/static_checks.yaml b/.github/workflows/static_checks.yaml
index a092210c8..96d3e31e9 100644
--- a/.github/workflows/static_checks.yaml
+++ b/.github/workflows/static_checks.yaml
@@ -37,7 +37,7 @@ jobs:
         run: |
           unzip -o -q ${{ matrix.profile }}.zip
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
-      - uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+      - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
         with:
           path: "emqx_dialyzer_${{ matrix.otp }}_plt"
           key: rebar3-dialyzer-plt-${{ matrix.profile }}-${{ matrix.otp }}-${{ hashFiles('rebar.*', 'apps/*/rebar.*') }}

From 74bf4042c529af52fc2b6bb1563e4afeaa22608a Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Wed, 17 Jan 2024 22:44:51 +0300
Subject: [PATCH 005/273] fix(mqtt_bridge): render valid messages from
 incomplete rule data

---
 .../src/emqx_bridge_mqtt.app.src              |  2 +-
 .../src/emqx_bridge_mqtt_msg.erl              | 23 +++++++++----
 .../test/emqx_bridge_mqtt_SUITE.erl           | 34 +++++++++++++++++++
 changes/ce/fix-12347.en.md                    |  4 +++
 4 files changed, 55 insertions(+), 8 deletions(-)
 create mode 100644 changes/ce/fix-12347.en.md

diff --git a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
index e6fe78ab8..0c00a0d59 100644
--- a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
+++ b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_bridge_mqtt, [
     {description, "EMQX MQTT Broker Bridge"},
-    {vsn, "0.1.7"},
+    {vsn, "0.1.8"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
index 48cae70d7..e09866429 100644
--- a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
+++ b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
@@ -16,6 +16,8 @@
 
 -module(emqx_bridge_mqtt_msg).
 
+-include_lib("emqx/include/emqx_mqtt.hrl").
+
 -export([parse/1]).
 -export([render/2]).
 
@@ -66,8 +68,8 @@ render(
     #{
         topic => render_string(TopicToken, Msg),
         payload => render_payload(Vars, Msg),
-        qos => render_simple_var(QoSToken, Msg),
-        retain => render_simple_var(RetainToken, Msg)
+        qos => render_simple_var(QoSToken, Msg, ?QOS_0),
+        retain => render_simple_var(RetainToken, Msg, false)
     }.
 
 render_payload(From, MapMsg) ->
@@ -80,16 +82,23 @@ do_render_payload(Tks, Msg) ->
 
 %% Replace a string contains vars to another string in which the placeholders are replace by the
 %% corresponding values. For example, given "a: ${var}", if the var=1, the result string will be:
-%% "a: 1".
+%% "a: 1". Undefined vars will be replaced by empty strings.
 render_string(Tokens, Data) when is_list(Tokens) ->
-    emqx_placeholder:proc_tmpl(Tokens, Data, #{return => full_binary});
+    emqx_placeholder:proc_tmpl(Tokens, Data, #{
+        return => full_binary, var_trans => fun undefined_as_empty/1
+    });
 render_string(Val, _Data) ->
     Val.
 
+undefined_as_empty(undefined) ->
+    <<>>;
+undefined_as_empty(Val) ->
+    emqx_utils_conv:bin(Val).
+
 %% Replace a simple var to its value. For example, given "${var}", if the var=1, then the result
 %% value will be an integer 1.
-render_simple_var(Tokens, Data) when is_list(Tokens) ->
+render_simple_var(Tokens, Data, Default) when is_list(Tokens) ->
     [Var] = emqx_placeholder:proc_tmpl(Tokens, Data, #{return => rawlist}),
-    Var;
-render_simple_var(Val, _Data) ->
+    emqx_maybe:define(Var, Default);
+render_simple_var(Val, _Data, _Default) ->
     Val.
diff --git a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
index 6d1ff0915..46788b416 100644
--- a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
+++ b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
@@ -839,6 +839,40 @@ t_egress_mqtt_bridge_with_rules(_) ->
     {ok, 204, <<>>} = request(delete, uri(["rules", RuleId]), []),
     {ok, 204, <<>>} = request(delete, uri(["bridges", BridgeIDEgress]), []).
 
+t_egress_mqtt_bridge_with_dummy_rule(_) ->
+    BridgeIDEgress = create_bridge(
+        ?SERVER_CONF#{
+            <<"name">> => ?BRIDGE_NAME_EGRESS,
+            <<"egress">> => ?EGRESS_CONF
+        }
+    ),
+
+    {ok, 201, Rule} = request(
+        post,
+        uri(["rules"]),
+        #{
+            <<"name">> => <<"A_rule_send_empty_messages_to_a_sink_mqtt_bridge">>,
+            <<"enable">> => true,
+            <<"actions">> => [BridgeIDEgress],
+            %% select something useless from what a message cannot be composed
+            <<"sql">> => <<"SELECT x from \"t/1\"">>
+        }
+    ),
+    #{<<"id">> := RuleId} = emqx_utils_json:decode(Rule),
+
+    %% PUBLISH a message to the rule.
+    Payload = <<"hi">>,
+    RuleTopic = <<"t/1">>,
+    RemoteTopic = <<?EGRESS_REMOTE_TOPIC, "/">>,
+    emqx:subscribe(RemoteTopic),
+    timer:sleep(100),
+    emqx:publish(emqx_message:make(RuleTopic, Payload)),
+    %% we should receive a message on the "remote" broker, with specified topic
+    assert_mqtt_msg_received(RemoteTopic, <<>>),
+
+    {ok, 204, <<>>} = request(delete, uri(["rules", RuleId]), []),
+    {ok, 204, <<>>} = request(delete, uri(["bridges", BridgeIDEgress]), []).
+
 t_mqtt_conn_bridge_egress_reconnect(_) ->
     %% then we add a mqtt connector, using POST
     BridgeIDEgress = create_bridge(
diff --git a/changes/ce/fix-12347.en.md b/changes/ce/fix-12347.en.md
new file mode 100644
index 000000000..b10738192
--- /dev/null
+++ b/changes/ce/fix-12347.en.md
@@ -0,0 +1,4 @@
+Always render valid messages for egress MQTT data bridge from the data fetched by Rule SQL, even if the data is incomplete and placeholders used in the bridge configuration are missing.
+Previously, some messages were rendered as invalid and were discarded by the MQTT egress data bridge.
+
+Render undefined variables as empty strings in `payload` and `topic` templates of the MQTT egress data bridge. Previously, undefined variables were rendered as `undefined` strings.

From 5b064e399f4df29358276fb011c1cf73a6b6c8ac Mon Sep 17 00:00:00 2001
From: JianBo He <heeejianbo@gmail.com>
Date: Thu, 18 Jan 2024 17:29:23 +0800
Subject: [PATCH 006/273] chore: improve http connector logs format

---
 .../src/emqx_bridge_http_connector.erl        | 28 ++++++++++---------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl b/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
index 51375fc04..44c786751 100644
--- a/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
+++ b/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
@@ -251,6 +251,7 @@ start_pool(PoolName, PoolOpts) ->
         {error, {already_started, _}} ->
             ?SLOG(warning, #{
                 msg => "emqx_connector_on_start_already_started",
+                connector => PoolName,
                 pool_name => PoolName
             }),
             ok;
@@ -507,8 +508,8 @@ resolve_pool_worker(#{pool_name := PoolName} = State, Key) ->
 on_get_channels(ResId) ->
     emqx_bridge_v2:get_channels_for_connector(ResId).
 
-on_get_status(_InstId, #{pool_name := PoolName, connect_timeout := Timeout} = State) ->
-    case do_get_status(PoolName, Timeout) of
+on_get_status(InstId, #{pool_name := InstId, connect_timeout := Timeout} = State) ->
+    case do_get_status(InstId, Timeout) of
         ok ->
             connected;
         {error, still_connecting} ->
@@ -524,12 +525,7 @@ do_get_status(PoolName, Timeout) ->
             case ehttpc:health_check(Worker, Timeout) of
                 ok ->
                     ok;
-                {error, Reason} = Error ->
-                    ?SLOG(error, #{
-                        msg => "http_connector_get_status_failed",
-                        reason => redact(Reason),
-                        worker => Worker
-                    }),
+                {error, _} = Error ->
                     Error
             end
         end,
@@ -540,14 +536,20 @@ do_get_status(PoolName, Timeout) ->
             case [E || {error, _} = E <- Results] of
                 [] ->
                     ok;
-                Errors ->
-                    hd(Errors)
+                [{error, Reason} | _] ->
+                    ?SLOG(info, #{
+                        msg => "health_check_failed",
+                        reason => redact(Reason),
+                        connector => PoolName
+                    }),
+                    {error, Reason}
             end
     catch
         exit:timeout ->
-            ?SLOG(error, #{
-                msg => "http_connector_pmap_failed",
-                reason => timeout
+            ?SLOG(info, #{
+                msg => "health_check_failed",
+                reason => timeout,
+                connector => PoolName
             }),
             {error, timeout}
     end.

From 57074015c6f1a1983193ffe382e7dff29386427b Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 16 Jan 2024 17:10:07 -0300
Subject: [PATCH 007/273] feat(ds): allow customizing the data directory

The storage expectations for the RocksDB DB may be different from our usual data
directory.  Also, it may consume a lot more storage than other data.

This allows customizing the data directory for the builtin DS storage backend.

Note: if the cluster was already initialized using a directory path, changing that config
will have no effect.  This path is currently persisted in mnesia and used when reopening
the DB.
---
 apps/emqx/src/emqx_persistent_message.erl     |  8 ++++-
 apps/emqx/src/emqx_schema.erl                 | 30 +++++++++++++++++++
 apps/emqx_conf/src/emqx_conf_schema.erl       | 18 ++---------
 .../src/emqx_ds_storage_layer.erl             | 20 +++++++++----
 4 files changed, 53 insertions(+), 23 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index 295ddd3dc..d725c9b2c 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -61,10 +61,16 @@ force_ds() ->
     emqx_config:get([session_persistence, force_persistence]).
 
 storage_backend(#{
-    builtin := #{enable := true, n_shards := NShards, replication_factor := ReplicationFactor}
+    builtin := #{
+        enable := true,
+        data_dir := DataDir,
+        n_shards := NShards,
+        replication_factor := ReplicationFactor
+    }
 }) ->
     #{
         backend => builtin,
+        data_dir => DataDir,
         storage => {emqx_ds_storage_bitfield_lts, #{}},
         n_shards => NShards,
         replication_factor => ReplicationFactor
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index ae22db14f..7cd67089d 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -94,6 +94,7 @@
     non_empty_string/1,
     validations/0,
     naive_env_interpolation/1,
+    ensure_unicode_path/2,
     validate_server_ssl_opts/1,
     validate_tcp_keepalive/1,
     parse_tcp_keepalive/1
@@ -1882,6 +1883,18 @@ fields("session_storage_backend_builtin") ->
                     default => true
                 }
             )},
+        {"data_dir",
+            sc(
+                string(),
+                #{
+                    desc => ?DESC(session_builtin_data_dir),
+                    default => <<"${EMQX_DATA_DIR}">>,
+                    importance => ?IMPORTANCE_LOW,
+                    converter => fun(Path, Opts) ->
+                        naive_env_interpolation(ensure_unicode_path(Path, Opts))
+                    end
+                }
+            )},
         {"n_shards",
             sc(
                 pos_integer(),
@@ -3836,3 +3849,20 @@ tags_schema() ->
             importance => ?IMPORTANCE_LOW
         }
     ).
+
+ensure_unicode_path(undefined, _) ->
+    undefined;
+ensure_unicode_path(Path, #{make_serializable := true}) ->
+    %% format back to serializable string
+    unicode:characters_to_binary(Path, utf8);
+ensure_unicode_path(Path, Opts) when is_binary(Path) ->
+    case unicode:characters_to_list(Path, utf8) of
+        {R, _, _} when R =:= error orelse R =:= incomplete ->
+            throw({"bad_file_path_string", Path});
+        PathStr ->
+            ensure_unicode_path(PathStr, Opts)
+    end;
+ensure_unicode_path(Path, _) when is_list(Path) ->
+    Path;
+ensure_unicode_path(Path, _) ->
+    throw({"not_string", Path}).
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 6614b24e2..d88a26c1d 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -1430,22 +1430,8 @@ convert_rotation(#{} = Rotation, _Opts) -> maps:get(<<"count">>, Rotation, 10);
 convert_rotation(Count, _Opts) when is_integer(Count) -> Count;
 convert_rotation(Count, _Opts) -> throw({"bad_rotation", Count}).
 
-ensure_unicode_path(undefined, _) ->
-    undefined;
-ensure_unicode_path(Path, #{make_serializable := true}) ->
-    %% format back to serializable string
-    unicode:characters_to_binary(Path, utf8);
-ensure_unicode_path(Path, Opts) when is_binary(Path) ->
-    case unicode:characters_to_list(Path, utf8) of
-        {R, _, _} when R =:= error orelse R =:= incomplete ->
-            throw({"bad_file_path_string", Path});
-        PathStr ->
-            ensure_unicode_path(PathStr, Opts)
-    end;
-ensure_unicode_path(Path, _) when is_list(Path) ->
-    Path;
-ensure_unicode_path(Path, _) ->
-    throw({"not_string", Path}).
+ensure_unicode_path(Path, Opts) ->
+    emqx_schema:ensure_unicode_path(Path, Opts).
 
 log_level() ->
     hoconsc:enum([debug, info, notice, warning, error, critical, alert, emergency, all]).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index ab64005b6..d44235924 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -34,7 +34,7 @@
 -export([start_link/2, init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2]).
 
 %% internal exports:
--export([db_dir/1]).
+-export([db_dir/2]).
 
 -export_type([
     gen_id/0,
@@ -168,7 +168,13 @@ open_shard(Shard, Options) ->
 -spec drop_shard(shard_id()) -> ok.
 drop_shard(Shard) ->
     catch emqx_ds_storage_layer_sup:stop_shard(Shard),
-    ok = rocksdb:destroy(db_dir(Shard), []).
+    case persistent_term:get({?MODULE, Shard, data_dir}, undefined) of
+        undefined ->
+            ok;
+        BaseDir ->
+            ok = rocksdb:destroy(db_dir(BaseDir, Shard), []),
+            persistent_term:erase({?MODULE, Shard, base_dir})
+    end.
 
 -spec store_batch(shard_id(), [emqx_types:message()], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
@@ -424,7 +430,8 @@ rocksdb_open(Shard, Options) ->
         {create_missing_column_families, true}
         | maps:get(db_options, Options, [])
     ],
-    DBDir = db_dir(Shard),
+    DataDir = maps:get(data_dir, Options, emqx:data_dir()),
+    DBDir = db_dir(DataDir, Shard),
     _ = filelib:ensure_dir(DBDir),
     ExistingCFs =
         case rocksdb:list_column_families(DBDir, DBOptions) of
@@ -440,15 +447,16 @@ rocksdb_open(Shard, Options) ->
     ],
     case rocksdb:open(DBDir, DBOptions, ColumnFamilies) of
         {ok, DBHandle, [_CFDefault | CFRefs]} ->
+            persistent_term:put({?MODULE, Shard, data_dir}, DataDir),
             {CFNames, _} = lists:unzip(ExistingCFs),
             {ok, DBHandle, lists:zip(CFNames, CFRefs)};
         Error ->
             Error
     end.
 
--spec db_dir(shard_id()) -> file:filename().
-db_dir({DB, ShardId}) ->
-    filename:join([emqx:data_dir(), atom_to_list(DB), binary_to_list(ShardId)]).
+-spec db_dir(file:filename(), shard_id()) -> file:filename().
+db_dir(BaseDir, {DB, ShardId}) ->
+    filename:join([BaseDir, atom_to_list(DB), binary_to_list(ShardId)]).
 
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->

From 29d767bd625a2430da85ac2ee3dd6c8d18fe0ece Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 16 Jan 2024 14:39:41 +0800
Subject: [PATCH 008/273] ci: add env vars to run cassandra tests locally

---
 .../docker-compose-toxiproxy.yaml             |  4 ++
 .ci/docker-compose-file/toxiproxy.json        | 12 ++++++
 .../test/emqx_bridge_cassandra_SUITE.erl      |  8 ++++
 .../emqx_bridge_cassandra_connector_SUITE.erl | 40 +++++++++++--------
 4 files changed, 47 insertions(+), 17 deletions(-)

diff --git a/.ci/docker-compose-file/docker-compose-toxiproxy.yaml b/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
index d648d9d78..568d9129c 100644
--- a/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
+++ b/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
@@ -39,6 +39,10 @@ services:
       - 19042:9042
       # Cassandra TLS
       - 19142:9142
+      # Cassandra No Auth
+      - 19043:9043
+      # Cassandra TLS No Auth
+      - 19143:9143
       # S3
       - 19000:19000
       # S3 TLS
diff --git a/.ci/docker-compose-file/toxiproxy.json b/.ci/docker-compose-file/toxiproxy.json
index c58474039..103bae924 100644
--- a/.ci/docker-compose-file/toxiproxy.json
+++ b/.ci/docker-compose-file/toxiproxy.json
@@ -96,6 +96,18 @@
     "upstream": "cassandra:9142",
     "enabled": true
   },
+  {
+    "name": "cassa_no_auth_tcp",
+    "listen": "0.0.0.0:9043",
+    "upstream": "cassandra_noauth:9042",
+    "enabled": true
+  },
+  {
+    "name": "cassa_no_auth_tls",
+    "listen": "0.0.0.0:9143",
+    "upstream": "cassandra_noauth:9142",
+    "enabled": true
+  },
   {
     "name": "sqlserver",
     "listen": "0.0.0.0:1433",
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index 9df219296..e0e3900b0 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -11,6 +11,14 @@
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
+%% To run this test locally:
+%%   ./scripts/ct/run.sh --app apps/emqx_bridge_cassandra --only-up
+%%   PROFILE=emqx-enterprise PROXY_HOST=localhost CASSA_TLS_HOST=localhost \
+%%     CASSA_TLS_PORT=19142 CASSA_TCP_HOST=localhost CASSA_TCP_NO_AUTH_HOST=localhost \
+%%     CASSA_TCP_PORT=19042 CASSA_TCP_NO_AUTH_PORT=19043 \
+%%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
+%%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE
+
 % SQL definitions
 -define(SQL_BRIDGE,
     "insert into mqtt_msg_test(topic, payload, arrived) "
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
index de306e3f0..245110de6 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
@@ -14,20 +14,20 @@
 -include_lib("emqx/include/emqx.hrl").
 -include_lib("stdlib/include/assert.hrl").
 
+%% To run this test locally:
+%%   ./scripts/ct/run.sh --app apps/emqx_bridge_cassandra --only-up
+%%   PROFILE=emqx-enterprise PROXY_HOST=localhost CASSA_TLS_HOST=localhost \
+%%     CASSA_TLS_PORT=9142 CASSA_TCP_HOST=localhost CASSA_TCP_NO_AUTH_HOST=localhost \
+%%     CASSA_TCP_PORT=19042 CASSA_TCP_NO_AUTH_PORT=19043 \
+%%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
+%%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE
+
 %% Cassandra servers are defined at `.ci/docker-compose-file/docker-compose-cassandra.yaml`
 %% You can change it to `127.0.0.1`, if you run this SUITE locally
 -define(CASSANDRA_HOST, "cassandra").
 -define(CASSANDRA_HOST_NOAUTH, "cassandra_noauth").
 -define(CASSANDRA_RESOURCE_MOD, emqx_bridge_cassandra_connector).
 
-%% This test SUITE requires a running cassandra instance. If you don't want to
-%% bring up the whole CI infrastuctucture with the `scripts/ct/run.sh` script
-%% you can create a cassandra instance with the following command (execute it
-%% from root of the EMQX directory.). You also need to set ?CASSANDRA_HOST and
-%% ?CASSANDRA_PORT to appropriate values.
-%%
-%% sudo docker run --rm -d --name cassandra --network host cassandra:3.11.14
-
 %% Cassandra default username & password once enable `authenticator: PasswordAuthenticator`
 %% in cassandra config
 -define(CASSA_USERNAME, <<"cassandra">>).
@@ -45,14 +45,14 @@ groups() ->
         {noauth, [t_lifecycle]}
     ].
 
-cassandra_servers(CassandraHost) ->
+cassandra_servers(CassandraHost, CassandraPort) ->
     lists:map(
         fun(#{hostname := Host, port := Port}) ->
             {Host, Port}
         end,
         emqx_schema:parse_servers(
-            iolist_to_binary([CassandraHost, ":", erlang:integer_to_list(?CASSANDRA_DEFAULT_PORT)]),
-            #{default_port => ?CASSANDRA_DEFAULT_PORT}
+            iolist_to_binary([CassandraHost, ":", erlang:integer_to_list(CassandraPort)]),
+            #{default_port => CassandraPort}
         )
     ).
 
@@ -63,25 +63,30 @@ init_per_suite(Config) ->
     Config.
 
 init_per_group(Group, Config) ->
-    {CassandraHost, AuthOpts} =
+    {CassandraHost, CassandraPort, AuthOpts} =
         case Group of
             auth ->
-                {?CASSANDRA_HOST, [{username, ?CASSA_USERNAME}, {password, ?CASSA_PASSWORD}]};
+                TcpHost = os:getenv("CASSA_TCP_HOST", "toxiproxy"),
+                TcpPort = list_to_integer(os:getenv("CASSA_TCP_PORT", "9042")),
+                {TcpHost, TcpPort, [{username, ?CASSA_USERNAME}, {password, ?CASSA_PASSWORD}]};
             noauth ->
-                {?CASSANDRA_HOST_NOAUTH, []}
+                TcpHost = os:getenv("CASSA_TCP_NO_AUTH_HOST", "toxiproxy"),
+                TcpPort = list_to_integer(os:getenv("CASSA_TCP_NO_AUTH_PORT", "9043")),
+                {TcpHost, TcpPort, []}
         end,
-    case emqx_common_test_helpers:is_tcp_server_available(CassandraHost, ?CASSANDRA_DEFAULT_PORT) of
+    case emqx_common_test_helpers:is_tcp_server_available(CassandraHost, CassandraPort) of
         true ->
             %% keyspace `mqtt` must be created in advance
             {ok, Conn} =
                 ecql:connect([
-                    {nodes, cassandra_servers(CassandraHost)},
+                    {nodes, cassandra_servers(CassandraHost, CassandraPort)},
                     {keyspace, "mqtt"}
                     | AuthOpts
                 ]),
             ecql:close(Conn),
             [
                 {cassa_host, CassandraHost},
+                {cassa_port, CassandraPort},
                 {cassa_auth_opts, AuthOpts}
                 | Config
             ];
@@ -212,6 +217,7 @@ create_local_resource(ResourceId, CheckedConfig) ->
 
 cassandra_config(Config) ->
     Host = ?config(cassa_host, Config),
+    Port = ?config(cassa_port, Config),
     AuthOpts = maps:from_list(?config(cassa_auth_opts, Config)),
     CassConfig =
         AuthOpts#{
@@ -223,7 +229,7 @@ cassandra_config(Config) ->
                     "~s:~b",
                     [
                         Host,
-                        ?CASSANDRA_DEFAULT_PORT
+                        Port
                     ]
                 )
             )

From b32c0fb0d8dc210d12e7a4d02a7f4cf798b93dc5 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Fri, 19 Jan 2024 18:46:35 +0800
Subject: [PATCH 009/273] refactor: split cassandra bridges to actions and
 connectors

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_cassandra.app.src         |   4 +-
 .../src/emqx_bridge_cassandra.erl             | 108 ++++++-
 .../src/emqx_bridge_cassandra_action_info.erl |  62 ++++
 .../src/emqx_bridge_cassandra_connector.erl   | 286 ++++++++----------
 .../test/emqx_bridge_cassandra_SUITE.erl      |  21 +-
 .../emqx_bridge_cassandra_connector_SUITE.erl |   4 -
 .../src/schema/emqx_connector_ee_schema.erl   |  12 +
 .../src/schema/emqx_connector_schema.erl      |   2 +
 rel/i18n/emqx_bridge_cassandra.hocon          |  10 +
 .../emqx_bridge_cassandra_connector.hocon     |   6 +
 11 files changed, 332 insertions(+), 184 deletions(-)
 create mode 100644 apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index d80050191..3754677a8 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -92,6 +92,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
         emqx_bridge_influxdb_action_info,
+        emqx_bridge_cassandra_action_info,
         emqx_bridge_mysql_action_info,
         emqx_bridge_pgsql_action_info,
         emqx_bridge_syskeeper_action_info,
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
index 97be100d2..aa8290b98 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_cassandra, [
     {description, "EMQX Enterprise Cassandra Bridge"},
-    {vsn, "0.1.6"},
+    {vsn, "0.2.0"},
     {registered, []},
     {applications, [
         kernel,
@@ -8,7 +8,7 @@
         emqx_resource,
         ecql
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_cassandra_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
index 2724b7c09..83268cab5 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
@@ -12,11 +12,17 @@
 
 %% schema examples
 -export([
-    conn_bridge_examples/1,
     values/2,
     fields/2
 ]).
 
+%% Examples
+-export([
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
+]).
+
 %% schema
 -export([
     namespace/0,
@@ -26,10 +32,13 @@
 ]).
 
 -define(DEFAULT_CQL, <<
-    "insert into mqtt_msg(topic, msgid, sender, qos, payload, arrived, retain) "
-    "values (${topic}, ${id}, ${clientid}, ${qos}, ${payload}, ${timestamp}, ${flags.retain})"
+    "insert into mqtt_msg(msgid, topic, qos, payload, arrived) "
+    "values (${id}, ${topic},  ${qos}, ${payload}, ${timestamp})"
 >>).
 
+-define(CONNECTOR_TYPE, cassandra).
+-define(ACTION_TYPE, cassandra).
+
 %%--------------------------------------------------------------------
 %% schema examples
 
@@ -43,6 +52,41 @@ conn_bridge_examples(Method) ->
         }
     ].
 
+bridge_v2_examples(Method) ->
+    ParamsExample = #{
+        parameters => #{
+            cql => ?DEFAULT_CQL
+        }
+    },
+    [
+        #{
+            <<"cassandra">> => #{
+                summary => <<"Cassandra Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, cassandra, cassandra, ParamsExample
+                )
+            }
+        }
+    ].
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"cassandra">> => #{
+                summary => <<"Cassandra Connector">>,
+                value => emqx_connector_schema:connector_values(
+                    Method, cassandra, #{
+                        servers => <<"127.0.0.1:9042">>,
+                        keyspace => <<"mqtt">>,
+                        username => <<"root">>,
+                        password => <<"******">>,
+                        pool_size => 8
+                    }
+                )
+            }
+        }
+    ].
+
 %% no difference in get/post/put method
 values(_Method, Type) ->
     #{
@@ -73,14 +117,47 @@ namespace() -> "bridge_cassa".
 
 roots() -> [].
 
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        emqx_bridge_cassandra_connector:fields("connector") ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(action) ->
+    {cassandra,
+        mk(
+            hoconsc:map(name, ref(?MODULE, cassandra_action)),
+            #{desc => <<"Cassandra Action Config">>, required => false}
+        )};
+fields(cassandra_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(ref(?MODULE, action_parameters), #{
+            required => true, desc => ?DESC(action_parameters)
+        })
+    );
+fields(action_parameters) ->
+    [
+        cql_field()
+    ];
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    Fields =
+        emqx_bridge_cassandra_connector:fields("connector") ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(cassandra_action));
 fields("config") ->
     [
+        cql_field(),
         {enable, mk(boolean(), #{desc => ?DESC("config_enable"), default => true})},
-        {cql,
-            mk(
-                binary(),
-                #{desc => ?DESC("cql_template"), default => ?DEFAULT_CQL, format => <<"sql">>}
-            )},
         {local_topic,
             mk(
                 binary(),
@@ -99,8 +176,23 @@ fields("get") ->
 fields("post", Type) ->
     [type_field(Type), name_field() | fields("config")].
 
+cql_field() ->
+    {cql,
+        mk(
+            binary(),
+            #{desc => ?DESC("cql_template"), default => ?DEFAULT_CQL, format => <<"sql">>}
+        )}.
+
 desc("config") ->
     ?DESC("desc_config");
+desc(cassandra_action) ->
+    ?DESC(cassandra_action);
+desc(action_parameters) ->
+    ?DESC(action_parameters);
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for Cassandra using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl
new file mode 100644
index 000000000..14db7cf50
--- /dev/null
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl
@@ -0,0 +1,62 @@
+-module(emqx_bridge_cassandra_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    connector_action_config_to_bridge_v1_config/2,
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(SCHEMA_MODULE, emqx_bridge_cassandra).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(cassandra_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ActionTopLevelKeys = schema_keys(cassandra_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ConnectorTopLevelKeys = schema_keys("config_connector"),
+    ConnectorKeys = maps:keys(BridgeV1Config) -- (ActionKeys -- ConnectorTopLevelKeys),
+    ConnConfig0 = maps:with(ConnectorKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        ConnConfig0
+    ).
+
+connector_action_config_to_bridge_v1_config(ConnectorRawConf, ActionRawConf) ->
+    RawConf = emqx_action_info:connector_action_config_to_bridge_v1_config(
+        ConnectorRawConf, ActionRawConf
+    ),
+    maps:without([<<"cassandra_type">>], RawConf).
+
+bridge_v1_type_name() -> cassandra.
+
+action_type_name() -> cassandra.
+
+connector_type_name() -> cassandra.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    [bin(Key) || Key <- proplists:get_keys(?SCHEMA_MODULE:fields(Name))].
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index c6bc7098c..3db71c9e0 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -14,13 +14,17 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 %% schema
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, desc/1]).
 
 %% callbacks of behaviour emqx_resource
 -export([
     callback_mode/0,
     on_start/2,
     on_stop/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channel_status/3,
+    on_get_channels/1,
     on_query/3,
     on_query_async/4,
     on_batch_query/3,
@@ -28,6 +32,8 @@
     on_get_status/2
 ]).
 
+-export([transform_bridge_v1_config_to_connector_config/1]).
+
 %% callbacks of ecpool
 -export([
     connect/1,
@@ -39,16 +45,10 @@
 
 -export([do_get_status/1]).
 
--type prepares() :: #{atom() => binary()}.
--type params_tokens() :: #{atom() => list()}.
-
 -type state() ::
     #{
         pool_name := binary(),
-        prepare_cql := prepares(),
-        params_tokens := params_tokens(),
-        %% returned by ecql:prepare/2
-        prepare_statement := binary()
+        channels := #{}
     }.
 
 -define(DEFAULT_SERVER_OPTION, #{default_port => ?CASSANDRA_DEFAULT_PORT}).
@@ -62,7 +62,9 @@ roots() ->
 fields(config) ->
     cassandra_db_fields() ++
         emqx_connector_schema_lib:ssl_fields() ++
-        emqx_connector_schema_lib:prepare_statement_fields().
+        emqx_connector_schema_lib:prepare_statement_fields();
+fields("connector") ->
+    cassandra_db_fields() ++ emqx_connector_schema_lib:ssl_fields().
 
 cassandra_db_fields() ->
     [
@@ -83,6 +85,11 @@ keyspace(desc) -> ?DESC("keyspace");
 keyspace(required) -> true;
 keyspace(_) -> undefined.
 
+desc(config) ->
+    ?DESC("config");
+desc("connector") ->
+    ?DESC("connector").
+
 %%--------------------------------------------------------------------
 %% callbacks for emqx_resource
 
@@ -130,10 +137,9 @@ on_start(
             false ->
                 []
         end,
-    State = parse_prepare_cql(Config),
     case emqx_resource_pool:start(InstId, ?MODULE, Options ++ SslOpts) of
         ok ->
-            {ok, init_prepare(State#{pool_name => InstId, prepare_statement => #{}})};
+            {ok, #{pool_name => InstId, channels => #{}}};
         {error, Reason} ->
             ?tp(
                 cassandra_connector_start_failed,
@@ -149,23 +155,49 @@ on_stop(InstId, _State) ->
     }),
     emqx_resource_pool:stop(InstId).
 
+on_add_channel(_InstId, #{channels := Channs} = OldState, ChannId, ChannConf0) ->
+    #{parameters := #{cql := CQL}} = ChannConf0,
+    {PrepareCQL, ParamsTokens} = emqx_placeholder:preproc_sql(CQL, '?'),
+    ParsedCql = #{
+        prepare_key => short_prepare_key(ChannId),
+        prepare_cql => PrepareCQL,
+        params_tokens => ParamsTokens
+    },
+    NewChanns = Channs#{ChannId => #{parsed_cql => ParsedCql, prepare_result => not_prepared}},
+    {ok, OldState#{channels => NewChanns}}.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = State, ChannId) ->
+    NewState = State#{channels => maps:remove(ChannId, Channels)},
+    {ok, NewState}.
+
+on_get_channel_status(InstanceId, ChannId, #{channels := Channels, pool_name := PoolName} = State) ->
+    case on_get_status(InstanceId, State) of
+        connected ->
+            #{parsed_cql := ParsedCql} = maps:get(ChannId, Channels),
+            case prepare_cql_to_cassandra(ParsedCql, PoolName) of
+                {ok, _} -> connected;
+                {error, Reason} -> {connecting, Reason}
+            end;
+        _ ->
+            connecting
+    end.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
 -type request() ::
     % emqx_bridge.erl
-    {send_message, Params :: map()}
+    {ChannId :: binary(), Params :: map()}
     % common query
-    | {query, SQL :: binary()}
-    | {query, SQL :: binary(), Params :: map()}.
+    | {query, CQL :: binary()}
+    | {query, CQL :: binary(), Params :: map()}.
 
 -spec on_query(
     emqx_resource:resource_id(),
     request(),
     state()
 ) -> ok | {ok, ecql:cql_result()} | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_query(
-    InstId,
-    Request,
-    State
-) ->
+on_query(InstId, Request, State) ->
     do_single_query(InstId, Request, sync, State).
 
 -spec on_query_async(
@@ -174,21 +206,11 @@ on_query(
     {function(), list()},
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_query_async(
-    InstId,
-    Request,
-    Callback,
-    State
-) ->
+on_query_async(InstId, Request, Callback, State) ->
     do_single_query(InstId, Request, {async, Callback}, State).
 
-do_single_query(
-    InstId,
-    Request,
-    Async,
-    #{pool_name := PoolName} = State
-) ->
-    {Type, PreparedKeyOrSQL, Params} = parse_request_to_cql(Request),
+do_single_query(InstId, Request, Async, #{pool_name := PoolName} = State) ->
+    {Type, PreparedKeyOrCQL, Params} = parse_request_to_cql(Request),
     ?tp(
         debug,
         cassandra_connector_received_cql_query,
@@ -196,12 +218,12 @@ do_single_query(
             connector => InstId,
             type => Type,
             params => Params,
-            prepared_key_or_cql => PreparedKeyOrSQL,
+            prepared_key_or_cql => PreparedKeyOrCQL,
             state => State
         }
     ),
-    {PreparedKeyOrSQL1, Data} = proc_cql_params(Type, PreparedKeyOrSQL, Params, State),
-    Res = exec_cql_query(InstId, PoolName, Type, Async, PreparedKeyOrSQL1, Data),
+    {PreparedKeyOrCQL1, Data} = proc_cql_params(Type, PreparedKeyOrCQL, Params, State),
+    Res = exec_cql_query(InstId, PoolName, Type, Async, PreparedKeyOrCQL1, Data),
     handle_result(Res).
 
 -spec on_batch_query(
@@ -209,11 +231,7 @@ do_single_query(
     [request()],
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_batch_query(
-    InstId,
-    Requests,
-    State
-) ->
+on_batch_query(InstId, Requests, State) ->
     do_batch_query(InstId, Requests, sync, State).
 
 -spec on_batch_query_async(
@@ -222,25 +240,15 @@ on_batch_query(
     {function(), list()},
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_batch_query_async(
-    InstId,
-    Requests,
-    Callback,
-    State
-) ->
+on_batch_query_async(InstId, Requests, Callback, State) ->
     do_batch_query(InstId, Requests, {async, Callback}, State).
 
-do_batch_query(
-    InstId,
-    Requests,
-    Async,
-    #{pool_name := PoolName} = State
-) ->
+do_batch_query(InstId, Requests, Async, #{pool_name := PoolName} = State) ->
     CQLs =
         lists:map(
             fun(Request) ->
-                {Type, PreparedKeyOrSQL, Params} = parse_request_to_cql(Request),
-                proc_cql_params(Type, PreparedKeyOrSQL, Params, State)
+                {Type, PreparedKeyOrCQL, Params} = parse_request_to_cql(Request),
+                proc_cql_params(Type, PreparedKeyOrCQL, Params, State)
             end,
             Requests
         ),
@@ -256,26 +264,24 @@ do_batch_query(
     Res = exec_cql_batch_query(InstId, PoolName, Async, CQLs),
     handle_result(Res).
 
-parse_request_to_cql({send_message, Params}) ->
-    {prepared_query, _Key = send_message, Params};
-parse_request_to_cql({query, SQL}) ->
-    parse_request_to_cql({query, SQL, #{}});
-parse_request_to_cql({query, SQL, Params}) ->
-    {query, SQL, Params}.
+parse_request_to_cql({query, CQL}) ->
+    {query, CQL, #{}};
+parse_request_to_cql({query, CQL, Params}) ->
+    {query, CQL, Params};
+parse_request_to_cql({ChannId, Params}) ->
+    {prepared_query, ChannId, Params}.
 
-proc_cql_params(
-    prepared_query,
-    PreparedKey0,
-    Params,
-    #{prepare_statement := Prepares, params_tokens := ParamsTokens}
-) ->
-    %% assert
-    _PreparedKey = maps:get(PreparedKey0, Prepares),
-    Tokens = maps:get(PreparedKey0, ParamsTokens),
-    {PreparedKey0, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))};
-proc_cql_params(query, SQL, Params, _State) ->
-    {SQL1, Tokens} = emqx_placeholder:preproc_sql(SQL, '?'),
-    {SQL1, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))}.
+proc_cql_params(prepared_query, ChannId, Params, #{channels := Channs}) ->
+    #{
+        parsed_cql := #{
+            prepare_key := PrepareKey,
+            params_tokens := ParamsTokens
+        }
+    } = maps:get(ChannId, Channs),
+    {PrepareKey, assign_type_for_params(emqx_placeholder:proc_sql(ParamsTokens, Params))};
+proc_cql_params(query, CQL, Params, _State) ->
+    {CQL1, Tokens} = emqx_placeholder:preproc_sql(CQL, '?'),
+    {CQL1, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))}.
 
 exec_cql_query(InstId, PoolName, Type, Async, PreparedKey, Data) when
     Type == query; Type == prepared_query
@@ -314,38 +320,15 @@ exec_cql_batch_query(InstId, PoolName, Async, CQLs) ->
 exec(PoolName, Query) ->
     ecpool:pick_and_do(PoolName, Query, no_handover).
 
-on_get_status(_InstId, #{pool_name := PoolName} = State) ->
+on_get_status(_InstId, #{pool_name := PoolName}) ->
     case emqx_resource_pool:health_check_workers(PoolName, fun ?MODULE:do_get_status/1) of
-        true ->
-            case do_check_prepares(State) of
-                ok ->
-                    connected;
-                {ok, NState} ->
-                    %% return new state with prepared statements
-                    {connected, NState};
-                false ->
-                    %% do not log error, it is logged in prepare_cql_to_conn
-                    connecting
-            end;
-        false ->
-            connecting
+        true -> connected;
+        false -> connecting
     end.
 
 do_get_status(Conn) ->
     ok == element(1, ecql:query(Conn, "SELECT cluster_name FROM system.local")).
 
-do_check_prepares(#{prepare_cql := Prepares}) when is_map(Prepares) ->
-    ok;
-do_check_prepares(State = #{pool_name := PoolName, prepare_cql := {error, Prepares}}) ->
-    %% retry to prepare
-    case prepare_cql(Prepares, PoolName) of
-        {ok, Sts} ->
-            %% remove the error
-            {ok, State#{prepare_cql => Prepares, prepare_statement := Sts}};
-        _Error ->
-            false
-    end.
-
 %%--------------------------------------------------------------------
 %% callbacks query
 
@@ -394,88 +377,50 @@ conn_opts([Opt | Opts], Acc) ->
 
 %%--------------------------------------------------------------------
 %% prepare
-
-%% XXX: hardcode
-%% note: the `cql` param is passed by emqx_bridge_cassandra
-parse_prepare_cql(#{cql := SQL}) ->
-    parse_prepare_cql([{send_message, SQL}], #{}, #{});
-parse_prepare_cql(_) ->
-    #{prepare_cql => #{}, params_tokens => #{}}.
-
-parse_prepare_cql([{Key, H} | T], Prepares, Tokens) ->
-    {PrepareSQL, ParamsTokens} = emqx_placeholder:preproc_sql(H, '?'),
-    parse_prepare_cql(
-        T, Prepares#{Key => PrepareSQL}, Tokens#{Key => ParamsTokens}
-    );
-parse_prepare_cql([], Prepares, Tokens) ->
-    #{
-        prepare_cql => Prepares,
-        params_tokens => Tokens
-    }.
-
-init_prepare(State = #{prepare_cql := Prepares, pool_name := PoolName}) ->
-    case maps:size(Prepares) of
-        0 ->
-            State;
-        _ ->
-            case prepare_cql(Prepares, PoolName) of
-                {ok, Sts} ->
-                    State#{prepare_statement := Sts};
-                Error ->
-                    ?tp(
-                        error,
-                        cassandra_prepare_cql_failed,
-                        #{prepares => Prepares, reason => Error}
-                    ),
-                    %% mark the prepare_cql as failed
-                    State#{prepare_cql => {error, Prepares}}
-            end
-    end.
-
-prepare_cql(Prepares, PoolName) when is_map(Prepares) ->
-    prepare_cql(maps:to_list(Prepares), PoolName);
-prepare_cql(Prepares, PoolName) ->
-    case do_prepare_cql(Prepares, PoolName) of
-        {ok, _Sts} = Ok ->
+prepare_cql_to_cassandra(ParsedCql, PoolName) ->
+    case prepare_cql_to_cassandra(ecpool:workers(PoolName), ParsedCql, #{}) of
+        {ok, Statement} ->
             %% prepare for reconnect
-            ecpool:add_reconnect_callback(PoolName, {?MODULE, prepare_cql_to_conn, [Prepares]}),
-            Ok;
+            ecpool:add_reconnect_callback(PoolName, {?MODULE, prepare_cql_to_conn, [ParsedCql]}),
+            {ok, Statement};
         Error ->
+            ?tp(
+                error,
+                cassandra_prepare_cql_failed,
+                #{parsed_cql => ParsedCql, reason => Error}
+            ),
             Error
     end.
 
-do_prepare_cql(Prepares, PoolName) ->
-    do_prepare_cql(ecpool:workers(PoolName), Prepares, #{}).
-
-do_prepare_cql([{_Name, Worker} | T], Prepares, _LastSts) ->
+prepare_cql_to_cassandra([{_Name, Worker} | T], ParsedCql, _LastSts) ->
     {ok, Conn} = ecpool_worker:client(Worker),
-    case prepare_cql_to_conn(Conn, Prepares) of
-        {ok, Sts} ->
-            do_prepare_cql(T, Prepares, Sts);
+    case prepare_cql_to_conn(Conn, ParsedCql) of
+        {ok, Statement} ->
+            prepare_cql_to_cassandra(T, ParsedCql, Statement);
         Error ->
             Error
     end;
-do_prepare_cql([], _Prepares, LastSts) ->
+prepare_cql_to_cassandra([], _ParsedCql, LastSts) ->
     {ok, LastSts}.
 
-prepare_cql_to_conn(Conn, Prepares) ->
-    prepare_cql_to_conn(Conn, Prepares, #{}).
-
-prepare_cql_to_conn(Conn, [], Statements) when is_pid(Conn) -> {ok, Statements};
-prepare_cql_to_conn(Conn, [{Key, SQL} | PrepareList], Statements) when is_pid(Conn) ->
-    ?SLOG(info, #{msg => "cassandra_prepare_cql", name => Key, prepare_cql => SQL}),
-    case ecql:prepare(Conn, Key, SQL) of
+prepare_cql_to_conn(Conn, #{prepare_key := PrepareKey, prepare_cql := PrepareCQL}) when
+    is_pid(Conn)
+->
+    ?SLOG(info, #{
+        msg => "cassandra_prepare_cql", prepare_key => PrepareKey, prepare_cql => PrepareCQL
+    }),
+    case ecql:prepare(Conn, PrepareKey, PrepareCQL) of
         {ok, Statement} ->
-            prepare_cql_to_conn(Conn, PrepareList, Statements#{Key => Statement});
-        {error, Error} = Other ->
+            {ok, Statement};
+        {error, Reason} = Error ->
             ?SLOG(error, #{
                 msg => "cassandra_prepare_cql_failed",
                 worker_pid => Conn,
-                name => Key,
-                prepare_cql => SQL,
-                error => Error
+                name => PrepareKey,
+                prepare_cql => PrepareCQL,
+                reason => Reason
             }),
-            Other
+            Error
     end.
 
 handle_result({error, disconnected}) ->
@@ -487,6 +432,9 @@ handle_result({error, Error}) ->
 handle_result(Res) ->
     Res.
 
+transform_bridge_v1_config_to_connector_config(_) ->
+    ok.
+
 %%--------------------------------------------------------------------
 %% utils
 
@@ -513,3 +461,11 @@ maybe_assign_type(V) when is_integer(V) ->
 maybe_assign_type(V) when is_float(V) -> {double, V};
 maybe_assign_type(V) ->
     V.
+
+short_prepare_key(Str) when is_binary(Str) ->
+    true = size(Str) > 0,
+    Sha = crypto:hash(sha, Str),
+    %% TODO: change to binary:encode_hex(X, lowercase) when OTP version is always > 25
+    Hex = string:lowercase(binary:encode_hex(Sha)),
+    <<UniqueEnough:16/binary, _/binary>> = Hex,
+    binary_to_atom(<<"cassa_prepare_key:", UniqueEnough/binary>>).
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index e0e3900b0..77aec7d99 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -301,17 +301,28 @@ send_message(Config, Payload) ->
 query_resource(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => 1_000}).
+    BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
+    ConnectorResId = emqx_connector_resource:resource_id(
+        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
+    ),
+    emqx_resource:query(BridgeV2Id, Request, #{
+        timeout => 1_000, connector_resource_id => ConnectorResId
+    }).
 
 query_resource_async(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
     Ref = alias([reply]),
     AsyncReplyFun = fun(Result) -> Ref ! {result, Ref, Result} end,
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    Return = emqx_resource:query(ResourceID, Request, #{
-        timeout => 500, async_reply_fun => {AsyncReplyFun, []}
+    BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
+    ConnectorResId = emqx_connector_resource:resource_id(
+        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
+    ),
+    Return = emqx_resource:query(BridgeV2Id, Request, #{
+        timeout => 500,
+        async_reply_fun => {AsyncReplyFun, []},
+        connector_resource_id => ConnectorResId,
+        query_mode => async
     }),
     {Return, Ref}.
 
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
index 245110de6..50d82397a 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
@@ -22,10 +22,6 @@
 %%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
 %%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE
 
-%% Cassandra servers are defined at `.ci/docker-compose-file/docker-compose-cassandra.yaml`
-%% You can change it to `127.0.0.1`, if you run this SUITE locally
--define(CASSANDRA_HOST, "cassandra").
--define(CASSANDRA_HOST_NOAUTH, "cassandra_noauth").
 -define(CASSANDRA_RESOURCE_MOD, emqx_bridge_cassandra_connector).
 
 %% Cassandra default username & password once enable `authenticator: PasswordAuthenticator`
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 655892d88..2b50252e8 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -36,6 +36,8 @@ resource_type(mongodb) ->
     emqx_bridge_mongodb_connector;
 resource_type(influxdb) ->
     emqx_bridge_influxdb_connector;
+resource_type(cassandra) ->
+    emqx_bridge_cassandra_connector;
 resource_type(mysql) ->
     emqx_bridge_mysql_connector;
 resource_type(pgsql) ->
@@ -130,6 +132,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {cassandra,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_cassandra, "config_connector")),
+                #{
+                    desc => <<"Cassandra Connector Config">>,
+                    required => false
+                }
+            )},
         {mysql,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_mysql, "config_connector")),
@@ -205,6 +215,7 @@ schema_modules() ->
         emqx_bridge_matrix,
         emqx_bridge_mongodb,
         emqx_bridge_influxdb,
+        emqx_bridge_cassandra,
         emqx_bridge_mysql,
         emqx_bridge_syskeeper_connector,
         emqx_bridge_syskeeper_proxy,
@@ -234,6 +245,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_matrix, <<"matrix">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mongodb, <<"mongodb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_influxdb, <<"influxdb">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_cassandra, <<"cassandra">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mysql, <<"mysql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_syskeeper_connector, <<"syskeeper_forwarder">>, Method),
         api_ref(emqx_bridge_syskeeper_proxy, <<"syskeeper_proxy">>, Method),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 615b89230..f4bbb5459 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -137,6 +137,8 @@ connector_type_to_bridge_types(mongodb) ->
     [mongodb, mongodb_rs, mongodb_sharded, mongodb_single];
 connector_type_to_bridge_types(influxdb) ->
     [influxdb, influxdb_api_v1, influxdb_api_v2];
+connector_type_to_bridge_types(cassandra) ->
+    [cassandra];
 connector_type_to_bridge_types(mysql) ->
     [mysql];
 connector_type_to_bridge_types(mqtt) ->
diff --git a/rel/i18n/emqx_bridge_cassandra.hocon b/rel/i18n/emqx_bridge_cassandra.hocon
index a96315340..29eb35de5 100644
--- a/rel/i18n/emqx_bridge_cassandra.hocon
+++ b/rel/i18n/emqx_bridge_cassandra.hocon
@@ -1,5 +1,15 @@
 emqx_bridge_cassandra {
 
+action_parameters.desc:
+"""Action specific configs."""
+action_parameters.label:
+"""Action"""
+
+cassandra_action.desc:
+"""Action configs."""
+cassandra_action.label:
+"""Action"""
+
 config_enable.desc:
 """Enable or disable this bridge"""
 
diff --git a/rel/i18n/emqx_bridge_cassandra_connector.hocon b/rel/i18n/emqx_bridge_cassandra_connector.hocon
index b149cce8a..40e1c0e22 100644
--- a/rel/i18n/emqx_bridge_cassandra_connector.hocon
+++ b/rel/i18n/emqx_bridge_cassandra_connector.hocon
@@ -1,5 +1,11 @@
 emqx_bridge_cassandra_connector {
 
+config.desc:
+"""Cassandra connection config"""
+
+config.label:
+"""Connection config"""
+
 keyspace.desc:
 """Keyspace name to connect to."""
 

From 0e1043f80cc397618d15bf6a24af30b3a3ed31d4 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Sun, 21 Jan 2024 21:00:38 +0800
Subject: [PATCH 010/273] ci: update generated connector name

---
 .../test/emqx_bridge_cassandra_SUITE.erl                  | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index 77aec7d99..09deaa699 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -302,9 +302,7 @@ query_resource(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
     BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
-    ConnectorResId = emqx_connector_resource:resource_id(
-        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
-    ),
+    ConnectorResId = emqx_connector_resource:resource_id(BridgeType, Name),
     emqx_resource:query(BridgeV2Id, Request, #{
         timeout => 1_000, connector_resource_id => ConnectorResId
     }).
@@ -315,9 +313,7 @@ query_resource_async(Config, Request) ->
     Ref = alias([reply]),
     AsyncReplyFun = fun(Result) -> Ref ! {result, Ref, Result} end,
     BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
-    ConnectorResId = emqx_connector_resource:resource_id(
-        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
-    ),
+    ConnectorResId = emqx_connector_resource:resource_id(BridgeType, Name),
     Return = emqx_resource:query(BridgeV2Id, Request, #{
         timeout => 500,
         async_reply_fun => {AsyncReplyFun, []},

From 8118297ddc80faac701ff9bb22d0bcb21977163c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jan 2024 03:44:31 +0000
Subject: [PATCH 011/273] chore(deps): bump the actions-package-macos group

Bumps the actions-package-macos group in /.github/actions/package-macos with 1 update: [actions/cache](https://github.com/actions/cache).


Updates `actions/cache` from 3.3.3 to 4.0.0
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/e12d46a63a90f2fae62d114769bbf2a179198b5c...13aacd865c20de90d75de3b17ebe84f7a17d57d2)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-package-macos
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/actions/package-macos/action.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/actions/package-macos/action.yaml b/.github/actions/package-macos/action.yaml
index 64d179b46..1553576b2 100644
--- a/.github/actions/package-macos/action.yaml
+++ b/.github/actions/package-macos/action.yaml
@@ -51,7 +51,7 @@ runs:
             echo "SELF_HOSTED=false" >> $GITHUB_OUTPUT
             ;;
         esac
-    - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
+    - uses: actions/cache@13aacd865c20de90d75de3b17ebe84f7a17d57d2 # v4.0.0
       id: cache
       if: steps.prepare.outputs.SELF_HOSTED != 'true'
       with:

From 837b19cb1e6023a90195db0052f00aee8ace3e4f Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Mon, 22 Jan 2024 15:45:00 +0800
Subject: [PATCH 012/273] chore: update change logs for cassandra bridge_v2

---
 changes/ee/feat-12330.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12330.en.md

diff --git a/changes/ee/feat-12330.en.md b/changes/ee/feat-12330.en.md
new file mode 100644
index 000000000..963098659
--- /dev/null
+++ b/changes/ee/feat-12330.en.md
@@ -0,0 +1 @@
+The bridges for Cassandra have been split so they are available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.

From e337e1dc408369cc8486f2ee60ee3b2701f9c26a Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Mon, 22 Jan 2024 20:45:10 +0800
Subject: [PATCH 013/273] feat(opents): improve the OpentsDB bridge to v2 style

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   3 +-
 .../src/emqx_bridge_opents.erl                | 128 ++++-
 .../src/emqx_bridge_opents_action_info.erl    |  71 +++
 .../src/emqx_bridge_opents_connector.erl      | 194 ++++++-
 .../test/emqx_bridge_opents_SUITE.erl         | 484 +++++++-----------
 .../src/schema/emqx_connector_ee_schema.erl   |  18 +-
 .../src/schema/emqx_connector_schema.erl      |   4 +-
 rel/i18n/emqx_bridge_opents.hocon             |  31 ++
 rel/i18n/emqx_bridge_opents_connector.hocon   |   6 +
 9 files changed, 607 insertions(+), 332 deletions(-)
 create mode 100644 apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index d80050191..4f6228998 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -98,7 +98,8 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_timescale_action_info,
         emqx_bridge_redis_action_info,
         emqx_bridge_iotdb_action_info,
-        emqx_bridge_es_action_info
+        emqx_bridge_es_action_info,
+        emqx_bridge_opents_action_info
     ].
 -else.
 hard_coded_action_info_modules_ee() ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index cfb12453d..7e490576f 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_bridge_opents).
 
@@ -7,10 +7,12 @@
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 
--import(hoconsc, [mk/2, enum/1, ref/2]).
+-import(hoconsc, [mk/2, enum/1, ref/2, array/1]).
 
 -export([
-    conn_bridge_examples/1
+    conn_bridge_examples/1,
+    bridge_v2_examples/1,
+    default_data_template/0
 ]).
 
 -export([
@@ -20,8 +22,11 @@
     desc/1
 ]).
 
+-define(CONNECTOR_TYPE, opents).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
+
 %% -------------------------------------------------------------------------------------------------
-%% api
+%% v1 examples
 conn_bridge_examples(Method) ->
     [
         #{
@@ -34,7 +39,7 @@ conn_bridge_examples(Method) ->
 
 values(_Method) ->
     #{
-        enable => true,
+        enabledb => true,
         type => opents,
         name => <<"foo">>,
         server => <<"http://127.0.0.1:4242">>,
@@ -50,7 +55,37 @@ values(_Method) ->
     }.
 
 %% -------------------------------------------------------------------------------------------------
-%% Hocon Schema Definitions
+%% v2 examples
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"opents">> => #{
+                summary => <<"OpenTSDB Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                )
+            }
+        }
+    ].
+
+action_values() ->
+    #{
+        parameters => #{
+            data => default_data_template()
+        }
+    }.
+
+default_data_template() ->
+    [
+        #{
+            metric => <<"${metric}">>,
+            tags => <<"${tags}">>,
+            value => <<"${value}">>
+        }
+    ].
+
+%% -------------------------------------------------------------------------------------------------
+%% V1 Schema Definitions
 namespace() -> "bridge_opents".
 
 roots() -> [].
@@ -65,10 +100,89 @@ fields("post") ->
 fields("put") ->
     fields("config");
 fields("get") ->
-    emqx_bridge_schema:status_fields() ++ fields("post").
+    emqx_bridge_schema:status_fields() ++ fields("post");
+%% -------------------------------------------------------------------------------------------------
+%% V2 Schema Definitions
+
+fields(action) ->
+    {opents,
+        mk(
+            hoconsc:map(name, ref(?MODULE, action_config)),
+            #{
+                desc => <<"OpenTSDB Action Config">>,
+                required => false
+            }
+        )};
+fields(action_config) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(
+            ref(?MODULE, action_parameters),
+            #{
+                required => true, desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    [
+        {data,
+            mk(
+                array(ref(?MODULE, action_parameters_data)),
+                #{
+                    desc => ?DESC("action_parameters_data"),
+                    default => <<"[]">>
+                }
+            )}
+    ];
+fields(action_parameters_data) ->
+    [
+        {timestamp,
+            mk(
+                binary(),
+                #{
+                    desc => ?DESC("config_parameters_timestamp"),
+                    required => false
+                }
+            )},
+        {metric,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_metric")
+                }
+            )},
+        {tags,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_tags")
+                }
+            )},
+        {value,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_value")
+                }
+            )}
+    ];
+fields("post_bridge_v2") ->
+    emqx_bridge_schema:type_and_name_fields(enum([opents])) ++ fields(action_config);
+fields("put_bridge_v2") ->
+    fields(action_config);
+fields("get_bridge_v2") ->
+    emqx_bridge_schema:status_fields() ++ fields("post_bridge_v2").
 
 desc("config") ->
     ?DESC("desc_config");
+desc(action_config) ->
+    ?DESC("desc_config");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(action_parameters_data) ->
+    ?DESC("action_parameters_data");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for OpenTSDB using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl
new file mode 100644
index 000000000..4c4c9568c
--- /dev/null
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl
@@ -0,0 +1,71 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_opents_action_info).
+
+-behaviour(emqx_action_info).
+
+-elvis([{elvis_style, invalid_dynamic_call, disable}]).
+
+%% behaviour callbacks
+-export([
+    action_type_name/0,
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_type_name/0,
+    connector_action_config_to_bridge_v1_config/2,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(ACTION_TYPE, opents).
+-define(SCHEMA_MODULE, emqx_bridge_opents).
+
+action_type_name() -> ?ACTION_TYPE.
+bridge_v1_type_name() -> ?ACTION_TYPE.
+connector_type_name() -> ?ACTION_TYPE.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
+    MergedConfig =
+        emqx_utils_maps:deep_merge(
+            maps:without(
+                [<<"description">>, <<"local_topic">>, <<"connector">>, <<"data">>],
+                emqx_utils_maps:unindent(<<"parameters">>, ActionConfig)
+            ),
+            ConnectorConfig
+        ),
+    BridgeV1Keys = schema_keys("config"),
+    maps:with(BridgeV1Keys, MergedConfig).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(action_config),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ConnectorKeys = schema_keys(emqx_bridge_opents_connector, "config_connector"),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        maps:with(ConnectorKeys, BridgeV1Config)
+    ).
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config#{<<"data">> => []}),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    schema_keys(?SCHEMA_MODULE, Name).
+
+schema_keys(Mod, Name) ->
+    [bin(Key) || Key <- proplists:get_keys(Mod:fields(Name))].
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index 9271abe15..6af1e2f55 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_opents_connector).
@@ -12,7 +12,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([roots/0, fields/1]).
+-export([namespace/0, roots/0, fields/1, desc/1]).
 
 %% `emqx_resource' API
 -export([
@@ -21,15 +21,25 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
+-export([connector_examples/1]).
+
 -export([connect/1]).
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
 
+-define(CONNECTOR_TYPE, opents).
+
+namespace() -> "opents_connector".
+
 %%=====================================================================
-%% Hocon schema
+%% V1 Hocon schema
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
@@ -40,8 +50,56 @@ fields(config) ->
         {summary, mk(boolean(), #{default => true, desc => ?DESC("summary")})},
         {details, mk(boolean(), #{default => false, desc => ?DESC("details")})},
         {auto_reconnect, fun emqx_connector_schema_lib:auto_reconnect/1}
+    ];
+%%=====================================================================
+%% V2 Hocon schema
+
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        proplists_without([auto_reconnect], fields(config));
+fields("post") ->
+    emqx_connector_schema:type_and_name_fields(enum([opents])) ++ fields("config_connector");
+fields("put") ->
+    fields("config_connector");
+fields("get") ->
+    emqx_bridge_schema:status_fields() ++ fields("post").
+
+desc(config) ->
+    ?DESC("desc_config");
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
+    ["Configuration for IoTDB using `", string:to_upper(Method), "` method."];
+desc(_) ->
+    undefined.
+
+proplists_without(Keys, List) ->
+    [El || El = {K, _} <- List, not lists:member(K, Keys)].
+
+%%=====================================================================
+%% V2 examples
+connector_examples(Method) ->
+    [
+        #{
+            <<"opents">> =>
+                #{
+                    summary => <<"OpenTSDB Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_example_values()
+                    )
+                }
+        }
     ].
 
+connector_example_values() ->
+    #{
+        name => <<"opents_connector">>,
+        type => opents,
+        enable => true,
+        server => <<"http://localhost:4242/">>,
+        pool_size => 8
+    }.
+
 %%========================================================================================
 %% `emqx_resource' API
 %%========================================================================================
@@ -56,8 +114,7 @@ on_start(
         server := Server,
         pool_size := PoolSize,
         summary := Summary,
-        details := Details,
-        resource_opts := #{batch_size := BatchSize}
+        details := Details
     } = Config
 ) ->
     ?SLOG(info, #{
@@ -70,11 +127,10 @@ on_start(
         {server, to_str(Server)},
         {summary, Summary},
         {details, Details},
-        {max_batch_size, BatchSize},
         {pool_size, PoolSize}
     ],
 
-    State = #{pool_name => InstanceId, server => Server},
+    State = #{pool_name => InstanceId, server => Server, channels => #{}},
     case opentsdb_connectivity(Server) of
         ok ->
             case emqx_resource_pool:start(InstanceId, ?MODULE, Options) of
@@ -93,6 +149,7 @@ on_stop(InstanceId, _State) ->
         msg => "stopping_opents_connector",
         connector => InstanceId
     }),
+    ?tp(opents_bridge_stopped, #{instance_id => InstanceId}),
     emqx_resource_pool:stop(InstanceId).
 
 on_query(InstanceId, Request, State) ->
@@ -101,10 +158,14 @@ on_query(InstanceId, Request, State) ->
 on_batch_query(
     InstanceId,
     BatchReq,
-    State
+    #{channels := Channels} = State
 ) ->
-    Datas = [format_opentsdb_msg(Msg) || {_Key, Msg} <- BatchReq],
-    do_query(InstanceId, Datas, State).
+    case try_render_messages(BatchReq, Channels) of
+        {ok, Datas} ->
+            do_query(InstanceId, Datas, State);
+        Error ->
+            Error
+    end.
 
 on_get_status(_InstanceId, #{server := Server}) ->
     Result =
@@ -117,6 +178,39 @@ on_get_status(_InstanceId, #{server := Server}) ->
         end,
     Result.
 
+on_add_channel(
+    _InstanceId,
+    #{channels := Channels} = OldState,
+    ChannelId,
+    #{
+        parameters := #{data := Data} = Parameter
+    }
+) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            {error, already_exists};
+        _ ->
+            Channel = Parameter#{
+                data := preproc_data_template(Data)
+            },
+            Channels2 = Channels#{ChannelId => Channel},
+            {ok, OldState#{channels := Channels2}}
+    end.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = OldState, ChannelId) ->
+    {ok, OldState#{channels => maps:remove(ChannelId, Channels)}}.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
+on_get_channel_status(InstanceId, ChannelId, #{channels := Channels} = State) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            on_get_status(InstanceId, State);
+        _ ->
+            {error, not_exists}
+    end.
+
 %%========================================================================================
 %% Helper fns
 %%========================================================================================
@@ -127,6 +221,9 @@ do_query(InstanceId, Query, #{pool_name := PoolName} = State) ->
         "opents_connector_received",
         #{connector => InstanceId, query => Query, state => State}
     ),
+
+    ?tp(opents_bridge_on_query, #{instance_id => InstanceId}),
+
     Result = ecpool:pick_and_do(PoolName, {opentsdb, put, [Query]}, no_handover),
 
     case Result of
@@ -172,17 +269,66 @@ opentsdb_connectivity(Server) ->
         end,
     emqx_connector_lib:http_connectivity(SvrUrl, ?HTTP_CONNECT_TIMEOUT).
 
-format_opentsdb_msg(Msg) ->
-    maps:with(
-        [
-            timestamp,
-            metric,
-            tags,
-            value,
-            <<"timestamp">>,
-            <<"metric">>,
-            <<"tags">>,
-            <<"value">>
-        ],
-        Msg
+try_render_messages([{ChannelId, _} | _] = BatchReq, Channels) ->
+    case maps:find(ChannelId, Channels) of
+        {ok, Channel} ->
+            {ok,
+                lists:foldl(
+                    fun({_, Message}, Acc) ->
+                        render_channel_message(Message, Channel, Acc)
+                    end,
+                    [],
+                    BatchReq
+                )};
+        _ ->
+            {error, {unrecoverable_error, {invalid_channel_id, ChannelId}}}
+    end.
+
+render_channel_message(Msg, #{data := DataList}, Acc) ->
+    RawOpts = #{return => rawlist, var_trans => fun(X) -> X end},
+    lists:foldl(
+        fun(#{metric := MetricTk, tags := TagsTk, value := ValueTk} = Data, InAcc) ->
+            MetricVal = emqx_placeholder:proc_tmpl(MetricTk, Msg),
+            TagsVal =
+                case emqx_placeholder:proc_tmpl(TagsTk, Msg, RawOpts) of
+                    [undefined] ->
+                        #{};
+                    [Any] ->
+                        Any
+                end,
+            ValueVal =
+                case ValueTk of
+                    [_] ->
+                        erlang:hd(emqx_placeholder:proc_tmpl(ValueTk, Msg, RawOpts));
+                    _ ->
+                        emqx_placeholder:proc_tmpl(ValueTk, Msg)
+                end,
+            Base = #{metric => MetricVal, tags => TagsVal, value => ValueVal},
+            [
+                case maps:get(timestamp, Data, undefined) of
+                    undefined ->
+                        Base;
+                    TimestampTk ->
+                        Base#{timestamp => emqx_placeholder:proc_tmpl(TimestampTk, Msg)}
+                end
+                | InAcc
+            ]
+        end,
+        Acc,
+        DataList
+    ).
+
+preproc_data_template([]) ->
+    preproc_data_template(emqx_bridge_opents:default_data_template());
+preproc_data_template(DataList) ->
+    lists:map(
+        fun(Data) ->
+            maps:map(
+                fun(_Key, Value) ->
+                    emqx_placeholder:preproc_tmpl(Value)
+                end,
+                Data
+            )
+        end,
+        DataList
     ).
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index 3632ce786..f86ae6986 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_opents_SUITE).
@@ -12,7 +12,8 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 % DB defaults
--define(BATCH_SIZE, 10).
+-define(BRIDGE_TYPE_BIN, <<"opents">>).
+-define(APPS, [opentsdb, emqx_bridge, emqx_resource, emqx_rule_engine, emqx_bridge_opents_SUITE]).
 
 %%------------------------------------------------------------------------------
 %% CT boilerplate
@@ -20,95 +21,34 @@
 
 all() ->
     [
-        {group, with_batch},
-        {group, without_batch}
+        {group, default}
     ].
 
 groups() ->
-    TCs = emqx_common_test_helpers:all(?MODULE),
+    AllTCs = emqx_common_test_helpers:all(?MODULE),
     [
-        {with_batch, TCs},
-        {without_batch, TCs}
+        {default, AllTCs}
     ].
 
-init_per_group(with_batch, Config0) ->
-    Config = [{batch_size, ?BATCH_SIZE} | Config0],
-    common_init(Config);
-init_per_group(without_batch, Config0) ->
-    Config = [{batch_size, 1} | Config0],
-    common_init(Config);
-init_per_group(_Group, Config) ->
-    Config.
-
-end_per_group(Group, Config) when Group =:= with_batch; Group =:= without_batch ->
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-    ok;
-end_per_group(_Group, _Config) ->
-    ok.
-
 init_per_suite(Config) ->
-    Config.
+    emqx_bridge_v2_testlib:init_per_suite(Config, ?APPS).
 
-end_per_suite(_Config) ->
-    emqx_mgmt_api_test_util:end_suite(),
-    ok = emqx_common_test_helpers:stop_apps([opentsdb, emqx_bridge, emqx_resource, emqx_conf]),
-    ok.
+end_per_suite(Config) ->
+    emqx_bridge_v2_testlib:end_per_suite(Config).
 
-init_per_testcase(_Testcase, Config) ->
-    delete_bridge(Config),
-    snabbkaffe:start_trace(),
-    Config.
-
-end_per_testcase(_Testcase, Config) ->
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-    ok = snabbkaffe:stop(),
-    delete_bridge(Config),
-    ok.
-
-%%------------------------------------------------------------------------------
-%% Helper fns
-%%------------------------------------------------------------------------------
-
-common_init(ConfigT) ->
-    Host = os:getenv("OPENTS_HOST", "toxiproxy"),
+init_per_group(default, Config0) ->
+    Host = os:getenv("OPENTS_HOST", "toxiproxy.emqx.net"),
     Port = list_to_integer(os:getenv("OPENTS_PORT", "4242")),
-
-    Config0 = [
-        {opents_host, Host},
-        {opents_port, Port},
-        {proxy_name, "opents"}
-        | ConfigT
-    ],
-
-    BridgeType = proplists:get_value(bridge_type, Config0, <<"opents">>),
+    ProxyName = "opents",
     case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
-            % Setup toxiproxy
-            ProxyHost = os:getenv("PROXY_HOST", "toxiproxy"),
-            ProxyPort = list_to_integer(os:getenv("PROXY_PORT", "8474")),
-            emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-            % Ensure enterprise bridge module is loaded
-            ok = emqx_common_test_helpers:start_apps([
-                emqx_conf, emqx_resource, emqx_bridge
-            ]),
-            _ = application:ensure_all_started(opentsdb),
-            _ = emqx_bridge_enterprise:module_info(),
-            emqx_mgmt_api_test_util:init_suite(),
-            {Name, OpenTSConf} = opents_config(BridgeType, Config0),
-            Config =
-                [
-                    {opents_config, OpenTSConf},
-                    {opents_bridge_type, BridgeType},
-                    {opents_name, Name},
-                    {proxy_host, ProxyHost},
-                    {proxy_port, ProxyPort}
-                    | Config0
-                ],
-            Config;
+            Config = emqx_bridge_v2_testlib:init_per_group(default, ?BRIDGE_TYPE_BIN, Config0),
+            [
+                {bridge_host, Host},
+                {bridge_port, Port},
+                {proxy_name, ProxyName}
+                | Config
+            ];
         false ->
             case os:getenv("IS_CI") of
                 "yes" ->
@@ -116,244 +56,152 @@ common_init(ConfigT) ->
                 _ ->
                     {skip, no_opents}
             end
-    end.
-
-opents_config(BridgeType, Config) ->
-    Port = integer_to_list(?config(opents_port, Config)),
-    Server = "http://" ++ ?config(opents_host, Config) ++ ":" ++ Port,
-    Name = atom_to_binary(?MODULE),
-    BatchSize = ?config(batch_size, Config),
-    ConfigString =
-        io_lib:format(
-            "bridges.~s.~s {\n"
-            "  enable = true\n"
-            "  server = ~p\n"
-            "  resource_opts = {\n"
-            "    request_ttl = 500ms\n"
-            "    batch_size = ~b\n"
-            "    query_mode = sync\n"
-            "  }\n"
-            "}",
-            [
-                BridgeType,
-                Name,
-                Server,
-                BatchSize
-            ]
-        ),
-    {Name, parse_and_check(ConfigString, BridgeType, Name)}.
-
-parse_and_check(ConfigString, BridgeType, Name) ->
-    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
-    hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
-    #{<<"bridges">> := #{BridgeType := #{Name := Config}}} = RawConf,
+    end;
+init_per_group(_Group, Config) ->
     Config.
 
-create_bridge(Config) ->
-    create_bridge(Config, _Overrides = #{}).
+end_per_group(default, Config) ->
+    emqx_bridge_v2_testlib:end_per_group(Config),
+    ok;
+end_per_group(_Group, _Config) ->
+    ok.
 
-create_bridge(Config, Overrides) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    Config0 = ?config(opents_config, Config),
-    Config1 = emqx_utils_maps:deep_merge(Config0, Overrides),
-    emqx_bridge:create(BridgeType, Name, Config1).
+init_per_testcase(TestCase, Config0) ->
+    Type = ?config(bridge_type, Config0),
+    UniqueNum = integer_to_binary(erlang:unique_integer()),
+    Name = <<
+        (atom_to_binary(TestCase))/binary, UniqueNum/binary
+    >>,
+    {_ConfigString, ConnectorConfig} = connector_config(Name, Config0),
+    {_, ActionConfig} = action_config(Name, Config0),
+    Config = [
+        {connector_type, Type},
+        {connector_name, Name},
+        {connector_config, ConnectorConfig},
+        {bridge_type, Type},
+        {bridge_name, Name},
+        {bridge_config, ActionConfig}
+        | Config0
+    ],
+    %%    iotdb_reset(Config),
+    ok = snabbkaffe:start_trace(),
+    Config.
 
-delete_bridge(Config) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    emqx_bridge:remove(BridgeType, Name).
-
-create_bridge_http(Params) ->
-    Path = emqx_mgmt_api_test_util:api_path(["bridges"]),
-    AuthHeader = emqx_mgmt_api_test_util:auth_header_(),
-    case emqx_mgmt_api_test_util:request_api(post, Path, "", AuthHeader, Params) of
-        {ok, Res} -> {ok, emqx_utils_json:decode(Res, [return_maps])};
-        Error -> Error
-    end.
-
-send_message(Config, Payload) ->
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    BridgeID = emqx_bridge_resource:bridge_id(BridgeType, Name),
-    emqx_bridge:send_message(BridgeID, Payload).
-
-query_resource(Config, Request) ->
-    query_resource(Config, Request, 1_000).
-
-query_resource(Config, Request, Timeout) ->
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => Timeout}).
+end_per_testcase(TestCase, Config) ->
+    emqx_bridge_v2_testlib:end_per_testcase(TestCase, Config).
 
 %%------------------------------------------------------------------------------
-%% Testcases
+%% Helper fns
 %%------------------------------------------------------------------------------
 
-t_setup_via_config_and_publish(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    SentData = make_data(),
-    ?check_trace(
-        begin
-            {_, {ok, #{result := Result}}} =
-                ?wait_async_action(
-                    send_message(Config, SentData),
-                    #{?snk_kind := buffer_worker_flush_ack},
-                    2_000
-                ),
-            ?assertMatch(
-                {ok, 200, #{failed := 0, success := 1}}, Result
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(opents_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, 200, #{failed := 0, success := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
+action_config(Name, Config) ->
+    Type = ?config(bridge_type, Config),
+    ConfigString =
+        io_lib:format(
+            "actions.~s.~s {\n"
+            "  enable = true\n"
+            "  connector = \"~s\"\n"
+            "  parameters = {\n"
+            "     data = []\n"
+            "  }\n"
+            "}\n",
+            [
+                Type,
+                Name,
+                Name
+            ]
+        ),
+    ct:pal("ActionConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_action_and_check(ConfigString, Type, Name)}.
 
-t_setup_via_http_api_and_publish(Config) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    OpentsConfig0 = ?config(opents_config, Config),
-    OpentsConfig = OpentsConfig0#{
-        <<"name">> => Name,
-        <<"type">> => BridgeType
-    },
-    ?assertMatch(
-        {ok, _},
-        create_bridge_http(OpentsConfig)
-    ),
-    SentData = make_data(),
-    ?check_trace(
-        begin
-            Request = {send_message, SentData},
-            Res0 = query_resource(Config, Request, 2_500),
-            ?assertMatch(
-                {ok, 200, #{failed := 0, success := 1}}, Res0
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(opents_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, 200, #{failed := 0, success := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
+connector_config(Name, Config) ->
+    Host = ?config(bridge_host, Config),
+    Port = ?config(bridge_port, Config),
+    Type = ?config(bridge_type, Config),
+    ServerURL = opents_server_url(Host, Port),
+    ConfigString =
+        io_lib:format(
+            "connectors.~s.~s {\n"
+            "  enable = true\n"
+            "  server = \"~s\"\n"
+            "}\n",
+            [
+                Type,
+                Name,
+                ServerURL
+            ]
+        ),
+    ct:pal("ConnectorConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_connector_and_check(ConfigString, Type, Name)}.
 
-t_get_status(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
+parse_action_and_check(ConfigString, BridgeType, Name) ->
+    parse_and_check(ConfigString, emqx_bridge_schema, <<"actions">>, BridgeType, Name).
 
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
+parse_connector_and_check(ConfigString, ConnectorType, Name) ->
+    parse_and_check(
+        ConfigString, emqx_connector_schema, <<"connectors">>, ConnectorType, Name
+    ).
+%%    emqx_utils_maps:safe_atom_key_map(Config).
 
-    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceID)),
-    ok.
+parse_and_check(ConfigString, SchemaMod, RootKey, Type0, Name) ->
+    Type = to_bin(Type0),
+    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
+    hocon_tconf:check_plain(SchemaMod, RawConf, #{required => false, atom_key => false}),
+    #{RootKey := #{Type := #{Name := Config}}} = RawConf,
+    Config.
 
-t_create_disconnected(Config) ->
-    BridgeType = proplists:get_value(bridge_type, Config, <<"opents">>),
-    Config1 = lists:keyreplace(opents_port, 1, Config, {opents_port, 61234}),
-    {_Name, OpenTSConf} = opents_config(BridgeType, Config1),
+to_bin(List) when is_list(List) ->
+    unicode:characters_to_binary(List, utf8);
+to_bin(Atom) when is_atom(Atom) ->
+    erlang:atom_to_binary(Atom);
+to_bin(Bin) when is_binary(Bin) ->
+    Bin.
 
-    Config2 = lists:keyreplace(opents_config, 1, Config1, {opents_config, OpenTSConf}),
-    ?assertMatch({ok, _}, create_bridge(Config2)),
+opents_server_url(Host, Port) ->
+    iolist_to_binary([
+        "http://",
+        Host,
+        ":",
+        integer_to_binary(Port)
+    ]).
 
-    Name = ?config(opents_name, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceID)),
-    ok.
+is_success_check({ok, 200, #{failed := Failed}}) ->
+    ?assertEqual(0, Failed);
+is_success_check(Ret) ->
+    ?assert(false, Ret).
 
-t_write_failure(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    {ok, _} = create_bridge(Config),
-    SentData = make_data(),
-    emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
-        {_, {ok, #{result := Result}}} =
-            ?wait_async_action(
-                send_message(Config, SentData),
-                #{?snk_kind := buffer_worker_flush_ack},
-                2_000
-            ),
-        ?assertMatch({error, _}, Result),
-        ok
-    end),
-    ok.
+is_error_check(Result) ->
+    ?assertMatch({error, {400, #{failed := 1}}}, Result).
 
-t_write_timeout(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    {ok, _} = create_bridge(
-        Config,
-        #{
-            <<"resource_opts">> => #{
-                <<"request_ttl">> => <<"500ms">>,
-                <<"resume_interval">> => <<"100ms">>,
-                <<"health_check_interval">> => <<"100ms">>
+opentds_query(Config, Metric) ->
+    Path = <<"/api/query">>,
+    Opts = #{return_all => true},
+    Body = #{
+        start => <<"1h-ago">>,
+        queries => [
+            #{
+                aggregator => <<"last">>,
+                metric => Metric,
+                tags => #{
+                    host => <<"*">>
+                }
             }
-        }
-    ),
-    SentData = make_data(),
-    emqx_common_test_helpers:with_failure(
-        timeout, ProxyName, ProxyHost, ProxyPort, fun() ->
-            ?assertMatch(
-                {error, {resource_error, #{reason := timeout}}},
-                query_resource(Config, {send_message, SentData})
-            )
-        end
-    ),
-    ok.
+        ],
+        showTSUID => false,
+        showQuery => false,
+        delete => false
+    },
+    opentsdb_request(Config, Path, Body, Opts).
 
-t_missing_data(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            send_message(Config, #{}),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-    ?assertMatch(
-        {error, {400, #{failed := 1, success := 0}}},
-        Result
-    ),
-    ok.
+opentsdb_request(Config, Path, Body) ->
+    opentsdb_request(Config, Path, Body, #{}).
 
-t_bad_data(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    Data = maps:without([metric], make_data()),
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            send_message(Config, Data),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-
-    ?assertMatch(
-        {error, {400, #{failed := 1, success := 0}}}, Result
-    ),
-    ok.
-
-make_data() ->
-    make_data(<<"cpu">>, 12).
+opentsdb_request(Config, Path, Body, Opts) ->
+    Host = ?config(bridge_host, Config),
+    Port = ?config(bridge_port, Config),
+    ServerURL = opents_server_url(Host, Port),
+    URL = <<ServerURL/binary, Path/binary>>,
+    emqx_mgmt_api_test_util:request_api(post, URL, [], [], Body, Opts).
 
 make_data(Metric, Value) ->
     #{
@@ -363,3 +211,45 @@ make_data(Metric, Value) ->
         },
         value => Value
     }.
+
+%%------------------------------------------------------------------------------
+%% Testcases
+%%------------------------------------------------------------------------------
+
+t_query_simple(Config) ->
+    Metric = <<"t_query_simple">>,
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_success_check/1, opents_bridge_on_query
+    ),
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"dps">> := _
+            }
+        ],
+        QResult
+    ),
+    [#{<<"dps">> := Dps}] = QResult,
+    ?assertMatch([Value | _], maps:values(Dps)).
+
+t_create_via_http(Config) ->
+    emqx_bridge_v2_testlib:t_create_via_http(Config).
+
+t_start_stop(Config) ->
+    emqx_bridge_v2_testlib:t_start_stop(Config, opents_bridge_stopped).
+
+t_on_get_status(Config) ->
+    emqx_bridge_v2_testlib:t_on_get_status(Config, #{failure_status => connecting}).
+
+t_query_invalid_data(Config) ->
+    Metric = <<"t_query_invalid_data">>,
+    Value = 12,
+    MakeMessageFun = fun() -> maps:remove(value, make_data(Metric, Value)) end,
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_error_check/1, opents_bridge_on_query
+    ).
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 655892d88..90c1ae1ce 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -52,6 +52,8 @@ resource_type(iotdb) ->
     emqx_bridge_iotdb_connector;
 resource_type(elasticsearch) ->
     emqx_bridge_es_connector;
+resource_type(opents) ->
+    emqx_bridge_opents_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -66,6 +68,8 @@ connector_impl_module(iotdb) ->
     emqx_bridge_iotdb_connector;
 connector_impl_module(elasticsearch) ->
     emqx_bridge_es_connector;
+connector_impl_module(opents) ->
+    emqx_bridge_opents_connector;
 connector_impl_module(_ConnectorType) ->
     undefined.
 
@@ -193,6 +197,14 @@ connector_structs() ->
                     desc => <<"ElasticSearch Connector Config">>,
                     required => false
                 }
+            )},
+        {opents,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_opents_connector, "config_connector")),
+                #{
+                    desc => <<"OpenTSDB Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -212,7 +224,8 @@ schema_modules() ->
         emqx_postgresql_connector_schema,
         emqx_bridge_redis_schema,
         emqx_bridge_iotdb_connector,
-        emqx_bridge_es_connector
+        emqx_bridge_es_connector,
+        emqx_bridge_opents_connector
     ].
 
 api_schemas(Method) ->
@@ -241,7 +254,8 @@ api_schemas(Method) ->
         api_ref(emqx_postgresql_connector_schema, <<"pgsql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_redis_schema, <<"redis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
-        api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method)
+        api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
+        api_ref(emqx_bridge_opents_connector, <<"opents">>, Method)
     ].
 
 api_ref(Module, Type, Method) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 615b89230..1829e04e6 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -154,7 +154,9 @@ connector_type_to_bridge_types(timescale) ->
 connector_type_to_bridge_types(iotdb) ->
     [iotdb];
 connector_type_to_bridge_types(elasticsearch) ->
-    [elasticsearch].
+    [elasticsearch];
+connector_type_to_bridge_types(opents) ->
+    [opents].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index ff44a9e18..5f1c4b0af 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -23,4 +23,35 @@ emqx_bridge_opents {
 
     desc_name.label:
         "Bridge Name"
+
+action_parameters_data.desc:
+"""OpenTSDB action parameter data"""
+
+action_parameters_data.label:
+"""Parameter Data"""
+
+config_parameters_timestamp.desc:
+"""Timestamp. Placeholders in format of ${var} is supported"""
+
+config_parameters_timestamp.label:
+"""Timestamp"""
+
+config_parameters_metric.metric:
+"""Metric. Placeholders in format of ${var} is supported"""
+
+config_parameters_metric.metric:
+"""Metric"""
+
+config_parameters_tags.desc:
+"""Data Type, Placeholders in format of ${var} is supported"""
+
+config_parameters_tags.label:
+"""Tags"""
+
+config_parameters_value.desc:
+"""Value. Placeholders in format of ${var} is supported"""
+
+config_parameters_value.label:
+"""Value"""
+
 }
diff --git a/rel/i18n/emqx_bridge_opents_connector.hocon b/rel/i18n/emqx_bridge_opents_connector.hocon
index 5c39d1e0e..a54c240a0 100644
--- a/rel/i18n/emqx_bridge_opents_connector.hocon
+++ b/rel/i18n/emqx_bridge_opents_connector.hocon
@@ -17,4 +17,10 @@ emqx_bridge_opents_connector {
 
     details.label:
         "Details"
+
+desc_config.desc:
+"""Configuration for OpenTSDB Connector."""
+
+desc_config.label:
+"""OpenTSDB Connector Configuration"""
 }

From 3f7b913e884294e5d13b8c16a78135060a13880c Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 18 Jan 2024 22:25:58 +0800
Subject: [PATCH 014/273] chore(opents): bump version && update changes

---
 apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src |  2 +-
 .../src/emqx_bridge_opents_connector.erl               |  7 ++++++-
 changes/ee/feat-12353.en.md                            |  1 +
 rel/i18n/emqx_bridge_opents.hocon                      | 10 ++++++++--
 4 files changed, 16 insertions(+), 4 deletions(-)
 create mode 100644 changes/ee/feat-12353.en.md

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src b/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
index 5e3b2f585..2469acaa8 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_opents, [
     {description, "EMQX Enterprise OpenTSDB Bridge"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index 6af1e2f55..e3fe9d6b4 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -56,7 +56,10 @@ fields(config) ->
 
 fields("config_connector") ->
     emqx_connector_schema:common_fields() ++
-        proplists_without([auto_reconnect], fields(config));
+        proplists_without([auto_reconnect], fields(config)) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
 fields("post") ->
     emqx_connector_schema:type_and_name_fields(enum([opents])) ++ fields("config_connector");
 fields("put") ->
@@ -66,6 +69,8 @@ fields("get") ->
 
 desc(config) ->
     ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc("config_connector") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
diff --git a/changes/ee/feat-12353.en.md b/changes/ee/feat-12353.en.md
new file mode 100644
index 000000000..2d34e1211
--- /dev/null
+++ b/changes/ee/feat-12353.en.md
@@ -0,0 +1 @@
+The bridges for OpentsDB have been split so it is available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index 5f1c4b0af..f5d2ade85 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -24,6 +24,12 @@ emqx_bridge_opents {
     desc_name.label:
         "Bridge Name"
 
+action_parameters.desc:
+"""OpenTSDB action parameters"""
+
+action_parameters.label:
+"""Parameters"""
+
 action_parameters_data.desc:
 """OpenTSDB action parameter data"""
 
@@ -36,10 +42,10 @@ config_parameters_timestamp.desc:
 config_parameters_timestamp.label:
 """Timestamp"""
 
-config_parameters_metric.metric:
+config_parameters_metric.desc:
 """Metric. Placeholders in format of ${var} is supported"""
 
-config_parameters_metric.metric:
+config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:

From 75b08b525b33ef50b9006a54631252ac753c4856 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 15 Jan 2024 16:52:59 -0300
Subject: [PATCH 015/273] feat(ds): add `list_generations` and
 `drop_generation` APIs

---
 apps/emqx/priv/bpapi.versions                 |   1 +
 apps/emqx_durable_storage/src/emqx_ds.erl     |  57 +++-
 .../src/emqx_ds_replication_layer.erl         |  45 ++-
 .../src/emqx_ds_storage_bitfield_lts.erl      |  16 +
 .../src/emqx_ds_storage_layer.erl             | 293 ++++++++++++++----
 .../src/emqx_ds_storage_reference.erl         |   8 +-
 .../src/proto/emqx_ds_proto_v3.erl            | 147 +++++++++
 .../test/emqx_ds_SUITE.erl                    | 250 ++++++++++++++-
 8 files changed, 755 insertions(+), 62 deletions(-)
 create mode 100644 apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl

diff --git a/apps/emqx/priv/bpapi.versions b/apps/emqx/priv/bpapi.versions
index 2777aec53..2b25cf4be 100644
--- a/apps/emqx/priv/bpapi.versions
+++ b/apps/emqx/priv/bpapi.versions
@@ -21,6 +21,7 @@
 {emqx_delayed,3}.
 {emqx_ds,1}.
 {emqx_ds,2}.
+{emqx_ds,3}.
 {emqx_eviction_agent,1}.
 {emqx_eviction_agent,2}.
 {emqx_exhook,1}.
diff --git a/apps/emqx_durable_storage/src/emqx_ds.erl b/apps/emqx_durable_storage/src/emqx_ds.erl
index d679f7097..434169520 100644
--- a/apps/emqx_durable_storage/src/emqx_ds.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds.erl
@@ -22,7 +22,14 @@
 -module(emqx_ds).
 
 %% Management API:
--export([open_db/2, update_db_config/2, add_generation/1, drop_db/1]).
+-export([
+    open_db/2,
+    update_db_config/2,
+    add_generation/1,
+    list_generations_with_lifetimes/1,
+    drop_generation/2,
+    drop_db/1
+]).
 
 %% Message storage API:
 -export([store_batch/2, store_batch/3]).
@@ -52,7 +59,10 @@
     get_iterator_result/1,
 
     ds_specific_stream/0,
-    ds_specific_iterator/0
+    ds_specific_iterator/0,
+    ds_specific_generation_rank/0,
+    generation_rank/0,
+    generation_info/0
 ]).
 
 %%================================================================================
@@ -80,6 +90,8 @@
 
 -type ds_specific_stream() :: term().
 
+-type ds_specific_generation_rank() :: term().
+
 -type message_key() :: binary().
 
 -type store_batch_result() :: ok | {error, _}.
@@ -114,6 +126,17 @@
 
 -type get_iterator_result(Iterator) :: {ok, Iterator} | undefined.
 
+%% An opaque term identifying a generation.  Each implementation will possibly add
+%% information to this term to match its inner structure (e.g.: by embedding the shard id,
+%% in the case of `emqx_ds_replication_layer').
+-opaque generation_rank() :: ds_specific_generation_rank().
+
+-type generation_info() :: #{
+    created_at := time(),
+    since := time(),
+    until := time() | undefined
+}.
+
 -define(persistent_term(DB), {emqx_ds_db_backend, DB}).
 
 -define(module(DB), (persistent_term:get(?persistent_term(DB)))).
@@ -128,6 +151,11 @@
 
 -callback update_db_config(db(), create_db_opts()) -> ok | {error, _}.
 
+-callback list_generations_with_lifetimes(db()) ->
+    #{generation_rank() => generation_info()}.
+
+-callback drop_generation(db(), generation_rank()) -> ok | {error, _}.
+
 -callback drop_db(db()) -> ok | {error, _}.
 
 -callback store_batch(db(), [emqx_types:message()], message_store_opts()) -> store_batch_result().
@@ -142,6 +170,11 @@
 
 -callback next(db(), Iterator, pos_integer()) -> next_result(Iterator).
 
+-optional_callbacks([
+    list_generations_with_lifetimes/1,
+    drop_generation/2
+]).
+
 %%================================================================================
 %% API funcions
 %%================================================================================
@@ -166,6 +199,26 @@ add_generation(DB) ->
 update_db_config(DB, Opts) ->
     ?module(DB):update_db_config(DB, Opts).
 
+-spec list_generations_with_lifetimes(db()) -> #{generation_rank() => generation_info()}.
+list_generations_with_lifetimes(DB) ->
+    Mod = ?module(DB),
+    case erlang:function_exported(Mod, list_generations_with_lifetimes, 1) of
+        true ->
+            Mod:list_generations_with_lifetimes(DB);
+        false ->
+            #{}
+    end.
+
+-spec drop_generation(db(), generation_rank()) -> ok | {error, _}.
+drop_generation(DB, GenId) ->
+    Mod = ?module(DB),
+    case erlang:function_exported(Mod, drop_generation, 2) of
+        true ->
+            Mod:drop_generation(DB, GenId);
+        false ->
+            {error, not_implemented}
+    end.
+
 %% @doc TODO: currently if one or a few shards are down, they won't be
 
 %% deleted.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
index 68d9459ee..387587570 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
@@ -25,6 +25,8 @@
     open_db/2,
     add_generation/1,
     update_db_config/2,
+    list_generations_with_lifetimes/1,
+    drop_generation/2,
     drop_db/1,
     store_batch/3,
     get_streams/3,
@@ -41,7 +43,9 @@
     do_make_iterator_v1/5,
     do_update_iterator_v2/4,
     do_next_v1/4,
-    do_add_generation_v2/1
+    do_add_generation_v2/1,
+    do_list_generations_with_lifetimes_v3/2,
+    do_drop_generation_v3/3
 ]).
 
 -export_type([shard_id/0, builtin_db_opts/0, stream/0, iterator/0, message_id/0, batch/0]).
@@ -104,6 +108,8 @@
     ?batch_messages := [emqx_types:message()]
 }.
 
+-type generation_rank() :: {shard_id(), term()}.
+
 %%================================================================================
 %% API functions
 %%================================================================================
@@ -135,6 +141,32 @@ add_generation(DB) ->
 update_db_config(DB, CreateOpts) ->
     emqx_ds_replication_layer_meta:update_db_config(DB, CreateOpts).
 
+-spec list_generations_with_lifetimes(emqx_ds:db()) ->
+    #{generation_rank() => emqx_ds:generation_info()}.
+list_generations_with_lifetimes(DB) ->
+    Shards = list_shards(DB),
+    lists:foldl(
+        fun(Shard, GensAcc) ->
+            Node = node_of_shard(DB, Shard),
+            maps:fold(
+                fun(GenId, Data, AccInner) ->
+                    AccInner#{{Shard, GenId} => Data}
+                end,
+                GensAcc,
+                emqx_ds_proto_v3:list_generations_with_lifetimes(Node, DB, Shard)
+            )
+        end,
+        #{},
+        Shards
+    ).
+
+-spec drop_generation(emqx_ds:db(), generation_rank()) -> ok | {error, _}.
+drop_generation(DB, {Shard, GenId}) ->
+    %% TODO: drop generation in all nodes in the replica set, not only in the leader,
+    %% after we have proper replication in place.
+    Node = node_of_shard(DB, Shard),
+    emqx_ds_proto_v3:drop_generation(Node, DB, Shard, GenId).
+
 -spec drop_db(emqx_ds:db()) -> ok | {error, _}.
 drop_db(DB) ->
     Nodes = list_nodes(),
@@ -301,7 +333,6 @@ do_next_v1(DB, Shard, Iter, BatchSize) ->
 -spec do_add_generation_v2(emqx_ds:db()) -> ok | {error, _}.
 do_add_generation_v2(DB) ->
     MyShards = emqx_ds_replication_layer_meta:my_owned_shards(DB),
-
     lists:foreach(
         fun(ShardId) ->
             emqx_ds_storage_layer:add_generation({DB, ShardId})
@@ -309,6 +340,16 @@ do_add_generation_v2(DB) ->
         MyShards
     ).
 
+-spec do_list_generations_with_lifetimes_v3(emqx_ds:db(), shard_id()) ->
+    #{emqx_ds:ds_specific_generation_rank() => emqx_ds:generation_info()}.
+do_list_generations_with_lifetimes_v3(DB, ShardId) ->
+    emqx_ds_storage_layer:list_generations_with_lifetimes({DB, ShardId}).
+
+-spec do_drop_generation_v3(emqx_ds:db(), shard_id(), emqx_ds_storage_layer:gen_id()) ->
+    ok | {error, _}.
+do_drop_generation_v3(DB, ShardId, GenId) ->
+    emqx_ds_storage_layer:drop_generation({DB, ShardId}, GenId).
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 4c59a5f62..27d41e6c6 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -27,6 +27,7 @@
 -export([
     create/4,
     open/5,
+    drop/5,
     store_batch/4,
     get_streams/4,
     make_iterator/5,
@@ -199,6 +200,21 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
         ts_offset = TSOffsetBits
     }.
 
+-spec drop(
+    emqx_ds_storage_layer:shard_id(),
+    rocksdb:db_handle(),
+    emqx_ds_storage_layer:gen_id(),
+    emqx_ds_storage_layer:cf_refs(),
+    s()
+) ->
+    ok.
+drop(_Shard, DBHandle, GenId, CFRefs, #s{}) ->
+    {_, DataCF} = lists:keyfind(data_cf(GenId), 1, CFRefs),
+    {_, TrieCF} = lists:keyfind(trie_cf(GenId), 1, CFRefs),
+    ok = rocksdb:drop_column_family(DBHandle, DataCF),
+    ok = rocksdb:drop_column_family(DBHandle, TrieCF),
+    ok.
+
 -spec store_batch(
     emqx_ds_storage_layer:shard_id(), s(), [emqx_types:message()], emqx_ds:message_store_opts()
 ) ->
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index ab64005b6..ed161d290 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -27,7 +27,9 @@
     update_iterator/3,
     next/3,
     update_config/2,
-    add_generation/1
+    add_generation/1,
+    list_generations_with_lifetimes/1,
+    drop_generation/2
 ]).
 
 %% gen_server
@@ -44,7 +46,8 @@
     iterator/0,
     shard_id/0,
     options/0,
-    prototype/0
+    prototype/0,
+    post_creation_context/0
 ]).
 
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
@@ -95,11 +98,18 @@
 
 %%%% Generation:
 
+-define(GEN_KEY(GEN_ID), {generation, GEN_ID}).
+
 -type generation(Data) :: #{
     %% Module that handles data for the generation:
     module := module(),
     %% Module-specific data defined at generation creation time:
     data := Data,
+    %% Column families used by this generation
+    cf_refs := cf_refs(),
+    %% Time at which this was created.  Might differ from `since', in particular for the
+    %% first generation.
+    created_at := emqx_ds:time(),
     %% When should this generation become active?
     %% This generation should only contain messages timestamped no earlier than that.
     %% The very first generation will have `since` equal 0.
@@ -121,7 +131,7 @@
     %% This data is used to create new generation:
     prototype := prototype(),
     %% Generations:
-    {generation, gen_id()} => GenData
+    ?GEN_KEY(gen_id()) => GenData
 }.
 
 %% Shard schema (persistent):
@@ -132,6 +142,18 @@
 
 -type options() :: map().
 
+-type post_creation_context() ::
+    #{
+        shard_id := emqx_ds_storage_layer:shard_id(),
+        db := rocksdb:db_handle(),
+        new_gen_id := emqx_ds_storage_layer:gen_id(),
+        old_gen_id := emqx_ds_storage_layer:gen_id(),
+        new_cf_refs := cf_refs(),
+        old_cf_refs := cf_refs(),
+        new_gen_runtime_data := _NewData,
+        old_gen_runtime_data := _OldData
+    }.
+
 %%================================================================================
 %% Generation callbacks
 %%================================================================================
@@ -145,6 +167,9 @@
 -callback open(shard_id(), rocksdb:db_handle(), gen_id(), cf_refs(), _Schema) ->
     _Data.
 
+-callback drop(shard_id(), rocksdb:db_handle(), gen_id(), cf_refs(), _RuntimeData) ->
+    ok | {error, _Reason}.
+
 -callback store_batch(shard_id(), _Data, [emqx_types:message()], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
 
@@ -157,10 +182,17 @@
 -callback next(shard_id(), _Data, Iter, pos_integer()) ->
     {ok, Iter, [emqx_types:message()]} | {error, _}.
 
+-callback post_creation_actions(post_creation_context()) -> _Data.
+
+-optional_callbacks([post_creation_actions/1]).
+
 %%================================================================================
 %% API for the replication layer
 %%================================================================================
 
+-record(call_list_generations_with_lifetimes, {}).
+-record(call_drop_generation, {gen_id :: gen_id()}).
+
 -spec open_shard(shard_id(), options()) -> ok.
 open_shard(Shard, Options) ->
     emqx_ds_storage_layer_sup:ensure_shard(Shard, Options).
@@ -182,18 +214,25 @@ store_batch(Shard, Messages, Options) ->
     [{integer(), stream()}].
 get_streams(Shard, TopicFilter, StartTime) ->
     Gens = generations_since(Shard, StartTime),
+    ?tp(get_streams_all_gens, #{gens => Gens}),
     lists:flatmap(
         fun(GenId) ->
-            #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-            Streams = Mod:get_streams(Shard, GenData, TopicFilter, StartTime),
-            [
-                {GenId, #{
-                    ?tag => ?STREAM,
-                    ?generation => GenId,
-                    ?enc => Stream
-                }}
-             || Stream <- Streams
-            ]
+            ?tp(get_streams_get_gen, #{gen_id => GenId}),
+            case generation_get_safe(Shard, GenId) of
+                {ok, #{module := Mod, data := GenData}} ->
+                    Streams = Mod:get_streams(Shard, GenData, TopicFilter, StartTime),
+                    [
+                        {GenId, #{
+                            ?tag => ?STREAM,
+                            ?generation => GenId,
+                            ?enc => Stream
+                        }}
+                     || Stream <- Streams
+                    ];
+                {error, not_found} ->
+                    %% race condition: generation was dropped before getting its streams?
+                    []
+            end
         end,
         Gens
     ).
@@ -203,16 +242,20 @@ get_streams(Shard, TopicFilter, StartTime) ->
 make_iterator(
     Shard, #{?tag := ?STREAM, ?generation := GenId, ?enc := Stream}, TopicFilter, StartTime
 ) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    case Mod:make_iterator(Shard, GenData, Stream, TopicFilter, StartTime) of
-        {ok, Iter} ->
-            {ok, #{
-                ?tag => ?IT,
-                ?generation => GenId,
-                ?enc => Iter
-            }};
-        {error, _} = Err ->
-            Err
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            case Mod:make_iterator(Shard, GenData, Stream, TopicFilter, StartTime) of
+                {ok, Iter} ->
+                    {ok, #{
+                        ?tag => ?IT,
+                        ?generation => GenId,
+                        ?enc => Iter
+                    }};
+                {error, _} = Err ->
+                    Err
+            end;
+        {error, not_found} ->
+            {error, end_of_stream}
     end.
 
 -spec update_iterator(
@@ -224,33 +267,42 @@ update_iterator(
     #{?tag := ?IT, ?generation := GenId, ?enc := OldIter},
     DSKey
 ) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    case Mod:update_iterator(Shard, GenData, OldIter, DSKey) of
-        {ok, Iter} ->
-            {ok, #{
-                ?tag => ?IT,
-                ?generation => GenId,
-                ?enc => Iter
-            }};
-        {error, _} = Err ->
-            Err
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            case Mod:update_iterator(Shard, GenData, OldIter, DSKey) of
+                {ok, Iter} ->
+                    {ok, #{
+                        ?tag => ?IT,
+                        ?generation => GenId,
+                        ?enc => Iter
+                    }};
+                {error, _} = Err ->
+                    Err
+            end;
+        {error, not_found} ->
+            {error, end_of_stream}
     end.
 
 -spec next(shard_id(), iterator(), pos_integer()) ->
     emqx_ds:next_result(iterator()).
 next(Shard, Iter = #{?tag := ?IT, ?generation := GenId, ?enc := GenIter0}, BatchSize) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    Current = generation_current(Shard),
-    case Mod:next(Shard, GenData, GenIter0, BatchSize) of
-        {ok, _GenIter, []} when GenId < Current ->
-            %% This is a past generation. Storage layer won't write
-            %% any more messages here. The iterator reached the end:
-            %% the stream has been fully replayed.
-            {ok, end_of_stream};
-        {ok, GenIter, Batch} ->
-            {ok, Iter#{?enc := GenIter}, Batch};
-        Error = {error, _} ->
-            Error
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            Current = generation_current(Shard),
+            case Mod:next(Shard, GenData, GenIter0, BatchSize) of
+                {ok, _GenIter, []} when GenId < Current ->
+                    %% This is a past generation. Storage layer won't write
+                    %% any more messages here. The iterator reached the end:
+                    %% the stream has been fully replayed.
+                    {ok, end_of_stream};
+                {ok, GenIter, Batch} ->
+                    {ok, Iter#{?enc := GenIter}, Batch};
+                Error = {error, _} ->
+                    Error
+            end;
+        {error, not_found} ->
+            %% generation was possibly dropped by GC
+            {ok, end_of_stream}
     end.
 
 -spec update_config(shard_id(), emqx_ds:create_db_opts()) -> ok.
@@ -261,6 +313,21 @@ update_config(ShardId, Options) ->
 add_generation(ShardId) ->
     gen_server:call(?REF(ShardId), add_generation, infinity).
 
+-spec list_generations_with_lifetimes(shard_id()) ->
+    #{
+        gen_id() => #{
+            created_at := emqx_ds:time(),
+            since := emqx_ds:time(),
+            until := undefined | emqx_ds:time()
+        }
+    }.
+list_generations_with_lifetimes(ShardId) ->
+    gen_server:call(?REF(ShardId), #call_list_generations_with_lifetimes{}, infinity).
+
+-spec drop_generation(shard_id(), gen_id()) -> ok.
+drop_generation(ShardId, GenId) ->
+    gen_server:call(?REF(ShardId), #call_drop_generation{gen_id = GenId}, infinity).
+
 %%================================================================================
 %% gen_server for the shard
 %%================================================================================
@@ -322,6 +389,13 @@ handle_call(add_generation, _From, S0) ->
     S = add_generation(S0, Since),
     commit_metadata(S),
     {reply, ok, S};
+handle_call(#call_list_generations_with_lifetimes{}, _From, S) ->
+    Generations = handle_list_generations_with_lifetimes(S),
+    {reply, Generations, S};
+handle_call(#call_drop_generation{gen_id = GenId}, _From, S0) ->
+    {Reply, S} = handle_drop_generation(S0, GenId),
+    commit_metadata(S),
+    {reply, Reply, S};
 handle_call(#call_create_generation{since = Since}, _From, S0) ->
     S = add_generation(S0, Since),
     commit_metadata(S),
@@ -353,7 +427,7 @@ open_shard(ShardId, DB, CFRefs, ShardSchema) ->
     %% Transform generation schemas to generation runtime data:
     maps:map(
         fun
-            ({generation, GenId}, GenSchema) ->
+            (?GEN_KEY(GenId), GenSchema) ->
                 open_generation(ShardId, DB, CFRefs, GenId, GenSchema);
             (_K, Val) ->
                 Val
@@ -366,10 +440,40 @@ add_generation(S0, Since) ->
     #s{shard_id = ShardId, db = DB, schema = Schema0, shard = Shard0, cf_refs = CFRefs0} = S0,
     Schema1 = update_last_until(Schema0, Since),
     Shard1 = update_last_until(Shard0, Since),
+
+    #{current_generation := OldGenId, prototype := {CurrentMod, _ModConf}} = Schema0,
+    OldKey = ?GEN_KEY(OldGenId),
+    #{OldKey := OldGenSchema} = Schema0,
+    #{cf_refs := OldCFRefs} = OldGenSchema,
+    #{OldKey := #{module := OldMod, data := OldGenData}} = Shard0,
+
     {GenId, Schema, NewCFRefs} = new_generation(ShardId, DB, Schema1, Since),
+
     CFRefs = NewCFRefs ++ CFRefs0,
-    Key = {generation, GenId},
-    Generation = open_generation(ShardId, DB, CFRefs, GenId, maps:get(Key, Schema)),
+    Key = ?GEN_KEY(GenId),
+    Generation0 =
+        #{data := NewGenData0} =
+        open_generation(ShardId, DB, CFRefs, GenId, maps:get(Key, Schema)),
+
+    %% When the new generation's module is the same as the last one, we might want to
+    %% perform actions like inheriting some of the previous (meta)data.
+    NewGenData =
+        run_post_creation_actions(
+            #{
+                shard_id => ShardId,
+                db => DB,
+                new_gen_id => GenId,
+                old_gen_id => OldGenId,
+                new_cf_refs => NewCFRefs,
+                old_cf_refs => OldCFRefs,
+                new_gen_runtime_data => NewGenData0,
+                old_gen_runtime_data => OldGenData,
+                new_module => CurrentMod,
+                old_module => OldMod
+            }
+        ),
+    Generation = Generation0#{data := NewGenData},
+
     Shard = Shard1#{current_generation := GenId, Key => Generation},
     S0#s{
         cf_refs = CFRefs,
@@ -377,6 +481,54 @@ add_generation(S0, Since) ->
         shard = Shard
     }.
 
+-spec handle_list_generations_with_lifetimes(server_state()) -> #{gen_id() => map()}.
+handle_list_generations_with_lifetimes(#s{schema = ShardSchema}) ->
+    maps:fold(
+        fun
+            (?GEN_KEY(GenId), GenSchema, Acc) ->
+                Acc#{GenId => export_generation(GenSchema)};
+            (_Key, _Value, Acc) ->
+                Acc
+        end,
+        #{},
+        ShardSchema
+    ).
+
+-spec export_generation(generation_schema()) -> map().
+export_generation(GenSchema) ->
+    maps:with([created_at, since, until], GenSchema).
+
+-spec handle_drop_generation(server_state(), gen_id()) ->
+    {ok | {error, current_generation}, server_state()}.
+handle_drop_generation(#s{schema = #{current_generation := GenId}} = S0, GenId) ->
+    {{error, current_generation}, S0};
+handle_drop_generation(#s{schema = Schema} = S0, GenId) when
+    not is_map_key(?GEN_KEY(GenId), Schema)
+->
+    {{error, not_found}, S0};
+handle_drop_generation(S0, GenId) ->
+    #s{
+        shard_id = ShardId,
+        db = DB,
+        schema = #{?GEN_KEY(GenId) := GenSchema} = OldSchema,
+        shard = OldShard,
+        cf_refs = OldCFRefs
+    } = S0,
+    #{module := Mod, cf_refs := GenCFRefs} = GenSchema,
+    #{?GEN_KEY(GenId) := #{data := RuntimeData}} = OldShard,
+    case Mod:drop(ShardId, DB, GenId, GenCFRefs, RuntimeData) of
+        ok ->
+            CFRefs = OldCFRefs -- GenCFRefs,
+            Shard = maps:remove(?GEN_KEY(GenId), OldShard),
+            Schema = maps:remove(?GEN_KEY(GenId), OldSchema),
+            S = S0#s{
+                cf_refs = CFRefs,
+                shard = Shard,
+                schema = Schema
+            },
+            {ok, S}
+    end.
+
 -spec open_generation(shard_id(), rocksdb:db_handle(), cf_refs(), gen_id(), generation_schema()) ->
     generation().
 open_generation(ShardId, DB, CFRefs, GenId, GenSchema) ->
@@ -403,10 +555,17 @@ new_generation(ShardId, DB, Schema0, Since) ->
     #{current_generation := PrevGenId, prototype := {Mod, ModConf}} = Schema0,
     GenId = PrevGenId + 1,
     {GenData, NewCFRefs} = Mod:create(ShardId, DB, GenId, ModConf),
-    GenSchema = #{module => Mod, data => GenData, since => Since, until => undefined},
+    GenSchema = #{
+        module => Mod,
+        data => GenData,
+        cf_refs => NewCFRefs,
+        created_at => emqx_message:timestamp_now(),
+        since => Since,
+        until => undefined
+    },
     Schema = Schema0#{
         current_generation => GenId,
-        {generation, GenId} => GenSchema
+        ?GEN_KEY(GenId) => GenSchema
     },
     {GenId, Schema, NewCFRefs}.
 
@@ -453,9 +612,26 @@ db_dir({DB, ShardId}) ->
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->
     #{current_generation := GenId} = Schema,
-    GenData0 = maps:get({generation, GenId}, Schema),
+    GenData0 = maps:get(?GEN_KEY(GenId), Schema),
     GenData = GenData0#{until := Until},
-    Schema#{{generation, GenId} := GenData}.
+    Schema#{?GEN_KEY(GenId) := GenData}.
+
+run_post_creation_actions(
+    #{
+        new_module := Mod,
+        old_module := Mod,
+        new_gen_runtime_data := NewGenData
+    } = Context
+) ->
+    case erlang:function_exported(Mod, post_creation_actions, 1) of
+        true ->
+            Mod:post_creation_actions(Context);
+        false ->
+            NewGenData
+    end;
+run_post_creation_actions(#{new_gen_runtime_data := NewGenData}) ->
+    %% Different implementation modules
+    NewGenData.
 
 %%--------------------------------------------------------------------------------
 %% Schema access
@@ -468,15 +644,24 @@ generation_current(Shard) ->
 
 -spec generation_get(shard_id(), gen_id()) -> generation().
 generation_get(Shard, GenId) ->
-    #{{generation, GenId} := GenData} = get_schema_runtime(Shard),
+    {ok, GenData} = generation_get_safe(Shard, GenId),
     GenData.
 
+-spec generation_get_safe(shard_id(), gen_id()) -> {ok, generation()} | {error, not_found}.
+generation_get_safe(Shard, GenId) ->
+    case get_schema_runtime(Shard) of
+        #{?GEN_KEY(GenId) := GenData} ->
+            {ok, GenData};
+        #{} ->
+            {error, not_found}
+    end.
+
 -spec generations_since(shard_id(), emqx_ds:time()) -> [gen_id()].
 generations_since(Shard, Since) ->
     Schema = get_schema_runtime(Shard),
     maps:fold(
         fun
-            ({generation, GenId}, #{until := Until}, Acc) when Until >= Since ->
+            (?GEN_KEY(GenId), #{until := Until}, Acc) when Until >= Since ->
                 [GenId | Acc];
             (_K, _V, Acc) ->
                 Acc
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
index da7ac79f6..c958e56dc 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
@@ -30,6 +30,7 @@
 -export([
     create/4,
     open/5,
+    drop/5,
     store_batch/4,
     get_streams/4,
     make_iterator/5,
@@ -85,6 +86,10 @@ open(_Shard, DBHandle, GenId, CFRefs, #schema{}) ->
     {_, CF} = lists:keyfind(data_cf(GenId), 1, CFRefs),
     #s{db = DBHandle, cf = CF}.
 
+drop(_ShardId, DBHandle, _GenId, _CFRefs, #s{cf = CFHandle}) ->
+    ok = rocksdb:drop_column_family(DBHandle, CFHandle),
+    ok.
+
 store_batch(_ShardId, #s{db = DB, cf = CF}, Messages, _Options) ->
     lists:foreach(
         fun(Msg) ->
@@ -142,7 +147,8 @@ do_next(TopicFilter, StartTime, IT, Action, NLeft, Key0, Acc) ->
     case rocksdb:iterator_move(IT, Action) of
         {ok, Key, Blob} ->
             Msg = #message{topic = Topic, timestamp = TS} = binary_to_term(Blob),
-            case emqx_topic:match(Topic, TopicFilter) andalso TS >= StartTime of
+            TopicWords = emqx_topic:words(Topic),
+            case emqx_topic:match(TopicWords, TopicFilter) andalso TS >= StartTime of
                 true ->
                     do_next(TopicFilter, StartTime, IT, next, NLeft - 1, Key, [{Key, Msg} | Acc]);
                 false ->
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
new file mode 100644
index 000000000..74a174c4c
--- /dev/null
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
@@ -0,0 +1,147 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_ds_proto_v3).
+
+-behavior(emqx_bpapi).
+
+-include_lib("emqx_utils/include/bpapi.hrl").
+%% API:
+-export([
+    drop_db/2,
+    store_batch/5,
+    get_streams/5,
+    make_iterator/6,
+    next/5,
+    update_iterator/5,
+    add_generation/2,
+
+    %% introduced in v3
+    list_generations_with_lifetimes/3,
+    drop_generation/4
+]).
+
+%% behavior callbacks:
+-export([introduced_in/0]).
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec drop_db([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+drop_db(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_drop_db_v1, [DB]).
+
+-spec get_streams(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    [{integer(), emqx_ds_storage_layer:stream()}].
+get_streams(Node, DB, Shard, TopicFilter, Time) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v1, [DB, Shard, TopicFilter, Time]).
+
+-spec make_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:stream(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+make_iterator(Node, DB, Shard, Stream, TopicFilter, StartTime) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_make_iterator_v1, [
+        DB, Shard, Stream, TopicFilter, StartTime
+    ]).
+
+-spec next(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    pos_integer()
+) ->
+    {ok, emqx_ds_storage_layer:iterator(), [{emqx_ds:message_key(), [emqx_types:message()]}]}
+    | {ok, end_of_stream}
+    | {error, _}.
+next(Node, DB, Shard, Iter, BatchSize) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_next_v1, [DB, Shard, Iter, BatchSize]).
+
+-spec store_batch(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_replication_layer:batch(),
+    emqx_ds:message_store_opts()
+) ->
+    emqx_ds:store_batch_result().
+store_batch(Node, DB, Shard, Batch, Options) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_store_batch_v1, [
+        DB, Shard, Batch, Options
+    ]).
+
+-spec update_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    emqx_ds:message_key()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+update_iterator(Node, DB, Shard, OldIter, DSKey) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_update_iterator_v2, [
+        DB, Shard, OldIter, DSKey
+    ]).
+
+-spec add_generation([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+add_generation(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_add_generation_v2, [DB]).
+
+%%--------------------------------------------------------------------------------
+%% Introduced in V3
+%%--------------------------------------------------------------------------------
+
+-spec list_generations_with_lifetimes(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id()
+) ->
+    #{
+        emqx_ds:ds_specific_generation_rank() => emqx_ds:generation_info()
+    }.
+list_generations_with_lifetimes(Node, DB, Shard) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_list_generations_with_lifetimes_v3, [DB, Shard]).
+
+-spec drop_generation(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:gen_id()
+) ->
+    ok | {error, _}.
+drop_generation(Node, DB, Shard, GenId) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_drop_generation_v3, [DB, Shard, GenId]).
+
+%%================================================================================
+%% behavior callbacks
+%%================================================================================
+
+introduced_in() ->
+    "5.6.0".
diff --git a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
index cb9d81580..d7dccccf5 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
@@ -155,7 +155,7 @@ t_05_update_iterator(_Config) ->
     ?assertEqual(Msgs, AllMsgs, #{from_key => Iter1, final_iter => FinalIter}),
     ok.
 
-t_05_update_config(_Config) ->
+t_06_update_config(_Config) ->
     DB = ?FUNCTION_NAME,
     ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
     TopicFilter = ['#'],
@@ -199,7 +199,7 @@ t_05_update_config(_Config) ->
     end,
     lists:foldl(Checker, [], lists:zip(StartTimes, MsgsList)).
 
-t_06_add_generation(_Config) ->
+t_07_add_generation(_Config) ->
     DB = ?FUNCTION_NAME,
     ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
     TopicFilter = ['#'],
@@ -243,6 +243,250 @@ t_06_add_generation(_Config) ->
     end,
     lists:foldl(Checker, [], lists:zip(StartTimes, MsgsList)).
 
+%% Verifies the basic usage of `list_generations_with_lifetimes' and `drop_generation'...
+%%   1) Cannot drop current generation.
+%%   2) All existing generations are returned by `list_generation_with_lifetimes'.
+%%   3) Dropping a generation removes it from the list.
+%%   4) Dropped generations stay dropped even after restarting the application.
+t_08_smoke_list_drop_generation(_Config) ->
+    DB = ?FUNCTION_NAME,
+    ?check_trace(
+        begin
+            ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+            %% Exactly one generation at first.
+            Generations0 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{_GenId, #{since := _, until := _}}],
+                maps:to_list(Generations0),
+                #{gens => Generations0}
+            ),
+            [{GenId0, _}] = maps:to_list(Generations0),
+            %% Cannot delete current generation
+            ?assertEqual({error, current_generation}, emqx_ds:drop_generation(DB, GenId0)),
+
+            %% New gen
+            ok = emqx_ds:add_generation(DB),
+            Generations1 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [
+                    {GenId0, #{since := _, until := _}},
+                    {_GenId1, #{since := _, until := _}}
+                ],
+                lists:sort(maps:to_list(Generations1)),
+                #{gens => Generations1}
+            ),
+            [GenId0, GenId1] = lists:sort(maps:keys(Generations1)),
+
+            %% Drop the older one
+            ?assertEqual(ok, emqx_ds:drop_generation(DB, GenId0)),
+            Generations2 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{GenId1, #{since := _, until := _}}],
+                lists:sort(maps:to_list(Generations2)),
+                #{gens => Generations2}
+            ),
+
+            %% Unknown gen_id, as it was already dropped
+            ?assertEqual({error, not_found}, emqx_ds:drop_generation(DB, GenId0)),
+
+            %% Should persist surviving generation list
+            ok = application:stop(emqx_durable_storage),
+            {ok, _} = application:ensure_all_started(emqx_durable_storage),
+            ok = emqx_ds:open_db(DB, opts()),
+
+            Generations3 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{GenId1, #{since := _, until := _}}],
+                lists:sort(maps:to_list(Generations3)),
+                #{gens => Generations3}
+            ),
+
+            ok
+        end,
+        []
+    ),
+    ok.
+
+t_drop_generation_with_never_used_iterator(_Config) ->
+    %% This test checks how the iterator behaves when:
+    %%   1) it's created at generation 1 and not consumed from.
+    %%   2) generation 2 is created and 1 dropped.
+    %%   3) iteration begins.
+    %% In this case, the iterator won't see any messages and the stream will end.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    Now = emqx_message:timestamp_now(),
+    Msgs1 = [
+        message(<<"foo/bar">>, <<"3">>, Now + 100),
+        message(<<"foo/baz">>, <<"4">>, Now + 101)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs1)),
+
+    ?assertMatch({ok, end_of_stream, []}, iterate(DB, Iter0, 1)),
+
+    %% New iterator for the new stream will only see the later messages.
+    [{_, Stream1}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    ?assertNotEqual(Stream0, Stream1),
+    {ok, Iter1} = emqx_ds:make_iterator(DB, Stream1, TopicFilter, StartTime),
+
+    {ok, Iter, Batch} = iterate(DB, Iter1, 1),
+    ?assertNotEqual(end_of_stream, Iter),
+    ?assertEqual(Msgs1, [Msg || {_Key, Msg} <- Batch]),
+
+    ok.
+
+t_drop_generation_with_used_once_iterator(_Config) ->
+    %% This test checks how the iterator behaves when:
+    %%   1) it's created at generation 1 and consumes at least 1 message.
+    %%   2) generation 2 is created and 1 dropped.
+    %%   3) iteration continues.
+    %% In this case, the iterator should see no more messages and the stream will end.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 =
+        [Msg0 | _] = [
+            message(<<"foo/bar">>, <<"1">>, 0),
+            message(<<"foo/baz">>, <<"2">>, 1)
+        ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+    {ok, Iter1, Batch1} = emqx_ds:next(DB, Iter0, 1),
+    ?assertNotEqual(end_of_stream, Iter1),
+    ?assertEqual([Msg0], [Msg || {_Key, Msg} <- Batch1]),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    Now = emqx_message:timestamp_now(),
+    Msgs1 = [
+        message(<<"foo/bar">>, <<"3">>, Now + 100),
+        message(<<"foo/baz">>, <<"4">>, Now + 101)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs1)),
+
+    ?assertMatch({ok, end_of_stream, []}, iterate(DB, Iter1, 1)),
+
+    ok.
+
+t_drop_generation_update_iterator(_Config) ->
+    %% This checks the behavior of `emqx_ds:update_iterator' after the generation
+    %% underlying the iterator has been dropped.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+    {ok, Iter1, _Batch1} = emqx_ds:next(DB, Iter0, 1),
+    {ok, _Iter2, [{Key2, _Msg}]} = emqx_ds:next(DB, Iter1, 1),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    ?assertEqual({error, end_of_stream}, emqx_ds:update_iterator(DB, Iter1, Key2)),
+
+    ok.
+
+t_make_iterator_stale_stream(_Config) ->
+    %% This checks the behavior of `emqx_ds:make_iterator' after the generation underlying
+    %% the stream has been dropped.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    ?assertEqual(
+        {error, end_of_stream},
+        emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime)
+    ),
+
+    ok.
+
+t_get_streams_concurrently_with_drop_generation(_Config) ->
+    %% This checks that we can get all streams while a generation is dropped
+    %% mid-iteration.
+
+    DB = ?FUNCTION_NAME,
+    ?check_trace(
+        #{timetrap => 5_000},
+        begin
+            ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+
+            [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+            ok = emqx_ds:add_generation(DB),
+            ok = emqx_ds:add_generation(DB),
+
+            %% All streams
+            TopicFilter = emqx_topic:words(<<"foo/+">>),
+            StartTime = 0,
+            ?assertMatch([_, _, _], emqx_ds:get_streams(DB, TopicFilter, StartTime)),
+
+            ?force_ordering(
+                #{?snk_kind := dropped_gen},
+                #{?snk_kind := get_streams_get_gen}
+            ),
+
+            spawn_link(fun() ->
+                {ok, _} = ?block_until(#{?snk_kind := get_streams_all_gens}),
+                ok = emqx_ds:drop_generation(DB, GenId0),
+                ?tp(dropped_gen, #{})
+            end),
+
+            ?assertMatch([_, _], emqx_ds:get_streams(DB, TopicFilter, StartTime)),
+
+            ok
+        end,
+        []
+    ),
+
+    ok.
+
 update_data_set() ->
     [
         [
@@ -295,7 +539,7 @@ iterate(DB, It0, BatchSize, Acc) ->
         {ok, It, Msgs} ->
             iterate(DB, It, BatchSize, Acc ++ Msgs);
         {ok, end_of_stream} ->
-            {ok, It0, Acc};
+            {ok, end_of_stream, Acc};
         Ret ->
             Ret
     end.

From db710c4be59914edc987bf951e85d62960d6593e Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 18 Jan 2024 14:28:13 -0300
Subject: [PATCH 016/273] feat(lts): inherit previous generation's lts when
 possible

---
 apps/emqx_durable_storage/src/emqx_ds_lts.erl | 11 ++++++-
 .../src/emqx_ds_storage_bitfield_lts.erl      | 30 ++++++++++++++++-
 .../emqx_ds_storage_bitfield_lts_SUITE.erl    | 33 +++++++++++++++++++
 3 files changed, 72 insertions(+), 2 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
index bcf95852d..9d87cf571 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
@@ -18,7 +18,12 @@
 
 %% API:
 -export([
-    trie_create/1, trie_create/0, trie_restore/2, topic_key/3, match_topics/2, lookup_topic_key/2
+    trie_create/1, trie_create/0,
+    trie_restore/2,
+    trie_restore_existing/2,
+    topic_key/3,
+    match_topics/2,
+    lookup_topic_key/2
 ]).
 
 %% Debug:
@@ -115,6 +120,10 @@ trie_create() ->
 -spec trie_restore(options(), [{_Key, _Val}]) -> trie().
 trie_restore(Options, Dump) ->
     Trie = trie_create(Options),
+    trie_restore_existing(Trie, Dump).
+
+-spec trie_restore_existing(trie(), [{_Key, _Val}]) -> trie().
+trie_restore_existing(Trie, Dump) ->
     lists:foreach(
         fun({{StateFrom, Token}, StateTo}) ->
             trie_insert(Trie, StateFrom, Token, StateTo)
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 27d41e6c6..2a3086a57 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -32,7 +32,8 @@
     get_streams/4,
     make_iterator/5,
     update_iterator/4,
-    next/4
+    next/4,
+    post_creation_actions/1
 ]).
 
 %% internal exports:
@@ -200,6 +201,22 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
         ts_offset = TSOffsetBits
     }.
 
+-spec post_creation_actions(emqx_ds_storage_layer:post_creation_context()) ->
+    s().
+post_creation_actions(
+    #{
+        db := DBHandle,
+        old_gen_id := OldGenId,
+        old_cf_refs := OldCFRefs,
+        new_gen_runtime_data := NewGenData0
+    }
+) ->
+    {_, OldTrieCF} = lists:keyfind(trie_cf(OldGenId), 1, OldCFRefs),
+    #s{trie = NewTrie0} = NewGenData0,
+    NewTrie = copy_previous_trie(DBHandle, NewTrie0, OldTrieCF),
+    ?tp(bitfield_lts_inherited_trie, #{}),
+    NewGenData0#s{trie = NewTrie}.
+
 -spec drop(
     emqx_ds_storage_layer:shard_id(),
     rocksdb:db_handle(),
@@ -516,6 +533,17 @@ restore_trie(TopicIndexBytes, DB, CF) ->
         rocksdb:iterator_close(IT)
     end.
 
+-spec copy_previous_trie(rocksdb:db_handle(), emqx_ds_lts:trie(), rocksdb:cf_handle()) ->
+    emqx_ds_lts:trie().
+copy_previous_trie(DBHandle, NewTrie, OldCF) ->
+    {ok, IT} = rocksdb:iterator(DBHandle, OldCF, []),
+    try
+        OldDump = read_persisted_trie(IT, rocksdb:iterator_move(IT, first)),
+        emqx_ds_lts:trie_restore_existing(NewTrie, OldDump)
+    after
+        rocksdb:iterator_close(IT)
+    end.
+
 read_persisted_trie(IT, {ok, KeyB, ValB}) ->
     [
         {binary_to_term(KeyB), binary_to_term(ValB)}
diff --git a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
index 03ff1a6cb..5d32143a7 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
@@ -131,6 +131,39 @@ t_get_streams(_Config) ->
     ?assert(lists:member(A, AllStreams)),
     ok.
 
+t_new_generation_inherit_trie(_Config) ->
+    %% This test checks that we inherit the previous generation's LTS when creating a new
+    %% generation.
+    ?check_trace(
+        begin
+            %% Create a bunch of topics to be learned in the first generation
+            Timestamps = lists:seq(1, 10_000, 100),
+            Batch = [
+                begin
+                    B = integer_to_binary(I),
+                    make_message(
+                        TS,
+                        <<"wildcard/", B/binary, "/suffix/", Suffix/binary>>,
+                        integer_to_binary(TS)
+                    )
+                end
+             || I <- lists:seq(1, 200),
+                TS <- Timestamps,
+                Suffix <- [<<"foo">>, <<"bar">>]
+            ],
+            ok = emqx_ds_storage_layer:store_batch(?SHARD, Batch, []),
+            %% Now we create a new generation with the same LTS module.  It should inherit the
+            %% learned trie.
+            ok = emqx_ds_storage_layer:add_generation(?SHARD),
+            ok
+        end,
+        fun(Trace) ->
+            ?assertMatch([_], ?of_kind(bitfield_lts_inherited_trie, Trace)),
+            ok
+        end
+    ),
+    ok.
+
 t_replay(_Config) ->
     %% Create concrete topics:
     Topics = [<<"foo/bar">>, <<"foo/bar/baz">>],

From 7035b4c8b3fc6c8ced3d0b623bc7144f80348044 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 18 Jan 2024 14:28:37 -0300
Subject: [PATCH 017/273] feat(ps): add message gc

---
 .../emqx_persistent_message_ds_gc_worker.erl  | 157 ++++++++++++++++++
 .../src/emqx_persistent_session_ds_sup.erl    |   5 +-
 apps/emqx/src/emqx_schema.erl                 |   8 +
 .../test/emqx_persistent_messages_SUITE.erl   |  87 +++++++++-
 changes/ce/feat-12338.en.md                   |   1 +
 rel/i18n/emqx_schema.hocon                    |   3 +
 6 files changed, 257 insertions(+), 4 deletions(-)
 create mode 100644 apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
 create mode 100644 changes/ce/feat-12338.en.md

diff --git a/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
new file mode 100644
index 000000000..b960eae9e
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
@@ -0,0 +1,157 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_persistent_message_ds_gc_worker).
+
+-behaviour(gen_server).
+
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("stdlib/include/qlc.hrl").
+-include_lib("stdlib/include/ms_transform.hrl").
+
+-include("emqx_persistent_session_ds.hrl").
+
+%% API
+-export([
+    start_link/0,
+    gc/0
+]).
+
+%% `gen_server' API
+-export([
+    init/1,
+    handle_call/3,
+    handle_cast/2,
+    handle_info/2
+]).
+
+%% call/cast/info records
+-record(gc, {}).
+
+%%--------------------------------------------------------------------------------
+%% API
+%%--------------------------------------------------------------------------------
+
+start_link() ->
+    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
+
+%% For testing or manual ops
+gc() ->
+    gen_server:call(?MODULE, #gc{}, infinity).
+
+%%--------------------------------------------------------------------------------
+%% `gen_server' API
+%%--------------------------------------------------------------------------------
+
+init(_Opts) ->
+    ensure_gc_timer(),
+    State = #{},
+    {ok, State}.
+
+handle_call(#gc{}, _From, State) ->
+    maybe_gc(),
+    {reply, ok, State};
+handle_call(_Call, _From, State) ->
+    {reply, error, State}.
+
+handle_cast(_Cast, State) ->
+    {noreply, State}.
+
+handle_info(#gc{}, State) ->
+    try_gc(),
+    ensure_gc_timer(),
+    {noreply, State};
+handle_info(_Info, State) ->
+    {noreply, State}.
+
+%%--------------------------------------------------------------------------------
+%% Internal fns
+%%--------------------------------------------------------------------------------
+
+ensure_gc_timer() ->
+    Timeout = emqx_config:get([session_persistence, message_retention_period]),
+    _ = erlang:send_after(Timeout, self(), #gc{}),
+    ok.
+
+try_gc() ->
+    %% Only cores should run GC.
+    CoreNodes = mria_membership:running_core_nodelist(),
+    Res = global:trans(
+        {?MODULE, self()},
+        fun maybe_gc/0,
+        CoreNodes,
+        %% Note: we set retries to 1 here because, in rare occasions, GC might start at the
+        %% same time in more than one node, and each one will abort the other.  By allowing
+        %% one retry, at least one node will (hopefully) get to enter the transaction and
+        %% the other will abort.  If GC runs too fast, both nodes might run in sequence.
+        %% But, in that case, GC is clearly not too costly, and that shouldn't be a problem,
+        %% resource-wise.
+        _Retries = 1
+    ),
+    case Res of
+        aborted ->
+            ?tp(ds_message_gc_lock_taken, #{}),
+            ok;
+        ok ->
+            ok
+    end.
+
+now_ms() ->
+    erlang:system_time(millisecond).
+
+maybe_gc() ->
+    AllGens = emqx_ds:list_generations_with_lifetimes(?PERSISTENT_MESSAGE_DB),
+    NowMS = now_ms(),
+    RetentionPeriod = emqx_config:get([session_persistence, message_retention_period]),
+    TimeThreshold = NowMS - RetentionPeriod,
+    maybe_create_new_generation(AllGens, TimeThreshold),
+    ?tp_span(
+        ps_message_gc,
+        #{},
+        begin
+            ExpiredGens =
+                maps:filter(
+                    fun(_GenId, #{until := Until}) ->
+                        is_number(Until) andalso Until =< TimeThreshold
+                    end,
+                    AllGens
+                ),
+            ExpiredGenIds = maps:keys(ExpiredGens),
+            lists:foreach(
+                fun(GenId) ->
+                    ok = emqx_ds:drop_generation(?PERSISTENT_MESSAGE_DB, GenId),
+                    ?tp(message_gc_generation_dropped, #{gen_id => GenId})
+                end,
+                ExpiredGenIds
+            )
+        end
+    ).
+
+maybe_create_new_generation(AllGens, TimeThreshold) ->
+    NeedNewGen =
+        lists:all(
+            fun({_GenId, #{created_at := CreatedAt}}) ->
+                CreatedAt =< TimeThreshold
+            end,
+            maps:to_list(AllGens)
+        ),
+    case NeedNewGen of
+        false ->
+            ?tp(ps_message_gc_too_early, #{}),
+            ok;
+        true ->
+            ok = emqx_ds:add_generation(?PERSISTENT_MESSAGE_DB),
+            ?tp(ps_message_gc_added_gen, #{})
+    end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_sup.erl b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
index 5bd620e8b..11e05be82 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_sup.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
@@ -48,13 +48,14 @@ init(Opts) ->
 
 do_init(_Opts) ->
     SupFlags = #{
-        strategy => rest_for_one,
+        strategy => one_for_one,
         intensity => 10,
         period => 2,
         auto_shutdown => never
     },
     CoreChildren = [
-        worker(gc_worker, emqx_persistent_session_ds_gc_worker, [])
+        worker(session_gc_worker, emqx_persistent_session_ds_gc_worker, []),
+        worker(message_gc_worker, emqx_persistent_message_ds_gc_worker, [])
     ],
     Children =
         case mria_rlog:role() of
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index 1dd0a55ed..610c07d49 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1853,6 +1853,14 @@ fields("session_persistence") ->
                     desc => ?DESC(session_ds_session_gc_batch_size)
                 }
             )},
+        {"message_retention_period",
+            sc(
+                timeout_duration(),
+                #{
+                    default => <<"1d">>,
+                    desc => ?DESC(session_ds_message_retention_period)
+                }
+            )},
         {"force_persistence",
             sc(
                 boolean(),
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index f25f38098..c46d726f4 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -19,6 +19,7 @@
 -include_lib("stdlib/include/assert.hrl").
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("emqx/include/emqx.hrl").
 -include_lib("emqx/include/emqx_mqtt.hrl").
 
 -compile(export_all).
@@ -45,10 +46,20 @@ init_per_testcase(t_session_subscription_iterators = TestCase, Config) ->
     Cluster = cluster(),
     Nodes = emqx_cth_cluster:start(Cluster, #{work_dir => emqx_cth_suite:work_dir(TestCase, Config)}),
     [{nodes, Nodes} | Config];
+init_per_testcase(t_message_gc = TestCase, Config) ->
+    Opts = #{
+        extra_emqx_conf =>
+            "\n  session_persistence.message_retention_period = 1s"
+            "\n  session_persistence.storage.builtin.n_shards = 3"
+    },
+    common_init_per_testcase(TestCase, [{n_shards, 3} | Config], Opts);
 init_per_testcase(TestCase, Config) ->
+    common_init_per_testcase(TestCase, Config, _Opts = #{}).
+
+common_init_per_testcase(TestCase, Config, Opts) ->
     ok = emqx_ds:drop_db(?PERSISTENT_MESSAGE_DB),
     Apps = emqx_cth_suite:start(
-        app_specs(),
+        app_specs(Opts),
         #{work_dir => emqx_cth_suite:work_dir(TestCase, Config)}
     ),
     [{apps, Apps} | Config].
@@ -379,6 +390,66 @@ t_publish_empty_topic_levels(_Config) ->
         emqtt:stop(Pub)
     end.
 
+t_message_gc_too_young(_Config) ->
+    %% Check that GC doesn't attempt to create a new generation if there are fresh enough
+    %% generations around.  The stability of this test relies on the default value for
+    %% message retention being long enough.  Currently, the default is 1 hour.
+    ?check_trace(
+        ok = emqx_persistent_message_ds_gc_worker:gc(),
+        fun(Trace) ->
+            ?assertMatch([_], ?of_kind(ps_message_gc_too_early, Trace)),
+            ok
+        end
+    ),
+    ok.
+
+t_message_gc(Config) ->
+    %% Check that, after GC runs, a new generation is created, retaining messages, and
+    %% older messages no longer are accessible.
+    NShards = ?config(n_shards, Config),
+    ?check_trace(
+        #{timetrap => 10_000},
+        begin
+            %% ensure some messages are in the first generation
+            ?force_ordering(
+                #{?snk_kind := inserted_batch},
+                #{?snk_kind := ps_message_gc_added_gen}
+            ),
+            Msgs0 = [
+                message(<<"foo/bar">>, <<"1">>, 0),
+                message(<<"foo/baz">>, <<"2">>, 1)
+            ],
+            ok = emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, Msgs0),
+            ?tp(inserted_batch, #{}),
+            {ok, _} = ?block_until(#{?snk_kind := ps_message_gc_added_gen}),
+
+            Now = emqx_message:timestamp_now(),
+            Msgs1 = [
+                message(<<"foo/bar">>, <<"3">>, Now + 100),
+                message(<<"foo/baz">>, <<"4">>, Now + 101)
+            ],
+            ok = emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, Msgs1),
+
+            {ok, _} = snabbkaffe:block_until(
+                ?match_n_events(NShards, #{?snk_kind := message_gc_generation_dropped}),
+                infinity
+            ),
+
+            TopicFilter = emqx_topic:words(<<"#">>),
+            StartTime = 0,
+            Msgs = consume(TopicFilter, StartTime),
+            %% only "1" and "2" should have been GC'ed
+            ?assertEqual(
+                sets:from_list([<<"3">>, <<"4">>], [{version, 2}]),
+                sets:from_list([emqx_message:payload(Msg) || Msg <- Msgs], [{version, 2}])
+            ),
+
+            ok
+        end,
+        []
+    ),
+    ok.
+
 %%
 
 connect(ClientId, CleanStart, EI) ->
@@ -438,9 +509,13 @@ publish(Node, Message) ->
     erpc:call(Node, emqx, publish, [Message]).
 
 app_specs() ->
+    app_specs(_Opts = #{}).
+
+app_specs(Opts) ->
+    ExtraEMQXConf = maps:get(extra_emqx_conf, Opts, ""),
     [
         emqx_durable_storage,
-        {emqx, "session_persistence {enable = true}"}
+        {emqx, "session_persistence {enable = true}" ++ ExtraEMQXConf}
     ].
 
 cluster() ->
@@ -459,3 +534,11 @@ clear_db() ->
     mria:stop(),
     ok = mnesia:delete_schema([node()]),
     ok.
+
+message(Topic, Payload, PublishedAt) ->
+    #message{
+        topic = Topic,
+        payload = Payload,
+        timestamp = PublishedAt,
+        id = emqx_guid:gen()
+    }.
diff --git a/changes/ce/feat-12338.en.md b/changes/ce/feat-12338.en.md
new file mode 100644
index 000000000..8b8edcb76
--- /dev/null
+++ b/changes/ce/feat-12338.en.md
@@ -0,0 +1 @@
+Added time-based message garbage collection to the RocksDB-based persistent session backend.
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index fe315b5d7..75dce469e 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1603,5 +1603,8 @@ The session will query the DB for the new messages when the value of `FreeSpace`
 
 `FreeSpace` is calculated as `ReceiveMaximum` for the session - number of inflight messages."""
 
+session_ds_message_retention_period.desc:
+"""The minimum amount of time that messages should be retained for.  After messages have been in storage for at least this period of time, they'll be dropped."""
+
 
 }

From 609ba7e3327b60267a24e76334247151aff2fdc6 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 22 Jan 2024 13:10:44 -0300
Subject: [PATCH 018/273] fix(ds): do not count persistent session-only routed
 messages as dropped

Fixes https://emqx.atlassian.net/browse/EMQX-11539
---
 apps/emqx/src/emqx_broker.erl                 | 12 ++++---
 .../test/emqx_persistent_messages_SUITE.erl   | 31 +++++++++++++++++++
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/apps/emqx/src/emqx_broker.erl b/apps/emqx/src/emqx_broker.erl
index ac9116cbd..6dc893043 100644
--- a/apps/emqx/src/emqx_broker.erl
+++ b/apps/emqx/src/emqx_broker.erl
@@ -249,7 +249,7 @@ publish(Msg) when is_record(Msg, message) ->
             [];
         Msg1 = #message{topic = Topic} ->
             PersistRes = persist_publish(Msg1),
-            PersistRes ++ route(aggre(emqx_router:match_routes(Topic)), delivery(Msg1))
+            route(aggre(emqx_router:match_routes(Topic)), delivery(Msg1), PersistRes)
     end.
 
 persist_publish(Msg) ->
@@ -289,18 +289,20 @@ delivery(Msg) -> #delivery{sender = self(), message = Msg}.
 %% Route
 %%--------------------------------------------------------------------
 
--spec route([emqx_types:route_entry()], emqx_types:delivery()) ->
+-spec route([emqx_types:route_entry()], emqx_types:delivery(), nil() | [persisted]) ->
     emqx_types:publish_result().
-route([], #delivery{message = Msg}) ->
+route([], #delivery{message = Msg}, _PersistRes = []) ->
     ok = emqx_hooks:run('message.dropped', [Msg, #{node => node()}, no_subscribers]),
     ok = inc_dropped_cnt(Msg),
     [];
-route(Routes, Delivery) ->
+route([], _Delivery, PersistRes = [_ | _]) ->
+    PersistRes;
+route(Routes, Delivery, PersistRes) ->
     lists:foldl(
         fun(Route, Acc) ->
             [do_route(Route, Delivery) | Acc]
         end,
-        [],
+        PersistRes,
         Routes
     ).
 
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index c46d726f4..73c88adc8 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -450,6 +450,32 @@ t_message_gc(Config) ->
     ),
     ok.
 
+t_metrics_not_dropped(_Config) ->
+    %% Asserts that, if only persisted sessions are subscribed to a topic being published
+    %% to, we don't bump the `message.dropped' metric, nor we run the equivalent hook.
+    Sub = connect(<<?MODULE_STRING "1">>, true, 30),
+    on_exit(fun() -> emqtt:stop(Sub) end),
+    Pub = connect(<<?MODULE_STRING "2">>, true, 30),
+    on_exit(fun() -> emqtt:stop(Pub) end),
+    Hookpoint = 'message.dropped',
+    emqx_hooks:add(Hookpoint, {?MODULE, on_message_dropped, [self()]}, 1_000),
+    on_exit(fun() -> emqx_hooks:del(Hookpoint, {?MODULE, on_message_dropped}) end),
+
+    DroppedBefore = emqx_metrics:val('messages.dropped'),
+    DroppedNoSubBefore = emqx_metrics:val('messages.dropped.no_subscribers'),
+
+    {ok, _, [?RC_GRANTED_QOS_1]} = emqtt:subscribe(Sub, <<"t/+">>, ?QOS_1),
+    emqtt:publish(Pub, <<"t/ps">>, <<"payload">>, ?QOS_1),
+    ?assertMatch([_], receive_messages(1, 1_500)),
+
+    DroppedAfter = emqx_metrics:val('messages.dropped'),
+    DroppedNoSubAfter = emqx_metrics:val('messages.dropped.no_subscribers'),
+
+    ?assertEqual(DroppedBefore, DroppedAfter),
+    ?assertEqual(DroppedNoSubBefore, DroppedNoSubAfter),
+
+    ok.
+
 %%
 
 connect(ClientId, CleanStart, EI) ->
@@ -542,3 +568,8 @@ message(Topic, Payload, PublishedAt) ->
         timestamp = PublishedAt,
         id = emqx_guid:gen()
     }.
+
+on_message_dropped(Msg, Context, Res, TestPid) ->
+    ErrCtx = #{msg => Msg, ctx => Context, res => Res},
+    ct:pal("this hook should not be called.\n  ~p", [ErrCtx]),
+    exit(TestPid, {hookpoint_called, ErrCtx}).

From 28867d07e69fb1db66b9ab095390db2f42a0ffd8 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Tue, 23 Jan 2024 10:00:56 +0800
Subject: [PATCH 019/273] fix(opentsdb): Enhanced the type support for template
 data

---
 .../src/emqx_bridge_opents.erl                | 18 +++-
 .../src/emqx_bridge_opents_connector.erl      | 27 ++++--
 .../test/emqx_bridge_opents_SUITE.erl         | 88 ++++++++++++++++++-
 rel/i18n/emqx_bridge_opents.hocon             |  2 +-
 4 files changed, 124 insertions(+), 11 deletions(-)

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index 7e490576f..119de1978 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -3,6 +3,7 @@
 %%--------------------------------------------------------------------
 -module(emqx_bridge_opents).
 
+-include_lib("emqx/include/logger.hrl").
 -include_lib("typerefl/include/types.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
@@ -156,12 +157,25 @@ fields(action_parameters_data) ->
                 binary(),
                 #{
                     required => true,
-                    desc => ?DESC("config_parameters_tags")
+                    desc => ?DESC("config_parameters_tags"),
+                    validator => fun(Tmpl) ->
+                        case emqx_placeholder:preproc_tmpl(Tmpl) of
+                            [{var, _}] ->
+                                true;
+                            _ ->
+                                ?SLOG(warning, #{
+                                    msg => "invalid_tags_template",
+                                    path => "opents.parameters.data.tags",
+                                    data => Tmpl
+                                }),
+                                false
+                        end
+                    end
                 }
             )},
         {value,
             mk(
-                binary(),
+                hoconsc:union([integer(), float(), binary()]),
                 #{
                     required => true,
                     desc => ?DESC("config_parameters_value")
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index e3fe9d6b4..d71468d82 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -304,9 +304,14 @@ render_channel_message(Msg, #{data := DataList}, Acc) ->
             ValueVal =
                 case ValueTk of
                     [_] ->
+                        %% just one element, maybe is a variable or a plain text
+                        %% we should keep it as it is
                         erlang:hd(emqx_placeholder:proc_tmpl(ValueTk, Msg, RawOpts));
-                    _ ->
-                        emqx_placeholder:proc_tmpl(ValueTk, Msg)
+                    Tks when is_list(Tks) ->
+                        emqx_placeholder:proc_tmpl(ValueTk, Msg);
+                    Raw ->
+                        %% not a token list, just a raw value
+                        Raw
                 end,
             Base = #{metric => MetricVal, tags => TagsVal, value => ValueVal},
             [
@@ -328,12 +333,20 @@ preproc_data_template([]) ->
 preproc_data_template(DataList) ->
     lists:map(
         fun(Data) ->
-            maps:map(
-                fun(_Key, Value) ->
-                    emqx_placeholder:preproc_tmpl(Value)
+            {Value, Data2} = maps:take(value, Data),
+            Template = maps:map(
+                fun(_Key, Val) ->
+                    emqx_placeholder:preproc_tmpl(Val)
                 end,
-                Data
-            )
+                Data2
+            ),
+
+            case Value of
+                Text when is_binary(Text) ->
+                    Template#{value => emqx_placeholder:preproc_tmpl(Text)};
+                Raw ->
+                    Template#{value => Raw}
+            end
         end,
         DataList
     ).
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index f86ae6986..e3e89d563 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -83,7 +83,7 @@ init_per_testcase(TestCase, Config0) ->
         {bridge_config, ActionConfig}
         | Config0
     ],
-    %%    iotdb_reset(Config),
+    emqx_bridge_v2_testlib:delete_all_bridges_and_connectors(),
     ok = snabbkaffe:start_trace(),
     Config.
 
@@ -253,3 +253,89 @@ t_query_invalid_data(Config) ->
     ok = emqx_bridge_v2_testlib:t_sync_query(
         Config, MakeMessageFun, fun is_error_check/1, opents_bridge_on_query
     ).
+
+t_tags_validator(Config) ->
+    %% Create without data  configured
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"${tags}">>,
+                        <<"value">> => <<"${payload.value}">>
+                    }
+                ]
+            }
+        })
+    ),
+
+    ?assertMatch(
+        {error, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"text">>,
+                        <<"value">> => <<"${payload.value}">>
+                    }
+                ]
+            }
+        })
+    ).
+
+t_raw_int_value(Config) ->
+    raw_value_test(<<"t_raw_int_value">>, 42, Config).
+
+t_raw_float_value(Config) ->
+    raw_value_test(<<"t_raw_float_value">>, 42.5, Config).
+
+raw_value_test(Metric, RawValue, Config) ->
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+    ResourceId = emqx_bridge_v2_testlib:resource_id(Config),
+    BridgeId = emqx_bridge_v2_testlib:bridge_id(Config),
+    ?retry(
+        _Sleep = 1_000,
+        _Attempts = 10,
+        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+    ),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"${tags}">>,
+                        <<"value">> => RawValue
+                    }
+                ]
+            }
+        })
+    ),
+
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+
+    is_success_check(
+        emqx_resource:simple_sync_query(ResourceId, {BridgeId, MakeMessageFun()})
+    ),
+
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"dps">> := _
+            }
+        ],
+        QResult
+    ),
+    [#{<<"dps">> := Dps}] = QResult,
+    ?assertMatch([RawValue | _], maps:values(Dps)).
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index f5d2ade85..ab2e82180 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -49,7 +49,7 @@ config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:
-"""Data Type, Placeholders in format of ${var} is supported"""
+"""Tags. Only supports with placeholder to extract tags from a variable"""
 
 config_parameters_tags.label:
 """Tags"""

From 0dbaaa5d949ab4235cf360ae6594b54b335f69d1 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Tue, 23 Jan 2024 09:06:15 +0800
Subject: [PATCH 020/273] chore: document api-key path api only support
 bearerAuth

---
 apps/emqx/include/http_api.hrl                  |  1 +
 apps/emqx_dashboard/src/emqx_dashboard.erl      |  7 ++++---
 apps/emqx_dashboard/src/emqx_dashboard_api.erl  |  1 +
 .../src/emqx_mgmt_api_api_keys.erl              |  2 ++
 apps/emqx_management/src/emqx_mgmt_auth.erl     |  6 +++---
 .../test/emqx_mgmt_api_api_keys_SUITE.erl       | 17 ++++++++++++++++-
 rel/i18n/emqx_mgmt_api_api_keys.hocon           | 10 +++++-----
 7 files changed, 32 insertions(+), 12 deletions(-)

diff --git a/apps/emqx/include/http_api.hrl b/apps/emqx/include/http_api.hrl
index 0f6372584..f0c5611e9 100644
--- a/apps/emqx/include/http_api.hrl
+++ b/apps/emqx/include/http_api.hrl
@@ -17,6 +17,7 @@
 %% HTTP API Auth
 -define(BAD_USERNAME_OR_PWD, 'BAD_USERNAME_OR_PWD').
 -define(BAD_API_KEY_OR_SECRET, 'BAD_API_KEY_OR_SECRET').
+-define(API_KEY_NOT_ALLOW, 'API_KEY_NOT_ALLOW').
 -define(API_KEY_NOT_ALLOW_MSG, <<"This API Key don't have permission to access this resource">>).
 
 %% Bad Request
diff --git a/apps/emqx_dashboard/src/emqx_dashboard.erl b/apps/emqx_dashboard/src/emqx_dashboard.erl
index 96f81ca84..a4438f6c7 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard.erl
@@ -264,10 +264,11 @@ api_key_authorize(Req, Key, Secret) ->
     case emqx_mgmt_auth:authorize(Path, Req, Key, Secret) of
         ok ->
             {ok, #{auth_type => api_key, source => Key}};
-        {error, <<"not_allowed">>} ->
+        {error, <<"not_allowed">>, Resource} ->
             return_unauthorized(
-                ?BAD_API_KEY_OR_SECRET,
-                <<"Not allowed, Check api_key/api_secret">>
+                ?API_KEY_NOT_ALLOW,
+                <<"Please use bearer Token instead, using API key/secret in ", Resource/binary,
+                    " path is not permitted">>
             );
         {error, unauthorized_role} ->
             {403, 'UNAUTHORIZED_ROLE', ?API_KEY_NOT_ALLOW_MSG};
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_api.erl b/apps/emqx_dashboard/src/emqx_dashboard_api.erl
index 8a81f2116..d7ed5941f 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_api.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_api.erl
@@ -89,6 +89,7 @@ schema("/logout") ->
         post => #{
             tags => [<<"dashboard">>],
             desc => ?DESC(logout_api),
+            security => [#{'bearerAuth' => []}],
             parameters => sso_parameters(),
             'requestBody' => fields([username]),
             responses => #{
diff --git a/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl b/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
index db20e9477..ad4b53401 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
@@ -40,6 +40,7 @@ schema("/api_key") ->
         get => #{
             description => ?DESC(api_key_list),
             tags => ?TAGS,
+            security => [#{'bearerAuth' => []}],
             responses => #{
                 200 => delete([api_secret], fields(app))
             }
@@ -47,6 +48,7 @@ schema("/api_key") ->
         post => #{
             description => ?DESC(create_new_api_key),
             tags => ?TAGS,
+            security => [#{'bearerAuth' => []}],
             'requestBody' => delete([created_at, api_key, api_secret], fields(app)),
             responses => #{
                 200 => hoconsc:ref(app),
diff --git a/apps/emqx_management/src/emqx_mgmt_auth.erl b/apps/emqx_management/src/emqx_mgmt_auth.erl
index 559344e2b..7745207ce 100644
--- a/apps/emqx_management/src/emqx_mgmt_auth.erl
+++ b/apps/emqx_management/src/emqx_mgmt_auth.erl
@@ -184,11 +184,11 @@ list() ->
     to_map(ets:match_object(?APP, #?APP{_ = '_'})).
 
 authorize(<<"/api/v5/users", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"users">>};
 authorize(<<"/api/v5/api_key", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"api_key">>};
 authorize(<<"/api/v5/logout", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"logout">>};
 authorize(_Path, Req, ApiKey, ApiSecret) ->
     Now = erlang:system_time(second),
     case find_by_api_key(ApiKey) of
diff --git a/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
index d437e07c9..760ab1732 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
@@ -394,8 +394,23 @@ t_authorize(_Config) ->
     {ok, _Status} = emqx_mgmt_api_test_util:request_api(get, BanPath, BasicHeader),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, BanPath, KeyError)),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, BanPath, SecretError)),
-    ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, ApiKeyPath, BasicHeader)),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, UserPath, BasicHeader)),
+    {error, {{"HTTP/1.1", 401, "Unauthorized"}, _Headers, Body}} =
+        emqx_mgmt_api_test_util:request_api(
+            get,
+            ApiKeyPath,
+            [],
+            BasicHeader,
+            [],
+            #{return_all => true}
+        ),
+    ?assertMatch(
+        #{
+            <<"code">> := <<"API_KEY_NOT_ALLOW">>,
+            <<"message">> := _
+        },
+        emqx_utils_json:decode(Body, [return_maps])
+    ),
 
     ?assertMatch(
         {ok, #{<<"api_key">> := _, <<"enable">> := false}},
diff --git a/rel/i18n/emqx_mgmt_api_api_keys.hocon b/rel/i18n/emqx_mgmt_api_api_keys.hocon
index 8acbe60d0..4becd01aa 100644
--- a/rel/i18n/emqx_mgmt_api_api_keys.hocon
+++ b/rel/i18n/emqx_mgmt_api_api_keys.hocon
@@ -1,27 +1,27 @@
 emqx_mgmt_api_api_keys {
 
 api_key_list.desc:
-"""Return api_key list"""
+"""Return api_key list. This API can only be requested using a bearer token."""
 api_key_list.label:
 """Return api_key list"""
 
 create_new_api_key.desc:
-"""Create new api_key"""
+"""Create new api_key. This API can only be requested using a bearer token."""
 create_new_api_key.label:
 """Create new api_key"""
 
 get_api_key.desc:
-"""Return the specific api_key"""
+"""Return the specific api_key. This API can only be requested using a bearer token."""
 get_api_key.label:
 """Return the specific api_key"""
 
 update_api_key.desc:
-"""Update the specific api_key"""
+"""Update the specific api_key. This API can only be requested using a bearer token."""
 update_api_key.label:
 """Update the specific api_key"""
 
 delete_api_key.desc:
-"""Delete the specific api_key"""
+"""Delete the specific api_key. This API can only be requested using a bearer token."""
 delete_api_key.label:
 """Delete the specific api_key"""
 

From 218af3fef4b62c3ca8b6c5ac57360c69585f84c6 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 23 Jan 2024 14:14:23 +0800
Subject: [PATCH 021/273] chore: update ecql to 0.6.0

---
 apps/emqx_bridge_cassandra/rebar.config               |  2 +-
 .../src/emqx_bridge_cassandra_connector.erl           | 11 +++--------
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/apps/emqx_bridge_cassandra/rebar.config b/apps/emqx_bridge_cassandra/rebar.config
index c0a72fef9..04ee603fa 100644
--- a/apps/emqx_bridge_cassandra/rebar.config
+++ b/apps/emqx_bridge_cassandra/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.5.2"}}},
+    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.6.0"}}},
     {emqx_connector, {path, "../../apps/emqx_connector"}},
     {emqx_resource, {path, "../../apps/emqx_resource"}},
     {emqx_bridge, {path, "../../apps/emqx_bridge"}}
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index 3db71c9e0..3b30f1d26 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -159,7 +159,7 @@ on_add_channel(_InstId, #{channels := Channs} = OldState, ChannId, ChannConf0) -
     #{parameters := #{cql := CQL}} = ChannConf0,
     {PrepareCQL, ParamsTokens} = emqx_placeholder:preproc_sql(CQL, '?'),
     ParsedCql = #{
-        prepare_key => short_prepare_key(ChannId),
+        prepare_key => make_prepare_key(ChannId),
         prepare_cql => PrepareCQL,
         params_tokens => ParamsTokens
     },
@@ -462,10 +462,5 @@ maybe_assign_type(V) when is_float(V) -> {double, V};
 maybe_assign_type(V) ->
     V.
 
-short_prepare_key(Str) when is_binary(Str) ->
-    true = size(Str) > 0,
-    Sha = crypto:hash(sha, Str),
-    %% TODO: change to binary:encode_hex(X, lowercase) when OTP version is always > 25
-    Hex = string:lowercase(binary:encode_hex(Sha)),
-    <<UniqueEnough:16/binary, _/binary>> = Hex,
-    binary_to_atom(<<"cassa_prepare_key:", UniqueEnough/binary>>).
+make_prepare_key(ChannId) ->
+    ChannId.

From 1eb47d0c16a3a592c5d3eb0693ff7536f31e7ba9 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 22 Jan 2024 18:18:17 -0300
Subject: [PATCH 022/273] perf(ds): inherit only LTS paths containing wildcards
 when adding a new generation

Fixes https://github.com/emqx/emqx/pull/12338#discussion_r1462139499
---
 apps/emqx_durable_storage/src/emqx_ds_lts.erl | 148 +++++++++++++++++-
 .../src/emqx_ds_storage_bitfield_lts.erl      |  27 ++--
 2 files changed, 152 insertions(+), 23 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
index 9d87cf571..226af62f0 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
@@ -20,7 +20,7 @@
 -export([
     trie_create/1, trie_create/0,
     trie_restore/2,
-    trie_restore_existing/2,
+    trie_copy_learned_paths/2,
     topic_key/3,
     match_topics/2,
     lookup_topic_key/2
@@ -120,10 +120,6 @@ trie_create() ->
 -spec trie_restore(options(), [{_Key, _Val}]) -> trie().
 trie_restore(Options, Dump) ->
     Trie = trie_create(Options),
-    trie_restore_existing(Trie, Dump).
-
--spec trie_restore_existing(trie(), [{_Key, _Val}]) -> trie().
-trie_restore_existing(Trie, Dump) ->
     lists:foreach(
         fun({{StateFrom, Token}, StateTo}) ->
             trie_insert(Trie, StateFrom, Token, StateTo)
@@ -132,6 +128,17 @@ trie_restore_existing(Trie, Dump) ->
     ),
     Trie.
 
+-spec trie_copy_learned_paths(trie(), trie()) -> trie().
+trie_copy_learned_paths(OldTrie, NewTrie) ->
+    WildcardPaths = [P || P <- paths(OldTrie), contains_wildcard(P)],
+    lists:foreach(
+        fun({{StateFrom, Token}, StateTo}) ->
+            trie_insert(NewTrie, StateFrom, Token, StateTo)
+        end,
+        lists:flatten(WildcardPaths)
+    ),
+    NewTrie.
+
 %% @doc Lookup the topic key. Create a new one, if not found.
 -spec topic_key(trie(), threshold_fun(), [binary() | '']) -> msg_storage_key().
 topic_key(Trie, ThresholdFun, Tokens) ->
@@ -385,6 +392,41 @@ emanating(#trie{trie = Tab}, State, Token) when is_binary(Token); Token =:= '' -
                 ets:lookup(Tab, {State, Token})
     ].
 
+all_emanating(#trie{trie = Tab}, State) ->
+    ets:select(
+        Tab,
+        ets:fun2ms(fun(#trans{key = {S, Edge}, next = Next}) when S == State ->
+            {{S, Edge}, Next}
+        end)
+    ).
+
+paths(#trie{} = T) ->
+    Roots = all_emanating(T, ?PREFIX),
+    lists:flatmap(
+        fun({Segment, Next}) ->
+            follow_path(T, Next, [{Segment, Next}])
+        end,
+        Roots
+    ).
+
+follow_path(#trie{} = T, State, Path) ->
+    lists:flatmap(
+        fun
+            ({{_State, ?EOT}, _Next} = Segment) ->
+                [lists:reverse([Segment | Path])];
+            ({_Edge, Next} = Segment) ->
+                follow_path(T, Next, [Segment | Path])
+        end,
+        all_emanating(T, State)
+    ).
+
+contains_wildcard([{{_State, ?PLUS}, _Next} | _Rest]) ->
+    true;
+contains_wildcard([_ | Rest]) ->
+    contains_wildcard(Rest);
+contains_wildcard([]) ->
+    false.
+
 %%================================================================================
 %% Tests
 %%================================================================================
@@ -636,4 +678,100 @@ test_key(Trie, Threshold, Topic0) ->
     {ok, Ret} = lookup_topic_key(Trie, Topic),
     Ret.
 
+paths_test() ->
+    T = trie_create(),
+    Threshold = 4,
+    ThresholdFun = fun
+        (0) -> 1000;
+        (_) -> Threshold
+    end,
+    PathsToInsert =
+        [
+            [''],
+            [1],
+            [2, 2],
+            [3, 3, 3],
+            [2, 3, 4]
+        ] ++ [[4, I, 4] || I <- lists:seq(1, Threshold + 2)] ++
+            [['', I, ''] || I <- lists:seq(1, Threshold + 2)],
+    lists:foreach(
+        fun(PathSpec) ->
+            test_key(T, ThresholdFun, PathSpec)
+        end,
+        PathsToInsert
+    ),
+
+    %% Test that the paths we've inserted are produced in the output
+    Paths = paths(T),
+    FormattedPaths = lists:map(fun format_path/1, Paths),
+    ExpectedWildcardPaths =
+        [
+            [4, '+', 4],
+            ['', '+', '']
+        ],
+    ExpectedPaths =
+        [
+            [''],
+            [1],
+            [2, 2],
+            [3, 3, 3]
+        ] ++ [[4, I, 4] || I <- lists:seq(1, Threshold)] ++
+            [['', I, ''] || I <- lists:seq(1, Threshold)] ++
+            ExpectedWildcardPaths,
+    FormatPathSpec =
+        fun(PathSpec) ->
+            lists:map(
+                fun
+                    (I) when is_integer(I) -> integer_to_binary(I);
+                    (A) -> A
+                end,
+                PathSpec
+            ) ++ [?EOT]
+        end,
+    lists:foreach(
+        fun(PathSpec) ->
+            Path = FormatPathSpec(PathSpec),
+            ?assert(
+                lists:member(Path, FormattedPaths),
+                #{
+                    paths => FormattedPaths,
+                    expected_path => Path
+                }
+            )
+        end,
+        ExpectedPaths
+    ),
+
+    %% Test filter function for paths containing wildcards
+    WildcardPaths = lists:filter(fun contains_wildcard/1, Paths),
+    FormattedWildcardPaths = lists:map(fun format_path/1, WildcardPaths),
+    ?assertEqual(
+        sets:from_list(FormattedWildcardPaths, [{version, 2}]),
+        sets:from_list(lists:map(FormatPathSpec, ExpectedWildcardPaths), [{version, 2}]),
+        #{
+            expected => ExpectedWildcardPaths,
+            wildcards => FormattedWildcardPaths
+        }
+    ),
+
+    %% Test that we're able to reconstruct the same trie from the paths
+    T2 = trie_create(),
+    [
+        trie_insert(T2, State, Edge, Next)
+     || Path <- Paths,
+        {{State, Edge}, Next} <- Path
+    ],
+    #trie{trie = Tab1} = T,
+    #trie{trie = Tab2} = T2,
+    Dump1 = sets:from_list(ets:tab2list(Tab1), [{version, 2}]),
+    Dump2 = sets:from_list(ets:tab2list(Tab2), [{version, 2}]),
+    ?assertEqual(Dump1, Dump2),
+
+    ok.
+
+format_path([{{_State, Edge}, _Next} | Rest]) ->
+    [Edge | format_path(Rest)];
+format_path([]) ->
+    [].
+
 -endif.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 2a3086a57..d407dab41 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -205,17 +205,15 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
     s().
 post_creation_actions(
     #{
-        db := DBHandle,
-        old_gen_id := OldGenId,
-        old_cf_refs := OldCFRefs,
-        new_gen_runtime_data := NewGenData0
+        new_gen_runtime_data := NewGenData,
+        old_gen_runtime_data := OldGenData
     }
 ) ->
-    {_, OldTrieCF} = lists:keyfind(trie_cf(OldGenId), 1, OldCFRefs),
-    #s{trie = NewTrie0} = NewGenData0,
-    NewTrie = copy_previous_trie(DBHandle, NewTrie0, OldTrieCF),
+    #s{trie = OldTrie} = OldGenData,
+    #s{trie = NewTrie0} = NewGenData,
+    NewTrie = copy_previous_trie(OldTrie, NewTrie0),
     ?tp(bitfield_lts_inherited_trie, #{}),
-    NewGenData0#s{trie = NewTrie}.
+    NewGenData#s{trie = NewTrie}.
 
 -spec drop(
     emqx_ds_storage_layer:shard_id(),
@@ -533,16 +531,9 @@ restore_trie(TopicIndexBytes, DB, CF) ->
         rocksdb:iterator_close(IT)
     end.
 
--spec copy_previous_trie(rocksdb:db_handle(), emqx_ds_lts:trie(), rocksdb:cf_handle()) ->
-    emqx_ds_lts:trie().
-copy_previous_trie(DBHandle, NewTrie, OldCF) ->
-    {ok, IT} = rocksdb:iterator(DBHandle, OldCF, []),
-    try
-        OldDump = read_persisted_trie(IT, rocksdb:iterator_move(IT, first)),
-        emqx_ds_lts:trie_restore_existing(NewTrie, OldDump)
-    after
-        rocksdb:iterator_close(IT)
-    end.
+-spec copy_previous_trie(emqx_ds_lts:trie(), emqx_ds_lts:trie()) -> emqx_ds_lts:trie().
+copy_previous_trie(OldTrie, NewTrie) ->
+    emqx_ds_lts:trie_copy_learned_paths(OldTrie, NewTrie).
 
 read_persisted_trie(IT, {ok, KeyB, ValB}) ->
     [

From eecd7e084c7747c2cb486c642b2f90af691284d0 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 23 Jan 2024 09:47:03 -0300
Subject: [PATCH 023/273] test(ds): reduce flakiness

---
 .../test/emqx_persistent_messages_SUITE.erl     | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index c46d726f4..d0b939540 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -438,10 +438,19 @@ t_message_gc(Config) ->
             TopicFilter = emqx_topic:words(<<"#">>),
             StartTime = 0,
             Msgs = consume(TopicFilter, StartTime),
-            %% only "1" and "2" should have been GC'ed
-            ?assertEqual(
-                sets:from_list([<<"3">>, <<"4">>], [{version, 2}]),
-                sets:from_list([emqx_message:payload(Msg) || Msg <- Msgs], [{version, 2}])
+            %% "1" and "2" should have been GC'ed
+            PresentMessages = sets:from_list(
+                [emqx_message:payload(Msg) || Msg <- Msgs],
+                [{version, 2}]
+            ),
+            ?assert(
+                sets:is_empty(
+                    sets:intersection(
+                        PresentMessages,
+                        sets:from_list([<<"1">>, <<"2">>], [{version, 2}])
+                    )
+                ),
+                #{present_messages => PresentMessages}
             ),
 
             ok

From 4afba8eb94bfdce05f55c7f9d68a56b78024b233 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Wed, 24 Jan 2024 18:50:57 +0800
Subject: [PATCH 024/273] feat: port emqx/emqx-enterprise#1892, add some SQL
 functions

---
 apps/emqx_rule_engine/src/emqx_rule_funcs.erl |  65 ++++++++--
 .../test/emqx_rule_funcs_SUITE.erl            | 111 ++++++++++++++++--
 2 files changed, 158 insertions(+), 18 deletions(-)

diff --git a/apps/emqx_rule_engine/src/emqx_rule_funcs.erl b/apps/emqx_rule_engine/src/emqx_rule_funcs.erl
index aa5e271eb..da78ed875 100644
--- a/apps/emqx_rule_engine/src/emqx_rule_funcs.erl
+++ b/apps/emqx_rule_engine/src/emqx_rule_funcs.erl
@@ -116,7 +116,9 @@
 %% Data Type Validation Funcs
 -export([
     is_null/1,
+    is_null_var/1,
     is_not_null/1,
+    is_not_null_var/1,
     is_str/1,
     is_bool/1,
     is_int/1,
@@ -153,6 +155,9 @@
     ascii/1,
     find/2,
     find/3,
+    join_to_string/1,
+    join_to_string/2,
+    join_to_sql_values_string/1,
     jq/2,
     jq/3
 ]).
@@ -163,7 +168,10 @@
 -export([
     map_get/2,
     map_get/3,
-    map_put/3
+    map_put/3,
+    map_keys/1,
+    map_values/1,
+    map_to_entries/1
 ]).
 
 %% For backward compatibility
@@ -699,9 +707,16 @@ hexstr2bin(Str) when is_binary(Str) ->
 is_null(undefined) -> true;
 is_null(_Data) -> false.
 
+%% Similar to is_null/1, but also works for the JSON value 'null'
+is_null_var(null) -> true;
+is_null_var(Data) -> is_null(Data).
+
 is_not_null(Data) ->
     not is_null(Data).
 
+is_not_null_var(Data) ->
+    not is_null_var(Data).
+
 is_str(T) when is_binary(T) -> true;
 is_str(_) -> false.
 
@@ -847,6 +862,23 @@ find_s(S, P, Dir) ->
         SubStr -> SubStr
     end.
 
+join_to_string(List) when is_list(List) ->
+    join_to_string(<<", ">>, List).
+join_to_string(Sep, List) when is_list(List), is_binary(Sep) ->
+    iolist_to_binary(lists:join(Sep, [str(Item) || Item <- List])).
+join_to_sql_values_string(List) ->
+    QuotedList =
+        [
+            case is_list(Item) of
+                true ->
+                    emqx_placeholder:quote_sql(emqx_utils_json:encode(Item));
+                false ->
+                    emqx_placeholder:quote_sql(Item)
+            end
+         || Item <- List
+        ],
+    iolist_to_binary(lists:join(<<", ">>, QuotedList)).
+
 -spec jq(FilterProgram, JSON, TimeoutMS) -> Result when
     FilterProgram :: binary(),
     JSON :: binary() | term(),
@@ -920,7 +952,8 @@ map_put(Key, Val, Map) ->
 mget(Key, Map) ->
     mget(Key, Map, undefined).
 
-mget(Key, Map, Default) ->
+mget(Key, Map0, Default) ->
+    Map = map(Map0),
     case maps:find(Key, Map) of
         {ok, Val} ->
             Val;
@@ -947,7 +980,8 @@ mget(Key, Map, Default) ->
             Default
     end.
 
-mput(Key, Val, Map) ->
+mput(Key, Val, Map0) ->
+    Map = map(Map0),
     case maps:find(Key, Map) of
         {ok, _} ->
             maps:put(Key, Val, Map);
@@ -974,6 +1008,13 @@ mput(Key, Val, Map) ->
             maps:put(Key, Val, Map)
     end.
 
+map_keys(Map) ->
+    maps:keys(map(Map)).
+map_values(Map) ->
+    maps:values(map(Map)).
+map_to_entries(Map) ->
+    [#{key => K, value => V} || {K, V} <- maps:to_list(map(Map))].
+
 %%------------------------------------------------------------------------------
 %% Hash Funcs
 %%------------------------------------------------------------------------------
@@ -1168,16 +1209,18 @@ map_path(Key) ->
     {path, [{key, P} || P <- string:split(Key, ".", all)]}.
 
 function_literal(Fun, []) when is_atom(Fun) ->
-    atom_to_list(Fun) ++ "()";
+    iolist_to_binary(atom_to_list(Fun) ++ "()");
 function_literal(Fun, [FArg | Args]) when is_atom(Fun), is_list(Args) ->
     WithFirstArg = io_lib:format("~ts(~0p", [atom_to_list(Fun), FArg]),
-    lists:foldl(
-        fun(Arg, Literal) ->
-            io_lib:format("~ts, ~0p", [Literal, Arg])
-        end,
-        WithFirstArg,
-        Args
-    ) ++ ")";
+    FuncLiteral =
+        lists:foldl(
+            fun(Arg, Literal) ->
+                io_lib:format("~ts, ~0p", [Literal, Arg])
+            end,
+            WithFirstArg,
+            Args
+        ) ++ ")",
+    iolist_to_binary(FuncLiteral);
 function_literal(Fun, Args) ->
     {invalid_func, {Fun, Args}}.
 
diff --git a/apps/emqx_rule_engine/test/emqx_rule_funcs_SUITE.erl b/apps/emqx_rule_engine/test/emqx_rule_funcs_SUITE.erl
index 93b35fbc4..d157cee7b 100644
--- a/apps/emqx_rule_engine/test/emqx_rule_funcs_SUITE.erl
+++ b/apps/emqx_rule_engine/test/emqx_rule_funcs_SUITE.erl
@@ -215,15 +215,32 @@ hex_convert() ->
     ).
 
 t_is_null(_) ->
+    ?assertEqual(false, emqx_rule_funcs:is_null(null)),
     ?assertEqual(true, emqx_rule_funcs:is_null(undefined)),
+    ?assertEqual(false, emqx_rule_funcs:is_null(<<"undefined">>)),
     ?assertEqual(false, emqx_rule_funcs:is_null(a)),
     ?assertEqual(false, emqx_rule_funcs:is_null(<<>>)),
     ?assertEqual(false, emqx_rule_funcs:is_null(<<"a">>)).
 
+t_is_null_var(_) ->
+    ?assertEqual(true, emqx_rule_funcs:is_null_var(null)),
+    ?assertEqual(false, emqx_rule_funcs:is_null_var(<<"null">>)),
+    ?assertEqual(true, emqx_rule_funcs:is_null_var(undefined)),
+    ?assertEqual(false, emqx_rule_funcs:is_null_var(<<"undefined">>)),
+    ?assertEqual(false, emqx_rule_funcs:is_null_var(a)),
+    ?assertEqual(false, emqx_rule_funcs:is_null_var(<<>>)),
+    ?assertEqual(false, emqx_rule_funcs:is_null_var(<<"a">>)).
+
 t_is_not_null(_) ->
     [
         ?assertEqual(emqx_rule_funcs:is_not_null(T), not emqx_rule_funcs:is_null(T))
-     || T <- [undefined, a, <<"a">>, <<>>]
+     || T <- [undefined, <<"undefined">>, null, <<"null">>, a, <<"a">>, <<>>]
+    ].
+
+t_is_not_null_var(_) ->
+    [
+        ?assertEqual(emqx_rule_funcs:is_not_null_var(T), not emqx_rule_funcs:is_null_var(T))
+     || T <- [undefined, <<"undefined">>, null, <<"null">>, a, <<"a">>, <<>>]
     ].
 
 t_is_str(_) ->
@@ -622,6 +639,63 @@ t_ascii(_) ->
     ?assertEqual(97, apply_func(ascii, [<<"a">>])),
     ?assertEqual(97, apply_func(ascii, [<<"ab">>])).
 
+t_join_to_string(_) ->
+    A = 1,
+    B = a,
+    C = <<"c">>,
+    D = #{a => 1},
+    E = [1, 2, 3],
+    F = [#{<<"key">> => 1, <<"value">> => 2}],
+    M = #{<<"a">> => a, <<"b">> => 1, <<"c">> => <<"c">>},
+    J = <<"{\"a\":\"a\",\"b\":1,\"c\":\"c\"}">>,
+    ?assertEqual(<<"a,b,c">>, apply_func(join_to_string, [<<",">>, [<<"a">>, <<"b">>, <<"c">>]])),
+    ?assertEqual(<<"a b c">>, apply_func(join_to_string, [<<" ">>, [<<"a">>, <<"b">>, <<"c">>]])),
+    ?assertEqual(
+        <<"a, b, c">>, apply_func(join_to_string, [<<", ">>, [<<"a">>, <<"b">>, <<"c">>]])
+    ),
+    ?assertEqual(
+        <<"1, a, c, {\"a\":1}, [1,2,3], [{\"value\":2,\"key\":1}]">>,
+        apply_func(join_to_string, [<<", ">>, [A, B, C, D, E, F]])
+    ),
+    ?assertEqual(<<"a">>, apply_func(join_to_string, [<<",">>, [<<"a">>]])),
+    ?assertEqual(<<"">>, apply_func(join_to_string, [<<",">>, []])),
+    ?assertEqual(<<"a, b, c">>, apply_func(join_to_string, [emqx_rule_funcs:map_keys(M)])),
+    ?assertEqual(<<"a, b, c">>, apply_func(join_to_string, [emqx_rule_funcs:map_keys(J)])),
+    ?assertEqual(<<"a, 1, c">>, apply_func(join_to_string, [emqx_rule_funcs:map_values(M)])),
+    ?assertEqual(<<"a, 1, c">>, apply_func(join_to_string, [emqx_rule_funcs:map_values(J)])).
+
+t_join_to_sql_values_string(_) ->
+    A = 1,
+    B = a,
+    C = <<"c">>,
+    D = #{a => 1},
+    E = [1, 2, 3],
+    E1 = [97, 98],
+    F = [#{<<"key">> => 1, <<"value">> => 2}],
+    M = #{<<"a">> => a, <<"b">> => 1, <<"c">> => <<"c">>},
+    J = <<"{\"a\":\"a\",\"b\":1,\"c\":\"c\"}">>,
+    ?assertEqual(
+        <<"'a', 'b', 'c'">>, apply_func(join_to_sql_values_string, [[<<"a">>, <<"b">>, <<"c">>]])
+    ),
+    ?assertEqual(
+        <<"1, 'a', 'c', '{\"a\":1}', '[1,2,3]', '[97,98]', '[{\"value\":2,\"key\":1}]'">>,
+        apply_func(join_to_sql_values_string, [[A, B, C, D, E, E1, F]])
+    ),
+    ?assertEqual(<<"'a'">>, apply_func(join_to_sql_values_string, [[<<"a">>]])),
+    ?assertEqual(<<"">>, apply_func(join_to_sql_values_string, [[]])),
+    ?assertEqual(
+        <<"'a', 'b', 'c'">>, apply_func(join_to_sql_values_string, [emqx_rule_funcs:map_keys(M)])
+    ),
+    ?assertEqual(
+        <<"'a', 'b', 'c'">>, apply_func(join_to_sql_values_string, [emqx_rule_funcs:map_keys(J)])
+    ),
+    ?assertEqual(
+        <<"'a', 1, 'c'">>, apply_func(join_to_sql_values_string, [emqx_rule_funcs:map_values(M)])
+    ),
+    ?assertEqual(
+        <<"'a', 1, 'c'">>, apply_func(join_to_sql_values_string, [emqx_rule_funcs:map_values(J)])
+    ).
+
 t_find(_) ->
     ?assertEqual(<<"cbcd">>, apply_func(find, [<<"acbcd">>, <<"c">>])),
     ?assertEqual(<<"cbcd">>, apply_func(find, [<<"acbcd">>, <<"c">>, <<"leading">>])),
@@ -746,14 +820,37 @@ t_map_put(_) ->
     ?assertEqual(#{a => 2}, apply_func(map_put, [<<"a">>, 2, #{a => 1}])).
 
 t_mget(_) ->
-    ?assertEqual(1, apply_func(map_get, [<<"a">>, #{a => 1}])),
-    ?assertEqual(1, apply_func(map_get, [<<"a">>, #{<<"a">> => 1}])),
-    ?assertEqual(undefined, apply_func(map_get, [<<"a">>, #{}])).
+    ?assertEqual(1, apply_func(mget, [<<"a">>, #{a => 1}])),
+    ?assertEqual(1, apply_func(mget, [<<"a">>, <<"{\"a\" : 1}">>])),
+    ?assertEqual(1, apply_func(mget, [<<"a">>, #{<<"a">> => 1}])),
+    ?assertEqual(1, apply_func(mget, [<<"a.b">>, #{<<"a.b">> => 1}])),
+    ?assertEqual(undefined, apply_func(mget, [<<"a">>, #{}])).
 
 t_mput(_) ->
-    ?assertEqual(#{<<"a">> => 1}, apply_func(map_put, [<<"a">>, 1, #{}])),
-    ?assertEqual(#{<<"a">> => 2}, apply_func(map_put, [<<"a">>, 2, #{<<"a">> => 1}])),
-    ?assertEqual(#{a => 2}, apply_func(map_put, [<<"a">>, 2, #{a => 1}])).
+    ?assertEqual(#{<<"a">> => 1}, apply_func(mput, [<<"a">>, 1, #{}])),
+    ?assertEqual(#{<<"a">> => 2}, apply_func(mput, [<<"a">>, 2, #{<<"a">> => 1}])),
+    ?assertEqual(#{<<"a">> => 2}, apply_func(mput, [<<"a">>, 2, <<"{\"a\" : 1}">>])),
+    ?assertEqual(#{<<"a.b">> => 2}, apply_func(mput, [<<"a.b">>, 2, #{<<"a.b">> => 1}])),
+    ?assertEqual(#{a => 2}, apply_func(mput, [<<"a">>, 2, #{a => 1}])).
+
+t_map_to_entries(_) ->
+    ?assertEqual([], apply_func(map_to_entries, [#{}])),
+    M = #{a => 1, b => <<"b">>},
+    J = <<"{\"a\":1,\"b\":\"b\"}">>,
+    ?assertEqual(
+        [
+            #{key => a, value => 1},
+            #{key => b, value => <<"b">>}
+        ],
+        apply_func(map_to_entries, [M])
+    ),
+    ?assertEqual(
+        [
+            #{key => <<"a">>, value => 1},
+            #{key => <<"b">>, value => <<"b">>}
+        ],
+        apply_func(map_to_entries, [J])
+    ).
 
 t_bitsize(_) ->
     ?assertEqual(8, apply_func(bitsize, [<<"a">>])),

From d840561036b74ddbc1361d65a4f1789af414559e Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Wed, 24 Jan 2024 21:53:23 +0800
Subject: [PATCH 025/273] build: direct paths to avoid wildcard traversal of
 the _build dir

- erlfmt always try loop through files in the `--exclude-files` dir
---
 Makefile | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index 48ca7ebcb..739195926 100644
--- a/Makefile
+++ b/Makefile
@@ -316,10 +316,9 @@ $(foreach tt,$(ALL_ELIXIR_TGZS),$(eval $(call gen-elixir-tgz-target,$(tt))))
 .PHONY: fmt
 fmt: $(REBAR)
 	@$(SCRIPTS)/erlfmt -w 'apps/*/{src,include,priv,test,integration_test}/**/*.{erl,hrl,app.src,eterm}'
-	@$(SCRIPTS)/erlfmt -w '**/*.escript' --exclude-files '_build/**'
-	@$(SCRIPTS)/erlfmt -w '**/rebar.config' --exclude-files '_build/**'
-	@$(SCRIPTS)/erlfmt -w 'rebar.config.erl'
-	@$(SCRIPTS)/erlfmt -w 'bin/nodetool'
+	@$(SCRIPTS)/erlfmt -w 'apps/*/rebar.config' 'apps/emqx/rebar.config.script' '.ci/fvt_tests/http_server/rebar.config'
+	@$(SCRIPTS)/erlfmt -w 'rebar.config' 'rebar.config.erl'
+	@$(SCRIPTS)/erlfmt -w 'scripts/*.escript' 'bin/*.escript' 'bin/nodetool'
 	@mix format
 
 .PHONY: clean-test-cluster-config

From 5547a40ceb95d9be2537a173df2f44900b87ce2a Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Wed, 24 Jan 2024 11:39:14 -0300
Subject: [PATCH 026/273] fix(ds): don't use env var for data dir default value

Fixes https://github.com/emqx/emqx/pull/12380
---
 apps/emqx/src/emqx_persistent_message.erl | 4 ++--
 apps/emqx/src/emqx_schema.erl             | 7 ++-----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index d725c9b2c..8e3755fdb 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -61,13 +61,13 @@ force_ds() ->
     emqx_config:get([session_persistence, force_persistence]).
 
 storage_backend(#{
-    builtin := #{
+    builtin := Opts = #{
         enable := true,
-        data_dir := DataDir,
         n_shards := NShards,
         replication_factor := ReplicationFactor
     }
 }) ->
+    DataDir = maps:get(data_dir, Opts, emqx:data_dir()),
     #{
         backend => builtin,
         data_dir => DataDir,
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index 56d575bd9..bbca13172 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1896,11 +1896,8 @@ fields("session_storage_backend_builtin") ->
                 string(),
                 #{
                     desc => ?DESC(session_builtin_data_dir),
-                    default => <<"${EMQX_DATA_DIR}">>,
-                    importance => ?IMPORTANCE_LOW,
-                    converter => fun(Path, Opts) ->
-                        naive_env_interpolation(ensure_unicode_path(Path, Opts))
-                    end
+                    required => false,
+                    importance => ?IMPORTANCE_LOW
                 }
             )},
         {"n_shards",

From fa842736d20f0427172347cdc49d2fbdda43c74c Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Fri, 19 Jan 2024 17:13:04 +0100
Subject: [PATCH 027/273] feat: refactor kinesis bridge to connector and action

Fixes:
https://emqx.atlassian.net/browse/EMQX-11461
---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_kinesis.app.src           |   4 +-
 .../src/emqx_bridge_kinesis.erl               | 163 +++++++++++++++++-
 .../src/emqx_bridge_kinesis_action_info.erl   |  22 +++
 .../emqx_bridge_kinesis_connector_client.erl  |  51 ++++--
 .../src/emqx_bridge_kinesis_impl_producer.erl | 137 ++++++++++++---
 ...mqx_bridge_kinesis_impl_producer_SUITE.erl | 108 ++++++++----
 .../src/schema/emqx_connector_ee_schema.erl   |  12 ++
 .../src/schema/emqx_connector_schema.erl      |   2 +
 .../src/emqx_resource_manager.erl             |   5 +
 rel/i18n/emqx_bridge_kinesis.hocon            |  19 ++
 11 files changed, 443 insertions(+), 81 deletions(-)
 create mode 100644 apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 8e5a823e3..7dce9d7cb 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -89,6 +89,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_confluent_producer_action_info,
         emqx_bridge_gcp_pubsub_producer_action_info,
         emqx_bridge_kafka_action_info,
+        emqx_bridge_kinesis_action_info,
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
         emqx_bridge_influxdb_action_info,
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.app.src b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.app.src
index 74d7dc94f..2e59fa8b2 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.app.src
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.app.src
@@ -1,13 +1,13 @@
 {application, emqx_bridge_kinesis, [
     {description, "EMQX Enterprise Amazon Kinesis Bridge"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {applications, [
         kernel,
         stdlib,
         erlcloud
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_kinesis_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index 14e197113..41717abe8 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -15,7 +15,9 @@
 ]).
 
 -export([
-    conn_bridge_examples/1
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
 ]).
 
 %%-------------------------------------------------------------------------------------------------
@@ -28,6 +30,37 @@ namespace() ->
 roots() ->
     [].
 
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    emqx_connector_schema:api_fields(
+        Field,
+        kinesis,
+        connector_config_fields()
+    );
+fields(action) ->
+    {kinesis,
+        hoconsc:mk(
+            hoconsc:map(name, hoconsc:ref(?MODULE, kinesis_action)),
+            #{
+                desc => <<"Kinesis Action Config">>,
+                required => false
+            }
+        )};
+fields(action_parameters) ->
+    fields(producer);
+fields(kinesis_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        hoconsc:mk(
+            hoconsc:ref(?MODULE, action_parameters),
+            #{
+                required => true,
+                desc => ?DESC("action_parameters")
+            }
+        )
+    );
 fields("config_producer") ->
     emqx_bridge_schema:common_bridge_fields() ++
         fields("resource_opts") ++
@@ -134,12 +167,38 @@ fields("get_producer") ->
 fields("post_producer") ->
     [type_field_producer(), name_field() | fields("config_producer")];
 fields("put_producer") ->
-    fields("config_producer").
+    fields("config_producer");
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        connector_config_fields() ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields("put_bridge_v2") ->
+    fields(kinesis_action);
+fields("get_bridge_v2") ->
+    fields(kinesis_action);
+fields("post_bridge_v2") ->
+    fields("post", kinesis, kinesis_action).
+
+fields("post", Type, StructName) ->
+    [type_field(Type), name_field() | fields(StructName)].
+
+type_field(Type) ->
+    {type, hoconsc:mk(hoconsc:enum([Type]), #{required => true, desc => ?DESC("desc_type")})}.
 
 desc("config_producer") ->
     ?DESC("desc_config");
 desc("creation_opts") ->
     ?DESC(emqx_resource_schema, "creation_opts");
+desc("config_connector") ->
+    ?DESC("config_connector");
+desc(kinesis_action) ->
+    ?DESC("kinesis_action");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(_) ->
     undefined.
 
@@ -153,6 +212,103 @@ conn_bridge_examples(Method) ->
         }
     ].
 
+connector_examples(Method) ->
+    [
+        #{
+            <<"kinesis">> => #{
+                summary => <<"Kinesis Connector">>,
+                value => values({Method, connector})
+            }
+        }
+    ].
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"kinesis">> => #{
+                summary => <<"Kinesis Action">>,
+                value => values({Method, bridge_v2_producer})
+            }
+        }
+    ].
+
+values({get, connector}) ->
+    maps:merge(
+        #{
+            status => <<"connected">>,
+            node_status => [
+                #{
+                    node => <<"emqx@localhost">>,
+                    status => <<"connected">>
+                }
+            ],
+            actions => [<<"my_action">>]
+        },
+        values({post, connector})
+    );
+values({get, Type}) ->
+    maps:merge(
+        #{
+            status => <<"connected">>,
+            node_status => [
+                #{
+                    node => <<"emqx@localhost">>,
+                    status => <<"connected">>
+                }
+            ]
+        },
+        values({post, Type})
+    );
+values({post, connector}) ->
+    maps:merge(
+        #{
+            name => <<"my_kinesis_connector">>,
+            type => <<"kinesis">>
+        },
+        values(common_config)
+    );
+values({post, Type}) ->
+    maps:merge(
+        #{
+            name => <<"my_kinesis_action">>,
+            type => <<"kinesis">>
+        },
+        values({put, Type})
+    );
+values({put, bridge_v2_producer}) ->
+    values(bridge_v2_producer);
+values({put, connector}) ->
+    values(common_config);
+values({put, Type}) ->
+    maps:merge(values(common_config), values(Type));
+values(bridge_v2_producer) ->
+    #{
+        enable => true,
+        connector => <<"my_kinesis_connector">>,
+        parameters => values(producer_values),
+        resource_opts => #{
+            <<"batch_size">> => 100,
+            <<"inflight_window">> => 100,
+            <<"max_buffer_bytes">> => <<"256MB">>,
+            <<"request_ttl">> => <<"45s">>
+        }
+    };
+values(common_config) ->
+    #{
+        <<"enable">> => true,
+        <<"aws_access_key_id">> => <<"your_access_key">>,
+        <<"aws_secret_access_key">> => <<"aws_secret_key">>,
+        <<"endpoint">> => <<"http://localhost:4566">>,
+        <<"max_retries">> => 2,
+        <<"pool_size">> => 8
+    };
+values(producer_values) ->
+    #{
+        <<"partition_key">> => <<"any_key">>,
+        <<"payload_template">> => <<"${.}">>,
+        <<"stream_name">> => <<"my_stream">>
+    }.
+
 values(producer, _Method) ->
     #{
         aws_access_key_id => <<"aws_access_key_id">>,
@@ -174,6 +330,9 @@ values(producer, _Method) ->
 %% Helper fns
 %%-------------------------------------------------------------------------------------------------
 
+connector_config_fields() ->
+    fields(connector_config).
+
 sc(Type, Meta) -> hoconsc:mk(Type, Meta).
 
 mk(Type, Meta) -> hoconsc:mk(Type, Meta).
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl
new file mode 100644
index 000000000..c7fb5e1e5
--- /dev/null
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl
@@ -0,0 +1,22 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_kinesis_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+bridge_v1_type_name() -> kinesis_producer.
+
+action_type_name() -> kinesis.
+
+connector_type_name() -> kinesis.
+
+schema_module() -> emqx_bridge_kinesis.
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_connector_client.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_connector_client.erl
index 959b539a0..518a9b668 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_connector_client.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_connector_client.erl
@@ -11,9 +11,7 @@
 -behaviour(gen_server).
 
 -type state() :: #{
-    instance_id := resource_id(),
-    partition_key := binary(),
-    stream_name := binary()
+    instance_id := resource_id()
 }.
 -type record() :: {Data :: binary(), PartitionKey :: binary()}.
 
@@ -23,7 +21,8 @@
 -export([
     start_link/1,
     connection_status/1,
-    query/2
+    connection_status/2,
+    query/3
 ]).
 
 %% gen_server callbacks
@@ -56,8 +55,16 @@ connection_status(Pid) ->
             {error, timeout}
     end.
 
-query(Pid, Records) ->
-    gen_server:call(Pid, {query, Records}, infinity).
+connection_status(Pid, StreamName) ->
+    try
+        gen_server:call(Pid, {connection_status, StreamName}, ?HEALTH_CHECK_TIMEOUT)
+    catch
+        _:_ ->
+            {error, timeout}
+    end.
+
+query(Pid, Records, StreamName) ->
+    gen_server:call(Pid, {query, Records, StreamName}, infinity).
 
 %%--------------------------------------------------------------------
 %% @doc
@@ -72,13 +79,12 @@ start_link(Options) ->
 %%%===================================================================
 
 %% Initialize kinesis connector
--spec init(emqx_bridge_kinesis_impl_producer:config()) -> {ok, state()}.
+-spec init(emqx_bridge_kinesis_impl_producer:config_connector()) ->
+    {ok, state()} | {stop, Reason :: term()}.
 init(#{
     aws_access_key_id := AwsAccessKey,
     aws_secret_access_key := AwsSecretAccessKey,
     endpoint := Endpoint,
-    partition_key := PartitionKey,
-    stream_name := StreamName,
     max_retries := MaxRetries,
     instance_id := InstanceId
 }) ->
@@ -93,9 +99,7 @@ init(#{
             }
         ),
     State = #{
-        instance_id => InstanceId,
-        partition_key => PartitionKey,
-        stream_name => StreamName
+        instance_id => InstanceId
     },
     %% TODO: teach `erlcloud` to to accept 0-arity closures as passwords.
     ok = erlcloud_config:configure(
@@ -124,18 +128,19 @@ init(#{
             {stop, Reason}
     end.
 
-handle_call(connection_status, _From, #{stream_name := StreamName} = State) ->
+handle_call({connection_status, StreamName}, _From, State) ->
+    Status = get_status(StreamName),
+    {reply, Status, State};
+handle_call(connection_status, _From, State) ->
     Status =
-        case erlcloud_kinesis:describe_stream(StreamName) of
-            {ok, _} ->
+        case erlcloud_kinesis:list_streams() of
+            {ok, _ListStreamsResult} ->
                 {ok, connected};
-            {error, {<<"ResourceNotFoundException">>, _}} ->
-                {error, unhealthy_target};
             Error ->
                 {error, Error}
         end,
     {reply, Status, State};
-handle_call({query, Records}, _From, #{stream_name := StreamName} = State) ->
+handle_call({query, Records, StreamName}, _From, State) ->
     Result = do_query(StreamName, Records),
     {reply, Result, State};
 handle_call(_Request, _From, State) ->
@@ -158,6 +163,16 @@ code_change(_OldVsn, State, _Extra) ->
 %%% Internal functions
 %%%===================================================================
 
+get_status(StreamName) ->
+    case erlcloud_kinesis:describe_stream(StreamName) of
+        {ok, _} ->
+            {ok, connected};
+        {error, {<<"ResourceNotFoundException">>, _}} ->
+            {error, unhealthy_target};
+        Error ->
+            {error, Error}
+    end.
+
 -spec do_query(binary(), [record()]) ->
     {ok, jsx:json_term() | binary()}
     | {error, {unrecoverable_error, term()}}
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
index decf3e83b..b71373897 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
@@ -13,27 +13,20 @@
     "Kinesis stream is invalid. Please check if the stream exist in Kinesis account."
 ).
 
--type config() :: #{
+-type config_connector() :: #{
     aws_access_key_id := binary(),
     aws_secret_access_key := emqx_secret:t(binary()),
     endpoint := binary(),
-    stream_name := binary(),
-    partition_key := binary(),
-    payload_template := binary(),
     max_retries := non_neg_integer(),
     pool_size := non_neg_integer(),
     instance_id => resource_id(),
     any() => term()
 }.
--type templates() :: #{
-    partition_key := list(),
-    send_message := list()
-}.
 -type state() :: #{
     pool_name := resource_id(),
-    templates := templates()
+    installed_channels := map()
 }.
--export_type([config/0]).
+-export_type([config_connector/0]).
 
 %% `emqx_resource' API
 -export([
@@ -42,7 +35,11 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
 -export([
@@ -55,7 +52,7 @@
 
 callback_mode() -> always_sync.
 
--spec on_start(resource_id(), config()) -> {ok, state()} | {error, term()}.
+-spec on_start(resource_id(), config_connector()) -> {ok, state()} | {error, term()}.
 on_start(
     InstanceId,
     #{
@@ -72,10 +69,9 @@ on_start(
         {config, Config},
         {pool_size, PoolSize}
     ],
-    Templates = parse_template(Config),
     State = #{
         pool_name => InstanceId,
-        templates => Templates
+        installed_channels => #{}
     },
 
     case emqx_resource_pool:start(InstanceId, ?MODULE, Options) of
@@ -123,31 +119,111 @@ on_get_status(_InstanceId, #{pool_name := Pool} = State) ->
             disconnected
     end.
 
+on_add_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels
+    } = OldState,
+    ChannelId,
+    ChannelConfig
+) ->
+    {ok, ChannelState} = create_channel_state(ChannelConfig),
+    NewInstalledChannels = maps:put(ChannelId, ChannelState, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+create_channel_state(
+    #{parameters := Parameters} = _ChannelConfig
+) ->
+    #{
+        stream_name := StreamName,
+        partition_key := PartitionKey
+    } = Parameters,
+    {ok, #{
+        templates => parse_template(Parameters),
+        stream_name => StreamName,
+        partition_key => PartitionKey
+    }}.
+
+on_remove_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels
+    } = OldState,
+    ChannelId
+) ->
+    NewInstalledChannels = maps:remove(ChannelId, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+on_get_channel_status(
+    _ResId,
+    ChannelId,
+    #{
+        pool_name := PoolName,
+        installed_channels := Channels
+    } = State
+) ->
+    #{stream_name := StreamName} = maps:get(ChannelId, Channels),
+    case
+        emqx_resource_pool:health_check_workers(
+            PoolName,
+            {emqx_bridge_kinesis_connector_client, connection_status, [StreamName]},
+            ?HEALTH_CHECK_TIMEOUT,
+            #{return_values => true}
+        )
+    of
+        {ok, Values} ->
+            AllOk = lists:all(fun(S) -> S =:= {ok, connected} end, Values),
+            case AllOk of
+                true ->
+                    connected;
+                false ->
+                    Unhealthy = lists:any(fun(S) -> S =:= {error, unhealthy_target} end, Values),
+                    case Unhealthy of
+                        true -> {disconnected, {unhealthy_target, ?TOPIC_MESSAGE}};
+                        false -> disconnected
+                    end
+            end;
+        {error, Reason} ->
+            ?SLOG(error, #{
+                msg => "kinesis_producer_get_status_failed",
+                state => State,
+                reason => Reason
+            }),
+            disconnected
+    end.
+
+on_get_channels(ResId) ->
+    emqx_bridge_v2:get_channels_for_connector(ResId).
+
 -spec on_query(
     resource_id(),
-    {send_message, map()},
+    {channel_id(), map()},
     state()
 ) ->
     {ok, map()}
     | {error, {recoverable_error, term()}}
     | {error, term()}.
-on_query(ResourceId, {send_message, Message}, State) ->
-    Requests = [{send_message, Message}],
+on_query(ResourceId, {ChannelId, Message}, State) ->
+    Requests = [{ChannelId, Message}],
     ?tp(emqx_bridge_kinesis_impl_producer_sync_query, #{message => Message}),
-    do_send_requests_sync(ResourceId, Requests, State).
+    do_send_requests_sync(ResourceId, Requests, State, ChannelId).
 
 -spec on_batch_query(
     resource_id(),
-    [{send_message, map()}],
+    [{channel_id(), map()}],
     state()
 ) ->
     {ok, map()}
     | {error, {recoverable_error, term()}}
     | {error, term()}.
 %% we only support batch insert
-on_batch_query(ResourceId, [{send_message, _} | _] = Requests, State) ->
+on_batch_query(ResourceId, [{ChannelId, _} | _] = Requests, State) ->
     ?tp(emqx_bridge_kinesis_impl_producer_sync_batch_query, #{requests => Requests}),
-    do_send_requests_sync(ResourceId, Requests, State).
+    do_send_requests_sync(ResourceId, Requests, State, ChannelId).
 
 connect(Opts) ->
     Options = proplists:get_value(config, Opts),
@@ -159,8 +235,9 @@ connect(Opts) ->
 
 -spec do_send_requests_sync(
     resource_id(),
-    [{send_message, map()}],
-    state()
+    [{channel_id(), map()}],
+    state(),
+    channel_id()
 ) ->
     {ok, jsx:json_term() | binary()}
     | {error, {recoverable_error, term()}}
@@ -171,12 +248,20 @@ connect(Opts) ->
 do_send_requests_sync(
     InstanceId,
     Requests,
-    #{pool_name := PoolName, templates := Templates}
+    #{
+        pool_name := PoolName,
+        installed_channels := InstalledChannels
+    } = _State,
+    ChannelId
 ) ->
+    #{
+        templates := Templates,
+        stream_name := StreamName
+    } = maps:get(ChannelId, InstalledChannels),
     Records = render_records(Requests, Templates),
     Result = ecpool:pick_and_do(
         PoolName,
-        {emqx_bridge_kinesis_connector_client, query, [Records]},
+        {emqx_bridge_kinesis_connector_client, query, [Records, StreamName]},
         no_handover
     ),
     handle_result(Result, Requests, InstanceId).
@@ -239,7 +324,7 @@ render_records(Items, Templates) ->
 render_messages([], _Templates, RenderedMsgs) ->
     RenderedMsgs;
 render_messages(
-    [{send_message, Msg} | Others],
+    [{_, Msg} | Others],
     {MsgTemplate, PartitionKeyTemplate} = Templates,
     RenderedMsgs
 ) ->
diff --git a/apps/emqx_bridge_kinesis/test/emqx_bridge_kinesis_impl_producer_SUITE.erl b/apps/emqx_bridge_kinesis/test/emqx_bridge_kinesis_impl_producer_SUITE.erl
index 61b354ea3..04a084462 100644
--- a/apps/emqx_bridge_kinesis/test/emqx_bridge_kinesis_impl_producer_SUITE.erl
+++ b/apps/emqx_bridge_kinesis/test/emqx_bridge_kinesis_impl_producer_SUITE.erl
@@ -13,6 +13,7 @@
 
 -define(BRIDGE_TYPE, kinesis_producer).
 -define(BRIDGE_TYPE_BIN, <<"kinesis_producer">>).
+-define(BRIDGE_V2_TYPE_BIN, <<"kinesis">>).
 -define(KINESIS_PORT, 4566).
 -define(KINESIS_ACCESS_KEY, "aws_access_key_id").
 -define(KINESIS_SECRET_KEY, "aws_secret_access_key").
@@ -48,7 +49,7 @@ init_per_suite(Config) ->
     [
         {proxy_host, ProxyHost},
         {proxy_port, ProxyPort},
-        {kinesis_port, ?KINESIS_PORT},
+        {kinesis_port, list_to_integer(os:getenv("KINESIS_PORT", integer_to_list(?KINESIS_PORT)))},
         {kinesis_secretfile, SecretFile},
         {proxy_name, ProxyName}
         | Config
@@ -116,7 +117,7 @@ generate_config(Config0) ->
             }
         ),
     ErlcloudConfig = erlcloud_kinesis:new("access_key", "secret", Host, Port, Scheme ++ "://"),
-    ResourceId = emqx_bridge_resource:resource_id(?BRIDGE_TYPE_BIN, Name),
+    ResourceId = connector_resource_id(?BRIDGE_V2_TYPE_BIN, Name),
     BridgeId = emqx_bridge_resource:bridge_id(?BRIDGE_TYPE_BIN, Name),
     [
         {kinesis_name, Name},
@@ -129,6 +130,9 @@ generate_config(Config0) ->
         | Config0
     ].
 
+connector_resource_id(BridgeType, Name) ->
+    <<"connector:", BridgeType/binary, ":", Name/binary>>.
+
 kinesis_config(Config) ->
     QueryMode = proplists:get_value(query_mode, Config, async),
     Scheme = proplists:get_value(connection_scheme, Config, "http"),
@@ -505,7 +509,7 @@ t_start_failed_then_fix(Config) ->
     ProxyPort = ?config(proxy_port, Config),
     ProxyHost = ?config(proxy_host, Config),
     ProxyName = ?config(proxy_name, Config),
-    ResourceId = ?config(resource_id, Config),
+    Name = ?config(kinesis_name, Config),
     emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
         ct:sleep(1000),
         ?wait_async_action(
@@ -517,7 +521,7 @@ t_start_failed_then_fix(Config) ->
     ?retry(
         _Sleep1 = 1_000,
         _Attempts1 = 30,
-        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+        ?assertMatch(#{status := connected}, emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name))
     ),
     ok.
 
@@ -538,40 +542,58 @@ t_stop(Config) ->
     ok.
 
 t_get_status_ok(Config) ->
-    ResourceId = ?config(resource_id, Config),
+    Name = ?config(kinesis_name, Config),
     {ok, _} = create_bridge(Config),
-    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId)),
+    ?assertMatch(#{status := connected}, emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)),
     ok.
 
 t_create_unhealthy(Config) ->
     delete_stream(Config),
-    ResourceId = ?config(resource_id, Config),
+    Name = ?config(kinesis_name, Config),
     {ok, _} = create_bridge(Config),
-    ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceId)),
     ?assertMatch(
-        {ok, _, #{error := {unhealthy_target, _}}},
-        emqx_resource_manager:lookup_cached(ResourceId)
+        #{
+            status := disconnected,
+            error := {unhealthy_target, _}
+        },
+        emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
     ),
     ok.
 
 t_get_status_unhealthy(Config) ->
-    delete_stream(Config),
-    ResourceId = ?config(resource_id, Config),
+    Name = ?config(kinesis_name, Config),
     {ok, _} = create_bridge(Config),
-    ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceId)),
     ?assertMatch(
-        {ok, _, #{error := {unhealthy_target, _}}},
-        emqx_resource_manager:lookup_cached(ResourceId)
+        #{
+            status := connected
+        },
+        emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
+    ),
+    delete_stream(Config),
+    ?retry(
+        100,
+        100,
+        fun() ->
+            ?assertMatch(
+                #{
+                    status := disconnected,
+                    error := {unhealthy_target, _}
+                },
+                emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
+            )
+        end
     ),
     ok.
 
 t_publish_success(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     ShardIt = get_shard_iterator(Config),
     Payload = <<"payload">>,
     Message = emqx_message:make(?TOPIC, Payload),
@@ -590,7 +612,7 @@ t_publish_success(Config) ->
             retried => 0,
             success => 1
         },
-        ResourceId
+        ActionId
     ),
     Record = wait_record(Config, ShardIt, 100, 10),
     ?assertEqual(Payload, proplists:get_value(<<"Data">>, Record)),
@@ -599,6 +621,7 @@ t_publish_success(Config) ->
 t_publish_success_with_template(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     Overrides =
         #{
             <<"payload_template">> => <<"${payload.data}">>,
@@ -607,7 +630,8 @@ t_publish_success_with_template(Config) ->
     ?assertMatch({ok, _}, create_bridge(Config, Overrides)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     ShardIt = get_shard_iterator(Config),
     Payload = <<"{\"key\":\"my_key\", \"data\":\"my_data\"}">>,
     Message = emqx_message:make(?TOPIC, Payload),
@@ -626,7 +650,7 @@ t_publish_success_with_template(Config) ->
             retried => 0,
             success => 1
         },
-        ResourceId
+        ActionId
     ),
     Record = wait_record(Config, ShardIt, 100, 10),
     ?assertEqual(<<"my_data">>, proplists:get_value(<<"Data">>, Record)),
@@ -635,10 +659,12 @@ t_publish_success_with_template(Config) ->
 t_publish_multiple_msgs_success(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     ShardIt = get_shard_iterator(Config),
     lists:foreach(
         fun(I) ->
@@ -675,17 +701,19 @@ t_publish_multiple_msgs_success(Config) ->
             retried => 0,
             success => 10
         },
-        ResourceId
+        ActionId
     ),
     ok.
 
 t_publish_unhealthy(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     ShardIt = get_shard_iterator(Config),
     Payload = <<"payload">>,
     Message = emqx_message:make(?TOPIC, Payload),
@@ -709,22 +737,26 @@ t_publish_unhealthy(Config) ->
             retried => 0,
             success => 0
         },
-        ResourceId
+        ActionId
     ),
-    ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceId)),
     ?assertMatch(
-        {ok, _, #{error := {unhealthy_target, _}}},
-        emqx_resource_manager:lookup_cached(ResourceId)
+        #{
+            status := disconnected,
+            error := {unhealthy_target, _}
+        },
+        emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
     ),
     ok.
 
 t_publish_big_msg(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     % Maximum size is 1MB. Using 1MB + 1 here.
     Payload = binary:copy(<<"a">>, 1 * 1024 * 1024 + 1),
     Message = emqx_message:make(?TOPIC, Payload),
@@ -743,7 +775,7 @@ t_publish_big_msg(Config) ->
             retried => 0,
             success => 0
         },
-        ResourceId
+        ActionId
     ),
     ok.
 
@@ -754,15 +786,20 @@ t_publish_connection_down(Config0) ->
     ProxyName = ?config(proxy_name, Config),
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     ?retry(
         _Sleep1 = 1_000,
         _Attempts1 = 30,
-        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+        ?assertMatch(
+            #{status := connected},
+            emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
+        )
     ),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
-    assert_empty_metrics(ResourceId),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
+    assert_empty_metrics(ActionId),
     ShardIt = get_shard_iterator(Config),
     Payload = <<"payload">>,
     Message = emqx_message:make(?TOPIC, Payload),
@@ -784,7 +821,10 @@ t_publish_connection_down(Config0) ->
     ?retry(
         _Sleep3 = 1_000,
         _Attempts3 = 20,
-        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+        ?assertMatch(
+            #{status := connected},
+            emqx_bridge_v2:health_check(?BRIDGE_V2_TYPE_BIN, Name)
+        )
     ),
     Record = wait_record(Config, ShardIt, 2000, 10),
     %% to avoid test flakiness
@@ -802,7 +842,7 @@ t_publish_connection_down(Config0) ->
             success => 1,
             retried_success => 1
         },
-        ResourceId
+        ActionId
     ),
     Data = proplists:get_value(<<"Data">>, Record),
     ?assertEqual(Payload, Data),
@@ -880,9 +920,11 @@ t_empty_payload_template(Config) ->
     ResourceId = ?config(resource_id, Config),
     TelemetryTable = ?config(telemetry_table, Config),
     Removes = [<<"payload_template">>],
+    Name = ?config(kinesis_name, Config),
     ?assertMatch({ok, _}, create_bridge(Config, #{}, Removes)),
     {ok, #{<<"id">> := RuleId}} = create_rule_and_action_http(Config),
     emqx_common_test_helpers:on_exit(fun() -> ok = emqx_rule_engine:delete_rule(RuleId) end),
+    ActionId = emqx_bridge_v2:id(?BRIDGE_V2_TYPE_BIN, Name),
     assert_empty_metrics(ResourceId),
     ShardIt = get_shard_iterator(Config),
     Payload = <<"payload">>,
@@ -902,7 +944,7 @@ t_empty_payload_template(Config) ->
             retried => 0,
             success => 1
         },
-        ResourceId
+        ActionId
     ),
     Record = wait_record(Config, ShardIt, 100, 10),
     Data = proplists:get_value(<<"Data">>, Record),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 077723538..8e81b12ea 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -30,6 +30,8 @@ resource_type(gcp_pubsub_producer) ->
     emqx_bridge_gcp_pubsub_impl_producer;
 resource_type(kafka_producer) ->
     emqx_bridge_kafka_impl_producer;
+resource_type(kinesis) ->
+    emqx_bridge_kinesis_impl_producer;
 resource_type(matrix) ->
     emqx_postgresql;
 resource_type(mongodb) ->
@@ -112,6 +114,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {kinesis,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_kinesis, "config_connector")),
+                #{
+                    desc => <<"Kinesis Connector Config">>,
+                    required => false
+                }
+            )},
         {matrix,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_matrix, "config_connector")),
@@ -224,6 +234,7 @@ schema_modules() ->
         emqx_bridge_confluent_producer,
         emqx_bridge_gcp_pubsub_producer_schema,
         emqx_bridge_kafka,
+        emqx_bridge_kinesis,
         emqx_bridge_matrix,
         emqx_bridge_mongodb,
         emqx_bridge_influxdb,
@@ -255,6 +266,7 @@ api_schemas(Method) ->
             Method ++ "_connector"
         ),
         api_ref(emqx_bridge_kafka, <<"kafka_producer">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_kinesis, <<"kinesis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_matrix, <<"matrix">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mongodb, <<"mongodb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_influxdb, <<"influxdb">>, Method ++ "_connector"),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 3c5fdfc03..d5c450529 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -131,6 +131,8 @@ connector_type_to_bridge_types(gcp_pubsub_producer) ->
     [gcp_pubsub, gcp_pubsub_producer];
 connector_type_to_bridge_types(kafka_producer) ->
     [kafka, kafka_producer];
+connector_type_to_bridge_types(kinesis) ->
+    [kinesis, kinesis_producer];
 connector_type_to_bridge_types(matrix) ->
     [matrix];
 connector_type_to_bridge_types(mongodb) ->
diff --git a/apps/emqx_resource/src/emqx_resource_manager.erl b/apps/emqx_resource/src/emqx_resource_manager.erl
index 4fd566f26..a9b4ebeb1 100644
--- a/apps/emqx_resource/src/emqx_resource_manager.erl
+++ b/apps/emqx_resource/src/emqx_resource_manager.erl
@@ -1247,6 +1247,11 @@ channel_status({?status_connecting, Error}) ->
         status => ?status_connecting,
         error => Error
     };
+channel_status({?status_disconnected, Error}) ->
+    #{
+        status => ?status_disconnected,
+        error => Error
+    };
 channel_status(?status_disconnected) ->
     #{
         status => ?status_disconnected,
diff --git a/rel/i18n/emqx_bridge_kinesis.hocon b/rel/i18n/emqx_bridge_kinesis.hocon
index 188ab82f3..bd4a3080b 100644
--- a/rel/i18n/emqx_bridge_kinesis.hocon
+++ b/rel/i18n/emqx_bridge_kinesis.hocon
@@ -82,4 +82,23 @@ max_retries.desc:
 max_retries.label:
 """Max Retries"""
 
+action_parameters.desc:
+"""Action specific configuration."""
+
+action_parameters.label:
+"""Action"""
+
+kinesis_action.desc:
+"""Configuration for Kinesis Action"""
+
+kinesis_action.label:
+"""Kinesis Action Configuration"""
+
+
+config_connector.desc:
+"""Configuration for a Kinesis Client."""
+
+config_connector.label:
+"""Kinesis Client Configuration"""
+
 }

From 25a88ccd040c2f7f69a22262a8966a1c30764e69 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Wed, 24 Jan 2024 18:36:56 +0100
Subject: [PATCH 028/273] docs: add change log entry for Kinesis bridge
 refactoring

---
 changes/ee/feat-12376.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12376.en.md

diff --git a/changes/ee/feat-12376.en.md b/changes/ee/feat-12376.en.md
new file mode 100644
index 000000000..e17868928
--- /dev/null
+++ b/changes/ee/feat-12376.en.md
@@ -0,0 +1 @@
+The Kinesis bridge has been split into connector and action components. Old Kinesis bridges will be upgraded automatically.

From 9b7df302e889e876e09047272c7e36b2fcc202d6 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 24 Jan 2024 18:42:24 +0100
Subject: [PATCH 029/273] fix(ds): Cache database metadata in RAM

---
 .../src/emqx_ds_replication_layer_meta.erl                    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
index 38c2dbbe7..16c52f20e 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
@@ -388,7 +388,7 @@ ensure_tables() ->
         {rlog_shard, ?SHARD},
         {majority, Majority},
         {type, ordered_set},
-        {storage, rocksdb_copies},
+        {storage, disc_copies},
         {record_name, ?META_TAB},
         {attributes, record_info(fields, ?META_TAB)}
     ]),
@@ -396,7 +396,7 @@ ensure_tables() ->
         {rlog_shard, ?SHARD},
         {majority, Majority},
         {type, ordered_set},
-        {storage, rocksdb_copies},
+        {storage, disc_copies},
         {record_name, ?NODE_TAB},
         {attributes, record_info(fields, ?NODE_TAB)}
     ]),

From 137535a82140313b1b3334e75717862cb91bac48 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 22 Jan 2024 22:45:56 +0100
Subject: [PATCH 030/273] feat(ds): Introduce egress process for the builtin
 backend

---
 .../emqx_persistent_session_ds_SUITE.erl      |  11 +-
 apps/emqx/src/emqx_persistent_message.erl     |   4 +-
 .../test/emqx_persistent_messages_SUITE.erl   |   4 +-
 .../test/emqx_persistent_session_SUITE.erl    |   2 +-
 apps/emqx_durable_storage/src/emqx_ds.erl     |   8 +-
 apps/emqx_durable_storage/src/emqx_ds_app.erl |   2 +-
 .../src/emqx_ds_builtin_db_sup.erl            | 152 +++++++++++++++
 .../src/emqx_ds_builtin_sup.erl               | 132 +++++++++++++
 .../src/emqx_ds_replication_layer.erl         | 112 ++++++-----
 .../src/emqx_ds_replication_layer.hrl         |  33 ++++
 .../src/emqx_ds_replication_layer_egress.erl  | 175 ++++++++++++++++++
 .../src/emqx_ds_replication_layer_meta.erl    |  12 +-
 .../src/emqx_ds_storage_layer.erl             |   6 +-
 .../src/emqx_ds_storage_layer_sup.erl         |   4 +-
 apps/emqx_durable_storage/src/emqx_ds_sup.erl |  66 +++----
 .../test/emqx_ds_SUITE.erl                    |   2 +-
 .../emqx_ds_storage_bitfield_lts_SUITE.erl    |  31 ++--
 17 files changed, 615 insertions(+), 141 deletions(-)
 create mode 100644 apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
 create mode 100644 apps/emqx_durable_storage/src/emqx_ds_builtin_sup.erl
 create mode 100644 apps/emqx_durable_storage/src/emqx_ds_replication_layer.hrl
 create mode 100644 apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index b5beb9ae7..fba36601f 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_persistent_session_ds_SUITE).
 
@@ -18,6 +18,9 @@
 %% CT boilerplate
 %%------------------------------------------------------------------------------
 
+suite() ->
+    [{timetrap, {seconds, 60}}].
+
 all() ->
     emqx_common_test_helpers:all(?MODULE).
 
@@ -191,6 +194,7 @@ t_non_persistent_session_subscription(_Config) ->
     ClientId = atom_to_binary(?FUNCTION_NAME),
     SubTopicFilter = <<"t/#">>,
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             ?tp(notice, "starting", #{}),
             Client = start_client(#{
@@ -220,6 +224,7 @@ t_session_subscription_idempotency(Config) ->
     SubTopicFilter = <<"t/+">>,
     ClientId = <<"myclientid">>,
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             ?force_ordering(
                 #{?snk_kind := persistent_session_ds_subscription_added},
@@ -281,6 +286,7 @@ t_session_unsubscription_idempotency(Config) ->
     SubTopicFilter = <<"t/+">>,
     ClientId = <<"myclientid">>,
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             ?force_ordering(
                 #{
@@ -385,6 +391,7 @@ do_t_session_discard(Params) ->
     ReconnectOpts = ReconnectOpts0#{clientid => ClientId},
     SubTopicFilter = <<"t/+">>,
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             ?tp(notice, "starting", #{}),
             Client0 = start_client(#{
@@ -472,6 +479,7 @@ do_t_session_expiration(_Config, Opts) ->
     } = Opts,
     CommonParams = #{proto_ver => v5, clientid => ClientId},
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             Topic = <<"some/topic">>,
             Params0 = maps:merge(CommonParams, FirstConn),
@@ -539,6 +547,7 @@ t_session_gc(Config) ->
     end,
 
     ?check_trace(
+        #{timetrap => 30_000},
         begin
             ClientId0 = <<"session_gc0">>,
             Client0 = StartClient(ClientId0, Port1, 30),
diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index 8e3755fdb..effad17dd 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2021-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2021-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -99,7 +99,7 @@ needs_persistence(Msg) ->
 
 -spec store_message(emqx_types:message()) -> emqx_ds:store_batch_result().
 store_message(Msg) ->
-    emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, [Msg]).
+    emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, [Msg], #{sync => false}).
 
 has_subscribers(#message{topic = Topic}) ->
     emqx_persistent_session_ds_router:has_any_route(Topic).
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index 36c8848cf..0c0eaac28 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -376,7 +376,7 @@ t_publish_empty_topic_levels(_Config) ->
             {<<"t/3/bar">>, <<"6">>}
         ],
         [emqtt:publish(Pub, Topic, Payload, ?QOS_1) || {Topic, Payload} <- Messages],
-        Received = receive_messages(length(Messages), 1_500),
+        Received = receive_messages(length(Messages)),
         ?assertMatch(
             [
                 #{topic := <<"t//1/">>, payload := <<"2">>},
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 09cbf306d..f2a42332e 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2021-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2021-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
diff --git a/apps/emqx_durable_storage/src/emqx_ds.erl b/apps/emqx_durable_storage/src/emqx_ds.erl
index 434169520..1402a19e3 100644
--- a/apps/emqx_durable_storage/src/emqx_ds.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -111,11 +111,15 @@
 %% use in emqx_guid.  Otherwise, the iterators won't match the message timestamps.
 -type time() :: non_neg_integer().
 
--type message_store_opts() :: #{}.
+-type message_store_opts() ::
+    #{
+        sync => boolean()
+    }.
 
 -type generic_db_opts() ::
     #{
         backend := atom(),
+        serialize_by => clientid | topic,
         _ => _
     }.
 
diff --git a/apps/emqx_durable_storage/src/emqx_ds_app.erl b/apps/emqx_durable_storage/src/emqx_ds_app.erl
index 858855b6f..dcf353a99 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_app.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_app.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_ds_app).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
new file mode 100644
index 000000000..9df07eb18
--- /dev/null
+++ b/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
@@ -0,0 +1,152 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+%% @doc Supervisor that contains all the processes that belong to a
+%% given builtin DS database.
+-module(emqx_ds_builtin_db_sup).
+
+-behaviour(supervisor).
+
+%% API:
+-export([start_db/2, start_shard/1, start_egress/1, stop_shard/1, ensure_shard/1]).
+
+%% behaviour callbacks:
+-export([init/1]).
+
+%% internal exports:
+-export([start_link_sup/2]).
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+-define(via(REC), {via, gproc, {n, l, REC}}).
+
+-define(db_sup, ?MODULE).
+-define(shard_sup, emqx_ds_builtin_db_shard_sup).
+-define(egress_sup, emqx_ds_builtin_db_egress_sup).
+
+-record(?db_sup, {db}).
+-record(?shard_sup, {db}).
+-record(?egress_sup, {db}).
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec start_db(emqx_ds:db(), emqx_ds_replication_layer:builtin_db_opts()) -> {ok, pid()}.
+start_db(DB, Opts) ->
+    start_link_sup(#?db_sup{db = DB}, Opts).
+
+-spec start_shard(emqx_ds_storage_layer:shard_id()) ->
+    supervisor:startchild_ret().
+start_shard(Shard = {DB, _}) ->
+    supervisor:start_child(?via(#?shard_sup{db = DB}), shard_spec(DB, Shard)).
+
+-spec start_egress(emqx_ds_storage_layer:shard_id()) ->
+    supervisor:startchild_ret().
+start_egress({DB, Shard}) ->
+    supervisor:start_child(?via(#?egress_sup{db = DB}), egress_spec(DB, Shard)).
+
+-spec stop_shard(emqx_ds_storage_layer:shard_id()) -> ok | {error, _}.
+stop_shard(Shard = {DB, _}) ->
+    Sup = ?via(#?shard_sup{db = DB}),
+    ok = supervisor:terminate_child(Sup, Shard),
+    ok = supervisor:delete_child(Sup, Shard).
+
+-spec ensure_shard(emqx_ds_storage_layer:shard_id()) ->
+    ok | {error, _Reason}.
+ensure_shard(Shard) ->
+    case start_shard(Shard) of
+        {ok, _Pid} ->
+            ok;
+        {error, {already_started, _Pid}} ->
+            ok;
+        {error, Reason} ->
+            {error, Reason}
+    end.
+
+%%================================================================================
+%% behaviour callbacks
+%%================================================================================
+
+init({#?db_sup{db = DB}, DefaultOpts}) ->
+    %% Spec for the top-level supervisor for the database:
+    logger:notice("Starting DS DB ~p", [DB]),
+    _ = emqx_ds_replication_layer_meta:open_db(DB, DefaultOpts),
+    %% TODO: before the leader election is implemented, we set ourselves as the leader for all shards:
+    MyShards = emqx_ds_replication_layer_meta:my_shards(DB),
+    lists:foreach(
+        fun(Shard) ->
+            emqx_ds_replication_layer:maybe_set_myself_as_leader(DB, Shard)
+        end,
+        MyShards
+    ),
+    Children = [sup_spec(#?shard_sup{db = DB}, []), sup_spec(#?egress_sup{db = DB}, [])],
+    SupFlags = #{
+        strategy => one_for_all,
+        intensity => 0,
+        period => 1
+    },
+    {ok, {SupFlags, Children}};
+init({#?shard_sup{db = DB}, _}) ->
+    %% Spec for the supervisor that manages the worker processes for
+    %% each local shard of the DB:
+    MyShards = emqx_ds_replication_layer_meta:my_shards(DB),
+    Children = [shard_spec(DB, Shard) || Shard <- MyShards],
+    SupFlags = #{
+        strategy => one_for_one,
+        intensity => 10,
+        period => 1
+    },
+    {ok, {SupFlags, Children}};
+init({#?egress_sup{db = DB}, _}) ->
+    %% Spec for the supervisor that manages the egress proxy processes
+    %% managing traffic towards each of the shards of the DB:
+    Shards = emqx_ds_replication_layer_meta:shards(DB),
+    Children = [egress_spec(DB, Shard) || Shard <- Shards],
+    SupFlags = #{
+        strategy => one_for_one,
+        intensity => 0,
+        period => 1
+    },
+    {ok, {SupFlags, Children}}.
+
+%%================================================================================
+%% Internal exports
+%%================================================================================
+
+start_link_sup(Id, Options) ->
+    supervisor:start_link(?via(Id), ?MODULE, {Id, Options}).
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+sup_spec(Id, Options) ->
+    #{
+        id => element(1, Id),
+        start => {?MODULE, start_link_sup, [Id, Options]},
+        type => supervisor,
+        shutdown => infinity
+    }.
+
+shard_spec(DB, Shard) ->
+    Options = emqx_ds_replication_layer_meta:get_options(DB),
+    #{
+        id => Shard,
+        start => {emqx_ds_storage_layer, start_link, [{DB, Shard}, Options]},
+        shutdown => 5_000,
+        restart => permanent,
+        type => worker
+    }.
+
+egress_spec(DB, Shard) ->
+    #{
+        id => Shard,
+        start => {emqx_ds_replication_layer_egress, start_link, [DB, Shard]},
+        shutdown => 5_000,
+        restart => permanent,
+        type => worker
+    }.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_builtin_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_builtin_sup.erl
new file mode 100644
index 000000000..50ed18de1
--- /dev/null
+++ b/apps/emqx_durable_storage/src/emqx_ds_builtin_sup.erl
@@ -0,0 +1,132 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+%% @doc This supervisor manages the global worker processes needed for
+%% the functioning of builtin databases, and all builtin database
+%% attach to it.
+-module(emqx_ds_builtin_sup).
+
+-behaviour(supervisor).
+
+%% API:
+-export([start_db/2, stop_db/1]).
+
+%% behavior callbacks:
+-export([init/1]).
+
+%% internal exports:
+-export([start_top/0, start_databases_sup/0]).
+
+-export_type([]).
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+-define(top, ?MODULE).
+-define(databases, emqx_ds_builtin_databases_sup).
+
+%%================================================================================
+%% API functions
+%%================================================================================
+
+-spec start_db(emqx_ds:db(), emqx_ds_replication_layer:builtin_db_opts()) ->
+    supervisor:startchild_ret().
+start_db(DB, Opts) ->
+    ensure_top(),
+    ChildSpec = #{
+        id => DB,
+        start => {emqx_ds_builtin_db_sup, start_db, [DB, Opts]},
+        type => supervisor,
+        shutdown => infinity
+    },
+    supervisor:start_child(?databases, ChildSpec).
+
+-spec stop_db(emqx_ds:db()) -> ok.
+stop_db(DB) ->
+    case whereis(?databases) of
+        Pid when is_pid(Pid) ->
+            _ = supervisor:terminate_child(?databases, DB),
+            _ = supervisor:delete_child(?databases, DB),
+            ok;
+        undefined ->
+            ok
+    end.
+
+%%================================================================================
+%% behavior callbacks
+%%================================================================================
+
+%% There are two layers of supervision:
+%%
+%% 1. top supervisor for the builtin backend. It contains the global
+%% worker processes (like the metadata server), and `?databases'
+%% supervisior.
+%%
+%% 2. `?databases': a `one_for_one' supervisor where each child is a
+%% `db' supervisor that contains processes that represent the DB.
+%% Chidren are attached dynamically to this one.
+init(?top) ->
+    %% Children:
+    MetadataServer = #{
+        id => metadata_server,
+        start => {emqx_ds_replication_layer_meta, start_link, []},
+        restart => permanent,
+        type => worker,
+        shutdown => 5000
+    },
+    DBsSup = #{
+        id => ?databases,
+        start => {?MODULE, start_databases_sup, []},
+        restart => permanent,
+        type => supervisor,
+        shutdown => infinity
+    },
+    %%
+    SupFlags = #{
+        strategy => one_for_all,
+        intensity => 1,
+        period => 1,
+        auto_shutdown => never
+    },
+    {ok, {SupFlags, [MetadataServer, DBsSup]}};
+init(?databases) ->
+    %% Children are added dynamically:
+    SupFlags = #{
+        strategy => one_for_one,
+        intensity => 10,
+        period => 1
+    },
+    {ok, {SupFlags, []}}.
+
+%%================================================================================
+%% Internal exports
+%%================================================================================
+
+-spec start_top() -> {ok, pid()}.
+start_top() ->
+    supervisor:start_link({local, ?top}, ?MODULE, ?top).
+
+start_databases_sup() ->
+    supervisor:start_link({local, ?databases}, ?MODULE, ?databases).
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+ensure_top() ->
+    {ok, _} = emqx_ds_sup:attach_backend(builtin, {?MODULE, start_top, []}),
+    ok.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
index 387587570..7f696e3ce 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
@@ -32,7 +32,10 @@
     get_streams/3,
     make_iterator/4,
     update_iterator/3,
-    next/3
+    next/3,
+    node_of_shard/2,
+    shard_of_message/3,
+    maybe_set_myself_as_leader/2
 ]).
 
 %% internal exports:
@@ -51,24 +54,12 @@
 -export_type([shard_id/0, builtin_db_opts/0, stream/0, iterator/0, message_id/0, batch/0]).
 
 -include_lib("emqx_utils/include/emqx_message.hrl").
+-include("emqx_ds_replication_layer.hrl").
 
 %%================================================================================
 %% Type declarations
 %%================================================================================
 
-%% # "Record" integer keys.  We use maps with integer keys to avoid persisting and sending
-%% records over the wire.
-
-%% tags:
--define(STREAM, 1).
--define(IT, 2).
--define(BATCH, 3).
-
-%% keys:
--define(tag, 1).
--define(shard, 2).
--define(enc, 3).
-
 -type shard_id() :: binary().
 
 -type builtin_db_opts() ::
@@ -101,8 +92,6 @@
 
 -type message_id() :: emqx_ds:message_id().
 
--define(batch_messages, 2).
-
 -type batch() :: #{
     ?tag := ?BATCH,
     ?batch_messages := [emqx_types:message()]
@@ -120,16 +109,14 @@ list_shards(DB) ->
 
 -spec open_db(emqx_ds:db(), builtin_db_opts()) -> ok | {error, _}.
 open_db(DB, CreateOpts) ->
-    ok = emqx_ds_sup:ensure_workers(),
-    Opts = emqx_ds_replication_layer_meta:open_db(DB, CreateOpts),
-    MyShards = emqx_ds_replication_layer_meta:my_shards(DB),
-    lists:foreach(
-        fun(Shard) ->
-            emqx_ds_storage_layer:open_shard({DB, Shard}, Opts),
-            maybe_set_myself_as_leader(DB, Shard)
-        end,
-        MyShards
-    ).
+    case emqx_ds_builtin_sup:start_db(DB, CreateOpts) of
+        {ok, _} ->
+            ok;
+        {error, {already_started, _}} ->
+            ok;
+        {error, Err} ->
+            {error, Err}
+    end.
 
 -spec add_generation(emqx_ds:db()) -> ok | {error, _}.
 add_generation(DB) ->
@@ -170,17 +157,15 @@ drop_generation(DB, {Shard, GenId}) ->
 -spec drop_db(emqx_ds:db()) -> ok | {error, _}.
 drop_db(DB) ->
     Nodes = list_nodes(),
-    _ = emqx_ds_proto_v1:drop_db(Nodes, DB),
+    _ = emqx_ds_proto_v2:drop_db(Nodes, DB),
     _ = emqx_ds_replication_layer_meta:drop_db(DB),
+    emqx_ds_builtin_sup:stop_db(DB),
     ok.
 
 -spec store_batch(emqx_ds:db(), [emqx_types:message(), ...], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
 store_batch(DB, Messages, Opts) ->
-    Shard = shard_of_messages(DB, Messages),
-    Node = node_of_shard(DB, Shard),
-    Batch = #{?tag => ?BATCH, ?batch_messages => Messages},
-    emqx_ds_proto_v1:store_batch(Node, DB, Shard, Batch, Opts).
+    emqx_ds_replication_layer_egress:store_batch(DB, Messages, Opts).
 
 -spec get_streams(emqx_ds:db(), emqx_ds:topic_filter(), emqx_ds:time()) ->
     [{emqx_ds:stream_rank(), stream()}].
@@ -262,6 +247,41 @@ next(DB, Iter0, BatchSize) ->
             Other
     end.
 
+-spec node_of_shard(emqx_ds:db(), shard_id()) -> node().
+node_of_shard(DB, Shard) ->
+    case emqx_ds_replication_layer_meta:shard_leader(DB, Shard) of
+        {ok, Leader} ->
+            Leader;
+        {error, no_leader_for_shard} ->
+            %% TODO: use optvar
+            timer:sleep(500),
+            node_of_shard(DB, Shard)
+    end.
+
+-spec shard_of_message(emqx_ds:db(), emqx_types:message(), clientid | topic) ->
+    emqx_ds_replication_layer:shard_id().
+shard_of_message(DB, #message{from = From, topic = Topic}, SerializeBy) ->
+    N = emqx_ds_replication_layer_meta:n_shards(DB),
+    Hash =
+        case SerializeBy of
+            clientid -> erlang:phash2(From, N);
+            topic -> erlang:phash2(Topic, N)
+        end,
+    integer_to_binary(Hash).
+
+%% TODO: there's no real leader election right now
+-spec maybe_set_myself_as_leader(emqx_ds:db(), shard_id()) -> ok.
+maybe_set_myself_as_leader(DB, Shard) ->
+    Site = emqx_ds_replication_layer_meta:this_site(),
+    case emqx_ds_replication_layer_meta:in_sync_replicas(DB, Shard) of
+        [Site | _] ->
+            %% Currently the first in-sync replica always becomes the
+            %% leader
+            ok = emqx_ds_replication_layer_meta:set_leader(DB, Shard, node());
+        _Sites ->
+            ok
+    end.
+
 %%================================================================================
 %% behavior callbacks
 %%================================================================================
@@ -273,6 +293,7 @@ next(DB, Iter0, BatchSize) ->
 -spec do_drop_db_v1(emqx_ds:db()) -> ok | {error, _}.
 do_drop_db_v1(DB) ->
     MyShards = emqx_ds_replication_layer_meta:my_shards(DB),
+    emqx_ds_builtin_sup:stop_db(DB),
     lists:foreach(
         fun(Shard) ->
             emqx_ds_storage_layer:drop_shard({DB, Shard})
@@ -354,34 +375,5 @@ do_drop_generation_v3(DB, ShardId, GenId) ->
 %% Internal functions
 %%================================================================================
 
-%% TODO: there's no real leader election right now
--spec maybe_set_myself_as_leader(emqx_ds:db(), shard_id()) -> ok.
-maybe_set_myself_as_leader(DB, Shard) ->
-    Site = emqx_ds_replication_layer_meta:this_site(),
-    case emqx_ds_replication_layer_meta:in_sync_replicas(DB, Shard) of
-        [Site | _] ->
-            %% Currently the first in-sync replica always becomes the
-            %% leader
-            ok = emqx_ds_replication_layer_meta:set_leader(DB, Shard, node());
-        _Sites ->
-            ok
-    end.
-
--spec node_of_shard(emqx_ds:db(), shard_id()) -> node().
-node_of_shard(DB, Shard) ->
-    case emqx_ds_replication_layer_meta:shard_leader(DB, Shard) of
-        {ok, Leader} ->
-            Leader;
-        {error, no_leader_for_shard} ->
-            %% TODO: use optvar
-            timer:sleep(500),
-            node_of_shard(DB, Shard)
-    end.
-
-%% Here we assume that all messages in the batch come from the same client
-shard_of_messages(DB, [#message{from = From} | _]) ->
-    N = emqx_ds_replication_layer_meta:n_shards(DB),
-    integer_to_binary(erlang:phash2(From, N)).
-
 list_nodes() ->
     mria:running_nodes().
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.hrl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.hrl
new file mode 100644
index 000000000..42e72f258
--- /dev/null
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.hrl
@@ -0,0 +1,33 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022, 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-ifndef(EMQX_DS_REPLICATION_LAYER_HRL).
+-define(EMQX_DS_REPLICATION_LAYER_HRL, true).
+
+%% # "Record" integer keys.  We use maps with integer keys to avoid persisting and sending
+%% records over the wire.
+
+%% tags:
+-define(STREAM, 1).
+-define(IT, 2).
+-define(BATCH, 3).
+
+%% keys:
+-define(tag, 1).
+-define(shard, 2).
+-define(enc, 3).
+-define(batch_messages, 2).
+
+-endif.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
new file mode 100644
index 000000000..3b264d9d1
--- /dev/null
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
@@ -0,0 +1,175 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+%% @doc Egress servers are responsible for proxing the outcoming
+%% `store_batch' requests towards EMQX DS shards.
+%%
+%% They re-assemble messages from different local processes into
+%% fixed-sized batches, and introduce centralized channels between the
+%% nodes. They are also responsible for maintaining backpressure
+%% towards the local publishers.
+%%
+%% There is (currently) one egress process for each shard running on
+%% each node, but it should be possible to have a pool of egress
+%% servers, if needed.
+-module(emqx_ds_replication_layer_egress).
+
+-behaviour(gen_server).
+
+%% API:
+-export([start_link/2, store_batch/3]).
+
+%% behavior callbacks:
+-export([init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2]).
+
+%% internal exports:
+-export([]).
+
+-export_type([]).
+
+-include("emqx_ds_replication_layer.hrl").
+-include_lib("snabbkaffe/include/trace.hrl").
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+-define(via(DB, Shard), {via, gproc, {n, l, {?MODULE, DB, Shard}}}).
+-define(flush, flush).
+
+-record(enqueue_req, {message :: emqx_types:message(), sync :: boolean()}).
+
+%%================================================================================
+%% API functions
+%%================================================================================
+
+-spec start_link(emqx_ds:db(), emqx_ds_replication_layer:shard_id()) -> {ok, pid()}.
+start_link(DB, Shard) ->
+    gen_server:start_link(?via(DB, Shard), ?MODULE, [DB, Shard], []).
+
+-spec store_batch(emqx_ds:db(), [emqx_types:message()], emqx_ds:message_store_opts()) ->
+    ok.
+store_batch(DB, Messages, Opts) ->
+    Sync = maps:get(sync, Opts, true),
+    lists:foreach(
+        fun(Message) ->
+            Shard = emqx_ds_replication_layer:shard_of_message(DB, Message, clientid),
+            gen_server:call(?via(DB, Shard), #enqueue_req{message = Message, sync = Sync})
+        end,
+        Messages
+    ).
+
+%%================================================================================
+%% behavior callbacks
+%%================================================================================
+
+-record(s, {
+    db :: emqx_ds:db(),
+    shard :: emqx_ds_replication_layer:shard_id(),
+    leader :: node(),
+    n = 0 :: non_neg_integer(),
+    tref :: reference(),
+    batch = [] :: [emqx_types:message()],
+    pending_replies = [] :: [gen_server:from()]
+}).
+
+init([DB, Shard]) ->
+    process_flag(trap_exit, true),
+    process_flag(message_queue_data, off_heap),
+    %% TODO: adjust leader dynamically
+    {ok, Leader} = emqx_ds_replication_layer_meta:shard_leader(DB, Shard),
+    S = #s{
+        db = DB,
+        shard = Shard,
+        leader = Leader,
+        tref = start_timer()
+    },
+    {ok, S}.
+
+handle_call(#enqueue_req{message = Msg, sync = Sync}, From, S) ->
+    do_enqueue(From, Sync, Msg, S);
+handle_call(_Call, _From, S) ->
+    {reply, {error, unknown_call}, S}.
+
+handle_cast(_Cast, S) ->
+    {noreply, S}.
+
+handle_info(?flush, S) ->
+    {noreply, do_flush(S)};
+handle_info(_Info, S) ->
+    {noreply, S}.
+
+terminate(_Reason, _S) ->
+    ok.
+
+%%================================================================================
+%% Internal exports
+%%================================================================================
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+do_flush(S = #s{batch = []}) ->
+    S#s{tref = start_timer()};
+do_flush(
+    S = #s{batch = Messages, pending_replies = Replies, db = DB, shard = Shard, leader = Leader}
+) ->
+    Batch = #{?tag => ?BATCH, ?batch_messages => lists:reverse(Messages)},
+    ok = emqx_ds_proto_v2:store_batch(Leader, DB, Shard, Batch, #{}),
+    [gen_server:reply(From, ok) || From <- lists:reverse(Replies)],
+    ?tp(emqx_ds_replication_layer_egress_flush, #{db => DB, shard => Shard}),
+    erlang:garbage_collect(),
+    S#s{
+        n = 0,
+        batch = [],
+        pending_replies = [],
+        tref = start_timer()
+    }.
+
+do_enqueue(From, Sync, Msg, S0 = #s{n = N, batch = Batch, pending_replies = Replies}) ->
+    NMax = 1000,
+    S1 = S0#s{n = N + 1, batch = [Msg | Batch]},
+    S2 =
+        case N >= NMax of
+            true ->
+                _ = erlang:cancel_timer(S0#s.tref),
+                do_flush(S1);
+            false ->
+                S1
+        end,
+    %% TODO: later we may want to delay the reply until the message is
+    %% replicated, but it requies changes to the PUBACK/PUBREC flow to
+    %% allow for async replies. For now, we ack when the message is
+    %% _buffered_ rather than stored.
+    %%
+    %% Otherwise, the client would freeze for at least flush interval,
+    %% or until the buffer is filled.
+    S =
+        case Sync of
+            true ->
+                S2#s{pending_replies = [From | Replies]};
+            false ->
+                gen_server:reply(From, ok),
+                S2
+        end,
+    %% TODO: add a backpressure mechanism for the server to avoid
+    %% building a long message queue.
+    {noreply, S}.
+
+start_timer() ->
+    Interval = 10,
+    erlang:send_after(Interval, self(), flush).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
index 16c52f20e..b49b0e8f7 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -35,6 +35,7 @@
     in_sync_replicas/2,
     sites/0,
     open_db/2,
+    get_options/1,
     update_db_config/2,
     drop_db/1,
     shard_leader/2,
@@ -230,6 +231,11 @@ is_leader(Node) ->
     {atomic, Result} = mria:transaction(?SHARD, fun ?MODULE:is_leader_trans/1, [Node]),
     Result.
 
+-spec get_options(emqx_ds:db()) -> emqx_ds_replication_layer:builtin_db_opts().
+get_options(DB) ->
+    {atomic, Opts} = mria:transaction(?SHARD, fun ?MODULE:open_db_trans/2, [DB, undefined]),
+    Opts.
+
 -spec open_db(emqx_ds:db(), emqx_ds_replication_layer:builtin_db_opts()) ->
     emqx_ds_replication_layer:builtin_db_opts().
 open_db(DB, DefaultOpts) ->
@@ -293,11 +299,11 @@ terminate(_Reason, #s{}) ->
 %% Internal exports
 %%================================================================================
 
--spec open_db_trans(emqx_ds:db(), emqx_ds_replication_layer:builtin_db_opts()) ->
+-spec open_db_trans(emqx_ds:db(), emqx_ds_replication_layer:builtin_db_opts() | undefined) ->
     emqx_ds_replication_layer:builtin_db_opts().
 open_db_trans(DB, CreateOpts) ->
     case mnesia:wread({?META_TAB, DB}) of
-        [] ->
+        [] when is_map(CreateOpts) ->
             NShards = maps:get(n_shards, CreateOpts),
             ReplicationFactor = maps:get(replication_factor, CreateOpts),
             mnesia:write(#?META_TAB{db = DB, db_props = CreateOpts}),
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index 0dcb8ce52..85a94a846 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -199,7 +199,6 @@ open_shard(Shard, Options) ->
 
 -spec drop_shard(shard_id()) -> ok.
 drop_shard(Shard) ->
-    catch emqx_ds_storage_layer_sup:stop_shard(Shard),
     case persistent_term:get({?MODULE, Shard, data_dir}, undefined) of
         undefined ->
             ok;
@@ -586,7 +585,8 @@ commit_metadata(#s{shard_id = ShardId, schema = Schema, shard = Runtime, db = DB
 rocksdb_open(Shard, Options) ->
     DBOptions = [
         {create_if_missing, true},
-        {create_missing_column_families, true}
+        {create_missing_column_families, true},
+        {enable_write_thread_adaptive_yield, false}
         | maps:get(db_options, Options, [])
     ],
     DataDir = maps:get(data_dir, Options, emqx:data_dir()),
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
index fd8cf289f..424b35133 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_ds_storage_layer_sup).
 
@@ -23,7 +23,7 @@
 
 -spec start_link() -> {ok, pid()}.
 start_link() ->
-    supervisor:start_link({local, ?SUP}, ?MODULE, []).
+    supervisor:start_link(?MODULE, []).
 
 -spec start_shard(emqx_ds_storage_layer:shard_id(), emqx_ds:create_db_opts()) ->
     supervisor:startchild_ret().
diff --git a/apps/emqx_durable_storage/src/emqx_ds_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_sup.erl
index 819d7d874..e863e74ce 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_sup.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_sup.erl
@@ -6,7 +6,7 @@
 -behaviour(supervisor).
 
 %% API:
--export([start_link/0, ensure_workers/0]).
+-export([start_link/0, attach_backend/2]).
 
 %% behaviour callbacks:
 -export([init/1]).
@@ -25,64 +25,40 @@
 start_link() ->
     supervisor:start_link({local, ?SUP}, ?MODULE, top).
 
--spec ensure_workers() -> ok.
-ensure_workers() ->
-    ChildSpec = #{
-        id => workers_sup,
-        restart => temporary,
-        type => supervisor,
-        start => {supervisor, start_link, [?MODULE, workers]}
+%% @doc Attach a child backend-specific supervisor to the top
+%% application supervisor, if not yet present
+-spec attach_backend(_BackendId, {module(), atom(), list()}) ->
+    {ok, pid()} | {error, _}.
+attach_backend(Backend, Start) ->
+    Spec = #{
+        id => Backend,
+        start => Start,
+        significant => false,
+        shutdown => infinity,
+        type => supervisor
     },
-    case supervisor:start_child(?SUP, ChildSpec) of
-        {ok, _} ->
-            ok;
-        {error, already_present} ->
-            ok;
-        {error, {already_started, _}} ->
-            ok
+    case supervisor:start_child(?SUP, Spec) of
+        {ok, Pid} ->
+            {ok, Pid};
+        {error, {already_started, Pid}} ->
+            {ok, Pid};
+        {error, Err} ->
+            {error, Err}
     end.
 
 %%================================================================================
 %% behaviour callbacks
 %%================================================================================
 
--dialyzer({nowarn_function, init/1}).
 init(top) ->
+    Children = [],
     SupFlags = #{
-        strategy => one_for_all,
+        strategy => one_for_one,
         intensity => 10,
         period => 1
     },
-    {ok, {SupFlags, []}};
-init(workers) ->
-    %% TODO: technically, we don't need rocksDB for the alternative
-    %% backends. But right now we have any:
-    Children = [meta(), storage_layer_sup()],
-    SupFlags = #{
-        strategy => one_for_all,
-        intensity => 0,
-        period => 1
-    },
     {ok, {SupFlags, Children}}.
 
 %%================================================================================
 %% Internal functions
 %%================================================================================
-
-meta() ->
-    #{
-        id => emqx_ds_replication_layer_meta,
-        start => {emqx_ds_replication_layer_meta, start_link, []},
-        restart => permanent,
-        type => worker,
-        shutdown => 5000
-    }.
-
-storage_layer_sup() ->
-    #{
-        id => local_store_shard_sup,
-        start => {emqx_ds_storage_layer_sup, start_link, []},
-        restart => permanent,
-        type => supervisor,
-        shutdown => infinity
-    }.
diff --git a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
index d7dccccf5..9dae8e699 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
diff --git a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
index 5d32143a7..03d86dd88 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
@@ -16,8 +16,8 @@
 -define(DEFAULT_CONFIG, #{
     backend => builtin,
     storage => {emqx_ds_storage_bitfield_lts, #{}},
-    n_shards => 16,
-    replication_factor => 3
+    n_shards => 1,
+    replication_factor => 1
 }).
 
 -define(COMPACT_CONFIG, #{
@@ -26,15 +26,10 @@
         {emqx_ds_storage_bitfield_lts, #{
             bits_per_wildcard_level => 8
         }},
-    n_shards => 16,
-    replication_factor => 3
+    n_shards => 1,
+    replication_factor => 1
 }).
 
-%% Smoke test for opening and reopening the database
-t_open(_Config) ->
-    ok = emqx_ds_storage_layer_sup:stop_shard(?SHARD),
-    {ok, _} = emqx_ds_storage_layer_sup:start_shard(?SHARD, #{}).
-
 %% Smoke test of store function
 t_store(_Config) ->
     MessageID = emqx_guid:gen(),
@@ -98,8 +93,8 @@ t_get_streams(_Config) ->
     [FooBarBaz] = GetStream(<<"foo/bar/baz">>),
     [A] = GetStream(<<"a">>),
     %% Restart shard to make sure trie is persisted and restored:
-    ok = emqx_ds_storage_layer_sup:stop_shard(?SHARD),
-    {ok, _} = emqx_ds_storage_layer_sup:start_shard(?SHARD, #{}),
+    ok = emqx_ds_builtin_sup:stop_db(?FUNCTION_NAME),
+    {ok, _} = emqx_ds_builtin_sup:start_db(?FUNCTION_NAME, #{}),
     %% Verify that there are no "ghost streams" for topics that don't
     %% have any messages:
     [] = GetStream(<<"bar/foo">>),
@@ -196,9 +191,9 @@ t_replay(_Config) ->
     ?assert(check(?SHARD, <<"foo/+/+">>, 0, Messages)),
     ?assert(check(?SHARD, <<"+/+/+">>, 0, Messages)),
     ?assert(check(?SHARD, <<"+/+/baz">>, 0, Messages)),
-    %% Restart shard to make sure trie is persisted and restored:
-    ok = emqx_ds_storage_layer_sup:stop_shard(?SHARD),
-    {ok, _} = emqx_ds_storage_layer_sup:start_shard(?SHARD, #{}),
+    %% Restart the DB to make sure trie is persisted and restored:
+    ok = emqx_ds_builtin_sup:stop_db(?FUNCTION_NAME),
+    {ok, _} = emqx_ds_builtin_sup:start_db(?FUNCTION_NAME, #{}),
     %% Learned wildcard topics:
     ?assertNot(check(?SHARD, <<"wildcard/1000/suffix/foo">>, 0, [])),
     ?assert(check(?SHARD, <<"wildcard/1/suffix/foo">>, 0, Messages)),
@@ -412,21 +407,21 @@ suite() -> [{timetrap, {seconds, 20}}].
 
 init_per_suite(Config) ->
     {ok, _} = application:ensure_all_started(emqx_durable_storage),
-    emqx_ds_sup:ensure_workers(),
     Config.
 
 end_per_suite(_Config) ->
     ok = application:stop(emqx_durable_storage).
 
 init_per_testcase(TC, Config) ->
-    {ok, _} = emqx_ds_storage_layer_sup:start_shard(shard(TC), ?DEFAULT_CONFIG),
+    ok = emqx_ds:open_db(TC, ?DEFAULT_CONFIG),
     Config.
 
 end_per_testcase(TC, _Config) ->
-    ok = emqx_ds_storage_layer_sup:stop_shard(shard(TC)).
+    emqx_ds:drop_db(TC),
+    ok.
 
 shard(TC) ->
-    {?MODULE, atom_to_binary(TC)}.
+    {TC, <<"0">>}.
 
 keyspace(TC) ->
     TC.

From eee221f1d018f2fef7a528f3ba16a20fd78784f9 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Tue, 23 Jan 2024 21:29:37 +0100
Subject: [PATCH 031/273] feat(ds): Make egress batching configurable

---
 apps/emqx/src/emqx_schema.erl                 | 20 ++++++++++++++++++-
 .../src/emqx_ds_replication_layer_egress.erl  |  4 ++--
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index bbca13172..b03cfe72e 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2017-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2017-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -1915,6 +1915,24 @@ fields("session_storage_backend_builtin") ->
                     default => 3,
                     importance => ?IMPORTANCE_HIDDEN
                 }
+            )},
+        {"egress_batch_size",
+            sc(
+                pos_integer(),
+                #{
+                    default => 1000,
+                    mapping => "emqx_durable_storage.egress_batch_size",
+                    importance => ?IMPORTANCE_HIDDEN
+                }
+            )},
+        {"egress_flush_interval",
+            sc(
+                timeout_duration_ms(),
+                #{
+                    default => 100,
+                    mapping => "emqx_durable_storage.egress_flush_interval",
+                    importance => ?IMPORTANCE_HIDDEN
+                }
             )}
     ].
 
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
index 3b264d9d1..842e8e5ed 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
@@ -141,7 +141,7 @@ do_flush(
     }.
 
 do_enqueue(From, Sync, Msg, S0 = #s{n = N, batch = Batch, pending_replies = Replies}) ->
-    NMax = 1000,
+    NMax = application:get_env(emqx_durable_storage, egress_batch_size, 1000),
     S1 = S0#s{n = N + 1, batch = [Msg | Batch]},
     S2 =
         case N >= NMax of
@@ -171,5 +171,5 @@ do_enqueue(From, Sync, Msg, S0 = #s{n = N, batch = Batch, pending_replies = Repl
     {noreply, S}.
 
 start_timer() ->
-    Interval = 10,
+    Interval = application:get_env(emqx_durable_storage, egress_flush_interval, 100),
     erlang:send_after(Interval, self(), flush).

From 305a54f646d7539fa6820a721430130486735e87 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 24 Jan 2024 14:43:09 +0100
Subject: [PATCH 032/273] chore(ds): Update BPAPI version

---
 .../src/emqx_ds_replication_layer.erl                | 12 ++++++------
 .../src/emqx_ds_replication_layer_egress.erl         |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
index 7f696e3ce..7432fe3c7 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
@@ -121,7 +121,7 @@ open_db(DB, CreateOpts) ->
 -spec add_generation(emqx_ds:db()) -> ok | {error, _}.
 add_generation(DB) ->
     Nodes = emqx_ds_replication_layer_meta:leader_nodes(DB),
-    _ = emqx_ds_proto_v2:add_generation(Nodes, DB),
+    _ = emqx_ds_proto_v3:add_generation(Nodes, DB),
     ok.
 
 -spec update_db_config(emqx_ds:db(), builtin_db_opts()) -> ok | {error, _}.
@@ -157,7 +157,7 @@ drop_generation(DB, {Shard, GenId}) ->
 -spec drop_db(emqx_ds:db()) -> ok | {error, _}.
 drop_db(DB) ->
     Nodes = list_nodes(),
-    _ = emqx_ds_proto_v2:drop_db(Nodes, DB),
+    _ = emqx_ds_proto_v3:drop_db(Nodes, DB),
     _ = emqx_ds_replication_layer_meta:drop_db(DB),
     emqx_ds_builtin_sup:stop_db(DB),
     ok.
@@ -174,7 +174,7 @@ get_streams(DB, TopicFilter, StartTime) ->
     lists:flatmap(
         fun(Shard) ->
             Node = node_of_shard(DB, Shard),
-            Streams = emqx_ds_proto_v1:get_streams(Node, DB, Shard, TopicFilter, StartTime),
+            Streams = emqx_ds_proto_v3:get_streams(Node, DB, Shard, TopicFilter, StartTime),
             lists:map(
                 fun({RankY, Stream}) ->
                     RankX = Shard,
@@ -196,7 +196,7 @@ get_streams(DB, TopicFilter, StartTime) ->
 make_iterator(DB, Stream, TopicFilter, StartTime) ->
     #{?tag := ?STREAM, ?shard := Shard, ?enc := StorageStream} = Stream,
     Node = node_of_shard(DB, Shard),
-    case emqx_ds_proto_v1:make_iterator(Node, DB, Shard, StorageStream, TopicFilter, StartTime) of
+    case emqx_ds_proto_v3:make_iterator(Node, DB, Shard, StorageStream, TopicFilter, StartTime) of
         {ok, Iter} ->
             {ok, #{?tag => ?IT, ?shard => Shard, ?enc => Iter}};
         Err = {error, _} ->
@@ -213,7 +213,7 @@ update_iterator(DB, OldIter, DSKey) ->
     #{?tag := ?IT, ?shard := Shard, ?enc := StorageIter} = OldIter,
     Node = node_of_shard(DB, Shard),
     case
-        emqx_ds_proto_v2:update_iterator(
+        emqx_ds_proto_v3:update_iterator(
             Node,
             DB,
             Shard,
@@ -239,7 +239,7 @@ next(DB, Iter0, BatchSize) ->
     %%
     %% This kind of trickery should be probably done here in the
     %% replication layer. Or, perhaps, in the logic layer.
-    case emqx_ds_proto_v1:next(Node, DB, Shard, StorageIter0, BatchSize) of
+    case emqx_ds_proto_v3:next(Node, DB, Shard, StorageIter0, BatchSize) of
         {ok, StorageIter, Batch} ->
             Iter = Iter0#{?enc := StorageIter},
             {ok, Iter, Batch};
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
index 842e8e5ed..8b37b29cb 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
@@ -172,4 +172,4 @@ do_enqueue(From, Sync, Msg, S0 = #s{n = N, batch = Batch, pending_replies = Repl
 
 start_timer() ->
     Interval = application:get_env(emqx_durable_storage, egress_flush_interval, 100),
-    erlang:send_after(Interval, self(), flush).
+    erlang:send_after(Interval, self(), ?flush).

From 7b5f2948fe127c85dd70b3df693769b315251cbe Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 24 Jan 2024 18:38:15 +0100
Subject: [PATCH 033/273] test(ds): Fix flaky testcase

---
 apps/emqx/test/emqx_persistent_messages_SUITE.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index 0c0eaac28..8a63d46be 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -475,7 +475,7 @@ t_metrics_not_dropped(_Config) ->
 
     {ok, _, [?RC_GRANTED_QOS_1]} = emqtt:subscribe(Sub, <<"t/+">>, ?QOS_1),
     emqtt:publish(Pub, <<"t/ps">>, <<"payload">>, ?QOS_1),
-    ?assertMatch([_], receive_messages(1, 1_500)),
+    ?assertMatch([_], receive_messages(1)),
 
     DroppedAfter = emqx_metrics:val('messages.dropped'),
     DroppedNoSubAfter = emqx_metrics:val('messages.dropped.no_subscribers'),

From ae387d1812285895281be699805a020d66f42d36 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Wed, 24 Jan 2024 18:02:47 -0300
Subject: [PATCH 034/273] ci: start/flush cover when using peer

`cover` is not automatically started by `peer`.  Without starting/flushing it, we don't
get coverage data from peer nodes.
---
 apps/emqx/test/emqx_cth_cluster.erl | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/apps/emqx/test/emqx_cth_cluster.erl b/apps/emqx/test/emqx_cth_cluster.erl
index d53bb1e90..0ac597ff6 100644
--- a/apps/emqx/test/emqx_cth_cluster.erl
+++ b/apps/emqx/test/emqx_cth_cluster.erl
@@ -381,6 +381,7 @@ node_init(Node) ->
     _ = share_load_module(Node, cthr),
     % Enable snabbkaffe trace forwarding
     ok = snabbkaffe:forward_trace(Node),
+    when_cover_enabled(fun() -> {ok, _} = cover:start([Node]) end),
     ok.
 
 %% Returns 'true' if this node should appear in running nodes list.
@@ -445,6 +446,7 @@ stop(Nodes) ->
 
 stop_node(Name) ->
     Node = node_name(Name),
+    when_cover_enabled(fun() -> cover:flush([Node]) end),
     ok = emqx_cth_peer:stop(Node).
 
 %% Ports
@@ -506,3 +508,20 @@ host() ->
 
 format(Format, Args) ->
     unicode:characters_to_binary(io_lib:format(Format, Args)).
+
+is_cover_enabled() ->
+    case os:getenv("ENABLE_COVER_COMPILE") of
+        "1" -> true;
+        "true" -> true;
+        _ -> false
+    end.
+
+when_cover_enabled(Fun) ->
+    %% We need to check if cover is enabled to avoid crashes when attempting to start it
+    %% on the peer.
+    case is_cover_enabled() of
+        true ->
+            Fun();
+        false ->
+            ok
+    end.

From 33981661c112d0ad11a96a28351cc266c9bc3c61 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Thu, 25 Jan 2024 09:20:23 +0800
Subject: [PATCH 035/273] chore: add changelogs for #12381

---
 changes/ee/feat-12381.en.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 changes/ee/feat-12381.en.md

diff --git a/changes/ee/feat-12381.en.md b/changes/ee/feat-12381.en.md
new file mode 100644
index 000000000..dfd48db00
--- /dev/null
+++ b/changes/ee/feat-12381.en.md
@@ -0,0 +1,3 @@
+Added new SQL functions: map_keys(), map_values(), map_to_entries(), join_to_string(), join_to_string(), join_to_sql_values_string(), is_null_var(), is_not_null_var().
+
+For more information on the functions and their usage, refer to the documentation.

From 3bc6e546e0f716209f637df9754a2c05faa4febd Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Thu, 25 Jan 2024 12:20:30 +0800
Subject: [PATCH 036/273] fix: reboot emqx_dashboard after emqx_licencse

---
 apps/emqx_machine/src/emqx_machine_boot.erl   | 20 +++++++--
 apps/emqx_machine/test/emqx_machine_SUITE.erl | 42 ++++++++++++-------
 changes/ee/fix-12390.en.md                    |  1 +
 3 files changed, 45 insertions(+), 18 deletions(-)
 create mode 100644 changes/ee/fix-12390.en.md

diff --git a/apps/emqx_machine/src/emqx_machine_boot.erl b/apps/emqx_machine/src/emqx_machine_boot.erl
index 08cf8c448..fb2c94758 100644
--- a/apps/emqx_machine/src/emqx_machine_boot.erl
+++ b/apps/emqx_machine/src/emqx_machine_boot.erl
@@ -166,8 +166,9 @@ is_app(Name) ->
 sorted_reboot_apps() ->
     RebootApps = reboot_apps(),
     Apps0 = [{App, app_deps(App, RebootApps)} || App <- RebootApps],
-    Apps = inject_bridge_deps(Apps0),
-    sorted_reboot_apps(Apps).
+    Apps1 = inject_bridge_deps(Apps0),
+    Apps2 = inject_dashboard_deps(Apps1),
+    sorted_reboot_apps(Apps2).
 
 app_deps(App, RebootApps) ->
     case application:get_key(App, applications) of
@@ -193,6 +194,18 @@ inject_bridge_deps(RebootAppDeps) ->
         end,
         RebootAppDeps
     ).
+inject_dashboard_deps(Reboots) ->
+    Apps = [emqx_license],
+    Deps = lists:filter(fun(App) -> lists:keymember(App, 1, Reboots) end, Apps),
+    lists:map(
+        fun
+            ({emqx_dashboard, Deps0}) when is_list(Deps0) ->
+                {emqx_dashboard, Deps0 ++ Deps};
+            (App) ->
+                App
+        end,
+        Reboots
+    ).
 
 sorted_reboot_apps(Apps) ->
     G = digraph:new(),
@@ -201,7 +214,8 @@ sorted_reboot_apps(Apps) ->
         case digraph_utils:topsort(G) of
             Sorted when is_list(Sorted) ->
                 %% ensure emqx_conf boot up first
-                [emqx_conf | Sorted ++ (NoDepApps -- Sorted)];
+                AllApps = Sorted ++ (NoDepApps -- Sorted),
+                [emqx_conf | lists:delete(emqx_conf, AllApps)];
             false ->
                 Loops = find_loops(G),
                 error({circular_application_dependency, Loops})
diff --git a/apps/emqx_machine/test/emqx_machine_SUITE.erl b/apps/emqx_machine/test/emqx_machine_SUITE.erl
index 7b64df05c..1a0818c86 100644
--- a/apps/emqx_machine/test/emqx_machine_SUITE.erl
+++ b/apps/emqx_machine/test/emqx_machine_SUITE.erl
@@ -24,25 +24,27 @@
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
+-define(APPS, [
+    emqx_prometheus,
+    emqx_modules,
+    emqx_dashboard,
+    emqx_gateway,
+    emqx_resource,
+    emqx_rule_engine,
+    emqx_bridge,
+    emqx_management,
+    emqx_retainer,
+    emqx_exhook,
+    emqx_auth,
+    emqx_plugin,
+    emqx_opentelemetry
+]).
+
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
     emqx_common_test_helpers:start_apps([emqx_conf, emqx_opentelemetry]),
-    application:set_env(emqx_machine, applications, [
-        emqx_prometheus,
-        emqx_modules,
-        emqx_dashboard,
-        emqx_gateway,
-        emqx_resource,
-        emqx_rule_engine,
-        emqx_bridge,
-        emqx_management,
-        emqx_retainer,
-        emqx_exhook,
-        emqx_auth,
-        emqx_plugin,
-        emqx_opentelemetry
-    ]),
+    application:load(emqx_dashboard),
     Config.
 
 end_per_suite(_Config) ->
@@ -60,7 +62,11 @@ init_per_testcase(t_open_ports_check = TestCase, Config) ->
     ],
     Nodes = emqx_cth_cluster:start(Cluster, #{work_dir => emqx_cth_suite:work_dir(TestCase, Config)}),
     [{nodes, Nodes} | Config];
+init_per_testcase(t_sorted_reboot_apps, Config) ->
+    application:set_env(emqx_machine, applications, ?APPS ++ [emqx_license]),
+    Config;
 init_per_testcase(_TestCase, Config) ->
+    application:set_env(emqx_machine, applications, ?APPS),
     Config.
 
 end_per_testcase(t_custom_shard_transports, Config) ->
@@ -88,6 +94,12 @@ t_shutdown_reboot(_Config) ->
     ok = emqx_machine_boot:stop_apps(),
     false = emqx:is_running(node()).
 
+t_sorted_reboot_apps(_Config) ->
+    Apps = emqx_machine_boot:sorted_reboot_apps(),
+    SortApps = [App || App <- Apps, (App =:= emqx_dashboard orelse App =:= emqx_license)],
+    %% make sure emqx_license start early than emqx_dashboard
+    ?assertEqual([emqx_license, emqx_dashboard], SortApps).
+
 t_custom_shard_transports(_Config) ->
     %% used to ensure the atom exists
     Shard = test_shard,
diff --git a/changes/ee/fix-12390.en.md b/changes/ee/fix-12390.en.md
new file mode 100644
index 000000000..f5d30a3f7
--- /dev/null
+++ b/changes/ee/fix-12390.en.md
@@ -0,0 +1 @@
+Fixed /license API request maybe crash during cluster join processes.

From f52cc93d9d5499c9a1affa59e9c5e270ed8c7a6f Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Tue, 16 Jan 2024 17:09:24 +0200
Subject: [PATCH 037/273] perf(emqx_cm): use a dedicated pool for channel
 cleanup

This is to isolate channels cleanup from other async tasks (like routes cleanup),
as channels cleanup can be quite slow under high network latency conditions.

Fixes: EMQX-11743
---
 apps/emqx/include/emqx_cm.hrl    |  2 +
 apps/emqx/src/emqx_cm.erl        |  6 ++-
 apps/emqx/src/emqx_cm_sup.erl    |  4 ++
 apps/emqx/src/emqx_pool.erl      | 64 +++++++++++++++++++++++---------
 apps/emqx/test/emqx_cm_SUITE.erl | 10 +++--
 changes/ce/perf-12336.en.md      |  2 +
 6 files changed, 66 insertions(+), 22 deletions(-)
 create mode 100644 changes/ce/perf-12336.en.md

diff --git a/apps/emqx/include/emqx_cm.hrl b/apps/emqx/include/emqx_cm.hrl
index ae70f131f..6478a6162 100644
--- a/apps/emqx/include/emqx_cm.hrl
+++ b/apps/emqx/include/emqx_cm.hrl
@@ -30,4 +30,6 @@
 -define(T_GET_INFO, 5_000).
 -define(T_TAKEOVER, 15_000).
 
+-define(CM_POOL, emqx_cm_pool).
+
 -endif.
diff --git a/apps/emqx/src/emqx_cm.erl b/apps/emqx/src/emqx_cm.erl
index 660ac3cfe..2e6714e7f 100644
--- a/apps/emqx/src/emqx_cm.erl
+++ b/apps/emqx/src/emqx_cm.erl
@@ -670,7 +670,11 @@ handle_info({'DOWN', _MRef, process, Pid, _Reason}, State = #{chan_pmon := PMon}
     ChanPids = [Pid | emqx_utils:drain_down(BatchSize)],
     {Items, PMon1} = emqx_pmon:erase_all(ChanPids, PMon),
     lists:foreach(fun mark_channel_disconnected/1, ChanPids),
-    ok = emqx_pool:async_submit(fun lists:foreach/2, [fun ?MODULE:clean_down/1, Items]),
+    ok = emqx_pool:async_submit_to_pool(
+        ?CM_POOL,
+        fun lists:foreach/2,
+        [fun ?MODULE:clean_down/1, Items]
+    ),
     {noreply, State#{chan_pmon := PMon1}};
 handle_info(Info, State) ->
     ?SLOG(error, #{msg => "unexpected_info", info => Info}),
diff --git a/apps/emqx/src/emqx_cm_sup.erl b/apps/emqx/src/emqx_cm_sup.erl
index e7420b4da..622921f1d 100644
--- a/apps/emqx/src/emqx_cm_sup.erl
+++ b/apps/emqx/src/emqx_cm_sup.erl
@@ -25,6 +25,8 @@
 %% for test
 -export([restart_flapping/0]).
 
+-include("emqx_cm.hrl").
+
 %%--------------------------------------------------------------------
 %% API
 %%--------------------------------------------------------------------
@@ -45,6 +47,7 @@ init([]) ->
     Banned = child_spec(emqx_banned, 1000, worker),
     Flapping = child_spec(emqx_flapping, 1000, worker),
     Locker = child_spec(emqx_cm_locker, 5000, worker),
+    CmPool = emqx_pool_sup:spec(emqx_cm_pool_sup, [?CM_POOL, random, {emqx_pool, start_link, []}]),
     Registry = child_spec(emqx_cm_registry, 5000, worker),
     Manager = child_spec(emqx_cm, 5000, worker),
     DSSessionGCSup = child_spec(emqx_persistent_session_ds_sup, infinity, supervisor),
@@ -53,6 +56,7 @@ init([]) ->
             Banned,
             Flapping,
             Locker,
+            CmPool,
             Registry,
             Manager,
             DSSessionGCSup
diff --git a/apps/emqx/src/emqx_pool.erl b/apps/emqx/src/emqx_pool.erl
index 1cb5f429c..39c585133 100644
--- a/apps/emqx/src/emqx_pool.erl
+++ b/apps/emqx/src/emqx_pool.erl
@@ -28,11 +28,15 @@
     submit/1,
     submit/2,
     async_submit/1,
-    async_submit/2
+    async_submit/2,
+    submit_to_pool/2,
+    submit_to_pool/3,
+    async_submit_to_pool/2,
+    async_submit_to_pool/3
 ]).
 
 -ifdef(TEST).
--export([worker/0, flush_async_tasks/0]).
+-export([worker/0, flush_async_tasks/0, flush_async_tasks/1]).
 -endif.
 
 %% gen_server callbacks
@@ -57,7 +61,7 @@
 -spec start_link(atom(), pos_integer()) -> startlink_ret().
 start_link(Pool, Id) ->
     gen_server:start_link(
-        {local, emqx_utils:proc_name(?MODULE, Id)},
+        {local, emqx_utils:proc_name(Pool, Id)},
         ?MODULE,
         [Pool, Id],
         [{hibernate_after, 1000}]
@@ -66,32 +70,48 @@ start_link(Pool, Id) ->
 %% @doc Submit work to the pool.
 -spec submit(task()) -> any().
 submit(Task) ->
-    call({submit, Task}).
+    submit_to_pool(?POOL, Task).
 
 -spec submit(fun(), list(any())) -> any().
 submit(Fun, Args) ->
-    call({submit, {Fun, Args}}).
-
-%% @private
-call(Req) ->
-    gen_server:call(worker(), Req, infinity).
+    submit_to_pool(?POOL, Fun, Args).
 
 %% @doc Submit work to the pool asynchronously.
 -spec async_submit(task()) -> ok.
 async_submit(Task) ->
-    cast({async_submit, Task}).
+    async_submit_to_pool(?POOL, Task).
 
 -spec async_submit(fun(), list(any())) -> ok.
 async_submit(Fun, Args) ->
-    cast({async_submit, {Fun, Args}}).
+    async_submit_to_pool(?POOL, Fun, Args).
+
+-spec submit_to_pool(any(), task()) -> any().
+submit_to_pool(Pool, Task) ->
+    call(Pool, {submit, Task}).
+
+-spec submit_to_pool(any(), fun(), list(any())) -> any().
+submit_to_pool(Pool, Fun, Args) ->
+    call(Pool, {submit, {Fun, Args}}).
+
+-spec async_submit_to_pool(any(), task()) -> ok.
+async_submit_to_pool(Pool, Task) ->
+    cast(Pool, {async_submit, Task}).
+
+-spec async_submit_to_pool(any(), fun(), list(any())) -> ok.
+async_submit_to_pool(Pool, Fun, Args) ->
+    cast(Pool, {async_submit, {Fun, Args}}).
 
 %% @private
-cast(Msg) ->
-    gen_server:cast(worker(), Msg).
+call(Pool, Req) ->
+    gen_server:call(worker(Pool), Req, infinity).
 
 %% @private
-worker() ->
-    gproc_pool:pick_worker(?POOL).
+cast(Pool, Msg) ->
+    gen_server:cast(worker(Pool), Msg).
+
+%% @private
+worker(Pool) ->
+    gproc_pool:pick_worker(Pool).
 
 %%--------------------------------------------------------------------
 %% gen_server callbacks
@@ -146,15 +166,25 @@ run(Fun) when is_function(Fun) ->
     Fun().
 
 -ifdef(TEST).
+
+worker() ->
+    worker(?POOL).
+
+flush_async_tasks() ->
+    flush_async_tasks(?POOL).
+
 %% This help function creates a large enough number of async tasks
 %% to force flush the pool workers.
 %% The number of tasks should be large enough to ensure all workers have
 %% the chance to work on at least one of the tasks.
-flush_async_tasks() ->
+flush_async_tasks(Pool) ->
     Ref = make_ref(),
     Self = self(),
     L = lists:seq(1, 997),
-    lists:foreach(fun(I) -> emqx_pool:async_submit(fun() -> Self ! {done, Ref, I} end, []) end, L),
+    lists:foreach(
+        fun(I) -> emqx_pool:async_submit_to_pool(Pool, fun() -> Self ! {done, Ref, I} end, []) end,
+        L
+    ),
     lists:foreach(
         fun(I) ->
             receive
diff --git a/apps/emqx/test/emqx_cm_SUITE.erl b/apps/emqx/test/emqx_cm_SUITE.erl
index 4ecea9a4b..e175b4349 100644
--- a/apps/emqx/test/emqx_cm_SUITE.erl
+++ b/apps/emqx/test/emqx_cm_SUITE.erl
@@ -221,7 +221,7 @@ t_open_session_race_condition(_) ->
     end,
     %% sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = emqx_pool:flush_async_tasks(),
+    ok = emqx_pool:flush_async_tasks(?CM_POOL),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
 t_kick_session_discard_normal(_) ->
@@ -343,7 +343,7 @@ test_stepdown_session(Action, Reason) ->
     end,
     % sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = flush_emqx_pool(),
+    ok = flush_emqx_cm_pool(),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
 %% Channel deregistration is delegated to emqx_pool as a sync tasks.
@@ -353,10 +353,12 @@ test_stepdown_session(Action, Reason) ->
 %% to sync with the pool workers.
 %% The number of tasks should be large enough to ensure all workers have
 %% the chance to work on at least one of the tasks.
-flush_emqx_pool() ->
+flush_emqx_cm_pool() ->
     Self = self(),
     L = lists:seq(1, 1000),
-    lists:foreach(fun(I) -> emqx_pool:async_submit(fun() -> Self ! {done, I} end, []) end, L),
+    lists:foreach(
+        fun(I) -> emqx_pool:async_submit_to_pool(?CM_POOL, fun() -> Self ! {done, I} end, []) end, L
+    ),
     lists:foreach(
         fun(I) ->
             receive
diff --git a/changes/ce/perf-12336.en.md b/changes/ce/perf-12336.en.md
new file mode 100644
index 000000000..5c385e6b6
--- /dev/null
+++ b/changes/ce/perf-12336.en.md
@@ -0,0 +1,2 @@
+Isolate channels cleanup from other async tasks (like routes cleanup) by using a dedicated pool,
+as this task can be quite slow under high network latency conditions.

From a8c6280a5e8e0f2325e3d11d0676e7955ed9fadf Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Tue, 16 Jan 2024 19:42:37 +0200
Subject: [PATCH 038/273] test(emqx_cm_SUITE): use one helper function:
 `emqx_pool:flush_async_tasks/1`

---
 apps/emqx/test/emqx_cm_SUITE.erl | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/apps/emqx/test/emqx_cm_SUITE.erl b/apps/emqx/test/emqx_cm_SUITE.erl
index e175b4349..aba4bc744 100644
--- a/apps/emqx/test/emqx_cm_SUITE.erl
+++ b/apps/emqx/test/emqx_cm_SUITE.erl
@@ -343,31 +343,9 @@ test_stepdown_session(Action, Reason) ->
     end,
     % sync
     ignored = gen_server:call(?CM, ignore, infinity),
-    ok = flush_emqx_cm_pool(),
+    ok = emqx_pool:flush_async_tasks(?CM_POOL),
     ?assertEqual([], emqx_cm:lookup_channels(ClientId)).
 
-%% Channel deregistration is delegated to emqx_pool as a sync tasks.
-%% The emqx_pool is pool of workers, and there is no way to know
-%% which worker was picked for the last deregistration task.
-%% This help function creates a large enough number of async tasks
-%% to sync with the pool workers.
-%% The number of tasks should be large enough to ensure all workers have
-%% the chance to work on at least one of the tasks.
-flush_emqx_cm_pool() ->
-    Self = self(),
-    L = lists:seq(1, 1000),
-    lists:foreach(
-        fun(I) -> emqx_pool:async_submit_to_pool(?CM_POOL, fun() -> Self ! {done, I} end, []) end, L
-    ),
-    lists:foreach(
-        fun(I) ->
-            receive
-                {done, I} -> ok
-            end
-        end,
-        L
-    ).
-
 t_discard_session_race(_) ->
     ClientId = rand_client_id(),
     ?check_trace(

From adf22f1f10f409bdd27ecb7a8c174d65a4e7053f Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Wed, 17 Jan 2024 22:44:51 +0300
Subject: [PATCH 039/273] fix(mqtt_bridge): render valid messages from
 incomplete rule data

---
 .../src/emqx_bridge_mqtt_msg.erl              | 23 +++++++++----
 .../test/emqx_bridge_mqtt_SUITE.erl           | 34 +++++++++++++++++++
 changes/ce/fix-12347.en.md                    |  4 +++
 3 files changed, 54 insertions(+), 7 deletions(-)
 create mode 100644 changes/ce/fix-12347.en.md

diff --git a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
index 48cae70d7..e09866429 100644
--- a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
+++ b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt_msg.erl
@@ -16,6 +16,8 @@
 
 -module(emqx_bridge_mqtt_msg).
 
+-include_lib("emqx/include/emqx_mqtt.hrl").
+
 -export([parse/1]).
 -export([render/2]).
 
@@ -66,8 +68,8 @@ render(
     #{
         topic => render_string(TopicToken, Msg),
         payload => render_payload(Vars, Msg),
-        qos => render_simple_var(QoSToken, Msg),
-        retain => render_simple_var(RetainToken, Msg)
+        qos => render_simple_var(QoSToken, Msg, ?QOS_0),
+        retain => render_simple_var(RetainToken, Msg, false)
     }.
 
 render_payload(From, MapMsg) ->
@@ -80,16 +82,23 @@ do_render_payload(Tks, Msg) ->
 
 %% Replace a string contains vars to another string in which the placeholders are replace by the
 %% corresponding values. For example, given "a: ${var}", if the var=1, the result string will be:
-%% "a: 1".
+%% "a: 1". Undefined vars will be replaced by empty strings.
 render_string(Tokens, Data) when is_list(Tokens) ->
-    emqx_placeholder:proc_tmpl(Tokens, Data, #{return => full_binary});
+    emqx_placeholder:proc_tmpl(Tokens, Data, #{
+        return => full_binary, var_trans => fun undefined_as_empty/1
+    });
 render_string(Val, _Data) ->
     Val.
 
+undefined_as_empty(undefined) ->
+    <<>>;
+undefined_as_empty(Val) ->
+    emqx_utils_conv:bin(Val).
+
 %% Replace a simple var to its value. For example, given "${var}", if the var=1, then the result
 %% value will be an integer 1.
-render_simple_var(Tokens, Data) when is_list(Tokens) ->
+render_simple_var(Tokens, Data, Default) when is_list(Tokens) ->
     [Var] = emqx_placeholder:proc_tmpl(Tokens, Data, #{return => rawlist}),
-    Var;
-render_simple_var(Val, _Data) ->
+    emqx_maybe:define(Var, Default);
+render_simple_var(Val, _Data, _Default) ->
     Val.
diff --git a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
index 807fba3c9..c6850ab8e 100644
--- a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
+++ b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_SUITE.erl
@@ -836,6 +836,40 @@ t_egress_mqtt_bridge_with_rules(_) ->
     {ok, 204, <<>>} = request(delete, uri(["rules", RuleId]), []),
     {ok, 204, <<>>} = request(delete, uri(["bridges", BridgeIDEgress]), []).
 
+t_egress_mqtt_bridge_with_dummy_rule(_) ->
+    BridgeIDEgress = create_bridge(
+        ?SERVER_CONF#{
+            <<"name">> => ?BRIDGE_NAME_EGRESS,
+            <<"egress">> => ?EGRESS_CONF
+        }
+    ),
+
+    {ok, 201, Rule} = request(
+        post,
+        uri(["rules"]),
+        #{
+            <<"name">> => <<"A_rule_send_empty_messages_to_a_sink_mqtt_bridge">>,
+            <<"enable">> => true,
+            <<"actions">> => [BridgeIDEgress],
+            %% select something useless from what a message cannot be composed
+            <<"sql">> => <<"SELECT x from \"t/1\"">>
+        }
+    ),
+    #{<<"id">> := RuleId} = emqx_utils_json:decode(Rule),
+
+    %% PUBLISH a message to the rule.
+    Payload = <<"hi">>,
+    RuleTopic = <<"t/1">>,
+    RemoteTopic = <<?EGRESS_REMOTE_TOPIC, "/">>,
+    emqx:subscribe(RemoteTopic),
+    timer:sleep(100),
+    emqx:publish(emqx_message:make(RuleTopic, Payload)),
+    %% we should receive a message on the "remote" broker, with specified topic
+    assert_mqtt_msg_received(RemoteTopic, <<>>),
+
+    {ok, 204, <<>>} = request(delete, uri(["rules", RuleId]), []),
+    {ok, 204, <<>>} = request(delete, uri(["bridges", BridgeIDEgress]), []).
+
 t_mqtt_conn_bridge_egress_reconnect(_) ->
     %% then we add a mqtt connector, using POST
     BridgeIDEgress = create_bridge(
diff --git a/changes/ce/fix-12347.en.md b/changes/ce/fix-12347.en.md
new file mode 100644
index 000000000..b10738192
--- /dev/null
+++ b/changes/ce/fix-12347.en.md
@@ -0,0 +1,4 @@
+Always render valid messages for egress MQTT data bridge from the data fetched by Rule SQL, even if the data is incomplete and placeholders used in the bridge configuration are missing.
+Previously, some messages were rendered as invalid and were discarded by the MQTT egress data bridge.
+
+Render undefined variables as empty strings in `payload` and `topic` templates of the MQTT egress data bridge. Previously, undefined variables were rendered as `undefined` strings.

From 50db0558413c4c41d7ab32aadc2ce0cd2dd6b8dc Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 16 Jan 2024 17:31:28 -0300
Subject: [PATCH 040/273] ci(dev): add `.git/` to `.gitignore`

For some reason, some tools like [ripgrep](https://github.com/BurntSushi/ripgrep) will
search `.git` when using the `-.`/`--hidden` flag, even when not using `--no-ignore-vcs`.
This leads to several unwanted results.
---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 0a76c3807..7068c1c7d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -73,3 +73,4 @@ apps/emqx_conf/etc/emqx.conf.all.rendered*
 rebar-git-cache.tar
 # build docker image locally
 .docker_image_tag
+.git/

From f100825ff4fb50f9af9c2fba900c4db90aa215be Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 17 Jan 2024 15:18:03 +0100
Subject: [PATCH 041/273] ci: bump actions versions

---
 .github/actions/package-macos/action.yaml    |  2 +-
 .github/workflows/_pr_entrypoint.yaml        |  2 +-
 .github/workflows/_push-entrypoint.yaml      |  2 +-
 .github/workflows/build_docker_for_test.yaml |  2 +-
 .github/workflows/build_packages.yaml        |  2 +-
 .github/workflows/build_packages_cron.yaml   |  4 ++--
 .github/workflows/build_slim_packages.yaml   |  6 +++---
 .github/workflows/check_deps_integrity.yaml  |  2 +-
 .github/workflows/performance_test.yaml      | 18 +++++++++---------
 .github/workflows/run_conf_tests.yaml        |  2 +-
 .github/workflows/run_emqx_app_tests.yaml    |  2 +-
 .github/workflows/run_jmeter_tests.yaml      | 14 +++++++-------
 .github/workflows/run_relup_tests.yaml       |  4 ++--
 .github/workflows/run_test_cases.yaml        | 10 +++++-----
 .github/workflows/scorecard.yaml             |  2 +-
 .github/workflows/static_checks.yaml         |  2 +-
 16 files changed, 38 insertions(+), 38 deletions(-)

diff --git a/.github/actions/package-macos/action.yaml b/.github/actions/package-macos/action.yaml
index bae335cf0..64d179b46 100644
--- a/.github/actions/package-macos/action.yaml
+++ b/.github/actions/package-macos/action.yaml
@@ -51,7 +51,7 @@ runs:
             echo "SELF_HOSTED=false" >> $GITHUB_OUTPUT
             ;;
         esac
-    - uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+    - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
       id: cache
       if: steps.prepare.outputs.SELF_HOSTED != 'true'
       with:
diff --git a/.github/workflows/_pr_entrypoint.yaml b/.github/workflows/_pr_entrypoint.yaml
index 86e676ebe..1f7e8e466 100644
--- a/.github/workflows/_pr_entrypoint.yaml
+++ b/.github/workflows/_pr_entrypoint.yaml
@@ -144,7 +144,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index 1e0dd941b..a6d0e178e 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -152,7 +152,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/build_docker_for_test.yaml b/.github/workflows/build_docker_for_test.yaml
index ccff642f9..25adea083 100644
--- a/.github/workflows/build_docker_for_test.yaml
+++ b/.github/workflows/build_docker_for_test.yaml
@@ -57,7 +57,7 @@ jobs:
       - name: export docker image
         run: |
           docker save $EMQX_IMAGE_TAG | gzip > $EMQX_NAME-docker-$PKG_VSN.tar.gz
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: "${{ env.EMQX_NAME }}-docker"
           path: "${{ env.EMQX_NAME }}-docker-${{ env.PKG_VSN }}.tar.gz"
diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index 3382bbeed..abde2672e 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -95,7 +95,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: ${{ matrix.profile }}-${{ matrix.otp }}-${{ matrix.os }}
diff --git a/.github/workflows/build_packages_cron.yaml b/.github/workflows/build_packages_cron.yaml
index 56d5c37f2..5e90be8c4 100644
--- a/.github/workflows/build_packages_cron.yaml
+++ b/.github/workflows/build_packages_cron.yaml
@@ -66,7 +66,7 @@ jobs:
           set -eu
           ./scripts/pkg-tests.sh "${PROFILE}-tgz"
           ./scripts/pkg-tests.sh "${PROFILE}-pkg"
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: success()
         with:
           name: ${{ matrix.profile[0] }}-${{ matrix.os }}
@@ -111,7 +111,7 @@ jobs:
           apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
           apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
           apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: success()
         with:
           name: ${{ matrix.profile }}-${{ matrix.os }}
diff --git a/.github/workflows/build_slim_packages.yaml b/.github/workflows/build_slim_packages.yaml
index 4b9ca76b9..45dee2b3d 100644
--- a/.github/workflows/build_slim_packages.yaml
+++ b/.github/workflows/build_slim_packages.yaml
@@ -88,13 +88,13 @@ jobs:
       run: |
         make ${EMQX_NAME}-elixir-pkg
         ./scripts/pkg-tests.sh ${EMQX_NAME}-elixir-pkg
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: "${{ matrix.profile[0] }}-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: _packages/${{ matrix.profile[0] }}/*
         retention-days: 7
         compression-level: 0
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: "${{ matrix.profile[0] }}-schema-dump-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: |
@@ -128,7 +128,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: ${{ matrix.os }}
         path: _packages/**/*
diff --git a/.github/workflows/check_deps_integrity.yaml b/.github/workflows/check_deps_integrity.yaml
index 30d788500..cfe6cfbae 100644
--- a/.github/workflows/check_deps_integrity.yaml
+++ b/.github/workflows/check_deps_integrity.yaml
@@ -36,7 +36,7 @@ jobs:
           MIX_ENV: emqx-enterprise
           PROFILE: emqx-enterprise
       - name: Upload produced lock files
-        uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: produced_lock_files
diff --git a/.github/workflows/performance_test.yaml b/.github/workflows/performance_test.yaml
index ede8abf07..629e8fcdb 100644
--- a/.github/workflows/performance_test.yaml
+++ b/.github/workflows/performance_test.yaml
@@ -52,7 +52,7 @@ jobs:
       id: package_file
       run: |
         echo "PACKAGE_FILE=$(find _packages/emqx -name 'emqx-*.deb' | head -n 1 | xargs basename)" >> $GITHUB_OUTPUT
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: emqx-ubuntu20.04
         path: _packages/emqx/${{ steps.package_file.outputs.PACKAGE_FILE }}
@@ -113,13 +113,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -184,13 +184,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -257,13 +257,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
@@ -330,13 +330,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: terraform
diff --git a/.github/workflows/run_conf_tests.yaml b/.github/workflows/run_conf_tests.yaml
index cac63910b..913f4e5a4 100644
--- a/.github/workflows/run_conf_tests.yaml
+++ b/.github/workflows/run_conf_tests.yaml
@@ -40,7 +40,7 @@ jobs:
         if: failure()
         run: |
           cat _build/${{ matrix.profile }}/rel/emqx/logs/erlang.log.*
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: conftest-logs-${{ matrix.profile }}
diff --git a/.github/workflows/run_emqx_app_tests.yaml b/.github/workflows/run_emqx_app_tests.yaml
index f7c645aeb..e6326b96c 100644
--- a/.github/workflows/run_emqx_app_tests.yaml
+++ b/.github/workflows/run_emqx_app_tests.yaml
@@ -58,7 +58,7 @@ jobs:
         ./rebar3 eunit -v --name 'eunit@127.0.0.1'
         ./rebar3 as standalone_test ct --name 'test@127.0.0.1' -v --readable=true
         ./rebar3 proper -d test/props
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: failure()
       with:
         name: logs-emqx-app-tests
diff --git a/.github/workflows/run_jmeter_tests.yaml b/.github/workflows/run_jmeter_tests.yaml
index 86cbf220f..14ee999ef 100644
--- a/.github/workflows/run_jmeter_tests.yaml
+++ b/.github/workflows/run_jmeter_tests.yaml
@@ -16,7 +16,7 @@ jobs:
     steps:
     - name: Cache Jmeter
       id: cache-jmeter
-      uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+      uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
       with:
         path: /tmp/apache-jmeter.tgz
         key: apache-jmeter-5.4.3.tgz
@@ -35,7 +35,7 @@ jobs:
         else
           wget --no-verbose --no-check-certificate -O /tmp/apache-jmeter.tgz $ARCHIVE_URL
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       with:
         name: apache-jmeter.tgz
         path: /tmp/apache-jmeter.tgz
@@ -86,7 +86,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-advanced_feat-${{ matrix.scripts_type }}
@@ -153,7 +153,7 @@ jobs:
       if: failure()
       run: |
         docker compose -f .ci/docker-compose-file/docker-compose-emqx-cluster.yaml logs --no-color > ./jmeter_logs/emqx.log
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-pgsql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.pgsql_tag }}
@@ -213,7 +213,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-mysql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.mysql_tag }}
@@ -265,7 +265,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-JWT_authn-${{ matrix.scripts_type }}
@@ -309,7 +309,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       if: always()
       with:
         name: jmeter_logs-built_in_database_authn_authz-${{ matrix.scripts_type }}
diff --git a/.github/workflows/run_relup_tests.yaml b/.github/workflows/run_relup_tests.yaml
index db8cef69d..b5016d71c 100644
--- a/.github/workflows/run_relup_tests.yaml
+++ b/.github/workflows/run_relup_tests.yaml
@@ -45,7 +45,7 @@ jobs:
       run: |
         export PROFILE='emqx-enterprise'
         make emqx-enterprise-tgz
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       name: Upload built emqx and test scenario
       with:
         name: relup_tests_emqx_built
@@ -111,7 +111,7 @@ jobs:
           docker logs node2.emqx.io | tee lux_logs/emqx2.log
           exit 1
         fi
-    - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
       name: Save debug data
       if: failure()
       with:
diff --git a/.github/workflows/run_test_cases.yaml b/.github/workflows/run_test_cases.yaml
index 8841c845b..ca478a381 100644
--- a/.github/workflows/run_test_cases.yaml
+++ b/.github/workflows/run_test_cases.yaml
@@ -64,7 +64,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}
         run: make proper
 
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.otp }}
           path: _build/test/cover
@@ -108,7 +108,7 @@ jobs:
           ENABLE_COVER_COMPILE: 1
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: ./scripts/ct/run.sh --ci --app ${{ matrix.app }}
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -116,7 +116,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
@@ -155,7 +155,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: |
           make "${{ matrix.app }}-ct"
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -164,7 +164,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
diff --git a/.github/workflows/scorecard.yaml b/.github/workflows/scorecard.yaml
index f43892d01..aabe4e5b0 100644
--- a/.github/workflows/scorecard.yaml
+++ b/.github/workflows/scorecard.yaml
@@ -40,7 +40,7 @@ jobs:
           publish_results: true
 
       - name: "Upload artifact"
-        uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392 # v4.0.0
+        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: SARIF file
           path: results.sarif
diff --git a/.github/workflows/static_checks.yaml b/.github/workflows/static_checks.yaml
index a092210c8..96d3e31e9 100644
--- a/.github/workflows/static_checks.yaml
+++ b/.github/workflows/static_checks.yaml
@@ -37,7 +37,7 @@ jobs:
         run: |
           unzip -o -q ${{ matrix.profile }}.zip
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
-      - uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84 # v3.3.2
+      - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
         with:
           path: "emqx_dialyzer_${{ matrix.otp }}_plt"
           key: rebar3-dialyzer-plt-${{ matrix.profile }}-${{ matrix.otp }}-${{ hashFiles('rebar.*', 'apps/*/rebar.*') }}

From 51d32bd620542537146f49f07d96602098ec1425 Mon Sep 17 00:00:00 2001
From: JianBo He <heeejianbo@gmail.com>
Date: Thu, 18 Jan 2024 17:29:23 +0800
Subject: [PATCH 042/273] chore: improve http connector logs format

---
 .../src/emqx_bridge_http_connector.erl        | 28 ++++++++++---------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl b/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
index a148a4d16..fd522726f 100644
--- a/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
+++ b/apps/emqx_bridge_http/src/emqx_bridge_http_connector.erl
@@ -252,6 +252,7 @@ start_pool(PoolName, PoolOpts) ->
         {error, {already_started, _}} ->
             ?SLOG(warning, #{
                 msg => "emqx_connector_on_start_already_started",
+                connector => PoolName,
                 pool_name => PoolName
             }),
             ok;
@@ -510,8 +511,8 @@ resolve_pool_worker(#{pool_name := PoolName} = State, Key) ->
 on_get_channels(ResId) ->
     emqx_bridge_v2:get_channels_for_connector(ResId).
 
-on_get_status(_InstId, #{pool_name := PoolName, connect_timeout := Timeout} = State) ->
-    case do_get_status(PoolName, Timeout) of
+on_get_status(InstId, #{pool_name := InstId, connect_timeout := Timeout} = State) ->
+    case do_get_status(InstId, Timeout) of
         ok ->
             connected;
         {error, still_connecting} ->
@@ -527,12 +528,7 @@ do_get_status(PoolName, Timeout) ->
             case ehttpc:health_check(Worker, Timeout) of
                 ok ->
                     ok;
-                {error, Reason} = Error ->
-                    ?SLOG(error, #{
-                        msg => "http_connector_get_status_failed",
-                        reason => redact(Reason),
-                        worker => Worker
-                    }),
+                {error, _} = Error ->
                     Error
             end
         end,
@@ -543,14 +539,20 @@ do_get_status(PoolName, Timeout) ->
             case [E || {error, _} = E <- Results] of
                 [] ->
                     ok;
-                Errors ->
-                    hd(Errors)
+                [{error, Reason} | _] ->
+                    ?SLOG(info, #{
+                        msg => "health_check_failed",
+                        reason => redact(Reason),
+                        connector => PoolName
+                    }),
+                    {error, Reason}
             end
     catch
         exit:timeout ->
-            ?SLOG(error, #{
-                msg => "http_connector_pmap_failed",
-                reason => timeout
+            ?SLOG(info, #{
+                msg => "health_check_failed",
+                reason => timeout,
+                connector => PoolName
             }),
             {error, timeout}
     end.

From fb39e1eacc88df8c6f0b2660932b694f3614c132 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 16 Jan 2024 17:10:07 -0300
Subject: [PATCH 043/273] feat(ds): allow customizing the data directory

The storage expectations for the RocksDB DB may be different from our usual data
directory.  Also, it may consume a lot more storage than other data.

This allows customizing the data directory for the builtin DS storage backend.

Note: if the cluster was already initialized using a directory path, changing that config
will have no effect.  This path is currently persisted in mnesia and used when reopening
the DB.
---
 apps/emqx/src/emqx_persistent_message.erl     |  8 ++++-
 apps/emqx/src/emqx_schema.erl                 | 30 +++++++++++++++++++
 apps/emqx_conf/src/emqx_conf_schema.erl       | 18 ++---------
 .../src/emqx_ds_storage_layer.erl             | 20 +++++++++----
 4 files changed, 53 insertions(+), 23 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index 295ddd3dc..d725c9b2c 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -61,10 +61,16 @@ force_ds() ->
     emqx_config:get([session_persistence, force_persistence]).
 
 storage_backend(#{
-    builtin := #{enable := true, n_shards := NShards, replication_factor := ReplicationFactor}
+    builtin := #{
+        enable := true,
+        data_dir := DataDir,
+        n_shards := NShards,
+        replication_factor := ReplicationFactor
+    }
 }) ->
     #{
         backend => builtin,
+        data_dir => DataDir,
         storage => {emqx_ds_storage_bitfield_lts, #{}},
         n_shards => NShards,
         replication_factor => ReplicationFactor
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index ae22db14f..7cd67089d 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -94,6 +94,7 @@
     non_empty_string/1,
     validations/0,
     naive_env_interpolation/1,
+    ensure_unicode_path/2,
     validate_server_ssl_opts/1,
     validate_tcp_keepalive/1,
     parse_tcp_keepalive/1
@@ -1882,6 +1883,18 @@ fields("session_storage_backend_builtin") ->
                     default => true
                 }
             )},
+        {"data_dir",
+            sc(
+                string(),
+                #{
+                    desc => ?DESC(session_builtin_data_dir),
+                    default => <<"${EMQX_DATA_DIR}">>,
+                    importance => ?IMPORTANCE_LOW,
+                    converter => fun(Path, Opts) ->
+                        naive_env_interpolation(ensure_unicode_path(Path, Opts))
+                    end
+                }
+            )},
         {"n_shards",
             sc(
                 pos_integer(),
@@ -3836,3 +3849,20 @@ tags_schema() ->
             importance => ?IMPORTANCE_LOW
         }
     ).
+
+ensure_unicode_path(undefined, _) ->
+    undefined;
+ensure_unicode_path(Path, #{make_serializable := true}) ->
+    %% format back to serializable string
+    unicode:characters_to_binary(Path, utf8);
+ensure_unicode_path(Path, Opts) when is_binary(Path) ->
+    case unicode:characters_to_list(Path, utf8) of
+        {R, _, _} when R =:= error orelse R =:= incomplete ->
+            throw({"bad_file_path_string", Path});
+        PathStr ->
+            ensure_unicode_path(PathStr, Opts)
+    end;
+ensure_unicode_path(Path, _) when is_list(Path) ->
+    Path;
+ensure_unicode_path(Path, _) ->
+    throw({"not_string", Path}).
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index abb2e14e3..04f19b95f 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -1432,22 +1432,8 @@ convert_rotation(#{} = Rotation, _Opts) -> maps:get(<<"count">>, Rotation, 10);
 convert_rotation(Count, _Opts) when is_integer(Count) -> Count;
 convert_rotation(Count, _Opts) -> throw({"bad_rotation", Count}).
 
-ensure_unicode_path(undefined, _) ->
-    undefined;
-ensure_unicode_path(Path, #{make_serializable := true}) ->
-    %% format back to serializable string
-    unicode:characters_to_binary(Path, utf8);
-ensure_unicode_path(Path, Opts) when is_binary(Path) ->
-    case unicode:characters_to_list(Path, utf8) of
-        {R, _, _} when R =:= error orelse R =:= incomplete ->
-            throw({"bad_file_path_string", Path});
-        PathStr ->
-            ensure_unicode_path(PathStr, Opts)
-    end;
-ensure_unicode_path(Path, _) when is_list(Path) ->
-    Path;
-ensure_unicode_path(Path, _) ->
-    throw({"not_string", Path}).
+ensure_unicode_path(Path, Opts) ->
+    emqx_schema:ensure_unicode_path(Path, Opts).
 
 log_level() ->
     hoconsc:enum([debug, info, notice, warning, error, critical, alert, emergency, all]).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index ab64005b6..d44235924 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -34,7 +34,7 @@
 -export([start_link/2, init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2]).
 
 %% internal exports:
--export([db_dir/1]).
+-export([db_dir/2]).
 
 -export_type([
     gen_id/0,
@@ -168,7 +168,13 @@ open_shard(Shard, Options) ->
 -spec drop_shard(shard_id()) -> ok.
 drop_shard(Shard) ->
     catch emqx_ds_storage_layer_sup:stop_shard(Shard),
-    ok = rocksdb:destroy(db_dir(Shard), []).
+    case persistent_term:get({?MODULE, Shard, data_dir}, undefined) of
+        undefined ->
+            ok;
+        BaseDir ->
+            ok = rocksdb:destroy(db_dir(BaseDir, Shard), []),
+            persistent_term:erase({?MODULE, Shard, base_dir})
+    end.
 
 -spec store_batch(shard_id(), [emqx_types:message()], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
@@ -424,7 +430,8 @@ rocksdb_open(Shard, Options) ->
         {create_missing_column_families, true}
         | maps:get(db_options, Options, [])
     ],
-    DBDir = db_dir(Shard),
+    DataDir = maps:get(data_dir, Options, emqx:data_dir()),
+    DBDir = db_dir(DataDir, Shard),
     _ = filelib:ensure_dir(DBDir),
     ExistingCFs =
         case rocksdb:list_column_families(DBDir, DBOptions) of
@@ -440,15 +447,16 @@ rocksdb_open(Shard, Options) ->
     ],
     case rocksdb:open(DBDir, DBOptions, ColumnFamilies) of
         {ok, DBHandle, [_CFDefault | CFRefs]} ->
+            persistent_term:put({?MODULE, Shard, data_dir}, DataDir),
             {CFNames, _} = lists:unzip(ExistingCFs),
             {ok, DBHandle, lists:zip(CFNames, CFRefs)};
         Error ->
             Error
     end.
 
--spec db_dir(shard_id()) -> file:filename().
-db_dir({DB, ShardId}) ->
-    filename:join([emqx:data_dir(), atom_to_list(DB), binary_to_list(ShardId)]).
+-spec db_dir(file:filename(), shard_id()) -> file:filename().
+db_dir(BaseDir, {DB, ShardId}) ->
+    filename:join([BaseDir, atom_to_list(DB), binary_to_list(ShardId)]).
 
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->

From 4a0fd756ae8c43edff0ccfa60ca0a6c8bf34b28b Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 15 Jan 2024 16:52:59 -0300
Subject: [PATCH 044/273] feat(ds): add `list_generations` and
 `drop_generation` APIs

---
 apps/emqx/priv/bpapi.versions                 |   1 +
 apps/emqx_durable_storage/src/emqx_ds.erl     |  57 +++-
 .../src/emqx_ds_replication_layer.erl         |  45 ++-
 .../src/emqx_ds_storage_bitfield_lts.erl      |  16 +
 .../src/emqx_ds_storage_layer.erl             | 293 ++++++++++++++----
 .../src/emqx_ds_storage_reference.erl         |   8 +-
 .../src/proto/emqx_ds_proto_v3.erl            | 147 +++++++++
 .../test/emqx_ds_SUITE.erl                    | 250 ++++++++++++++-
 8 files changed, 755 insertions(+), 62 deletions(-)
 create mode 100644 apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl

diff --git a/apps/emqx/priv/bpapi.versions b/apps/emqx/priv/bpapi.versions
index 859d7fbe0..987c19535 100644
--- a/apps/emqx/priv/bpapi.versions
+++ b/apps/emqx/priv/bpapi.versions
@@ -22,6 +22,7 @@
 {emqx_delayed,3}.
 {emqx_ds,1}.
 {emqx_ds,2}.
+{emqx_ds,3}.
 {emqx_eviction_agent,1}.
 {emqx_eviction_agent,2}.
 {emqx_exhook,1}.
diff --git a/apps/emqx_durable_storage/src/emqx_ds.erl b/apps/emqx_durable_storage/src/emqx_ds.erl
index d679f7097..434169520 100644
--- a/apps/emqx_durable_storage/src/emqx_ds.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds.erl
@@ -22,7 +22,14 @@
 -module(emqx_ds).
 
 %% Management API:
--export([open_db/2, update_db_config/2, add_generation/1, drop_db/1]).
+-export([
+    open_db/2,
+    update_db_config/2,
+    add_generation/1,
+    list_generations_with_lifetimes/1,
+    drop_generation/2,
+    drop_db/1
+]).
 
 %% Message storage API:
 -export([store_batch/2, store_batch/3]).
@@ -52,7 +59,10 @@
     get_iterator_result/1,
 
     ds_specific_stream/0,
-    ds_specific_iterator/0
+    ds_specific_iterator/0,
+    ds_specific_generation_rank/0,
+    generation_rank/0,
+    generation_info/0
 ]).
 
 %%================================================================================
@@ -80,6 +90,8 @@
 
 -type ds_specific_stream() :: term().
 
+-type ds_specific_generation_rank() :: term().
+
 -type message_key() :: binary().
 
 -type store_batch_result() :: ok | {error, _}.
@@ -114,6 +126,17 @@
 
 -type get_iterator_result(Iterator) :: {ok, Iterator} | undefined.
 
+%% An opaque term identifying a generation.  Each implementation will possibly add
+%% information to this term to match its inner structure (e.g.: by embedding the shard id,
+%% in the case of `emqx_ds_replication_layer').
+-opaque generation_rank() :: ds_specific_generation_rank().
+
+-type generation_info() :: #{
+    created_at := time(),
+    since := time(),
+    until := time() | undefined
+}.
+
 -define(persistent_term(DB), {emqx_ds_db_backend, DB}).
 
 -define(module(DB), (persistent_term:get(?persistent_term(DB)))).
@@ -128,6 +151,11 @@
 
 -callback update_db_config(db(), create_db_opts()) -> ok | {error, _}.
 
+-callback list_generations_with_lifetimes(db()) ->
+    #{generation_rank() => generation_info()}.
+
+-callback drop_generation(db(), generation_rank()) -> ok | {error, _}.
+
 -callback drop_db(db()) -> ok | {error, _}.
 
 -callback store_batch(db(), [emqx_types:message()], message_store_opts()) -> store_batch_result().
@@ -142,6 +170,11 @@
 
 -callback next(db(), Iterator, pos_integer()) -> next_result(Iterator).
 
+-optional_callbacks([
+    list_generations_with_lifetimes/1,
+    drop_generation/2
+]).
+
 %%================================================================================
 %% API funcions
 %%================================================================================
@@ -166,6 +199,26 @@ add_generation(DB) ->
 update_db_config(DB, Opts) ->
     ?module(DB):update_db_config(DB, Opts).
 
+-spec list_generations_with_lifetimes(db()) -> #{generation_rank() => generation_info()}.
+list_generations_with_lifetimes(DB) ->
+    Mod = ?module(DB),
+    case erlang:function_exported(Mod, list_generations_with_lifetimes, 1) of
+        true ->
+            Mod:list_generations_with_lifetimes(DB);
+        false ->
+            #{}
+    end.
+
+-spec drop_generation(db(), generation_rank()) -> ok | {error, _}.
+drop_generation(DB, GenId) ->
+    Mod = ?module(DB),
+    case erlang:function_exported(Mod, drop_generation, 2) of
+        true ->
+            Mod:drop_generation(DB, GenId);
+        false ->
+            {error, not_implemented}
+    end.
+
 %% @doc TODO: currently if one or a few shards are down, they won't be
 
 %% deleted.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
index 68d9459ee..387587570 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
@@ -25,6 +25,8 @@
     open_db/2,
     add_generation/1,
     update_db_config/2,
+    list_generations_with_lifetimes/1,
+    drop_generation/2,
     drop_db/1,
     store_batch/3,
     get_streams/3,
@@ -41,7 +43,9 @@
     do_make_iterator_v1/5,
     do_update_iterator_v2/4,
     do_next_v1/4,
-    do_add_generation_v2/1
+    do_add_generation_v2/1,
+    do_list_generations_with_lifetimes_v3/2,
+    do_drop_generation_v3/3
 ]).
 
 -export_type([shard_id/0, builtin_db_opts/0, stream/0, iterator/0, message_id/0, batch/0]).
@@ -104,6 +108,8 @@
     ?batch_messages := [emqx_types:message()]
 }.
 
+-type generation_rank() :: {shard_id(), term()}.
+
 %%================================================================================
 %% API functions
 %%================================================================================
@@ -135,6 +141,32 @@ add_generation(DB) ->
 update_db_config(DB, CreateOpts) ->
     emqx_ds_replication_layer_meta:update_db_config(DB, CreateOpts).
 
+-spec list_generations_with_lifetimes(emqx_ds:db()) ->
+    #{generation_rank() => emqx_ds:generation_info()}.
+list_generations_with_lifetimes(DB) ->
+    Shards = list_shards(DB),
+    lists:foldl(
+        fun(Shard, GensAcc) ->
+            Node = node_of_shard(DB, Shard),
+            maps:fold(
+                fun(GenId, Data, AccInner) ->
+                    AccInner#{{Shard, GenId} => Data}
+                end,
+                GensAcc,
+                emqx_ds_proto_v3:list_generations_with_lifetimes(Node, DB, Shard)
+            )
+        end,
+        #{},
+        Shards
+    ).
+
+-spec drop_generation(emqx_ds:db(), generation_rank()) -> ok | {error, _}.
+drop_generation(DB, {Shard, GenId}) ->
+    %% TODO: drop generation in all nodes in the replica set, not only in the leader,
+    %% after we have proper replication in place.
+    Node = node_of_shard(DB, Shard),
+    emqx_ds_proto_v3:drop_generation(Node, DB, Shard, GenId).
+
 -spec drop_db(emqx_ds:db()) -> ok | {error, _}.
 drop_db(DB) ->
     Nodes = list_nodes(),
@@ -301,7 +333,6 @@ do_next_v1(DB, Shard, Iter, BatchSize) ->
 -spec do_add_generation_v2(emqx_ds:db()) -> ok | {error, _}.
 do_add_generation_v2(DB) ->
     MyShards = emqx_ds_replication_layer_meta:my_owned_shards(DB),
-
     lists:foreach(
         fun(ShardId) ->
             emqx_ds_storage_layer:add_generation({DB, ShardId})
@@ -309,6 +340,16 @@ do_add_generation_v2(DB) ->
         MyShards
     ).
 
+-spec do_list_generations_with_lifetimes_v3(emqx_ds:db(), shard_id()) ->
+    #{emqx_ds:ds_specific_generation_rank() => emqx_ds:generation_info()}.
+do_list_generations_with_lifetimes_v3(DB, ShardId) ->
+    emqx_ds_storage_layer:list_generations_with_lifetimes({DB, ShardId}).
+
+-spec do_drop_generation_v3(emqx_ds:db(), shard_id(), emqx_ds_storage_layer:gen_id()) ->
+    ok | {error, _}.
+do_drop_generation_v3(DB, ShardId, GenId) ->
+    emqx_ds_storage_layer:drop_generation({DB, ShardId}, GenId).
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 4c59a5f62..27d41e6c6 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -27,6 +27,7 @@
 -export([
     create/4,
     open/5,
+    drop/5,
     store_batch/4,
     get_streams/4,
     make_iterator/5,
@@ -199,6 +200,21 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
         ts_offset = TSOffsetBits
     }.
 
+-spec drop(
+    emqx_ds_storage_layer:shard_id(),
+    rocksdb:db_handle(),
+    emqx_ds_storage_layer:gen_id(),
+    emqx_ds_storage_layer:cf_refs(),
+    s()
+) ->
+    ok.
+drop(_Shard, DBHandle, GenId, CFRefs, #s{}) ->
+    {_, DataCF} = lists:keyfind(data_cf(GenId), 1, CFRefs),
+    {_, TrieCF} = lists:keyfind(trie_cf(GenId), 1, CFRefs),
+    ok = rocksdb:drop_column_family(DBHandle, DataCF),
+    ok = rocksdb:drop_column_family(DBHandle, TrieCF),
+    ok.
+
 -spec store_batch(
     emqx_ds_storage_layer:shard_id(), s(), [emqx_types:message()], emqx_ds:message_store_opts()
 ) ->
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index d44235924..0dcb8ce52 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -27,7 +27,9 @@
     update_iterator/3,
     next/3,
     update_config/2,
-    add_generation/1
+    add_generation/1,
+    list_generations_with_lifetimes/1,
+    drop_generation/2
 ]).
 
 %% gen_server
@@ -44,7 +46,8 @@
     iterator/0,
     shard_id/0,
     options/0,
-    prototype/0
+    prototype/0,
+    post_creation_context/0
 ]).
 
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
@@ -95,11 +98,18 @@
 
 %%%% Generation:
 
+-define(GEN_KEY(GEN_ID), {generation, GEN_ID}).
+
 -type generation(Data) :: #{
     %% Module that handles data for the generation:
     module := module(),
     %% Module-specific data defined at generation creation time:
     data := Data,
+    %% Column families used by this generation
+    cf_refs := cf_refs(),
+    %% Time at which this was created.  Might differ from `since', in particular for the
+    %% first generation.
+    created_at := emqx_ds:time(),
     %% When should this generation become active?
     %% This generation should only contain messages timestamped no earlier than that.
     %% The very first generation will have `since` equal 0.
@@ -121,7 +131,7 @@
     %% This data is used to create new generation:
     prototype := prototype(),
     %% Generations:
-    {generation, gen_id()} => GenData
+    ?GEN_KEY(gen_id()) => GenData
 }.
 
 %% Shard schema (persistent):
@@ -132,6 +142,18 @@
 
 -type options() :: map().
 
+-type post_creation_context() ::
+    #{
+        shard_id := emqx_ds_storage_layer:shard_id(),
+        db := rocksdb:db_handle(),
+        new_gen_id := emqx_ds_storage_layer:gen_id(),
+        old_gen_id := emqx_ds_storage_layer:gen_id(),
+        new_cf_refs := cf_refs(),
+        old_cf_refs := cf_refs(),
+        new_gen_runtime_data := _NewData,
+        old_gen_runtime_data := _OldData
+    }.
+
 %%================================================================================
 %% Generation callbacks
 %%================================================================================
@@ -145,6 +167,9 @@
 -callback open(shard_id(), rocksdb:db_handle(), gen_id(), cf_refs(), _Schema) ->
     _Data.
 
+-callback drop(shard_id(), rocksdb:db_handle(), gen_id(), cf_refs(), _RuntimeData) ->
+    ok | {error, _Reason}.
+
 -callback store_batch(shard_id(), _Data, [emqx_types:message()], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
 
@@ -157,10 +182,17 @@
 -callback next(shard_id(), _Data, Iter, pos_integer()) ->
     {ok, Iter, [emqx_types:message()]} | {error, _}.
 
+-callback post_creation_actions(post_creation_context()) -> _Data.
+
+-optional_callbacks([post_creation_actions/1]).
+
 %%================================================================================
 %% API for the replication layer
 %%================================================================================
 
+-record(call_list_generations_with_lifetimes, {}).
+-record(call_drop_generation, {gen_id :: gen_id()}).
+
 -spec open_shard(shard_id(), options()) -> ok.
 open_shard(Shard, Options) ->
     emqx_ds_storage_layer_sup:ensure_shard(Shard, Options).
@@ -188,18 +220,25 @@ store_batch(Shard, Messages, Options) ->
     [{integer(), stream()}].
 get_streams(Shard, TopicFilter, StartTime) ->
     Gens = generations_since(Shard, StartTime),
+    ?tp(get_streams_all_gens, #{gens => Gens}),
     lists:flatmap(
         fun(GenId) ->
-            #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-            Streams = Mod:get_streams(Shard, GenData, TopicFilter, StartTime),
-            [
-                {GenId, #{
-                    ?tag => ?STREAM,
-                    ?generation => GenId,
-                    ?enc => Stream
-                }}
-             || Stream <- Streams
-            ]
+            ?tp(get_streams_get_gen, #{gen_id => GenId}),
+            case generation_get_safe(Shard, GenId) of
+                {ok, #{module := Mod, data := GenData}} ->
+                    Streams = Mod:get_streams(Shard, GenData, TopicFilter, StartTime),
+                    [
+                        {GenId, #{
+                            ?tag => ?STREAM,
+                            ?generation => GenId,
+                            ?enc => Stream
+                        }}
+                     || Stream <- Streams
+                    ];
+                {error, not_found} ->
+                    %% race condition: generation was dropped before getting its streams?
+                    []
+            end
         end,
         Gens
     ).
@@ -209,16 +248,20 @@ get_streams(Shard, TopicFilter, StartTime) ->
 make_iterator(
     Shard, #{?tag := ?STREAM, ?generation := GenId, ?enc := Stream}, TopicFilter, StartTime
 ) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    case Mod:make_iterator(Shard, GenData, Stream, TopicFilter, StartTime) of
-        {ok, Iter} ->
-            {ok, #{
-                ?tag => ?IT,
-                ?generation => GenId,
-                ?enc => Iter
-            }};
-        {error, _} = Err ->
-            Err
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            case Mod:make_iterator(Shard, GenData, Stream, TopicFilter, StartTime) of
+                {ok, Iter} ->
+                    {ok, #{
+                        ?tag => ?IT,
+                        ?generation => GenId,
+                        ?enc => Iter
+                    }};
+                {error, _} = Err ->
+                    Err
+            end;
+        {error, not_found} ->
+            {error, end_of_stream}
     end.
 
 -spec update_iterator(
@@ -230,33 +273,42 @@ update_iterator(
     #{?tag := ?IT, ?generation := GenId, ?enc := OldIter},
     DSKey
 ) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    case Mod:update_iterator(Shard, GenData, OldIter, DSKey) of
-        {ok, Iter} ->
-            {ok, #{
-                ?tag => ?IT,
-                ?generation => GenId,
-                ?enc => Iter
-            }};
-        {error, _} = Err ->
-            Err
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            case Mod:update_iterator(Shard, GenData, OldIter, DSKey) of
+                {ok, Iter} ->
+                    {ok, #{
+                        ?tag => ?IT,
+                        ?generation => GenId,
+                        ?enc => Iter
+                    }};
+                {error, _} = Err ->
+                    Err
+            end;
+        {error, not_found} ->
+            {error, end_of_stream}
     end.
 
 -spec next(shard_id(), iterator(), pos_integer()) ->
     emqx_ds:next_result(iterator()).
 next(Shard, Iter = #{?tag := ?IT, ?generation := GenId, ?enc := GenIter0}, BatchSize) ->
-    #{module := Mod, data := GenData} = generation_get(Shard, GenId),
-    Current = generation_current(Shard),
-    case Mod:next(Shard, GenData, GenIter0, BatchSize) of
-        {ok, _GenIter, []} when GenId < Current ->
-            %% This is a past generation. Storage layer won't write
-            %% any more messages here. The iterator reached the end:
-            %% the stream has been fully replayed.
-            {ok, end_of_stream};
-        {ok, GenIter, Batch} ->
-            {ok, Iter#{?enc := GenIter}, Batch};
-        Error = {error, _} ->
-            Error
+    case generation_get_safe(Shard, GenId) of
+        {ok, #{module := Mod, data := GenData}} ->
+            Current = generation_current(Shard),
+            case Mod:next(Shard, GenData, GenIter0, BatchSize) of
+                {ok, _GenIter, []} when GenId < Current ->
+                    %% This is a past generation. Storage layer won't write
+                    %% any more messages here. The iterator reached the end:
+                    %% the stream has been fully replayed.
+                    {ok, end_of_stream};
+                {ok, GenIter, Batch} ->
+                    {ok, Iter#{?enc := GenIter}, Batch};
+                Error = {error, _} ->
+                    Error
+            end;
+        {error, not_found} ->
+            %% generation was possibly dropped by GC
+            {ok, end_of_stream}
     end.
 
 -spec update_config(shard_id(), emqx_ds:create_db_opts()) -> ok.
@@ -267,6 +319,21 @@ update_config(ShardId, Options) ->
 add_generation(ShardId) ->
     gen_server:call(?REF(ShardId), add_generation, infinity).
 
+-spec list_generations_with_lifetimes(shard_id()) ->
+    #{
+        gen_id() => #{
+            created_at := emqx_ds:time(),
+            since := emqx_ds:time(),
+            until := undefined | emqx_ds:time()
+        }
+    }.
+list_generations_with_lifetimes(ShardId) ->
+    gen_server:call(?REF(ShardId), #call_list_generations_with_lifetimes{}, infinity).
+
+-spec drop_generation(shard_id(), gen_id()) -> ok.
+drop_generation(ShardId, GenId) ->
+    gen_server:call(?REF(ShardId), #call_drop_generation{gen_id = GenId}, infinity).
+
 %%================================================================================
 %% gen_server for the shard
 %%================================================================================
@@ -328,6 +395,13 @@ handle_call(add_generation, _From, S0) ->
     S = add_generation(S0, Since),
     commit_metadata(S),
     {reply, ok, S};
+handle_call(#call_list_generations_with_lifetimes{}, _From, S) ->
+    Generations = handle_list_generations_with_lifetimes(S),
+    {reply, Generations, S};
+handle_call(#call_drop_generation{gen_id = GenId}, _From, S0) ->
+    {Reply, S} = handle_drop_generation(S0, GenId),
+    commit_metadata(S),
+    {reply, Reply, S};
 handle_call(#call_create_generation{since = Since}, _From, S0) ->
     S = add_generation(S0, Since),
     commit_metadata(S),
@@ -359,7 +433,7 @@ open_shard(ShardId, DB, CFRefs, ShardSchema) ->
     %% Transform generation schemas to generation runtime data:
     maps:map(
         fun
-            ({generation, GenId}, GenSchema) ->
+            (?GEN_KEY(GenId), GenSchema) ->
                 open_generation(ShardId, DB, CFRefs, GenId, GenSchema);
             (_K, Val) ->
                 Val
@@ -372,10 +446,40 @@ add_generation(S0, Since) ->
     #s{shard_id = ShardId, db = DB, schema = Schema0, shard = Shard0, cf_refs = CFRefs0} = S0,
     Schema1 = update_last_until(Schema0, Since),
     Shard1 = update_last_until(Shard0, Since),
+
+    #{current_generation := OldGenId, prototype := {CurrentMod, _ModConf}} = Schema0,
+    OldKey = ?GEN_KEY(OldGenId),
+    #{OldKey := OldGenSchema} = Schema0,
+    #{cf_refs := OldCFRefs} = OldGenSchema,
+    #{OldKey := #{module := OldMod, data := OldGenData}} = Shard0,
+
     {GenId, Schema, NewCFRefs} = new_generation(ShardId, DB, Schema1, Since),
+
     CFRefs = NewCFRefs ++ CFRefs0,
-    Key = {generation, GenId},
-    Generation = open_generation(ShardId, DB, CFRefs, GenId, maps:get(Key, Schema)),
+    Key = ?GEN_KEY(GenId),
+    Generation0 =
+        #{data := NewGenData0} =
+        open_generation(ShardId, DB, CFRefs, GenId, maps:get(Key, Schema)),
+
+    %% When the new generation's module is the same as the last one, we might want to
+    %% perform actions like inheriting some of the previous (meta)data.
+    NewGenData =
+        run_post_creation_actions(
+            #{
+                shard_id => ShardId,
+                db => DB,
+                new_gen_id => GenId,
+                old_gen_id => OldGenId,
+                new_cf_refs => NewCFRefs,
+                old_cf_refs => OldCFRefs,
+                new_gen_runtime_data => NewGenData0,
+                old_gen_runtime_data => OldGenData,
+                new_module => CurrentMod,
+                old_module => OldMod
+            }
+        ),
+    Generation = Generation0#{data := NewGenData},
+
     Shard = Shard1#{current_generation := GenId, Key => Generation},
     S0#s{
         cf_refs = CFRefs,
@@ -383,6 +487,54 @@ add_generation(S0, Since) ->
         shard = Shard
     }.
 
+-spec handle_list_generations_with_lifetimes(server_state()) -> #{gen_id() => map()}.
+handle_list_generations_with_lifetimes(#s{schema = ShardSchema}) ->
+    maps:fold(
+        fun
+            (?GEN_KEY(GenId), GenSchema, Acc) ->
+                Acc#{GenId => export_generation(GenSchema)};
+            (_Key, _Value, Acc) ->
+                Acc
+        end,
+        #{},
+        ShardSchema
+    ).
+
+-spec export_generation(generation_schema()) -> map().
+export_generation(GenSchema) ->
+    maps:with([created_at, since, until], GenSchema).
+
+-spec handle_drop_generation(server_state(), gen_id()) ->
+    {ok | {error, current_generation}, server_state()}.
+handle_drop_generation(#s{schema = #{current_generation := GenId}} = S0, GenId) ->
+    {{error, current_generation}, S0};
+handle_drop_generation(#s{schema = Schema} = S0, GenId) when
+    not is_map_key(?GEN_KEY(GenId), Schema)
+->
+    {{error, not_found}, S0};
+handle_drop_generation(S0, GenId) ->
+    #s{
+        shard_id = ShardId,
+        db = DB,
+        schema = #{?GEN_KEY(GenId) := GenSchema} = OldSchema,
+        shard = OldShard,
+        cf_refs = OldCFRefs
+    } = S0,
+    #{module := Mod, cf_refs := GenCFRefs} = GenSchema,
+    #{?GEN_KEY(GenId) := #{data := RuntimeData}} = OldShard,
+    case Mod:drop(ShardId, DB, GenId, GenCFRefs, RuntimeData) of
+        ok ->
+            CFRefs = OldCFRefs -- GenCFRefs,
+            Shard = maps:remove(?GEN_KEY(GenId), OldShard),
+            Schema = maps:remove(?GEN_KEY(GenId), OldSchema),
+            S = S0#s{
+                cf_refs = CFRefs,
+                shard = Shard,
+                schema = Schema
+            },
+            {ok, S}
+    end.
+
 -spec open_generation(shard_id(), rocksdb:db_handle(), cf_refs(), gen_id(), generation_schema()) ->
     generation().
 open_generation(ShardId, DB, CFRefs, GenId, GenSchema) ->
@@ -409,10 +561,17 @@ new_generation(ShardId, DB, Schema0, Since) ->
     #{current_generation := PrevGenId, prototype := {Mod, ModConf}} = Schema0,
     GenId = PrevGenId + 1,
     {GenData, NewCFRefs} = Mod:create(ShardId, DB, GenId, ModConf),
-    GenSchema = #{module => Mod, data => GenData, since => Since, until => undefined},
+    GenSchema = #{
+        module => Mod,
+        data => GenData,
+        cf_refs => NewCFRefs,
+        created_at => emqx_message:timestamp_now(),
+        since => Since,
+        until => undefined
+    },
     Schema = Schema0#{
         current_generation => GenId,
-        {generation, GenId} => GenSchema
+        ?GEN_KEY(GenId) => GenSchema
     },
     {GenId, Schema, NewCFRefs}.
 
@@ -461,9 +620,26 @@ db_dir(BaseDir, {DB, ShardId}) ->
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->
     #{current_generation := GenId} = Schema,
-    GenData0 = maps:get({generation, GenId}, Schema),
+    GenData0 = maps:get(?GEN_KEY(GenId), Schema),
     GenData = GenData0#{until := Until},
-    Schema#{{generation, GenId} := GenData}.
+    Schema#{?GEN_KEY(GenId) := GenData}.
+
+run_post_creation_actions(
+    #{
+        new_module := Mod,
+        old_module := Mod,
+        new_gen_runtime_data := NewGenData
+    } = Context
+) ->
+    case erlang:function_exported(Mod, post_creation_actions, 1) of
+        true ->
+            Mod:post_creation_actions(Context);
+        false ->
+            NewGenData
+    end;
+run_post_creation_actions(#{new_gen_runtime_data := NewGenData}) ->
+    %% Different implementation modules
+    NewGenData.
 
 %%--------------------------------------------------------------------------------
 %% Schema access
@@ -476,15 +652,24 @@ generation_current(Shard) ->
 
 -spec generation_get(shard_id(), gen_id()) -> generation().
 generation_get(Shard, GenId) ->
-    #{{generation, GenId} := GenData} = get_schema_runtime(Shard),
+    {ok, GenData} = generation_get_safe(Shard, GenId),
     GenData.
 
+-spec generation_get_safe(shard_id(), gen_id()) -> {ok, generation()} | {error, not_found}.
+generation_get_safe(Shard, GenId) ->
+    case get_schema_runtime(Shard) of
+        #{?GEN_KEY(GenId) := GenData} ->
+            {ok, GenData};
+        #{} ->
+            {error, not_found}
+    end.
+
 -spec generations_since(shard_id(), emqx_ds:time()) -> [gen_id()].
 generations_since(Shard, Since) ->
     Schema = get_schema_runtime(Shard),
     maps:fold(
         fun
-            ({generation, GenId}, #{until := Until}, Acc) when Until >= Since ->
+            (?GEN_KEY(GenId), #{until := Until}, Acc) when Until >= Since ->
                 [GenId | Acc];
             (_K, _V, Acc) ->
                 Acc
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
index da7ac79f6..c958e56dc 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_reference.erl
@@ -30,6 +30,7 @@
 -export([
     create/4,
     open/5,
+    drop/5,
     store_batch/4,
     get_streams/4,
     make_iterator/5,
@@ -85,6 +86,10 @@ open(_Shard, DBHandle, GenId, CFRefs, #schema{}) ->
     {_, CF} = lists:keyfind(data_cf(GenId), 1, CFRefs),
     #s{db = DBHandle, cf = CF}.
 
+drop(_ShardId, DBHandle, _GenId, _CFRefs, #s{cf = CFHandle}) ->
+    ok = rocksdb:drop_column_family(DBHandle, CFHandle),
+    ok.
+
 store_batch(_ShardId, #s{db = DB, cf = CF}, Messages, _Options) ->
     lists:foreach(
         fun(Msg) ->
@@ -142,7 +147,8 @@ do_next(TopicFilter, StartTime, IT, Action, NLeft, Key0, Acc) ->
     case rocksdb:iterator_move(IT, Action) of
         {ok, Key, Blob} ->
             Msg = #message{topic = Topic, timestamp = TS} = binary_to_term(Blob),
-            case emqx_topic:match(Topic, TopicFilter) andalso TS >= StartTime of
+            TopicWords = emqx_topic:words(Topic),
+            case emqx_topic:match(TopicWords, TopicFilter) andalso TS >= StartTime of
                 true ->
                     do_next(TopicFilter, StartTime, IT, next, NLeft - 1, Key, [{Key, Msg} | Acc]);
                 false ->
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
new file mode 100644
index 000000000..74a174c4c
--- /dev/null
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
@@ -0,0 +1,147 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_ds_proto_v3).
+
+-behavior(emqx_bpapi).
+
+-include_lib("emqx_utils/include/bpapi.hrl").
+%% API:
+-export([
+    drop_db/2,
+    store_batch/5,
+    get_streams/5,
+    make_iterator/6,
+    next/5,
+    update_iterator/5,
+    add_generation/2,
+
+    %% introduced in v3
+    list_generations_with_lifetimes/3,
+    drop_generation/4
+]).
+
+%% behavior callbacks:
+-export([introduced_in/0]).
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec drop_db([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+drop_db(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_drop_db_v1, [DB]).
+
+-spec get_streams(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    [{integer(), emqx_ds_storage_layer:stream()}].
+get_streams(Node, DB, Shard, TopicFilter, Time) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v1, [DB, Shard, TopicFilter, Time]).
+
+-spec make_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:stream(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+make_iterator(Node, DB, Shard, Stream, TopicFilter, StartTime) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_make_iterator_v1, [
+        DB, Shard, Stream, TopicFilter, StartTime
+    ]).
+
+-spec next(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    pos_integer()
+) ->
+    {ok, emqx_ds_storage_layer:iterator(), [{emqx_ds:message_key(), [emqx_types:message()]}]}
+    | {ok, end_of_stream}
+    | {error, _}.
+next(Node, DB, Shard, Iter, BatchSize) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_next_v1, [DB, Shard, Iter, BatchSize]).
+
+-spec store_batch(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_replication_layer:batch(),
+    emqx_ds:message_store_opts()
+) ->
+    emqx_ds:store_batch_result().
+store_batch(Node, DB, Shard, Batch, Options) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_store_batch_v1, [
+        DB, Shard, Batch, Options
+    ]).
+
+-spec update_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    emqx_ds:message_key()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+update_iterator(Node, DB, Shard, OldIter, DSKey) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_update_iterator_v2, [
+        DB, Shard, OldIter, DSKey
+    ]).
+
+-spec add_generation([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+add_generation(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_add_generation_v2, [DB]).
+
+%%--------------------------------------------------------------------------------
+%% Introduced in V3
+%%--------------------------------------------------------------------------------
+
+-spec list_generations_with_lifetimes(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id()
+) ->
+    #{
+        emqx_ds:ds_specific_generation_rank() => emqx_ds:generation_info()
+    }.
+list_generations_with_lifetimes(Node, DB, Shard) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_list_generations_with_lifetimes_v3, [DB, Shard]).
+
+-spec drop_generation(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:gen_id()
+) ->
+    ok | {error, _}.
+drop_generation(Node, DB, Shard, GenId) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_drop_generation_v3, [DB, Shard, GenId]).
+
+%%================================================================================
+%% behavior callbacks
+%%================================================================================
+
+introduced_in() ->
+    "5.6.0".
diff --git a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
index cb9d81580..d7dccccf5 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_SUITE.erl
@@ -155,7 +155,7 @@ t_05_update_iterator(_Config) ->
     ?assertEqual(Msgs, AllMsgs, #{from_key => Iter1, final_iter => FinalIter}),
     ok.
 
-t_05_update_config(_Config) ->
+t_06_update_config(_Config) ->
     DB = ?FUNCTION_NAME,
     ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
     TopicFilter = ['#'],
@@ -199,7 +199,7 @@ t_05_update_config(_Config) ->
     end,
     lists:foldl(Checker, [], lists:zip(StartTimes, MsgsList)).
 
-t_06_add_generation(_Config) ->
+t_07_add_generation(_Config) ->
     DB = ?FUNCTION_NAME,
     ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
     TopicFilter = ['#'],
@@ -243,6 +243,250 @@ t_06_add_generation(_Config) ->
     end,
     lists:foldl(Checker, [], lists:zip(StartTimes, MsgsList)).
 
+%% Verifies the basic usage of `list_generations_with_lifetimes' and `drop_generation'...
+%%   1) Cannot drop current generation.
+%%   2) All existing generations are returned by `list_generation_with_lifetimes'.
+%%   3) Dropping a generation removes it from the list.
+%%   4) Dropped generations stay dropped even after restarting the application.
+t_08_smoke_list_drop_generation(_Config) ->
+    DB = ?FUNCTION_NAME,
+    ?check_trace(
+        begin
+            ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+            %% Exactly one generation at first.
+            Generations0 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{_GenId, #{since := _, until := _}}],
+                maps:to_list(Generations0),
+                #{gens => Generations0}
+            ),
+            [{GenId0, _}] = maps:to_list(Generations0),
+            %% Cannot delete current generation
+            ?assertEqual({error, current_generation}, emqx_ds:drop_generation(DB, GenId0)),
+
+            %% New gen
+            ok = emqx_ds:add_generation(DB),
+            Generations1 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [
+                    {GenId0, #{since := _, until := _}},
+                    {_GenId1, #{since := _, until := _}}
+                ],
+                lists:sort(maps:to_list(Generations1)),
+                #{gens => Generations1}
+            ),
+            [GenId0, GenId1] = lists:sort(maps:keys(Generations1)),
+
+            %% Drop the older one
+            ?assertEqual(ok, emqx_ds:drop_generation(DB, GenId0)),
+            Generations2 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{GenId1, #{since := _, until := _}}],
+                lists:sort(maps:to_list(Generations2)),
+                #{gens => Generations2}
+            ),
+
+            %% Unknown gen_id, as it was already dropped
+            ?assertEqual({error, not_found}, emqx_ds:drop_generation(DB, GenId0)),
+
+            %% Should persist surviving generation list
+            ok = application:stop(emqx_durable_storage),
+            {ok, _} = application:ensure_all_started(emqx_durable_storage),
+            ok = emqx_ds:open_db(DB, opts()),
+
+            Generations3 = emqx_ds:list_generations_with_lifetimes(DB),
+            ?assertMatch(
+                [{GenId1, #{since := _, until := _}}],
+                lists:sort(maps:to_list(Generations3)),
+                #{gens => Generations3}
+            ),
+
+            ok
+        end,
+        []
+    ),
+    ok.
+
+t_drop_generation_with_never_used_iterator(_Config) ->
+    %% This test checks how the iterator behaves when:
+    %%   1) it's created at generation 1 and not consumed from.
+    %%   2) generation 2 is created and 1 dropped.
+    %%   3) iteration begins.
+    %% In this case, the iterator won't see any messages and the stream will end.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    Now = emqx_message:timestamp_now(),
+    Msgs1 = [
+        message(<<"foo/bar">>, <<"3">>, Now + 100),
+        message(<<"foo/baz">>, <<"4">>, Now + 101)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs1)),
+
+    ?assertMatch({ok, end_of_stream, []}, iterate(DB, Iter0, 1)),
+
+    %% New iterator for the new stream will only see the later messages.
+    [{_, Stream1}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    ?assertNotEqual(Stream0, Stream1),
+    {ok, Iter1} = emqx_ds:make_iterator(DB, Stream1, TopicFilter, StartTime),
+
+    {ok, Iter, Batch} = iterate(DB, Iter1, 1),
+    ?assertNotEqual(end_of_stream, Iter),
+    ?assertEqual(Msgs1, [Msg || {_Key, Msg} <- Batch]),
+
+    ok.
+
+t_drop_generation_with_used_once_iterator(_Config) ->
+    %% This test checks how the iterator behaves when:
+    %%   1) it's created at generation 1 and consumes at least 1 message.
+    %%   2) generation 2 is created and 1 dropped.
+    %%   3) iteration continues.
+    %% In this case, the iterator should see no more messages and the stream will end.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 =
+        [Msg0 | _] = [
+            message(<<"foo/bar">>, <<"1">>, 0),
+            message(<<"foo/baz">>, <<"2">>, 1)
+        ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+    {ok, Iter1, Batch1} = emqx_ds:next(DB, Iter0, 1),
+    ?assertNotEqual(end_of_stream, Iter1),
+    ?assertEqual([Msg0], [Msg || {_Key, Msg} <- Batch1]),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    Now = emqx_message:timestamp_now(),
+    Msgs1 = [
+        message(<<"foo/bar">>, <<"3">>, Now + 100),
+        message(<<"foo/baz">>, <<"4">>, Now + 101)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs1)),
+
+    ?assertMatch({ok, end_of_stream, []}, iterate(DB, Iter1, 1)),
+
+    ok.
+
+t_drop_generation_update_iterator(_Config) ->
+    %% This checks the behavior of `emqx_ds:update_iterator' after the generation
+    %% underlying the iterator has been dropped.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+    {ok, Iter0} = emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime),
+    {ok, Iter1, _Batch1} = emqx_ds:next(DB, Iter0, 1),
+    {ok, _Iter2, [{Key2, _Msg}]} = emqx_ds:next(DB, Iter1, 1),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    ?assertEqual({error, end_of_stream}, emqx_ds:update_iterator(DB, Iter1, Key2)),
+
+    ok.
+
+t_make_iterator_stale_stream(_Config) ->
+    %% This checks the behavior of `emqx_ds:make_iterator' after the generation underlying
+    %% the stream has been dropped.
+
+    DB = ?FUNCTION_NAME,
+    ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+    [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+
+    TopicFilter = emqx_topic:words(<<"foo/+">>),
+    StartTime = 0,
+    Msgs0 = [
+        message(<<"foo/bar">>, <<"1">>, 0),
+        message(<<"foo/baz">>, <<"2">>, 1)
+    ],
+    ?assertMatch(ok, emqx_ds:store_batch(DB, Msgs0)),
+
+    [{_, Stream0}] = emqx_ds:get_streams(DB, TopicFilter, StartTime),
+
+    ok = emqx_ds:add_generation(DB),
+    ok = emqx_ds:drop_generation(DB, GenId0),
+
+    ?assertEqual(
+        {error, end_of_stream},
+        emqx_ds:make_iterator(DB, Stream0, TopicFilter, StartTime)
+    ),
+
+    ok.
+
+t_get_streams_concurrently_with_drop_generation(_Config) ->
+    %% This checks that we can get all streams while a generation is dropped
+    %% mid-iteration.
+
+    DB = ?FUNCTION_NAME,
+    ?check_trace(
+        #{timetrap => 5_000},
+        begin
+            ?assertMatch(ok, emqx_ds:open_db(DB, opts())),
+
+            [GenId0] = maps:keys(emqx_ds:list_generations_with_lifetimes(DB)),
+            ok = emqx_ds:add_generation(DB),
+            ok = emqx_ds:add_generation(DB),
+
+            %% All streams
+            TopicFilter = emqx_topic:words(<<"foo/+">>),
+            StartTime = 0,
+            ?assertMatch([_, _, _], emqx_ds:get_streams(DB, TopicFilter, StartTime)),
+
+            ?force_ordering(
+                #{?snk_kind := dropped_gen},
+                #{?snk_kind := get_streams_get_gen}
+            ),
+
+            spawn_link(fun() ->
+                {ok, _} = ?block_until(#{?snk_kind := get_streams_all_gens}),
+                ok = emqx_ds:drop_generation(DB, GenId0),
+                ?tp(dropped_gen, #{})
+            end),
+
+            ?assertMatch([_, _], emqx_ds:get_streams(DB, TopicFilter, StartTime)),
+
+            ok
+        end,
+        []
+    ),
+
+    ok.
+
 update_data_set() ->
     [
         [
@@ -295,7 +539,7 @@ iterate(DB, It0, BatchSize, Acc) ->
         {ok, It, Msgs} ->
             iterate(DB, It, BatchSize, Acc ++ Msgs);
         {ok, end_of_stream} ->
-            {ok, It0, Acc};
+            {ok, end_of_stream, Acc};
         Ret ->
             Ret
     end.

From 7c0d37fdb978486b3bcfd07856011a26682a94a1 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 18 Jan 2024 14:28:13 -0300
Subject: [PATCH 045/273] feat(lts): inherit previous generation's lts when
 possible

---
 apps/emqx_durable_storage/src/emqx_ds_lts.erl | 11 ++++++-
 .../src/emqx_ds_storage_bitfield_lts.erl      | 30 ++++++++++++++++-
 .../emqx_ds_storage_bitfield_lts_SUITE.erl    | 33 +++++++++++++++++++
 3 files changed, 72 insertions(+), 2 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
index bcf95852d..9d87cf571 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
@@ -18,7 +18,12 @@
 
 %% API:
 -export([
-    trie_create/1, trie_create/0, trie_restore/2, topic_key/3, match_topics/2, lookup_topic_key/2
+    trie_create/1, trie_create/0,
+    trie_restore/2,
+    trie_restore_existing/2,
+    topic_key/3,
+    match_topics/2,
+    lookup_topic_key/2
 ]).
 
 %% Debug:
@@ -115,6 +120,10 @@ trie_create() ->
 -spec trie_restore(options(), [{_Key, _Val}]) -> trie().
 trie_restore(Options, Dump) ->
     Trie = trie_create(Options),
+    trie_restore_existing(Trie, Dump).
+
+-spec trie_restore_existing(trie(), [{_Key, _Val}]) -> trie().
+trie_restore_existing(Trie, Dump) ->
     lists:foreach(
         fun({{StateFrom, Token}, StateTo}) ->
             trie_insert(Trie, StateFrom, Token, StateTo)
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 27d41e6c6..2a3086a57 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -32,7 +32,8 @@
     get_streams/4,
     make_iterator/5,
     update_iterator/4,
-    next/4
+    next/4,
+    post_creation_actions/1
 ]).
 
 %% internal exports:
@@ -200,6 +201,22 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
         ts_offset = TSOffsetBits
     }.
 
+-spec post_creation_actions(emqx_ds_storage_layer:post_creation_context()) ->
+    s().
+post_creation_actions(
+    #{
+        db := DBHandle,
+        old_gen_id := OldGenId,
+        old_cf_refs := OldCFRefs,
+        new_gen_runtime_data := NewGenData0
+    }
+) ->
+    {_, OldTrieCF} = lists:keyfind(trie_cf(OldGenId), 1, OldCFRefs),
+    #s{trie = NewTrie0} = NewGenData0,
+    NewTrie = copy_previous_trie(DBHandle, NewTrie0, OldTrieCF),
+    ?tp(bitfield_lts_inherited_trie, #{}),
+    NewGenData0#s{trie = NewTrie}.
+
 -spec drop(
     emqx_ds_storage_layer:shard_id(),
     rocksdb:db_handle(),
@@ -516,6 +533,17 @@ restore_trie(TopicIndexBytes, DB, CF) ->
         rocksdb:iterator_close(IT)
     end.
 
+-spec copy_previous_trie(rocksdb:db_handle(), emqx_ds_lts:trie(), rocksdb:cf_handle()) ->
+    emqx_ds_lts:trie().
+copy_previous_trie(DBHandle, NewTrie, OldCF) ->
+    {ok, IT} = rocksdb:iterator(DBHandle, OldCF, []),
+    try
+        OldDump = read_persisted_trie(IT, rocksdb:iterator_move(IT, first)),
+        emqx_ds_lts:trie_restore_existing(NewTrie, OldDump)
+    after
+        rocksdb:iterator_close(IT)
+    end.
+
 read_persisted_trie(IT, {ok, KeyB, ValB}) ->
     [
         {binary_to_term(KeyB), binary_to_term(ValB)}
diff --git a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
index 03ff1a6cb..5d32143a7 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
@@ -131,6 +131,39 @@ t_get_streams(_Config) ->
     ?assert(lists:member(A, AllStreams)),
     ok.
 
+t_new_generation_inherit_trie(_Config) ->
+    %% This test checks that we inherit the previous generation's LTS when creating a new
+    %% generation.
+    ?check_trace(
+        begin
+            %% Create a bunch of topics to be learned in the first generation
+            Timestamps = lists:seq(1, 10_000, 100),
+            Batch = [
+                begin
+                    B = integer_to_binary(I),
+                    make_message(
+                        TS,
+                        <<"wildcard/", B/binary, "/suffix/", Suffix/binary>>,
+                        integer_to_binary(TS)
+                    )
+                end
+             || I <- lists:seq(1, 200),
+                TS <- Timestamps,
+                Suffix <- [<<"foo">>, <<"bar">>]
+            ],
+            ok = emqx_ds_storage_layer:store_batch(?SHARD, Batch, []),
+            %% Now we create a new generation with the same LTS module.  It should inherit the
+            %% learned trie.
+            ok = emqx_ds_storage_layer:add_generation(?SHARD),
+            ok
+        end,
+        fun(Trace) ->
+            ?assertMatch([_], ?of_kind(bitfield_lts_inherited_trie, Trace)),
+            ok
+        end
+    ),
+    ok.
+
 t_replay(_Config) ->
     %% Create concrete topics:
     Topics = [<<"foo/bar">>, <<"foo/bar/baz">>],

From d323fc7c2702fc2cc355affdcec2efcf1cbf2da4 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 18 Jan 2024 14:28:37 -0300
Subject: [PATCH 046/273] feat(ps): add message gc

---
 .../emqx_persistent_message_ds_gc_worker.erl  | 157 ++++++++++++++++++
 .../src/emqx_persistent_session_ds_sup.erl    |   5 +-
 apps/emqx/src/emqx_schema.erl                 |   8 +
 .../test/emqx_persistent_messages_SUITE.erl   |  87 +++++++++-
 changes/ce/feat-12338.en.md                   |   1 +
 rel/i18n/emqx_schema.hocon                    |   3 +
 6 files changed, 257 insertions(+), 4 deletions(-)
 create mode 100644 apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
 create mode 100644 changes/ce/feat-12338.en.md

diff --git a/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
new file mode 100644
index 000000000..b960eae9e
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_message_ds_gc_worker.erl
@@ -0,0 +1,157 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_persistent_message_ds_gc_worker).
+
+-behaviour(gen_server).
+
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("stdlib/include/qlc.hrl").
+-include_lib("stdlib/include/ms_transform.hrl").
+
+-include("emqx_persistent_session_ds.hrl").
+
+%% API
+-export([
+    start_link/0,
+    gc/0
+]).
+
+%% `gen_server' API
+-export([
+    init/1,
+    handle_call/3,
+    handle_cast/2,
+    handle_info/2
+]).
+
+%% call/cast/info records
+-record(gc, {}).
+
+%%--------------------------------------------------------------------------------
+%% API
+%%--------------------------------------------------------------------------------
+
+start_link() ->
+    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
+
+%% For testing or manual ops
+gc() ->
+    gen_server:call(?MODULE, #gc{}, infinity).
+
+%%--------------------------------------------------------------------------------
+%% `gen_server' API
+%%--------------------------------------------------------------------------------
+
+init(_Opts) ->
+    ensure_gc_timer(),
+    State = #{},
+    {ok, State}.
+
+handle_call(#gc{}, _From, State) ->
+    maybe_gc(),
+    {reply, ok, State};
+handle_call(_Call, _From, State) ->
+    {reply, error, State}.
+
+handle_cast(_Cast, State) ->
+    {noreply, State}.
+
+handle_info(#gc{}, State) ->
+    try_gc(),
+    ensure_gc_timer(),
+    {noreply, State};
+handle_info(_Info, State) ->
+    {noreply, State}.
+
+%%--------------------------------------------------------------------------------
+%% Internal fns
+%%--------------------------------------------------------------------------------
+
+ensure_gc_timer() ->
+    Timeout = emqx_config:get([session_persistence, message_retention_period]),
+    _ = erlang:send_after(Timeout, self(), #gc{}),
+    ok.
+
+try_gc() ->
+    %% Only cores should run GC.
+    CoreNodes = mria_membership:running_core_nodelist(),
+    Res = global:trans(
+        {?MODULE, self()},
+        fun maybe_gc/0,
+        CoreNodes,
+        %% Note: we set retries to 1 here because, in rare occasions, GC might start at the
+        %% same time in more than one node, and each one will abort the other.  By allowing
+        %% one retry, at least one node will (hopefully) get to enter the transaction and
+        %% the other will abort.  If GC runs too fast, both nodes might run in sequence.
+        %% But, in that case, GC is clearly not too costly, and that shouldn't be a problem,
+        %% resource-wise.
+        _Retries = 1
+    ),
+    case Res of
+        aborted ->
+            ?tp(ds_message_gc_lock_taken, #{}),
+            ok;
+        ok ->
+            ok
+    end.
+
+now_ms() ->
+    erlang:system_time(millisecond).
+
+maybe_gc() ->
+    AllGens = emqx_ds:list_generations_with_lifetimes(?PERSISTENT_MESSAGE_DB),
+    NowMS = now_ms(),
+    RetentionPeriod = emqx_config:get([session_persistence, message_retention_period]),
+    TimeThreshold = NowMS - RetentionPeriod,
+    maybe_create_new_generation(AllGens, TimeThreshold),
+    ?tp_span(
+        ps_message_gc,
+        #{},
+        begin
+            ExpiredGens =
+                maps:filter(
+                    fun(_GenId, #{until := Until}) ->
+                        is_number(Until) andalso Until =< TimeThreshold
+                    end,
+                    AllGens
+                ),
+            ExpiredGenIds = maps:keys(ExpiredGens),
+            lists:foreach(
+                fun(GenId) ->
+                    ok = emqx_ds:drop_generation(?PERSISTENT_MESSAGE_DB, GenId),
+                    ?tp(message_gc_generation_dropped, #{gen_id => GenId})
+                end,
+                ExpiredGenIds
+            )
+        end
+    ).
+
+maybe_create_new_generation(AllGens, TimeThreshold) ->
+    NeedNewGen =
+        lists:all(
+            fun({_GenId, #{created_at := CreatedAt}}) ->
+                CreatedAt =< TimeThreshold
+            end,
+            maps:to_list(AllGens)
+        ),
+    case NeedNewGen of
+        false ->
+            ?tp(ps_message_gc_too_early, #{}),
+            ok;
+        true ->
+            ok = emqx_ds:add_generation(?PERSISTENT_MESSAGE_DB),
+            ?tp(ps_message_gc_added_gen, #{})
+    end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_sup.erl b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
index 5bd620e8b..11e05be82 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_sup.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
@@ -48,13 +48,14 @@ init(Opts) ->
 
 do_init(_Opts) ->
     SupFlags = #{
-        strategy => rest_for_one,
+        strategy => one_for_one,
         intensity => 10,
         period => 2,
         auto_shutdown => never
     },
     CoreChildren = [
-        worker(gc_worker, emqx_persistent_session_ds_gc_worker, [])
+        worker(session_gc_worker, emqx_persistent_session_ds_gc_worker, []),
+        worker(message_gc_worker, emqx_persistent_message_ds_gc_worker, [])
     ],
     Children =
         case mria_rlog:role() of
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index 7cd67089d..56d575bd9 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1855,6 +1855,14 @@ fields("session_persistence") ->
                     desc => ?DESC(session_ds_session_gc_batch_size)
                 }
             )},
+        {"message_retention_period",
+            sc(
+                timeout_duration(),
+                #{
+                    default => <<"1d">>,
+                    desc => ?DESC(session_ds_message_retention_period)
+                }
+            )},
         {"force_persistence",
             sc(
                 boolean(),
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index f25f38098..c46d726f4 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -19,6 +19,7 @@
 -include_lib("stdlib/include/assert.hrl").
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("emqx/include/emqx.hrl").
 -include_lib("emqx/include/emqx_mqtt.hrl").
 
 -compile(export_all).
@@ -45,10 +46,20 @@ init_per_testcase(t_session_subscription_iterators = TestCase, Config) ->
     Cluster = cluster(),
     Nodes = emqx_cth_cluster:start(Cluster, #{work_dir => emqx_cth_suite:work_dir(TestCase, Config)}),
     [{nodes, Nodes} | Config];
+init_per_testcase(t_message_gc = TestCase, Config) ->
+    Opts = #{
+        extra_emqx_conf =>
+            "\n  session_persistence.message_retention_period = 1s"
+            "\n  session_persistence.storage.builtin.n_shards = 3"
+    },
+    common_init_per_testcase(TestCase, [{n_shards, 3} | Config], Opts);
 init_per_testcase(TestCase, Config) ->
+    common_init_per_testcase(TestCase, Config, _Opts = #{}).
+
+common_init_per_testcase(TestCase, Config, Opts) ->
     ok = emqx_ds:drop_db(?PERSISTENT_MESSAGE_DB),
     Apps = emqx_cth_suite:start(
-        app_specs(),
+        app_specs(Opts),
         #{work_dir => emqx_cth_suite:work_dir(TestCase, Config)}
     ),
     [{apps, Apps} | Config].
@@ -379,6 +390,66 @@ t_publish_empty_topic_levels(_Config) ->
         emqtt:stop(Pub)
     end.
 
+t_message_gc_too_young(_Config) ->
+    %% Check that GC doesn't attempt to create a new generation if there are fresh enough
+    %% generations around.  The stability of this test relies on the default value for
+    %% message retention being long enough.  Currently, the default is 1 hour.
+    ?check_trace(
+        ok = emqx_persistent_message_ds_gc_worker:gc(),
+        fun(Trace) ->
+            ?assertMatch([_], ?of_kind(ps_message_gc_too_early, Trace)),
+            ok
+        end
+    ),
+    ok.
+
+t_message_gc(Config) ->
+    %% Check that, after GC runs, a new generation is created, retaining messages, and
+    %% older messages no longer are accessible.
+    NShards = ?config(n_shards, Config),
+    ?check_trace(
+        #{timetrap => 10_000},
+        begin
+            %% ensure some messages are in the first generation
+            ?force_ordering(
+                #{?snk_kind := inserted_batch},
+                #{?snk_kind := ps_message_gc_added_gen}
+            ),
+            Msgs0 = [
+                message(<<"foo/bar">>, <<"1">>, 0),
+                message(<<"foo/baz">>, <<"2">>, 1)
+            ],
+            ok = emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, Msgs0),
+            ?tp(inserted_batch, #{}),
+            {ok, _} = ?block_until(#{?snk_kind := ps_message_gc_added_gen}),
+
+            Now = emqx_message:timestamp_now(),
+            Msgs1 = [
+                message(<<"foo/bar">>, <<"3">>, Now + 100),
+                message(<<"foo/baz">>, <<"4">>, Now + 101)
+            ],
+            ok = emqx_ds:store_batch(?PERSISTENT_MESSAGE_DB, Msgs1),
+
+            {ok, _} = snabbkaffe:block_until(
+                ?match_n_events(NShards, #{?snk_kind := message_gc_generation_dropped}),
+                infinity
+            ),
+
+            TopicFilter = emqx_topic:words(<<"#">>),
+            StartTime = 0,
+            Msgs = consume(TopicFilter, StartTime),
+            %% only "1" and "2" should have been GC'ed
+            ?assertEqual(
+                sets:from_list([<<"3">>, <<"4">>], [{version, 2}]),
+                sets:from_list([emqx_message:payload(Msg) || Msg <- Msgs], [{version, 2}])
+            ),
+
+            ok
+        end,
+        []
+    ),
+    ok.
+
 %%
 
 connect(ClientId, CleanStart, EI) ->
@@ -438,9 +509,13 @@ publish(Node, Message) ->
     erpc:call(Node, emqx, publish, [Message]).
 
 app_specs() ->
+    app_specs(_Opts = #{}).
+
+app_specs(Opts) ->
+    ExtraEMQXConf = maps:get(extra_emqx_conf, Opts, ""),
     [
         emqx_durable_storage,
-        {emqx, "session_persistence {enable = true}"}
+        {emqx, "session_persistence {enable = true}" ++ ExtraEMQXConf}
     ].
 
 cluster() ->
@@ -459,3 +534,11 @@ clear_db() ->
     mria:stop(),
     ok = mnesia:delete_schema([node()]),
     ok.
+
+message(Topic, Payload, PublishedAt) ->
+    #message{
+        topic = Topic,
+        payload = Payload,
+        timestamp = PublishedAt,
+        id = emqx_guid:gen()
+    }.
diff --git a/changes/ce/feat-12338.en.md b/changes/ce/feat-12338.en.md
new file mode 100644
index 000000000..8b8edcb76
--- /dev/null
+++ b/changes/ce/feat-12338.en.md
@@ -0,0 +1 @@
+Added time-based message garbage collection to the RocksDB-based persistent session backend.
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index af4251328..be16c765e 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1608,5 +1608,8 @@ The session will query the DB for the new messages when the value of `FreeSpace`
 
 `FreeSpace` is calculated as `ReceiveMaximum` for the session - number of inflight messages."""
 
+session_ds_message_retention_period.desc:
+"""The minimum amount of time that messages should be retained for.  After messages have been in storage for at least this period of time, they'll be dropped."""
+
 
 }

From 878c9ee8b14fb0facfeb52275ad55a457f455a4e Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 22 Jan 2024 13:10:44 -0300
Subject: [PATCH 047/273] fix(ds): do not count persistent session-only routed
 messages as dropped

Fixes https://emqx.atlassian.net/browse/EMQX-11539
---
 apps/emqx/src/emqx_broker.erl                 | 12 ++++---
 .../test/emqx_persistent_messages_SUITE.erl   | 31 +++++++++++++++++++
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/apps/emqx/src/emqx_broker.erl b/apps/emqx/src/emqx_broker.erl
index ac9116cbd..6dc893043 100644
--- a/apps/emqx/src/emqx_broker.erl
+++ b/apps/emqx/src/emqx_broker.erl
@@ -249,7 +249,7 @@ publish(Msg) when is_record(Msg, message) ->
             [];
         Msg1 = #message{topic = Topic} ->
             PersistRes = persist_publish(Msg1),
-            PersistRes ++ route(aggre(emqx_router:match_routes(Topic)), delivery(Msg1))
+            route(aggre(emqx_router:match_routes(Topic)), delivery(Msg1), PersistRes)
     end.
 
 persist_publish(Msg) ->
@@ -289,18 +289,20 @@ delivery(Msg) -> #delivery{sender = self(), message = Msg}.
 %% Route
 %%--------------------------------------------------------------------
 
--spec route([emqx_types:route_entry()], emqx_types:delivery()) ->
+-spec route([emqx_types:route_entry()], emqx_types:delivery(), nil() | [persisted]) ->
     emqx_types:publish_result().
-route([], #delivery{message = Msg}) ->
+route([], #delivery{message = Msg}, _PersistRes = []) ->
     ok = emqx_hooks:run('message.dropped', [Msg, #{node => node()}, no_subscribers]),
     ok = inc_dropped_cnt(Msg),
     [];
-route(Routes, Delivery) ->
+route([], _Delivery, PersistRes = [_ | _]) ->
+    PersistRes;
+route(Routes, Delivery, PersistRes) ->
     lists:foldl(
         fun(Route, Acc) ->
             [do_route(Route, Delivery) | Acc]
         end,
-        [],
+        PersistRes,
         Routes
     ).
 
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index c46d726f4..73c88adc8 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -450,6 +450,32 @@ t_message_gc(Config) ->
     ),
     ok.
 
+t_metrics_not_dropped(_Config) ->
+    %% Asserts that, if only persisted sessions are subscribed to a topic being published
+    %% to, we don't bump the `message.dropped' metric, nor we run the equivalent hook.
+    Sub = connect(<<?MODULE_STRING "1">>, true, 30),
+    on_exit(fun() -> emqtt:stop(Sub) end),
+    Pub = connect(<<?MODULE_STRING "2">>, true, 30),
+    on_exit(fun() -> emqtt:stop(Pub) end),
+    Hookpoint = 'message.dropped',
+    emqx_hooks:add(Hookpoint, {?MODULE, on_message_dropped, [self()]}, 1_000),
+    on_exit(fun() -> emqx_hooks:del(Hookpoint, {?MODULE, on_message_dropped}) end),
+
+    DroppedBefore = emqx_metrics:val('messages.dropped'),
+    DroppedNoSubBefore = emqx_metrics:val('messages.dropped.no_subscribers'),
+
+    {ok, _, [?RC_GRANTED_QOS_1]} = emqtt:subscribe(Sub, <<"t/+">>, ?QOS_1),
+    emqtt:publish(Pub, <<"t/ps">>, <<"payload">>, ?QOS_1),
+    ?assertMatch([_], receive_messages(1, 1_500)),
+
+    DroppedAfter = emqx_metrics:val('messages.dropped'),
+    DroppedNoSubAfter = emqx_metrics:val('messages.dropped.no_subscribers'),
+
+    ?assertEqual(DroppedBefore, DroppedAfter),
+    ?assertEqual(DroppedNoSubBefore, DroppedNoSubAfter),
+
+    ok.
+
 %%
 
 connect(ClientId, CleanStart, EI) ->
@@ -542,3 +568,8 @@ message(Topic, Payload, PublishedAt) ->
         timestamp = PublishedAt,
         id = emqx_guid:gen()
     }.
+
+on_message_dropped(Msg, Context, Res, TestPid) ->
+    ErrCtx = #{msg => Msg, ctx => Context, res => Res},
+    ct:pal("this hook should not be called.\n  ~p", [ErrCtx]),
+    exit(TestPid, {hookpoint_called, ErrCtx}).

From dad8a32e0bee2712a837efeb2557fbc28e69fb7d Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Mon, 22 Jan 2024 20:45:10 +0800
Subject: [PATCH 048/273] feat(opents): improve the OpentsDB bridge to v2 style

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   3 +-
 .../src/emqx_bridge_opents.erl                | 128 ++++-
 .../src/emqx_bridge_opents_action_info.erl    |  71 +++
 .../src/emqx_bridge_opents_connector.erl      | 194 ++++++-
 .../test/emqx_bridge_opents_SUITE.erl         | 484 +++++++-----------
 .../src/schema/emqx_connector_ee_schema.erl   |  18 +-
 .../src/schema/emqx_connector_schema.erl      |   4 +-
 rel/i18n/emqx_bridge_opents.hocon             |  31 ++
 rel/i18n/emqx_bridge_opents_connector.hocon   |   6 +
 9 files changed, 607 insertions(+), 332 deletions(-)
 create mode 100644 apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index d80050191..4f6228998 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -98,7 +98,8 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_timescale_action_info,
         emqx_bridge_redis_action_info,
         emqx_bridge_iotdb_action_info,
-        emqx_bridge_es_action_info
+        emqx_bridge_es_action_info,
+        emqx_bridge_opents_action_info
     ].
 -else.
 hard_coded_action_info_modules_ee() ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index cfb12453d..7e490576f 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_bridge_opents).
 
@@ -7,10 +7,12 @@
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 
--import(hoconsc, [mk/2, enum/1, ref/2]).
+-import(hoconsc, [mk/2, enum/1, ref/2, array/1]).
 
 -export([
-    conn_bridge_examples/1
+    conn_bridge_examples/1,
+    bridge_v2_examples/1,
+    default_data_template/0
 ]).
 
 -export([
@@ -20,8 +22,11 @@
     desc/1
 ]).
 
+-define(CONNECTOR_TYPE, opents).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
+
 %% -------------------------------------------------------------------------------------------------
-%% api
+%% v1 examples
 conn_bridge_examples(Method) ->
     [
         #{
@@ -34,7 +39,7 @@ conn_bridge_examples(Method) ->
 
 values(_Method) ->
     #{
-        enable => true,
+        enabledb => true,
         type => opents,
         name => <<"foo">>,
         server => <<"http://127.0.0.1:4242">>,
@@ -50,7 +55,37 @@ values(_Method) ->
     }.
 
 %% -------------------------------------------------------------------------------------------------
-%% Hocon Schema Definitions
+%% v2 examples
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"opents">> => #{
+                summary => <<"OpenTSDB Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                )
+            }
+        }
+    ].
+
+action_values() ->
+    #{
+        parameters => #{
+            data => default_data_template()
+        }
+    }.
+
+default_data_template() ->
+    [
+        #{
+            metric => <<"${metric}">>,
+            tags => <<"${tags}">>,
+            value => <<"${value}">>
+        }
+    ].
+
+%% -------------------------------------------------------------------------------------------------
+%% V1 Schema Definitions
 namespace() -> "bridge_opents".
 
 roots() -> [].
@@ -65,10 +100,89 @@ fields("post") ->
 fields("put") ->
     fields("config");
 fields("get") ->
-    emqx_bridge_schema:status_fields() ++ fields("post").
+    emqx_bridge_schema:status_fields() ++ fields("post");
+%% -------------------------------------------------------------------------------------------------
+%% V2 Schema Definitions
+
+fields(action) ->
+    {opents,
+        mk(
+            hoconsc:map(name, ref(?MODULE, action_config)),
+            #{
+                desc => <<"OpenTSDB Action Config">>,
+                required => false
+            }
+        )};
+fields(action_config) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(
+            ref(?MODULE, action_parameters),
+            #{
+                required => true, desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    [
+        {data,
+            mk(
+                array(ref(?MODULE, action_parameters_data)),
+                #{
+                    desc => ?DESC("action_parameters_data"),
+                    default => <<"[]">>
+                }
+            )}
+    ];
+fields(action_parameters_data) ->
+    [
+        {timestamp,
+            mk(
+                binary(),
+                #{
+                    desc => ?DESC("config_parameters_timestamp"),
+                    required => false
+                }
+            )},
+        {metric,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_metric")
+                }
+            )},
+        {tags,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_tags")
+                }
+            )},
+        {value,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("config_parameters_value")
+                }
+            )}
+    ];
+fields("post_bridge_v2") ->
+    emqx_bridge_schema:type_and_name_fields(enum([opents])) ++ fields(action_config);
+fields("put_bridge_v2") ->
+    fields(action_config);
+fields("get_bridge_v2") ->
+    emqx_bridge_schema:status_fields() ++ fields("post_bridge_v2").
 
 desc("config") ->
     ?DESC("desc_config");
+desc(action_config) ->
+    ?DESC("desc_config");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(action_parameters_data) ->
+    ?DESC("action_parameters_data");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for OpenTSDB using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl
new file mode 100644
index 000000000..4c4c9568c
--- /dev/null
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_action_info.erl
@@ -0,0 +1,71 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_opents_action_info).
+
+-behaviour(emqx_action_info).
+
+-elvis([{elvis_style, invalid_dynamic_call, disable}]).
+
+%% behaviour callbacks
+-export([
+    action_type_name/0,
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_type_name/0,
+    connector_action_config_to_bridge_v1_config/2,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(ACTION_TYPE, opents).
+-define(SCHEMA_MODULE, emqx_bridge_opents).
+
+action_type_name() -> ?ACTION_TYPE.
+bridge_v1_type_name() -> ?ACTION_TYPE.
+connector_type_name() -> ?ACTION_TYPE.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
+    MergedConfig =
+        emqx_utils_maps:deep_merge(
+            maps:without(
+                [<<"description">>, <<"local_topic">>, <<"connector">>, <<"data">>],
+                emqx_utils_maps:unindent(<<"parameters">>, ActionConfig)
+            ),
+            ConnectorConfig
+        ),
+    BridgeV1Keys = schema_keys("config"),
+    maps:with(BridgeV1Keys, MergedConfig).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(action_config),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ConnectorKeys = schema_keys(emqx_bridge_opents_connector, "config_connector"),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        maps:with(ConnectorKeys, BridgeV1Config)
+    ).
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config#{<<"data">> => []}),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    schema_keys(?SCHEMA_MODULE, Name).
+
+schema_keys(Mod, Name) ->
+    [bin(Key) || Key <- proplists:get_keys(Mod:fields(Name))].
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index 9271abe15..6af1e2f55 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_opents_connector).
@@ -12,7 +12,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([roots/0, fields/1]).
+-export([namespace/0, roots/0, fields/1, desc/1]).
 
 %% `emqx_resource' API
 -export([
@@ -21,15 +21,25 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
+-export([connector_examples/1]).
+
 -export([connect/1]).
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
 
+-define(CONNECTOR_TYPE, opents).
+
+namespace() -> "opents_connector".
+
 %%=====================================================================
-%% Hocon schema
+%% V1 Hocon schema
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
@@ -40,8 +50,56 @@ fields(config) ->
         {summary, mk(boolean(), #{default => true, desc => ?DESC("summary")})},
         {details, mk(boolean(), #{default => false, desc => ?DESC("details")})},
         {auto_reconnect, fun emqx_connector_schema_lib:auto_reconnect/1}
+    ];
+%%=====================================================================
+%% V2 Hocon schema
+
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        proplists_without([auto_reconnect], fields(config));
+fields("post") ->
+    emqx_connector_schema:type_and_name_fields(enum([opents])) ++ fields("config_connector");
+fields("put") ->
+    fields("config_connector");
+fields("get") ->
+    emqx_bridge_schema:status_fields() ++ fields("post").
+
+desc(config) ->
+    ?DESC("desc_config");
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
+    ["Configuration for IoTDB using `", string:to_upper(Method), "` method."];
+desc(_) ->
+    undefined.
+
+proplists_without(Keys, List) ->
+    [El || El = {K, _} <- List, not lists:member(K, Keys)].
+
+%%=====================================================================
+%% V2 examples
+connector_examples(Method) ->
+    [
+        #{
+            <<"opents">> =>
+                #{
+                    summary => <<"OpenTSDB Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_example_values()
+                    )
+                }
+        }
     ].
 
+connector_example_values() ->
+    #{
+        name => <<"opents_connector">>,
+        type => opents,
+        enable => true,
+        server => <<"http://localhost:4242/">>,
+        pool_size => 8
+    }.
+
 %%========================================================================================
 %% `emqx_resource' API
 %%========================================================================================
@@ -56,8 +114,7 @@ on_start(
         server := Server,
         pool_size := PoolSize,
         summary := Summary,
-        details := Details,
-        resource_opts := #{batch_size := BatchSize}
+        details := Details
     } = Config
 ) ->
     ?SLOG(info, #{
@@ -70,11 +127,10 @@ on_start(
         {server, to_str(Server)},
         {summary, Summary},
         {details, Details},
-        {max_batch_size, BatchSize},
         {pool_size, PoolSize}
     ],
 
-    State = #{pool_name => InstanceId, server => Server},
+    State = #{pool_name => InstanceId, server => Server, channels => #{}},
     case opentsdb_connectivity(Server) of
         ok ->
             case emqx_resource_pool:start(InstanceId, ?MODULE, Options) of
@@ -93,6 +149,7 @@ on_stop(InstanceId, _State) ->
         msg => "stopping_opents_connector",
         connector => InstanceId
     }),
+    ?tp(opents_bridge_stopped, #{instance_id => InstanceId}),
     emqx_resource_pool:stop(InstanceId).
 
 on_query(InstanceId, Request, State) ->
@@ -101,10 +158,14 @@ on_query(InstanceId, Request, State) ->
 on_batch_query(
     InstanceId,
     BatchReq,
-    State
+    #{channels := Channels} = State
 ) ->
-    Datas = [format_opentsdb_msg(Msg) || {_Key, Msg} <- BatchReq],
-    do_query(InstanceId, Datas, State).
+    case try_render_messages(BatchReq, Channels) of
+        {ok, Datas} ->
+            do_query(InstanceId, Datas, State);
+        Error ->
+            Error
+    end.
 
 on_get_status(_InstanceId, #{server := Server}) ->
     Result =
@@ -117,6 +178,39 @@ on_get_status(_InstanceId, #{server := Server}) ->
         end,
     Result.
 
+on_add_channel(
+    _InstanceId,
+    #{channels := Channels} = OldState,
+    ChannelId,
+    #{
+        parameters := #{data := Data} = Parameter
+    }
+) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            {error, already_exists};
+        _ ->
+            Channel = Parameter#{
+                data := preproc_data_template(Data)
+            },
+            Channels2 = Channels#{ChannelId => Channel},
+            {ok, OldState#{channels := Channels2}}
+    end.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = OldState, ChannelId) ->
+    {ok, OldState#{channels => maps:remove(ChannelId, Channels)}}.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
+on_get_channel_status(InstanceId, ChannelId, #{channels := Channels} = State) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            on_get_status(InstanceId, State);
+        _ ->
+            {error, not_exists}
+    end.
+
 %%========================================================================================
 %% Helper fns
 %%========================================================================================
@@ -127,6 +221,9 @@ do_query(InstanceId, Query, #{pool_name := PoolName} = State) ->
         "opents_connector_received",
         #{connector => InstanceId, query => Query, state => State}
     ),
+
+    ?tp(opents_bridge_on_query, #{instance_id => InstanceId}),
+
     Result = ecpool:pick_and_do(PoolName, {opentsdb, put, [Query]}, no_handover),
 
     case Result of
@@ -172,17 +269,66 @@ opentsdb_connectivity(Server) ->
         end,
     emqx_connector_lib:http_connectivity(SvrUrl, ?HTTP_CONNECT_TIMEOUT).
 
-format_opentsdb_msg(Msg) ->
-    maps:with(
-        [
-            timestamp,
-            metric,
-            tags,
-            value,
-            <<"timestamp">>,
-            <<"metric">>,
-            <<"tags">>,
-            <<"value">>
-        ],
-        Msg
+try_render_messages([{ChannelId, _} | _] = BatchReq, Channels) ->
+    case maps:find(ChannelId, Channels) of
+        {ok, Channel} ->
+            {ok,
+                lists:foldl(
+                    fun({_, Message}, Acc) ->
+                        render_channel_message(Message, Channel, Acc)
+                    end,
+                    [],
+                    BatchReq
+                )};
+        _ ->
+            {error, {unrecoverable_error, {invalid_channel_id, ChannelId}}}
+    end.
+
+render_channel_message(Msg, #{data := DataList}, Acc) ->
+    RawOpts = #{return => rawlist, var_trans => fun(X) -> X end},
+    lists:foldl(
+        fun(#{metric := MetricTk, tags := TagsTk, value := ValueTk} = Data, InAcc) ->
+            MetricVal = emqx_placeholder:proc_tmpl(MetricTk, Msg),
+            TagsVal =
+                case emqx_placeholder:proc_tmpl(TagsTk, Msg, RawOpts) of
+                    [undefined] ->
+                        #{};
+                    [Any] ->
+                        Any
+                end,
+            ValueVal =
+                case ValueTk of
+                    [_] ->
+                        erlang:hd(emqx_placeholder:proc_tmpl(ValueTk, Msg, RawOpts));
+                    _ ->
+                        emqx_placeholder:proc_tmpl(ValueTk, Msg)
+                end,
+            Base = #{metric => MetricVal, tags => TagsVal, value => ValueVal},
+            [
+                case maps:get(timestamp, Data, undefined) of
+                    undefined ->
+                        Base;
+                    TimestampTk ->
+                        Base#{timestamp => emqx_placeholder:proc_tmpl(TimestampTk, Msg)}
+                end
+                | InAcc
+            ]
+        end,
+        Acc,
+        DataList
+    ).
+
+preproc_data_template([]) ->
+    preproc_data_template(emqx_bridge_opents:default_data_template());
+preproc_data_template(DataList) ->
+    lists:map(
+        fun(Data) ->
+            maps:map(
+                fun(_Key, Value) ->
+                    emqx_placeholder:preproc_tmpl(Value)
+                end,
+                Data
+            )
+        end,
+        DataList
     ).
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index 3632ce786..f86ae6986 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_opents_SUITE).
@@ -12,7 +12,8 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 % DB defaults
--define(BATCH_SIZE, 10).
+-define(BRIDGE_TYPE_BIN, <<"opents">>).
+-define(APPS, [opentsdb, emqx_bridge, emqx_resource, emqx_rule_engine, emqx_bridge_opents_SUITE]).
 
 %%------------------------------------------------------------------------------
 %% CT boilerplate
@@ -20,95 +21,34 @@
 
 all() ->
     [
-        {group, with_batch},
-        {group, without_batch}
+        {group, default}
     ].
 
 groups() ->
-    TCs = emqx_common_test_helpers:all(?MODULE),
+    AllTCs = emqx_common_test_helpers:all(?MODULE),
     [
-        {with_batch, TCs},
-        {without_batch, TCs}
+        {default, AllTCs}
     ].
 
-init_per_group(with_batch, Config0) ->
-    Config = [{batch_size, ?BATCH_SIZE} | Config0],
-    common_init(Config);
-init_per_group(without_batch, Config0) ->
-    Config = [{batch_size, 1} | Config0],
-    common_init(Config);
-init_per_group(_Group, Config) ->
-    Config.
-
-end_per_group(Group, Config) when Group =:= with_batch; Group =:= without_batch ->
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-    ok;
-end_per_group(_Group, _Config) ->
-    ok.
-
 init_per_suite(Config) ->
-    Config.
+    emqx_bridge_v2_testlib:init_per_suite(Config, ?APPS).
 
-end_per_suite(_Config) ->
-    emqx_mgmt_api_test_util:end_suite(),
-    ok = emqx_common_test_helpers:stop_apps([opentsdb, emqx_bridge, emqx_resource, emqx_conf]),
-    ok.
+end_per_suite(Config) ->
+    emqx_bridge_v2_testlib:end_per_suite(Config).
 
-init_per_testcase(_Testcase, Config) ->
-    delete_bridge(Config),
-    snabbkaffe:start_trace(),
-    Config.
-
-end_per_testcase(_Testcase, Config) ->
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-    ok = snabbkaffe:stop(),
-    delete_bridge(Config),
-    ok.
-
-%%------------------------------------------------------------------------------
-%% Helper fns
-%%------------------------------------------------------------------------------
-
-common_init(ConfigT) ->
-    Host = os:getenv("OPENTS_HOST", "toxiproxy"),
+init_per_group(default, Config0) ->
+    Host = os:getenv("OPENTS_HOST", "toxiproxy.emqx.net"),
     Port = list_to_integer(os:getenv("OPENTS_PORT", "4242")),
-
-    Config0 = [
-        {opents_host, Host},
-        {opents_port, Port},
-        {proxy_name, "opents"}
-        | ConfigT
-    ],
-
-    BridgeType = proplists:get_value(bridge_type, Config0, <<"opents">>),
+    ProxyName = "opents",
     case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
-            % Setup toxiproxy
-            ProxyHost = os:getenv("PROXY_HOST", "toxiproxy"),
-            ProxyPort = list_to_integer(os:getenv("PROXY_PORT", "8474")),
-            emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-            % Ensure enterprise bridge module is loaded
-            ok = emqx_common_test_helpers:start_apps([
-                emqx_conf, emqx_resource, emqx_bridge
-            ]),
-            _ = application:ensure_all_started(opentsdb),
-            _ = emqx_bridge_enterprise:module_info(),
-            emqx_mgmt_api_test_util:init_suite(),
-            {Name, OpenTSConf} = opents_config(BridgeType, Config0),
-            Config =
-                [
-                    {opents_config, OpenTSConf},
-                    {opents_bridge_type, BridgeType},
-                    {opents_name, Name},
-                    {proxy_host, ProxyHost},
-                    {proxy_port, ProxyPort}
-                    | Config0
-                ],
-            Config;
+            Config = emqx_bridge_v2_testlib:init_per_group(default, ?BRIDGE_TYPE_BIN, Config0),
+            [
+                {bridge_host, Host},
+                {bridge_port, Port},
+                {proxy_name, ProxyName}
+                | Config
+            ];
         false ->
             case os:getenv("IS_CI") of
                 "yes" ->
@@ -116,244 +56,152 @@ common_init(ConfigT) ->
                 _ ->
                     {skip, no_opents}
             end
-    end.
-
-opents_config(BridgeType, Config) ->
-    Port = integer_to_list(?config(opents_port, Config)),
-    Server = "http://" ++ ?config(opents_host, Config) ++ ":" ++ Port,
-    Name = atom_to_binary(?MODULE),
-    BatchSize = ?config(batch_size, Config),
-    ConfigString =
-        io_lib:format(
-            "bridges.~s.~s {\n"
-            "  enable = true\n"
-            "  server = ~p\n"
-            "  resource_opts = {\n"
-            "    request_ttl = 500ms\n"
-            "    batch_size = ~b\n"
-            "    query_mode = sync\n"
-            "  }\n"
-            "}",
-            [
-                BridgeType,
-                Name,
-                Server,
-                BatchSize
-            ]
-        ),
-    {Name, parse_and_check(ConfigString, BridgeType, Name)}.
-
-parse_and_check(ConfigString, BridgeType, Name) ->
-    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
-    hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
-    #{<<"bridges">> := #{BridgeType := #{Name := Config}}} = RawConf,
+    end;
+init_per_group(_Group, Config) ->
     Config.
 
-create_bridge(Config) ->
-    create_bridge(Config, _Overrides = #{}).
+end_per_group(default, Config) ->
+    emqx_bridge_v2_testlib:end_per_group(Config),
+    ok;
+end_per_group(_Group, _Config) ->
+    ok.
 
-create_bridge(Config, Overrides) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    Config0 = ?config(opents_config, Config),
-    Config1 = emqx_utils_maps:deep_merge(Config0, Overrides),
-    emqx_bridge:create(BridgeType, Name, Config1).
+init_per_testcase(TestCase, Config0) ->
+    Type = ?config(bridge_type, Config0),
+    UniqueNum = integer_to_binary(erlang:unique_integer()),
+    Name = <<
+        (atom_to_binary(TestCase))/binary, UniqueNum/binary
+    >>,
+    {_ConfigString, ConnectorConfig} = connector_config(Name, Config0),
+    {_, ActionConfig} = action_config(Name, Config0),
+    Config = [
+        {connector_type, Type},
+        {connector_name, Name},
+        {connector_config, ConnectorConfig},
+        {bridge_type, Type},
+        {bridge_name, Name},
+        {bridge_config, ActionConfig}
+        | Config0
+    ],
+    %%    iotdb_reset(Config),
+    ok = snabbkaffe:start_trace(),
+    Config.
 
-delete_bridge(Config) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    emqx_bridge:remove(BridgeType, Name).
-
-create_bridge_http(Params) ->
-    Path = emqx_mgmt_api_test_util:api_path(["bridges"]),
-    AuthHeader = emqx_mgmt_api_test_util:auth_header_(),
-    case emqx_mgmt_api_test_util:request_api(post, Path, "", AuthHeader, Params) of
-        {ok, Res} -> {ok, emqx_utils_json:decode(Res, [return_maps])};
-        Error -> Error
-    end.
-
-send_message(Config, Payload) ->
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    BridgeID = emqx_bridge_resource:bridge_id(BridgeType, Name),
-    emqx_bridge:send_message(BridgeID, Payload).
-
-query_resource(Config, Request) ->
-    query_resource(Config, Request, 1_000).
-
-query_resource(Config, Request, Timeout) ->
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => Timeout}).
+end_per_testcase(TestCase, Config) ->
+    emqx_bridge_v2_testlib:end_per_testcase(TestCase, Config).
 
 %%------------------------------------------------------------------------------
-%% Testcases
+%% Helper fns
 %%------------------------------------------------------------------------------
 
-t_setup_via_config_and_publish(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    SentData = make_data(),
-    ?check_trace(
-        begin
-            {_, {ok, #{result := Result}}} =
-                ?wait_async_action(
-                    send_message(Config, SentData),
-                    #{?snk_kind := buffer_worker_flush_ack},
-                    2_000
-                ),
-            ?assertMatch(
-                {ok, 200, #{failed := 0, success := 1}}, Result
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(opents_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, 200, #{failed := 0, success := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
+action_config(Name, Config) ->
+    Type = ?config(bridge_type, Config),
+    ConfigString =
+        io_lib:format(
+            "actions.~s.~s {\n"
+            "  enable = true\n"
+            "  connector = \"~s\"\n"
+            "  parameters = {\n"
+            "     data = []\n"
+            "  }\n"
+            "}\n",
+            [
+                Type,
+                Name,
+                Name
+            ]
+        ),
+    ct:pal("ActionConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_action_and_check(ConfigString, Type, Name)}.
 
-t_setup_via_http_api_and_publish(Config) ->
-    BridgeType = ?config(opents_bridge_type, Config),
-    Name = ?config(opents_name, Config),
-    OpentsConfig0 = ?config(opents_config, Config),
-    OpentsConfig = OpentsConfig0#{
-        <<"name">> => Name,
-        <<"type">> => BridgeType
-    },
-    ?assertMatch(
-        {ok, _},
-        create_bridge_http(OpentsConfig)
-    ),
-    SentData = make_data(),
-    ?check_trace(
-        begin
-            Request = {send_message, SentData},
-            Res0 = query_resource(Config, Request, 2_500),
-            ?assertMatch(
-                {ok, 200, #{failed := 0, success := 1}}, Res0
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(opents_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, 200, #{failed := 0, success := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
+connector_config(Name, Config) ->
+    Host = ?config(bridge_host, Config),
+    Port = ?config(bridge_port, Config),
+    Type = ?config(bridge_type, Config),
+    ServerURL = opents_server_url(Host, Port),
+    ConfigString =
+        io_lib:format(
+            "connectors.~s.~s {\n"
+            "  enable = true\n"
+            "  server = \"~s\"\n"
+            "}\n",
+            [
+                Type,
+                Name,
+                ServerURL
+            ]
+        ),
+    ct:pal("ConnectorConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_connector_and_check(ConfigString, Type, Name)}.
 
-t_get_status(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
+parse_action_and_check(ConfigString, BridgeType, Name) ->
+    parse_and_check(ConfigString, emqx_bridge_schema, <<"actions">>, BridgeType, Name).
 
-    Name = ?config(opents_name, Config),
-    BridgeType = ?config(opents_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
+parse_connector_and_check(ConfigString, ConnectorType, Name) ->
+    parse_and_check(
+        ConfigString, emqx_connector_schema, <<"connectors">>, ConnectorType, Name
+    ).
+%%    emqx_utils_maps:safe_atom_key_map(Config).
 
-    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceID)),
-    ok.
+parse_and_check(ConfigString, SchemaMod, RootKey, Type0, Name) ->
+    Type = to_bin(Type0),
+    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
+    hocon_tconf:check_plain(SchemaMod, RawConf, #{required => false, atom_key => false}),
+    #{RootKey := #{Type := #{Name := Config}}} = RawConf,
+    Config.
 
-t_create_disconnected(Config) ->
-    BridgeType = proplists:get_value(bridge_type, Config, <<"opents">>),
-    Config1 = lists:keyreplace(opents_port, 1, Config, {opents_port, 61234}),
-    {_Name, OpenTSConf} = opents_config(BridgeType, Config1),
+to_bin(List) when is_list(List) ->
+    unicode:characters_to_binary(List, utf8);
+to_bin(Atom) when is_atom(Atom) ->
+    erlang:atom_to_binary(Atom);
+to_bin(Bin) when is_binary(Bin) ->
+    Bin.
 
-    Config2 = lists:keyreplace(opents_config, 1, Config1, {opents_config, OpenTSConf}),
-    ?assertMatch({ok, _}, create_bridge(Config2)),
+opents_server_url(Host, Port) ->
+    iolist_to_binary([
+        "http://",
+        Host,
+        ":",
+        integer_to_binary(Port)
+    ]).
 
-    Name = ?config(opents_name, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceID)),
-    ok.
+is_success_check({ok, 200, #{failed := Failed}}) ->
+    ?assertEqual(0, Failed);
+is_success_check(Ret) ->
+    ?assert(false, Ret).
 
-t_write_failure(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    {ok, _} = create_bridge(Config),
-    SentData = make_data(),
-    emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
-        {_, {ok, #{result := Result}}} =
-            ?wait_async_action(
-                send_message(Config, SentData),
-                #{?snk_kind := buffer_worker_flush_ack},
-                2_000
-            ),
-        ?assertMatch({error, _}, Result),
-        ok
-    end),
-    ok.
+is_error_check(Result) ->
+    ?assertMatch({error, {400, #{failed := 1}}}, Result).
 
-t_write_timeout(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    {ok, _} = create_bridge(
-        Config,
-        #{
-            <<"resource_opts">> => #{
-                <<"request_ttl">> => <<"500ms">>,
-                <<"resume_interval">> => <<"100ms">>,
-                <<"health_check_interval">> => <<"100ms">>
+opentds_query(Config, Metric) ->
+    Path = <<"/api/query">>,
+    Opts = #{return_all => true},
+    Body = #{
+        start => <<"1h-ago">>,
+        queries => [
+            #{
+                aggregator => <<"last">>,
+                metric => Metric,
+                tags => #{
+                    host => <<"*">>
+                }
             }
-        }
-    ),
-    SentData = make_data(),
-    emqx_common_test_helpers:with_failure(
-        timeout, ProxyName, ProxyHost, ProxyPort, fun() ->
-            ?assertMatch(
-                {error, {resource_error, #{reason := timeout}}},
-                query_resource(Config, {send_message, SentData})
-            )
-        end
-    ),
-    ok.
+        ],
+        showTSUID => false,
+        showQuery => false,
+        delete => false
+    },
+    opentsdb_request(Config, Path, Body, Opts).
 
-t_missing_data(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            send_message(Config, #{}),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-    ?assertMatch(
-        {error, {400, #{failed := 1, success := 0}}},
-        Result
-    ),
-    ok.
+opentsdb_request(Config, Path, Body) ->
+    opentsdb_request(Config, Path, Body, #{}).
 
-t_bad_data(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    Data = maps:without([metric], make_data()),
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            send_message(Config, Data),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-
-    ?assertMatch(
-        {error, {400, #{failed := 1, success := 0}}}, Result
-    ),
-    ok.
-
-make_data() ->
-    make_data(<<"cpu">>, 12).
+opentsdb_request(Config, Path, Body, Opts) ->
+    Host = ?config(bridge_host, Config),
+    Port = ?config(bridge_port, Config),
+    ServerURL = opents_server_url(Host, Port),
+    URL = <<ServerURL/binary, Path/binary>>,
+    emqx_mgmt_api_test_util:request_api(post, URL, [], [], Body, Opts).
 
 make_data(Metric, Value) ->
     #{
@@ -363,3 +211,45 @@ make_data(Metric, Value) ->
         },
         value => Value
     }.
+
+%%------------------------------------------------------------------------------
+%% Testcases
+%%------------------------------------------------------------------------------
+
+t_query_simple(Config) ->
+    Metric = <<"t_query_simple">>,
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_success_check/1, opents_bridge_on_query
+    ),
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"dps">> := _
+            }
+        ],
+        QResult
+    ),
+    [#{<<"dps">> := Dps}] = QResult,
+    ?assertMatch([Value | _], maps:values(Dps)).
+
+t_create_via_http(Config) ->
+    emqx_bridge_v2_testlib:t_create_via_http(Config).
+
+t_start_stop(Config) ->
+    emqx_bridge_v2_testlib:t_start_stop(Config, opents_bridge_stopped).
+
+t_on_get_status(Config) ->
+    emqx_bridge_v2_testlib:t_on_get_status(Config, #{failure_status => connecting}).
+
+t_query_invalid_data(Config) ->
+    Metric = <<"t_query_invalid_data">>,
+    Value = 12,
+    MakeMessageFun = fun() -> maps:remove(value, make_data(Metric, Value)) end,
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_error_check/1, opents_bridge_on_query
+    ).
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 655892d88..90c1ae1ce 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -52,6 +52,8 @@ resource_type(iotdb) ->
     emqx_bridge_iotdb_connector;
 resource_type(elasticsearch) ->
     emqx_bridge_es_connector;
+resource_type(opents) ->
+    emqx_bridge_opents_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -66,6 +68,8 @@ connector_impl_module(iotdb) ->
     emqx_bridge_iotdb_connector;
 connector_impl_module(elasticsearch) ->
     emqx_bridge_es_connector;
+connector_impl_module(opents) ->
+    emqx_bridge_opents_connector;
 connector_impl_module(_ConnectorType) ->
     undefined.
 
@@ -193,6 +197,14 @@ connector_structs() ->
                     desc => <<"ElasticSearch Connector Config">>,
                     required => false
                 }
+            )},
+        {opents,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_opents_connector, "config_connector")),
+                #{
+                    desc => <<"OpenTSDB Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -212,7 +224,8 @@ schema_modules() ->
         emqx_postgresql_connector_schema,
         emqx_bridge_redis_schema,
         emqx_bridge_iotdb_connector,
-        emqx_bridge_es_connector
+        emqx_bridge_es_connector,
+        emqx_bridge_opents_connector
     ].
 
 api_schemas(Method) ->
@@ -241,7 +254,8 @@ api_schemas(Method) ->
         api_ref(emqx_postgresql_connector_schema, <<"pgsql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_redis_schema, <<"redis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
-        api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method)
+        api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
+        api_ref(emqx_bridge_opents_connector, <<"opents">>, Method)
     ].
 
 api_ref(Module, Type, Method) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 615b89230..1829e04e6 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -154,7 +154,9 @@ connector_type_to_bridge_types(timescale) ->
 connector_type_to_bridge_types(iotdb) ->
     [iotdb];
 connector_type_to_bridge_types(elasticsearch) ->
-    [elasticsearch].
+    [elasticsearch];
+connector_type_to_bridge_types(opents) ->
+    [opents].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index ff44a9e18..5f1c4b0af 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -23,4 +23,35 @@ emqx_bridge_opents {
 
     desc_name.label:
         "Bridge Name"
+
+action_parameters_data.desc:
+"""OpenTSDB action parameter data"""
+
+action_parameters_data.label:
+"""Parameter Data"""
+
+config_parameters_timestamp.desc:
+"""Timestamp. Placeholders in format of ${var} is supported"""
+
+config_parameters_timestamp.label:
+"""Timestamp"""
+
+config_parameters_metric.metric:
+"""Metric. Placeholders in format of ${var} is supported"""
+
+config_parameters_metric.metric:
+"""Metric"""
+
+config_parameters_tags.desc:
+"""Data Type, Placeholders in format of ${var} is supported"""
+
+config_parameters_tags.label:
+"""Tags"""
+
+config_parameters_value.desc:
+"""Value. Placeholders in format of ${var} is supported"""
+
+config_parameters_value.label:
+"""Value"""
+
 }
diff --git a/rel/i18n/emqx_bridge_opents_connector.hocon b/rel/i18n/emqx_bridge_opents_connector.hocon
index 5c39d1e0e..a54c240a0 100644
--- a/rel/i18n/emqx_bridge_opents_connector.hocon
+++ b/rel/i18n/emqx_bridge_opents_connector.hocon
@@ -17,4 +17,10 @@ emqx_bridge_opents_connector {
 
     details.label:
         "Details"
+
+desc_config.desc:
+"""Configuration for OpenTSDB Connector."""
+
+desc_config.label:
+"""OpenTSDB Connector Configuration"""
 }

From 83a88227980c85de3c206be16852d34b7a210e82 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 18 Jan 2024 22:25:58 +0800
Subject: [PATCH 049/273] chore(opents): bump version && update changes

---
 apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src |  2 +-
 .../src/emqx_bridge_opents_connector.erl               |  7 ++++++-
 changes/ee/feat-12353.en.md                            |  1 +
 rel/i18n/emqx_bridge_opents.hocon                      | 10 ++++++++--
 4 files changed, 16 insertions(+), 4 deletions(-)
 create mode 100644 changes/ee/feat-12353.en.md

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src b/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
index 5e3b2f585..2469acaa8 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_opents, [
     {description, "EMQX Enterprise OpenTSDB Bridge"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index 6af1e2f55..e3fe9d6b4 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -56,7 +56,10 @@ fields(config) ->
 
 fields("config_connector") ->
     emqx_connector_schema:common_fields() ++
-        proplists_without([auto_reconnect], fields(config));
+        proplists_without([auto_reconnect], fields(config)) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
 fields("post") ->
     emqx_connector_schema:type_and_name_fields(enum([opents])) ++ fields("config_connector");
 fields("put") ->
@@ -66,6 +69,8 @@ fields("get") ->
 
 desc(config) ->
     ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc("config_connector") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
diff --git a/changes/ee/feat-12353.en.md b/changes/ee/feat-12353.en.md
new file mode 100644
index 000000000..2d34e1211
--- /dev/null
+++ b/changes/ee/feat-12353.en.md
@@ -0,0 +1 @@
+The bridges for OpentsDB have been split so it is available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index 5f1c4b0af..f5d2ade85 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -24,6 +24,12 @@ emqx_bridge_opents {
     desc_name.label:
         "Bridge Name"
 
+action_parameters.desc:
+"""OpenTSDB action parameters"""
+
+action_parameters.label:
+"""Parameters"""
+
 action_parameters_data.desc:
 """OpenTSDB action parameter data"""
 
@@ -36,10 +42,10 @@ config_parameters_timestamp.desc:
 config_parameters_timestamp.label:
 """Timestamp"""
 
-config_parameters_metric.metric:
+config_parameters_metric.desc:
 """Metric. Placeholders in format of ${var} is supported"""
 
-config_parameters_metric.metric:
+config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:

From b44420c14f1b949086b21ef59c51340c3c5762ce Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Tue, 23 Jan 2024 10:00:56 +0800
Subject: [PATCH 050/273] fix(opentsdb): Enhanced the type support for template
 data

---
 .../src/emqx_bridge_opents.erl                | 18 +++-
 .../src/emqx_bridge_opents_connector.erl      | 27 ++++--
 .../test/emqx_bridge_opents_SUITE.erl         | 88 ++++++++++++++++++-
 rel/i18n/emqx_bridge_opents.hocon             |  2 +-
 4 files changed, 124 insertions(+), 11 deletions(-)

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index 7e490576f..119de1978 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -3,6 +3,7 @@
 %%--------------------------------------------------------------------
 -module(emqx_bridge_opents).
 
+-include_lib("emqx/include/logger.hrl").
 -include_lib("typerefl/include/types.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
@@ -156,12 +157,25 @@ fields(action_parameters_data) ->
                 binary(),
                 #{
                     required => true,
-                    desc => ?DESC("config_parameters_tags")
+                    desc => ?DESC("config_parameters_tags"),
+                    validator => fun(Tmpl) ->
+                        case emqx_placeholder:preproc_tmpl(Tmpl) of
+                            [{var, _}] ->
+                                true;
+                            _ ->
+                                ?SLOG(warning, #{
+                                    msg => "invalid_tags_template",
+                                    path => "opents.parameters.data.tags",
+                                    data => Tmpl
+                                }),
+                                false
+                        end
+                    end
                 }
             )},
         {value,
             mk(
-                binary(),
+                hoconsc:union([integer(), float(), binary()]),
                 #{
                     required => true,
                     desc => ?DESC("config_parameters_value")
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index e3fe9d6b4..d71468d82 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -304,9 +304,14 @@ render_channel_message(Msg, #{data := DataList}, Acc) ->
             ValueVal =
                 case ValueTk of
                     [_] ->
+                        %% just one element, maybe is a variable or a plain text
+                        %% we should keep it as it is
                         erlang:hd(emqx_placeholder:proc_tmpl(ValueTk, Msg, RawOpts));
-                    _ ->
-                        emqx_placeholder:proc_tmpl(ValueTk, Msg)
+                    Tks when is_list(Tks) ->
+                        emqx_placeholder:proc_tmpl(ValueTk, Msg);
+                    Raw ->
+                        %% not a token list, just a raw value
+                        Raw
                 end,
             Base = #{metric => MetricVal, tags => TagsVal, value => ValueVal},
             [
@@ -328,12 +333,20 @@ preproc_data_template([]) ->
 preproc_data_template(DataList) ->
     lists:map(
         fun(Data) ->
-            maps:map(
-                fun(_Key, Value) ->
-                    emqx_placeholder:preproc_tmpl(Value)
+            {Value, Data2} = maps:take(value, Data),
+            Template = maps:map(
+                fun(_Key, Val) ->
+                    emqx_placeholder:preproc_tmpl(Val)
                 end,
-                Data
-            )
+                Data2
+            ),
+
+            case Value of
+                Text when is_binary(Text) ->
+                    Template#{value => emqx_placeholder:preproc_tmpl(Text)};
+                Raw ->
+                    Template#{value => Raw}
+            end
         end,
         DataList
     ).
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index f86ae6986..e3e89d563 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -83,7 +83,7 @@ init_per_testcase(TestCase, Config0) ->
         {bridge_config, ActionConfig}
         | Config0
     ],
-    %%    iotdb_reset(Config),
+    emqx_bridge_v2_testlib:delete_all_bridges_and_connectors(),
     ok = snabbkaffe:start_trace(),
     Config.
 
@@ -253,3 +253,89 @@ t_query_invalid_data(Config) ->
     ok = emqx_bridge_v2_testlib:t_sync_query(
         Config, MakeMessageFun, fun is_error_check/1, opents_bridge_on_query
     ).
+
+t_tags_validator(Config) ->
+    %% Create without data  configured
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"${tags}">>,
+                        <<"value">> => <<"${payload.value}">>
+                    }
+                ]
+            }
+        })
+    ),
+
+    ?assertMatch(
+        {error, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"text">>,
+                        <<"value">> => <<"${payload.value}">>
+                    }
+                ]
+            }
+        })
+    ).
+
+t_raw_int_value(Config) ->
+    raw_value_test(<<"t_raw_int_value">>, 42, Config).
+
+t_raw_float_value(Config) ->
+    raw_value_test(<<"t_raw_float_value">>, 42.5, Config).
+
+raw_value_test(Metric, RawValue, Config) ->
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+    ResourceId = emqx_bridge_v2_testlib:resource_id(Config),
+    BridgeId = emqx_bridge_v2_testlib:bridge_id(Config),
+    ?retry(
+        _Sleep = 1_000,
+        _Attempts = 10,
+        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+    ),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => <<"${tags}">>,
+                        <<"value">> => RawValue
+                    }
+                ]
+            }
+        })
+    ),
+
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+
+    is_success_check(
+        emqx_resource:simple_sync_query(ResourceId, {BridgeId, MakeMessageFun()})
+    ),
+
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"dps">> := _
+            }
+        ],
+        QResult
+    ),
+    [#{<<"dps">> := Dps}] = QResult,
+    ?assertMatch([RawValue | _], maps:values(Dps)).
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index f5d2ade85..ab2e82180 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -49,7 +49,7 @@ config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:
-"""Data Type, Placeholders in format of ${var} is supported"""
+"""Tags. Only supports with placeholder to extract tags from a variable"""
 
 config_parameters_tags.label:
 """Tags"""

From 186e1591df60da24a68cf55452345df5a90c9c4c Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Tue, 23 Jan 2024 09:06:15 +0800
Subject: [PATCH 051/273] chore: document api-key path api only support
 bearerAuth

---
 apps/emqx/include/http_api.hrl                  |  1 +
 apps/emqx_dashboard/src/emqx_dashboard.erl      |  7 ++++---
 apps/emqx_dashboard/src/emqx_dashboard_api.erl  |  1 +
 .../src/emqx_mgmt_api_api_keys.erl              |  2 ++
 apps/emqx_management/src/emqx_mgmt_auth.erl     |  6 +++---
 .../test/emqx_mgmt_api_api_keys_SUITE.erl       | 17 ++++++++++++++++-
 rel/i18n/emqx_mgmt_api_api_keys.hocon           | 10 +++++-----
 7 files changed, 32 insertions(+), 12 deletions(-)

diff --git a/apps/emqx/include/http_api.hrl b/apps/emqx/include/http_api.hrl
index 0f6372584..f0c5611e9 100644
--- a/apps/emqx/include/http_api.hrl
+++ b/apps/emqx/include/http_api.hrl
@@ -17,6 +17,7 @@
 %% HTTP API Auth
 -define(BAD_USERNAME_OR_PWD, 'BAD_USERNAME_OR_PWD').
 -define(BAD_API_KEY_OR_SECRET, 'BAD_API_KEY_OR_SECRET').
+-define(API_KEY_NOT_ALLOW, 'API_KEY_NOT_ALLOW').
 -define(API_KEY_NOT_ALLOW_MSG, <<"This API Key don't have permission to access this resource">>).
 
 %% Bad Request
diff --git a/apps/emqx_dashboard/src/emqx_dashboard.erl b/apps/emqx_dashboard/src/emqx_dashboard.erl
index 96f81ca84..a4438f6c7 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard.erl
@@ -264,10 +264,11 @@ api_key_authorize(Req, Key, Secret) ->
     case emqx_mgmt_auth:authorize(Path, Req, Key, Secret) of
         ok ->
             {ok, #{auth_type => api_key, source => Key}};
-        {error, <<"not_allowed">>} ->
+        {error, <<"not_allowed">>, Resource} ->
             return_unauthorized(
-                ?BAD_API_KEY_OR_SECRET,
-                <<"Not allowed, Check api_key/api_secret">>
+                ?API_KEY_NOT_ALLOW,
+                <<"Please use bearer Token instead, using API key/secret in ", Resource/binary,
+                    " path is not permitted">>
             );
         {error, unauthorized_role} ->
             {403, 'UNAUTHORIZED_ROLE', ?API_KEY_NOT_ALLOW_MSG};
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_api.erl b/apps/emqx_dashboard/src/emqx_dashboard_api.erl
index 8a81f2116..d7ed5941f 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_api.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_api.erl
@@ -89,6 +89,7 @@ schema("/logout") ->
         post => #{
             tags => [<<"dashboard">>],
             desc => ?DESC(logout_api),
+            security => [#{'bearerAuth' => []}],
             parameters => sso_parameters(),
             'requestBody' => fields([username]),
             responses => #{
diff --git a/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl b/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
index db20e9477..ad4b53401 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_api_keys.erl
@@ -40,6 +40,7 @@ schema("/api_key") ->
         get => #{
             description => ?DESC(api_key_list),
             tags => ?TAGS,
+            security => [#{'bearerAuth' => []}],
             responses => #{
                 200 => delete([api_secret], fields(app))
             }
@@ -47,6 +48,7 @@ schema("/api_key") ->
         post => #{
             description => ?DESC(create_new_api_key),
             tags => ?TAGS,
+            security => [#{'bearerAuth' => []}],
             'requestBody' => delete([created_at, api_key, api_secret], fields(app)),
             responses => #{
                 200 => hoconsc:ref(app),
diff --git a/apps/emqx_management/src/emqx_mgmt_auth.erl b/apps/emqx_management/src/emqx_mgmt_auth.erl
index 559344e2b..7745207ce 100644
--- a/apps/emqx_management/src/emqx_mgmt_auth.erl
+++ b/apps/emqx_management/src/emqx_mgmt_auth.erl
@@ -184,11 +184,11 @@ list() ->
     to_map(ets:match_object(?APP, #?APP{_ = '_'})).
 
 authorize(<<"/api/v5/users", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"users">>};
 authorize(<<"/api/v5/api_key", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"api_key">>};
 authorize(<<"/api/v5/logout", _/binary>>, _Req, _ApiKey, _ApiSecret) ->
-    {error, <<"not_allowed">>};
+    {error, <<"not_allowed">>, <<"logout">>};
 authorize(_Path, Req, ApiKey, ApiSecret) ->
     Now = erlang:system_time(second),
     case find_by_api_key(ApiKey) of
diff --git a/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
index d437e07c9..760ab1732 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_api_keys_SUITE.erl
@@ -394,8 +394,23 @@ t_authorize(_Config) ->
     {ok, _Status} = emqx_mgmt_api_test_util:request_api(get, BanPath, BasicHeader),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, BanPath, KeyError)),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, BanPath, SecretError)),
-    ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, ApiKeyPath, BasicHeader)),
     ?assertEqual(Unauthorized, emqx_mgmt_api_test_util:request_api(get, UserPath, BasicHeader)),
+    {error, {{"HTTP/1.1", 401, "Unauthorized"}, _Headers, Body}} =
+        emqx_mgmt_api_test_util:request_api(
+            get,
+            ApiKeyPath,
+            [],
+            BasicHeader,
+            [],
+            #{return_all => true}
+        ),
+    ?assertMatch(
+        #{
+            <<"code">> := <<"API_KEY_NOT_ALLOW">>,
+            <<"message">> := _
+        },
+        emqx_utils_json:decode(Body, [return_maps])
+    ),
 
     ?assertMatch(
         {ok, #{<<"api_key">> := _, <<"enable">> := false}},
diff --git a/rel/i18n/emqx_mgmt_api_api_keys.hocon b/rel/i18n/emqx_mgmt_api_api_keys.hocon
index 8acbe60d0..4becd01aa 100644
--- a/rel/i18n/emqx_mgmt_api_api_keys.hocon
+++ b/rel/i18n/emqx_mgmt_api_api_keys.hocon
@@ -1,27 +1,27 @@
 emqx_mgmt_api_api_keys {
 
 api_key_list.desc:
-"""Return api_key list"""
+"""Return api_key list. This API can only be requested using a bearer token."""
 api_key_list.label:
 """Return api_key list"""
 
 create_new_api_key.desc:
-"""Create new api_key"""
+"""Create new api_key. This API can only be requested using a bearer token."""
 create_new_api_key.label:
 """Create new api_key"""
 
 get_api_key.desc:
-"""Return the specific api_key"""
+"""Return the specific api_key. This API can only be requested using a bearer token."""
 get_api_key.label:
 """Return the specific api_key"""
 
 update_api_key.desc:
-"""Update the specific api_key"""
+"""Update the specific api_key. This API can only be requested using a bearer token."""
 update_api_key.label:
 """Update the specific api_key"""
 
 delete_api_key.desc:
-"""Delete the specific api_key"""
+"""Delete the specific api_key. This API can only be requested using a bearer token."""
 delete_api_key.label:
 """Delete the specific api_key"""
 

From 497e735bf48ff840406dad4d656a53720df1a3be Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 16 Jan 2024 14:39:41 +0800
Subject: [PATCH 052/273] ci: add env vars to run cassandra tests locally

---
 .../docker-compose-toxiproxy.yaml             |  4 ++
 .ci/docker-compose-file/toxiproxy.json        | 12 ++++++
 .../test/emqx_bridge_cassandra_SUITE.erl      |  8 ++++
 .../emqx_bridge_cassandra_connector_SUITE.erl | 40 +++++++++++--------
 4 files changed, 47 insertions(+), 17 deletions(-)

diff --git a/.ci/docker-compose-file/docker-compose-toxiproxy.yaml b/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
index d648d9d78..568d9129c 100644
--- a/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
+++ b/.ci/docker-compose-file/docker-compose-toxiproxy.yaml
@@ -39,6 +39,10 @@ services:
       - 19042:9042
       # Cassandra TLS
       - 19142:9142
+      # Cassandra No Auth
+      - 19043:9043
+      # Cassandra TLS No Auth
+      - 19143:9143
       # S3
       - 19000:19000
       # S3 TLS
diff --git a/.ci/docker-compose-file/toxiproxy.json b/.ci/docker-compose-file/toxiproxy.json
index c58474039..103bae924 100644
--- a/.ci/docker-compose-file/toxiproxy.json
+++ b/.ci/docker-compose-file/toxiproxy.json
@@ -96,6 +96,18 @@
     "upstream": "cassandra:9142",
     "enabled": true
   },
+  {
+    "name": "cassa_no_auth_tcp",
+    "listen": "0.0.0.0:9043",
+    "upstream": "cassandra_noauth:9042",
+    "enabled": true
+  },
+  {
+    "name": "cassa_no_auth_tls",
+    "listen": "0.0.0.0:9143",
+    "upstream": "cassandra_noauth:9142",
+    "enabled": true
+  },
   {
     "name": "sqlserver",
     "listen": "0.0.0.0:1433",
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index 9df219296..e0e3900b0 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -11,6 +11,14 @@
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
+%% To run this test locally:
+%%   ./scripts/ct/run.sh --app apps/emqx_bridge_cassandra --only-up
+%%   PROFILE=emqx-enterprise PROXY_HOST=localhost CASSA_TLS_HOST=localhost \
+%%     CASSA_TLS_PORT=19142 CASSA_TCP_HOST=localhost CASSA_TCP_NO_AUTH_HOST=localhost \
+%%     CASSA_TCP_PORT=19042 CASSA_TCP_NO_AUTH_PORT=19043 \
+%%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
+%%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE
+
 % SQL definitions
 -define(SQL_BRIDGE,
     "insert into mqtt_msg_test(topic, payload, arrived) "
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
index de306e3f0..245110de6 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
@@ -14,20 +14,20 @@
 -include_lib("emqx/include/emqx.hrl").
 -include_lib("stdlib/include/assert.hrl").
 
+%% To run this test locally:
+%%   ./scripts/ct/run.sh --app apps/emqx_bridge_cassandra --only-up
+%%   PROFILE=emqx-enterprise PROXY_HOST=localhost CASSA_TLS_HOST=localhost \
+%%     CASSA_TLS_PORT=9142 CASSA_TCP_HOST=localhost CASSA_TCP_NO_AUTH_HOST=localhost \
+%%     CASSA_TCP_PORT=19042 CASSA_TCP_NO_AUTH_PORT=19043 \
+%%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
+%%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE
+
 %% Cassandra servers are defined at `.ci/docker-compose-file/docker-compose-cassandra.yaml`
 %% You can change it to `127.0.0.1`, if you run this SUITE locally
 -define(CASSANDRA_HOST, "cassandra").
 -define(CASSANDRA_HOST_NOAUTH, "cassandra_noauth").
 -define(CASSANDRA_RESOURCE_MOD, emqx_bridge_cassandra_connector).
 
-%% This test SUITE requires a running cassandra instance. If you don't want to
-%% bring up the whole CI infrastuctucture with the `scripts/ct/run.sh` script
-%% you can create a cassandra instance with the following command (execute it
-%% from root of the EMQX directory.). You also need to set ?CASSANDRA_HOST and
-%% ?CASSANDRA_PORT to appropriate values.
-%%
-%% sudo docker run --rm -d --name cassandra --network host cassandra:3.11.14
-
 %% Cassandra default username & password once enable `authenticator: PasswordAuthenticator`
 %% in cassandra config
 -define(CASSA_USERNAME, <<"cassandra">>).
@@ -45,14 +45,14 @@ groups() ->
         {noauth, [t_lifecycle]}
     ].
 
-cassandra_servers(CassandraHost) ->
+cassandra_servers(CassandraHost, CassandraPort) ->
     lists:map(
         fun(#{hostname := Host, port := Port}) ->
             {Host, Port}
         end,
         emqx_schema:parse_servers(
-            iolist_to_binary([CassandraHost, ":", erlang:integer_to_list(?CASSANDRA_DEFAULT_PORT)]),
-            #{default_port => ?CASSANDRA_DEFAULT_PORT}
+            iolist_to_binary([CassandraHost, ":", erlang:integer_to_list(CassandraPort)]),
+            #{default_port => CassandraPort}
         )
     ).
 
@@ -63,25 +63,30 @@ init_per_suite(Config) ->
     Config.
 
 init_per_group(Group, Config) ->
-    {CassandraHost, AuthOpts} =
+    {CassandraHost, CassandraPort, AuthOpts} =
         case Group of
             auth ->
-                {?CASSANDRA_HOST, [{username, ?CASSA_USERNAME}, {password, ?CASSA_PASSWORD}]};
+                TcpHost = os:getenv("CASSA_TCP_HOST", "toxiproxy"),
+                TcpPort = list_to_integer(os:getenv("CASSA_TCP_PORT", "9042")),
+                {TcpHost, TcpPort, [{username, ?CASSA_USERNAME}, {password, ?CASSA_PASSWORD}]};
             noauth ->
-                {?CASSANDRA_HOST_NOAUTH, []}
+                TcpHost = os:getenv("CASSA_TCP_NO_AUTH_HOST", "toxiproxy"),
+                TcpPort = list_to_integer(os:getenv("CASSA_TCP_NO_AUTH_PORT", "9043")),
+                {TcpHost, TcpPort, []}
         end,
-    case emqx_common_test_helpers:is_tcp_server_available(CassandraHost, ?CASSANDRA_DEFAULT_PORT) of
+    case emqx_common_test_helpers:is_tcp_server_available(CassandraHost, CassandraPort) of
         true ->
             %% keyspace `mqtt` must be created in advance
             {ok, Conn} =
                 ecql:connect([
-                    {nodes, cassandra_servers(CassandraHost)},
+                    {nodes, cassandra_servers(CassandraHost, CassandraPort)},
                     {keyspace, "mqtt"}
                     | AuthOpts
                 ]),
             ecql:close(Conn),
             [
                 {cassa_host, CassandraHost},
+                {cassa_port, CassandraPort},
                 {cassa_auth_opts, AuthOpts}
                 | Config
             ];
@@ -212,6 +217,7 @@ create_local_resource(ResourceId, CheckedConfig) ->
 
 cassandra_config(Config) ->
     Host = ?config(cassa_host, Config),
+    Port = ?config(cassa_port, Config),
     AuthOpts = maps:from_list(?config(cassa_auth_opts, Config)),
     CassConfig =
         AuthOpts#{
@@ -223,7 +229,7 @@ cassandra_config(Config) ->
                     "~s:~b",
                     [
                         Host,
-                        ?CASSANDRA_DEFAULT_PORT
+                        Port
                     ]
                 )
             )

From 6a21766ce3af07fa25ebb58d9571809d4ae78d92 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Fri, 19 Jan 2024 18:46:35 +0800
Subject: [PATCH 053/273] refactor: split cassandra bridges to actions and
 connectors

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_cassandra.app.src         |   4 +-
 .../src/emqx_bridge_cassandra.erl             | 108 ++++++-
 .../src/emqx_bridge_cassandra_action_info.erl |  62 ++++
 .../src/emqx_bridge_cassandra_connector.erl   | 286 ++++++++----------
 .../test/emqx_bridge_cassandra_SUITE.erl      |  21 +-
 .../emqx_bridge_cassandra_connector_SUITE.erl |   4 -
 .../src/schema/emqx_connector_ee_schema.erl   |  12 +
 .../src/schema/emqx_connector_schema.erl      |   2 +
 rel/i18n/emqx_bridge_cassandra.hocon          |  10 +
 .../emqx_bridge_cassandra_connector.hocon     |   6 +
 11 files changed, 332 insertions(+), 184 deletions(-)
 create mode 100644 apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 4f6228998..8e5a823e3 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -92,6 +92,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
         emqx_bridge_influxdb_action_info,
+        emqx_bridge_cassandra_action_info,
         emqx_bridge_mysql_action_info,
         emqx_bridge_pgsql_action_info,
         emqx_bridge_syskeeper_action_info,
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
index 97be100d2..aa8290b98 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_cassandra, [
     {description, "EMQX Enterprise Cassandra Bridge"},
-    {vsn, "0.1.6"},
+    {vsn, "0.2.0"},
     {registered, []},
     {applications, [
         kernel,
@@ -8,7 +8,7 @@
         emqx_resource,
         ecql
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_cassandra_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
index 2724b7c09..83268cab5 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra.erl
@@ -12,11 +12,17 @@
 
 %% schema examples
 -export([
-    conn_bridge_examples/1,
     values/2,
     fields/2
 ]).
 
+%% Examples
+-export([
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
+]).
+
 %% schema
 -export([
     namespace/0,
@@ -26,10 +32,13 @@
 ]).
 
 -define(DEFAULT_CQL, <<
-    "insert into mqtt_msg(topic, msgid, sender, qos, payload, arrived, retain) "
-    "values (${topic}, ${id}, ${clientid}, ${qos}, ${payload}, ${timestamp}, ${flags.retain})"
+    "insert into mqtt_msg(msgid, topic, qos, payload, arrived) "
+    "values (${id}, ${topic},  ${qos}, ${payload}, ${timestamp})"
 >>).
 
+-define(CONNECTOR_TYPE, cassandra).
+-define(ACTION_TYPE, cassandra).
+
 %%--------------------------------------------------------------------
 %% schema examples
 
@@ -43,6 +52,41 @@ conn_bridge_examples(Method) ->
         }
     ].
 
+bridge_v2_examples(Method) ->
+    ParamsExample = #{
+        parameters => #{
+            cql => ?DEFAULT_CQL
+        }
+    },
+    [
+        #{
+            <<"cassandra">> => #{
+                summary => <<"Cassandra Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, cassandra, cassandra, ParamsExample
+                )
+            }
+        }
+    ].
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"cassandra">> => #{
+                summary => <<"Cassandra Connector">>,
+                value => emqx_connector_schema:connector_values(
+                    Method, cassandra, #{
+                        servers => <<"127.0.0.1:9042">>,
+                        keyspace => <<"mqtt">>,
+                        username => <<"root">>,
+                        password => <<"******">>,
+                        pool_size => 8
+                    }
+                )
+            }
+        }
+    ].
+
 %% no difference in get/post/put method
 values(_Method, Type) ->
     #{
@@ -73,14 +117,47 @@ namespace() -> "bridge_cassa".
 
 roots() -> [].
 
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        emqx_bridge_cassandra_connector:fields("connector") ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(action) ->
+    {cassandra,
+        mk(
+            hoconsc:map(name, ref(?MODULE, cassandra_action)),
+            #{desc => <<"Cassandra Action Config">>, required => false}
+        )};
+fields(cassandra_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(ref(?MODULE, action_parameters), #{
+            required => true, desc => ?DESC(action_parameters)
+        })
+    );
+fields(action_parameters) ->
+    [
+        cql_field()
+    ];
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    Fields =
+        emqx_bridge_cassandra_connector:fields("connector") ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(cassandra_action));
 fields("config") ->
     [
+        cql_field(),
         {enable, mk(boolean(), #{desc => ?DESC("config_enable"), default => true})},
-        {cql,
-            mk(
-                binary(),
-                #{desc => ?DESC("cql_template"), default => ?DEFAULT_CQL, format => <<"sql">>}
-            )},
         {local_topic,
             mk(
                 binary(),
@@ -99,8 +176,23 @@ fields("get") ->
 fields("post", Type) ->
     [type_field(Type), name_field() | fields("config")].
 
+cql_field() ->
+    {cql,
+        mk(
+            binary(),
+            #{desc => ?DESC("cql_template"), default => ?DEFAULT_CQL, format => <<"sql">>}
+        )}.
+
 desc("config") ->
     ?DESC("desc_config");
+desc(cassandra_action) ->
+    ?DESC(cassandra_action);
+desc(action_parameters) ->
+    ?DESC(action_parameters);
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for Cassandra using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl
new file mode 100644
index 000000000..14db7cf50
--- /dev/null
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_action_info.erl
@@ -0,0 +1,62 @@
+-module(emqx_bridge_cassandra_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    connector_action_config_to_bridge_v1_config/2,
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(SCHEMA_MODULE, emqx_bridge_cassandra).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(cassandra_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ActionTopLevelKeys = schema_keys(cassandra_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ConnectorTopLevelKeys = schema_keys("config_connector"),
+    ConnectorKeys = maps:keys(BridgeV1Config) -- (ActionKeys -- ConnectorTopLevelKeys),
+    ConnConfig0 = maps:with(ConnectorKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        ConnConfig0
+    ).
+
+connector_action_config_to_bridge_v1_config(ConnectorRawConf, ActionRawConf) ->
+    RawConf = emqx_action_info:connector_action_config_to_bridge_v1_config(
+        ConnectorRawConf, ActionRawConf
+    ),
+    maps:without([<<"cassandra_type">>], RawConf).
+
+bridge_v1_type_name() -> cassandra.
+
+action_type_name() -> cassandra.
+
+connector_type_name() -> cassandra.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    [bin(Key) || Key <- proplists:get_keys(?SCHEMA_MODULE:fields(Name))].
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index c6bc7098c..3db71c9e0 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -14,13 +14,17 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 %% schema
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, desc/1]).
 
 %% callbacks of behaviour emqx_resource
 -export([
     callback_mode/0,
     on_start/2,
     on_stop/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channel_status/3,
+    on_get_channels/1,
     on_query/3,
     on_query_async/4,
     on_batch_query/3,
@@ -28,6 +32,8 @@
     on_get_status/2
 ]).
 
+-export([transform_bridge_v1_config_to_connector_config/1]).
+
 %% callbacks of ecpool
 -export([
     connect/1,
@@ -39,16 +45,10 @@
 
 -export([do_get_status/1]).
 
--type prepares() :: #{atom() => binary()}.
--type params_tokens() :: #{atom() => list()}.
-
 -type state() ::
     #{
         pool_name := binary(),
-        prepare_cql := prepares(),
-        params_tokens := params_tokens(),
-        %% returned by ecql:prepare/2
-        prepare_statement := binary()
+        channels := #{}
     }.
 
 -define(DEFAULT_SERVER_OPTION, #{default_port => ?CASSANDRA_DEFAULT_PORT}).
@@ -62,7 +62,9 @@ roots() ->
 fields(config) ->
     cassandra_db_fields() ++
         emqx_connector_schema_lib:ssl_fields() ++
-        emqx_connector_schema_lib:prepare_statement_fields().
+        emqx_connector_schema_lib:prepare_statement_fields();
+fields("connector") ->
+    cassandra_db_fields() ++ emqx_connector_schema_lib:ssl_fields().
 
 cassandra_db_fields() ->
     [
@@ -83,6 +85,11 @@ keyspace(desc) -> ?DESC("keyspace");
 keyspace(required) -> true;
 keyspace(_) -> undefined.
 
+desc(config) ->
+    ?DESC("config");
+desc("connector") ->
+    ?DESC("connector").
+
 %%--------------------------------------------------------------------
 %% callbacks for emqx_resource
 
@@ -130,10 +137,9 @@ on_start(
             false ->
                 []
         end,
-    State = parse_prepare_cql(Config),
     case emqx_resource_pool:start(InstId, ?MODULE, Options ++ SslOpts) of
         ok ->
-            {ok, init_prepare(State#{pool_name => InstId, prepare_statement => #{}})};
+            {ok, #{pool_name => InstId, channels => #{}}};
         {error, Reason} ->
             ?tp(
                 cassandra_connector_start_failed,
@@ -149,23 +155,49 @@ on_stop(InstId, _State) ->
     }),
     emqx_resource_pool:stop(InstId).
 
+on_add_channel(_InstId, #{channels := Channs} = OldState, ChannId, ChannConf0) ->
+    #{parameters := #{cql := CQL}} = ChannConf0,
+    {PrepareCQL, ParamsTokens} = emqx_placeholder:preproc_sql(CQL, '?'),
+    ParsedCql = #{
+        prepare_key => short_prepare_key(ChannId),
+        prepare_cql => PrepareCQL,
+        params_tokens => ParamsTokens
+    },
+    NewChanns = Channs#{ChannId => #{parsed_cql => ParsedCql, prepare_result => not_prepared}},
+    {ok, OldState#{channels => NewChanns}}.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = State, ChannId) ->
+    NewState = State#{channels => maps:remove(ChannId, Channels)},
+    {ok, NewState}.
+
+on_get_channel_status(InstanceId, ChannId, #{channels := Channels, pool_name := PoolName} = State) ->
+    case on_get_status(InstanceId, State) of
+        connected ->
+            #{parsed_cql := ParsedCql} = maps:get(ChannId, Channels),
+            case prepare_cql_to_cassandra(ParsedCql, PoolName) of
+                {ok, _} -> connected;
+                {error, Reason} -> {connecting, Reason}
+            end;
+        _ ->
+            connecting
+    end.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
 -type request() ::
     % emqx_bridge.erl
-    {send_message, Params :: map()}
+    {ChannId :: binary(), Params :: map()}
     % common query
-    | {query, SQL :: binary()}
-    | {query, SQL :: binary(), Params :: map()}.
+    | {query, CQL :: binary()}
+    | {query, CQL :: binary(), Params :: map()}.
 
 -spec on_query(
     emqx_resource:resource_id(),
     request(),
     state()
 ) -> ok | {ok, ecql:cql_result()} | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_query(
-    InstId,
-    Request,
-    State
-) ->
+on_query(InstId, Request, State) ->
     do_single_query(InstId, Request, sync, State).
 
 -spec on_query_async(
@@ -174,21 +206,11 @@ on_query(
     {function(), list()},
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_query_async(
-    InstId,
-    Request,
-    Callback,
-    State
-) ->
+on_query_async(InstId, Request, Callback, State) ->
     do_single_query(InstId, Request, {async, Callback}, State).
 
-do_single_query(
-    InstId,
-    Request,
-    Async,
-    #{pool_name := PoolName} = State
-) ->
-    {Type, PreparedKeyOrSQL, Params} = parse_request_to_cql(Request),
+do_single_query(InstId, Request, Async, #{pool_name := PoolName} = State) ->
+    {Type, PreparedKeyOrCQL, Params} = parse_request_to_cql(Request),
     ?tp(
         debug,
         cassandra_connector_received_cql_query,
@@ -196,12 +218,12 @@ do_single_query(
             connector => InstId,
             type => Type,
             params => Params,
-            prepared_key_or_cql => PreparedKeyOrSQL,
+            prepared_key_or_cql => PreparedKeyOrCQL,
             state => State
         }
     ),
-    {PreparedKeyOrSQL1, Data} = proc_cql_params(Type, PreparedKeyOrSQL, Params, State),
-    Res = exec_cql_query(InstId, PoolName, Type, Async, PreparedKeyOrSQL1, Data),
+    {PreparedKeyOrCQL1, Data} = proc_cql_params(Type, PreparedKeyOrCQL, Params, State),
+    Res = exec_cql_query(InstId, PoolName, Type, Async, PreparedKeyOrCQL1, Data),
     handle_result(Res).
 
 -spec on_batch_query(
@@ -209,11 +231,7 @@ do_single_query(
     [request()],
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_batch_query(
-    InstId,
-    Requests,
-    State
-) ->
+on_batch_query(InstId, Requests, State) ->
     do_batch_query(InstId, Requests, sync, State).
 
 -spec on_batch_query_async(
@@ -222,25 +240,15 @@ on_batch_query(
     {function(), list()},
     state()
 ) -> ok | {error, {recoverable_error | unrecoverable_error, term()}}.
-on_batch_query_async(
-    InstId,
-    Requests,
-    Callback,
-    State
-) ->
+on_batch_query_async(InstId, Requests, Callback, State) ->
     do_batch_query(InstId, Requests, {async, Callback}, State).
 
-do_batch_query(
-    InstId,
-    Requests,
-    Async,
-    #{pool_name := PoolName} = State
-) ->
+do_batch_query(InstId, Requests, Async, #{pool_name := PoolName} = State) ->
     CQLs =
         lists:map(
             fun(Request) ->
-                {Type, PreparedKeyOrSQL, Params} = parse_request_to_cql(Request),
-                proc_cql_params(Type, PreparedKeyOrSQL, Params, State)
+                {Type, PreparedKeyOrCQL, Params} = parse_request_to_cql(Request),
+                proc_cql_params(Type, PreparedKeyOrCQL, Params, State)
             end,
             Requests
         ),
@@ -256,26 +264,24 @@ do_batch_query(
     Res = exec_cql_batch_query(InstId, PoolName, Async, CQLs),
     handle_result(Res).
 
-parse_request_to_cql({send_message, Params}) ->
-    {prepared_query, _Key = send_message, Params};
-parse_request_to_cql({query, SQL}) ->
-    parse_request_to_cql({query, SQL, #{}});
-parse_request_to_cql({query, SQL, Params}) ->
-    {query, SQL, Params}.
+parse_request_to_cql({query, CQL}) ->
+    {query, CQL, #{}};
+parse_request_to_cql({query, CQL, Params}) ->
+    {query, CQL, Params};
+parse_request_to_cql({ChannId, Params}) ->
+    {prepared_query, ChannId, Params}.
 
-proc_cql_params(
-    prepared_query,
-    PreparedKey0,
-    Params,
-    #{prepare_statement := Prepares, params_tokens := ParamsTokens}
-) ->
-    %% assert
-    _PreparedKey = maps:get(PreparedKey0, Prepares),
-    Tokens = maps:get(PreparedKey0, ParamsTokens),
-    {PreparedKey0, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))};
-proc_cql_params(query, SQL, Params, _State) ->
-    {SQL1, Tokens} = emqx_placeholder:preproc_sql(SQL, '?'),
-    {SQL1, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))}.
+proc_cql_params(prepared_query, ChannId, Params, #{channels := Channs}) ->
+    #{
+        parsed_cql := #{
+            prepare_key := PrepareKey,
+            params_tokens := ParamsTokens
+        }
+    } = maps:get(ChannId, Channs),
+    {PrepareKey, assign_type_for_params(emqx_placeholder:proc_sql(ParamsTokens, Params))};
+proc_cql_params(query, CQL, Params, _State) ->
+    {CQL1, Tokens} = emqx_placeholder:preproc_sql(CQL, '?'),
+    {CQL1, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))}.
 
 exec_cql_query(InstId, PoolName, Type, Async, PreparedKey, Data) when
     Type == query; Type == prepared_query
@@ -314,38 +320,15 @@ exec_cql_batch_query(InstId, PoolName, Async, CQLs) ->
 exec(PoolName, Query) ->
     ecpool:pick_and_do(PoolName, Query, no_handover).
 
-on_get_status(_InstId, #{pool_name := PoolName} = State) ->
+on_get_status(_InstId, #{pool_name := PoolName}) ->
     case emqx_resource_pool:health_check_workers(PoolName, fun ?MODULE:do_get_status/1) of
-        true ->
-            case do_check_prepares(State) of
-                ok ->
-                    connected;
-                {ok, NState} ->
-                    %% return new state with prepared statements
-                    {connected, NState};
-                false ->
-                    %% do not log error, it is logged in prepare_cql_to_conn
-                    connecting
-            end;
-        false ->
-            connecting
+        true -> connected;
+        false -> connecting
     end.
 
 do_get_status(Conn) ->
     ok == element(1, ecql:query(Conn, "SELECT cluster_name FROM system.local")).
 
-do_check_prepares(#{prepare_cql := Prepares}) when is_map(Prepares) ->
-    ok;
-do_check_prepares(State = #{pool_name := PoolName, prepare_cql := {error, Prepares}}) ->
-    %% retry to prepare
-    case prepare_cql(Prepares, PoolName) of
-        {ok, Sts} ->
-            %% remove the error
-            {ok, State#{prepare_cql => Prepares, prepare_statement := Sts}};
-        _Error ->
-            false
-    end.
-
 %%--------------------------------------------------------------------
 %% callbacks query
 
@@ -394,88 +377,50 @@ conn_opts([Opt | Opts], Acc) ->
 
 %%--------------------------------------------------------------------
 %% prepare
-
-%% XXX: hardcode
-%% note: the `cql` param is passed by emqx_bridge_cassandra
-parse_prepare_cql(#{cql := SQL}) ->
-    parse_prepare_cql([{send_message, SQL}], #{}, #{});
-parse_prepare_cql(_) ->
-    #{prepare_cql => #{}, params_tokens => #{}}.
-
-parse_prepare_cql([{Key, H} | T], Prepares, Tokens) ->
-    {PrepareSQL, ParamsTokens} = emqx_placeholder:preproc_sql(H, '?'),
-    parse_prepare_cql(
-        T, Prepares#{Key => PrepareSQL}, Tokens#{Key => ParamsTokens}
-    );
-parse_prepare_cql([], Prepares, Tokens) ->
-    #{
-        prepare_cql => Prepares,
-        params_tokens => Tokens
-    }.
-
-init_prepare(State = #{prepare_cql := Prepares, pool_name := PoolName}) ->
-    case maps:size(Prepares) of
-        0 ->
-            State;
-        _ ->
-            case prepare_cql(Prepares, PoolName) of
-                {ok, Sts} ->
-                    State#{prepare_statement := Sts};
-                Error ->
-                    ?tp(
-                        error,
-                        cassandra_prepare_cql_failed,
-                        #{prepares => Prepares, reason => Error}
-                    ),
-                    %% mark the prepare_cql as failed
-                    State#{prepare_cql => {error, Prepares}}
-            end
-    end.
-
-prepare_cql(Prepares, PoolName) when is_map(Prepares) ->
-    prepare_cql(maps:to_list(Prepares), PoolName);
-prepare_cql(Prepares, PoolName) ->
-    case do_prepare_cql(Prepares, PoolName) of
-        {ok, _Sts} = Ok ->
+prepare_cql_to_cassandra(ParsedCql, PoolName) ->
+    case prepare_cql_to_cassandra(ecpool:workers(PoolName), ParsedCql, #{}) of
+        {ok, Statement} ->
             %% prepare for reconnect
-            ecpool:add_reconnect_callback(PoolName, {?MODULE, prepare_cql_to_conn, [Prepares]}),
-            Ok;
+            ecpool:add_reconnect_callback(PoolName, {?MODULE, prepare_cql_to_conn, [ParsedCql]}),
+            {ok, Statement};
         Error ->
+            ?tp(
+                error,
+                cassandra_prepare_cql_failed,
+                #{parsed_cql => ParsedCql, reason => Error}
+            ),
             Error
     end.
 
-do_prepare_cql(Prepares, PoolName) ->
-    do_prepare_cql(ecpool:workers(PoolName), Prepares, #{}).
-
-do_prepare_cql([{_Name, Worker} | T], Prepares, _LastSts) ->
+prepare_cql_to_cassandra([{_Name, Worker} | T], ParsedCql, _LastSts) ->
     {ok, Conn} = ecpool_worker:client(Worker),
-    case prepare_cql_to_conn(Conn, Prepares) of
-        {ok, Sts} ->
-            do_prepare_cql(T, Prepares, Sts);
+    case prepare_cql_to_conn(Conn, ParsedCql) of
+        {ok, Statement} ->
+            prepare_cql_to_cassandra(T, ParsedCql, Statement);
         Error ->
             Error
     end;
-do_prepare_cql([], _Prepares, LastSts) ->
+prepare_cql_to_cassandra([], _ParsedCql, LastSts) ->
     {ok, LastSts}.
 
-prepare_cql_to_conn(Conn, Prepares) ->
-    prepare_cql_to_conn(Conn, Prepares, #{}).
-
-prepare_cql_to_conn(Conn, [], Statements) when is_pid(Conn) -> {ok, Statements};
-prepare_cql_to_conn(Conn, [{Key, SQL} | PrepareList], Statements) when is_pid(Conn) ->
-    ?SLOG(info, #{msg => "cassandra_prepare_cql", name => Key, prepare_cql => SQL}),
-    case ecql:prepare(Conn, Key, SQL) of
+prepare_cql_to_conn(Conn, #{prepare_key := PrepareKey, prepare_cql := PrepareCQL}) when
+    is_pid(Conn)
+->
+    ?SLOG(info, #{
+        msg => "cassandra_prepare_cql", prepare_key => PrepareKey, prepare_cql => PrepareCQL
+    }),
+    case ecql:prepare(Conn, PrepareKey, PrepareCQL) of
         {ok, Statement} ->
-            prepare_cql_to_conn(Conn, PrepareList, Statements#{Key => Statement});
-        {error, Error} = Other ->
+            {ok, Statement};
+        {error, Reason} = Error ->
             ?SLOG(error, #{
                 msg => "cassandra_prepare_cql_failed",
                 worker_pid => Conn,
-                name => Key,
-                prepare_cql => SQL,
-                error => Error
+                name => PrepareKey,
+                prepare_cql => PrepareCQL,
+                reason => Reason
             }),
-            Other
+            Error
     end.
 
 handle_result({error, disconnected}) ->
@@ -487,6 +432,9 @@ handle_result({error, Error}) ->
 handle_result(Res) ->
     Res.
 
+transform_bridge_v1_config_to_connector_config(_) ->
+    ok.
+
 %%--------------------------------------------------------------------
 %% utils
 
@@ -513,3 +461,11 @@ maybe_assign_type(V) when is_integer(V) ->
 maybe_assign_type(V) when is_float(V) -> {double, V};
 maybe_assign_type(V) ->
     V.
+
+short_prepare_key(Str) when is_binary(Str) ->
+    true = size(Str) > 0,
+    Sha = crypto:hash(sha, Str),
+    %% TODO: change to binary:encode_hex(X, lowercase) when OTP version is always > 25
+    Hex = string:lowercase(binary:encode_hex(Sha)),
+    <<UniqueEnough:16/binary, _/binary>> = Hex,
+    binary_to_atom(<<"cassa_prepare_key:", UniqueEnough/binary>>).
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index e0e3900b0..77aec7d99 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -301,17 +301,28 @@ send_message(Config, Payload) ->
 query_resource(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => 1_000}).
+    BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
+    ConnectorResId = emqx_connector_resource:resource_id(
+        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
+    ),
+    emqx_resource:query(BridgeV2Id, Request, #{
+        timeout => 1_000, connector_resource_id => ConnectorResId
+    }).
 
 query_resource_async(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
     Ref = alias([reply]),
     AsyncReplyFun = fun(Result) -> Ref ! {result, Ref, Result} end,
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    Return = emqx_resource:query(ResourceID, Request, #{
-        timeout => 500, async_reply_fun => {AsyncReplyFun, []}
+    BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
+    ConnectorResId = emqx_connector_resource:resource_id(
+        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
+    ),
+    Return = emqx_resource:query(BridgeV2Id, Request, #{
+        timeout => 500,
+        async_reply_fun => {AsyncReplyFun, []},
+        connector_resource_id => ConnectorResId,
+        query_mode => async
     }),
     {Return, Ref}.
 
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
index 245110de6..50d82397a 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE.erl
@@ -22,10 +22,6 @@
 %%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
 %%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_connector_SUITE
 
-%% Cassandra servers are defined at `.ci/docker-compose-file/docker-compose-cassandra.yaml`
-%% You can change it to `127.0.0.1`, if you run this SUITE locally
--define(CASSANDRA_HOST, "cassandra").
--define(CASSANDRA_HOST_NOAUTH, "cassandra_noauth").
 -define(CASSANDRA_RESOURCE_MOD, emqx_bridge_cassandra_connector).
 
 %% Cassandra default username & password once enable `authenticator: PasswordAuthenticator`
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 90c1ae1ce..077723538 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -36,6 +36,8 @@ resource_type(mongodb) ->
     emqx_bridge_mongodb_connector;
 resource_type(influxdb) ->
     emqx_bridge_influxdb_connector;
+resource_type(cassandra) ->
+    emqx_bridge_cassandra_connector;
 resource_type(mysql) ->
     emqx_bridge_mysql_connector;
 resource_type(pgsql) ->
@@ -134,6 +136,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {cassandra,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_cassandra, "config_connector")),
+                #{
+                    desc => <<"Cassandra Connector Config">>,
+                    required => false
+                }
+            )},
         {mysql,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_mysql, "config_connector")),
@@ -217,6 +227,7 @@ schema_modules() ->
         emqx_bridge_matrix,
         emqx_bridge_mongodb,
         emqx_bridge_influxdb,
+        emqx_bridge_cassandra,
         emqx_bridge_mysql,
         emqx_bridge_syskeeper_connector,
         emqx_bridge_syskeeper_proxy,
@@ -247,6 +258,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_matrix, <<"matrix">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mongodb, <<"mongodb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_influxdb, <<"influxdb">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_cassandra, <<"cassandra">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mysql, <<"mysql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_syskeeper_connector, <<"syskeeper_forwarder">>, Method),
         api_ref(emqx_bridge_syskeeper_proxy, <<"syskeeper_proxy">>, Method),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 1829e04e6..3c5fdfc03 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -137,6 +137,8 @@ connector_type_to_bridge_types(mongodb) ->
     [mongodb, mongodb_rs, mongodb_sharded, mongodb_single];
 connector_type_to_bridge_types(influxdb) ->
     [influxdb, influxdb_api_v1, influxdb_api_v2];
+connector_type_to_bridge_types(cassandra) ->
+    [cassandra];
 connector_type_to_bridge_types(mysql) ->
     [mysql];
 connector_type_to_bridge_types(mqtt) ->
diff --git a/rel/i18n/emqx_bridge_cassandra.hocon b/rel/i18n/emqx_bridge_cassandra.hocon
index a96315340..29eb35de5 100644
--- a/rel/i18n/emqx_bridge_cassandra.hocon
+++ b/rel/i18n/emqx_bridge_cassandra.hocon
@@ -1,5 +1,15 @@
 emqx_bridge_cassandra {
 
+action_parameters.desc:
+"""Action specific configs."""
+action_parameters.label:
+"""Action"""
+
+cassandra_action.desc:
+"""Action configs."""
+cassandra_action.label:
+"""Action"""
+
 config_enable.desc:
 """Enable or disable this bridge"""
 
diff --git a/rel/i18n/emqx_bridge_cassandra_connector.hocon b/rel/i18n/emqx_bridge_cassandra_connector.hocon
index b149cce8a..40e1c0e22 100644
--- a/rel/i18n/emqx_bridge_cassandra_connector.hocon
+++ b/rel/i18n/emqx_bridge_cassandra_connector.hocon
@@ -1,5 +1,11 @@
 emqx_bridge_cassandra_connector {
 
+config.desc:
+"""Cassandra connection config"""
+
+config.label:
+"""Connection config"""
+
 keyspace.desc:
 """Keyspace name to connect to."""
 

From 5cd9f495588037bebbc8fc36892b8b3ce99b40bc Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Sun, 21 Jan 2024 21:00:38 +0800
Subject: [PATCH 054/273] ci: update generated connector name

---
 .../test/emqx_bridge_cassandra_SUITE.erl                  | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index 77aec7d99..09deaa699 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -302,9 +302,7 @@ query_resource(Config, Request) ->
     Name = ?config(cassa_name, Config),
     BridgeType = ?config(cassa_bridge_type, Config),
     BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
-    ConnectorResId = emqx_connector_resource:resource_id(
-        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
-    ),
+    ConnectorResId = emqx_connector_resource:resource_id(BridgeType, Name),
     emqx_resource:query(BridgeV2Id, Request, #{
         timeout => 1_000, connector_resource_id => ConnectorResId
     }).
@@ -315,9 +313,7 @@ query_resource_async(Config, Request) ->
     Ref = alias([reply]),
     AsyncReplyFun = fun(Result) -> Ref ! {result, Ref, Result} end,
     BridgeV2Id = emqx_bridge_v2:id(BridgeType, Name),
-    ConnectorResId = emqx_connector_resource:resource_id(
-        cassandra, <<"connector_emqx_bridge_cassandra_SUITE">>
-    ),
+    ConnectorResId = emqx_connector_resource:resource_id(BridgeType, Name),
     Return = emqx_resource:query(BridgeV2Id, Request, #{
         timeout => 500,
         async_reply_fun => {AsyncReplyFun, []},

From f0cde3fc5bc42b36327635fc37fa07cdec21ef5a Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Mon, 22 Jan 2024 15:45:00 +0800
Subject: [PATCH 055/273] chore: update change logs for cassandra bridge_v2

---
 changes/ee/feat-12330.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12330.en.md

diff --git a/changes/ee/feat-12330.en.md b/changes/ee/feat-12330.en.md
new file mode 100644
index 000000000..963098659
--- /dev/null
+++ b/changes/ee/feat-12330.en.md
@@ -0,0 +1 @@
+The bridges for Cassandra have been split so they are available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.

From e4c683d6f8e54d2d36380f658c4ad4a151f1c63b Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 23 Jan 2024 14:14:23 +0800
Subject: [PATCH 056/273] chore: update ecql to 0.6.0

---
 apps/emqx_bridge_cassandra/rebar.config               |  2 +-
 .../src/emqx_bridge_cassandra_connector.erl           | 11 +++--------
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/apps/emqx_bridge_cassandra/rebar.config b/apps/emqx_bridge_cassandra/rebar.config
index c0a72fef9..04ee603fa 100644
--- a/apps/emqx_bridge_cassandra/rebar.config
+++ b/apps/emqx_bridge_cassandra/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.5.2"}}},
+    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.6.0"}}},
     {emqx_connector, {path, "../../apps/emqx_connector"}},
     {emqx_resource, {path, "../../apps/emqx_resource"}},
     {emqx_bridge, {path, "../../apps/emqx_bridge"}}
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index 3db71c9e0..3b30f1d26 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -159,7 +159,7 @@ on_add_channel(_InstId, #{channels := Channs} = OldState, ChannId, ChannConf0) -
     #{parameters := #{cql := CQL}} = ChannConf0,
     {PrepareCQL, ParamsTokens} = emqx_placeholder:preproc_sql(CQL, '?'),
     ParsedCql = #{
-        prepare_key => short_prepare_key(ChannId),
+        prepare_key => make_prepare_key(ChannId),
         prepare_cql => PrepareCQL,
         params_tokens => ParamsTokens
     },
@@ -462,10 +462,5 @@ maybe_assign_type(V) when is_float(V) -> {double, V};
 maybe_assign_type(V) ->
     V.
 
-short_prepare_key(Str) when is_binary(Str) ->
-    true = size(Str) > 0,
-    Sha = crypto:hash(sha, Str),
-    %% TODO: change to binary:encode_hex(X, lowercase) when OTP version is always > 25
-    Hex = string:lowercase(binary:encode_hex(Sha)),
-    <<UniqueEnough:16/binary, _/binary>> = Hex,
-    binary_to_atom(<<"cassa_prepare_key:", UniqueEnough/binary>>).
+make_prepare_key(ChannId) ->
+    ChannId.

From 9003bc5b7228210a67eeaaede59f8865a7336097 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Mon, 22 Jan 2024 18:18:17 -0300
Subject: [PATCH 057/273] perf(ds): inherit only LTS paths containing wildcards
 when adding a new generation

Fixes https://github.com/emqx/emqx/pull/12338#discussion_r1462139499
---
 apps/emqx_durable_storage/src/emqx_ds_lts.erl | 148 +++++++++++++++++-
 .../src/emqx_ds_storage_bitfield_lts.erl      |  27 ++--
 2 files changed, 152 insertions(+), 23 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
index 9d87cf571..226af62f0 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
@@ -20,7 +20,7 @@
 -export([
     trie_create/1, trie_create/0,
     trie_restore/2,
-    trie_restore_existing/2,
+    trie_copy_learned_paths/2,
     topic_key/3,
     match_topics/2,
     lookup_topic_key/2
@@ -120,10 +120,6 @@ trie_create() ->
 -spec trie_restore(options(), [{_Key, _Val}]) -> trie().
 trie_restore(Options, Dump) ->
     Trie = trie_create(Options),
-    trie_restore_existing(Trie, Dump).
-
--spec trie_restore_existing(trie(), [{_Key, _Val}]) -> trie().
-trie_restore_existing(Trie, Dump) ->
     lists:foreach(
         fun({{StateFrom, Token}, StateTo}) ->
             trie_insert(Trie, StateFrom, Token, StateTo)
@@ -132,6 +128,17 @@ trie_restore_existing(Trie, Dump) ->
     ),
     Trie.
 
+-spec trie_copy_learned_paths(trie(), trie()) -> trie().
+trie_copy_learned_paths(OldTrie, NewTrie) ->
+    WildcardPaths = [P || P <- paths(OldTrie), contains_wildcard(P)],
+    lists:foreach(
+        fun({{StateFrom, Token}, StateTo}) ->
+            trie_insert(NewTrie, StateFrom, Token, StateTo)
+        end,
+        lists:flatten(WildcardPaths)
+    ),
+    NewTrie.
+
 %% @doc Lookup the topic key. Create a new one, if not found.
 -spec topic_key(trie(), threshold_fun(), [binary() | '']) -> msg_storage_key().
 topic_key(Trie, ThresholdFun, Tokens) ->
@@ -385,6 +392,41 @@ emanating(#trie{trie = Tab}, State, Token) when is_binary(Token); Token =:= '' -
                 ets:lookup(Tab, {State, Token})
     ].
 
+all_emanating(#trie{trie = Tab}, State) ->
+    ets:select(
+        Tab,
+        ets:fun2ms(fun(#trans{key = {S, Edge}, next = Next}) when S == State ->
+            {{S, Edge}, Next}
+        end)
+    ).
+
+paths(#trie{} = T) ->
+    Roots = all_emanating(T, ?PREFIX),
+    lists:flatmap(
+        fun({Segment, Next}) ->
+            follow_path(T, Next, [{Segment, Next}])
+        end,
+        Roots
+    ).
+
+follow_path(#trie{} = T, State, Path) ->
+    lists:flatmap(
+        fun
+            ({{_State, ?EOT}, _Next} = Segment) ->
+                [lists:reverse([Segment | Path])];
+            ({_Edge, Next} = Segment) ->
+                follow_path(T, Next, [Segment | Path])
+        end,
+        all_emanating(T, State)
+    ).
+
+contains_wildcard([{{_State, ?PLUS}, _Next} | _Rest]) ->
+    true;
+contains_wildcard([_ | Rest]) ->
+    contains_wildcard(Rest);
+contains_wildcard([]) ->
+    false.
+
 %%================================================================================
 %% Tests
 %%================================================================================
@@ -636,4 +678,100 @@ test_key(Trie, Threshold, Topic0) ->
     {ok, Ret} = lookup_topic_key(Trie, Topic),
     Ret.
 
+paths_test() ->
+    T = trie_create(),
+    Threshold = 4,
+    ThresholdFun = fun
+        (0) -> 1000;
+        (_) -> Threshold
+    end,
+    PathsToInsert =
+        [
+            [''],
+            [1],
+            [2, 2],
+            [3, 3, 3],
+            [2, 3, 4]
+        ] ++ [[4, I, 4] || I <- lists:seq(1, Threshold + 2)] ++
+            [['', I, ''] || I <- lists:seq(1, Threshold + 2)],
+    lists:foreach(
+        fun(PathSpec) ->
+            test_key(T, ThresholdFun, PathSpec)
+        end,
+        PathsToInsert
+    ),
+
+    %% Test that the paths we've inserted are produced in the output
+    Paths = paths(T),
+    FormattedPaths = lists:map(fun format_path/1, Paths),
+    ExpectedWildcardPaths =
+        [
+            [4, '+', 4],
+            ['', '+', '']
+        ],
+    ExpectedPaths =
+        [
+            [''],
+            [1],
+            [2, 2],
+            [3, 3, 3]
+        ] ++ [[4, I, 4] || I <- lists:seq(1, Threshold)] ++
+            [['', I, ''] || I <- lists:seq(1, Threshold)] ++
+            ExpectedWildcardPaths,
+    FormatPathSpec =
+        fun(PathSpec) ->
+            lists:map(
+                fun
+                    (I) when is_integer(I) -> integer_to_binary(I);
+                    (A) -> A
+                end,
+                PathSpec
+            ) ++ [?EOT]
+        end,
+    lists:foreach(
+        fun(PathSpec) ->
+            Path = FormatPathSpec(PathSpec),
+            ?assert(
+                lists:member(Path, FormattedPaths),
+                #{
+                    paths => FormattedPaths,
+                    expected_path => Path
+                }
+            )
+        end,
+        ExpectedPaths
+    ),
+
+    %% Test filter function for paths containing wildcards
+    WildcardPaths = lists:filter(fun contains_wildcard/1, Paths),
+    FormattedWildcardPaths = lists:map(fun format_path/1, WildcardPaths),
+    ?assertEqual(
+        sets:from_list(FormattedWildcardPaths, [{version, 2}]),
+        sets:from_list(lists:map(FormatPathSpec, ExpectedWildcardPaths), [{version, 2}]),
+        #{
+            expected => ExpectedWildcardPaths,
+            wildcards => FormattedWildcardPaths
+        }
+    ),
+
+    %% Test that we're able to reconstruct the same trie from the paths
+    T2 = trie_create(),
+    [
+        trie_insert(T2, State, Edge, Next)
+     || Path <- Paths,
+        {{State, Edge}, Next} <- Path
+    ],
+    #trie{trie = Tab1} = T,
+    #trie{trie = Tab2} = T2,
+    Dump1 = sets:from_list(ets:tab2list(Tab1), [{version, 2}]),
+    Dump2 = sets:from_list(ets:tab2list(Tab2), [{version, 2}]),
+    ?assertEqual(Dump1, Dump2),
+
+    ok.
+
+format_path([{{_State, Edge}, _Next} | Rest]) ->
+    [Edge | format_path(Rest)];
+format_path([]) ->
+    [].
+
 -endif.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index 2a3086a57..d407dab41 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -205,17 +205,15 @@ open(_Shard, DBHandle, GenId, CFRefs, Schema) ->
     s().
 post_creation_actions(
     #{
-        db := DBHandle,
-        old_gen_id := OldGenId,
-        old_cf_refs := OldCFRefs,
-        new_gen_runtime_data := NewGenData0
+        new_gen_runtime_data := NewGenData,
+        old_gen_runtime_data := OldGenData
     }
 ) ->
-    {_, OldTrieCF} = lists:keyfind(trie_cf(OldGenId), 1, OldCFRefs),
-    #s{trie = NewTrie0} = NewGenData0,
-    NewTrie = copy_previous_trie(DBHandle, NewTrie0, OldTrieCF),
+    #s{trie = OldTrie} = OldGenData,
+    #s{trie = NewTrie0} = NewGenData,
+    NewTrie = copy_previous_trie(OldTrie, NewTrie0),
     ?tp(bitfield_lts_inherited_trie, #{}),
-    NewGenData0#s{trie = NewTrie}.
+    NewGenData#s{trie = NewTrie}.
 
 -spec drop(
     emqx_ds_storage_layer:shard_id(),
@@ -533,16 +531,9 @@ restore_trie(TopicIndexBytes, DB, CF) ->
         rocksdb:iterator_close(IT)
     end.
 
--spec copy_previous_trie(rocksdb:db_handle(), emqx_ds_lts:trie(), rocksdb:cf_handle()) ->
-    emqx_ds_lts:trie().
-copy_previous_trie(DBHandle, NewTrie, OldCF) ->
-    {ok, IT} = rocksdb:iterator(DBHandle, OldCF, []),
-    try
-        OldDump = read_persisted_trie(IT, rocksdb:iterator_move(IT, first)),
-        emqx_ds_lts:trie_restore_existing(NewTrie, OldDump)
-    after
-        rocksdb:iterator_close(IT)
-    end.
+-spec copy_previous_trie(emqx_ds_lts:trie(), emqx_ds_lts:trie()) -> emqx_ds_lts:trie().
+copy_previous_trie(OldTrie, NewTrie) ->
+    emqx_ds_lts:trie_copy_learned_paths(OldTrie, NewTrie).
 
 read_persisted_trie(IT, {ok, KeyB, ValB}) ->
     [

From 024ffe29092dee3ee3841dc97574cad6a8578757 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 23 Jan 2024 09:47:03 -0300
Subject: [PATCH 058/273] test(ds): reduce flakiness

---
 .../test/emqx_persistent_messages_SUITE.erl     | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index 73c88adc8..36c8848cf 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -438,10 +438,19 @@ t_message_gc(Config) ->
             TopicFilter = emqx_topic:words(<<"#">>),
             StartTime = 0,
             Msgs = consume(TopicFilter, StartTime),
-            %% only "1" and "2" should have been GC'ed
-            ?assertEqual(
-                sets:from_list([<<"3">>, <<"4">>], [{version, 2}]),
-                sets:from_list([emqx_message:payload(Msg) || Msg <- Msgs], [{version, 2}])
+            %% "1" and "2" should have been GC'ed
+            PresentMessages = sets:from_list(
+                [emqx_message:payload(Msg) || Msg <- Msgs],
+                [{version, 2}]
+            ),
+            ?assert(
+                sets:is_empty(
+                    sets:intersection(
+                        PresentMessages,
+                        sets:from_list([<<"1">>, <<"2">>], [{version, 2}])
+                    )
+                ),
+                #{present_messages => PresentMessages}
             ),
 
             ok

From 3897f5bc877b87c381d05a77ad356f7d888f3d80 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jan 2024 03:44:31 +0000
Subject: [PATCH 059/273] chore(deps): bump the actions-package-macos group

Bumps the actions-package-macos group in /.github/actions/package-macos with 1 update: [actions/cache](https://github.com/actions/cache).


Updates `actions/cache` from 3.3.3 to 4.0.0
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/e12d46a63a90f2fae62d114769bbf2a179198b5c...13aacd865c20de90d75de3b17ebe84f7a17d57d2)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-package-macos
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/actions/package-macos/action.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/actions/package-macos/action.yaml b/.github/actions/package-macos/action.yaml
index 64d179b46..1553576b2 100644
--- a/.github/actions/package-macos/action.yaml
+++ b/.github/actions/package-macos/action.yaml
@@ -51,7 +51,7 @@ runs:
             echo "SELF_HOSTED=false" >> $GITHUB_OUTPUT
             ;;
         esac
-    - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
+    - uses: actions/cache@13aacd865c20de90d75de3b17ebe84f7a17d57d2 # v4.0.0
       id: cache
       if: steps.prepare.outputs.SELF_HOSTED != 'true'
       with:

From 9afb5f661cbde30d1143f321e74a1c946cf25935 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Wed, 24 Jan 2024 21:53:23 +0800
Subject: [PATCH 060/273] build: direct paths to avoid wildcard traversal of
 the _build dir

- erlfmt always try loop through files in the `--exclude-files` dir
---
 Makefile | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index 0ccd48410..47e665de2 100644
--- a/Makefile
+++ b/Makefile
@@ -316,10 +316,9 @@ $(foreach tt,$(ALL_ELIXIR_TGZS),$(eval $(call gen-elixir-tgz-target,$(tt))))
 .PHONY: fmt
 fmt: $(REBAR)
 	@$(SCRIPTS)/erlfmt -w 'apps/*/{src,include,priv,test,integration_test}/**/*.{erl,hrl,app.src,eterm}'
-	@$(SCRIPTS)/erlfmt -w '**/*.escript' --exclude-files '_build/**'
-	@$(SCRIPTS)/erlfmt -w '**/rebar.config' --exclude-files '_build/**'
-	@$(SCRIPTS)/erlfmt -w 'rebar.config.erl'
-	@$(SCRIPTS)/erlfmt -w 'bin/nodetool'
+	@$(SCRIPTS)/erlfmt -w 'apps/*/rebar.config' 'apps/emqx/rebar.config.script' '.ci/fvt_tests/http_server/rebar.config'
+	@$(SCRIPTS)/erlfmt -w 'rebar.config' 'rebar.config.erl'
+	@$(SCRIPTS)/erlfmt -w 'scripts/*.escript' 'bin/*.escript' 'bin/nodetool'
 	@mix format
 
 .PHONY: clean-test-cluster-config

From 846ad42a65279f786db832181c14c214adc51e71 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Wed, 24 Jan 2024 11:39:14 -0300
Subject: [PATCH 061/273] fix(ds): don't use env var for data dir default value

Fixes https://github.com/emqx/emqx/pull/12380
---
 apps/emqx/src/emqx_persistent_message.erl | 4 ++--
 apps/emqx/src/emqx_schema.erl             | 7 ++-----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index d725c9b2c..8e3755fdb 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -61,13 +61,13 @@ force_ds() ->
     emqx_config:get([session_persistence, force_persistence]).
 
 storage_backend(#{
-    builtin := #{
+    builtin := Opts = #{
         enable := true,
-        data_dir := DataDir,
         n_shards := NShards,
         replication_factor := ReplicationFactor
     }
 }) ->
+    DataDir = maps:get(data_dir, Opts, emqx:data_dir()),
     #{
         backend => builtin,
         data_dir => DataDir,
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index 56d575bd9..bbca13172 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1896,11 +1896,8 @@ fields("session_storage_backend_builtin") ->
                 string(),
                 #{
                     desc => ?DESC(session_builtin_data_dir),
-                    default => <<"${EMQX_DATA_DIR}">>,
-                    importance => ?IMPORTANCE_LOW,
-                    converter => fun(Path, Opts) ->
-                        naive_env_interpolation(ensure_unicode_path(Path, Opts))
-                    end
+                    required => false,
+                    importance => ?IMPORTANCE_LOW
                 }
             )},
         {"n_shards",

From aeefbe95447ee4340ef355c36266b2912f76692a Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 24 Jan 2024 18:42:24 +0100
Subject: [PATCH 062/273] fix(ds): Cache database metadata in RAM

---
 .../src/emqx_ds_replication_layer_meta.erl                    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
index 38c2dbbe7..16c52f20e 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
@@ -388,7 +388,7 @@ ensure_tables() ->
         {rlog_shard, ?SHARD},
         {majority, Majority},
         {type, ordered_set},
-        {storage, rocksdb_copies},
+        {storage, disc_copies},
         {record_name, ?META_TAB},
         {attributes, record_info(fields, ?META_TAB)}
     ]),
@@ -396,7 +396,7 @@ ensure_tables() ->
         {rlog_shard, ?SHARD},
         {majority, Majority},
         {type, ordered_set},
-        {storage, rocksdb_copies},
+        {storage, disc_copies},
         {record_name, ?NODE_TAB},
         {attributes, record_info(fields, ?NODE_TAB)}
     ]),

From cfad0923cf0b6cd6dd1706770d833e6d14d045c4 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 25 Jan 2024 11:50:01 +0100
Subject: [PATCH 063/273] chore: use macros for connector and action status
 atoms

---
 .../src/emqx_bridge_kinesis_impl_producer.erl | 24 ++++++++++---------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
index b71373897..10049a2a9 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_impl_producer.erl
@@ -88,7 +88,9 @@ on_stop(InstanceId, _State) ->
     emqx_resource_pool:stop(InstanceId).
 
 -spec on_get_status(resource_id(), state()) ->
-    connected | disconnected | {disconnected, state(), {unhealthy_target, string()}}.
+    ?status_connected
+    | ?status_disconnected
+    | {?status_disconnected, state(), {unhealthy_target, string()}}.
 on_get_status(_InstanceId, #{pool_name := Pool} = State) ->
     case
         emqx_resource_pool:health_check_workers(
@@ -99,15 +101,15 @@ on_get_status(_InstanceId, #{pool_name := Pool} = State) ->
         )
     of
         {ok, Values} ->
-            AllOk = lists:all(fun(S) -> S =:= {ok, connected} end, Values),
+            AllOk = lists:all(fun(S) -> S =:= {ok, ?status_connected} end, Values),
             case AllOk of
                 true ->
-                    connected;
+                    ?status_connected;
                 false ->
                     Unhealthy = lists:any(fun(S) -> S =:= {error, unhealthy_target} end, Values),
                     case Unhealthy of
-                        true -> {disconnected, State, {unhealthy_target, ?TOPIC_MESSAGE}};
-                        false -> disconnected
+                        true -> {?status_disconnected, State, {unhealthy_target, ?TOPIC_MESSAGE}};
+                        false -> ?status_disconnected
                     end
             end;
         {error, Reason} ->
@@ -116,7 +118,7 @@ on_get_status(_InstanceId, #{pool_name := Pool} = State) ->
                 state => State,
                 reason => Reason
             }),
-            disconnected
+            ?status_disconnected
     end.
 
 on_add_channel(
@@ -176,15 +178,15 @@ on_get_channel_status(
         )
     of
         {ok, Values} ->
-            AllOk = lists:all(fun(S) -> S =:= {ok, connected} end, Values),
+            AllOk = lists:all(fun(S) -> S =:= {ok, ?status_connected} end, Values),
             case AllOk of
                 true ->
-                    connected;
+                    ?status_connected;
                 false ->
                     Unhealthy = lists:any(fun(S) -> S =:= {error, unhealthy_target} end, Values),
                     case Unhealthy of
-                        true -> {disconnected, {unhealthy_target, ?TOPIC_MESSAGE}};
-                        false -> disconnected
+                        true -> {?status_disconnected, {unhealthy_target, ?TOPIC_MESSAGE}};
+                        false -> ?status_disconnected
                     end
             end;
         {error, Reason} ->
@@ -193,7 +195,7 @@ on_get_channel_status(
                 state => State,
                 reason => Reason
             }),
-            disconnected
+            ?status_disconnected
     end.
 
 on_get_channels(ResId) ->

From 2887a05ba32431e0d4aba299f3f799b41e5f0519 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 25 Jan 2024 12:48:31 +0100
Subject: [PATCH 064/273] refactor: simplify emqx_bridge_kinesis (thanks to
 @thalesmg's tips)

---
 .../src/emqx_bridge_kinesis.erl               | 148 ++++++------------
 .../src/emqx_bridge_kinesis_action_info.erl   |   2 +-
 2 files changed, 49 insertions(+), 101 deletions(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index 41717abe8..1ce62dcda 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -3,6 +3,7 @@
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_kinesis).
+
 -include_lib("typerefl/include/types.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
@@ -20,6 +21,9 @@
     connector_examples/1
 ]).
 
+-define(CONNECTOR_TYPE, kinesis).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
+
 %%-------------------------------------------------------------------------------------------------
 %% `hocon_schema' API
 %%-------------------------------------------------------------------------------------------------
@@ -37,11 +41,11 @@ fields(Field) when
 ->
     emqx_connector_schema:api_fields(
         Field,
-        kinesis,
+        ?CONNECTOR_TYPE,
         connector_config_fields()
     );
 fields(action) ->
-    {kinesis,
+    {?ACTION_TYPE,
         hoconsc:mk(
             hoconsc:map(name, hoconsc:ref(?MODULE, kinesis_action)),
             #{
@@ -174,18 +178,12 @@ fields("config_connector") ->
         emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
 fields(connector_resource_opts) ->
     emqx_connector_schema:resource_opts_fields();
-fields("put_bridge_v2") ->
-    fields(kinesis_action);
-fields("get_bridge_v2") ->
-    fields(kinesis_action);
-fields("post_bridge_v2") ->
-    fields("post", kinesis, kinesis_action).
-
-fields("post", Type, StructName) ->
-    [type_field(Type), name_field() | fields(StructName)].
-
-type_field(Type) ->
-    {type, hoconsc:mk(hoconsc:enum([Type]), #{required => true, desc => ?DESC("desc_type")})}.
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(kinesis_action)).
 
 desc("config_producer") ->
     ?DESC("desc_config");
@@ -202,12 +200,12 @@ desc(connector_resource_opts) ->
 desc(_) ->
     undefined.
 
-conn_bridge_examples(Method) ->
+conn_bridge_examples(_Method) ->
     [
         #{
             <<"kinesis_producer">> => #{
                 summary => <<"Amazon Kinesis Producer Bridge">>,
-                value => values(producer, Method)
+                value => conn_bridge_values()
             }
         }
     ].
@@ -215,102 +213,52 @@ conn_bridge_examples(Method) ->
 connector_examples(Method) ->
     [
         #{
-            <<"kinesis">> => #{
-                summary => <<"Kinesis Connector">>,
-                value => values({Method, connector})
-            }
+            <<"kinesis">> =>
+                #{
+                    summary => <<"Kinesis Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_values()
+                    )
+                }
         }
     ].
 
-bridge_v2_examples(Method) ->
-    [
-        #{
-            <<"kinesis">> => #{
-                summary => <<"Kinesis Action">>,
-                value => values({Method, bridge_v2_producer})
-            }
-        }
-    ].
-
-values({get, connector}) ->
-    maps:merge(
-        #{
-            status => <<"connected">>,
-            node_status => [
-                #{
-                    node => <<"emqx@localhost">>,
-                    status => <<"connected">>
-                }
-            ],
-            actions => [<<"my_action">>]
-        },
-        values({post, connector})
-    );
-values({get, Type}) ->
-    maps:merge(
-        #{
-            status => <<"connected">>,
-            node_status => [
-                #{
-                    node => <<"emqx@localhost">>,
-                    status => <<"connected">>
-                }
-            ]
-        },
-        values({post, Type})
-    );
-values({post, connector}) ->
-    maps:merge(
-        #{
-            name => <<"my_kinesis_connector">>,
-            type => <<"kinesis">>
-        },
-        values(common_config)
-    );
-values({post, Type}) ->
-    maps:merge(
-        #{
-            name => <<"my_kinesis_action">>,
-            type => <<"kinesis">>
-        },
-        values({put, Type})
-    );
-values({put, bridge_v2_producer}) ->
-    values(bridge_v2_producer);
-values({put, connector}) ->
-    values(common_config);
-values({put, Type}) ->
-    maps:merge(values(common_config), values(Type));
-values(bridge_v2_producer) ->
+connector_values() ->
     #{
-        enable => true,
-        connector => <<"my_kinesis_connector">>,
-        parameters => values(producer_values),
-        resource_opts => #{
-            <<"batch_size">> => 100,
-            <<"inflight_window">> => 100,
-            <<"max_buffer_bytes">> => <<"256MB">>,
-            <<"request_ttl">> => <<"45s">>
-        }
-    };
-values(common_config) ->
-    #{
-        <<"enable">> => true,
         <<"aws_access_key_id">> => <<"your_access_key">>,
         <<"aws_secret_access_key">> => <<"aws_secret_key">>,
         <<"endpoint">> => <<"http://localhost:4566">>,
         <<"max_retries">> => 2,
         <<"pool_size">> => 8
-    };
-values(producer_values) ->
-    #{
-        <<"partition_key">> => <<"any_key">>,
-        <<"payload_template">> => <<"${.}">>,
-        <<"stream_name">> => <<"my_stream">>
     }.
 
-values(producer, _Method) ->
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"kinesis">> =>
+                #{
+                    summary => <<"Kinesis Action">>,
+                    value => emqx_bridge_v2_schema:action_values(
+                        Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                    )
+                }
+        }
+    ].
+
+action_values() ->
     #{
+        parameters => #{
+            <<"partition_key">> => <<"any_key">>,
+            <<"payload_template">> => <<"${.}">>,
+            <<"stream_name">> => <<"my_stream">>
+        }
+    }.
+
+conn_bridge_values() ->
+    #{
+        enable => true,
+        type => kinesis_producer,
+        name => <<"foo">>,
         aws_access_key_id => <<"aws_access_key_id">>,
         aws_secret_access_key => <<"******">>,
         endpoint => <<"https://kinesis.us-east-1.amazonaws.com">>,
diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl
index c7fb5e1e5..7987315e4 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis_action_info.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_kinesis_action_info).

From c37097a15062c53125de58c855c67e1c27e27aa6 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 25 Jan 2024 22:58:16 +0800
Subject: [PATCH 065/273] feat(dashboard): expose the `swagger_support` option

---
 apps/emqx_dashboard/src/emqx_dashboard.erl        | 3 ++-
 apps/emqx_dashboard/src/emqx_dashboard_schema.erl | 6 ++++++
 rel/i18n/emqx_dashboard_schema.hocon              | 5 +++++
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/apps/emqx_dashboard/src/emqx_dashboard.erl b/apps/emqx_dashboard/src/emqx_dashboard.erl
index a4438f6c7..85647e67a 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard.erl
@@ -76,7 +76,8 @@ start_listeners(Listeners) ->
         security => [#{'basicAuth' => []}, #{'bearerAuth' => []}],
         swagger_global_spec => GlobalSpec,
         dispatch => dispatch(),
-        middlewares => [?EMQX_MIDDLE, cowboy_router, cowboy_handler]
+        middlewares => [?EMQX_MIDDLE, cowboy_router, cowboy_handler],
+        swagger_support => emqx:get_config([dashboard, swagger_support], true)
     },
     {OkListeners, ErrListeners} =
         lists:foldl(
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_schema.erl b/apps/emqx_dashboard/src/emqx_dashboard_schema.erl
index 59be9706e..5577b47c8 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_schema.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_schema.erl
@@ -56,6 +56,7 @@ fields("dashboard") ->
                 }
             )},
         {cors, fun cors/1},
+        {swagger_support, fun swagger_support/1},
         {i18n_lang, fun i18n_lang/1},
         {bootstrap_users_file,
             ?HOCON(
@@ -272,6 +273,11 @@ cors(required) -> false;
 cors(desc) -> ?DESC(cors);
 cors(_) -> undefined.
 
+swagger_support(type) -> boolean();
+swagger_support(default) -> true;
+swagger_support(desc) -> ?DESC(swagger_support);
+swagger_support(_) -> undefined.
+
 %% TODO: change it to string type
 %% It will be up to the dashboard package which languages to support
 i18n_lang(type) -> ?ENUM([en, zh]);
diff --git a/rel/i18n/emqx_dashboard_schema.hocon b/rel/i18n/emqx_dashboard_schema.hocon
index 524e633aa..4ee5f32d8 100644
--- a/rel/i18n/emqx_dashboard_schema.hocon
+++ b/rel/i18n/emqx_dashboard_schema.hocon
@@ -143,4 +143,9 @@ ssl_options.desc:
 ssl_options.label:
 """SSL options"""
 
+swagger_support.desc:
+"""Enable or disable support for swagger API documentation."""
+
+swagger_support.label:
+"""Swagger Support"""
 }

From f47dacc5d0370cb00a72574572f0a690b5759739 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 25 Jan 2024 23:04:38 +0800
Subject: [PATCH 066/273] chore: update template for erlang_ls config

---
 scripts/gen-erlang-ls-config.sh | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/scripts/gen-erlang-ls-config.sh b/scripts/gen-erlang-ls-config.sh
index d1e6e44b7..0129a2f33 100755
--- a/scripts/gen-erlang-ls-config.sh
+++ b/scripts/gen-erlang-ls-config.sh
@@ -54,6 +54,8 @@ macros:
     value: ee
 code_reload:
   node: emqx@127.0.0.1
+formatting:
+  formatter: erlfmt
 EOF
 }
 

From 8e31afe6c2f8db8d3d21d591b275f21037e017af Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 25 Jan 2024 13:44:27 -0300
Subject: [PATCH 067/273] fix(ds): don't make data dir part of the schema

The data directory was ending up being persisted in the database schema.  This led to
issues when opening the DB on different nodes.
---
 apps/emqx/src/emqx_persistent_message.erl     |  4 +--
 apps/emqx/src/emqx_schema.erl                 |  1 +
 .../src/emqx_ds_storage_layer.erl             | 25 ++++++++-----------
 3 files changed, 13 insertions(+), 17 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_message.erl b/apps/emqx/src/emqx_persistent_message.erl
index effad17dd..b178a742c 100644
--- a/apps/emqx/src/emqx_persistent_message.erl
+++ b/apps/emqx/src/emqx_persistent_message.erl
@@ -61,16 +61,14 @@ force_ds() ->
     emqx_config:get([session_persistence, force_persistence]).
 
 storage_backend(#{
-    builtin := Opts = #{
+    builtin := #{
         enable := true,
         n_shards := NShards,
         replication_factor := ReplicationFactor
     }
 }) ->
-    DataDir = maps:get(data_dir, Opts, emqx:data_dir()),
     #{
         backend => builtin,
-        data_dir => DataDir,
         storage => {emqx_ds_storage_bitfield_lts, #{}},
         n_shards => NShards,
         replication_factor => ReplicationFactor
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index b03cfe72e..afbe2cfa7 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1896,6 +1896,7 @@ fields("session_storage_backend_builtin") ->
                 string(),
                 #{
                     desc => ?DESC(session_builtin_data_dir),
+                    mapping => "emqx_durable_storage.db_data_dir",
                     required => false,
                     importance => ?IMPORTANCE_LOW
                 }
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index 85a94a846..8f4b2afc6 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -36,7 +36,7 @@
 -export([start_link/2, init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2]).
 
 %% internal exports:
--export([db_dir/2]).
+-export([db_dir/1]).
 
 -export_type([
     gen_id/0,
@@ -52,6 +52,7 @@
 
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
+-define(APP, emqx_durable_storage).
 -define(REF(ShardId), {via, gproc, {n, l, {?MODULE, ShardId}}}).
 
 %%================================================================================
@@ -199,13 +200,7 @@ open_shard(Shard, Options) ->
 
 -spec drop_shard(shard_id()) -> ok.
 drop_shard(Shard) ->
-    case persistent_term:get({?MODULE, Shard, data_dir}, undefined) of
-        undefined ->
-            ok;
-        BaseDir ->
-            ok = rocksdb:destroy(db_dir(BaseDir, Shard), []),
-            persistent_term:erase({?MODULE, Shard, base_dir})
-    end.
+    ok = rocksdb:destroy(db_dir(Shard), []).
 
 -spec store_batch(shard_id(), [emqx_types:message()], emqx_ds:message_store_opts()) ->
     emqx_ds:store_batch_result().
@@ -589,8 +584,7 @@ rocksdb_open(Shard, Options) ->
         {enable_write_thread_adaptive_yield, false}
         | maps:get(db_options, Options, [])
     ],
-    DataDir = maps:get(data_dir, Options, emqx:data_dir()),
-    DBDir = db_dir(DataDir, Shard),
+    DBDir = db_dir(Shard),
     _ = filelib:ensure_dir(DBDir),
     ExistingCFs =
         case rocksdb:list_column_families(DBDir, DBOptions) of
@@ -606,16 +600,19 @@ rocksdb_open(Shard, Options) ->
     ],
     case rocksdb:open(DBDir, DBOptions, ColumnFamilies) of
         {ok, DBHandle, [_CFDefault | CFRefs]} ->
-            persistent_term:put({?MODULE, Shard, data_dir}, DataDir),
             {CFNames, _} = lists:unzip(ExistingCFs),
             {ok, DBHandle, lists:zip(CFNames, CFRefs)};
         Error ->
             Error
     end.
 
--spec db_dir(file:filename(), shard_id()) -> file:filename().
-db_dir(BaseDir, {DB, ShardId}) ->
-    filename:join([BaseDir, atom_to_list(DB), binary_to_list(ShardId)]).
+-spec db_dir(shard_id()) -> file:filename().
+db_dir({DB, ShardId}) ->
+    filename:join([base_dir(), atom_to_list(DB), binary_to_list(ShardId)]).
+
+-spec base_dir() -> file:filename().
+base_dir() ->
+    application:get_env(?APP, db_data_dir, emqx:data_dir()).
 
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->

From cc60b0296462fdd9f7f94ed0a3ad8b7b1cdbc02a Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 25 Jan 2024 14:58:54 -0300
Subject: [PATCH 068/273] ci: enable coveralls parallel send

Since we use coveralls' [parallel webhook
API](https://docs.coveralls.io/api-parallel-build-webhook), it seems we should also set it
in our [plugin
config](https://github.com/emqx/coveralls-erl/blob/02daa4e5f157ff16d10b41ce00b829bc8734a9e1/src/rebar3_coveralls.erl#L132).
---
 rebar.config.erl | 1 +
 1 file changed, 1 insertion(+)

diff --git a/rebar.config.erl b/rebar.config.erl
index e374959dc..21d741129 100644
--- a/rebar.config.erl
+++ b/rebar.config.erl
@@ -565,6 +565,7 @@ coveralls() ->
                 {coveralls_service_job_id, os:getenv("GITHUB_RUN_ID")},
                 {coveralls_commit_sha, os:getenv("GITHUB_SHA")},
                 {coveralls_coverdata, "_build/test/cover/*.coverdata"},
+                {coveralls_parallel, true},
                 {coveralls_service_name, "github"}
             ],
             case

From 726302ef6ae01ff61d049d4756a499e5aee25ba9 Mon Sep 17 00:00:00 2001
From: William Yang <mscame@gmail.com>
Date: Wed, 24 Jan 2024 23:57:10 +0100
Subject: [PATCH 069/273] perf: new ws listener option to disable UTF-8
 validation

---
 apps/emqx/src/emqx_schema.erl        | 8 ++++++++
 apps/emqx/src/emqx_ws_connection.erl | 3 ++-
 rel/i18n/emqx_schema.hocon           | 7 +++++++
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index afbe2cfa7..77340ca87 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1104,6 +1104,14 @@ fields("ws_opts") ->
             sc(
                 ref("deflate_opts"),
                 #{}
+            )},
+        {"validate_utf8",
+            sc(
+                boolean(),
+                #{
+                    default => true,
+                    desc => ?DESC(fields_ws_opts_validate_utf8)
+                }
             )}
     ];
 fields("tcp_opts") ->
diff --git a/apps/emqx/src/emqx_ws_connection.erl b/apps/emqx/src/emqx_ws_connection.erl
index 4a25494ad..1511eb6e0 100644
--- a/apps/emqx/src/emqx_ws_connection.erl
+++ b/apps/emqx/src/emqx_ws_connection.erl
@@ -205,7 +205,8 @@ init(Req, #{listener := {Type, Listener}} = Opts) ->
         compress => get_ws_opts(Type, Listener, compress),
         deflate_opts => get_ws_opts(Type, Listener, deflate_opts),
         max_frame_size => get_ws_opts(Type, Listener, max_frame_size),
-        idle_timeout => get_ws_opts(Type, Listener, idle_timeout)
+        idle_timeout => get_ws_opts(Type, Listener, idle_timeout),
+        validate_utf8 => get_ws_opts(Type, Listener, validate_utf8)
     },
     case check_origin_header(Req, Opts) of
         {error, Reason} ->
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index be16c765e..5ff4e063e 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1275,6 +1275,13 @@ fields_ws_opts_allow_origin_absence.desc:
 fields_ws_opts_allow_origin_absence.label:
 """Allow origin absence"""
 
+fields_ws_opts_validate_utf8.desc:
+"""Set to <code>false</code> to disable WebSocket Frame UTF-8
+  validation for performance"""
+
+fields_ws_opts_validate_utf8.label:
+"""Enable/Disable WebSocket Frame utf8 validation"""
+
 common_ssl_opts_schema_versions.desc:
 """All TLS/DTLS versions to be supported.<br/>
 NOTE: PSK ciphers are suppressed by 'tlsv1.3' version config.<br/>

From 85e9731617de762be28e2be5c67ebe18c03f3cd2 Mon Sep 17 00:00:00 2001
From: William Yang <mscame@gmail.com>
Date: Thu, 25 Jan 2024 10:01:22 +0100
Subject: [PATCH 070/273] docs: changelog

---
 changes/perf-12392.en.md | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 changes/perf-12392.en.md

diff --git a/changes/perf-12392.en.md b/changes/perf-12392.en.md
new file mode 100644
index 000000000..d44b80b91
--- /dev/null
+++ b/changes/perf-12392.en.md
@@ -0,0 +1,4 @@
+New WebSocket listener option: `validate_utf8` for performance tuning. 
+
+
+

From 2d693402c57e7f2d1c352179536c3f9488d8a585 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Wed, 17 Jan 2024 09:56:59 +0200
Subject: [PATCH 071/273] refactor: split greptimedb bridge to actions and
 connectors

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   3 +-
 apps/emqx_bridge_greptimedb/rebar.config      |   2 +-
 .../src/emqx_bridge_greptimedb.app.src        |   2 +-
 .../src/emqx_bridge_greptimedb.erl            | 136 +++++++++---
 .../emqx_bridge_greptimedb_action_info.erl    |  58 +++++
 .../src/emqx_bridge_greptimedb_connector.erl  | 206 ++++++++++++------
 .../test/emqx_bridge_greptimedb_SUITE.erl     |  15 +-
 ...emqx_bridge_greptimedb_connector_SUITE.erl |  28 ++-
 .../src/schema/emqx_connector_ee_schema.erl   |  16 +-
 .../src/schema/emqx_connector_schema.erl      |   4 +-
 changes/ee/feat-12386.en.md                   |   1 +
 mix.exs                                       |   2 +-
 rel/i18n/emqx_bridge_greptimedb.hocon         |  15 ++
 13 files changed, 368 insertions(+), 120 deletions(-)
 create mode 100644 apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_action_info.erl
 create mode 100644 changes/ee/feat-12386.en.md

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 7dce9d7cb..b495fa671 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -101,7 +101,8 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_redis_action_info,
         emqx_bridge_iotdb_action_info,
         emqx_bridge_es_action_info,
-        emqx_bridge_opents_action_info
+        emqx_bridge_opents_action_info,
+        emqx_bridge_greptimedb_action_info
     ].
 -else.
 hard_coded_action_info_modules_ee() ->
diff --git a/apps/emqx_bridge_greptimedb/rebar.config b/apps/emqx_bridge_greptimedb/rebar.config
index 170ced1e7..bb37de16e 100644
--- a/apps/emqx_bridge_greptimedb/rebar.config
+++ b/apps/emqx_bridge_greptimedb/rebar.config
@@ -6,7 +6,7 @@
     {emqx_connector, {path, "../../apps/emqx_connector"}},
     {emqx_resource, {path, "../../apps/emqx_resource"}},
     {emqx_bridge, {path, "../../apps/emqx_bridge"}},
-    {greptimedb, {git, "https://github.com/GreptimeTeam/greptimedb-client-erl", {tag, "v0.1.6"}}}
+    {greptimedb, {git, "https://github.com/GreptimeTeam/greptimedb-client-erl", {tag, "v0.1.7"}}}
 ]}.
 {plugins, [rebar3_path_deps]}.
 {project_plugins, [erlfmt]}.
diff --git a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
index 0875d13ba..b3ac508ad 100644
--- a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
+++ b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
@@ -8,7 +8,7 @@
         emqx_resource,
         greptimedb
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_greptimedb_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.erl b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.erl
index f5ae714d7..cf3586c73 100644
--- a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.erl
+++ b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.erl
@@ -10,10 +10,6 @@
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
 
--export([
-    conn_bridge_examples/1
-]).
-
 -export([
     namespace/0,
     roots/0,
@@ -21,6 +17,16 @@
     desc/1
 ]).
 
+%% Examples
+-export([
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
+]).
+
+-define(CONNECTOR_TYPE, greptimedb).
+-define(ACTION_TYPE, greptimedb).
+
 %% -------------------------------------------------------------------------------------------------
 %% api
 
@@ -29,44 +35,67 @@ conn_bridge_examples(Method) ->
         #{
             <<"greptimedb">> => #{
                 summary => <<"Greptimedb HTTP API V2 Bridge">>,
-                value => values("greptimedb", Method)
+                value => bridge_v1_values(Method)
             }
         }
     ].
 
-values(Protocol, get) ->
-    values(Protocol, post);
-values("greptimedb", post) ->
-    SupportUint = <<"uint_value=${payload.uint_key}u,">>,
-    TypeOpts = #{
-        bucket => <<"example_bucket">>,
-        org => <<"examlpe_org">>,
-        token => <<"example_token">>,
-        server => <<"127.0.0.1:4001">>
+bridge_v2_examples(Method) ->
+    ParamsExample = #{
+        parameters => #{
+            write_syntax => write_syntax_value(), precision => ms
+        }
     },
-    values(common, "greptimedb", SupportUint, TypeOpts);
-values(Protocol, put) ->
-    values(Protocol, post).
+    [
+        #{
+            <<"greptimedb">> => #{
+                summary => <<"GreptimeDB Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, greptimedb, greptimedb, ParamsExample
+                )
+            }
+        }
+    ].
 
-values(common, Protocol, SupportUint, TypeOpts) ->
-    CommonConfigs = #{
-        type => list_to_atom(Protocol),
+connector_examples(Method) ->
+    [
+        #{
+            <<"greptimedb">> => #{
+                summary => <<"GreptimeDB Connector">>,
+                value => emqx_connector_schema:connector_values(
+                    Method, greptimedb, connector_values(Method)
+                )
+            }
+        }
+    ].
+
+bridge_v1_values(_Method) ->
+    #{
+        type => greptimedb,
         name => <<"demo">>,
         enable => true,
         local_topic => <<"local/topic/#">>,
-        write_syntax =>
-            <<"${topic},clientid=${clientid}", " ", "payload=${payload},",
-                "${clientid}_int_value=${payload.int_key}i,", SupportUint/binary,
-                "bool=${payload.bool}">>,
+        write_syntax => write_syntax_value(),
         precision => ms,
         resource_opts => #{
             batch_size => 100,
             batch_time => <<"20ms">>
         },
+        username => <<"example_username">>,
+        password => <<"******">>,
+        dbname => <<"example_db">>,
         server => <<"127.0.0.1:4001">>,
         ssl => #{enable => false}
-    },
-    maps:merge(TypeOpts, CommonConfigs).
+    }.
+
+connector_values(Method) ->
+    maps:without([write_syntax, precision], bridge_v1_values(Method)).
+
+write_syntax_value() ->
+    <<"${topic},clientid=${clientid}", " ", "payload=${payload},",
+        "${clientid}_int_value=${payload.int_key}i,",
+        "uint_value=${payload.uint_key}u,"
+        "bool=${payload.bool}">>.
 
 %% -------------------------------------------------------------------------------------------------
 %% Hocon Schema Definitions
@@ -80,11 +109,50 @@ fields("put_grpc_v1") ->
     method_fields(put, greptimedb);
 fields("get_grpc_v1") ->
     method_fields(get, greptimedb);
-fields(Type) when
-    Type == greptimedb
-->
+fields(greptimedb = Type) ->
     greptimedb_bridge_common_fields() ++
-        connector_fields(Type).
+        connector_fields(Type);
+%% Actions
+fields(action) ->
+    {greptimedb,
+        mk(
+            hoconsc:map(name, ref(?MODULE, greptimedb_action)),
+            #{desc => <<"GreptimeDB Action Config">>, required => false}
+        )};
+fields(greptimedb_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(ref(?MODULE, action_parameters), #{
+            required => true, desc => ?DESC(action_parameters)
+        })
+    );
+fields(action_parameters) ->
+    [
+        {write_syntax, fun write_syntax/1},
+        emqx_bridge_greptimedb_connector:precision_field()
+    ];
+%% Connectors
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        emqx_bridge_greptimedb_connector:fields("connector") ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    Fields =
+        emqx_bridge_greptimedb_connector:fields("connector") ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
+%$ Bridge v2
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(greptimedb_action)).
 
 method_fields(post, ConnectorType) ->
     greptimedb_bridge_common_fields() ++
@@ -122,6 +190,14 @@ desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for Greptimedb using `", string:to_upper(Method), "` method."];
 desc(greptimedb) ->
     ?DESC(emqx_bridge_greptimedb_connector, "greptimedb");
+desc(greptimedb_action) ->
+    ?DESC(greptimedb_action);
+desc(action_parameters) ->
+    ?DESC(action_parameters);
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(_) ->
     undefined.
 
diff --git a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_action_info.erl b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_action_info.erl
new file mode 100644
index 000000000..c128e7101
--- /dev/null
+++ b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_action_info.erl
@@ -0,0 +1,58 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_greptimedb_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    action_type_name/0,
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_type_name/0,
+    connector_action_config_to_bridge_v1_config/2,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(SCHEMA_MODULE, emqx_bridge_greptimedb).
+-define(GREPTIMEDB_TYPE, greptimedb).
+
+action_type_name() -> ?GREPTIMEDB_TYPE.
+bridge_v1_type_name() -> ?GREPTIMEDB_TYPE.
+connector_type_name() -> ?GREPTIMEDB_TYPE.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(greptimedb_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ConnectorKeys = schema_keys("config_connector"),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        maps:with(ConnectorKeys, BridgeV1Config)
+    ).
+
+connector_action_config_to_bridge_v1_config(ConnectorRawConf, ActionRawConf) ->
+    emqx_action_info:connector_action_config_to_bridge_v1_config(
+        ConnectorRawConf, ActionRawConf
+    ).
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    [bin(Key) || Key <- proplists:get_keys(?SCHEMA_MODULE:fields(Name))].
diff --git a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_connector.erl b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_connector.erl
index af42dac52..0016af463 100644
--- a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_connector.erl
+++ b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb_connector.erl
@@ -4,7 +4,7 @@
 -module(emqx_bridge_greptimedb_connector).
 
 -include_lib("emqx_connector/include/emqx_connector.hrl").
-
+-include_lib("emqx_resource/include/emqx_resource.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("typerefl/include/types.hrl").
 -include_lib("emqx/include/logger.hrl").
@@ -19,6 +19,10 @@
     callback_mode/0,
     on_start/2,
     on_stop/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channel_status/3,
+    on_get_channels/1,
     on_query/3,
     on_batch_query/3,
     on_query_async/4,
@@ -34,6 +38,8 @@
     desc/1
 ]).
 
+-export([precision_field/0]).
+
 %% only for test
 -ifdef(TEST).
 -export([is_unrecoverable_error/1]).
@@ -62,6 +68,38 @@
 %% resource callback
 callback_mode() -> async_if_possible.
 
+on_add_channel(
+    _InstanceId,
+    #{channels := Channels} = OldState,
+    ChannelId,
+    #{parameters := Parameters} = ChannelConfig0
+) ->
+    #{write_syntax := WriteSyntaxTmpl} = Parameters,
+    Precision = maps:get(precision, Parameters, ms),
+    ChannelConfig = maps:merge(
+        Parameters,
+        ChannelConfig0#{
+            precision => Precision,
+            write_syntax => to_config(WriteSyntaxTmpl, Precision)
+        }
+    ),
+    {ok, OldState#{
+        channels => Channels#{ChannelId => ChannelConfig}
+    }}.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = State, ChannelId) ->
+    NewState = State#{channels => maps:remove(ChannelId, Channels)},
+    {ok, NewState}.
+
+on_get_channel_status(InstanceId, _ChannelId, State) ->
+    case on_get_status(InstanceId, State) of
+        ?status_connected -> ?status_connected;
+        _ -> ?status_connecting
+    end.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
 on_start(InstId, Config) ->
     %% InstID as pool would be handled by greptimedb client
     %% so there is no need to allocate pool_name here
@@ -78,8 +116,13 @@ on_stop(InstId, _State) ->
             ok
     end.
 
-on_query(InstId, {send_message, Data}, _State = #{write_syntax := SyntaxLines, client := Client}) ->
-    case data_to_points(Data, SyntaxLines) of
+on_query(InstId, {Channel, Message}, State) ->
+    #{
+        channels := #{Channel := #{write_syntax := SyntaxLines}},
+        client := Client,
+        dbname := DbName
+    } = State,
+    case data_to_points(Message, DbName, SyntaxLines) of
         {ok, Points} ->
             ?tp(
                 greptimedb_connector_send_query,
@@ -97,8 +140,13 @@ on_query(InstId, {send_message, Data}, _State = #{write_syntax := SyntaxLines, c
 
 %% Once a Batched Data trans to points failed.
 %% This batch query failed
-on_batch_query(InstId, BatchData, _State = #{write_syntax := SyntaxLines, client := Client}) ->
-    case parse_batch_data(InstId, BatchData, SyntaxLines) of
+on_batch_query(InstId, [{Channel, _} | _] = BatchData, State) ->
+    #{
+        channels := #{Channel := #{write_syntax := SyntaxLines}},
+        client := Client,
+        dbname := DbName
+    } = State,
+    case parse_batch_data(InstId, DbName, BatchData, SyntaxLines) of
         {ok, Points} ->
             ?tp(
                 greptimedb_connector_send_query,
@@ -113,13 +161,13 @@ on_batch_query(InstId, BatchData, _State = #{write_syntax := SyntaxLines, client
             {error, {unrecoverable_error, Reason}}
     end.
 
-on_query_async(
-    InstId,
-    {send_message, Data},
-    {ReplyFun, Args},
-    _State = #{write_syntax := SyntaxLines, client := Client}
-) ->
-    case data_to_points(Data, SyntaxLines) of
+on_query_async(InstId, {Channel, Message}, {ReplyFun, Args}, State) ->
+    #{
+        channels := #{Channel := #{write_syntax := SyntaxLines}},
+        client := Client,
+        dbname := DbName
+    } = State,
+    case data_to_points(Message, DbName, SyntaxLines) of
         {ok, Points} ->
             ?tp(
                 greptimedb_connector_send_query,
@@ -135,13 +183,13 @@ on_query_async(
             Err
     end.
 
-on_batch_query_async(
-    InstId,
-    BatchData,
-    {ReplyFun, Args},
-    #{write_syntax := SyntaxLines, client := Client}
-) ->
-    case parse_batch_data(InstId, BatchData, SyntaxLines) of
+on_batch_query_async(InstId, [{Channel, _} | _] = BatchData, {ReplyFun, Args}, State) ->
+    #{
+        channels := #{Channel := #{write_syntax := SyntaxLines}},
+        client := Client,
+        dbname := DbName
+    } = State,
+    case parse_batch_data(InstId, DbName, BatchData, SyntaxLines) of
         {ok, Points} ->
             ?tp(
                 greptimedb_connector_send_query,
@@ -159,9 +207,9 @@ on_batch_query_async(
 on_get_status(_InstId, #{client := Client}) ->
     case greptimedb:is_alive(Client) of
         true ->
-            connected;
+            ?status_connected;
         false ->
-            disconnected
+            ?status_disconnected
     end.
 
 %% -------------------------------------------------------------------------------------------------
@@ -179,22 +227,36 @@ roots() ->
         }}
     ].
 
+fields("connector") ->
+    [server_field()] ++
+        credentials_fields() ++
+        emqx_connector_schema_lib:ssl_fields();
+%% ============ begin: schema for old bridge configs ============
 fields(common) ->
     [
-        {server, server()},
-        {precision,
-            %% The greptimedb only supports these 4 precision
-            mk(enum([ns, us, ms, s]), #{
-                required => false, default => ms, desc => ?DESC("precision")
-            })}
+        server_field(),
+        precision_field()
     ];
 fields(greptimedb) ->
     fields(common) ++
-        [
-            {dbname, mk(binary(), #{required => true, desc => ?DESC("dbname")})},
-            {username, mk(binary(), #{desc => ?DESC("username")})},
-            {password, emqx_schema_secret:mk(#{desc => ?DESC("password")})}
-        ] ++ emqx_connector_schema_lib:ssl_fields().
+        credentials_fields() ++
+        emqx_connector_schema_lib:ssl_fields().
+%% ============ end: schema for old bridge configs ============
+
+desc(common) ->
+    ?DESC("common");
+desc(greptimedb) ->
+    ?DESC("greptimedb").
+
+precision_field() ->
+    {precision,
+        %% The greptimedb only supports these 4 precision
+        mk(enum([ns, us, ms, s]), #{
+            required => false, default => ms, desc => ?DESC("precision")
+        })}.
+
+server_field() ->
+    {server, server()}.
 
 server() ->
     Meta = #{
@@ -205,10 +267,12 @@ server() ->
     },
     emqx_schema:servers_sc(Meta, ?GREPTIMEDB_HOST_OPTIONS).
 
-desc(common) ->
-    ?DESC("common");
-desc(greptimedb) ->
-    ?DESC("greptimedb").
+credentials_fields() ->
+    [
+        {dbname, mk(binary(), #{required => true, desc => ?DESC("dbname")})},
+        {username, mk(binary(), #{desc => ?DESC("username")})},
+        {password, emqx_schema_secret:mk(#{desc => ?DESC("password")})}
+    ].
 
 %% -------------------------------------------------------------------------------------------------
 %% internal functions
@@ -243,9 +307,8 @@ start_client(InstId, Config) ->
 do_start_client(
     InstId,
     ClientConfig,
-    Config = #{write_syntax := Lines}
+    Config
 ) ->
-    Precision = maps:get(precision, Config, ms),
     case greptimedb:start_client(ClientConfig) of
         {ok, Client} ->
             case greptimedb:is_alive(Client, true) of
@@ -253,7 +316,7 @@ do_start_client(
                     State = #{
                         client => Client,
                         dbname => proplists:get_value(dbname, ClientConfig, ?DEFAULT_DB),
-                        write_syntax => to_config(Lines, Precision)
+                        channels => #{}
                     },
                     ?SLOG(info, #{
                         msg => "starting_greptimedb_connector_success",
@@ -314,8 +377,7 @@ client_config(
         {pool, InstId},
         {pool_type, random},
         {auto_reconnect, ?AUTO_RECONNECT_S},
-        {gprc_options, grpc_config()},
-        {timeunit, maps:get(precision, Config, ms)}
+        {gprc_options, grpc_config()}
     ] ++ protocol_config(Config).
 
 protocol_config(
@@ -469,10 +531,10 @@ to_maps_config(K, V, Res) ->
 
 %% -------------------------------------------------------------------------------------------------
 %% Tags & Fields Data Trans
-parse_batch_data(InstId, BatchData, SyntaxLines) ->
+parse_batch_data(InstId, DbName, BatchData, SyntaxLines) ->
     {Points, Errors} = lists:foldl(
-        fun({send_message, Data}, {ListOfPoints, ErrAccIn}) ->
-            case data_to_points(Data, SyntaxLines) of
+        fun({_, Data}, {ListOfPoints, ErrAccIn}) ->
+            case data_to_points(Data, DbName, SyntaxLines) of
                 {ok, Points} ->
                     {[Points | ListOfPoints], ErrAccIn};
                 {error, ErrorPoints} ->
@@ -496,21 +558,25 @@ parse_batch_data(InstId, BatchData, SyntaxLines) ->
             {error, points_trans_failed}
     end.
 
--spec data_to_points(map(), [
-    #{
-        fields := [{binary(), binary()}],
-        measurement := binary(),
-        tags := [{binary(), binary()}],
-        timestamp := emqx_placeholder:tmpl_token() | integer(),
-        precision := {From :: ts_precision(), To :: ts_precision()}
-    }
-]) -> {ok, [map()]} | {error, term()}.
-data_to_points(Data, SyntaxLines) ->
-    lines_to_points(Data, SyntaxLines, [], []).
+-spec data_to_points(
+    map(),
+    binary(),
+    [
+        #{
+            fields := [{binary(), binary()}],
+            measurement := binary(),
+            tags := [{binary(), binary()}],
+            timestamp := emqx_placeholder:tmpl_token() | integer(),
+            precision := {From :: ts_precision(), To :: ts_precision()}
+        }
+    ]
+) -> {ok, [map()]} | {error, term()}.
+data_to_points(Data, DbName, SyntaxLines) ->
+    lines_to_points(Data, DbName, SyntaxLines, [], []).
 
 %% When converting multiple rows data into Greptimedb Line Protocol, they are considered to be strongly correlated.
 %% And once a row fails to convert, all of them are considered to have failed.
-lines_to_points(_, [], Points, ErrorPoints) ->
+lines_to_points(_Data, _DbName, [], Points, ErrorPoints) ->
     case ErrorPoints of
         [] ->
             {ok, Points};
@@ -518,23 +584,27 @@ lines_to_points(_, [], Points, ErrorPoints) ->
             %% ignore trans succeeded points
             {error, ErrorPoints}
     end;
-lines_to_points(Data, [#{timestamp := Ts} = Item | Rest], ResultPointsAcc, ErrorPointsAcc) when
+lines_to_points(
+    Data, DbName, [#{timestamp := Ts} = Item | Rest], ResultPointsAcc, ErrorPointsAcc
+) when
     is_list(Ts)
 ->
     TransOptions = #{return => rawlist, var_trans => fun data_filter/1},
     case parse_timestamp(emqx_placeholder:proc_tmpl(Ts, Data, TransOptions)) of
         {ok, TsInt} ->
             Item1 = Item#{timestamp => TsInt},
-            continue_lines_to_points(Data, Item1, Rest, ResultPointsAcc, ErrorPointsAcc);
+            continue_lines_to_points(Data, DbName, Item1, Rest, ResultPointsAcc, ErrorPointsAcc);
         {error, BadTs} ->
-            lines_to_points(Data, Rest, ResultPointsAcc, [
+            lines_to_points(Data, DbName, Rest, ResultPointsAcc, [
                 {error, {bad_timestamp, BadTs}} | ErrorPointsAcc
             ])
     end;
-lines_to_points(Data, [#{timestamp := Ts} = Item | Rest], ResultPointsAcc, ErrorPointsAcc) when
+lines_to_points(
+    Data, DbName, [#{timestamp := Ts} = Item | Rest], ResultPointsAcc, ErrorPointsAcc
+) when
     is_integer(Ts)
 ->
-    continue_lines_to_points(Data, Item, Rest, ResultPointsAcc, ErrorPointsAcc).
+    continue_lines_to_points(Data, DbName, Item, Rest, ResultPointsAcc, ErrorPointsAcc).
 
 parse_timestamp([TsInt]) when is_integer(TsInt) ->
     {ok, TsInt};
@@ -546,30 +616,32 @@ parse_timestamp([TsBin]) ->
             {error, TsBin}
     end.
 
-continue_lines_to_points(Data, Item, Rest, ResultPointsAcc, ErrorPointsAcc) ->
-    case line_to_point(Data, Item) of
+continue_lines_to_points(Data, DbName, Item, Rest, ResultPointsAcc, ErrorPointsAcc) ->
+    case line_to_point(Data, DbName, Item) of
         {_, [#{fields := Fields}]} when map_size(Fields) =:= 0 ->
             %% greptimedb client doesn't like empty field maps...
             ErrorPointsAcc1 = [{error, no_fields} | ErrorPointsAcc],
-            lines_to_points(Data, Rest, ResultPointsAcc, ErrorPointsAcc1);
+            lines_to_points(Data, DbName, Rest, ResultPointsAcc, ErrorPointsAcc1);
         Point ->
-            lines_to_points(Data, Rest, [Point | ResultPointsAcc], ErrorPointsAcc)
+            lines_to_points(Data, DbName, Rest, [Point | ResultPointsAcc], ErrorPointsAcc)
     end.
 
 line_to_point(
     Data,
+    DbName,
     #{
         measurement := Measurement,
         tags := Tags,
         fields := Fields,
         timestamp := Ts,
-        precision := Precision
+        precision := {_, ToPrecision} = Precision
     } = Item
 ) ->
     {_, EncodedTags} = maps:fold(fun maps_config_to_data/3, {Data, #{}}, Tags),
     {_, EncodedFields} = maps:fold(fun maps_config_to_data/3, {Data, #{}}, Fields),
     TableName = emqx_placeholder:proc_tmpl(Measurement, Data),
-    {TableName, [
+    Metric = #{dbname => DbName, table => TableName, timeunit => ToPrecision},
+    {Metric, [
         maps:without([precision, measurement], Item#{
             tags => EncodedTags,
             fields => EncodedFields,
diff --git a/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_SUITE.erl b/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_SUITE.erl
index 73223892d..fb6639b68 100644
--- a/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_SUITE.erl
+++ b/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_SUITE.erl
@@ -452,10 +452,7 @@ t_start_ok(Config) ->
             [#{points := [Point0]}] = Trace,
             {Measurement, [Point]} = Point0,
             ct:pal("sent point: ~p", [Point]),
-            ?assertMatch(
-                <<_/binary>>,
-                Measurement
-            ),
+            ?assertMatch(#{dbname := _, table := _, timeunit := _}, Measurement),
             ?assertMatch(
                 #{
                     fields := #{},
@@ -481,7 +478,6 @@ t_start_stop(Config) ->
     BridgeName = ?config(bridge_name, Config),
     BridgeConfig = ?config(bridge_config, Config),
     StopTracePoint = greptimedb_client_stopped,
-    ResourceId = emqx_bridge_resource:resource_id(BridgeType, BridgeName),
     ?check_trace(
         begin
             ProbeRes0 = emqx_bridge_testlib:probe_bridge_api(
@@ -491,6 +487,7 @@ t_start_stop(Config) ->
             ),
             ?assertMatch({ok, {{_, 204, _}, _Headers, _Body}}, ProbeRes0),
             ?assertMatch({ok, _}, emqx_bridge:create(BridgeType, BridgeName, BridgeConfig)),
+            ResourceId = emqx_bridge_resource:resource_id(BridgeType, BridgeName),
 
             %% Since the connection process is async, we give it some time to
             %% stabilize and avoid flakiness.
@@ -554,6 +551,7 @@ t_start_stop(Config) ->
             ok
         end,
         fun(Trace) ->
+            ResourceId = emqx_bridge_resource:resource_id(BridgeType, BridgeName),
             %% one for probe, two for real
             ?assertMatch(
                 [_, #{instance_id := ResourceId}, #{instance_id := ResourceId}],
@@ -568,10 +566,7 @@ t_start_already_started(Config) ->
     Type = greptimedb_type_bin(?config(greptimedb_type, Config)),
     Name = ?config(greptimedb_name, Config),
     GreptimedbConfigString = ?config(greptimedb_config_string, Config),
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
+    ?assertMatch({ok, _}, create_bridge(Config)),
     ResourceId = resource_id(Config),
     TypeAtom = binary_to_atom(Type),
     NameAtom = binary_to_atom(Name),
@@ -1036,7 +1031,6 @@ t_missing_field(Config) ->
     ok.
 
 t_authentication_error_on_send_message(Config0) ->
-    ResourceId = resource_id(Config0),
     QueryMode = proplists:get_value(query_mode, Config0, sync),
     GreptimedbType = ?config(greptimedb_type, Config0),
     GreptimeConfig0 = proplists:get_value(greptimedb_config, Config0),
@@ -1055,6 +1049,7 @@ t_authentication_error_on_send_message(Config0) ->
         end,
         fun() ->
             {ok, _} = create_bridge(Config),
+            ResourceId = resource_id(Config0),
             ?retry(
                 _Sleep = 1_000,
                 _Attempts = 10,
diff --git a/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_connector_SUITE.erl b/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_connector_SUITE.erl
index a4acf5b4e..bb8bca17d 100644
--- a/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_connector_SUITE.erl
+++ b/apps/emqx_bridge_greptimedb/test/emqx_bridge_greptimedb_connector_SUITE.erl
@@ -65,7 +65,7 @@ t_lifecycle(Config) ->
     Port = ?config(greptimedb_tcp_port, Config),
     perform_lifecycle_check(
         <<"emqx_bridge_greptimedb_connector_SUITE">>,
-        greptimedb_config(Host, Port)
+        greptimedb_connector_config(Host, Port)
     ).
 
 perform_lifecycle_check(PoolName, InitialConfig) ->
@@ -75,6 +75,7 @@ perform_lifecycle_check(PoolName, InitialConfig) ->
     % expects this
     FullConfig = CheckedConfig#{write_syntax => greptimedb_write_syntax()},
     {ok, #{
+        id := ResourceId,
         state := #{client := #{pool := ReturnedPoolName}} = State,
         status := InitialStatus
     }} = emqx_resource:create_local(
@@ -92,8 +93,13 @@ perform_lifecycle_check(PoolName, InitialConfig) ->
     }} =
         emqx_resource:get_instance(PoolName),
     ?assertEqual({ok, connected}, emqx_resource:health_check(PoolName)),
+    %% install actions to the connector
+    ActionConfig = greptimedb_action_config(),
+    ChannelId = <<"test_channel">>,
+    ?assertEqual(ok, emqx_resource_manager:add_channel(ResourceId, ChannelId, ActionConfig)),
+    ?assertMatch(#{status := connected}, emqx_resource:channel_health_check(ResourceId, ChannelId)),
     % % Perform query as further check that the resource is working as expected
-    ?assertMatch({ok, _}, emqx_resource:query(PoolName, test_query())),
+    ?assertMatch({ok, _}, emqx_resource:query(PoolName, test_query(ChannelId))),
     ?assertEqual(ok, emqx_resource:stop(PoolName)),
     % Resource will be listed still, but state will be changed and healthcheck will fail
     % as the worker no longer exists.
@@ -115,7 +121,9 @@ perform_lifecycle_check(PoolName, InitialConfig) ->
     {ok, ?CONNECTOR_RESOURCE_GROUP, #{status := InitialStatus}} =
         emqx_resource:get_instance(PoolName),
     ?assertEqual({ok, connected}, emqx_resource:health_check(PoolName)),
-    ?assertMatch({ok, _}, emqx_resource:query(PoolName, test_query())),
+    ?assertEqual(ok, emqx_resource_manager:add_channel(ResourceId, ChannelId, ActionConfig)),
+    ?assertMatch(#{status := connected}, emqx_resource:channel_health_check(ResourceId, ChannelId)),
+    ?assertMatch({ok, _}, emqx_resource:query(PoolName, test_query(ChannelId))),
     % Stop and remove the resource in one go.
     ?assertEqual(ok, emqx_resource:remove_local(PoolName)),
     ?assertEqual({error, not_found}, ecpool:stop_sup_pool(ReturnedPoolName)),
@@ -126,7 +134,7 @@ perform_lifecycle_check(PoolName, InitialConfig) ->
 % %% Helpers
 % %%------------------------------------------------------------------------------
 
-greptimedb_config(Host, Port) ->
+greptimedb_connector_config(Host, Port) ->
     Server = list_to_binary(io_lib:format("~s:~b", [Host, Port])),
     ResourceConfig = #{
         <<"dbname">> => <<"public">>,
@@ -136,6 +144,14 @@ greptimedb_config(Host, Port) ->
     },
     #{<<"config">> => ResourceConfig}.
 
+greptimedb_action_config() ->
+    #{
+        parameters => #{
+            write_syntax => greptimedb_write_syntax(),
+            precision => ms
+        }
+    }.
+
 greptimedb_write_syntax() ->
     [
         #{
@@ -146,8 +162,8 @@ greptimedb_write_syntax() ->
         }
     ].
 
-test_query() ->
-    {send_message, #{
+test_query(ChannelId) ->
+    {ChannelId, #{
         <<"clientid">> => <<"something">>,
         <<"payload">> => #{bool => true},
         <<"topic">> => <<"connector_test">>,
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 8e81b12ea..95c9d2991 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -58,6 +58,8 @@ resource_type(elasticsearch) ->
     emqx_bridge_es_connector;
 resource_type(opents) ->
     emqx_bridge_opents_connector;
+resource_type(greptimedb) ->
+    emqx_bridge_greptimedb_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -225,6 +227,14 @@ connector_structs() ->
                     desc => <<"OpenTSDB Connector Config">>,
                     required => false
                 }
+            )},
+        {greptimedb,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_greptimedb, "config_connector")),
+                #{
+                    desc => <<"GreptimeDB Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -247,7 +257,8 @@ schema_modules() ->
         emqx_bridge_redis_schema,
         emqx_bridge_iotdb_connector,
         emqx_bridge_es_connector,
-        emqx_bridge_opents_connector
+        emqx_bridge_opents_connector,
+        emqx_bridge_greptimedb
     ].
 
 api_schemas(Method) ->
@@ -279,7 +290,8 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_redis_schema, <<"redis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
         api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
-        api_ref(emqx_bridge_opents_connector, <<"opents">>, Method)
+        api_ref(emqx_bridge_opents_connector, <<"opents">>, Method),
+        api_ref(emqx_bridge_greptimedb, <<"greptimedb">>, Method ++ "_connector")
     ].
 
 api_ref(Module, Type, Method) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index d5c450529..b7c4d9f74 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -160,7 +160,9 @@ connector_type_to_bridge_types(iotdb) ->
 connector_type_to_bridge_types(elasticsearch) ->
     [elasticsearch];
 connector_type_to_bridge_types(opents) ->
-    [opents].
+    [opents];
+connector_type_to_bridge_types(greptimedb) ->
+    [greptimedb].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/changes/ee/feat-12386.en.md b/changes/ee/feat-12386.en.md
new file mode 100644
index 000000000..b12e2f24f
--- /dev/null
+++ b/changes/ee/feat-12386.en.md
@@ -0,0 +1 @@
+Split GreptimeDB bridge into connector and action components.
diff --git a/mix.exs b/mix.exs
index bb79c3204..4b689b15f 100644
--- a/mix.exs
+++ b/mix.exs
@@ -209,7 +209,7 @@ defmodule EMQXUmbrella.MixProject do
       {:crc32cer, "0.1.8", override: true},
       {:supervisor3, "1.1.12", override: true},
       {:opentsdb, github: "emqx/opentsdb-client-erl", tag: "v0.5.1", override: true},
-      {:greptimedb, github: "GreptimeTeam/greptimedb-client-erl", tag: "v0.1.6", override: true},
+      {:greptimedb, github: "GreptimeTeam/greptimedb-client-erl", tag: "v0.1.7", override: true},
       # The following two are dependencies of rabbit_common. They are needed here to
       # make mix not complain about conflicting versions
       {:thoas, github: "emqx/thoas", tag: "v1.0.0", override: true},
diff --git a/rel/i18n/emqx_bridge_greptimedb.hocon b/rel/i18n/emqx_bridge_greptimedb.hocon
index 977e6e064..9ca36acb3 100644
--- a/rel/i18n/emqx_bridge_greptimedb.hocon
+++ b/rel/i18n/emqx_bridge_greptimedb.hocon
@@ -47,4 +47,19 @@ Please note that a placeholder for an integer value must be annotated with a suf
 write_syntax.label:
 """Write Syntax"""
 
+action_parameters.label:
+"""Action Parameters"""
+action_parameters.desc:
+"""Additional parameters specific to this action type"""
+
+connector.label:
+"""GreptimeDB Connector"""
+connector.desc:
+"""GreptimeDB Connector Configs"""
+
+greptimedb_action.label:
+"""GreptimeDB Action"""
+greptimedb_action.desc:
+"""Action to interact with a GreptimeDB connector"""
+
 }

From a56a5e9c3cc358441b128f71a38a55de8b5bd6cf Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Wed, 24 Jan 2024 21:10:30 +0200
Subject: [PATCH 072/273] chore: add copyright

---
 .../src/emqx_bridge_influxdb_action_info.erl                   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/apps/emqx_bridge_influxdb/src/emqx_bridge_influxdb_action_info.erl b/apps/emqx_bridge_influxdb/src/emqx_bridge_influxdb_action_info.erl
index 00a6c5510..5864daf50 100644
--- a/apps/emqx_bridge_influxdb/src/emqx_bridge_influxdb_action_info.erl
+++ b/apps/emqx_bridge_influxdb/src/emqx_bridge_influxdb_action_info.erl
@@ -1,3 +1,6 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
 -module(emqx_bridge_influxdb_action_info).
 
 -behaviour(emqx_action_info).

From 0933dc818e80a45e7f1bd6338697f1fd02cc26b5 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 26 Jan 2024 14:25:16 +0100
Subject: [PATCH 073/273] chore(ekka): Bump version to 0.18.4

Don't escalate the errors in etcd node discovery to the node level.

Fixes: #12255
---
 apps/emqx/rebar.config | 2 +-
 mix.exs                | 2 +-
 rebar.config           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/emqx/rebar.config b/apps/emqx/rebar.config
index bfd981854..a9b441bc5 100644
--- a/apps/emqx/rebar.config
+++ b/apps/emqx/rebar.config
@@ -28,7 +28,7 @@
     {gproc, {git, "https://github.com/emqx/gproc", {tag, "0.9.0.1"}}},
     {cowboy, {git, "https://github.com/emqx/cowboy", {tag, "2.9.2"}}},
     {esockd, {git, "https://github.com/emqx/esockd", {tag, "5.11.1"}}},
-    {ekka, {git, "https://github.com/emqx/ekka", {tag, "0.18.3"}}},
+    {ekka, {git, "https://github.com/emqx/ekka", {tag, "0.18.4"}}},
     {gen_rpc, {git, "https://github.com/emqx/gen_rpc", {tag, "3.3.1"}}},
     {hocon, {git, "https://github.com/emqx/hocon.git", {tag, "0.40.4"}}},
     {emqx_http_lib, {git, "https://github.com/emqx/emqx_http_lib.git", {tag, "0.5.3"}}},
diff --git a/mix.exs b/mix.exs
index 4b689b15f..cf1ea39d8 100644
--- a/mix.exs
+++ b/mix.exs
@@ -55,7 +55,7 @@ defmodule EMQXUmbrella.MixProject do
       {:cowboy, github: "emqx/cowboy", tag: "2.9.2", override: true},
       {:esockd, github: "emqx/esockd", tag: "5.11.1", override: true},
       {:rocksdb, github: "emqx/erlang-rocksdb", tag: "1.8.0-emqx-2", override: true},
-      {:ekka, github: "emqx/ekka", tag: "0.18.3", override: true},
+      {:ekka, github: "emqx/ekka", tag: "0.18.4", override: true},
       {:gen_rpc, github: "emqx/gen_rpc", tag: "3.3.1", override: true},
       {:grpc, github: "emqx/grpc-erl", tag: "0.6.12", override: true},
       {:minirest, github: "emqx/minirest", tag: "1.3.15", override: true},
diff --git a/rebar.config b/rebar.config
index 7a2e7ff8c..4f4b68016 100644
--- a/rebar.config
+++ b/rebar.config
@@ -83,7 +83,7 @@
     {cowboy, {git, "https://github.com/emqx/cowboy", {tag, "2.9.2"}}},
     {esockd, {git, "https://github.com/emqx/esockd", {tag, "5.11.1"}}},
     {rocksdb, {git, "https://github.com/emqx/erlang-rocksdb", {tag, "1.8.0-emqx-2"}}},
-    {ekka, {git, "https://github.com/emqx/ekka", {tag, "0.18.3"}}},
+    {ekka, {git, "https://github.com/emqx/ekka", {tag, "0.18.4"}}},
     {gen_rpc, {git, "https://github.com/emqx/gen_rpc", {tag, "3.3.1"}}},
     {grpc, {git, "https://github.com/emqx/grpc-erl", {tag, "0.6.12"}}},
     {minirest, {git, "https://github.com/emqx/minirest", {tag, "1.3.15"}}},

From dd71a47d3f892e4e6bacaf2fb65b3d93266a9d39 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 26 Jan 2024 16:22:55 +0100
Subject: [PATCH 074/273] chore: add a script to update BSL license change date

---
 scripts/update-bsl-license-convert-year.sh | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100755 scripts/update-bsl-license-convert-year.sh

diff --git a/scripts/update-bsl-license-convert-year.sh b/scripts/update-bsl-license-convert-year.sh
new file mode 100755
index 000000000..636ba8e7a
--- /dev/null
+++ b/scripts/update-bsl-license-convert-year.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+CONVERT_DATE="$(date -d "+4 years" '+%Y-%m-%d')"
+NEWTEXT="Change Date:          $CONVERT_DATE"
+
+update() {
+    local file="$1"
+    sed -E "s#(^Change Date: *)(.*)#\1$CONVERT_DATE#g" -i "$file"
+}
+
+while read -r file; do
+    if [[ $file != *BSL.txt ]]; then
+        ## Ignore other files
+        continue
+    fi
+    update "$file"
+done < <(git ls-files)

From 2d08aa88d8df842255fbd522b0ada1794d533d9c Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Tue, 19 Dec 2023 17:47:11 +0100
Subject: [PATCH 075/273] refactor(ds): Create a CRUD module for the persistent
 session

---
 .../src/emqx_persistent_session_ds_state.erl  | 508 ++++++++++++++++++
 1 file changed, 508 insertions(+)
 create mode 100644 apps/emqx/src/emqx_persistent_session_ds_state.erl

diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
new file mode 100644
index 000000000..5fd2c2ac9
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -0,0 +1,508 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+%% @doc CRUD interface for the persistent session
+%%
+%% This module encapsulates the data related to the state of the
+%% inflight messages for the persistent session based on DS.
+%%
+%% It is responsible for saving, caching, and restoring session state.
+%% It is completely devoid of business logic. Not even the default
+%% values should be set in this module.
+-module(emqx_persistent_session_ds_state).
+
+-export([create_tables/0]).
+
+-export([open/1, create_new/1, delete/1, commit/1, print_session/1]).
+-export([get_created_at/1, set_created_at/2]).
+-export([get_last_alive_at/1, set_last_alive_at/2]).
+-export([get_conninfo/1, set_conninfo/2]).
+-export([get_stream/2, put_stream/3, del_stream/2, fold_streams/3]).
+-export([get_seqno/2, put_seqno/3]).
+-export([get_rank/2, put_rank/3, del_rank/2, fold_ranks/3]).
+-export([get_subscriptions/1, put_subscription/4, del_subscription/3]).
+
+%% internal exports:
+-export([]).
+
+-export_type([t/0, seqno_type/0]).
+
+-include("emqx_persistent_session_ds.hrl").
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+%% Generic key-value wrapper that is used for exporting arbitrary
+%% terms to mnesia:
+-record(kv, {
+    k :: term(),
+    v :: map()
+}).
+
+%% Persistent map.
+%%
+%% Pmap accumulates the updates in a term stored in the heap of a
+%% process, so they can be committed all at once in a single
+%% transaction.
+%%
+%% It should be possible to make frequent changes to the pmap without
+%% stressing Mria.
+%%
+%% It's implemented as two maps: `clean' and `dirty'. Updates are made
+%% to the `dirty' area. `pmap_commit' function saves the updated
+%% entries to Mnesia and moves them to the `clean' area.
+-record(pmap, {table, clean, dirty, tombstones}).
+
+-type pmap(K, V) ::
+    #pmap{
+        table :: atom(),
+        clean :: #{K => V},
+        dirty :: #{K => V},
+        tombstones :: #{K => _}
+    }.
+
+%% Session metadata:
+-define(created_at, created_at).
+-define(last_alive_at, last_alive_at).
+-define(conninfo, conninfo).
+
+-type metadata() ::
+    #{
+        ?created_at => emqx_persistent_session_ds:timestamp(),
+        ?last_alive_at => emqx_persistent_session_ds:timestamp(),
+        ?conninfo => emqx_types:conninfo()
+    }.
+
+-type seqno_type() :: next | acked | pubrel.
+
+-opaque t() :: #{
+    id := emqx_persistent_session_ds:id(),
+    dirty := boolean(),
+    metadata := metadata(),
+    subscriptions := emqx_persistent_session_ds:subscriptions(),
+    seqnos := pmap(seqno_type(), emqx_persistent_session_ds:seqno()),
+    streams := pmap(emqx_ds:stream(), emqx_persistent_message_ds_replayer:stream_state()),
+    ranks := pmap(term(), integer())
+}.
+
+-define(session_tab, emqx_ds_session_tab).
+-define(subscription_tab, emqx_ds_session_subscriptions).
+-define(stream_tab, emqx_ds_session_streams).
+-define(seqno_tab, emqx_ds_session_seqnos).
+-define(rank_tab, emqx_ds_session_ranks).
+-define(bag_tables, [?stream_tab, ?seqno_tab, ?rank_tab]).
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec create_tables() -> ok.
+create_tables() ->
+    ok = mria:create_table(
+        ?session_tab,
+        [
+            {rlog_shard, ?DS_MRIA_SHARD},
+            {type, set},
+            {storage, rocksdb_copies},
+            {record_name, kv},
+            {attributes, record_info(fields, kv)}
+        ]
+    ),
+    [create_kv_bag_table(Table) || Table <- ?bag_tables],
+    mria:wait_for_tables([?session_tab | ?bag_tables]).
+
+-spec open(emqx_persistent_session_ds:session_id()) -> {ok, t()} | undefined.
+open(SessionId) ->
+    ro_transaction(fun() ->
+        case kv_restore(?session_tab, SessionId) of
+            [Metadata] ->
+                Rec = #{
+                    id => SessionId,
+                    metadata => Metadata,
+                    subscriptions => read_subscriptions(SessionId),
+                    streams => pmap_open(?stream_tab, SessionId),
+                    seqnos => pmap_open(?seqno_tab, SessionId),
+                    ranks => pmap_open(?rank_tab, SessionId),
+                    dirty => false
+                },
+                {ok, Rec};
+            [] ->
+                undefined
+        end
+    end).
+
+-spec print_session(emqx_persistent_session_ds:id()) -> map() | undefined.
+print_session(SessionId) ->
+    case open(SessionId) of
+        undefined ->
+            undefined;
+        #{
+            metadata := Metadata,
+            subscriptions := SubsGBT,
+            streams := Streams,
+            seqnos := Seqnos,
+            ranks := Ranks
+        } ->
+            Subs = emqx_topic_gbt:fold(
+                fun(Key, Sub, Acc) -> maps:put(Key, Sub, Acc) end,
+                #{},
+                SubsGBT
+            ),
+            #{
+                session => Metadata,
+                subscriptions => Subs,
+                streams => Streams#pmap.clean,
+                seqnos => Seqnos#pmap.clean,
+                ranks => Ranks#pmap.clean
+            }
+    end.
+
+-spec delete(emqx_persistent_session_ds:id()) -> ok.
+delete(Id) ->
+    transaction(
+        fun() ->
+            [kv_delete(Table, Id) || Table <- ?bag_tables],
+            mnesia:delete(?session_tab, Id, write)
+        end
+    ).
+
+-spec commit(t()) -> t().
+commit(Rec = #{dirty := false}) ->
+    Rec;
+commit(
+    Rec = #{
+        id := SessionId,
+        metadata := Metadata,
+        subscriptions := Subs,
+        streams := Streams,
+        seqnos := SeqNos,
+        ranks := Ranks
+    }
+) ->
+    transaction(fun() ->
+        kv_persist(?session_tab, SessionId, Metadata),
+        Rec#{
+            subscriptions => pmap_commit(SessionId, Subs),
+            streams => pmap_commit(SessionId, Streams),
+            seqnos => pmap_commit(SessionId, SeqNos),
+            ranksz => pmap_commit(SessionId, Ranks),
+            dirty => false
+        }
+    end).
+
+-spec create_new(emqx_persistent_session_ds:id()) -> t().
+create_new(SessionId) ->
+    transaction(fun() ->
+        delete(SessionId),
+        #{
+            id => SessionId,
+            metadata => #{},
+            subscriptions => emqx_topic_gbt:new(),
+            streams => pmap_open(?stream_tab, SessionId),
+            seqnos => pmap_open(?seqno_tab, SessionId),
+            ranks => pmap_open(?rank_tab, SessionId),
+            dirty => true
+        }
+    end).
+
+%%
+
+-spec get_created_at(t()) -> emqx_persistent_session_ds:timestamp() | undefined.
+get_created_at(Rec) ->
+    get_meta(?created_at, Rec).
+
+-spec set_created_at(emqx_persistent_session_ds:timestamp(), t()) -> t().
+set_created_at(Val, Rec) ->
+    set_meta(?created_at, Val, Rec).
+
+-spec get_last_alive_at(t()) -> emqx_persistent_session_ds:timestamp() | undefined.
+get_last_alive_at(Rec) ->
+    get_meta(?last_alive_at, Rec).
+
+-spec set_last_alive_at(emqx_persistent_session_ds:timestamp(), t()) -> t().
+set_last_alive_at(Val, Rec) ->
+    set_meta(?last_alive_at, Val, Rec).
+
+-spec get_conninfo(t()) -> emqx_types:conninfo() | undefined.
+get_conninfo(Rec) ->
+    get_meta(?conninfo, Rec).
+
+-spec set_conninfo(emqx_types:conninfo(), t()) -> t().
+set_conninfo(Val, Rec) ->
+    set_meta(?conninfo, Val, Rec).
+
+%%
+
+-spec get_stream(emqx_persistent_session_ds:stream(), t()) ->
+    emqx_persistent_message_ds_replayer:stream_state() | undefined.
+get_stream(Key, Rec) ->
+    gen_get(streams, Key, Rec).
+
+-spec put_stream(
+    emqx_persistent_session_ds:stream(), emqx_persistent_message_ds_replayer:stream_state(), t()
+) -> t().
+put_stream(Key, Val, Rec) ->
+    gen_put(streams, Key, Val, Rec).
+
+-spec del_stream(emqx_persistent_session_ds:stream(), t()) -> t().
+del_stream(Key, Rec) ->
+    gen_del(stream, Key, Rec).
+
+-spec fold_streams(fun(), Acc, t()) -> Acc.
+fold_streams(Fun, Acc, Rec) ->
+    gen_fold(streams, Fun, Acc, Rec).
+
+%%
+
+-spec get_seqno(seqno_type(), t()) -> emqx_persistent_session_ds:seqno() | undefined.
+get_seqno(Key, Rec) ->
+    gen_get(seqnos, Key, Rec).
+
+-spec put_seqno(seqno_type(), emqx_persistent_session_ds:seqno(), t()) -> t().
+put_seqno(Key, Val, Rec) ->
+    gen_put(seqnos, Key, Val, Rec).
+
+%%
+
+-spec get_rank(term(), t()) -> integer() | undefined.
+get_rank(Key, Rec) ->
+    gen_get(ranks, Key, Rec).
+
+-spec put_rank(term(), integer(), t()) -> t().
+put_rank(Key, Val, Rec) ->
+    gen_put(ranks, Key, Val, Rec).
+
+-spec del_rank(term(), t()) -> t().
+del_rank(Key, Rec) ->
+    gen_del(ranks, Key, Rec).
+
+-spec fold_ranks(fun(), Acc, t()) -> Acc.
+fold_ranks(Fun, Acc, Rec) ->
+    gen_fold(ranks, Fun, Acc, Rec).
+
+%%
+
+-spec get_subscriptions(t()) -> emqx_persistent_session_ds:subscriptions().
+get_subscriptions(#{subscriptions := Subs}) ->
+    Subs.
+
+-spec put_subscription(
+    emqx_persistent_session_ds:subscription_id(),
+    _SubId,
+    emqx_persistent_session_ds:subscription(),
+    t()
+) -> t().
+put_subscription(TopicFilter, SubId, Subscription, Rec = #{id := Id, subscriptions := Subs0}) ->
+    %% Note: currently changes to the subscriptions are persisted immediately.
+    Key = {TopicFilter, SubId},
+    transaction(fun() -> kv_bag_persist(?subscription_tab, Id, Key, Subscription) end),
+    Subs = emqx_topic_gbt:insert(TopicFilter, SubId, Subscription, Subs0),
+    Rec#{subscriptions => Subs}.
+
+-spec del_subscription(emqx_persistent_session_ds:topic_filter(), _SubId, t()) -> t().
+del_subscription(TopicFilter, SubId, Rec = #{id := Id, subscriptions := Subs0}) ->
+    %% Note: currently the subscriptions are persisted immediately.
+    Key = {TopicFilter, SubId},
+    transaction(fun() -> kv_bag_delete(?subscription_tab, Id, Key) end),
+    Subs = emqx_topic_gbt:delete(TopicFilter, SubId, Subs0),
+    Rec#{subscriptions => Subs}.
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+%% All mnesia reads and writes are passed through this function.
+%% Backward compatiblity issues can be handled here.
+encoder(encode, _Table, Term) ->
+    Term;
+encoder(decode, _Table, Term) ->
+    Term.
+
+%%
+
+get_meta(K, #{metadata := Meta}) ->
+    maps:get(K, Meta, undefined).
+
+set_meta(K, V, Rec = #{metadata := Meta}) ->
+    Rec#{metadata => maps:put(K, V, Meta), dirty => true}.
+
+%%
+
+gen_get(Field, Key, Rec) ->
+    pmap_get(Key, maps:get(Field, Rec)).
+
+gen_fold(Field, Fun, Acc, Rec) ->
+    pmap_fold(Fun, Acc, maps:get(Field, Rec)).
+
+gen_put(Field, Key, Val, Rec) ->
+    maps:update_with(
+        Field,
+        fun(PMap) -> pmap_put(Key, Val, PMap) end,
+        Rec#{dirty => true}
+    ).
+
+gen_del(Field, Key, Rec) ->
+    maps:update_with(
+        Field,
+        fun(PMap) -> pmap_del(Key, PMap) end,
+        Rec#{dirty => true}
+    ).
+
+%%
+
+read_subscriptions(SessionId) ->
+    Records = kv_bag_restore(?subscription_tab, SessionId),
+    lists:foldl(
+        fun({{TopicFilter, SubId}, Subscription}, Acc) ->
+            emqx_topic_gbt:insert(TopicFilter, SubId, Subscription, Acc)
+        end,
+        emqx_topic_gbt:new(),
+        Records
+    ).
+
+%%
+
+%% @doc Open a PMAP and fill the clean area with the data from DB.
+%% This functtion should be ran in a transaction.
+-spec pmap_open(atom(), emqx_persistent_session_ds:id()) -> pmap(_K, _V).
+pmap_open(Table, SessionId) ->
+    Clean = maps:from_list(kv_bag_restore(Table, SessionId)),
+    #pmap{
+        table = Table,
+        clean = Clean,
+        dirty = #{},
+        tombstones = #{}
+    }.
+
+-spec pmap_get(K, pmap(K, V)) -> V | undefined.
+pmap_get(K, #pmap{dirty = Dirty, clean = Clean}) ->
+    case Dirty of
+        #{K := V} ->
+            V;
+        _ ->
+            case Clean of
+                #{K := V} -> V;
+                _ -> undefined
+            end
+    end.
+
+-spec pmap_put(K, V, pmap(K, V)) -> pmap(K, V).
+pmap_put(K, V, Pmap = #pmap{dirty = Dirty, clean = Clean, tombstones = Tombstones}) ->
+    Pmap#pmap{
+        dirty = maps:put(K, V, Dirty),
+        clean = maps:remove(K, Clean),
+        tombstones = maps:remove(K, Tombstones)
+    }.
+
+-spec pmap_del(K, pmap(K, V)) -> pmap(K, V).
+pmap_del(
+    Key,
+    Pmap = #pmap{dirty = Dirty, clean = Clean, tombstones = Tombstones}
+) ->
+    %% Update the caches:
+    Pmap#pmap{
+        dirty = maps:remove(Key, Dirty),
+        clean = maps:remove(Key, Clean),
+        tombstones = Tombstones#{Key => del}
+    }.
+
+-spec pmap_fold(fun((K, V, A) -> A), A, pmap(K, V)) -> A.
+pmap_fold(Fun, Acc0, #pmap{clean = Clean, dirty = Dirty}) ->
+    Acc1 = maps:fold(Fun, Acc0, Dirty),
+    maps:fold(Fun, Acc1, Clean).
+
+-spec pmap_commit(emqx_persistent_session_ds:id(), pmap(K, V)) -> pmap(K, V).
+pmap_commit(
+    SessionId, Pmap = #pmap{table = Tab, dirty = Dirty, clean = Clean, tombstones = Tombstones}
+) ->
+    %% Commit deletions:
+    maps:foreach(fun(K, _) -> kv_bag_delete(Tab, SessionId, K) end, Tombstones),
+    %% Replace all records in the bag with the entries from the dirty area:
+    maps:foreach(
+        fun(K, V) ->
+            kv_bag_persist(Tab, SessionId, K, V)
+        end,
+        Dirty
+    ),
+    Pmap#pmap{
+        dirty = #{},
+        tombstones = #{},
+        clean = maps:merge(Clean, Dirty)
+    }.
+
+%% Functions dealing with set tables:
+
+kv_persist(Tab, SessionId, Val0) ->
+    Val = encoder(encode, Tab, Val0),
+    mnesia:write(Tab, #kv{k = SessionId, v = Val}, write).
+
+kv_delete(Table, Namespace) ->
+    mnesia:delete({Table, Namespace}).
+
+kv_restore(Tab, SessionId) ->
+    [encoder(decode, Tab, V) || #kv{v = V} <- mnesia:read(Tab, SessionId)].
+
+%% Functions dealing with bags:
+
+%% @doc Create a mnesia table for the PMAP:
+-spec create_kv_bag_table(atom()) -> ok.
+create_kv_bag_table(Table) ->
+    mria:create_table(Table, [
+        {type, bag},
+        {rlog_shard, ?DS_MRIA_SHARD},
+        {storage, rocksdb_copies},
+        {record_name, kv},
+        {attributes, record_info(fields, kv)}
+    ]).
+
+kv_bag_persist(Tab, SessionId, Key, Val0) ->
+    %% Remove the previous entry corresponding to the key:
+    kv_bag_delete(Tab, SessionId, Key),
+    %% Write data to mnesia:
+    Val = encoder(encode, Tab, Val0),
+    mnesia:write(Tab, #kv{k = SessionId, v = {Key, Val}}).
+
+kv_bag_restore(Tab, SessionId) ->
+    [{K, encoder(decode, Tab, V)} || #kv{v = {K, V}} <- mnesia:read(Tab, SessionId)].
+
+kv_bag_delete(Table, SessionId, Key) ->
+    %% Note: this match spec uses a fixed primary key, so it doesn't
+    %% require a table scan, and the transaction doesn't grab the
+    %% whole table lock:
+    MS = [{#kv{k = SessionId, v = {Key, '_'}}, [], ['$_']}],
+    Objs = mnesia:select(Table, MS, write),
+    lists:foreach(
+        fun(Obj) ->
+            mnesia:delete_object(Table, Obj, write)
+        end,
+        Objs
+    ).
+
+%%
+
+transaction(Fun) ->
+    case mnesia:is_transaction() of
+        true ->
+            Fun();
+        false ->
+            {atomic, Res} = mria:transaction(?DS_MRIA_SHARD, Fun),
+            Res
+    end.
+
+ro_transaction(Fun) ->
+    {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
+    Res.

From 8e8d3af096b2c95e5a2fee270c8d4c0ce1ba5e86 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 28 Dec 2023 20:18:34 +0100
Subject: [PATCH 076/273] fix(sessds): Refactor emqx_persistent_session_ds to
 use CRUD module

---
 .../emqx_persistent_message_ds_replayer.erl   |  795 ----------
 apps/emqx/src/emqx_persistent_session_ds.erl  | 1339 ++++++++---------
 apps/emqx/src/emqx_persistent_session_ds.hrl  |   79 +-
 .../emqx_persistent_session_ds_inflight.erl   |  111 ++
 .../src/emqx_persistent_session_ds_state.erl  |   59 +-
 apps/emqx/src/emqx_schema.erl                 |    2 +-
 apps/emqx/src/emqx_session.erl                |   24 +-
 apps/emqx/src/emqx_topic_gbt.erl              |   20 +-
 .../test/emqx_persistent_session_SUITE.erl    |    8 +-
 apps/emqx_conf/src/emqx_conf_schema.erl       |    2 +-
 apps/emqx_durable_storage/src/emqx_ds.erl     |    8 +-
 apps/emqx_exhook/test/emqx_exhook_SUITE.erl   |    2 +-
 12 files changed, 848 insertions(+), 1601 deletions(-)
 delete mode 100644 apps/emqx/src/emqx_persistent_message_ds_replayer.erl
 create mode 100644 apps/emqx/src/emqx_persistent_session_ds_inflight.erl

diff --git a/apps/emqx/src/emqx_persistent_message_ds_replayer.erl b/apps/emqx/src/emqx_persistent_message_ds_replayer.erl
deleted file mode 100644
index 1053978dc..000000000
--- a/apps/emqx/src/emqx_persistent_message_ds_replayer.erl
+++ /dev/null
@@ -1,795 +0,0 @@
-%%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
-%%
-%% Licensed under the Apache License, Version 2.0 (the "License");
-%% you may not use this file except in compliance with the License.
-%% You may obtain a copy of the License at
-%%
-%%     http://www.apache.org/licenses/LICENSE-2.0
-%%
-%% Unless required by applicable law or agreed to in writing, software
-%% distributed under the License is distributed on an "AS IS" BASIS,
-%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-%% See the License for the specific language governing permissions and
-%% limitations under the License.
-%%--------------------------------------------------------------------
-
-%% @doc This module implements the routines for replaying streams of
-%% messages.
--module(emqx_persistent_message_ds_replayer).
-
-%% API:
--export([new/0, open/1, next_packet_id/1, n_inflight/1]).
-
--export([poll/4, replay/2, commit_offset/4]).
-
--export([seqno_to_packet_id/1, packet_id_to_seqno/2]).
-
--export([committed_until/2]).
-
-%% internal exports:
--export([]).
-
--export_type([inflight/0, seqno/0]).
-
--include_lib("emqx/include/logger.hrl").
--include_lib("emqx/include/emqx_mqtt.hrl").
--include_lib("emqx_utils/include/emqx_message.hrl").
--include("emqx_persistent_session_ds.hrl").
-
--ifdef(TEST).
--include_lib("proper/include/proper.hrl").
--include_lib("eunit/include/eunit.hrl").
--endif.
-
--define(EPOCH_SIZE, 16#10000).
-
--define(ACK, 0).
--define(COMP, 1).
-
--define(TRACK_FLAG(WHICH), (1 bsl WHICH)).
--define(TRACK_FLAGS_ALL, ?TRACK_FLAG(?ACK) bor ?TRACK_FLAG(?COMP)).
--define(TRACK_FLAGS_NONE, 0).
-
-%%================================================================================
-%% Type declarations
-%%================================================================================
-
-%% Note: sequence numbers are monotonic; they don't wrap around:
--type seqno() :: non_neg_integer().
-
--type track() :: ack | comp.
--type commit_type() :: rec.
-
--record(inflight, {
-    next_seqno = 1 :: seqno(),
-    commits = #{ack => 1, comp => 1, rec => 1} :: #{track() | commit_type() => seqno()},
-    %% Ranges are sorted in ascending order of their sequence numbers.
-    offset_ranges = [] :: [ds_pubrange()]
-}).
-
--opaque inflight() :: #inflight{}.
-
--type message() :: emqx_types:message().
--type replies() :: [emqx_session:reply()].
-
--type preproc_fun() :: fun((message()) -> message() | [message()]).
-
-%%================================================================================
-%% API funcions
-%%================================================================================
-
--spec new() -> inflight().
-new() ->
-    #inflight{}.
-
--spec open(emqx_persistent_session_ds:id()) -> inflight().
-open(SessionId) ->
-    {Ranges, RecUntil} = ro_transaction(
-        fun() -> {get_ranges(SessionId), get_committed_offset(SessionId, rec)} end
-    ),
-    {Commits, NextSeqno} = compute_inflight_range(Ranges),
-    #inflight{
-        commits = Commits#{rec => RecUntil},
-        next_seqno = NextSeqno,
-        offset_ranges = Ranges
-    }.
-
--spec next_packet_id(inflight()) -> {emqx_types:packet_id(), inflight()}.
-next_packet_id(Inflight0 = #inflight{next_seqno = LastSeqno}) ->
-    Inflight = Inflight0#inflight{next_seqno = next_seqno(LastSeqno)},
-    {seqno_to_packet_id(LastSeqno), Inflight}.
-
--spec n_inflight(inflight()) -> non_neg_integer().
-n_inflight(#inflight{offset_ranges = Ranges}) ->
-    %% TODO
-    %% This is not very efficient. Instead, we can take the maximum of
-    %% `range_size(AckedUntil, NextSeqno)` and `range_size(CompUntil, NextSeqno)`.
-    %% This won't be exact number but a pessimistic estimate, but this way we
-    %% will penalize clients that PUBACK QoS 1 messages but don't PUBCOMP QoS 2
-    %% messages for some reason. For that to work, we need to additionally track
-    %% actual `AckedUntil` / `CompUntil` during `commit_offset/4`.
-    lists:foldl(
-        fun
-            (#ds_pubrange{type = ?T_CHECKPOINT}, N) ->
-                N;
-            (#ds_pubrange{type = ?T_INFLIGHT} = Range, N) ->
-                N + range_size(Range)
-        end,
-        0,
-        Ranges
-    ).
-
--spec replay(preproc_fun(), inflight()) -> {emqx_session:replies(), inflight()}.
-replay(PreprocFunFun, Inflight0 = #inflight{offset_ranges = Ranges0, commits = Commits}) ->
-    {Ranges, Replies} = lists:mapfoldr(
-        fun(Range, Acc) ->
-            replay_range(PreprocFunFun, Commits, Range, Acc)
-        end,
-        [],
-        Ranges0
-    ),
-    Inflight = Inflight0#inflight{offset_ranges = Ranges},
-    {Replies, Inflight}.
-
--spec commit_offset(emqx_persistent_session_ds:id(), Offset, emqx_types:packet_id(), inflight()) ->
-    {_IsValidOffset :: boolean(), inflight()}
-when
-    Offset :: track() | commit_type().
-commit_offset(
-    SessionId,
-    Track,
-    PacketId,
-    Inflight0 = #inflight{commits = Commits}
-) when Track == ack orelse Track == comp ->
-    case validate_commit(Track, PacketId, Inflight0) of
-        CommitUntil when is_integer(CommitUntil) ->
-            %% TODO
-            %% We do not preserve `CommitUntil` in the database. Instead, we discard
-            %% fully acked ranges from the database. In effect, this means that the
-            %% most recent `CommitUntil` the client has sent may be lost in case of a
-            %% crash or client loss.
-            Inflight1 = Inflight0#inflight{commits = Commits#{Track := CommitUntil}},
-            Inflight = discard_committed(SessionId, Inflight1),
-            {true, Inflight};
-        false ->
-            {false, Inflight0}
-    end;
-commit_offset(
-    SessionId,
-    CommitType = rec,
-    PacketId,
-    Inflight0 = #inflight{commits = Commits}
-) ->
-    case validate_commit(CommitType, PacketId, Inflight0) of
-        CommitUntil when is_integer(CommitUntil) ->
-            update_committed_offset(SessionId, CommitType, CommitUntil),
-            Inflight = Inflight0#inflight{commits = Commits#{CommitType := CommitUntil}},
-            {true, Inflight};
-        false ->
-            {false, Inflight0}
-    end.
-
--spec poll(preproc_fun(), emqx_persistent_session_ds:id(), inflight(), pos_integer()) ->
-    {emqx_session:replies(), inflight()}.
-poll(PreprocFun, SessionId, Inflight0, WindowSize) when WindowSize > 0, WindowSize < ?EPOCH_SIZE ->
-    MinBatchSize = emqx_config:get([session_persistence, min_batch_size]),
-    FetchThreshold = min(MinBatchSize, ceil(WindowSize / 2)),
-    FreeSpace = WindowSize - n_inflight(Inflight0),
-    case FreeSpace >= FetchThreshold of
-        false ->
-            %% TODO: this branch is meant to avoid fetching data from
-            %% the DB in chunks that are too small. However, this
-            %% logic is not exactly good for the latency. Can the
-            %% client get stuck even?
-            {[], Inflight0};
-        true ->
-            %% TODO: Wrap this in `mria:async_dirty/2`?
-            Checkpoints = find_checkpoints(Inflight0#inflight.offset_ranges),
-            StreamGroups = group_streams(get_streams(SessionId)),
-            {Publihes, Inflight} =
-                fetch(PreprocFun, SessionId, Inflight0, Checkpoints, StreamGroups, FreeSpace, []),
-            %% Discard now irrelevant QoS0-only ranges, if any.
-            {Publihes, discard_committed(SessionId, Inflight)}
-    end.
-
-%% Which seqno this track is committed until.
-%% "Until" means this is first seqno that is _not yet committed_ for this track.
--spec committed_until(track() | commit_type(), inflight()) -> seqno().
-committed_until(Track, #inflight{commits = Commits}) ->
-    maps:get(Track, Commits).
-
--spec seqno_to_packet_id(seqno()) -> emqx_types:packet_id() | 0.
-seqno_to_packet_id(Seqno) ->
-    Seqno rem ?EPOCH_SIZE.
-
-%% Reconstruct session counter by adding most significant bits from
-%% the current counter to the packet id.
--spec packet_id_to_seqno(emqx_types:packet_id(), inflight()) -> seqno().
-packet_id_to_seqno(PacketId, #inflight{next_seqno = NextSeqno}) ->
-    packet_id_to_seqno_(NextSeqno, PacketId).
-
-%%================================================================================
-%% Internal exports
-%%================================================================================
-
-%%================================================================================
-%% Internal functions
-%%================================================================================
-
-compute_inflight_range([]) ->
-    {#{ack => 1, comp => 1}, 1};
-compute_inflight_range(Ranges) ->
-    _RangeLast = #ds_pubrange{until = LastSeqno} = lists:last(Ranges),
-    AckedUntil = find_committed_until(ack, Ranges),
-    CompUntil = find_committed_until(comp, Ranges),
-    Commits = #{
-        ack => emqx_maybe:define(AckedUntil, LastSeqno),
-        comp => emqx_maybe:define(CompUntil, LastSeqno)
-    },
-    {Commits, LastSeqno}.
-
-find_committed_until(Track, Ranges) ->
-    RangesUncommitted = lists:dropwhile(
-        fun(Range) ->
-            case Range of
-                #ds_pubrange{type = ?T_CHECKPOINT} ->
-                    true;
-                #ds_pubrange{type = ?T_INFLIGHT, tracks = Tracks} ->
-                    not has_track(Track, Tracks)
-            end
-        end,
-        Ranges
-    ),
-    case RangesUncommitted of
-        [#ds_pubrange{id = {_, CommittedUntil, _StreamRef}} | _] ->
-            CommittedUntil;
-        [] ->
-            undefined
-    end.
-
--spec get_ranges(emqx_persistent_session_ds:id()) -> [ds_pubrange()].
-get_ranges(SessionId) ->
-    Pat = erlang:make_tuple(
-        record_info(size, ds_pubrange),
-        '_',
-        [{1, ds_pubrange}, {#ds_pubrange.id, {SessionId, '_', '_'}}]
-    ),
-    mnesia:match_object(?SESSION_PUBRANGE_TAB, Pat, read).
-
-fetch(PreprocFun, SessionId, Inflight0, CPs, Groups, N, Acc) when N > 0, Groups =/= [] ->
-    #inflight{next_seqno = FirstSeqno, offset_ranges = Ranges} = Inflight0,
-    {Stream, Groups2} = get_the_first_stream(Groups),
-    case get_next_n_messages_from_stream(Stream, CPs, N) of
-        [] ->
-            fetch(PreprocFun, SessionId, Inflight0, CPs, Groups2, N, Acc);
-        {ItBegin, ItEnd, Messages} ->
-            %% We need to preserve the iterator pointing to the beginning of the
-            %% range, so that we can replay it if needed.
-            {Publishes, UntilSeqno} = publish_fetch(PreprocFun, FirstSeqno, Messages),
-            Size = range_size(FirstSeqno, UntilSeqno),
-            Range0 = #ds_pubrange{
-                id = {SessionId, FirstSeqno, Stream#ds_stream.ref},
-                type = ?T_INFLIGHT,
-                tracks = compute_pub_tracks(Publishes),
-                until = UntilSeqno,
-                iterator = ItBegin
-            },
-            ok = preserve_range(Range0),
-            %% ...Yet we need to keep the iterator pointing past the end of the
-            %% range, so that we can pick up where we left off: it will become
-            %% `ItBegin` of the next range for this stream.
-            Range = keep_next_iterator(ItEnd, Range0),
-            Inflight = Inflight0#inflight{
-                next_seqno = UntilSeqno,
-                offset_ranges = Ranges ++ [Range]
-            },
-            fetch(PreprocFun, SessionId, Inflight, CPs, Groups2, N - Size, [Publishes | Acc])
-    end;
-fetch(_ReplyFun, _SessionId, Inflight, _CPs, _Groups, _N, Acc) ->
-    Publishes = lists:append(lists:reverse(Acc)),
-    {Publishes, Inflight}.
-
-discard_committed(
-    SessionId,
-    Inflight0 = #inflight{commits = Commits, offset_ranges = Ranges0}
-) ->
-    %% TODO: This could be kept and incrementally updated in the inflight state.
-    Checkpoints = find_checkpoints(Ranges0),
-    %% TODO: Wrap this in `mria:async_dirty/2`?
-    Ranges = discard_committed_ranges(SessionId, Commits, Checkpoints, Ranges0),
-    Inflight0#inflight{offset_ranges = Ranges}.
-
-find_checkpoints(Ranges) ->
-    lists:foldl(
-        fun(#ds_pubrange{id = {_SessionId, _, StreamRef}} = Range, Acc) ->
-            %% For each stream, remember the last range over this stream.
-            Acc#{StreamRef => Range}
-        end,
-        #{},
-        Ranges
-    ).
-
-discard_committed_ranges(
-    SessionId,
-    Commits,
-    Checkpoints,
-    Ranges = [Range = #ds_pubrange{id = {_SessionId, _, StreamRef}} | Rest]
-) ->
-    case discard_committed_range(Commits, Range) of
-        discard ->
-            %% This range has been fully committed.
-            %% Either discard it completely, or preserve the iterator for the next range
-            %% over this stream (i.e. a checkpoint).
-            RangeKept =
-                case maps:get(StreamRef, Checkpoints) of
-                    Range ->
-                        [checkpoint_range(Range)];
-                    _Previous ->
-                        discard_range(Range),
-                        []
-                end,
-            %% Since we're (intentionally) not using transactions here, it's important to
-            %% issue database writes in the same order in which ranges are stored: from
-            %% the oldest to the newest. This is also why we need to compute which ranges
-            %% should become checkpoints before we start writing anything.
-            RangeKept ++ discard_committed_ranges(SessionId, Commits, Checkpoints, Rest);
-        keep ->
-            %% This range has not been fully committed.
-            [Range | discard_committed_ranges(SessionId, Commits, Checkpoints, Rest)];
-        keep_all ->
-            %% The rest of ranges (if any) still have uncommitted messages.
-            Ranges;
-        TracksLeft ->
-            %% Only some track has been committed.
-            %% Preserve the uncommitted tracks in the database.
-            RangeKept = Range#ds_pubrange{tracks = TracksLeft},
-            preserve_range(restore_first_iterator(RangeKept)),
-            [RangeKept | discard_committed_ranges(SessionId, Commits, Checkpoints, Rest)]
-    end;
-discard_committed_ranges(_SessionId, _Commits, _Checkpoints, []) ->
-    [].
-
-discard_committed_range(_Commits, #ds_pubrange{type = ?T_CHECKPOINT}) ->
-    discard;
-discard_committed_range(
-    #{ack := AckedUntil, comp := CompUntil},
-    #ds_pubrange{until = Until}
-) when Until > AckedUntil andalso Until > CompUntil ->
-    keep_all;
-discard_committed_range(Commits, #ds_pubrange{until = Until, tracks = Tracks}) ->
-    case discard_tracks(Commits, Until, Tracks) of
-        0 ->
-            discard;
-        Tracks ->
-            keep;
-        TracksLeft ->
-            TracksLeft
-    end.
-
-discard_tracks(#{ack := AckedUntil, comp := CompUntil}, Until, Tracks) ->
-    TAck =
-        case Until > AckedUntil of
-            true -> ?TRACK_FLAG(?ACK) band Tracks;
-            false -> 0
-        end,
-    TComp =
-        case Until > CompUntil of
-            true -> ?TRACK_FLAG(?COMP) band Tracks;
-            false -> 0
-        end,
-    TAck bor TComp.
-
-replay_range(
-    PreprocFun,
-    Commits,
-    Range0 = #ds_pubrange{
-        type = ?T_INFLIGHT, id = {_, First, _StreamRef}, until = Until, iterator = It
-    },
-    Acc
-) ->
-    Size = range_size(First, Until),
-    {ok, ItNext, MessagesUnacked} = emqx_ds:next(?PERSISTENT_MESSAGE_DB, It, Size),
-    %% Asserting that range is consistent with the message storage state.
-    {Replies, Until} = publish_replay(PreprocFun, Commits, First, MessagesUnacked),
-    %% Again, we need to keep the iterator pointing past the end of the
-    %% range, so that we can pick up where we left off.
-    Range = keep_next_iterator(ItNext, Range0),
-    {Range, Replies ++ Acc};
-replay_range(_PreprocFun, _Commits, Range0 = #ds_pubrange{type = ?T_CHECKPOINT}, Acc) ->
-    {Range0, Acc}.
-
-validate_commit(
-    Track,
-    PacketId,
-    Inflight = #inflight{commits = Commits, next_seqno = NextSeqno}
-) ->
-    Seqno = packet_id_to_seqno_(NextSeqno, PacketId),
-    CommittedUntil = maps:get(Track, Commits),
-    CommitNext = get_commit_next(Track, Inflight),
-    case Seqno >= CommittedUntil andalso Seqno < CommitNext of
-        true ->
-            next_seqno(Seqno);
-        false ->
-            ?SLOG(warning, #{
-                msg => "out-of-order_commit",
-                track => Track,
-                packet_id => PacketId,
-                commit_seqno => Seqno,
-                committed_until => CommittedUntil,
-                commit_next => CommitNext
-            }),
-            false
-    end.
-
-get_commit_next(ack, #inflight{next_seqno = NextSeqno}) ->
-    NextSeqno;
-get_commit_next(rec, #inflight{next_seqno = NextSeqno}) ->
-    NextSeqno;
-get_commit_next(comp, #inflight{commits = Commits}) ->
-    maps:get(rec, Commits).
-
-publish_fetch(PreprocFun, FirstSeqno, Messages) ->
-    flatmapfoldl(
-        fun({_DSKey, MessageIn}, Acc) ->
-            Message = PreprocFun(MessageIn),
-            publish_fetch(Message, Acc)
-        end,
-        FirstSeqno,
-        Messages
-    ).
-
-publish_fetch(#message{qos = ?QOS_0} = Message, Seqno) ->
-    {{undefined, Message}, Seqno};
-publish_fetch(#message{} = Message, Seqno) ->
-    PacketId = seqno_to_packet_id(Seqno),
-    {{PacketId, Message}, next_seqno(Seqno)};
-publish_fetch(Messages, Seqno) ->
-    flatmapfoldl(fun publish_fetch/2, Seqno, Messages).
-
-publish_replay(PreprocFun, Commits, FirstSeqno, Messages) ->
-    #{ack := AckedUntil, comp := CompUntil, rec := RecUntil} = Commits,
-    flatmapfoldl(
-        fun({_DSKey, MessageIn}, Acc) ->
-            Message = PreprocFun(MessageIn),
-            publish_replay(Message, AckedUntil, CompUntil, RecUntil, Acc)
-        end,
-        FirstSeqno,
-        Messages
-    ).
-
-publish_replay(#message{qos = ?QOS_0}, _, _, _, Seqno) ->
-    %% QoS 0 (at most once) messages should not be replayed.
-    {[], Seqno};
-publish_replay(#message{qos = Qos} = Message, AckedUntil, CompUntil, RecUntil, Seqno) ->
-    case Qos of
-        ?QOS_1 when Seqno < AckedUntil ->
-            %% This message has already been acked, so we can skip it.
-            %% We still need to advance seqno, because previously we assigned this message
-            %% a unique Packet Id.
-            {[], next_seqno(Seqno)};
-        ?QOS_2 when Seqno < CompUntil ->
-            %% This message's flow has already been fully completed, so we can skip it.
-            %% We still need to advance seqno, because previously we assigned this message
-            %% a unique Packet Id.
-            {[], next_seqno(Seqno)};
-        ?QOS_2 when Seqno < RecUntil ->
-            %% This message's flow has been partially completed, we need to resend a PUBREL.
-            PacketId = seqno_to_packet_id(Seqno),
-            Pub = {pubrel, PacketId},
-            {Pub, next_seqno(Seqno)};
-        _ ->
-            %% This message flow hasn't been acked and/or received, we need to resend it.
-            PacketId = seqno_to_packet_id(Seqno),
-            Pub = {PacketId, emqx_message:set_flag(dup, true, Message)},
-            {Pub, next_seqno(Seqno)}
-    end;
-publish_replay([], _, _, _, Seqno) ->
-    {[], Seqno};
-publish_replay(Messages, AckedUntil, CompUntil, RecUntil, Seqno) ->
-    flatmapfoldl(
-        fun(Message, Acc) ->
-            publish_replay(Message, AckedUntil, CompUntil, RecUntil, Acc)
-        end,
-        Seqno,
-        Messages
-    ).
-
--spec compute_pub_tracks(replies()) -> non_neg_integer().
-compute_pub_tracks(Pubs) ->
-    compute_pub_tracks(Pubs, ?TRACK_FLAGS_NONE).
-
-compute_pub_tracks(_Pubs, Tracks = ?TRACK_FLAGS_ALL) ->
-    Tracks;
-compute_pub_tracks([Pub | Rest], Tracks) ->
-    Track =
-        case Pub of
-            {_PacketId, #message{qos = ?QOS_1}} -> ?TRACK_FLAG(?ACK);
-            {_PacketId, #message{qos = ?QOS_2}} -> ?TRACK_FLAG(?COMP);
-            {pubrel, _PacketId} -> ?TRACK_FLAG(?COMP);
-            _ -> ?TRACK_FLAGS_NONE
-        end,
-    compute_pub_tracks(Rest, Track bor Tracks);
-compute_pub_tracks([], Tracks) ->
-    Tracks.
-
-keep_next_iterator(ItNext, Range = #ds_pubrange{iterator = ItFirst, misc = Misc}) ->
-    Range#ds_pubrange{
-        iterator = ItNext,
-        %% We need to keep the first iterator around, in case we need to preserve
-        %% this range again, updating still uncommitted tracks it's part of.
-        misc = Misc#{iterator_first => ItFirst}
-    }.
-
-restore_first_iterator(Range = #ds_pubrange{misc = Misc = #{iterator_first := ItFirst}}) ->
-    Range#ds_pubrange{
-        iterator = ItFirst,
-        misc = maps:remove(iterator_first, Misc)
-    }.
-
--spec preserve_range(ds_pubrange()) -> ok.
-preserve_range(Range = #ds_pubrange{type = ?T_INFLIGHT}) ->
-    mria:dirty_write(?SESSION_PUBRANGE_TAB, Range).
-
-has_track(ack, Tracks) ->
-    (?TRACK_FLAG(?ACK) band Tracks) > 0;
-has_track(comp, Tracks) ->
-    (?TRACK_FLAG(?COMP) band Tracks) > 0.
-
--spec discard_range(ds_pubrange()) -> ok.
-discard_range(#ds_pubrange{id = RangeId}) ->
-    mria:dirty_delete(?SESSION_PUBRANGE_TAB, RangeId).
-
--spec checkpoint_range(ds_pubrange()) -> ds_pubrange().
-checkpoint_range(Range0 = #ds_pubrange{type = ?T_INFLIGHT}) ->
-    Range = Range0#ds_pubrange{type = ?T_CHECKPOINT, misc = #{}},
-    ok = mria:dirty_write(?SESSION_PUBRANGE_TAB, Range),
-    Range;
-checkpoint_range(Range = #ds_pubrange{type = ?T_CHECKPOINT}) ->
-    %% This range should have been checkpointed already.
-    Range.
-
-get_last_iterator(Stream = #ds_stream{ref = StreamRef}, Checkpoints) ->
-    case maps:get(StreamRef, Checkpoints, none) of
-        none ->
-            Stream#ds_stream.beginning;
-        #ds_pubrange{iterator = ItNext} ->
-            ItNext
-    end.
-
--spec get_streams(emqx_persistent_session_ds:id()) -> [ds_stream()].
-get_streams(SessionId) ->
-    mnesia:dirty_read(?SESSION_STREAM_TAB, SessionId).
-
--spec get_committed_offset(emqx_persistent_session_ds:id(), _Name) -> seqno().
-get_committed_offset(SessionId, Name) ->
-    case mnesia:read(?SESSION_COMMITTED_OFFSET_TAB, {SessionId, Name}) of
-        [] ->
-            1;
-        [#ds_committed_offset{until = Seqno}] ->
-            Seqno
-    end.
-
--spec update_committed_offset(emqx_persistent_session_ds:id(), _Name, seqno()) -> ok.
-update_committed_offset(SessionId, Name, Until) ->
-    mria:dirty_write(?SESSION_COMMITTED_OFFSET_TAB, #ds_committed_offset{
-        id = {SessionId, Name}, until = Until
-    }).
-
-next_seqno(Seqno) ->
-    NextSeqno = Seqno + 1,
-    case seqno_to_packet_id(NextSeqno) of
-        0 ->
-            %% We skip sequence numbers that lead to PacketId = 0 to
-            %% simplify math. Note: it leads to occasional gaps in the
-            %% sequence numbers.
-            NextSeqno + 1;
-        _ ->
-            NextSeqno
-    end.
-
-packet_id_to_seqno_(NextSeqno, PacketId) ->
-    Epoch = NextSeqno bsr 16,
-    case (Epoch bsl 16) + PacketId of
-        N when N =< NextSeqno ->
-            N;
-        N ->
-            N - ?EPOCH_SIZE
-    end.
-
-range_size(#ds_pubrange{id = {_, First, _StreamRef}, until = Until}) ->
-    range_size(First, Until).
-
-range_size(FirstSeqno, UntilSeqno) ->
-    %% This function assumes that gaps in the sequence ID occur _only_ when the
-    %% packet ID wraps.
-    Size = UntilSeqno - FirstSeqno,
-    Size + (FirstSeqno bsr 16) - (UntilSeqno bsr 16).
-
-%%================================================================================
-%% stream scheduler
-
-%% group streams by the first position in the rank
--spec group_streams(list(ds_stream())) -> list(list(ds_stream())).
-group_streams(Streams) ->
-    Groups = maps:groups_from_list(
-        fun(#ds_stream{rank = {RankX, _}}) -> RankX end,
-        Streams
-    ),
-    shuffle(maps:values(Groups)).
-
--spec shuffle([A]) -> [A].
-shuffle(L0) ->
-    L1 = lists:map(
-        fun(A) ->
-            %% maybe topic/stream prioritization could be introduced here?
-            {rand:uniform(), A}
-        end,
-        L0
-    ),
-    L2 = lists:sort(L1),
-    {_, L} = lists:unzip(L2),
-    L.
-
-get_the_first_stream([Group | Groups]) ->
-    case get_next_stream_from_group(Group) of
-        {Stream, {sorted, []}} ->
-            {Stream, Groups};
-        {Stream, Group2} ->
-            {Stream, [Group2 | Groups]};
-        undefined ->
-            get_the_first_stream(Groups)
-    end;
-get_the_first_stream([]) ->
-    %% how this possible ?
-    throw(#{reason => no_valid_stream}).
-
-%% the scheduler is simple, try to get messages from the same shard, but it's okay to take turns
-get_next_stream_from_group({sorted, [H | T]}) ->
-    {H, {sorted, T}};
-get_next_stream_from_group({sorted, []}) ->
-    undefined;
-get_next_stream_from_group(Streams) ->
-    [Stream | T] = lists:sort(
-        fun(#ds_stream{rank = {_, RankA}}, #ds_stream{rank = {_, RankB}}) ->
-            RankA < RankB
-        end,
-        Streams
-    ),
-    {Stream, {sorted, T}}.
-
-get_next_n_messages_from_stream(Stream, CPs, N) ->
-    ItBegin = get_last_iterator(Stream, CPs),
-    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, ItBegin, N) of
-        {ok, _ItEnd, []} ->
-            [];
-        {ok, ItEnd, Messages} ->
-            {ItBegin, ItEnd, Messages};
-        {ok, end_of_stream} ->
-            %% TODO: how to skip this closed stream or it should be taken over by lower level layer
-            []
-    end.
-
-%%================================================================================
-
--spec flatmapfoldl(fun((X, Acc) -> {Y | [Y], Acc}), Acc, [X]) -> {[Y], Acc}.
-flatmapfoldl(_Fun, Acc, []) ->
-    {[], Acc};
-flatmapfoldl(Fun, Acc, [X | Xs]) ->
-    {Ys, NAcc} = Fun(X, Acc),
-    {Zs, FAcc} = flatmapfoldl(Fun, NAcc, Xs),
-    case is_list(Ys) of
-        true ->
-            {Ys ++ Zs, FAcc};
-        _ ->
-            {[Ys | Zs], FAcc}
-    end.
-
-ro_transaction(Fun) ->
-    {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
-    Res.
-
--ifdef(TEST).
-
-%% This test only tests boundary conditions (to make sure property-based test didn't skip them):
-packet_id_to_seqno_test() ->
-    %% Packet ID = 1; first epoch:
-    ?assertEqual(1, packet_id_to_seqno_(1, 1)),
-    ?assertEqual(1, packet_id_to_seqno_(10, 1)),
-    ?assertEqual(1, packet_id_to_seqno_(1 bsl 16 - 1, 1)),
-    ?assertEqual(1, packet_id_to_seqno_(1 bsl 16, 1)),
-    %% Packet ID = 1; second and 3rd epochs:
-    ?assertEqual(1 bsl 16 + 1, packet_id_to_seqno_(1 bsl 16 + 1, 1)),
-    ?assertEqual(1 bsl 16 + 1, packet_id_to_seqno_(2 bsl 16, 1)),
-    ?assertEqual(2 bsl 16 + 1, packet_id_to_seqno_(2 bsl 16 + 1, 1)),
-    %% Packet ID = 16#ffff:
-    PID = 1 bsl 16 - 1,
-    ?assertEqual(PID, packet_id_to_seqno_(PID, PID)),
-    ?assertEqual(PID, packet_id_to_seqno_(1 bsl 16, PID)),
-    ?assertEqual(1 bsl 16 + PID, packet_id_to_seqno_(2 bsl 16, PID)),
-    ok.
-
-packet_id_to_seqno_test_() ->
-    Opts = [{numtests, 1000}, {to_file, user}],
-    {timeout, 30, fun() -> ?assert(proper:quickcheck(packet_id_to_seqno_prop(), Opts)) end}.
-
-packet_id_to_seqno_prop() ->
-    ?FORALL(
-        NextSeqNo,
-        next_seqno_gen(),
-        ?FORALL(
-            SeqNo,
-            seqno_gen(NextSeqNo),
-            begin
-                PacketId = seqno_to_packet_id(SeqNo),
-                ?assertEqual(SeqNo, packet_id_to_seqno_(NextSeqNo, PacketId)),
-                true
-            end
-        )
-    ).
-
-next_seqno_gen() ->
-    ?LET(
-        {Epoch, Offset},
-        {non_neg_integer(), non_neg_integer()},
-        Epoch bsl 16 + Offset
-    ).
-
-seqno_gen(NextSeqNo) ->
-    WindowSize = 1 bsl 16 - 1,
-    Min = max(0, NextSeqNo - WindowSize),
-    Max = max(0, NextSeqNo - 1),
-    range(Min, Max).
-
-range_size_test_() ->
-    [
-        ?_assertEqual(0, range_size(42, 42)),
-        ?_assertEqual(1, range_size(42, 43)),
-        ?_assertEqual(1, range_size(16#ffff, 16#10001)),
-        ?_assertEqual(16#ffff - 456 + 123, range_size(16#1f0000 + 456, 16#200000 + 123))
-    ].
-
-compute_inflight_range_test_() ->
-    [
-        ?_assertEqual(
-            {#{ack => 1, comp => 1}, 1},
-            compute_inflight_range([])
-        ),
-        ?_assertEqual(
-            {#{ack => 12, comp => 13}, 42},
-            compute_inflight_range([
-                #ds_pubrange{id = {<<>>, 1, 0}, until = 2, type = ?T_CHECKPOINT},
-                #ds_pubrange{id = {<<>>, 4, 0}, until = 8, type = ?T_CHECKPOINT},
-                #ds_pubrange{id = {<<>>, 11, 0}, until = 12, type = ?T_CHECKPOINT},
-                #ds_pubrange{
-                    id = {<<>>, 12, 0},
-                    until = 13,
-                    type = ?T_INFLIGHT,
-                    tracks = ?TRACK_FLAG(?ACK)
-                },
-                #ds_pubrange{
-                    id = {<<>>, 13, 0},
-                    until = 20,
-                    type = ?T_INFLIGHT,
-                    tracks = ?TRACK_FLAG(?COMP)
-                },
-                #ds_pubrange{
-                    id = {<<>>, 20, 0},
-                    until = 42,
-                    type = ?T_INFLIGHT,
-                    tracks = ?TRACK_FLAG(?ACK) bor ?TRACK_FLAG(?COMP)
-                }
-            ])
-        ),
-        ?_assertEqual(
-            {#{ack => 13, comp => 13}, 13},
-            compute_inflight_range([
-                #ds_pubrange{id = {<<>>, 1, 0}, until = 2, type = ?T_CHECKPOINT},
-                #ds_pubrange{id = {<<>>, 4, 0}, until = 8, type = ?T_CHECKPOINT},
-                #ds_pubrange{id = {<<>>, 11, 0}, until = 12, type = ?T_CHECKPOINT},
-                #ds_pubrange{id = {<<>>, 12, 0}, until = 13, type = ?T_CHECKPOINT}
-            ])
-        )
-    ].
-
--endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index a8c62fe7a..1ab256d32 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2021-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2021-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -19,6 +19,7 @@
 -behaviour(emqx_session).
 
 -include("emqx.hrl").
+-include_lib("emqx/include/logger.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("stdlib/include/ms_transform.hrl").
 
@@ -78,59 +79,64 @@
 -ifdef(TEST).
 -export([
     session_open/2,
-    list_all_sessions/0,
-    list_all_subscriptions/0,
-    list_all_streams/0,
-    list_all_pubranges/0
+    list_all_sessions/0
 ]).
 -endif.
 
 -export_type([
     id/0,
-    subscription_id/0,
-    session/0
+    seqno/0,
+    timestamp/0,
+    topic_filter/0,
+    subscription/0,
+    session/0,
+    stream_state/0
 ]).
 
+-type seqno() :: non_neg_integer().
+
 %% Currently, this is the clientid.  We avoid `emqx_types:clientid()' because that can be
 %% an atom, in theory (?).
 -type id() :: binary().
 -type topic_filter() :: emqx_types:topic().
--type topic_filter_words() :: emqx_ds:topic_filter().
--type subscription_id() :: {id(), topic_filter()}.
+
 -type subscription() :: #{
     start_time := emqx_ds:time(),
     props := map(),
     extra := map()
 }.
 
+%%%%% Session sequence numbers:
+-define(next(QOS), {0, QOS}).
+%% Note: we consider the sequence number _committed_ once the full
+%% packet MQTT flow is completed for the sequence number. That is,
+%% when we receive PUBACK for the QoS1 message, or PUBCOMP, or PUBREC
+%% with Reason code > 0x80 for QoS2 message.
+-define(committed(QOS), {1, QOS}).
+%% For QoS2 messages we also need to store the sequence number of the
+%% last PUBREL message:
+-define(pubrec, 2).
+
 -define(TIMER_PULL, timer_pull).
 -define(TIMER_GET_STREAMS, timer_get_streams).
 -define(TIMER_BUMP_LAST_ALIVE_AT, timer_bump_last_alive_at).
 -type timer() :: ?TIMER_PULL | ?TIMER_GET_STREAMS | ?TIMER_BUMP_LAST_ALIVE_AT.
 
--type subscriptions() :: emqx_topic_gbt:t(nil(), subscription()).
-
 -type session() :: #{
     %% Client ID
     id := id(),
-    %% When the session was created
-    created_at := timestamp(),
-    %% When the client was last considered alive
-    last_alive_at := timestamp(),
-    %% Client’s Subscriptions.
-    subscriptions := subscriptions(),
-    %% Inflight messages
-    inflight := emqx_persistent_message_ds_replayer:inflight(),
-    %% Receive maximum
-    receive_maximum := pos_integer(),
-    %% Connection Info
-    conninfo := emqx_types:conninfo(),
-    %% Timers
-    timer() => reference(),
-    %%
-    props := map()
+    %% Configuration:
+    props := map(),
+    %% Persistent state:
+    s := emqx_persistent_session_ds_state:t(),
+    %% Buffer:
+    inflight := emqx_persistent_session_ds_inflight:t(),
+    %% Timers:
+    timer() => reference()
 }.
 
+-type stream_state() :: #ifs{}.
+
 -type timestamp() :: emqx_utils_calendar:epoch_millisecond().
 -type millisecond() :: non_neg_integer().
 -type clientinfo() :: emqx_types:clientinfo().
@@ -141,23 +147,15 @@
     subscriptions_cnt,
     subscriptions_max,
     inflight_cnt,
-    inflight_max,
-    next_pkt_id
+    inflight_max
 ]).
 
--define(IS_EXPIRED(NOW_MS, LAST_ALIVE_AT, EI),
-    (is_number(LAST_ALIVE_AT) andalso
-        is_number(EI) andalso
-        (NOW_MS >= LAST_ALIVE_AT + EI))
-).
-
 %%
 
 -spec create(clientinfo(), conninfo(), emqx_session:conf()) ->
     session().
 create(#{clientid := ClientID}, ConnInfo, Conf) ->
-    Session = session_ensure_new(ClientID, ConnInfo),
-    apply_conf(ConnInfo, Conf, ensure_timers(Session)).
+    ensure_timers(session_ensure_new(ClientID, ConnInfo, Conf)).
 
 -spec open(clientinfo(), conninfo(), emqx_session:conf()) ->
     {_IsPresent :: true, session(), []} | false.
@@ -171,18 +169,12 @@ open(#{clientid := ClientID} = _ClientInfo, ConnInfo, Conf) ->
     ok = emqx_cm:discard_session(ClientID),
     case session_open(ClientID, ConnInfo) of
         Session0 = #{} ->
-            Session = apply_conf(ConnInfo, Conf, Session0),
+            Session = Session0#{props => Conf},
             {true, ensure_timers(Session), []};
         false ->
             false
     end.
 
-apply_conf(ConnInfo, Conf, Session) ->
-    Session#{
-        receive_maximum => receive_maximum(ConnInfo),
-        props => Conf
-    }.
-
 -spec destroy(session() | clientinfo()) -> ok.
 destroy(#{id := ClientID}) ->
     destroy_session(ClientID);
@@ -202,14 +194,14 @@ info(id, #{id := ClientID}) ->
     ClientID;
 info(clientid, #{id := ClientID}) ->
     ClientID;
-info(created_at, #{created_at := CreatedAt}) ->
-    CreatedAt;
+info(created_at, #{s := S}) ->
+    emqx_persistent_session_ds_state:get_created_at(S);
 info(is_persistent, #{}) ->
     true;
-info(subscriptions, #{subscriptions := Subs}) ->
-    subs_to_map(Subs);
-info(subscriptions_cnt, #{subscriptions := Subs}) ->
-    subs_size(Subs);
+info(subscriptions, #{s := S}) ->
+    subs_to_map(S);
+info(subscriptions_cnt, #{s := S}) ->
+    emqx_topic_gbt:size(emqx_persistent_session_ds_state:get_subscriptions(S));
 info(subscriptions_max, #{props := Conf}) ->
     maps:get(max_subscriptions, Conf);
 info(upgrade_qos, #{props := Conf}) ->
@@ -217,9 +209,9 @@ info(upgrade_qos, #{props := Conf}) ->
 info(inflight, #{inflight := Inflight}) ->
     Inflight;
 info(inflight_cnt, #{inflight := Inflight}) ->
-    emqx_persistent_message_ds_replayer:n_inflight(Inflight);
-info(inflight_max, #{receive_maximum := ReceiveMaximum}) ->
-    ReceiveMaximum;
+    emqx_persistent_session_ds_inflight:n_inflight(Inflight);
+info(inflight_max, #{inflight := Inflight}) ->
+    emqx_persistent_session_ds_inflight:receive_maximum(Inflight);
 info(retry_interval, #{props := Conf}) ->
     maps:get(retry_interval, Conf);
 % info(mqueue, #sessmem{mqueue = MQueue}) ->
@@ -230,9 +222,9 @@ info(retry_interval, #{props := Conf}) ->
 %     emqx_mqueue:max_len(MQueue);
 % info(mqueue_dropped, #sessmem{mqueue = MQueue}) ->
 %     emqx_mqueue:dropped(MQueue);
-info(next_pkt_id, #{inflight := Inflight}) ->
-    {PacketId, _} = emqx_persistent_message_ds_replayer:next_packet_id(Inflight),
-    PacketId;
+%% info(next_pkt_id, #{s := S}) ->
+%%     {PacketId, _} = emqx_persistent_message_ds_replayer:next_packet_id(S),
+%%     PacketId;
 % info(awaiting_rel, #sessmem{awaiting_rel = AwaitingRel}) ->
 %     AwaitingRel;
 % info(awaiting_rel_cnt, #sessmem{awaiting_rel = AwaitingRel}) ->
@@ -249,22 +241,7 @@ stats(Session) ->
 %% Debug/troubleshooting
 -spec print_session(emqx_types:clientid()) -> map() | undefined.
 print_session(ClientId) ->
-    catch ro_transaction(
-        fun() ->
-            case mnesia:read(?SESSION_TAB, ClientId) of
-                [Session] ->
-                    #{
-                        session => Session,
-                        streams => mnesia:read(?SESSION_STREAM_TAB, ClientId),
-                        pubranges => session_read_pubranges(ClientId),
-                        offsets => session_read_offsets(ClientId),
-                        subscriptions => session_read_subscriptions(ClientId)
-                    };
-                [] ->
-                    undefined
-            end
-        end
-    ).
+    emqx_persistent_session_ds_state:print_session(ClientId).
 
 %%--------------------------------------------------------------------
 %% Client -> Broker: SUBSCRIBE / UNSUBSCRIBE
@@ -275,39 +252,74 @@ print_session(ClientId) ->
 subscribe(
     TopicFilter,
     SubOpts,
-    Session = #{id := ID, subscriptions := Subs}
+    Session = #{id := ID, s := S0}
 ) ->
-    case subs_lookup(TopicFilter, Subs) of
-        Subscription = #{} ->
-            NSubscription = update_subscription(TopicFilter, Subscription, SubOpts, ID),
-            NSubs = subs_insert(TopicFilter, NSubscription, Subs),
-            {ok, Session#{subscriptions := NSubs}};
+    case subs_lookup(TopicFilter, S0) of
         undefined ->
-            % TODO: max_subscriptions
-            Subscription = add_subscription(TopicFilter, SubOpts, ID),
-            NSubs = subs_insert(TopicFilter, Subscription, Subs),
-            {ok, Session#{subscriptions := NSubs}}
-    end.
+            %% N.B.: we chose to update the router before adding the
+            %% subscription to the session/iterator table. The
+            %% reasoning for this is as follows:
+            %%
+            %% Messages matching this topic filter should start to be
+            %% persisted as soon as possible to avoid missing
+            %% messages. If this is the first such persistent session
+            %% subscription, it's important to do so early on.
+            %%
+            %% This could, in turn, lead to some inconsistency: if
+            %% such a route gets created but the session/iterator data
+            %% fails to be updated accordingly, we have a dangling
+            %% route. To remove such dangling routes, we may have a
+            %% periodic GC process that removes routes that do not
+            %% have a matching persistent subscription. Also, route
+            %% operations use dirty mnesia operations, which
+            %% inherently have room for inconsistencies.
+            %%
+            %% In practice, we use the iterator reference table as a
+            %% source of truth, since it is guarded by a transaction
+            %% context: we consider a subscription operation to be
+            %% successful if it ended up changing this table. Both
+            %% router and iterator information can be reconstructed
+            %% from this table, if needed.
+            ok = emqx_persistent_session_ds_router:do_add_route(TopicFilter, ID),
+            Subscription = #{
+                start_time => now_ms(),
+                props => SubOpts
+            },
+            IsNew = true;
+        Subscription0 = #{} ->
+            Subscription = Subscription0#{props => SubOpts},
+            IsNew = false
+    end,
+    S = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S0),
+    ?tp(persistent_session_ds_subscription_added, #{
+        topic_filter => TopicFilter, sub => Subscription, is_new => IsNew
+    }),
+    {ok, Session#{s => S}}.
 
 -spec unsubscribe(topic_filter(), session()) ->
     {ok, session(), emqx_types:subopts()} | {error, emqx_types:reason_code()}.
 unsubscribe(
     TopicFilter,
-    Session = #{id := ID, subscriptions := Subs}
+    Session = #{id := ID, s := S0}
 ) ->
-    case subs_lookup(TopicFilter, Subs) of
-        _Subscription = #{props := SubOpts} ->
-            ok = del_subscription(TopicFilter, ID),
-            NSubs = subs_delete(TopicFilter, Subs),
-            {ok, Session#{subscriptions := NSubs}, SubOpts};
+    %% TODO: drop streams and messages from the buffer
+    case subs_lookup(TopicFilter, S0) of
+        #{props := SubOpts} ->
+            S = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
+            ?tp_span(
+                persistent_session_ds_subscription_route_delete,
+                #{session_id => ID},
+                ok = emqx_persistent_session_ds_router:do_delete_route(TopicFilter, ID)
+            ),
+            {ok, Session#{s => S}, SubOpts};
         undefined ->
             {error, ?RC_NO_SUBSCRIPTION_EXISTED}
     end.
 
 -spec get_subscription(topic_filter(), session()) ->
     emqx_types:subopts() | undefined.
-get_subscription(TopicFilter, #{subscriptions := Subs}) ->
-    case subs_lookup(TopicFilter, Subs) of
+get_subscription(TopicFilter, #{s := S}) ->
+    case subs_lookup(TopicFilter, S) of
         _Subscription = #{props := SubOpts} ->
             SubOpts;
         undefined ->
@@ -333,15 +345,12 @@ publish(_PacketId, Msg, Session) ->
 -spec puback(clientinfo(), emqx_types:packet_id(), session()) ->
     {ok, emqx_types:message(), replies(), session()}
     | {error, emqx_types:reason_code()}.
-puback(_ClientInfo, PacketId, Session = #{id := Id, inflight := Inflight0}) ->
-    case emqx_persistent_message_ds_replayer:commit_offset(Id, ack, PacketId, Inflight0) of
-        {true, Inflight} ->
-            %% TODO: we pass a bogus message into the hook:
-            Msg = emqx_message:make(Id, <<>>, <<>>),
-            {ok, Msg, [], pull_now(Session#{inflight => Inflight})};
-        {false, _} ->
-            %% Invalid Packet Id
-            {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
+puback(_ClientInfo, PacketId, Session0) ->
+    case commit_seqno(puback, PacketId, Session0) of
+        {ok, Msg, Session} ->
+            {ok, Msg, [], inc_send_quota(Session)};
+        Error ->
+            Error
     end.
 
 %%--------------------------------------------------------------------
@@ -351,15 +360,12 @@ puback(_ClientInfo, PacketId, Session = #{id := Id, inflight := Inflight0}) ->
 -spec pubrec(emqx_types:packet_id(), session()) ->
     {ok, emqx_types:message(), session()}
     | {error, emqx_types:reason_code()}.
-pubrec(PacketId, Session = #{id := Id, inflight := Inflight0}) ->
-    case emqx_persistent_message_ds_replayer:commit_offset(Id, rec, PacketId, Inflight0) of
-        {true, Inflight} ->
-            %% TODO: we pass a bogus message into the hook:
-            Msg = emqx_message:make(Id, <<>>, <<>>),
-            {ok, Msg, pull_now(Session#{inflight => Inflight})};
-        {false, _} ->
-            %% Invalid Packet Id
-            {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
+pubrec(PacketId, Session0) ->
+    case commit_seqno(pubrec, PacketId, Session0) of
+        {ok, Msg, Session} ->
+            {ok, Msg, Session};
+        Error = {error, _} ->
+            Error
     end.
 
 %%--------------------------------------------------------------------
@@ -379,15 +385,12 @@ pubrel(_PacketId, Session = #{}) ->
 -spec pubcomp(clientinfo(), emqx_types:packet_id(), session()) ->
     {ok, emqx_types:message(), replies(), session()}
     | {error, emqx_types:reason_code()}.
-pubcomp(_ClientInfo, PacketId, Session = #{id := Id, inflight := Inflight0}) ->
-    case emqx_persistent_message_ds_replayer:commit_offset(Id, comp, PacketId, Inflight0) of
-        {true, Inflight} ->
-            %% TODO
-            Msg = emqx_message:make(Id, <<>>, <<>>),
-            {ok, Msg, [], Session#{inflight => Inflight}};
-        {false, _} ->
-            %% Invalid Packet Id
-            {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
+pubcomp(_ClientInfo, PacketId, Session0) ->
+    case commit_seqno(pubcomp, PacketId, Session0) of
+        {ok, Msg, Session} ->
+            {ok, Msg, [], inc_send_quota(Session)};
+        Error = {error, _} ->
+            Error
     end.
 
 %%--------------------------------------------------------------------
@@ -403,215 +406,87 @@ deliver(_ClientInfo, _Delivers, Session) ->
 handle_timeout(
     ClientInfo,
     ?TIMER_PULL,
-    Session0 = #{
-        id := Id,
-        inflight := Inflight0,
-        subscriptions := Subs,
-        props := Conf,
-        receive_maximum := ReceiveMaximum
-    }
+    Session0
 ) ->
-    MaxBatchSize = emqx_config:get([session_persistence, max_batch_size]),
-    BatchSize = min(ReceiveMaximum, MaxBatchSize),
-    UpgradeQoS = maps:get(upgrade_qos, Conf),
-    PreprocFun = make_preproc_fun(ClientInfo, Subs, UpgradeQoS),
-    {Publishes, Inflight} = emqx_persistent_message_ds_replayer:poll(
-        PreprocFun,
-        Id,
-        Inflight0,
-        BatchSize
-    ),
-    IdlePollInterval = emqx_config:get([session_persistence, idle_poll_interval]),
+    {Publishes, Session1} = drain_buffer(fill_buffer(Session0, ClientInfo)),
     Timeout =
         case Publishes of
             [] ->
-                IdlePollInterval;
+                emqx_config:get([session_persistence, idle_poll_interval]);
             [_ | _] ->
                 0
         end,
-    Session = emqx_session:ensure_timer(?TIMER_PULL, Timeout, Session0#{inflight := Inflight}),
+    Session = emqx_session:ensure_timer(?TIMER_PULL, Timeout, Session1),
     {ok, Publishes, Session};
-handle_timeout(_ClientInfo, ?TIMER_GET_STREAMS, Session) ->
-    renew_streams(Session),
+handle_timeout(_ClientInfo, ?TIMER_GET_STREAMS, Session0 = #{s := S0}) ->
+    S = renew_streams(S0),
     Interval = emqx_config:get([session_persistence, renew_streams_interval]),
-    {ok, [], emqx_session:ensure_timer(?TIMER_GET_STREAMS, Interval, Session)};
-handle_timeout(_ClientInfo, ?TIMER_BUMP_LAST_ALIVE_AT, Session0) ->
-    %% Note: we take a pessimistic approach here and assume that the client will be alive
-    %% until the next bump timeout.  With this, we avoid garbage collecting this session
-    %% too early in case the session/connection/node crashes earlier without having time
-    %% to commit the time.
-    BumpInterval = emqx_config:get([session_persistence, last_alive_update_interval]),
-    EstimatedLastAliveAt = now_ms() + BumpInterval,
-    Session = session_set_last_alive_at_trans(Session0, EstimatedLastAliveAt),
-    {ok, [], emqx_session:ensure_timer(?TIMER_BUMP_LAST_ALIVE_AT, BumpInterval, Session)};
+    Session = emqx_session:ensure_timer(
+        ?TIMER_GET_STREAMS,
+        Interval,
+        Session0#{s => S}
+    ),
+    {ok, [], Session};
+handle_timeout(_ClientInfo, ?TIMER_BUMP_LAST_ALIVE_AT, Session0 = #{s := S0}) ->
+    S = emqx_persistent_session_ds_state:commit(bump_last_alive(S0)),
+    Session = emqx_session:ensure_timer(
+        ?TIMER_BUMP_LAST_ALIVE_AT,
+        bump_interval(),
+        Session0#{s => S}
+    ),
+    {ok, [], Session};
 handle_timeout(_ClientInfo, expire_awaiting_rel, Session) ->
     %% TODO: stub
     {ok, [], Session}.
 
+bump_last_alive(S0) ->
+    %% Note: we take a pessimistic approach here and assume that the client will be alive
+    %% until the next bump timeout.  With this, we avoid garbage collecting this session
+    %% too early in case the session/connection/node crashes earlier without having time
+    %% to commit the time.
+    EstimatedLastAliveAt = now_ms() + bump_interval(),
+    emqx_persistent_session_ds_state:set_last_alive_at(EstimatedLastAliveAt, S0).
+
 -spec replay(clientinfo(), [], session()) ->
     {ok, replies(), session()}.
-replay(
-    ClientInfo,
-    [],
-    Session = #{inflight := Inflight0, subscriptions := Subs, props := Conf}
-) ->
-    UpgradeQoS = maps:get(upgrade_qos, Conf),
-    PreprocFun = make_preproc_fun(ClientInfo, Subs, UpgradeQoS),
-    {Replies, Inflight} = emqx_persistent_message_ds_replayer:replay(PreprocFun, Inflight0),
-    {ok, Replies, Session#{inflight := Inflight}}.
-
+replay(ClientInfo, [], Session0) ->
+    Streams = find_replay_streams(Session0),
+    Session = lists:foldl(
+        fun({StreamKey, Stream}, SessionAcc) ->
+            replay_batch(StreamKey, Stream, SessionAcc, ClientInfo)
+        end,
+        Session0,
+        Streams
+    ),
+    %% Note: we filled the buffer with the historical messages, and
+    %% from now on we'll rely on the normal inflight/flow control
+    %% mechanisms to replay them:
+    {ok, [], pull_now(Session)}.
 %%--------------------------------------------------------------------
 
 -spec disconnect(session(), emqx_types:conninfo()) -> {shutdown, session()}.
-disconnect(Session0, ConnInfo) ->
-    Session = session_set_last_alive_at_trans(Session0, ConnInfo, now_ms()),
-    {shutdown, Session}.
+disconnect(Session = #{s := S0}, _ConnInfo) ->
+    S1 = emqx_persistent_session_ds_state:set_last_alive_at(now_ms(), S0),
+    S = emqx_persistent_session_ds_state:commit(S1),
+    {shutdown, Session#{s => S}}.
 
 -spec terminate(Reason :: term(), session()) -> ok.
-terminate(_Reason, _Session = #{}) ->
+terminate(_Reason, _Session = #{s := S}) ->
+    emqx_persistent_session_ds_state:commit(S),
     ok.
 
-%%--------------------------------------------------------------------
-
-make_preproc_fun(ClientInfo, Subs, UpgradeQoS) ->
-    fun(Message = #message{topic = Topic}) ->
-        emqx_utils:flattermap(
-            fun(Match) ->
-                #{props := SubOpts} = subs_get_match(Match, Subs),
-                emqx_session:enrich_message(ClientInfo, Message, SubOpts, UpgradeQoS)
-            end,
-            subs_matches(Topic, Subs)
-        )
-    end.
-
-%%--------------------------------------------------------------------
-
--spec add_subscription(topic_filter(), emqx_types:subopts(), id()) ->
-    subscription().
-add_subscription(TopicFilter, SubOpts, DSSessionID) ->
-    %% N.B.: we chose to update the router before adding the subscription to the
-    %% session/iterator table.  The reasoning for this is as follows:
-    %%
-    %% Messages matching this topic filter should start to be persisted as soon as
-    %% possible to avoid missing messages.  If this is the first such persistent
-    %% session subscription, it's important to do so early on.
-    %%
-    %% This could, in turn, lead to some inconsistency: if such a route gets
-    %% created but the session/iterator data fails to be updated accordingly, we
-    %% have a dangling route.  To remove such dangling routes, we may have a
-    %% periodic GC process that removes routes that do not have a matching
-    %% persistent subscription.  Also, route operations use dirty mnesia
-    %% operations, which inherently have room for inconsistencies.
-    %%
-    %% In practice, we use the iterator reference table as a source of truth,
-    %% since it is guarded by a transaction context: we consider a subscription
-    %% operation to be successful if it ended up changing this table.  Both router
-    %% and iterator information can be reconstructed from this table, if needed.
-    ok = emqx_persistent_session_ds_router:do_add_route(TopicFilter, DSSessionID),
-    {ok, DSSubExt, IsNew} = session_add_subscription(
-        DSSessionID, TopicFilter, SubOpts
-    ),
-    ?tp(persistent_session_ds_subscription_added, #{sub => DSSubExt, is_new => IsNew}),
-    %% we'll list streams and open iterators when implementing message replay.
-    DSSubExt.
-
--spec update_subscription(topic_filter(), subscription(), emqx_types:subopts(), id()) ->
-    subscription().
-update_subscription(TopicFilter, DSSubExt, SubOpts, DSSessionID) ->
-    {ok, NDSSubExt, false} = session_add_subscription(
-        DSSessionID, TopicFilter, SubOpts
-    ),
-    ok = ?tp(persistent_session_ds_iterator_updated, #{sub => DSSubExt}),
-    NDSSubExt.
-
--spec del_subscription(topic_filter(), id()) ->
-    ok.
-del_subscription(TopicFilter, DSSessionId) ->
-    %% TODO: transaction?
-    ?tp_span(
-        persistent_session_ds_subscription_delete,
-        #{session_id => DSSessionId},
-        ok = session_del_subscription(DSSessionId, TopicFilter)
-    ),
-    ?tp_span(
-        persistent_session_ds_subscription_route_delete,
-        #{session_id => DSSessionId},
-        ok = emqx_persistent_session_ds_router:do_delete_route(TopicFilter, DSSessionId)
-    ).
-
 %%--------------------------------------------------------------------
 %% Session tables operations
 %%--------------------------------------------------------------------
 
 create_tables() ->
-    ok = mria:create_table(
-        ?SESSION_TAB,
-        [
-            {rlog_shard, ?DS_MRIA_SHARD},
-            {type, set},
-            {storage, storage()},
-            {record_name, session},
-            {attributes, record_info(fields, session)}
-        ]
-    ),
-    ok = mria:create_table(
-        ?SESSION_SUBSCRIPTIONS_TAB,
-        [
-            {rlog_shard, ?DS_MRIA_SHARD},
-            {type, ordered_set},
-            {storage, storage()},
-            {record_name, ds_sub},
-            {attributes, record_info(fields, ds_sub)}
-        ]
-    ),
-    ok = mria:create_table(
-        ?SESSION_STREAM_TAB,
-        [
-            {rlog_shard, ?DS_MRIA_SHARD},
-            {type, bag},
-            {storage, storage()},
-            {record_name, ds_stream},
-            {attributes, record_info(fields, ds_stream)}
-        ]
-    ),
-    ok = mria:create_table(
-        ?SESSION_PUBRANGE_TAB,
-        [
-            {rlog_shard, ?DS_MRIA_SHARD},
-            {type, ordered_set},
-            {storage, storage()},
-            {record_name, ds_pubrange},
-            {attributes, record_info(fields, ds_pubrange)}
-        ]
-    ),
-    ok = mria:create_table(
-        ?SESSION_COMMITTED_OFFSET_TAB,
-        [
-            {rlog_shard, ?DS_MRIA_SHARD},
-            {type, set},
-            {storage, storage()},
-            {record_name, ds_committed_offset},
-            {attributes, record_info(fields, ds_committed_offset)}
-        ]
-    ),
-    ok = mria:wait_for_tables([
-        ?SESSION_TAB,
-        ?SESSION_SUBSCRIPTIONS_TAB,
-        ?SESSION_STREAM_TAB,
-        ?SESSION_PUBRANGE_TAB,
-        ?SESSION_COMMITTED_OFFSET_TAB
-    ]),
-    ok.
+    emqx_persistent_session_ds_state:create_tables().
 
--dialyzer({nowarn_function, storage/0}).
-storage() ->
-    %% FIXME: This is a temporary workaround to avoid crashes when starting on Windows
-    case mria:rocksdb_backend_available() of
-        true ->
-            rocksdb_copies;
-        _ ->
-            disc_copies
-    end.
+-define(IS_EXPIRED(NOW_MS, LAST_ALIVE_AT, EI),
+    (is_number(LAST_ALIVE_AT) andalso
+        is_number(EI) andalso
+        (NOW_MS >= LAST_ALIVE_AT + EI))
+).
 
 %% @doc Called when a client connects. This function looks up a
 %% session or returns `false` if previous one couldn't be found.
@@ -622,204 +497,59 @@ storage() ->
     session() | false.
 session_open(SessionId, NewConnInfo) ->
     NowMS = now_ms(),
-    transaction(fun() ->
-        case mnesia:read(?SESSION_TAB, SessionId, write) of
-            [Record0 = #session{last_alive_at = LastAliveAt, conninfo = ConnInfo}] ->
-                EI = expiry_interval(ConnInfo),
-                case ?IS_EXPIRED(NowMS, LastAliveAt, EI) of
-                    true ->
-                        session_drop(SessionId),
-                        false;
-                    false ->
-                        %% new connection being established
-                        Record1 = Record0#session{conninfo = NewConnInfo},
-                        Record = session_set_last_alive_at(Record1, NowMS),
-                        Session = export_session(Record),
-                        DSSubs = session_read_subscriptions(SessionId),
-                        Subscriptions = export_subscriptions(DSSubs),
-                        Inflight = emqx_persistent_message_ds_replayer:open(SessionId),
-                        Session#{
-                            conninfo => NewConnInfo,
-                            inflight => Inflight,
-                            subscriptions => Subscriptions
-                        }
-                end;
-            _ ->
-                false
-        end
-    end).
+    case emqx_persistent_session_ds_state:open(SessionId) of
+        {ok, S0} ->
+            EI = expiry_interval(emqx_persistent_session_ds_state:get_conninfo(S0)),
+            LastAliveAt = emqx_persistent_session_ds_state:get_last_alive_at(S0),
+            case ?IS_EXPIRED(NowMS, LastAliveAt, EI) of
+                true ->
+                    emqx_persistent_session_ds_state:delete(SessionId),
+                    false;
+                false ->
+                    %% New connection being established
+                    S1 = emqx_persistent_session_ds_state:set_conninfo(NewConnInfo, S0),
+                    S2 = emqx_persistent_session_ds_state:set_last_alive_at(NowMS, S1),
+                    S = emqx_persistent_session_ds_state:commit(S2),
+                    Inflight = emqx_persistent_session_ds_inflight:new(
+                        receive_maximum(NewConnInfo)
+                    ),
+                    #{
+                        id => SessionId,
+                        s => S,
+                        inflight => Inflight,
+                        props => #{}
+                    }
+            end;
+        undefined ->
+            false
+    end.
 
--spec session_ensure_new(id(), emqx_types:conninfo()) ->
+-spec session_ensure_new(id(), emqx_types:conninfo(), emqx_session:conf()) ->
     session().
-session_ensure_new(SessionId, ConnInfo) ->
-    transaction(fun() ->
-        ok = session_drop_records(SessionId),
-        Session = export_session(session_create(SessionId, ConnInfo)),
-        Session#{
-            subscriptions => subs_new(),
-            inflight => emqx_persistent_message_ds_replayer:new()
-        }
-    end).
-
-session_create(SessionId, ConnInfo) ->
-    Session = #session{
-        id = SessionId,
-        created_at = now_ms(),
-        last_alive_at = now_ms(),
-        conninfo = ConnInfo
-    },
-    ok = mnesia:write(?SESSION_TAB, Session, write),
-    Session.
-
-session_set_last_alive_at_trans(Session, LastAliveAt) ->
-    #{conninfo := ConnInfo} = Session,
-    session_set_last_alive_at_trans(Session, ConnInfo, LastAliveAt).
-
-session_set_last_alive_at_trans(Session, NewConnInfo, LastAliveAt) ->
-    #{id := SessionId} = Session,
-    transaction(fun() ->
-        case mnesia:read(?SESSION_TAB, SessionId, write) of
-            [#session{} = SessionRecord0] ->
-                SessionRecord = SessionRecord0#session{conninfo = NewConnInfo},
-                _ = session_set_last_alive_at(SessionRecord, LastAliveAt),
-                ok;
-            _ ->
-                %% log and crash?
-                ok
-        end
-    end),
-    Session#{conninfo := NewConnInfo, last_alive_at := LastAliveAt}.
-
-session_set_last_alive_at(SessionRecord0, LastAliveAt) ->
-    SessionRecord = SessionRecord0#session{last_alive_at = LastAliveAt},
-    ok = mnesia:write(?SESSION_TAB, SessionRecord, write),
-    SessionRecord.
+session_ensure_new(Id, ConnInfo, Conf) ->
+    Now = now_ms(),
+    S0 = emqx_persistent_session_ds_state:create_new(Id),
+    S1 = emqx_persistent_session_ds_state:set_conninfo(ConnInfo, S0),
+    S2 = bump_last_alive(S1),
+    S3 = emqx_persistent_session_ds_state:set_created_at(Now, S2),
+    S4 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), 0, S3),
+    S5 = emqx_persistent_session_ds_state:put_seqno(?committed(?QOS_1), 0, S4),
+    S6 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), 0, S5),
+    S7 = emqx_persistent_session_ds_state:put_seqno(?committed(?QOS_2), 0, S6),
+    S8 = emqx_persistent_session_ds_state:put_seqno(?pubrec, 0, S7),
+    S = emqx_persistent_session_ds_state:commit(S8),
+    #{
+        id => Id,
+        props => Conf,
+        s => S,
+        inflight => emqx_persistent_session_ds_inflight:new(receive_maximum(ConnInfo))
+    }.
 
 %% @doc Called when a client reconnects with `clean session=true' or
 %% during session GC
 -spec session_drop(id()) -> ok.
-session_drop(DSSessionId) ->
-    transaction(fun() ->
-        ok = session_drop_records(DSSessionId),
-        ok = mnesia:delete(?SESSION_TAB, DSSessionId, write)
-    end).
-
--spec session_drop_records(id()) -> ok.
-session_drop_records(DSSessionId) ->
-    ok = session_drop_subscriptions(DSSessionId),
-    ok = session_drop_pubranges(DSSessionId),
-    ok = session_drop_offsets(DSSessionId),
-    ok = session_drop_streams(DSSessionId).
-
--spec session_drop_subscriptions(id()) -> ok.
-session_drop_subscriptions(DSSessionId) ->
-    Subscriptions = session_read_subscriptions(DSSessionId, write),
-    lists:foreach(
-        fun(#ds_sub{id = DSSubId} = DSSub) ->
-            TopicFilter = subscription_id_to_topic_filter(DSSubId),
-            ok = emqx_persistent_session_ds_router:do_delete_route(TopicFilter, DSSessionId),
-            ok = session_del_subscription(DSSub)
-        end,
-        Subscriptions
-    ).
-
-%% @doc Called when a client subscribes to a topic. Idempotent.
--spec session_add_subscription(id(), topic_filter(), _Props :: map()) ->
-    {ok, subscription(), _IsNew :: boolean()}.
-session_add_subscription(DSSessionId, TopicFilter, Props) ->
-    DSSubId = {DSSessionId, TopicFilter},
-    transaction(fun() ->
-        case mnesia:read(?SESSION_SUBSCRIPTIONS_TAB, DSSubId, write) of
-            [] ->
-                DSSub = session_insert_subscription(DSSessionId, TopicFilter, Props),
-                DSSubExt = export_subscription(DSSub),
-                ?tp(
-                    ds_session_subscription_added,
-                    #{sub => DSSubExt, session_id => DSSessionId}
-                ),
-                {ok, DSSubExt, _IsNew = true};
-            [#ds_sub{} = DSSub] ->
-                NDSSub = session_update_subscription(DSSub, Props),
-                NDSSubExt = export_subscription(NDSSub),
-                ?tp(
-                    ds_session_subscription_present,
-                    #{sub => NDSSubExt, session_id => DSSessionId}
-                ),
-                {ok, NDSSubExt, _IsNew = false}
-        end
-    end).
-
--spec session_insert_subscription(id(), topic_filter(), map()) -> ds_sub().
-session_insert_subscription(DSSessionId, TopicFilter, Props) ->
-    {DSSubId, StartMS} = new_subscription_id(DSSessionId, TopicFilter),
-    DSSub = #ds_sub{
-        id = DSSubId,
-        start_time = StartMS,
-        props = Props,
-        extra = #{}
-    },
-    ok = mnesia:write(?SESSION_SUBSCRIPTIONS_TAB, DSSub, write),
-    DSSub.
-
--spec session_update_subscription(ds_sub(), map()) -> ds_sub().
-session_update_subscription(DSSub, Props) ->
-    NDSSub = DSSub#ds_sub{props = Props},
-    ok = mnesia:write(?SESSION_SUBSCRIPTIONS_TAB, NDSSub, write),
-    NDSSub.
-
-session_del_subscription(DSSessionId, TopicFilter) ->
-    DSSubId = {DSSessionId, TopicFilter},
-    transaction(fun() ->
-        mnesia:delete(?SESSION_SUBSCRIPTIONS_TAB, DSSubId, write)
-    end).
-
-session_del_subscription(#ds_sub{id = DSSubId}) ->
-    mnesia:delete(?SESSION_SUBSCRIPTIONS_TAB, DSSubId, write).
-
-session_read_subscriptions(DSSessionID) ->
-    session_read_subscriptions(DSSessionID, read).
-
-session_read_subscriptions(DSSessionId, LockKind) ->
-    MS = ets:fun2ms(
-        fun(Sub = #ds_sub{id = {Sess, _}}) when Sess =:= DSSessionId ->
-            Sub
-        end
-    ),
-    mnesia:select(?SESSION_SUBSCRIPTIONS_TAB, MS, LockKind).
-
-session_read_pubranges(DSSessionID) ->
-    session_read_pubranges(DSSessionID, read).
-
-session_read_pubranges(DSSessionId, LockKind) ->
-    MS = ets:fun2ms(
-        fun(#ds_pubrange{id = ID}) when element(1, ID) =:= DSSessionId ->
-            ID
-        end
-    ),
-    mnesia:select(?SESSION_PUBRANGE_TAB, MS, LockKind).
-
-session_read_offsets(DSSessionID) ->
-    session_read_offsets(DSSessionID, read).
-
-session_read_offsets(DSSessionId, LockKind) ->
-    MS = ets:fun2ms(
-        fun(#ds_committed_offset{id = {Sess, Type}}) when Sess =:= DSSessionId ->
-            {DSSessionId, Type}
-        end
-    ),
-    mnesia:select(?SESSION_COMMITTED_OFFSET_TAB, MS, LockKind).
-
--spec new_subscription_id(id(), topic_filter()) -> {subscription_id(), integer()}.
-new_subscription_id(DSSessionId, TopicFilter) ->
-    %% Note: here we use _milliseconds_ to match with the timestamp
-    %% field of `#message' record.
-    NowMS = now_ms(),
-    DSSubId = {DSSessionId, TopicFilter},
-    {DSSubId, NowMS}.
-
--spec subscription_id_to_topic_filter(subscription_id()) -> topic_filter().
-subscription_id_to_topic_filter({_DSSessionId, TopicFilter}) ->
-    TopicFilter.
+session_drop(ID) ->
+    emqx_persistent_session_ds_state:delete(ID).
 
 now_ms() ->
     erlang:system_time(millisecond).
@@ -845,124 +575,341 @@ do_ensure_all_iterators_closed(_DSSessionID) ->
     ok.
 
 %%--------------------------------------------------------------------
-%% Reading batches
+%% Buffer filling
 %%--------------------------------------------------------------------
 
--spec renew_streams(session()) -> ok.
-renew_streams(#{id := SessionId, subscriptions := Subscriptions}) ->
-    transaction(fun() ->
-        ExistingStreams = mnesia:read(?SESSION_STREAM_TAB, SessionId, write),
-        subs_fold(
-            fun(TopicFilter, #{start_time := StartTime}, Streams) ->
-                TopicFilterWords = emqx_topic:words(TopicFilter),
-                renew_topic_streams(SessionId, TopicFilterWords, StartTime, Streams)
-            end,
-            ExistingStreams,
-            Subscriptions
-        )
-    end),
-    ok.
+fill_buffer(Session = #{s := S}, ClientInfo) ->
+    fill_buffer(shuffle(find_new_streams(S)), Session, ClientInfo).
 
--spec renew_topic_streams(id(), topic_filter_words(), emqx_ds:time(), _Acc :: [ds_stream()]) -> ok.
-renew_topic_streams(DSSessionId, TopicFilter, StartTime, ExistingStreams) ->
-    TopicStreams = emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
-    lists:foldl(
-        fun({Rank, Stream}, Streams) ->
-            case lists:keymember(Stream, #ds_stream.stream, Streams) of
-                true ->
-                    Streams;
-                false ->
-                    StreamRef = length(Streams) + 1,
-                    DSStream = session_store_stream(
-                        DSSessionId,
-                        StreamRef,
-                        Stream,
-                        Rank,
-                        TopicFilter,
-                        StartTime
+-spec shuffle([A]) -> [A].
+shuffle(L0) ->
+    L1 = lists:map(
+        fun(A) ->
+            %% maybe topic/stream prioritization could be introduced here?
+            {rand:uniform(), A}
+        end,
+        L0
+    ),
+    L2 = lists:sort(L1),
+    {_, L} = lists:unzip(L2),
+    L.
+
+fill_buffer([], Session, _ClientInfo) ->
+    Session;
+fill_buffer(
+    [{StreamKey, Stream0 = #ifs{it_end = It0}} | Streams],
+    Session0 = #{s := S0, inflight := Inflight0},
+    ClientInfo
+) ->
+    BatchSize = emqx_config:get([session_persistence, max_batch_size]),
+    MaxBufferSize = BatchSize * 2,
+    case emqx_persistent_session_ds_inflight:n_buffered(Inflight0) < MaxBufferSize of
+        true ->
+            case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
+                {ok, It, []} ->
+                    S = emqx_persistent_session_ds_state:put_stream(
+                        StreamKey, Stream0#ifs{it_end = It}, S0
                     ),
-                    [DSStream | Streams]
+                    fill_buffer(Streams, Session0#{s := S}, ClientInfo);
+                {ok, It, Messages} ->
+                    Session = new_batch(StreamKey, Stream0, It, Messages, Session0, ClientInfo),
+                    fill_buffer(Streams, Session, ClientInfo);
+                {ok, end_of_stream} ->
+                    S = emqx_persistent_session_ds_state:put_stream(
+                        StreamKey, Stream0#ifs{it_end = end_of_stream}, S0
+                    ),
+                    fill_buffer(Streams, Session0#{s := S}, ClientInfo)
+            end;
+        false ->
+            Session0
+    end.
+
+new_batch(
+    StreamKey, Stream0, Iterator, [{BatchBeginMsgKey, _} | _] = Messages0, Session0, ClientInfo
+) ->
+    #{inflight := Inflight0, s := S0} = Session0,
+    FirstSeqnoQos1 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0),
+    FirstSeqnoQos2 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0),
+    NBefore = emqx_persistent_session_ds_inflight:n_buffered(Inflight0),
+    {LastSeqnoQos1, LastSeqnoQos2, Session} = do_process_batch(
+        false, FirstSeqnoQos1, FirstSeqnoQos2, Messages0, Session0, ClientInfo
+    ),
+    NAfter = emqx_persistent_session_ds_inflight:n_buffered(maps:get(inflight, Session)),
+    Stream = Stream0#ifs{
+        batch_size = NAfter - NBefore,
+        batch_begin_key = BatchBeginMsgKey,
+        first_seqno_qos1 = FirstSeqnoQos1,
+        first_seqno_qos2 = FirstSeqnoQos2,
+        last_seqno_qos1 = LastSeqnoQos1,
+        last_seqno_qos2 = LastSeqnoQos2,
+        it_end = Iterator
+    },
+    S1 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), LastSeqnoQos1, S0),
+    S2 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), LastSeqnoQos2, S1),
+    S = emqx_persistent_session_ds_state:put_stream(StreamKey, Stream, S2),
+    Session#{s => S}.
+
+replay_batch(_StreamKey, Stream, Session0, ClientInfo) ->
+    #ifs{
+        batch_begin_key = BatchBeginMsgKey,
+        batch_size = BatchSize,
+        first_seqno_qos1 = FirstSeqnoQos1,
+        first_seqno_qos2 = FirstSeqnoQos2,
+        it_end = ItEnd
+    } = Stream,
+    {ok, ItBegin} = emqx_ds:update_iterator(?PERSISTENT_MESSAGE_DB, ItEnd, BatchBeginMsgKey),
+    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, ItBegin, BatchSize) of
+        {ok, _ItEnd, Messages} ->
+            {_LastSeqnoQo1, _LastSeqnoQos2, Session} = do_process_batch(
+                true, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Session0, ClientInfo
+            ),
+            %% TODO: check consistency of the sequence numbers
+            Session
+    end.
+
+do_process_batch(_IsReplay, LastSeqnoQos1, LastSeqnoQos2, [], Session, _ClientInfo) ->
+    {LastSeqnoQos1, LastSeqnoQos2, Session};
+do_process_batch(IsReplay, FirstSeqnoQos1, FirstSeqnoQos2, [KV | Messages], Session, ClientInfo) ->
+    #{s := S, props := #{upgrade_qos := UpgradeQoS}, inflight := Inflight0} = Session,
+    {_DsMsgKey, Msg0 = #message{topic = Topic}} = KV,
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
+    Msgs = [
+        Msg
+     || SubMatch <- emqx_topic_gbt:matches(Topic, Subs, []),
+        Msg <- begin
+            #{props := SubOpts} = emqx_topic_gbt:get_record(SubMatch, Subs),
+            emqx_session:enrich_message(ClientInfo, Msg0, SubOpts, UpgradeQoS)
+        end
+    ],
+    CommittedQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    CommittedQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    {Inflight, LastSeqnoQos1, LastSeqnoQos2} = lists:foldl(
+        fun(Msg = #message{qos = Qos}, {Inflight1, SeqnoQos10, SeqnoQos20}) ->
+            case Qos of
+                ?QOS_0 ->
+                    SeqnoQos1 = SeqnoQos10,
+                    SeqnoQos2 = SeqnoQos20,
+                    PacketId = undefined;
+                ?QOS_1 ->
+                    SeqnoQos1 = inc_seqno(?QOS_1, SeqnoQos10),
+                    SeqnoQos2 = SeqnoQos20,
+                    PacketId = seqno_to_packet_id(?QOS_1, SeqnoQos1);
+                ?QOS_2 ->
+                    SeqnoQos1 = SeqnoQos10,
+                    SeqnoQos2 = inc_seqno(?QOS_2, SeqnoQos20),
+                    PacketId = seqno_to_packet_id(?QOS_2, SeqnoQos2)
+            end,
+            %% ?SLOG(debug, #{
+            %%     msg => "out packet",
+            %%     qos => Qos,
+            %%     packet_id => PacketId,
+            %%     enriched => emqx_message:to_map(Msg),
+            %%     original => emqx_message:to_map(Msg0),
+            %%     upgrade_qos => UpgradeQoS
+            %% }),
+
+            %% Handle various situations where we want to ignore the packet:
+            Inflight2 =
+                case IsReplay of
+                    true when Qos =:= ?QOS_0 ->
+                        Inflight1;
+                    true when Qos =:= ?QOS_1, SeqnoQos1 < CommittedQos1 ->
+                        Inflight1;
+                    true when Qos =:= ?QOS_2, SeqnoQos2 < CommittedQos2 ->
+                        Inflight1;
+                    _ ->
+                        emqx_persistent_session_ds_inflight:push({PacketId, Msg}, Inflight1)
+                end,
+            {
+                Inflight2,
+                SeqnoQos1,
+                SeqnoQos2
+            }
+        end,
+        {Inflight0, FirstSeqnoQos1, FirstSeqnoQos2},
+        Msgs
+    ),
+    do_process_batch(
+        IsReplay, LastSeqnoQos1, LastSeqnoQos2, Messages, Session#{inflight => Inflight}, ClientInfo
+    ).
+
+%%--------------------------------------------------------------------
+%% Buffer drain
+%%--------------------------------------------------------------------
+
+drain_buffer(Session = #{inflight := Inflight0}) ->
+    {Messages, Inflight} = emqx_persistent_session_ds_inflight:pop(Inflight0),
+    {Messages, Session#{inflight => Inflight}}.
+
+%%--------------------------------------------------------------------
+%% Stream renew
+%%--------------------------------------------------------------------
+
+%% erlfmt-ignore
+-define(fully_replayed(STREAM, COMMITTEDQOS1, COMMITTEDQOS2),
+    ((STREAM#ifs.last_seqno_qos1 =< COMMITTEDQOS1 orelse STREAM#ifs.last_seqno_qos1 =:= undefined) andalso
+     (STREAM#ifs.last_seqno_qos2 =< COMMITTEDQOS2 orelse STREAM#ifs.last_seqno_qos2 =:= undefined))).
+
+-spec find_replay_streams(session()) ->
+    [{emqx_persistent_session_ds_state:stream_key(), stream_state()}].
+find_replay_streams(#{s := S}) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    Streams = emqx_persistent_session_ds_state:fold_streams(
+        fun(Key, Stream, Acc) ->
+            case Stream of
+                #ifs{
+                    first_seqno_qos1 = F1,
+                    first_seqno_qos2 = F2,
+                    last_seqno_qos1 = L1,
+                    last_seqno_qos2 = L2
+                } when F1 >= CommQos1, L1 =< CommQos1, F2 >= CommQos2, L2 =< CommQos2 ->
+                    [{Key, Stream} | Acc];
+                _ ->
+                    Acc
             end
         end,
-        ExistingStreams,
-        TopicStreams
-    ).
-
-session_store_stream(DSSessionId, StreamRef, Stream, Rank, TopicFilter, StartTime) ->
-    {ok, ItBegin} = emqx_ds:make_iterator(
-        ?PERSISTENT_MESSAGE_DB,
-        Stream,
-        TopicFilter,
-        StartTime
+        [],
+        S
     ),
-    DSStream = #ds_stream{
-        session = DSSessionId,
-        ref = StreamRef,
-        stream = Stream,
-        rank = Rank,
-        beginning = ItBegin
-    },
-    mnesia:write(?SESSION_STREAM_TAB, DSStream, write),
-    DSStream.
-
-%% must be called inside a transaction
--spec session_drop_streams(id()) -> ok.
-session_drop_streams(DSSessionId) ->
-    mnesia:delete(?SESSION_STREAM_TAB, DSSessionId, write).
-
-%% must be called inside a transaction
--spec session_drop_pubranges(id()) -> ok.
-session_drop_pubranges(DSSessionId) ->
-    RangeIds = session_read_pubranges(DSSessionId, write),
-    lists:foreach(
-        fun(RangeId) ->
-            mnesia:delete(?SESSION_PUBRANGE_TAB, RangeId, write)
+    lists:sort(
+        fun(
+            #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2},
+            #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}
+        ) ->
+            case A1 =:= A2 of
+                true -> B1 =< B2;
+                false -> A1 < A2
+            end
         end,
-        RangeIds
+        Streams
     ).
 
-%% must be called inside a transaction
--spec session_drop_offsets(id()) -> ok.
-session_drop_offsets(DSSessionId) ->
-    OffsetIds = session_read_offsets(DSSessionId, write),
-    lists:foreach(
-        fun(OffsetId) ->
-            mnesia:delete(?SESSION_COMMITTED_OFFSET_TAB, OffsetId, write)
+-spec find_new_streams(emqx_persistent_session_ds_state:t()) ->
+    [{emqx_persistent_session_ds_state:stream_key(), stream_state()}].
+find_new_streams(S) ->
+    %% FIXME: this function is currently very sensitive to the
+    %% consistency of the packet IDs on both broker and client side.
+    %%
+    %% If the client fails to properly ack packets due to a bug, or a
+    %% network issue, or if the state of streams and seqno tables ever
+    %% become de-synced, then this function will return an empty list,
+    %% and the replay cannot progress.
+    %%
+    %% In other words, this function is not robust, and we should find
+    %% some way to get the replays un-stuck at the cost of potentially
+    %% losing messages during replay (or just kill the stuck channel
+    %% after timeout?)
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    emqx_persistent_session_ds_state:fold_streams(
+        fun
+            (Key, Stream, Acc) when ?fully_replayed(Stream, CommQos1, CommQos2) ->
+                %% This stream has been full acked by the client. It
+                %% means we can get more messages from it:
+                [{Key, Stream} | Acc];
+            (_Key, _Stream, Acc) ->
+                Acc
         end,
-        OffsetIds
+        [],
+        S
+    ).
+
+-spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
+renew_streams(S0) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
+    subs_fold(
+        fun(TopicFilterBin, _Subscription = #{start_time := StartTime}, S1) ->
+            SubId = [],
+            TopicFilter = emqx_topic:words(TopicFilterBin),
+            TopicStreams = emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
+            TopicStreamGroups = maps:groups_from_list(fun({{X, _}, _}) -> X end, TopicStreams),
+            %% Iterate over groups of streams with the same rank X,
+            %% finding the first eligible stream to replay:
+            maps:fold(
+                fun(RankX, Streams, S2) ->
+                    Key = {RankX, SubId},
+                    case emqx_persistent_session_ds_state:get_stream(Key, S2) of
+                        undefined ->
+                            MinRankY = emqx_persistent_session_ds_state:get_rank(RankX, S2),
+                            start_stream_replay(
+                                TopicFilter, StartTime, Key, MinRankY, Streams, S2
+                            );
+                        Stream = #ifs{it_end = end_of_stream, rank_y = MinRankY} when
+                            ?fully_replayed(Stream, CommQos1, CommQos2)
+                        ->
+                            %% We have fully replayed the stream with
+                            %% the given rank X, and the client acked
+                            %% all messages:
+                            S3 = emqx_persistent_session_ds_state:del_stream(Key, S2),
+                            S4 = emqx_persistent_session_ds_state:put_rank(RankX, MinRankY, S3),
+                            start_stream_replay(TopicFilter, StartTime, Key, MinRankY, Streams, S4);
+                        #ifs{} ->
+                            %% Stream replay is currently in progress, leave it as is:
+                            S2
+                    end
+                end,
+                S1,
+                TopicStreamGroups
+            )
+        end,
+        S0,
+        S0
+    ).
+
+start_stream_replay(TopicFilter, StartTime, Key, MinRankY, Streams, S0) ->
+    case find_first_stream(MinRankY, Streams) of
+        {RankY, Stream} ->
+            {ok, Iterator} = emqx_ds:make_iterator(
+                ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
+            ),
+            NewStreamState = #ifs{
+                rank_y = RankY,
+                it_end = Iterator
+            },
+            emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S0);
+        undefined ->
+            S0
+    end.
+
+%% @doc Find the first stream with rank Y greater than the one given as the first argument.
+-spec find_first_stream(emqx_ds:rank_y() | undefined, [
+    {emqx_ds:stream_rank(), emqx_ds:ds_specific_stream()}
+]) ->
+    {emqx_ds:rank_y(), emqx_ds:ds_specific_stream()} | undefined.
+find_first_stream(MinRankY, Streams) ->
+    lists:foldl(
+        fun
+            ({{_RankX, RankY}, Stream}, Acc) when RankY > MinRankY; MinRankY =:= undefined ->
+                case Acc of
+                    {AccY, _} when AccY < RankY ->
+                        Acc;
+                    _ ->
+                        {RankY, Stream}
+                end;
+            (_, Acc) ->
+                Acc
+        end,
+        undefined,
+        Streams
     ).
 
 %%--------------------------------------------------------------------------------
 
-subs_new() ->
-    emqx_topic_gbt:new().
-
-subs_lookup(TopicFilter, Subs) ->
+subs_lookup(TopicFilter, S) ->
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
     emqx_topic_gbt:lookup(TopicFilter, [], Subs, undefined).
 
-subs_insert(TopicFilter, Subscription, Subs) ->
-    emqx_topic_gbt:insert(TopicFilter, [], Subscription, Subs).
-
-subs_delete(TopicFilter, Subs) ->
-    emqx_topic_gbt:delete(TopicFilter, [], Subs).
-
-subs_matches(Topic, Subs) ->
-    emqx_topic_gbt:matches(Topic, Subs, []).
-
-subs_get_match(M, Subs) ->
-    emqx_topic_gbt:get_record(M, Subs).
-
-subs_size(Subs) ->
-    emqx_topic_gbt:size(Subs).
-
-subs_to_map(Subs) ->
+subs_to_map(S) ->
     subs_fold(
         fun(TopicFilter, #{props := Props}, Acc) -> Acc#{TopicFilter => Props} end,
         #{},
-        Subs
+        S
     ).
 
-subs_fold(Fun, AccIn, Subs) ->
+subs_fold(Fun, AccIn, S) ->
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
     emqx_topic_gbt:fold(
         fun(Key, Sub, Acc) -> Fun(emqx_topic_gbt:get_topic(Key), Sub, Acc) end,
         AccIn,
@@ -971,41 +918,6 @@ subs_fold(Fun, AccIn, Subs) ->
 
 %%--------------------------------------------------------------------------------
 
-transaction(Fun) ->
-    case mnesia:is_transaction() of
-        true ->
-            Fun();
-        false ->
-            {atomic, Res} = mria:transaction(?DS_MRIA_SHARD, Fun),
-            Res
-    end.
-
-ro_transaction(Fun) ->
-    {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
-    Res.
-
-%%--------------------------------------------------------------------------------
-
-export_subscriptions(DSSubs) ->
-    lists:foldl(
-        fun(DSSub = #ds_sub{id = {_DSSessionId, TopicFilter}}, Acc) ->
-            subs_insert(TopicFilter, export_subscription(DSSub), Acc)
-        end,
-        subs_new(),
-        DSSubs
-    ).
-
-export_session(#session{} = Record) ->
-    export_record(Record, #session.id, [id, created_at, last_alive_at, conninfo, props], #{}).
-
-export_subscription(#ds_sub{} = Record) ->
-    export_record(Record, #ds_sub.start_time, [start_time, props, extra], #{}).
-
-export_record(Record, I, [Field | Rest], Acc) ->
-    export_record(Record, I + 1, Rest, Acc#{Field => element(I, Record)});
-export_record(_, _, [], Acc) ->
-    Acc.
-
 %% TODO: find a more reliable way to perform actions that have side
 %% effects. Add `CBM:init' callback to the session behavior?
 -spec ensure_timers(session()) -> session().
@@ -1014,6 +926,11 @@ ensure_timers(Session0) ->
     Session2 = emqx_session:ensure_timer(?TIMER_GET_STREAMS, 100, Session1),
     emqx_session:ensure_timer(?TIMER_BUMP_LAST_ALIVE_AT, 100, Session2).
 
+-spec inc_send_quota(session()) -> session().
+inc_send_quota(Session = #{inflight := Inflight0}) ->
+    {_NInflight, Inflight} = emqx_persistent_session_ds_inflight:inc_send_quota(Inflight0),
+    pull_now(Session#{inflight => Inflight}).
+
 -spec pull_now(session()) -> session().
 pull_now(Session) ->
     emqx_session:reset_timer(?TIMER_PULL, 0, Session).
@@ -1029,75 +946,119 @@ receive_maximum(ConnInfo) ->
 expiry_interval(ConnInfo) ->
     maps:get(expiry_interval, ConnInfo, 0).
 
+bump_interval() ->
+    emqx_config:get([session_persistence, last_alive_update_interval]).
+
+%%--------------------------------------------------------------------
+%% SeqNo tracking
+%% --------------------------------------------------------------------
+
+-spec commit_seqno(puback | pubrec | pubcomp, emqx_types:packet_id(), session()) ->
+    {ok, emqx_types:message(), session()} | {error, _}.
+commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
+    SeqNo = packet_id_to_seqno(PacketId, S),
+    case Track of
+        puback ->
+            Old = ?committed(?QOS_1),
+            Next = ?next(?QOS_1);
+        pubrec ->
+            Old = ?pubrec,
+            Next = ?next(?QOS_2);
+        pubcomp ->
+            Old = ?committed(?QOS_2),
+            Next = ?next(?QOS_2)
+    end,
+    NextSeqNo = emqx_persistent_session_ds_state:get_seqno(Next, S),
+    PrevSeqNo = emqx_persistent_session_ds_state:get_seqno(Old, S),
+    case PrevSeqNo =< SeqNo andalso SeqNo =< NextSeqNo of
+        true ->
+            %% TODO: we pass a bogus message into the hook:
+            Msg = emqx_message:make(SessionId, <<>>, <<>>),
+            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(Old, SeqNo, S)}};
+        false ->
+            ?SLOG(warning, #{
+                msg => "out-of-order_commit",
+                track => Track,
+                packet_id => PacketId,
+                commit_seqno => SeqNo,
+                prev => PrevSeqNo,
+                next => NextSeqNo
+            }),
+            {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
+    end.
+
+%%--------------------------------------------------------------------
+%% Functions for dealing with the sequence number and packet ID
+%% generation
+%% --------------------------------------------------------------------
+
+%% Epoch size = `16#10000 div 2' since we generate different sets of
+%% packet IDs for QoS1 and QoS2:
+-define(EPOCH_SIZE, 16#8000).
+
+%% Reconstruct session counter by adding most significant bits from
+%% the current counter to the packet id:
+-spec packet_id_to_seqno(emqx_types:packet_id(), emqx_persistent_session_ds_state:t()) ->
+    seqno().
+packet_id_to_seqno(PacketId, S) ->
+    NextSeqNo = emqx_persistent_session_ds_state:get_seqno(?next(packet_id_to_qos(PacketId)), S),
+    packet_id_to_seqno_(PacketId, NextSeqNo).
+
+packet_id_to_seqno_(PacketId, NextSeqNo) ->
+    Epoch = NextSeqNo bsr 15,
+    SeqNo = (Epoch bsl 15) + (PacketId bsr 1),
+    case SeqNo =< NextSeqNo of
+        true ->
+            SeqNo;
+        false ->
+            SeqNo - ?EPOCH_SIZE
+    end.
+
+-spec inc_seqno(?QOS_1 | ?QOS_2, seqno()) -> emqx_types:packet_id().
+inc_seqno(Qos, SeqNo) ->
+    NextSeqno = SeqNo + 1,
+    case seqno_to_packet_id(Qos, NextSeqno) of
+        0 ->
+            %% We skip sequence numbers that lead to PacketId = 0 to
+            %% simplify math. Note: it leads to occasional gaps in the
+            %% sequence numbers.
+            NextSeqno + 1;
+        _ ->
+            NextSeqno
+    end.
+
+%% Note: we use the least significant bit to store the QoS. Even
+%% packet IDs are QoS1, odd packet IDs are QoS2.
+seqno_to_packet_id(?QOS_1, SeqNo) ->
+    (SeqNo bsl 1) band 16#ffff;
+seqno_to_packet_id(?QOS_2, SeqNo) ->
+    ((SeqNo bsl 1) band 16#ffff) bor 1.
+
+packet_id_to_qos(PacketId) ->
+    case PacketId band 1 of
+        0 -> ?QOS_1;
+        1 -> ?QOS_2
+    end.
+
+%%--------------------------------------------------------------------
+%% Tests
+%%--------------------------------------------------------------------
+
 -ifdef(TEST).
+
+%% Warning: the below functions may return out-of-date results because
+%% the sessions commit data to mria asynchronously.
+
 list_all_sessions() ->
-    DSSessionIds = mnesia:dirty_all_keys(?SESSION_TAB),
-    ConnInfo = #{},
-    Sessions = lists:filtermap(
-        fun(SessionID) ->
-            Sess = session_open(SessionID, ConnInfo),
-            case Sess of
-                false ->
-                    false;
-                _ ->
-                    {true, {SessionID, Sess}}
-            end
-        end,
-        DSSessionIds
-    ),
-    maps:from_list(Sessions).
-
-list_all_subscriptions() ->
-    DSSubIds = mnesia:dirty_all_keys(?SESSION_SUBSCRIPTIONS_TAB),
-    Subscriptions = lists:map(
-        fun(DSSubId) ->
-            [DSSub] = mnesia:dirty_read(?SESSION_SUBSCRIPTIONS_TAB, DSSubId),
-            {DSSubId, export_subscription(DSSub)}
-        end,
-        DSSubIds
-    ),
-    maps:from_list(Subscriptions).
-
-list_all_streams() ->
-    DSStreamIds = mnesia:dirty_all_keys(?SESSION_STREAM_TAB),
-    DSStreams = lists:map(
-        fun(DSStreamId) ->
-            Records = mnesia:dirty_read(?SESSION_STREAM_TAB, DSStreamId),
-            ExtDSStreams =
-                lists:map(
-                    fun(Record) ->
-                        export_record(
-                            Record,
-                            #ds_stream.session,
-                            [session, topic_filter, stream, rank],
-                            #{}
-                        )
-                    end,
-                    Records
-                ),
-            {DSStreamId, ExtDSStreams}
-        end,
-        DSStreamIds
-    ),
-    maps:from_list(DSStreams).
-
-list_all_pubranges() ->
-    DSPubranges = mnesia:dirty_match_object(?SESSION_PUBRANGE_TAB, #ds_pubrange{_ = '_'}),
-    lists:foldl(
-        fun(Record = #ds_pubrange{id = {SessionId, First, StreamRef}}, Acc) ->
-            Range = #{
-                session => SessionId,
-                stream => StreamRef,
-                first => First,
-                until => Record#ds_pubrange.until,
-                type => Record#ds_pubrange.type,
-                iterator => Record#ds_pubrange.iterator
-            },
-            maps:put(SessionId, maps:get(SessionId, Acc, []) ++ [Range], Acc)
-        end,
-        #{},
-        DSPubranges
+    maps:from_list(
+        [
+            {Id, emqx_persistent_session_ds_state:print_session(Id)}
+         || Id <- emqx_persistent_session_ds_state:list_sessions()
+        ]
     ).
 
-%% ifdef(TEST)
+%%%% Proper generators:
+
+%%%% Unit tests:
+
 -endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 31c9b2faf..936b36841 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -25,66 +25,27 @@
 -define(SESSION_COMMITTED_OFFSET_TAB, emqx_ds_committed_offset_tab).
 -define(DS_MRIA_SHARD, emqx_ds_session_shard).
 
--define(T_INFLIGHT, 1).
--define(T_CHECKPOINT, 2).
-
--record(ds_sub, {
-    id :: emqx_persistent_session_ds:subscription_id(),
-    start_time :: emqx_ds:time(),
-    props = #{} :: map(),
-    extra = #{} :: map()
-}).
--type ds_sub() :: #ds_sub{}.
-
--record(ds_stream, {
-    session :: emqx_persistent_session_ds:id(),
-    ref :: _StreamRef,
-    stream :: emqx_ds:stream(),
-    rank :: emqx_ds:stream_rank(),
-    beginning :: emqx_ds:iterator()
-}).
--type ds_stream() :: #ds_stream{}.
-
--record(ds_pubrange, {
-    id :: {
-        %% What session this range belongs to.
-        _Session :: emqx_persistent_session_ds:id(),
-        %% Where this range starts.
-        _First :: emqx_persistent_message_ds_replayer:seqno(),
-        %% Which stream this range is over.
-        _StreamRef
-    },
-    %% Where this range ends: the first seqno that is not included in the range.
-    until :: emqx_persistent_message_ds_replayer:seqno(),
-    %% Type of a range:
-    %% * Inflight range is a range of yet unacked messages from this stream.
-    %% * Checkpoint range was already acked, its purpose is to keep track of the
-    %%   very last iterator for this stream.
-    type :: ?T_INFLIGHT | ?T_CHECKPOINT,
-    %% What commit tracks this range is part of.
-    tracks = 0 :: non_neg_integer(),
-    %% Meaning of this depends on the type of the range:
-    %% * For inflight range, this is the iterator pointing to the first message in
-    %%   the range.
-    %% * For checkpoint range, this is the iterator pointing right past the last
-    %%   message in the range.
-    iterator :: emqx_ds:iterator(),
-    %% Reserved for future use.
-    misc = #{} :: map()
-}).
--type ds_pubrange() :: #ds_pubrange{}.
-
--record(ds_committed_offset, {
-    id :: {
-        %% What session this marker belongs to.
-        _Session :: emqx_persistent_session_ds:id(),
-        %% Marker name.
-        _CommitType
-    },
-    %% Where this marker is pointing to: the first seqno that is not marked.
-    until :: emqx_persistent_message_ds_replayer:seqno()
+%% State of the stream:
+-record(ifs, {
+    rank_y :: emqx_ds:rank_y(),
+    %% Iterator at the end of the last batch:
+    it_end :: emqx_ds:iterator() | undefined | end_of_stream,
+    %% Size of the last batch:
+    batch_size :: pos_integer() | undefined,
+    %% Key that points at the beginning of the batch:
+    batch_begin_key :: binary() | undefined,
+    %% Number of messages collected in the last batch:
+    batch_n_messages :: pos_integer() | undefined,
+    %% Session sequence number at the time when the batch was fetched:
+    first_seqno_qos1 :: emqx_persistent_session_ds:seqno() | undefined,
+    first_seqno_qos2 :: emqx_persistent_session_ds:seqno() | undefined,
+    %% Sequence numbers that the client must PUBACK or PUBREL
+    %% before we can consider the batch to be fully replayed:
+    last_seqno_qos1 :: emqx_persistent_session_ds:seqno() | undefined,
+    last_seqno_qos2 :: emqx_persistent_session_ds:seqno() | undefined
 }).
 
+%% TODO: remove
 -record(session, {
     %% same as clientid
     id :: emqx_persistent_session_ds:id(),
diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
new file mode 100644
index 000000000..75f246ec3
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -0,0 +1,111 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_persistent_session_ds_inflight).
+
+%% API:
+-export([new/1, push/2, pop/1, n_buffered/1, n_inflight/1, inc_send_quota/1, receive_maximum/1]).
+
+%% behavior callbacks:
+-export([]).
+
+%% internal exports:
+-export([]).
+
+-export_type([t/0]).
+
+-include("emqx.hrl").
+-include("emqx_mqtt.hrl").
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+-record(inflight, {
+    queue :: queue:queue(),
+    receive_maximum :: pos_integer(),
+    n_inflight = 0 :: non_neg_integer(),
+    n_qos0 = 0 :: non_neg_integer(),
+    n_qos1 = 0 :: non_neg_integer(),
+    n_qos2 = 0 :: non_neg_integer()
+}).
+
+-type t() :: #inflight{}.
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec new(non_neg_integer()) -> t().
+new(ReceiveMaximum) when ReceiveMaximum > 0 ->
+    #inflight{queue = queue:new(), receive_maximum = ReceiveMaximum}.
+
+-spec receive_maximum(t()) -> pos_integer().
+receive_maximum(#inflight{receive_maximum = ReceiveMaximum}) ->
+    ReceiveMaximum.
+
+-spec push({emqx_types:packet_id() | undefined, emqx_types:message()}, t()) -> t().
+push(Val = {_PacketId, Msg}, Rec) ->
+    #inflight{queue = Q0, n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2} = Rec,
+    Q = queue:in(Val, Q0),
+    case Msg#message.qos of
+        ?QOS_0 ->
+            Rec#inflight{queue = Q, n_qos0 = NQos0 + 1};
+        ?QOS_1 ->
+            Rec#inflight{queue = Q, n_qos1 = NQos1 + 1};
+        ?QOS_2 ->
+            Rec#inflight{queue = Q, n_qos2 = NQos2 + 1}
+    end.
+
+-spec pop(t()) -> {[{emqx_types:packet_id() | undefined, emqx_types:message()}], t()}.
+pop(Inflight = #inflight{receive_maximum = ReceiveMaximum}) ->
+    do_pop(ReceiveMaximum, Inflight, []).
+
+-spec n_buffered(t()) -> non_neg_integer().
+n_buffered(#inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2}) ->
+    NQos0 + NQos1 + NQos2.
+
+-spec n_inflight(t()) -> non_neg_integer().
+n_inflight(#inflight{n_inflight = NInflight}) ->
+    NInflight.
+
+%% https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Flow_Control
+-spec inc_send_quota(t()) -> {non_neg_integer(), t()}.
+inc_send_quota(Rec = #inflight{n_inflight = NInflight0}) ->
+    NInflight = max(NInflight0 - 1, 0),
+    {NInflight, Rec#inflight{n_inflight = NInflight}}.
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+do_pop(ReceiveMaximum, Rec0 = #inflight{n_inflight = NInflight, queue = Q0}, Acc) ->
+    case NInflight < ReceiveMaximum andalso queue:out(Q0) of
+        {{value, Val}, Q} ->
+            #inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2} = Rec0,
+            {_PacketId, #message{qos = Qos}} = Val,
+            Rec =
+                case Qos of
+                    ?QOS_0 ->
+                        Rec0#inflight{queue = Q, n_qos0 = NQos0 - 1};
+                    ?QOS_1 ->
+                        Rec0#inflight{queue = Q, n_qos1 = NQos1 - 1, n_inflight = NInflight + 1};
+                    ?QOS_2 ->
+                        Rec0#inflight{queue = Q, n_qos2 = NQos2 - 1, n_inflight = NInflight + 1}
+                end,
+            do_pop(ReceiveMaximum, Rec, [Val | Acc]);
+        _ ->
+            {lists:reverse(Acc), Rec0}
+    end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 5fd2c2ac9..39fd7eeb7 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@
 
 -export([create_tables/0]).
 
--export([open/1, create_new/1, delete/1, commit/1, print_session/1]).
+-export([open/1, create_new/1, delete/1, commit/1, print_session/1, list_sessions/0]).
 -export([get_created_at/1, set_created_at/2]).
 -export([get_last_alive_at/1, set_last_alive_at/2]).
 -export([get_conninfo/1, set_conninfo/2]).
@@ -38,7 +38,7 @@
 %% internal exports:
 -export([]).
 
--export_type([t/0, seqno_type/0]).
+-export_type([t/0, subscriptions/0, seqno_type/0, stream_key/0]).
 
 -include("emqx_persistent_session_ds.hrl").
 
@@ -46,12 +46,11 @@
 %% Type declarations
 %%================================================================================
 
+-type subscriptions() :: emqx_topic_gbt:t(_SubId, emqx_persistent_session_ds:subscription()).
+
 %% Generic key-value wrapper that is used for exporting arbitrary
 %% terms to mnesia:
--record(kv, {
-    k :: term(),
-    v :: map()
-}).
+-record(kv, {k, v}).
 
 %% Persistent map.
 %%
@@ -62,9 +61,9 @@
 %% It should be possible to make frequent changes to the pmap without
 %% stressing Mria.
 %%
-%% It's implemented as two maps: `clean' and `dirty'. Updates are made
-%% to the `dirty' area. `pmap_commit' function saves the updated
-%% entries to Mnesia and moves them to the `clean' area.
+%% It's implemented as three maps: `clean', `dirty' and `tombstones'.
+%% Updates are made to the `dirty' area. `pmap_commit' function saves
+%% the updated entries to Mnesia and moves them to the `clean' area.
 -record(pmap, {table, clean, dirty, tombstones}).
 
 -type pmap(K, V) ::
@@ -87,15 +86,17 @@
         ?conninfo => emqx_types:conninfo()
     }.
 
--type seqno_type() :: next | acked | pubrel.
+-type seqno_type() :: term().
+
+-type stream_key() :: {emqx_ds:rank_x(), _SubId}.
 
 -opaque t() :: #{
     id := emqx_persistent_session_ds:id(),
     dirty := boolean(),
     metadata := metadata(),
-    subscriptions := emqx_persistent_session_ds:subscriptions(),
+    subscriptions := subscriptions(),
     seqnos := pmap(seqno_type(), emqx_persistent_session_ds:seqno()),
-    streams := pmap(emqx_ds:stream(), emqx_persistent_message_ds_replayer:stream_state()),
+    streams := pmap(emqx_ds:stream(), emqx_persistent_session_ds:stream_state()),
     ranks := pmap(term(), integer())
 }.
 
@@ -104,7 +105,7 @@
 -define(stream_tab, emqx_ds_session_streams).
 -define(seqno_tab, emqx_ds_session_seqnos).
 -define(rank_tab, emqx_ds_session_ranks).
--define(bag_tables, [?stream_tab, ?seqno_tab, ?rank_tab]).
+-define(bag_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
 
 %%================================================================================
 %% API funcions
@@ -125,7 +126,7 @@ create_tables() ->
     [create_kv_bag_table(Table) || Table <- ?bag_tables],
     mria:wait_for_tables([?session_tab | ?bag_tables]).
 
--spec open(emqx_persistent_session_ds:session_id()) -> {ok, t()} | undefined.
+-spec open(emqx_persistent_session_ds:id()) -> {ok, t()} | undefined.
 open(SessionId) ->
     ro_transaction(fun() ->
         case kv_restore(?session_tab, SessionId) of
@@ -150,13 +151,13 @@ print_session(SessionId) ->
     case open(SessionId) of
         undefined ->
             undefined;
-        #{
+        {ok, #{
             metadata := Metadata,
             subscriptions := SubsGBT,
             streams := Streams,
             seqnos := Seqnos,
             ranks := Ranks
-        } ->
+        }} ->
             Subs = emqx_topic_gbt:fold(
                 fun(Key, Sub, Acc) -> maps:put(Key, Sub, Acc) end,
                 #{},
@@ -171,6 +172,10 @@ print_session(SessionId) ->
             }
     end.
 
+-spec list_sessions() -> [emqx_persistent_session_ds:id()].
+list_sessions() ->
+    mnesia:dirty_all_keys(?session_tab).
+
 -spec delete(emqx_persistent_session_ds:id()) -> ok.
 delete(Id) ->
     transaction(
@@ -187,7 +192,6 @@ commit(
     Rec = #{
         id := SessionId,
         metadata := Metadata,
-        subscriptions := Subs,
         streams := Streams,
         seqnos := SeqNos,
         ranks := Ranks
@@ -196,10 +200,9 @@ commit(
     transaction(fun() ->
         kv_persist(?session_tab, SessionId, Metadata),
         Rec#{
-            subscriptions => pmap_commit(SessionId, Subs),
             streams => pmap_commit(SessionId, Streams),
             seqnos => pmap_commit(SessionId, SeqNos),
-            ranksz => pmap_commit(SessionId, Ranks),
+            ranks => pmap_commit(SessionId, Ranks),
             dirty => false
         }
     end).
@@ -247,18 +250,16 @@ set_conninfo(Val, Rec) ->
 
 %%
 
--spec get_stream(emqx_persistent_session_ds:stream(), t()) ->
-    emqx_persistent_message_ds_replayer:stream_state() | undefined.
+-spec get_stream(stream_key(), t()) ->
+    emqx_persistent_session_ds:stream_state() | undefined.
 get_stream(Key, Rec) ->
     gen_get(streams, Key, Rec).
 
--spec put_stream(
-    emqx_persistent_session_ds:stream(), emqx_persistent_message_ds_replayer:stream_state(), t()
-) -> t().
+-spec put_stream(stream_key(), emqx_persistent_session_ds:stream_state(), t()) -> t().
 put_stream(Key, Val, Rec) ->
     gen_put(streams, Key, Val, Rec).
 
--spec del_stream(emqx_persistent_session_ds:stream(), t()) -> t().
+-spec del_stream(stream_key(), t()) -> t().
 del_stream(Key, Rec) ->
     gen_del(stream, Key, Rec).
 
@@ -296,12 +297,12 @@ fold_ranks(Fun, Acc, Rec) ->
 
 %%
 
--spec get_subscriptions(t()) -> emqx_persistent_session_ds:subscriptions().
+-spec get_subscriptions(t()) -> subscriptions().
 get_subscriptions(#{subscriptions := Subs}) ->
     Subs.
 
 -spec put_subscription(
-    emqx_persistent_session_ds:subscription_id(),
+    emqx_persistent_session_ds:topic_filter(),
     _SubId,
     emqx_persistent_session_ds:subscription(),
     t()
@@ -474,7 +475,7 @@ kv_bag_persist(Tab, SessionId, Key, Val0) ->
     kv_bag_delete(Tab, SessionId, Key),
     %% Write data to mnesia:
     Val = encoder(encode, Tab, Val0),
-    mnesia:write(Tab, #kv{k = SessionId, v = {Key, Val}}).
+    mnesia:write(Tab, #kv{k = SessionId, v = {Key, Val}}, write).
 
 kv_bag_restore(Tab, SessionId) ->
     [{K, encoder(decode, Tab, V)} || #kv{v = {K, V}} <- mnesia:read(Tab, SessionId)].
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index 77340ca87..e26475855 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1810,7 +1810,7 @@ fields("session_persistence") ->
             sc(
                 pos_integer(),
                 #{
-                    default => 1000,
+                    default => 100,
                     desc => ?DESC(session_ds_max_batch_size)
                 }
             )},
diff --git a/apps/emqx/src/emqx_session.erl b/apps/emqx/src/emqx_session.erl
index c08109fe8..fa7441b11 100644
--- a/apps/emqx/src/emqx_session.erl
+++ b/apps/emqx/src/emqx_session.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2017-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2017-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -409,12 +409,8 @@ enrich_delivers(ClientInfo, Delivers, Session) ->
 enrich_delivers(_ClientInfo, [], _UpgradeQoS, _Session) ->
     [];
 enrich_delivers(ClientInfo, [D | Rest], UpgradeQoS, Session) ->
-    case enrich_deliver(ClientInfo, D, UpgradeQoS, Session) of
-        [] ->
-            enrich_delivers(ClientInfo, Rest, UpgradeQoS, Session);
-        Msg ->
-            [Msg | enrich_delivers(ClientInfo, Rest, UpgradeQoS, Session)]
-    end.
+    enrich_deliver(ClientInfo, D, UpgradeQoS, Session) ++
+        enrich_delivers(ClientInfo, Rest, UpgradeQoS, Session).
 
 enrich_deliver(ClientInfo, {deliver, Topic, Msg}, UpgradeQoS, Session) ->
     SubOpts =
@@ -435,13 +431,15 @@ enrich_message(
     _ = emqx_session_events:handle_event(ClientInfo, {dropped, Msg, no_local}),
     [];
 enrich_message(_ClientInfo, MsgIn, SubOpts = #{}, UpgradeQoS) ->
-    maps:fold(
-        fun(SubOpt, V, Msg) -> enrich_subopts(SubOpt, V, Msg, UpgradeQoS) end,
-        MsgIn,
-        SubOpts
-    );
+    [
+        maps:fold(
+            fun(SubOpt, V, Msg) -> enrich_subopts(SubOpt, V, Msg, UpgradeQoS) end,
+            MsgIn,
+            SubOpts
+        )
+    ];
 enrich_message(_ClientInfo, Msg, undefined, _UpgradeQoS) ->
-    Msg.
+    [Msg].
 
 enrich_subopts(nl, 1, Msg, _) ->
     emqx_message:set_flag(nl, Msg);
diff --git a/apps/emqx/src/emqx_topic_gbt.erl b/apps/emqx/src/emqx_topic_gbt.erl
index 6e9e7d2fc..b399903f4 100644
--- a/apps/emqx/src/emqx_topic_gbt.erl
+++ b/apps/emqx/src/emqx_topic_gbt.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -39,11 +39,11 @@
 -type match(ID) :: key(ID).
 
 -opaque t(ID, Value) :: gb_trees:tree(key(ID), Value).
--opaque t() :: t(_ID, _Value).
+-type t() :: t(_ID, _Value).
 
 %% @doc Create a new gb_tree and store it in the persitent_term with the
 %% given name.
--spec new() -> t().
+-spec new() -> t(_ID, _Value).
 new() ->
     gb_trees:empty().
 
@@ -54,19 +54,19 @@ size(Gbt) ->
 %% @doc Insert a new entry into the index that associates given topic filter to given
 %% record ID, and attaches arbitrary record to the entry. This allows users to choose
 %% between regular and "materialized" indexes, for example.
--spec insert(emqx_types:topic() | words(), _ID, _Record, t()) -> t().
+-spec insert(emqx_types:topic() | words(), ID, Record, t(ID, Record)) -> t(ID, Record).
 insert(Filter, ID, Record, Gbt) ->
     Key = key(Filter, ID),
     gb_trees:enter(Key, Record, Gbt).
 
 %% @doc Delete an entry from the index that associates given topic filter to given
 %% record ID. Deleting non-existing entry is not an error.
--spec delete(emqx_types:topic() | words(), _ID, t()) -> t().
+-spec delete(emqx_types:topic() | words(), ID, t(ID, Record)) -> t(ID, Record).
 delete(Filter, ID, Gbt) ->
     Key = key(Filter, ID),
     gb_trees:delete_any(Key, Gbt).
 
--spec lookup(emqx_types:topic() | words(), _ID, t(), Default) -> _Record | Default.
+-spec lookup(emqx_types:topic() | words(), ID, t(ID, Record), Default) -> Record | Default.
 lookup(Filter, ID, Gbt, Default) ->
     Key = key(Filter, ID),
     case gb_trees:lookup(Key, Gbt) of
@@ -76,7 +76,7 @@ lookup(Filter, ID, Gbt, Default) ->
             Default
     end.
 
--spec fold(fun((key(_ID), _Record, Acc) -> Acc), Acc, t()) -> Acc.
+-spec fold(fun((key(ID), Record, Acc) -> Acc), Acc, t(ID, Record)) -> Acc.
 fold(Fun, Acc, Gbt) ->
     Iter = gb_trees:iterator(Gbt),
     fold_iter(Fun, Acc, Iter).
@@ -91,13 +91,13 @@ fold_iter(Fun, Acc, Iter) ->
 
 %% @doc Match given topic against the index and return the first match, or `false` if
 %% no match is found.
--spec match(emqx_types:topic(), t()) -> match(_ID) | false.
+-spec match(emqx_types:topic(), t(ID, _Record)) -> match(ID) | false.
 match(Topic, Gbt) ->
     emqx_trie_search:match(Topic, make_nextf(Gbt)).
 
 %% @doc Match given topic against the index and return _all_ matches.
 %% If `unique` option is given, return only unique matches by record ID.
--spec matches(emqx_types:topic(), t(), emqx_trie_search:opts()) -> [match(_ID)].
+-spec matches(emqx_types:topic(), t(ID, _Record), emqx_trie_search:opts()) -> [match(ID)].
 matches(Topic, Gbt, Opts) ->
     emqx_trie_search:matches(Topic, make_nextf(Gbt), Opts).
 
@@ -112,7 +112,7 @@ get_topic(Key) ->
     emqx_trie_search:get_topic(Key).
 
 %% @doc Fetch the record associated with the match.
--spec get_record(match(_ID), t()) -> _Record.
+-spec get_record(match(ID), t(ID, Record)) -> Record.
 get_record(Key, Gbt) ->
     gb_trees:get(Key, Gbt).
 
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index f2a42332e..64cd9c6a8 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -36,7 +36,7 @@ all() ->
         % NOTE
         % Tests are disabled while existing session persistence impl is being
         % phased out.
-        {group, persistence_disabled},
+        %{group, persistence_disabled},
         {group, persistence_enabled}
     ].
 
@@ -71,7 +71,11 @@ init_per_group(persistence_disabled, Config) ->
     ];
 init_per_group(persistence_enabled, Config) ->
     [
-        {emqx_config, "session_persistence { enable = true }"},
+        {emqx_config,
+            "session_persistence {\n"
+            "  enable = true\n"
+            "  renew_streams_interval = 100ms\n"
+            "}"},
         {persistence, ds}
         | Config
     ];
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 04f19b95f..23f69a81b 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -594,7 +594,7 @@ fields("node") ->
             sc(
                 hoconsc:enum([gen_rpc, distr]),
                 #{
-                    mapping => "mria.shard_transport",
+                    mapping => "mria.shardp_transport",
                     importance => ?IMPORTANCE_HIDDEN,
                     default => distr,
                     desc => ?DESC(db_default_shard_transport)
diff --git a/apps/emqx_durable_storage/src/emqx_ds.erl b/apps/emqx_durable_storage/src/emqx_ds.erl
index 1402a19e3..4e408ed80 100644
--- a/apps/emqx_durable_storage/src/emqx_ds.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds.erl
@@ -47,6 +47,8 @@
     topic_filter/0,
     topic/0,
     stream/0,
+    rank_x/0,
+    rank_y/0,
     stream_rank/0,
     iterator/0,
     iterator_id/0,
@@ -77,7 +79,11 @@
 %% Parsed topic filter.
 -type topic_filter() :: list(binary() | '+' | '#' | '').
 
--type stream_rank() :: {term(), integer()}.
+-type rank_x() :: term().
+
+-type rank_y() :: integer().
+
+-type stream_rank() :: {rank_x(), rank_y()}.
 
 %% TODO: Not implemented
 -type iterator_id() :: term().
diff --git a/apps/emqx_exhook/test/emqx_exhook_SUITE.erl b/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
index ffe932449..2d53886e3 100644
--- a/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
+++ b/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.

From 3fb2064ea4814f0184e7c4a461d5c304f1626eb8 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 3 Jan 2024 15:35:53 +0100
Subject: [PATCH 077/273] test(sessds): Add property-based tests for seqno
 generator

---
 apps/emqx/src/emqx_channel.erl                |  6 +-
 apps/emqx/src/emqx_cm.erl                     |  2 +-
 apps/emqx/src/emqx_persistent_session_ds.erl  | 91 +++++++++++++++++--
 .../test/emqx_persistent_session_SUITE.erl    | 20 +++-
 4 files changed, 103 insertions(+), 16 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index cf519fd5d..f4661a85e 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2019-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2019-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -191,7 +191,9 @@ info(topic_aliases, #channel{topic_aliases = Aliases}) ->
 info(alias_maximum, #channel{alias_maximum = Limits}) ->
     Limits;
 info(timers, #channel{timers = Timers}) ->
-    Timers.
+    Timers;
+info(session_state, #channel{session = Session}) ->
+    Session.
 
 set_conn_state(ConnState, Channel) ->
     Channel#channel{conn_state = ConnState}.
diff --git a/apps/emqx/src/emqx_cm.erl b/apps/emqx/src/emqx_cm.erl
index 2e6714e7f..10cd3d6cc 100644
--- a/apps/emqx/src/emqx_cm.erl
+++ b/apps/emqx/src/emqx_cm.erl
@@ -1,5 +1,5 @@
 %%-------------------------------------------------------------------
-%% Copyright (c) 2017-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2017-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 1ab256d32..ee7fb3eb9 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -27,6 +27,11 @@
 
 -include("emqx_persistent_session_ds.hrl").
 
+-ifdef(TEST).
+-include_lib("proper/include/proper.hrl").
+-include_lib("eunit/include/eunit.hrl").
+-endif.
+
 %% Session API
 -export([
     create/3,
@@ -216,12 +221,12 @@ info(retry_interval, #{props := Conf}) ->
     maps:get(retry_interval, Conf);
 % info(mqueue, #sessmem{mqueue = MQueue}) ->
 %     MQueue;
-% info(mqueue_len, #sessmem{mqueue = MQueue}) ->
-%     emqx_mqueue:len(MQueue);
+info(mqueue_len, #{inflight := Inflight}) ->
+    emqx_persistent_session_ds_inflight:n_buffered(Inflight);
 % info(mqueue_max, #sessmem{mqueue = MQueue}) ->
 %     emqx_mqueue:max_len(MQueue);
-% info(mqueue_dropped, #sessmem{mqueue = MQueue}) ->
-%     emqx_mqueue:dropped(MQueue);
+info(mqueue_dropped, _Session) ->
+    0;
 %% info(next_pkt_id, #{s := S}) ->
 %%     {PacketId, _} = emqx_persistent_message_ds_replayer:next_packet_id(S),
 %%     PacketId;
@@ -750,6 +755,11 @@ drain_buffer(Session = #{inflight := Inflight0}) ->
     ((STREAM#ifs.last_seqno_qos1 =< COMMITTEDQOS1 orelse STREAM#ifs.last_seqno_qos1 =:= undefined) andalso
      (STREAM#ifs.last_seqno_qos2 =< COMMITTEDQOS2 orelse STREAM#ifs.last_seqno_qos2 =:= undefined))).
 
+%% erlfmt-ignore
+-define(last_replayed(STREAM, NEXTQOS1, NEXTQOS2),
+    ((STREAM#ifs.last_seqno_qos1 == NEXTQOS1 orelse STREAM#ifs.last_seqno_qos1 =:= undefined) andalso
+     (STREAM#ifs.last_seqno_qos2 == NEXTQOS2 orelse STREAM#ifs.last_seqno_qos2 =:= undefined))).
+
 -spec find_replay_streams(session()) ->
     [{emqx_persistent_session_ds_state:stream_key(), stream_state()}].
 find_replay_streams(#{s := S}) ->
@@ -1002,9 +1012,6 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
     seqno().
 packet_id_to_seqno(PacketId, S) ->
     NextSeqNo = emqx_persistent_session_ds_state:get_seqno(?next(packet_id_to_qos(PacketId)), S),
-    packet_id_to_seqno_(PacketId, NextSeqNo).
-
-packet_id_to_seqno_(PacketId, NextSeqNo) ->
     Epoch = NextSeqNo bsr 15,
     SeqNo = (Epoch bsl 15) + (PacketId bsr 1),
     case SeqNo =< NextSeqNo of
@@ -1059,6 +1066,74 @@ list_all_sessions() ->
 
 %%%% Proper generators:
 
-%%%% Unit tests:
+%% Generate a sequence number that smaller than the given `NextSeqNo'
+%% number by at most `?EPOCH_SIZE':
+seqno_gen(NextSeqNo) ->
+    WindowSize = ?EPOCH_SIZE - 1,
+    Min = max(0, NextSeqNo - WindowSize),
+    Max = max(0, NextSeqNo - 1),
+    range(Min, Max).
+
+%% Generate a sequence number:
+next_seqno_gen() ->
+    ?LET(
+        {Epoch, Offset},
+        {non_neg_integer(), non_neg_integer()},
+        Epoch bsl 15 + Offset
+    ).
+
+%%%% Property-based tests:
+
+%% erlfmt-ignore
+packet_id_to_seqno_prop() ->
+    ?FORALL(
+        {Qos, NextSeqNo}, {oneof([?QOS_1, ?QOS_2]), next_seqno_gen()},
+        ?FORALL(
+            ExpectedSeqNo, seqno_gen(NextSeqNo),
+            begin
+                PacketId = seqno_to_packet_id(Qos, ExpectedSeqNo),
+                SeqNo = packet_id_to_seqno(PacketId, NextSeqNo),
+                ?WHENFAIL(
+                    begin
+                        io:format(user, " *** PacketID = ~p~n", [PacketId]),
+                        io:format(user, " *** SeqNo = ~p -> ~p~n", [ExpectedSeqNo, SeqNo]),
+                        io:format(user, " *** NextSeqNo = ~p~n", [NextSeqNo])
+                    end,
+                    PacketId < 16#10000 andalso SeqNo =:= ExpectedSeqNo
+                )
+            end)).
+
+inc_seqno_prop() ->
+    ?FORALL(
+        {Qos, SeqNo},
+        {oneof([?QOS_1, ?QOS_2]), next_seqno_gen()},
+        begin
+            NewSeqNo = inc_seqno(Qos, SeqNo),
+            PacketId = seqno_to_packet_id(Qos, NewSeqNo),
+            ?WHENFAIL(
+                begin
+                    io:format(user, " *** SeqNo = ~p -> ~p~n", [SeqNo, NewSeqNo]),
+                    io:format(user, " *** PacketId = ~p~n", [PacketId])
+                end,
+                PacketId > 0 andalso PacketId < 16#10000
+            )
+        end
+    ).
+
+seqno_proper_test_() ->
+    Props = [packet_id_to_seqno_prop(), inc_seqno_prop()],
+    Opts = [{numtests, 10000}, {to_file, user}],
+    {timeout, 30,
+        {setup,
+            fun() ->
+                meck:new(emqx_persistent_session_ds_state, [no_history]),
+                ok = meck:expect(emqx_persistent_session_ds_state, get_seqno, fun(_Track, Seqno) ->
+                    Seqno
+                end)
+            end,
+            fun(_) ->
+                meck:unload(emqx_persistent_session_ds_state)
+            end,
+            [?_assert(proper:quickcheck(Prop, Opts)) || Prop <- Props]}}.
 
 -endif.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 64cd9c6a8..6c9da71e0 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -36,7 +36,7 @@ all() ->
         % NOTE
         % Tests are disabled while existing session persistence impl is being
         % phased out.
-        %{group, persistence_disabled},
+        %%{group, persistence_disabled},
         {group, persistence_enabled}
     ].
 
@@ -56,7 +56,7 @@ groups() ->
     TCsNonGeneric = [t_choose_impl],
     TCGroups = [{group, tcp}, {group, quic}, {group, ws}],
     [
-        {persistence_disabled, TCGroups},
+        %% {persistence_disabled, TCGroups},
         {persistence_enabled, TCGroups},
         {tcp, [], TCs},
         {quic, [], TCs -- TCsNonGeneric},
@@ -782,8 +782,9 @@ t_publish_many_while_client_is_gone(Config) ->
     ClientOpts = [
         {proto_ver, v5},
         {clientid, ClientId},
-        {properties, #{'Session-Expiry-Interval' => 30}},
-        {auto_ack, never}
+        %,
+        {properties, #{'Session-Expiry-Interval' => 30}}
+        %{auto_ack, never}
         | Config
     ],
 
@@ -810,7 +811,7 @@ t_publish_many_while_client_is_gone(Config) ->
     Msgs1 = receive_messages(NPubs1),
     ct:pal("Msgs1 = ~p", [Msgs1]),
     NMsgs1 = length(Msgs1),
-    ?assertEqual(NPubs1, NMsgs1),
+    ?assertEqual(NPubs1, NMsgs1, debug_info(ClientId)),
 
     ?assertEqual(
         get_topicwise_order(Pubs1),
@@ -1084,3 +1085,12 @@ skip_ds_tc(Config) ->
         _ ->
             Config
     end.
+
+fail_with_debug_info(Exception, ClientId) ->
+    case emqx_cm:lookup_channels(ClientId) of
+        [Chan] ->
+            sys:get_state(Chan, 1000);
+        [] ->
+            no_channel
+    end,
+    exit(Exception).

From 82ef34998a16ff5611239c1fb71a9cb9bf98be31 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 4 Jan 2024 01:52:34 +0100
Subject: [PATCH 078/273] feat(sessds): Index streams by a unique subid

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 177 +++++++++++-------
 apps/emqx/src/emqx_persistent_session_ds.hrl  |   1 +
 .../src/emqx_persistent_session_ds_state.erl  | 162 +++++++++-------
 .../test/emqx_persistent_session_SUITE.erl    |  23 ++-
 4 files changed, 221 insertions(+), 142 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index ee7fb3eb9..20153f4a7 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -93,6 +93,7 @@
     seqno/0,
     timestamp/0,
     topic_filter/0,
+    subscription_id/0,
     subscription/0,
     session/0,
     stream_state/0
@@ -105,7 +106,10 @@
 -type id() :: binary().
 -type topic_filter() :: emqx_types:topic().
 
+-type subscription_id() :: integer().
+
 -type subscription() :: #{
+    id := subscription_id(),
     start_time := emqx_ds:time(),
     props := map(),
     extra := map()
@@ -286,16 +290,19 @@ subscribe(
             %% router and iterator information can be reconstructed
             %% from this table, if needed.
             ok = emqx_persistent_session_ds_router:do_add_route(TopicFilter, ID),
+            {SubId, S1} = emqx_persistent_session_ds_state:new_subid(S0),
             Subscription = #{
                 start_time => now_ms(),
-                props => SubOpts
+                props => SubOpts,
+                id => SubId
             },
             IsNew = true;
         Subscription0 = #{} ->
             Subscription = Subscription0#{props => SubOpts},
-            IsNew = false
+            IsNew = false,
+            S1 = S0
     end,
-    S = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S0),
+    S = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S1),
     ?tp(persistent_session_ds_subscription_added, #{
         topic_filter => TopicFilter, sub => Subscription, is_new => IsNew
     }),
@@ -309,7 +316,7 @@ unsubscribe(
 ) ->
     %% TODO: drop streams and messages from the buffer
     case subs_lookup(TopicFilter, S0) of
-        #{props := SubOpts} ->
+        #{props := SubOpts, id := _SubId} ->
             S = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
             ?tp_span(
                 persistent_session_ds_subscription_route_delete,
@@ -477,7 +484,7 @@ disconnect(Session = #{s := S0}, _ConnInfo) ->
 
 -spec terminate(Reason :: term(), session()) -> ok.
 terminate(_Reason, _Session = #{s := S}) ->
-    emqx_persistent_session_ds_state:commit(S),
+    _ = emqx_persistent_session_ds_state:commit(S),
     ok.
 
 %%--------------------------------------------------------------------
@@ -584,7 +591,9 @@ do_ensure_all_iterators_closed(_DSSessionID) ->
 %%--------------------------------------------------------------------
 
 fill_buffer(Session = #{s := S}, ClientInfo) ->
-    fill_buffer(shuffle(find_new_streams(S)), Session, ClientInfo).
+    Streams = shuffle(find_new_streams(S)),
+    ?SLOG(error, #{msg => "fill_buffer", streams => Streams}),
+    fill_buffer(Streams, Session, ClientInfo).
 
 -spec shuffle([A]) -> [A].
 shuffle(L0) ->
@@ -827,82 +836,124 @@ find_new_streams(S) ->
 
 -spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
 renew_streams(S0) ->
-    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
-    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
+    S1 = remove_old_streams(S0),
     subs_fold(
-        fun(TopicFilterBin, _Subscription = #{start_time := StartTime}, S1) ->
-            SubId = [],
+        fun(TopicFilterBin, _Subscription = #{start_time := StartTime, id := SubId}, S2) ->
             TopicFilter = emqx_topic:words(TopicFilterBin),
-            TopicStreams = emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
-            TopicStreamGroups = maps:groups_from_list(fun({{X, _}, _}) -> X end, TopicStreams),
-            %% Iterate over groups of streams with the same rank X,
-            %% finding the first eligible stream to replay:
-            maps:fold(
-                fun(RankX, Streams, S2) ->
-                    Key = {RankX, SubId},
-                    case emqx_persistent_session_ds_state:get_stream(Key, S2) of
-                        undefined ->
-                            MinRankY = emqx_persistent_session_ds_state:get_rank(RankX, S2),
-                            start_stream_replay(
-                                TopicFilter, StartTime, Key, MinRankY, Streams, S2
-                            );
-                        Stream = #ifs{it_end = end_of_stream, rank_y = MinRankY} when
-                            ?fully_replayed(Stream, CommQos1, CommQos2)
-                        ->
-                            %% We have fully replayed the stream with
-                            %% the given rank X, and the client acked
-                            %% all messages:
-                            S3 = emqx_persistent_session_ds_state:del_stream(Key, S2),
-                            S4 = emqx_persistent_session_ds_state:put_rank(RankX, MinRankY, S3),
-                            start_stream_replay(TopicFilter, StartTime, Key, MinRankY, Streams, S4);
-                        #ifs{} ->
-                            %% Stream replay is currently in progress, leave it as is:
-                            S2
-                    end
+            Streams = select_streams(
+                SubId,
+                emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
+                S2
+            ),
+            lists:foldl(
+                fun(I, Acc) ->
+                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc)
                 end,
-                S1,
-                TopicStreamGroups
+                S2,
+                Streams
             )
         end,
-        S0,
-        S0
+        S1,
+        S1
     ).
 
-start_stream_replay(TopicFilter, StartTime, Key, MinRankY, Streams, S0) ->
-    case find_first_stream(MinRankY, Streams) of
-        {RankY, Stream} ->
+ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
+    Key = {SubId, Stream},
+    case emqx_persistent_session_ds_state:get_stream(Key, S) of
+        undefined ->
             {ok, Iterator} = emqx_ds:make_iterator(
                 ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
             ),
             NewStreamState = #ifs{
+                rank_x = RankX,
                 rank_y = RankY,
                 it_end = Iterator
             },
-            emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S0);
-        undefined ->
-            S0
+            emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
+        #ifs{} ->
+            S
     end.
 
-%% @doc Find the first stream with rank Y greater than the one given as the first argument.
--spec find_first_stream(emqx_ds:rank_y() | undefined, [
-    {emqx_ds:stream_rank(), emqx_ds:ds_specific_stream()}
-]) ->
-    {emqx_ds:rank_y(), emqx_ds:ds_specific_stream()} | undefined.
-find_first_stream(MinRankY, Streams) ->
-    lists:foldl(
+select_streams(SubId, Streams0, S) ->
+    TopicStreamGroups = maps:groups_from_list(fun({{X, _}, _}) -> X end, Streams0),
+    maps:fold(
+        fun(RankX, Streams, Acc) ->
+            select_streams(SubId, RankX, Streams, S) ++ Acc
+        end,
+        [],
+        TopicStreamGroups
+    ).
+
+select_streams(SubId, RankX, Streams0, S) ->
+    %% 1. Find the streams with the rank Y greater than the recorded one:
+    Streams1 =
+        case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, S) of
+            undefined ->
+                Streams0;
+            ReplayedY ->
+                [I || I = {{_, Y}, _} <- Streams0, Y > ReplayedY]
+        end,
+    %% 2. Sort streams by rank Y:
+    Streams = lists:sort(
+        fun({{_, Y1}, _}, {{_, Y2}, _}) ->
+            Y1 =< Y2
+        end,
+        Streams1
+    ),
+    %% 3. Select streams with the least rank Y:
+    case Streams of
+        [] ->
+            [];
+        [{{_, MinRankY}, _} | _] ->
+            lists:takewhile(fun({{_, Y}, _}) -> Y =:= MinRankY end, Streams)
+    end.
+
+-spec remove_old_streams(emqx_persistent_session_ds_state:t()) ->
+    emqx_persistent_session_ds_state:t().
+remove_old_streams(S0) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
+    %% 1. For each subscription, find the X ranks that were fully replayed:
+    Groups = emqx_persistent_session_ds_state:fold_streams(
+        fun({SubId, _Stream}, StreamState = #ifs{rank_x = RankX, rank_y = RankY, it_end = It}, Acc) ->
+            Key = {SubId, RankX},
+            IsComplete =
+                It =:= end_of_stream andalso ?fully_replayed(StreamState, CommQos1, CommQos2),
+            case {maps:get(Key, Acc, undefined), IsComplete} of
+                {undefined, true} ->
+                    Acc#{Key => {true, RankY}};
+                {_, false} ->
+                    Acc#{Key => false};
+                _ ->
+                    Acc
+            end
+        end,
+        #{},
+        S0
+    ),
+    %% 2. Advance rank y for each fully replayed set of streams:
+    S1 = maps:fold(
         fun
-            ({{_RankX, RankY}, Stream}, Acc) when RankY > MinRankY; MinRankY =:= undefined ->
-                case Acc of
-                    {AccY, _} when AccY < RankY ->
-                        Acc;
-                    _ ->
-                        {RankY, Stream}
-                end;
-            (_, Acc) ->
+            (Key, {true, RankY}, Acc) ->
+                emqx_persistent_session_ds_state:put_rank(Key, RankY, Acc);
+            (_, _, Acc) ->
                 Acc
         end,
-        undefined,
-        Streams
+        S0,
+        Groups
+    ),
+    %% 3. Remove the fully replayed streams:
+    emqx_persistent_session_ds_state:fold_streams(
+        fun(Key = {SubId, _Stream}, #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
+            case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
+                MinRankY when RankY < MinRankY ->
+                    emqx_persistent_session_ds_state:del_stream(Key, Acc);
+                _ ->
+                    Acc
+            end
+        end,
+        S1,
+        S1
     ).
 
 %%--------------------------------------------------------------------------------
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 936b36841..4cb6eb596 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -27,6 +27,7 @@
 
 %% State of the stream:
 -record(ifs, {
+    rank_x :: emqx_ds:rank_x(),
     rank_y :: emqx_ds:rank_y(),
     %% Iterator at the end of the last batch:
     it_end :: emqx_ds:iterator() | undefined | end_of_stream,
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 39fd7eeb7..d3dc70e2d 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -26,10 +26,11 @@
 
 -export([create_tables/0]).
 
--export([open/1, create_new/1, delete/1, commit/1, print_session/1, list_sessions/0]).
+-export([open/1, create_new/1, delete/1, commit/1, format/1, print_session/1, list_sessions/0]).
 -export([get_created_at/1, set_created_at/2]).
 -export([get_last_alive_at/1, set_last_alive_at/2]).
 -export([get_conninfo/1, set_conninfo/2]).
+-export([new_subid/1]).
 -export([get_stream/2, put_stream/3, del_stream/2, fold_streams/3]).
 -export([get_seqno/2, put_seqno/3]).
 -export([get_rank/2, put_rank/3, del_rank/2, fold_ranks/3]).
@@ -38,7 +39,7 @@
 %% internal exports:
 -export([]).
 
--export_type([t/0, subscriptions/0, seqno_type/0, stream_key/0]).
+-export_type([t/0, subscriptions/0, seqno_type/0, stream_key/0, rank_key/0]).
 
 -include("emqx_persistent_session_ds.hrl").
 
@@ -78,18 +79,18 @@
 -define(created_at, created_at).
 -define(last_alive_at, last_alive_at).
 -define(conninfo, conninfo).
+-define(last_subid, last_subid).
 
 -type metadata() ::
     #{
         ?created_at => emqx_persistent_session_ds:timestamp(),
         ?last_alive_at => emqx_persistent_session_ds:timestamp(),
-        ?conninfo => emqx_types:conninfo()
+        ?conninfo => emqx_types:conninfo(),
+        ?last_subid => integer()
     }.
 
 -type seqno_type() :: term().
 
--type stream_key() :: {emqx_ds:rank_x(), _SubId}.
-
 -opaque t() :: #{
     id := emqx_persistent_session_ds:id(),
     dirty := boolean(),
@@ -151,27 +152,31 @@ print_session(SessionId) ->
     case open(SessionId) of
         undefined ->
             undefined;
-        {ok, #{
-            metadata := Metadata,
-            subscriptions := SubsGBT,
-            streams := Streams,
-            seqnos := Seqnos,
-            ranks := Ranks
-        }} ->
-            Subs = emqx_topic_gbt:fold(
-                fun(Key, Sub, Acc) -> maps:put(Key, Sub, Acc) end,
-                #{},
-                SubsGBT
-            ),
-            #{
-                session => Metadata,
-                subscriptions => Subs,
-                streams => Streams#pmap.clean,
-                seqnos => Seqnos#pmap.clean,
-                ranks => Ranks#pmap.clean
-            }
+        {ok, Session} ->
+            format(Session)
     end.
 
+-spec format(t()) -> map().
+format(#{
+    metadata := Metadata,
+    subscriptions := SubsGBT,
+    streams := Streams,
+    seqnos := Seqnos,
+    ranks := Ranks
+}) ->
+    Subs = emqx_topic_gbt:fold(
+        fun(Key, Sub, Acc) -> maps:put(Key, Sub, Acc) end,
+        #{},
+        SubsGBT
+    ),
+    #{
+        metadata => Metadata,
+        subscriptions => Subs,
+        streams => pmap_format(Streams),
+        seqnos => pmap_format(Seqnos),
+        ranks => pmap_format(Ranks)
+    }.
+
 -spec list_sessions() -> [emqx_persistent_session_ds:id()].
 list_sessions() ->
     mnesia:dirty_all_keys(?session_tab).
@@ -248,52 +253,14 @@ get_conninfo(Rec) ->
 set_conninfo(Val, Rec) ->
     set_meta(?conninfo, Val, Rec).
 
-%%
-
--spec get_stream(stream_key(), t()) ->
-    emqx_persistent_session_ds:stream_state() | undefined.
-get_stream(Key, Rec) ->
-    gen_get(streams, Key, Rec).
-
--spec put_stream(stream_key(), emqx_persistent_session_ds:stream_state(), t()) -> t().
-put_stream(Key, Val, Rec) ->
-    gen_put(streams, Key, Val, Rec).
-
--spec del_stream(stream_key(), t()) -> t().
-del_stream(Key, Rec) ->
-    gen_del(stream, Key, Rec).
-
--spec fold_streams(fun(), Acc, t()) -> Acc.
-fold_streams(Fun, Acc, Rec) ->
-    gen_fold(streams, Fun, Acc, Rec).
-
-%%
-
--spec get_seqno(seqno_type(), t()) -> emqx_persistent_session_ds:seqno() | undefined.
-get_seqno(Key, Rec) ->
-    gen_get(seqnos, Key, Rec).
-
--spec put_seqno(seqno_type(), emqx_persistent_session_ds:seqno(), t()) -> t().
-put_seqno(Key, Val, Rec) ->
-    gen_put(seqnos, Key, Val, Rec).
-
-%%
-
--spec get_rank(term(), t()) -> integer() | undefined.
-get_rank(Key, Rec) ->
-    gen_get(ranks, Key, Rec).
-
--spec put_rank(term(), integer(), t()) -> t().
-put_rank(Key, Val, Rec) ->
-    gen_put(ranks, Key, Val, Rec).
-
--spec del_rank(term(), t()) -> t().
-del_rank(Key, Rec) ->
-    gen_del(ranks, Key, Rec).
-
--spec fold_ranks(fun(), Acc, t()) -> Acc.
-fold_ranks(Fun, Acc, Rec) ->
-    gen_fold(ranks, Fun, Acc, Rec).
+-spec new_subid(t()) -> {emqx_persistent_session_ds:subscription_id(), t()}.
+new_subid(Rec) ->
+    LastSubId =
+        case get_meta(?last_subid, Rec) of
+            undefined -> 0;
+            N when is_integer(N) -> N
+        end,
+    {LastSubId, set_meta(?last_subid, LastSubId + 1, Rec)}.
 
 %%
 
@@ -322,6 +289,57 @@ del_subscription(TopicFilter, SubId, Rec = #{id := Id, subscriptions := Subs0})
     Subs = emqx_topic_gbt:delete(TopicFilter, SubId, Subs0),
     Rec#{subscriptions => Subs}.
 
+%%
+
+-type stream_key() :: {emqx_persistent_session_ds:subscription_id(), emqx_ds:stream()}.
+
+-spec get_stream(stream_key(), t()) ->
+    emqx_persistent_session_ds:stream_state() | undefined.
+get_stream(Key, Rec) ->
+    gen_get(streams, Key, Rec).
+
+-spec put_stream(stream_key(), emqx_persistent_session_ds:stream_state(), t()) -> t().
+put_stream(Key, Val, Rec) ->
+    gen_put(streams, Key, Val, Rec).
+
+-spec del_stream(stream_key(), t()) -> t().
+del_stream(Key, Rec) ->
+    gen_del(streams, Key, Rec).
+
+-spec fold_streams(fun(), Acc, t()) -> Acc.
+fold_streams(Fun, Acc, Rec) ->
+    gen_fold(streams, Fun, Acc, Rec).
+
+%%
+
+-spec get_seqno(seqno_type(), t()) -> emqx_persistent_session_ds:seqno() | undefined.
+get_seqno(Key, Rec) ->
+    gen_get(seqnos, Key, Rec).
+
+-spec put_seqno(seqno_type(), emqx_persistent_session_ds:seqno(), t()) -> t().
+put_seqno(Key, Val, Rec) ->
+    gen_put(seqnos, Key, Val, Rec).
+
+%%
+
+-type rank_key() :: {emqx_persistent_session_ds:subscription_id(), emqx_ds:rank_x()}.
+
+-spec get_rank(rank_key(), t()) -> integer() | undefined.
+get_rank(Key, Rec) ->
+    gen_get(ranks, Key, Rec).
+
+-spec put_rank(rank_key(), integer(), t()) -> t().
+put_rank(Key, Val, Rec) ->
+    gen_put(ranks, Key, Val, Rec).
+
+-spec del_rank(rank_key(), t()) -> t().
+del_rank(Key, Rec) ->
+    gen_del(ranks, Key, Rec).
+
+-spec fold_ranks(fun(), Acc, t()) -> Acc.
+fold_ranks(Fun, Acc, Rec) ->
+    gen_fold(ranks, Fun, Acc, Rec).
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
@@ -445,6 +463,10 @@ pmap_commit(
         clean = maps:merge(Clean, Dirty)
     }.
 
+-spec pmap_format(pmap(_K, _V)) -> map().
+pmap_format(#pmap{clean = Clean, dirty = Dirty}) ->
+    maps:merge(Clean, Dirty).
+
 %% Functions dealing with set tables:
 
 kv_persist(Tab, SessionId, Val0) ->
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 6c9da71e0..2c6f0e46f 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -811,7 +811,8 @@ t_publish_many_while_client_is_gone(Config) ->
     Msgs1 = receive_messages(NPubs1),
     ct:pal("Msgs1 = ~p", [Msgs1]),
     NMsgs1 = length(Msgs1),
-    ?assertEqual(NPubs1, NMsgs1, debug_info(ClientId)),
+    NPubs1 =:= NMsgs1 orelse
+        throw_with_debug_info({NPubs1, '==', NMsgs1}, ClientId),
 
     ?assertEqual(
         get_topicwise_order(Pubs1),
@@ -1086,11 +1087,15 @@ skip_ds_tc(Config) ->
             Config
     end.
 
-fail_with_debug_info(Exception, ClientId) ->
-    case emqx_cm:lookup_channels(ClientId) of
-        [Chan] ->
-            sys:get_state(Chan, 1000);
-        [] ->
-            no_channel
-    end,
-    exit(Exception).
+throw_with_debug_info(Error, ClientId) ->
+    Info =
+        case emqx_cm:lookup_channels(ClientId) of
+            [Pid] ->
+                #{channel := ChanState} = emqx_connection:get_state(Pid),
+                SessionState = emqx_channel:info(session_state, ChanState),
+                maps:update_with(s, fun emqx_persistent_session_ds_state:format/1, SessionState);
+            [] ->
+                no_channel
+        end,
+    ct:pal("!!! Assertion failed: ~p~nState:~n~p", [Error, Info]),
+    exit(Error).

From 4f4831fe7f508e7a99d8905e07824fe751e110d9 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 5 Jan 2024 04:26:14 +0100
Subject: [PATCH 079/273] refactor(sessds): Factor out stream scheduler into
 its own module

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 532 ++++++------------
 apps/emqx/src/emqx_persistent_session_ds.hrl  |  39 +-
 .../emqx_persistent_session_ds_inflight.erl   |  80 ++-
 .../src/emqx_persistent_session_ds_state.erl  |   9 +-
 ...persistent_session_ds_stream_scheduler.erl | 247 ++++++++
 .../test/emqx_persistent_session_SUITE.erl    |  25 +-
 6 files changed, 524 insertions(+), 408 deletions(-)
 create mode 100644 apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 20153f4a7..f334204cc 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -115,17 +115,6 @@
     extra := map()
 }.
 
-%%%%% Session sequence numbers:
--define(next(QOS), {0, QOS}).
-%% Note: we consider the sequence number _committed_ once the full
-%% packet MQTT flow is completed for the sequence number. That is,
-%% when we receive PUBACK for the QoS1 message, or PUBCOMP, or PUBREC
-%% with Reason code > 0x80 for QoS2 message.
--define(committed(QOS), {1, QOS}).
-%% For QoS2 messages we also need to store the sequence number of the
-%% last PUBREL message:
--define(pubrec, 2).
-
 -define(TIMER_PULL, timer_pull).
 -define(TIMER_GET_STREAMS, timer_get_streams).
 -define(TIMER_BUMP_LAST_ALIVE_AT, timer_bump_last_alive_at).
@@ -156,7 +145,9 @@
     subscriptions_cnt,
     subscriptions_max,
     inflight_cnt,
-    inflight_max
+    inflight_max,
+    mqueue_len,
+    mqueue_dropped
 ]).
 
 %%
@@ -226,7 +217,7 @@ info(retry_interval, #{props := Conf}) ->
 % info(mqueue, #sessmem{mqueue = MQueue}) ->
 %     MQueue;
 info(mqueue_len, #{inflight := Inflight}) ->
-    emqx_persistent_session_ds_inflight:n_buffered(Inflight);
+    emqx_persistent_session_ds_inflight:n_buffered(all, Inflight);
 % info(mqueue_max, #sessmem{mqueue = MQueue}) ->
 %     emqx_mqueue:max_len(MQueue);
 info(mqueue_dropped, _Session) ->
@@ -250,7 +241,16 @@ stats(Session) ->
 %% Debug/troubleshooting
 -spec print_session(emqx_types:clientid()) -> map() | undefined.
 print_session(ClientId) ->
-    emqx_persistent_session_ds_state:print_session(ClientId).
+    case emqx_cm:lookup_channels(ClientId) of
+        [Pid] ->
+            #{channel := ChanState} = emqx_connection:get_state(Pid),
+            SessionState = emqx_channel:info(session_state, ChanState),
+            maps:update_with(s, fun emqx_persistent_session_ds_state:format/1, SessionState#{
+                '_alive' => {true, Pid}
+            });
+        [] ->
+            emqx_persistent_session_ds_state:print_session(ClientId)
+    end.
 
 %%--------------------------------------------------------------------
 %% Client -> Broker: SUBSCRIBE / UNSUBSCRIBE
@@ -420,7 +420,7 @@ handle_timeout(
     ?TIMER_PULL,
     Session0
 ) ->
-    {Publishes, Session1} = drain_buffer(fill_buffer(Session0, ClientInfo)),
+    {Publishes, Session1} = drain_buffer(fetch_new_messages(Session0, ClientInfo)),
     Timeout =
         case Publishes of
             [] ->
@@ -431,7 +431,7 @@ handle_timeout(
     Session = emqx_session:ensure_timer(?TIMER_PULL, Timeout, Session1),
     {ok, Publishes, Session};
 handle_timeout(_ClientInfo, ?TIMER_GET_STREAMS, Session0 = #{s := S0}) ->
-    S = renew_streams(S0),
+    S = emqx_persistent_session_ds_stream_scheduler:renew_streams(S0),
     Interval = emqx_config:get([session_persistence, renew_streams_interval]),
     Session = emqx_session:ensure_timer(
         ?TIMER_GET_STREAMS,
@@ -461,11 +461,11 @@ bump_last_alive(S0) ->
 
 -spec replay(clientinfo(), [], session()) ->
     {ok, replies(), session()}.
-replay(ClientInfo, [], Session0) ->
-    Streams = find_replay_streams(Session0),
+replay(ClientInfo, [], Session0 = #{s := S0}) ->
+    Streams = emqx_persistent_session_ds_stream_scheduler:find_replay_streams(S0),
     Session = lists:foldl(
-        fun({StreamKey, Stream}, SessionAcc) ->
-            replay_batch(StreamKey, Stream, SessionAcc, ClientInfo)
+        fun({_StreamKey, Stream}, SessionAcc) ->
+            replay_batch(Stream, SessionAcc, ClientInfo)
         end,
         Session0,
         Streams
@@ -474,6 +474,27 @@ replay(ClientInfo, [], Session0) ->
     %% from now on we'll rely on the normal inflight/flow control
     %% mechanisms to replay them:
     {ok, [], pull_now(Session)}.
+
+-spec replay_batch(stream_state(), session(), clientinfo()) -> session().
+replay_batch(Ifs0, Session, ClientInfo) ->
+    #ifs{
+        batch_begin_key = BatchBeginMsgKey,
+        batch_size = BatchSize,
+        it_end = ItEnd
+    } = Ifs0,
+    %% TODO: retry
+    {ok, ItBegin} = emqx_ds:update_iterator(?PERSISTENT_MESSAGE_DB, ItEnd, BatchBeginMsgKey),
+    Ifs1 = Ifs0#ifs{it_end = ItBegin},
+    {Ifs, Inflight} = enqueue_batch(true, BatchSize, Ifs1, Session, ClientInfo),
+    %% Assert:
+    Ifs =:= Ifs1 orelse
+        ?SLOG(warning, #{
+            msg => "replay_inconsistency",
+            expected => Ifs1,
+            got => Ifs
+        }),
+    Session#{inflight => Inflight}.
+
 %%--------------------------------------------------------------------
 
 -spec disconnect(session(), emqx_types:conninfo()) -> {shutdown, session()}.
@@ -544,12 +565,21 @@ session_ensure_new(Id, ConnInfo, Conf) ->
     S1 = emqx_persistent_session_ds_state:set_conninfo(ConnInfo, S0),
     S2 = bump_last_alive(S1),
     S3 = emqx_persistent_session_ds_state:set_created_at(Now, S2),
-    S4 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), 0, S3),
-    S5 = emqx_persistent_session_ds_state:put_seqno(?committed(?QOS_1), 0, S4),
-    S6 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), 0, S5),
-    S7 = emqx_persistent_session_ds_state:put_seqno(?committed(?QOS_2), 0, S6),
-    S8 = emqx_persistent_session_ds_state:put_seqno(?pubrec, 0, S7),
-    S = emqx_persistent_session_ds_state:commit(S8),
+    S4 = lists:foldl(
+        fun(Track, Acc) ->
+            emqx_persistent_session_ds_state:put_seqno(Track, 0, Acc)
+        end,
+        S3,
+        [
+            ?next(?QOS_1),
+            ?dup(?QOS_1),
+            ?committed(?QOS_1),
+            ?next(?QOS_2),
+            ?dup(?QOS_2),
+            ?committed(?QOS_2)
+        ]
+    ),
+    S = emqx_persistent_session_ds_state:commit(S4),
     #{
         id => Id,
         props => Conf,
@@ -587,105 +617,88 @@ do_ensure_all_iterators_closed(_DSSessionID) ->
     ok.
 
 %%--------------------------------------------------------------------
-%% Buffer filling
+%% Normal replay:
 %%--------------------------------------------------------------------
 
-fill_buffer(Session = #{s := S}, ClientInfo) ->
-    Streams = shuffle(find_new_streams(S)),
-    ?SLOG(error, #{msg => "fill_buffer", streams => Streams}),
-    fill_buffer(Streams, Session, ClientInfo).
+fetch_new_messages(Session = #{s := S}, ClientInfo) ->
+    Streams = emqx_persistent_session_ds_stream_scheduler:find_new_streams(S),
+    ?SLOG(debug, #{msg => "fill_buffer", streams => Streams}),
+    fetch_new_messages(Streams, Session, ClientInfo).
 
--spec shuffle([A]) -> [A].
-shuffle(L0) ->
-    L1 = lists:map(
-        fun(A) ->
-            %% maybe topic/stream prioritization could be introduced here?
-            {rand:uniform(), A}
-        end,
-        L0
-    ),
-    L2 = lists:sort(L1),
-    {_, L} = lists:unzip(L2),
-    L.
-
-fill_buffer([], Session, _ClientInfo) ->
+fetch_new_messages([], Session, _ClientInfo) ->
     Session;
-fill_buffer(
-    [{StreamKey, Stream0 = #ifs{it_end = It0}} | Streams],
-    Session0 = #{s := S0, inflight := Inflight0},
-    ClientInfo
-) ->
+fetch_new_messages([I | Streams], Session0 = #{inflight := Inflight}, ClientInfo) ->
     BatchSize = emqx_config:get([session_persistence, max_batch_size]),
-    MaxBufferSize = BatchSize * 2,
-    case emqx_persistent_session_ds_inflight:n_buffered(Inflight0) < MaxBufferSize of
+    case emqx_persistent_session_ds_inflight:n_buffered(all, Inflight) >= BatchSize of
         true ->
-            case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
-                {ok, It, []} ->
-                    S = emqx_persistent_session_ds_state:put_stream(
-                        StreamKey, Stream0#ifs{it_end = It}, S0
-                    ),
-                    fill_buffer(Streams, Session0#{s := S}, ClientInfo);
-                {ok, It, Messages} ->
-                    Session = new_batch(StreamKey, Stream0, It, Messages, Session0, ClientInfo),
-                    fill_buffer(Streams, Session, ClientInfo);
-                {ok, end_of_stream} ->
-                    S = emqx_persistent_session_ds_state:put_stream(
-                        StreamKey, Stream0#ifs{it_end = end_of_stream}, S0
-                    ),
-                    fill_buffer(Streams, Session0#{s := S}, ClientInfo)
-            end;
+            %% Buffer is full:
+            Session0;
         false ->
-            Session0
+            Session = new_batch(I, BatchSize, Session0, ClientInfo),
+            fetch_new_messages(Streams, Session, ClientInfo)
     end.
 
-new_batch(
-    StreamKey, Stream0, Iterator, [{BatchBeginMsgKey, _} | _] = Messages0, Session0, ClientInfo
-) ->
-    #{inflight := Inflight0, s := S0} = Session0,
-    FirstSeqnoQos1 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0),
-    FirstSeqnoQos2 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0),
-    NBefore = emqx_persistent_session_ds_inflight:n_buffered(Inflight0),
-    {LastSeqnoQos1, LastSeqnoQos2, Session} = do_process_batch(
-        false, FirstSeqnoQos1, FirstSeqnoQos2, Messages0, Session0, ClientInfo
-    ),
-    NAfter = emqx_persistent_session_ds_inflight:n_buffered(maps:get(inflight, Session)),
-    Stream = Stream0#ifs{
-        batch_size = NAfter - NBefore,
-        batch_begin_key = BatchBeginMsgKey,
-        first_seqno_qos1 = FirstSeqnoQos1,
-        first_seqno_qos2 = FirstSeqnoQos2,
-        last_seqno_qos1 = LastSeqnoQos1,
-        last_seqno_qos2 = LastSeqnoQos2,
-        it_end = Iterator
+new_batch({StreamKey, Ifs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
+    SN1 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0),
+    SN2 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0),
+    Ifs1 = Ifs0#ifs{
+        first_seqno_qos1 = SN1,
+        first_seqno_qos2 = SN2,
+        batch_size = 0,
+        batch_begin_key = undefined,
+        last_seqno_qos1 = SN1,
+        last_seqno_qos2 = SN2
     },
-    S1 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), LastSeqnoQos1, S0),
-    S2 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), LastSeqnoQos2, S1),
-    S = emqx_persistent_session_ds_state:put_stream(StreamKey, Stream, S2),
-    Session#{s => S}.
+    {Ifs, Inflight} = enqueue_batch(false, BatchSize, Ifs1, Session, ClientInfo),
+    S1 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), Ifs#ifs.last_seqno_qos1, S0),
+    S2 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), Ifs#ifs.last_seqno_qos2, S1),
+    S = emqx_persistent_session_ds_state:put_stream(StreamKey, Ifs, S2),
+    Session#{s => S, inflight => Inflight}.
 
-replay_batch(_StreamKey, Stream, Session0, ClientInfo) ->
+enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, ClientInfo) ->
     #ifs{
-        batch_begin_key = BatchBeginMsgKey,
-        batch_size = BatchSize,
+        it_end = It0,
         first_seqno_qos1 = FirstSeqnoQos1,
-        first_seqno_qos2 = FirstSeqnoQos2,
-        it_end = ItEnd
-    } = Stream,
-    {ok, ItBegin} = emqx_ds:update_iterator(?PERSISTENT_MESSAGE_DB, ItEnd, BatchBeginMsgKey),
-    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, ItBegin, BatchSize) of
-        {ok, _ItEnd, Messages} ->
-            {_LastSeqnoQo1, _LastSeqnoQos2, Session} = do_process_batch(
-                true, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Session0, ClientInfo
+        first_seqno_qos2 = FirstSeqnoQos2
+    } = Ifs0,
+    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
+        {ok, It, []} ->
+            %% No new messages; just update the end iterator:
+            {Ifs0#ifs{it_end = It}, Inflight0};
+        {ok, end_of_stream} ->
+            %% No new messages; just update the end iterator:
+            {Ifs0#ifs{it_end = end_of_stream}, Inflight0};
+        {ok, It, [{BatchBeginMsgKey, _} | _] = Messages} ->
+            {Inflight, LastSeqnoQos1, LastSeqnoQos2} = process_batch(
+                IsReplay, Session, ClientInfo, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Inflight0
             ),
-            %% TODO: check consistency of the sequence numbers
-            Session
+            Ifs = Ifs0#ifs{
+                it_end = It,
+                batch_begin_key = BatchBeginMsgKey,
+                %% TODO: it should be possible to avoid calling
+                %% length here by diffing size of inflight before
+                %% and after inserting messages:
+                batch_size = length(Messages),
+                last_seqno_qos1 = LastSeqnoQos1,
+                last_seqno_qos2 = LastSeqnoQos2
+            },
+            {Ifs, Inflight};
+        {error, _} when not IsReplay ->
+            ?SLOG(debug, #{msg => "failed_to_fetch_batch", iterator => It0}),
+            {Ifs0, Inflight0}
     end.
 
-do_process_batch(_IsReplay, LastSeqnoQos1, LastSeqnoQos2, [], Session, _ClientInfo) ->
-    {LastSeqnoQos1, LastSeqnoQos2, Session};
-do_process_batch(IsReplay, FirstSeqnoQos1, FirstSeqnoQos2, [KV | Messages], Session, ClientInfo) ->
-    #{s := S, props := #{upgrade_qos := UpgradeQoS}, inflight := Inflight0} = Session,
+process_batch(_IsReplay, _Session, _ClientInfo, LastSeqNoQos1, LastSeqNoQos2, [], Inflight) ->
+    {Inflight, LastSeqNoQos1, LastSeqNoQos2};
+process_batch(
+    IsReplay, Session, ClientInfo, FirstSeqNoQos1, FirstSeqNoQos2, [KV | Messages], Inflight0
+) ->
+    #{s := S, props := #{upgrade_qos := UpgradeQoS}} = Session,
     {_DsMsgKey, Msg0 = #message{topic = Topic}} = KV,
+    Comm1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    Comm2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    Dup1 = emqx_persistent_session_ds_state:get_seqno(?dup(?QOS_1), S),
+    Dup2 = emqx_persistent_session_ds_state:get_seqno(?dup(?QOS_2), S),
     Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
     Msgs = [
         Msg
@@ -695,266 +708,85 @@ do_process_batch(IsReplay, FirstSeqnoQos1, FirstSeqnoQos2, [KV | Messages], Sess
             emqx_session:enrich_message(ClientInfo, Msg0, SubOpts, UpgradeQoS)
         end
     ],
-    CommittedQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
-    CommittedQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
-    {Inflight, LastSeqnoQos1, LastSeqnoQos2} = lists:foldl(
-        fun(Msg = #message{qos = Qos}, {Inflight1, SeqnoQos10, SeqnoQos20}) ->
+    {Inflight, LastSeqNoQos1, LastSeqNoQos2} = lists:foldl(
+        fun(Msg = #message{qos = Qos}, {Acc, SeqNoQos10, SeqNoQos20}) ->
             case Qos of
                 ?QOS_0 ->
-                    SeqnoQos1 = SeqnoQos10,
-                    SeqnoQos2 = SeqnoQos20,
-                    PacketId = undefined;
+                    SeqNoQos1 = SeqNoQos10,
+                    SeqNoQos2 = SeqNoQos20;
                 ?QOS_1 ->
-                    SeqnoQos1 = inc_seqno(?QOS_1, SeqnoQos10),
-                    SeqnoQos2 = SeqnoQos20,
-                    PacketId = seqno_to_packet_id(?QOS_1, SeqnoQos1);
+                    SeqNoQos1 = inc_seqno(?QOS_1, SeqNoQos10),
+                    SeqNoQos2 = SeqNoQos20;
                 ?QOS_2 ->
-                    SeqnoQos1 = SeqnoQos10,
-                    SeqnoQos2 = inc_seqno(?QOS_2, SeqnoQos20),
-                    PacketId = seqno_to_packet_id(?QOS_2, SeqnoQos2)
+                    SeqNoQos1 = SeqNoQos10,
+                    SeqNoQos2 = inc_seqno(?QOS_2, SeqNoQos20)
             end,
-            %% ?SLOG(debug, #{
-            %%     msg => "out packet",
-            %%     qos => Qos,
-            %%     packet_id => PacketId,
-            %%     enriched => emqx_message:to_map(Msg),
-            %%     original => emqx_message:to_map(Msg0),
-            %%     upgrade_qos => UpgradeQoS
-            %% }),
-
-            %% Handle various situations where we want to ignore the packet:
-            Inflight2 =
-                case IsReplay of
-                    true when Qos =:= ?QOS_0 ->
-                        Inflight1;
-                    true when Qos =:= ?QOS_1, SeqnoQos1 < CommittedQos1 ->
-                        Inflight1;
-                    true when Qos =:= ?QOS_2, SeqnoQos2 < CommittedQos2 ->
-                        Inflight1;
-                    _ ->
-                        emqx_persistent_session_ds_inflight:push({PacketId, Msg}, Inflight1)
-                end,
             {
-                Inflight2,
-                SeqnoQos1,
-                SeqnoQos2
+                case Msg#message.qos of
+                    ?QOS_0 when IsReplay ->
+                        %% We ignore QoS 0 messages during replay:
+                        Acc;
+                    ?QOS_0 ->
+                        emqx_persistent_session_ds_inflight:push({undefined, Msg}, Acc);
+                    ?QOS_1 when SeqNoQos1 =< Comm1 ->
+                        %% QoS1 message has been acked by the client, ignore:
+                        Acc;
+                    ?QOS_1 when SeqNoQos1 =< Dup1 ->
+                        %% QoS1 message has been sent but not
+                        %% acked. Retransmit:
+                        Msg1 = emqx_message:set_flag(dup, true, Msg),
+                        emqx_persistent_session_ds_inflight:push({SeqNoQos1, Msg1}, Acc);
+                    ?QOS_1 ->
+                        emqx_persistent_session_ds_inflight:push({SeqNoQos1, Msg}, Acc);
+                    ?QOS_2 when SeqNoQos2 =< Comm2 ->
+                        %% QoS2 message has been PUBCOMP'ed by the client, ignore:
+                        Acc;
+                    ?QOS_2 when SeqNoQos2 =< Dup2 ->
+                        %% QoS2 message has been PUBREC'ed by the client, resend PUBREL:
+                        emqx_persistent_session_ds_inflight:push({pubrel, SeqNoQos2}, Acc);
+                    ?QOS_2 ->
+                        %% MQTT standard 4.3.3: DUP flag is never set for QoS2 messages:
+                        emqx_persistent_session_ds_inflight:push({SeqNoQos2, Msg}, Acc)
+                end,
+                SeqNoQos1,
+                SeqNoQos2
             }
         end,
-        {Inflight0, FirstSeqnoQos1, FirstSeqnoQos2},
+        {Inflight0, FirstSeqNoQos1, FirstSeqNoQos2},
         Msgs
     ),
-    do_process_batch(
-        IsReplay, LastSeqnoQos1, LastSeqnoQos2, Messages, Session#{inflight => Inflight}, ClientInfo
+    process_batch(
+        IsReplay, Session, ClientInfo, LastSeqNoQos1, LastSeqNoQos2, Messages, Inflight
     ).
 
 %%--------------------------------------------------------------------
 %% Buffer drain
 %%--------------------------------------------------------------------
 
-drain_buffer(Session = #{inflight := Inflight0}) ->
-    {Messages, Inflight} = emqx_persistent_session_ds_inflight:pop(Inflight0),
-    {Messages, Session#{inflight => Inflight}}.
+drain_buffer(Session = #{inflight := Inflight0, s := S0}) ->
+    {Publishes, Inflight, S} = do_drain_buffer(Inflight0, S0, []),
+    {Publishes, Session#{inflight => Inflight, s := S}}.
 
-%%--------------------------------------------------------------------
-%% Stream renew
-%%--------------------------------------------------------------------
-
-%% erlfmt-ignore
--define(fully_replayed(STREAM, COMMITTEDQOS1, COMMITTEDQOS2),
-    ((STREAM#ifs.last_seqno_qos1 =< COMMITTEDQOS1 orelse STREAM#ifs.last_seqno_qos1 =:= undefined) andalso
-     (STREAM#ifs.last_seqno_qos2 =< COMMITTEDQOS2 orelse STREAM#ifs.last_seqno_qos2 =:= undefined))).
-
-%% erlfmt-ignore
--define(last_replayed(STREAM, NEXTQOS1, NEXTQOS2),
-    ((STREAM#ifs.last_seqno_qos1 == NEXTQOS1 orelse STREAM#ifs.last_seqno_qos1 =:= undefined) andalso
-     (STREAM#ifs.last_seqno_qos2 == NEXTQOS2 orelse STREAM#ifs.last_seqno_qos2 =:= undefined))).
-
--spec find_replay_streams(session()) ->
-    [{emqx_persistent_session_ds_state:stream_key(), stream_state()}].
-find_replay_streams(#{s := S}) ->
-    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
-    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
-    Streams = emqx_persistent_session_ds_state:fold_streams(
-        fun(Key, Stream, Acc) ->
-            case Stream of
-                #ifs{
-                    first_seqno_qos1 = F1,
-                    first_seqno_qos2 = F2,
-                    last_seqno_qos1 = L1,
-                    last_seqno_qos2 = L2
-                } when F1 >= CommQos1, L1 =< CommQos1, F2 >= CommQos2, L2 =< CommQos2 ->
-                    [{Key, Stream} | Acc];
-                _ ->
-                    Acc
-            end
-        end,
-        [],
-        S
-    ),
-    lists:sort(
-        fun(
-            #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2},
-            #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}
-        ) ->
-            case A1 =:= A2 of
-                true -> B1 =< B2;
-                false -> A1 < A2
-            end
-        end,
-        Streams
-    ).
-
--spec find_new_streams(emqx_persistent_session_ds_state:t()) ->
-    [{emqx_persistent_session_ds_state:stream_key(), stream_state()}].
-find_new_streams(S) ->
-    %% FIXME: this function is currently very sensitive to the
-    %% consistency of the packet IDs on both broker and client side.
-    %%
-    %% If the client fails to properly ack packets due to a bug, or a
-    %% network issue, or if the state of streams and seqno tables ever
-    %% become de-synced, then this function will return an empty list,
-    %% and the replay cannot progress.
-    %%
-    %% In other words, this function is not robust, and we should find
-    %% some way to get the replays un-stuck at the cost of potentially
-    %% losing messages during replay (or just kill the stuck channel
-    %% after timeout?)
-    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
-    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
-    emqx_persistent_session_ds_state:fold_streams(
-        fun
-            (Key, Stream, Acc) when ?fully_replayed(Stream, CommQos1, CommQos2) ->
-                %% This stream has been full acked by the client. It
-                %% means we can get more messages from it:
-                [{Key, Stream} | Acc];
-            (_Key, _Stream, Acc) ->
-                Acc
-        end,
-        [],
-        S
-    ).
-
--spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
-renew_streams(S0) ->
-    S1 = remove_old_streams(S0),
-    subs_fold(
-        fun(TopicFilterBin, _Subscription = #{start_time := StartTime, id := SubId}, S2) ->
-            TopicFilter = emqx_topic:words(TopicFilterBin),
-            Streams = select_streams(
-                SubId,
-                emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
-                S2
-            ),
-            lists:foldl(
-                fun(I, Acc) ->
-                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc)
-                end,
-                S2,
-                Streams
-            )
-        end,
-        S1,
-        S1
-    ).
-
-ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
-    Key = {SubId, Stream},
-    case emqx_persistent_session_ds_state:get_stream(Key, S) of
+do_drain_buffer(Inflight0, S0, Acc) ->
+    case emqx_persistent_session_ds_inflight:pop(Inflight0) of
         undefined ->
-            {ok, Iterator} = emqx_ds:make_iterator(
-                ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
-            ),
-            NewStreamState = #ifs{
-                rank_x = RankX,
-                rank_y = RankY,
-                it_end = Iterator
-            },
-            emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
-        #ifs{} ->
-            S
-    end.
-
-select_streams(SubId, Streams0, S) ->
-    TopicStreamGroups = maps:groups_from_list(fun({{X, _}, _}) -> X end, Streams0),
-    maps:fold(
-        fun(RankX, Streams, Acc) ->
-            select_streams(SubId, RankX, Streams, S) ++ Acc
-        end,
-        [],
-        TopicStreamGroups
-    ).
-
-select_streams(SubId, RankX, Streams0, S) ->
-    %% 1. Find the streams with the rank Y greater than the recorded one:
-    Streams1 =
-        case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, S) of
-            undefined ->
-                Streams0;
-            ReplayedY ->
-                [I || I = {{_, Y}, _} <- Streams0, Y > ReplayedY]
-        end,
-    %% 2. Sort streams by rank Y:
-    Streams = lists:sort(
-        fun({{_, Y1}, _}, {{_, Y2}, _}) ->
-            Y1 =< Y2
-        end,
-        Streams1
-    ),
-    %% 3. Select streams with the least rank Y:
-    case Streams of
-        [] ->
-            [];
-        [{{_, MinRankY}, _} | _] ->
-            lists:takewhile(fun({{_, Y}, _}) -> Y =:= MinRankY end, Streams)
-    end.
-
--spec remove_old_streams(emqx_persistent_session_ds_state:t()) ->
-    emqx_persistent_session_ds_state:t().
-remove_old_streams(S0) ->
-    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
-    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
-    %% 1. For each subscription, find the X ranks that were fully replayed:
-    Groups = emqx_persistent_session_ds_state:fold_streams(
-        fun({SubId, _Stream}, StreamState = #ifs{rank_x = RankX, rank_y = RankY, it_end = It}, Acc) ->
-            Key = {SubId, RankX},
-            IsComplete =
-                It =:= end_of_stream andalso ?fully_replayed(StreamState, CommQos1, CommQos2),
-            case {maps:get(Key, Acc, undefined), IsComplete} of
-                {undefined, true} ->
-                    Acc#{Key => {true, RankY}};
-                {_, false} ->
-                    Acc#{Key => false};
-                _ ->
-                    Acc
+            {lists:reverse(Acc), Inflight0, S0};
+        {{pubrel, SeqNo}, Inflight} ->
+            Publish = {pubrel, seqno_to_packet_id(?QOS_2, SeqNo)},
+            do_drain_buffer(Inflight, S0, [Publish | Acc]);
+        {{SeqNo, Msg}, Inflight} ->
+            case Msg#message.qos of
+                ?QOS_0 ->
+                    do_drain_buffer(Inflight, S0, [{undefined, Msg} | Acc]);
+                ?QOS_1 ->
+                    S = emqx_persistent_session_ds_state:put_seqno(?dup(?QOS_1), SeqNo, S0),
+                    Publish = {seqno_to_packet_id(?QOS_1, SeqNo), Msg},
+                    do_drain_buffer(Inflight, S, [Publish | Acc]);
+                ?QOS_2 ->
+                    Publish = {seqno_to_packet_id(?QOS_2, SeqNo), Msg},
+                    do_drain_buffer(Inflight, S0, [Publish | Acc])
             end
-        end,
-        #{},
-        S0
-    ),
-    %% 2. Advance rank y for each fully replayed set of streams:
-    S1 = maps:fold(
-        fun
-            (Key, {true, RankY}, Acc) ->
-                emqx_persistent_session_ds_state:put_rank(Key, RankY, Acc);
-            (_, _, Acc) ->
-                Acc
-        end,
-        S0,
-        Groups
-    ),
-    %% 3. Remove the fully replayed streams:
-    emqx_persistent_session_ds_state:fold_streams(
-        fun(Key = {SubId, _Stream}, #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
-            case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
-                MinRankY when RankY < MinRankY ->
-                    emqx_persistent_session_ds_state:del_stream(Key, Acc);
-                _ ->
-                    Acc
-            end
-        end,
-        S1,
-        S1
-    ).
+    end.
 
 %%--------------------------------------------------------------------------------
 
@@ -1023,7 +855,7 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
             Old = ?committed(?QOS_1),
             Next = ?next(?QOS_1);
         pubrec ->
-            Old = ?pubrec,
+            Old = ?dup(?QOS_2),
             Next = ?next(?QOS_2);
         pubcomp ->
             Old = ?committed(?QOS_2),
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 4cb6eb596..e7500606b 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -25,25 +25,40 @@
 -define(SESSION_COMMITTED_OFFSET_TAB, emqx_ds_committed_offset_tab).
 -define(DS_MRIA_SHARD, emqx_ds_session_shard).
 
-%% State of the stream:
+%%%%% Session sequence numbers:
+
+%%
+%%   -----|----------|----------|------> seqno
+%%        |          |          |
+%%   committed      dup       next
+
+%% Seqno becomes committed after receiving PUBACK for QoS1 or PUBCOMP
+%% for QoS2.
+-define(committed(QOS), {0, QOS}).
+%% Seqno becomes dup:
+%%
+%% 1. After broker sends QoS1 message to the client
+%% 2. After it receives PUBREC from the client for the QoS2 message
+-define(dup(QOS), {1, QOS}).
+%% Last seqno assigned to some message (that may reside in the
+%% mqueue):
+-define(next(QOS), {0, QOS}).
+
+%%%%% State of the stream:
 -record(ifs, {
     rank_x :: emqx_ds:rank_x(),
     rank_y :: emqx_ds:rank_y(),
     %% Iterator at the end of the last batch:
-    it_end :: emqx_ds:iterator() | undefined | end_of_stream,
-    %% Size of the last batch:
-    batch_size :: pos_integer() | undefined,
+    it_end :: emqx_ds:iterator() | end_of_stream,
     %% Key that points at the beginning of the batch:
     batch_begin_key :: binary() | undefined,
-    %% Number of messages collected in the last batch:
-    batch_n_messages :: pos_integer() | undefined,
+    batch_size = 0 :: non_neg_integer(),
     %% Session sequence number at the time when the batch was fetched:
-    first_seqno_qos1 :: emqx_persistent_session_ds:seqno() | undefined,
-    first_seqno_qos2 :: emqx_persistent_session_ds:seqno() | undefined,
-    %% Sequence numbers that the client must PUBACK or PUBREL
-    %% before we can consider the batch to be fully replayed:
-    last_seqno_qos1 :: emqx_persistent_session_ds:seqno() | undefined,
-    last_seqno_qos2 :: emqx_persistent_session_ds:seqno() | undefined
+    first_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
+    first_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno(),
+    %% Number of messages collected in the last batch:
+    last_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
+    last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno()
 }).
 
 %% TODO: remove
diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index 75f246ec3..09962faa0 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -16,7 +16,7 @@
 -module(emqx_persistent_session_ds_inflight).
 
 %% API:
--export([new/1, push/2, pop/1, n_buffered/1, n_inflight/1, inc_send_quota/1, receive_maximum/1]).
+-export([new/1, push/2, pop/1, n_buffered/2, n_inflight/1, inc_send_quota/1, receive_maximum/1]).
 
 %% behavior callbacks:
 -export([]).
@@ -44,6 +44,10 @@
 
 -type t() :: #inflight{}.
 
+-type payload() ::
+    {emqx_persistent_session_ds:seqno() | undefined, emqx_types:message()}
+    | {pubrel, emqx_persistent_session_ds:seqno()}.
+
 %%================================================================================
 %% API funcions
 %%================================================================================
@@ -56,10 +60,12 @@ new(ReceiveMaximum) when ReceiveMaximum > 0 ->
 receive_maximum(#inflight{receive_maximum = ReceiveMaximum}) ->
     ReceiveMaximum.
 
--spec push({emqx_types:packet_id() | undefined, emqx_types:message()}, t()) -> t().
-push(Val = {_PacketId, Msg}, Rec) ->
+-spec push(payload(), t()) -> t().
+push(Payload = {pubrel, _SeqNo}, Rec = #inflight{queue = Q}) ->
+    Rec#inflight{queue = queue:in(Payload, Q)};
+push(Payload = {_, Msg}, Rec) ->
     #inflight{queue = Q0, n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2} = Rec,
-    Q = queue:in(Val, Q0),
+    Q = queue:in(Payload, Q0),
     case Msg#message.qos of
         ?QOS_0 ->
             Rec#inflight{queue = Q, n_qos0 = NQos0 + 1};
@@ -69,12 +75,49 @@ push(Val = {_PacketId, Msg}, Rec) ->
             Rec#inflight{queue = Q, n_qos2 = NQos2 + 1}
     end.
 
--spec pop(t()) -> {[{emqx_types:packet_id() | undefined, emqx_types:message()}], t()}.
-pop(Inflight = #inflight{receive_maximum = ReceiveMaximum}) ->
-    do_pop(ReceiveMaximum, Inflight, []).
+-spec pop(t()) -> {payload(), t()} | undefined.
+pop(Rec0) ->
+    #inflight{
+        receive_maximum = ReceiveMaximum,
+        n_inflight = NInflight,
+        queue = Q0,
+        n_qos0 = NQos0,
+        n_qos1 = NQos1,
+        n_qos2 = NQos2
+    } = Rec0,
+    case NInflight < ReceiveMaximum andalso queue:out(Q0) of
+        {{value, Payload}, Q} ->
+            Rec =
+                case Payload of
+                    {pubrel, _} ->
+                        Rec0#inflight{queue = Q};
+                    {_, #message{qos = Qos}} ->
+                        case Qos of
+                            ?QOS_0 ->
+                                Rec0#inflight{queue = Q, n_qos0 = NQos0 - 1};
+                            ?QOS_1 ->
+                                Rec0#inflight{
+                                    queue = Q, n_qos1 = NQos1 - 1, n_inflight = NInflight + 1
+                                };
+                            ?QOS_2 ->
+                                Rec0#inflight{
+                                    queue = Q, n_qos2 = NQos2 - 1, n_inflight = NInflight + 1
+                                }
+                        end
+                end,
+            {Payload, Rec};
+        _ ->
+            undefined
+    end.
 
--spec n_buffered(t()) -> non_neg_integer().
-n_buffered(#inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2}) ->
+-spec n_buffered(0..2 | all, t()) -> non_neg_integer().
+n_buffered(?QOS_0, #inflight{n_qos0 = NQos0}) ->
+    NQos0;
+n_buffered(?QOS_1, #inflight{n_qos1 = NQos1}) ->
+    NQos1;
+n_buffered(?QOS_2, #inflight{n_qos2 = NQos2}) ->
+    NQos2;
+n_buffered(all, #inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2}) ->
     NQos0 + NQos1 + NQos2.
 
 -spec n_inflight(t()) -> non_neg_integer().
@@ -90,22 +133,3 @@ inc_send_quota(Rec = #inflight{n_inflight = NInflight0}) ->
 %%================================================================================
 %% Internal functions
 %%================================================================================
-
-do_pop(ReceiveMaximum, Rec0 = #inflight{n_inflight = NInflight, queue = Q0}, Acc) ->
-    case NInflight < ReceiveMaximum andalso queue:out(Q0) of
-        {{value, Val}, Q} ->
-            #inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2} = Rec0,
-            {_PacketId, #message{qos = Qos}} = Val,
-            Rec =
-                case Qos of
-                    ?QOS_0 ->
-                        Rec0#inflight{queue = Q, n_qos0 = NQos0 - 1};
-                    ?QOS_1 ->
-                        Rec0#inflight{queue = Q, n_qos1 = NQos1 - 1, n_inflight = NInflight + 1};
-                    ?QOS_2 ->
-                        Rec0#inflight{queue = Q, n_qos2 = NQos2 - 1, n_inflight = NInflight + 1}
-                end,
-            do_pop(ReceiveMaximum, Rec, [Val | Acc]);
-        _ ->
-            {lists:reverse(Acc), Rec0}
-    end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index d3dc70e2d..cfe366e2e 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -41,6 +41,7 @@
 
 -export_type([t/0, subscriptions/0, seqno_type/0, stream_key/0, rank_key/0]).
 
+-include("emqx_mqtt.hrl").
 -include("emqx_persistent_session_ds.hrl").
 
 %%================================================================================
@@ -89,7 +90,13 @@
         ?last_subid => integer()
     }.
 
--type seqno_type() :: term().
+-type seqno_type() ::
+    ?next(?QOS_1)
+    | ?dup(?QOS_1)
+    | ?committed(?QOS_1)
+    | ?next(?QOS_2)
+    | ?dup(?QOS_2)
+    | ?committed(?QOS_2).
 
 -opaque t() :: #{
     id := emqx_persistent_session_ds:id(),
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
new file mode 100644
index 000000000..d48d0af77
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -0,0 +1,247 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_persistent_session_ds_stream_scheduler).
+
+%% API:
+-export([find_new_streams/1, find_replay_streams/1]).
+-export([renew_streams/1]).
+
+%% behavior callbacks:
+-export([]).
+
+%% internal exports:
+-export([]).
+
+-export_type([]).
+
+-include("emqx_mqtt.hrl").
+-include("emqx_persistent_session_ds.hrl").
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+%%================================================================================
+%% API functions
+%%================================================================================
+
+-spec find_replay_streams(emqx_persistent_session_ds_state:t()) ->
+    [{emqx_persistent_session_ds_state:stream_key(), emqx_persistent_session_ds:stream_state()}].
+find_replay_streams(S) ->
+    Comm1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    Comm2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    %% 1. Find the streams that aren't fully acked
+    Streams = emqx_persistent_session_ds_state:fold_streams(
+        fun(Key, Stream, Acc) ->
+            case is_fully_acked(Comm1, Comm2, Stream) of
+                false ->
+                    [{Key, Stream} | Acc];
+                true ->
+                    Acc
+            end
+        end,
+        [],
+        S
+    ),
+    lists:sort(fun compare_streams/2, Streams).
+
+-spec find_new_streams(emqx_persistent_session_ds_state:t()) ->
+    [{emqx_persistent_session_ds_state:stream_key(), emqx_persistent_session_ds:stream_state()}].
+find_new_streams(S) ->
+    %% FIXME: this function is currently very sensitive to the
+    %% consistency of the packet IDs on both broker and client side.
+    %%
+    %% If the client fails to properly ack packets due to a bug, or a
+    %% network issue, or if the state of streams and seqno tables ever
+    %% become de-synced, then this function will return an empty list,
+    %% and the replay cannot progress.
+    %%
+    %% In other words, this function is not robust, and we should find
+    %% some way to get the replays un-stuck at the cost of potentially
+    %% losing messages during replay (or just kill the stuck channel
+    %% after timeout?)
+    Comm1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    Comm2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    shuffle(
+        emqx_persistent_session_ds_state:fold_streams(
+            fun(Key, Stream, Acc) ->
+                case is_fully_acked(Comm1, Comm2, Stream) of
+                    true ->
+                        [{Key, Stream} | Acc];
+                    false ->
+                        Acc
+                end
+            end,
+            [],
+            S
+        )
+    ).
+
+-spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
+renew_streams(S0) ->
+    S1 = remove_fully_replayed_streams(S0),
+    emqx_topic_gbt:fold(
+        fun(Key, _Subscription = #{start_time := StartTime, id := SubId}, S2) ->
+            TopicFilter = emqx_topic:words(emqx_trie_search:get_topic(Key)),
+            Streams = select_streams(
+                SubId,
+                emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
+                S2
+            ),
+            lists:foldl(
+                fun(I, Acc) ->
+                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc)
+                end,
+                S2,
+                Streams
+            )
+        end,
+        S1,
+        emqx_persistent_session_ds_state:get_subscriptions(S1)
+    ).
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
+    Key = {SubId, Stream},
+    case emqx_persistent_session_ds_state:get_stream(Key, S) of
+        undefined ->
+            {ok, Iterator} = emqx_ds:make_iterator(
+                ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
+            ),
+            NewStreamState = #ifs{
+                rank_x = RankX,
+                rank_y = RankY,
+                it_end = Iterator
+            },
+            emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
+        #ifs{} ->
+            S
+    end.
+
+select_streams(SubId, Streams0, S) ->
+    TopicStreamGroups = maps:groups_from_list(fun({{X, _}, _}) -> X end, Streams0),
+    maps:fold(
+        fun(RankX, Streams, Acc) ->
+            select_streams(SubId, RankX, Streams, S) ++ Acc
+        end,
+        [],
+        TopicStreamGroups
+    ).
+
+select_streams(SubId, RankX, Streams0, S) ->
+    %% 1. Find the streams with the rank Y greater than the recorded one:
+    Streams1 =
+        case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, S) of
+            undefined ->
+                Streams0;
+            ReplayedY ->
+                [I || I = {{_, Y}, _} <- Streams0, Y > ReplayedY]
+        end,
+    %% 2. Sort streams by rank Y:
+    Streams = lists:sort(
+        fun({{_, Y1}, _}, {{_, Y2}, _}) ->
+            Y1 =< Y2
+        end,
+        Streams1
+    ),
+    %% 3. Select streams with the least rank Y:
+    case Streams of
+        [] ->
+            [];
+        [{{_, MinRankY}, _} | _] ->
+            lists:takewhile(fun({{_, Y}, _}) -> Y =:= MinRankY end, Streams)
+    end.
+
+-spec remove_fully_replayed_streams(emqx_persistent_session_ds_state:t()) ->
+    emqx_persistent_session_ds_state:t().
+remove_fully_replayed_streams(S0) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
+    %% 1. For each subscription, find the X ranks that were fully replayed:
+    Groups = emqx_persistent_session_ds_state:fold_streams(
+        fun({SubId, _Stream}, StreamState = #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
+            Key = {SubId, RankX},
+            case
+                {maps:get(Key, Acc, undefined), is_fully_replayed(CommQos1, CommQos2, StreamState)}
+            of
+                {undefined, true} ->
+                    Acc#{Key => {true, RankY}};
+                {_, false} ->
+                    Acc#{Key => false};
+                _ ->
+                    Acc
+            end
+        end,
+        #{},
+        S0
+    ),
+    %% 2. Advance rank y for each fully replayed set of streams:
+    S1 = maps:fold(
+        fun
+            (Key, {true, RankY}, Acc) ->
+                emqx_persistent_session_ds_state:put_rank(Key, RankY, Acc);
+            (_, _, Acc) ->
+                Acc
+        end,
+        S0,
+        Groups
+    ),
+    %% 3. Remove the fully replayed streams:
+    emqx_persistent_session_ds_state:fold_streams(
+        fun(Key = {SubId, _Stream}, #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
+            case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
+                MinRankY when RankY < MinRankY ->
+                    emqx_persistent_session_ds_state:del_stream(Key, Acc);
+                _ ->
+                    Acc
+            end
+        end,
+        S1,
+        S1
+    ).
+
+compare_streams(
+    #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2},
+    #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}
+) ->
+    case A1 =:= B1 of
+        true ->
+            A2 =< B2;
+        false ->
+            A1 < B1
+    end.
+
+is_fully_replayed(Comm1, Comm2, S = #ifs{it_end = It}) ->
+    It =:= end_of_stream andalso is_fully_acked(Comm1, Comm2, S).
+
+is_fully_acked(Comm1, Comm2, #ifs{last_seqno_qos1 = S1, last_seqno_qos2 = S2}) ->
+    (Comm1 >= S1) andalso (Comm2 >= S2).
+
+-spec shuffle([A]) -> [A].
+shuffle(L0) ->
+    L1 = lists:map(
+        fun(A) ->
+            %% maybe topic/stream prioritization could be introduced here?
+            {rand:uniform(), A}
+        end,
+        L0
+    ),
+    L2 = lists:sort(L1),
+    {_, L} = lists:unzip(L2),
+    L.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 2c6f0e46f..03f513684 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -713,8 +713,8 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
 
     ct:pal("Msgs2 = ~p", [Msgs2]),
 
-    ?assert(NMsgs2 < NPubs, Msgs2),
-    ?assert(NMsgs2 > NPubs2, Msgs2),
+    ?assert(NMsgs2 =< NPubs, {NMsgs2, '=<', NPubs}),
+    ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
     ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
     NSame = NMsgs2 - NPubs2,
     ?assert(
@@ -782,9 +782,8 @@ t_publish_many_while_client_is_gone(Config) ->
     ClientOpts = [
         {proto_ver, v5},
         {clientid, ClientId},
-        %,
-        {properties, #{'Session-Expiry-Interval' => 30}}
-        %{auto_ack, never}
+        {properties, #{'Session-Expiry-Interval' => 30}},
+        {auto_ack, never}
         | Config
     ],
 
@@ -811,12 +810,12 @@ t_publish_many_while_client_is_gone(Config) ->
     Msgs1 = receive_messages(NPubs1),
     ct:pal("Msgs1 = ~p", [Msgs1]),
     NMsgs1 = length(Msgs1),
-    NPubs1 =:= NMsgs1 orelse
-        throw_with_debug_info({NPubs1, '==', NMsgs1}, ClientId),
+    ?assertEqual(NPubs1, NMsgs1, emqx_persistent_session_ds:print_session(ClientId)),
 
     ?assertEqual(
         get_topicwise_order(Pubs1),
-        get_topicwise_order(Msgs1)
+        get_topicwise_order(Msgs1),
+        emqx_persistent_session_ds:print_session(ClientId)
     ),
 
     %% PUBACK every QoS 1 message.
@@ -1088,14 +1087,6 @@ skip_ds_tc(Config) ->
     end.
 
 throw_with_debug_info(Error, ClientId) ->
-    Info =
-        case emqx_cm:lookup_channels(ClientId) of
-            [Pid] ->
-                #{channel := ChanState} = emqx_connection:get_state(Pid),
-                SessionState = emqx_channel:info(session_state, ChanState),
-                maps:update_with(s, fun emqx_persistent_session_ds_state:format/1, SessionState);
-            [] ->
-                no_channel
-        end,
+    Info = emqx_persistent_session_ds:print_session(ClientId),
     ct:pal("!!! Assertion failed: ~p~nState:~n~p", [Error, Info]),
     exit(Error).

From 1b4f69b44d1825dc9a8c62f24a05f2d44e344716 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 5 Jan 2024 14:02:53 +0100
Subject: [PATCH 080/273] refactor(sessds): Simplify data structure of ds_state
 pmap datatype

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 58 ++++++++---------
 apps/emqx/src/emqx_persistent_session_ds.hrl  |  6 +-
 .../src/emqx_persistent_session_ds_state.erl  | 65 +++++++------------
 ...persistent_session_ds_stream_scheduler.erl |  4 +-
 4 files changed, 58 insertions(+), 75 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index f334204cc..15f214e03 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -477,20 +477,13 @@ replay(ClientInfo, [], Session0 = #{s := S0}) ->
 
 -spec replay_batch(stream_state(), session(), clientinfo()) -> session().
 replay_batch(Ifs0, Session, ClientInfo) ->
-    #ifs{
-        batch_begin_key = BatchBeginMsgKey,
-        batch_size = BatchSize,
-        it_end = ItEnd
-    } = Ifs0,
-    %% TODO: retry
-    {ok, ItBegin} = emqx_ds:update_iterator(?PERSISTENT_MESSAGE_DB, ItEnd, BatchBeginMsgKey),
-    Ifs1 = Ifs0#ifs{it_end = ItBegin},
-    {Ifs, Inflight} = enqueue_batch(true, BatchSize, Ifs1, Session, ClientInfo),
+    #ifs{batch_size = BatchSize} = Ifs0,
+    %% TODO: retry on errors:
+    {Ifs, Inflight} = enqueue_batch(true, BatchSize, Ifs0, Session, ClientInfo),
     %% Assert:
-    Ifs =:= Ifs1 orelse
-        ?SLOG(warning, #{
-            msg => "replay_inconsistency",
-            expected => Ifs1,
+    Ifs =:= Ifs0 orelse
+        ?tp(warning, emqx_persistent_session_ds_replay_inconsistency, #{
+            expected => Ifs0,
             got => Ifs
         }),
     Session#{inflight => Inflight}.
@@ -645,7 +638,6 @@ new_batch({StreamKey, Ifs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
         first_seqno_qos1 = SN1,
         first_seqno_qos2 = SN2,
         batch_size = 0,
-        batch_begin_key = undefined,
         last_seqno_qos1 = SN1,
         last_seqno_qos2 = SN2
     },
@@ -657,10 +649,16 @@ new_batch({StreamKey, Ifs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
 
 enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, ClientInfo) ->
     #ifs{
-        it_end = It0,
+        it_begin = ItBegin,
+        it_end = ItEnd,
         first_seqno_qos1 = FirstSeqnoQos1,
         first_seqno_qos2 = FirstSeqnoQos2
     } = Ifs0,
+    It0 =
+        case IsReplay of
+            true -> ItBegin;
+            false -> ItEnd
+        end,
     case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
         {ok, It, []} ->
             %% No new messages; just update the end iterator:
@@ -668,13 +666,13 @@ enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, Cli
         {ok, end_of_stream} ->
             %% No new messages; just update the end iterator:
             {Ifs0#ifs{it_end = end_of_stream}, Inflight0};
-        {ok, It, [{BatchBeginMsgKey, _} | _] = Messages} ->
+        {ok, It, Messages} ->
             {Inflight, LastSeqnoQos1, LastSeqnoQos2} = process_batch(
                 IsReplay, Session, ClientInfo, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Inflight0
             ),
             Ifs = Ifs0#ifs{
+                it_begin = It0,
                 it_end = It,
-                batch_begin_key = BatchBeginMsgKey,
                 %% TODO: it should be possible to avoid calling
                 %% length here by diffing size of inflight before
                 %% and after inserting messages:
@@ -852,30 +850,30 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
     SeqNo = packet_id_to_seqno(PacketId, S),
     case Track of
         puback ->
-            Old = ?committed(?QOS_1),
-            Next = ?next(?QOS_1);
+            MinTrack = ?committed(?QOS_1),
+            MaxTrack = ?next(?QOS_1);
         pubrec ->
-            Old = ?dup(?QOS_2),
-            Next = ?next(?QOS_2);
+            MinTrack = ?dup(?QOS_2),
+            MaxTrack = ?next(?QOS_2);
         pubcomp ->
-            Old = ?committed(?QOS_2),
-            Next = ?next(?QOS_2)
+            MinTrack = ?committed(?QOS_2),
+            MaxTrack = ?next(?QOS_2)
     end,
-    NextSeqNo = emqx_persistent_session_ds_state:get_seqno(Next, S),
-    PrevSeqNo = emqx_persistent_session_ds_state:get_seqno(Old, S),
-    case PrevSeqNo =< SeqNo andalso SeqNo =< NextSeqNo of
+    Min = emqx_persistent_session_ds_state:get_seqno(MinTrack, S),
+    Max = emqx_persistent_session_ds_state:get_seqno(MaxTrack, S),
+    case Min =< SeqNo andalso SeqNo =< Max of
         true ->
             %% TODO: we pass a bogus message into the hook:
             Msg = emqx_message:make(SessionId, <<>>, <<>>),
-            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(Old, SeqNo, S)}};
+            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(MinTrack, SeqNo, S)}};
         false ->
             ?SLOG(warning, #{
                 msg => "out-of-order_commit",
                 track => Track,
                 packet_id => PacketId,
-                commit_seqno => SeqNo,
-                prev => PrevSeqNo,
-                next => NextSeqNo
+                seqno => SeqNo,
+                min => Min,
+                max => Max
             }),
             {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
     end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index e7500606b..d8556c8c9 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -42,16 +42,16 @@
 -define(dup(QOS), {1, QOS}).
 %% Last seqno assigned to some message (that may reside in the
 %% mqueue):
--define(next(QOS), {0, QOS}).
+-define(next(QOS), {2, QOS}).
 
 %%%%% State of the stream:
 -record(ifs, {
     rank_x :: emqx_ds:rank_x(),
     rank_y :: emqx_ds:rank_y(),
-    %% Iterator at the end of the last batch:
+    %% Iterator at the beginning and end of the last batch:
+    it_begin :: emqx_ds:iterator() | undefined,
     it_end :: emqx_ds:iterator() | end_of_stream,
     %% Key that points at the beginning of the batch:
-    batch_begin_key :: binary() | undefined,
     batch_size = 0 :: non_neg_integer(),
     %% Session sequence number at the time when the batch was fetched:
     first_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index cfe366e2e..8f7cb5ca0 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -66,14 +66,13 @@
 %% It's implemented as three maps: `clean', `dirty' and `tombstones'.
 %% Updates are made to the `dirty' area. `pmap_commit' function saves
 %% the updated entries to Mnesia and moves them to the `clean' area.
--record(pmap, {table, clean, dirty, tombstones}).
+-record(pmap, {table, cache, dirty}).
 
 -type pmap(K, V) ::
     #pmap{
         table :: atom(),
-        clean :: #{K => V},
-        dirty :: #{K => V},
-        tombstones :: #{K => _}
+        cache :: #{K => V},
+        dirty :: #{K => dirty | del}
     }.
 
 %% Session metadata:
@@ -409,70 +408,56 @@ pmap_open(Table, SessionId) ->
     Clean = maps:from_list(kv_bag_restore(Table, SessionId)),
     #pmap{
         table = Table,
-        clean = Clean,
-        dirty = #{},
-        tombstones = #{}
+        cache = Clean,
+        dirty = #{}
     }.
 
 -spec pmap_get(K, pmap(K, V)) -> V | undefined.
-pmap_get(K, #pmap{dirty = Dirty, clean = Clean}) ->
-    case Dirty of
-        #{K := V} ->
-            V;
-        _ ->
-            case Clean of
-                #{K := V} -> V;
-                _ -> undefined
-            end
-    end.
+pmap_get(K, #pmap{cache = Cache}) ->
+    maps:get(K, Cache, undefined).
 
 -spec pmap_put(K, V, pmap(K, V)) -> pmap(K, V).
-pmap_put(K, V, Pmap = #pmap{dirty = Dirty, clean = Clean, tombstones = Tombstones}) ->
+pmap_put(K, V, Pmap = #pmap{dirty = Dirty, cache = Cache}) ->
     Pmap#pmap{
-        dirty = maps:put(K, V, Dirty),
-        clean = maps:remove(K, Clean),
-        tombstones = maps:remove(K, Tombstones)
+        cache = maps:put(K, V, Cache),
+        dirty = Dirty#{K => dirty}
     }.
 
 -spec pmap_del(K, pmap(K, V)) -> pmap(K, V).
 pmap_del(
     Key,
-    Pmap = #pmap{dirty = Dirty, clean = Clean, tombstones = Tombstones}
+    Pmap = #pmap{dirty = Dirty, cache = Cache}
 ) ->
-    %% Update the caches:
     Pmap#pmap{
-        dirty = maps:remove(Key, Dirty),
-        clean = maps:remove(Key, Clean),
-        tombstones = Tombstones#{Key => del}
+        cache = maps:remove(Key, Cache),
+        dirty = Dirty#{Key => del}
     }.
 
 -spec pmap_fold(fun((K, V, A) -> A), A, pmap(K, V)) -> A.
-pmap_fold(Fun, Acc0, #pmap{clean = Clean, dirty = Dirty}) ->
-    Acc1 = maps:fold(Fun, Acc0, Dirty),
-    maps:fold(Fun, Acc1, Clean).
+pmap_fold(Fun, Acc, #pmap{cache = Cache}) ->
+    maps:fold(Fun, Acc, Cache).
 
 -spec pmap_commit(emqx_persistent_session_ds:id(), pmap(K, V)) -> pmap(K, V).
 pmap_commit(
-    SessionId, Pmap = #pmap{table = Tab, dirty = Dirty, clean = Clean, tombstones = Tombstones}
+    SessionId, Pmap = #pmap{table = Tab, dirty = Dirty, cache = Cache}
 ) ->
-    %% Commit deletions:
-    maps:foreach(fun(K, _) -> kv_bag_delete(Tab, SessionId, K) end, Tombstones),
-    %% Replace all records in the bag with the entries from the dirty area:
     maps:foreach(
-        fun(K, V) ->
-            kv_bag_persist(Tab, SessionId, K, V)
+        fun
+            (K, del) ->
+                kv_bag_delete(Tab, SessionId, K);
+            (K, dirty) ->
+                V = maps:get(K, Cache),
+                kv_bag_persist(Tab, SessionId, K, V)
         end,
         Dirty
     ),
     Pmap#pmap{
-        dirty = #{},
-        tombstones = #{},
-        clean = maps:merge(Clean, Dirty)
+        dirty = #{}
     }.
 
 -spec pmap_format(pmap(_K, _V)) -> map().
-pmap_format(#pmap{clean = Clean, dirty = Dirty}) ->
-    maps:merge(Clean, Dirty).
+pmap_format(#pmap{cache = Cache}) ->
+    Cache.
 
 %% Functions dealing with set tables:
 
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index d48d0af77..d572609e1 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -217,8 +217,8 @@ remove_fully_replayed_streams(S0) ->
     ).
 
 compare_streams(
-    #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2},
-    #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}
+    {_KeyA, #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2}},
+    {_KeyB, #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}}
 ) ->
     case A1 =:= B1 of
         true ->

From 978a3bfef37cd1e9b3438bff13e8836db2bb3643 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sat, 6 Jan 2024 04:33:10 +0100
Subject: [PATCH 081/273] refactor(sessds): Simplify representation of QoS
 tracks

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 12 +--
 apps/emqx/src/emqx_persistent_session_ds.hrl  | 18 +++--
 .../src/emqx_persistent_session_ds_state.erl  | 78 +++++++++----------
 ...persistent_session_ds_stream_scheduler.erl | 24 +++++-
 .../test/emqx_persistent_session_SUITE.erl    | 13 +++-
 5 files changed, 87 insertions(+), 58 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 15f214e03..145d6ccbf 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -290,7 +290,7 @@ subscribe(
             %% router and iterator information can be reconstructed
             %% from this table, if needed.
             ok = emqx_persistent_session_ds_router:do_add_route(TopicFilter, ID),
-            {SubId, S1} = emqx_persistent_session_ds_state:new_subid(S0),
+            {SubId, S1} = emqx_persistent_session_ds_state:new_id(S0),
             Subscription = #{
                 start_time => now_ms(),
                 props => SubOpts,
@@ -314,10 +314,10 @@ unsubscribe(
     TopicFilter,
     Session = #{id := ID, s := S0}
 ) ->
-    %% TODO: drop streams and messages from the buffer
     case subs_lookup(TopicFilter, S0) of
-        #{props := SubOpts, id := _SubId} ->
-            S = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
+        #{props := SubOpts, id := SubId} ->
+            S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
+            S = emqx_persistent_session_ds_stream_scheduler:del_subscription(SubId, S1),
             ?tp_span(
                 persistent_session_ds_subscription_route_delete,
                 #{session_id => ID},
@@ -662,11 +662,13 @@ enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, Cli
     case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
         {ok, It, []} ->
             %% No new messages; just update the end iterator:
+            logger:warning(#{msg => "batch_empty"}),
             {Ifs0#ifs{it_end = It}, Inflight0};
         {ok, end_of_stream} ->
             %% No new messages; just update the end iterator:
             {Ifs0#ifs{it_end = end_of_stream}, Inflight0};
-        {ok, It, Messages} ->
+        {ok, It, [{K, _} | _] = Messages} ->
+            logger:warning(#{msg => "batch", it => K, msgs => length(Messages)}),
             {Inflight, LastSeqnoQos1, LastSeqnoQos2} = process_batch(
                 IsReplay, Session, ClientInfo, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Inflight0
             ),
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index d8556c8c9..43e8b1cf8 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -34,15 +34,19 @@
 
 %% Seqno becomes committed after receiving PUBACK for QoS1 or PUBCOMP
 %% for QoS2.
--define(committed(QOS), {0, QOS}).
+-define(committed(QOS), QOS).
 %% Seqno becomes dup:
 %%
-%% 1. After broker sends QoS1 message to the client
-%% 2. After it receives PUBREC from the client for the QoS2 message
--define(dup(QOS), {1, QOS}).
-%% Last seqno assigned to some message (that may reside in the
-%% mqueue):
--define(next(QOS), {2, QOS}).
+%% 1. After broker sends QoS1 message to the client. Upon session
+%% reconnect, QoS1 messages with seqno in the committed..dup range are
+%% retransmitted with DUP flag.
+%%
+%% 2. After it receives PUBREC from the client for the QoS2 message.
+%% Upon session reconnect, PUBREL for QoS2 messages with seqno in
+%% committed..dup are retransmitted.
+-define(dup(QOS), (10 + QOS)).
+%% Last seqno assigned to a message.
+-define(next(QOS), (20 + QOS)).
 
 %%%%% State of the stream:
 -record(ifs, {
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 8f7cb5ca0..a1147aec5 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -30,7 +30,7 @@
 -export([get_created_at/1, set_created_at/2]).
 -export([get_last_alive_at/1, set_last_alive_at/2]).
 -export([get_conninfo/1, set_conninfo/2]).
--export([new_subid/1]).
+-export([new_id/1]).
 -export([get_stream/2, put_stream/3, del_stream/2, fold_streams/3]).
 -export([get_seqno/2, put_seqno/3]).
 -export([get_rank/2, put_rank/3, del_rank/2, fold_ranks/3]).
@@ -43,6 +43,7 @@
 
 -include("emqx_mqtt.hrl").
 -include("emqx_persistent_session_ds.hrl").
+-include_lib("snabbkaffe/include/trace.hrl").
 
 %%================================================================================
 %% Type declarations
@@ -79,14 +80,15 @@
 -define(created_at, created_at).
 -define(last_alive_at, last_alive_at).
 -define(conninfo, conninfo).
--define(last_subid, last_subid).
+%% Unique integer used to create unique identities
+-define(last_id, last_id).
 
 -type metadata() ::
     #{
         ?created_at => emqx_persistent_session_ds:timestamp(),
         ?last_alive_at => emqx_persistent_session_ds:timestamp(),
         ?conninfo => emqx_types:conninfo(),
-        ?last_subid => integer()
+        ?last_id => integer()
     }.
 
 -type seqno_type() ::
@@ -112,7 +114,7 @@
 -define(stream_tab, emqx_ds_session_streams).
 -define(seqno_tab, emqx_ds_session_seqnos).
 -define(rank_tab, emqx_ds_session_ranks).
--define(bag_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
+-define(pmap_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
 
 %%================================================================================
 %% API funcions
@@ -130,8 +132,8 @@ create_tables() ->
             {attributes, record_info(fields, kv)}
         ]
     ),
-    [create_kv_bag_table(Table) || Table <- ?bag_tables],
-    mria:wait_for_tables([?session_tab | ?bag_tables]).
+    [create_kv_pmap_table(Table) || Table <- ?pmap_tables],
+    mria:wait_for_tables([?session_tab | ?pmap_tables]).
 
 -spec open(emqx_persistent_session_ds:id()) -> {ok, t()} | undefined.
 open(SessionId) ->
@@ -191,7 +193,7 @@ list_sessions() ->
 delete(Id) ->
     transaction(
         fun() ->
-            [kv_delete(Table, Id) || Table <- ?bag_tables],
+            [kv_pmap_delete(Table, Id) || Table <- ?pmap_tables],
             mnesia:delete(?session_tab, Id, write)
         end
     ).
@@ -259,14 +261,14 @@ get_conninfo(Rec) ->
 set_conninfo(Val, Rec) ->
     set_meta(?conninfo, Val, Rec).
 
--spec new_subid(t()) -> {emqx_persistent_session_ds:subscription_id(), t()}.
-new_subid(Rec) ->
-    LastSubId =
-        case get_meta(?last_subid, Rec) of
+-spec new_id(t()) -> {emqx_persistent_session_ds:subscription_id(), t()}.
+new_id(Rec) ->
+    LastId =
+        case get_meta(?last_id, Rec) of
             undefined -> 0;
             N when is_integer(N) -> N
         end,
-    {LastSubId, set_meta(?last_subid, LastSubId + 1, Rec)}.
+    {LastId, set_meta(?last_id, LastId + 1, Rec)}.
 
 %%
 
@@ -283,7 +285,7 @@ get_subscriptions(#{subscriptions := Subs}) ->
 put_subscription(TopicFilter, SubId, Subscription, Rec = #{id := Id, subscriptions := Subs0}) ->
     %% Note: currently changes to the subscriptions are persisted immediately.
     Key = {TopicFilter, SubId},
-    transaction(fun() -> kv_bag_persist(?subscription_tab, Id, Key, Subscription) end),
+    transaction(fun() -> kv_pmap_persist(?subscription_tab, Id, Key, Subscription) end),
     Subs = emqx_topic_gbt:insert(TopicFilter, SubId, Subscription, Subs0),
     Rec#{subscriptions => Subs}.
 
@@ -291,13 +293,13 @@ put_subscription(TopicFilter, SubId, Subscription, Rec = #{id := Id, subscriptio
 del_subscription(TopicFilter, SubId, Rec = #{id := Id, subscriptions := Subs0}) ->
     %% Note: currently the subscriptions are persisted immediately.
     Key = {TopicFilter, SubId},
-    transaction(fun() -> kv_bag_delete(?subscription_tab, Id, Key) end),
+    transaction(fun() -> kv_pmap_delete(?subscription_tab, Id, Key) end),
     Subs = emqx_topic_gbt:delete(TopicFilter, SubId, Subs0),
     Rec#{subscriptions => Subs}.
 
 %%
 
--type stream_key() :: {emqx_persistent_session_ds:subscription_id(), emqx_ds:stream()}.
+-type stream_key() :: {emqx_persistent_session_ds:subscription_id(), binary()}.
 
 -spec get_stream(stream_key(), t()) ->
     emqx_persistent_session_ds:stream_state() | undefined.
@@ -390,7 +392,7 @@ gen_del(Field, Key, Rec) ->
 %%
 
 read_subscriptions(SessionId) ->
-    Records = kv_bag_restore(?subscription_tab, SessionId),
+    Records = kv_pmap_restore(?subscription_tab, SessionId),
     lists:foldl(
         fun({{TopicFilter, SubId}, Subscription}, Acc) ->
             emqx_topic_gbt:insert(TopicFilter, SubId, Subscription, Acc)
@@ -405,7 +407,7 @@ read_subscriptions(SessionId) ->
 %% This functtion should be ran in a transaction.
 -spec pmap_open(atom(), emqx_persistent_session_ds:id()) -> pmap(_K, _V).
 pmap_open(Table, SessionId) ->
-    Clean = maps:from_list(kv_bag_restore(Table, SessionId)),
+    Clean = maps:from_list(kv_pmap_restore(Table, SessionId)),
     #pmap{
         table = Table,
         cache = Clean,
@@ -444,10 +446,10 @@ pmap_commit(
     maps:foreach(
         fun
             (K, del) ->
-                kv_bag_delete(Tab, SessionId, K);
+                kv_pmap_delete(Tab, SessionId, K);
             (K, dirty) ->
                 V = maps:get(K, Cache),
-                kv_bag_persist(Tab, SessionId, K, V)
+                kv_pmap_persist(Tab, SessionId, K, V)
         end,
         Dirty
     ),
@@ -465,47 +467,43 @@ kv_persist(Tab, SessionId, Val0) ->
     Val = encoder(encode, Tab, Val0),
     mnesia:write(Tab, #kv{k = SessionId, v = Val}, write).
 
-kv_delete(Table, Namespace) ->
-    mnesia:delete({Table, Namespace}).
-
 kv_restore(Tab, SessionId) ->
     [encoder(decode, Tab, V) || #kv{v = V} <- mnesia:read(Tab, SessionId)].
 
 %% Functions dealing with bags:
 
 %% @doc Create a mnesia table for the PMAP:
--spec create_kv_bag_table(atom()) -> ok.
-create_kv_bag_table(Table) ->
+-spec create_kv_pmap_table(atom()) -> ok.
+create_kv_pmap_table(Table) ->
     mria:create_table(Table, [
-        {type, bag},
+        {type, ordered_set},
         {rlog_shard, ?DS_MRIA_SHARD},
         {storage, rocksdb_copies},
         {record_name, kv},
         {attributes, record_info(fields, kv)}
     ]).
 
-kv_bag_persist(Tab, SessionId, Key, Val0) ->
-    %% Remove the previous entry corresponding to the key:
-    kv_bag_delete(Tab, SessionId, Key),
+kv_pmap_persist(Tab, SessionId, Key, Val0) ->
     %% Write data to mnesia:
     Val = encoder(encode, Tab, Val0),
-    mnesia:write(Tab, #kv{k = SessionId, v = {Key, Val}}, write).
+    mnesia:write(Tab, #kv{k = {SessionId, Key}, v = Val}, write).
 
-kv_bag_restore(Tab, SessionId) ->
-    [{K, encoder(decode, Tab, V)} || #kv{v = {K, V}} <- mnesia:read(Tab, SessionId)].
+kv_pmap_restore(Table, SessionId) ->
+    MS = [{#kv{k = {SessionId, '_'}, _ = '_'}, [], ['$_']}],
+    Objs = mnesia:select(Table, MS, read),
+    [{K, encoder(decode, Table, V)} || #kv{k = {_, K}, v = V} <- Objs].
 
-kv_bag_delete(Table, SessionId, Key) ->
+kv_pmap_delete(Table, SessionId) ->
+    MS = [{#kv{k = {SessionId, '$1'}, _ = '_'}, [], ['$1']}],
+    Keys = mnesia:select(Table, MS, read),
+    [mnesia:delete(Table, {SessionId, K}, write) || K <- Keys],
+    ok.
+
+kv_pmap_delete(Table, SessionId, Key) ->
     %% Note: this match spec uses a fixed primary key, so it doesn't
     %% require a table scan, and the transaction doesn't grab the
     %% whole table lock:
-    MS = [{#kv{k = SessionId, v = {Key, '_'}}, [], ['$_']}],
-    Objs = mnesia:select(Table, MS, write),
-    lists:foreach(
-        fun(Obj) ->
-            mnesia:delete_object(Table, Obj, write)
-        end,
-        Objs
-    ).
+    mnesia:delete(Table, {SessionId, Key}, write).
 
 %%
 
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index d572609e1..091b815d4 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -17,7 +17,7 @@
 
 %% API:
 -export([find_new_streams/1, find_replay_streams/1]).
--export([renew_streams/1]).
+-export([renew_streams/1, del_subscription/2]).
 
 %% behavior callbacks:
 -export([]).
@@ -113,12 +113,31 @@ renew_streams(S0) ->
         emqx_persistent_session_ds_state:get_subscriptions(S1)
     ).
 
+-spec del_subscription(
+    emqx_persistent_session_ds:subscription_id(), emqx_persistent_session_ds_state:t()
+) ->
+    emqx_persistent_session_ds_state:t().
+del_subscription(SubId, S0) ->
+    emqx_persistent_session_ds_state:fold_streams(
+        fun(Key, _, Acc) ->
+            case Key of
+                {SubId, _Stream} ->
+                    emqx_persistent_session_ds_state:del_stream(Key, Acc);
+                _ ->
+                    Acc
+            end
+        end,
+        S0,
+        S0
+    ).
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
 
 ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
-    Key = {SubId, Stream},
+    %% TODO: use next_id to enumerate streams
+    Key = {SubId, term_to_binary(Stream)},
     case emqx_persistent_session_ds_state:get_stream(Key, S) of
         undefined ->
             {ok, Iterator} = emqx_ds:make_iterator(
@@ -127,6 +146,7 @@ ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
             NewStreamState = #ifs{
                 rank_x = RankX,
                 rank_y = RankY,
+                it_begin = Iterator,
                 it_end = Iterator
             },
             emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 03f513684..3b9cb33cb 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -54,7 +54,8 @@ all() ->
 groups() ->
     TCs = emqx_common_test_helpers:all(?MODULE),
     TCsNonGeneric = [t_choose_impl],
-    TCGroups = [{group, tcp}, {group, quic}, {group, ws}],
+    % {group, quic}, {group, ws}],
+    TCGroups = [{group, tcp}],
     [
         %% {persistence_disabled, TCGroups},
         {persistence_enabled, TCGroups},
@@ -694,6 +695,9 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     ok = publish_many(Pubs2),
     NPubs2 = length(Pubs2),
 
+    _ = receive_messages(NPubs1, 2000),
+    [] = receive_messages(NPubs1, 2000),
+    debug_info(ClientId),
     {ok, Client2} = emqtt:start_link([
         {proto_ver, v5},
         {clientid, ClientId},
@@ -702,12 +706,14 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
         {auto_ack, false}
         | Config
     ]),
+
     {ok, _} = emqtt:ConnFun(Client2),
 
     %% Try to receive _at most_ `NPubs` messages.
     %% There shouldn't be that much unacked messages in the replay anyway,
     %% but it's an easy number to pick.
     NPubs = NPubs1 + NPubs2,
+
     Msgs2 = receive_messages(NPubs, _Timeout = 2000),
     NMsgs2 = length(Msgs2),
 
@@ -1086,7 +1092,6 @@ skip_ds_tc(Config) ->
             Config
     end.
 
-throw_with_debug_info(Error, ClientId) ->
+debug_info(ClientId) ->
     Info = emqx_persistent_session_ds:print_session(ClientId),
-    ct:pal("!!! Assertion failed: ~p~nState:~n~p", [Error, Info]),
-    exit(Error).
+    ct:pal("*** State:~n~p", [Info]).

From cff6c15e13dd12c2f8e0f3b6d404b7ba4dabd574 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sun, 7 Jan 2024 22:50:18 +0100
Subject: [PATCH 082/273] fix(sessds): Store the QoS as the MSB of the packet
 ID

---
 .../emqx_persistent_session_ds_SUITE.erl      |  17 +--
 apps/emqx/src/emqx_persistent_session_ds.erl  | 139 +++++++++++++-----
 apps/emqx/src/emqx_persistent_session_ds.hrl  |  16 +-
 .../emqx_persistent_session_ds_gc_worker.erl  |  63 ++------
 .../src/emqx_persistent_session_ds_state.erl  |  95 +++++++++---
 ...persistent_session_ds_stream_scheduler.erl |  16 +-
 .../test/emqx_persistent_messages_SUITE.erl   |   5 -
 .../test/emqx_persistent_session_SUITE.erl    |   9 +-
 8 files changed, 224 insertions(+), 136 deletions(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index fba36601f..f806a57fc 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -409,27 +409,26 @@ do_t_session_discard(Params) ->
             ?retry(
                 _Sleep0 = 100,
                 _Attempts0 = 50,
-                true = map_size(emqx_persistent_session_ds:list_all_streams()) > 0
+                #{} = emqx_persistent_session_ds_state:print_session(ClientId)
             ),
             ok = emqtt:stop(Client0),
             ?tp(notice, "disconnected", #{}),
 
             ?tp(notice, "reconnecting", #{}),
-            %% we still have streams
-            ?assert(map_size(emqx_persistent_session_ds:list_all_streams()) > 0),
+            %% we still have the session:
+            ?assertMatch(#{}, emqx_persistent_session_ds_state:print_session(ClientId)),
             Client1 = start_client(ReconnectOpts),
             {ok, _} = emqtt:connect(Client1),
             ?assertEqual([], emqtt:subscriptions(Client1)),
             case is_persistent_connect_opts(ReconnectOpts) of
                 true ->
-                    ?assertMatch(#{ClientId := _}, emqx_persistent_session_ds:list_all_sessions());
+                    ?assertMatch(#{}, emqx_persistent_session_ds_state:print_session(ClientId));
                 false ->
-                    ?assertEqual(#{}, emqx_persistent_session_ds:list_all_sessions())
+                    ?assertEqual(
+                        undefined, emqx_persistent_session_ds_state:print_session(ClientId)
+                    )
             end,
-            ?assertEqual(#{}, emqx_persistent_session_ds:list_all_subscriptions()),
             ?assertEqual([], emqx_persistent_session_ds_router:topics()),
-            ?assertEqual(#{}, emqx_persistent_session_ds:list_all_streams()),
-            ?assertEqual(#{}, emqx_persistent_session_ds:list_all_pubranges()),
             ok = emqtt:stop(Client1),
             ?tp(notice, "disconnected", #{}),
 
@@ -486,7 +485,7 @@ do_t_session_expiration(_Config, Opts) ->
             Client0 = start_client(Params0),
             {ok, _} = emqtt:connect(Client0),
             {ok, _, [?RC_GRANTED_QOS_2]} = emqtt:subscribe(Client0, Topic, ?QOS_2),
-            Subs0 = emqx_persistent_session_ds:list_all_subscriptions(),
+            #{subscriptions := Subs0} = emqx_persistent_session_ds:print_session(ClientId),
             ?assertEqual(1, map_size(Subs0), #{subs => Subs0}),
             Info0 = maps:from_list(emqtt:info(Client0)),
             ?assertEqual(0, maps:get(session_present, Info0), #{info => Info0}),
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 145d6ccbf..b26a4e983 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -67,7 +67,7 @@
 ]).
 
 %% session table operations
--export([create_tables/0]).
+-export([create_tables/0, sync/1]).
 
 %% internal export used by session GC process
 -export([destroy_session/1]).
@@ -133,6 +133,11 @@
     timer() => reference()
 }.
 
+-record(req_sync, {
+    from :: pid(),
+    ref :: reference()
+}).
+
 -type stream_state() :: #ifs{}.
 
 -type timestamp() :: emqx_utils_calendar:epoch_millisecond().
@@ -147,7 +152,8 @@
     inflight_cnt,
     inflight_max,
     mqueue_len,
-    mqueue_dropped
+    mqueue_dropped,
+    awaiting_rel_cnt
 ]).
 
 %%
@@ -227,8 +233,8 @@ info(mqueue_dropped, _Session) ->
 %%     PacketId;
 % info(awaiting_rel, #sessmem{awaiting_rel = AwaitingRel}) ->
 %     AwaitingRel;
-% info(awaiting_rel_cnt, #sessmem{awaiting_rel = AwaitingRel}) ->
-%     maps:size(AwaitingRel);
+info(awaiting_rel_cnt, #{s := S}) ->
+    seqno_diff(?QOS_2, ?dup(?QOS_2), ?committed(?QOS_2), S);
 info(awaiting_rel_max, #{props := Conf}) ->
     maps:get(max_awaiting_rel, Conf);
 info(await_rel_timeout, #{props := Conf}) ->
@@ -447,6 +453,10 @@ handle_timeout(_ClientInfo, ?TIMER_BUMP_LAST_ALIVE_AT, Session0 = #{s := S0}) ->
         Session0#{s => S}
     ),
     {ok, [], Session};
+handle_timeout(_ClientInfo, #req_sync{from = From, ref = Ref}, Session = #{s := S0}) ->
+    S = emqx_persistent_session_ds_state:commit(S0),
+    From ! Ref,
+    {ok, [], Session#{s => S}};
 handle_timeout(_ClientInfo, expire_awaiting_rel, Session) ->
     %% TODO: stub
     {ok, [], Session}.
@@ -508,6 +518,22 @@ terminate(_Reason, _Session = #{s := S}) ->
 create_tables() ->
     emqx_persistent_session_ds_state:create_tables().
 
+%% @doc Force syncing of the transient state to persistent storage
+sync(ClientId) ->
+    case emqx_cm:lookup_channels(ClientId) of
+        [Pid] ->
+            Ref = monitor(process, Pid),
+            Pid ! {emqx_session, #req_sync{from = self(), ref = Ref}},
+            receive
+                {'DOWN', Ref, process, _Pid, Reason} ->
+                    {error, Reason};
+                Ref ->
+                    ok
+            end;
+        [] ->
+            {error, noproc}
+    end.
+
 -define(IS_EXPIRED(NOW_MS, LAST_ALIVE_AT, EI),
     (is_number(LAST_ALIVE_AT) andalso
         is_number(EI) andalso
@@ -615,7 +641,6 @@ do_ensure_all_iterators_closed(_DSSessionID) ->
 
 fetch_new_messages(Session = #{s := S}, ClientInfo) ->
     Streams = emqx_persistent_session_ds_stream_scheduler:find_new_streams(S),
-    ?SLOG(debug, #{msg => "fill_buffer", streams => Streams}),
     fetch_new_messages(Streams, Session, ClientInfo).
 
 fetch_new_messages([], Session, _ClientInfo) ->
@@ -649,32 +674,24 @@ new_batch({StreamKey, Ifs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
 
 enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, ClientInfo) ->
     #ifs{
-        it_begin = ItBegin,
-        it_end = ItEnd,
+        it_begin = ItBegin0,
+        it_end = ItEnd0,
         first_seqno_qos1 = FirstSeqnoQos1,
         first_seqno_qos2 = FirstSeqnoQos2
     } = Ifs0,
-    It0 =
+    ItBegin =
         case IsReplay of
-            true -> ItBegin;
-            false -> ItEnd
+            true -> ItBegin0;
+            false -> ItEnd0
         end,
-    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, It0, BatchSize) of
-        {ok, It, []} ->
-            %% No new messages; just update the end iterator:
-            logger:warning(#{msg => "batch_empty"}),
-            {Ifs0#ifs{it_end = It}, Inflight0};
-        {ok, end_of_stream} ->
-            %% No new messages; just update the end iterator:
-            {Ifs0#ifs{it_end = end_of_stream}, Inflight0};
-        {ok, It, [{K, _} | _] = Messages} ->
-            logger:warning(#{msg => "batch", it => K, msgs => length(Messages)}),
+    case emqx_ds:next(?PERSISTENT_MESSAGE_DB, ItBegin, BatchSize) of
+        {ok, ItEnd, Messages} ->
             {Inflight, LastSeqnoQos1, LastSeqnoQos2} = process_batch(
                 IsReplay, Session, ClientInfo, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Inflight0
             ),
             Ifs = Ifs0#ifs{
-                it_begin = It0,
-                it_end = It,
+                it_begin = ItBegin,
+                it_end = ItEnd,
                 %% TODO: it should be possible to avoid calling
                 %% length here by diffing size of inflight before
                 %% and after inserting messages:
@@ -683,11 +700,17 @@ enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, Cli
                 last_seqno_qos2 = LastSeqnoQos2
             },
             {Ifs, Inflight};
+        {ok, end_of_stream} ->
+            %% No new messages; just update the end iterator:
+            {Ifs0#ifs{it_begin = ItBegin, it_end = end_of_stream, batch_size = 0}, Inflight0};
         {error, _} when not IsReplay ->
-            ?SLOG(debug, #{msg => "failed_to_fetch_batch", iterator => It0}),
+            ?SLOG(info, #{msg => "failed_to_fetch_batch", iterator => ItBegin}),
             {Ifs0, Inflight0}
     end.
 
+%% key_of_iter(#{3 := #{3 := #{5 := K}}}) ->
+%%     K.
+
 process_batch(_IsReplay, _Session, _ClientInfo, LastSeqNoQos1, LastSeqNoQos2, [], Inflight) ->
     {Inflight, LastSeqNoQos1, LastSeqNoQos2};
 process_batch(
@@ -885,6 +908,9 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
 %% generation
 %% --------------------------------------------------------------------
 
+-define(EPOCH_BITS, 15).
+-define(PACKET_ID_MASK, 2#111_1111_1111_1111).
+
 %% Epoch size = `16#10000 div 2' since we generate different sets of
 %% packet IDs for QoS1 and QoS2:
 -define(EPOCH_SIZE, 16#8000).
@@ -895,8 +921,8 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
     seqno().
 packet_id_to_seqno(PacketId, S) ->
     NextSeqNo = emqx_persistent_session_ds_state:get_seqno(?next(packet_id_to_qos(PacketId)), S),
-    Epoch = NextSeqNo bsr 15,
-    SeqNo = (Epoch bsl 15) + (PacketId bsr 1),
+    Epoch = NextSeqNo bsr ?EPOCH_BITS,
+    SeqNo = (Epoch bsl ?EPOCH_BITS) + (PacketId band ?PACKET_ID_MASK),
     case SeqNo =< NextSeqNo of
         true ->
             SeqNo;
@@ -920,15 +946,31 @@ inc_seqno(Qos, SeqNo) ->
 %% Note: we use the least significant bit to store the QoS. Even
 %% packet IDs are QoS1, odd packet IDs are QoS2.
 seqno_to_packet_id(?QOS_1, SeqNo) ->
-    (SeqNo bsl 1) band 16#ffff;
+    SeqNo band ?PACKET_ID_MASK;
 seqno_to_packet_id(?QOS_2, SeqNo) ->
-    ((SeqNo bsl 1) band 16#ffff) bor 1.
+    SeqNo band ?PACKET_ID_MASK bor ?EPOCH_SIZE.
 
 packet_id_to_qos(PacketId) ->
-    case PacketId band 1 of
-        0 -> ?QOS_1;
-        1 -> ?QOS_2
-    end.
+    PacketId bsr ?EPOCH_BITS + 1.
+
+seqno_diff(Qos, A, B, S) ->
+    seqno_diff(
+        Qos,
+        emqx_persistent_session_ds_state:get_seqno(A, S),
+        emqx_persistent_session_ds_state:get_seqno(B, S)
+    ).
+
+%% Dialyzer complains about the second clause, since it's currently
+%% unused, shut it up:
+-dialyzer({nowarn_function, seqno_diff/3}).
+seqno_diff(?QOS_1, A, B) ->
+    %% For QoS1 messages we skip a seqno every time the epoch changes,
+    %% we need to substract that from the diff:
+    EpochA = A bsr ?EPOCH_BITS,
+    EpochB = B bsr ?EPOCH_BITS,
+    A - B - (EpochA - EpochB);
+seqno_diff(?QOS_2, A, B) ->
+    A - B.
 
 %%--------------------------------------------------------------------
 %% Tests
@@ -942,7 +984,7 @@ packet_id_to_qos(PacketId) ->
 list_all_sessions() ->
     maps:from_list(
         [
-            {Id, emqx_persistent_session_ds_state:print_session(Id)}
+            {Id, print_session(Id)}
          || Id <- emqx_persistent_session_ds_state:list_sessions()
         ]
     ).
@@ -961,7 +1003,7 @@ seqno_gen(NextSeqNo) ->
 next_seqno_gen() ->
     ?LET(
         {Epoch, Offset},
-        {non_neg_integer(), non_neg_integer()},
+        {non_neg_integer(), range(0, ?EPOCH_SIZE)},
         Epoch bsl 15 + Offset
     ).
 
@@ -995,6 +1037,7 @@ inc_seqno_prop() ->
             PacketId = seqno_to_packet_id(Qos, NewSeqNo),
             ?WHENFAIL(
                 begin
+                    io:format(user, " *** QoS = ~p~n", [Qos]),
                     io:format(user, " *** SeqNo = ~p -> ~p~n", [SeqNo, NewSeqNo]),
                     io:format(user, " *** PacketId = ~p~n", [PacketId])
                 end,
@@ -1003,9 +1046,30 @@ inc_seqno_prop() ->
         end
     ).
 
+seqno_diff_prop() ->
+    ?FORALL(
+        {Qos, SeqNo, N},
+        {oneof([?QOS_1, ?QOS_2]), next_seqno_gen(), range(0, 100)},
+        ?IMPLIES(
+            seqno_to_packet_id(Qos, SeqNo) > 0,
+            begin
+                NewSeqNo = apply_n_times(N, fun(A) -> inc_seqno(Qos, A) end, SeqNo),
+                Diff = seqno_diff(Qos, NewSeqNo, SeqNo),
+                ?WHENFAIL(
+                    begin
+                        io:format(user, " *** QoS = ~p~n", [Qos]),
+                        io:format(user, " *** SeqNo = ~p -> ~p~n", [SeqNo, NewSeqNo]),
+                        io:format(user, " *** N : ~p == ~p~n", [N, Diff])
+                    end,
+                    N =:= Diff
+                )
+            end
+        )
+    ).
+
 seqno_proper_test_() ->
-    Props = [packet_id_to_seqno_prop(), inc_seqno_prop()],
-    Opts = [{numtests, 10000}, {to_file, user}],
+    Props = [packet_id_to_seqno_prop(), inc_seqno_prop(), seqno_diff_prop()],
+    Opts = [{numtests, 1000}, {to_file, user}],
     {timeout, 30,
         {setup,
             fun() ->
@@ -1019,4 +1083,9 @@ seqno_proper_test_() ->
             end,
             [?_assert(proper:quickcheck(Prop, Opts)) || Prop <- Props]}}.
 
+apply_n_times(0, Fun, A) ->
+    A;
+apply_n_times(N, Fun, A) when N > 0 ->
+    apply_n_times(N - 1, Fun, Fun(A)).
+
 -endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 43e8b1cf8..2d47052ca 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -42,8 +42,8 @@
 %% retransmitted with DUP flag.
 %%
 %% 2. After it receives PUBREC from the client for the QoS2 message.
-%% Upon session reconnect, PUBREL for QoS2 messages with seqno in
-%% committed..dup are retransmitted.
+%% Upon session reconnect, PUBREL messages for QoS2 messages with
+%% seqno in committed..dup are retransmitted.
 -define(dup(QOS), (10 + QOS)).
 %% Last seqno assigned to a message.
 -define(next(QOS), (20 + QOS)).
@@ -65,16 +65,4 @@
     last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno()
 }).
 
-%% TODO: remove
--record(session, {
-    %% same as clientid
-    id :: emqx_persistent_session_ds:id(),
-    %% creation time
-    created_at :: _Millisecond :: non_neg_integer(),
-    last_alive_at :: _Millisecond :: non_neg_integer(),
-    conninfo :: emqx_types:conninfo(),
-    %% for future usage
-    props = #{} :: map()
-}).
-
 -endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
index af387d2ca..46e170492 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -104,58 +104,27 @@ now_ms() ->
     erlang:system_time(millisecond).
 
 start_gc() ->
-    do_gc(more).
-
-zombie_session_ms() ->
-    NowMS = now_ms(),
     GCInterval = emqx_config:get([session_persistence, session_gc_interval]),
     BumpInterval = emqx_config:get([session_persistence, last_alive_update_interval]),
     TimeThreshold = max(GCInterval, BumpInterval) * 3,
-    ets:fun2ms(
-        fun(
-            #session{
-                id = DSSessionId,
-                last_alive_at = LastAliveAt,
-                conninfo = #{expiry_interval := EI}
-            }
-        ) when
-            LastAliveAt + EI + TimeThreshold =< NowMS
-        ->
-            DSSessionId
-        end
-    ).
+    MinLastAlive = now_ms() - TimeThreshold,
+    gc_loop(MinLastAlive, emqx_persistent_session_ds_state:make_session_iterator()).
 
-do_gc(more) ->
+gc_loop(MinLastAlive, It0) ->
     GCBatchSize = emqx_config:get([session_persistence, session_gc_batch_size]),
-    MS = zombie_session_ms(),
-    {atomic, Next} = mria:transaction(?DS_MRIA_SHARD, fun() ->
-        Res = mnesia:select(?SESSION_TAB, MS, GCBatchSize, write),
-        case Res of
-            '$end_of_table' ->
-                done;
-            {[], Cont} ->
-                %% since `GCBatchsize' is just a "recommendation" for `select', we try only
-                %% _once_ the continuation and then stop if it yields nothing, to avoid a
-                %% dead loop.
-                case mnesia:select(Cont) of
-                    '$end_of_table' ->
-                        done;
-                    {[], _Cont} ->
-                        done;
-                    {DSSessionIds0, _Cont} ->
-                        do_gc_(DSSessionIds0),
-                        more
-                end;
-            {DSSessionIds0, _Cont} ->
-                do_gc_(DSSessionIds0),
-                more
-        end
-    end),
-    do_gc(Next);
-do_gc(done) ->
-    ok.
+    case emqx_persistent_session_ds_state:session_iterator_next(It0, GCBatchSize) of
+        {[], _} ->
+            ok;
+        {Sessions, It} ->
+            do_gc([
+                Key
+             || {Key, #{last_alive_at := LastAliveAt}} <- Sessions,
+                LastAliveAt < MinLastAlive
+            ]),
+            gc_loop(MinLastAlive, It)
+    end.
 
-do_gc_(DSSessionIds) ->
+do_gc(DSSessionIds) ->
     lists:foreach(fun emqx_persistent_session_ds:destroy_session/1, DSSessionIds),
     ?tp(ds_session_gc_cleaned, #{session_ids => DSSessionIds}),
     ok.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index a1147aec5..504e9649c 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -36,14 +36,16 @@
 -export([get_rank/2, put_rank/3, del_rank/2, fold_ranks/3]).
 -export([get_subscriptions/1, put_subscription/4, del_subscription/3]).
 
-%% internal exports:
--export([]).
+-export([make_session_iterator/0, session_iterator_next/2]).
 
--export_type([t/0, subscriptions/0, seqno_type/0, stream_key/0, rank_key/0]).
+-export_type([
+    t/0, metadata/0, subscriptions/0, seqno_type/0, stream_key/0, rank_key/0, session_iterator/0
+]).
 
 -include("emqx_mqtt.hrl").
 -include("emqx_persistent_session_ds.hrl").
 -include_lib("snabbkaffe/include/trace.hrl").
+-include_lib("stdlib/include/qlc.hrl").
 
 %%================================================================================
 %% Type declarations
@@ -51,6 +53,8 @@
 
 -type subscriptions() :: emqx_topic_gbt:t(_SubId, emqx_persistent_session_ds:subscription()).
 
+-opaque session_iterator() :: emqx_persistent_session_ds:id() | '$end_of_table'.
+
 %% Generic key-value wrapper that is used for exporting arbitrary
 %% terms to mnesia:
 -record(kv, {k, v}).
@@ -116,6 +120,14 @@
 -define(rank_tab, emqx_ds_session_ranks).
 -define(pmap_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
 
+-ifndef(TEST).
+-define(set_dirty, dirty => true).
+-define(unset_dirty, dirty => false).
+-else.
+-define(set_dirty, dirty => true, '_' => do_seqno()).
+-define(unset_dirty, dirty => false, '_' => do_seqno()).
+-endif.
+
 %%================================================================================
 %% API funcions
 %%================================================================================
@@ -126,7 +138,7 @@ create_tables() ->
         ?session_tab,
         [
             {rlog_shard, ?DS_MRIA_SHARD},
-            {type, set},
+            {type, ordered_set},
             {storage, rocksdb_copies},
             {record_name, kv},
             {attributes, record_info(fields, kv)}
@@ -210,15 +222,17 @@ commit(
         ranks := Ranks
     }
 ) ->
-    transaction(fun() ->
-        kv_persist(?session_tab, SessionId, Metadata),
-        Rec#{
-            streams => pmap_commit(SessionId, Streams),
-            seqnos => pmap_commit(SessionId, SeqNos),
-            ranks => pmap_commit(SessionId, Ranks),
-            dirty => false
-        }
-    end).
+    check_sequence(
+        transaction(fun() ->
+            kv_persist(?session_tab, SessionId, Metadata),
+            Rec#{
+                streams => pmap_commit(SessionId, Streams),
+                seqnos => pmap_commit(SessionId, SeqNos),
+                ranks => pmap_commit(SessionId, Ranks),
+                ?unset_dirty
+            }
+        end)
+    ).
 
 -spec create_new(emqx_persistent_session_ds:id()) -> t().
 create_new(SessionId) ->
@@ -231,7 +245,7 @@ create_new(SessionId) ->
             streams => pmap_open(?stream_tab, SessionId),
             seqnos => pmap_open(?seqno_tab, SessionId),
             ranks => pmap_open(?rank_tab, SessionId),
-            dirty => true
+            ?set_dirty
         }
     end).
 
@@ -299,7 +313,7 @@ del_subscription(TopicFilter, SubId, Rec = #{id := Id, subscriptions := Subs0})
 
 %%
 
--type stream_key() :: {emqx_persistent_session_ds:subscription_id(), binary()}.
+-type stream_key() :: {emqx_persistent_session_ds:subscription_id(), _StreamId}.
 
 -spec get_stream(stream_key(), t()) ->
     emqx_persistent_session_ds:stream_state() | undefined.
@@ -348,6 +362,26 @@ del_rank(Key, Rec) ->
 fold_ranks(Fun, Acc, Rec) ->
     gen_fold(ranks, Fun, Acc, Rec).
 
+-spec make_session_iterator() -> session_iterator().
+make_session_iterator() ->
+    case mnesia:dirty_first(?session_tab) of
+        '$end_of_table' ->
+            '$end_of_table';
+        Key ->
+            {true, Key}
+    end.
+
+-spec session_iterator_next(session_iterator(), pos_integer()) ->
+    {[{emqx_persistent_session_ds:id(), metadata()}], session_iterator()}.
+session_iterator_next(Cursor, 0) ->
+    {[], Cursor};
+session_iterator_next('$end_of_table', _N) ->
+    {[], '$end_of_table'};
+session_iterator_next(Cursor0, N) ->
+    ThisVal = [{Cursor0, Metadata} || Metadata <- mnesia:dirty_read(?session_tab, Cursor0)],
+    {NextVals, Cursor} = session_iterator_next(Cursor0, N - 1),
+    {ThisVal ++ NextVals, Cursor}.
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
@@ -365,28 +399,32 @@ get_meta(K, #{metadata := Meta}) ->
     maps:get(K, Meta, undefined).
 
 set_meta(K, V, Rec = #{metadata := Meta}) ->
-    Rec#{metadata => maps:put(K, V, Meta), dirty => true}.
+    check_sequence(Rec#{metadata => maps:put(K, V, Meta), ?set_dirty}).
 
 %%
 
 gen_get(Field, Key, Rec) ->
+    check_sequence(Rec),
     pmap_get(Key, maps:get(Field, Rec)).
 
 gen_fold(Field, Fun, Acc, Rec) ->
+    check_sequence(Rec),
     pmap_fold(Fun, Acc, maps:get(Field, Rec)).
 
 gen_put(Field, Key, Val, Rec) ->
+    check_sequence(Rec),
     maps:update_with(
         Field,
         fun(PMap) -> pmap_put(Key, Val, PMap) end,
-        Rec#{dirty => true}
+        Rec#{?set_dirty}
     ).
 
 gen_del(Field, Key, Rec) ->
+    check_sequence(Rec),
     maps:update_with(
         Field,
         fun(PMap) -> pmap_del(Key, PMap) end,
-        Rec#{dirty => true}
+        Rec#{?set_dirty}
     ).
 
 %%
@@ -519,3 +557,24 @@ transaction(Fun) ->
 ro_transaction(Fun) ->
     {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
     Res.
+
+-compile({inline, check_sequence/1}).
+
+-ifdef(TEST).
+do_seqno() ->
+    case erlang:get(?MODULE) of
+        undefined ->
+            put(?MODULE, 0),
+            0;
+        N ->
+            put(?MODULE, N + 1),
+            N + 1
+    end.
+
+check_sequence(A = #{'_' := N}) ->
+    N = erlang:get(?MODULE),
+    A.
+-else.
+check_sequence(A) ->
+    A.
+-endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 091b815d4..e0de96454 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -27,6 +27,7 @@
 
 -export_type([]).
 
+-include_lib("emqx/include/logger.hrl").
 -include("emqx_mqtt.hrl").
 -include("emqx_persistent_session_ds.hrl").
 
@@ -136,10 +137,13 @@ del_subscription(SubId, S0) ->
 %%================================================================================
 
 ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
-    %% TODO: use next_id to enumerate streams
-    Key = {SubId, term_to_binary(Stream)},
+    %% TODO: hash collisions
+    Key = {SubId, erlang:phash2(Stream)},
     case emqx_persistent_session_ds_state:get_stream(Key, S) of
         undefined ->
+            ?SLOG(debug, #{
+                '$msg' => new_stream, key => Key, stream => Stream
+            }),
             {ok, Iterator} = emqx_ds:make_iterator(
                 ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
             ),
@@ -226,7 +230,15 @@ remove_fully_replayed_streams(S0) ->
     emqx_persistent_session_ds_state:fold_streams(
         fun(Key = {SubId, _Stream}, #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
             case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
+                undefined ->
+                    Acc;
                 MinRankY when RankY < MinRankY ->
+                    ?SLOG(debug, #{
+                        msg => del_fully_preplayed_stream,
+                        key => Key,
+                        rank => {RankX, RankY},
+                        min => MinRankY
+                    }),
                     emqx_persistent_session_ds_state:del_stream(Key, Acc);
                 _ ->
                     Acc
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index a6ad9181a..7acfb6214 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -318,11 +318,6 @@ t_qos0_only_many_streams(_Config) ->
             receive_messages(3)
         ),
 
-        ?assertMatch(
-            #{pubranges := [_, _, _]},
-            emqx_persistent_session_ds:print_session(ClientId)
-        ),
-
         Inflight1 = get_session_inflight(ConnPid),
 
         %% TODO: Kinda stupid way to verify that the runtime state is not growing.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 3b9cb33cb..4647186aa 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -695,9 +695,6 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     ok = publish_many(Pubs2),
     NPubs2 = length(Pubs2),
 
-    _ = receive_messages(NPubs1, 2000),
-    [] = receive_messages(NPubs1, 2000),
-    debug_info(ClientId),
     {ok, Client2} = emqtt:start_link([
         {proto_ver, v5},
         {clientid, ClientId},
@@ -719,9 +716,9 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
 
     ct:pal("Msgs2 = ~p", [Msgs2]),
 
-    ?assert(NMsgs2 =< NPubs, {NMsgs2, '=<', NPubs}),
-    ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
-    ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
+    ?assert(NMsgs2 < NPubs, {NMsgs2, '<', NPubs}),
+    %% ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
+    %% ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
     NSame = NMsgs2 - NPubs2,
     ?assert(
         lists:all(fun(#{dup := Dup}) -> Dup end, lists:sublist(Msgs2, NSame))

From 963df8f9416d3328fb798b59aa6c2560a3b31334 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 8 Jan 2024 11:12:33 +0100
Subject: [PATCH 083/273] fix(sessds): Delete the routes when the session
 expires

---
 .../emqx_persistent_session_ds_SUITE.erl      | 32 +++++----
 apps/emqx/src/emqx_persistent_session_ds.erl  | 65 ++++++++++++-------
 .../src/emqx_persistent_session_ds_state.erl  | 23 ++++---
 .../test/emqx_persistent_messages_SUITE.erl   | 26 +-------
 apps/emqx_conf/src/emqx_conf_schema.erl       |  4 +-
 5 files changed, 74 insertions(+), 76 deletions(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index f806a57fc..96fd523e6 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -85,6 +85,7 @@ end_per_testcase(TestCase, Config) when
     Nodes = ?config(nodes, Config),
     emqx_common_test_helpers:call_janitor(60_000),
     ok = emqx_cth_cluster:stop(Nodes),
+    snabbkaffe:stop(),
     ok;
 end_per_testcase(_TestCase, _Config) ->
     emqx_common_test_helpers:call_janitor(60_000),
@@ -164,10 +165,19 @@ is_persistent_connect_opts(#{properties := #{'Session-Expiry-Interval' := EI}})
     EI > 0.
 
 list_all_sessions(Node) ->
-    erpc:call(Node, emqx_persistent_session_ds, list_all_sessions, []).
+    erpc:call(Node, emqx_persistent_session_ds_state, list_sessions, []).
 
 list_all_subscriptions(Node) ->
-    erpc:call(Node, emqx_persistent_session_ds, list_all_subscriptions, []).
+    Sessions = list_all_sessions(Node),
+    lists:flatmap(
+        fun(ClientId) ->
+            #{s := #{subscriptions := Subs}} = erpc:call(
+                Node, emqx_persistent_session_ds, print_session, [ClientId]
+            ),
+            maps:to_list(Subs)
+        end,
+        Sessions
+    ).
 
 list_all_pubranges(Node) ->
     erpc:call(Node, emqx_persistent_session_ds, list_all_pubranges, []).
@@ -485,7 +495,7 @@ do_t_session_expiration(_Config, Opts) ->
             Client0 = start_client(Params0),
             {ok, _} = emqtt:connect(Client0),
             {ok, _, [?RC_GRANTED_QOS_2]} = emqtt:subscribe(Client0, Topic, ?QOS_2),
-            #{subscriptions := Subs0} = emqx_persistent_session_ds:print_session(ClientId),
+            #{s := #{subscriptions := Subs0}} = emqx_persistent_session_ds:print_session(ClientId),
             ?assertEqual(1, map_size(Subs0), #{subs => Subs0}),
             Info0 = maps:from_list(emqtt:info(Client0)),
             ?assertEqual(0, maps:get(session_present, Info0), #{info => Info0}),
@@ -512,7 +522,8 @@ do_t_session_expiration(_Config, Opts) ->
             emqtt:publish(Client2, Topic, <<"payload">>),
             ?assertNotReceive({publish, #{topic := Topic}}),
             %% ensure subscriptions are absent from table.
-            ?assertEqual(#{}, emqx_persistent_session_ds:list_all_subscriptions()),
+            #{s := #{subscriptions := Subs3}} = emqx_persistent_session_ds:print_session(ClientId),
+            ?assertEqual([], maps:to_list(Subs3)),
             emqtt:disconnect(Client2, ?RC_NORMAL_DISCONNECTION, ThirdDisconn),
 
             ok
@@ -580,10 +591,8 @@ t_session_gc(Config) ->
             ),
             ?assertMatch({ok, _}, Res0),
             {ok, #{?snk_meta := #{time := T0}}} = Res0,
-            Sessions0 = list_all_sessions(Node1),
-            Subs0 = list_all_subscriptions(Node1),
-            ?assertEqual(3, map_size(Sessions0), #{sessions => Sessions0}),
-            ?assertEqual(3, map_size(Subs0), #{subs => Subs0}),
+            ?assertMatch([_, _, _], list_all_sessions(Node1), sessions),
+            ?assertMatch([_, _, _], list_all_subscriptions(Node1), subscriptions),
 
             %% Now we disconnect 2 of them; only those should be GC'ed.
             ?assertMatch(
@@ -628,11 +637,8 @@ t_session_gc(Config) ->
                     4 * GCInterval + 1_000
                 )
             ),
-            Sessions1 = list_all_sessions(Node1),
-            Subs1 = list_all_subscriptions(Node1),
-            ?assertEqual(1, map_size(Sessions1), #{sessions => Sessions1}),
-            ?assertEqual(1, map_size(Subs1), #{subs => Subs1}),
-
+            ?assertMatch([_], list_all_sessions(Node1), sessions),
+            ?assertMatch([_], list_all_subscriptions(Node1), subscriptions),
             ok
         end,
         [
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index b26a4e983..e5f08a6bb 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -20,7 +20,7 @@
 
 -include("emqx.hrl").
 -include_lib("emqx/include/logger.hrl").
--include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("snabbkaffe/include/trace.hrl").
 -include_lib("stdlib/include/ms_transform.hrl").
 
 -include("emqx_mqtt.hrl").
@@ -188,7 +188,7 @@ destroy(#{clientid := ClientID}) ->
     destroy_session(ClientID).
 
 destroy_session(ClientID) ->
-    session_drop(ClientID).
+    session_drop(ClientID, destroy).
 
 %%--------------------------------------------------------------------
 %% Info, Stats
@@ -321,19 +321,28 @@ unsubscribe(
     Session = #{id := ID, s := S0}
 ) ->
     case subs_lookup(TopicFilter, S0) of
-        #{props := SubOpts, id := SubId} ->
-            S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
-            S = emqx_persistent_session_ds_stream_scheduler:del_subscription(SubId, S1),
-            ?tp_span(
-                persistent_session_ds_subscription_route_delete,
-                #{session_id => ID},
-                ok = emqx_persistent_session_ds_router:do_delete_route(TopicFilter, ID)
-            ),
-            {ok, Session#{s => S}, SubOpts};
         undefined ->
-            {error, ?RC_NO_SUBSCRIPTION_EXISTED}
+            {error, ?RC_NO_SUBSCRIPTION_EXISTED};
+        Subscription = #{props := SubOpts} ->
+            S = do_unsubscribe(ID, TopicFilter, Subscription, S0),
+            {ok, Session#{s => S}, SubOpts}
     end.
 
+-spec do_unsubscribe(id(), topic_filter(), subscription(), emqx_persistent_session_ds_state:t()) ->
+    emqx_persistent_session_ds_state:t().
+do_unsubscribe(SessionId, TopicFilter, #{id := SubId}, S0) ->
+    ?tp(persistent_session_ds_subscription_delete, #{
+        session_id => SessionId, topic_filter => TopicFilter
+    }),
+    S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
+    S = emqx_persistent_session_ds_stream_scheduler:del_subscription(SubId, S1),
+    ?tp_span(
+        persistent_session_ds_subscription_route_delete,
+        #{session_id => SessionId, topic_filter => TopicFilter},
+        ok = emqx_persistent_session_ds_router:do_delete_route(TopicFilter, SessionId)
+    ),
+    S.
+
 -spec get_subscription(topic_filter(), session()) ->
     emqx_types:subopts() | undefined.
 get_subscription(TopicFilter, #{s := S}) ->
@@ -534,12 +543,6 @@ sync(ClientId) ->
             {error, noproc}
     end.
 
--define(IS_EXPIRED(NOW_MS, LAST_ALIVE_AT, EI),
-    (is_number(LAST_ALIVE_AT) andalso
-        is_number(EI) andalso
-        (NOW_MS >= LAST_ALIVE_AT + EI))
-).
-
 %% @doc Called when a client connects. This function looks up a
 %% session or returns `false` if previous one couldn't be found.
 %%
@@ -553,11 +556,12 @@ session_open(SessionId, NewConnInfo) ->
         {ok, S0} ->
             EI = expiry_interval(emqx_persistent_session_ds_state:get_conninfo(S0)),
             LastAliveAt = emqx_persistent_session_ds_state:get_last_alive_at(S0),
-            case ?IS_EXPIRED(NowMS, LastAliveAt, EI) of
+            case NowMS >= LastAliveAt + EI of
                 true ->
-                    emqx_persistent_session_ds_state:delete(SessionId),
+                    session_drop(SessionId, expired),
                     false;
                 false ->
+                    ?tp(open_session, #{ei => EI, now => NowMS, laa => LastAliveAt}),
                     %% New connection being established
                     S1 = emqx_persistent_session_ds_state:set_conninfo(NewConnInfo, S0),
                     S2 = emqx_persistent_session_ds_state:set_last_alive_at(NowMS, S1),
@@ -608,9 +612,22 @@ session_ensure_new(Id, ConnInfo, Conf) ->
 
 %% @doc Called when a client reconnects with `clean session=true' or
 %% during session GC
--spec session_drop(id()) -> ok.
-session_drop(ID) ->
-    emqx_persistent_session_ds_state:delete(ID).
+-spec session_drop(id(), _Reason) -> ok.
+session_drop(ID, Reason) ->
+    case emqx_persistent_session_ds_state:open(ID) of
+        {ok, S0} ->
+            ?tp(debug, drop_persistent_session, #{client_id => ID, reason => Reason}),
+            _S = subs_fold(
+                fun(TopicFilter, Subscription, S) ->
+                    do_unsubscribe(ID, TopicFilter, Subscription, S)
+                end,
+                S0,
+                S0
+            ),
+            emqx_persistent_session_ds_state:delete(ID);
+        undefined ->
+            ok
+    end.
 
 now_ms() ->
     erlang:system_time(millisecond).
@@ -1083,7 +1100,7 @@ seqno_proper_test_() ->
             end,
             [?_assert(proper:quickcheck(Prop, Opts)) || Prop <- Props]}}.
 
-apply_n_times(0, Fun, A) ->
+apply_n_times(0, _Fun, A) ->
     A;
 apply_n_times(N, Fun, A) when N > 0 ->
     apply_n_times(N - 1, Fun, Fun(A)).
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 504e9649c..0c2bc450b 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -159,7 +159,7 @@ open(SessionId) ->
                     streams => pmap_open(?stream_tab, SessionId),
                     seqnos => pmap_open(?seqno_tab, SessionId),
                     ranks => pmap_open(?rank_tab, SessionId),
-                    dirty => false
+                    ?unset_dirty
                 },
                 {ok, Rec};
             [] ->
@@ -222,17 +222,16 @@ commit(
         ranks := Ranks
     }
 ) ->
-    check_sequence(
-        transaction(fun() ->
-            kv_persist(?session_tab, SessionId, Metadata),
-            Rec#{
-                streams => pmap_commit(SessionId, Streams),
-                seqnos => pmap_commit(SessionId, SeqNos),
-                ranks => pmap_commit(SessionId, Ranks),
-                ?unset_dirty
-            }
-        end)
-    ).
+    check_sequence(Rec),
+    transaction(fun() ->
+        kv_persist(?session_tab, SessionId, Metadata),
+        Rec#{
+            streams => pmap_commit(SessionId, Streams),
+            seqnos => pmap_commit(SessionId, SeqNos),
+            ranks => pmap_commit(SessionId, Ranks),
+            ?unset_dirty
+        }
+    end).
 
 -spec create_new(emqx_persistent_session_ds:id()) -> t().
 create_new(SessionId) ->
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index 7acfb6214..6da60b809 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -216,31 +216,7 @@ t_session_subscription_iterators(Config) ->
                 messages => [Message1, Message2, Message3, Message4]
             }
         end,
-        fun(Trace) ->
-            ct:pal("trace:\n  ~p", [Trace]),
-            case ?of_kind(ds_session_subscription_added, Trace) of
-                [] ->
-                    %% Since `emqx_durable_storage' is a dependency of `emqx', it gets
-                    %% compiled in "prod" mode when running emqx standalone tests.
-                    ok;
-                [_ | _] ->
-                    ?assertMatch(
-                        [
-                            #{?snk_kind := ds_session_subscription_added},
-                            #{?snk_kind := ds_session_subscription_present}
-                        ],
-                        ?of_kind(
-                            [
-                                ds_session_subscription_added,
-                                ds_session_subscription_present
-                            ],
-                            Trace
-                        )
-                    ),
-                    ok
-            end,
-            ok
-        end
+        []
     ),
     ok.
 
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 23f69a81b..6f21fc216 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2021-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2021-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -594,7 +594,7 @@ fields("node") ->
             sc(
                 hoconsc:enum([gen_rpc, distr]),
                 #{
-                    mapping => "mria.shardp_transport",
+                    mapping => "mria.shard_transport",
                     importance => ?IMPORTANCE_HIDDEN,
                     default => distr,
                     desc => ?DESC(db_default_shard_transport)

From 893656f092f827ddf484d2176ae01b98269669b7 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 10 Jan 2024 23:46:18 +0100
Subject: [PATCH 084/273] fix(sessds): Fix session garbage collection after the
 refactoring

---
 .../emqx_persistent_session_ds_SUITE.erl      | 56 +++++++------------
 apps/emqx/src/emqx_persistent_session_ds.erl  | 11 ++--
 .../emqx_persistent_session_ds_gc_worker.erl  | 25 ++++++---
 .../emqx_persistent_session_ds_inflight.erl   |  4 +-
 .../src/emqx_persistent_session_ds_state.erl  |  9 ++-
 .../src/emqx_persistent_session_ds_sup.erl    |  2 +-
 .../test/emqx_persistent_session_SUITE.erl    |  8 +--
 7 files changed, 57 insertions(+), 58 deletions(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index 96fd523e6..f834b8098 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -54,12 +54,12 @@ init_per_testcase(TestCase, Config) when
 init_per_testcase(t_session_gc = TestCase, Config) ->
     Opts = #{
         n => 3,
-        roles => [core, core, replicant],
+        roles => [core, core, core],
         extra_emqx_conf =>
             "\n session_persistence {"
             "\n   last_alive_update_interval = 500ms "
-            "\n   session_gc_interval = 2s "
-            "\n   session_gc_batch_size = 1 "
+            "\n   session_gc_interval = 1s "
+            "\n   session_gc_batch_size = 2 "
             "\n }"
     },
     Cluster = cluster(Opts),
@@ -85,7 +85,6 @@ end_per_testcase(TestCase, Config) when
     Nodes = ?config(nodes, Config),
     emqx_common_test_helpers:call_janitor(60_000),
     ok = emqx_cth_cluster:stop(Nodes),
-    snabbkaffe:stop(),
     ok;
 end_per_testcase(_TestCase, _Config) ->
     emqx_common_test_helpers:call_janitor(60_000),
@@ -151,6 +150,7 @@ start_client(Opts0 = #{}) ->
     Opts = maps:to_list(emqx_utils_maps:deep_merge(Defaults, Opts0)),
     ct:pal("starting client with opts:\n  ~p", [Opts]),
     {ok, Client} = emqtt:start_link(Opts),
+    unlink(Client),
     on_exit(fun() -> catch emqtt:stop(Client) end),
     Client.
 
@@ -182,20 +182,6 @@ list_all_subscriptions(Node) ->
 list_all_pubranges(Node) ->
     erpc:call(Node, emqx_persistent_session_ds, list_all_pubranges, []).
 
-prop_only_cores_run_gc(CoreNodes) ->
-    {"only core nodes run gc", fun(Trace) -> ?MODULE:prop_only_cores_run_gc(Trace, CoreNodes) end}.
-prop_only_cores_run_gc(Trace, CoreNodes) ->
-    GCNodes = lists:usort([
-        N
-     || #{
-            ?snk_kind := K,
-            ?snk_meta := #{node := N}
-        } <- Trace,
-        lists:member(K, [ds_session_gc, ds_session_gc_lock_taken]),
-        N =/= node()
-    ]),
-    ?assertEqual(lists:usort(CoreNodes), GCNodes).
-
 %%------------------------------------------------------------------------------
 %% Testcases
 %%------------------------------------------------------------------------------
@@ -236,6 +222,7 @@ t_session_subscription_idempotency(Config) ->
     ?check_trace(
         #{timetrap => 30_000},
         begin
+            #{timetrap => 20_000},
             ?force_ordering(
                 #{?snk_kind := persistent_session_ds_subscription_added},
                 _NEvents0 = 1,
@@ -298,10 +285,10 @@ t_session_unsubscription_idempotency(Config) ->
     ?check_trace(
         #{timetrap => 30_000},
         begin
+            #{timetrap => 20_000},
             ?force_ordering(
                 #{
-                    ?snk_kind := persistent_session_ds_subscription_delete,
-                    ?snk_span := {complete, _}
+                    ?snk_kind := persistent_session_ds_subscription_delete
                 },
                 _NEvents0 = 1,
                 #{?snk_kind := will_restart_node},
@@ -452,6 +439,8 @@ do_t_session_discard(Params) ->
     ok.
 
 t_session_expiration1(Config) ->
+    %% This testcase verifies that the properties passed in the
+    %% CONNECT packet are respected by the GC process:
     ClientId = atom_to_binary(?FUNCTION_NAME),
     Opts = #{
         clientid => ClientId,
@@ -464,6 +453,9 @@ t_session_expiration1(Config) ->
     do_t_session_expiration(Config, Opts).
 
 t_session_expiration2(Config) ->
+    %% This testcase updates the expiry interval for the session in
+    %% the _DISCONNECT_ packet. This setting should be respected by GC
+    %% process:
     ClientId = atom_to_binary(?FUNCTION_NAME),
     Opts = #{
         clientid => ClientId,
@@ -478,6 +470,8 @@ t_session_expiration2(Config) ->
     do_t_session_expiration(Config, Opts).
 
 do_t_session_expiration(_Config, Opts) ->
+    %% Sequence is a list of pairs of properties passed through the
+    %% CONNECT and for the DISCONNECT for each session:
     #{
         clientid := ClientId,
         sequence := [
@@ -510,7 +504,7 @@ do_t_session_expiration(_Config, Opts) ->
             ?assertEqual([], Subs1),
             emqtt:disconnect(Client1, ?RC_NORMAL_DISCONNECTION, SecondDisconn),
 
-            ct:sleep(1_500),
+            ct:sleep(2_500),
 
             Params2 = maps:merge(CommonParams, ThirdConn),
             Client2 = start_client(Params2),
@@ -525,7 +519,6 @@ do_t_session_expiration(_Config, Opts) ->
             #{s := #{subscriptions := Subs3}} = emqx_persistent_session_ds:print_session(ClientId),
             ?assertEqual([], maps:to_list(Subs3)),
             emqtt:disconnect(Client2, ?RC_NORMAL_DISCONNECTION, ThirdDisconn),
-
             ok
         end,
         []
@@ -541,6 +534,7 @@ t_session_gc(Config) ->
         Port2,
         Port3
     ] = lists:map(fun(N) -> get_mqtt_port(N, tcp) end, Nodes),
+    ct:pal("Ports: ~p", [[Port1, Port2, Port3]]),
     CommonParams = #{
         clean_start => false,
         proto_ver => v5
@@ -618,11 +612,8 @@ t_session_gc(Config) ->
                 ?block_until(
                     #{
                         ?snk_kind := ds_session_gc_cleaned,
-                        ?snk_meta := #{node := N, time := T},
-                        session_ids := [ClientId1]
-                    } when
-                        N =/= node() andalso T > T0,
-                    4 * GCInterval + 1_000
+                        session_id := ClientId1
+                    }
                 )
             ),
             ?assertMatch(
@@ -630,19 +621,14 @@ t_session_gc(Config) ->
                 ?block_until(
                     #{
                         ?snk_kind := ds_session_gc_cleaned,
-                        ?snk_meta := #{node := N, time := T},
-                        session_ids := [ClientId2]
-                    } when
-                        N =/= node() andalso T > T0,
-                    4 * GCInterval + 1_000
+                        session_id := ClientId2
+                    }
                 )
             ),
             ?assertMatch([_], list_all_sessions(Node1), sessions),
             ?assertMatch([_], list_all_subscriptions(Node1), subscriptions),
             ok
         end,
-        [
-            prop_only_cores_run_gc(CoreNodes)
-        ]
+        []
     ),
     ok.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index e5f08a6bb..d8019b6f1 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -331,10 +331,10 @@ unsubscribe(
 -spec do_unsubscribe(id(), topic_filter(), subscription(), emqx_persistent_session_ds_state:t()) ->
     emqx_persistent_session_ds_state:t().
 do_unsubscribe(SessionId, TopicFilter, #{id := SubId}, S0) ->
+    S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
     ?tp(persistent_session_ds_subscription_delete, #{
         session_id => SessionId, topic_filter => TopicFilter
     }),
-    S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
     S = emqx_persistent_session_ds_stream_scheduler:del_subscription(SubId, S1),
     ?tp_span(
         persistent_session_ds_subscription_route_delete,
@@ -510,9 +510,12 @@ replay_batch(Ifs0, Session, ClientInfo) ->
 %%--------------------------------------------------------------------
 
 -spec disconnect(session(), emqx_types:conninfo()) -> {shutdown, session()}.
-disconnect(Session = #{s := S0}, _ConnInfo) ->
+disconnect(Session = #{s := S0}, ConnInfo) ->
+    OldConnInfo = emqx_persistent_session_ds_state:get_conninfo(S0),
+    NewConnInfo = maps:merge(OldConnInfo, maps:with([expiry_interval], ConnInfo)),
     S1 = emqx_persistent_session_ds_state:set_last_alive_at(now_ms(), S0),
-    S = emqx_persistent_session_ds_state:commit(S1),
+    S2 = emqx_persistent_session_ds_state:set_conninfo(NewConnInfo, S1),
+    S = emqx_persistent_session_ds_state:commit(S2),
     {shutdown, Session#{s => S}}.
 
 -spec terminate(Reason :: term(), session()) -> ok.
@@ -861,7 +864,7 @@ ensure_timers(Session0) ->
 
 -spec inc_send_quota(session()) -> session().
 inc_send_quota(Session = #{inflight := Inflight0}) ->
-    {_NInflight, Inflight} = emqx_persistent_session_ds_inflight:inc_send_quota(Inflight0),
+    Inflight = emqx_persistent_session_ds_inflight:inc_send_quota(Inflight0),
     pull_now(Session#{inflight => Inflight}).
 
 -spec pull_now(session()) -> session().
diff --git a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
index 46e170492..4ff420eb8 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
@@ -113,18 +113,25 @@ start_gc() ->
 gc_loop(MinLastAlive, It0) ->
     GCBatchSize = emqx_config:get([session_persistence, session_gc_batch_size]),
     case emqx_persistent_session_ds_state:session_iterator_next(It0, GCBatchSize) of
-        {[], _} ->
+        {[], _It} ->
             ok;
         {Sessions, It} ->
-            do_gc([
-                Key
-             || {Key, #{last_alive_at := LastAliveAt}} <- Sessions,
-                LastAliveAt < MinLastAlive
-            ]),
+            [
+                do_gc(SessionId, MinLastAlive, LastAliveAt, EI)
+             || {SessionId, #{last_alive_at := LastAliveAt, conninfo := #{expiry_interval := EI}}} <-
+                    Sessions
+            ],
             gc_loop(MinLastAlive, It)
     end.
 
-do_gc(DSSessionIds) ->
-    lists:foreach(fun emqx_persistent_session_ds:destroy_session/1, DSSessionIds),
-    ?tp(ds_session_gc_cleaned, #{session_ids => DSSessionIds}),
+do_gc(SessionId, MinLastAlive, LastAliveAt, EI) when LastAliveAt + EI < MinLastAlive ->
+    emqx_persistent_session_ds:destroy_session(SessionId),
+    ?tp(error, ds_session_gc_cleaned, #{
+        session_id => SessionId,
+        last_alive_at => LastAliveAt,
+        expiry_interval => EI,
+        min_last_alive => MinLastAlive
+    }),
+    ok;
+do_gc(_SessionId, _MinLastAliveAt, _LastAliveAt, _EI) ->
     ok.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index 09962faa0..2938222e9 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -125,10 +125,10 @@ n_inflight(#inflight{n_inflight = NInflight}) ->
     NInflight.
 
 %% https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Flow_Control
--spec inc_send_quota(t()) -> {non_neg_integer(), t()}.
+-spec inc_send_quota(t()) -> t().
 inc_send_quota(Rec = #inflight{n_inflight = NInflight0}) ->
     NInflight = max(NInflight0 - 1, 0),
-    {NInflight, Rec#inflight{n_inflight = NInflight}}.
+    Rec#inflight{n_inflight = NInflight}.
 
 %%================================================================================
 %% Internal functions
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 0c2bc450b..27519678d 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -367,7 +367,7 @@ make_session_iterator() ->
         '$end_of_table' ->
             '$end_of_table';
         Key ->
-            {true, Key}
+            Key
     end.
 
 -spec session_iterator_next(session_iterator(), pos_integer()) ->
@@ -377,8 +377,11 @@ session_iterator_next(Cursor, 0) ->
 session_iterator_next('$end_of_table', _N) ->
     {[], '$end_of_table'};
 session_iterator_next(Cursor0, N) ->
-    ThisVal = [{Cursor0, Metadata} || Metadata <- mnesia:dirty_read(?session_tab, Cursor0)],
-    {NextVals, Cursor} = session_iterator_next(Cursor0, N - 1),
+    ThisVal = [
+        {Cursor0, Metadata}
+     || #kv{v = Metadata} <- mnesia:dirty_read(?session_tab, Cursor0)
+    ],
+    {NextVals, Cursor} = session_iterator_next(mnesia:dirty_next(?session_tab, Cursor0), N - 1),
     {ThisVal ++ NextVals, Cursor}.
 
 %%================================================================================
diff --git a/apps/emqx/src/emqx_persistent_session_ds_sup.erl b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
index 11e05be82..7b3fb7abb 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_sup.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_sup.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 4647186aa..007b737c2 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -645,7 +645,7 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
         #mqtt_msg{topic = <<"loc/1/2/42">>, payload = <<"M4">>, qos = 1},
         #mqtt_msg{topic = <<"t/42/foo">>, payload = <<"M5">>, qos = 1},
         #mqtt_msg{topic = <<"loc/3/4/5">>, payload = <<"M6">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M7">>, qos = 1}
+        #mqtt_msg{topic = <<"msg/feed/me2">>, payload = <<"M7">>, qos = 1}
     ],
     ok = publish_many(Pubs1),
     NPubs1 = length(Pubs1),
@@ -686,11 +686,11 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     maybe_kill_connection_process(ClientId, Config),
 
     Pubs2 = [
-        #mqtt_msg{topic = <<"loc/3/4/5">>, payload = <<"M8">>, qos = 1},
+        #mqtt_msg{topic = <<"loc/3/4/6">>, payload = <<"M8">>, qos = 1},
         #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M9">>, qos = 1},
         #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M10">>, qos = 1},
         #mqtt_msg{topic = <<"msg/feed/friend">>, payload = <<"M11">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M12">>, qos = 1}
+        #mqtt_msg{topic = <<"msg/feed/me2">>, payload = <<"M12">>, qos = 1}
     ],
     ok = publish_many(Pubs2),
     NPubs2 = length(Pubs2),
@@ -719,7 +719,7 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     ?assert(NMsgs2 < NPubs, {NMsgs2, '<', NPubs}),
     %% ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
     %% ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
-    NSame = NMsgs2 - NPubs2,
+    NSame = max(0, NMsgs2 - NPubs2),
     ?assert(
         lists:all(fun(#{dup := Dup}) -> Dup end, lists:sublist(Msgs2, NSame))
     ),

From e7b03cdc597c488a4a98426c1ca7ff21e17d193f Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 11 Jan 2024 04:40:36 +0100
Subject: [PATCH 085/273] test(sessds): Create a property-based test for the
 session state

---
 .../src/emqx_persistent_session_ds_state.erl  |   4 +-
 ...emqx_persistent_session_ds_state_tests.erl | 372 ++++++++++++++++++
 2 files changed, 374 insertions(+), 2 deletions(-)
 create mode 100644 apps/emqx/test/emqx_persistent_session_ds_state_tests.erl

diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 27519678d..6e03a1c32 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -120,7 +120,7 @@
 -define(rank_tab, emqx_ds_session_ranks).
 -define(pmap_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
 
--ifndef(TEST).
+-ifndef(CHECK_SEQNO).
 -define(set_dirty, dirty => true).
 -define(unset_dirty, dirty => false).
 -else.
@@ -562,7 +562,7 @@ ro_transaction(Fun) ->
 
 -compile({inline, check_sequence/1}).
 
--ifdef(TEST).
+-ifdef(CHECK_SEQNO).
 do_seqno() ->
     case erlang:get(?MODULE) of
         undefined ->
diff --git a/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
new file mode 100644
index 000000000..35554829a
--- /dev/null
+++ b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
@@ -0,0 +1,372 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_persistent_session_ds_state_tests).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include_lib("proper/include/proper.hrl").
+-include_lib("eunit/include/eunit.hrl").
+
+-define(tab, ?MODULE).
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+-record(s, {subs = #{}, metadata = #{}, streams = #{}, seqno = #{}, committed = false}).
+
+-type state() :: #{emqx_persistent_session_ds:id() => #s{}}.
+
+%%================================================================================
+%% Properties
+%%================================================================================
+
+seqno_proper_test_() ->
+    Props = [prop_consistency()],
+    Opts = [{numtests, 10}, {to_file, user}, {max_size, 100}],
+    {timeout, 300, [?_assert(proper:quickcheck(Prop, Opts)) || Prop <- Props]}.
+
+prop_consistency() ->
+    ?FORALL(
+        Cmds,
+        commands(?MODULE),
+        ?TRAPEXIT(
+            begin
+                init(),
+                {_History, State, Result} = run_commands(?MODULE, Cmds),
+                clean(),
+                ?WHENFAIL(
+                    io:format(
+                        user,
+                        "Operations: ~p~nState: ~p\nResult: ~p~n",
+                        [Cmds, State, Result]
+                    ),
+                    aggregate(command_names(Cmds), Result =:= ok)
+                )
+            end
+        )
+    ).
+
+%%================================================================================
+%% Generators
+%%================================================================================
+
+-define(n_sessions, 10).
+
+session_id() ->
+    oneof([integer_to_binary(I) || I <- lists:seq(1, ?n_sessions)]).
+
+topic() ->
+    oneof([<<"foo">>, <<"bar">>, <<"foo/#">>, <<"//+/#">>]).
+
+subid() ->
+    oneof([[]]).
+
+subscription() ->
+    oneof([#{}]).
+
+session_id(S) ->
+    oneof(maps:keys(S)).
+
+batch_size() ->
+    range(1, ?n_sessions).
+
+put_metadata() ->
+    oneof([
+        ?LET(
+            Val,
+            range(0, 100),
+            {last_alive_at, set_last_alive_at, Val}
+        ),
+        ?LET(
+            Val,
+            range(0, 100),
+            {created_at, set_created_at, Val}
+        )
+    ]).
+
+get_metadata() ->
+    oneof([
+        {last_alive_at, get_last_alive_at},
+        {created_at, get_created_at}
+    ]).
+
+seqno_track() ->
+    range(0, 1).
+
+seqno() ->
+    range(1, 100).
+
+stream_id() ->
+    range(1, 1).
+
+stream() ->
+    oneof([#{}]).
+
+put_req() ->
+    oneof([
+        ?LET(
+            {Id, Stream},
+            {stream_id(), stream()},
+            {#s.streams, put_stream, Id, Stream}
+        ),
+        ?LET(
+            {Track, Seqno},
+            {seqno_track(), seqno()},
+            {#s.seqno, put_seqno, Track, Seqno}
+        )
+    ]).
+
+get_req() ->
+    oneof([
+        {#s.streams, get_stream, stream_id()},
+        {#s.seqno, get_seqno, seqno_track()}
+    ]).
+
+del_req() ->
+    oneof([
+        {#s.streams, del_stream, stream_id()}
+    ]).
+
+command(S) ->
+    case maps:size(S) > 0 of
+        true ->
+            frequency([
+                %% Global CRUD operations:
+                {1, {call, ?MODULE, create_new, [session_id()]}},
+                {1, {call, ?MODULE, delete, [session_id(S)]}},
+                {2, {call, ?MODULE, reopen, [session_id(S)]}},
+                {2, {call, ?MODULE, commit, [session_id(S)]}},
+
+                %% Subscriptions:
+                {3,
+                    {call, ?MODULE, put_subscription, [
+                        session_id(S), topic(), subid(), subscription()
+                    ]}},
+                {3, {call, ?MODULE, del_subscription, [session_id(S), topic(), subid()]}},
+
+                %% Metadata:
+                {3, {call, ?MODULE, put_metadata, [session_id(S), put_metadata()]}},
+                {3, {call, ?MODULE, get_metadata, [session_id(S), get_metadata()]}},
+
+                %% Key-value:
+                {3, {call, ?MODULE, gen_put, [session_id(S), put_req()]}},
+                {3, {call, ?MODULE, gen_get, [session_id(S), get_req()]}},
+                {3, {call, ?MODULE, gen_del, [session_id(S), del_req()]}},
+
+                %% Getters:
+                {4, {call, ?MODULE, get_subscriptions, [session_id(S)]}},
+                {1, {call, ?MODULE, iterate_sessions, [batch_size()]}}
+            ]);
+        false ->
+            frequency([
+                {1, {call, ?MODULE, create_new, [session_id()]}},
+                {1, {call, ?MODULE, iterate_sessions, [batch_size()]}}
+            ])
+    end.
+
+precondition(_, _) ->
+    true.
+
+postcondition(S, {call, ?MODULE, iterate_sessions, [_]}, Result) ->
+    {Sessions, _} = lists:unzip(Result),
+    %% No lingering sessions:
+    ?assertMatch([], Sessions -- maps:keys(S)),
+    %% All committed sessions are visited by the iterator:
+    CommittedSessions = lists:sort([K || {K, #s{committed = true}} <- maps:to_list(S)]),
+    ?assertMatch([], CommittedSessions -- Sessions),
+    true;
+postcondition(S, {call, ?MODULE, get_metadata, [SessionId, {MetaKey, _Fun}]}, Result) ->
+    #{SessionId := #s{metadata = Meta}} = S,
+    ?assertEqual(
+        maps:get(MetaKey, Meta, undefined),
+        Result,
+        #{session_id => SessionId, meta => MetaKey}
+    ),
+    true;
+postcondition(S, {call, ?MODULE, gen_get, [SessionId, {Idx, Fun, Key}]}, Result) ->
+    #{SessionId := Record} = S,
+    ?assertEqual(
+        maps:get(Key, element(Idx, Record), undefined),
+        Result,
+        #{session_id => SessionId, key => Key, 'fun' => Fun}
+    ),
+    true;
+postcondition(S, {call, ?MODULE, get_subscriptions, [SessionId]}, Result) ->
+    #{SessionId := #s{subs = Subs}} = S,
+    ?assertEqual(maps:size(Subs), emqx_topic_gbt:size(Result)),
+    maps:foreach(
+        fun({TopicFilter, Id}, Expected) ->
+            ?assertEqual(
+                Expected,
+                emqx_topic_gbt:lookup(TopicFilter, Id, Result, default)
+            )
+        end,
+        Subs
+    ),
+    true;
+postcondition(_, _, _) ->
+    true.
+
+next_state(S, _V, {call, ?MODULE, create_new, [SessionId]}) ->
+    S#{SessionId => #s{}};
+next_state(S, _V, {call, ?MODULE, delete, [SessionId]}) ->
+    maps:remove(SessionId, S);
+next_state(S, _V, {call, ?MODULE, put_subscription, [SessionId, TopicFilter, SubId, Subscription]}) ->
+    Key = {TopicFilter, SubId},
+    update(
+        SessionId,
+        #s.subs,
+        fun(Subs) -> Subs#{Key => Subscription} end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, del_subscription, [SessionId, TopicFilter, SubId]}) ->
+    Key = {TopicFilter, SubId},
+    update(
+        SessionId,
+        #s.subs,
+        fun(Subs) -> maps:remove(Key, Subs) end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, put_metadata, [SessionId, {Key, _Fun, Val}]}) ->
+    update(
+        SessionId,
+        #s.metadata,
+        fun(Map) -> Map#{Key => Val} end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, gen_put, [SessionId, {Idx, _Fun, Key, Val}]}) ->
+    update(
+        SessionId,
+        Idx,
+        fun(Map) -> Map#{Key => Val} end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, gen_del, [SessionId, {Idx, _Fun, Key}]}) ->
+    update(
+        SessionId,
+        Idx,
+        fun(Map) -> maps:remove(Key, Map) end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, commit, [SessionId]}) ->
+    update(
+        SessionId,
+        #s.committed,
+        fun(_) -> true end,
+        S
+    );
+next_state(S, _V, {call, ?MODULE, _, _}) ->
+    S.
+
+initial_state() ->
+    #{}.
+
+%%================================================================================
+%% Operations
+%%================================================================================
+
+create_new(SessionId) ->
+    put_state(SessionId, emqx_persistent_session_ds_state:create_new(SessionId)).
+
+delete(SessionId) ->
+    emqx_persistent_session_ds_state:delete(SessionId),
+    ets:delete(?tab, SessionId).
+
+commit(SessionId) ->
+    put_state(SessionId, emqx_persistent_session_ds_state:commit(get_state(SessionId))).
+
+reopen(SessionId) ->
+    _ = emqx_persistent_session_ds_state:commit(get_state(SessionId)),
+    {ok, S} = emqx_persistent_session_ds_state:open(SessionId),
+    put_state(SessionId, S).
+
+put_subscription(SessionId, TopicFilter, SubId, Subscription) ->
+    S = emqx_persistent_session_ds_state:put_subscription(
+        TopicFilter, SubId, Subscription, get_state(SessionId)
+    ),
+    put_state(SessionId, S).
+
+del_subscription(SessionId, TopicFilter, SubId) ->
+    S = emqx_persistent_session_ds_state:del_subscription(TopicFilter, SubId, get_state(SessionId)),
+    put_state(SessionId, S).
+
+get_subscriptions(SessionId) ->
+    emqx_persistent_session_ds_state:get_subscriptions(get_state(SessionId)).
+
+put_metadata(SessionId, {_MetaKey, Fun, Value}) ->
+    S = apply(emqx_persistent_session_ds_state, Fun, [Value, get_state(SessionId)]),
+    put_state(SessionId, S).
+
+get_metadata(SessionId, {_MetaKey, Fun}) ->
+    apply(emqx_persistent_session_ds_state, Fun, [get_state(SessionId)]).
+
+gen_put(SessionId, {_Idx, Fun, Key, Value}) ->
+    S = apply(emqx_persistent_session_ds_state, Fun, [Key, Value, get_state(SessionId)]),
+    put_state(SessionId, S).
+
+gen_del(SessionId, {_Idx, Fun, Key}) ->
+    S = apply(emqx_persistent_session_ds_state, Fun, [Key, get_state(SessionId)]),
+    put_state(SessionId, S).
+
+gen_get(SessionId, {_Idx, Fun, Key}) ->
+    apply(emqx_persistent_session_ds_state, Fun, [Key, get_state(SessionId)]).
+
+iterate_sessions(BatchSize) ->
+    Fun = fun F(It0) ->
+        case emqx_persistent_session_ds_state:session_iterator_next(It0, BatchSize) of
+            {[], _} ->
+                [];
+            {Sessions, It} ->
+                Sessions ++ F(It)
+        end
+    end,
+    Fun(emqx_persistent_session_ds_state:make_session_iterator()).
+
+%%================================================================================
+%% Misc.
+%%================================================================================
+
+update(SessionId, Key, Fun, S) ->
+    maps:update_with(
+        SessionId,
+        fun(SS) ->
+            setelement(Key, SS, Fun(erlang:element(Key, SS)))
+        end,
+        S
+    ).
+
+get_state(SessionId) ->
+    case ets:lookup(?tab, SessionId) of
+        [{_, S}] ->
+            S;
+        [] ->
+            error({not_found, SessionId})
+    end.
+
+put_state(SessionId, S) ->
+    ets:insert(?tab, {SessionId, S}).
+
+init() ->
+    _ = ets:new(?tab, [named_table, public, {keypos, 1}]),
+    mria:start(),
+    emqx_persistent_session_ds_state:create_tables().
+
+clean() ->
+    ets:delete(?tab),
+    mria:stop(),
+    mria_mnesia:delete_schema().

From 39857626ce831c6e8c9a5f79a96119d49c1ef15a Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 12 Jan 2024 02:06:32 +0100
Subject: [PATCH 086/273] test(sessds): Fix failing tests

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 28 +++++---
 apps/emqx/src/emqx_persistent_session_ds.hrl  | 21 +++---
 .../src/emqx_persistent_session_ds_state.erl  |  1 +
 .../test/emqx_persistent_session_SUITE.erl    | 69 ++++++++++---------
 4 files changed, 64 insertions(+), 55 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index d8019b6f1..7d4ab71d6 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -234,7 +234,7 @@ info(mqueue_dropped, _Session) ->
 % info(awaiting_rel, #sessmem{awaiting_rel = AwaitingRel}) ->
 %     AwaitingRel;
 info(awaiting_rel_cnt, #{s := S}) ->
-    seqno_diff(?QOS_2, ?dup(?QOS_2), ?committed(?QOS_2), S);
+    seqno_diff(?QOS_2, ?rec, ?committed(?QOS_2), S);
 info(awaiting_rel_max, #{props := Conf}) ->
     maps:get(max_awaiting_rel, Conf);
 info(await_rel_timeout, #{props := Conf}) ->
@@ -602,6 +602,7 @@ session_ensure_new(Id, ConnInfo, Conf) ->
             ?committed(?QOS_1),
             ?next(?QOS_2),
             ?dup(?QOS_2),
+            ?rec,
             ?committed(?QOS_2)
         ]
     ),
@@ -742,6 +743,7 @@ process_batch(
     Comm2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
     Dup1 = emqx_persistent_session_ds_state:get_seqno(?dup(?QOS_1), S),
     Dup2 = emqx_persistent_session_ds_state:get_seqno(?dup(?QOS_2), S),
+    Rec = emqx_persistent_session_ds_state:get_seqno(?rec, S),
     Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
     Msgs = [
         Msg
@@ -784,11 +786,18 @@ process_batch(
                     ?QOS_2 when SeqNoQos2 =< Comm2 ->
                         %% QoS2 message has been PUBCOMP'ed by the client, ignore:
                         Acc;
-                    ?QOS_2 when SeqNoQos2 =< Dup2 ->
+                    ?QOS_2 when SeqNoQos2 =< Rec ->
                         %% QoS2 message has been PUBREC'ed by the client, resend PUBREL:
                         emqx_persistent_session_ds_inflight:push({pubrel, SeqNoQos2}, Acc);
+                    ?QOS_2 when SeqNoQos2 =< Dup2 ->
+                        %% QoS2 message has been sent, but we haven't received PUBREC.
+                        %%
+                        %% TODO: According to the MQTT standard 4.3.3:
+                        %% DUP flag is never set for QoS2 messages? We
+                        %% do so for mem sessions, though.
+                        Msg1 = emqx_message:set_flag(dup, true, Msg),
+                        emqx_persistent_session_ds_inflight:push({SeqNoQos2, Msg1}, Acc);
                     ?QOS_2 ->
-                        %% MQTT standard 4.3.3: DUP flag is never set for QoS2 messages:
                         emqx_persistent_session_ds_inflight:push({SeqNoQos2, Msg}, Acc)
                 end,
                 SeqNoQos1,
@@ -821,13 +830,10 @@ do_drain_buffer(Inflight0, S0, Acc) ->
             case Msg#message.qos of
                 ?QOS_0 ->
                     do_drain_buffer(Inflight, S0, [{undefined, Msg} | Acc]);
-                ?QOS_1 ->
-                    S = emqx_persistent_session_ds_state:put_seqno(?dup(?QOS_1), SeqNo, S0),
-                    Publish = {seqno_to_packet_id(?QOS_1, SeqNo), Msg},
-                    do_drain_buffer(Inflight, S, [Publish | Acc]);
-                ?QOS_2 ->
-                    Publish = {seqno_to_packet_id(?QOS_2, SeqNo), Msg},
-                    do_drain_buffer(Inflight, S0, [Publish | Acc])
+                Qos ->
+                    S = emqx_persistent_session_ds_state:put_seqno(?dup(Qos), SeqNo, S0),
+                    Publish = {seqno_to_packet_id(Qos, SeqNo), Msg},
+                    do_drain_buffer(Inflight, S, [Publish | Acc])
             end
     end.
 
@@ -898,7 +904,7 @@ commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
             MinTrack = ?committed(?QOS_1),
             MaxTrack = ?next(?QOS_1);
         pubrec ->
-            MinTrack = ?dup(?QOS_2),
+            MinTrack = ?rec,
             MaxTrack = ?next(?QOS_2);
         pubcomp ->
             MinTrack = ?committed(?QOS_2),
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 2d47052ca..6ab2d4c1f 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -28,25 +28,22 @@
 %%%%% Session sequence numbers:
 
 %%
-%%   -----|----------|----------|------> seqno
-%%        |          |          |
-%%   committed      dup       next
+%%   -----|----------|-----|-----|------> seqno
+%%        |          |     |     |
+%%   committed      dup   rec   next
+%                        (Qos2)
 
 %% Seqno becomes committed after receiving PUBACK for QoS1 or PUBCOMP
 %% for QoS2.
 -define(committed(QOS), QOS).
-%% Seqno becomes dup:
+%% Seqno becomes dup after broker sends QoS1 or QoS2 message to the
+%% client. Upon session reconnect, messages with seqno in the
+%% committed..dup range are retransmitted with DUP flag.
 %%
-%% 1. After broker sends QoS1 message to the client. Upon session
-%% reconnect, QoS1 messages with seqno in the committed..dup range are
-%% retransmitted with DUP flag.
-%%
-%% 2. After it receives PUBREC from the client for the QoS2 message.
-%% Upon session reconnect, PUBREL messages for QoS2 messages with
-%% seqno in committed..dup are retransmitted.
 -define(dup(QOS), (10 + QOS)).
+-define(rec, 22).
 %% Last seqno assigned to a message.
--define(next(QOS), (20 + QOS)).
+-define(next(QOS), (30 + QOS)).
 
 %%%%% State of the stream:
 -record(ifs, {
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 6e03a1c32..fbd4fcc22 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -101,6 +101,7 @@
     | ?committed(?QOS_1)
     | ?next(?QOS_2)
     | ?dup(?QOS_2)
+    | ?rec
     | ?committed(?QOS_2).
 
 -opaque t() :: #{
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 007b737c2..008fc177c 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -36,7 +36,7 @@ all() ->
         % NOTE
         % Tests are disabled while existing session persistence impl is being
         % phased out.
-        %%{group, persistence_disabled},
+        {group, persistence_disabled},
         {group, persistence_enabled}
     ].
 
@@ -54,10 +54,9 @@ all() ->
 groups() ->
     TCs = emqx_common_test_helpers:all(?MODULE),
     TCsNonGeneric = [t_choose_impl],
-    % {group, quic}, {group, ws}],
-    TCGroups = [{group, tcp}],
+    TCGroups = [{group, tcp}, {group, quic}, {group, ws}],
     [
-        %% {persistence_disabled, TCGroups},
+        {persistence_disabled, TCGroups},
         {persistence_enabled, TCGroups},
         {tcp, [], TCs},
         {quic, [], TCs -- TCsNonGeneric},
@@ -677,6 +676,7 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     ),
 
     NAcked = 4,
+    ?assert(NMsgs1 >= NAcked),
     [ok = emqtt:puback(Client1, PktId) || #{packet_id := PktId} <- lists:sublist(Msgs1, NAcked)],
 
     %% Ensure that PUBACKs are propagated to the channel.
@@ -690,17 +690,18 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
         #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M9">>, qos = 1},
         #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M10">>, qos = 1},
         #mqtt_msg{topic = <<"msg/feed/friend">>, payload = <<"M11">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me2">>, payload = <<"M12">>, qos = 1}
+        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M12">>, qos = 1}
     ],
     ok = publish_many(Pubs2),
     NPubs2 = length(Pubs2),
 
+    %% Now reconnect with auto ack to make sure all streams are
+    %% replayed till the end:
     {ok, Client2} = emqtt:start_link([
         {proto_ver, v5},
         {clientid, ClientId},
         {properties, #{'Session-Expiry-Interval' => 30}},
-        {clean_start, false},
-        {auto_ack, false}
+        {clean_start, false}
         | Config
     ]),
 
@@ -717,9 +718,9 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
     ct:pal("Msgs2 = ~p", [Msgs2]),
 
     ?assert(NMsgs2 < NPubs, {NMsgs2, '<', NPubs}),
-    %% ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
-    %% ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
-    NSame = max(0, NMsgs2 - NPubs2),
+    ?assert(NMsgs2 > NPubs2, {NMsgs2, '>', NPubs2}),
+    ?assert(NMsgs2 >= NPubs - NAcked, Msgs2),
+    NSame = NMsgs2 - NPubs2,
     ?assert(
         lists:all(fun(#{dup := Dup}) -> Dup end, lists:sublist(Msgs2, NSame))
     ),
@@ -780,6 +781,11 @@ t_publish_many_while_client_is_gone(Config) ->
     %% for its subscriptions after the client dies or reconnects, in addition
     %% to PUBRELs for the messages it has PUBRECed. While client must send
     %% PUBACKs and PUBRECs in order, those orders are independent of each other.
+    %%
+    %% Developer's note: for simplicity we publish all messages to the
+    %% same topic, since persistent session ds may reorder messages
+    %% that belong to different streams, and this particular test is
+    %% very sensitive the order.
     ClientId = ?config(client_id, Config),
     ConnFun = ?config(conn_fun, Config),
     ClientOpts = [
@@ -792,20 +798,18 @@ t_publish_many_while_client_is_gone(Config) ->
 
     {ok, Client1} = emqtt:start_link([{clean_start, true} | ClientOpts]),
     {ok, _} = emqtt:ConnFun(Client1),
-    {ok, _, [?QOS_1]} = emqtt:subscribe(Client1, <<"t/+/foo">>, ?QOS_1),
-    {ok, _, [?QOS_2]} = emqtt:subscribe(Client1, <<"msg/feed/#">>, ?QOS_2),
-    {ok, _, [?QOS_2]} = emqtt:subscribe(Client1, <<"loc/+/+/+">>, ?QOS_2),
+    {ok, _, [?QOS_2]} = emqtt:subscribe(Client1, <<"t">>, ?QOS_2),
 
     Pubs1 = [
-        #mqtt_msg{topic = <<"t/42/foo">>, payload = <<"M1">>, qos = 1},
-        #mqtt_msg{topic = <<"t/42/foo">>, payload = <<"M2">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M3">>, qos = 2},
-        #mqtt_msg{topic = <<"loc/1/2/42">>, payload = <<"M4">>, qos = 2},
-        #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M5">>, qos = 2},
-        #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M6">>, qos = 1},
-        #mqtt_msg{topic = <<"loc/3/4/5">>, payload = <<"M7">>, qos = 2},
-        #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M8">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M9">>, qos = 2}
+        #mqtt_msg{topic = <<"t">>, payload = <<"M1">>, qos = 1},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M2">>, qos = 1},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M3">>, qos = 2},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M4">>, qos = 2},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M5">>, qos = 2},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M6">>, qos = 1},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M7">>, qos = 2},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M8">>, qos = 1},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M9">>, qos = 2}
     ],
     ok = publish_many(Pubs1),
     NPubs1 = length(Pubs1),
@@ -827,7 +831,7 @@ t_publish_many_while_client_is_gone(Config) ->
         [PktId || #{qos := 1, packet_id := PktId} <- Msgs1]
     ),
 
-    %% PUBREC first `NRecs` QoS 2 messages.
+    %% PUBREC first `NRecs` QoS 2 messages (up to "M5")
     NRecs = 3,
     PubRecs1 = lists:sublist([PktId || #{qos := 2, packet_id := PktId} <- Msgs1], NRecs),
     lists:foreach(
@@ -851,9 +855,9 @@ t_publish_many_while_client_is_gone(Config) ->
     maybe_kill_connection_process(ClientId, Config),
 
     Pubs2 = [
-        #mqtt_msg{topic = <<"loc/3/4/5">>, payload = <<"M10">>, qos = 2},
-        #mqtt_msg{topic = <<"t/100/foo">>, payload = <<"M11">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/friend">>, payload = <<"M12">>, qos = 2}
+        #mqtt_msg{topic = <<"t">>, payload = <<"M10">>, qos = 2},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M11">>, qos = 1},
+        #mqtt_msg{topic = <<"t">>, payload = <<"M12">>, qos = 2}
     ],
     ok = publish_many(Pubs2),
     NPubs2 = length(Pubs2),
@@ -886,8 +890,8 @@ t_publish_many_while_client_is_gone(Config) ->
         Msgs2Dups
     ),
 
-    %% Now complete all yet incomplete QoS 2 message flows instead.
-    PubRecs2 = [PktId || #{qos := 2, packet_id := PktId} <- Msgs2],
+    %% Ack more messages:
+    PubRecs2 = lists:sublist([PktId || #{qos := 2, packet_id := PktId} <- Msgs2], 2),
     lists:foreach(
         fun(PktId) -> ok = emqtt:pubrec(Client2, PktId) end,
         PubRecs2
@@ -903,6 +907,7 @@ t_publish_many_while_client_is_gone(Config) ->
 
     %% PUBCOMP every PUBREL.
     PubComps = [PktId || {pubrel, #{packet_id := PktId}} <- PubRels1 ++ PubRels2],
+    ct:pal("PubComps: ~p", [PubComps]),
     lists:foreach(
         fun(PktId) -> ok = emqtt:pubcomp(Client2, PktId) end,
         PubComps
@@ -910,19 +915,19 @@ t_publish_many_while_client_is_gone(Config) ->
 
     %% Ensure that PUBCOMPs are propagated to the channel.
     pong = emqtt:ping(Client2),
-
+    %% Reconnect for the last time
     ok = disconnect_client(Client2),
     maybe_kill_connection_process(ClientId, Config),
 
     {ok, Client3} = emqtt:start_link([{clean_start, false} | ClientOpts]),
     {ok, _} = emqtt:ConnFun(Client3),
 
-    %% Only the last unacked QoS 1 message should be retransmitted.
+    %% Check that the messages are retransmitted with DUP=1:
     Msgs3 = receive_messages(NPubs, _Timeout = 2000),
     ct:pal("Msgs3 = ~p", [Msgs3]),
     ?assertMatch(
-        [#{topic := <<"t/100/foo">>, payload := <<"M11">>, qos := 1, dup := true}],
-        Msgs3
+        [<<"M10">>, <<"M11">>, <<"M12">>],
+        [I || #{payload := I} <- Msgs3]
     ),
 
     ok = disconnect_client(Client3).

From f5b9bd30aa10cc1fbd6a44644f8ba53cd9dc1526 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 12 Jan 2024 03:08:49 +0100
Subject: [PATCH 087/273] fix(sessds): Apply review remarks

---
 apps/emqx/src/emqx_persistent_session_ds.erl      | 13 +++++++------
 apps/emqx/src/emqx_persistent_session_ds.hrl      | 15 +++++++++------
 .../src/emqx_persistent_session_ds_gc_worker.erl  |  2 +-
 .../src/emqx_persistent_session_ds_inflight.erl   |  3 ---
 .../emqx/src/emqx_persistent_session_ds_state.erl | 11 ++++++-----
 ...mqx_persistent_session_ds_stream_scheduler.erl |  2 +-
 apps/emqx/test/emqx_persistent_session_SUITE.erl  |  2 +-
 changes/ce/feat-12251.en.md                       |  7 +++++++
 8 files changed, 32 insertions(+), 23 deletions(-)
 create mode 100644 changes/ce/feat-12251.en.md

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 7d4ab71d6..43a0f1bec 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -373,7 +373,7 @@ publish(_PacketId, Msg, Session) ->
     {ok, emqx_types:message(), replies(), session()}
     | {error, emqx_types:reason_code()}.
 puback(_ClientInfo, PacketId, Session0) ->
-    case commit_seqno(puback, PacketId, Session0) of
+    case update_seqno(puback, PacketId, Session0) of
         {ok, Msg, Session} ->
             {ok, Msg, [], inc_send_quota(Session)};
         Error ->
@@ -388,7 +388,7 @@ puback(_ClientInfo, PacketId, Session0) ->
     {ok, emqx_types:message(), session()}
     | {error, emqx_types:reason_code()}.
 pubrec(PacketId, Session0) ->
-    case commit_seqno(pubrec, PacketId, Session0) of
+    case update_seqno(pubrec, PacketId, Session0) of
         {ok, Msg, Session} ->
             {ok, Msg, Session};
         Error = {error, _} ->
@@ -413,7 +413,7 @@ pubrel(_PacketId, Session = #{}) ->
     {ok, emqx_types:message(), replies(), session()}
     | {error, emqx_types:reason_code()}.
 pubcomp(_ClientInfo, PacketId, Session0) ->
-    case commit_seqno(pubcomp, PacketId, Session0) of
+    case update_seqno(pubcomp, PacketId, Session0) of
         {ok, Msg, Session} ->
             {ok, Msg, [], inc_send_quota(Session)};
         Error = {error, _} ->
@@ -540,6 +540,7 @@ sync(ClientId) ->
                 {'DOWN', Ref, process, _Pid, Reason} ->
                     {error, Reason};
                 Ref ->
+                    demonitor(Ref, [flush]),
                     ok
             end;
         [] ->
@@ -767,7 +768,7 @@ process_batch(
                     SeqNoQos2 = inc_seqno(?QOS_2, SeqNoQos20)
             end,
             {
-                case Msg#message.qos of
+                case Qos of
                     ?QOS_0 when IsReplay ->
                         %% We ignore QoS 0 messages during replay:
                         Acc;
@@ -895,9 +896,9 @@ bump_interval() ->
 %% SeqNo tracking
 %% --------------------------------------------------------------------
 
--spec commit_seqno(puback | pubrec | pubcomp, emqx_types:packet_id(), session()) ->
+-spec update_seqno(puback | pubrec | pubcomp, emqx_types:packet_id(), session()) ->
     {ok, emqx_types:message(), session()} | {error, _}.
-commit_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
+update_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
     SeqNo = packet_id_to_seqno(PacketId, S),
     case Track of
         puback ->
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 6ab2d4c1f..8286a4e41 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -31,7 +31,7 @@
 %%   -----|----------|-----|-----|------> seqno
 %%        |          |     |     |
 %%   committed      dup   rec   next
-%                        (Qos2)
+%%                       (Qos2)
 
 %% Seqno becomes committed after receiving PUBACK for QoS1 or PUBCOMP
 %% for QoS2.
@@ -41,23 +41,26 @@
 %% committed..dup range are retransmitted with DUP flag.
 %%
 -define(dup(QOS), (10 + QOS)).
+%% Rec flag is specific for the QoS2. It contains seqno of the last
+%% PUBREC received from the client. When the session reconnects,
+%% PUBREL packages for the dup..rec range are retransmitted.
 -define(rec, 22).
-%% Last seqno assigned to a message.
+%% Last seqno assigned to a message (it may not be sent yet).
 -define(next(QOS), (30 + QOS)).
 
 %%%%% State of the stream:
 -record(ifs, {
     rank_x :: emqx_ds:rank_x(),
     rank_y :: emqx_ds:rank_y(),
-    %% Iterator at the beginning and end of the last batch:
+    %% Iterators at the beginning and the end of the last batch:
     it_begin :: emqx_ds:iterator() | undefined,
     it_end :: emqx_ds:iterator() | end_of_stream,
-    %% Key that points at the beginning of the batch:
+    %% Size of the last batch:
     batch_size = 0 :: non_neg_integer(),
-    %% Session sequence number at the time when the batch was fetched:
+    %% Session sequence numbers at the time when the batch was fetched:
     first_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
     first_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno(),
-    %% Number of messages collected in the last batch:
+    %% Sequence numbers that have to be committed for the batch:
     last_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
     last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno()
 }).
diff --git a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
index 4ff420eb8..66f5c9b4e 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
@@ -126,7 +126,7 @@ gc_loop(MinLastAlive, It0) ->
 
 do_gc(SessionId, MinLastAlive, LastAliveAt, EI) when LastAliveAt + EI < MinLastAlive ->
     emqx_persistent_session_ds:destroy_session(SessionId),
-    ?tp(error, ds_session_gc_cleaned, #{
+    ?tp(debug, ds_session_gc_cleaned, #{
         session_id => SessionId,
         last_alive_at => LastAliveAt,
         expiry_interval => EI,
diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index 2938222e9..a769fce64 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -18,9 +18,6 @@
 %% API:
 -export([new/1, push/2, pop/1, n_buffered/2, n_inflight/1, inc_send_quota/1, receive_maximum/1]).
 
-%% behavior callbacks:
--export([]).
-
 %% internal exports:
 -export([]).
 
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index fbd4fcc22..57f2316b7 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -68,9 +68,10 @@
 %% It should be possible to make frequent changes to the pmap without
 %% stressing Mria.
 %%
-%% It's implemented as three maps: `clean', `dirty' and `tombstones'.
-%% Updates are made to the `dirty' area. `pmap_commit' function saves
-%% the updated entries to Mnesia and moves them to the `clean' area.
+%% It's implemented as two maps: `cache', and `dirty'. `cache' stores
+%% the data, and `dirty' contains information about dirty and deleted
+%% keys. When `commit/1' is called, dirty keys are dumped to the
+%% tables, and deleted keys are removed from the tables.
 -record(pmap, {table, cache, dirty}).
 
 -type pmap(K, V) ::
@@ -530,9 +531,9 @@ kv_pmap_persist(Tab, SessionId, Key, Val0) ->
     mnesia:write(Tab, #kv{k = {SessionId, Key}, v = Val}, write).
 
 kv_pmap_restore(Table, SessionId) ->
-    MS = [{#kv{k = {SessionId, '_'}, _ = '_'}, [], ['$_']}],
+    MS = [{#kv{k = {SessionId, '$1'}, v = '$2'}, [], [{{'$1', '$2'}}]}],
     Objs = mnesia:select(Table, MS, read),
-    [{K, encoder(decode, Table, V)} || #kv{k = {_, K}, v = V} <- Objs].
+    [{K, encoder(decode, Table, V)} || {K, V} <- Objs].
 
 kv_pmap_delete(Table, SessionId) ->
     MS = [{#kv{k = {SessionId, '$1'}, _ = '_'}, [], ['$1']}],
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index e0de96454..621355005 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -142,7 +142,7 @@ ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
     case emqx_persistent_session_ds_state:get_stream(Key, S) of
         undefined ->
             ?SLOG(debug, #{
-                '$msg' => new_stream, key => Key, stream => Stream
+                msg => new_stream, key => Key, stream => Stream
             }),
             {ok, Iterator} = emqx_ds:make_iterator(
                 ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 008fc177c..3fc76d4b5 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -554,7 +554,7 @@ t_process_dies_session_expires(Config) ->
 
     ok = publish(Topic, Payload),
 
-    timer:sleep(1100),
+    timer:sleep(2000),
 
     {ok, Client2} = emqtt:start_link([
         {proto_ver, v5},
diff --git a/changes/ce/feat-12251.en.md b/changes/ce/feat-12251.en.md
new file mode 100644
index 000000000..a206288b5
--- /dev/null
+++ b/changes/ce/feat-12251.en.md
@@ -0,0 +1,7 @@
+Optimize performance of the RocksDB-based persistent session.
+Reduce RAM usage and frequency of database requests.
+
+- Introduce dirty session state to avoid frequent mria transactions
+- Introduce an intermediate buffer for the persistent messages
+- Use separate tracks of PacketIds for QoS1 and QoS2 messages
+- Limit the number of continuous ranges of infligtht messages to one per stream

From ebe2339810dbd55b7b65a0e34bc2481de5adc8ee Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sat, 13 Jan 2024 05:07:16 +0100
Subject: [PATCH 088/273] fix(sessds): Use mria:async_dirty instead of
 transaction

---
 .../src/emqx_persistent_session_ds_state.erl  | 24 ++++++++++++-------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 57f2316b7..a4b349c9e 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -550,17 +550,23 @@ kv_pmap_delete(Table, SessionId, Key) ->
 %%
 
 transaction(Fun) ->
-    case mnesia:is_transaction() of
-        true ->
-            Fun();
-        false ->
-            {atomic, Res} = mria:transaction(?DS_MRIA_SHARD, Fun),
-            Res
-    end.
+    mria:async_dirty(?DS_MRIA_SHARD, Fun).
 
 ro_transaction(Fun) ->
-    {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
-    Res.
+    mria:async_dirty(?DS_MRIA_SHARD, Fun).
+
+%% transaction(Fun) ->
+%%     case mnesia:is_transaction() of
+%%         true ->
+%%             Fun();
+%%         false ->
+%%             {atomic, Res} = mria:transaction(?DS_MRIA_SHARD, Fun),
+%%             Res
+%%     end.
+
+%% ro_transaction(Fun) ->
+%%     {atomic, Res} = mria:ro_transaction(?DS_MRIA_SHARD, Fun),
+%%     Res.
 
 -compile({inline, check_sequence/1}).
 

From 974760d3312fccb3d2170afc0a13ccdc853125ab Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 15 Jan 2024 12:30:29 +0100
Subject: [PATCH 089/273] test(sessds): Don't trap exits in the test

---
 ...emqx_persistent_session_ds_state_tests.erl | 28 +++++++++----------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
index 35554829a..ebf04eeb3 100644
--- a/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
+++ b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
@@ -44,21 +44,19 @@ prop_consistency() ->
     ?FORALL(
         Cmds,
         commands(?MODULE),
-        ?TRAPEXIT(
-            begin
-                init(),
-                {_History, State, Result} = run_commands(?MODULE, Cmds),
-                clean(),
-                ?WHENFAIL(
-                    io:format(
-                        user,
-                        "Operations: ~p~nState: ~p\nResult: ~p~n",
-                        [Cmds, State, Result]
-                    ),
-                    aggregate(command_names(Cmds), Result =:= ok)
-                )
-            end
-        )
+        begin
+            init(),
+            {_History, State, Result} = run_commands(?MODULE, Cmds),
+            clean(),
+            ?WHENFAIL(
+                io:format(
+                    user,
+                    "Operations: ~p~nState: ~p\nResult: ~p~n",
+                    [Cmds, State, Result]
+                ),
+                aggregate(command_names(Cmds), Result =:= ok)
+            )
+        end
     ).
 
 %%================================================================================

From 2d2321279240e4be2854a6d0e9b47063e9e326f6 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Tue, 16 Jan 2024 10:24:07 +0100
Subject: [PATCH 090/273] refactor(sessds): #ifs -> #srs

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 40 +++++++++----------
 apps/emqx/src/emqx_persistent_session_ds.hrl  |  4 +-
 ...persistent_session_ds_stream_scheduler.erl | 16 ++++----
 3 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 43a0f1bec..9f77c4219 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -138,7 +138,7 @@
     ref :: reference()
 }).
 
--type stream_state() :: #ifs{}.
+-type stream_state() :: #srs{}.
 
 -type timestamp() :: emqx_utils_calendar:epoch_millisecond().
 -type millisecond() :: non_neg_integer().
@@ -495,15 +495,15 @@ replay(ClientInfo, [], Session0 = #{s := S0}) ->
     {ok, [], pull_now(Session)}.
 
 -spec replay_batch(stream_state(), session(), clientinfo()) -> session().
-replay_batch(Ifs0, Session, ClientInfo) ->
-    #ifs{batch_size = BatchSize} = Ifs0,
+replay_batch(Srs0, Session, ClientInfo) ->
+    #srs{batch_size = BatchSize} = Srs0,
     %% TODO: retry on errors:
-    {Ifs, Inflight} = enqueue_batch(true, BatchSize, Ifs0, Session, ClientInfo),
+    {Srs, Inflight} = enqueue_batch(true, BatchSize, Srs0, Session, ClientInfo),
     %% Assert:
-    Ifs =:= Ifs0 orelse
+    Srs =:= Srs0 orelse
         ?tp(warning, emqx_persistent_session_ds_replay_inconsistency, #{
-            expected => Ifs0,
-            got => Ifs
+            expected => Srs0,
+            got => Srs
         }),
     Session#{inflight => Inflight}.
 
@@ -678,29 +678,29 @@ fetch_new_messages([I | Streams], Session0 = #{inflight := Inflight}, ClientInfo
             fetch_new_messages(Streams, Session, ClientInfo)
     end.
 
-new_batch({StreamKey, Ifs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
+new_batch({StreamKey, Srs0}, BatchSize, Session = #{s := S0}, ClientInfo) ->
     SN1 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0),
     SN2 = emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0),
-    Ifs1 = Ifs0#ifs{
+    Srs1 = Srs0#srs{
         first_seqno_qos1 = SN1,
         first_seqno_qos2 = SN2,
         batch_size = 0,
         last_seqno_qos1 = SN1,
         last_seqno_qos2 = SN2
     },
-    {Ifs, Inflight} = enqueue_batch(false, BatchSize, Ifs1, Session, ClientInfo),
-    S1 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), Ifs#ifs.last_seqno_qos1, S0),
-    S2 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), Ifs#ifs.last_seqno_qos2, S1),
-    S = emqx_persistent_session_ds_state:put_stream(StreamKey, Ifs, S2),
+    {Srs, Inflight} = enqueue_batch(false, BatchSize, Srs1, Session, ClientInfo),
+    S1 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), Srs#srs.last_seqno_qos1, S0),
+    S2 = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), Srs#srs.last_seqno_qos2, S1),
+    S = emqx_persistent_session_ds_state:put_stream(StreamKey, Srs, S2),
     Session#{s => S, inflight => Inflight}.
 
-enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, ClientInfo) ->
-    #ifs{
+enqueue_batch(IsReplay, BatchSize, Srs0, Session = #{inflight := Inflight0}, ClientInfo) ->
+    #srs{
         it_begin = ItBegin0,
         it_end = ItEnd0,
         first_seqno_qos1 = FirstSeqnoQos1,
         first_seqno_qos2 = FirstSeqnoQos2
-    } = Ifs0,
+    } = Srs0,
     ItBegin =
         case IsReplay of
             true -> ItBegin0;
@@ -711,7 +711,7 @@ enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, Cli
             {Inflight, LastSeqnoQos1, LastSeqnoQos2} = process_batch(
                 IsReplay, Session, ClientInfo, FirstSeqnoQos1, FirstSeqnoQos2, Messages, Inflight0
             ),
-            Ifs = Ifs0#ifs{
+            Srs = Srs0#srs{
                 it_begin = ItBegin,
                 it_end = ItEnd,
                 %% TODO: it should be possible to avoid calling
@@ -721,13 +721,13 @@ enqueue_batch(IsReplay, BatchSize, Ifs0, Session = #{inflight := Inflight0}, Cli
                 last_seqno_qos1 = LastSeqnoQos1,
                 last_seqno_qos2 = LastSeqnoQos2
             },
-            {Ifs, Inflight};
+            {Srs, Inflight};
         {ok, end_of_stream} ->
             %% No new messages; just update the end iterator:
-            {Ifs0#ifs{it_begin = ItBegin, it_end = end_of_stream, batch_size = 0}, Inflight0};
+            {Srs0#srs{it_begin = ItBegin, it_end = end_of_stream, batch_size = 0}, Inflight0};
         {error, _} when not IsReplay ->
             ?SLOG(info, #{msg => "failed_to_fetch_batch", iterator => ItBegin}),
-            {Ifs0, Inflight0}
+            {Srs0, Inflight0}
     end.
 
 %% key_of_iter(#{3 := #{3 := #{5 := K}}}) ->
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index 8286a4e41..f097b2c6e 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -48,8 +48,8 @@
 %% Last seqno assigned to a message (it may not be sent yet).
 -define(next(QOS), (30 + QOS)).
 
-%%%%% State of the stream:
--record(ifs, {
+%%%%% Stream Replay State:
+-record(srs, {
     rank_x :: emqx_ds:rank_x(),
     rank_y :: emqx_ds:rank_y(),
     %% Iterators at the beginning and the end of the last batch:
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 621355005..5df56843f 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -147,14 +147,14 @@ ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
             {ok, Iterator} = emqx_ds:make_iterator(
                 ?PERSISTENT_MESSAGE_DB, Stream, TopicFilter, StartTime
             ),
-            NewStreamState = #ifs{
+            NewStreamState = #srs{
                 rank_x = RankX,
                 rank_y = RankY,
                 it_begin = Iterator,
                 it_end = Iterator
             },
             emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
-        #ifs{} ->
+        #srs{} ->
             S
     end.
 
@@ -199,7 +199,7 @@ remove_fully_replayed_streams(S0) ->
     CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
     %% 1. For each subscription, find the X ranks that were fully replayed:
     Groups = emqx_persistent_session_ds_state:fold_streams(
-        fun({SubId, _Stream}, StreamState = #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
+        fun({SubId, _Stream}, StreamState = #srs{rank_x = RankX, rank_y = RankY}, Acc) ->
             Key = {SubId, RankX},
             case
                 {maps:get(Key, Acc, undefined), is_fully_replayed(CommQos1, CommQos2, StreamState)}
@@ -228,7 +228,7 @@ remove_fully_replayed_streams(S0) ->
     ),
     %% 3. Remove the fully replayed streams:
     emqx_persistent_session_ds_state:fold_streams(
-        fun(Key = {SubId, _Stream}, #ifs{rank_x = RankX, rank_y = RankY}, Acc) ->
+        fun(Key = {SubId, _Stream}, #srs{rank_x = RankX, rank_y = RankY}, Acc) ->
             case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
                 undefined ->
                     Acc;
@@ -249,8 +249,8 @@ remove_fully_replayed_streams(S0) ->
     ).
 
 compare_streams(
-    {_KeyA, #ifs{first_seqno_qos1 = A1, first_seqno_qos2 = A2}},
-    {_KeyB, #ifs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}}
+    {_KeyA, #srs{first_seqno_qos1 = A1, first_seqno_qos2 = A2}},
+    {_KeyB, #srs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}}
 ) ->
     case A1 =:= B1 of
         true ->
@@ -259,10 +259,10 @@ compare_streams(
             A1 < B1
     end.
 
-is_fully_replayed(Comm1, Comm2, S = #ifs{it_end = It}) ->
+is_fully_replayed(Comm1, Comm2, S = #srs{it_end = It}) ->
     It =:= end_of_stream andalso is_fully_acked(Comm1, Comm2, S).
 
-is_fully_acked(Comm1, Comm2, #ifs{last_seqno_qos1 = S1, last_seqno_qos2 = S2}) ->
+is_fully_acked(Comm1, Comm2, #srs{last_seqno_qos1 = S1, last_seqno_qos2 = S2}) ->
     (Comm1 >= S1) andalso (Comm2 >= S2).
 
 -spec shuffle([A]) -> [A].

From 3c451c6ae60cc455b8d9c082866d5fca7ed359c6 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Tue, 16 Jan 2024 17:02:06 +0100
Subject: [PATCH 091/273] test(sessds): Fix unstable tests

---
 .../emqx_persistent_session_ds_SUITE.erl      | 120 +++++++-----------
 apps/emqx/src/emqx_persistent_session_ds.erl  |  34 +++--
 apps/emqx/src/emqx_persistent_session_ds.hrl  |   7 +
 .../emqx_persistent_session_ds_gc_worker.erl  |  33 +++--
 .../src/emqx_persistent_session_ds_state.erl  |  24 ++--
 ...persistent_session_ds_stream_scheduler.erl |   8 +-
 .../test/emqx_persistent_session_SUITE.erl    |  68 +++++-----
 changes/ce/feat-12251.en.md                   |   2 +-
 8 files changed, 138 insertions(+), 158 deletions(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index f834b8098..40ffe7f32 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -91,7 +91,7 @@ end_per_testcase(_TestCase, _Config) ->
     ok.
 
 %%------------------------------------------------------------------------------
-%% Helper fns
+%% Helper functions
 %%------------------------------------------------------------------------------
 
 cluster(#{n := N} = Opts) ->
@@ -147,9 +147,9 @@ start_client(Opts0 = #{}) ->
         proto_ver => v5,
         properties => #{'Session-Expiry-Interval' => 300}
     },
-    Opts = maps:to_list(emqx_utils_maps:deep_merge(Defaults, Opts0)),
-    ct:pal("starting client with opts:\n  ~p", [Opts]),
-    {ok, Client} = emqtt:start_link(Opts),
+    Opts = emqx_utils_maps:deep_merge(Defaults, Opts0),
+    ?tp(notice, "starting client", Opts),
+    {ok, Client} = emqtt:start_link(maps:to_list(Opts)),
     unlink(Client),
     on_exit(fun() -> catch emqtt:stop(Client) end),
     Client.
@@ -186,33 +186,6 @@ list_all_pubranges(Node) ->
 %% Testcases
 %%------------------------------------------------------------------------------
 
-t_non_persistent_session_subscription(_Config) ->
-    ClientId = atom_to_binary(?FUNCTION_NAME),
-    SubTopicFilter = <<"t/#">>,
-    ?check_trace(
-        #{timetrap => 30_000},
-        begin
-            ?tp(notice, "starting", #{}),
-            Client = start_client(#{
-                clientid => ClientId,
-                properties => #{'Session-Expiry-Interval' => 0}
-            }),
-            {ok, _} = emqtt:connect(Client),
-            ?tp(notice, "subscribing", #{}),
-            {ok, _, [?RC_GRANTED_QOS_2]} = emqtt:subscribe(Client, SubTopicFilter, qos2),
-
-            ok = emqtt:stop(Client),
-
-            ok
-        end,
-        fun(Trace) ->
-            ct:pal("trace:\n  ~p", [Trace]),
-            ?assertEqual([], ?of_kind(ds_session_subscription_added, Trace)),
-            ok
-        end
-    ),
-    ok.
-
 t_session_subscription_idempotency(Config) ->
     [Node1Spec | _] = ?config(node_specs, Config),
     [Node1] = ?config(nodes, Config),
@@ -222,7 +195,6 @@ t_session_subscription_idempotency(Config) ->
     ?check_trace(
         #{timetrap => 30_000},
         begin
-            #{timetrap => 20_000},
             ?force_ordering(
                 #{?snk_kind := persistent_session_ds_subscription_added},
                 _NEvents0 = 1,
@@ -553,14 +525,14 @@ t_session_gc(Config) ->
     ?check_trace(
         #{timetrap => 30_000},
         begin
-            ClientId0 = <<"session_gc0">>,
-            Client0 = StartClient(ClientId0, Port1, 30),
-
             ClientId1 = <<"session_gc1">>,
-            Client1 = StartClient(ClientId1, Port2, 1),
+            Client1 = StartClient(ClientId1, Port1, 30),
 
             ClientId2 = <<"session_gc2">>,
-            Client2 = StartClient(ClientId2, Port3, 1),
+            Client2 = StartClient(ClientId2, Port2, 1),
+
+            ClientId3 = <<"session_gc3">>,
+            Client3 = StartClient(ClientId3, Port3, 1),
 
             lists:foreach(
                 fun(Client) ->
@@ -570,52 +542,41 @@ t_session_gc(Config) ->
                     {ok, _} = emqtt:publish(Client, Topic, Payload, ?QOS_1),
                     ok
                 end,
-                [Client0, Client1, Client2]
+                [Client1, Client2, Client3]
             ),
 
             %% Clients are still alive; no session is garbage collected.
-            Res0 = ?block_until(
-                #{
-                    ?snk_kind := ds_session_gc,
-                    ?snk_span := {complete, _},
-                    ?snk_meta := #{node := N}
-                } when
-                    N =/= node(),
-                3 * GCInterval + 1_000
-            ),
-            ?assertMatch({ok, _}, Res0),
-            {ok, #{?snk_meta := #{time := T0}}} = Res0,
-            ?assertMatch([_, _, _], list_all_sessions(Node1), sessions),
-            ?assertMatch([_, _, _], list_all_subscriptions(Node1), subscriptions),
-
-            %% Now we disconnect 2 of them; only those should be GC'ed.
-            ?assertMatch(
-                {ok, {ok, _}},
-                ?wait_async_action(
-                    emqtt:stop(Client1),
-                    #{?snk_kind := terminate},
-                    1_000
-                )
-            ),
-            ct:pal("disconnected client1"),
-            ?assertMatch(
-                {ok, {ok, _}},
-                ?wait_async_action(
-                    emqtt:stop(Client2),
-                    #{?snk_kind := terminate},
-                    1_000
-                )
-            ),
-            ct:pal("disconnected client2"),
             ?assertMatch(
                 {ok, _},
                 ?block_until(
                     #{
-                        ?snk_kind := ds_session_gc_cleaned,
-                        session_id := ClientId1
-                    }
+                        ?snk_kind := ds_session_gc,
+                        ?snk_span := {complete, _},
+                        ?snk_meta := #{node := N}
+                    } when N =/= node()
                 )
             ),
+            ?assertMatch([_, _, _], list_all_sessions(Node1), sessions),
+            ?assertMatch([_, _, _], list_all_subscriptions(Node1), subscriptions),
+
+            %% Now we disconnect 2 of them; only those should be GC'ed.
+
+            ?assertMatch(
+                {ok, {ok, _}},
+                ?wait_async_action(
+                    emqtt:stop(Client2),
+                    #{?snk_kind := terminate}
+                )
+            ),
+            ?tp(notice, "disconnected client1", #{}),
+            ?assertMatch(
+                {ok, {ok, _}},
+                ?wait_async_action(
+                    emqtt:stop(Client3),
+                    #{?snk_kind := terminate}
+                )
+            ),
+            ?tp(notice, "disconnected client2", #{}),
             ?assertMatch(
                 {ok, _},
                 ?block_until(
@@ -625,7 +586,16 @@ t_session_gc(Config) ->
                     }
                 )
             ),
-            ?assertMatch([_], list_all_sessions(Node1), sessions),
+            ?assertMatch(
+                {ok, _},
+                ?block_until(
+                    #{
+                        ?snk_kind := ds_session_gc_cleaned,
+                        session_id := ClientId3
+                    }
+                )
+            ),
+            ?assertMatch([ClientId1], list_all_sessions(Node1), sessions),
             ?assertMatch([_], list_all_subscriptions(Node1), subscriptions),
             ok
         end,
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 9f77c4219..6f32b1549 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -79,7 +79,7 @@
     do_ensure_all_iterators_closed/1
 ]).
 
--export([print_session/1]).
+-export([print_session/1, seqno_diff/4]).
 
 -ifdef(TEST).
 -export([
@@ -152,8 +152,7 @@
     inflight_cnt,
     inflight_max,
     mqueue_len,
-    mqueue_dropped,
-    awaiting_rel_cnt
+    mqueue_dropped
 ]).
 
 %%
@@ -233,8 +232,8 @@ info(mqueue_dropped, _Session) ->
 %%     PacketId;
 % info(awaiting_rel, #sessmem{awaiting_rel = AwaitingRel}) ->
 %     AwaitingRel;
-info(awaiting_rel_cnt, #{s := S}) ->
-    seqno_diff(?QOS_2, ?rec, ?committed(?QOS_2), S);
+%% info(awaiting_rel_cnt, #{s := S}) ->
+%%     seqno_diff(?QOS_2, ?rec, ?committed(?QOS_2), S);
 info(awaiting_rel_max, #{props := Conf}) ->
     maps:get(max_awaiting_rel, Conf);
 info(await_rel_timeout, #{props := Conf}) ->
@@ -271,6 +270,8 @@ subscribe(
 ) ->
     case subs_lookup(TopicFilter, S0) of
         undefined ->
+            %% TODO: max subscriptions
+
             %% N.B.: we chose to update the router before adding the
             %% subscription to the session/iterator table. The
             %% reasoning for this is as follows:
@@ -511,16 +512,21 @@ replay_batch(Srs0, Session, ClientInfo) ->
 
 -spec disconnect(session(), emqx_types:conninfo()) -> {shutdown, session()}.
 disconnect(Session = #{s := S0}, ConnInfo) ->
-    OldConnInfo = emqx_persistent_session_ds_state:get_conninfo(S0),
-    NewConnInfo = maps:merge(OldConnInfo, maps:with([expiry_interval], ConnInfo)),
     S1 = emqx_persistent_session_ds_state:set_last_alive_at(now_ms(), S0),
-    S2 = emqx_persistent_session_ds_state:set_conninfo(NewConnInfo, S1),
+    S2 =
+        case ConnInfo of
+            #{expiry_interval := EI} when is_number(EI) ->
+                emqx_persistent_session_ds_state:set_expiry_interval(EI, S1);
+            _ ->
+                S1
+        end,
     S = emqx_persistent_session_ds_state:commit(S2),
     {shutdown, Session#{s => S}}.
 
 -spec terminate(Reason :: term(), session()) -> ok.
-terminate(_Reason, _Session = #{s := S}) ->
+terminate(_Reason, _Session = #{id := Id, s := S}) ->
     _ = emqx_persistent_session_ds_state:commit(S),
+    ?tp(debug, persistent_session_ds_terminate, #{id => Id}),
     ok.
 
 %%--------------------------------------------------------------------
@@ -558,7 +564,7 @@ session_open(SessionId, NewConnInfo) ->
     NowMS = now_ms(),
     case emqx_persistent_session_ds_state:open(SessionId) of
         {ok, S0} ->
-            EI = expiry_interval(emqx_persistent_session_ds_state:get_conninfo(S0)),
+            EI = emqx_persistent_session_ds_state:get_expiry_interval(S0),
             LastAliveAt = emqx_persistent_session_ds_state:get_last_alive_at(S0),
             case NowMS >= LastAliveAt + EI of
                 true ->
@@ -567,7 +573,7 @@ session_open(SessionId, NewConnInfo) ->
                 false ->
                     ?tp(open_session, #{ei => EI, now => NowMS, laa => LastAliveAt}),
                     %% New connection being established
-                    S1 = emqx_persistent_session_ds_state:set_conninfo(NewConnInfo, S0),
+                    S1 = emqx_persistent_session_ds_state:set_expiry_interval(EI, S0),
                     S2 = emqx_persistent_session_ds_state:set_last_alive_at(NowMS, S1),
                     S = emqx_persistent_session_ds_state:commit(S2),
                     Inflight = emqx_persistent_session_ds_inflight:new(
@@ -587,9 +593,10 @@ session_open(SessionId, NewConnInfo) ->
 -spec session_ensure_new(id(), emqx_types:conninfo(), emqx_session:conf()) ->
     session().
 session_ensure_new(Id, ConnInfo, Conf) ->
+    ?tp(debug, persistent_session_ds_ensure_new, #{id => Id}),
     Now = now_ms(),
     S0 = emqx_persistent_session_ds_state:create_new(Id),
-    S1 = emqx_persistent_session_ds_state:set_conninfo(ConnInfo, S0),
+    S1 = emqx_persistent_session_ds_state:set_expiry_interval(expiry_interval(ConnInfo), S0),
     S2 = bump_last_alive(S1),
     S3 = emqx_persistent_session_ds_state:set_created_at(Now, S2),
     S4 = lists:foldl(
@@ -970,8 +977,7 @@ inc_seqno(Qos, SeqNo) ->
             NextSeqno
     end.
 
-%% Note: we use the least significant bit to store the QoS. Even
-%% packet IDs are QoS1, odd packet IDs are QoS2.
+%% Note: we use the most significant bit to store the QoS.
 seqno_to_packet_id(?QOS_1, SeqNo) ->
     SeqNo band ?PACKET_ID_MASK;
 seqno_to_packet_id(?QOS_2, SeqNo) ->
diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index f097b2c6e..fa4bfacf1 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -65,4 +65,11 @@
     last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno()
 }).
 
+%% Session metadata keys:
+-define(created_at, created_at).
+-define(last_alive_at, last_alive_at).
+-define(expiry_interval, expiry_interval).
+%% Unique integer used to create unique identities
+-define(last_id, last_id).
+
 -endif.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
index 66f5c9b4e..a4d1fe638 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_gc_worker.erl
@@ -69,7 +69,7 @@ handle_info(_Info, State) ->
     {noreply, State}.
 
 %%--------------------------------------------------------------------------------
-%% Internal fns
+%% Internal functions
 %%--------------------------------------------------------------------------------
 
 ensure_gc_timer() ->
@@ -116,22 +116,21 @@ gc_loop(MinLastAlive, It0) ->
         {[], _It} ->
             ok;
         {Sessions, It} ->
-            [
-                do_gc(SessionId, MinLastAlive, LastAliveAt, EI)
-             || {SessionId, #{last_alive_at := LastAliveAt, conninfo := #{expiry_interval := EI}}} <-
-                    Sessions
-            ],
+            [do_gc(SessionId, MinLastAlive, Metadata) || {SessionId, Metadata} <- Sessions],
             gc_loop(MinLastAlive, It)
     end.
 
-do_gc(SessionId, MinLastAlive, LastAliveAt, EI) when LastAliveAt + EI < MinLastAlive ->
-    emqx_persistent_session_ds:destroy_session(SessionId),
-    ?tp(debug, ds_session_gc_cleaned, #{
-        session_id => SessionId,
-        last_alive_at => LastAliveAt,
-        expiry_interval => EI,
-        min_last_alive => MinLastAlive
-    }),
-    ok;
-do_gc(_SessionId, _MinLastAliveAt, _LastAliveAt, _EI) ->
-    ok.
+do_gc(SessionId, MinLastAlive, Metadata) ->
+    #{?last_alive_at := LastAliveAt, ?expiry_interval := EI} = Metadata,
+    case LastAliveAt + EI < MinLastAlive of
+        true ->
+            emqx_persistent_session_ds:destroy_session(SessionId),
+            ?tp(debug, ds_session_gc_cleaned, #{
+                session_id => SessionId,
+                last_alive_at => LastAliveAt,
+                expiry_interval => EI,
+                min_last_alive => MinLastAlive
+            });
+        false ->
+            ok
+    end.
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index a4b349c9e..32d661354 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -29,7 +29,7 @@
 -export([open/1, create_new/1, delete/1, commit/1, format/1, print_session/1, list_sessions/0]).
 -export([get_created_at/1, set_created_at/2]).
 -export([get_last_alive_at/1, set_last_alive_at/2]).
--export([get_conninfo/1, set_conninfo/2]).
+-export([get_expiry_interval/1, set_expiry_interval/2]).
 -export([new_id/1]).
 -export([get_stream/2, put_stream/3, del_stream/2, fold_streams/3]).
 -export([get_seqno/2, put_seqno/3]).
@@ -81,18 +81,11 @@
         dirty :: #{K => dirty | del}
     }.
 
-%% Session metadata:
--define(created_at, created_at).
--define(last_alive_at, last_alive_at).
--define(conninfo, conninfo).
-%% Unique integer used to create unique identities
--define(last_id, last_id).
-
 -type metadata() ::
     #{
         ?created_at => emqx_persistent_session_ds:timestamp(),
         ?last_alive_at => emqx_persistent_session_ds:timestamp(),
-        ?conninfo => emqx_types:conninfo(),
+        ?expiry_interval => emqx_types:conninfo(),
         ?last_id => integer()
     }.
 
@@ -122,6 +115,7 @@
 -define(rank_tab, emqx_ds_session_ranks).
 -define(pmap_tables, [?stream_tab, ?seqno_tab, ?rank_tab, ?subscription_tab]).
 
+%% Enable this flag if you suspect some code breaks the sequence:
 -ifndef(CHECK_SEQNO).
 -define(set_dirty, dirty => true).
 -define(unset_dirty, dirty => false).
@@ -268,13 +262,13 @@ get_last_alive_at(Rec) ->
 set_last_alive_at(Val, Rec) ->
     set_meta(?last_alive_at, Val, Rec).
 
--spec get_conninfo(t()) -> emqx_types:conninfo() | undefined.
-get_conninfo(Rec) ->
-    get_meta(?conninfo, Rec).
+-spec get_expiry_interval(t()) -> non_neg_integer() | undefined.
+get_expiry_interval(Rec) ->
+    get_meta(?expiry_interval, Rec).
 
--spec set_conninfo(emqx_types:conninfo(), t()) -> t().
-set_conninfo(Val, Rec) ->
-    set_meta(?conninfo, Val, Rec).
+-spec set_expiry_interval(non_neg_integer(), t()) -> t().
+set_expiry_interval(Val, Rec) ->
+    set_meta(?expiry_interval, Val, Rec).
 
 -spec new_id(t()) -> {emqx_persistent_session_ds:subscription_id(), t()}.
 new_id(Rec) ->
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 5df56843f..b321b324b 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -201,12 +201,10 @@ remove_fully_replayed_streams(S0) ->
     Groups = emqx_persistent_session_ds_state:fold_streams(
         fun({SubId, _Stream}, StreamState = #srs{rank_x = RankX, rank_y = RankY}, Acc) ->
             Key = {SubId, RankX},
-            case
-                {maps:get(Key, Acc, undefined), is_fully_replayed(CommQos1, CommQos2, StreamState)}
-            of
-                {undefined, true} ->
+            case is_fully_replayed(CommQos1, CommQos2, StreamState) of
+                true when is_map_key(Key, Acc) ->
                     Acc#{Key => {true, RankY}};
-                {_, false} ->
+                true ->
                     Acc#{Key => false};
                 _ ->
                     Acc
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 3fc76d4b5..730fdd297 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -74,6 +74,7 @@ init_per_group(persistence_enabled, Config) ->
         {emqx_config,
             "session_persistence {\n"
             "  enable = true\n"
+            "  last_alive_update_interval = 100ms\n"
             "  renew_streams_interval = 100ms\n"
             "}"},
         {persistence, ds}
@@ -534,42 +535,47 @@ t_process_dies_session_expires(Config) ->
     %% Emulate an error in the connect process,
     %% or that the node of the process goes down.
     %% A persistent session should eventually expire.
-    ConnFun = ?config(conn_fun, Config),
-    ClientId = ?config(client_id, Config),
-    Topic = ?config(topic, Config),
-    STopic = ?config(stopic, Config),
-    Payload = <<"test">>,
-    {ok, Client1} = emqtt:start_link([
-        {proto_ver, v5},
-        {clientid, ClientId},
-        {properties, #{'Session-Expiry-Interval' => 1}},
-        {clean_start, true}
-        | Config
-    ]),
-    {ok, _} = emqtt:ConnFun(Client1),
-    {ok, _, [2]} = emqtt:subscribe(Client1, STopic, qos2),
-    ok = emqtt:disconnect(Client1),
+    ?check_trace(
+        begin
+            ConnFun = ?config(conn_fun, Config),
+            ClientId = ?config(client_id, Config),
+            Topic = ?config(topic, Config),
+            STopic = ?config(stopic, Config),
+            Payload = <<"test">>,
+            {ok, Client1} = emqtt:start_link([
+                {proto_ver, v5},
+                {clientid, ClientId},
+                {properties, #{'Session-Expiry-Interval' => 1}},
+                {clean_start, true}
+                | Config
+            ]),
+            {ok, _} = emqtt:ConnFun(Client1),
+            {ok, _, [2]} = emqtt:subscribe(Client1, STopic, qos2),
+            ok = emqtt:disconnect(Client1),
 
-    maybe_kill_connection_process(ClientId, Config),
+            maybe_kill_connection_process(ClientId, Config),
 
-    ok = publish(Topic, Payload),
+            ok = publish(Topic, Payload),
 
-    timer:sleep(2000),
+            timer:sleep(1500),
 
-    {ok, Client2} = emqtt:start_link([
-        {proto_ver, v5},
-        {clientid, ClientId},
-        {properties, #{'Session-Expiry-Interval' => 30}},
-        {clean_start, false}
-        | Config
-    ]),
-    {ok, _} = emqtt:ConnFun(Client2),
-    ?assertEqual(0, client_info(session_present, Client2)),
+            {ok, Client2} = emqtt:start_link([
+                {proto_ver, v5},
+                {clientid, ClientId},
+                {properties, #{'Session-Expiry-Interval' => 30}},
+                {clean_start, false}
+                | Config
+            ]),
+            {ok, _} = emqtt:ConnFun(Client2),
+            ?assertEqual(0, client_info(session_present, Client2)),
 
-    %% We should not receive the pending message
-    ?assertEqual([], receive_messages(1)),
+            %% We should not receive the pending message
+            ?assertEqual([], receive_messages(1)),
 
-    emqtt:disconnect(Client2).
+            emqtt:disconnect(Client2)
+        end,
+        []
+    ).
 
 t_publish_while_client_is_gone_qos1(Config) ->
     %% A persistent session should receive messages in its
@@ -644,7 +650,7 @@ t_publish_many_while_client_is_gone_qos1(Config) ->
         #mqtt_msg{topic = <<"loc/1/2/42">>, payload = <<"M4">>, qos = 1},
         #mqtt_msg{topic = <<"t/42/foo">>, payload = <<"M5">>, qos = 1},
         #mqtt_msg{topic = <<"loc/3/4/5">>, payload = <<"M6">>, qos = 1},
-        #mqtt_msg{topic = <<"msg/feed/me2">>, payload = <<"M7">>, qos = 1}
+        #mqtt_msg{topic = <<"msg/feed/me">>, payload = <<"M7">>, qos = 1}
     ],
     ok = publish_many(Pubs1),
     NPubs1 = length(Pubs1),
diff --git a/changes/ce/feat-12251.en.md b/changes/ce/feat-12251.en.md
index a206288b5..b35c44a01 100644
--- a/changes/ce/feat-12251.en.md
+++ b/changes/ce/feat-12251.en.md
@@ -4,4 +4,4 @@ Reduce RAM usage and frequency of database requests.
 - Introduce dirty session state to avoid frequent mria transactions
 - Introduce an intermediate buffer for the persistent messages
 - Use separate tracks of PacketIds for QoS1 and QoS2 messages
-- Limit the number of continuous ranges of infligtht messages to one per stream
+- Limit the number of continuous ranges of inflight messages to one per stream

From eec56b0d6bb27c2a9a1376b60bd24c4dc63c23fc Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 24 Jan 2024 02:10:24 +0100
Subject: [PATCH 092/273] fix(sessds): Improve comments

---
 apps/emqx/src/emqx_persistent_session_ds.erl  |  2 +-
 .../src/emqx_persistent_session_ds_state.erl  |  2 +-
 ...persistent_session_ds_stream_scheduler.erl | 35 +++++++++++++++++++
 .../test/emqx_persistent_session_SUITE.erl    |  2 +-
 ...emqx_persistent_session_ds_state_tests.erl |  3 ++
 apps/emqx_durable_storage/src/emqx_ds_lts.erl |  6 +++-
 6 files changed, 46 insertions(+), 4 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 6f32b1549..9cc3aea94 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -1037,7 +1037,7 @@ next_seqno_gen() ->
     ?LET(
         {Epoch, Offset},
         {non_neg_integer(), range(0, ?EPOCH_SIZE)},
-        Epoch bsl 15 + Offset
+        Epoch bsl ?EPOCH_BITS + Offset
     ).
 
 %%%% Property-based tests:
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 32d661354..0f617153b 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -85,7 +85,7 @@
     #{
         ?created_at => emqx_persistent_session_ds:timestamp(),
         ?last_alive_at => emqx_persistent_session_ds:timestamp(),
-        ?expiry_interval => emqx_types:conninfo(),
+        ?expiry_interval => non_neg_integer(),
         ?last_id => integer()
     }.
 
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index b321b324b..03a6fbf80 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -39,6 +39,8 @@
 %% API functions
 %%================================================================================
 
+%% @doc Find the streams that have uncommitted (in-flight) messages.
+%% Return them in the order they were previously replayed.
 -spec find_replay_streams(emqx_persistent_session_ds_state:t()) ->
     [{emqx_persistent_session_ds_state:stream_key(), emqx_persistent_session_ds:stream_state()}].
 find_replay_streams(S) ->
@@ -59,6 +61,15 @@ find_replay_streams(S) ->
     ),
     lists:sort(fun compare_streams/2, Streams).
 
+%% @doc Find streams from which the new messages can be fetched.
+%%
+%% Currently it amounts to the streams that don't have any inflight
+%% messages, since for performance reasons we keep only one record of
+%% in-flight messages per stream, and we don't want to overwrite these
+%% records prematurely.
+%%
+%% This function is non-detereministic: it randomizes the order of
+%% streams to ensure fair replay of different topics.
 -spec find_new_streams(emqx_persistent_session_ds_state:t()) ->
     [{emqx_persistent_session_ds_state:stream_key(), emqx_persistent_session_ds:stream_state()}].
 find_new_streams(S) ->
@@ -91,6 +102,23 @@ find_new_streams(S) ->
         )
     ).
 
+%% @doc This function makes the session aware of the new streams.
+%%
+%% It has the following properties:
+%%
+%% 1. For each RankX, it keeps only the streams with the same RankY.
+%%
+%% 2. For each RankX, it never advances RankY until _all_ streams with
+%% the same RankX are replayed.
+%%
+%% 3. Once all streams with the given rank are replayed, it advances
+%% the RankY to the smallest known RankY that is greater than replayed
+%% RankY.
+%%
+%% 4. If the RankX has never been replayed, it selects the streams
+%% with the smallest RankY.
+%%
+%% This way, messages from the same topic/shard are never reordered.
 -spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
 renew_streams(S0) ->
     S1 = remove_fully_replayed_streams(S0),
@@ -192,6 +220,12 @@ select_streams(SubId, RankX, Streams0, S) ->
             lists:takewhile(fun({{_, Y}, _}) -> Y =:= MinRankY end, Streams)
     end.
 
+%% @doc Advance RankY for each RankX that doesn't have any unreplayed
+%% streams.
+%%
+%% Drop streams with the fully replayed rank. This function relies on
+%% the fact that all streams with the same RankX have also the same
+%% RankY.
 -spec remove_fully_replayed_streams(emqx_persistent_session_ds_state:t()) ->
     emqx_persistent_session_ds_state:t().
 remove_fully_replayed_streams(S0) ->
@@ -246,6 +280,7 @@ remove_fully_replayed_streams(S0) ->
         S1
     ).
 
+%% @doc Compare the streams by the order in which they were replayed.
 compare_streams(
     {_KeyA, #srs{first_seqno_qos1 = A1, first_seqno_qos2 = A2}},
     {_KeyB, #srs{first_seqno_qos1 = B1, first_seqno_qos2 = B2}}
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 730fdd297..72c04ff74 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -928,7 +928,7 @@ t_publish_many_while_client_is_gone(Config) ->
     {ok, Client3} = emqtt:start_link([{clean_start, false} | ClientOpts]),
     {ok, _} = emqtt:ConnFun(Client3),
 
-    %% Check that the messages are retransmitted with DUP=1:
+    %% Check that we receive the rest of the messages:
     Msgs3 = receive_messages(NPubs, _Timeout = 2000),
     ct:pal("Msgs3 = ~p", [Msgs3]),
     ?assertMatch(
diff --git a/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
index ebf04eeb3..61e0575a8 100644
--- a/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
+++ b/apps/emqx/test/emqx_persistent_session_ds_state_tests.erl
@@ -27,6 +27,9 @@
 %% Type declarations
 %%================================================================================
 
+%% Note: here `committed' != `dirty'. It means "has been committed at
+%% least once since the creation", and it's used by the iteration
+%% test.
 -record(s, {subs = #{}, metadata = #{}, streams = #{}, seqno = #{}, committed = false}).
 
 -type state() :: #{emqx_persistent_session_ds:id() => #s{}}.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
index 226af62f0..6ebfc820d 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_lts.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -213,6 +213,10 @@ trie_next(#trie{trie = Trie}, State, ?EOT) ->
         [] -> undefined
     end;
 trie_next(#trie{trie = Trie}, State, Token) ->
+    %% NOTE: it's crucial to return the original (non-wildcard) index
+    %% for the topic, if found. Otherwise messages from the same topic
+    %% will end up in different streams, once the wildcard is learned,
+    %% and their replay order will become undefined:
     case ets:lookup(Trie, {State, Token}) of
         [#trans{next = Next}] ->
             {false, Next};

From 2c6a7763184355a679f25be73046bd24282f69c2 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 26 Jan 2024 17:39:14 +0100
Subject: [PATCH 093/273] fix(sessds): Stricter checks for PacketIds

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 26 +++++++++----------
 .../test/emqx_persistent_messages_SUITE.erl   |  2 +-
 2 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 9cc3aea94..1c1e78058 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -909,30 +909,28 @@ update_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
     SeqNo = packet_id_to_seqno(PacketId, S),
     case Track of
         puback ->
-            MinTrack = ?committed(?QOS_1),
-            MaxTrack = ?next(?QOS_1);
+            QoS = ?QOS_1,
+            SeqNoKey = ?committed(?QOS_1);
         pubrec ->
-            MinTrack = ?rec,
-            MaxTrack = ?next(?QOS_2);
+            QoS = ?QOS_2,
+            SeqNoKey = ?rec;
         pubcomp ->
-            MinTrack = ?committed(?QOS_2),
-            MaxTrack = ?next(?QOS_2)
+            QoS = ?QOS_2,
+            SeqNoKey = ?committed(?QOS_2)
     end,
-    Min = emqx_persistent_session_ds_state:get_seqno(MinTrack, S),
-    Max = emqx_persistent_session_ds_state:get_seqno(MaxTrack, S),
-    case Min =< SeqNo andalso SeqNo =< Max of
-        true ->
+    Current = emqx_persistent_session_ds_state:get_seqno(SeqNoKey, S),
+    case inc_seqno(QoS, Current) of
+        SeqNo ->
             %% TODO: we pass a bogus message into the hook:
             Msg = emqx_message:make(SessionId, <<>>, <<>>),
-            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(MinTrack, SeqNo, S)}};
-        false ->
+            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(SeqNoKey, SeqNo, S)}};
+        Expected ->
             ?SLOG(warning, #{
                 msg => "out-of-order_commit",
                 track => Track,
                 packet_id => PacketId,
                 seqno => SeqNo,
-                min => Min,
-                max => Max
+                expected => Expected
             }),
             {error, ?RC_PACKET_IDENTIFIER_NOT_FOUND}
     end.
diff --git a/apps/emqx/test/emqx_persistent_messages_SUITE.erl b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
index 6da60b809..0ca1daa1c 100644
--- a/apps/emqx/test/emqx_persistent_messages_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_messages_SUITE.erl
@@ -495,7 +495,7 @@ consume(It) ->
     end.
 
 receive_messages(Count) ->
-    receive_messages(Count, 5_000).
+    receive_messages(Count, 10_000).
 
 receive_messages(Count, Timeout) ->
     lists:reverse(receive_messages(Count, [], Timeout)).

From 96c527541b249c0fda38d9f75941490d716f1488 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sun, 28 Jan 2024 19:32:04 +0100
Subject: [PATCH 094/273] docs(ds): Update README

---
 apps/emqx_durable_storage/README.md | 113 +++++++++++++++++++++++-----
 1 file changed, 96 insertions(+), 17 deletions(-)

diff --git a/apps/emqx_durable_storage/README.md b/apps/emqx_durable_storage/README.md
index bc8eae2d0..f613085bb 100644
--- a/apps/emqx_durable_storage/README.md
+++ b/apps/emqx_durable_storage/README.md
@@ -1,24 +1,97 @@
-# EMQX Replay
+# EMQX Durable Storage
 
-`emqx_ds` is an application implementing durable storage for MQTT messages within EMQX.
+`emqx_durable_storage` (DS for short) is an application implementing durable storage for MQTT messages within EMQX.
+
+The core design idea behind `emqx_durable_storage` is to store each message exactly once (per each replica of the database), regardless of the number of consumers, online or offline.
+This makes the storage disk requirements very predictable: only the number of _published_ messages matters; the number of consumers is removed from the equation, and fan-out is practically free in terms of disk storage.
 
 # Features
 
-- Streams. Stream is an abstraction that encompasses topics, shards, different data layouts, etc.
-  The client application must only aware of the streams.
+## Callback modules
 
-- Batching. All the API functions are batch-oriented.
+### Backend
 
-- Iterators. Iterators can be stored durably or transferred over network.
-  They take relatively small space.
+DS _backend_ is a callback module that implements `emqx_ds` behavior.
 
-- Support for various backends. Almost any DBMS that supports range
-  queries can serve as a `emqx_durable_storage` backend.
+EMQX repository contains the "builtin" backend, implemented in `emqx_ds_replication_layer` module, that uses RocksDB as the main storage.
 
-- Builtin backend based on RocksDB.
-  - Changing storage layout on the fly: it's achieved by creating a
-    new set of tables (known as "generation") and the schema.
-  - Sharding based on publisher's client ID
+Note that builtin backend introduces the concept of **site** to alleviate the problem of changing node names.
+Site IDs are persistent, and they are randomly generated at the first startup of the node.
+Each node in the cluster has a unique site ID, that is independent from the Erlang node name (`emqx@...`).
+
+### Layout
+
+DS _layout_ is a module that implements `emqx_ds_storage_layer` behavior.
+Layout modules are the only modules that have direct access to the underlying storage engine, in both reads and writes.
+
+Different storage layouts can be used to maximize the efficiency of message storage and retrieval for various types of workload.
+
+Backward- and forward-incompatible changes to the layout modules are forbidden.
+EMQX should always be able to read the data written by the old releases.
+Non-compatible changes must be implemented as entirely new layout modules.
+
+## How does EMQX organize data
+
+Messages are organized in the following hierarchy:
+
+1. **Database**.
+   DS databases are completely independent from each other.
+   They can have different schema, different backend, and they can be opened, closed, created and dropped independently from each other.
+
+   Each database can be used for a different type of payload or a different tenant.
+
+2. **Shard**.
+   (The concept of shard is specific to the builtin backend)
+   The builtin backend separates different messages into shards.
+   Sharding can be performed by `clientId` or the topic of the message.
+
+3. **Generation**.
+   Each shard is additionally split into partitions called generations, each one covering a particular period of time.
+   New messages are written only into the _current_ generation, while the previous generations are only accessible for reading.
+
+   Different generations can use different layout modules to organize the data.
+   In fact, in order to change the layout of the data the application must create a new generation, so the previously recorded messages remain readable without having to perform a heavy migration procedure.
+   Generations can also be used for the garbage collection and message retention policies: since all messages in the generation belong to a certain interval of time, old messages can be efficiently deleted by dropping the entire generation.
+
+
+4. *Stream*.
+   Finally, messages in each shard and generation are split into streams.
+   Every stream can contain messages from multiple topics.
+   The number of streams is expected to be relatively low in comparison with the number of topics: one stream can potentially contain millions of topics.
+   Various layout callback modules can employ different strategies for mapping topics into streams.
+
+   Stream is *the only* unit of message serialization in `emqx_durable_storage` application.
+
+   The consumer of the messages can replay the stream using an _iterator_.
+
+## Message replay
+
+All the API functions in EMQX DS are batch-oriented.
+
+Consumption of messages is done in several stages:
+
+1. The consumer calls `emqx_ds:get_streams` function to get the list of streams that contain messages from a given topic filter, and a given time range.
+
+2. `get_streams` returns the list of streams together with their _ranks_.
+   The rank of the stream is a tuple with two elements, called `X` and `Y`.
+
+   The consumer must follow the below rules to avoid reordering of the messages:
+
+   - Streams with different `X`-ranks can always be replayed in parallel, regardless of their `Y`-rank.
+   - Streams with the same `X` and `Y`-rank can be replayed in parallel.
+   - Groups of streams with the same `X` rank should be replayed in order of their `Y`-rank
+
+3. In order to start replay of the stream, the consumer calls `emqx_ds:make_iterator` function that returns an _iterator_ object.
+   Iterators are the pointers to a particular position in the stream, they can be saved and restored as regular Erlang terms.
+
+4. The consumer then proceeds to call `emqx_ds:next` function to fetch messages.
+   - If this function returns `{ok, end_of_stream}`, it means the stream is fully replayed.
+   - If this function returns `{ok, NextIterator, []}`, it means new messages can appear in the stream.
+
+   Note: the consumer must implement a fair strategy for consuming messages from different streams.
+   It cannot rely on an assumption that it can reach the end of a stream in a finite time.
+
+5. The consumer must periodically refresh the list of streams as explained in 1, because new streams can appear from time to time.
 
 # Limitation
 
@@ -36,10 +109,16 @@ In the future it can serve as a storage for retained messages or as a generic me
 
 # Configurations
 
-`emqx_durable_storage` doesn't have any configurable parameters.
-Instead, it relies on the upper-level business applications to create
-a correct configuration and pass it to `emqx_ds:open_db(DBName, Config)`
-function according to its needs.
+Global options for `emqx_durable_storage` application are configured via OTP application environment.
+Database-specific settings are stored in the schema table.
+
+The following application environment variables are available:
+
+- `emqx_durable_storage.db_data_dir`: directory where the databases are located
+
+- `emqx_durable_storage.egress_batch_size`: number of messages stored in the batch before it is committed to the durable storage.
+
+- `emqx_durable_storage.egress_flush_interval`: period at which the batches of messages are committed to the durable storage.
 
 # HTTP APIs
 

From 2479e1189a7317b11f14f85c4abd9850054f16d8 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 29 Jan 2024 00:36:13 +0100
Subject: [PATCH 095/273] fix(ds): Remove unused module

---
 .../emqx_durable_storage/src/emqx_ds_conf.erl | 73 -------------------
 1 file changed, 73 deletions(-)
 delete mode 100644 apps/emqx_durable_storage/src/emqx_ds_conf.erl

diff --git a/apps/emqx_durable_storage/src/emqx_ds_conf.erl b/apps/emqx_durable_storage/src/emqx_ds_conf.erl
deleted file mode 100644
index d9e1efd57..000000000
--- a/apps/emqx_durable_storage/src/emqx_ds_conf.erl
+++ /dev/null
@@ -1,73 +0,0 @@
-%%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
-%%--------------------------------------------------------------------
--module(emqx_ds_conf).
-
-%% TODO: make a proper HOCON schema and all...
-
-%% API:
--export([keyspace_config/1, db_options/1]).
-
--export([iteration_options/1]).
--export([default_iteration_options/0]).
-
--export_type([
-    backend_config/0,
-    iteration_options/0
-]).
-
--type backend_config() ::
-    {emqx_ds_message_storage_bitmask, emqx_ds_storage_bitfield_lts:options()}
-    | {module(), _Options}.
-
--type keyspace() :: atom().
--type iteration_options() :: map().
-
-%%================================================================================
-%% API funcions
-%%================================================================================
-
--define(APP, emqx_ds).
-
--spec keyspace_config(keyspace()) -> backend_config().
-keyspace_config(Keyspace) ->
-    DefaultKeyspaceConfig = application:get_env(
-        ?APP,
-        default_keyspace_config,
-        default_keyspace_config()
-    ),
-    Keyspaces = application:get_env(?APP, keyspace_config, #{}),
-    maps:get(Keyspace, Keyspaces, DefaultKeyspaceConfig).
-
--spec iteration_options(keyspace()) ->
-    iteration_options().
-iteration_options(Keyspace) ->
-    case keyspace_config(Keyspace) of
-        {emqx_ds_message_storage_bitmask, Config} ->
-            maps:get(iteration, Config, default_iteration_options());
-        {_Module, _} ->
-            default_iteration_options()
-    end.
-
--spec default_iteration_options() -> iteration_options().
-default_iteration_options() ->
-    {emqx_ds_message_storage_bitmask, Config} = default_keyspace_config(),
-    maps:get(iteration, Config).
-
--spec default_keyspace_config() -> backend_config().
-default_keyspace_config() ->
-    {emqx_ds_message_storage_bitmask, #{
-        db_options => [],
-        timestamp_bits => 64,
-        topic_bits_per_level => [8, 8, 8, 32, 16],
-        epoch => 5,
-        iteration => #{
-            iterator_refresh => {every, 100}
-        }
-    }}.
-
--spec db_options(keyspace()) -> emqx_ds_storage_layer:options().
-db_options(Keyspace) ->
-    DefaultDBOptions = application:get_env(?APP, default_db_options, []),
-    Keyspaces = application:get_env(?APP, keyspace_config, #{}),
-    emqx_utils_maps:deep_get([Keyspace, db_options], Keyspaces, DefaultDBOptions).

From 12da3c0986961ea9f04341d7003e4c2f4c0352f9 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Mon, 29 Jan 2024 15:33:23 +0800
Subject: [PATCH 096/273] feat: configurable server side
 message_expiry_interval

---
 apps/emqx/src/emqx_channel.erl            |  3 ++-
 apps/emqx/src/emqx_message.erl            | 22 ++++++++++++++--------
 apps/emqx/src/emqx_schema.erl             |  9 +++++++++
 apps/emqx/src/emqx_session_mem.erl        |  8 ++++----
 apps/emqx/test/emqx_config_SUITE.erl      |  1 +
 apps/emqx/test/emqx_message_SUITE.erl     |  6 +++---
 apps/emqx/test/emqx_session_mem_SUITE.erl |  1 +
 rel/config/examples/mqtt.conf.example     | 15 +++++++++++++++
 rel/i18n/emqx_schema.hocon                |  6 ++++++
 9 files changed, 55 insertions(+), 16 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index f4661a85e..86c3b840c 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -930,7 +930,8 @@ handle_deliver(
     Delivers1 = maybe_nack(Delivers),
     Messages = emqx_session:enrich_delivers(ClientInfo, Delivers1, Session),
     NSession = emqx_session_mem:enqueue(ClientInfo, Messages, Session),
-    {ok, Channel#channel{session = NSession}};
+    %% we need to update stats here, as the stats_timer is canceled after disconnected
+    {ok, {event, updated}, Channel#channel{session = NSession}};
 handle_deliver(Delivers, Channel) ->
     Delivers1 = emqx_external_trace:start_trace_send(Delivers, trace_info(Channel)),
     do_handle_deliver(Delivers1, Channel).
diff --git a/apps/emqx/src/emqx_message.erl b/apps/emqx/src/emqx_message.erl
index 6b684c199..0628908d1 100644
--- a/apps/emqx/src/emqx_message.erl
+++ b/apps/emqx/src/emqx_message.erl
@@ -65,7 +65,7 @@
 ]).
 
 -export([
-    is_expired/1,
+    is_expired/2,
     update_expiry/1,
     timestamp_now/0
 ]).
@@ -273,14 +273,20 @@ remove_header(Hdr, Msg = #message{headers = Headers}) ->
         false -> Msg
     end.
 
--spec is_expired(emqx_types:message()) -> boolean().
-is_expired(#message{
-    headers = #{properties := #{'Message-Expiry-Interval' := Interval}},
-    timestamp = CreatedAt
-}) ->
+-spec is_expired(emqx_types:message(), atom()) -> boolean().
+is_expired(
+    #message{
+        headers = #{properties := #{'Message-Expiry-Interval' := Interval}},
+        timestamp = CreatedAt
+    },
+    _
+) ->
     elapsed(CreatedAt) > timer:seconds(Interval);
-is_expired(_Msg) ->
-    false.
+is_expired(#message{timestamp = CreatedAt}, Zone) ->
+    case emqx_config:get_zone_conf(Zone, [mqtt, message_expiry_interval], infinity) of
+        infinity -> false;
+        Interval -> elapsed(CreatedAt) > Interval
+    end.
 
 -spec update_expiry(emqx_types:message()) -> emqx_types:message().
 update_expiry(
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index e26475855..d9171f711 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -3745,6 +3745,15 @@ mqtt_session() ->
                     importance => ?IMPORTANCE_LOW
                 }
             )},
+        {"message_expiry_interval",
+            sc(
+                hoconsc:union([duration(), infinity]),
+                #{
+                    default => infinity,
+                    desc => ?DESC(mqtt_message_expiry_interval),
+                    importance => ?IMPORTANCE_LOW
+                }
+            )},
         {"max_awaiting_rel",
             sc(
                 hoconsc:union([non_neg_integer(), infinity]),
diff --git a/apps/emqx/src/emqx_session_mem.erl b/apps/emqx/src/emqx_session_mem.erl
index c8affdaea..e8c7a7d18 100644
--- a/apps/emqx/src/emqx_session_mem.erl
+++ b/apps/emqx/src/emqx_session_mem.erl
@@ -468,12 +468,12 @@ dequeue(ClientInfo, Session = #session{inflight = Inflight, mqueue = Q}) ->
 
 dequeue(_ClientInfo, 0, Msgs, Q) ->
     {lists:reverse(Msgs), Q};
-dequeue(ClientInfo, Cnt, Msgs, Q) ->
+dequeue(ClientInfo = #{zone := Zone}, Cnt, Msgs, Q) ->
     case emqx_mqueue:out(Q) of
         {empty, _Q} ->
             dequeue(ClientInfo, 0, Msgs, Q);
         {{value, Msg}, Q1} ->
-            case emqx_message:is_expired(Msg) of
+            case emqx_message:is_expired(Msg, Zone) of
                 true ->
                     _ = emqx_session_events:handle_event(ClientInfo, {expired, Msg}),
                     dequeue(ClientInfo, Cnt, Msgs, Q1);
@@ -619,14 +619,14 @@ retry_delivery(
     end.
 
 do_retry_delivery(
-    ClientInfo,
+    ClientInfo = #{zone := Zone},
     PacketId,
     #inflight_data{phase = wait_ack, message = Msg} = Data,
     Now,
     Acc,
     Inflight
 ) ->
-    case emqx_message:is_expired(Msg) of
+    case emqx_message:is_expired(Msg, Zone) of
         true ->
             _ = emqx_session_events:handle_event(ClientInfo, {expired, Msg}),
             {Acc, emqx_inflight:delete(PacketId, Inflight)};
diff --git a/apps/emqx/test/emqx_config_SUITE.erl b/apps/emqx/test/emqx_config_SUITE.erl
index 6a49507a6..4ddebd278 100644
--- a/apps/emqx/test/emqx_config_SUITE.erl
+++ b/apps/emqx/test/emqx_config_SUITE.erl
@@ -446,6 +446,7 @@ zone_global_defaults() ->
                 response_information => [],
                 retain_available => true,
                 retry_interval => 30000,
+                message_expiry_interval => infinity,
                 server_keepalive => disabled,
                 session_expiry_interval => 7200000,
                 shared_subscription => true,
diff --git a/apps/emqx/test/emqx_message_SUITE.erl b/apps/emqx/test/emqx_message_SUITE.erl
index 2e4164652..c97c0d899 100644
--- a/apps/emqx/test/emqx_message_SUITE.erl
+++ b/apps/emqx/test/emqx_message_SUITE.erl
@@ -143,12 +143,12 @@ t_undefined_headers(_) ->
 
 t_is_expired(_) ->
     Msg = emqx_message:make(<<"clientid">>, <<"topic">>, <<"payload">>),
-    ?assertNot(emqx_message:is_expired(Msg)),
+    ?assertNot(emqx_message:is_expired(Msg, ?MODULE)),
     Msg1 = emqx_message:set_headers(#{properties => #{'Message-Expiry-Interval' => 1}}, Msg),
     timer:sleep(500),
-    ?assertNot(emqx_message:is_expired(Msg1)),
+    ?assertNot(emqx_message:is_expired(Msg1, ?MODULE)),
     timer:sleep(600),
-    ?assert(emqx_message:is_expired(Msg1)),
+    ?assert(emqx_message:is_expired(Msg1, ?MODULE)),
     timer:sleep(1000),
     Msg = emqx_message:update_expiry(Msg),
     Msg2 = emqx_message:update_expiry(Msg1),
diff --git a/apps/emqx/test/emqx_session_mem_SUITE.erl b/apps/emqx/test/emqx_session_mem_SUITE.erl
index 20d622941..a539dde9a 100644
--- a/apps/emqx/test/emqx_session_mem_SUITE.erl
+++ b/apps/emqx/test/emqx_session_mem_SUITE.erl
@@ -545,6 +545,7 @@ clientinfo() -> clientinfo(#{}).
 clientinfo(Init) ->
     maps:merge(
         #{
+            zone => ?MODULE,
             clientid => <<"clientid">>,
             username => <<"username">>
         },
diff --git a/rel/config/examples/mqtt.conf.example b/rel/config/examples/mqtt.conf.example
index 64c73524c..84fdf7783 100644
--- a/rel/config/examples/mqtt.conf.example
+++ b/rel/config/examples/mqtt.conf.example
@@ -82,6 +82,21 @@ mqtt {
     ## Specifies how long the session will expire after the connection is disconnected, only for non-MQTT 5.0 connections
     session_expiry_interval = 2h
 
+    ## The expiry interval of MQTT messages.
+    ##
+    ## For MQTT 5.0 clients, this configuration will only take effect when the
+    ##  Message-Expiry-Interval property is not set in the message; otherwise, the
+    ##  value of the Message-Expiry-Interval property will be used.
+    ## For MQTT versions older than 5.0, this configuration will always take effect.
+    ## Please note that setting message_expiry_interval greater than session_expiry_interval
+    ##  is meaningless, as all messages will be cleared when the session expires.
+    ##
+    ## Type:
+    ##   - infinity :: Never expire
+    ##   - Time Duration :: The expiry interval
+    ## Default: infinity
+    message_expiry_interval = infinity
+
     ## Maximum queue length. Enqueued messages when persistent client disconnected, or inflight window is full
     ## Type: infinity | Integer
     max_mqueue_len = 1000
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index 5ff4e063e..40da8d75e 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -191,6 +191,12 @@ mqtt_session_expiry_interval.desc:
 mqtt_session_expiry_interval.label:
 """Session Expiry Interval"""
 
+mqtt_message_expiry_interval.desc:
+"""The expiry interval of MQTT messages. For MQTT 5.0 clients, this configuration will only take effect when the Message-Expiry-Interval property is not set in the message; otherwise, the value of the Message-Expiry-Interval property will be used. For MQTT versions older than 5.0, this configuration will always take effect. Please note that setting message_expiry_interval greater than session_expiry_interval is meaningless, as all messages will be cleared when the session expires."""
+
+mqtt_message_expiry_interval.label:
+"""Message Expiry Interval"""
+
 fields_listener_enabled.desc:
 """Enable listener."""
 

From 9f22c2c4555a502a34d7c7fe8871606d825a95f3 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Mon, 29 Jan 2024 18:18:18 +0800
Subject: [PATCH 097/273] ci: add some sleep and retry to
 emqx_persistent_session_ds_SUITE

---
 apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index 40ffe7f32..96236c0ae 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -595,7 +595,7 @@ t_session_gc(Config) ->
                     }
                 )
             ),
-            ?assertMatch([ClientId1], list_all_sessions(Node1), sessions),
+            ?retry(50, 3, [ClientId1] = list_all_sessions(Node1)),
             ?assertMatch([_], list_all_subscriptions(Node1), subscriptions),
             ok
         end,

From 47f61ba68a389d87003680ca0bf268b09a878982 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Fri, 26 Jan 2024 16:09:23 -0300
Subject: [PATCH 098/273] fix(cassandra_bridge): correctly insert null values
 into columns

Fixes https://emqx.atlassian.net/browse/EMQX-11822
---
 apps/emqx_bridge_cassandra/rebar.config       |  2 +-
 .../src/emqx_bridge_cassandra_connector.erl   | 18 +++-
 .../test/emqx_bridge_cassandra_SUITE.erl      | 89 +++++++++++++++++--
 changes/ee/fix-12411.en.md                    |  1 +
 4 files changed, 99 insertions(+), 11 deletions(-)
 create mode 100644 changes/ee/fix-12411.en.md

diff --git a/apps/emqx_bridge_cassandra/rebar.config b/apps/emqx_bridge_cassandra/rebar.config
index 04ee603fa..e98146d78 100644
--- a/apps/emqx_bridge_cassandra/rebar.config
+++ b/apps/emqx_bridge_cassandra/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.6.0"}}},
+    {ecql, {git, "https://github.com/emqx/ecql.git", {tag, "v0.6.1"}}},
     {emqx_connector, {path, "../../apps/emqx_connector"}},
     {emqx_resource, {path, "../../apps/emqx_resource"}},
     {emqx_bridge, {path, "../../apps/emqx_bridge"}}
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index 3b30f1d26..872ccb532 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -278,10 +278,24 @@ proc_cql_params(prepared_query, ChannId, Params, #{channels := Channs}) ->
             params_tokens := ParamsTokens
         }
     } = maps:get(ChannId, Channs),
-    {PrepareKey, assign_type_for_params(emqx_placeholder:proc_sql(ParamsTokens, Params))};
+    {PrepareKey, assign_type_for_params(proc_sql(ParamsTokens, Params))};
 proc_cql_params(query, CQL, Params, _State) ->
     {CQL1, Tokens} = emqx_placeholder:preproc_sql(CQL, '?'),
-    {CQL1, assign_type_for_params(emqx_placeholder:proc_sql(Tokens, Params))}.
+    {CQL1, assign_type_for_params(proc_sql(Tokens, Params))}.
+
+proc_sql(Tokens, Params) ->
+    VarTrans = fun
+        (null) -> null;
+        (X) -> emqx_placeholder:sql_data(X)
+    end,
+    emqx_placeholder:proc_tmpl(
+        Tokens,
+        Params,
+        #{
+            return => rawlist,
+            var_trans => VarTrans
+        }
+    ).
 
 exec_cql_query(InstId, PoolName, Type, Async, PreparedKey, Data) when
     Type == query; Type == prepared_query
diff --git a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
index 09deaa699..18d6993b3 100644
--- a/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
+++ b/apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE.erl
@@ -19,6 +19,8 @@
 %%     ./rebar3 ct --name 'test@127.0.0.1' -v --suite \
 %%     apps/emqx_bridge_cassandra/test/emqx_bridge_cassandra_SUITE
 
+-import(emqx_common_test_helpers, [on_exit/1]).
+
 % SQL definitions
 -define(SQL_BRIDGE,
     "insert into mqtt_msg_test(topic, payload, arrived) "
@@ -129,12 +131,15 @@ init_per_group(_Group, Config) ->
     Config.
 
 end_per_group(Group, Config) when
-    Group == without_batch; Group == without_batch
+    Group == with_batch;
+    Group == without_batch
 ->
     connect_and_drop_table(Config),
     ProxyHost = ?config(proxy_host, Config),
     ProxyPort = ?config(proxy_port, Config),
     emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
+    Apps = ?config(apps, Config),
+    emqx_cth_suite:stop(Apps),
     ok;
 end_per_group(_Group, _Config) ->
     ok.
@@ -160,6 +165,7 @@ end_per_testcase(_Testcase, Config) ->
     ok = snabbkaffe:stop(),
     connect_and_clear_table(Config),
     delete_bridge(Config),
+    emqx_common_test_helpers:call_janitor(),
     ok.
 
 %%------------------------------------------------------------------------------
@@ -177,19 +183,32 @@ common_init(Config0) ->
             ProxyHost = os:getenv("PROXY_HOST", "toxiproxy"),
             ProxyPort = list_to_integer(os:getenv("PROXY_PORT", "8474")),
             emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-            % Ensure EE bridge module is loaded
-            ok = emqx_common_test_helpers:start_apps([emqx_conf, emqx_bridge]),
-            _ = emqx_bridge_enterprise:module_info(),
-            emqx_mgmt_api_test_util:init_suite(),
+            Apps = emqx_cth_suite:start(
+                [
+                    emqx,
+                    emqx_conf,
+                    emqx_bridge_cassandra,
+                    emqx_bridge,
+                    emqx_rule_engine,
+                    emqx_management,
+                    {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+                ],
+                #{work_dir => emqx_cth_suite:work_dir(Config0)}
+            ),
+            {ok, _Api} = emqx_common_test_http:create_default_app(),
             % Connect to cassnadra directly and create the table
             catch connect_and_drop_table(Config0),
             connect_and_create_table(Config0),
             {Name, CassaConf} = cassa_config(BridgeType, Config0),
             Config =
                 [
+                    {apps, Apps},
                     {cassa_config, CassaConf},
                     {cassa_bridge_type, BridgeType},
                     {cassa_name, Name},
+                    {bridge_type, BridgeType},
+                    {bridge_name, Name},
+                    {bridge_config, CassaConf},
                     {proxy_host, ProxyHost},
                     {proxy_port, ProxyPort}
                     | Config0
@@ -360,13 +379,19 @@ connect_direct_cassa(Config) ->
 
 % These funs connect and then stop the cassandra connection
 connect_and_create_table(Config) ->
+    connect_and_create_table(Config, ?SQL_CREATE_TABLE).
+
+connect_and_create_table(Config, SQL) ->
     with_direct_conn(Config, fun(Conn) ->
-        {ok, _} = ecql:query(Conn, ?SQL_CREATE_TABLE)
+        {ok, _} = ecql:query(Conn, SQL)
     end).
 
 connect_and_drop_table(Config) ->
+    connect_and_drop_table(Config, ?SQL_DROP_TABLE).
+
+connect_and_drop_table(Config, SQL) ->
     with_direct_conn(Config, fun(Conn) ->
-        {ok, _} = ecql:query(Conn, ?SQL_DROP_TABLE)
+        {ok, _} = ecql:query(Conn, SQL)
     end).
 
 connect_and_clear_table(Config) ->
@@ -375,8 +400,11 @@ connect_and_clear_table(Config) ->
     end).
 
 connect_and_get_payload(Config) ->
+    connect_and_get_payload(Config, ?SQL_SELECT).
+
+connect_and_get_payload(Config, SQL) ->
     with_direct_conn(Config, fun(Conn) ->
-        {ok, {_Keyspace, _ColsSpec, [[Result]]}} = ecql:query(Conn, ?SQL_SELECT),
+        {ok, {_Keyspace, _ColsSpec, [[Result]]}} = ecql:query(Conn, SQL),
         Result
     end).
 
@@ -685,3 +713,48 @@ t_nasty_sql_string(Config) ->
     %% XXX: why ok instead of {ok, AffectedLines}?
     ?assertEqual(ok, send_message(Config, Message)),
     ?assertEqual(Payload, connect_and_get_payload(Config)).
+
+t_insert_null_into_int_column(Config) ->
+    BridgeType = ?config(bridge_type, Config),
+    connect_and_create_table(
+        Config,
+        <<
+            "CREATE TABLE mqtt.mqtt_msg_test2 (\n"
+            "  topic text,\n"
+            "  payload text,\n"
+            "  arrived timestamp,\n"
+            "  x int,\n"
+            "  PRIMARY KEY (topic)\n"
+            ")"
+        >>
+    ),
+    on_exit(fun() -> connect_and_drop_table(Config, "DROP TABLE mqtt.mqtt_msg_test2") end),
+    {ok, {{_, 201, _}, _, _}} =
+        emqx_bridge_testlib:create_bridge_api(
+            Config,
+            #{
+                <<"cql">> => <<
+                    "insert into mqtt_msg_test2(topic, payload, x, arrived) "
+                    "values (${topic}, ${payload}, ${x}, ${timestamp})"
+                >>
+            }
+        ),
+    RuleTopic = <<"t/c">>,
+    Opts = #{
+        sql => <<"select *, first(jq('null', payload)) as x from \"", RuleTopic/binary, "\"">>
+    },
+    {ok, _} = emqx_bridge_testlib:create_rule_and_action_http(BridgeType, RuleTopic, Config, Opts),
+
+    Payload = <<"{}">>,
+    Msg = emqx_message:make(RuleTopic, Payload),
+    {_, {ok, _}} =
+        ?wait_async_action(
+            emqx:publish(Msg),
+            #{?snk_kind := cassandra_connector_query_return},
+            10_000
+        ),
+
+    %% Would return `1853189228' if it encodes `null' as an integer...
+    ?assertEqual(null, connect_and_get_payload(Config, "select x from mqtt.mqtt_msg_test2")),
+
+    ok.
diff --git a/changes/ee/fix-12411.en.md b/changes/ee/fix-12411.en.md
new file mode 100644
index 000000000..7dead2ed7
--- /dev/null
+++ b/changes/ee/fix-12411.en.md
@@ -0,0 +1 @@
+Fixed a bug where `null` values would be inserted as `1853189228` in `int` columns in Cassandra data integration.

From 82403167c245b87ec26245027c5cfd784e42773e Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 26 Jan 2024 16:23:35 +0100
Subject: [PATCH 099/273] chore: update BSL license change date

---
 apps/emqx_audit/BSL.txt                    | 2 +-
 apps/emqx_auth_ldap/BSL.txt                | 2 +-
 apps/emqx_bridge_azure_event_hub/BSL.txt   | 2 +-
 apps/emqx_bridge_cassandra/BSL.txt         | 2 +-
 apps/emqx_bridge_clickhouse/BSL.txt        | 2 +-
 apps/emqx_bridge_confluent/BSL.txt         | 2 +-
 apps/emqx_bridge_dynamo/BSL.txt            | 2 +-
 apps/emqx_bridge_es/BSL.txt                | 2 +-
 apps/emqx_bridge_gcp_pubsub/BSL.txt        | 2 +-
 apps/emqx_bridge_greptimedb/BSL.txt        | 2 +-
 apps/emqx_bridge_hstreamdb/BSL.txt         | 2 +-
 apps/emqx_bridge_influxdb/BSL.txt          | 2 +-
 apps/emqx_bridge_iotdb/BSL.txt             | 2 +-
 apps/emqx_bridge_kafka/BSL.txt             | 2 +-
 apps/emqx_bridge_kinesis/BSL.txt           | 2 +-
 apps/emqx_bridge_matrix/BSL.txt            | 2 +-
 apps/emqx_bridge_mongodb/BSL.txt           | 2 +-
 apps/emqx_bridge_mysql/BSL.txt             | 2 +-
 apps/emqx_bridge_opents/BSL.txt            | 2 +-
 apps/emqx_bridge_oracle/BSL.txt            | 2 +-
 apps/emqx_bridge_pgsql/BSL.txt             | 2 +-
 apps/emqx_bridge_pulsar/BSL.txt            | 2 +-
 apps/emqx_bridge_rabbitmq/BSL.txt          | 2 +-
 apps/emqx_bridge_redis/BSL.txt             | 2 +-
 apps/emqx_bridge_rocketmq/BSL.txt          | 2 +-
 apps/emqx_bridge_sqlserver/BSL.txt         | 2 +-
 apps/emqx_bridge_syskeeper/BSL.txt         | 2 +-
 apps/emqx_bridge_tdengine/BSL.txt          | 2 +-
 apps/emqx_bridge_timescale/BSL.txt         | 2 +-
 apps/emqx_dashboard_rbac/BSL.txt           | 2 +-
 apps/emqx_dashboard_sso/BSL.txt            | 2 +-
 apps/emqx_durable_storage/BSL.txt          | 2 +-
 apps/emqx_enterprise/BSL.txt               | 2 +-
 apps/emqx_eviction_agent/BSL.txt           | 2 +-
 apps/emqx_ft/BSL.txt                       | 2 +-
 apps/emqx_gateway_gbt32960/BSL.txt         | 2 +-
 apps/emqx_gateway_jt808/BSL.txt            | 2 +-
 apps/emqx_gateway_ocpp/BSL.txt             | 2 +-
 apps/emqx_gcp_device/BSL.txt               | 2 +-
 apps/emqx_license/BSL.txt                  | 2 +-
 apps/emqx_node_rebalance/BSL.txt           | 2 +-
 apps/emqx_oracle/BSL.txt                   | 2 +-
 apps/emqx_s3/BSL.txt                       | 2 +-
 apps/emqx_schema_registry/BSL.txt          | 2 +-
 scripts/update-bsl-license-convert-year.sh | 1 -
 45 files changed, 44 insertions(+), 45 deletions(-)

diff --git a/apps/emqx_audit/BSL.txt b/apps/emqx_audit/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_audit/BSL.txt
+++ b/apps/emqx_audit/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_auth_ldap/BSL.txt b/apps/emqx_auth_ldap/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_auth_ldap/BSL.txt
+++ b/apps/emqx_auth_ldap/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_azure_event_hub/BSL.txt b/apps/emqx_bridge_azure_event_hub/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_azure_event_hub/BSL.txt
+++ b/apps/emqx_bridge_azure_event_hub/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_cassandra/BSL.txt b/apps/emqx_bridge_cassandra/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_cassandra/BSL.txt
+++ b/apps/emqx_bridge_cassandra/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_clickhouse/BSL.txt b/apps/emqx_bridge_clickhouse/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_clickhouse/BSL.txt
+++ b/apps/emqx_bridge_clickhouse/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_confluent/BSL.txt b/apps/emqx_bridge_confluent/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_confluent/BSL.txt
+++ b/apps/emqx_bridge_confluent/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_dynamo/BSL.txt b/apps/emqx_bridge_dynamo/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_dynamo/BSL.txt
+++ b/apps/emqx_bridge_dynamo/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_es/BSL.txt b/apps/emqx_bridge_es/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_es/BSL.txt
+++ b/apps/emqx_bridge_es/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_gcp_pubsub/BSL.txt b/apps/emqx_bridge_gcp_pubsub/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_gcp_pubsub/BSL.txt
+++ b/apps/emqx_bridge_gcp_pubsub/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_greptimedb/BSL.txt b/apps/emqx_bridge_greptimedb/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_greptimedb/BSL.txt
+++ b/apps/emqx_bridge_greptimedb/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_hstreamdb/BSL.txt b/apps/emqx_bridge_hstreamdb/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_hstreamdb/BSL.txt
+++ b/apps/emqx_bridge_hstreamdb/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_influxdb/BSL.txt b/apps/emqx_bridge_influxdb/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_influxdb/BSL.txt
+++ b/apps/emqx_bridge_influxdb/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_iotdb/BSL.txt b/apps/emqx_bridge_iotdb/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_iotdb/BSL.txt
+++ b/apps/emqx_bridge_iotdb/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_kafka/BSL.txt b/apps/emqx_bridge_kafka/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_kafka/BSL.txt
+++ b/apps/emqx_bridge_kafka/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_kinesis/BSL.txt b/apps/emqx_bridge_kinesis/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_kinesis/BSL.txt
+++ b/apps/emqx_bridge_kinesis/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_matrix/BSL.txt b/apps/emqx_bridge_matrix/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_matrix/BSL.txt
+++ b/apps/emqx_bridge_matrix/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_mongodb/BSL.txt b/apps/emqx_bridge_mongodb/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_mongodb/BSL.txt
+++ b/apps/emqx_bridge_mongodb/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_mysql/BSL.txt b/apps/emqx_bridge_mysql/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_mysql/BSL.txt
+++ b/apps/emqx_bridge_mysql/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_opents/BSL.txt b/apps/emqx_bridge_opents/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_opents/BSL.txt
+++ b/apps/emqx_bridge_opents/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_oracle/BSL.txt b/apps/emqx_bridge_oracle/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_oracle/BSL.txt
+++ b/apps/emqx_bridge_oracle/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_pgsql/BSL.txt b/apps/emqx_bridge_pgsql/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_pgsql/BSL.txt
+++ b/apps/emqx_bridge_pgsql/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_pulsar/BSL.txt b/apps/emqx_bridge_pulsar/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_pulsar/BSL.txt
+++ b/apps/emqx_bridge_pulsar/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_rabbitmq/BSL.txt b/apps/emqx_bridge_rabbitmq/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_rabbitmq/BSL.txt
+++ b/apps/emqx_bridge_rabbitmq/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_redis/BSL.txt b/apps/emqx_bridge_redis/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_redis/BSL.txt
+++ b/apps/emqx_bridge_redis/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_rocketmq/BSL.txt b/apps/emqx_bridge_rocketmq/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_rocketmq/BSL.txt
+++ b/apps/emqx_bridge_rocketmq/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_sqlserver/BSL.txt b/apps/emqx_bridge_sqlserver/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_sqlserver/BSL.txt
+++ b/apps/emqx_bridge_sqlserver/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_syskeeper/BSL.txt b/apps/emqx_bridge_syskeeper/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_syskeeper/BSL.txt
+++ b/apps/emqx_bridge_syskeeper/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_tdengine/BSL.txt b/apps/emqx_bridge_tdengine/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_tdengine/BSL.txt
+++ b/apps/emqx_bridge_tdengine/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_bridge_timescale/BSL.txt b/apps/emqx_bridge_timescale/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_bridge_timescale/BSL.txt
+++ b/apps/emqx_bridge_timescale/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_dashboard_rbac/BSL.txt b/apps/emqx_dashboard_rbac/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_dashboard_rbac/BSL.txt
+++ b/apps/emqx_dashboard_rbac/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_dashboard_sso/BSL.txt b/apps/emqx_dashboard_sso/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_dashboard_sso/BSL.txt
+++ b/apps/emqx_dashboard_sso/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_durable_storage/BSL.txt b/apps/emqx_durable_storage/BSL.txt
index 2374e6ce2..f0cd31c6f 100644
--- a/apps/emqx_durable_storage/BSL.txt
+++ b/apps/emqx_durable_storage/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-06-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_enterprise/BSL.txt b/apps/emqx_enterprise/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_enterprise/BSL.txt
+++ b/apps/emqx_enterprise/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_eviction_agent/BSL.txt b/apps/emqx_eviction_agent/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_eviction_agent/BSL.txt
+++ b/apps/emqx_eviction_agent/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_ft/BSL.txt b/apps/emqx_ft/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_ft/BSL.txt
+++ b/apps/emqx_ft/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_gateway_gbt32960/BSL.txt b/apps/emqx_gateway_gbt32960/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_gateway_gbt32960/BSL.txt
+++ b/apps/emqx_gateway_gbt32960/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_gateway_jt808/BSL.txt b/apps/emqx_gateway_jt808/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_gateway_jt808/BSL.txt
+++ b/apps/emqx_gateway_jt808/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_gateway_ocpp/BSL.txt b/apps/emqx_gateway_ocpp/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_gateway_ocpp/BSL.txt
+++ b/apps/emqx_gateway_ocpp/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_gcp_device/BSL.txt b/apps/emqx_gcp_device/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_gcp_device/BSL.txt
+++ b/apps/emqx_gcp_device/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_license/BSL.txt b/apps/emqx_license/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_license/BSL.txt
+++ b/apps/emqx_license/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_node_rebalance/BSL.txt b/apps/emqx_node_rebalance/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_node_rebalance/BSL.txt
+++ b/apps/emqx_node_rebalance/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_oracle/BSL.txt b/apps/emqx_oracle/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_oracle/BSL.txt
+++ b/apps/emqx_oracle/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_s3/BSL.txt b/apps/emqx_s3/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_s3/BSL.txt
+++ b/apps/emqx_s3/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/apps/emqx_schema_registry/BSL.txt b/apps/emqx_schema_registry/BSL.txt
index 0acc0e696..f0cd31c6f 100644
--- a/apps/emqx_schema_registry/BSL.txt
+++ b/apps/emqx_schema_registry/BSL.txt
@@ -7,7 +7,7 @@ Licensed Work:        EMQX Enterprise Edition
 Additional Use Grant: Students and educators are granted right to copy,
                       modify, and create derivative work for research
                       or education.
-Change Date:          2027-02-01
+Change Date:          2028-01-26
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Software,
diff --git a/scripts/update-bsl-license-convert-year.sh b/scripts/update-bsl-license-convert-year.sh
index 636ba8e7a..3c0d49646 100755
--- a/scripts/update-bsl-license-convert-year.sh
+++ b/scripts/update-bsl-license-convert-year.sh
@@ -3,7 +3,6 @@
 set -euo pipefail
 
 CONVERT_DATE="$(date -d "+4 years" '+%Y-%m-%d')"
-NEWTEXT="Change Date:          $CONVERT_DATE"
 
 update() {
     local file="$1"

From b849b08dbc22c65252523b5e0cd627410e127be4 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Mon, 29 Jan 2024 16:47:17 +0100
Subject: [PATCH 100/273] fix: kinesis schema problems found by @HJianBo

This commit fixes problems in schema found by @HJianBo here:

https://github.com/emqx/emqx/pull/12376#pullrequestreview-1848306286
---
 .../src/emqx_bridge_kinesis.erl               | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index 1ce62dcda..d2c0081dd 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -42,7 +42,7 @@ fields(Field) when
     emqx_connector_schema:api_fields(
         Field,
         ?CONNECTOR_TYPE,
-        connector_config_fields()
+        fields("config_connector")
     );
 fields(action) ->
     {?ACTION_TYPE,
@@ -54,7 +54,7 @@ fields(action) ->
             }
         )};
 fields(action_parameters) ->
-    fields(producer);
+    fields(producer) -- fields(local_topic);
 fields(kinesis_action) ->
     emqx_bridge_v2_schema:make_producer_action_schema(
         hoconsc:mk(
@@ -142,13 +142,6 @@ fields(producer) ->
                     desc => ?DESC("payload_template")
                 }
             )},
-        {local_topic,
-            sc(
-                binary(),
-                #{
-                    desc => ?DESC("local_topic")
-                }
-            )},
         {stream_name,
             sc(
                 binary(),
@@ -165,6 +158,16 @@ fields(producer) ->
                     desc => ?DESC("partition_key")
                 }
             )}
+    ] ++ fields(local_topic);
+fields(local_topic) ->
+    [
+        {local_topic,
+            sc(
+                binary(),
+                #{
+                    desc => ?DESC("local_topic")
+                }
+            )}
     ];
 fields("get_producer") ->
     emqx_bridge_schema:status_fields() ++ fields("post_producer");
@@ -174,7 +177,7 @@ fields("put_producer") ->
     fields("config_producer");
 fields("config_connector") ->
     emqx_connector_schema:common_fields() ++
-        connector_config_fields() ++
+        fields(connector_config) ++
         emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
 fields(connector_resource_opts) ->
     emqx_connector_schema:resource_opts_fields();
@@ -278,9 +281,6 @@ conn_bridge_values() ->
 %% Helper fns
 %%-------------------------------------------------------------------------------------------------
 
-connector_config_fields() ->
-    fields(connector_config).
-
 sc(Type, Meta) -> hoconsc:mk(Type, Meta).
 
 mk(Type, Meta) -> hoconsc:mk(Type, Meta).

From 206af96a33c7071c49e02d99fe6c8a238b27de95 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 30 Jan 2024 15:45:50 +0800
Subject: [PATCH 101/273] ci: update testcases for message-expiry-interval

---
 apps/emqx/test/emqx_message_SUITE.erl | 46 +++++++++++++++++++++++----
 1 file changed, 39 insertions(+), 7 deletions(-)

diff --git a/apps/emqx/test/emqx_message_SUITE.erl b/apps/emqx/test/emqx_message_SUITE.erl
index c97c0d899..7bf6c9a7e 100644
--- a/apps/emqx/test/emqx_message_SUITE.erl
+++ b/apps/emqx/test/emqx_message_SUITE.erl
@@ -141,18 +141,50 @@ t_undefined_headers(_) ->
     Msg2 = emqx_message:set_header(c, 3, Msg),
     ?assertEqual(3, emqx_message:get_header(c, Msg2)).
 
-t_is_expired(_) ->
+t_is_expired_1(_) ->
+    test_msg_expired_property(?MODULE).
+
+t_is_expired_2(_) ->
+    %% if the 'Message-Expiry-Interval' property is set, the message_expiry_interval should be ignored
+    try
+        emqx_config:put(
+            maps:from_list([{list_to_atom(Root), #{}} || Root <- emqx_zone_schema:roots()])
+        ),
+        emqx_config:put_zone_conf(?MODULE, [mqtt, message_expiry_interval], timer:seconds(10)),
+        test_msg_expired_property(?MODULE)
+    after
+        emqx_config:erase_all()
+    end.
+
+t_is_expired_3(_) ->
+    try
+        emqx_config:put(
+            maps:from_list([{list_to_atom(Root), #{}} || Root <- emqx_zone_schema:roots()])
+        ),
+        emqx_config:put_zone_conf(?MODULE, [mqtt, message_expiry_interval], 100),
+        Msg = emqx_message:make(<<"clientid">>, <<"topic">>, <<"payload">>),
+        ?assertNot(emqx_message:is_expired(Msg, ?MODULE)),
+        timer:sleep(120),
+        ?assert(emqx_message:is_expired(Msg, ?MODULE))
+    after
+        emqx_config:erase_all()
+    end.
+
+test_msg_expired_property(Zone) ->
     Msg = emqx_message:make(<<"clientid">>, <<"topic">>, <<"payload">>),
-    ?assertNot(emqx_message:is_expired(Msg, ?MODULE)),
+    ?assertNot(emqx_message:is_expired(Msg, Zone)),
     Msg1 = emqx_message:set_headers(#{properties => #{'Message-Expiry-Interval' => 1}}, Msg),
     timer:sleep(500),
-    ?assertNot(emqx_message:is_expired(Msg1, ?MODULE)),
+    ?assertNot(emqx_message:is_expired(Msg1, Zone)),
     timer:sleep(600),
-    ?assert(emqx_message:is_expired(Msg1, ?MODULE)),
+    ?assert(emqx_message:is_expired(Msg1, Zone)).
+
+t_update_expired(_) ->
+    Msg = emqx_message:make(<<"clientid">>, <<"topic">>, <<"payload">>),
     timer:sleep(1000),
-    Msg = emqx_message:update_expiry(Msg),
-    Msg2 = emqx_message:update_expiry(Msg1),
-    Props = emqx_message:get_header(properties, Msg2),
+    ?assertEqual(Msg, emqx_message:update_expiry(Msg)),
+    Msg1 = emqx_message:set_headers(#{properties => #{'Message-Expiry-Interval' => 1}}, Msg),
+    Props = emqx_message:get_header(properties, emqx_message:update_expiry(Msg1)),
     ?assertEqual(1, maps:get('Message-Expiry-Interval', Props)).
 
 % t_to_list(_) ->

From 30508d833c22a3bafe97af7f1bb9d0ed3bafb4bd Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 30 Jan 2024 15:46:55 +0800
Subject: [PATCH 102/273] chore: add change logs for message-expiry-interval

---
 changes/ee/feat-12417.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 changes/ee/feat-12417.md

diff --git a/changes/ee/feat-12417.md b/changes/ee/feat-12417.md
new file mode 100644
index 000000000..6847c6925
--- /dev/null
+++ b/changes/ee/feat-12417.md
@@ -0,0 +1,3 @@
+Added support for specifying the expiration time of MQTT messages via configuration file.
+
+See the description of the `message_expiry_interval` configuration in the `mqtt.conf.example` file for more details.

From 81f96f1a6809d15205525f72df6cca7f81b67489 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Tue, 30 Jan 2024 17:34:42 +0800
Subject: [PATCH 103/273] feat(opentsdb): supports more flexible tags schema

---
 .../src/emqx_bridge_opents.erl                | 54 ++++++++---
 .../src/emqx_bridge_opents_connector.erl      | 61 ++++++++++---
 .../test/emqx_bridge_opents_SUITE.erl         | 90 +++++++++++++++++++
 rel/i18n/emqx_bridge_opents.hocon             | 20 ++++-
 4 files changed, 196 insertions(+), 29 deletions(-)

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index 119de1978..16513ac11 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -130,7 +130,7 @@ fields(action_parameters) ->
                 array(ref(?MODULE, action_parameters_data)),
                 #{
                     desc => ?DESC("action_parameters_data"),
-                    default => <<"[]">>
+                    default => []
                 }
             )}
     ];
@@ -154,22 +154,27 @@ fields(action_parameters_data) ->
             )},
         {tags,
             mk(
-                binary(),
+                hoconsc:union([array(ref(?MODULE, action_parameters_data_tags)), binary()]),
                 #{
                     required => true,
                     desc => ?DESC("config_parameters_tags"),
-                    validator => fun(Tmpl) ->
-                        case emqx_placeholder:preproc_tmpl(Tmpl) of
-                            [{var, _}] ->
-                                true;
-                            _ ->
-                                ?SLOG(warning, #{
-                                    msg => "invalid_tags_template",
-                                    path => "opents.parameters.data.tags",
-                                    data => Tmpl
-                                }),
-                                false
-                        end
+                    validator => fun
+                        (Tmpl) when is_binary(Tmpl) ->
+                            case emqx_placeholder:preproc_tmpl(Tmpl) of
+                                [{var, _}] ->
+                                    true;
+                                _ ->
+                                    ?SLOG(warning, #{
+                                        msg => "invalid_tags_template",
+                                        path => "opents.parameters.data.tags",
+                                        data => Tmpl
+                                    }),
+                                    false
+                            end;
+                        ([_ | _] = Tags) when is_list(Tags) ->
+                            true;
+                        (_) ->
+                            false
                     end
                 }
             )},
@@ -182,6 +187,25 @@ fields(action_parameters_data) ->
                 }
             )}
     ];
+fields(action_parameters_data_tags) ->
+    [
+        {tag,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("tags_tag")
+                }
+            )},
+        {value,
+            mk(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("tags_value")
+                }
+            )}
+    ];
 fields("post_bridge_v2") ->
     emqx_bridge_schema:type_and_name_fields(enum([opents])) ++ fields(action_config);
 fields("put_bridge_v2") ->
@@ -197,6 +221,8 @@ desc(action_parameters) ->
     ?DESC("action_parameters");
 desc(action_parameters_data) ->
     ?DESC("action_parameters_data");
+desc(action_parameters_data_tags) ->
+    ?DESC("action_parameters_data_tags");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for OpenTSDB using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index d71468d82..faa8c769c 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -294,13 +294,26 @@ render_channel_message(Msg, #{data := DataList}, Acc) ->
     lists:foldl(
         fun(#{metric := MetricTk, tags := TagsTk, value := ValueTk} = Data, InAcc) ->
             MetricVal = emqx_placeholder:proc_tmpl(MetricTk, Msg),
+
             TagsVal =
-                case emqx_placeholder:proc_tmpl(TagsTk, Msg, RawOpts) of
-                    [undefined] ->
-                        #{};
-                    [Any] ->
-                        Any
+                case TagsTk of
+                    [tags | TagTkList] ->
+                        maps:from_list([
+                            {
+                                emqx_placeholder:proc_tmpl(TagName, Msg),
+                                emqx_placeholder:proc_tmpl(TagValue, Msg)
+                            }
+                         || {TagName, TagValue} <- TagTkList
+                        ]);
+                    TagsTks ->
+                        case emqx_placeholder:proc_tmpl(TagsTks, Msg, RawOpts) of
+                            [undefined] ->
+                                #{};
+                            [Any] ->
+                                Any
+                        end
                 end,
+
             ValueVal =
                 case ValueTk of
                     [_] ->
@@ -308,7 +321,7 @@ render_channel_message(Msg, #{data := DataList}, Acc) ->
                         %% we should keep it as it is
                         erlang:hd(emqx_placeholder:proc_tmpl(ValueTk, Msg, RawOpts));
                     Tks when is_list(Tks) ->
-                        emqx_placeholder:proc_tmpl(ValueTk, Msg);
+                        emqx_placeholder:proc_tmpl(Tks, Msg);
                     Raw ->
                         %% not a token list, just a raw value
                         Raw
@@ -332,8 +345,8 @@ preproc_data_template([]) ->
     preproc_data_template(emqx_bridge_opents:default_data_template());
 preproc_data_template(DataList) ->
     lists:map(
-        fun(Data) ->
-            {Value, Data2} = maps:take(value, Data),
+        fun(#{tags := Tags, value := Value} = Data) ->
+            Data2 = maps:without([tags, value], Data),
             Template = maps:map(
                 fun(_Key, Val) ->
                     emqx_placeholder:preproc_tmpl(Val)
@@ -341,12 +354,32 @@ preproc_data_template(DataList) ->
                 Data2
             ),
 
-            case Value of
-                Text when is_binary(Text) ->
-                    Template#{value => emqx_placeholder:preproc_tmpl(Text)};
-                Raw ->
-                    Template#{value => Raw}
-            end
+            TagsTk =
+                case Tags of
+                    Tmpl when is_binary(Tmpl) ->
+                        emqx_placeholder:preproc_tmpl(Tmpl);
+                    List ->
+                        [
+                            tags
+                            | [
+                                {
+                                    emqx_placeholder:preproc_tmpl(TagName),
+                                    emqx_placeholder:preproc_tmpl(TagValue)
+                                }
+                             || #{tag := TagName, value := TagValue} <- List
+                            ]
+                        ]
+                end,
+
+            ValueTk =
+                case Value of
+                    Text when is_binary(Text) ->
+                        emqx_placeholder:preproc_tmpl(Text);
+                    Raw ->
+                        Raw
+                end,
+
+            Template#{tags => TagsTk, value => ValueTk}
         end,
         DataList
     ).
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index e3e89d563..34b7901cc 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -294,6 +294,96 @@ t_raw_int_value(Config) ->
 t_raw_float_value(Config) ->
     raw_value_test(<<"t_raw_float_value">>, 42.5, Config).
 
+t_list_tags(Config) ->
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+    ResourceId = emqx_bridge_v2_testlib:resource_id(Config),
+    BridgeId = emqx_bridge_v2_testlib:bridge_id(Config),
+    ?retry(
+        _Sleep = 1_000,
+        _Attempts = 10,
+        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+    ),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => [#{<<"tag">> => <<"host">>, <<"value">> => <<"valueA">>}],
+                        value => <<"${value}">>
+                    }
+                ]
+            }
+        })
+    ),
+
+    Metric = <<"t_list_tags">>,
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+
+    is_success_check(
+        emqx_resource:simple_sync_query(ResourceId, {BridgeId, MakeMessageFun()})
+    ),
+
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"tags">> := #{<<"host">> := <<"valueA">>}
+            }
+        ],
+        QResult
+    ).
+
+t_list_tags_with_var(Config) ->
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
+    ResourceId = emqx_bridge_v2_testlib:resource_id(Config),
+    BridgeId = emqx_bridge_v2_testlib:bridge_id(Config),
+    ?retry(
+        _Sleep = 1_000,
+        _Attempts = 10,
+        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+    ),
+
+    ?assertMatch(
+        {ok, _},
+        emqx_bridge_v2_testlib:update_bridge_api(Config, #{
+            <<"parameters">> => #{
+                <<"data">> => [
+                    #{
+                        <<"metric">> => <<"${metric}">>,
+                        <<"tags">> => [#{<<"tag">> => <<"host">>, <<"value">> => <<"${value}">>}],
+                        value => <<"${value}">>
+                    }
+                ]
+            }
+        })
+    ),
+
+    Metric = <<"t_list_tags_with_var">>,
+    Value = 12,
+    MakeMessageFun = fun() -> make_data(Metric, Value) end,
+
+    is_success_check(
+        emqx_resource:simple_sync_query(ResourceId, {BridgeId, MakeMessageFun()})
+    ),
+
+    {ok, {{_, 200, _}, _, IoTDBResult}} = opentds_query(Config, Metric),
+    QResult = emqx_utils_json:decode(IoTDBResult),
+    ?assertMatch(
+        [
+            #{
+                <<"metric">> := Metric,
+                <<"tags">> := #{<<"host">> := <<"12">>}
+            }
+        ],
+        QResult
+    ).
+
 raw_value_test(Metric, RawValue, Config) ->
     ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
     ResourceId = emqx_bridge_v2_testlib:resource_id(Config),
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index ab2e82180..3a37e104c 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -49,7 +49,7 @@ config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:
-"""Tags. Only supports with placeholder to extract tags from a variable"""
+"""Tags. Only supports with placeholder to extract tags from a variable or a list of tags"""
 
 config_parameters_tags.label:
 """Tags"""
@@ -60,4 +60,22 @@ config_parameters_value.desc:
 config_parameters_value.label:
 """Value"""
 
+action_parameters_data_tags.desc:
+"""OpenTSDB data tags"""
+
+action_parameters_data_tags.label:
+"""Tags"""
+
+tags_tag.desc:
+"""The name of this tag. Placeholders in format of ${var} is supported"""
+
+tags_tag.label:
+"""Tag"""
+
+tags_value.desc:
+"""The value of this tag. Placeholders in format of ${var} is supported"""
+
+tags_value.label:
+"""Value"""
+
 }

From 274f378c6e6faba71a5bfcca0f8642aaf060c764 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Tue, 30 Jan 2024 17:53:32 +0100
Subject: [PATCH 104/273] fix: better delete of local_topic as suggested by
 @thalesmg

Co-authored-by:  Thales Macedo Garitezi <thalesmg@gmail.com>

Co-authored-by: Thales Macedo Garitezi <thalesmg@gmail.com>
---
 apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index d2c0081dd..1a2d63e83 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -54,7 +54,7 @@ fields(action) ->
             }
         )};
 fields(action_parameters) ->
-    fields(producer) -- fields(local_topic);
+    proplists:delete(local_topic, fields(producer));
 fields(kinesis_action) ->
     emqx_bridge_v2_schema:make_producer_action_schema(
         hoconsc:mk(

From e843d9fd919f0a1afb9388000b05be5d3b8e1a1c Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 31 Jan 2024 00:20:54 +0100
Subject: [PATCH 105/273] fix(sessds): Stream scheduler must ignore fully
 replayed streams

---
 ...x_persistent_session_ds_stream_scheduler.erl | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 03a6fbf80..475f9f9fb 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -89,13 +89,16 @@ find_new_streams(S) ->
     Comm2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
     shuffle(
         emqx_persistent_session_ds_state:fold_streams(
-            fun(Key, Stream, Acc) ->
-                case is_fully_acked(Comm1, Comm2, Stream) of
-                    true ->
-                        [{Key, Stream} | Acc];
-                    false ->
-                        Acc
-                end
+            fun
+                (_Key, #srs{it_end = end_of_stream}, Acc) ->
+                    Acc;
+                (Key, Stream, Acc) ->
+                    case is_fully_acked(Comm1, Comm2, Stream) of
+                        true ->
+                            [{Key, Stream} | Acc];
+                        false ->
+                            Acc
+                    end
             end,
             [],
             S

From 13df7fa46ec8057de954c854f778b117246b33d0 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Wed, 31 Jan 2024 13:02:01 +0800
Subject: [PATCH 106/273] fix(dashboard): add test case & update change

---
 .../src/emqx_dashboard_listener.erl           | 19 +++++++----
 .../test/emqx_dashboard_SUITE.erl             | 33 +++++++++++++++++++
 changes/ce/feat-12398.en.md                   |  1 +
 3 files changed, 47 insertions(+), 6 deletions(-)
 create mode 100644 changes/ce/feat-12398.en.md

diff --git a/apps/emqx_dashboard/src/emqx_dashboard_listener.erl b/apps/emqx_dashboard/src/emqx_dashboard_listener.erl
index 6c4b84433..d98338d18 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_listener.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_listener.erl
@@ -149,12 +149,13 @@ remove_sensitive_data(Conf0) ->
 post_config_update(_, {change_i18n_lang, _}, _NewConf, _OldConf, _AppEnvs) ->
     delay_job(regenerate);
 post_config_update(_, _Req, NewConf, OldConf, _AppEnvs) ->
+    SwaggerSupport = diff_swagger_support(NewConf, OldConf),
     OldHttp = get_listener(http, OldConf),
     OldHttps = get_listener(https, OldConf),
     NewHttp = get_listener(http, NewConf),
     NewHttps = get_listener(https, NewConf),
-    {StopHttp, StartHttp} = diff_listeners(http, OldHttp, NewHttp),
-    {StopHttps, StartHttps} = diff_listeners(https, OldHttps, NewHttps),
+    {StopHttp, StartHttp} = diff_listeners(http, OldHttp, NewHttp, SwaggerSupport),
+    {StopHttps, StartHttps} = diff_listeners(https, OldHttps, NewHttps, SwaggerSupport),
     Stop = maps:merge(StopHttp, StopHttps),
     Start = maps:merge(StartHttp, StartHttps),
     delay_job({update_listeners, Stop, Start}).
@@ -168,10 +169,16 @@ delay_job(Msg) ->
 get_listener(Type, Conf) ->
     emqx_utils_maps:deep_get([listeners, Type], Conf, undefined).
 
-diff_listeners(_, Listener, Listener) -> {#{}, #{}};
-diff_listeners(Type, undefined, Start) -> {#{}, #{Type => Start}};
-diff_listeners(Type, Stop, undefined) -> {#{Type => Stop}, #{}};
-diff_listeners(Type, Stop, Start) -> {#{Type => Stop}, #{Type => Start}}.
+diff_swagger_support(NewConf, OldConf) ->
+    maps:get(swagger_support, NewConf, true) =:=
+        maps:get(swagger_support, OldConf, true).
+
+diff_listeners(_, undefined, undefined, _) -> {#{}, #{}};
+diff_listeners(_, Listener, Listener, true) -> {#{}, #{}};
+diff_listeners(Type, undefined, Start, _) -> {#{}, #{Type => Start}};
+diff_listeners(Type, Stop, undefined, _) -> {#{Type => Stop}, #{}};
+diff_listeners(Type, Listener, Listener, false) -> {#{Type => Listener}, #{Type => Listener}};
+diff_listeners(Type, Stop, Start, _) -> {#{Type => Stop}, #{Type => Start}}.
 
 -define(DIR, <<"dashboard">>).
 
diff --git a/apps/emqx_dashboard/test/emqx_dashboard_SUITE.erl b/apps/emqx_dashboard/test/emqx_dashboard_SUITE.erl
index a11b537d1..ed1925b0e 100644
--- a/apps/emqx_dashboard/test/emqx_dashboard_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_dashboard_SUITE.erl
@@ -31,6 +31,7 @@
 -include_lib("eunit/include/eunit.hrl").
 -include_lib("common_test/include/ct.hrl").
 -include_lib("emqx/include/emqx.hrl").
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include("emqx_dashboard.hrl").
 
 -define(CONTENT_TYPE, "application/x-www-form-urlencoded").
@@ -188,6 +189,38 @@ t_swagger_json(_Config) ->
     ),
     ok.
 
+t_disable_swagger_json(_Config) ->
+    Url = ?HOST ++ "/api-docs/index.html",
+
+    ?assertMatch(
+        {ok, {{"HTTP/1.1", 200, "OK"}, __, _}},
+        httpc:request(get, {Url, []}, [], [{body_format, binary}])
+    ),
+
+    DashboardCfg = emqx:get_raw_config([dashboard]),
+    DashboardCfg2 = DashboardCfg#{<<"swagger_support">> => false},
+    emqx:update_config([dashboard], DashboardCfg2),
+    ?retry(
+        _Sleep = 1000,
+        _Attempts = 5,
+        ?assertMatch(
+            {ok, {{"HTTP/1.1", 404, "Not Found"}, _, _}},
+            httpc:request(get, {Url, []}, [], [{body_format, binary}])
+        )
+    ),
+
+    DashboardCfg3 = DashboardCfg#{<<"swagger_support">> => true},
+    emqx:update_config([dashboard], DashboardCfg3),
+    ?retry(
+        _Sleep0 = 1000,
+        _Attempts0 = 5,
+        ?assertMatch(
+            {ok, {{"HTTP/1.1", 200, "OK"}, __, _}},
+            httpc:request(get, {Url, []}, [], [{body_format, binary}])
+        )
+    ),
+    ok.
+
 t_cli(_Config) ->
     [mria:dirty_delete(?ADMIN, Admin) || Admin <- mnesia:dirty_all_keys(?ADMIN)],
     emqx_dashboard_cli:admins(["add", "username", "password_ww2"]),
diff --git a/changes/ce/feat-12398.en.md b/changes/ce/feat-12398.en.md
new file mode 100644
index 000000000..71f88c138
--- /dev/null
+++ b/changes/ce/feat-12398.en.md
@@ -0,0 +1 @@
+Exposed the `swagger_support` option in configuration for Dashboard to disable the swagger API document.

From 4d0febd38000c2a9d5543d99f04e0f8ea907193c Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Thu, 11 Jan 2024 23:14:57 +0100
Subject: [PATCH 107/273] docs: fix schema name-version description

---
 rel/i18n/emqx_plugins_schema.hocon | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/rel/i18n/emqx_plugins_schema.hocon b/rel/i18n/emqx_plugins_schema.hocon
index b72c87054..af1fb4a0b 100644
--- a/rel/i18n/emqx_plugins_schema.hocon
+++ b/rel/i18n/emqx_plugins_schema.hocon
@@ -22,9 +22,9 @@ install_dir.label:
 """Install Directory"""
 
 name_vsn.desc:
-"""The {name}-{version} of the plugin.<br/>
-It should match the plugin application name-version as the for the plugin release package name<br/>
-For example: my_plugin-0.1.0."""
+"""The `{name}-{version}` of the plugin.<br/>
+It should match the plugin application name-version as plugin release package name<br/>
+For example: `my_plugin-0.1.0`."""
 
 name_vsn.label:
 """Name-Version"""

From e9318752e626553c834257f85045eeea3c98a7a1 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 12 Jan 2024 14:58:37 +0100
Subject: [PATCH 108/273] feat: store session unregistration timestamp in
 emqx_cm_registry table

---
 apps/emqx/include/emqx_cm.hrl              |   9 +-
 apps/emqx/src/emqx_cm_registry.erl         | 150 ++++++++++++++++++---
 apps/emqx/src/emqx_cm_registry_cleaner.erl | 139 +++++++++++++++++++
 apps/emqx/src/emqx_cm_sup.erl              |   2 +
 apps/emqx/src/emqx_schema.erl              |  74 ++++++----
 rel/i18n/emqx_schema.hocon                 |  18 ++-
 6 files changed, 342 insertions(+), 50 deletions(-)
 create mode 100644 apps/emqx/src/emqx_cm_registry_cleaner.erl

diff --git a/apps/emqx/include/emqx_cm.hrl b/apps/emqx/include/emqx_cm.hrl
index 6478a6162..d1d195921 100644
--- a/apps/emqx/include/emqx_cm.hrl
+++ b/apps/emqx/include/emqx_cm.hrl
@@ -23,7 +23,7 @@
 -define(CHAN_INFO_TAB, emqx_channel_info).
 -define(CHAN_LIVE_TAB, emqx_channel_live).
 
-%% Mria/Mnesia Tables for channel management.
+%% Mria table for session registraition.
 -define(CHAN_REG_TAB, emqx_channel_registry).
 
 -define(T_KICK, 5_000).
@@ -32,4 +32,11 @@
 
 -define(CM_POOL, emqx_cm_pool).
 
+%% Registered sessions.
+-record(channel, {
+    chid :: emqx_types:clientid() | '_',
+    %% pid field is extended in 5.6.0 to support recording unregistration timestamp.
+    pid :: pid() | non_neg_integer() | '$1'
+}).
+
 -endif.
diff --git a/apps/emqx/src/emqx_cm_registry.erl b/apps/emqx/src/emqx_cm_registry.erl
index 058bb53ec..0236cbc06 100644
--- a/apps/emqx/src/emqx_cm_registry.erl
+++ b/apps/emqx/src/emqx_cm_registry.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2019-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2019-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -19,14 +19,9 @@
 
 -behaviour(gen_server).
 
--include("emqx.hrl").
--include("emqx_cm.hrl").
--include("logger.hrl").
--include("types.hrl").
-
 -export([start_link/0]).
 
--export([is_enabled/0]).
+-export([is_enabled/0, is_hist_enabled/0]).
 
 -export([
     register_channel/1,
@@ -50,10 +45,13 @@
     do_cleanup_channels/1
 ]).
 
--define(REGISTRY, ?MODULE).
--define(LOCK, {?MODULE, cleanup_down}).
+-include("emqx.hrl").
+-include("emqx_cm.hrl").
+-include("logger.hrl").
+-include("types.hrl").
 
--record(channel, {chid, pid}).
+-define(REGISTRY, ?MODULE).
+-define(NODE_DOWN_CLEANUP_LOCK, {?MODULE, cleanup_down}).
 
 %% @doc Start the global channel registry.
 -spec start_link() -> startlink_ret().
@@ -69,6 +67,11 @@ start_link() ->
 is_enabled() ->
     emqx:get_config([broker, enable_session_registry]).
 
+%% @doc Is the global session registration history enabled?
+-spec is_hist_enabled() -> boolean().
+is_hist_enabled() ->
+    retain_duration() > 0.
+
 %% @doc Register a global channel.
 -spec register_channel(
     emqx_types:clientid()
@@ -78,8 +81,11 @@ register_channel(ClientId) when is_binary(ClientId) ->
     register_channel({ClientId, self()});
 register_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid) ->
     case is_enabled() of
-        true -> mria:dirty_write(?CHAN_REG_TAB, record(ClientId, ChanPid));
-        false -> ok
+        true ->
+            ok = when_hist_enabled(fun() -> delete_hist_d(ClientId) end),
+            mria:dirty_write(?CHAN_REG_TAB, record(ClientId, ChanPid));
+        false ->
+            ok
     end.
 
 %% @doc Unregister a global channel.
@@ -91,18 +97,45 @@ unregister_channel(ClientId) when is_binary(ClientId) ->
     unregister_channel({ClientId, self()});
 unregister_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid) ->
     case is_enabled() of
-        true -> mria:dirty_delete_object(?CHAN_REG_TAB, record(ClientId, ChanPid));
-        false -> ok
+        true ->
+            mria:dirty_delete_object(?CHAN_REG_TAB, record(ClientId, ChanPid)),
+            %% insert unregistration history after unrestration
+            ok = when_hist_enabled(fun() -> insert_hist_d(ClientId) end);
+        false ->
+            ok
     end.
 
 %% @doc Lookup the global channels.
 -spec lookup_channels(emqx_types:clientid()) -> list(pid()).
 lookup_channels(ClientId) ->
-    [ChanPid || #channel{pid = ChanPid} <- mnesia:dirty_read(?CHAN_REG_TAB, ClientId)].
+    lists:filtermap(
+        fun
+            (#channel{pid = ChanPid}) when is_pid(ChanPid) ->
+                case is_pid_down(ChanPid) of
+                    true ->
+                        false;
+                    _ ->
+                        {true, ChanPid}
+                end;
+            (_) ->
+                false
+        end,
+        mnesia:dirty_read(?CHAN_REG_TAB, ClientId)
+    ).
+
+%% Return 'true' or 'false' if it's a local pid.
+%% Otherwise return 'unknown'.
+is_pid_down(Pid) when node(Pid) =:= node() ->
+    not erlang:is_process_alive(Pid);
+is_pid_down(_) ->
+    unknown.
 
 record(ClientId, ChanPid) ->
     #channel{chid = ClientId, pid = ChanPid}.
 
+hist(ClientId) ->
+    #channel{chid = ClientId, pid = now_ts()}.
+
 %%--------------------------------------------------------------------
 %% gen_server callbacks
 %%--------------------------------------------------------------------
@@ -158,15 +191,96 @@ code_change(_OldVsn, State, _Extra) ->
 
 cleanup_channels(Node) ->
     global:trans(
-        {?LOCK, self()},
+        {?NODE_DOWN_CLEANUP_LOCK, self()},
         fun() ->
             mria:transaction(?CM_SHARD, fun ?MODULE:do_cleanup_channels/1, [Node])
         end
     ).
 
 do_cleanup_channels(Node) ->
-    Pat = [{#channel{pid = '$1', _ = '_'}, [{'==', {node, '$1'}, Node}], ['$_']}],
+    Pat = [
+        {
+            #channel{pid = '$1', _ = '_'},
+            _Match = [{'andalso', {is_pid, '$1'}, {'==', {node, '$1'}, Node}}],
+            _Return = ['$_']
+        }
+    ],
     lists:foreach(fun delete_channel/1, mnesia:select(?CHAN_REG_TAB, Pat, write)).
 
 delete_channel(Chan) ->
-    mnesia:delete_object(?CHAN_REG_TAB, Chan, write).
+    mnesia:delete_object(?CHAN_REG_TAB, Chan, write),
+    ok = when_hist_enabled(fun() -> insert_hist_t(Chan#channel.chid) end).
+
+%%--------------------------------------------------------------------
+%% History entry operations
+%%--------------------------------------------------------------------
+
+when_hist_enabled(F) ->
+    case is_hist_enabled() of
+        true ->
+            _ = F();
+        false ->
+            ok
+    end,
+    ok.
+
+%% Insert unregistration history in a transaction when unregistering the last channel for a clientid.
+insert_hist_t(ClientId) ->
+    case delete_hist_t(ClientId) of
+        true ->
+            ok;
+        false ->
+            mnesia:write(?CHAN_REG_TAB, hist(ClientId), write)
+    end.
+
+%% Dirty insert unregistration history.
+%% Since dirty opts are used, async pool workers may race deletes and inserts,
+%% so there could be more than one history records for a clientid,
+%% but it should be eventually consistent after the client re-registers or the periodic cleanup.
+insert_hist_d(ClientId) ->
+    %% delete old hist records first
+    case delete_hist_d(ClientId) of
+        true ->
+            ok;
+        false ->
+            mria:dirty_write(?CHAN_REG_TAB, hist(ClientId))
+    end.
+
+%% Current timestamp in seconds.
+now_ts() ->
+    erlang:system_time(seconds).
+
+%% Delete all history records for a clientid, return true if there is a Pid found.
+delete_hist_t(ClientId) ->
+    fold_hist(
+        fun(Hist) -> mnesia:delete_object(?CHAN_REG_TAB, Hist, write) end,
+        mnesia:read(?CHAN_REG_TAB, ClientId, write)
+    ).
+
+%% Delete all history records for a clientid, return true if there is a Pid found.
+delete_hist_d(ClientId) ->
+    fold_hist(
+        fun(Hist) -> mria:dirty_delete_object(?CHAN_REG_TAB, Hist) end,
+        mnesia:dirty_read(?CHAN_REG_TAB, ClientId)
+    ).
+
+%% Fold over the history records, return true if there is a Pid found.
+fold_hist(F, List) ->
+    lists:foldl(
+        fun(#channel{pid = Ts} = Record, HasPid) ->
+            case is_integer(Ts) of
+                true ->
+                    ok = F(Record),
+                    HasPid;
+                false ->
+                    true
+            end
+        end,
+        false,
+        List
+    ).
+
+%% Return the session registration history retain duration.
+-spec retain_duration() -> non_neg_integer().
+retain_duration() ->
+    emqx:get_config([broker, session_registration_history_retain]).
diff --git a/apps/emqx/src/emqx_cm_registry_cleaner.erl b/apps/emqx/src/emqx_cm_registry_cleaner.erl
new file mode 100644
index 000000000..41f5bfc6b
--- /dev/null
+++ b/apps/emqx/src/emqx_cm_registry_cleaner.erl
@@ -0,0 +1,139 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+%% @doc This module implements the global session registry history cleaner.
+-module(emqx_cm_registry_cleaner).
+-behaviour(gen_server).
+
+-export([start_link/0]).
+
+%% gen_server callbacks
+-export([
+    init/1,
+    handle_call/3,
+    handle_cast/2,
+    handle_info/2,
+    terminate/2,
+    code_change/3
+]).
+
+-include("emqx_cm.hrl").
+
+start_link() ->
+    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
+
+init(_) ->
+    case mria_config:whoami() =:= core of
+        true ->
+            ok = send_delay_start(),
+            {ok, #{next_clientid => undefined}};
+        false ->
+            ignore
+    end.
+
+handle_call(_Request, _From, State) ->
+    {reply, ok, State}.
+
+handle_cast(_Msg, State) ->
+    {noreply, State}.
+
+handle_info(start, #{next_clientid := NextClientId} = State) ->
+    case is_hist_enabled() of
+        true ->
+            NewNext =
+                case cleanup_one_chunk(NextClientId) of
+                    '$end_of_table' ->
+                        ok = send_delay_start(),
+                        undefined;
+                    Id ->
+                        _ = erlang:garbage_collect(),
+                        Id
+                end,
+            {noreply, State#{next_clientid := NewNext}};
+        false ->
+            %% if not enabled, dealy and check again
+            %% because it might be enabled from online config change while waiting
+            ok = send_delay_start(),
+            {noreply, State}
+    end;
+handle_info(_Info, State) ->
+    {noreply, State}.
+
+terminate(_Reason, _State) ->
+    ok.
+
+code_change(_OldVsn, State, _Extra) ->
+    {ok, State}.
+
+cleanup_one_chunk(NextClientId) ->
+    Retain = retain_duration(),
+    Now = now_ts(),
+    IsExpired = fun(#channel{pid = Ts}) ->
+        is_integer(Ts) andalso (Ts < Now - Retain)
+    end,
+    cleanup_loop(NextClientId, 10000, IsExpired).
+
+cleanup_loop(ClientId, 0, _IsExpired) ->
+    ClientId;
+cleanup_loop('$end_of_table', _Count, _IsExpired) ->
+    '$end_of_table';
+cleanup_loop(undefined, Count, IsExpired) ->
+    cleanup_loop(mnesia:dirty_first(?CHAN_REG_TAB), Count, IsExpired);
+cleanup_loop(ClientId, Count, IsExpired) ->
+    Recods = mnesia:dirty_read(?CHAN_REG_TAB, ClientId),
+    Next = mnesia:dirty_next(?CHAN_REG_TAB, ClientId),
+    lists:foreach(
+        fun(R) ->
+            case IsExpired(R) of
+                true ->
+                    mria:dirty_delete_object(?CHAN_REG_TAB, R);
+                false ->
+                    ok
+            end
+        end,
+        Recods
+    ),
+    cleanup_loop(Next, Count - 1, IsExpired).
+
+is_hist_enabled() ->
+    retain_duration() > 0.
+
+%% Return the session registration history retain duration in seconds.
+-spec retain_duration() -> non_neg_integer().
+retain_duration() ->
+    emqx:get_config([broker, session_registration_history_retain]).
+
+cleanup_delay() ->
+    Default = timer:minutes(2),
+    case retain_duration() of
+        0 ->
+            %% prepare for online config change
+            Default;
+        RetainSeconds ->
+            Min = max(1, timer:seconds(RetainSeconds div 4)),
+            min(Min, Default)
+    end.
+
+send_delay_start() ->
+    Delay = cleanup_delay(),
+    ok = send_delay_start(Delay).
+
+send_delay_start(Delay) ->
+    _ = erlang:send_after(Delay, self(), start),
+    ok.
+
+now_ts() ->
+    erlang:system_time(seconds).
diff --git a/apps/emqx/src/emqx_cm_sup.erl b/apps/emqx/src/emqx_cm_sup.erl
index 622921f1d..348c3fca0 100644
--- a/apps/emqx/src/emqx_cm_sup.erl
+++ b/apps/emqx/src/emqx_cm_sup.erl
@@ -49,6 +49,7 @@ init([]) ->
     Locker = child_spec(emqx_cm_locker, 5000, worker),
     CmPool = emqx_pool_sup:spec(emqx_cm_pool_sup, [?CM_POOL, random, {emqx_pool, start_link, []}]),
     Registry = child_spec(emqx_cm_registry, 5000, worker),
+    RegistryCleaner = child_spec(emqx_cm_registry_cleaner, 5000, worker),
     Manager = child_spec(emqx_cm, 5000, worker),
     DSSessionGCSup = child_spec(emqx_persistent_session_ds_sup, infinity, supervisor),
     Children =
@@ -58,6 +59,7 @@ init([]) ->
             Locker,
             CmPool,
             Registry,
+            RegistryCleaner,
             Manager,
             DSSessionGCSup
         ],
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index d9171f711..ec4edfb6b 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -182,7 +182,7 @@
 -define(DEFAULT_MULTIPLIER, 1.5).
 -define(DEFAULT_BACKOFF, 0.75).
 
-namespace() -> broker.
+namespace() -> emqx.
 
 tags() ->
     [<<"EMQX">>].
@@ -230,7 +230,7 @@ roots(high) ->
         );
 roots(medium) ->
     [
-        {"broker",
+        {broker,
             sc(
                 ref("broker"),
                 #{
@@ -1347,24 +1347,43 @@ fields("deflate_opts") ->
     ];
 fields("broker") ->
     [
-        {"enable_session_registry",
+        {enable_session_registry,
             sc(
                 boolean(),
                 #{
                     default => true,
+                    importance => ?IMPORTANCE_HIGH,
                     desc => ?DESC(broker_enable_session_registry)
                 }
             )},
-        {"session_locking_strategy",
+        {session_registration_history_retain,
+            sc(
+                duration_s(),
+                #{
+                    default => <<"0s">>,
+                    importance => ?IMPORTANCE_LOW,
+                    desc => ?DESC("broker_session_registration_history_retain")
+                }
+            )},
+        {session_locking_strategy,
             sc(
                 hoconsc:enum([local, leader, quorum, all]),
                 #{
                     default => quorum,
+                    importance => ?IMPORTANCE_HIDDEN,
                     desc => ?DESC(broker_session_locking_strategy)
                 }
             )},
-        shared_subscription_strategy(),
-        {"shared_dispatch_ack_enabled",
+        %% moved to under mqtt root
+        {shared_subscription_strategy,
+            sc(
+                string(),
+                #{
+                    deprecated => {since, "5.1.0"},
+                    importance => ?IMPORTANCE_HIDDEN
+                }
+            )},
+        {shared_dispatch_ack_enabled,
             sc(
                 boolean(),
                 #{
@@ -1374,7 +1393,7 @@ fields("broker") ->
                     desc => ?DESC(broker_shared_dispatch_ack_enabled)
                 }
             )},
-        {"route_batch_clean",
+        {route_batch_clean,
             sc(
                 boolean(),
                 #{
@@ -1383,18 +1402,18 @@ fields("broker") ->
                     importance => ?IMPORTANCE_HIDDEN
                 }
             )},
-        {"perf",
+        {perf,
             sc(
                 ref("broker_perf"),
                 #{importance => ?IMPORTANCE_HIDDEN}
             )},
-        {"routing",
+        {routing,
             sc(
                 ref("broker_routing"),
                 #{importance => ?IMPORTANCE_HIDDEN}
             )},
         %% FIXME: Need new design for shared subscription group
-        {"shared_subscription_group",
+        {shared_subscription_group,
             sc(
                 map(name, ref("shared_subscription_group")),
                 #{
@@ -3640,7 +3659,22 @@ mqtt_general() ->
                     desc => ?DESC(mqtt_shared_subscription)
                 }
             )},
-        shared_subscription_strategy(),
+        {"shared_subscription_strategy",
+            sc(
+                hoconsc:enum([
+                    random,
+                    round_robin,
+                    round_robin_per_group,
+                    sticky,
+                    local,
+                    hash_topic,
+                    hash_clientid
+                ]),
+                #{
+                    default => round_robin,
+                    desc => ?DESC(mqtt_shared_subscription_strategy)
+                }
+            )},
         {"exclusive_subscription",
             sc(
                 boolean(),
@@ -3846,24 +3880,6 @@ mqtt_session() ->
             )}
     ].
 
-shared_subscription_strategy() ->
-    {"shared_subscription_strategy",
-        sc(
-            hoconsc:enum([
-                random,
-                round_robin,
-                round_robin_per_group,
-                sticky,
-                local,
-                hash_topic,
-                hash_clientid
-            ]),
-            #{
-                default => round_robin,
-                desc => ?DESC(broker_shared_subscription_strategy)
-            }
-        )}.
-
 default_mem_check_interval() ->
     case emqx_os_mon:is_os_check_supported() of
         true -> <<"60s">>;
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index 40da8d75e..94ba275f3 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1022,7 +1022,7 @@ fields_ws_opts_supported_subprotocols.desc:
 fields_ws_opts_supported_subprotocols.label:
 """Supported subprotocols"""
 
-broker_shared_subscription_strategy.desc:
+mqtt_shared_subscription_strategy.desc:
 """Dispatch strategy for shared subscription.
  - `random`: Randomly select a subscriber for dispatch;
  - `round_robin`: Messages from a single publisher are dispatched to subscribers in turn;
@@ -1420,7 +1420,21 @@ force_shutdown_enable.label:
 """Enable `force_shutdown` feature"""
 
 broker_enable_session_registry.desc:
-"""Enable session registry"""
+"""The Global Session Registry is a cluster-wide mechanism designed to maintain the uniqueness of client IDs within the cluster.
+Recommendations for Use<br/>
+- Default Setting: It is generally advisable to enable. This feature is crucial for session takeover to work properly. For example if a client reconneted to another node in the cluster, the new connection will need to find the old session and take it over.
+- Disabling the Feature: Disabling is an option for scenarios when all sessions expire immediately after client is disconnected (i.e. session expiry interval is zero). This can be relevant in certain specialized use cases.
+
+Advantages of Disabling<br/>
+- Reduced Memory Usage: Turning off the session registry can lower the overall memory footprint of the system.
+- Improved Performance: Without the overhead of maintaining a global registry, the node can process client connections faster."""
+
+broker_session_registration_history_retain.desc:
+"""The duration to retain the session registration history. Setting this to a value greater than `0s` will increase memory usage and impact peformance.
+This retained history can be used to monitor how many sessions were registered in the past configured duration.
+Note: This config has no effect if `enable_session_registry` is set to `false`.<br/>
+Note: If the clients are suing random client IDs, it's not recommended to enable this feature, at least not for a long retain duration.<br/>
+Note: When clustered, the lowest (but greater than `0s`) value among the nodes in the cluster will take effect."""
 
 overload_protection_backoff_delay.desc:
 """The maximum duration of delay for background task execution during high load conditions."""

From 562a2736ae243b23760023186bb5be7aad5e61a2 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Mon, 15 Jan 2024 15:58:30 +0100
Subject: [PATCH 109/273] feat: add `broker` root to hot-config schema

---
 apps/emqx_management/src/emqx_mgmt_api_configs.erl | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/emqx_management/src/emqx_mgmt_api_configs.erl b/apps/emqx_management/src/emqx_mgmt_api_configs.erl
index ca1a9fc0b..8db1ef720 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_configs.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_configs.erl
@@ -53,7 +53,8 @@
     <<"alarm">>,
     <<"sys_topics">>,
     <<"sysmon">>,
-    <<"log">>
+    <<"log">>,
+    <<"broker">>
     | ?ROOT_KEYS_EE
 ]).
 

From 509ab6f35a44182deefb6c60339cc923b314729d Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Tue, 16 Jan 2024 14:19:31 +0100
Subject: [PATCH 110/273] feat(api): add /sessions_count api to count sessions

---
 apps/emqx/src/emqx_cm_registry.erl            |  2 +-
 ...leaner.erl => emqx_cm_registry_keeper.erl} | 61 +++++++++++++++++--
 apps/emqx/src/emqx_cm_sup.erl                 |  4 +-
 apps/emqx/src/emqx_schema.erl                 |  4 +-
 .../src/emqx_mgmt_api_clients.erl             | 35 ++++++++++-
 rel/i18n/emqx_mgmt_api_clients.hocon          |  7 +++
 rel/i18n/emqx_schema.hocon                    |  2 +-
 7 files changed, 103 insertions(+), 12 deletions(-)
 rename apps/emqx/src/{emqx_cm_registry_cleaner.erl => emqx_cm_registry_keeper.erl} (65%)

diff --git a/apps/emqx/src/emqx_cm_registry.erl b/apps/emqx/src/emqx_cm_registry.erl
index 0236cbc06..1fd140388 100644
--- a/apps/emqx/src/emqx_cm_registry.erl
+++ b/apps/emqx/src/emqx_cm_registry.erl
@@ -283,4 +283,4 @@ fold_hist(F, List) ->
 %% Return the session registration history retain duration.
 -spec retain_duration() -> non_neg_integer().
 retain_duration() ->
-    emqx:get_config([broker, session_registration_history_retain]).
+    emqx:get_config([broker, session_history_retain]).
diff --git a/apps/emqx/src/emqx_cm_registry_cleaner.erl b/apps/emqx/src/emqx_cm_registry_keeper.erl
similarity index 65%
rename from apps/emqx/src/emqx_cm_registry_cleaner.erl
rename to apps/emqx/src/emqx_cm_registry_keeper.erl
index 41f5bfc6b..8d697732a 100644
--- a/apps/emqx/src/emqx_cm_registry_cleaner.erl
+++ b/apps/emqx/src/emqx_cm_registry_keeper.erl
@@ -15,10 +15,13 @@
 %%--------------------------------------------------------------------
 
 %% @doc This module implements the global session registry history cleaner.
--module(emqx_cm_registry_cleaner).
+-module(emqx_cm_registry_keeper).
 -behaviour(gen_server).
 
--export([start_link/0]).
+-export([
+    start_link/0,
+    count/1
+]).
 
 %% gen_server callbacks
 -export([
@@ -30,8 +33,15 @@
     code_change/3
 ]).
 
+-include_lib("stdlib/include/ms_transform.hrl").
 -include("emqx_cm.hrl").
 
+-define(CACHE_COUNT_THRESHOLD, 1000).
+-define(MIN_COUNT_INTERVAL_SECONDS, 5).
+-define(CLEANUP_CHUNK_SIZE, 10000).
+
+-define(IS_HIST_ENABLED(RETAIN), (RETAIN > 0)).
+
 start_link() ->
     gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
 
@@ -44,6 +54,45 @@ init(_) ->
             ignore
     end.
 
+%% @doc Count the number of sessions.
+%% Include sessions which are expired since the given timestamp if `since' is greater than 0.
+-spec count(non_neg_integer()) -> non_neg_integer().
+count(Since) ->
+    Retain = retain_duration(),
+    Now = now_ts(),
+    %% Get table size if hist is not enabled or
+    %% Since is before the earliest possible retention time.
+    IsCountAll = (not ?IS_HIST_ENABLED(Retain) orelse (Now - Retain >= Since)),
+    case IsCountAll of
+        true ->
+            mnesia:table_info(?CHAN_REG_TAB, size);
+        false ->
+            %% make a gen call to avoid many callers doing the same concurrently
+            gen_server:call(?MODULE, {count, Since}, infinity)
+    end.
+
+handle_call({count, Since}, _From, State) ->
+    {LastCountTime, LastCount} =
+        case State of
+            #{last_count_time := T, last_count := C} ->
+                {T, C};
+            _ ->
+                {0, 0}
+        end,
+    Now = now_ts(),
+    Total = mnesia:table_info(?CHAN_REG_TAB, size),
+    %% Always count if the table is small enough
+    %% or when the last count is too old
+    IsTableSmall = (Total < ?CACHE_COUNT_THRESHOLD),
+    IsLastCountOld = (Now - LastCountTime > ?MIN_COUNT_INTERVAL_SECONDS),
+    case IsTableSmall orelse IsLastCountOld of
+        true ->
+            Count = do_count(Since),
+            CountFinishedAt = now_ts(),
+            {reply, Count, State#{last_count_time => CountFinishedAt, last_count => Count}};
+        false ->
+            {reply, LastCount, State}
+    end;
 handle_call(_Request, _From, State) ->
     {reply, ok, State}.
 
@@ -84,7 +133,7 @@ cleanup_one_chunk(NextClientId) ->
     IsExpired = fun(#channel{pid = Ts}) ->
         is_integer(Ts) andalso (Ts < Now - Retain)
     end,
-    cleanup_loop(NextClientId, 10000, IsExpired).
+    cleanup_loop(NextClientId, ?CLEANUP_CHUNK_SIZE, IsExpired).
 
 cleanup_loop(ClientId, 0, _IsExpired) ->
     ClientId;
@@ -114,7 +163,7 @@ is_hist_enabled() ->
 %% Return the session registration history retain duration in seconds.
 -spec retain_duration() -> non_neg_integer().
 retain_duration() ->
-    emqx:get_config([broker, session_registration_history_retain]).
+    emqx:get_config([broker, session_history_retain]).
 
 cleanup_delay() ->
     Default = timer:minutes(2),
@@ -137,3 +186,7 @@ send_delay_start(Delay) ->
 
 now_ts() ->
     erlang:system_time(seconds).
+
+do_count(Since) ->
+    Ms = ets:fun2ms(fun(#channel{pid = V}) -> is_pid(V) orelse (is_integer(V) andalso (V >= Since)) end),
+    ets:select_count(?CHAN_REG_TAB, Ms).
diff --git a/apps/emqx/src/emqx_cm_sup.erl b/apps/emqx/src/emqx_cm_sup.erl
index 348c3fca0..3306b7ccd 100644
--- a/apps/emqx/src/emqx_cm_sup.erl
+++ b/apps/emqx/src/emqx_cm_sup.erl
@@ -49,7 +49,7 @@ init([]) ->
     Locker = child_spec(emqx_cm_locker, 5000, worker),
     CmPool = emqx_pool_sup:spec(emqx_cm_pool_sup, [?CM_POOL, random, {emqx_pool, start_link, []}]),
     Registry = child_spec(emqx_cm_registry, 5000, worker),
-    RegistryCleaner = child_spec(emqx_cm_registry_cleaner, 5000, worker),
+    RegistryKeeper = child_spec(emqx_cm_registry_keeper, 5000, worker),
     Manager = child_spec(emqx_cm, 5000, worker),
     DSSessionGCSup = child_spec(emqx_persistent_session_ds_sup, infinity, supervisor),
     Children =
@@ -59,7 +59,7 @@ init([]) ->
             Locker,
             CmPool,
             Registry,
-            RegistryCleaner,
+            RegistryKeeper,
             Manager,
             DSSessionGCSup
         ],
diff --git a/apps/emqx/src/emqx_schema.erl b/apps/emqx/src/emqx_schema.erl
index ec4edfb6b..d5989687d 100644
--- a/apps/emqx/src/emqx_schema.erl
+++ b/apps/emqx/src/emqx_schema.erl
@@ -1356,13 +1356,13 @@ fields("broker") ->
                     desc => ?DESC(broker_enable_session_registry)
                 }
             )},
-        {session_registration_history_retain,
+        {session_history_retain,
             sc(
                 duration_s(),
                 #{
                     default => <<"0s">>,
                     importance => ?IMPORTANCE_LOW,
-                    desc => ?DESC("broker_session_registration_history_retain")
+                    desc => ?DESC("broker_session_history_retain")
                 }
             )},
         {session_locking_strategy,
diff --git a/apps/emqx_management/src/emqx_mgmt_api_clients.erl b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
index f394ffefa..935c690fe 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_clients.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
@@ -45,7 +45,8 @@
     subscribe_batch/2,
     unsubscribe/2,
     unsubscribe_batch/2,
-    set_keepalive/2
+    set_keepalive/2,
+    sessions_count/2
 ]).
 
 -export([
@@ -96,7 +97,8 @@ paths() ->
         "/clients/:clientid/subscribe/bulk",
         "/clients/:clientid/unsubscribe",
         "/clients/:clientid/unsubscribe/bulk",
-        "/clients/:clientid/keepalive"
+        "/clients/:clientid/keepalive",
+        "/sessions_count"
     ].
 
 schema("/clients") ->
@@ -385,6 +387,30 @@ schema("/clients/:clientid/keepalive") ->
                 )
             }
         }
+    };
+schema("/sessions_count") ->
+    #{
+        'operationId' => sessions_count,
+        get => #{
+            description => ?DESC(get_sessions_count),
+            tags => ?TAGS,
+            parameters => [
+                {since,
+                    hoconsc:mk(non_neg_integer(), #{
+                        in => query,
+                        required => false,
+                        default => 0,
+                        desc =>
+                            <<"Include sessions expired after this time (UNIX Epoch in seconds precesion)">>,
+                        example => 1705391625
+                    })}
+            ],
+            responses => #{
+                200 => hoconsc:mk(binary(), #{
+                    desc => <<"Number of sessions">>
+                })
+            }
+        }
     }.
 
 fields(clients) ->
@@ -1059,3 +1085,8 @@ client_example() ->
         <<"recv_cnt">> => 4,
         <<"recv_msg.qos0">> => 0
     }.
+
+sessions_count(get, #{query_string := QString}) ->
+    Since = maps:get(<<"since">>, QString, undefined),
+    Count = emqx_cm_registry_keeper:count(Since),
+    {200, integer_to_binary(Count)}.
diff --git a/rel/i18n/emqx_mgmt_api_clients.hocon b/rel/i18n/emqx_mgmt_api_clients.hocon
index 64d4e5279..1e9193df6 100644
--- a/rel/i18n/emqx_mgmt_api_clients.hocon
+++ b/rel/i18n/emqx_mgmt_api_clients.hocon
@@ -60,4 +60,11 @@ set_keepalive_seconds.desc:
 set_keepalive_seconds.label:
 """Set the online client keepalive by seconds"""
 
+get_sessions_count.desc:
+"""Get the number of sessions. By default it returns the number of non-expired sessions.
+if `broker.session_history_retain` is set to a duration greater than `0s`,
+this API can also count expired sessions by providing the `since` parameter."""
+get_sessions_count.label:
+"""Count number of sessions"""
+
 }
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index 94ba275f3..4c9f1b83e 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1429,7 +1429,7 @@ Advantages of Disabling<br/>
 - Reduced Memory Usage: Turning off the session registry can lower the overall memory footprint of the system.
 - Improved Performance: Without the overhead of maintaining a global registry, the node can process client connections faster."""
 
-broker_session_registration_history_retain.desc:
+broker_session_history_retain.desc:
 """The duration to retain the session registration history. Setting this to a value greater than `0s` will increase memory usage and impact peformance.
 This retained history can be used to monitor how many sessions were registered in the past configured duration.
 Note: This config has no effect if `enable_session_registry` is set to `false`.<br/>

From 87a2368e3797bc98697298cf0b8f599e84507967 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 19 Jan 2024 17:31:16 +0100
Subject: [PATCH 111/273] feat(metrics): add cluster_session guage

---
 apps/emqx/src/emqx_cm.erl                           |  3 ++-
 apps/emqx/src/emqx_cm_registry.erl                  |  2 +-
 apps/emqx/src/emqx_cm_registry_keeper.erl           |  6 ++++--
 apps/emqx/src/emqx_stats.erl                        |  8 +++++++-
 apps/emqx_dashboard/src/emqx_dashboard_monitor.erl  |  1 +
 .../src/emqx_dashboard_monitor_api.erl              |  6 ++++++
 apps/emqx_management/src/emqx_mgmt.erl              |  1 +
 apps/emqx_management/src/emqx_mgmt_api_nodes.erl    | 13 +++++++++++++
 apps/emqx_management/src/emqx_mgmt_api_stats.erl    |  4 ++++
 apps/emqx_prometheus/src/emqx_prometheus.erl        |  6 +++++-
 apps/emqx_telemetry/src/emqx_telemetry.app.src      |  2 +-
 apps/emqx_telemetry/src/emqx_telemetry.erl          |  4 ++++
 rel/i18n/emqx_mgmt_api_clients.hocon                |  9 ++++++---
 13 files changed, 55 insertions(+), 10 deletions(-)

diff --git a/apps/emqx/src/emqx_cm.erl b/apps/emqx/src/emqx_cm.erl
index 10cd3d6cc..c33aacf30 100644
--- a/apps/emqx/src/emqx_cm.erl
+++ b/apps/emqx/src/emqx_cm.erl
@@ -124,7 +124,8 @@
     {?CHAN_TAB, 'channels.count', 'channels.max'},
     {?CHAN_TAB, 'sessions.count', 'sessions.max'},
     {?CHAN_CONN_TAB, 'connections.count', 'connections.max'},
-    {?CHAN_LIVE_TAB, 'live_connections.count', 'live_connections.max'}
+    {?CHAN_LIVE_TAB, 'live_connections.count', 'live_connections.max'},
+    {?CHAN_REG_TAB, 'cluster_sessions.count', 'cluster_sessions.max'}
 ]).
 
 %% Batch drain
diff --git a/apps/emqx/src/emqx_cm_registry.erl b/apps/emqx/src/emqx_cm_registry.erl
index 1fd140388..4556bce0e 100644
--- a/apps/emqx/src/emqx_cm_registry.erl
+++ b/apps/emqx/src/emqx_cm_registry.erl
@@ -99,7 +99,7 @@ unregister_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid
     case is_enabled() of
         true ->
             mria:dirty_delete_object(?CHAN_REG_TAB, record(ClientId, ChanPid)),
-            %% insert unregistration history after unrestration
+            %% insert unregistration history after unregstration
             ok = when_hist_enabled(fun() -> insert_hist_d(ClientId) end);
         false ->
             ok
diff --git a/apps/emqx/src/emqx_cm_registry_keeper.erl b/apps/emqx/src/emqx_cm_registry_keeper.erl
index 8d697732a..f661e203f 100644
--- a/apps/emqx/src/emqx_cm_registry_keeper.erl
+++ b/apps/emqx/src/emqx_cm_registry_keeper.erl
@@ -172,7 +172,7 @@ cleanup_delay() ->
             %% prepare for online config change
             Default;
         RetainSeconds ->
-            Min = max(1, timer:seconds(RetainSeconds div 4)),
+            Min = max(timer:seconds(1), timer:seconds(RetainSeconds) div 4),
             min(Min, Default)
     end.
 
@@ -188,5 +188,7 @@ now_ts() ->
     erlang:system_time(seconds).
 
 do_count(Since) ->
-    Ms = ets:fun2ms(fun(#channel{pid = V}) -> is_pid(V) orelse (is_integer(V) andalso (V >= Since)) end),
+    Ms = ets:fun2ms(fun(#channel{pid = V}) ->
+        is_pid(V) orelse (is_integer(V) andalso (V >= Since))
+    end),
     ets:select_count(?CHAN_REG_TAB, Ms).
diff --git a/apps/emqx/src/emqx_stats.erl b/apps/emqx/src/emqx_stats.erl
index 9685823ff..9b5e2a826 100644
--- a/apps/emqx/src/emqx_stats.erl
+++ b/apps/emqx/src/emqx_stats.erl
@@ -99,7 +99,11 @@
     [
         'sessions.count',
         %% Maximum Number of Concurrent Sessions
-        'sessions.max'
+        'sessions.max',
+        %% Count of Sessions in the cluster
+        'cluster_sessions.count',
+        %% Maximum Number of Sessions in the cluster
+        'cluster_sessions.max'
     ]
 ).
 
@@ -164,6 +168,8 @@ names() ->
         emqx_connections_max,
         emqx_live_connections_count,
         emqx_live_connections_max,
+        emqx_cluster_sessions_count,
+        emqx_cluster_sessions_max,
         emqx_sessions_count,
         emqx_sessions_max,
         emqx_channels_count,
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl b/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
index 4891b5293..c8f92de0d 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
@@ -415,6 +415,7 @@ getstats(Key) ->
 
 stats(connections) -> emqx_stats:getstat('connections.count');
 stats(live_connections) -> emqx_stats:getstat('live_connections.count');
+stats(cluster_sessions) -> emqx_stats:getstat('cluster_sessions.count');
 stats(topics) -> emqx_stats:getstat('topics.count');
 stats(subscriptions) -> emqx_stats:getstat('subscriptions.count');
 stats(received) -> emqx_metrics:val('messages.received');
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl b/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
index d7e3c094c..c36c6d0f3 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
@@ -194,6 +194,12 @@ swagger_desc(live_connections) ->
         "Connections at the time of sampling."
         " Can only represent the approximate state"
     >>;
+swagger_desc(cluster_sessions) ->
+    <<
+        "Total number of sessions in the cluster at the time of sampling. "
+        "It includes expired sessions when `broker.session_history_retain` is set to a duration greater than `0s`. "
+        "Can only represent the approximate state"
+    >>;
 swagger_desc(received_msg_rate) ->
     swagger_desc_format("Dropped messages ", per);
 %swagger_desc(received_bytes_rate) -> swagger_desc_format("Received bytes ", per);
diff --git a/apps/emqx_management/src/emqx_mgmt.erl b/apps/emqx_management/src/emqx_mgmt.erl
index 9d4ad8521..67405af05 100644
--- a/apps/emqx_management/src/emqx_mgmt.erl
+++ b/apps/emqx_management/src/emqx_mgmt.erl
@@ -145,6 +145,7 @@ node_info() ->
         ),
         connections => ets:info(?CHAN_TAB, size),
         live_connections => ets:info(?CHAN_LIVE_TAB, size),
+        cluster_sessions => ets:info(?CHAN_REG_TAB, size),
         node_status => 'running',
         uptime => proplists:get_value(uptime, BrokerInfo),
         version => iolist_to_binary(proplists:get_value(version, BrokerInfo)),
diff --git a/apps/emqx_management/src/emqx_mgmt_api_nodes.erl b/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
index 9afb74f38..07d775f6e 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
@@ -160,6 +160,19 @@ fields(node_info) ->
                 non_neg_integer(),
                 #{desc => <<"Number of clients currently connected to this node">>, example => 0}
             )},
+        {cluster_sessions,
+            mk(
+                non_neg_integer(),
+                #{
+                    desc =>
+                        <<
+                            "By default, it includes only those sessions that have not expired. "
+                            "If the `broker.session_history_retain` config is set to a duration greater than `0s`, "
+                            "this count will also include sessions that expired within the specified retain time"
+                        >>,
+                    example => 0
+                }
+            )},
         {load1,
             mk(
                 float(),
diff --git a/apps/emqx_management/src/emqx_mgmt_api_stats.erl b/apps/emqx_management/src/emqx_mgmt_api_stats.erl
index b57565671..cddc2a7c3 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_stats.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_stats.erl
@@ -89,6 +89,10 @@ fields(node_stats_data) ->
         stats_schema('delayed.max', <<"Historical maximum number of delayed messages">>),
         stats_schema('live_connections.count', <<"Number of current live connections">>),
         stats_schema('live_connections.max', <<"Historical maximum number of live connections">>),
+        stats_schema('cluster_sessions.count', <<"Number of sessions in the cluster">>),
+        stats_schema(
+            'cluster_sessions.max', <<"Historical maximum number of sessions in the cluster">>
+        ),
         stats_schema('retained.count', <<"Number of currently retained messages">>),
         stats_schema('retained.max', <<"Historical maximum number of retained messages">>),
         stats_schema('sessions.count', <<"Number of current sessions">>),
diff --git a/apps/emqx_prometheus/src/emqx_prometheus.erl b/apps/emqx_prometheus/src/emqx_prometheus.erl
index 59241bd02..2942ac485 100644
--- a/apps/emqx_prometheus/src/emqx_prometheus.erl
+++ b/apps/emqx_prometheus/src/emqx_prometheus.erl
@@ -251,7 +251,7 @@ add_collect_family(Name, Data, Callback, Type) ->
 
 %% behaviour
 fetch_from_local_node(Mode) ->
-    {node(self()), #{
+    {node(), #{
         stats_data => stats_data(Mode),
         vm_data => vm_data(Mode),
         cluster_data => cluster_data(Mode),
@@ -308,6 +308,8 @@ emqx_collect(K = emqx_sessions_count, D) -> gauge_metrics(?MG(K, D));
 emqx_collect(K = emqx_sessions_max, D) -> gauge_metrics(?MG(K, D));
 emqx_collect(K = emqx_channels_count, D) -> gauge_metrics(?MG(K, D));
 emqx_collect(K = emqx_channels_max, D) -> gauge_metrics(?MG(K, D));
+emqx_collect(K = emqx_cluster_sessions_count, D) -> gauge_metrics(?MG(K, D));
+emqx_collect(K = emqx_cluster_sessions_max, D) -> gauge_metrics(?MG(K, D));
 %% pub/sub stats
 emqx_collect(K = emqx_topics_count, D) -> gauge_metrics(?MG(K, D));
 emqx_collect(K = emqx_topics_max, D) -> gauge_metrics(?MG(K, D));
@@ -500,6 +502,8 @@ stats_metric_meta() ->
         {emqx_sessions_max, gauge, 'sessions.max'},
         {emqx_channels_count, gauge, 'channels.count'},
         {emqx_channels_max, gauge, 'channels.max'},
+        {emqx_cluster_sessions_count, gauge, 'cluster_sessions.count'},
+        {emqx_cluster_sessions_max, gauge, 'cluster_sessions.max'},
         %% pub/sub stats
         {emqx_suboptions_count, gauge, 'suboptions.count'},
         {emqx_suboptions_max, gauge, 'suboptions.max'},
diff --git a/apps/emqx_telemetry/src/emqx_telemetry.app.src b/apps/emqx_telemetry/src/emqx_telemetry.app.src
index 32c2baa91..b4b0ebcfe 100644
--- a/apps/emqx_telemetry/src/emqx_telemetry.app.src
+++ b/apps/emqx_telemetry/src/emqx_telemetry.app.src
@@ -1,6 +1,6 @@
 {application, emqx_telemetry, [
     {description, "Report telemetry data for EMQX Opensource edition"},
-    {vsn, "0.1.3"},
+    {vsn, "0.2.0"},
     {registered, [emqx_telemetry_sup, emqx_telemetry]},
     {mod, {emqx_telemetry_app, []}},
     {applications, [
diff --git a/apps/emqx_telemetry/src/emqx_telemetry.erl b/apps/emqx_telemetry/src/emqx_telemetry.erl
index 8842d7a86..2e54549b8 100644
--- a/apps/emqx_telemetry/src/emqx_telemetry.erl
+++ b/apps/emqx_telemetry/src/emqx_telemetry.erl
@@ -303,6 +303,9 @@ active_plugins() ->
 num_clients() ->
     emqx_stats:getstat('live_connections.count').
 
+num_cluster_sessions() ->
+    emqx_stats:getstat('cluster_sessions.count').
+
 messages_sent() ->
     emqx_metrics:val('messages.sent').
 
@@ -348,6 +351,7 @@ get_telemetry(State0 = #state{node_uuid = NodeUUID, cluster_uuid = ClusterUUID})
         {nodes_uuid, nodes_uuid()},
         {active_plugins, active_plugins()},
         {num_clients, num_clients()},
+        {num_cluster_sessions, num_cluster_sessions()},
         {messages_received, messages_received()},
         {messages_sent, messages_sent()},
         {build_info, build_info()},
diff --git a/rel/i18n/emqx_mgmt_api_clients.hocon b/rel/i18n/emqx_mgmt_api_clients.hocon
index 1e9193df6..2431c09ec 100644
--- a/rel/i18n/emqx_mgmt_api_clients.hocon
+++ b/rel/i18n/emqx_mgmt_api_clients.hocon
@@ -61,9 +61,12 @@ set_keepalive_seconds.label:
 """Set the online client keepalive by seconds"""
 
 get_sessions_count.desc:
-"""Get the number of sessions. By default it returns the number of non-expired sessions.
-if `broker.session_history_retain` is set to a duration greater than `0s`,
-this API can also count expired sessions by providing the `since` parameter."""
+"""Get the total number of sessions in the cluster.
+By default, it includes only those sessions that have not expired.
+If the `broker.session_history_retain` config is set to a duration greater than 0s,
+this count will also include sessions that expired within the specified retain time.
+By specifying the `since` parameter, it can return the number of sessions that have expired within the specified time."""
+
 get_sessions_count.label:
 """Count number of sessions"""
 

From 330baa6cc39bffca1159e5eb05a834f03d757de9 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 19 Jan 2024 17:44:49 +0100
Subject: [PATCH 112/273] docs: add changelog for #12326

---
 changes/ce/feat-12326.en.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 changes/ce/feat-12326.en.md

diff --git a/changes/ce/feat-12326.en.md b/changes/ce/feat-12326.en.md
new file mode 100644
index 000000000..bfef51eb8
--- /dev/null
+++ b/changes/ce/feat-12326.en.md
@@ -0,0 +1,14 @@
+Add session registration history.
+
+Setting config `broker.session_history_retain` allows EMQX to keep track of expired sessions for the retained period.
+
+API `GET /api/v5/sessions_count?since=1705682238` can be called to count the cluster-wide sessions which were alive (unexpired) since the provided timestamp (UNIX epoch at seconds precision).
+
+A new gauge `cluster_sessions` is added to the metrics collection. Exposed to prometheus as
+
+```
+# TYPE emqx_cluster_sessions_count gauge
+emqx_cluster_sessions_count 1234
+```
+
+The counter can only be used for an approximate estimation as the collection and calculations are async.

From 209331ad33bf05d2ad9c0abee9211109daa47962 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 19 Jan 2024 20:13:13 +0100
Subject: [PATCH 113/273] test: fix config test

---
 apps/emqx/test/emqx_config_SUITE.erl | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/apps/emqx/test/emqx_config_SUITE.erl b/apps/emqx/test/emqx_config_SUITE.erl
index 4ddebd278..72611c3a6 100644
--- a/apps/emqx/test/emqx_config_SUITE.erl
+++ b/apps/emqx/test/emqx_config_SUITE.erl
@@ -76,8 +76,7 @@ t_fill_default_values(C) when is_list(C) ->
                             <<"trie_compaction">> := true
                         },
                     <<"route_batch_clean">> := false,
-                    <<"session_locking_strategy">> := <<"quorum">>,
-                    <<"shared_subscription_strategy">> := <<"round_robin">>
+                    <<"session_history_retain">> := <<"0s">>
                 }
         },
         WithDefaults

From 38047108a4cea20d512c32a851259372c19aa0fc Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 19 Jan 2024 21:27:43 +0100
Subject: [PATCH 114/273] test: add test coverage for emqx_cm_registry_keeper
 module

---
 apps/emqx/src/emqx_cm_registry_keeper.erl     |   8 +-
 .../test/emqx_cm_registry_keeper_SUITE.erl    | 100 ++++++++++++++++++
 2 files changed, 104 insertions(+), 4 deletions(-)
 create mode 100644 apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl

diff --git a/apps/emqx/src/emqx_cm_registry_keeper.erl b/apps/emqx/src/emqx_cm_registry_keeper.erl
index f661e203f..1087932df 100644
--- a/apps/emqx/src/emqx_cm_registry_keeper.erl
+++ b/apps/emqx/src/emqx_cm_registry_keeper.erl
@@ -46,12 +46,12 @@ start_link() ->
     gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
 
 init(_) ->
-    case mria_config:whoami() =:= core of
+    case mria_config:whoami() =:= replicant of
         true ->
-            ok = send_delay_start(),
-            {ok, #{next_clientid => undefined}};
+            ignore;
         false ->
-            ignore
+            ok = send_delay_start(),
+            {ok, #{next_clientid => undefined}}
     end.
 
 %% @doc Count the number of sessions.
diff --git a/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl b/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl
new file mode 100644
index 000000000..3dcded1c3
--- /dev/null
+++ b/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl
@@ -0,0 +1,100 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2019-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_cm_registry_keeper_SUITE).
+
+-compile(export_all).
+-compile(nowarn_export_all).
+
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include("emqx_cm.hrl").
+
+%%--------------------------------------------------------------------
+%% CT callbacks
+%%--------------------------------------------------------------------
+
+all() -> emqx_common_test_helpers:all(?MODULE).
+
+init_per_suite(Config) ->
+    AppConfig = "broker.session_history_retain = 2s",
+    Apps = emqx_cth_suite:start(
+        [{emqx, #{config => AppConfig}}],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{apps, Apps} | Config].
+
+end_per_suite(Config) ->
+    emqx_cth_suite:stop(proplists:get_value(apps, Config)).
+
+init_per_testcase(_TestCase, Config) ->
+    Config.
+
+end_per_testcase(_TestCase, Config) ->
+    Config.
+
+t_cleanup_after_retain(_) ->
+    Pid = spawn(fun() ->
+        receive
+            stop -> ok
+        end
+    end),
+    ClientId = <<"clientid">>,
+    ClientId2 = <<"clientid2">>,
+    emqx_cm_registry:register_channel({ClientId, Pid}),
+    emqx_cm_registry:register_channel({ClientId2, Pid}),
+    ?assertEqual([Pid], emqx_cm_registry:lookup_channels(ClientId)),
+    ?assertEqual([Pid], emqx_cm_registry:lookup_channels(ClientId2)),
+    ?assertEqual(2, emqx_cm_registry_keeper:count(0)),
+    T0 = erlang:system_time(seconds),
+    exit(Pid, kill),
+    %% lookup_channel chesk if the channel is still alive
+    ?assertEqual([], emqx_cm_registry:lookup_channels(ClientId)),
+    ?assertEqual([], emqx_cm_registry:lookup_channels(ClientId2)),
+    %% simulate a DOWN message which causes emqx_cm to call clean_down
+    %% to clean the channels for real
+    ok = emqx_cm:clean_down({Pid, ClientId}),
+    ok = emqx_cm:clean_down({Pid, ClientId2}),
+    ?assertEqual(2, emqx_cm_registry_keeper:count(T0)),
+    ?assertEqual(2, emqx_cm_registry_keeper:count(0)),
+    ?retry(_Interval = 1000, _Attempts = 4, begin
+        ?assertEqual(0, emqx_cm_registry_keeper:count(T0)),
+        ?assertEqual(0, emqx_cm_registry_keeper:count(0))
+    end),
+    ok.
+
+%% count is cached when the number of entries is greater than 1000
+t_count_cache(_) ->
+    Pid = self(),
+    ClientsCount = 999,
+    ClientIds = lists:map(fun erlang:integer_to_binary/1, lists:seq(1, ClientsCount)),
+    Channels = lists:map(fun(ClientId) -> {ClientId, Pid} end, ClientIds),
+    lists:foreach(
+        fun emqx_cm_registry:register_channel/1,
+        Channels
+    ),
+    T0 = erlang:system_time(seconds),
+    ?assertEqual(ClientsCount, emqx_cm_registry_keeper:count(0)),
+    ?assertEqual(ClientsCount, emqx_cm_registry_keeper:count(T0)),
+    %% insert another one to trigger the cache threshold
+    emqx_cm_registry:register_channel({<<"-1">>, Pid}),
+    ?assertEqual(ClientsCount + 1, emqx_cm_registry_keeper:count(0)),
+    ?assertEqual(ClientsCount, emqx_cm_registry_keeper:count(T0)),
+    mnesia:clear_table(?CHAN_REG_TAB),
+    ok.
+
+channel(Id, Pid) ->
+    #channel{chid = Id, pid = Pid}.

From e9c8446d57894704c371857bed3b1be3cab19380 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Tue, 30 Jan 2024 17:33:36 +0800
Subject: [PATCH 115/273] feat: upgrade erlfmt to support maybe syntax

---
 apps/emqx/include/types.hrl                   |   2 +-
 apps/emqx/rebar.config                        |   2 +-
 apps/emqx/src/emqx_broker.erl                 |   2 +-
 apps/emqx/src/emqx_broker_helper.erl          |   4 ++--
 apps/emqx/src/emqx_channel.erl                |  12 ++++++------
 apps/emqx/src/emqx_cm.erl                     |  14 +++++++-------
 apps/emqx/src/emqx_cm_locker.erl              |   2 +-
 apps/emqx/src/emqx_connection.erl             |   8 ++++----
 apps/emqx/src/emqx_gc.erl                     |   4 ++--
 apps/emqx/src/emqx_hooks.erl                  |   2 +-
 apps/emqx/src/emqx_maybe.erl                  |  12 ++++++------
 apps/emqx/src/emqx_message.erl                |   6 +++---
 apps/emqx/src/emqx_mountpoint.erl             |   8 ++++----
 apps/emqx/src/emqx_mqueue.erl                 |   2 +-
 apps/emqx/src/emqx_pd.erl                     |   2 +-
 apps/emqx/src/emqx_session.erl                |   2 +-
 apps/emqx/src/emqx_stats.erl                  |   2 +-
 apps/emqx/src/emqx_sys.erl                    |   4 ++--
 apps/emqx/src/emqx_types.erl                  |  16 ++++++++--------
 apps/emqx/src/emqx_ws_connection.erl          |   6 +++---
 apps/emqx/test/emqx_listeners_SUITE.erl       |   8 ++++----
 apps/emqx/test/emqx_proper_types.erl          |   8 ++++----
 apps/emqx_exhook/src/emqx_exhook.app.src      |   2 +-
 apps/emqx_exhook/src/emqx_exhook_handler.erl  |  16 ++++++++--------
 .../test/props/prop_exhook_hooks.erl          |  16 ++++++++--------
 apps/emqx_ft/src/emqx_ft.erl                  |   6 +++---
 apps/emqx_ft/src/emqx_ft_storage.erl          |   2 +-
 apps/emqx_ft/src/emqx_ft_storage_fs_gc.erl    |   4 ++--
 .../src/bhvrs/emqx_gateway_conn.erl           |  12 ++++++------
 .../src/emqx_exproto_channel.erl              |   6 +++---
 .../src/emqx_gateway_gbt32960.app.src         |   2 +-
 .../src/emqx_gbt32960_channel.erl             |   2 +-
 .../src/emqx_gateway_jt808.app.src            |   2 +-
 .../src/emqx_jt808_channel.erl                |   2 +-
 .../src/emqx_gateway_mqttsn.app.src           |   2 +-
 .../src/emqx_mqttsn_channel.erl               |   2 +-
 .../src/emqx_ocpp_channel.erl                 |   6 +++---
 .../src/emqx_ocpp_connection.erl              |  12 ++++++------
 apps/emqx_modules/src/emqx_delayed.erl        |   6 +++---
 .../src/emqx_resource_manager.erl             |   4 ++--
 apps/emqx_rule_engine/include/rule_engine.hrl |   2 +-
 apps/emqx_s3/src/emqx_s3.app.src              |   2 +-
 apps/emqx_s3/src/emqx_s3.erl                  |   8 ++++----
 apps/emqx_utils/src/emqx_utils.erl            |  12 ++++++------
 apps/emqx_utils/test/emqx_utils_fs_SUITE.erl  |   4 ++--
 rebar.config                                  |   2 +-
 scripts/erlfmt                                | Bin 137271 -> 827374 bytes
 47 files changed, 131 insertions(+), 131 deletions(-)

diff --git a/apps/emqx/include/types.hrl b/apps/emqx/include/types.hrl
index ec56a9300..75750138f 100644
--- a/apps/emqx/include/types.hrl
+++ b/apps/emqx/include/types.hrl
@@ -14,7 +14,7 @@
 %% limitations under the License.
 %%--------------------------------------------------------------------
 
--type maybe(T) :: undefined | T.
+-type option(T) :: undefined | T.
 
 -type startlink_ret() :: {ok, pid()} | ignore | {error, term()}.
 
diff --git a/apps/emqx/rebar.config b/apps/emqx/rebar.config
index a9b441bc5..3626d0858 100644
--- a/apps/emqx/rebar.config
+++ b/apps/emqx/rebar.config
@@ -71,7 +71,7 @@
     {statistics, true}
 ]}.
 
-{project_plugins, [erlfmt]}.
+{project_plugins, [{erlfmt, "1.3.0"}]}.
 
 {erlfmt, [
     {files, [
diff --git a/apps/emqx/src/emqx_broker.erl b/apps/emqx/src/emqx_broker.erl
index b4fdd0e86..c8ca20812 100644
--- a/apps/emqx/src/emqx_broker.erl
+++ b/apps/emqx/src/emqx_broker.erl
@@ -440,7 +440,7 @@ subscribed(SubId, Topic) when ?IS_SUBID(SubId) ->
     SubPid = emqx_broker_helper:lookup_subpid(SubId),
     ets:member(?SUBOPTION, {Topic, SubPid}).
 
--spec get_subopts(pid(), emqx_types:topic() | emqx_types:share()) -> maybe(emqx_types:subopts()).
+-spec get_subopts(pid(), emqx_types:topic() | emqx_types:share()) -> option(emqx_types:subopts()).
 get_subopts(SubPid, Topic) when is_pid(SubPid), ?IS_TOPIC(Topic) ->
     lookup_value(?SUBOPTION, {Topic, SubPid});
 get_subopts(SubId, Topic) when ?IS_SUBID(SubId) ->
diff --git a/apps/emqx/src/emqx_broker_helper.erl b/apps/emqx/src/emqx_broker_helper.erl
index ea615c2f7..ef238b61a 100644
--- a/apps/emqx/src/emqx_broker_helper.erl
+++ b/apps/emqx/src/emqx_broker_helper.erl
@@ -71,11 +71,11 @@ register_sub(SubPid, SubId) when is_pid(SubPid) ->
             error(subid_conflict)
     end.
 
--spec lookup_subid(pid()) -> maybe(emqx_types:subid()).
+-spec lookup_subid(pid()) -> option(emqx_types:subid()).
 lookup_subid(SubPid) when is_pid(SubPid) ->
     emqx_utils_ets:lookup_value(?SUBMON, SubPid).
 
--spec lookup_subpid(emqx_types:subid()) -> maybe(pid()).
+-spec lookup_subpid(emqx_types:subid()) -> option(pid()).
 lookup_subpid(SubId) ->
     emqx_utils_ets:lookup_value(?SUBID, SubId).
 
diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 86c3b840c..c2e0f3396 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -84,21 +84,21 @@
     %% MQTT ClientInfo
     clientinfo :: emqx_types:clientinfo(),
     %% MQTT Session
-    session :: maybe(emqx_session:t()),
+    session :: option(emqx_session:t()),
     %% Keepalive
-    keepalive :: maybe(emqx_keepalive:keepalive()),
+    keepalive :: option(emqx_keepalive:keepalive()),
     %% MQTT Will Msg
-    will_msg :: maybe(emqx_types:message()),
+    will_msg :: option(emqx_types:message()),
     %% MQTT Topic Aliases
     topic_aliases :: emqx_types:topic_aliases(),
     %% MQTT Topic Alias Maximum
-    alias_maximum :: maybe(map()),
+    alias_maximum :: option(map()),
     %% Authentication Data Cache
-    auth_cache :: maybe(map()),
+    auth_cache :: option(map()),
     %% Quota checkers
     quota :: emqx_limiter_container:container(),
     %% Timers
-    timers :: #{atom() => disabled | maybe(reference())},
+    timers :: #{atom() => disabled | option(reference())},
     %% Conn State
     conn_state :: conn_state(),
     %% Takeover
diff --git a/apps/emqx/src/emqx_cm.erl b/apps/emqx/src/emqx_cm.erl
index 10cd3d6cc..d9d5aa941 100644
--- a/apps/emqx/src/emqx_cm.erl
+++ b/apps/emqx/src/emqx_cm.erl
@@ -200,12 +200,12 @@ do_unregister_channel({_ClientId, ChanPid} = Chan) ->
     true.
 
 %% @doc Get info of a channel.
--spec get_chan_info(emqx_types:clientid()) -> maybe(emqx_types:infos()).
+-spec get_chan_info(emqx_types:clientid()) -> option(emqx_types:infos()).
 get_chan_info(ClientId) ->
     with_channel(ClientId, fun(ChanPid) -> get_chan_info(ClientId, ChanPid) end).
 
 -spec do_get_chan_info(emqx_types:clientid(), chan_pid()) ->
-    maybe(emqx_types:infos()).
+    option(emqx_types:infos()).
 do_get_chan_info(ClientId, ChanPid) ->
     Chan = {ClientId, ChanPid},
     try
@@ -215,7 +215,7 @@ do_get_chan_info(ClientId, ChanPid) ->
     end.
 
 -spec get_chan_info(emqx_types:clientid(), chan_pid()) ->
-    maybe(emqx_types:infos()).
+    option(emqx_types:infos()).
 get_chan_info(ClientId, ChanPid) ->
     wrap_rpc(emqx_cm_proto_v2:get_chan_info(ClientId, ChanPid)).
 
@@ -230,12 +230,12 @@ set_chan_info(ClientId, Info) when ?IS_CLIENTID(ClientId) ->
     end.
 
 %% @doc Get channel's stats.
--spec get_chan_stats(emqx_types:clientid()) -> maybe(emqx_types:stats()).
+-spec get_chan_stats(emqx_types:clientid()) -> option(emqx_types:stats()).
 get_chan_stats(ClientId) ->
     with_channel(ClientId, fun(ChanPid) -> get_chan_stats(ClientId, ChanPid) end).
 
 -spec do_get_chan_stats(emqx_types:clientid(), chan_pid()) ->
-    maybe(emqx_types:stats()).
+    option(emqx_types:stats()).
 do_get_chan_stats(ClientId, ChanPid) ->
     Chan = {ClientId, ChanPid},
     try
@@ -245,7 +245,7 @@ do_get_chan_stats(ClientId, ChanPid) ->
     end.
 
 -spec get_chan_stats(emqx_types:clientid(), chan_pid()) ->
-    maybe(emqx_types:stats()).
+    option(emqx_types:stats()).
 get_chan_stats(ClientId, ChanPid) ->
     wrap_rpc(emqx_cm_proto_v2:get_chan_stats(ClientId, ChanPid)).
 
@@ -325,7 +325,7 @@ takeover_session_end({ConnMod, ChanPid}) ->
     end.
 
 -spec pick_channel(emqx_types:clientid()) ->
-    maybe(pid()).
+    option(pid()).
 pick_channel(ClientId) ->
     case lookup_channels(ClientId) of
         [] ->
diff --git a/apps/emqx/src/emqx_cm_locker.erl b/apps/emqx/src/emqx_cm_locker.erl
index f56f9239a..c767901ed 100644
--- a/apps/emqx/src/emqx_cm_locker.erl
+++ b/apps/emqx/src/emqx_cm_locker.erl
@@ -32,7 +32,7 @@ start_link() ->
     ekka_locker:start_link(?MODULE).
 
 -spec trans(
-    maybe(emqx_types:clientid()),
+    option(emqx_types:clientid()),
     fun(([node()]) -> any())
 ) -> any().
 trans(undefined, Fun) ->
diff --git a/apps/emqx/src/emqx_connection.erl b/apps/emqx/src/emqx_connection.erl
index d306464c1..96e4f54c7 100644
--- a/apps/emqx/src/emqx_connection.erl
+++ b/apps/emqx/src/emqx_connection.erl
@@ -99,13 +99,13 @@
     %% Channel State
     channel :: emqx_channel:channel(),
     %% GC State
-    gc_state :: maybe(emqx_gc:gc_state()),
+    gc_state :: option(emqx_gc:gc_state()),
     %% Stats Timer
-    stats_timer :: disabled | maybe(reference()),
+    stats_timer :: disabled | option(reference()),
     %% Idle Timeout
     idle_timeout :: integer() | infinity,
     %% Idle Timer
-    idle_timer :: maybe(reference()),
+    idle_timer :: option(reference()),
     %% Zone name
     zone :: atom(),
     %% Listener Type and Name
@@ -121,7 +121,7 @@
     limiter_timer :: undefined | reference(),
 
     %% QUIC conn owner pid if in use.
-    quic_conn_pid :: maybe(pid())
+    quic_conn_pid :: option(pid())
 }).
 
 -record(retry, {
diff --git a/apps/emqx/src/emqx_gc.erl b/apps/emqx/src/emqx_gc.erl
index 61087ba29..525a9bea8 100644
--- a/apps/emqx/src/emqx_gc.erl
+++ b/apps/emqx/src/emqx_gc.erl
@@ -86,11 +86,11 @@ do_run([{K, N} | T], St) ->
     end.
 
 %% @doc Info of GC state.
--spec info(maybe(gc_state())) -> maybe(map()).
+-spec info(option(gc_state())) -> option(map()).
 info(?GCS(St)) -> St.
 
 %% @doc Reset counters to zero.
--spec reset(maybe(gc_state())) -> gc_state().
+-spec reset(option(gc_state())) -> gc_state().
 reset(?GCS(St)) ->
     ?GCS(do_reset(St)).
 
diff --git a/apps/emqx/src/emqx_hooks.erl b/apps/emqx/src/emqx_hooks.erl
index efe2c0de8..57e772ddc 100644
--- a/apps/emqx/src/emqx_hooks.erl
+++ b/apps/emqx/src/emqx_hooks.erl
@@ -76,7 +76,7 @@
 
 -record(callback, {
     action :: action(),
-    filter :: maybe(filter()),
+    filter :: option(filter()),
     priority :: integer()
 }).
 
diff --git a/apps/emqx/src/emqx_maybe.erl b/apps/emqx/src/emqx_maybe.erl
index af2fd04a7..522cd5e98 100644
--- a/apps/emqx/src/emqx_maybe.erl
+++ b/apps/emqx/src/emqx_maybe.erl
@@ -23,30 +23,30 @@
 -export([define/2]).
 -export([apply/2]).
 
--type t(T) :: maybe(T).
+-type t(T) :: option(T).
 -export_type([t/1]).
 
--spec to_list(maybe(A)) -> [A].
+-spec to_list(option(A)) -> [A].
 to_list(undefined) ->
     [];
 to_list(Term) ->
     [Term].
 
--spec from_list([A]) -> maybe(A).
+-spec from_list([A]) -> option(A).
 from_list([]) ->
     undefined;
 from_list([Term]) ->
     Term.
 
--spec define(maybe(A), B) -> A | B.
+-spec define(option(A), B) -> A | B.
 define(undefined, Term) ->
     Term;
 define(Term, _) ->
     Term.
 
 %% @doc Apply a function to a maybe argument.
--spec apply(fun((A) -> B), maybe(A)) ->
-    maybe(B).
+-spec apply(fun((A) -> B), option(A)) ->
+    option(B).
 apply(_Fun, undefined) ->
     undefined;
 apply(Fun, Term) when is_function(Fun) ->
diff --git a/apps/emqx/src/emqx_message.erl b/apps/emqx/src/emqx_message.erl
index 0628908d1..b183aa029 100644
--- a/apps/emqx/src/emqx_message.erl
+++ b/apps/emqx/src/emqx_message.erl
@@ -186,7 +186,7 @@ estimate_size(#message{topic = Topic, payload = Payload}) ->
     TopicLengthSize = 2,
     FixedHeaderSize + VarLenSize + TopicLengthSize + TopicSize + PacketIdSize + PayloadSize.
 
--spec id(emqx_types:message()) -> maybe(binary()).
+-spec id(emqx_types:message()) -> option(binary()).
 id(#message{id = Id}) -> Id.
 
 -spec qos(emqx_types:message()) -> emqx_types:qos().
@@ -229,7 +229,7 @@ get_flag(Flag, Msg) ->
 get_flag(Flag, #message{flags = Flags}, Default) ->
     maps:get(Flag, Flags, Default).
 
--spec get_flags(emqx_types:message()) -> maybe(map()).
+-spec get_flags(emqx_types:message()) -> option(map()).
 get_flags(#message{flags = Flags}) -> Flags.
 
 -spec set_flag(emqx_types:flag(), emqx_types:message()) -> emqx_types:message().
@@ -252,7 +252,7 @@ unset_flag(Flag, Msg = #message{flags = Flags}) ->
 set_headers(New, Msg = #message{headers = Old}) when is_map(New) ->
     Msg#message{headers = maps:merge(Old, New)}.
 
--spec get_headers(emqx_types:message()) -> maybe(map()).
+-spec get_headers(emqx_types:message()) -> option(map()).
 get_headers(Msg) -> Msg#message.headers.
 
 -spec get_header(term(), emqx_types:message()) -> term().
diff --git a/apps/emqx/src/emqx_mountpoint.erl b/apps/emqx/src/emqx_mountpoint.erl
index c19736690..8da27aad2 100644
--- a/apps/emqx/src/emqx_mountpoint.erl
+++ b/apps/emqx/src/emqx_mountpoint.erl
@@ -32,7 +32,7 @@
 
 -type mountpoint() :: binary().
 
--spec mount(maybe(mountpoint()), Any) -> Any when
+-spec mount(option(mountpoint()), Any) -> Any when
     Any ::
         emqx_types:topic()
         | emqx_types:share()
@@ -47,7 +47,7 @@ mount(MountPoint, Msg = #message{topic = Topic}) when is_binary(Topic) ->
 mount(MountPoint, TopicFilters) when is_list(TopicFilters) ->
     [{prefix_maybe_share(MountPoint, Topic), SubOpts} || {Topic, SubOpts} <- TopicFilters].
 
--spec prefix_maybe_share(maybe(mountpoint()), Any) -> Any when
+-spec prefix_maybe_share(option(mountpoint()), Any) -> Any when
     Any ::
         emqx_types:topic()
         | emqx_types:share().
@@ -60,7 +60,7 @@ prefix_maybe_share(MountPoint, #share{group = Group, topic = Topic}) when
 ->
     #share{group = Group, topic = prefix_maybe_share(MountPoint, Topic)}.
 
--spec unmount(maybe(mountpoint()), Any) -> Any when
+-spec unmount(option(mountpoint()), Any) -> Any when
     Any ::
         emqx_types:topic()
         | emqx_types:share()
@@ -84,7 +84,7 @@ unmount_maybe_share(MountPoint, TopicFilter = #share{topic = Topic}) when
 ->
     TopicFilter#share{topic = unmount_maybe_share(MountPoint, Topic)}.
 
--spec replvar(maybe(mountpoint()), map()) -> maybe(mountpoint()).
+-spec replvar(option(mountpoint()), map()) -> option(mountpoint()).
 replvar(undefined, _Vars) ->
     undefined;
 replvar(MountPoint, Vars) ->
diff --git a/apps/emqx/src/emqx_mqueue.erl b/apps/emqx/src/emqx_mqueue.erl
index 0ef7d56e5..7b30e5006 100644
--- a/apps/emqx/src/emqx_mqueue.erl
+++ b/apps/emqx/src/emqx_mqueue.erl
@@ -189,7 +189,7 @@ stats(#mqueue{max_len = MaxLen, dropped = Dropped} = MQ) ->
     [{len, len(MQ)}, {max_len, MaxLen}, {dropped, Dropped}].
 
 %% @doc Enqueue a message.
--spec in(message(), mqueue()) -> {maybe(message()), mqueue()}.
+-spec in(message(), mqueue()) -> {option(message()), mqueue()}.
 in(Msg = #message{qos = ?QOS_0}, MQ = #mqueue{store_qos0 = false}) ->
     {_Dropped = Msg, MQ};
 in(
diff --git a/apps/emqx/src/emqx_pd.erl b/apps/emqx/src/emqx_pd.erl
index 73e75a771..602c23065 100644
--- a/apps/emqx/src/emqx_pd.erl
+++ b/apps/emqx/src/emqx_pd.erl
@@ -48,7 +48,7 @@ get_counter(Key) ->
         Cnt -> Cnt
     end.
 
--spec inc_counter(key(), number()) -> maybe(number()).
+-spec inc_counter(key(), number()) -> option(number()).
 inc_counter(Key, Inc) ->
     put(Key, get_counter(Key) + Inc).
 
diff --git a/apps/emqx/src/emqx_session.erl b/apps/emqx/src/emqx_session.erl
index fa7441b11..a84ed4d83 100644
--- a/apps/emqx/src/emqx_session.erl
+++ b/apps/emqx/src/emqx_session.erl
@@ -135,7 +135,7 @@
 -type custom_timer_name() :: atom().
 
 -type message() :: emqx_types:message().
--type publish() :: {maybe(emqx_types:packet_id()), emqx_types:message()}.
+-type publish() :: {option(emqx_types:packet_id()), emqx_types:message()}.
 -type pubrel() :: {pubrel, emqx_types:packet_id()}.
 -type reply() :: publish() | pubrel().
 -type replies() :: [reply()] | reply().
diff --git a/apps/emqx/src/emqx_stats.erl b/apps/emqx/src/emqx_stats.erl
index 9685823ff..4954d0a45 100644
--- a/apps/emqx/src/emqx_stats.erl
+++ b/apps/emqx/src/emqx_stats.erl
@@ -62,7 +62,7 @@
 -record(update, {name, countdown, interval, func}).
 
 -record(state, {
-    timer :: maybe(reference()),
+    timer :: option(reference()),
     updates :: [#update{}],
     tick_ms :: timeout()
 }).
diff --git a/apps/emqx/src/emqx_sys.erl b/apps/emqx/src/emqx_sys.erl
index 509429796..e7c19cabd 100644
--- a/apps/emqx/src/emqx_sys.erl
+++ b/apps/emqx/src/emqx_sys.erl
@@ -65,8 +65,8 @@
 -import(emqx_utils, [start_timer/2]).
 
 -record(state, {
-    heartbeat :: maybe(reference()),
-    ticker :: maybe(reference()),
+    heartbeat :: option(reference()),
+    ticker :: option(reference()),
     sysdescr :: binary()
 }).
 
diff --git a/apps/emqx/src/emqx_types.erl b/apps/emqx/src/emqx_types.erl
index 436fffe4e..087bcaebe 100644
--- a/apps/emqx/src/emqx_types.erl
+++ b/apps/emqx/src/emqx_types.erl
@@ -173,7 +173,7 @@
     atom() => term()
 }.
 -type clientinfo() :: #{
-    zone := maybe(zone()),
+    zone := option(zone()),
     protocol := protocol(),
     peerhost := peerhost(),
     sockport := non_neg_integer(),
@@ -181,9 +181,9 @@
     username := username(),
     is_bridge := boolean(),
     is_superuser := boolean(),
-    mountpoint := maybe(binary()),
-    ws_cookie => maybe(list()),
-    password => maybe(binary()),
+    mountpoint := option(binary()),
+    ws_cookie => option(list()),
+    password => option(binary()),
     auth_result => auth_result(),
     anonymous => boolean(),
     cn => binary(),
@@ -191,8 +191,8 @@
     atom() => term()
 }.
 -type clientid() :: binary() | atom().
--type username() :: maybe(binary()).
--type password() :: maybe(binary()).
+-type username() :: option(binary()).
+-type password() :: option(binary()).
 -type peerhost() :: inet:ip_address().
 -type peername() ::
     {inet:ip_address(), inet:port_number()}
@@ -222,8 +222,8 @@
 -type packet_id() :: 1..16#FFFF.
 -type alias_id() :: 0..16#FFFF.
 -type topic_aliases() :: #{
-    inbound => maybe(map()),
-    outbound => maybe(map())
+    inbound => option(map()),
+    outbound => option(map())
 }.
 -type properties() :: #{atom() => term()}.
 -type topic_filters() :: list({topic(), subopts()}).
diff --git a/apps/emqx/src/emqx_ws_connection.erl b/apps/emqx/src/emqx_ws_connection.erl
index 1511eb6e0..59e120e47 100644
--- a/apps/emqx/src/emqx_ws_connection.erl
+++ b/apps/emqx/src/emqx_ws_connection.erl
@@ -76,15 +76,15 @@
     %% Channel
     channel :: emqx_channel:channel(),
     %% GC State
-    gc_state :: maybe(emqx_gc:gc_state()),
+    gc_state :: option(emqx_gc:gc_state()),
     %% Postponed Packets|Cmds|Events
     postponed :: list(emqx_types:packet() | ws_cmd() | tuple()),
     %% Stats Timer
-    stats_timer :: disabled | maybe(reference()),
+    stats_timer :: disabled | option(reference()),
     %% Idle Timeout
     idle_timeout :: timeout(),
     %% Idle Timer
-    idle_timer :: maybe(reference()),
+    idle_timer :: option(reference()),
     %% Zone name
     zone :: atom(),
     %% Listener Type and Name
diff --git a/apps/emqx/test/emqx_listeners_SUITE.erl b/apps/emqx/test/emqx_listeners_SUITE.erl
index 2d2a13e31..e934e6903 100644
--- a/apps/emqx/test/emqx_listeners_SUITE.erl
+++ b/apps/emqx/test/emqx_listeners_SUITE.erl
@@ -405,9 +405,9 @@ t_quic_update_opts(Config) ->
         %% Unable to connect with old SSL options, server's cert is signed by another CA.
         ?assertError(
             {transport_down, #{error := _, status := Status}} when
-                (Status =:= bad_certificate orelse
+                ((Status =:= bad_certificate orelse
                     Status =:= cert_untrusted_root orelse
-                    Status =:= handshake_failure),
+                    Status =:= handshake_failure)),
             ConnectFun(Host, Port, [
                 {cacertfile, filename:join(PrivDir, "ca.pem")} | ClientSSLOpts
             ])
@@ -553,9 +553,9 @@ t_quic_update_opts_fail(Config) ->
         %% Unable to connect with old SSL options, server's cert is signed by another CA.
         ?assertError(
             {transport_down, #{error := _, status := Status}} when
-                (Status =:= bad_certificate orelse
+                ((Status =:= bad_certificate orelse
                     Status =:= cert_untrusted_root orelse
-                    Status =:= handshake_failure),
+                    Status =:= handshake_failure)),
             ConnectFun(Host, Port, [
                 {cacertfile, filename:join(PrivDir, "ca.pem")} | ClientSSLOpts
             ])
diff --git a/apps/emqx/test/emqx_proper_types.erl b/apps/emqx/test/emqx_proper_types.erl
index 243a39007..d1b4b7554 100644
--- a/apps/emqx/test/emqx_proper_types.erl
+++ b/apps/emqx/test/emqx_proper_types.erl
@@ -114,8 +114,8 @@ clientinfo() ->
         {username, username()},
         {is_bridge, boolean()},
         {is_supuser, boolean()},
-        {mountpoint, maybe(utf8())},
-        {ws_cookie, maybe(list())}
+        {mountpoint, option(utf8())},
+        {ws_cookie, option(list())}
         % password,
         % auth_result,
         % anonymous,
@@ -496,7 +496,7 @@ pubsub() ->
 %% Basic Types
 %%--------------------------------------------------------------------
 
-maybe(T) ->
+option(T) ->
     oneof([undefined, T]).
 
 socktype() ->
@@ -522,7 +522,7 @@ clientid() ->
     utf8().
 
 username() ->
-    maybe(utf8()).
+    option(utf8()).
 
 properties() ->
     map(limited_latin_atom(), binary()).
diff --git a/apps/emqx_exhook/src/emqx_exhook.app.src b/apps/emqx_exhook/src/emqx_exhook.app.src
index 79c34e36b..826f0ba46 100644
--- a/apps/emqx_exhook/src/emqx_exhook.app.src
+++ b/apps/emqx_exhook/src/emqx_exhook.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_exhook, [
     {description, "EMQX Extension for Hook"},
-    {vsn, "5.0.15"},
+    {vsn, "5.0.16"},
     {modules, []},
     {registered, []},
     {mod, {emqx_exhook_app, []}},
diff --git a/apps/emqx_exhook/src/emqx_exhook_handler.erl b/apps/emqx_exhook/src/emqx_exhook_handler.erl
index 5c1d18c17..0519d5f22 100644
--- a/apps/emqx_exhook/src/emqx_exhook_handler.erl
+++ b/apps/emqx_exhook/src/emqx_exhook_handler.erl
@@ -306,7 +306,7 @@ conninfo(
     #{
         node => stringfy(node()),
         clientid => ClientId,
-        username => maybe(Username),
+        username => option(Username),
         peerhost => ntoa(Peerhost),
         peerport => PeerPort,
         sockport => SockPort,
@@ -330,17 +330,17 @@ clientinfo(
     #{
         node => stringfy(node()),
         clientid => ClientId,
-        username => maybe(Username),
-        password => maybe(maps:get(password, ClientInfo, undefined)),
+        username => option(Username),
+        password => option(maps:get(password, ClientInfo, undefined)),
         peerhost => ntoa(PeerHost),
         peerport => PeerPort,
         sockport => SockPort,
         protocol => stringfy(Protocol),
-        mountpoint => maybe(Mountpoiont),
+        mountpoint => option(Mountpoiont),
         is_superuser => maps:get(is_superuser, ClientInfo, false),
         anonymous => maps:get(anonymous, ClientInfo, true),
-        cn => maybe(maps:get(cn, ClientInfo, undefined)),
-        dn => maybe(maps:get(dn, ClientInfo, undefined))
+        cn => option(maps:get(cn, ClientInfo, undefined)),
+        dn => option(maps:get(dn, ClientInfo, undefined))
     }.
 
 message(#message{
@@ -435,8 +435,8 @@ ntoa({0, 0, 0, 0, 0, 16#ffff, AB, CD}) ->
 ntoa(IP) ->
     list_to_binary(inet_parse:ntoa(IP)).
 
-maybe(undefined) -> <<>>;
-maybe(B) -> B.
+option(undefined) -> <<>>;
+option(B) -> B.
 
 %% @private
 stringfy(Term) when is_binary(Term) ->
diff --git a/apps/emqx_exhook/test/props/prop_exhook_hooks.erl b/apps/emqx_exhook/test/props/prop_exhook_hooks.erl
index 041091e27..defdcf901 100644
--- a/apps/emqx_exhook/test/props/prop_exhook_hooks.erl
+++ b/apps/emqx_exhook/test/props/prop_exhook_hooks.erl
@@ -509,8 +509,8 @@ ntoa({0, 0, 0, 0, 0, 16#ffff, AB, CD}) ->
 ntoa(IP) ->
     list_to_binary(inet_parse:ntoa(IP)).
 
-maybe(undefined) -> <<>>;
-maybe(B) -> B.
+option(undefined) -> <<>>;
+option(B) -> B.
 
 properties(undefined) ->
     [];
@@ -568,7 +568,7 @@ from_conninfo(ConnInfo) ->
     #{
         node => nodestr(),
         clientid => maps:get(clientid, ConnInfo),
-        username => maybe(maps:get(username, ConnInfo, <<>>)),
+        username => option(maps:get(username, ConnInfo, <<>>)),
         peerhost => peerhost(ConnInfo),
         peerport => peerport(ConnInfo),
         sockport => sockport(ConnInfo),
@@ -581,17 +581,17 @@ from_clientinfo(ClientInfo) ->
     #{
         node => nodestr(),
         clientid => maps:get(clientid, ClientInfo),
-        username => maybe(maps:get(username, ClientInfo, <<>>)),
-        password => maybe(maps:get(password, ClientInfo, <<>>)),
+        username => option(maps:get(username, ClientInfo, <<>>)),
+        password => option(maps:get(password, ClientInfo, <<>>)),
         peerhost => ntoa(maps:get(peerhost, ClientInfo)),
         peerport => maps:get(peerport, ClientInfo),
         sockport => maps:get(sockport, ClientInfo),
         protocol => stringfy(maps:get(protocol, ClientInfo)),
-        mountpoint => maybe(maps:get(mountpoint, ClientInfo, <<>>)),
+        mountpoint => option(maps:get(mountpoint, ClientInfo, <<>>)),
         is_superuser => maps:get(is_superuser, ClientInfo, false),
         anonymous => maps:get(anonymous, ClientInfo, true),
-        cn => maybe(maps:get(cn, ClientInfo, <<>>)),
-        dn => maybe(maps:get(dn, ClientInfo, <<>>))
+        cn => option(maps:get(cn, ClientInfo, <<>>)),
+        dn => option(maps:get(dn, ClientInfo, <<>>))
     }.
 
 from_message(Msg) ->
diff --git a/apps/emqx_ft/src/emqx_ft.erl b/apps/emqx_ft/src/emqx_ft.erl
index c886b86bd..7eef357b3 100644
--- a/apps/emqx_ft/src/emqx_ft.erl
+++ b/apps/emqx_ft/src/emqx_ft.erl
@@ -218,7 +218,7 @@ do_on_file_command(TopicReplyData, FileId, Msg, FileCommand) ->
         [<<"fin">>, FinalSizeBin | MaybeChecksum] when length(MaybeChecksum) =< 1 ->
             ChecksumBin = emqx_maybe:from_list(MaybeChecksum),
             validate(
-                [{size, FinalSizeBin}, {{maybe, checksum}, ChecksumBin}],
+                [{size, FinalSizeBin}, {{option, checksum}, ChecksumBin}],
                 fun([FinalSize, FinalChecksum]) ->
                     on_fin(TopicReplyData, Msg, Transfer, FinalSize, FinalChecksum)
                 end
@@ -464,9 +464,9 @@ do_validate([{integrity, Payload, {Algo, Checksum}} | Rest], Parsed) ->
         Mismatch ->
             {error, {checksum_mismatch, binary:encode_hex(Mismatch)}}
     end;
-do_validate([{{maybe, _}, undefined} | Rest], Parsed) ->
+do_validate([{{option, _}, undefined} | Rest], Parsed) ->
     do_validate(Rest, [undefined | Parsed]);
-do_validate([{{maybe, T}, Value} | Rest], Parsed) ->
+do_validate([{{option, T}, Value} | Rest], Parsed) ->
     do_validate([{T, Value} | Rest], Parsed).
 
 parse_checksum(Checksum) when is_binary(Checksum) andalso byte_size(Checksum) =:= 64 ->
diff --git a/apps/emqx_ft/src/emqx_ft_storage.erl b/apps/emqx_ft/src/emqx_ft_storage.erl
index 506cf9789..b8d4952ee 100644
--- a/apps/emqx_ft/src/emqx_ft_storage.erl
+++ b/apps/emqx_ft/src/emqx_ft_storage.erl
@@ -100,7 +100,7 @@
 -callback start(storage()) -> any().
 -callback stop(storage()) -> any().
 
--callback update_config(_OldConfig :: maybe(storage()), _NewConfig :: maybe(storage())) ->
+-callback update_config(_OldConfig :: option(storage()), _NewConfig :: option(storage())) ->
     any().
 
 %%--------------------------------------------------------------------
diff --git a/apps/emqx_ft/src/emqx_ft_storage_fs_gc.erl b/apps/emqx_ft/src/emqx_ft_storage_fs_gc.erl
index 4e9a6d56c..9be7779f8 100644
--- a/apps/emqx_ft/src/emqx_ft_storage_fs_gc.erl
+++ b/apps/emqx_ft/src/emqx_ft_storage_fs_gc.erl
@@ -41,8 +41,8 @@
 -export([handle_info/2]).
 
 -record(st, {
-    next_gc_timer :: maybe(reference()),
-    last_gc :: maybe(gcstats())
+    next_gc_timer :: option(reference()),
+    last_gc :: option(gcstats())
 }).
 
 -type gcstats() :: #gcstats{}.
diff --git a/apps/emqx_gateway/src/bhvrs/emqx_gateway_conn.erl b/apps/emqx_gateway/src/bhvrs/emqx_gateway_conn.erl
index d61d086b4..5e85444a1 100644
--- a/apps/emqx_gateway/src/bhvrs/emqx_gateway_conn.erl
+++ b/apps/emqx_gateway/src/bhvrs/emqx_gateway_conn.erl
@@ -67,9 +67,9 @@
     %% The {active, N} option
     active_n :: pos_integer(),
     %% Limiter
-    limiter :: maybe(emqx_htb_limiter:limiter()),
+    limiter :: option(emqx_htb_limiter:limiter()),
     %% Limit Timer
-    limit_timer :: maybe(reference()),
+    limit_timer :: option(reference()),
     %% Parse State
     parse_state :: emqx_gateway_frame:parse_state(),
     %% Serialize options
@@ -77,15 +77,15 @@
     %% Channel State
     channel :: emqx_gateway_channel:channel(),
     %% GC State
-    gc_state :: maybe(emqx_gc:gc_state()),
+    gc_state :: option(emqx_gc:gc_state()),
     %% Stats Timer
-    stats_timer :: disabled | maybe(reference()),
+    stats_timer :: disabled | option(reference()),
     %% Idle Timeout
     idle_timeout :: integer(),
     %% Idle Timer
-    idle_timer :: maybe(reference()),
+    idle_timer :: option(reference()),
     %% OOM Policy
-    oom_policy :: maybe(emqx_types:oom_policy()),
+    oom_policy :: option(emqx_types:oom_policy()),
     %% Frame Module
     frame_mod :: atom(),
     %% Channel Module
diff --git a/apps/emqx_gateway_exproto/src/emqx_exproto_channel.erl b/apps/emqx_gateway_exproto/src/emqx_exproto_channel.erl
index 1b3d057a8..718f97982 100644
--- a/apps/emqx_gateway_exproto/src/emqx_exproto_channel.erl
+++ b/apps/emqx_gateway_exproto/src/emqx_exproto_channel.erl
@@ -50,15 +50,15 @@
     %% Conn info
     conninfo :: emqx_types:conninfo(),
     %% Client info from `register` function
-    clientinfo :: maybe(map()),
+    clientinfo :: option(map()),
     %% Connection state
     conn_state :: conn_state(),
     %% Subscription
     subscriptions = #{},
     %% Keepalive
-    keepalive :: maybe(emqx_keepalive:keepalive()),
+    keepalive :: option(emqx_keepalive:keepalive()),
     %% Timers
-    timers :: #{atom() => disabled | maybe(reference())},
+    timers :: #{atom() => disabled | option(reference())},
     %% Closed reason
     closed_reason = undefined
 }).
diff --git a/apps/emqx_gateway_gbt32960/src/emqx_gateway_gbt32960.app.src b/apps/emqx_gateway_gbt32960/src/emqx_gateway_gbt32960.app.src
index 0ed2dca39..155e4dc25 100644
--- a/apps/emqx_gateway_gbt32960/src/emqx_gateway_gbt32960.app.src
+++ b/apps/emqx_gateway_gbt32960/src/emqx_gateway_gbt32960.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_gateway_gbt32960, [
     {description, "GBT32960 Gateway"},
-    {vsn, "0.1.0"},
+    {vsn, "0.1.1"},
     {registered, []},
     {applications, [kernel, stdlib, emqx, emqx_gateway]},
     {env, []},
diff --git a/apps/emqx_gateway_gbt32960/src/emqx_gbt32960_channel.erl b/apps/emqx_gateway_gbt32960/src/emqx_gbt32960_channel.erl
index 3f71f5a3a..155a2e2f6 100644
--- a/apps/emqx_gateway_gbt32960/src/emqx_gbt32960_channel.erl
+++ b/apps/emqx_gateway_gbt32960/src/emqx_gbt32960_channel.erl
@@ -42,7 +42,7 @@
     %% Session
     session :: undefined | map(),
     %% Keepalive
-    keepalive :: maybe(emqx_keepalive:keepalive()),
+    keepalive :: option(emqx_keepalive:keepalive()),
     %% Conn State
     conn_state :: conn_state(),
     %% Timers
diff --git a/apps/emqx_gateway_jt808/src/emqx_gateway_jt808.app.src b/apps/emqx_gateway_jt808/src/emqx_gateway_jt808.app.src
index 3d64366ff..0409f1ed2 100644
--- a/apps/emqx_gateway_jt808/src/emqx_gateway_jt808.app.src
+++ b/apps/emqx_gateway_jt808/src/emqx_gateway_jt808.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_gateway_jt808, [
     {description, "JT/T 808 Gateway"},
-    {vsn, "0.0.1"},
+    {vsn, "0.0.2"},
     {registered, []},
     {applications, [kernel, stdlib, emqx, emqx_gateway]},
     {env, []},
diff --git a/apps/emqx_gateway_jt808/src/emqx_jt808_channel.erl b/apps/emqx_gateway_jt808/src/emqx_jt808_channel.erl
index 12776a261..74882c645 100644
--- a/apps/emqx_gateway_jt808/src/emqx_jt808_channel.erl
+++ b/apps/emqx_gateway_jt808/src/emqx_jt808_channel.erl
@@ -48,7 +48,7 @@
     %% AuthCode
     authcode :: undefined | anonymous | binary(),
     %% Keepalive
-    keepalive :: maybe(emqx_keepalive:keepalive()),
+    keepalive :: option(emqx_keepalive:keepalive()),
     %% Msg SN
     msg_sn,
     %% Down Topic
diff --git a/apps/emqx_gateway_mqttsn/src/emqx_gateway_mqttsn.app.src b/apps/emqx_gateway_mqttsn/src/emqx_gateway_mqttsn.app.src
index 246566df1..2d4d144f4 100644
--- a/apps/emqx_gateway_mqttsn/src/emqx_gateway_mqttsn.app.src
+++ b/apps/emqx_gateway_mqttsn/src/emqx_gateway_mqttsn.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_gateway_mqttsn, [
     {description, "MQTT-SN Gateway"},
-    {vsn, "0.1.7"},
+    {vsn, "0.1.8"},
     {registered, []},
     {applications, [kernel, stdlib, emqx, emqx_gateway]},
     {env, []},
diff --git a/apps/emqx_gateway_mqttsn/src/emqx_mqttsn_channel.erl b/apps/emqx_gateway_mqttsn/src/emqx_mqttsn_channel.erl
index d37979ced..1c0cbfb6f 100644
--- a/apps/emqx_gateway_mqttsn/src/emqx_mqttsn_channel.erl
+++ b/apps/emqx_gateway_mqttsn/src/emqx_mqttsn_channel.erl
@@ -71,7 +71,7 @@
     %% Connection State
     conn_state :: conn_state(),
     %% Inflight register message queue
-    register_inflight :: maybe(term()),
+    register_inflight :: option(term()),
     %% Topics list for awaiting to register to client
     register_awaiting_queue :: list(),
     %% Duration for asleep
diff --git a/apps/emqx_gateway_ocpp/src/emqx_ocpp_channel.erl b/apps/emqx_gateway_ocpp/src/emqx_ocpp_channel.erl
index 3f5fe8f70..0ccc4c5e9 100644
--- a/apps/emqx_gateway_ocpp/src/emqx_ocpp_channel.erl
+++ b/apps/emqx_gateway_ocpp/src/emqx_ocpp_channel.erl
@@ -63,15 +63,15 @@
     %% ClientInfo
     clientinfo :: emqx_types:clientinfo(),
     %% Session
-    session :: maybe(map()),
+    session :: option(map()),
     %% ClientInfo override specs
     clientinfo_override :: map(),
     %% Keepalive
-    keepalive :: maybe(emqx_ocpp_keepalive:keepalive()),
+    keepalive :: option(emqx_ocpp_keepalive:keepalive()),
     %% Stores all unsent messages.
     mqueue :: queue:queue(),
     %% Timers
-    timers :: #{atom() => disabled | maybe(reference())},
+    timers :: #{atom() => disabled | option(reference())},
     %% Conn State
     conn_state :: conn_state()
 }).
diff --git a/apps/emqx_gateway_ocpp/src/emqx_ocpp_connection.erl b/apps/emqx_gateway_ocpp/src/emqx_ocpp_connection.erl
index 3147324f7..64afa63fe 100644
--- a/apps/emqx_gateway_ocpp/src/emqx_ocpp_connection.erl
+++ b/apps/emqx_gateway_ocpp/src/emqx_ocpp_connection.erl
@@ -72,9 +72,9 @@
     %% Piggyback
     piggyback :: single | multiple,
     %% Limiter
-    limiter :: maybe(emqx_htb_limiter:limiter()),
+    limiter :: option(emqx_htb_limiter:limiter()),
     %% Limit Timer
-    limit_timer :: maybe(reference()),
+    limit_timer :: option(reference()),
     %% Parse State
     parse_state :: emqx_ocpp_frame:parse_state(),
     %% Serialize options
@@ -82,17 +82,17 @@
     %% Channel
     channel :: emqx_ocpp_channel:channel(),
     %% GC State
-    gc_state :: maybe(emqx_gc:gc_state()),
+    gc_state :: option(emqx_gc:gc_state()),
     %% Postponed Packets|Cmds|Events
     postponed :: list(emqx_types:packet() | ws_cmd() | tuple()),
     %% Stats Timer
-    stats_timer :: disabled | maybe(reference()),
+    stats_timer :: disabled | option(reference()),
     %% Idle Timeout
     idle_timeout :: timeout(),
     %%% Idle Timer
-    idle_timer :: maybe(reference()),
+    idle_timer :: option(reference()),
     %% OOM Policy
-    oom_policy :: maybe(emqx_types:oom_policy()),
+    oom_policy :: option(emqx_types:oom_policy()),
     %% Frame Module
     frame_mod :: atom(),
     %% Channel Module
diff --git a/apps/emqx_modules/src/emqx_delayed.erl b/apps/emqx_modules/src/emqx_delayed.erl
index d2ed12332..c95cca37b 100644
--- a/apps/emqx_modules/src/emqx_delayed.erl
+++ b/apps/emqx_modules/src/emqx_delayed.erl
@@ -92,10 +92,10 @@
 -export_type([with_id_return/0, with_id_return/1]).
 
 -type state() :: #{
-    publish_timer := maybe(reference()),
+    publish_timer := option(reference()),
     publish_at := non_neg_integer(),
-    stats_timer := maybe(reference()),
-    stats_fun := maybe(fun((pos_integer()) -> ok))
+    stats_timer := option(reference()),
+    stats_fun := option(fun((pos_integer()) -> ok))
 }.
 
 %% sync ms with record change
diff --git a/apps/emqx_resource/src/emqx_resource_manager.erl b/apps/emqx_resource/src/emqx_resource_manager.erl
index ef81f57f7..e9f179b0b 100644
--- a/apps/emqx_resource/src/emqx_resource_manager.erl
+++ b/apps/emqx_resource/src/emqx_resource_manager.erl
@@ -825,7 +825,7 @@ handle_remove_channel_exists(From, ChannelId, Data) ->
 handle_not_connected_and_not_connecting_remove_channel(From, ChannelId, Data) ->
     %% When state is not connected and not connecting the channel will be removed
     %% from the channels map but nothing else will happen since the channel
-    %% is not addded/installed in the resource state.
+    %% is not added/installed in the resource state.
     Channels = Data#data.added_channels,
     NewChannels = maps:remove(ChannelId, Channels),
     NewData = Data#data{added_channels = NewChannels},
@@ -915,7 +915,7 @@ with_health_check(#data{error = PrevError} = Data, Func) ->
 -spec channels_health_check(resource_status(), data()) -> data().
 channels_health_check(?status_connected = _ConnectorStatus, Data0) ->
     Channels = maps:to_list(Data0#data.added_channels),
-    %% All channels with a stutus different from connected or connecting are
+    %% All channels with a status different from connected or connecting are
     %% not added
     ChannelsNotAdded = [
         ChannelId
diff --git a/apps/emqx_rule_engine/include/rule_engine.hrl b/apps/emqx_rule_engine/include/rule_engine.hrl
index 7df5d9941..c2346dbcc 100644
--- a/apps/emqx_rule_engine/include/rule_engine.hrl
+++ b/apps/emqx_rule_engine/include/rule_engine.hrl
@@ -18,7 +18,7 @@
 
 -define(KV_TAB, '@rule_engine_db').
 
--type maybe(T) :: T | undefined.
+-type option(T) :: T | undefined.
 
 -type rule_id() :: binary().
 -type rule_name() :: binary().
diff --git a/apps/emqx_s3/src/emqx_s3.app.src b/apps/emqx_s3/src/emqx_s3.app.src
index ef59859ce..965cb099d 100644
--- a/apps/emqx_s3/src/emqx_s3.app.src
+++ b/apps/emqx_s3/src/emqx_s3.app.src
@@ -1,6 +1,6 @@
 {application, emqx_s3, [
     {description, "EMQX S3"},
-    {vsn, "5.0.13"},
+    {vsn, "5.0.14"},
     {modules, []},
     {registered, [emqx_s3_sup]},
     {applications, [
diff --git a/apps/emqx_s3/src/emqx_s3.erl b/apps/emqx_s3/src/emqx_s3.erl
index e5454bfc9..87996e2fc 100644
--- a/apps/emqx_s3/src/emqx_s3.erl
+++ b/apps/emqx_s3/src/emqx_s3.erl
@@ -103,9 +103,9 @@ with_client(ProfileId, Fun) when is_function(Fun, 1) andalso ?IS_PROFILE_ID(Prof
 %%
 
 -spec pre_config_update(
-    profile_id(), maybe(emqx_config:raw_config()), maybe(emqx_config:raw_config())
+    profile_id(), option(emqx_config:raw_config()), option(emqx_config:raw_config())
 ) ->
-    {ok, maybe(profile_config())} | {error, term()}.
+    {ok, option(profile_config())} | {error, term()}.
 pre_config_update(ProfileId, NewConfig = #{<<"transport_options">> := TransportOpts}, _OldConfig) ->
     case emqx_connector_ssl:convert_certs(mk_certs_dir(ProfileId), TransportOpts) of
         {ok, TransportOptsConv} ->
@@ -118,8 +118,8 @@ pre_config_update(_ProfileId, NewConfig, _OldConfig) ->
 
 -spec post_config_update(
     profile_id(),
-    maybe(emqx_config:config()),
-    maybe(emqx_config:config())
+    option(emqx_config:config()),
+    option(emqx_config:config())
 ) ->
     ok.
 post_config_update(_ProfileId, _NewConfig, _OldConfig) ->
diff --git a/apps/emqx_utils/src/emqx_utils.erl b/apps/emqx_utils/src/emqx_utils.erl
index 0eeef2e5e..3867eee5e 100644
--- a/apps/emqx_utils/src/emqx_utils.erl
+++ b/apps/emqx_utils/src/emqx_utils.erl
@@ -89,7 +89,7 @@
 
 -type readable_error_msg(_Error) :: binary().
 
--type maybe(T) :: undefined | T.
+-type option(T) :: undefined | T.
 
 -dialyzer({nowarn_function, [nolink_apply/2]}).
 
@@ -128,8 +128,8 @@ merge_opts(Defaults, Options) ->
     ).
 
 %% @doc Apply a function to a maybe argument.
--spec maybe_apply(fun((maybe(A)) -> maybe(A)), maybe(A)) ->
-    maybe(A)
+-spec maybe_apply(fun((option(A)) -> option(A)), option(A)) ->
+    option(A)
 when
     A :: any().
 maybe_apply(_Fun, undefined) ->
@@ -184,17 +184,17 @@ apply_fun(Fun, Input, State) ->
         {arity, 2} -> Fun(Input, State)
     end.
 
--spec start_timer(integer() | atom(), term()) -> maybe(reference()).
+-spec start_timer(integer() | atom(), term()) -> option(reference()).
 start_timer(Interval, Msg) ->
     start_timer(Interval, self(), Msg).
 
--spec start_timer(integer() | atom(), pid() | atom(), term()) -> maybe(reference()).
+-spec start_timer(integer() | atom(), pid() | atom(), term()) -> option(reference()).
 start_timer(Interval, Dest, Msg) when is_number(Interval) ->
     erlang:start_timer(erlang:ceil(Interval), Dest, Msg);
 start_timer(_Atom, _Dest, _Msg) ->
     undefined.
 
--spec cancel_timer(maybe(reference())) -> ok.
+-spec cancel_timer(option(reference())) -> ok.
 cancel_timer(Timer) when is_reference(Timer) ->
     case erlang:cancel_timer(Timer) of
         false ->
diff --git a/apps/emqx_utils/test/emqx_utils_fs_SUITE.erl b/apps/emqx_utils/test/emqx_utils_fs_SUITE.erl
index d74a258d4..0bbf58604 100644
--- a/apps/emqx_utils/test/emqx_utils_fs_SUITE.erl
+++ b/apps/emqx_utils/test/emqx_utils_fs_SUITE.erl
@@ -66,8 +66,8 @@ t_traverse_dir(Config) ->
             {"nonempty/d2/deep/down/here", #file_info{type = regular, mode = ORW}},
             {"nonempty/d2/deep/mutrec", #file_info{type = symlink, mode = ARWX}}
         ] when
-            ((ORW band 8#00600 =:= 8#00600) and
-                (ARWX band 8#00777 =:= 8#00777)),
+            (((ORW band 8#00600 =:= 8#00600) and
+                (ARWX band 8#00777 =:= 8#00777))),
 
         [{string:prefix(Filename, Dir), Info} || {Filename, Info} <- Traversal]
     ).
diff --git a/rebar.config b/rebar.config
index 4f4b68016..5ebe9da15 100644
--- a/rebar.config
+++ b/rebar.config
@@ -132,7 +132,7 @@
 {eunit_opts, [verbose]}.
 
 {project_plugins, [
-    erlfmt,
+    {erlfmt, "1.3.0"},
     {rebar3_hex, "7.0.2"},
     {rebar3_sbom, {git, "https://github.com/emqx/rebar3_sbom.git", {tag, "v0.6.1-1"}}}
 ]}.
diff --git a/scripts/erlfmt b/scripts/erlfmt
index 0c42bdf924414935bd3dc9049d44429646a8a474..62c5b0697890170bf78bab291d2e2443b96fc0ba 100755
GIT binary patch
literal 827374
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%0AfW{ROm$MlPII#*
z-N)IaB@|NF<=5A95})ip?o#derDbjuy)Z&m9s?_%<dQ0GDitG}hDUvG#9jD=Q{4u^
zNzQ=JJuFQc2^nS&Y%47NCCOUcC;T3PgFK=q@R;wzH6<fle0+@oM2Pv2Y#B(H5nF_2
z`*p*i(Y&qxremujLO4Nc2C^`Fnf@ujc)7=R4`d+^pB}y<^lTplk3*1SlmF|HNH@)D
z;sE?@C<;FJ=B-+&bZc!&7o1^WoY_E-N0%I{fED<$C$k{p{k+Jf{4>0Cef8wOjsk|B
z?g^byVe080dPA5a1=)9>BnzLQ-)QG<%%^V5tLzN9ReQrPgwRCsKSrZwn@?i0T3Um(
zRb{L#dNUKD(%d7%`aNOD^a8I*Y?l%E$nxnRu|vR*upZIaxnYKl(3%j4Hc~hBl;yhq
z&J>wvP>RXY(hV|O%z6SRVWO`3z(am9%!8uQ)H5)%muL;Emoe8pbrX{AI|dM<Zu?Sy
zbJfN}j6UZh#@q~{{D?iIiajjL{*(P(V%%UyIzf<DsXv;cx+?k`)p4-a38-~JBQRyt
zq}qG)Q0SA=#uaDTmR9(OV|6bYquH}reADfi_)*gEbg3wbJbtdxgP_K-pHg;L_3ljz
zjryj#gNJrXQdf22fsNXilI6fA1wW3Pr?Rbj?gxvHki4eWH`aRlW-8lCrFCCPt)Di=
z9@qKrkS29_nAthpR$NX?`MVqGEa<^=&9-t+1>7MIXo{LazeGiDMCo|x@tp4ZEdtdA
z5w}=}kw%&9{S^G1t`znB;u17g=Ko5&bv%o9L)#A17tP;u>c8_aW6hoD&ot9O*IP+;
zh$~Y#?uXb$%<FQK5g{T?QK&bDFVi_{EiOth&fLDtd%T~>pLRHxe18#ooX@VoVs4<j
zFQ1kRX=VU(IcQi~t77)hs?5aWxX^N5&#L^ZwYaJOsuiuyN@i(;;Un_goa)5|w%t^t
zz;mxA>F2#Mg3;P+nf>RIOt@!x_l~{ThW-ren?>PMc7N$Iu7d)basppa_uO&6d#V?*
z78S}#G?PP?!9ez}k)N{ZjeWtt?iyAY%plRzB8PwSEkFU}jXL&tWb6;JP55F@gkRyn
zdEpuVpr(jJURx`n%wR!WTSreYdGc#FvtIG?M#~ib0jf`>#=|CWLwxg3;<UlD;QUV2
z7kurT27S<O$$z}93712vd`u7^aukliBa#1yn<Qj9;#Yj4bFYYFT?yvP5^4lDd9jhE
zlwIjHfw<v8F2U&@WH=KjM82Kv(lUM?p_9dn2JPzGu+qS(oFiVEI;$r00xjlX?$UK(
zg^TIRJP(i%%*8M@+l83lA?wBk2Z`Exe0j&`$^2|Tin)K}=iO*Z1T=%m`d_gO<%@3l
zsdQx|e5vVV#}&<qH%927Ag5vi#)3(M`~V<0*X|h1br}cX2eOC?g*N6ztTvH&2q(h7
zv@(CC{n{!87JZ4*F=<V&za&aKz)UMPfd4$7W}e&|4HItX3}p{ptyzN5>1@#PVsTE5
z8__L=VM{JFy+{rYvo^A+F2{r^zo3#Paw3LNZIuSA$9smu!?<U2Frr&~3R_Av+tr$d
zj!3z3`KnWes$+!^VQG#6rZ;Edk{~~c8Wh+0KMoGEyM#<-<?<2ymqKMZSMo3;z2UmB
zE%{A?P+v^9F>vC_XO#oN>M1RneR@ou9FC<FTJth2m~5B^zYMP+8g}+%Zn(TbN>fZ*
zN|_2=>t8=@BD7-?i!u`+e7z>~21B~>tX)TzEcpi$^eFMQD-ASeH%%%T;wkhh7ulkE
zDnhTNY4pL}_Q8m0_c;7BnQ&SIpnJiIHAZX{(Mi6|1>)A!DXkC~{aVXEguTZy;5X>i
zrmg;L9(d8S;*&ZQ?u3Vupa+FUGW#eOoFt*i<|UiI6hX{Wl4lA~Pu-!?o%1+jNqg6~
zWuKCzIpwq=*8Z^jg}beF<O!eRTXrshdWw}h5okPv$T1Y4&I#&ru3U7AQ9+I}OU8{4
zH|0-fw#HiOEWvy3a+*w3LB_(bx4v<Iwy$>b;kr*>A0(G*cA>)s5@hvj!;GnVhyWGD
zU5@s~?3-a-3`df{tXOUNaMw4`A?}z>n3O6;6{Py6!NE>}w(LpwG$uf6oYZxX#N?bK
zT0EYl>Dvq8h74z54TUvDPS~r;59yg(ByZd*$#kis@3(K~0wD@+nGDh?ov6ftHr)|x
zOIfmOp6IRBoWrY2Sq&>oS#&M;6y7a;d{?VQ;=_1LSz?2pPTpkmrUH~;@s;xitlMK5
z4Y-V!_-AVbo;lRc4bGDdxUBgQ*}Fk}dMpDo%hC26J-5$0=m1B;t>-p${XJg2y%;1y
z^5{!%roVLZDYt6%X=(9smtk|+FW)Jsq^m@wEcBn=P>>~Jp2CSL6670$iO<1)GHmyh
zz&l13cL4aUeMOx97YU#e@%G!Zh<wZLEy20>S|X5lPom)e@rySoKw|b}#)lr8netLB
z)o3BA?H<w}XVHS?mc(F5C%AD0XIzZQ>RUE$3pT4YV+&yqX!3vvKpA{7tUv1L%!p(c
zju+@tk5`N5V9jW-0t!Tha+irW-<HWxbD+Ms&{*&w84x{Uu_K*w-Y{vK$>5Mnej>UR
zx+L0Ln)I|J0K&bmq%zIYl5wN^p!8%AW<8Hpaw_XT$6c4(sd)M!bdv4tKaW14IJ@6e
z4PvjdA1jE?y+d%ev5Jn{93-!0;vck(DA`s@wO32FKVe&TTh8hHg>w=kURU?#8X#L&
zXP5b+=05p0T9Sd2k}1pt1&P90OyVy3w@IQC9?;T8akJ=|P4>!~Bk4m6m!TbNL^nOB
zp&fcew;aU-N5;w;o1qn$`r3kH={3yPe%<>^v!y&~!>cTsT4P+cUD<d%C7W7lS>u~R
zrdK<f`T}hGL*2A%8s{wMm3BDl#`Mfvi;*FURrIkd|6&I6Zy;$0VQM3a?#H_^y|U`5
z1vEB2fXioH(xJJABBKshj4jd>8fy7ka)8jXfS7_;wVv#YBEE=eFP55ucLBLA{Y;Tk
zd)PRP=LcF+B?)uHYCD_@NaXNde&jTVq}I(5bQyhcFF$>n(|+YyiqYPNPH!18q2a`!
z_wF}%P)W|9NALJ-nK7X;q0^(a#}bl9U;*MNvTCpQq#q$nF19kDb6}Xa`Vj_gRfBC;
zlQusllX2NinIrAq$x<%$;hPDabGDI-J+*r}q}g9mAmyE7hNfbw6V^`8%~~@UbprLp
z5@xbr8aKBuhF;Y*9C4|0h*+cjl*K$&x$}(oH`SLIpkS5T*~lq5@swp#;I`-QHGl-9
zkK#Ux2|DG1;?k;%(ceznC13#Z(B_mW>kHdkOBH2_v0^pIt)`2f$EOT`U`)SQpcoK8
zA5y1l_<N&<YF~bR^b+gwy3?qz|1;@Q8nEr`Sb;}FuC;&L0p3*toB4?wI@~sZx+(vn
zz)r!yS*c;tC3W+uik>}E8osjC2aDjJj=#fMX8ZQl{p9sxpC>hT6!G}Z<w%6x&J~8a
ze7kj{s6!ZWj{?(w7sNI9f;)(UhfYtgRULtl72&WV%Tb?^P0GQ_&1~jqI34}{P{)|&
zD+EY*iW9AY^o>HP#xC+v;e00$(H~uJ`k~Ks;!nPpXz2p*FLg6?gudk;e#_i4;m0zQ
zRY!_yxL18O7}eYZ-%kNnsWfQY@4+AEgXl16wmiUBRbF69`wT+R)=^l$jKkF{(}#9f
zk9}kG<`ju1C%ETaV>Rd}cI@m_o7iqXNS(}1T#S~aT~C^!G4BapO6K*Nq=EhH6H8wU
zYp0R!tW^^JmA*~~*U$rg^NwZc21~O7vc3!Q9kN7oGqAKG@QZPo?n83Ics9rR*jo(~
zFG6Tkb~h=>S#Q;I^`HUV)sd~cjz$Pq>YBC%m_J8P0D~uh-TfuDvukjIQt<TR@x+%?
zz~dp2z1}*4qsPJZD!<2h?u`r|$Y9d-&A**caNBm&hH=*72hk3kEc>Vp-Kb5Knh6mA
z@@PVw-OeYrrIuuh9_}V?Hr8%0_1UJrywi4XXBAMl>yedZNU2rYtnPWG?zzIKw>4rT
z3K%Nj3f3Unb-v<&ezEa@-LjZfEjJarC5dRRf^OYo2pCn?j&-w3LxQ!1_RP>uTDy)+
zXZ~v&cd-=Sxy8GZ+!@4W4X(A(Z#Vd@Paxo8TO0^*<Z^5y4Ogu_oI*U9LUhsUNc*Qt
z14qz7%7bSd^By^IUAyau_YoQQs^Jd5LZjTfD`5?&i^6zyM)`D(pNFdo)lx)M6D~pL
z8P|iHIcoU(P8+ZAN^#GCBADZudiw4*X7!<K=)S2d@`cRg#EOll;gHV2C^H0}c#4a|
zBQ7`A+3q#RSSL<Sy36Skp7o8EQ~Sp{-^>0Zhx*;|3Z7i&L!bcW#jjVwj@0$Sj=#%^
zUOFa{ONm}gS&Ey;jSLiz+iFpY{r`;G(_#)l4li31rC<O@hlzD7KErciX!AS6+gkwv
z!OI^tmYL#qCjvr)Ll0m1L;&Kbo;HO}4-1^sN14!rcj6z+QcysBXCI*+$s2$k1=u#*
z?O$MYS_eOoVveS19P~idE<%JJE19p&81|KwfbiGPN2Ng7FrA>c*I%`8FT8XwoK32!
zluio$Ou&u9DS<RHl@N6JHD#5+!2{>Q19x=60*WeheLsf2#xjUU^1r($PP>72x^)tu
zf^y}DnZrlbP<=rTn8U^*iMsHkN_0mY4P(lk`j_S@>6bhWUDxzuWYSaf?8rd&-1-rn
zZ&LRZxiDf+;FA*R9c6?@@`G8XYW~;n{W%`);ABodvoQY~akTXx`lI_ZTj^-^e!)&3
zs0gDdd~P0Zozq205=^>S&Lpn0Ic~EXbC5O;noL+XHmFoZ7`A~Ex~xITaxR%^8YY1v
z;=d)tL<Ax;dUP)mH;EuEn5mwrO2X@uZro&t-;mO3;z^o{#PpFfcCWd@CGOg~-Kxi!
z28q%Pm5D|vO`^x1xM&y|XV8LV9LnSH9m<WP73?iM2IkQPT53wJL|n@|cVLwi_)tyh
zCz#rtmCj(_3vh%Dtdm_L`%1a!tyD|CCrB?ZSKuYADj3rIi_F|F5#>k}q)vE~THnXt
z^F%{0hx_8%VcaiPkUS$3oRsqA;!GsMlJZ><xfvuGL)Mn`#gX()lwl9J2s22r*qI|d
zYL>h&_5XK)Lf_;oU2v~bQO=ZK+9#9%b(f5D_LhuwM)&8%LjJVWsqlWDq&lzVYn8C1
zpl$x%B-WJ&bv-R|NZM9^wBiL4F-qYk@qmrXCmreptL*$6S4WU9G4wu{VBb5`H`wlX
zAC6}NU*H|;w2ymnIE(KI72GenpK**bqluoI68c_sJmZeV5sAi|hZzKxm-2;>UoH0U
zY%&#1ZiZb2)S%SWX9hvkYSYO`pICb4t2G&>u)IFy9~O@U3LnsbQWq+gh{%}0s5|ax
zUF1w-a?(4#R34C@vHLq}-uYK0=EN%1Bei1AC6$Gb-$pB6H!sAl)(^^(!jm{H0U#ld
zvhgI*B1Fs*!O;=!^h}}Ma<vW0jYm&_7jUcV$_Cpazz?{9fG>FY0lD-JztYVa&TcJu
z^X(D{knhxTgZ96D;d`V_N?`=hMmYZ&Ai?L<GcN0<y6D&2_p<*onpDo$(MCv|iv7Vt
z{bey09}Y!OnTDgzXfW5R_CbpFflmG1k<npvS?2f&E-xF#rJ#Mhs|X6WKxU#?GC57P
z-h#fT$aJC~oU!p&*JMe(RAX9y_&l`C$O8)+8;e(cBUS}iOZF)T)G{<k$-_M_pH5c~
zDKoo+k%!H?MkbZAOZl<`R!BQx%a_zz?+va86dx+T{x@a{;tD9==yKvLr(9g2P!%TJ
z6(%enKr7!BR!|0Q(N{a*-~I9&3i>729a)35j7(~cRQJd7xC;(H`LMi6ZwN03<&XA?
zVh<b(244jU-CFHn!<0iy+n!$9`gJY1wk-WK&qx@o){RTkQ+E>htkWG7`V!~Wb9D$!
zV*x`(g>>~O!omRR2L9V596%nMuRz9Ys~xun9ZPT(KY%ntxO7EzDGOnY(}zrBnf6Yt
zmT|H6I#jY}ECIrQ9yh`Is#j*Ema{kF`wa_+pW(_ItlFaY9bc6_WfWG~9i{BAU1*wF
z1)krkB`M;=(Jb)^g7fj^g5bTyUp!b~XiWIVS|UWvEcQ90uX}o15V1Lp!WbXX!YWeg
zZywM?4rS3r4n+jH^%k;G{SF^LWfn;}Q5DzPy`1$^b!M%`a9#m(Q=KqaC8V|Amqb9I
z`?NJEjNF139J2a`!}I_tFK9LkXH0Idb<vzOVR6l}>!(ekwp{Dnmb%IiSCAVMu3>%)
zLeP_Lg2-h<`hr`)G`&W^OAfX>Z*%OHTDO?#`(n3d`BZQ3&7LZt%}mzVr)2)3mKfwY
z<4C;bRnf_G^Z4gLn3X?%?t|I+IcsHii)l5g9cs{JsglV*M+R<Ub89`EVeYI>-@xRm
zKA?7d?hnRCf3p6&@zvk&n};RG;7U*e`Ycyqww05ookRfSzorc4k3SdyM2=uzcVP^O
zd|_Ax7@u&drml&4l6gV2pLa@h^MZjK>|&<zyJahfv)0yvnec0Ijx9vZb?@d_Ekp;_
zf|dravzjfR{Q8~p&Vbc#saIk)Ij*Krc@Z@4tXOWNqyb;A!1Lz1+Q-rg1HI26ZcX?J
z{n!WIr#-4>*@%n2klrlN-xBLL{Z%`0tIJ7)85`5*{*6GBvU)FXPd<J}eqwYb)t*Fg
zl<D4yBY<b5aThq46eW~jAb(A7z5%Rf<4ES@U_+znu4m>^qGP5Q?Jv2fbhW=v92<9d
z_Wo?MWT?s?oeheWu;-x|Rm0c8j+o=Ir8^%TE`E1kpYzqxT8)d6d3BhW^Ig|jjf4N1
zI#~!Zd_CY`kyf&wwiG?1H@5#SO?Ih)=FxleyK?V3#gcLFx)~FBXI2+^oo^+|YRWt6
z=N$d7tS34~(#2Ms@qS_c915p@%g_pA5S?ZAyS`D^?dxanShZSv8U#7a@=2;Z!<$zR
zk&(rw6wgz~qOa;xXciB4v{S*@e*E@M!il|uvMU@?AJfrp@6$dxfPXCJdX2jPez;Wg
z?av)sEpLjIj`&aH4vTsjr{O11q|FnEec1@#e9I$d{SMZ%1p+Xu4b+tI+=t$#&namh
zTXpHr4Q^f!(6~e)LIh*?{Bz_7DCjmsv7qqBz8Qgj7W~<b+O-+3I9!*x=P`8+B&k}(
z0LjTzO;k+ps2%mq=_aWU?LuF9OPwAa1T0ZLbiKV{EU~sB^>Hxk%y72n&a~&+?Rfgq
zE#Go4-!?k(Z*6<_gq%KSpFSV&+)%JrawTdIoSYb|+tAf=U=dLn)*63vXQ}1<D^odG
zA$PP`5*7+m$(^>GeX5eMs6BZ~Pr;M32pY7ib-1w{cdu^lTGFDl)5T2~^L8nrN`l1k
zF!T)UPLlLR{brSQiYCNskt>*U2|0(#C<KrA$OPEC$va{<p}_=WBWm8%R5{s)&nKMp
z&8nzr*{ka^-L=nRwu{@;Vm-N|Mcyjm;IYL5k)c4ZXCt?H$db`vwCpz<kr@1H0<Ycd
z$I3-E(e*f}S^6PCm8`kBZq|NX#he_iUuz9+?u~OGk5Ana3U=5W&eHl%8`9rxyhF`j
zdf`3-(BA=lCDd^6^=W2ua%io%0o)sUF3U_qoFG|R05%3N%J9u34556NWdHnzx8$9$
z{d^-K#qO*T!CZgwMi6R~5Q`tn8-6#3`AuCwL^CIcNt?YBhCF+rbpyMAHcD95(We@{
zY7qf%Ep$zsi<+NPbseo34)JFX7gaTfJ{6Vbez)vC^1F@<d%OnG*F{GwaLfj?KDB}^
zG02kR-+@CR$RgIWn9Fi?1JC9G&rH?B<~o{2B`w$mUY)^{iKvUaB#)*aI%j>Y?)$L0
zQe(%9^YcgpRDD~c>u)h9m9`Mid<;gyveAqy*C;+K(rr<h8Dg1ZHSsK7*<haPw>uM;
zip~4X_}vqEC+E$gxr5x=Nar=A$5NK>b>V0tA{9A2QbKU~^~eMwAs6z#9!$4)hcAD}
zqC$4A=@{{ZgK)`ZLt2?oG7;yW1xgA~7l5~=@ZUy#Dm0aFl)V<!lVC~i&S!&8JLh$N
zZEKs9DM4r-%(AYS{TP^++K9BO9g(Wp??R$80|L^okpZtE-VYXbJt@b1hPCyvZ7Ik8
z%Yq4LB{cv1TUSnaTcX<t$segi+6Q^Mz9EOCKWq5rqr>rz%7{rYNxN@X8{|2wqO0Z_
z*f^s(oEz)>T1q&F5Z8F~@hO}8+f>HWUtvl2lG7(NOE~K(^?Bu)5a5Qr!_NR{G1)`}
zxa3cT6&}MCq?%yp@+%;m7gZ7+O!(W-6&^>9Z@5a))bh$|J{xNxWsD+s3Ecf%&~-`C
zQSjg|z#ety<u9)Gn4wA)%FgM2Iy*BlZh}DZF#w!~t5ji+tc-s#OjnIH0?l1)k@{^m
zq<)F2mk~`oRiWd8oZa3gkAKzU((TK(8o^jX+Ome^_Xwd<Nb%1$@C5o*U%otE5!r;(
zqjq!ZvhH~}6>exs_(_)2Qu9rFh#_N_u-zS=mJY*9<cclDv-bd;B0rM&ceOmrzg#qA
zBMIb=qD_f#%#L~-NOe@54vJ+jFmqsvUIS`Wgh+xa<!qdYaLmc%n<6xKj;T2BF>#IY
zaEoVL@a2lt3*U+$LRerhr0LXR+Sw%Mih`~}lt@Kz`h14VnOADeLnWt>Ve>M`kn+D@
z1muCLYv&COlv6rI#v;Wv4Wn*DZ{Ft=yIum>uD{_NY?GBO{zZ`gX0Ct;nXo?yPH3Ag
zJ^qvH3jCG;n6E1}GngR0!a9#TsHXQ}p!e`yv-)X=3ko=%^4ngPr4tV;*K%*4)D9xo
z9kx6*-#-Bx&~9wu@2UF^retnMv}U<E1G703uA|`h>mpm<IQxZE>|dO7d9BrM!X~89
z;T&$nD9weLryFUE5hef;MVuEceS1gja8Z(78sk7Id#TW|=$<NJsql{%y-KlU19W6Q
zCbuN9UDHQ;dHLZe8avUjs#Q~5@~S3+QW85a)=4H|uQizDGUXl5c}$!1M2%Hdntw#O
zvH!^0veE2o{=a`r*q)Fe^rVG8uCDE2C`+m}hdDV>|CS<D?2=|4`TIIMlo5lu-Zrr4
zpa^;XZf83tc{$Vvs6Fxw9OSlfsQafj{>dk6uk>qoUFi|qE<B_aDMJn=cxc-_s1izj
zCxlZ=%owQ9NdEURn^t6s3Q(XufX%i$H@tsf*3-tqy<p{P$URb4)oHN1huSvj8V#kF
zZkzs^j}PrMljfUVtX;~VOVndLi-v#LSDMfYN|2%HvME}5mQC^+_2m^rYJEU|^^+M@
z79j``c}O|h)khUw{D6Q+cYCP5J`$(B8R=nh=}B=cuBjiLom!f5CD%u=U~>y(b8L&z
z_p(i&Y^m}vVDh7Vp>dr|$n0S!RA@kXl|4itmJA==h`FLKA~k^#Gb?Z8?Aa9pdv~iL
zyCm7HbCBpfIhq_a+H*D9s;paM{OSEFj2rz5B^wPY*xy?xq3Rt0sKvKihmJG_qC00b
z>v;E2(Oq13oe*=C-ATm_&E^X*OscltCOzb=42wVRC8B#7Sa>tW8Jno_;Qgk%{2p66
zhlofAUw)yT5p>n8e<~3oW@3eD>S1Vx!Rc=4LpG+c=^I!^5K#?wtTJ7HluL>Lc(vy;
z{uo0e+dc|&k69&{s)02|9T4i;OND67vP1SiIS^)|f5u50@HZr^Fa=2$w<}ig@X({}
zSAeL-iZ7-W)Ap4w-?2AE1#7Bg7KQYr59heGDneyGI@;X{h!)JuXOjNphRysK*PL-e
zhI6Sp@(_U86w$MAof+gM1EX-Z$SxhZ${oSsk4f>wJL2Sy?Jwn?LI>&XRs5XwmY?&m
zjBw3UaKxBCiXC`fk3j~^DC|%yTy<l#Y)pDbqj18q3EmCGC2a)5iyl1$wso~CuI6gQ
zjS;{XtEw>eAq)e*dx$le79@>9=F*eq$uig@OOK6_`E#&Y^08<?sFiVMBb##({jpai
zS1Mt&v|&^%bYSemBb>qiPx2<{mC863ddT6(Y45ZPUQ~7Sef2Liu_GsSakAbpBYETH
zv3J*U!FU3v>f%RL=rA1FEUOV=GHP!<f8p64-HULNL|@?vVSzN9?kMc<DE5a!LzpT}
zIOtSq@5ktAUyJk4c-6~-@fClWVJGha(!|$%b))F-FJpoYTaqdA0=9$)V(PmLiPY=k
z%9c|HrgN!li)X7HuMLeiS+GpL_2!svLf?JkOl~?TC7RGI6Ieo35KJ`y5!QK&ECsI}
zo7iH7#&3uA50jv!l{2S$A$d$7-rBW4+M<1B$X1lk+u}kQw1HtA+CY`fPW3wU;zfsB
zR-9^-VI|Yiw*7_i&(2n-Wr{1Av4xu{IMR?t{zJ@m2&PYUK_~l^!iNC^pzFr?)MxtC
zuPX(Gs7xe@i7Jf95T7-vjoukAiuK(Y1E*YBpa7oF<?d6yU8cRq1uSWqYO)_1zl7NY
zbyY6Jd_o*M;8wB^-kek1ZmHs$mxZ+^H4G3&vKv^GY-)E)e^%Nb8R;f#e06v2J~w!Q
zlBnbiJ+^qVS)Q+4;HoJFOP<f{l9n@hl3hGRujNf!%sHJ4p$o5E`1VmEwrP1m3nENX
zhJ@3GP0D3o3FBND1^#Hwln??3G~t+j6)?<=JAjFv8<q}IKv=9cxqk-p)CyXpG~zaX
z4scfd0AEzTvCLs`Z(fQVg|JeS;m}>`D95}%fkSyqbTFdtArn_g`&QMh;x8d@<i24m
zzc(x1*d3y~rWLL1;x`ux|J>1vl{%pAPQtWRYQj#NYs@vWWSCCl%MuzObFV_`TjB#X
zPh_Uwv|G`USrH0VB0Q~lo({##_L^}c{FwpD#wNYas3;cRWeti)QLYV=+GJJJ2<S4~
z{hlqn$r|w0h{tUAx<huAb%WP%aR7HM!?MGn6UKk9FjaHRdRj!hrm;vUxKY2-gnO79
zzR<8xg}_El;fhda0O4NpN--{&e1SB;!-a+FTRPF~0wnBWP-M8e^6^9_74Ycy?oQC{
zZ!*ErjX-g^ydZ;yQZiP=#ez%OS($>XPB|uA7+nlb96-JWWfCDA>1ns`v;ET8;7@D>
z2|H85IZv>M{=W0EvK8|6E*6d|7PiDU6;m5k6a7&Z+qC-9?s|FIeNkM5Mm6rL{HH*7
znv|tPxllF+mBJ?pF?rheMNg0)Pp#mFg<S3rN;*cBs1^OR7ruRQ1#VIq?!@8Wh4A`8
zbO+gV2ld9(&<)wDwaTYS`->*sN2vXoeH}nESN;r60r_md1ItMIg$e?v(GEk^sp!-q
z)U0Gx8wkt{2*fqMc(*xMw3+cKsyH%UF3H_srs;~LI?!{tk_g%JA{AgrzKx8|s6Uyh
zWZlytL+^4^BqCEYt`@G!yv%sjf}etPVUJRhG{yRRRj^O$77VT;`4*$vZebuZc*T&|
z*r|G5Yz6Zais7$I+(GyT<EzC)!A3mx@cvj!1gh}R@x^f{jwM7Kpnpsq{Vi1LH#{(I
z0&45NK1l1>nKis6JH&@5^9Ell_g+BVp>OCwdM6tDp)M@oAo&%S=3&SDZjAYnRh974
z!Jm^mg_E1Tv}je)!GcV@XiBRmrL37!BCH{mq|)knkq)pQ?}b-^csDBbYtVaS+$)f6
zq}!rv{AC}~7uCG6EQ?K^{^N;VsQ))e&BZrS7#@s#rO(9pM_cTeDIo|VFN<N~m}0wK
zpYt#VN0@!IeZAO`!7UG*ILyL{p~vxjLwzxA*hv`7ifUmHZTpu$CyS4wRiqIAvJ$|a
zhoqZTC{>f}A2SMEgxPBE{gXUy99{J&w4sk-5)x(nPt4uSoi<ah8r;tS*GCw-k9EGF
zF**KRycN@{RrXO1@HNd#@XaIREHv}&#>xQO1!{3bcW{hiag5j7Kd7{I{k!4(3X#X$
zjGlqIE6cnD+7kA(!I|^d4?PWs&N?F~Q?OqVB6v{>+N^XuPINp+Okf0EUYETLjEZ)R
zpIu$walUM*slQus(PKu-0&X+#xQI@UmdxO8y@`<<ucpn)LG`ibJ2`Q!2%>H`&lg~7
z(--@<*O8^1c##`e4A9!U`}#831lG(4`cbsdg^lC=|0$VHGj>eiBzhsS*6HNO={JQ5
zbc0*;#oc|!jNnW98r!K_uO=D*;SNf+N=ce)NrlE$TGc1fRr7nldFIJZWr<JAs*uL%
zErElkxhKx+1z76y*#3YfmUt77P+b6PRhD0)=6_jh8E5dfkaGjxU<@YW&JU1nE}Au#
zNeDbEV|t0}bT=m=45QdLua8xpw4m;k`C%d@I8W1;u*lgE^9dYHJ(!m0DE973PlN2o
zXOa0=?_Z}r4C6dz4EtCl0LMQ$*cD;|nB*g%;D=OMs0q_O5{pI$C3jSRk=G}P#6Wn4
zotknP+2sXt9R;DBblqq2{K2eR1&&~^8*k9&vc&;;>s9Uk=`kqK;BEw76#yjSS{6N8
zEZzlsD6XG{O}jY`mT~g9L9o0>h8eGKlO5V^crv=1XtVLdr8sV)hf0GSdm!uYndCR1
z3`8VGIScp+`O4y(g%03G*<<PI*hBr1dR|@Dq#vZLkyjO5jpHSx;Jpgyy+%s9&uxKv
z;ADkux!GQ>zJSg7Fz_oqnPV{`ZCI3SKql5?@2<dAXA+a_s>9UFS#+dhGb_`bu1c9W
zXw3#pb1bACH6`@w%;Xh5dO@B(!tt?Rg$;M~h&1obzrzV^)C!HZ=u_$jXef&Dp1^VP
zu$g@g>>OmgL=zkwsWv#m+lwYY{*Le;uj!a&E@uCQ8qvXWGR^vDQSsO2Y3^JH>Yo*-
zX-hpPEvmjx7%H5^^=jc6W!&1;qAea#<5VXCBW<|N#f=ySgn!jFb5kYv2M)Kl6q!!8
zmj=s)ZiGVQj+_K5AxAQ^3xfYT&@ebN<ZXT+yOvY8yhLnn6uK@4QJ+`7IOSf1$BxR-
zLK%RP)N90x%ncBV9o(2M`~!$rQT*-7u6y;{T7x_waDTe;+>-jzqMV{LCSu=4qjZJb
zu2XA@99c-&7bOUq7YEr@zrz0VyN)0KAEwQIjd?<5sc2Vw;MulRwC24)mnRV|yK9*U
zFS~1707Eby0Ij?~RDi}krzUX}??N%jeY%LSO(=vB{FJRba`ujf^Bp<S*#Z|{w=Htw
zUhSoF%A?EC?0=B}p!P=o=^Yv%s=Jzw=(gGult~ev`D~fJS{a9wQ%Yt<Ce!TZ*dqh)
zp0dUHetDDYoT`?!L`PDH_=PH=&uf6%>2!q)Cz*C7U$`1@NHsy-g)Lz?2jq+U6U(i`
zOh^<9tm&6hlCNNs*G_XyB(D0fY<yG2Etk@fL&0?8bZL&I)H+UThLI-43}xuNW$4Gh
zZ7C9;&K{K<hOE}*?WuYf_LBz0(9wyNLLE|IobI6L0Uics+AGhuWznD1FtD`;%HH&w
zGt-tlApCY}?o`2)H%Gx?E>^z~jJmd1BM05}AA5?cks5ZG_}K1*3Nes?QdUYYlJapH
zx%Jw?ARQvNh>+zdy5vhO9mey{TI9R|lIZSSu|~a1iiCr&89xLHf(JI`NsVUW#V#47
zQ0&qWgYPktKS9mYWng#WiOoug!lz{F5CePABMT|C@J4ZJh`iZ!^k;nfHPNh-HO4x>
zyuX{1<z;N~gRT7e#!m=$PVDUsO5(oGMwqLZbXH;OiGpxj49wXWI<tY8o$DNiTFwd(
z38dXFMi(`um~)aY>N#rt`e5BUx}g+eHa}nEAP|eXe$>T{f|H%840XRpA_hSOSTz5V
z$13yhC{^xb=9%L2h}-7I&vtG9(&YVO*cVl9=@PWb2yn#e?ml*M8I|7%eQjH_ClXZM
za3gU`eE20ZwUTx=h_Ltj``-h%#$)SF?xh1a)-9t=0<Z5UrX>S*NKL<WK($2mYF}P&
z_4dE_O{m(CLfpdwTUDXg*9d!ixL9sPC#Gt~>k=J5V~m0buwfDfuI<#5rno!w_WM8F
z!;XA=#MTrDbE9EjGZMOpwkR>v>+*Er)`;Awt$RJFt^H!t1|Du@3|^mIz5VQ|C!ZV%
z@FOHo-X$%R=C}U!40SS_tYpe@8`)yc?|`@IZvR}o>c*r9$h9OHxKfwBk55mMF2;5D
zw^wzh74T&)?HTu(*WP{w>k%c`HoFhjf?gNn*gdidsFHf?n%c-i_5B9J!OT>3mX)q|
zgM$izq6!ut)bK%`>Aq=zVe#qO+HOwOI*NGU>O|GLr+7x$VIb&s<*?pA>L4M%*9Lx{
zJt{?#(W?wug4Cvh)y&JUWJK3HPh;seUf@az1TxB`v2LRXe_V(jNk+eI3?E$9Xg+sF
zjcsi>$abz7uWqzYZ1HE?J=*tdB%yCz^m_>k(Jj4o%f4O2;E#15N?y1O&){jIJvb2&
zjre%uJRYz`ztYVg`*Os-?u|I~a>u?pWs4(UIq>z3UJJ?Zx%aWe_|nT22Hmjn9Ltfq
zhI*ouDA_v-ckqQr6>>)Xjz{v0Dpa@gpKn^Y1pPSA$J3$@+vNLwHU)i6JYp5_GaLCP
z2nR4^T>{(}{sjDXIDH}J^aE@+-5w{xyzfvL0afP%XK#J}1-(r{0l0MEC>kB#gk7NQ
zxVA6taNd2vp&Inm*zAZBFBzZoOU8f$BX70$@<2z{7Cbp;EYW}8z4LTEE}xGP?{;5*
zg{{9?FCuXKsp439z(7il+0Th<dIb?VPEja(WxoT?zkfJS{CFa(IOlr*&OT8i0(8uC
z{Z0cRgpap_YuGY$h+ICrb5~}nTN8Wg81wf4@0cZn275*tf&Zq?*#_3X1tAXk7G@@l
znQnR{D(pGuEG#AsL-HKh#Zgu&n?oa$S>?`UJAYT#ZsCc;Dc4@NYcNU7(6DR3n2}yR
zF=m>Uw5MsnvKL>qfE*$H9xqo;6q(Ee`G`D{Qcra*kv``E5$ExykiO&_OmqwAJJ~M$
zs^bO>7$e#h#`j6i(uv!xeB7B}slg`67adBK*sDR{vjpL~W7Hz-lfcFW{)-G%=p?{e
zK7eVQKxIzs8{T#^EE(9^;l>l6uq<~H2?pLa!2gEfFUfQW27GOrV1M+FnXVUt4DQ<K
z(&M6D2S=~5qVjN=NDlYhqlWF91Y$obxV>>b2+*PX<(En0mLXFXDAS9+A{FSY!y-=5
z*K_Vg<!zfNzcsbtpFdV@ZM|Z{uf)_-wnM@IO3^p_k`s@PZsT6B;$By7FHTqZB9P5r
zo%d|yzhoi+NnxM?gQHAhkgr_bBr4QHxjF%lZ_473ol8SU56LN%5X%-mWQuU)Kve(L
zz*pHDr!}fY?O)x$8LP)uC@_LUDM~;e<8ko(O&y*^UTT;cYF;Yf8~?1`!lZS@3Dc$n
z%(3~?IZ`E>Z;Kxe7w$n0Qy@jIp(A2%VfwNCnZmV^4Pf7~_L!OpeyaTwqa(!rg6XGE
zX6-kHsJM$@QQy^0d}{P(3%48+QK<OVd7$O5h9$?iwp6bS`p5B?;Hh~n_s*r+__o;4
z3_`?4m!f7|r^wGHkH}B9++9wrH1M%@cL*XM)@84W`xsJ3yaLjT;;(XT9z*Onq?UyJ
zM=;V;Ipe6Th<&IVH7GNnTmzAh=#4Iq&@9fc#E_2Jfc6!xnX+F)BeV7HsRq|{hV_aj
z!8rA1+*p9$CW9|@BXuvY(yO~p-nRVM*dsRtd6zT8Jur_1j|<?$t(+yfgWJjeP>WUO
zvO{D)G4i05nyyD2OP;&jwVwERdEJ3}o2cu+83|lZSTNA`0;JHzra$%-SnVJDJ``Ui
z(I>Ict0=sIFGCCz=ewSv@^j*%-YweWGJyC|xF<LRQ*72d1O3vZsXB15oDcL&_9dMe
zS1h(Ef&IrkHwRphpAF^PU=TbFTwbniX&&L!0C^$5uBwt#FLvQWy?!Q)8rVP~cM9Ix
z-%GEwbB!B-bE=n6kOSexp<0xNKL4$<Uj4tp>=Jm6iWf($rTa*{37S}^%;chp=OdNs
zi~P^Sz?&^@)5A|YgylPjf~y`N++mZK8pTE>$qA@A{z5IsnMc#JWLr&#2Mz52WRmQq
zR<vHpoa_~&a?wmc{h0Yw(r?u!lX&vbA=|nv*3liyIBe9g9W2zf%xsV;)wO&rJKA^b
z(uHIkzwg2>KvpiB&dFu4`8$EhE<D&{P(Gd0WT5K=H5B*U?wbK!T=S2gdJznEyS8Ko
z1g_l?VY;xFi>}o8vw3%%<On9WSesl)>|G{4J~Azjn~tPpcLBZR0{7Qg;w@TGA6Otd
zj*<7&4EqoI?>leW>0{qJ?58yPd+XG$7*mh4d#`k90FD!HSJ=^{k)V1cZSO1@VnFtV
zw^fQ{F~7`s@=&W%1g^0M{?-7}ZZ>Y*W`YRkmeK|ZsVGaqmI;|BwuS|(?o21&AtK;s
z?whZMi?T=6c}+)se&Mx7=!jnR!?<31_cuUkH{+B;)l21Kq;DMSX*as@k{3ziCb(%x
zu9*d}CoZA~agv_{%l@H<(JJ#%O+py5x0WYDX8Bb=2~O+K2jT8!5olqOZVcarOwm<~
zB$n{ve|-Zk1C@pRR0S?nmPYf-myTDk&)Za)Bn$cHBaz`_IK%13k4=8Sq@sS~9`dzx
zHLv&Tri4zUz(DMYgT%^jiBwfaqHF$Ti5JLJK2SSt?fT-s&X?aZo>XfiMD05XLmW_l
zLd8A)>S_?}_;93kmF)c^Wfx~h<=d4o`6)m%exo$`&6Jfg)=<DnB|mO=PjQ6D7h`Mp
zehPN3KbUx}@+{{gU20(zE8rttW?__)<PXsr#LH#XYp?d#(DmATv`_HqWxi48D`@cU
z8^~E(AX?gVtI)RXi*`h(pNF)YhcrH>^(rcd)%F&ViK=B)l&A0v@y=!%=xdpgpLgTn
z8~Oc+BW|L!CP38Etx^6+;o0aI5FVlUvapf#4+oiLrBDqh)6`$OnFZCr@w6Z(rO*WC
zU$yG*qB<#|_9fQchqvXK=wa&R5$e>|+r=of;ML^OnlgdhMP7jdYP53n59K_Ii-w_i
zud?b!c@dUptP_cE89ii4FW|+)kF4xE>vz6bXF&R>8^IOh4`@715U=dOXFuYXsUTnc
z1B@d+4o8D5udzq4m8x#0{o5;FE9SG)M5K4L!jlm*`Uj4zdj|2S`@$fzth#x|(5MbJ
zuzY=^gM#Q51WFiwPxp!z8zL0qt{xlxW8YXcHoCy&Aon4Hb;u}c@G(F#sTWT9LoYlx
zfsqNjn|Mr*={E65?TIp}#7|3o&(G1~<tU<R<g=-I<kN8DbAl(~W0-QT*D+J_vq7O~
zuj+CyHNrU?`Mu4C<e>iH1?G%5wkRGUm=TxfYV8E0T1b+A>KfDVk-QfP(w{&sgwey2
z3b1cX;~i0(jz{uTtc8-8iF`rJ(N=rB-Bqh&l&JrNNwluP{iPFVt92w;*I?qZpztZi
zvPg~pQvBWS8PPmG$e&GQ2pDMduWjs=y=s1B5jI)^L4TIJ8f5F;w$;@#w?~QP`A%I@
z`o_!;dYay|3r>G#5*(>m?VYymz12>A;hJm9(B{vq!i~5c)mH5yg2J=1tM}jvSZ|Ix
z@W;`@aw#E4ckd4T948K^L8EZ*&i)6KLQ0kC0VkdM6Taf+gH*K-M~EA5NHZ%r3bP8R
zN2yVSTx$v+H1s8-jlait?H1s8qk5Gnov^^EID>BRU3gB9@7iLgnRs~yJCaYaPB^8n
zeI{GitDZR?I{x)~T+Q`f2c{0gy>JRN?9rFJ9Dkg5XOYBRY+X=<MI(KkcGw+gl9UyJ
z_|t9#y_YD0S!{lz*o&9u?%Y!@kAwo;KPb@X=_kdC{f?ltPx9m%Wp3Q^qkQINR$06m
zwSR6!sV_Y`<i=f^%#1!39PN2c-TwMPDLRp7Y<0j{5DDui(}LAk-XGwfZ9`v1x2E+R
z^YbyrrUffmv0li3Ub|4&uzM9IZ+LeWCy72HRl^rJNT$%z1(=3ONQ**-vK$jgfAd~q
zd~@Ydw6TVvQ!T(F0&D+EtmuUC`G0J^b8uzN8!a4L6B`rTnb?@vHYT=hXM%}sJ2|n<
z6Wg}!<jecJU)BBRR%>-X>zuuJ?K;(Ux}RQ;vkC(T%zVb5F#^G(QOw`IXdJZ^^BsM5
z5Nkim74P6cxsa-0S!+<@=BCqgFGeVl1*@8jeL?Yb0<85wc{4m9Rb}qr{9W(h;BcPc
z&kr#Y9}bd?fwWWvzzXdNS}H(>y28i=EyRJ5o)BM@2PApCN77beT><qWiAZQR6g+xH
zkL(J81B8Y;Db@Lym0RPQn!;)r$?Ot$Mq}*Io!l@$ZAg2GlqwUm4NL<--m!wppNvXt
zmr)+#y2+s$#bpPYn4k-ZA#X^qG8ZXCB2ODi+<uU!t)_4%V;Z^t%QzVW%*a&4$+VTY
z$5c}&%|sJ)*;Z4Cq`4Bs1c0|<pk;rqHL$Fzu$;WqwD#SI<p?#D`Y}Xygm`s}e_7Y-
zhHICm%{&Tr5#(%1!CM+&hT+fqf3F5%`?sexVGFk3Vby^wt~sZGIOirb2QJ|onW8`*
zmof#F7LIB=Iam`UsEQE@TV2KE+_+#F!&EhzOgDu12EZg>zVgs}<KiJk4=Ad$Zfh7W
zR|PEW)N(1W!YCquoFC$aqo%DovNTSRzaY$?;<M3&D|?}o=w<5$(37*Kc5rx+(fCqQ
zeLl+EG(!*i&34r4=BKPy816FhTpPNMSfmmdq-v>C4Dv)`yP06SLHyMgpZNPHq~M;6
z3*kl%|3>cdw*nPUggQU9IHcR|xJ!vnJ*P<3rwJR`JfYM@-lM{Z$i<JuInsUw2by75
z%Z^0J(i##wCg#=)Fh{)ZtA8S|HzEK41NJiNpn9E1(R($p_LK$+88j6NnS_|%9mcYD
zo5bH4Lz(2j&G@%7she)#j>}U$bZ}$aUWUtZ<}U{Ezl1Yq^=)eRz4wO{f@_=;OM9n@
zzZ3Aq6=r3Z3&2|#*W3U&b3q4*LjH4u2jy$XDRI1uybjP|MjImZ^-(U!PyUJF?Ecm>
zGoh#_)M%9@ziYFfX;LJZlJfC}vfZ^zl`1K_%<v`ZvM<SHXNSYrsTa|lw&Bpv$}rcc
z7w0Boq^Y2YGk!8rEz;&|1pj9A?q2p;mcjqSm`n!>$~8zWJZNaxFGKyXbBY7PwGI|!
zsarU@8Fn=d8n@T4qu^3$pzv@*bRUPIC(!U_B0fGvxs7GI^ueSs%PRuvE>JR9PG*2W
z8s9pbgH|gbju&MlQFZ+32*T6zX6b_(E99rnD%!dLDD(Vh0?vHNq;83rSjvtfvIhx-
zF3(;mRUIi)O(kuFqo1c~P_Bqm90!Ur&YIQA5Zy#$R9f$HFAL}N2J=^%*Uk-nn7DYx
zEERMdBN?7;pj0S3!<?U(d-{RQ6p&Vu7Ck|`o275+pVjb4BqkvPJQTxN=EJ0xlt86w
z%1DSQk_6D*#ty~sPWdD=hdq&t-*up_%qEVILqxb7MXIQoa%;nv80t5z0{bE`gH4YC
zkxBINsCVGr7(9yb|8R%Qwrf+RgA|tImttDkV2TLbAMp1;@(zhVPjYqco<%l{CJ3aZ
z4+rUp#Hu?HXx(L56bh=PCd#p*$T~HGAM5?JMVf;m=ZOtP^dOWsUAw?T_Ob$%jG5__
z<{$*T{-x8mlt#^ao3huzqrMdADo!&KT>Qy4z+5w5m}i~^2W?1FW*QcBU^}dRtfyD7
zm*4T(e`nUg9p3&CcA-YFQV_GVBo8vHn|p`7&@XqyjNPq6(;_%j`qR1s*6w?wp3lZ4
zUo?XGc^9m^1AH1ag5NmM91%+QhlTQnER%TE4@l3<FFB3+(+(41)o-~L!1yhvWb$x`
z{H20<_qOP80TM>(jZA-RirqR$W>!M<)c3L24ss&fPl&}Ui1C+oh|R0uOkspPEut5H
z+n;CdKWzhMVkMJHBWl4X>qTW%Y$j|ejp9>_R56FgL@}+xLE3-jjKq3U<k!c~83}5V
z)aYOrJW$?VEQxx1@pyX$&S&;m$<^|&z=jO=J|klFin6Et83a+d=9hG7nSed!i6Ezk
z0=Z)Y?Xd_MkM26kdzOLALdn0gt4~D1$|ECTQ14Sdjyic>vncVH-gt=L<sX#gs(b+T
z$5&sWzC8Ky;_NLqoU43Iw=@l{Jdet}%I`;$W1(zuh*dmZ;+giduj)x<Dumvyv!rd<
z*5nNFdyfE4$0vneoZuA6zy~q>tYZ4SV%jlv@C`@EoE?KQB&{8Ldk>p`Z}&RQV3)Nw
z+cflnEy&3NO2i?wq)QYtskW^MlWT#WE6K;P9K{uRyKw=*zW9VWjbgIe!hyQ`E~*tB
zb6CodIiYWtlbVjBsP-A6uok;8Zim|+rDAykKzEnF?4u@A!=r*;W%P=P@EL;_x3kJ1
zzT_&GuUc7rvm;|nB^QM=NvG!4L`FGismBgZx9u;MeAk<n%GaLf>$C_BQ)g=MEQUQX
zkhEMoX}ZgG92u#^YD0wn;HH(7pPV8s5!4&*__GEUkgCZ{+lE{r;F&Fe$FcT4;{-B`
z&;(*2y<x3$8i#!nNrgzH`UG$&V};_yL#Q?HNqhtdQLxV+_KXP<i9n<H7~q4jeUO1=
z%7ts-%>G;?%P4?S0>iudE0V-D#IpyIX}}a}05Yya6MeGQm@L(UVi-id^S=xW)jwhH
z#6<4CHk<%$j85KXbpnEa;3w#=kWT^d&^*<|%7dbcmaKsc;qAl>tZYS+Tq?>%g5^8B
z&DvOBHjiw5Pc*lE2hb>NX8297*?vyCIDICpg70-mIW7D)7o1X)>mt}|xY_Da%|rgH
zl6pYkfNOfD!=!y8lTm>gcg_@en;tt=AwAdUnEFef8<>GS7HNuTM5fh)(?mSU+~Cg>
z3Stn=s@<ccPa-G)zDVvYw4UGIqvMR#5>+joW{tcdya9?Ii%-}VqP531i^Hp%Ya03s
z0_O-5GLyAwm*ogkGE*BOb8d@qw_?z!NsDeMf`a!M4pK%8lsM($$_OZj+BIFy-Vz)I
zjOYBP*(YWy`FDhF=O<u*fkk>()HH(nySZTVIhJNp_q^_+HhV{9pB;Ms)8k%0pykat
zPPR49!kfi`x%H<!q3by^zcw?X&oPSBgzMMel%sur&1z^GtM;>`%C#f|1JTmRjDrL*
zr|&87XyZVAR-wecQoa{lIin>jpZj)|pla6@uDv`O<hzfWAPoxV!2k)-iwoBmC%Y^s
z#H!cT0{h3fC@SNnA~<mirlIhCQh&mtCB4Lid_n%;2S>>+DdFOMmV)(EFH{IGG+v;Q
zMFBf6RrL;uX}^edyK|OONqN3O;PmGCXm4H|CA5TsjGY#MbuT^3hJ(jTq@crD>~T4t
zJyYI_$qpd4ymT!H1~M?xgKKM1CB%->=}@SOKR}B#CR9<Wh!$bQYT_47^Kf5TXt9)E
zTs1~!89<{Np7_T?mzKWDN^y=sJ|*l`oV8<0A&9R(<L?c^(!bwws#Dw281oKVuaAbs
zGDYqdUL_N+CP7~V`JV>r!OJ+8@GjxlSH3MPAEKMR*UOibTm<=-y$#LzwN$y$f{%df
z#Pw^uF?lniKTb(J(%x8DJsX;hguNA&=)66}yOW1%qbsckenFnPA^r;h2mKxB%G&_)
z!T|EV07dhsS{#wZNyQMky%T5bqttj;q?86HBk~LUxCXTmOP++O-UP&f#&kFS<#TU3
zJ70V2qrJ?-<<_b_BUC8hfEB^e!-zbL7G0SOD(&J9jcu(F0sn@Lu^0|rUk@A@=;7bo
zdurA+<)JiX%<;_nb0Bq8YQL&c8g3=7QzF8G!jP(nW~C(+_yS6QJ<IaKP%Q#_&5d(q
zh`MBix@3nXz=-sfjjAO>xfUh^JykV8-nHIC*|5Gi5K#OxnH{6m{1{H=&q==a#2b<6
zqd>qD6J66+goAf!Ps)Z*B#d|IfX?P2ICygSgVYPIXwee_bhK5uN><k5omG5>)La=9
zWXl3zSD3`N232{nQjs06pD(I+kVYZ(g|%1_OC6(j<XDDO3B#1fiJ4<CUn)8g_dKDf
zm$|x(;;NFPmVOe-8#ussPbH~Vepfz=cUFdNy)BLjlG)S?x9?{(>kdw(nh=g>Ajtp2
zqW~>4fyO`q_Nzs;Kp2s2L8fR-RhB~5p<;*D1aUJ0JgrPVx#(<sqE)kC6}R9I;(e05
zx0O2r`uEyMDTUGrRjW~(UKE@Suubpy$AFHH6?sB6=G>jA(3vQMl4VH9Pike0!j?7O
zkPHhF4TcaB#s55$M?HHz<!<7rKulo$<jV*nk!Xq}_|1ouB8lcpdUl6;`1EWzYYw}V
z(k-?hhORx0<EW_6I}XwHoZw(UJh|NmH9L0crl!WqCyo{l+b3Pste9&Wmq)eL#d&9_
z8xuzj(zimudtgTma9K^n8UL|{crj4vcv&T1jI_p|XGaMsWmigbmu`kHl|St^9-CCD
z%VxbNJxD@XpRj4BP1=jpWP3@1Y_l~F3(iAxWrvrKmb%Ui{Jh32{yAx|PPtp+L|>pa
zhYU}T_?V1)ei$9yxJ-m>ozG|}`@0D5_?p!cA?FDvxgP0kfNl|oeM7ral_m)@@QB4S
zdu|>LGW5P)VJ6|UqR;+^&>}uteTU#{WN-}|T?T^$OFcf5%{#QTGnZqBS1E!Ebn>zS
z>x|kfY*Zp?$14^wAYypS8th^Wrd!gb_(LQMyU#B0fi31b<2pN9@LAR!Z;tGpf>-Gd
zhB5xmd&ba%KUQGci+hW*sm|W!$J#3Dn==Qx+xElg+{!)yJJq?Z8@r8zzRJ&P3J@Ff
z`Q^uOInF}*zMx+q4Fc}qA@99-5GzC_%;7EpWW!jZj+Nl;oU&;9V9|Qsc|>*$6BSX{
zx#DfbMk~EKWF#(%?v$azUTG(|fvyaPce_STdOE<P!NIz_-Cerx?s!LwMm83fSsGSK
zc)hozwaz5@x;89GJC**f?r8Gh8S1Ys$RCU#2S3MBN<WLK^z)&HAK2&5tx8oBxr!Jt
zs9nmK&s@kD5uJQ~E4`sL@K&ac(dWORNjm$XY7io<>Z9q}##plh|5e3v)vK~dG--Xq
z_3s$#b}`n`z#p@d2i{@eASF(M<=n@q10J({%Ll&^ma=oFKWC$x$2S1bvvVjV%FD_=
zEKLO`6c!A_!K_fU4C?Sk5QZ6V{s?Fg@L$c6?^~e}L(y{00frbiIr?I4v)f-us9!aS
z&wfQAU+RvZ`Z!Zxv@V}#BQ|Dl4;L-{^bb@6cj`7rr!XK~@Z+v38KJe-!#p>|wbn;F
z%^)MH8cqG;%ei~56Or?I6@f`H&fP&%kpy+$!Jpk_kU-8IhSHO|z<u~nUdgD~;Rww`
zSuXq!MwSuJb9+sAn2us!b~JiVxAKZr0hR!^p(ub^NvZe-H2?S<VzNbpa=JK=7<*en
zsUm-LHAnHx!VG<8>A#913upE=LJ-bh8$H_ugC{QRUQ%eF)rD3f;?%*08BQ0c+rA7r
zR!g<5u85QD$h3Q&TkPJ|pgkwWQy|AYhnqL-R9b!EHHv%Q+8NGn^eN9)@&*JgYC6!>
zNlO7%FWmMvmuEeVv)uMoEl4`>XM&>I9_%ehjG!yOEm!FEu)+cSY1K~A6{UA)Dnwp~
zbvX`7Uw>(_I?HkbXqYQ&av)D8$<EHqE@uTR89@RbR1*^(TsqnGYt;EN4~zK!Xh`Py
zl(s)BxXt9%KOgE=6GpFY7HLUf={IT-xHJBj@15K(#tGm5m*s}-(}xL$u9U=ni2d~~
zzWra;V#*Z3?xdxd6F|R}`GTouN*_66XjI5VX?Jj=loh*DYi9nAj@R7wFyz*b^bxMq
zzLByL4cnGM<t4TLh2Wao(T`VXwf}2dTn>E_PxNaX5xdr4&3v;I?jGZTVw&?l@s5Ih
zkn^Bp6p@@VV<zJn!?6?%fYT}Ik}Sui$p{YA3%z!Q3h#Q#VA`>W9)lTQkTnPti?=4s
z+bk@;A)V*5Rru9wf{ct1#Lc|75wx@iARxFDD%=QBN$l#}<#(_<kMU&GS9`i8V6WJW
zR=-Lv2wbiZcZAGi=Slm;!xfotWnKF}PXMt54_?e?%pra4_eA=<QU%2lVP(xBT1_o{
z*gWfq`u+Q^$dsQh(xD_Qi_Wx~sAYvzno?v*3cn>Ki_vM)Q%8fDE<2sBeE4&&UU;Wo
zzRnyDRC>3?j<#wh^r?#U>@r)N?=Nt2W|U51pv}B*MS_}D@t?_$2Vc`UeQXQ))eER!
zJlCUsrE@f8C*kW(xY`V=iYPPtR%+33PukPnY8Q*Aw#+SY(08i7xyzom)q8cFhD&(2
zIeBO$R-8O3_p@gk{j|aB;~eAR7)%~us@YJwZA5K{;><7}<ZC(0?!=h&vB0CXEm|eH
z=gOdcqt3u{z4iB3#WVe+D=x_~B>S8%%T?mODm{#`ddnI28p}#nhkN)n6HlmDyD#Mx
z?Nn;@Y2dMLf`RxL-gV}-#@|u+;w;I!^m<mYPMt>7{3d($nDNMIQ0jDCdoY0)c@#^x
zJ8ttYDM6cdwGut|lo;rwLrarPa>|fgxA487KU(%tG#7tkjrKyeW`g!I%~QTXssGSn
zr7`E(S9x&5a~UaDG3>i&lhSr|h{?DIpZToc-q}vLV1*k^8(zNN!l|-)SXswS>pO47
z^oyb1q>oE9WaWIbDeppU^9T}r0vE2_cE@v~$ni=!5Ve7Sk~8t&6qE#FdCOAsq#Uj9
z9l2k?iof4lrttTMf>0y!i_d|NY%I`Q*5@Zwrnu(^JYxsWyj^L^48xg5#@tQ0ZCi4i
z(k1|0ah0GfW&spDFW@Pg$W8mG=~P$jQRf6CtuzWQClZsJ>+Py0VUx{QA6Uu0@+#?+
z0@#=fg}A#kHEXvqW6LIA|DfJJbZl(pcfxCZUudvgKWP1{CE4X--67;hYzN6GlmB(u
z{$g5SqZyBOTKScJ<_wqt79~e7^!uEUO3&dQac`z(*`_d4(jF~sU0@>fh~;3wr;)xo
z)KsRlwoT(tM(w5j%xRzh(-r<OilavD6XAe=NU70E)6&wkHK$@1>%mn&_`4gZbsDqa
z)_iO6uUL64OsC*Y+PaM8b~|Vy|MoD=5B;cm0WP5nP^6YerLNIx{yA1JOT$A7wy627
z-RVcS^VL>vkcLt-v{Blq)mkeN_;lJ;Z|1w>yjelowjp8MC*s2CkdhAE_raUZz~gbw
zsQzuL1*99z(qs{{l-{jNEVu8f4fz6NxFM`xBzwu6Z^&gAyA?^xb{%!OGXdB#S`qfX
zuI^cyy3DGR=epcwEW|sy+Uzr3We)d-P1)$U%EI``lT5rZJ~|V;pEQ@m*daF&y>$Mh
zz!6`9iPeOJyX1JR+JDdvPW%&+2zoVDNKFt)|5-;5W!Hz5L+_JA-Yvk~f8kj5S^J?j
z7(-}lanoGqc*K{bgt^YaCCO0Y6g!c&wOaD{R~#LI00Gsy)b95<p+~dxZYPk^j@n{y
z8+!D%gIi2~&%sMxad4BkQ?s*duqagC#?zBmY3`RP6q_%a_Xv)qZ#}C^c*;X>r(<RB
zx12@p!fM-5mtA%r38g^4G7e2P-l^Gv?=gCg`{V2Ujj!8NM<mf9;TcEG@dSUS`MN@D
zw7%8oj(w$h^RF;c$AG(T7~PEh_3km}ra+u}RbX%$3u`Da-o|7Rn9ao`aX6rpinlhY
z#^Q50*pY^OXZ%U$534~8Zwg75k!8$vPWJ}1)Sx&ss9C8wN3=4fKPP*mY@aCCfUq)%
zU8d(45ndK@4Q~Y4FOHP2NIYgX)~PM_d#?CkLiG{D?J_|Q2*Q~NVipP!n)b*jK>Se%
zSjmOE6GX)HhoS@XAFM@h*n!r7^~^<vx+cXAU{3ABtp$OQUWR!z0H53jv#ka9HlTb4
z>t)yu5P%^@0W%;9?lFW3B1HioCPvC9M%^U=jVFdw+JP_;LfY^17zv89hrP`MsqRsw
z3jW!GG-wY#mWyvI1gX+TP#OTO0R3<cLnuPZCdA4cfawm(m`Bi-i`CVG;;4Wvrhq{1
zKqDsvo7jKC32#<_Yq@Qt6F9C&gg65eJ%hir<JllcyB^MA9+fc-nl(+(TtMlW_v>|+
zVV{KP!yXyRfEbPm=E;!ha#(@a|Eos?J9Gy-KoL7yf*H#A2773S5j!>_HL%PbOx_6B
z)PTZtM-w=t(-A4=P5@tvYjq8(*CXvtC|!#%UI%toONe*<gJT!Xy4UO(m*<Aw)$o^Z
zAOHFA)Bp(yD#Z`fB5E?BzXNs9UN_*ry`cC50@t)iJ2}sY64yL2J5;iyT<JoQg`#7H
z!T<|~vKjB$!jOh={|3ph<T*GkNzVat@YjETM}vVQiHp<RTJpb>8v;1u*;i&vSA~)G
zg{$|)2^)fVM>D)fQrsIdz<vt`pv#ar`}ZBggv?E$i_M^m)H(m%rOHO7`WH_X5;F(O
zEonxT#X=o5IpZ-_0G}wIQs!T+M1nEn(k4W%BK7M8Q&oXn^&bOL0`{hedV>UcCTPhv
z8|#tAsWs9)Cd6ql)S3GmWbpf&`NiCV!&Y6&vmUqJCjZ*gZIJW(i<jH%r67SF=+-df
zZ%T#j7dMxu71HZ9!a}}Qib3b)D}fWbVRO_SNitPR6D~rEuLpILU4b9*+rb}SZ*HPo
zmiQ!^BrzBI3ew;Z=-;z73<zZbpN3z;HHQu-3<yvS9)#d~^pB&psf{z^A0rD}#{Yx$
z?F}8B{xBH*F|@Hx)3sY0`w>bibt`dBc2sD7<*C>}<(Zx^u$q=PGC$c%J-vwm3D@vT
zj6`8}6_f5Cm?XJF#%HtMeVB_R^(4O}Bi$8{!EF;q3fZhk;PZtsLBh=M?dt05dN0S<
z`YWB!^M1pRkPr9sb$#jVOqOR2(`Aq7sRmH5_1ZhGIHQ)4AXcY06*agqGpk=CC1Ba)
z>(E3r^&V!ErQ((YeDpob!5@lpsk3@lT<)N<i(fma(|?O*T(e7WqDmQT<JQ^a&A3uK
zJFr%!JGI1Q;BQ^QcyLr(D0vgo@X>0p=}f=U^3!-XAX@NMTo_mGMk?oNEwE*?{0MVx
zpl+J5Z?~FyvNFA}ZGYVRd>HL@>AXGrlc2J;KatV9;BoHLfi?ffPv_0`@a)w@mp;-}
zHOVY2o;@m`w-q))Oj9iuZwqTCWummo?bBR<9~SQQMIp7(?!$0&rT5e{oAD$6GK%#L
z-Ee&?tmLiz2hDUCx7OQjaVOsjx|^?SC+*bO=}zF?S@|Y<C$OAfD<op!{bcs-!rDQ5
zzSnZ~=FM~AHO{2HV*I1;=CiT0s^Y2S$+zwpOfS>9V8z>wwK__5FXzFuyS}@BO88g|
z>&`xQs=aM$wH(<IRSJN$_AUCi`R)v`OuzPPqA~lWsxgmw*LbxFLGq%?x|Zbj=b_6R
zh93uO?c&w<xZ-RtP7llSo>rgXDZOvoY$Lbo(tAY{`Q^!>-6(r_b56I_kB8w6#0N>>
zr9&tVp#Jg>xSA{4;%!;?otWwB+wwih`P&8;TeGA(Ls&Dmxb^(1d4Z?jeYexKVRyLT
z`CMH(^>#}H#=nWTkrZaAKCn}7Nkp^b`&s53W|Ral(tqp<HbXu$#R?+&X@wfC%a&|j
z8FU5Jjn~=zaIkFGbm7DHhcd_3ZeOP0h7H$jhLh<1kXOm!UuCti7b+eDhspJLZ&dGr
zxt`huC%T^l4?;n2ch^UUsba{~kZAn)c<<J*lOKRaA}ar;pV*~?`tpe1TNKOpVG?=m
zm48#)xZj90I@-e8<lhd15$R;_AQxvuG-qj4P}_eMH^c;~h!G?zZJb8H034YbF^4-^
z#>qBT&=v)w9zvJAUKf6coSr_pU3I8>P5)L##r`QvD_o5ov|U28`Y5t`KS<6V;j%1y
zdRVW$-a@|z0Lkyc{F4NGe4(9;sid6e9tnITv=>j}FIp0(Vg%X(r(!gksvEur|M$7$
zC;7kbG;-Q|T2?w%(d6dI9X@z#FWW@_Eb5S=tgLT7F|X{tE3>4bh(cQ(oo0RpIb6!P
zA<$Xp>#OCzB83hZbDW!On?|@+nL~Iodsg+FdvutYgC}OU2b3&PgJur<bV$jAmH<vi
zLW#*e1CI_DLc6SC?W3DTk54kFX~;@gI%sJFoJ#aXbTug2?<bXI&`0VArz)$4CQ67U
z+Itxt1YGK_|H1;~Ta-hZ=GpD$H-3t2^PA?m<&RdV+Y8=8#8bxc3iaZ{9TJb^8ORyt
z86eFN<nxHSg){u0^jkkyELV)VBr`}Z<bNqh?*C7ifF0URc4-NpH~e<uvF}6^QaaD~
zbvu(LtVvUl-(|5K*nvJMnMWED!$#y{qko<*3`ECB7asnuPD>F=z*_9bixt>I%BfXk
z6|>HbIQ5gR1y!IF(=tOA0R0XJocFPVw$Tu*^EA@(Z4VQtIdR!SdQcuX`v;}!NETd$
z|1~&VQb`3WT>0P$m%B#T3gA-^$wB0`=*hiOhO!bHl5o`sn4+=_2C{w3cFK)}a>rn(
zy5?_>CCwiJNXjU%D%`oVph-xj&VohYGz1DK_`#r=lPlX8=l4|JS|ZR0l%fG?NI>U2
zqII)Q0V4xA8h;sR6K)|fh+asHAHNmn1r@=?oCQ}v$B-0UduqYm33|>z^q{Y~=Vm&z
zHv5x&VMn(6z{JIi4XUK`NX7P5VxK7Yq4Z1;nz(Bhio)S5x&7y573azbF82B&1bd3W
z8FWJh|GO34Q0D-#6p{&q14ulA<>MZ4Xb$e$nSf{{YiEN3a6HK9JbzcPRakS%+$?9&
ziZQ5a1hvd?fAc_Fd4CqrF|yqA>#F&3omb>kVKu=tkUwCFu&?Yw-4waeoO)rwJ%r!z
zcnRYAM~?&u5vce71uZ|e#r^SS*jhURNxgWHkASmFkl7qYSd?E&(W0{P6JSW9;6@M=
zSs=_{rN2+J87i7Cx@1;g2g@~#QAhKm(Bj0W=U{)65=ZC$`488_wvZk#LTsdiaDr{a
z_>+Rf{6E0}OzuzfIx-1}1`W7vD*pnI7%<LnfJ*~ug<h#RE!K;cWgt&18h`>Rj1Hsd
zEE4%CG4oZLaQ8_YyP_^n1{sFFuNWsGMEF1YKfq^+e@#IE58Nfy?*fA;8e78O1?EoZ
z>x%Xgy#!(z1)N?qav71u5;ONy+Xd#H-=D1&pIN6GDKNK1$5+ZE!Pr*J6`z@>QYa9N
z24jc&4=58%EiLRK@r#Ou70l6TGHweRD2TJB0PC=GXJo?G7ElRAp{&ts6??=3u*3uk
zjt$WHqQDr_ou)XM!L1Q$nYRc1vHDLYK=AsP^q}ssr;P<;^Xiy$hy4lvXYLuYzi0Wc
z*FQ7<jcSLd!Eu(24PpcMLMMj=vC(+wEBa%7u1PURjE@}<@LB9fdPu-M5GtAR^AVhx
zrw4&qE{H=*=WO0?e+;4m=%LcF&5gFh0*FF~1_jYX_Kf};3?+^Kp9L2STmk{Vj+&HM
zfQ<pF5c|6?j}RRdKn~@JeQap1ig3@=Km(PmvDNa93<C1?^*06HTV?QJn6*_pRnu{w
z!cEd0(4zQ=%V4_<k`X*S!N5!hCk}3;D${2Q+e_9y0fnJ2mS|a_c3R-Mz)`9(n7<2t
z)~>bn5TZJ-rENj0rER0AO{8k&XNFeaO7ihE753u&l$qvq2ux#jqKpu2E8<}VSg0+~
zY30Zu{08XG;-{cHNU9dJB}AyWSt+Yan>i{>ohyV$r=P_4F<2x^r(eV$wiJd-m*di@
z2J6IIJ;E({V<c_L)KjkfJC|{NXyMigP-!WyF2$Wt(k`c5n4eu;O_ajpYOSDMNaW?)
z$im4#)69`Gm2zymY;xf>Q<m^59!^nyD&)>k+K?@2a+b%H8$Gs`bS@EZ_gq603)&|n
zTva@uZK%;&N&rp($~!B{{1)~?l}-BzSasx0?+t9EpI#+JzV(~RSvRtD63)jOO4__d
zyjC1$i2ulQXp=L@7JvLTQM(`<DJF+Dug3w>bIin_0463fkIglq56V@}UYSLbY|gaW
zv>!4t>)Ib#|D8%T+&5I7{+7cQUz#68b9H_WJsD3#EHR0CtbWXXOpd8M$n9x=GiE_j
zL8K{ORFRjjZ=_CmcRc}Zb7leUX3KRei6cj!Ix$9`W^<wBQRW*B(jf>s)ak6Q5J1^t
zYLodVeUhEXen}rjF%vXK#U+>^JF;vzzhW`;(HtYgaCvTv*(!#grW3!WP87Efswz%Y
zx%cPUDY81-M7!SWm>Q_*OcqMlq5p660&3|5B4wYSCbXT=s;b?k%$b321*D#O9EqT*
zfOa8?j-Z-!W0tiN)NY}LgrI8l0|)ms(#!oa;!7-t&#@ophHVIi4-X-W`;4qTs>{%m
zMMU@7jgm=p=}WRN=0I*ImBg5(g{XaX2zj=6LtA<ObhmZ5h3&VQn)dnZW2LlPOLD8P
z>efQy+QOs@K}SXF&l9Oe3a5Zt{iT%rk%a>!lkQM?=Nr&f8AG{+P43cep4PSx=Ycq<
z;6(E86AqqHkCd}~X5Ef1UiAeo@3pJv#fb=ONnAZ#u>?FS9@|oHJoPW%fgx)Iy6_yW
z&UR`PrR9yHchnGD#~j;))NyD%7S|8rvlyC{b^6hC;=L*&H+;N1BG=1hytHpX(}4;Y
zYA$io?8j2Qx`{XoX_mTS@`_$dr}M{6Ch~K{T%nd@<2fHLdV1N}OHWtT9lSY=jErA0
zc|4xJH@$7w5*!wd=|7G)OrFieIUp^;4d0Q%@@HxZqe4G+(yxnW4~>_q%FnXNg+1F0
zzkh&NF$)%;Rg=>VU|C}!vU$!y1b54zIW~zm{?Xvz_}$PVo+(zJ<B=kv=F@W?yxUOn
zS%-6{V@$+}1aap?)9V7;)d8TS(*&p|pJlNw@|}6pHFk^(d`*W=)~+U2*_*U0DO)HR
zSx{Huyg3|}!ThRo_fS~`-j#L6%g^<9oAUy$Q5Q3*Jeh~@Mm2<}v5%MY@2nNBxC=ap
zekybQilmH~?Ds>r8+FmDJm3rM;GgD#u@9FqAsu2fsREcQ1QpTbxxa%u24{i=eyn7*
zF#juCkN#rzk>JK1nQOu=$}`_9=cdmi!CtcpMw~!tU*4MZ*WX$I25m1c;~wLg@8h|o
z*ZJ9l1U+$Dh#td7_;h-4^>so?{BjG)yP|LWP{IGH`#Y<EehV*39I;zXPAuI`COERT
zT?;`pGrCTymTCTP@QUH)uXaTz4q{63SJO_p@ugE<t*?eImgr`2%oD`N&r<NXsD}xT
z!<je?@K*(AV!7ycL^D<}dLgzhJr=g^<_0EtiAvCR{;Aqd<Hmm^-L_|%(i7TRna~-`
zlbFjg{<4ycNtPs61HxH0yowVwTs$b7Exu@1qSmQM2}(yZU5HI*E(JaEpd`cG?c0A)
zJN`z+<(z3(<WoZ(g%>AsgqhdNCg7TP#O?j?%gro?=t!uG1gQ`4K{Cv_7)oavTHT~(
zn>j0i6_(pJf#h`sn*B=V@~Y1(bg?eI$U41Aa*#9yu>G_4b84ah=bc@oIWu}m2gD*;
zvd1b)Dyw7rwkrYnlCVxmBu+Ke@s?GC-0FvUih#eit!D+jp|MVV*RDD1sdzdxV?E<s
z5)<6YcSd85Ok_3%_}l#4Z@$>QBS{hEvIF*C-V%;#3hSs?xfWKMf1}+RNW8`Y{q;u#
zbL6%AFOw`{@L6Yx>iLFX1XO=6{E4CK?Xh_F2){tYZNjYWEN)^mf%hmSm7Y<L`3~XZ
zbo_xR3`M|&=?U)%hz!(X$0g#}JOA-%S}-y#5_j8D{+=F?isZD<`8Oxv=D^i=855L8
zz;r3>Zy;1U{l2qAjKtH<aZ|Z@8;4s+@tiY1Mp&46XdJ78SSTrFCVO8FM{PQa8u*vD
ze}fIKCq)c`jbL^Coktvf_hD9A2Bkh;fW`K^JzpX6+!_{yt21gKjIj=6B-YXRzXXZX
zjB$(NL&Vh&RUR|}d@iw5Z6=2E-vTm+#KTFRt5XM67<d0}y-2ayUCO#dMl@r1v4hJ0
zHLZl?g<cf-#@fl^OgNbI%n8ms)?4=iHMLFg_<0QGE2o83f_DEZBsE9=6c+a^8-k8i
z%!%1k2r^kRC(-ld@<m_k>WZwWN3?+t3_Y{7W|)tmyL-0K^TNsDt<FvN#2bv-IM_z|
zmnR`2tY)lN>Mfr0IL&V(8@7YySWQ|&a_gb7+2NR8;c+BkUhM$R&&~GB0Lz%jes5>-
zj#Rn#-)l9@%8H#5*9t9yc2(Hl3@br7q<?5%BDQ!xOF~EZz6!cWkqpERfBVQY(oYMg
zIQWR02Pj5KqofN`X~DwoSp7)9Dto{NWwJNk{tA*3Y<_cHzZM4+F?WB3&UMuJPJr=;
zbHoF%D_!;tM-GMOh1i6dP2jMa>4upZEM=@&QP=tcZ0fF?hL$<1>WF2xFj3Wgs)n#!
zFzB`N*wI%Jy-)TC;Zs%ur1%ZIxi}qPe}8q+Xsx?hW8T%3A<qbtU_Ivi6O8V)RGI&g
zqL>xu;z>2|#6koaYx-v7s)^lNPYcdTsfhnZ%9L9Z2|mcNs5lifW>L2zhOB?4sciS*
zyEZ1cg=4%X))K3j=8(y(!qd%godlP-qFPV@U#kbdw94E>X>G;41`QBjYagjS!$WmV
z;{dA=zZvw%19ufKA~i#>Qfb|S0x*0lpo~gz-`dMLYK;_p>qyo$G0z>3pipu-W!u^f
zk&-E3!G~SQARG<yPaTin$4hb7GpCPORpuAb;^H~;WcgGL^kHMvqP3v)`#g!Nj1<j4
z5TZFdlVUEf$9))_Z=tSfm|KmXV=rn3#Nh$lMr4o(^)uW4B#CF$(ABc{mi4Ps0K4jb
z>cJ;BFtsO}lEgAt%dJI#cQ`f%1G>&Xy6Rz>p-^`v_cPfz>ro@Z_ma6o?f5n)#NItP
z7ykjK>#zx;-GgtUcM1+-GAFjs(Bn9iQasyhGLtPf$y?5^|7u6T8{i1k@833dWu9_M
zOa_z`T{jqgh2RMJZ><ign_&1>&AT1D5OxHgW+3+a@R&{w-^5ggh867WXoJ^f9*^J-
zC=4)XGNFjDQt*=C^+&uJ8!Sl1WWpmOUe`MI^pD15LL(1ebXE3_TKU9e=ICZiOz~s>
zNg&1QImb?AM^0_zjL*rB@C76{@^9n}@2ovo(3Psa76nkNbFsj!i7!*sQ!)%vUM8Y6
z!mX^j?Y`s6t*_4VDOx@;6tHg|%pdY0*+6R1S3MHSOOhnC<!o79cY$siOYi88EX3%v
zsHC)bui<Mpt8D$;$CV%iUBD(;V`lYDf@yW_NhYnh0`P@U4iD&Zo<^0<d7-+%tQaoY
z9ok%pet_wcNa2)vOE8??B|3UUK6yy-I5H=<pq3o3JrlBP-$`K+&{noCX|ua&EyQZ7
zGHU-5&~Q>|W&aiw{5e){T85)m#Jvtz5y!5qs)1oyjG<(Buc{SRp}B3{z_o~gQAelx
zM^=3y&Z^Rp9V^p}p!iU`Sjzx139)rCy*Pg{uY8hQls?qEP_;Ow9?UYrrB(~>#oVgg
zviAKH+bWWKF})JEO41VNe!ME;l+!+hU5LOgT79d2s0^*L?o{+xu3l<EszNmD@0RQ$
z_5wna27luii%K7jT9w*ADXlgwn`kwgMIlSX*EM=2t14laP<E-T2(HQcj#F#tGAFvS
zF5_qwyh<>aYIb3p2HsO%Y2_pBms2q5(ktV0F>|Z}-M~li2I-mVrrSi3tx~I#tyAt-
zt&iX?rOx}JRpBqCrGhW<S7Do?sRh|*A6B2@rkRpcwbznYoDUJ368U+X`?|IuekHeA
zeiy6{-3<{xWu6le7e=4l%YyFmH^V354>3N`s|tzZsZ&KydA<nuoP4(h)&_Mx>8sMC
zWBF6a@7VDFK671X2p?EFtMrPtDwdAjPF*~uJ7v37uQV1c89U21i?&Li48A}+^Y{yw
z7Wn^ugzG8i%-TNS`1%Fl`$*Q5+f|0ANz|l*(Fxw=M~l-6-{r{`=w}FduCP_59U7`N
zYTBx%&RL{b%t)Jt>#@-?nNqCMdG`LDzH?XNH&dId0eak5a^++*8`tWFyOQzQ5Q@mB
z4bLW+lJXfEP05}&M|`lW=d<TEPVXJk&{{XmGER{3nN|;7v71|+DBhvJhO9`&rt03;
zrsanLZLd{4r+K3ZndD2}CLZFZ^4@?>Cr5|kZA-j4uIU-agm++`Ywv`I-Km!xjCt+A
z@e{c_ng*-d!?SM(1B<W~X}8p+xr;-!kzaE*hxFSVtG2c!Icd#%PXx{t9+Wn$SA$n?
z$C!79Z7bfvzLxxQztZHV)$SzQX1w9<c)|H4ex**$Jsd_g46ciH9**Cm-LWrs3JGv*
z6`lc`uiu`Wt6HJoNp+38L}FeTbZxp~Qw98EyM?~o+Q!zy*nQz%;9vi}kn39bim9jS
z&mA0gpG>yoHt!L#Nu~^9d@x-WP22<>&vHJ}>-`P&iAtG9-Ys&L^rq9rCz8M#9G-jH
zLp%1miEuXbM%6{hLHOvsW}Zk#|20!wFp+yTB+@{w2l`>nEkKxex2t-sDuTDidFHUD
zbc3CRS5ts^Lwd|}<H=1)SOVCKGW0^v!qAWWgyLrH`a2oUSn_bQcYOa0$4&3cYb~Fv
zyhoY$Wuk>;SDgK9IX19X%F`9P2)m*im#uQ26o+$oB>c$q1lJn#k{nmUqK|pYb~q=T
zJ?X78@*vYOH)UXpb}M5lJOW4^hWFsO`%N-sxU2d=K#`4)m+BP4o1#g*FMeo3GG&|$
z=fPj<N3~CJ2rlf4l{g;U;eU`2+!4p6KXS!v75vVRHuVve3JC5<jS%o<Fx)l112@f!
zO9?F4LUH_7^d|8e>ChY*PgRHU-~uR*(57Ap>x~XP9ZCQTLOLQXU_IE~rv-wYQ|;h9
z5brQZYX0!k?z;fbg5R0%q)7bw2KE}8iEVZQ>OuxRNove~68vI1g7qLpGqn3dNU<*q
z6bX5!cB+i~#hMh??0=sYx0ZSZ=RtdCL*h5&Ejw}nObPCYe#wk$X7!`lCjjb^xG~jW
z-pU<{lUy0?QoH>ENRN1>E>~yC47f3(-MnW;xL+E_VBPxGqWrl7xq~MmGWk><3F}eZ
z?x(x@ar=W}>=;WXajM|E7z1<QU!)H=g!w1e8TQd+DxV}Nx{l<TCE#D!-adYhn5AOD
zz0loxllTpa>g5<$qu+WQDv{_LFreIunbyU9hq1PvVmPE1?gHvC?AN3%!N0(jR-@jk
z9zqIVnr0L4TLHy{yCy|fI(tP|K0+<vUMSE!Ug**8ItC9sBjdV_n_yqO4kLuSCPa0-
zQlE`?k!7CWNC8?S0?c(^S4<_attmJtx4INDgI+Q<aefTH{hk}+uE2BPUa+>&NWS25
zAp}6;#*jhrf!(0LkGBHwLe`-T-UPrHux^dFf077*#*O=d{5}u}a0+=x=hPmV@=uJ*
z0j~&t2jkQn@dIrX_Jt*WtN{uBWJkfg-2y?qMPyQixbv6%Nd-6CyulFo(j)e>6g2wh
zF(|I6Jw&Z21ib&?Pfk=SOd(jRA1eM55S@@G(p^7#6?=|;YG}k=;*$qL{QkiUgG~}x
z5a9h|9)4DusUGH83L+|iQ540mnC?Xd!l#GwCnwZ0WgvNv-~Sv=DpSq8RmGZzRz&R|
zOKbj>hRI#$o?~+eBOOeepoYuD<vne3B_ak)TM<)9*#!pOPkRlAM#6*>2mXvChMD!M
zTY5V;N!@wB^y=P_2TYFn$!kvmwG!}>(MEC@s<q^V*iz_9P}1*`m9Zx@$EgDk8xGLL
zoMs&(^H$8b24~LeGEvR>>oeWi+UZKj(%tBfaM*b0DZ@=O4ibd{D~{g+5SxzKA_<0E
zMKkwx_|USy#w7*kmL0Pt=6W1aXXXK!Eapn|!(s_WTz_Wf8#1w`Rhly$&C509JlLi*
z<xtZp=_!K`9mdQ24;9DD!iSnNrOa=&<PP3XF7d}<3vi6MRHqRdGRw_hwdB~@bm>aC
zasMiia`3ro$`EHa#R@6Ms8#eEk$JTG(!pv>M#ayMYx}$YZq7_!*j=CR*(Gb{xHw*v
za!|f(8*L~WrwgkCIK0de^`pkGDE=v`-54t$<e;tK(9W+^QKO~sJ2$4MJ0h2afI1Ea
zJtb@7jk#TRw6++@k$MNFa*prd$|e-@PfrS-F(3}@%QIrCuR7`_7lL-^ZdaLg2*-bW
zAcZvZA8wGvNw&8}Tevm<usP!><kPYC0#6oP@W$Ph7GK*{uLEnQD^Z-Bx_t8En0#5e
z_?)7sqvJ~w7tWjCH;5~GxE(Hx)sRz`#5DwFV*@lDsVK-Kjnf(BWrj#!jHFFX23&!_
zl}$Yy<}&6yg-aE9!N3V}i@+(*Jpg8e?KtOZR*~3zhn5jlcg1{a2ePlrl%tm9EV}+f
zuX+{Q28Tlfz4TdLmt{e7Wfj?kphxa1dE13k>1Cv4O&L-=8}tH}%CKm&GXBLdsw;JQ
zLNT}WESL&+DZ}zCKPYO(?xXGb<Ld4s{*icc8=ra4h1^^F22_hKeF?2JZT0K%&}<|%
zniXw1kdUq_oQ0IGs+Ps8zCn2Gd~g<y2JlN7o(d3~9Y-lCEn^NsF^`3Yi*gKO_$co%
zmpA5{JSShlqH9$r0AQqc^1q}MiB~(O1ph!lXb(bZUJTccGVq?%!)nSDif`EAR1PAy
zfVU^^A;Gp6_D3%XT35Fac*5XbCdk=0ogum8lrgf7%#aLgGd^Z=W3xGp$)8yN*U-un
zh~ySFXX1uUu!Gc?nFo|pOu!jBPangdJjWfw?>)C1!yi4bWszWRuV;~9ZI5ReW@-;)
zVNJ^_1lGNtM;kxFj{(2`%>0QlYpMXMr|OEQ)v)j=rlHwObl7s$NX{bB5=A6+$0SW5
z#ZjJ6xnUAqOcoli<FL(T$ql#7p}dzlXYz!YwkDjoyP<+H&p1-B@MyaHidd0JOGx|3
zXDMN7Z(}K8X)k9fVQ!CPDPe8TXE9^qDFmhg8ESx<K!y_F3U{^L?^(hGU&w@PG}oh_
z)dcx_-0JZ$zB*fpg=jtMpi(Y<_H$DSg{&QD+dkv&N7A#9n@iieamNgQ3xYJ#i$e8E
zYeSL&zvHWW^q`xTy*otXZLj5m-O6rErDq8?C9fG+HxJ_P{oPnPXi+zkJ_TXFN(0o=
z1Joo@K{+6oE$?n{B|ZCiFg6>*mxeM6>Og0;W8*3TnJ&PtyjQKM^RuyU50?6w^}-CY
zlaT7-yow1^fBN|QP&e)lZRVcIOi)(?{|jsoF8d4|gLWK)FhYY8oNXJ)*W3!6<5L3G
zp7wb6>&f6JzC9oP_^#{8K(~||Ut&oCceDPtyc=IKN$w82p7yo#rQ!JdFgK(QFNC)U
zGVtvz_^VA(w;VrtiubDGHhFl<ZZe$QO^64Jd@tgo>~~#7Xdp_CBnwI^ge!`d6K9XT
zw71+*YZ%=TigZg=*K;QMy3(QH!;R4Ri*UTq^E17-Hw4iZeB7#Ymsg786O!)s<`AD#
z6oa$ftk`8V*%P<!xn6<vdWCbDS4grw<DB&q>Sb;e+h(U=O6$>y<C8>NAD@JJo7oA?
z6Li}upU6^6$%)pJSKB0?*it*?3Dgr$+YF!3uhy;EiOXNkQC^w0F5Sgz>&DLQZx|ap
zzLIWj67)w@0IxC}ztQvTvG>T8r?~}Y)2%5XebzVMe6GoJ+p+i172Tv4dO$nX9Rz@f
z_KwHYP3ch5)J^4(+SE<q@Cj&J1DpfemH=6S-|FN<sT<;HW@#H*X-BCWQfUG#?L{n8
ztnDEzj7;sVEQ~DeX)KJ)?PV;CtnCpjHB9YwEHy0c|5$36+w)jzSla_w>}rEE#yUo=
z^MKmG>Js1@&{s3fE$(!W4CfpRfjMva-dW({EhJ7KWFX}Ga8b5$$osJ4B};qt>*c0j
z4Qf|yW)2w+7<=b;5KQa&&nPmH9UtgT{phD(lA*nC3?1EgS48m$VNZPSUu>J-?+*0p
z?fTQE<LfsI>Zb1XX9mGvNhC<tzMt~qj^Z%Xu8G~{3djGv3yJ9un(N4eG`YG@|NNO4
zS2uGo=SGt1q<jBSq$I^8Z?B1RFdLR<V95mT_GJEb854nA9RvG{HH;E<^v?tVS#v#}
z46WZc(e|ceVRxXv^np9_o%$z{4K-mtsp#K9V~xI~^@&~Ny5PDopj$V?_Dfo)dK&VU
zz-8ud7R--J@orZQ1)yQ(D3OB`ogDe7@aJ~yZx+JsVGtt3s9}&UR78G?(F*=&B1sC6
zb?|EkU;_x|x(u&SMwCX>a6N>J)H52LP!_75;1pD!JK~mapk2;DbCF{t@{hug0aoW)
zsx-3Q6BNb3ON_y~S0n0tDgv6w>Ee8*P^w@OxY?bbf(e6j%l}H~J`)-EpXb`1w?TEi
zuLHl^5a*j-__N(0tQibw#&TLDz4K3usVKnr72RRKDem7T{+l*+yc-0q8OW{Jp(1zF
zo0GKfQt3^k_KB~i$0fL1cPpjgAy)Z4tHBr^NNTuvwCN{G|6nvY_;bRvWAyN+_Eog<
z)1#6fw8E|SbrzG+M(rwffiiVLz)mg4Tupzda&w^wi_wZ>7ZUK}KqHVw(%qwzQqq)E
z*p!qeHM-QCBR{^n&;4LM8b+Gs2i^@eN4}JXO2{MypTcw^z+F|6;*Gn4ViesU8bl2_
z3KyhA9KJr3Y|a~Hs{I5+09=EW4!Z|uhL1(k^wprA3;;q1k&24h2r?N1WhHqVioBR?
zg481dqWq(>jq~q^C~jcCvM2%mNDAF2s`RrUePs-Pz<Op6+sEs+OXK?uFeA!WK%)Dh
zPuKv=PFx;@k^e+Kw~Oo!gb-?(m<|`ro7VFJkv#1xD4I+Y<Qm>Tnt6_)wf^+)iECgb
zH$?<eoT?YFgMjbnYH>J6oT}AGIflssYP}_>CVN<Ax{#VINd*O_osr4H{78A)KUF8v
z3QTb|`shk69L+|KdP`%IkUo<%mNg5_#$WZP1||zLBjpMIRLw{${<{dxsIc{bqP6HR
zYf<^`WV9cZ<<Pqe8@n4W^uu1qS}_v$$9(<ySWO;^&b*$I^~+m_oAGo)SNi!+{KtHJ
z-wrazos6DObeGI;`KP6f07fbR5nzgzm5=VV;H?PRxqEo`gM9R{orrjp#rX@PZA$QI
z&#53agepb^eV8IbM$`cz6hG^yI7uMskKP~Q+xDXN*grYZf8YnMAc#Xi&lnr!4nni=
zs7CXRKseXJ9;2X5=TYSL%Ls;L_{T7T5?Fw7k3l#$Yz{M1M5a+h8q1;&r%{=vQN>I}
z@6yK84U2n6N4v8t%7hnC4NX#+1oDf!k5qxU;G+{d8rk?4PQMr->JqCNx2w&B7?JCe
zsgXq-IM->2r-WO#sn8XX51^*gV;a+9&A8XaF`&U8J2K}~qu9+P84>D|lj+iL7FrGH
zw5b8}&Ia(DJ5yzUg=;z&q)PsZz;Ono$~A{uI9H@fHAhf8x2MXug@124rkdYGv^DG}
zI9rTTp3TO~&lHj8luJwV%cdlIw=vMaAn0n{rhO9t-vqO7LU-P`QR3TJ{cX(nHYk1L
z>~F07jqhA6MzM}(;~D3R$n^`QrMon~jS=5QrSEUC{w{yMN#oxnb*A<%7WLEF_?p>o
zX4N-STs_MB;!BnO)+N3&n6oQ@b1`gih}g2Fb{S=?YLBCo+jhaPY%j3YMThBl$)Q)K
zI|lx6(SeIyXU1T29oN>y8PRQh7mrMHZ^<5yT=R^`tb=385N^u|E~DQFzDx6~=Yp?i
z*WKOry0<Fc8p0iHyQy{=$$kzTE7<1dBHsG3mmuC6^qHV1%kYMyrwaKVyMc2vXU+SX
zK(Yy(7xsFi)*X2}=9q9R!K4Iv_s1(ok1~i`$RISxR>b9xs~I<+YZ1v!@MpfB*gm6Q
zJx>K#0PT2P{&0yCXb^eubu`QzkoW6=yf7{NtGQTj`x>(UkEX8xYBOm523nwaaVt>V
z-CctgC%6_Z?(XjH#e;<4UL4wD#UXf+q9H)>;_&Bv-|w5bncMt!pM7pKbC=BB{dT(%
zix9uzjNE9LbE};U(w&n!x4-!|CNWglwYmL}S6ET@RNYyFo%?XW>(T##?`FL8@o>9w
zNHS;F67%8>ig2Q|+U?6RDP7-C);$&leew>+Q+_hhh}KWNZwme8mP4AqK?<%RGBRdd
z0X^`OcP%5#_&6gE{DPFpdB1-Ca7*NI(@WB2piBm3#>MO?T5tamlF9QG!q(eI3u*{r
z9HX4LW7`kpVN<g}m5kdM)J{LX_Bjhs`iCfndgiHLfcQ<4OpJD{O5!$x4i(|~-I=3)
z!JAtHK3}!;2#H$|T?|4Is;>ka2g0KmS<lBY3#uNbF=7NxgdPH-97M`E6iyX)C~AY^
z1^qw*LPPWrf2bKCVu?<8KVpggj%<rQRPg&Y!@$n$ma0<U`JhpHAjTQbz?y{{>Q<Z`
z{YKiZC{+*Zm{O=7!Uje{F+x#1%6Zx225Lz5F5f^6LI_%d8DdeK1be^oMFh^afgjNp
ze`tTq5Ea5SAi~$;85R+u>`uAm6&eyXw28ne7ZIZ3K8t!j(ew5UWgz5-DP?F5Xy6@X
zv>t-|8CMVbnN1hr82P`)kWsS)!%uYb=|>W`sdRz}8%VjF$9t&0yj>%Y>Ax=qW9U1v
z&IF|J{yB#Flm)cXcOFIfl5M>4MctycIMoc51l-($=_DUM7De|X^kAGxE^PPkAZlfC
zoZ%gspZayps3=~1=vrn~&GDU{t=MScTVn;p_)2$81VnS(D9;g^ikTc{mDKcXd$#E%
z)}P1EwVC2}O|gDj3W$QCG<;l#A;TC>zjUnx#5<oCl^gX6bxpELbp)u-P?)l<ABsBz
zD3{QL@M`c~chL$%X^}mVl7Ak){otp?xHYORf~Zim_^O>j6VlRP+)|`|wTSXUN+y_n
z1$15k?pI*w707(Gz-z#FEiYFaNV9$Q@z!fGDRa(1@S;|&E$zS)l9ahvEwByKAy=BY
z<G<*cYDkkSG^4eCG(OBq8cQB~>WDd@F|ny$RR7w)Up{Hj`Nd<gwxBhy@T)*e%Tuec
zLq@Sc%elhiNnCC1^2Cs05!RP;1B06v<O?I6d$z`z_;2Zt$ycPztYcJSb^z1VU3Ksw
zB~%C79uE;OIv*~r$|<YrmC?foj(hD(DsxIIb->jEP#p|=<*@wpQU(<Mg~)u<$b5S#
z)rHbZdkt+MxEdWw5S`B=tD03(8Ly#@3}${yPcN;sSEuL)DyIXLr>3bR(-z0eOJpSm
zvXI|JCIv!B?sWJss%>_)*GH?O)20*TCHRv9bJNtD)70bB)L+w=ugXhQ%S&*Q-a)x9
z{>V#wk(cmF3N#hCsJ7jub>E#I7_I6{R}Z2u?tiA*y}Wrz$JzMxa(nUR<5+)RAek~F
z&h91t?)<w8Qu2={hk=|K?k<=o`$^H6^3uw*)D^g%X@X*7<S4>e6_Nq6AFBsbp&t#u
zlPh)ykftsm+$Ss*4+k8k>Pe2)aPIC&n+AQX+ep>r>{>cfx(UGb|9ONM=N0p_OZu}3
zbrVObzO7;{KHXv(_N9oF&B+&|1_~@+r^5zQ^82q#WX%pyDz)_GOX2^{@@0c3VW+0r
z_c2SaY3Rs|(uRfCL^ynmcET-Ow7G<HaWP+BukyU!<!N2fbA<v4M%;4vV^L>Qff2~>
zIN(jJO(pt7xN)zvcNw%oIu+sfCdf@?Dh**X*yVb7TGUY+1WgHK0jIrF8rOrrBXUSj
zCqe?x#e!}mZ~pL#dTa#ikROwN!sNMM9scR9l-Qp1Wgf9h9<<MzN^cg_(!BWdYAj`c
zB*rkfL#(~0Ek*9LtrZdK_Jeel9Ub?K==)Drj>z1MbPxDQ)FE61XE7zhGa?{M<9g2D
z{Y<b^HO-K;%}rkJ_s44TNssd{DmS9{nl(7@gDUHT%Rp33_foUAhj8xX4XbPEvgySI
zBT@gZg$zJ3sHS)qmZVF?c5iIbn*<Wn4~m6ddR}Kx^lrdq0mTh95g@Aed#+hx7~F~C
zDRn_x&J0{rybU|orQ*1!G3hM?Rp|#s!V<i$wJCx?3kvala(a@JvsFexnXtSr|5}hs
z<GtN%4jg_$(K`jVlryWW84>ocTNsHis;EKz&^rv@ku$5WDgFyv&{Zc4imDHe2I(1y
zt6pVw-RC8ne!2FX)jNcrC--f_EoSwO;1nN%iWf!_rn>G8lKYn6_;O~i5uCsXb&Hwq
z4NaatC~$V%)6KScU3*aUPQdB>lj}ETXI1JX46a_|%K+u*2gSquy8LYwINSZBVRv2r
z;UGr+C&XC{&ufn4;2Ahhyy<Iv2eA2CO59#WJsc7L`~@n!UVXh&IIQrMPXeRwy1z>{
zwY#n^dku<M$UkhMD$caB#ta5St$mJ#9eH|rUIo^u6ZabH^}{y(1rsD$e4{vmn=Y3w
zYoBvrM_$(|AH<j7DG8?4HD+*_cHMI%4A^yVom^yj%?M~%T;TM%(y5W8_fM)1jsh_n
z1VzKVy6&@*i=3{jWP2a$EZ68CzE5+RW)WOPffCn0+43;tPkruL^%U6Quk;{k;4d8a
zEj$z({#$uT`kK0Tz&GMhW|*=vfy9N+WWqP&5O4UaDle%Ex5+OO9+TnadA@{m-TBuX
zu%Gm}Hf*}mn>r3zhSyZ}c>i%*57W)_C;H^pTldWKeLd%x|1jKF*_r6`b)S2~GJo2)
z;R~Xr<h;!A!>0t2Q$co{V;95kLIbUtZY5txcRtR0C5~0@B}S;SlEmcJ+kUV&921&o
zjprU}&3F6u1#9Qsyy0+~Qe2-a#SYVDZ<w2BjnFOc58{nwS}C*P4pPLGD`dLagH+{W
zY3v|$?L++0iWKS;3Aj9!j6@IuDlCYp<fbHbBWmgjyL@(yD=Gia$6jQ#D+Ypjat)b>
z(oEAB9)GM~hd^+No;hbP<^zm=S)Egcz83-5iUT?H1DEz{s7y;!h+~l3;e4uEZ%p%+
zMn8%4T}6zs6a7%>q@iw98rCjF>lE#|`c@VCRsoEgto4RZyO-0L)8}d7yxWw3m<?Sy
zx$v4q_-M4LC0TB_Hig1((+*nTMK@pI)w;(mU@1Q?9kbQ2b0fCs;Qr<PwF8A$!4h<i
z2`(sN4_W#-M+ff^vCm&>ZB~MwdO|%Ll&o98n@3=a24?F7up|t;)60-qSN04Bsh#Dk
zwa49OB#X>C@T_par$yj&4b@gL;C>i*mp|>8;98Hut9gm9Sp~Z331v3T7<JYRS<>X~
zsZ13wdp_TUZ~p&9O-Dxo0mXcY&>BV43co4BbbL9h?fp?n85peJbQ8|N0Aq=#FMDO$
z^TeSsCu_<PW9S|qsy6vF-CS*C+K*3gWfV*ZKWzOFdwMB)IHM4HnHYbo8|EcmR1%uH
z%Hg6RWll(Pa9#fnmiEVhDB8f5N;X}K*W`F4C}oXsr};O*WGG?<UI8x0ackpv+#fZ)
zmGb=3!{nb&662)&Ps#HKp7Px$x&&x#f!VQk<4&4<MWW6ru9QZF)zzYz{!(C{Nie1A
zq^^Ck#^nUKh0m*73kRKlGf~7yyMy^URRd!JJeJ=Dtd5B?w39CcRU2jc%Ygwl(9V2+
z!)k>nLq~blS*WbCI0H1m2I`le4}$K<^t!yB{8xX?^p^qSOn@=?_*JSIqwZ%CyEL=~
znXWT6sPZ(6m!Q|m;*&tFUx{6c+DpvWi5e6(P#x7t9k@Yhwg8A@5&Ev82p=+^*d?cZ
znU&89<+0IesGQP-`<0^PYUbF(ttw34+Z*u0G4jdkp$RhVw(>!m+Dk0g=^Ae)!JJ><
zWEG}FEL@<~{QN2?t4x#)G>4yGwpuTW%t}6J@5R1crU9+Bhx7_~qHa<LJ(9r^0QFT?
zA1e1!L(y$?%Bshddzqo}Hqa%0uPiMWH2$B7_tBMVT5zXQT^<m}JXF6Tm|Z7_^jcNb
zq#Ekts%N{By7g9JyMv&Y&_NilAH<Y&a6`~Ld5Ido@#l^faC-3=S9at3{At#`s9!_Q
z?^$^ky{KRFN@9AG*>LO<CtmmbF{8}0C`7Y0|6r5A`m9HGmaNE!*>IdUg@$T6FrLSc
zNTW5`mKt#6N2J*rX3GsA_uBw5B^(6B3!Dc^&Ds><Ft2{U#03}`tX43s4$n)^dKXnN
z|Jpw+w?m!gAvoD3m73)!vSwbLZ215P@I}#T&0#FDqf%F#MHP!+x=*$Bi<j6Y{WLow
z#;S3JHXTn8^ouvLY}!}14CYZ(N)Uv5<h{%h-?!UeTmq|^D?O7={}J5Wo6w4lar{;<
zUDuV+?S~Z}+Pu=Z;vAAq>b@)17nG&+${B_H0pW7)#E(hl3}4<Y;l5qUKyiIjjU$-u
z&y@g;`WlNYm?7edQH|A+{_a~+<d2hbq6r56KiFDt{?aY{;n2eR%K-dCsfGNP-ollt
z`nZwRk}Ii>PH4&^#)1pD$U;K*%aAaFxmovzd2{UocP^a+7AC_lL;MJ|=Ed*kJ+*&G
z5;ORbBAS{Phs_gfy|_r&YoZ33430i?X)XGbB&N1Wp!~3Q3LWG!z(tX@c8Zk_uTA12
zp>eRpL>XUw8zJ2+Fk~KDJIMv(bnw93wss1WmNYQ>JfpCvh`DX$WjSNCs7rE{-qt3x
z>!gC+xfe&{B=$;g`P31ELKLT6r0f1`e(siYT+jVikVNpW`Q|(3o2HawBl-qGI)2)D
z^n{qUxgKZM;fux}ef_(QMh0p%yP0cFOd<mvi`iu#`r4S{v776}t&9TVot*6Tx9r;6
z<VaL12b8RM)_&8qcg8t-;BVRUNTerPc9UaVj*_(Z&N>Ew%!NqN7&CAkLw;CDkPZt7
zWjb+%Ik~=D+cIw-ly(exv+|5G@L`UMlIHx3?{LI>Ip?GiXU*cnnuSaI4^zh&@fB=K
z3-rUm_GOA>I&Q8+&j{plRyI15WdYEN0QZ`Wtx%Nb=ZE8W35uxtpH_bu&rMl$;J++>
zd08(USNS`&ckx&3>elA~6mmNCV|6``^;E69SEE<}L^%unT;cs5&T9h&<r|hmlVu8>
z<;5$jA2L^!z|;AfDGqRg3U4B~hYb`zze}%LAFN~p&B*UksGgN6w2&9CsP4{M1%P=c
z!BzZi8r3FIaBfi1EEK828z0Wb3pY^3(zZ|3u>Gnz{ROUA;Z1DcOv<mP?Zey_qj8X{
zIqhH{uVon}vXtmQIPH<Kt_^0kfhGhOeLXgnDYTXE-96|W`^yf!vw@EP2NWvh-~ySR
zU;ehb!G+84!hw?0s@`U$5-#$+`~R_IgubqUNB^<(Ev?Mgbh-6&ZhpY<Y9hU^EIwce
z2-V2R)pWUg1yRu#9OQdXUZ0_)gI1)JKEL_zU*R0vK!PFik<On||4Nb7#O0_5WfMPw
z(d^&OBFo7ShAZO~(s?3<MQXe${a|f}X#HNspJQMqp_kTMv&rJLSA~h_d3xfw<<9qE
z|7G7){BrH|@AJEEkIm`!b7FzS1Q*003=F}MYmPAk@<ul-Cl9=443<ZdslD?1fV+rl
znmdo!8bL0BF_#e(r;u8#h3ET~x_sgXnWyoHrZ2A<GyEJKZ*)Sql3dWUQLkZ?pRnS0
zL0CI@tL6K!qIO|nmZz6GGr3k>%_D^ME<TYuGx=6sts|-RF1A-0(5kC(^l_amUhQZJ
zw@wKvqTj)hqIM*RTh|5^k?W|BRXggyt@DG5=ycR4svY^@*5yI->y7jPRo4%(i*oi9
zl}3J^h9R+b?4ZRzU0z<Va-to3#UgH(m+Gq=Zzrx)N9%R83Tu7-Fl#7N2l71XdX+CW
z7YSG>>Qt5#s;-t|CB4Yol4t7xvtORr%i3}cN8pQCud;X<e~uxq=h5)%1GuwYS%$n`
zM^CRfZyA4tVT<R{o7peoq_e-kUIosCvtR0x?AB%Kc20_#uJOrmuA&%XceUAI7^(zg
zRSN}l>C<3g1G-|MN4(;*%H->J>cZawxRA70!ykKr2%FFqYx62J`rA*vpQzgZH24`h
zLCB^%DK<Ez?U8NnX1|Z2Yc{zO&adH-Y<_M(ML415QDk1SA2>(`>6B`ew<mhHs6QDM
z&adf_X0E!xM!+ULITX&X?Ga}_xnRtaYc^>eUf5ux*oXl&=2(uhuYb>0vadX72<}vF
zOn~l&x9NDanG@G^$~US&jal_s`IpcZ4JWU|=^+Mm`sw-PZyiAU@`D_}%izIqdx?+w
zM*M<k-lQtmQIX~+IvZ@ud)$+2OXL5dDA_QEw=d6&&!XDjWhW{G`Fc9&Np6zIx}X}}
zQI76)Yv0!Y<2III-b9NFM9sWBdB4x!m=R+^+z`FqgZ}SKd3l`GoQgB%sRtALOiSpe
z$`;oqimi~u%jY%2h*O!JzP=fOwfrqM6-S4j7PhuJHd_N5qr9o+-|ajF)=^GLUfEgg
z{KE#iD~oov22Mtx0_){=d7*K#HNz9Ojx{2mY*9yttd`$jjGhWATI;f=+;g1P_t<>a
zbj@r#N80a&#(VwAPXyPPax;c+_B^MVJ#AR}3iMz>I#&NQHPe&_-CI(AjW0;Btb+b&
z3d>kcqGRBrE3<@$b(eZ+TG%)0aWMiL|JjHlJA96ql30x)*Abt53ir}bzYI0k+xAEp
zI`D4%`-Kv(mX=Z+Cxvpj>dx|G@CU~~k_bDSvM4Xu#m61DR{de0pZOhk%qq?}OCv)N
z8Sf5m%O!s>J~3yWtDk)dNmPHJ9o?mpp?pEGze7{pK9xld!C|@U))?9hvws%o!x|}#
z?nhp``|29mk0^S}E%eJQ#`2LrP{kB^%xq9_&pJ@s^t<35;I$hN++*6kJUDj}Mml^H
zes^a3hadz+?Xv3p#19?&g7F;7AF26v=axtu#p4!q%OH+qd-ub&KynvDJTjynYh(c@
zu|I+HsxjG?S)y!*G(Kf@(d}SRymHKfCgms>aE?ZSqZz0*5<yTrcaAVr<t3(iPD-J!
z8K^sgFm&MgsmfPw<cXkoiMx1Plj24*P<o`7zzph!GnC``TlL(U!bdX@prCXPr0~%S
zR2{J-Fk3oj8nP7mTXGwntiaS)z2hD4a;PtR{w>)e-sMPN^_+sDhN-W{l78sM^R>=Y
zU$PQ`I!s^X{0+q=Q!v<)VJO9ut?ITZIgUVbwkdJDN+etB@zc;hZUV`rE4m?0PqxzA
zig@PCzByO&p$0Fu%G;#mPJ;dgH`bw3&xw-T-sHq>91-WzThPk&<l3E#B-$dHPtb?I
z_r*uS7{R#5EMkUKDbI#JSAv7}!yv3P*eS&=Rq(Q-k&BS%F3!?I2)Z{`5n+mL;qidO
z6W2m}vas#KB4IHe8?t)KS?m0*$EA7+g8W5)z*)cfd&vaRn?z2};r1dQ4l#$2{o3c|
zVsG7$wMAUpyOg!(2J>oPqk*-eBX|z?t%sl7y?JWw0mf2GUBrHP<8(W=&^Sq#zz0@+
z+n#odcFsUb)3uN0H>ua>b3$f9$@f35t0jLA^m3UtI-Gx(_brVgW_Vi^ZoI+=5C{V`
zb5EovnYTN}3L=@2IM&Q`_LVw$d1NO!*0i)ZIvVj$HOD!5xo4|7)qq+)fs2Di9Qs^&
z2kU=K4KJ^J5Ou-&Y5SdM1tYfyna4_fnI&LLvP_gfC9q<5lKFyxDQ$hLyr(HB@ff|L
z86$Iy{G(>2bY~AG&z@H*V?&hT3Te6(i_RzkICDuVtA`A-2YjDhSR(Hod2*rrh;xD<
zY8CLfQy*%{L+br&T>6)Hqlzg?x3$qSZA7D<Df)vI`Dl((qZxxt*K6I{6?C;Rm95qu
z6711zR}Is*F;*C(>4-vXoRPd2NJ6aBF*|do7!UJSF0CuqzibBSZuA}^IRpEszi<ev
z>>|lJyN;345R=Uf(Z|HS#XN+kv(d0)cFxkr#2Q;E3g&#Eo107hYV005Iu!l;IDKA@
zgZroV7&A>B=HcITgtW!zD_13vG&x!SE-T42I$38oC5beF=qvXz37Q--_ZpRdcxYsE
zYxDuJt^ARlR)T5cn4OdK-Lb8_yWTm9G&$sRBlMzibmVhO^dqsx7NZm#!ph~n)IMES
zsA<^Iuaq5Hxq7}`=Nw1Ix!KfUj%w<;vD5%#JO=kH>YJ|e{LzKz-v{X|G)p9NoAg<7
zT9~9;>F6}o(U_h}cxhA7nC?pKX%1MV$LV4;OQbwM>GS031+Bm;zv9YC)BmQ+(Fl_8
zOwe1)b&>G=rmv9eBI5~<1?kfXlJU&-?$f0?M<==~p{0GrBvqx08kj^$bmLr+|0!Tq
zs}djQDM<H&zEjShB>gbGPR^e!eJ>r8rh|lMiat@1Q+Bx93M0*Eo=%o$kXpHkJ?PIy
zxT+O*9~b_)>_U%fqY^lg0i3utZ$;H(?!Jx;7YKU$wM^}pby-KOiMhyE0oAWc_nYgL
zN0mcw_uKK|7QD0C?s+T8p7qw3jrwBq`Gu3exNNBEj?s)82@pdYoi+ks+go582@n_y
zF^q&5#zI&W(=arEmzuy!4WNf6&_e^*q6xeMLkz$WF&!WW#GV0Sj{;#q1@cn>`LTdm
zNs#<_NPajZKM|523CWLz<cC7YQXph8kY6%D>oN$B2GCLyXsH1NX#znSKw3>8tp@Oi
zCh&&_@DL0s1w*L8kU=m+8Vm^oLlD7`XE5X;@Xy1X)w`E_Qd8iypjD+F@D1kJHN?Jz
z+Rqe-#bcGN2aLcPyMfrpQn&O%$m~ZyG(hIC@{WKDT(bLqK>pvUcc#E3E~_v-AT1X2
z8N@!58spW@X_Te`GEAZc11{*x5(NOWEJpDfAUs$Ga3C<7db|fhW~(?_138aodvzU7
z&DsOWw;NS%fH06Y|EhtEMY}dYDoL7GYarFpwdW9)wbV9KpenCbp&oD^%it6UOr{2y
z0w=kwBJ_Z~SSv6fu%7zn^)0reZ(d;@s|-EhUG%#Khz)u3N)1FfTI_Wk#<K0cK>q2}
zx>pOq^5q%`a<t<m7%~w0Ixr$KEjVz2M)p?^goW?5CIe(BTE`dI_A~W$NZDjsd%%Te
zzRnLy*C9YcJhob$CgYzeIv!Ex{NTiWaAFoX@%lc&-Xz{Q!A#rX%)y>NSk>+E+GG!-
zp}EdF`K#~x$O618rH0>&O3&e_54^Y#q**6urUM9f8c~z<c7}Zvy#Mpf$?4)h+syyn
zWp?~9LW=5oQm5!989x`Na0piZ#kz(*|G_jKkN%todq=7Er*}S{loTFgx_}>zYba(f
z3DRvg_Io9<X8n{s{pj9hc+xf`QBFzcwAZHzVr}C*BF7-~(J!~^#b-HY^TkFI>8Gl_
z<}e=ZGtL1PFMn<mH1-7_G%RIfs+)%Uvb6pF3wjlMq}JTK8pSu68TWyB(-^5DV7j(c
zS^JOj5Nfs0GjfoUJRKQ~>QG%RY^QR}RV8N6RIeE&iE!s;BL8>Mnir+GFEdTgM9PF*
z-nEjqJBB0oy^_JZ`m9fGg_d<^BU&Sde^acJuSG-Hd}=rEEu$=Z4^py{ugODd-D}P6
zEGL?t;VBEr*Tf;UZncsRmUWiBM=4&(*Nh>FqKj+K`ltFKS0gARhTADg$=BJE0?37B
z;jyI5e6N>yN#k@@Z0u)$*T%^gm_vW6d5egy>;uXdl2`U==J1$fmo>9z!|mweah253
zrc&hQwC9>F5T~~S*NBR<m;bG13bG#aTf|HrTbwO9Ku*paxJIxER%hSIPp0x%ROdM?
zeHEaUWlZwLkY{K5{L_fr9)L)@5v@sH!xaIvv*qkyJ#Nfd88cOm!967jVJ_S;>s4tz
z=C-WNV_KbzCwdse=t%fZANQS}zRZ<PQ;29MO2yFc4@tmikt!<(c73&Z+h&*_{SdCG
zX3tK4ypJVxEaAo+8s$j)%q_oO>zhmX5=q!ks1|^;nD#Yv6iZ*Nz6GmySm25!GmX_z
zh4UaoMMIk7`^V0KzAeA@x`UGV0&DUB6y4PMGYMg2*<HHbbbJlfWLYd>l(t<aXd11C
zI!Z~{hiFsxcVuJIFxsaXb?ip0O`J%L_PvMY>{Dx_z8I%F=k`6yT81FUd7nX^ISh+t
z{OB?4R}#m{zDop0bC%N!k-m~ZOMj^9aiidOk`;tER=v1poXI!d+rF~@Xhag~qGFLm
zKU+d+)dcf}*6lJw&<PpUI=<x=J71kXdM2#=FrUqbzkfL6BSRyMcJ!{LVoc`W&27i$
zp&)s8SJf>I_PGKVGr@Cp1d}<J88o-*i;#}8ki?q@Y)UugLCzY`EUk4K=z~8rDSnlG
zp-v{KL}9%gY@)T!0FCj7PR6e?FPz8(l`E{5foZkYsi7nO(7JdLwuM3&3Mj}~8``K7
z5GC@et_P2ocd3AX_(Lh;SE&~yN|RxlJ}hwiYJVAu1<*eh`)(Z{46jcqT`HPu<y{J3
z^($~t{3^>ruS^g`;hLZg0C|YKe^nc4eyvcBx;IYgQqYXkxxu)OqV#Gg6HvNF&^vr9
z4wnF&<k<IXV2QH;p%T@U1ol!XU1pl(75<9gO3LfdvVY3gjT($_%?H9ZX~-KH)madw
z4%EMz64xF=d7WCesB{h1U_8{sVYRQ*NkQXRO%W*p^J|H7=%}Rl%W2kBylz{TD2PMA
zom%3|P)~6<H-I7?&RnXt2%^-3-c<M-f=T_M`0-sb5Zg!*K#ISXrboHIE?D~-Tt(2P
z3^|A-gMx~5p~}@oR4-`oa3(HQ^)O!LFlmFWG7a8quq|Pm3?wI#Yz|cPpw4ermV=yM
zfhyh*xZqxGiVJ^zA2NVF0}d>mngN;WK!IAl4A4f(>-4g0<?AkumTPbhp;xDl%R8^v
zSmVoRsy7JWj^c12z=UzZsMz%D?_n6(OX)qf{F2|s5DaBHfMk8wj|yZYMrH2#^*}c9
z?^$5vtVvM{ch`u=d(eYe4440a2MH)fOo7Y)rw0LOL~MkMZ1?Uhh`LCfn{59M6NFnd
z%}us<hXmrz-gui>bjHW!|BE+tmbZvOe%ep%Ck%O-;8<-dFWw~LfbJN@x6)#1_lt!O
zjrzcA&0){u%8P=;btN(0#;?O3=-%u_+D#Z@5zDFv!dTrIem0*4BW&MwYx~+*_^?bL
zE@NF3gsp!O`>{N^o0qiyemZY?a{IORtv3O8&&qP)l;rf_-^ABN);sObq{)Xemjn!?
zds?Zhn8pH*Fs*x{+A_&dp8FuCDyHH-G{UO@E=7z>q^oWXrOi;5dy3Ig<i_yk7f#p_
zms~$q=arF$YCjskCpUD?MT+7{1Ue6xk?Ke3y{ef}>_-Z^8lO?8osqi?o8gq^4Z<>n
z5tn8KBd)>@N(+Orb?2vLP$wg-uXx{AVp!z%q0?Rw!pb>iiA@mJq0w1a^sv%Pi_HD+
zB$Hu?BGYI4alOH|fen(1$JeNFz1}}wUQGK_15RuhJ3pSeN8Z;{dfB97AaUNzV<5To
zF`Ze8Biqows!Z|VuM?yt!}z`LHcjfYPKpTQ7;;#L6j*W|G^Oe;z17PGEk4pb_^&N4
zTua<u?bXdGu=H6bCI9Pg_<#`;)a-d0-jDddpT!Xm0tEt8b55hO+)8kIFX~EtGh#|&
z(x_qhD6P~-sojs^QcRL@bR=}tW#&pUxY=7Mdq61ztAj*?nD(Y5{HbTESk$$3_4&%*
zK%=1w^?pJA7?<|VqYc@ZD4c({_c7N2*>tyo2jBOhD_OWi4NBz{MMhBAADowEQ}u$8
zD=m^w-;0zzaW3?o=P$mo<NZ1O`VfAQ%qqlZ-etK=<}+}TeC<C$(msuuOVU)iRQ`Te
zk}a@tNuF`8eP}+ThLhPoT?eFLQlr36c-^cMQ<`6{kfZ~Zsm50DDx|!&2K3S`;DYOy
zK-ikl1TBg<`)0~(LcmEHoJmIzrfCL*I#(yl^8->ubTqrmMNk%W#O*W7yp{RM7Wl;B
zT!52Q2=T(}+;au=(l0cDZD5)TOmNleWLbXg6cH`WwF(i+1vYUw6QGxR0Sz2Z>D5}+
zuEdYB@H+KK08UwOIUSEH@NE1l&4Lox84B_zY%_plXs(wlP}G1`wF<-GHsWw0fKw)1
zN2dd(Il>D6Sgj`ORYU0&Ubc||_tf#Y26M+7egtAHIQc{4;`5mo^mRIpG#Q!UQq@yZ
z3yUB%T_{TRl$=)#rB{5}qKa3xb>^ABRQT&TAXRGB!JA4JDp$SW0Y{z7Yw$cln;OJJ
zgM9|1_R>$rKI<#z1D9sst6Eg{;($c?L-hf5X>c(epF>SsCi^~}15lSyiiq~>!j~Tk
zrxb^?0VY%7NIExg%^d=MQwWCUdV@k?9T=!(Vm0Y`gGH4JL+7aEV%+dV&e4b^?#%pd
zoHouhf!|s1Jur=xi7wVy$s%l24jltfU)HF&Ymc4)s4s1l+ciX20WfIlGq_Vk?a?f0
z>r?aOeOFE+XQGS$RNAO)#S*nZGtX3uo2O<`H;Rd_M8nHmi=PLu=v6F9W#jq!9VJbe
zKugZKJe9>AKZ-ByD|30mZy9RYU0w7%8V_cxxZm=Ka?Vw$>~oc=wC<=;Ni>&Cj(B<M
z7A>Pl=tgpX%Nv1K)KSK1-As=7onOCurv)%A)7)q+Q@c||_4qchek+#g^W`Yhm^sJ;
zAGn(gzR3_j_LS?VF3&HdxtpMxRFl89U{n;Zp?hP1jMnJx9+s7ct*hLnk9KG?qJ+cB
zK)k~39!Ei+vx4g$MZvK2>bLN2RMvZjP|S{$aOx#(n#aB1BGuYTbkAaZ)cqH2cG_X4
z0z2&w<`e_@E^Q(s`Fw54jzpa*wx&daDz>&nt17mZME5GTjzpfS+Qvk!s@m2>dNsf8
z^WuG_asA!Q;BiIQU)tH+o6PDv(ZXxp7N10;3!5yRiZe_%+6%u~KK6<ZpAxIvl=zIi
zMfyB)8}Kt3?JVbUeO|)MSJMPU+LYS^yYZV8n%^g{YV_I3t#h7V;kIQu#tRZvvFL!U
zIS~9i>l2@TkoVi{i-qN=L6#5bih|^MmaBSVq&I$iEsqY8v0q8D`^Q~vNtM=pEW0s{
zqxdGE_~uG{W8O!JAs~jJv13g99}(%#4Z5Ubtht}2jFZPAUo4h<ryJ6By`x&2#&=P=
z<yKb!?itsqMzvq3Wrz>03Ii!cZpB(J{p@xwXMP?0L1MOI4`j$!!gHX(txfxFi+B;r
ze@0r(sAoV?oMD(gWPe+$b7@dbld|mR{<Y8pdHN4t%ZTmV<|9{gAwi55C5PK7H^JfM
zpHgV|7Fuw>{%5m7{m+si%-PHBKN48(W`E`^-)ye5>Ir{!9&b4mgPXw@ZkX?BtMy8s
zvrL2f%Oo@X`QaT`a6o*p37j7sQl}?b0yEHR06dZR-b(}e8Lma3{R=e@1Wyp?k!Js^
zx*Vogz7cxw<A41l{#go+2<>00q0+p1&~lM`LhZeu)wt1C1;2pxB#Gcf5Yp@7EBH|9
z-x@=WevqCdC42*p1eZKoP?1?TYb$$BFzw}oitCcY`{4`YGV8W&py#iqy<*T_T~v7g
z(E_W?x{FuYbBt*(4^&)_7#;#&P><|7h08xRFhXCD|98&d=Scu08m^X;fxJiKTOCb*
z%M$9@QW+ueRm_!!iD@f(4U?&4+9`Iv8O%#^62?4IGON2qqY{JN++d-t;U?`m7_>>4
z`PuKdJ9NY7n#G!>C?b#ddg;df-s`FFp*O%x@3n?~TZ`daJTC`ZfkhNLym|W@)!_{3
zXb1Kb35WLy)`U6PsNoT<$G&WMOqej-E%h&L4p>UlSdE^A$a8uBf<J=5ep@Qmm(7_)
zl<Up>;#ox-qIfePBekR6>s)9ob|Bw5jaxzv@yjL*4JRl=*35af<4z@HRn`nPqo;pW
z{8%BmQ|jUgBP4pV4LQsZze2_issL>M<qV3Ck=QJ4XogkxUsY4yi^cS<mYtsEU{l^3
z$Mg-ConGZgOv;8#l{U1&x?i0fl}@|Crj4%FpXaIqV0+k4$O#;e71L)k9u)T?34J4G
z_n&Z{Vr9)-W^e9QiuX!WykMM$S3%En8I<=<*iZBceVb<fc`-%qFixYZH_vmn0We|g
zpa_5@j8lBCblMx%pnoO%JU1?W#S`-k0Z1Nm1|`P?FPHY)%%<F`giOh*i(D<S-)n{(
zdeqEaQrya81W%aVim4yAe7GkkdivIXbw_#sDW-3%toSUaZ$Or6XGYNI%IvX%^J>Oc
z=t_|NUMb`-LF_6G`-wdv_?OxJXPn+**^sre7dU57T#UqeY5xxnrRh<KpxjCi^6gx3
zSM#08*0|#4o4$gppe<HKNd!~rd+M{Saw<eKz&-cbLU}QQne09DSzCEAVo1@I#};R5
zFk&FZVa~wPE8XT1FxL>)FL#f1mZQ{<+!uBwy48>xjPnSbqYCYpzo$K0QtCk3RP4gK
zB`=pm+?2cLJ)10F3+q?1M+!;sL_O<J@<9rT@gzQDFYgZPS78b5SLi~$eJBqI3z6!=
zxs54*2n&((N4Om+M-2;+@qc$)RUQ)-BJcn9_MluLEJWHL^ERh^BrF8rk950K-jDDS
zeMNWXqNI-al6=K?=JrJMYu_v^Bqii)Tj)#bA{Vq(k(<z-FwMCmo-!f6RiDL1iHP+t
zMZ!;X+AdS@$k{+hD~@q-as7^xpoj|he5lLNLH^-D$E?RR(lfq92dPAd_f6<1x{bh`
zP3(OspIfpn1N;lKTf2Zdbb$y>)rdx?PR7c<20(H0ZB%0dvr;0AUB@N#^P&Zu!aZ*c
zy0)uj4QF?+=Jo;`FIvNQ-2DW!8ON-}E3vc3J#z1JjTde0Lpmp#;m)wd^^c39L^)(}
zh%YN-xB*NTcxd-3>MOMA%CoU_*|V|bXR>5zzG5{(2KDo?blbRj%l}y7{y64hg`zSy
zMGvSdvmpecGAw?;cZiHDq<XC=N@l4cjR_aS+&3N)Tf*8G>sT%^a<uIDep%O?-(}68
z_Mdk0D4E$-V`!indRp0>k3_7a%exiOSnJ4E<EOI=%dYw0PDr?dyJpbtnay5!(pCU)
zv@M5y>L@%E5uR5W%S)!R!D0od7q;5?|MqTe$Ok!YJ&b8$pS{^-BEFUO%#27jG@tRi
z1#8MI$;W5MucTMcTL+717iW!&9gy)FAxcJWP7a;6V<!k8o^WX&jG8#H_?RF(a{aXr
z>t3ZP^*9R%^k;NRgynLIL>k8bTNRpB3y_LzI|3+j%YI54w~fqO)#g~^Zj<6z<Mqlm
z_BOXi?K~cZ{&Qc6tLEKn_K=??JY}(wIHR?bR=`LD!#<B}3?=tU4V#)z`-FXZf{|)-
zdTVpGYlZ0J?5#9W)!+sEIEgnvcoZ7iK)ywbf0EhiF9GSoU}cT5D6MIq*mEjDS+icq
z!FWDx!zSxxWicn+-F&}IM8tt_sv<_eIOiWP%>%nF8$NrZKC`YIBg)qWe~Dkg$3(_z
zm3~7U1K=FD(ONwQe#r<+i|*zaFzNkKma>3q?XFk+%Ooc>ExCJjyT0F?>I%nsK;qkn
zk$WC?g{vR4e-l7K%*o!RpNYCaLDizGLF==BN1%9}Jrji&<9Ye%<IkjkZS<iJ2*U>N
zu&A%lBR4)wI7SPesxAi!?kA9+UG!3Nu2cISnpUwBF4>R&<X?4nYipM=j><VRcd8(X
zBtDmNO8Tb7-CzYTyf}Qbp5Xgl+a+gw@NZ!tp|--Wy@gK{)HzFBUf+yO$Du}h7a}*$
zl-nDdOWlIkSf41Eas+w2LX9_eO;-i=q966R>@9mOYHwULxhMYST6kBzppmi!IDmU1
zqE}_5Lm0{{%XM|0NJM8xg)AAJT}9F)YQW9BrWU8Q;F3bZ#VPboUd=rUwr1(R2tYFr
zxg*o33i@BPgKDMTxLQQNYGQxxiOJVW2*P#9M@r4Dw2E=w$X2-ZAY)=#I;1qMlM&J$
zFUv3IVdng=EiBdz_KL;+-TVDb+-G=YVc%JZ<a%`a9oH1KB<&zLC0L}Sc&*Xtw8>`A
zxge|CRrl{tgU&a$Q9HH2>vKE0TfVOwbp9yJ5`FE)3$wcOMD#dLn{4+^&8?_gX=M}u
zL%rVbZdR!uO9{rT;;nc9-l7C!&Ufp@nR*et`&o}cK6C|z)$sK+_b%G3HW!0pId=6o
z<vmz4jfQUs!f;ClPLV;l$j>-jQ$wqw7AM@8kJ686`Sg?n1E(VcBNkhh+-KaY4BTY0
z{p#GO9<o%E&?tA|;mMHNuP;J^FAwXFROWD`&cK<emtymR7)lXPObB2|*86$KdU(e=
zevs^iBkJOsPc(XXVFP72!cAi6>^+GptdA1~#B3N_5*71fJ5B1H86uHVPKu5xj~iG1
zpL(R<*QelIJMu!io1bqFeZr69(B^zD$v&yLeX$T@r|BK1ov7arLLw2~4Wc3G^o)E#
z1R;09!|M|pefdh9KEppBKFunhz956>|8~9i5ho(da6El&zzR8CEgDwlrnOEvZ=X1}
zPcN5Fg;}4pETZCKtG@Nv4`ppBX}e_%*a3#bvE?0FgK$@aY1owCtTI({WDR9~#%f<+
ztf&$Q*&2JU@|F^FHYwFzcDvA#Q~lnWjVn&jwr;Gkpc*g~h?m&DyU)xe11n?gQryb?
z)KX7BKs8@|_Zhu!Sao>mo9!9@-!DUft3gQt!$C=3k6%%@&GpKzQ|AHbp1bg5uulL{
zA{S3LwTHj{M5C#+?kGDiONti*$%(6;&u@NKmS3;b=oTC;WvwFHIf;>SvBmO<+8`{l
zRxotxQ_A=lT!X*aIX>?#h!&uWBF`u?uww2hA0a+t&cd?4jB>C%1ySz2GT^|<UJD+#
z-po?zcXF8V0Vo{`TD+K<@9JF|VarE8P9cIqA0<%biLci1pQeUDrlDrV^!pCvLt;Y(
zBhc%MxBI+ag~l9UvBW5I<Jiq!lKyTcmh9y=j%;i8>}O8M9bj?1bF>V2>Jcbtl-SQ{
z6@o@$a!6x@E-%<RF!Q~+QJ-?AlH03|ud8PchR)TsQ@`=81}Py>BKN1M=~vE0bIyig
zQ`4y49xZM?9<RE`zbqX&dfmM}!zX)f%j5rVV<FeimjFOCkcVmRMeSha%1eoC7a?<I
z<to_ykvUl^)Ya?{w$C>@p7<?NiWIGSm@gp`3d(zpDc4x{$Oj3Xw=P3(6j}j3z=8Fl
zpoW^RDqago$v&5ZhTwUV!~2DRen`D?iNEHgm|39gb(vaB;JILhU6C$p3owoIS+^zB
zODMuv{XjnkMt5Y6e<Wp--&Q=;@^7|l(Uh#^-^|dW^L<xa0!N4U9N{8%*W9X_p1~T-
z-hq|9<<}vZ1BQvMQ{_>e>QzD8Eb-=OQXb;M4uf;z>>nHF#Kk{E&WUpt!h-T}S5`rJ
zm@Bzp^pUHmVDzCYs$ewSl~FJn=1MGxa^xx~XajS_5v)9N<rJ(ubfpsPI&_s3tc0H-
z2zJ5FJ_=rV`o@w|c=-z1+_%(rJaPB;TaRMe8Yp~kY7F{9iXBz)4J6-o<sh3zwxF20
zm?C$UL)sRy2LQD|+E|k^ZCqpjSoph*A@PD7Y>pI1Cmb^@qh+;POBNtk=S#dfx07%{
ztuBVyV=Tc+C$-t56SHsqVM0GGKn1Lit#fPwUOrDm5*ZXh0R*H>H7DP1E40+!`~lRR
z0c^x2t6Gq5D{BJJZ@x82r)=liLsy;n2ETZUjo%{_wa%(<Id93DJq9VEyUz!n<5>Ou
z+!M?Mz?N!7j!i+>Zk^jlof)?O9E7tPh`L&U<kW}kv|TbOSTd<Jv+ppo&pNZOGP92{
zv;WraQrPa2)b5hm?h?)JvWfHAP3EgQ-fCd}%zjIxKrv&haN5j%LZpBhL+c$&>Esfc
zliI7qP^v0cI@$61fxh*Qqjd5H&8aq0K$5Oi*va7%-(LH?jP71j>55j7p!ycS(B46`
zf(=5Iw5m3gsog{(LTD1FHnc@8k&s!PZEbzardwZ}RY7Hd)^|SP-4t8>GlAi!!)s|R
zs)|v-d2o7}c>E0xvxwBBN9q2HqvO+ulDpsfH8D55E+-8|rY$L)&j|z+rN98YYlm#F
z#nzD^U98(rib?+xDfdam`@{kQsR2oPB*oRkw)sLREpJE6zsu(G3a7Qc-`dR2bBZPi
zsER)>3_9o4@|6GAqU9<5&qK=-8G<c!ZDe_5hKQapY%}@Hne()%<r$$%QMwS)T)Rp5
za2nscz1KrI<|m$h2{FIrg)|5?9!q}EuNG~b)B2#V#+S+W?Qa%}k7+!m(6`MB7+M5I
zI*Zm7(%&AM*q}+I#MDH0k?=GXo_UgLwId#_q+yb3Wn$j#ssj?Gi0ChW2{7>b9fDGI
zyxMTm?dxx(wbt9j6*>OMcj9Nj0lJLe$h59dV%6SBw~%x~)u@b561lZ#2{7_}`Hk`|
z2#pOjCZ5{v8t;1)v^To2aIO;bfPTxI9wWM{4J#jeP5qPmS;|XrDoX^|wA)loLr7d!
zBRalJ2B1Lxtm+`FFQi6QeWaFluO_(jmbX`)B{mnKohT;bbvFpzm`-}azO+^wi=Z=!
z51whpXzvN^i^DLjJEE?q2ZVgvBs@ihJ`J$MI;e0X{Pp?qpy#{#Vh|tZ+Aq2>JwOHx
zBm49@lHX#NOe8O@<}fJH7;s72nNDd<_wFS8_wvq1ld+^&e6yh>(SlohXFjiOhi`5z
z_`J@)cYk^vyZEI-vp&D)x{`|a=Yl)DxndIhCo);Dns_h5j3PT;w2bF4D@9xr#-SUu
zC-}B~*|#le%H%vop150{m|%_JhG#x=44Lp#^t5s+G$(u|%i-hD`)>Co6>fr2f7%tS
z88=$hMa2x^rD$vmS$<@04KNm={U3GWCI~^M9W+*kLYK6yl%O(cRWbgLfPEzaEkYYk
znE;A1mM5s_QP8*~q>XblL9X#7bv@+m1Lt=gH-C!S5rcShD?s?yk`(d^J1hL(bVE!q
zAu7>6Qj>0z&P4)aj8X^HnYOi=Hlx`#qmp&@-$Jlh*P4;GHL-gB^KV2K-xi@et0${%
z{fe6JFoV+mG;A4WpR7_>8R&j*>sR6?GyL}>J0#|jZ;8;Up7qf9t1zKcCC17`wIgrg
zEH|;{Y#E*?NG})HX><7(y%U2+&I+0n$B<BWxsM_@rTzo00|qS5LARbXqhSTxqy0yI
z-Jh0)Dk<c5AqRj!jCf`KK%EDnQl7weHZi9k9?bEMx7k|1k<Z?|?*o1xStK*x1{{A%
zP&Uj1ehTQ|dhcC@PGgL_O$@7SBk);!?^ON`^`0^^=%6Is4~`GT?L9^?ZCBv*m>u_q
zSsU3cErKjWQ=&U5vDO0kj<;qTX$AL1+=_IYGYB$5Ex33*<)i;L3UZj28?nlFeXcUu
zk|qxRe%D<eScC7qGpxq=w@9NShT!HqImTI%xb%f7qDUCILP2&f9(#ZaH>n}^V0KU@
zZ%`X;(7F>P?Oig%onb~`uYTbJh~4y9#;8ZEZ75;YsE5Zl+q7?v!}uM#ARk#g7=5?^
zU9GxSvyb3rh47el=&4=)soWPKng=sxj%r>=r;bCmBpz9RXi$GhI(H`QTNh@i_nU8S
z6Jx)m)D2Mmeu*q=FCwWM#Q6Ra(aCYoCBQ-Y;c7*K9Y<x+z%f#2LyH$j#XKZC<Nmh&
z12P&#o$aw*;ggJQG!Z<J7=CzmhFmFo@mb4!dPH$wadpO^tbt3`Uz)kTU_wS8bZnKJ
zy^SlHXIbt`a3)W^p$`k{876NyFE|oH^(e3$6`B-P3-Mz#9Z221mOYmzY-mA<z9Pe`
zo)A@wA936`*AjES++ZHUA25pT!Ee0vu_f5y;7KGOjr$hXgCUrD`)#x(tY^F>tN^wm
z6)paCxEo((PTc=f0;jVQIuLEe60*agq^?UjFW!7sE?%jm^^WA1omH=%bx^!5i`wE{
z;Rm&Yq1X(3o@=9G$hSQSOwL@kq4|GCRf^mTQ_vu-PZ3KggG-w!dH%u?ttBm_d4K~h
z8n@vdxdWaHnonPe?U-q&=lv4J6b^XthO8u1POW!I4O7zax<b?PJgI4UVKnlU^LnIt
z(bYxDIb0WfCcj3tulVKP1{J0;9`eW+m5h`671W#Wa(AVty)zja1$pw*rp)lj#~+f(
zQ&u{V`o-2;?n-wRrJ;siAl}eX(BX6`9DekRC67{jYz(N!PXBykPC=LQjq&KCA5`2B
zRq3a=5$c%b-#;RXls@W9(id+9(F<;sZom|D;p7nox6IC%p4(NO+yik{?x22r^&NRh
z#-gdDJ~goj@;f!L4Dz6YZ;|A^g}0>6SMJ-kowM_Cpx>~+Kc_nt9zOaNk((6WBHy@D
z(Q&$iGVuF%i>@N%x)h#1<_#rbt35X3xg;y}tW04R*V!NnhiHyGjMJuFef~}5S>aXo
zS1#97bER|U+L762`PWq1=gPWcV`gQkl_u~pEBH7aQwzh%B+<SvUYA4Wl&H)JW2T)X
zUVy41KZYgiJ5{#-MBV|nRbSOMw|W+_FQjKidlFE@(gPoR{H)H913vEEAKTDk3{V07
zBg=lFYQFijcg&u(Z6F%ZpoH7ja??dHE&XrU;$ODKzm4gS;%?umsyY)t{8*m~$ejQQ
zU2hImzhDPNrFB?5Qw`pQ<UW5NrJlHw7E7lZ@I0-eC0$Vnv9{u@e;dH{(0!;T?`?tR
zJ-42CT%tg-l038=tsTOuTmGTynW*6Ys~g<qdv$-Bn#C?V+rn2*1X^-C6k3-V-o)A}
zTT+7<hwp~Q_>1P$<1i+9-JS1^=sA~JSAz1oTO)zOn9iNQ?onBe5XGp9ys=M6B0r6)
z?q!LdN$NUJ_zNYz9Ala<(*Du-$Y?IJSgdD&<Jv#=CRi;6rC_%~<1JNX{#F!S_@;4q
zR{R!72frs*&UK1jf6t&!k2OC<TlG>4Z;~mea)S40i78)QOO-amZn2BcLENm`D}H}o
zXMRGtO!#Q7R_|?bMgG<vT{thtAbI@Or4Igt8qKIHngCNcel<gGh8))bz3==byT8h8
zV48h?rxKsGaeh+K(;UNe@Rt_b{??%uGnSh`@eY=IPHoi}WxOYzoZznq54|R{fm!zX
zb9DK%9Fy39GcO3*K0WTSH=4KqKdx?q$+6cFsF$rA&K>_dF8jxn@1muOuToZhFn0`m
zd#;1erbu(UK)+n|u1}SJ@H<_28pmMpwCTUlGT~RJ03|*zll+LH^($(?rAhdH|Nl5t
z27ZBr06grxx2D8P5ybD7q|Cpcf1i{CxGgczb%Vc^m3*t|ZpH}js*y88Z~<}J*KFAY
z`SQ`on`Zt=mlEm$&~BijQ-%_6pjN$iwyN>3v}M@px_>y7^fQ~h^3>DQ3%Z`9Yn~*t
zr>`Bfi41j8a<iR3w$l?`;S-(1zQ|B&{>*Hhq*!5N^U}m(kTs6GquR5?k`|k-r#s@V
zAah{#Jvr+qn^AmcY9aUVXoB01ZSDx!pjx-;6@PD#cbcFud7S(uZtRk)ch|5>1^b)A
zWyf+XOEASe_7l8FSi$#S=;_K@L1AUD!T8F%q$M|R$nfbmQ|G(7-U6S<9O7Hkz9av}
z>yCfs&$yJBuNhyaugxD^P6oqi#d7xo&LpU8_>u*vB3ye3Fk+0}2`Dxxh9zl<l?|Y3
zvFUEfGTRf}D#p{J2eJ)mAxor{>4vFlv1xB<GiS4&<q@zF+#1Jcp$AeAfzSh)hb++p
z>4$dE1KEf0(F19RGSCBAhqTcH8HeW49kaJdk=qrUl*8(@#A*fvNLP4&%Qu?DA3(Dx
zw4m1Q9N)?b&TnKtGdL8GA0pm-Wh1Z5Wy7%fIzeL9{0YosK<hhWMVcx=8#BmFD>;C~
z>;8@?KP}=cmQ)xaVRAGW%uV}X9!I)@p)xs2`F|u`WmH>TvxZXK+Tu`Li@Q6;oua|r
z-L(`g9;~>#y9U?b?he6<OL4h*zq{7VdFC0}`ID8LbGA$=7bVCzji4+X$HEM+l9N)v
zxhN}Bzw(Dao+X~O-qgzX7*AJju|1(o{oE^q$sya0xCUp!i^Ee=LelNi3qn%Jsb37H
z^Bqsj&+Sva7))30)qcj{1`bXKY#`DYnoJ0R7;-~pZitSDN?&E2oFT6B+>#ubLjr!f
zjExa(p_f5XO-Aiw8Mcn*s^XSg`Yexz#Bs(@MpD;^Sz|}}YW}SvwSC2aoY7OY$J|o7
zrMAIlJq^1HFg8uH(Cb%h8rwI60n;w*xHMQ|*QoV6FJL7f36*Ua;z;^#R<W3ub_1DU
zr8k`*)4IK+#F|Z6%fjr&;^ldFU$X(fk1i9Nk&UkEHv`Qz8|p!Z)+*V?s>LJG*nOWA
ziOn6y@jJa}Ydli}h@l4aYIW3Y6f>YY>W?HdAQ_S$%2Qy<Fw+J*JtEg$-MQG)v<zzX
zQixniw&hdn$kVf>9LzWZd}~|uh&7+4sg}-U7$ocnAkcS|rk!C+!P9f7$8dsn!`&Oa
z%RHOzJ?~lZh!F^*Ii?!a<&_PhVRIhaWESwv@O`$@Y<xpxpdiK7A<&Gl*J&IHsxQQQ
zZ$jts#;u;$iFCI~)GzcxOvzCgJDef8X3H2#9}mi-IYBr~tz_6d9$mpb^W&N1hIXEz
zCOp7wLf1Rdzn+%)E<Yw8tx&KEp5XXG9cJ$<fXiDC!oJu^_+d3d(z=lSu>1_kPd=0`
zD#1Ppx1>0t9z^&mn2a#&>;#Lk={2zZ;hV5Zu&?|TIYw6y!oBlci6LFvGtDgW{Zh=C
zv`7N4L!mTPBDStBwUQdOQd{J4GJlDP1OA+=(_oj{tvcHo?I10^^OJlX@@re<3&FPJ
zHsJtV(F1mkq2dxEyrqM0fWK6-Sy=;#sbrOvwRuEVqw}j^=hGoNLu7uWR<}w8p4=6+
zQUJPQ09w}3)p-O)F_uuQ(yexftKHG}IMl48?d|Vzp31isIl?nU&_fi|{9@z{<mEAX
zV={lo`D5`@t=>ea`Bh*XLzljX2iHJb4-NOy?rcv;qY2AKGTE@Em@r^;Wg}psQ)oaW
zZC>AF=9|OfDIB8;m#Znb6e5Xvz4;UkPK(D##gEnUBZ>!f?Kh^j`|6nSa1{a#z#-~!
zk?3oMcKR_}r1~+`YNzTXuVRt<^saAol0xksaBbX~7*~z!F8l+ZC20hbCoi$JE$b7n
z&POuO7HK_DwhDL3UUbl<otgoAbAAK^Z&ZU0db?79-P=tX4{6aAAJMq41kr*LkwU!e
zvXoN;@dYNp;T2&a7j;&bMr>baGx!)mROxKuU_{=v0x0emC8;OLh@lMP?o_d<o%Yi@
z=F?7HRf~i?OsSm?pYY86>)zJMJZuVebr;~piy|!W=_z_W0;}=ADnvKMXkl_k|HI-P
zX#<zhFCNM|%j_>37CpeGw1)n9$Pjp5Rw2y1s2h5WpkpcdP8Q@IckR@FY)yJ7Pb;A)
zqRAgKullCXpT^snd;BgYoi-km%g(hDQ#j#3X0NHVdg?Q8u@uh@`qQ|=#X4-JC4rZy
zFFEllmugebKsIIeBX8C0$2NJQVpzDMCW5QtpWMZteB&G|=B!(0MN}VX^3qLH`Y00h
zgA!t2QK^ZaY32Am*r56us^oI~+@Gn5GhoIPJz)RxbCb9e6NOjDqPh_iksk4Tz*^$j
z2$D~G*_q^CEr<RZGR1=@jMM*WC3rU_x>xt}Khn3N9m9ftOOk>8g|jI0Rby|AS3r4h
zOhTNtcg2vCdGB<JQ2F5WYfOm~x71$Q*M^0DEhmpZLt0@U=QO^$ZuM)qdK3>Wg}5Cw
zk!N}9%UBwa&Zg}{O$iyxP4LP$LfQ?5j&Dg3I0iJDt$q;vZc(D7gv*_2jVN~73gh$1
zUTTKI#44A2nqyAQHs1!fbffc4xi()^=+lsve~VAP!Vx`oIzuSEG;RJ^{GSQ=_Wh&U
zf-zMY#QF3Vxso!#4fio;KbK<xm!oG&#yJy@5O%b+0c-Jba)~!%=M7#%qsdXVu!O)w
zoW+s#taaXcCUe%G(FuV<EJ+?mTAue9buEJ6PQgtXQbTItkvqzVI5)sft2O7jlBa-Y
zXfvAxNJOITXUB-zBJypxe2II17PgMJb$fz`XJU>LPeu8T2d*;Y(oDDorA>AGN5Nz3
zm7h8Rsb;S!hu11Nk~?m$I)-jP2==j{Krm9@Pqf#KvYU>9Fi~kdiv^c~KKiMzt(3K&
znf@zlbaqV4?MF980N<A!VpJTq0;5`?$^me%*S<<e<PDmE-PP5e*9x5hTlCa#bJNpB
z&7I~Sv(^PB+!Flu8rT;JO4aQyEpDsEZs)m2>k^RE$(Y8_5t<CRM1?!DcvGC~T{x$z
z5sM#i9i-J9D~zW>_q{kY8OT~`3Th%9c(ko4!_R*o<R=44t`sIwxVqwopREL=hJ9`Q
zMB?zQ1T%*B2u+{=mN?^BzP(^xd$GhEUV16V%(<P<x0V;pk$B!YuC7QlHiWi8r$_L5
ztP&@}8x*)PC%Mxk%I%mtSp}ovNDnGyrZ`g?5;;A1iSn-mClPD~a~k$I4SIBb#^50^
zdB?l)=aMEvhAAP#?d#xg^8t%$sawUY-I6g@=z~v+Hs2kMdJIdXZVBfzPBs2Y)u{0J
z5Ll$2QrpO~sLA{M@@Pm0%-+l={4J#xl4d&Av5~ESS`tjh);6-rs`5SwfLW~h1d@_J
zxA;wk(q+_Dg?}1@0JAPOvSX#x3u^KJIVNjl1x_9Ge?^0>;e&J-yp`&t9)G8+RqwuU
z8RVbhbakq)jQN8!SH}E&)9P*gecS3&p6*c0S+35KN2{;Sq?0?BTS$N0QFgty*5f_i
zVT~Fbttr#{{&Ey4I(_VVZLB|hyyF=4@bgWsKYY4t7!6o%$@y_7(WPH<YO@t!u;Sg-
z30V2z{|s+l;{PmZ?s;{Vk|Z?OVyJodbt^z}1@q~yVzm1HY$-{9f2}4_2+Xsk(qj31
zmob{XyJnl@-|g64bSm5R+FVcjd<QU}x;}H?v>mtqy%nz{&6xbIQr00~RL{es_PwY+
z9L0<WM@9$-%*+VPQYYK`VSk#tx~ybg7c*+YkUWS>A2p$lyQQk*CvSd*o;<juj%x@d
zvgTLt$%BXLxH(WFXI>XEx{F006<5Y6oL~O{9NmSZkBU*pB`RfH{GrpKY<@-Z^lTtg
z-8r?Fd-Vi#Tl<vYKqN7H77TQIW~JH?Mv-lagVIE31UtbYC#-PIlKlA2Tc+LrbAp2*
zlxjh#JCtH2IBY?wC;4$RAJs;4Na5Ndv<5f9VNGJzUK*M}n&2P+HML~g7s3nI&Y?kQ
ziSHFx$w%hKvxHV-9l=Su{=lx$vqUA@@mhgz{dYgYi2H`xhs+Rn<PwQ{q7c0VC6rx(
z4gG|qC`hk}$Em#1kq5l%Ya!A23foshn=;^s8PCeaxhqY|W49q%%k4y9Ss{`cyxK=J
zE!CZicou%8lrYB`&NT8Y!N2=J>a6PdF>+o04W}oNmCt?DH&(4yu9ts*qP#|>e<dMU
zqsyR*Va<y_AT|LdM`<-q=#y6g^WyGqMb(p?YFbNn3xvw3MK|8%K-#D_u5_Y3Z+ik#
ztzPMg?f!CaJAxVkz~|(63VI1iw-(iCl+c3-_I2+Vllkw2M1mD6-)&=kx>!}z`6M3;
zORxPUHNL8;50;ij{uEb@p%qIG-8om<A&CjHX&f9Ix{6fw8)7v$Ln$YWcECEmRUwa)
zk@k1_K$B(g7e$6PHrxr5Sp3I$tOZ-?;nmkH;)xf*po7_OJ@NOmVBEhy;^s1hOYo8P
zgz`3N63{o9hVTujr0~O5e-^d8Q~4A3ze-df7>3<#4=@$YA>ze1%FMq9z*T*j>2UE=
zbuvVK;vTP-ceZ0VzWqUD%arxT+pCaH7KQ^i+?t6N3LY_{r0pkznBgN~rm`9VkzeCe
z^GLsN+)A2+3CoO66Gaf908`0h2hci!sd==}fT&5>xy(2)ZU7DU3x}J8Nmw<Mg%6<V
zL*pD@I8vcS$Ponm6l@ZRR2Ejyv@>WuUIf7^)I$U@1B?B1{h$=a4T~wU78p*>vu$jJ
zcgfm_>4ne#Q4oz7jwDP87BiUOlGP2v3%~uNpaQ8qC#J+wV0fNxPrnhoAlf6e@*Ya1
zd-|t2wvCT)E?EblRY6dfC)7m?brD^%-lBTpKOqXD!FhEg55d7Hg^9t^1`|86V<Tju
z4VR+DDLfv>r7<}{>ShT72|P*7*PXS+f^oW==dsW|<juFIn35?C2W;spu(au`5+f46
zTLcNpgm^!FVs`FuL&!sH00(2~Q3$bp&y*0%CfV(}lsY0UsXC=<Pf&LRl_6YonVyzD
zhx&%tS2(VY;;cRYj7h%k&RSI0Sc9ZyG1mRqaV(A9s1?S1#rtmwS7n-~o5mpSP(0GX
zxOTp3u=&Rh`gO8MJs=$!7FpmYALOi$g)O2;S)W>i+&<)?e?qcG%cB-O>a3u<+kE!D
z3)(nb^F1Hub0w+%mu=hmbKIlL)$%Uw(ZAskO-r3JCe&`4#!ZrI_B%Mt{=+9uoa^3E
zo`J(6i5D4TGWuViNi^_rlJTKEjMo_pSShc0*eH|8%_srX2T!8-Z@L`RpRj(*PRXK#
zN=W`{CCn35Bcr4;`%tF#jk;XQNM1eHh99&8IBH1)VwS140Wm97u|n<83LJV=Go+>L
ztz%X{NTFuHgxd$fg}GQKAK5^v*Y#eyMf0AzA$@&K8i2#YKZDM{#iB<h9Z5>D1C#g%
z9mml_-2sZP)=YuFbder^%T*KsC)5G5;w~}_q;od#*2ivuekxJCh`$>g>z)@$F&9~|
za3P}h=cHul?N&@?s9d5%<htVB8MRx|s2@}>MHwxoHNjL?EIoG~F{T8^FpgJWDbGff
zqp2iJ*)b0WH5I!N_U;5*HwTElqDsrzmI_6eRl%Cm(&TqDWf+uMrX!z7^lY<FzxK~z
zNvP%(mX4~*s^$SnUMXbsL+sGI8T$-97S41&d1BS0H{zN4dXCdGF+W)(jL6UvjDca;
z<Ky4{5gbcfu+F9wvd@N_vCV?`C_BMsQa%Y~(S^Y5=-WUHpUZ7ZniTAFPA+HVb52%g
zmh*WYXGfAs(_LXfe8=4`L3~bUk@I!S-M95J+g(^e?X`h2LG7^t>q`qIwvTY3e%PCp
zAGhp)O&D>=E4ZsXrq4#H{p592iHKSmTbOk;mZiY6ZPkc4jQ$biVM!h`@96O%?=(qn
z)&%rKjzkDYf+RN^doVUDdzONU8DUv3SY2%ZjIA~fHdE^ZQ`M)%N0^~frWGc|BbyOX
z5||-U?u{r(4aKud&C2ponvO6_4FNZzqiKBc2_)~>*%Q#r%|5OSgPmk7cs-?3L!>Xs
z*sf&G(Ri-t&e6E8tj^KcuJF&%xUaO&1ub^n&e7Pfc+b%|ue{C+(|Cgg;1mRZ3A`#~
zj%0PwWP`IdX|e~h3}~{)v$AQj`?9dHl=pl8&}0u~ozrAbW--%b_hwDfOztYtVogDm
zq_HerOFAPgooQDF8rtS22aH)|z7XJ|P{Zqx^#n6Gmm$ONJCi3Gm$huGO~KM1(9^q2
zU>*Y01<B2Py&ADev%=LGBjqJ68L1+o8AVyf5zU1?yEwZIda_s)I)Et|PVttfgW?{6
z!Yw8_@{HOkC@Y^=Ta0}%Vw)(~HJM|Zz77KrM%isE_ZPL>HnkbtN@B<izM0V;xe0i*
zj}qE70kiV_5u0o3RzrdMx&E}xHBGBa$SXLjW3~RB3)!@0JXS2jcj&AsM5ZGEl1xXn
zm7`9NF5t$_i2ehF#;-G>)y}WeWZ5wC@(g8!Qwl|tX}fo&I9Qw{(|ngApf6-_ozHal
zi(~YJ_+22I#~%KdVO}h}tU!TvYq#rfZr8GI*T_!S&TiMxmCW%4R)>^Uhy7NE5>|)7
zR)=s_hp$$L{#J*bR);8!HzbWW4vja=jjnvFZD?m5SZ5t@XC1_69q4BrIA?m19-AMm
z?SHkq;*QFp{7Dv#p;NjWG|?|Z1e7iMw6CgYt(7+!R5vdzG+S4-RGc|CodHhvY(V<<
z;fqi0tIS$!WlaIqn&&p=fRhUw^J>lNCfMrcxdjhvriBHM)>Vh9qPA6Tt+j%tU)7p_
zZEyfY5F1@R`<g`(*QSZ;W@X!8{i=b5J6rqT6*!<(*eZ1QCJHTq(kA0-&He=pYx~v;
zMVF?20MU*Oe6`1STS|TV#0uhtRXQyY#AdjWdv)Pj|EzU!2*0X}A!~Y8``(gB@2qff
zR^L9qB5QV)S8L3*X%0YiVUt$vfzarhYi@<U<`{a{K;fgBG5RSJYsO#Q$pDPJeI|5t
zMmw{XW99fWdh-pb^OfA^8Se7#`RMF^dhH^=WlPMlJ7zNgweyw6=NbL>?&RofX?m?D
zzr_$5h~5l9?tG>2d4|8eyE!^LoL<A5S)0ml$q{oj6m=AV)}hS$pcowd@JdtYZds6e
zY+R&y>a1!+1!O?(n`g6UR?WIwlJ6=PiyxrgC_u*F|Gaan(6(^NcO8qx&rmO3BX|FW
zeNks=6XSp0ghh-0Mo4M;a|X>dm|6Xww|vp!zucup+&f=g>l)iL=l^oU77zX#m#2w)
z>Aw+*nrL4(HCNXF8Hdo)&6!od|B|W~asNxYZ)~3aFR7+UQrMB<7><eQzmZ67>?5|;
z<ep`0<zJzt!+^0Xs5d9@j=*Z{t$!^CrA<%giQ{utdC*U!G}O&%QO9>IrO!FT39f?6
z)9MdXoha|2K!)v+&Id?JE$Vb?>(L)Gp@OAeX3?5Z{Xhda5KL#fomtYNWm1o(DDg79
z73b-PTY9yunesy541F!>G=s57t|}Bq|Fexma+94z9uj4w-a<3_NL#<XC^fTR6P=@V
zC!9sU1g-T?wF<q2to6sW3hDKo?I5m`bPb>F2&nafTUw?4g4g<&Ab3(;L51DBV)q$G
zwkKBaG47e~e+2p!Ub5Vw+nM=S-;IdRSahVHNvjH8l^18;ETK85o@$CO74GBjF#@lO
zFCcfwdq4m6dz65`!b^$gOG$Fao=9h(z}wvD=2ecAb4hqa&28*^BZ_BxS}VP0d-?<Y
zMMI#JZw~zYl`tyZf4bj`sNmOhA0b+ECH(oQX_NLtXRLs|;@6v{t+@rUb^~y7&$_Tt
z>?W}1C<fNOLCjPl-uEM6g(HV%*;=#;gd6UCXddk&MGL_%m`#h1^;g`KFeVE02JG`u
zHKe6q+lIBzKo-BN5KISA+7N08j$*`7Zjn1>!A-!CfN_XLVYjLtr}Pu)_a`EXS9IXp
zr$9r}-k&hNHR0P^aobzr+e?y{7m}AJWDi$J0iSwn(6{FRFv6XPJtdxS54X%PIS4S&
zMV^7mwjUlE5dxJfpiT^!oIdi@nKf8HAEH2INBGNQCK%yR3ETo_piSm5U)6!LlH(O`
zNsCYB+?wFz@fpcsl6U5ufZ(LHdz>qve=l?Kmbb(c8Vwxg>m1w5+&ptux_}lmF;3d*
zW+F08?lDcCXlHKOIvXtQz6eL%JVUuorihWV!Pc&zS=~mD2`F#yE*N($hN43lvN13d
z0)8cZiOB^i<q^f^5^3HC{sK4Yxi~QA6HQ9HxkB$$Mqu5%Uw*L~pldGPJDt3~<U4)|
z8UOJjOa(#c2rs}yZTtKn^!tT7mTF;Mt~^4iTviHgYN#VY9CpM1ZGVI3vrFRNt}-Be
z`LlEgW5_wC@%=<@&UgFy?_c5GTuimAFUU0lYYcA<voiMhc%%h*zRFfTxE#8W%d6W&
zh&yPOap9?n+k~?<;U29oI(wZ+=?=zOaw2#6S<9;cTn=>`tYifrfDyV^MnMs}p!<|Y
zMXG1-rZ<Xbuo_Kxf2zNXIqA^pob%QWWKxApm^|Sf_vf3taWuDyfy(}SDX<85_gMjC
zZ^oWj1#fG4P?wcGT-BxU_9V>1<&r}r5;7mlN76QjUKZVVg-qX);WCkR!~N4HhAhfM
z+(E018nsPA(cYKbQ#@9hZ5V^M$$!_VLqW=S@8dm1Fu_@bfGLVyq!1WQ3Y4fW1&U{s
z0&!b5qNa^oS+Xb3C>7Ec5a*@DZf?+=K{o7XC;u~cp+@z8#sSng|IgTg8rT;OiFXjO
zmUn|qA=<OE4cA%Wr|iT#oO(2afB0QC-TcvaarTqJm>I)QpkXS0QLu~GC9iNQ$_a;x
zfN`!z&|`+h*ZAV96bnsG#hRn)?#}$Tg=mqT>Vxw!Ee>>`Y6YJPSjdJ85m^T|EoWey
zG+68FS9ye+Tu>GI-KO(zpzqGej|Yf~-u+5EkuE=~mH^Sowt^tMMQ{65j|nev)D9<O
z*pIr8O1)or3FNn_7=K~aeY7w^&J0{&fvec^V)WaqJt#7rAd2F0L|g2b(Y}!~o*;_g
za{TxQw4;3<CdS@h>B6&4?@3wtg=d!Dxc~~Q^v<SGSfqD8){G#sOm4c;{5DoAxAL*V
z&m6FCo3GJDqqA>Y?<p@|qP=fhu2Ed9V{X%~QEZ`YP9KG+o9b1pQD0w`z%@p%)A0U;
z)Qn$P3w$=JQr-iIV7N^#2u>}0&FFSTn{wrx`v2?m`;byjHr5IQoUy-*fD>P@YlvVe
zQZ@sGT=Ei2oFq(d%BcFr2=aK@Pq|6^DS&Y1@d@iUv<VWOpdT)&!S7Fa!;(wVzoS0w
ziifnqJZyx#98h)>#c!d59Z9Z1B#-*xFV&I(@Yf)ONBx+WYViOqif#trmL9~D?;3>m
zI3X60LeVV`+!_R5P=HP22QN&bwy1Ht<(UFp83R&uUYJ`RCYm1fjjuqnyPnB|7dBB_
zT)5qRyPj2p7yMCM|8Tp#al45a19$*02f8l~^$$$7sZ5QjO!cWuu}-Zk&;uJ0+P=iB
z*S)`z@?9BH^zWpe`n^~xxkx)KpJoleLd<)osl~HZAojS|g%rvt-Y7==;jH!%RLu)=
zmFm9vx7T|M)<5s9+SJIWO3zzRyfxjs6~V64uimEt0`={*=e+stL~ZM#rOA{w=D!z|
zsB91gTl+s)mB1^e!Hc!Q_cGfWd+1_y(q0SuR^6AeV(I76KE1pf=jU|z<uio%$xRFx
zkmqP})G32eS+SIN6;6lKTJiDxSx7ju2Oqr<s(fLqo;eqDN_x7L^M6hy%13ASkMPSc
zvil&s`Vy9$VJof4x*Z|A9XY!lvAG?oW{y%GP51NWgo9P2F!L2LdwLL~72nbSw}U9n
z(+_75clcLE$mwaNo(r6qF<C8ahuHTvIy(A9Ae~xaXdp5CsT`zyIp$)OfpE<z@1vWT
zSe>V;n6%GDC*JYwnt-L};d#i>@bKZygRS!2dG=$LYgdD-g<4bWqkS8(P5-z~-n9xH
z3vOL+w&UT7v-yDCjsn|{esoi04z5m&5m~Cs8kw|bt;72Iys{K@WwfbXqyD%{-3c#2
zJ$^HFstTgAoZrI~p`Qh4GLNa6<StY^Lc;Axkeyvzsj5OGNvZ(DFR?@|eWaR}wcUq9
z6Qggxh<Ls|OFN*c+$pag)tpAGAC;Wuv^f{l|J)fuAAL(ET4L}`z&ktrL3|dCl@Hzg
zC$RE^^-!H5)jKFCPZqx0xd1dee36~rRsxu)#F{@<ERSD5DxQDojj4vd2K<)cS)M#0
zEVfcxSYNh&ls~VqCuM1_d?-b0K6R<i%)3B;n3?M$s<yANDV&7c>=Vo<&+96%Y&4EL
zDY%qMnfX}Frp1e@XPWJV+dkyC!}#|ToarwoT#zR&iluB*^!hhyBNiJX<Aa0BTf1v!
z4xaeu)VBDJ;c;}Pw6<(C%L9J)pfuYN>2W=YAr4or$JDe6FzvXWEDftG{9{tu*ofu0
zo|LfVf!Z}SM+&eewGCg7<zUF3-e114tXn<fX$%T_8BYvQP|J9#fC3=n$rcKl{Q+4B
z8$Rgm=ztL(8|tmXWWNTj>nekhGu~z0UGJ+9b`$3vMtAvh9KMoDwD<b4&V-Z{(~&XZ
z-h`C?IPL526ngxANiozc@&l*h0vObW2g&OsSoIoJEl7v7Ef%_=4eM1aIej{?Tp5vE
zYX`_{dB|(kA@=v7RWBk)x*9sm9!M)V%@Vv7`o;pG4G1BM62>6W9+I^mEr<)R6Yiel
zDIL19o5U<}6-4HvJ@||5Yy%zmmndw@258MOY|H0<^*h5($mNHH@%n!*2Wp_FOL2kM
zm@@xWKM3`$Y)8J!^Ad@@xM6qWS$wEUNY0i$H$QM@2c`{!jVws0{nNaua?-+OKXYKl
z8;lFeM5cKMLfBkIynm-XZ}0oBgSFOA52XamNw=kR%}F6rMCPQsQnu!#2U7Cpq&rwi
z-bqAEN&eA9mfxOv<LEoAlN%Ebruv%7ow&uma*$yF><fv5esi=36MvbsXcfV_C^7O|
zAeW}ZSEQ66Pz=o|6XaLnli!;GCFu*X;094S^k#<dHWns@t9dad-jD4F>0aHzuQTt)
zzX_7aA?qsk7wxF#RXVhtNqlRAZ-Wob8(#+Jf0{ZT*8K;8Kl6^Cc$QWZQ`4P~XU?q3
zwZ>hQ;*gRJQ8<_pSO8N!rWF)By@k+P?j>SpH&U44$8A<;H}-XWG{+4q4@HrvOC|Lb
zesN28YVOT&y__J#_e2=j2%kw;VId65FeYJA3$VGiQZ~2zSRftJK<qazNt$MlUv>6N
z(e@E$4j^1C@P;!tOI7SI4?E}TvbM4yDCen}%ekk9U-8GugS@D**~!DR6hZ2b(_LVK
zcWEI8Wak!%V7%b3fQ&LGXAXI0_x8x+gPDFbNK(@W>l&lLvR^ujI~<c=C@R{lk-)mg
zius!*Crb1jhb(u2;s~8o25=^to92QeT|(Gso(7{J28=I7lu#FKk%&oPFFM2q$noo?
zqYTHdLX=q8n=vU0bKb)>UpkaBH0RkKavz;M7-|}I0LR!SZTu$EVpuyE(iolG8A={?
z7>^Mib?A%P9Ca9tDGcLin~`5pb)aI%8jCS2%5W|Sub)EEL|zrtCOBGIKPo-NwWeNc
z@A>z2=QI?Xr3X6)b<m1{{KiY2>3gHO3L4#ou$K$D@Cr({;MAZN(~sMZ?m?aeSdlE2
z%-72U3cm)fKUbrbw|<PKq}oN+j!<R8ZPb#NimELYa#p+V8TA+*_2?h<7#uYayJK60
zA6p|BTSFdO`#k2$_ooH!&pkWiMUnQVIHMzM<-bOuMP5=|zjQ=Y;r-g}IS;7H8}*jp
z^#>`l1i|MtOQJD{Xyh2cR0!L{`K*1c5bh+?{&yToh-V*+5omzz26MZc3zwVnkr>7v
z&kZICkr-wIl^-U(rfyOA2*K*tkbd6KMiHTBiuJntbSp@2uexAJpEd?GN$9EX#d-XW
z64P5v7`(xW0J259Lu$ue{jpa^cLcCviJ92Vwax1ct`5DMN$s4qEJs+@LOz6HZNg7$
zhxQt$NdSdNCmI{>{S^8M{|wmq8X}#tTd+hP5NBTGI&h&naPfKI!g%0<yyrq}-~x8w
zB4EIgb=Q-0*OO(}6Egu%`Wk`U+mq6pT4qy}>Vlc-LW$}EgX+SA>Vli<LX+wOm+HcT
z>Vk&K5hh`YbmSx)vhf?T5eWGwd0mZIwqy(Ww*Ur-QC>*JbOaE3zj9q8SV1-l<2@Us
zHkk;$TWla3#qpjXsZC-+Z%-&Gisw<GtocrP;SkdyM(FJv)8WgxdcI%<QZBHsm0Eix
zw8yk+6e^v$14^y+6WYf?N%_oOYKyQiNn=styzSZcU*_avQ-%xR>Ca{IQ28(;=@by-
zN-RnF@(lTWQ6JxFb#ff)A(DsNtw<jq$|<w72Nw98E@#8V%#*5K;KK?r#wmt`#}-s1
zJ+{O=wxm45DL@}q{83l@u~z)yR{V)q{LxpKBs>fyJq*P>!pT4^lpq#z5DNu}g$y)B
z37R4YO;LcR$Uw@JAZ2opG6hIEaGsXaBWHfuU(WR2I%dNXN*0#=l}zuwV>a+OJq)1{
zS<`#-m<@75P>t1TS9zUoaouzJ(D?}=$PvoR>Yo1$RZlMym)AWv51k7Tf-Y=MyGrT=
z6ihu^ht82=HsT3E`-GqZL65DaW#Y32fmO$w*epR1L&7OZ&G@+$c}44K7mJxj$_8dg
zCBkX-cMoFaX>G-6e8cHfuhf+M;=a_gwv@cc^SW?+O0&q5fJ$Il^)qIu0^EJY^sDr?
zWyjVu^k^N6cQ4`+!cFJ5SadYy5#FD}nmY&(IZct{EZuXPCfCGcoZvPLNG#T@Q!oJw
zm2>c;whUH~PH?Z^hq09qB!d2e5k5|GtA1geguX=EtC6YgktxcyU@uO-3Sq<*!vUqE
z!H`CkkgT)nh?-tgLnQC?wdkMU%+Q@$FgE<*&$~P}sA>0>w$C$0&--XwpQXU*)gZ^v
zaTw2&nGH_^p@3<dx6Yj93x*{@HRqE+gKj+bImJ0l@kN)p+X7%y?<<1ad*b1n<;3gv
zt=ECk^9FiQ4xJhC((9CX_IdleB$%V;Rm$z1;UVpml50i!aNvY0boM_n?EUXbn%7Pn
zH(g96{*OMA6y=%*c|`9jF|_g`@?8;(Ko-Ce`A(b?39obf&*(<^u>T-uvcJfLx$=vv
z6I-g{6FWac&P*C4K*|zGAytxS5UoTx7_CH&$<7}NVS7S6XQ6&b?Dd9urR2rT{n6@N
zS6_l)3FiiI;ubAIgc=AufN#DQPD-Md)Kkbur`wr<&>z#4(d@C9gVAifOw#Gc)yLis
z?=MDqz!hL5Q);B70dk5}D&t*LV=FriI)eov&sJ2Z9mK*X0@$2!TqJ%F_*``qK=7cm
zV_M%gY|_^EKT#Ij`&ncpQ`<tadr{?&l&-$1%Ys*5#$X=`v}~W%L?M8;{+ZvXfz%7Q
zL~JsEYcfE;*StCMr`NS@Wz$))4aOYjCwJ`~<aVpubS#MK*(5XLXzeDxa13D?EJh;e
zEeK8uS2VzAw({OQJ@jrMebu3@gCv>UZn&)VCnV}_Q|EdQeryaC<3aUq&In`@Z+60}
z)d0JS?qjGwmeh3NpW2IOquzV&zMf^zX9cv;>-irG_#F$V!~Y|~mmhn76=m1s7u>2g
z@x4kK{32{qH@b8BsXm!#Qi*)ZwSR>g@<`^3H@b-~yM<*vQh-^SdEp$_WM+Gz&7h|i
zX?O(v>pxY|6A)|vlKmnN=H9mCd0IgYxRV5{kPugXJqrfk1(%>UUhrGkcLVX-xBkJ2
zH;3NeZ$BgMyh?ml8!x!8xW|Nl_=<Z?;dRa8ca794bf6q-8t^Bse8hQv>PS_j058W+
z!ll4Q211RK7_l0MvNEZ7z((GdF}^2$@T;+tY@&R(yuKWstEJp0X!|en=y0Oh8qVw*
z#u}@YG2`dpUkwYTXAH3@5zXZ&I)Md%g%HL8)hZw`rLXkaX&&2gp3{C_{pWu&reu@w
z(TLil4Zf=qBN<$;7TU3%oJ?aTt)=NsF7T`Jm5zbf?9m0yQ0g$TTq>YaZd|CgI;T=5
zC6c1OpA|uYNbBS0YZUxvm{|Kht<myC_*g_%2Gl!tP5b3x?It5sQ}aH6xunsaiFwb^
zU^y}o9s?Q?UIl`kUgez8l!;EQWgXo^o|vwq4pg&n8?QBEa+6#7#26eG&;Z^H!P2Nn
z#K=&C!)m1pAeP~<fB|r2h>|AN@F2bjoZ#07SARMYi~ffu<0RxLto^U!(P$widDyPw
z2|5cKe8;p;e&)olrtVO3$s0J&L~X}~VHu7p@eR0pp1M1J`e~}MY0g?OJyviDFRX&W
z43lT;U&!e(ZWgl6M-z-Z=(h2PFxDspHU=VGp9<J@yPg<*`XD<Jf4~ZQBG$SMl^M&W
zGrs>aEH9rh@8Hjd0dIVFC8|%Esh|Psjy=<yEms%cZw@|Mb}7&ObbOy$iKI=*pL?dI
z<=#;LH}Ux2s@w&fFu^Yzcou$;yxx7A(_B_$d86fzgYsmNNTV3cbffe(5eU;pP4VGG
z^lCZz;q4y{leRz1knNJhtlGv9GBQ;&H3PDJ?VIv7j`=*#CpuE_)(q|5({C&$g$|!5
zT@J_nvwT;jlbt}G(fW)Xt|s0%cOjEPXPf<P8^eg+^kZk7b4-yCjmx0ms{m4P4hJ(L
zJSN1N4}Ne<D_2jDedsJc^ik4|phdctdR;i3>G1ASY@K9?`QT24JA6%Iv{fiozt28L
z!`b&!#?aX>JN_2=6*LD-BZk(EoR|X-5sz;z&-GdB%wl8IeY)mk|8O+Z;-8UEcq#Ak
z7VD%)$SUKdm~j@JC^4}YSt&8UEUHjG_YvAbdiw~?AmqE`lo&XRFqD{Bnm;Kq@iav!
zNtr6Uq)5mszfi`FR~&gV8N|VQ^CO%fqAb?opQ^Go|M1cxY*IB*pklF^`hLX=w9Gva
zp2bcLX6HGUy5wIaJp(0Esnam9u{3}Vq~e@5jtV0IEwyyROrHK7zBJ|xY7mFW*3{Z%
zaZYwZh|ZoL_NXXA8WG&}X=cz>7I;v*(W}G5*^i1K&$i83!+@`yodjw0kZ<S^a80lz
zd}#5^h{&h>C`bZ%ab`xL4b%%17D$|O{sp>%DEacwcv1A$gtV`LlP^3cCN4&NW^jmU
z=WCE72A<ZjY+lmEf3XWkYgRJ33bY}~*24LTOKRg;<gdmCD1U5|$s@$P)(ibh1&sQv
zfsvQ~DVJXdaR<Wbh7}*+v_MCTK)3HrEG~-_m18gI6~NsWLB^tjq>S+B8hVKhl>cNL
z@<}P5S)iNsCmkqw?NBwC$->j+S?{!7vNCK9bp^qJ#mLjuS6FxI%zNJ3Rp)cdlyTF#
zaK=Xe8Q-aaL(U+#%d<jr#9G6O|GIFnP|w-iiiJbYP_xssy5`iG&MCRWlo_V0FM{p%
zom+GA+T1d?gR(hln^36G=-J3`tNL2p48m**K?_J(AO8|~E~IH1JQv#31Lg?f+5&Tg
za!r97Lb#T|B`6i{68wtVmPC(k##!bNXm}0W5b6$X^Mt(!?c*e`T|(#`TWdk^XlFdZ
zdCk{HWD9BQOLu^H_klLSH=$gEVAK$<6)<Wj*9bT&#62>83TN><B@6E2N6H-9%EV~D
z0Cn}G2FWhN^C}Ph9ertCrjtlzW*D7cZ5QHg?|cq~@+NkFE*)4=Q$jMN;K8V>94VYE
z-zTC>?2G~Y%qaTnqRfkp?LCBDNO%V`eMMq$j7#X3q&4kqf6~Ip$Uh^ARZPd2tr5+$
zCzqQO2K}+N$~BBA&NWX@FEvjGK=snNvA9SuK9NqD=F5ISU(G*Mc^wTbkIC6nDS6Jn
zQntS}myXVi)UNa+79Di|tk_S;coBg2%h&z{cWAq>4U)0+I-N@Iv{E4rqbLgOl^<&n
zJZXdlBwOeftuSlZCBm+msnwykDqC5Rt)ruO!a=`HJoL>~3PhjWH3Sq+xaJ^ntord2
zjVO?!$YT^>w~7J_yf*>+1Z{D*XmR?CIpO_2il<-?ahzqr?~E8Gk}AzL$F_?v3A4LJ
z2*WHKPS{ELC1awR3|~`%J3egaLf%sHp8xi|a*@7}uGfrv7^1URuN%U;;Ivyp0;uog
z1&5e%Hs$76u4)@Je|3D}0wo+Ii%IHbX~Jq9`xzGPd59qfhSyZ>9y=QrbkTEo-%Our
zkkx3G)*yJt$Zc|w)kvyrAk8<ymY&RtR&krR0SW+BD)78M)L&3ER1&cgMrw-_9xkPA
z{<fc{1JJL1;7|C0JapPi!Fs{9c0ukEFegKt+O}?$i&pA9Z#8v*4B`qdvY$nw8%WnQ
z@HR}~k3lX-^EG{PAlcy7HdC?}rLJ@i3|n|-d79s2GZTs`v^c*%g58gNe_s2$ege8%
z!?sBxLjH`FmeTO55Byrt<*4ckLvVog&Zuw4prW&B3DS!@C@_2DZfr1^az6Q|32zY#
z_v2Hp&U<@SkQ3aZ!&*>jO<9a7wB6!Bg!lSC*AKs2EX9+MKIAeNlT{;nhX*~_0zD}P
z&Ocsx*fk26oZ9Yem=m7G*3O)N^v1Kn1s>=lxd+oUh$UM4R<S{B(Ao$ake5<Dm1Bx^
z=OzUXr8h}@`l@Pb6zOJVDYBeiy+nN^xQ_{eo(!`@qBJ<iAhAV?WPDXwierGJPcXSY
zQ9>6YM5uHnnDaui$35LGi>7S`xNarmFrRe3Ao@?8uLEai$S#CPZ1G!&I~mWnkPOky
z@BmD*?)y+h=WcG2cM-epdrQae`(QuO9WNM2@X?#7%R3o*le#_A`et9(!JS1%n~qn8
zLTfWp%_R7r@e#>~HUfL>gqZM=p{USDY3Kn3uOB7`rsf3K2fB9eTsbjC#xM>&DCJ$A
z2?!%|it`@6L7_130hut8v?T9=O>_9{jFUh_F7b-nL!^b&7}Ld<!8c?L{is|_I|?nm
zsxRFXA|2vh9N$u;SQuBVShyDI-X2dXpP@vmoS~E>162j6epy7L6v^Vw5~i%QmU6&e
zRHqcl;4TxU?I4kIkjqfdf#w>1TJ)mqPSv_P{@(G10Kr9bRz|5C;17^pxRNTkQ%jBB
z3aXTz2$s1qXDrlmBks;WX+3LNnRjm}JF%GSm?-wnaAy<#zMnFVp9i?7Pl;qJyQ9Y=
z-EBC(@^VuXI@dON=^gq071E!UW7XKBUxAkz$Byf{La`x&p7!c0z;1)krm=9wKt`(i
zdP5Jk2j73%eI_*7$a_4WegU9$<M!7`Hms~p;+Z03a5{0>T7P0RIGml-jU;=8*)3T4
zq$}#6^~p2PPeII&7_x_Sr4sZYps=Zw+<~ZY?GZNeECi-iNlZK-{q&b8eH<!r`kn*{
zAhZ#Enh21>7g;OT4_80yv+SBh-dZdgsKFLk<~L>Icv>w_QlBp<UP$umQ>^eA*Xt<Q
z6{!v)+T;i4HB81QC^Q)o;+a*~DA(fYR$^-nZt^JrM0v|n2r2)54~YsBr$!Hs4oPub
ze`Z*C{4L24>4c6e&p2BoIE#vPg+^@xQ2nmpIyl>AvY_sKgRe?7R#Z4|%IRtRue`DY
zwqDhIUlBNEQi)lh-7N`P1X<Mr*Dj_f@3}YqbiH&HVmCi;T0o~a4o>38awLet6Jtb-
zt+wVKeUuN)TSmql5>qz#9~6n{y7+80W~$uW4Fz*_+~lVp9e^x!J{Q0IRA-(!z*}UE
z6hU`*jP3UtGfmlroumm5FooYIC}nPHkl2c33ppd2mxRLRNhECIzBLOKFW*_EvlMl1
zuPO03@NTqnZXm5P$PK?oN1n8t+2Q=#(NwKzj!bq?lZNb{{yv3Wsia8w@E92h4kt5|
z%x1oNL882_iv)XM#mDvk_WN+nHGe9Zo|AuI$<{3DwHAF~`G7968uzdtpDE)#aDU-(
zOewqwPwJ0R53fZc%kYldHPJo2vploY;?4Rxyh6bN>B^RE;^2S!0J*?k=nh_w*o>pN
zct=Wj&{zdN7m>JhkCV9k%&|@`^+UeK9Q~_B=2-^wh6N$A>f%XzCp_~jK;0+O$M;n<
zKIICn)4B<0*jot5E4yo9&)YA!=_K3IobG~sj19VD0(*W2kOtkcj4ykpl`wCGmN3W7
zl#QKKLG9odO6FUu9n4mz9QsINi=D2;d?)^2FIYCX1;ul1Ap(5mbOsCQN=hI})mkD_
zNzwD6Wa`Fx)N{_s02vQB&+BEMbI9(5-cG00DFpcfp7H|EXA1F=Wc5g%o3Y;6h+N8%
zz!SqrzI85m;!r7?=}@Vc?A*;V#hG^Wz{&Eb2cKsq`}y+emvc8$hSs^{iCqi{1_iHz
z=z{8<y3RQ!!7$I$OZ-je5X;Hgtk+O2J4orJAf+ef6eKI?QeiU!xn=|`6tXl7MntM<
ziN_pp(z(x7LAsujX(ClUi})o>H}nVT;#+~|wA1<5X!om>@t+cz!T-9+C&|gShX1`<
zzvi`OTh0gd_XE7bZ1QI2gIw{!m`*z|0Iybh`@`S4jls4m8%puj4%Af9qULW)7+={G
zZ5ZX<<hIqxBQ1FzkV{Wqu_jaQ%#`jfC@v|0-~OT>A^}O&9C=0H9zW00Qv;ZX3bdjp
z@HTH~NILr{1inCqOZkADapDI4K?t5cCqo`Sw)r_PO99mmXNR&22Zo=;U#u;7wDL+e
z$wYqqehz%mGoOZg<QZW5?Sx&h)<r07m=*ISxMZL(p9-eg$`Fw|{jvt@!<{5|?HAxr
zt)8c#mv9tw5uhOjYfj+566UY!yx~uFWEs6#YJV$XAIt(T(-qz1L+|V35m73dnh--(
zr4J4BW_r!sSPv{^qU}FrbEZp(PvnukN2E*0xTXf2sO(@MK5}i6%H79dh;ylhmv2<W
zZvNi(57Z(ayd^@WROz~J##)U2!LapJ?O|q!uw1QqS$SZ=lMd9^(cU#uxp@Ei3<<bZ
z{weO`BMZ*1sc1mBUfAap)6ac$dJq1~e<LsGfFh;hd>9a6brPk~56RNcz`yfS-kgQ}
z4EyXd`?=RMg@QD{)!Jg^yaDP%f61b`R0%4AFYOWEjLR{FEpVUhO@NVR!$yp;9rOtM
zz`yw>PJ)FlpO2BmeLf_wcr}Kuy+o)R?_D17?lh%7@v_-FekENTl?9GU5K)duUH(i@
zyc0<;c$e<CUDF|JGNk$L6Ra4b-WBA<UdRZ4g)PIz`4cTIC&Z)p2sbOAl7FS~$P8;}
zL=69j{?8}NC7h=Qh6N^p$izB1oPlq^dYpkWpv$M-x{uC)KnE$n$6_L*Iro4cy@-nH
z^Q8@vF6%tMChy*l!<)*i?hu5C)i!XZ34rt}qL$+HVWQF+Zf`vQ+x%Gweauu`!qvo^
zSowQ8FWKmhq~%;N6lJ4v7DC1bAHhcc{fh|-8w16XVB#MKu8>sI>=Im!BDdMuB`t$P
z<CcZ1&c6>~O_M7EmRmy?ODT6X4eKD+sg}j3F2}3}b)M&@E5O10Z&s;AodfLpO?KKu
z**|;{cD3UX6HKljzSWL@tsh|@PMr9|7du}+Zl`9IW;$Xv_Emy{$(3`(B&`6fIrdey
zS;qo*#UYInj4}3A$pc_Pvtph`PzYw98*v!>Ds`uALAYX@CNUyB_Er2&*MgqUC@pwI
zZ0zfI3>^y;KD)FL$ZvBDDrqKH7(R=%*Nbw8J4>lQE#e+U)t@kphLCVD&4!$CXgMf<
z41OC2t6Y&;6jpe#a)g!fCKFiGlk`RB(UXiulhZ4iN|i^3vzgXL&ZV)*3=)jXs5;Yd
zBxnd`62NH)1`)uiXAVZc(UXis2hfuYMt9MZOhgOQlk`VZ;l!Cs<wrK8&FBv9rOwC?
z?xoHA7~~t5QMvkPajSCm-NNn16_tgX#+8|co9Y#|#XyCZP2Ln1@#TJF^SCwN4BxM>
zT}C>C*E>ycy^;I<<%#XRWN%|Bj_(z=0dK3<Stvp9pV3Sn*adwh6>=4fqA-O^3D6!)
z{P|#+%YoPCPd*g>0zzFVE1LW0P8rsI(r$+^ALrUi0nILcAiLi=qUqJYkt)JD^<yD=
zVFP-RnR-E)deNDBA(?u=GxY*9GvhKd!!t9ZGBblS(I{wdfQb$9iET2&IuP2i%!rT-
z*p~FX8EcxG?xI~CLUfm=#i>O=PDzt+X;VP#;!_*o<j}e*r=}_3*Wyzs-~`XQ%CNF2
zAY$>U2mng4W-_R5a*+%@t!eLdr^Z{z9YB-sD9<xL@EwU8e{bghGqvhVAENaabth5p
zd(ViK;3GDxQ4HpCpq6spq0-U<tZedvXmTzV_CYD;wFV5;mj(MT@L#{|;K)E+Wgs`?
z5q{heewXH69={ZG^$Y{1$*2AEJ`#Ss)Vz_`vj0%Ev->tFjFf$_3kyRUyv<kGwy1PN
zoO}S_nXqgvg{58F8*vYG4pwjtR<P}q`=5;WJ@qqcVq3<yf2g-2-0G!GEG0-E@NRwd
zVYXS3wcDncRWhN(Yk~zZiZh7vb$t4~_<7%nME}{_?aY-fy1}f#JR9~T00ZZm5pZvv
zH1aKJL^f#zIcdZ>X@o6lL^WyTbJB=$(g=Cdh*;7HY|=<T(ui>5d1q;|kktlgrafx9
z-80Yq;`_<wuf<N{DqkXcYX-nQZsWQ5b%VJBO}F*|jc8ZIqhooyqs7|+J@fpyf0V_!
zE*F=>+_*o;;#`2!b*n7xnR#M83TjoQJ(DOd_;R^!m3;H-F200I@58h~5h?ukQd@jU
zncf!%CB@%fT8l5S()*O5r0CmAqs94@jm=Lbj(d*rErmf#E<D~6g4dh$nVhBdolvJg
z#Ke~$O@z#a>as<R8m8bHZx@4Vn4MG+WtKn7K2Xpd=cnkIy?HJe8n`99MWB*qo`%pG
ze#p{`musg;zI{G1FRC1q(@7~Z*3%4g){(1nC_|_0a;-BK#Lwq)L=W^#i}Gn+taeh}
zT3j8|<Ak|%MtZ}MxzS*G41L_vvhMn;Ug)Cy+i<TBQ+n^}=)~!^JVnpw4Rc|p!a;I#
zn*v42qc_n}oPWt&vU&{V<;_P?1Cm}2=F*9`EvHyAlO+7pMWG+XaII4M>;~(#)M{m>
z1>whwIg9KVl*EGBLhpS?pY>al_h5e?rk`lp;C!Ey{K30ItlR~M?>NfoINIn?`aj{-
z(R;$eU6s(WYM5@W4$9ct&Tq>aP-On#@#TFxA6`^m)aoKXG=L?Cu8Z>c&m&X&A&*tM
zVS!;lXn;5B>$Uvt7|S$^h;%phQA$ppVL)WSBl6S!@KFjWl>82OgazzB9|d3ZR&CA+
zp88KX3Qr3jNKBXt&k7!xLSaVm;0F}u1f{G<ZrTpm453hTz}CVU_b7LhTEk`dD0LI(
znD+hy=Vyuc(EWA9ZjN4K$d~(pFYl;6zPcXo&8Kgezxo0(Yr3oqW3ko~)5iogv;q2y
zAb4A7dj~93|9$P)@F>mwJ_aFt5(1KwZ-`6*__})3v;E}{+8dmU`8+4n+0;H`djkrg
zYp*?$wxF$+Hm`y6`#3#86eAz<)STL_ZmHVRt3QvZX%1;3{ox`UdjiR@NH2dPf4U#P
z5aHQx^Z4vJzO4Cwc#BitH1*uByb)aI!v8*rU^j_i51kW!7<~Y?sLK9@ZMCO!4DZo@
z>&MfpyLn*2i|en#+F5Kw>nZ8_U5g>A1wf<`u0qGkk@{e1&6N7kXyF<K5H$e6(Lh`7
z;wxMrBFsGp_BQgfrb@vCTXPw)R-vF3YXtVrqoNfj|LVOpFk(eVMEC)9(kS==kgXIh
zenluV^bM4Jq!H#a+MQ!feYkai4*LNbB}r8p>m4W|fl@{^Umv`{uBb;GSZf{6o*!`n
z+tz$qUmH812=Cc52ikyD?q7#hMu*0BF}wgX#Fw`uT274#0^4QBk#TBTew^z#q@7DR
zq*bSpaX$K2GxXIDRvKD<jp+=+ggcROnx2Ew7p_o+BB>LiVAT#vJm5UAgez@Ef3QjK
z*Q^ZmQ&yo4cfC5bEn-B!{iW@ScD+WpNow*#=me+yNr4;j>YUGP!x_xu)OpW4kf$fm
z2M%qUD7XKoR5?PB8q7@Ihh?Pus$oeql)%Nqd?A!H?(KZI+`qx4FBs)vv3a~&5zM1$
zaZbr}1yrNUYI)y7R1YIRdoV_@Mn)-d_l4=XHGdW!ko-z^8ihoZr<oxQNl=gCj;gcz
zF*}v7*yCzt`q0dFb66(DX-ryL`%R#v&tkkaclTgW={u~P;CepkW`5|85KX`}lQ~o-
z_2vFKI2;N#K6G~29&z;Iw3^E^x3BQE?B;{AZu<3ZVMJd)tDJ=4`VT-?TD`ZRJW(cS
zJ`BgX#KTA<ZqIOQXAj%c7Ted+$MuHCwJ9mAvA^5nh@2m6#YSac62V>Zq$d81{`0eO
zTm*2iRpACg9vLq!+$FqahQ3WqkNOTmVAG>o;j)^NB!x+i&gJLL<(ISYnC}^+ml~2w
zs{3MYNK_PD;SkUjQ$H>Cf2^GaR2<E=@3Fz%-8I48-8HxdcbDKkxVyV+&_HmP!JR;G
zcMrkg@f~?b?zwlJd)`~S)~;Xu_wK1)Gt+B&y1S~hwZds{?kGk@-+z<83m3|hs^3H%
zE!R>Cn6w@`^q+zT!3fN07@;A?F@u+v1M!%QLiMOtxg%H=dl!X-mqto}c49SWqKb5I
zJh4$CoVy;3&@1unjtTJbFl4(mgF$I-NhncVuX^69kt=+Z$=lyIIoDcnt%D9HCGc0h
znb+H4W;r;>=@aF@9U8JO76xrvC6sR7D})yCp<0}P&3pMzdkL`)7W$5;Mg1m=z*Zoa
z!B(L3rT>{F-)PB%Za0$)dVsp$gEAkW&Al^~<iol%mej?%GnXX5qG2s+icCtss*8ML
zE=q}fVl4`Zd}0ynG?;rm4S<JXE{ceRVJ)hUOv;#%em|RftBQnS*&)M1F_#p>D$@Yj
ze?zSiYr%yclpQoi0uV^wB!1a{Qy`La!QzjO`ohfvrBo`$#Fi5#mPuv+XBk?oIYiP0
zw~O5kN4YC%LNPX4V;<_(#Jfrt6t(51$<~TH(@GE3-wJ{t6hj+^Z8?*UFey$JP3=o6
zxzD50zH_D1S4N*!qrf_lN`*=t9Hb>!l4g`#$tD>b#05(Y?UC%a8<sURp{iqnU&000
zMprK_y+LYKLPk?2L0`W_WGi1NEf*waBZ3V%vP_0@rAA$GcGxmHgRL_Mb4`k*7PSs}
zSfTHj)kD9j!{mON4IFl1nSloIC^d*EY#Or$$Vz>}P_9xXQ})=;0V*{mU1__a`>@G)
zuVz&XEGo<p53d5aQV`CeOXLf7f!?wa0Ir-N0&YgOoT!Qbe#nF!VAiB_=(aq2INs$J
zq8;s|snebs|5%C|BhK6=7wZ+5IUfU@Yy(u&;x1j+?g;T758OHP+x2sX{_OZoi$~ui
zGiVU8UB;y)9gaDSV!Rc3`~lq@q~4c9qdcivcZ(8#-uOEEJi-9yNsQBI2fAqmHIgxH
zlEcPJk?w{p<&^Y%bbO;)DjZxYl(?KA|0)rson5d^Mb9WdDEC>PA?eLYr5m$0X1SHK
z>=?>N`76=0i|7>>(3^e-;hFPwPj4Ksqz&sGqI#sRW2RXdS(BWSjRV}BOp$l}fR_S3
z<g`d8(j$o(ZGFZ+dGN7o3ME8?<Wu#oaUhZ%77oJM?7mAqEOV@Qw34ya_tC310D@ll
zjw@U24+Um@1ji2hfvYy~p%X8{+7rhP!Jr*ihFHzmom(ryS{uiXnxRF0K=*Spr@p4m
zj%y63e%|8H#~(u{I(8j`MKM2Ie|mhbjroCe?y*)L^8>=J!+v(?#2nkAvgH#&t?sw0
zHucyac6#)o#xZ@yc41d-{RI8n;k-@#O~4#I`oN%~t4+qkOM4!EH@UzHn*@Av2^BSo
zNDPTY3^}=ph);szIUo1?8xnnJA!e6-mL>+BvrxQSw7@~bq}QGC+k!s8@TyYh)r0+(
zyr>jMXZl=zFd7uE5lL)Ki5z~9g9#2l*YGIy%e3YDw6Fvh2Z`XpP1ZeLM%5a!we<nB
zQG%Y<sun3vqC48!E#f`()uIj{+nyQa4%TXs-jKkkT#Hm|uy=CQdkPxOB;Y+9;GKNK
z?VUR;Fv_!9lszaginm(CALgBG;S}eLe@9#980U<BM@#cw5#G@bOP5N-ZL{vdZVD8h
zDaJN%S8kj9B;IRjmf|TmQ&zP0PF8(yvY#uz!u)ZEGFkgi&!!@`%8Vlh=S;*<rv~;&
z(uvS<k(X~4!@W;Vm!Cg{jzszhKV#z{UJLMM*Mg=?_ync)NzI4TwtT4_2%MFQU$45z
zUdtKZ#qryIvJpz`AOFs_;r=^2Df+lNkl{M}J5)uaIn=$K2;&crF48os=UCDd{O*sS
z68vr&5EXtm6KD|MpA;m4&xE>5g6~fY3c>fM1Of2<=|P`jaNt?Rca)%b40e>>56hh?
zD7@;c1E8Aaa|r2y^>Yd7f#q`wX%PFXPJAQBt7JSI$E!wsAih5h2oK+%2?Q47pMEOA
zTIu<X@G?$ip~M`er49d5sk5bV$>x&$KAK(p^q^47X<Uv}nw=78;Y3~`LQl4^lzLSC
znSPN~fGrMtGpXr@|IGkWz(LQe+pCsS6D-uA;rJ&V@pDmUnmofDI!gs{*%6%>`NMj2
zc-S~ESeAr}z>E;IVZEBt?>n$(`UTaVTm0QeIbj#NS%eIRndsEu=;EnzMng5t12$_|
zTn={9qBb5-Ik+EOw@Z?YhAK)2^bDu#NIDKG!H;BI;$`%T+}{xlDb^iIr<xViVD(Vw
zPiM)r78R`-RA2Zl7!IK(RSs`gACeSzCj*IBmz7Rh8{-7~b2`7Uy8oVTUR_ooXlaa!
z-JDePf^>JA_BppLQ*CLCQQVt+pX`HA_wdWPZRwP=1x8M9PRti-cg|_;Rc)obok@~k
zp6As?OpX=|ITJY>M}+6JkL2!)(`hY@nUi~yA0AoVHD)zi8i8G-IeTA--BZCg%z%0&
zA@zFkA35~NK+-Xq@XjGaRZw^ZSJv-K8FWa-8{vN(i|*Dn*R#oR$}t-fqGzl5KHk#H
zx+6Ijokh=P-#p$j$hxC37QOP`c#rh6?kJ*7EqbJxjjyG$+-VK1+Tgk5nT@}svY==U
zJ<s7LmEf8*U=O9!H*sTwPbi3&NTOGlmhva!XP}RqNv??(^P@+F44t9Wqg7A`?$-b&
z>e)9C>HE_IOJF!dEH*<Dx^NN$aS~-V5CYkt7Z(a}5^oPfc<-s6Yo1W!JgZBa`S(3H
zVV8vP9t*lENaAJM)TZ)Dv_jRAW>8L<EARtWT;FFj-jrmpr`(l9m!BsUSf$qTlbzeU
z`V_9F`m$G{Hut=zE6YKY+D)A1066)E?2K(gv|DLDRn6>PU(GBA28+9ia?IXi;`KXT
zrh1*S{*gIifeP}PEt85Rm1;pg&&Q_1{9%`<A{X-deN1U+YoUw1If@sNMb07ZB(G?V
zA(5A(8zCix8+~U?BZSUKhLpoWwJ)5-*`ej+^-)ZAQwc|QQvsLL(2?O}Y{7w(8+&I^
zW6|M4Hj&KK0e#&1h&E$qMk9q~Vq?D*iv`aw#>v7jv=+<1uqXBMx8PL@snQvw>xYy@
zf`@p3*`-%oz+VgZup*C^*&jg__y=&#kwa4O&J9CSaI?BQMS!D{D;8jOF$+#{*^nI+
zkMd445YsA~Nm_o#4ft!irIU1x<M%)mJ~r&E!j1{xsPf7Qn4RwgBNF?gr6`<B<&aXk
zU?@lA<7d%UENg8nY8~~(aOv3c52#oYh2P}GVQ^^3t@@%O!MVIt1o9T`_{J>u64*bD
zAe1L&KZk>^#6?nQD^bl#j2+oKGcE3Ff*IgTGSB2nqtsj;%OJS*D{(|vxe81bg+~UQ
zZ9dTpe8O83!CbrKZSQkvk2K4);<~B{T?1(6JE5RC)H=y0OR{P$q6SE)bVBK_M(bv4
zfwZS+iKw=Dw;FP(uPH0`MRyr+ml4RlpAsyNK<m`krWN|3AYGPg%y9mNI9s*(3hIV9
zwOZj_JKSX)14qll2(tUkgCd$qNF_u`CAEB-$w4k57y%Yo{WsfR1KNiXY%>^;GZ+^6
zG|>4p+lLXahY@~<5py#bdxsIMzr^Xh3ZVp)qr+&YG0MPW=IE7R$1ny{X=Le@l67)v
z8~K&(J-5G%VZ6{Q{rb+2_MM-l=XwAyl?GZTmwWDdKs%LYvYDR+bUnZ`gmIvgTVBV{
zvUEM*`7Xbw4qOj>s_O|UpkbWOZ6Teh#OGHgt&9|x$e<;nFYJ%R;Ms(`ckIj@YH$`G
za1R4Tgn!Fssh<4}>JanTg{aWK5pXV0d%G35Myb$;fm@43Z-b@!Rl7RQNn7Aw7+fO?
z_ZbcyKLWiCVu1}Jn2nHw4RKE;#JQDl&lxYW82#3XPId<!b6~LUa4?mWv7Yf&<)q=`
zSA?$dHqhADsOknr=X6)k{;voGMvO=BC&rRGI4&iwESlOlH%ceQuPMsD&%T$>-_;y?
zmZOInACw%G78VaYl3zc>%9^V0{~)GJNb#=7m6j~=n(He5j_f2;RP43VU2I*k|FqHd
zzD^xX_&jNX&HIr1!Y|q3T-I!8sazyrT^g0{WWSIRJCQ|e<7T(W*UNvLC|tLQRNj$Z
zD@J#qkvl}rqLHtAeBuIdEIb)0sDHJoe3tI3EdMRKJE7tWhCt<1plev5TlA$p+<h8h
z&APcmp%Q@Vi6gllYg{!paT;FoYEs@PC1TN(qsrqARq6Aa8T0;>jP`Ol=u>ASOunAQ
zomk1_d5~;QOrUJe8bS(hJIn`HH!ii~Q^xXnZS=@5ZZw_1M!tL%3yv>b7DYzwGeG`A
zyoL1HoHerT9QLlc<STkBS$DTIy0zuC(k~Wwe?)9#-8qMn&rbza+Zvw~S|^E7ca365
zFn7sfNYHmhVn{ekSiQyLVc2Up-eLYj97*HoPMdIToURuU0k(rlf96?#{x`G2X3A9b
zEcCIn#a21=n&+Z!)l<=gD29!I_JW-viXh(eol@6T#(Wly%8;&9lC)zCgE1xPTRO{4
z;`yGW^1uU8r1AGsoWz|4F6x0D!b}vxj1<C*6~YV%nGO(5j~4ZS4*3)(njS2g9xj?5
zAc`9&>VY4^jLbo*45`%XrlgG@p9(#sefRp!^<w9%cb?(e)BBY)8tprMhqWiR#ZIN>
z^UmJ3JGysjI`_?Vy_oyz?Z4P|hey6Hv6GPsZLW>)!B}@`;cvBdN*L~=Upcj<ay}^M
zN%m<nyAICs8Zm{PPi@vV2mFjA|63O<HLUzRfz<+d3R93aL{*;Zb_o=bid#^a73*Ot
zK0nX3Ih#B8(g0aD2VzS*W2tvlZRUwRCurrz8ev7(Z`Zp*wT+&SvAvo;bRL6gUo|rc
zx_VbHk-7#)Lep#o;d+rT@?#W;szSS%@F3kDyx^}tW0=1xPo*4t=Pi$^ylk?0OH`5s
zF8hK`7Xp@Tup2$e{wN`#85?$-8@FYp2Z20ZxoT0*pAC|%>$^|<OCIsuI!WApiBkR9
zs>Rn4FLZ@A!Z`-`eY^(sMT1Pi@cC(H{Y9upsJ|K%%FKoz6$jo_C5p>J{35N1psM!;
zG|OeyO~`-?I!HIoTRfGjbwAo}Bp!1aK7lp(@{vBqx=P;kvt^Rx&NOsyG=;G>O{Q_h
z)}(R?2tHR%rdfw59THV&JO;0)SYx4jp~7{-1dEbigh6S%89<4$h1=lsR9pGcUdWaB
zAd^Vn^4Y$i+INDn9cDUOH{;J8evmKvcqBflVaWIyx%CU)*Mn28@sjS@k!*&+;5I0X
zV<xSI7x^0=UHLM{=5WQmQySiwMv|j1lYTv4o&<7wm)*ZmTWri~XZr>%-`PC!TNoI@
zzoM&N;-mwGhB2S<N;j2Q0RBKa4>I47#yA!f|6tF1vCXG~6gQ!U+4Es@>mh6%x_gX|
z0DtR}&8ce4=hhTpcb&>*ng;yqsQkpz4-MYeq4)axduA7#D%<bQjLdqH@%iW%%Tn`G
z8a57-sP_f~=X<2_Jz_9k9L>Oz#M(SBKe|-AXtBw~MrSfsJ=Nok=3twokzRqPYvqfs
zp`91JusCn4P&I0;oI>#dUfe3-^0|-$TPDex;Ts-Ny5W6mPok?c-h8EcVZJD4N+c^&
zwR%*YhPujENCv@Zoo9i|J>Ic2n_C!ThHsBBRq-#!_Z;oKuREv<SMPHLJaKB#EI@BW
z`b#&Vaq|NS7mG-ccg^=r5E@Bz(|x~iTX@f4diTJ$D_^zO#Vy16jw7F%G@Fn#B0Z&l
zT^hFS6*Oo2&64#V3ilm{*76Km7`FZPn698f(ztwV(yZk>u2B`YY<|nK@>S40Y+?A6
z-FKYvU9r1m@vas$uMOw2Z&HdMYBTI!m?MPs&J-&72^FS}5Vlv^W7HaE^1zYX&f}<P
zk9i%Mh2+`qN@mf5I2&>z+~%k&*5=r_dAX_)&$yZz&!`7~)JOG>^3pixM(;JEG>$!Q
zF#;FTYzRT1{8p(bzN2oBA4BxWnwp6;m$Cd|DIP}K(NM5`C`*BNI!i&8mHZ*PiD()=
zMjJy6+?vLFB$cIL<!Ab|Yc$+v^XP*%@|puA`(~Cb0<0Vjn`{%red1i@&R2O4VzLEu
z?i;DAaTjl=JJ6=;$vz-YgKNs<Vd0X2L22+}E47qE4DGp$zoNNte~qH#XQ*Afce2`w
z(a5mlND)G-cl5@-)m7^-`)@tQG;0{~MI%#!C3>M%exds=F7IX}nI@#}JFozq`}c!0
z-%Pk|M4bLU_`+7Pm7y3d&$&yjeY(`1ufh#7p<cS!x2K?|82$%>;MS!r=j!^Lk7qgG
z@5eD5>82@zSFMWQ{nv3j*TaA@_iw2esOIEgU#+b}G)c)N3M=K+5V1@8#eeDe4<$xR
zy9!Tf!2{9cdefh&DN=>rc!gStioF&r7M1tSO7G`+!L7kpbA|15AniZX+lOT8ZW)-4
zbd1k`vqxZ$=@<u*d0>jlXDSsV<bTNnT?McPfRdzlq2d*O(B@EX#{kc)P3MqAQG%w+
zn7{D_|Gq4XFX8<r#SMlFg?nTwT0O8tF8_f>#0m1Kn1*O{4Pz^eCi4F1(f>E*m2->|
zE5UD|1S~x(GR_eaLGGy>Z;hA|XF-`TZOC*P%P%$V?_C9@Poend7>aYNf(7M|P-fct
z=3_zgW-xCiALq?D{ER&6aS&dYGSikTt<1tN)?xgz_efj}gulL+2qMKpJ`Yg{f!C^>
zlDG)Hd>HI0ryLUJ_-)ZE#Th!rrnf#e>@qO|Y(c-zI9ch${KQ$!4X#Nagf&+5rQEf2
zZ{JZdY??M$abVi7w{?J_{uU)}*Z(h*@7lbt-_Zt5Jy0P@DS$!Lfk`c|#*0W++-mTV
zj77D;5JILUEEWP-h>qLp6*Z);+<Ms3CXy`NCxMAsxCubT>0PNIZ>t$r{~^$ha9DHL
zCUv(-?Ara^`$I;!g>UW+|G^ZWgR8o$?@OnHuX>;*zt}w1(3wXB5pr7aj+>aff9XtX
zKc#`jy|Mv!XR3wU+0t6{>`r45CyUH!wq?2&Uj3&s;pImi>u9|3iTbV5I+X4%YJ=n2
z281(5LP~wy+B<1gJ)ydtU%BU>c`Zy=A{cXC)?%{7A-*~;*;P1t*d5FcIhshLmQ6<g
z<e1os2Yp3exg80Zvcqw#%idQ0b<fYWSwAr84oNI^3IX4O20k1LXysw~(vv<hQMszP
zTFuV5YaTK)FabBDVIRw-=!D_$0ms&rxwE;7Tu{GGJyQwQwqzd*xK`v@V(4z8PgOkY
zW9)TiVRGb-F40RDi4<<kN@ZltYNwiX^tg3_**=22!=;BC>s?G&O)~FIS>%HxVACw7
zeftSr=4eKcuE?s1?$^C27oBQ^S*uKjBz;!ja=2rucfxqjsLVuVllj6Go6RDuL1}sh
z#fQhJnL%<bZQQ$(h)2@SLJOVOg6QgKbOZcFWRtUT`aBR~RCY$8e+Vrx!-t?88&5-N
zq_3)Lj>feF!-)9VJ40Kj?cv*&qJ$ist)AM`T1=*`iW_Fe-<Sl7PACi0=BA^pEZIUQ
zgJZcup8-SU_Une@2m7}}#`cU%oBOOLa9nBlT+S{L%Ka0ALkg>UY6BA|(OIo{T&d13
z1<Jz{fFV}<Mf{Z2Y=`%!rgV0&?e$IQH}@BY#O){9?DzK7hn(&8t>#@^YLr0}JVSP?
z9ewHJ6U#%ltJxAp<LK4WVZ6F^q7${K@|J>9b;_AjShmIcn(&;WH&svsH4pr~p;mrP
zhGHD=H*&}_4L&XzP8=X`O5f=8LR)tU*MVm;VODqVJN4R5)M8W%-$(#&=X~myDvr>5
zuQ?1pXc<hT!KIcxIQKqU`gO*uXKs+1mh5wxhyO%3sj*7~T{~)lt^}{kJlSqn#ryO{
z`|N>rTuCs;z#&_*vf~U_JK~m*(BFjxSuDR6V~jc|w4^(7dFhXrfUzrvu?%GX_4Tn?
zSutU)t#JF6oWxt^N%gr|1S8Z0(USI@_yjGj>r0>ssZTJ(l0;fCZ~UgFPA*?(#wVan
zFu44UZ1?wrhOq4g13p~2>?qr>JJ{}+_jyET-QmT#+~}L|as9yMYia%I0nDn3rfF@R
zT^gD2j{dybv0}Nk|9MDtRnLfjVuCMbZMCC6y?<gQMqu?B5Aed)TQh6m(;lD1(JfZ@
zk)vC+t~Ik3)i!qD9nLLe-yMNd_r@D4tK>np*W9{Gwr-5WfMLljvlgvd^2QtB!rrY^
zhnGnMRkir+*IR1y>e5?k^%`LK^;m#*33I}qOzXs*1C~?frU|Gp|4i1a^U|nTr}4&5
zuNAT%2g@mPa|?|5(V<+oI9e}Km%dLBVrIQgxui9b1+Zb5&w?T-dNA)DW#3S-d^&}G
zGbU8*@{qLq98vqeYy{5e^`M+j^O+~JBX-QHEb%xMihT$SNeGO4@bM>Lv+AuUq3aII
ze2m?EyMk8UA%GZTks(uv(bPtz8Np5ZhR9BL6Hcdu>+3bGh9`Pe2kx~+0V1(5p3nQu
zb-yKFk_;cFj%R*jk62?5?7<7X`A&gy?{?+8T*)SH_>dX^hdmDYs*J;WhRU*AiCSH1
za^<a>Y>5|d3Hg~~g|xTIhgmi{^~2@l(HlM8CQreVzEgz?<|ma8<9=kiYu7+Sv<Vd0
zMco^mIh&{I{0#$@X7c2(cA!NO-YI0NxV5xjXS-Csct<<>lC~GDz>PUZ3fGab@Em1T
zskDUWRp}PhYsSPMuS*g#UJ=B1u5s;R1J^}4;Y8GnaebbMTOINx=U5+HF$Zi$%Joai
zf!r$wC1UHybBDmWBKV=s@@*$^vv%ddwQ}pMpn~Uy;WI;-=}yEYeKnCSgs6NaTv|kZ
z$J%N9S`%r1L^z99YQZ>O{Sphv)p7$0&gq!PTj)3TwC6}-q{7SZ6we0UWZfCgHXdRd
z`0LX$M9&ml9n?(ErPRTB9_U+K$~3nbx3_q%G08uji=+zI7rExh%4qJ8VE02GsOt;P
zKX1d<8)2>?i{D{OT)DAUIndOq2|WvBb{G>aXjT`Ed|Xua9prs9(X8G&>&KI*BC_+?
z<K@cyUf~~1Fu^w<slu*Anz`W-_{>SAd2y`Q`Q%`)MWgtw-7w}c0%5VeC9&1%IW^sJ
z$0JUQZ19S5`yQoX_30d`swua7Lqo?;N-WCqP!aJ3tYmNJ6H?^xMTLh?FvM>%S0CEf
z`~yEq{rO*acHZ|p&0Md6>)e^^EeH<JN;=PR=QHbGpyztK!#qn%79_jgX(3hpSegaC
zT(y(1?%~8^qPb%txk`8WD)-aj`Hxn$>##a!xB^}C3M)>=CH6lRQKMA2mB_M{I;39{
z$v4V$x|DW4+cfyecPBc&FS{$J_&(IDQbGIygWT_@<2D~xdiV4u>$^uM5bNcSF%-N3
zKJZheC-J5yy-mtJt%MZ#kw+&X(KNRk`6vbrw;B0}*b;`+6Bs?m%s;bQj-#a(EIc=y
zMRH+ic4(J>ki<ED;G2k^85c-@Fj$B2$(g@8Nk(~)^@o)f#rU3>+@3N}MZ}|^U`eIZ
zAv-$@l$~`3ODPWFWgA7oq~fKNc6;=$A5@$^y|UlCI*ym6{P{r%V&?=us*k9zoUio+
z!>zN1596mc)g{m1E0#cw<J>hzy(|~Q8>xl_$sMBLc{km@L*k@B$yB=Px>UB-rk_~n
z9n$UXSsX4cj?z=0$9ZcbwdeUf0v~OIuf^`ul--=u_FJWiBit8$2@~p8G=DMM2HoK|
z8C!UXXF~E<68Ot@(}9iS@a|jk-y6?ws8{oO;rF`uY!fl}e8zKY;oUSE3TQ$~XfV7j
zz0kZ(cr?>9Pi25dffo`^^KWTa7r#Pde=YT*2PzI&lbZBMowDi}Go?!3q;gZ3Mf@t}
z`fNP><3`v*7gr$a6cP9IdKc}7nyEz-sR9E`Cp!_pmg&I?Xtb9CG%A8yb0zJ9z~Mz~
zJ3@52%svDBWbtZX%X`9}1<gCRvwVJ6Vsg@QifF9aVsK2u8P@fMq$?RIYqv=IHNHD`
z@3JSO8kZTxkz*6TrzzkeK&MBP_^{6&rW$+|p#>!#Y!$@=?2^=w!jR4Iqan&BPY*)C
z9oWTANjIbq*gfhc+9m<S7|bF3CcmMUZ?A2SBfA_}NdT=d#3-0LE-QeUh#At6g7+MP
z9gK5pnX`v4U;_*_^wy%M45|SVEJ_YzI;t<FHQ?0}86sMw5r}IxhpLgFds|sPBT<Jn
zkL#U&p8=HF_Dw~-kbTILd)SD3&fDATwgKfmV52}SeIjONfSg7Wt}@rk;GdrO8M7~A
zJ?d=i%nGh>5jx07l?cw77*1E+xQYs`Od%}ir_{|IT2oAA(36<4p4b~7kByQ|LBa3H
zDIl0dZFWlTj0{31C(Crjn&1u4Uh}>Y4ySI&onMPN_TAJw&XrnYDtzL<C^-my9^<<f
zo>U};Wy_pNLIVHf)u2sSM>uiPD;-VmhOuN9zz6;j%pLq3dKFR&P79!g<N;d;UI%vx
zWyrOu-9tv)5>Eu}P2>o5iJj^LbE<SGFbOHJgyZp>t49cyJ~2c0eaX!h94+^NuY-;K
zhW-E_<oirvH>hIpHb^fpFNj0Hva}VaN+!e8R>o%FjTv6%PS1xcTV7l|R;fv<{M{U;
zVjF@+5)MYxMPc@~=u&8$#lf1)xKBkeXxL=VWN7{l<l4Zq{PQUdj45neysH!gv@l7(
zaM@u;-hKC??obGxZGDgU$Uh$4I=7xZPn$kBR%(wDeZ`xmN6EYmG)J?<4m9_iriW-H
zkN^1ZxDxVDA0XacC0BB!aGu^_5`wQYnF6ueNC+u5)VuRUrF_2?DiW^;JBtAP1tjex
zm4*U}|Kao?7|7$v;sl@3xqXEa^hM1n6z~u#jNnep*e8#bV)S->SQFNPM1!jSR2<|$
z28o((%5^C%@3k$fc~E~iX+l@>rVVW`Ov0uQQ?IYs>(^fq0D9PPuxs!aFit}-LsCOp
zLvBM#VX#QBGzeL6<p8K;@FDOI;27X@U~FI<0j&Y50T*zF_kJ2ubzcI&522aCGXidy
zi*b5H8@a#|bN~UphqwUL08wEyL-u^!d}d^DZCH?~um(pD_&DS^%qqNAAf65Q$+RuB
zE#MUF6#7)`qTP@LOc2@!f*bB0A^;`X4@^)J8tfhy4?+)Y6RcPZ8JzTeW?n!8ys%kQ
z0Mtns!}nNe@Ut|BBOI8sCdvc3_{MIUGNQ^}Z<wu4$g6emc`h)<$6%1~=|NNkBE&;9
z$k1!p$7`6Z!vuEEg}Jk|s0HBNkV%YG@~U$z6#Z(njxQ$0aS3v?WG3VxQ1tB&QAZxm
ziJ-86n$Qt$)E}x&Sg%GS>$Tqm@69~`e|%zRmaX%p#n?c_0X79Vkm*ai;LNUSGJgkU
z=^lR7ipGknCm)@*to}`$U~DwFT7t(RYw49;+8ue6<~1kBA1CLb*SCZ2kaXD+JWR#U
zxa9=*7l}CS-;(0qxBiDzsjVy8E{*@I7F~K^62B)Yd+@`@{So_fA8CJ1@Stm;`E!?l
zivE4)@0+DvdeHIf!~csNVv_Yx?u+`zj^)s+)wEPU)0HVx!1vcuk&i^b6&pMYZMYVn
z*-X1dm)U89x+A}-Piu(i0_?E<6VS#oRgYH}(E$7bsH!6J02ZtPwNJ7lbbu1fWR<@M
z5`Zt}FXd?|5fXqEX0dX-qzL}M1FO}T5ss05SKaAR(!oE-`nZ*X>&f1PvnN>I3*p#*
zUa~<f*(HA|ghedyA0)#zaenD4CNP#t`-eymdncrNr<g+QrUxJ@<#)mL;UBaimze=3
zbVM8dVzg5zwEzm=_7Q9X`F6Plz7~?nS%C;}S!cYR)XRqog=DC;5x~b_%N-Kyuv;4)
zsg+8#$1E4K(m4jRIF_?Gh#E_c7S)ckWZBx>NLi6omC!R{X<%zI*Xy&_ouDq#w>pb{
zu7D%E1q2aoZXyt!g2C|h^ddXfK@$FdK|1$;e5DhEKV8M(&+tyi9BdsDNwzIoHJ>J9
zC=rcTK^i6RG=!Ccr|i3Q^l>H@VZkT0MnpsH7^DS4q3)eimG_jB8iHZPppJ`j8loq}
zT2X)`j6{;ZZ5i)Geh-MqzWd>e{Pw*6WZqU;)qVF;Y3^3b8M5`8_tJ!!FdD+7*Yp#(
zT(5H-d^LbiSYQbT8Ay>2PKYt8o=-&^z?l#A6CAQF=ps;mGt3Yc_XE4VF7Eo5RSAP5
z*Ma9|^&KTT#8p<s5v4AFg(Rm^=0Y{s)LVI@Z#h=*MW=+SErXM6A$coirOdN6>>+u}
z9HowpYnJdrO}YwOrPm6jjwTP-sx2Z(tJ7+#*_E4;fUiQDj!8i5Agt%)O+5hDN6Yp6
zO^Zpvjo@7(DvBImMmf%p4?MkJ0N+tpD-1DvnXsZYrmJg#EIQA=I?o!|{x)6rEG3m1
zzVcf*%@K5~X6jLVXNamT{ga#_D|TP$R?WH6`&zDJN|`l+hT5(bRvVU&WQTa#uS}h@
z8g-SZzw_}Om^z0wvMEu!^YUGoI;S<RkL=>q_>7J0+JF55)ObYx_+r*I+b*XrbUn!x
z;@#<Ih>43d6rkIy#f*Fk(Jmse1o<1d12N@QYlr-+=WdBnd`+0?eJ%M{LonK)KttFx
zJ%k#V{vIg7bnyKkvySiRwva2}V|8%cl*t6(_WJfnqSKIiREJI%PR&Xh;bgMsuIpe_
zIBQ=$IwDz>C6*<X&&Q%zyS`1?*uZ1(ll+2y>NV=kMfi!(<_Ek%W~<UHGA%T3Ghnl`
zD1G9~=o44izja!FJx#p%bx!%2RVM9pGtpp=D=T@!7N5&IAWLD-T(xD{)SfdYOCbM*
zhE0wHpbE>V%#6iWqjm|_>kD6swpzO>vUa4|Hm7+0D<1pCuo+hpzmx4ViPGZm#r0LR
z580etRL7XSQK=nbCQx12yI1}*$K3K<0}M}rY3h*D%>5m%5Fd%qN0K+%9TKDG{^-21
zd!9Dy*hW6QjcsKrmmFW7lZF>rV#zdBO#bcDie-k_kDl|(RLfLMA3WvnvMQg>w*9&%
zFYdIg5^0hItQ?p_Xig_eFI$ML;BUV4@+0w?1ObQP7C(CQEfZv%MyI9lAK6mNMCHit
z+w8-z-`Jb$$4~Kht2OyV(W!NiA0k$YXig)|2b|~A90C|2k$(X+|MKB%$};2XA=N<k
z_rNlv6GGBJeKcSy&c}k+sh<#*o5ueJE|~TOD)k$NVaacFN4od-9{CrzZ|`0{3GRR^
zJ*a^+HX2?^GK8Y2FF|<=RPJc1cKSt<9t>-?#E?e|un6Q8ToX}4`5hRv32O<)Pf8;l
zf>GQDr?LfA;RsaY7Wt4(ilrD2|Bo`|l4$i!F);Gy145@D6;GMWq}Q$wZ`w_T%7W?0
z1HQAp_#_hTgH&?0*oaX6u2-^NSfVSfcGMp(EU{Z^L{r(BLG~4y>PNmQk!+3Rh~}s3
z@3arBvR%Q6RiCaU-nSdj5wDgQa1C!kM*Bgw&8y}OzMwDMbf9cPWnC>CvsZpaFs~H|
z?W)!lJ1Qi#m!|xn^PxMo@Q2DTEKFa3gn{ggLD9PFyf@sfU#gdoTxZ&+i@|wsmRo)K
zP8{V6-s8_wop}Z81m$<U>c8+byCN5@1k^{!HO~{MVv_0I_Tq~dPGoak_ZBG`?&!3)
zM<*IhV-iayiAT|g=v~~*7Po6@JtvpVXp%O#`RGr6(8;FqdHbd!sy6g3+cXx3C8kUw
zk0dsx@L$++CC*K$Tmu_FH@pa{Ul-oQT0FrUAZhS8Bqy>kV0Q0z%nU3<8n~_FZoer%
z>mIDhcIaGvoFu67_?;1{$>%_Lb%$B&w9ZKV6~A`ZeR3s-YKm6-q~np^=)h~i)4O4}
zJaL21!J#?cT-G|rE|H2ax!Q&Eqe^38;_amU7-xBb?Ca*~Z+avDS{HpGs<#REL?Pa+
zwZ=hmDuQf<2GiQan3`4EkJq1N^<CB<2;Ce$z9zNph`0_Dx9v=Mx<6N_aY(J9%@Coj
zq17+jl}eE7P!|4waBknZ4wJ$KBi`Lt8;l9`8G5w8xO&&l-o;y9JB%4lw14gDHD5y3
zBMx)I|3@c%`x@0K#iq`ve$88>fN9%ztq#AwNu=02G1-+TgZJ_M*N14{TlLDIWL-?f
zf$6w2qw4O5%7R)2PLY1J7fatDEDnWUwBvsame@tw(dI19gCHyl&1k)M2*;#QiI!#|
z|F7_Zlwd3#iAE<`jQcO4aNS=l|C7jR2Qp@E9=Jor<(&Hc9o_TBO<%WqrFB`~Md@ri
z?U}dQ?dQt2r0uhO))miEJN`L7dJh7G^<JIt4WSIxfz3Wy3g3c&3^l84E6U4L&AeG>
zIt<HA>rTIqY~6R~SN2bn=^vP=R&qWkQ^_Tt8kTL@oGBiBo|I%!xN4t#Qfi(VSHI3}
zWHL{?P-z%jzGJPL&}>-oJo7Z>yz~;dLKL_X%=J)u9k``Buv+jw(*>@tpPWA0I+{>j
z*!0LF-3Nd_U4vg7Knj}nz`W1Y%}89lDQ5A*%;sKl#4jehB!PtWn&biW@{pUnc?_jV
zb1DP3s7UJpY{IC{F+2-?q|xFN35G&L|Dy$E^WN(H33p8Sr)p8L&h0OGP~d+`|7*gc
z;!+a&bI#@kl>Z+uNUg-|2^_(Y&o#Ub7N9dylC6^ja-g5)8s0&*(<}+}p2N8*)p-NG
z(N~k+B?PL!NoyE?$<kuzwf=L~+OjYD(Thc=A0?W(T<}Zy<&<7<oUHnqz>5#><{J1=
zP=w(J4_J8^wjOzAgmGw>9=$qLdg!qpIYWkWKvqxIrd@uXJIp8!1OhLljGJ&2Z@$T0
zxIT(?iOaWH|GHVR4=*AN&Gqd_2d~l&M2iP5x1N0mBnL{)+;0%+#$}j%CERp_GIWZv
zPAZW}D%r`~#h5hzfh3=7T!@KLa!)fTME5Flr4;F}qL;LtiTR_rg?f;Ku13a5A=2ir
z5-#;1GhL_*i+rS!3SyFRI%a?IKS=$W6>4UF3bj&d`(f()akMuyo*8k;l81Og3{?<F
zW&+P;kLA57VHSKp!(;_rg+xkiFo_rLrPyEdqTlFA{J-t8zaoTQ<77=e5Fi_1bWh{@
zHTzev#95Dn5Ba3TJ*WurmaP1k|HaL5pUFXD()u>5{<gh%dNK@4{gHbzty%-V%gt?K
zL@4H2S5>IA0)_R~|GMJs^H0z`P5L90vv2=1P5K+u%?;l@0rg?UCRAXT3O0dNsew(Y
zSZ2i%cUHxcG=Y(lD!;@|6z^748FxGH%A4AZF$Pk48F(0;qqShZj9@+;q~hF4nbVa8
zd?xRcEa!E6qJ!1$4*mlRMb&k}#;Dt5Ax#xRjtIvgd|M#?G|?}p&K|R#z^+aBX%a**
zGiFphIOw3NUROh0TyROC$!0KVH-dr)+cf$&XuAMF4wzihQHV&u5yPBrY1&Q5*84de
z0(B6)7JO=ux*@|7_;IhGBPt;{QowBm8WeW1B&t?CzKA6ZV!o&~R3N;}7o+zR;qvud
z`BstI3CcbUbTWzHITy6dlx*KM%&e7(QjgGe!Jr_eZoJ3|I7ZEB(W2b>a*Al{j5urM
z%mJ70+g7?)U|&7Jw40VjmkXAs2z^=Tnir=Z@E_sC5FVx%AEp~|y{N@jnAL=+A|)(@
zK*(0UQ?$)aoKFn1#z~268IG;M#_Ue&tj?;$M011uWrFlhJ3(){Cl~3NVO7E0>#O9r
zG9UiE9Xb-F2anPJg=9ye`ph|W&5{~d?-RXeLQi7yuy~Ld+mq-9QH>e(@LNUj5Q*>*
z@)0;DBE%eiqJ>Iz>r@bj;2U|eBT9nv*fRZn4zC_eO*##@XNaYRaD4v-M)|LQDJ}!j
zXNQvoOMkJH#L@Z6ADPIKs6PI^1ozv{tza1I-q|8Ye=0Q_f$E?Pw9J@xbLtbt46=%!
zBP|nA49bS)L2}05W&iht{9+NAphRdYBw74q_Ct&5sr)<<p&)K(C&X>s_YvAAsKcbO
zB82aP3}PZKC5yCi{6K!F2vQI}GzX$J?mTn3(Wn0ZR){{fqwMqQ%%wp4fWAdbo}Crt
zsAvTRaG1JjI(V3zvpBf=5q0s=^5S%Gd3k_yL!>`%_HqjMHOI#z?0M?<;Dy&q4=po(
zH28O5y&>Tez%9tD4(1dv3|N6;hw&=EvBN2}&&N4J5%y;WOYRkB4wkC{{0K5KgdiCQ
zyXj?J*M(~iJPR;ef+9p8jRE6g`VLKY2wsE!tL1?2<n`^34tQ(d-d>iwJOU%HzeQg2
zNVGCDjRHz4E%wS4S=|F#A#1<V=}f`o$W;B^8L{b2tiFRJ_w0XjD80zL;u2D%oIvVr
zp#5+kxCO64ar6y1f%L9nY(5L5I)l<;dquhQ4|s!oCfR%gdxN<b>UjhI2g!ZlUAPGU
zA2R;SM#38qQ8~ZVYnEgnTz7vQd;p~8>xhsN+1&mdxpK&es!?0gP86h&=@y=ia+cvs
z<JHf1UXY$el@X)-Dl&_&lyVeWL)I30h+k+E{s%nXR>*mw-$JAXu1C9y|9oZ=*+LBw
z!$el*7XLHc5|l4tWr&#~C-8{xqy7Q62r_A_V{1bg3Q(%OVurlw;O0PWL(X)_ePD<o
zix#v#gpCNp64W}BLlDENCBcjz@jkQVW~WlG<|b}c;)-bOxHUbFaVzRrh!*33Gg&GE
z4{O!cXQZyGdK_yA#c69o-0dDzm{4x!U8t}7|D_BSlTjnFScS`o$>ST(q9%oE=&Ipl
z<NsWVI0sLXA=%xZ%P<2kzg$<TBdmVk5u&_fxy3;@3<^$+v(5K!6$&8~$;}a3p;9=0
zco$`%sM$h^?t|JV3E9t=-r*Z!&%~)K*H(PwkdtI*U}~i`k2xQ{K!5f``7wh|#(;MG
zy-M(&Y{pQKNR%BDB*?)o6;tiUvH|j<J?u-Xi^EdmTM=BjCDxc-@N~c8I?%*2*zP!8
z$^M}s!}Yp2rz3L6pGU3pwMDWv=+{qQzm+$@A44AAuXE&Msjr0sq9=tTxer`0c&xR3
zV|5J7GH_<83Ya%vfH}~g+1<uF7$wF!3ibg4g`4`VTw-%v<mB5g(8Ow=<mHi6b=^`U
zN;8(PQolDB7QW=-9p~LuH(AtX2wdDuwp&aceF(D`Y&8juhU;#B+Ul3bJYPM;Cvd<F
zX&*32IE()rFMt+u8WJtl6(=vuDB`>;h_<}O*ss98?TmNI>mdJQ!8!hp2V{RM;%4{d
zjF1pLq#cGWo-M&89wA;EL<K65CUM4NC1@pVg~*80i_wc(1=34ACM<wVKp5c|GOsuh
z2}B7a<ktmmB=+VTRQ|&wG@nWHenAQz-MNMLIb9niO^roF`|0Q}i*XuIWc{f3R9fzU
z$r^6(%<L#My%Al0Cd;}@oQRx&soc#s>M$$q;MHGu{@Srev3~9AIp(o`4d8TOs+EtQ
zh%&u-U%0;A&0189>a%i-(kufx(?wC@RDHMd_Yu=V`W8j(YKz`tuU>I&<`3{RG+9zc
z<V-Zz`xBh0y`~ypQ+hGAo3u21`zn1;)K!oBPp6E2C#Bt)sHY+R)*JyHdvJ~If@ynp
zRzD}Fz$|`5v6NS$#0sN)lG^GW`9{kx-Aq)RNKx77CrJ%cwHsi~`k6Yc+_cvE+BJjl
z!;>!Smm3o<WB;&)C%$hpt`AAd+#Im)Z;S)!hPaz(SI}wnX=t?AZ(&SU;$@hOaCuR5
zQ`QC{XIfS)nFNZ2BM=LScULvR1D2H#FECnEl44Cd`ZVBjX4`@6iTqU1{EnqPE>4);
zna~;CS@7D%l&k@_6;C_z8BRN@BLI=yf!u-2M^H-vaHGbo6!LSvIM6mi92S|Xot!(F
zFq|;-Sy=ozmv_}C29<~r)gBdAEZ{N-zi%t12Fv;P9F#bGI6E#yqal3*#oRyd?{Cu(
zW6F{%vCZNhnZP6n8h|2vHYPWnqsrd|{EmTFeX&IrEO|P!1;{E)4Z3O-t&%!fqZAc0
zfvd#^`d9J>qPcV=KGJNMXO+mBu)>pqLoeDk;=iJBHjo?O1iy_rKo_oxT1KiUl06$K
z@XZ*dPSvoiM=>x5g0F<pn>1IHKg0w63UixoKsCG!Rf+7s6WGyc%BYOVKQ9z*e{F@A
z8c!TSF+;T_3sM7^>@L)<k?vSsyEi-wh|W3{6`Rl=aW^Oqquo+f%7jv*Wb#{H=Z^&a
zJ<wXJ<jVw712QrHB^cEj)%Mo>%|xpIY+GgjYz3u%HSp4Z&juYBP;1h<=Ky^Q5JtGD
zerjUr>xaAsq^824fcP!{&^NqSi~GF)7;f<vEwu8syh2a#YAjlE-{A+IzJ*85mg_%*
zkxS?V9;d}p_P>S<?#v291m|w)A*qN3uBZh9liN6(s<@wya`SR=zh;R$*(I11X5>_V
z&0_vvbiTU#qr}{eo_ncxsJkwFrcEl^6aEeg6zmW5Qz1D#96|{6a1*7!qZ=Ncc)xLB
zFR@jBB~)}-c15G?Ay1B-OL`#`>ad$+cBu+23q3q)n6%8w9SaV_o!i^Y$}Iw&Rg=~m
z;SAE<i|^;zmANHTs;)H?i$-K&)f)??$7?VJC6dYg$53M?mX8?73N`A;K%inKokFG_
zs)nax){=_!qk+sI)Ccd{43zfI@E#>&3m!*h6$2suOF-<7fwC=l7SJYLrA8GTiz=H(
zRkZ(-L*T;$uY^ENI!rc9K|@MIPD2LGLj|vd#3;H?>XPs=f!a8sDjvH5OgorfGL>vB
zAthYubzCt|Vv&4`Y>I*;a-ct60hMPA@9K@^Cmi1J7Y9>vRydjX5s*<w2~0*PVMO*s
zs9b_4sHvkF$_X?FOG4p?=c!J)47;^CVkyqpp_+7-;K266$Qn}doXD-P`aZ5xpz7p=
zIU~CgsLi_U&=jqt+AFBHDU^0KHSo4F_{RAB)(UlO0W=K9pZFbdJ$uyfg1k&z_kzQb
zH%Cyi<fB3AF%_*TzJ+(S6TRy`h<9Derq+?zZ{JoTKdI&<l%yb-IHLW5r?PF?SC`si
zEcPOqD9&*BV4hFVTdZ-sP@Az-oAKQjYcu9+`^hwBD>Y_IHR?$>X3I5>7i*i((CeMB
zsry*D&O@3x*F@f#vo<JEA5?f4bF|7(A5?j$aJ1@DcdI$6D0Ij(8eWDXGOAs*953X7
zcFD2wKA*W2%QKoYYeF}w5vp^NP$bFiR-Y#};*V&5*2!C-BABd<Ydqeme&nta{BJOF
zYQ1cmp$bwtH*F*^bu>_LIMDnDOj|We4$+hmjb>fsMpjythk8iRc{@;b>*JT$NcY;w
zlVR43k54+(Pd|fwKWksu*caK<V-}RaGDuj`iOQkrL{6&&r;>mBUrF^fG6Xt5r)NV`
zIlp}?C_!Qv;$&%-VbbxMnT<--|K>3}a7t~?#nK+Jtl(p9?3Q%=O|7himtn!GLQ&3D
zr*cjuC-wMSyp?FFOoWc?yh>pzdQ)=w;4`&?wUvrol1}FQY;h`e6MIF848#8<!PikI
zaLYn#FfIeG?=*oo_Pwoi+_jZXuaz@<01M<v!fYPygFrTzzo3ib{^odZM$kVBo_;f-
zR>*UNr9AR3>HEwRo^3PxN0M1(1a`Uh-~JyOP<xcLG$IV>$w~Rye`X%IQJGIsP)*X)
z{C`!;C4f4VfA2h;`;stnvoCjpX=wOwKnjZXI=iJ3_Rh{pNm<#eySvmhTnvB5JP9Ka
z@`|R;<VhGA*`Qr<Y8qCaDc7I;Kdf%_$`pXkf9hwL-_AH0qbM794?Q_Ga`^RbrSK~d
z@9m*Ey=>dJs`5Tf-We<S?cq3`iRUCOJBHk%yT*mHyUYIrNLyqQ-dQ8Q5txm&TTN;K
z;Q9F9N#q)+^}ui}@oG|I0NTd@eXz~|ckl~{bwCG#2hJs9zMgPvfHU|W5S?~YtEWD|
z1bi4G7C?v~n-69V-Uks3fJH#XCZ*5U6s`@>2k(UN0%-dFoi3~uPzPoN-Uwk17>9Sn
z+WgR?9=;JGOuKjC0M+LlScixD+8uhC_4xf0TrfH;)oa?l!M1<I+kXsN2FAV-w^TK0
zE&AJD5hw59@p;=d;s=%fe*w<4B|T%8hzY8H3DKP;@Rhn`^xZnuT~gJ=F$)ORRkilz
zn`g8g)E)-n`dyNM3#WQ0JqZM}-p&R?7i>LUCN0`-D@s_dI%~M9)Bzl+t=p>;<reO9
z@h#VpA!QI#t;BQkmiay}bdqUZx(I#HN$c&BCbXQ|rM>I7ATwu3$a4()<o<P<u&?Kh
z4wWe0CNDe=TjBg|9T{9CbV0gmmx@hMkfzR6)p}$f+qFG)JFgdqUY=of@w3rF+^^(L
z75)6z5@6R?9$uQ%*1g(gLp78nrV>YpKGX=#)8<lbRBUG~FwAMNw#oren2&y{QOl`6
z%eop|2g;|81Zs{3zJ)<<d?xW&4qYkrYirH3KQ9Y=I@<E{YRM!18z!EWnLZuO`YnGJ
zDsc-(OdS(BPYbf`6*;d!Y0z`*zzwM~hU<g88mH|L@}q*+9J-L)iZr#vTu+k*UZmV@
zjNwfr^!g%BCiTKYW0=+@_G+3s3emt<z?91o<9zMYUcbpFd;;fj3o?0Y7W^F)b2O4p
ztCwRN;zI{dl4yrgVY)I}Bxcs2L$&hkeqDEJoN{W6*na=HGb#*l@<{8$o;uA>&Lq^=
zik#M4M0hWY$4^~FoUEQ_v2bys9>;+>RMT6^aea-C6<1N2x3V{E*6U!_tA+hspnvJn
zxhaFqPsSwleu{8$RUApMFiOYjDXSq!`LVlaRA}*IUS&55q55t)`S4v}Q5>P~?jeN~
z3C|;FMk-d&`B%dKUb^z#q@|Lg<B=VCCrfH6HlECp8TnXqXCD&oE)+tdy+c|lDIVU@
z8Rghm=P$`cMSqpvgA#kRAEcCdB1e_gVhf!yQ;N#}N!tFNl$gonpN9=w1?Wo^zE?%s
zI(pP!hwS~|TT&sow8!79<~R6zd0(mFPlj(80F9du4s96#{#WeT@BJsMhyphj024;}
ziz&q+3eSlBJC?AK1F0wXoHdFt>3MyJ*ZWYn8Qt@6fPcV7@Tz+ceK%M8K9U0ey>b>3
z0KNPYYRU5pc{&m~FMFGO`8Bqx^cM4Ul-82>`tfcqXjQ5EJq2M^3B_6H1?Rjh@4(M1
z{!hs;t$D<|HP<}nAAUG%wx+ItEcV0%suJlI;=H<q7b{J@sk53)ud`*FtEdk^yPjC|
zX(I&m4^i-`EL~DVOy!1XJ4I&Ch49$SrOa=YKpxhvBR9P6Vqj~u)lGNBrYv4<gz0kw
zd}g%OPIpxg>(Dn%HAk$chv?|H0wDH|JswKsCi(CFFmH80l&5cKw1KL~?ZErx8hL%q
zz*=gWkzFLLZ1SXKpO<brT0a`vW{5!{8%&4Mv>m3x%QZuN%q|RmtPls974a?Ik!H{j
ziQTUb6}wd_NEV~JcE5dE5Z9GOCa=0b?6`Y6bs(-MiSd(%EoF*5R|yVy6Ii<EuLZin
z{3QAhKuS<eYCPY3Jx%Gc+-KJAzL;b_@0ag`U{a&O@N(_W>5q|S*AEY}uD{F1cHaj_
zq*p(ZR|!^X`fAla2CJWF-`3kcrDLsXS8I->RqgRlKL+=H!1MX=^w4>FAlHz09&`NS
z^YhcS-A@6vE`|0GlRMOPpF+e?^hpss#3Xea(}m{hpDj8I0@X838QjYPD$ggxXyb2x
zo{>;K9WGnl3@_}!*Wx^TFBcLrI%14ABj71Cl6ISxJicWUXaf%lPedSxEp5#YZ8go1
z!-vn%-P6&)FWraO5A`n5F2=@h{ic;^_jZ?6me+sbo_>()ebIX7x6#gjaCS@|$=A+%
zW9+GEp~1hru&mF&QsTno=E`a7Xi?PeQPJe<rYR_f^0PgvY&IytE8Z37<7^O_SG+rp
z`%y1n)S!gB(`Uzy@_B=~4Rd#=z{xegkd`)c$Jc0-?4~PQfpT}AVplg!izc_bf%?xm
zFEp_i$ERg;FJHF6cK|Q#H0OAEtcJ<NU-ae*?~v@!kPnHM+8m_1Y8(wOmXWve&lg3m
z2I74>7gJMHArB^br2TcMbGdc>89aQ6Qet(&dSAY@#Qq<$-U2Fau5H^!OL2EAUW&U*
zao6JR?ygfDiWYY%?oeC@m}14<WpH=bfA0Hv-t~U}_pPk!$a$SR*^^1K_Dr&py*=Ek
zDyi1_zYVgEBRI|Pzu;xp^4<g1OD4ElcH2%pPI?|UNuN6{zmb!T9fx>r`?ticK~j>u
zrj|I_07H&ebf?w*2DHuF-iTX1fH%4DuZdf)BM`d(RmV%Wa<|@bow8xl;viFGlj26H
z!G8Fi@CM(<dEhwolM~!|w8s+By4s-T#h$-moicx*qyDunsWPK>=R|)87x{XL*^5P%
zqL1BSpX+`umpVTl`O@8Hm{X1YiI8VuCEcjs^JDc!PWA+8Q*X%ivt21#SCw5fWKcK)
z4pR_Ai%~0}c?~45+~Ge^b#2L<)ppVjGVC(>^D3W8eziJhCIxIT9fO^*I`4j(=ZP2C
zeGp*QxtmH1QwFl_)z{n_8S%XoHqp8(E$-yHZIE+Y-NaIDv>u%G&hTivUEhw78$65n
z1qg}>)GJS{+F&a0=U{9+@#bwzxlK17(%p>mJ}u_jxb2S}@_Ecx$<mP*ZcKT^1x^cA
zOP?r~+^U>31%7bEc7hvZ2ehXl1Td1p06wo{yoq)~zvQ+e2TFDdzx?(VdVs%dzmU7+
zzfj-mz1ZGr0!#Pj1*b(V1fS!2^?5}j^tMDJ^zlR?^zcLqY|?DKU6{IvJbZCMHDa#W
zl<!x3pmagZqha2h>E{zP%I<ahb9ynn^+8a5^}_^4OW!g`Ga?>~*x%Y|h)!7h`QFGI
za0xK(?|diD{q%-kb#M_6uHORm{k3@is2TShaZ$4c=n;s1M~lY+Krv{&I9)hj8kzL}
ze23SJdB`*A4+f&!<-H1N`|Y0hEn@=^=6#>@jH@eagPJVgq_yp~o$jwhUmXF+^IrFJ
zb=_(2(DPPL=OzX#8=)RT0NDBG7Z2@;=kraCEsYDit&P4PChw>(MGssLn3uKS<Nn&d
z3W_%*|F8$GI@3`ABE!H7{zceU8rZF$rPnIjD0Bh`2*rXSf}Temh^DFk*ig6iSF5iA
z^oAlR`NCPn4_59?>R0Z2{*m`x<NkI3!f<O4EcAzAlWlAFf_ZDu_?8HOqq%l3ZG6iJ
zAkY-L&+Dxqe8V8Qy#7>0w29vH*X*6Xs`KU<9GPL^oP3>ka|N{<v4PBR_c~a&wG4n`
z2z-sGGo3jP!u5KC)n?n>h`<#H<f(eS?=U`X*g&*He?`-N-fjWu`n{7?-Cm#fVajg=
zc?bb<=lOu}!bbiaohts=BrdL0{xJ_L7vC;XFMe)0^;U3n<E$%p!o_uUlaaA>qphoV
z5}e@yuv0}Inw(E=xgfz~d}|0K(%iVMG;WJELX<|)hpuFKTrjyM0g`AsUDoy<5x;5h
z-aY*`Jd5mlMk4X^qObD4kvHzoF+yP|d7;$4+%gKs#Sf&Y61tbHyPE;R9rHXs*7=6!
zA>>gQew5D5MXtnu=Bs-O%R`lZ%Y`2#3&4!a=EsHvY%0qmzA;~J9@^mYc*Gp+D<`kM
zEg1=yCo{>Tt1ZiYd^-<9oVPH%X7$xlook<RIPP;G7KxoJWtH|FwsC(IfGm!P7kR$>
z@v?4yB|d}&V<NQh0~xaP+HsH>s#VWZTp&u-#QkAi&FPGB*F<Tb?|OVV)n0sXVO}6w
zT%a#C2^#<o61*gSE(DPH4ACD+0^E=~%O8xj9gh%tF<TJsT!9C62tBHWv>?^OyNEe}
zzmaxV|9#M$xWAM3Yp)1$CHjK|ukE<EcGK#8utq}wNtN%WnaOVZIW$9QfS2~;(OTWr
zv{#5({6LSYo@ZDgFeV&i;u&N%<`rHz9uo}G^9(i{lkNk55$IF3^860cXpS&@mG1e8
zywa;`)f`qhZVwv)vPXpkJR}gM(U)Q33>)}J+8PK+0)N}EEVy!Rz@<h%I`isV5RlZc
z<D@e11sY19_Dvi+<7RiJE<9jpzisjQF!8u#cgA`54BPpHZtr;ffmJe$0BwRjcu~j<
zEAs@%45h0<AiG<JLD2D#onWWty9)$){{S6=xQAXyAvC104A$GbTKCM`o76BgVnG%A
z;)3562C_B~1Uf$Og4p$Gy{b-^7rGwfmyjZONKscm=r~dqQc3!sf7WNJJNga=H<?af
zT<EgdKx)%w73`cBCMGkq6G26<ZPE&lShymAY|N|XKcIymzz77IS%gBbz2OUw&}z>G
zgHsIcyuFLvAla282*mJM2L{jCvXL1MJD{M~YDQgN$aVEx{0FvS-dv1MY^xoKwS;E|
z!~H1tHISZV{j{#=L0t?!an-?2*xM^9tAoxbashJ}M{-;%&WCbMOAvVU{11GbTHT8U
zS@ql1PKcQe=xb2ZYH&)!<+XlDgNhmYbHLLYC&&<A1|`jL;AwkW@iYWHtyo<To*vT{
z*Ken%<I-<0*KfeB^Pg}&ED`L7!2b^fognAKJq0%AwQo+15u4?vFKy*-mJe>~LVqsy
zOMJt?6N+<&puDV#<8TokjRsVJV+A+C+v>M<;y3*Pr$2e}{n6lw;=oGqgvAN{oBm&M
zQ~>jCR=7x71u+Cya-cl<ISdFM3)eo3(4eF-?*@d+r`2n=x|b7~wz|_V)ae<w1%V+w
z+xIyis&y?x@Cy0fYEA#7uk#QH&8PMqRYEE|%KHbg|G*Cd%$5hY@=RL@mTe&Lg@CXL
z#)?^EAH|B93e9Cttm&^a1cMOpnee(5cyML6O`dZ@uuqVye?SyYhwobr9+vz=ovY7?
zwLKj6@)xi7XDMXRL#N-!|7_H#WEID_{!jp<z8%YO4*Uv`CmM+d0VJb>WcAIwZkY8y
zIPhKJKpDtw-@&6{Pe7*cb1SG;%(EZ}euZz3_G7T+>X!`?IqFNG_QpmJA+NSZcJ{;~
z-!g+@ugiv8UC18ei1&}O!io2vy8nS81ntdZp|`@Ii0h#Mf8O}j!HDa!SYBslx~6jH
z(L$F^!6PWN>=9_x^D!#N%XPtdy#I<Vh}cyOzu&u}0{LBonYtRzHxEKu9m$TPj`yz6
zKpt*w;ox?koxZ@j?7oY2L09PWF*66c-lLUpSgWI92r%DyolClHv5jw)K|vh1c>e$n
z<kxUu<n4qfR7o6{8+L3t)!@9Q;L#5O7sz>y@eY4s>{mCqJ>zQbVukSv88}7>goq=8
zz%0qJK_`yg2ykPD>4x*Nf{QJ$10Gw*jAeTodp38pV82<zkh&oEOgj--mL#Opd7YhQ
zXWlL7_%TYdi$%sQXs@vwQdF-o%F^(jpX#l4CHwy-&I^pbY-gFnYbai0rhp8(mP#oi
zvK6x9?}N>Q9v6!P0j7e@1-WM4_Ebk?WGj)n5rf>{q*3D?{yc5h$CkbS<BLH2ram*`
zDe=oisU2amm5)|EX2f6=Z+pF2E5T+(G;4@@5dR=u-D9@0;}SmD95w>3cL0C$w$Jjd
z1=lzn@dZT{PHa{>V0t~+>Qy1cEfc*Gw%Et&|6$UjDsdj+6c}Whi6LoGXmDO-AM11(
z;anMDnn59k7`70j2x9m_jF=2Ur%amK@NHjj%S_bm44V%zRwX(txfz!25MzyfTajZ~
z!`Yi;JYz3y)O#iy>s{em#<J7qEHb*}k&<JbQ~i(p%n1gIB8ONf=h*wjG^bUc{EQ$X
zzT!23KIfRK^AzWMkH}0m)cZ}@&xcZJravMxLPBpDXWN$(?!Y)e$+PPV#~NTe`%oBn
zLgC)u+p;|Z#4*!F#IfS8e1}2u9H&>}N4v_tMh8wkT>sdja4&w}>w+E%c_NvNgr1Mr
zFgcruMeZyHpGMlUCcTqD`u9T|ubQg~3H>8WTyi!(BxmMTyV4|~Z~GFL?4Q(T>Z;&R
z-$vb?{DNsDHy+7Cqx>f=k(fDnyJbs$82XYXdLwj#df(JDEgPP$o_Fws*#|)>Q6CCj
z_LUsHKHURMQQopmQ68~PhIjp?lk(OO5_)^~<%3%U+=hTlq-X-O+<B}ToPdqi0dw!8
z_kSP6&rYAPRsV_;;iOmeBgK;<IFbRAo^nyZ?R=G?Rb^FMqL5iaMLrUjih{|eake^s
zv(L+UdtL+`4BL94AxIxGx^#Qbghp8MIBnj&q0d`dQSntnLtc}mnr!#htun&rb<|d%
zHcxkL;&@Q=zDl#2Z0DA~vO}|_I`#Uvx^qLfxRbovac5$wu|0QT!If!VtGZ_Ap2d)5
z|20}O?dnOarvJ&m2Dj3qGPcvOgClREqPVwG8T*+MxWP<b<IkI}gg5J6NaX)|>+?Ju
zk1z86vi5TKI`WY7`g(JG>Fj#r;^p~5yP}<UMv7)Nlf!dfTKMSgWUFTt=P6zI3O>mv
ztI18~d(K;Giz;K1sCOd3z{Q;VR3Z6I>{~?H+s>@6iOxsqD8$3hY!qZPv^#}=Lcb@c
zCnR8DQ>vMYNy#aElnt6w@EUVp_`jgS<M$aZHL*txOIr>`Ue=f%k&z~-n7S_cKc<cx
zrM#>;eH0_j&%-zcFY|U{+I$nbr8+8`#h;uPGTO;{sl%yZl@@eMzo~4N#0xCwG8UcW
z8EK+OWle$AX7|-*;G;#ZQ*By-y=pTU{?y?(pW}>{T*QNn@BagM=>5O6>a3f*;3Hlo
zm3`jcoNYLtIBYV%IP59`rO7ki1A`1^UNm2=J><BM^%TUA?R+l_?M>c;0AydS0hE8d
zuMkhf!V=;s+q{z^ywbx$4Sog4v7AGU!##QCzW36`q_~g?#Nq;Xl2M&dK6QTW!QO28
z>e_8%Vd8ZBVjEAAn|0B1xefzYrkiy!fLtNuW0h^@ND(GDdao5O$Y>5IzM>=gsth2-
zg}h;PO8*u8wUZnb`p>4cZnl~M{(FipeszSLq7te}hzb~bhk>^p&wgA#ErLJ(Aldm|
zWqvyhlkQxSYP;E8+x_kS>~8mY`|$Ag6#V4QOCtQ**%8noxS_N#@){3JyUrWj9~o3O
zG9n+}-zYtnU%L;;6@GtuI0d>Py9w;Yr3!G5;_d~vp}N7k4ZT{ER1ikklDZAlX1bJF
z{+rALZHH>9fN?MFw`KfS$N$v<B9&D4VrOBi$bNd>EMfO*|AW<#)sUCq|D6KRT{r4l
zh+Q`lp2JspcDgC<Q6EuHHbetqA5nK$FN7kx>F!J@Bce!X|D6S-KL}+FIZ*<`UhwWr
zC?dj0@LaWrAcB<dWU-LcuaOE!`d9#<zhMb`E1m@6Jf-nddfjk`t(Q!$;P__cOC$Ow
z=S#~r+@n0D<)h0s2*U}<O&0#YaK1<I0yy87-n@ei3Rz?>YNqhv0=`cEpSbsP1|s|~
zyu3fS5<KL#Zg5=GxBwBnylGu~NXb^g8AH%s-p&zL6bP$eokfJz^WN9ou$Q;4jSc93
zo`%U@`sYYuz^Npm+GA)va?IQgx@8Wre?|NENILtrLLWFV-InC}RedocJ2R@Oy`MRS
z9G!*Rm+Qw{U!PV$Ab>v)knQO7>N4u_^zeFamDeqtXSfa!Su;e707Z<5?8gz0dt?*y
zYVqP{XYqRd;k(g0Xqj{>04=+qk*1zDaIaW7pze<raCa0gkJfTuSB{+(aNpP+OgiVG
z-Y=aPRD`3Aos|(iaorqyqm#b!^SiHF4F-6w?)Uf+9I#HBY?7kh5FhYN7F>80PuBit
zx)5TxVYoqlf`1JT{0iJ8g(nR@H=cBo29myd-mFahS7fzLL_KFiaK0oF5rw8sdJz|Q
z5E1az#7Jcke-;xEU&r$K1R2Q<zy#Ukx(hPa`-SO%Wg)odU}GbU(bwKp^3m6&QI<vg
zf1L!&bDcVtk9Y9@`n{`pacKXRxZi+sDM-)J{lbkWFir@A1HS&d6yd>lA@L7SCL)+8
zbPx}T6zM*=O(gv}<WZ>ioNMpiI1qjB!Wa#G@6b4RJPs`#6yn2=eILaqm|hA||BLtg
z_h<5de>aLUHk4La3Hp~Do1+~j)!v+@i%y}{xY@5be`dAztJ_+|At#p_>FZ_}ef`U)
zuOauCv$+58Y>#hov-TV@VV7Z1TsP<8>n4Cp{x&}$yeEfqOlK1v5)$Hd8zSyN7CLw6
zU(8W@*JhXaEa?iAJqzD)lw}6DhK^EDxXBEWV6jI)WRz^&C=2*1nu;07yY=6hYa|tO
z1n-l$tA3!1#2!zqOx$RI+#b*F5le1joAU5Wi6~k`t{#Dv+Ry!R`iP{#pxNc3tNKP<
z#SRa8=qJue&w5?C(`hjc$JQR|kGu^Ev5Mzmq;Y^_(CeU@`Mk>60{<6cr8uIZ>sprZ
zhHbn`O9nc^eM`C0-wErl;0H<a?kGU(fNb7}I$yM`&N@5Vdn@*_(cg_%N=FrMu+tK?
zA%v{9n~v%}3Wwg!YRXtR)<6>CheI;tc?a$GjIzm}2n!8jRkr??uAg3#n7g$Rv(WeB
zVT@{telJ)`S@lKfK(_|YiI*<xX+s&9O&7x8tW5~7#*5kP+LDkcno%q|kR|5`q%XI-
zZfB3q$h{FO<(*CykK#;sivT~@g&nu~R{D~R=bqP>r^tuclNjk@C2!n{^B&8hqjvhw
z_UV9xMw%bi#7job$b$Pl)~TSD11~e-HUqTTj7uSR;GT>JIPtgu;$}WUL62lyHumKK
z=w+U+6ifhG)WXl~zP(PW##aTECUn7-c!Oj^aVuXo7vq;Xe>X&^t^8@E|2BDRi0Hss
z=Q#01EeHK)Qs86Nu7NwXYZSh*7o{Pr+x0O6(xyqh)2DROK~i{oA_EQ{b*PntBI%Ij
zmOK}x)SerFyEOwxgU#+N=0j1T=G?tu7s0p@_d}usdtvIw)P33LYI*FPL8kR;xj$W&
ziN}P#r$}oqZC~on2)N-LT#b7un9p$@iKohF`UaZJ>aXv-;}MX~)xYDaoW*+S@@d7Z
zsG0P66v%l@Y>c&pjX!nu@5|x!tg`s|)LG=*{ebE{&G_E+-Wd(FSaYQ5QNpwxFtU5)
z8GUklOXC9n7ATQ)Fn&rTus%vWa2dUH9)_+)>%tV!(r@Bz=7a2u#aGwaa0d93Kifih
zA1ja-?2_e>o}K#L)ZYJX9E;Ld9A`vvB-IT!p+D|kLCXYy)wnV)9j0jk!Hk10$)C)q
z203w309K3?V7|_ss!m;9{<N<6uH9y*>*rqrILg4YT#`J8JIU9J%A=!Ub5}6ALe`zO
zyJGk2RPt-L!%N{lx`s~RedMsBp+3~;mpc6Sy3g-WZ7VZvhv_SgLPV^leo=&}bspnf
zN3nck?q*6H>*<Bp#R($>R+b4_;%G-!n~#KL9YO8H|DvM9EITZ)ev$?6sb6fZTIzlT
zGi^spqrrr$z>4uECM>spk^}Qb0Zs_}>x9I`9#xqU$~_k7(UjLnVLv2LHvbIqMT**)
z1+lXb?u;fZphN|T(`}^2YxLoqA|!Bllhi^b0_BV&M0g}04ee-iQ<$_<55dD(1pxvg
zQo}g*R|P5wC|hPqC@!oI`BEUL*+_!#nJv0dwmayev2QbM2Uqu{Nwwl?_zaRd{Xm4T
zfq!;NXNI+czvcfruu?GG_N<){)oR@!*1xfgn(BwS9|<%=-63_nS1O443>mS#_!HN2
z%1N+Y!;YWsmx>=k^eBu!Y97iM0=bQp=r%&l>rX4u81$^y*U#Uqj>V%zNbNLSrXJdN
z#cR=T39Ek9kUW%@*c7<w-0Y&YbS-VTX<iQ+#^}#QAmM9DBD+MNrWPXoT$j743hFo_
zUcYhC;%cq?o4z%78;So~CMr3#5tBV(J$p+X-%b{;x{$<r<clS>78I(wQ23ABn+p<z
z4coAfhxF``z-s25EM)+Z$Fc<A4_N=mR{jLeBQ(a?cGzbxWx#(M>=DNq6&%T#IR0Nu
z@#vzaY6l_q7+K*Z{<0Q)afNV%#C$=M6|Y{DQah}dOMbRChpQ1uRmCJ@S{82aD)(d7
zoc!8kj`1swdUp=>4@;U^8VhG+IjajAw}mGQp9i+@``vZP{8xm8iN2Ga7q)<gS#P-6
zIDbWzn{;`BhVh@x+ZJbEogppksXy=Y5ujPe3-q}E{KCj3$ml<Rn3Y>i9HKZHOZ=9j
z<KDVovHDHkXX$#5CFhj;D)rdXU?k*t^chn)dQD6kJMD)3*L?W%Q-}ZbipARB5Oo&I
zha=x)^e48U@B(Gfu+@9wwirp&R+Bf^=k+4P9o9Pq+Ks<E0+(`L<}j$@6BbuuhG$_x
z6(V<^Yjz5>Dzfv_6?Sd|e-0D-wDCk`A&O&Lxf2bIK1zB1+8FyLLbvpjLV(>}I{a)X
zfs`<n3gm2_9)~jc(}b5DMLHZj<V^A(li<JRze`?_5QbBMT+AWn($4|`c5~^s1m_*0
zi$bJ8wd(BODKqu1e>Ihs{?hC5c`%gP?<QAgx2JGe>_T^SCbv`|33(J)$sJHt$WiU$
z<*&lb>V0=bp0tK0ViN6wPqz(<tk6~Bqbjq4QzyintbH1(#rs$dQ=s~Z6FF2VX!0`#
z5xiKT=mE}uO{D*rNAO}@q6fGiV_^!^KXD?3x(2DRVEly_<DwR>+-&+N_9_nT+TJ6J
zKXeGgXK=w|@b;h6W?@8WTNFbI-17tX-Uq5^$r%XGW-8;2h4bH&h7g8oZ*9Le5}uyB
zW@beu57I2?1?18mN5@WaGHkr#DJ~tl&)<MFHCTR^5XHQId-T`Uda`-$8oExa$}m7>
zu60Bh99&vfmv3*9Q?3(qU|Dlj#<nJ(Y2fIba}&Jjj5u5)Ee$GntOV9~4vuu83!*z(
z8y5;FNxcy{Q6ZdguWawn%BK@~JFQ|~^VCc%tn90kKY-pB4bQ6o+6%G}y$D*&m36&d
zuBA4#cWoHlf+n3?E=<OFgtAi*xmg#S9+-Yx-;3-o3Fd8D#Fx~r&bxK){>sMncE<D(
zUhUA1=R<vwea@wIXr<4+lx3ln3`2+@Q@B5T>OpwL%y&Eh-nq^MG!eYOgKs6F0@rqK
zcQ?Nap(Kik*Txb1Mebsz2E{CTV&O%8X2g(9$E3yn+?f$M4TBj5Z;EBuCt(vr5SGTO
zs{JYP!qVZNrK&zAHHwZ-!?2A^MBzn33VyxB7Q&k*D;L94A|Xq#7l<m%z&tj#ithLX
z5tP82rs54v_rb75BTMiWh!(j7r9+k*Vc7|{2^xY_f`n`?o5UT1ERl*I$;ynOqy352
zBq*{EroI+0!~n_Z(}@&qpis^ksv^E@E^{BN0kuiHOrJX&;*2CtNi_8ddJ-azVXuS<
zAU#xzbxH=%dfOM75SnI|#7Ze)@-e*#(<D_YR3}jBXQcB!-1!deqoxgF<TMsW7|o{)
z6_^qmM1Ng<n5#}Wlo>2md3j?S6U1~6{F?t<)D<nLDlZ%3M7XTZ)wnC&L#LjYx^Ym3
zw7mbSQ~u4_l>Gg0xwwukHqfiB=p1Y2I$LinX(qQNnLOS?5A{Px;at|5?Apmy^LQ%Y
z$h5=p=rs@WF72;}oR%zAPoZ3M$!;di$Envh5hwiPPG4{TCgIch=v$+8?v=OGXGcBF
zEG%^9W6AeBgBFKWL5JtkeV3zlaPvzTPnTW_7um~%>%>%hZthbl-P#RdD#i21dz|0O
zC8b}8p5fE*TVIfrEscn#tq*wg4Yx+R+>6}&yR^Iy=1@v!=)2d6_17ULSGEG@Y+d0@
zS>p+hW9f^%rN1%<Xx3Ue9D$dJf4_x)Umb9v_qqfWJWhRd)g$UI`xQai()l3rvZ0yv
z0dTyU5iX4%X!YnBx1zXfjq0{d%>9#+-zwfC1k~PZvbI_8=&a4-eEh+2ZL{GY>0L!k
zGLO32-fOzH4PqbOlrf<m2{AXJMyAps7~Yb>llsk?*#DC;4q`=9>CjRS($7WJ)rJKy
zo!OZfjeza={2?mCpS1J^Tq=WC+QvK9Z^NwM)@IF&Ft%INCdio<vgbOfkCr(i{$Dfy
zKjs!EercQkKgCy*`rMh)wag)-g_35o$c4gO`ERV*C^p`TAWT$PRCv%uPPiG7ZeX^D
z*b@}>4GDI8b|^Dl!HDbu?5C&01Pi{1TBz8DiB`^+PQJ5L)}lO_DOlOVprV`Vr0Lxv
zY@)vExNs2uf7+z9HKi3%$eS#+zVKmvu=%c2(^88aZ#wGv%4#|TF3I0&VzWh&g1u@_
zE4^DU{kxlP4o`A3ZbxMsLPRRjJL01~G=+gUihNmPXv^r*8eJoqUkrpbA3Y7UPD?@i
zloRB?EzQ)nAL-#x;l+_4V~$W9sJp#<51u8-%iK0|BZ0?;_ijWWVi6)&&P5rH{-tZY
z<dpuxmixj<z3)ZP)jhEP8YStpr+tGLy-u%y^$R$dlow&%yoxvG{iHDIK%SaKRJp&z
zZ4_G?A93?*eT(i}auy77Wo}-XYZpm;E>h!Ej;_8>%a<>!CbbWJwMgG0yX*6Q7Zi?9
z3iW6sO@nO@oVnaviTL$nEv3#v<_kYn7Z!UoHpZpSPfhdd>PpL}QOgs5%CGq_JNLbv
zNX1QTd57Y4B<#i`G}HCu{jYebjwk#he3B8HPt-7^_gBv%7~Ee!95f=w>GGWo9Htl;
zeT%hg!^$Y7KdLIi{roI)j!KK0IT$?qz@Rf`5T@AjV?@q9_{+I*x|Kj;-aS5xQi&|1
z)wzzwkO1M;{TCOPi)Y=RN;DnxbahAuK41VgT9>v6_`}ptu3R$R7M{}&;3BgDGj89P
zN_0sxjs(XBOoK(rOgYMS5ot~;iP^cxcA}YAz7jiU1%p_dFHtsprn+d-1|E&Wqz<mq
zBVcPj64WTPw2<z&(0R534~2sUIZo8NmN=b>5W;#Yo#|tl)EnPKnl3a8mufn?e0$|H
zm4A&=G>hSKs-@tyBv!s#Mg=9Ikwo=)*9e`L!(p~x|ML%ARtY4EAqmT%si0-tPpx)#
z?nn%+Ri6!wi9=!@4plmcMZAhE0bG~zt*9|d0vKv#otb#~-Lz#-<gL6FTd%q=H?I9!
z^C1b`(5qU$-Cy`^q)eNX1C9uBY;bt4X#*VZ)ry>4rsvS~s%|co?4OMAhbTr8)4lw>
zJm^1qeLn%Gk9}NW$#d>riLi)(rL$=w_t*vYhHT_>(WMK5cK8^NMQQU@C*?_Q*kQXs
z=UshYYaLxCi4|!72>uvKz8^U8fFT}s&q}b5aSg*JqD1l?wAkVqadk|!SY;e()k$?}
zVBELV85m;^Y+&5B)EOW99g}5&$YTe`kMturC>R&s?xXJCw4RSeyQ~!zK1kE91WeMZ
zY6*MVMLQ4AeK;C!KZcQ;+dm`*?xP%V(PE#0FVhwDd<y#}huz)TNplpW@rw(oPOUox
z_%nVf<C5A;kx05R+UzI8!$a^bJMru$alEk9Y`453_pYL}>&Rxrr@}VB;sXR-MAm#T
z4p*WhnAUt>+WEie#{H<!ouaKRtH9N0Dyf+NHkVnUJJY2r?vi|CwDU2vQe3^PqKsk|
z#}P_Z{Il&x$$%V`GYvu#b5$d{qvLOrB;^#}zUIjpd@n;zDCFbUm6p!Zci)e!_)_tu
z2^~vA<J(-~5AlGAGGrCm!5_;AKFhANUPCjfg?C?bQ$wE6RPjGOvDIEg@NWFK#qkkL
z-dGt-DU;D<Ea*;*`AzH=Pa~fhIkh;b8DkQj(Tg&`Pa~O3!$fJP(>JQEmYT53pwmsU
zf|ALY@==_~FDmd!2)KXi`{rv{yC3+*SL>Gd{FeQkeeaQTtdCEFLo74k4WA?w5{biZ
zVs-H5+*w*G!kvKB-_z*9x=31d+AG9MInR?Fj()Sdy}eQ|^hvJdrB=)!L5%dXHU&x*
z2AbwayttYV+6A=Q1$f#8+}ac}yx%|k{~`^RQ&bI}Q&b(^hYVV=?i<%vGILREC<Zur
z4QxgYh*4k+7VT{(!C}<+Jaq9<v{x-GxVQp-UaP4`3W}+2ZxY51jbQQOBW#B>!9j6w
z6BX2*JCyMl^!GI?DDFKdV{lI|KNJb02Cw!+PzV<SNfqCwu~{7V;$#6TUL3bJ@3JxY
zyW$=+X`OQq?KRY*IoTvMGJ-ujI^@>WP`fesAULcL8E^cZJ_G+XPt0J{CIJW+g^SjV
z^4;!xBLa#2D-=T37^v6s+F3Cn4U!W=Ex;j5V;7}?dgsxd>uzCRfPbN|$jSS%PnxRp
zrQb2HoB&M%aO5&;cn=qd2W7ppobM>AFYgLpU$3K#%P`Q+F;8MC61zSZsF@>$AH}26
zm<iGczDXGQe;N=;*orDuYq1cB6!zyovOc==KWbF*=rj^t1QO3-h>~t&D%|v!Z(kTL
z8gG2^0BjgLQD#(hcLlNlKY92k?7zz^qrNzG34a#)d2&b`1A4bYBS`0aBalpxLqxmz
z^L&vJvepl1PZ!YyRXT_yjQe?GKYIF|$2RZHynVw+)tJV}4C5|0RFBo>>U>1K;*v+^
ze%dXXee4>F7<>(0@I0`I$2*id^gLGYD9ClHF#?hSn#M*wgI+bB^dtx`55A+hbFY*z
zy_B_nUmR0urf?Z5j#6)|!|YD++&G;RP?|eoupAOh+E)LvOl0lSXCB62t}1x&N%pK=
z4|l>9!)$L3Q!XWunwo?>hx|s$N|lLxu2wshbxSdT5zF#gd3mjVLb<Z6CT7{S>&~&L
z`_qGPX-)UDPuG&Uz16Ez#?kjrJXMNtQ-4;+NVNX?d;0xwnD8yp|9dhDR8!03?YETw
z?8qmuo776DYbmkRGI+@5v~89g&19LPEGR-mxT$HF?^)DbREHJ^hl0z1no?>Fv$u{$
z(_|;KKWVK;H;7fzeJwD~h(KSHIYi`6V4AsQrYOIQ9SWr-D<v2$>+S1$)QRpjaK$H)
zy;iZawPlNSq;;`%I*)zI6PEpe?Lkao=u>`Or<RJ(NHNn})VcS`$)DMYWP!}a%X~JF
z(%_ehXT`;dXr;V!;wmM>>z_RuhIyYxa<#;s(GxxX?#b<4sWAJD-=OUbY&b1uv1=Hj
zShC2fi=WCS_iJd1J!~W}SjSZi$N5M|o_ViG?)cHtBJy6{r(M^fJp3qrpWQ9@5>+o{
zmT6*!ZxJ_nZFem-YUT1A%8z#C3EYS4SFe(q(;VQ!#1m<&vrbjt+FYYxEP!c506bC|
z@p$zU)VrU^Ow-F(DSM>xQ##oTy$qvAr9{&)p%cwhWNYqzn4F_`Y6@befjQNZKgzMD
z-@_ZS>cn!~>M9`Ps?`^xV!qylR^z~yn-%T&Z-FR`{}OD|2Q<h}ey>^J7mF0_M|mV6
zCD;I1H#*CE{&brSyq<jPI(o+bKIfEXkh6k!Gh1>(j>hkGJhRf+(XNZqWV+1Jh|0|U
z`H9{I<XEtfod{gzid!=Br}`t-_^@ddn-``)64pv*{&Go>P6p<>WJJ2={BtDNDxpZ!
z2!DXqfEWiVjHo&0nzo^nT+NCjIT)Q>tltHHJDZW<T>*aVI(c4{o8@7`$~PD(#Ma6x
zLWv1w(b{vgjiyult*{+UDEVVc-d8V!TJHJ7ZZygzdnO_cK9hYpeoJ*b6Y!JJrh`|K
zCQqiEbu=+kvxr3N<OX|qg2hzyqh2B0dP{t{2hV$=h7=a)1bDtluVD}x4J=J!oaBa~
z5%E7!Jgxe^J&mw-^3ANzExb)RI#1w>y}y1H)h(&0`Wf46t*#cf&ByPq9T)d5$&OGz
z2u&kUyF-ZLi?pI|s)eFBm`;ZuEknm+ik%3Am|zL;jzgh<JQ-Q%3@zrxwetH_oEeYq
znrLsMywrws!1C?~J?AG|SCuA0t>SO=XRaqJAChF1RIQFPsA-z0@t%ba{f;I@bVJDZ
zC!#+Ws5;a)qG#}CzsA4DFyjP}w|$y@(>N)wTyC4!#QrPB@pE@wk0+srsFaE$2Ychf
zdO4FY(SS>2Z`=L2R50Ymn&0h_czH=_Kqs|#G>zAY)o}JattxZup?jtKgQ^#D?G^Fy
zlnXz4jr-T0IwM2nmt;G!r6$HcarB!r<P<5Sdf8APnaOyN2i2DivW;_~+1k}k9Vawl
zF<wS}`dfy$S|AO1X=*A3-nw|*TTLL*^{Z9iOE1m-garq<PmZA}&Z&Xgwfjy=la-yT
zdgg48OZGmr5BR3SP2dC`mU0U$7EC4lwqr^=^2j7Hp5puaGucLMjWCr^<V)-4YVZeq
z?6b;AciOg;8&b;h@Ci;fq>#HlTC&IG5`f+%|2$k)`*v1i*(6iaYd9A7vN<_hX?xA&
zMFA2Y(kR9S@WbgZ4xlbnvG!4+zxc#G`K4KOX_2!=<&DmC-oXCu7XyB((bPMv6mVgG
zv6Vzq#*UQ?Qs>F<@?Vfwg`sS3TqB+dl;>xs#LZ>h@s@HTbzUABmXC4F<dSfM$@AY1
z811(AW{K}CbK*pjK8smO-RW)?a#&ihdLsP}R7Z_%Gc&|go;O>YerLSUF7&}R<OqM)
z`n$YLV!`L8wySg7DBVYleSeo0Zsq*Dqk{WG!Kt?H%yLW*!IH(?=6GPlP+t7)iF<R|
z{1WoX`N&_1@mUyw>XPSQ>xbRqENVp2t{r?bg|~@&NK-*1OV(X+9gN%fa+f@uvFXx0
zw%%6^)7RurqZeiA3;n!QdVlPn2epZoKhXQGScsqBuG8(kUGk=VvX(Yvr$diAe%|*E
z-i5_p9uHp9u?)`Z-I`hI^#kXPs)ttzP-*21XCNOsD2L|jp@U=niYQa~=T9Zx(5wQd
zqjqE!`H{37eM0qoWbQkSixy9+BfWW$750p^zDX2$)RG=|IWQRsrItvL$^JmcYqumU
zfznWH7;|Xe=i$}&%@W7DhDs<k5jOHHFKevmnB7o|zLgMq$WOoi6t&Yrsl`*Z(iikY
zo^&dHQN1I?j__u+^Uu-;KTYEse%&s|#U7;|E;Eq}8l`Z~h}I3-k0JPS+gkWlrxj}@
z#LLsFu;_zoFK15+sKiQNDL0(`bb$9liL0biv13^Q--*a>`eOo1R<CUXF5_LJyh}s!
zBCgY)o^pPC*w=$cJI{#w7)2sceg5r@w<L>WY2&y_45;v1eP_6}Kc;Tr&r!r&T8&JR
z3_6LHrw$8S<)BrjW}kH+s7^2pH}00D|0$=!x+y07`L?Eh055*j7CsO`(CrroL*cxX
zx=zAPL?!n1*ukGKPurYXDLnWYMl4HaWXo0QRe1B+qqxX7$DW|OQtNsKgs}61rGwo@
ziQfq$3caukzGOxA=iVBJVmgIUvua2FvqlknUg1MZeg`N=$+YMxR!JAg7e2ld(}5@2
z2C(tU;?wTSRDAo>Bfs_?IM2Q?)NK%WWe$3ELH(WzbkV92Yyq^PFpRO~xf#lRzqUY-
zT;ElSbaUZAUW!`Brw$KCLGT#(Cj4VnJ!^=R*|uuY1>sd~q_ywOqMxhW;N%gj%Yb8*
zDrI6UqQ?5#q$@~#N13=tI1H^sSH>kreYh%OrU)R>AkKP8wtP$9p6#JpIJ4-mgZATT
zX;LV}L6n#8TI*53Z8#OuSy7nPgUa2I_Fm-<S#9I^CgorXqvk4E^iUZ43_0gPxuHac
zr2LUR!%nFDnO}Xl1wyHHFS+AcT!$2c1eL{@zKj{yFD;Br={{=WWbfY$EaMV?KQw>!
zuAO|`!_l$9CZ4j9IJD+7=ij*boA?X^*Uh?swq)6v+(-z2xPB5jVtw2!)xq&QEVWQ9
z_4HRUB7Tf@aqel*Zp91e&Nb^rKIFw~;6r>ITzd=Q=<S}n0pYj<9-$+>;QhJZ_WE5z
zKmlT(VNu5(-d}3*=NHkoO`a-)>pPkPgZQ;Top7-_TAuToRF1yx0j#*&6elGer&lyP
zIpF-pCxmRuDx(>>%i~rlnoSJ53=|SmF6^HG8S7t@h|KXrBAu$lg99dYAf{6h8!q@i
zXYArlhxhHa@@j)Ai3Sqh6}H1%TFtP<>V;GyB>e>3$oU!N#z}V4K6;L!Wmc|SKWr+9
zT*+%kTE|~$R;AhSRP|f7WM5-&Rj}*3E)S1-P5$;UXMR17xcMaIejM2rVPBuWVJNVM
z`c-FvFHtj+Nzo4~$xexV#1}K+qTFZhFZZf<N5+Lg(_cRl4yT);{2t@k$^vJ6xf*M&
z@+1r9w)<6ivD_Fjj9U%xOhL@43cwMVLeBg~XTEMwi;+l;*PMDSxO~&|9N-x<P8fv{
zcaFsTIl;}+KP*E0kpTy(tzs{Ykr|IG@Gk0kTAe|-XC1`PX?(FoIXW;k3~wu%$};%%
z_xh@4SJ94;p<Xg;dO-2`u`&W!bwnmruW=7w89QrbI@89Qv!=}Vd?j>tV~J*_f#)LW
zEN$U}!DwO7=_EQM9uJw`sP53Jqgw1YMuf;{b^J{LL8E`Qfe#P8<!&ltrXJZy`d9cx
zXHeFDEVH|MHn;BuUfOo}ICGeP%CK~w-2k8nzbhrQjpH_Ncu6t5A<#)pZuBV-(US&1
zI=P@2$e2*`5brDvp9~gUWoYtd79U^Xh8r=OWnKbSCF!Tu?JDNT5Cqa$>d6CLynk`6
z$<1<i9eW-P4`M76kKjn?n3;MVvA8T+N_d}_|G;z@?XRAtF!erfxep>V?-8n#%H#17
zV!!ZAi`K_F8>0VK8j|nE<=%c(W;d5K`x0t4B{atEGBy_ZmD+)*6!<I#9SU3j?QC)v
z6%HE1gDNZ=q0sFbmpNJGoK>LI9+dgHsVGE}Aq$HJZT5V>UZXelw!ZA55*478YK^gT
zR6XaUl#Z~o)#8`z0iF9-U0nFwnLi*Ms0LIxSy<WwNmnEn#OHi_=l-}(3@vFXS2yTk
zEsjtj4B#U+)4&PIe*4djJSeD7?;E}hPR{Xa0dke|I$V-i@zCelKdUE~|6C|tv)E;L
zL~TzOYfKICx2ws!MMgH=JcUY~5;wCK5A-_gm9t+Pw^nPn`B*M$R{b(r{!*?@_eE1$
zQ4cd}I)>Ax`4nFR(M-^*CAC5+l~T4~pP}rV;#Pj6)|UV%Og<|n0e7qR)WiHH&Q$F*
zYFiETmvTIV%dTHUK!RYAxnB&Agrx>eoOAX)^(QLHgx0=-DkL-vOE<%pMyFQfiN7iU
z{!kLS5j|3o6+i2x!dj1rmyiGz$e9|;*8bN+6^*KSG_xXb9?NCEeI~Aj!hMJ2w6S&}
z?Dpx$SSTo3Y*XE&Z9mti#Xu405kIVogz*PZJqZPTQc2=QpPi6&ofdI!hL+4X{MM2K
zck1#Qqbsdq>-enwTp9u(Vd3ZEHd%6L`O24TA33&j$UUA_E`Z=RPXoi}RAOkq+o^-Q
z$m^uJJ(CT-CH%cF4rmR|NlA$(YZ%ZfTfc)oLn0cufbt3xMnzpTD!4M$nf$|Wz}2qP
zE;jU+VMq>uX}zg23Qkg%&p-ci6%=06X=IT-+Yn#9(Bs5q-eHK{xaFqU^J9YR>j>_`
zq-co9P>FnDFrDuL2GpT=&!6K9d?LsQ$sy}%HR#&AZR-He1(n75^}^axlm70%ZbDs{
zaAR*ZbluGsna3PlYqzKl?ZlEZ#g>|TOaR<jcOa5~@3Y1vTaXcr<u#$9E<mz+D%ELt
zG3N~sH79b%G1IyMce?!|MZOqr_Sfkf2XD!XR8zA;X5e;C@%V)fR|=N0mG!P-m0f9R
zafuHPp+T0<p<=lrs!CFpb)94&K)odGEGy=L7#htRxrKtuhWp%GUi2eOyEWohQ7z+-
zFp21qT<tJ##-F`S|EeVsOB{H5eqK*M$@;KP)|lkku`UZrnqOfOuxUBYfn47N*?N{T
zMTWWOF@2q>X7Zh_s*K7P%3(@Xb&Gz>XBhHpo*XJifUo8WNWjXt6yOeg3^ZB4uE}Q(
z#3%ge@RqD~Sd*U=?d3y<&%rllu%o-xnxxt<iz?XQitj2iD|r8qIrvs#r@3utc69oE
zWg|;F89kkFElvC9XTw@|QkQ~f;?_-nk*0v2XnwV>rUK+`y<z+icaUX3f`cQqC*7#0
z|B$sb{;FQu$4nT()dZ>4)Wv0OJ=JOziGoS0C>9{BwL>Z8(}nR%G4V=g5}>!tFaBE-
z$7N1pn}`MHsM2}LJU{!X>Gf_At@?0HKK_xxQ`oXvufd^oCV<8rUucR*5mvsaW9ab!
zrtE<1?kKO%eBNDIMe+V1^N2h+^Q>Ob|NbDN_6^k$IOt<cd`eIfJ{U5-DpcdeoFua4
z;Y$Lrm%D<FA_vQzS_sjCV@eXczMc>I*&NOCzH%7WcfAEziSH+9M}O&BA<@Bq$!(6$
zDT?*_puQq(rj<75oVPxw`1(W3Id8XUOE~i+EQEjkTnErI6S0BdFRXwsuvCH$Y^h>-
zT}KwSI4x4<pp#en6hM@VW?NaRUiLL7w|Vx^#%*k5Lq4xW^G_*%ZgcLDcWSJ46fW-u
zY98tl-NaEB??}a3gYVo2?Te}-CxbB`O)rXV4Cm#K0kPz`(-db_PUaIw*IoT{8V7Dc
zRvOSm(0Llz570?gHo0JjA3>f0noV_$l_DjEra$Ma9<RSTjZLU$MQn+HaRG*dDp1u=
zopE^>oJPLFmm1jd9{Vl(K3zl6JWzS1_}cbI(06x<-9b7a*nwd-?q@+!ON$v6<Qb9O
z4<r}03Z)F5J(V1cA_FT8iVG36yjkF?o9~(UcH3QP2Z+uu(FSX&WfW-I@d>1+S^Xyi
zmUbkj$Ei|w2hp+EszP5q(771v%nso1oRt*e#wt27Zgd}mZ=0^d^0{j9tr=}I+w){k
z;9)@gOUSl@>)8Q8?TC)2X)p0#qAlKS6+{FwQV*kJuN0PmQ`B`+#_A;@qhWG#Jekv4
zjg8!DHgfMgvN@Ci3L6;j9n6eH{8D;_6eS9S=60N;$%l)!1;37T)t|z>Do0u$L^}IC
za7%7Pw$(H>5k8G<A-TWQC8$(VeYZe0Ntpw8{|>KTK9VueNutXVBei2-h)3MGl~ZC5
z;}_JVqMfO)`#o*}oL8+T%CY<Feo`^HgIKkLkej?=5b?{FlkhGpe#yR&jDKMennLi<
z)JnePaq-<a4Ig13a~5QHT~8F&F*NAwiq<hi_lAhXy@kDvtv7#vD|wcmH|gC&dV?*5
zg`=S%-RAAg2v-Ep)}k#Ly#Q(!*{b9qN*p^PFBoWy`}Oq835P3?yD_K|MS8YQ+pU2p
z^&UL&Qpvi<GMWX*b#eHbCUe?<8Etf+wbVZCq46`ZLdJmf%hg7^Oi@Kq^6IGCPOa}v
zzMQt9#!GK?Pxz`<IHKa1<pRDs3;jS!p)U*Do2JFkdks3wK!o#k-@+4uWY({r{OWJ$
zuQj>LpLl9tjhyt0>`ESpCpHh3T}mGEp3tbr$<6)(6^EqpdhRYGjxKvy^$z`nfGvFc
z_v_J#_ws=SEoW7i@)vt=L;S*{dt(4r$ML<iC(1FF1s9um?bctMMAeZO$RTFnFSv7T
z*D7Ig&s~xNDLN_J6)6Gvf;GAb_86r1cx*fN_pSBNL|b2;wY7xfW;)@j!^pKBquzR)
zI4KUKutN+7<0~^#|4u}=t<O77v#7}>E@)7FGLU(<agVcj;EUp^zq$M2bD!i(MAm9j
zBj2canrOM0%r6^X?0NVq1+dYc$XlvOZbfVzoVf94Yld!{p0R(|*Br19nF)VpjTclr
zGrJ#}Ic&jjcQM~I-LvtinZPg~CM2j>o@TZx^MY%Nc8fF0x*Q9dBKub3=2`%2J$yCM
z*hQB$o3Kmzx5>u&g-FfhRT0%uv?%C7as(5#ogglZa?Wlc#QWWyP3umdDVFQfRqf9;
z96?$qO>D)-_vv*+Vrdg?n!XCz(OWf~3-TsYbZDJH*1xiwuhW%<GBToR{Lj}E`E!6T
z97BwtDjO1WMKjVq$`aekha++Wo1`hSFR&+5z{bUy^z}E6rI~d8TpM)vCX#oycJIqX
z83Pvwn^@jDMT?G^yq~%!jco&F+#Y7?k~P{jDPun?`Gfa{<_d7?koS%r-B;ls*FMlB
zrRLNAEe1<3$E=jMiRh~}whOAkAFt~-eej?w7c%%@aGI+U<#ZY#apsU_dC5uTDw`nJ
z^1}jOV?irLLhc5wS`c|37jcP&tERk|7Ivd|N+Z*saf+*&VH<dCDddL_v_9sC9eS!d
za`ntxuOFECafC-bZA#D{4u43LOY%*@qtHyz%I0#_TN#R~<UXLw@FixxV){XsT>UKN
zb2UR%CCju3Hgb(&ki@a`8WYR{QMu?yBLZs(f<@J0z5?zHeBv15nefm@o%3Q!a0)?o
zJyr;Zh8Vt#IMf`0!gxPI)$iLHmcSoc_K~*K&)>y&6WOE_i`4=^decfWZk=bxrxeuG
zZ9VA}zL%cqs;?CMTT6{E>@{_TDv=**Db~{}o|M(C(5H2JqVJ;a@7OgxWh#zSXr9yc
z$`|0b;KRQxJoKupts_&`H;R{33Vmxbog*V6Z_yS&nUkjhr7y?jlZIC~ika|~)%lrz
z=J2>%I8_-46@Tp-7BJs8ASfBNz-N*vN>8MkXH7Y^gP+Jl5g|l-HE+F00#7Q3%m1H=
zxCmj~i#hM3EcV(LNx6t{o{@d{XF0O#lujt4VeIZiga8`lCpog46hSb9&!pCsdqq}J
zkixm~A&ZYK++7;xs*x1j!$>5`TO#@^jnRX=@J*WkA<N^W(N!35M;tI5@s=3>LSqCh
zNs*X8vcX~yVqDZiN^ikAC=i~LdbAuv{${6n9sF>T$|V`JUPdr*;|Zgvn%|BbwpP$b
zR)5kOa7oQpa#S#FhV(7ykWF@oD#fmSQf6+nlMu0rnNtmbmF<`-k;E=SRGdlsI<zrM
zZ8<=T#BL@%_4-(3lk8d3$4+a9jm-38HYk?QinD9RXTf`IfckikMN#bB4{zs_nMRFj
z>f2qDXwa}*)zPQ|No6|}_TaPtnp;9W=R_JByXGxE(zAFNtQuNk`p~mRd?LhB>_KCX
zL*XVd&)&c7&WfFxQfGn~;gUwz#t4MufWcifcEgx~sNm7X%O_qow}eanK3E7VqUXNS
z9vFD+e8NuhxK5)jfTZP~QaYrX)N3$Qin&SOoGiDf=Md6)We0B{y8;acja?QMA1OjS
z%!ePnbpI2go8s=i9DYWT<yPsq`Gk4i-LUWe&=zJ=RB)}3nz~WpTq!NN(3_Ex2H)Q1
z+R)9cjsNGYfr#HW(Bey+M1K>P3(}MZL5uEeF^Un88EcFp0%-B(yNP|c13^|)I2+c0
z{y7sI_X6X3z13x$P_&0VXvQ*X@Q!f~aZyO#Bd)0`x}pM0Lp8_SaPE>AeHTbbWOpJE
zMLFMF{^xT_e^bn^?!dtB`4Ok3!@kf)s+4;9hLA2}Zn8?t=z3djl1j@E$c&)U5+O#T
zLBr_;-fdEwYmi6tlHpYSEoehzf9lx^nI+zy(zj@x4Yk)Z1OL39Vjk%_1zFdm8|fNs
zFRUn)V-q!o4-AJ_0l@@Nu5rWa=4)Y>N)|TBZ1gpD->~2vsXrm#{N-ZFhPC{Ke2e7r
z#k;7y6qc)bNfqyhY){_<wW#&!QT(oT1u4`lnx#efpX@_^ORH4;Nj~~92D4!QcONc5
z6Z4Ojn6}-o({+H9allBld;X5iC5@cADuVHbq@l2+FaRh6e5BU7Bu7!0*g{=lQF~O7
z{R%_Qz#WH6jF5Ri$t5fN9nZwe5KiEh@@RH62mdFPsFz`K?&P!l{iMI5s#6C#iy9~)
z5ll~hCokRa&@5_%QozzIZe$<SO(6C^I;=bWt5Hk=i{&J~_(3$6JL?vcV!Su~^){7Z
zWXF)&38j2NG-C?$Z_ZQ7y$17gZ)ANUuS|@ECD_JOwK<kEd8y%`;dAs6Z4+B@)INJq
zaTRLXQEi5WI*W$7c0E0tmu%;9ce7!IrRj#=hXALHwfodZ{|T1U?=jkY)m;zK9@0{b
z>H%Xup?Gyjw~AqTm+(XE9{Y5RJkl!`wpAp0sb+&ZXrxwc?%BKCgF4J4R(udO>5@uE
zI><uw*^+kT*2~S%E^GQ{{RO**>UrMp2Rm0b^MLxC+x~>xe){>6M!l!A&Ni*hJwxa$
zzcBkV+~xv*c%r{r2hF&J7f7}%w7UGUd8#GyRKa?VH1=&Ncd2?dgaulCn7%Y51zJa#
z{5mF{{~rK=K!3kwVBEkmCeBNn0S4C9G_W>}RMbVh6A8)JJBDg?`nAtr@zpBZKo$Q(
z?@>lBi<X}g9-#FOAVCv-V#I&XoU)jsFB(-{tv|1vABif<BXKqCG^<mc#uzPDt9~R%
zo(V~a2JxTvi#e65rjCmT$3ivrQFycAaqCE&{A4C^VO04!$fQXLlm6#zG$YYQ5ZfBU
zW{iDtLSp*A29sN(ngi?Bs20gmek0b<`$*QbD3f)Lg=g!7E_D`Kh4JpeZlMEffm`UH
zTKX0S!b0!e&G>PvSg!w*_&Pb_7wQ9XsfzLDxD>5lTuN{I?!xH$i1|LAtcK!i_eyVN
z)<&X*k=okSPP4y!b6&oAhPP%aq0He*=_4EQI&oK1s!RDf?Tb`N&v;Yx)X8O4txBF7
z5WZ4OzG608ycNQ{b&BD}La}PW&=#wfVB{+%I{t*1eshZHLC|O#6ZHfGa<Tr<Xj<*M
zx-upno~8=wSmH7A*Re!}f&1yuWM;%V|6NM-+39IQQAc2GiRxrEwnRU$r!mn$U~GvV
zO*~`EOcyHQOC}`9==mjTR=SNi+6Y7&5ojZEw5-`8UgjPCEQ-(rIBS|>vM%0Nr>3lD
zAiT8#-dYH6Z6Lh01TS72Q&T6XsWY%=E!C6TvsN$gPUC#ms=-|0;Ea6M(hHB3&pOCw
zo#3-B&WDXi>xhs3a>0MQbzXZ^@`9aWjV7~l-DAzXYI(B+c5QGnS*R&42n4!b09_vk
z$~w{dK%nbW2KZ&2td(7_pXSNTraoBf)i8eBVHshqR}<~9N+GOL0jm_kDh04g5v)?Z
z7dc@9E7(IOd?hJOW0!2IiFjv=*rj}v72g*rORUbP>?mVft!4U=?P)Mxp~_UY+0JF2
z{l5B_>AV}Do!Q;GvAcCo7--(CH(PZm7d}=V_c7Mm<=*#FW^0$LY}wl7R9oKK<$Awl
zw(!hy)z#nJMk|!7fn4vvjNVqR#@M~B0(x78*V<_n75ey=H(_Anj<LptvahD<TghiP
zmBF){N<O=(%s9KL6tkO3`|PGt&u&`!W;b4&$yTXKwu;|Ps#J@lk$!Qta^a!I4aT9y
zq|quX)lBJwVH?Ow%W*}0$$wnYG<Adi+_;d5T6=HrOiRaD)2ix1sziM)p2yYFJdRhA
zwMuRBHNbzrTGbT1vDfN~Ervc($9;kXdZ5-dEA&ps0mrCQt@#UAo!7SwJwazs>-4+r
zI<ilnt_5oVb!vd`Ey-_7o&FL;zQWh()B}rQTh{9ne06lM8dV#qs<XWJ)}z;jdL13e
zpM>0KhI-YGH$%PZX&ORh0-B*-^@=s2*UwZlg!uKrv2eWF{6YbFR4scf*6VfFS&8qB
zMLWdwyFm$c-)JPbDPpK8VyTqts3~HqBX5eB>SNZK$^<k;jAmciiP~A5BBqyVQmx^y
zT9DbB$n4hi-c%d^)H~@^7TY)Bm*`EZt?X=GOwM_wRS_ob5(~|!uCTl-Z&H1crhW-c
zuJ;5>2=n+l*d{f^(=Eo`O)6hC;>Wp@>kmznxsFQ`J|k8jE>~G)F=uV5u4MT+3-gxN
zMQZEvHplXYtGbf4d8Ji#Q9@mp7th#`S1@LH!SMWH1$h;vMS0%lbhNs<qHb8h@X=JZ
zxT3x!lD8>RTwGHd8NQx=at<4il|Qd#6J1h|h3P?(uJg>Y#uaoPo36Cyhp|c4!yJA|
z(%1U?e#W*i35LLsx~jABEQ#;Vi?i`mDhEAAJUKt|-h@29Fm*lGbPz3(2fdX}Z|TIN
zAn=b3l+Iq6YFE)KR2S+JX0?62KwmYxztTA@(WwvJ`&C!}6GZ<NYwEEl^&^s#w1l3n
zG=?M%N%sm8ci=F(>bVR(B6Xz=aj#f5iId)2W^@F)oJYQvoDR^R1^z$A0F>Pgl+EMk
zyj4|+H$X|I-SrVAz*Ngkrv7W~Exz2{h(2Rp>0td$hcwDE<3eAnvVQRfG>aRd_tN4q
zD0~gc$9jFiSF{I<=HtK8N#3xB7mh**2f^F*(2=eRLEK)tQV`_XJ;}2nMPs#87vp0y
z$y&00*Ha(cnC<_&t+zlRx<D_Z3-khAAmxU=j5kO6Gj&+iCu7eVrBiwOE7FUaKECpj
zzGv5<j?qgE_IHe4^qTDZBj22ItKOh>dZ!nQ5|!w!TW7xi@3uxId+T!;$=33}iK;%n
zw@&>>%$-(S8c!XXXwW|13D2Z)ef0QO5vf`iUC;caPn?MFmwgQseS=W+HBs~hDEj(P
z=s4P1qUU^RmrGTpuU>AM@Bh1t(HwpCM@exzeX_ocV_$lM4B*&Tjq!8rtH%5Pm<$HE
z{>A{8qd)Fc(fGt(4sZSSxi>JpX}N89>rV(ms%n!lHuSed1g8r;9Jv2VJYt+79GH5>
ziM~ES?~5RV{JuOuJj@2@ceweHx;nKkA`a!Lf&K%G^j9<gw3hyE>4QaAW8qSQRa#_7
zTg94}L?Sg_u)RVsx((EUFOoHogVUh&LBgcYLHe~$Pu=(#GV0g4X<dezA^bd|miUgL
zrL7$5okC1oIaIar-Fv9+eZtD2IzCp6+?nmf(}m8y<^>*^PafI0xVo~&n{CG0S5@l|
zSqtl{sM;lkX};!LsCUxP&{JS~wpp0_U4g~33z%oi4`!)ITlQwAMd;g5l6Onbtc?y)
zKo2_6OA6G;pmhK>GQROA?eb$D$(I30(md8=9)EWxaYyX;o)3&N#?4XQ_uT7it7GCp
zFp6yid!n55%-dJ64SQmY(#__pSo-%pVmXNyL+{z`|H%O6O=c5~(_7l90Y1JBX|~U}
zc>DOCIO9~dZx)&ol7lSST<e$6{ARJvVd9tdh=o0w@zVjZ@G^QsDlSj9Yd98))^4I}
z<C9fNxAb`B3&^7XN*j>RYC4`OC2Hy&p*LzeUPswsH65=j#cMj=J0Os#DHwSsriY9a
z#)Qo8{uA|~X7;8vQLjnP;<660W{dUR^rxPYGSNDd;;%aX)|uqr2-bhaT6nX)_=lSE
zQ%@?=OWb%8JvNLROShQJ&*^GO%$XUfE0&$(Tyvp^{_f(d<heSAe*DeYkapEkL`v&;
zWD>g48+4a*)gW1LaAK}oRKL!@cuH4Bm!A{LA3iEw{d09z6R-Md*%Z1H0^o0msqt=V
zFrO;A?o|D?U7`Q)cHnO?HJ++E8%;OWzd)w1f~K3Qk;0~%s^d>G&zq`0!k)!tqnY7s
ziaP^%`V8smGqk6B<Dh^3I>Va<_<q-tkBBpLR0)B2M*5q&L_KHFq_Jrs7!qgDJDX)l
zoI!7HS%vd`hvrE%N;H9%`G}<CGwE^eJ8{m&(>eO=CF^kLsWT`2)JaxZA98Pz3SyFu
zZyw*rpv(TxZ0OHEY?qKkR-5Ojp~hr-4l&R6CesUR^`^T2$^_%M90{iINsnj2dB#NV
zJpX4Z`mb1y{&!)t8cpEN)2}wOL1&tqbgRTN9tqkd;_{_CFBK|3#~bt4Rg?a-+PV4(
zy?9e)QFX<<bkKm5+nw*d6s215d=WW?M9sY=taPiNZ+sI$fAVk<Bx=L<$4S)D=-lV)
zUK+1g`e-Fdd-;p>NiMV{TJ(H1(CGN*s}aUs2clpjB+pN_6l?SI)wp!y_?zVd-`9Zp
zkL05;jrs!L=V0_lXTx>mQ*d7V9D#2WPK(kS=ILCEi;b&Y{a3ph-wBYQyZ>r;ezm9n
zYEOQ(xBqHyezmXvYF~b}zyE4~eKiGdo*E!VhIzV^EjGu=`N_6Om71^LbA8{kB+1Pu
z%k(!!G;uDiquG2p&Fibm{O2{*!nDUGlr1EOO?Z}H*gid-NvdB+Q|oq>rFA+6eqm`<
zq1SbyiF|Zo7+d6@7Um}pZ~6^el$;i(8*GuvPFG@)p3^Q##9c|r+REwJBC41<9n+r;
z@afnh9T|pC#};X4Hz$ti{<GMakT3QxWEAMKjnjH`rdYqzCw|}F_<j3;om;xxT{ZG6
z?3FOS%r68cEKZx?7mgQgw^&V;ZMRsR=d~SsI4?=ENxAD14^7IEmZ%nDsb+~-zFWeU
z@0KJMi+q9(zNfEop^qTAL~q4$^Oxw;F@T_F#!}-6v($LPEY)8@s+yXLO{~&Obtv%J
z{=eHKWBwaoKd5D32D41gV3x5@9!bz#f>=iGkv*%bB-IwuAD0_Ta`cz|wM8F}2h04+
zRS!XJx$4OpU^)4ozX6t~*2q$Vfo5I(m&OQg%hhDbZMi-_m*i$N>&2j1FBTt@lBiiS
zrddMe#ncHiG~o)P30Ht7Oga1t)xlqb72=b15_R?OkR)oM54l?!XN4Lm8fS(63X?a^
z3N_u*I4eQptdu^tQad-BrRxLn&1NQ|UYQrV#c~Q!!})HqN`$u{QFC#VRr)*c^i9O9
z{}M5<Tw)F^m!t=l<b5uo4heRmE}_RDU#Lyg;u8Im!W#M#eW;Z;^d<Tzkbm?rR>{}+
zSIO7tkh6)cX5YBIM&%Tp(_;D*pOY0D&yB*M=SE@rx#9ms`<T-=;`{oMMBQcO3u#7?
z9QplsA8zOxo_K*JeQX|4sK&-E@=YlV)wzBemr5F!nluu+F4Y@O^Aa%u{lJv~u1w%c
z-a^4!D9sypECqNg#9MLR{=uQh;8qmGtq5@|lH7_Aw<5@`$lz8Kz^#b5nGKO@+afi~
z-?qiFZHr;s7W1~16S{J9Lf2SM=*r`$ea)ng{>9DD_Y2zySmoaP4Qr=zn#GBkO}U-~
zcu%$wzKLVGD)1K>DJDPV`h+Qe=9a6OiOCOlg$lzJDuP_00!{rYjHzEm@YJuuocdMx
zrhaJ)E4<HXQbh*KcCFAKpC#Hb{kuxv$wm63WvcOf!cMZ8EA<STwPB^6e)2Y~r0FM^
zKvoG~s6xI_1$?0j`9c-)g({yfq`E+rD)5itRcegCN6?>Q22`cSvKdenz3FBZ&h`r?
zlE6O)s-oF6oVix13oK4mZ8%l6->LZIquNicS}crLrx(W4q^ngAe~F&5wX1#a5B}d3
z_=}8`9#X9)S*9a30&@+*TmvxIAj~xga}B~=<JCIFuqMql*}ye4OoC}c4S_SJ4dB7Q
z!T;c=KYV*8X`CC3ok;pC)?VZEf;#F^J9P&(d~eYE0&#Qvt2MQTchm+AIko8NQ=5AF
zq|w&;7d~oJJ16;m;XvRLwaO?`AYGzXkEh}pR_8yIuK%(=!|HTwSMUI<^NuX0u-2&o
z9BZA<cq<-Y`b=sQ-_y(R(x~v#DDu)M@X{#q(kSxMDDu*%>7`NWrBTyMQ_7|q=J27U
z-f))sAZMvZ&QcGYrQYu>^~hQ3p|jL0qX=-8dgv@04QJUH;4B+0&a%;TmW|R`HbQ6F
z$ee{wb@X}FR9(=KhE3u~!zOy+@~ITBPn$*j77~T|baAtP-&oe`3aXc7j6t=$Le%mK
z{oII8E%-*@m2#W(O4Za@Kfcn~7^JIk2mVUcI+i1cKfl@@M)4j&bE7NO0N>XP^ylD|
z0buv^DtT_>D!sd_LnG^08YQwPU1iMF=&xAobPHQX@T=%Kng9R*|No4biCYtA_xBSL
zmPpuTlYoFMBC;76CgO%D%97LyMM0}Egiv7AAP5x^BfFJF!|se)Y7MB^h6HSpssVxu
zO#(Hj87!JqC88p=AilW1Gd%ym@4D`be7=V{nKS1;=iCErC7E9?_aCzm%GYm*U;cI%
zbIA0I;my+-|2TatC3$jh)a?*D940?#-T7~*!>V82Z2JA~(Gc0wjQE?`eML(=AB4_q
zJ|4>QR4oX4cf)P2bkFMO?4p04JGEMUblD3%`1|?MipQ;wA2&R&9#H#bp11F(qt-Lq
z+L+fof4Wz~cX}Fm{lU4@=UVp7`hHOsq%_e#4mQ$<cbk3pe)q(M;gPNULAL_GO|`pU
z?!PTRtN*qC^p{`JH?=cUVeOMQXO@1+*#E1~^^)0)d)*(AoP+SCpI%7LK3aX)ZsYxg
z2a#Sg!380I9esG5VsO#w<Ad}C|A`(4kHD7xx@}+97nGPrTYRwB?fLRkb@!8?X)gxv
zk^Ghdt_YeIJ#8GA{d?a}Yo3=ZWxu--wRrvP*hAXnzWVcHO2^1<xbm;6&p&j=hQtzQ
zX5qJY7c6?Y&nkJ$FRyLKfu=i@&Gt!)>_4XOGfW=4!fETSt33Fdr2Tcm!|l13gYN&e
z+tKVs$k^EMjr-2;ci5q+rvk>@@+ZuXa4kOEJ#)9=HTOn#i!LTNDSv_`X+NH_v@0(4
z>YKG|lneF~mtQrp+u?A+ucF`1>4cw=>3iSjJvTQVeWKeo>i6$l*0zXE)MLA;_PI8D
zwnPID#tNs#R>pgbAFh6S_}5HoB^L2NzbR8ge-Cxgeq!fpKhL~gw|?N$Be(c3k5TP@
z0^c|6!nJ$gg=@BFx87?~_q|!t8#Oplb|>M}T-x(X-&IbXYQJ|=cO&GUqk5>~O1kUp
zv9d)kNRp-!n^mza!4GLp2P%N04zznmxBr~$_Vtc}J5Tl;`Js9EOK#}L%)Y)|{9m%W
z*S@kS|MAztoTJ;li{7w|KUlYY*camE@?FpV0f0RKqzwQPdBb)8=FA-*hfAiWUbjb@
z3W6RgwuH~Tvy3>jmaPCn7A`*cDDqeMy??25H6hI9RL-iOjGu6Sxn6u@lY?+m$2Zbr
zw$;OzTOR+g>EmBjGvBcLm%M*wnE0lAk#4MC%n1{7x;r@Cv%Uc#`O#xJQ~Bjzru^F@
z=>n^V7cb9MYF>Xiy=%8&B=jJv=AVKKQ-jOVU#kC5vg=<F>R+9#e>HqA2%2${6rCv?
zZJt<8Dt-0iz{STWozn%)zuO0L%XTTmX0c)MyXF{)+vXY=Ijw(vKE35jV!caE&c7zP
z>E3~PEx~y$E-rCVi)==7)7d4TZ+7?JY#Yy+;*$DU$!rb9xb#eL;8QuVcWy`}PyM?z
zq}m|ErSAT!==&Y5l_ML|L+_UFxXrR%onCtX{7vJ3-n{<0F17J(>w}pI_$g89a?jXe
zi#{)&DU2BNXAk*jKFw)(y`zNwktFvA*1fu$T3vr}0lVM--eWPRVeJj+jRkF*3v{{$
zInYp*ck66@_s4+k-FM=@ZR*(l`tH=W(r4Yro^@}$VPySv>hg=Ti8sPBUn~#l`f3~W
z+lwe$r@(x{q06ha35TCvnSGuBJm{JI-lAsY`quGRUmsEISY@>D&Gz?pl!Mh1ryf<@
z5105)L}b&(l0R!3-UsAq?=|b6C%^BhHQ{;Dw3$;gUyl-9-T^mik`_PcI$um$^~(VR
zmxt9a-}T5RD{{VHAG`6~X5&wmwh#YYcJ)E4X4m%i>nmUVp`^dN1oYD1<q^->bfTB_
zS27KJ8V`Rn^yTQeKQFgb?ti8i-K?vQ-}k%X!_7TToAkDML}=Q2qH;QY*^38t35OOB
z|9Yij{N6n~{anM!QuX4E+3&8r-1t=3W}L=BfBrfC8))>E<FI>>^y!~TkN)dUrv?Xq
zpPv3)cWj}=Wp=8^{`<rKRvJnFA0^SkJ2$N2PK1YQ*AU0<yQY=i8-4r-?s;c0t*&4H
zVBGV&_}k?fna(u_|I1mV_<Oa->j5EJ)B4r&49b_cgg^FQ3fLFNb6wz9p3;)^6Ti4?
z!Ybe|WQT;A+Vi9yQopfl@_hJRtucniPwE4|-o0l4$opl$FZ0MV$BJ=BK`Hl9W`D<M
z>d)aru0>~wMyrd=@*)?_Py?Sg)rJ$4Qkofs!$=FB6DXy-f@xmqe#}D&xBo~Mt-4%h
zoi-?a|J|&$*9-61LkUL>P0&?k=qh8)Nk#4!hQAebHUc_Jg3k6qXKUuclrz05b$V5D
zO#r$ITh*FX7MfMn^Nhj%6zO6qYJqw082Re*SOEHJ6EsT#J_Ny^gvtUL@2DkALX^Z?
zqID96D@t1jnG*oxK$s*{5@q9pI%T+G+?5@%g1&!Y6d5imSBA^RU3pnsBn%S`jmpU?
zmons<idx7#3MjLLBLqq}#rR2XmWi0bP04bQGN{;%PlPli9NsQrRA^{Mka;pt<_Y%+
zlsZ=+fDZ%&0_Qzodu&<4_5|2IaGo(}gQ}8&+e9bfp%dJ+&fA{wlX7LIY#iie?UXRg
zH8cxOR-u%!N8)JsUP&1kCv&n4#EfGoauQ+@0Pi-4#R0r=@2R(Go!*{sO}R2kHtxa8
z+A3jCGzgV5ZIe13Hy$+UJuvPqANQ7xdn?9q#=sXo7X+WfoPCz$IblzI&I(iWHqUt|
z(jfmpto8zWl7!)jBI_X*5oig7<Ah2d*?4W8GEFfajHPT!b~tG=ZD2f@leI|9s6>%^
zh(!WgiZma4(T}~Fic?Slw!)zTB2>^b&lt2z7)2;Tgf@%*qjsix!1QvZqimeY%ZijR
zNE(E~$*Pw!{?t^|L8@pV)e4phl!=P*Hg1-kn30iev(i}N*3Lekl3u*qFA8+BjsiRu
zLYqr9CmW@1r?8m9;4MpTMVeB9CuFB(z39o!61Qf|EH9NKX2;1+LR7=u10)K}1{AM$
zdRRdcOL)1=%Tzibgd_yG%@uG{d12e#0Ie4?P1-3$z)j)hfff_slXaCvD2VyxKW4~1
z3oDB>pa8cBD@htK9NMY66@pgOzf6nYAkMUMvKMCtIc<|<5}h6ldR3ssSgJ3cDjgMb
zZ6cvw0n<TBi2?S=yl8S!P^ubyLOcC~2~cST-x4sB6{2>o+CiKKrKri$Gy~1a*vb_n
zz$xgoE5IbcUX4tf0TG3*_9$n@sYE_6Ll3O3#GIK{ut>m+Q;05d)eFUG=_zWeG|dR_
zsHJXLN1b*9lmwX9$fOU59NFsS<xC*8=1kXPZVZ58%&w_KaTGAG)-la_H6+aO!+(KS
zfK8HtaOeO5rYXEIBti!YHBS!!T}|lIXrQZ{>Cdh?F^>Y~FLlf;g@}QrI^bDc(%!5A
z5rd<qiPNgk;0EY42~ZYkI<!!dIEeX+=@zRVks(KIAWl1mcASKg2!LN3l*9r2urxKL
zZHsc(bZmf<3;@3%xL(MNk%>|);RJ-~dn@vPzP23o0&!Xi+98CJh`<%hHyOBsr}$0j
z=zSqGLoNzos~1Vr{Ll^~D9N}ztq<+k13kS)u(g6lU4gv>7-(cV4T#Lx>RW>%Kc3o7
z?AEm6uFt6r;<OW*4nt^^1MKyLuL_tCU4cmu&S^RqI_UxDlrzI*B4?hOB}p^ZbVwy>
z)o6z?w0S&CWZz%{Oj^OS0_I_b=sH*JB2HT@7m-rc$KE=L{fEOP69P>(0b0ohoIPN3
z0n^wQu4-g%l9h7Ph0RybbJbSu6DFE$IkYkwa3;c4;n2!V;LM75FiXhvmWyoIYKnBi
z1I;#oRwkm^x1g0Iz#}g5{RW{4aK;K&37Dx0k(8@;6i;9!Wtyt)=h7q3N}Jsanf91w
zs|}?S?r1g<y0#t7?uV`!03OrpH(t1xQwLph2fii3zcezp4TyZ%>X33~s7mCNOuBD)
zEeaU3g!c)Up$ZYqRhx+?cqwXU>4Z5}lFXoyoCfIH5@3u7ziwpa4v50o>eb~;3zf(?
znRKheMaZ;}i;UT7l61liogqMZ+tC?0l!x6oF3zlTwI_VGocWbZ<jqsZNhT<o87fD8
zLOM}5cSs#0nJCfB7(jV@fa@OcE&(&Z7k<>p+>hmI@Qw%5x<?esQ9FqzD$$vGD31hO
zFVf8Dp!ebeEadl_fg_gi8Ub^$LR8IF8;d8BQ`Gj-2~#}e(2?0X=)F5|gb3egWbPgi
z1+dkj<;=Az(PI2@-$wzTEa3tHbFD&jj;pp1Po$>M9i)!)^F6FFA#A(Eu|h*Nf{c=Z
zB2TzSpwzko5g_bVVfOt^M|YGO4wVvsh(Op)sI-*v%IlO%6}*L5KODT#oKwrCFKBl(
z)Kv6Bkx{^T0{nG26qyB_r?1@~83UZRg8vdIzf<r!xb#J0$Gs_ZBdH_SgR$STTb-An
z72(h=0+1XC2MLu9GG44D+>R)>*C@CD`-h`1TCowjWdI}x!R<ojb{Vg&P6;Y_H0-`1
zLtDaF62~%41qr&f2YBKEX9|?Ry8=%b@Ea`VN7#_NwFG!Vgx@qOzaQYOV$&ZD@(g%%
zBGwG2_qU#LMPt`NUIf4<5T*!~WEpS0C43xFZn$OC7V%Xr<mC?75aHvE$_)cNcQ*a6
zL7p{_PQiSW*sW(g(Af2m7ZIolgrkH?4;gQ(B|LyApDKpn0ilvB=dEDV9i>gn(O4tM
zYX^#)KoNY8{DMc$`eI6hDct6Zn-M2DZ$T=(<gHWSSFk%88xDyGKwKc~BUCPw@qVaN
z#w&Qs@H{s+=Un2_ZQGj`Xkz;zQ8W-ogfC)OX9DV2;E8OmBTc9bmh%>|>1NU<FEo|}
zi4xJ++mHxvCVR*9mKZ>71y2Z+*$Un@F5Ow&<Ra%8rP7Pqi7$ug9<XD%k}BgF@#qnf
zCZa|mmNXql6=dunvvW*OjRxpeaFak8tKf;abQ^J#qnu}#N<V@7N<HAja^-Rv&yGir
zku(`<6cR~OC8{vOd=;ZZ^$>3fASJ?RqY@h60c?6$xss;hnJ1IR4YE972Bu^@a~^$@
zq=}?aVCScWlwpBSto;Yia<g1GSuX4>7hV?5?5tgua2KNdTQS|yB~<Q|^ZeO#dufv|
zsxXAclTf4@MJ(_{hm4#Jz?244xGexTBa7wZ2C8v``}<|rWQIbeVY$*!pfqe$;*3E8
zFdYaV!j8a^6%muG26!$Ux`nu@3{})X<3wP(P@~X8<EgJhr#<1ha%H}Zw}waGEorjQ
zD1MV93ee>Q>~ZUz((N|`rj{`Fg$4@VF|L##PPCNs+)||{@lh$>B1tUQEGI*D9Kh5Q
zE)gi#`@*I{uqi&?PndPuM+5fmfV}}=&jE18z^J{eT-sIMPJDdjTMu++v1TV(v$Gi8
zi7^J;6sd_ck&Hd_mB0~yA!O$UoFKp(8<p+@JS(<zX}OZ4;sxOYz%B+jVFmXKlpF=G
zohx+^CqgMwvNRDtg0BRR_@9F6U4a+^?AfTa9^g^fQjc=wRu%6e);inmw=YANZ-nX%
zfS4fof>60t#=BUjT%q7OVujf`xTQN*l31!)PJ-(90DpSGDFUU$75I|@KWow({OJil
zD_0(n@fbYmPD!G<X8CWDE(d9s1Kvw}Td!}&R6C|{8_wb`uw1!7#WQ>v%KnyJ!j&4d
zClWPnGALm);7fpQ69C^JxDMYY&(hI4p)y*|^JGh{rHMXh8yQM4YESG(+c?m=n~9!i
z+j=O02wV<?zY!{z$#`{j%5()U1dsXFmhL1;Vx^|d2uer>E_=fF1j-k#Km#9W;JT=>
zWcY_e{zS;X2f`VHc1dCp+J?W^EimiM@PI?gm5XFNGoCb3l1S3DQ8;mT(1j9wN-yw)
z*ULqgVjnq#qf9hBIKEXez7?DBFSbTZV(Gh3uDl>nUT9R}j6pcGF!lV3cTS$@Qh6j1
zSRnmcSZM&&)-kPkaroByMC?7qjVsnHBmx^7nHZ8a3k}<S#-Se)ZxUY`^b46moH(jx
zVKRUtI}S>TD@1DvSle$b9km`1k=uQUP;?-Squ7VSvC%>96=vJ*%Qpj7axVkThCsNS
zYeR(G6M&2$xD(55e0y`w6|U5-J<(Lt)(_o}1~Q0nXE<~}6L{%>*D*_ySf*(sLHG9n
zFFoLc0_93y_-&&y4|~W<@-5xF7InBdcDOinxHxs-?9j0$#gZL2h@Nz<e_3r|W@i-r
zP0YTSi>gA!UY~EAOZ+Ze@|9eOf2+G%d+Bp;{nikTK?}9dhs573axWcSL204(U}7*3
z!BOU8S{SF&)n<WO`MR#+xGHTe34G?j!q8k>yF(Yx25kxE10zWhdrOMrj%niwpsfQ7
zL!vgG+;j0Me;I=&4&LIUi+2a>2rSRiI1CNIx&-hW2bQe>s}9wc9iF;)H}D$*%eFKQ
zLn8Q1IR6p@NjEoEoWJaeq?20~$u8dFU&4^kGP<C}sP7^X3--QKdWHwGh}>c%yV%1|
z$B@wCWuh`NPmLJQMa=Hjn%${2lhvAOYH`Nk{@gl0UL1Zn)GbQSxDeiX=f@=W7C)dh
zVNtv(^^zGU?lwB|rix@|{DOP?VuW*xc{Z~0?@U~foLf|*nLjzO7Rub3meEHdJ&~n_
zHimr665o5=0Q}1pd`n}kE+gIWYHi@ZutM?(EiQc*F(e{+zQ|(^c+(II8E{HJ>Z|)`
z*E8oQnBGCv|7NY)PedLY^~^b!O@|q^5ERA*-nx(Gm=;WjQT4gjswo2UI8pa^iSBPh
zEq03UYrP)R+hy9*Wh(13?d!r>*5zxW8l$PknyM`y`7yhknht~pKHCQkj@_;8KIW6V
zV=?0$8+eD8=r)J+sZ&N{MbvA?4%rsKbC<N?)v_NC7i#|g6aD+ouquUPc*=&`UG@i&
z!{OLRE^;^p`^ZKPUvbv2q3YKV%D6A0BPNentB#ncju2Ew98@@C5YB(C$CoT$TR_nl
zko5%weF0UEGX}oM6$e!U?!7ExGJ%rnTPU@ap+D%LI{sAya7U4Ll}v{%!JLd_ts<GI
zNCXwhL4`9037`cBv@ig%@SV~Z*YaI9@LkA!7dhXhb{?pO)0Sn}B3(6g5%OKu^IZ)1
zF1>u5F_853IGRSdCO6k#%%FB!#DEq{KnoIRkqqLDfpL${(X>-mOqw;l8U;SIMD`L?
z05ugZmYT^>Udgmc>9h$}rw6Yz&stIRR%E>uL2pIX<4n+>as?kUkV%@kCQ#$AgEsN6
zlE8;S$fUI@hmhKBt1_pi8spAqnsdsErKBE|sC^~l=WGVU2#9kyKj#1#=7^kP_pw`w
zr8Ye%Mf*z5&xr=Zh{%})u$lu_<B$CSd+a*C%SOJ7A>XB+?@~7pW`)udeQ3W<U{>_4
zwaTBIYA=wQ_Mx7-R|fo?MBS@f{2UVI9O{ss8v}M*A!7v9K5FW3#Zo63>P$|xD3g};
z5lzX5J&@HVDi=bkMX7XCFG|wBYVSQ{-FL_uEA;oB&9hMyeH2+AMbJl4^*9ss1Fql)
z5II6K|9%Md*1d}0&l158fe2OzYY3_5Y|U95nn6@WXY8jF&9jaay(3xgNYFb{^*9ss
zO|Iao<C)J<#pTcy$1_blgUpY4+;T(Ypht~E**fbdCqpo+_q;Vpv~R`88gH{abH^E4
z;By8voOSm{y&!zZuw55b5iyj?TY~v)v3_E?nM3QvEch3C1eqsdR{p%TE#(C-VzMA@
zxPUucz#cAuhH+*Oe|81%AlC7K|3eHxBQCW@&Kr!J$wtm{Bj?(ApmO@KYt2*sFCipE
zOzue=-oqW<!yeuP4dcun*8MMp5(UJ?u8W?}Sp;}IbF<g~qRFs+GJK*@c>+It_m+;@
zUkDFyFWN;mx?XOU_w}L~_rT}<u0TL05Rk%~76w1_<POHjY8%8p0a0<g3`Bo$Q>Fpl
zG=RU$RyWV?O&flA=f~fUh3`);dQ@+8-He)ty%>fe$}q^fQj&jtiT7VqKSs@jv8_Lu
zpWSd1mjX=QkDBRrP<7+;{d(zWt|yXfh2#>E+#m#J42rZLkM+%w%1C*t#U997SMVr-
z|5>2>7~VTa5=<NWBJYBbcSM@-;s>+NsTgo-2{=Upr;<UOF);3#6ZBz=`0KgFo597d
z;9>%}m<{5L!FFAKxh~%Xn|gagMhcc<N{cDnwiGw#JCOBD%&}z*NsoBw@{6_kWNm)2
zE+1nIxFyq+(rF6Td~bhjp0%OqZOD2Xg5HLz$C;q7!Gay<e^%%OXOOiq;L%9_XR7w2
zW8a*#csiA!A4&kvalmtU`&l@qudU;+*~njG$Y0aXUsE>^W`$YBeT-h*eTlUS8w)0a
zEOH;iT}LDGtG4St8urbZ;x`vJ&jwhlc3UDh3E<Hl{%3dWSF*VnOJoQ{h8&O}wzr;6
z(bLI#IzdmT&NBwS$WRb6gl7)h`yo$c$O=>QHqUt|(&qQ*@=wi$=uOiG?eEkE2z++4
z<8GW3<r8D)df%U(4pofr$4e(CV)F6N;YTBkKAAbpghIo(AQ^q~D_1rk%7#Cl5WwAo
zRnwj?z}<z|$Ls&8=iu(7Fx55()i!+V%_AnaS*y00U~1lGJrCjhssrFA291CE-`3)+
zg*}V~T3SE9DjM8GM9wFGM{n~#n`2uy89eg&+upgb!s%Rse#$}h*b}))0*_i0PKT6D
z9~}RBG9zv9!JXP)kNNCQj=NDW$~TLh8(n$nND-Qk|J6FVVx(Y+*?S|$8MDCWPS9}Z
z-5>W0!XJ~{=e$#=zj~A@JJfj;i}<UN%+HjSs<oN7=UQHYU&zk-bN8#JSC>w&#@{e*
zZ~1V&czSgqrf?h1g6SicNHR?oWNsY$b9EGW8&d>T5LMq;oJEx}u(3}nohIS?*VsI3
zOwk*Y^~MCfF;$N<L0{$yt~~&*T>&QdY<RzkqTfW;ZzAY7QS~@u;EOzQP-WuhU1r2&
zCPfbxX3=DfDjltXUqu3M7ikeKpT!5Yn@1=VJ-IN;K*l(xLr(Hp1kk&U&*FgI_||(<
zJH0)T8WR;ZbUjM5w)Qe8S_C`oY|5}j0;mN-e!+TvfdRjumya_BlHNJ2gdMTjJ(|(_
zDG^gWn8Iy1%jOs+Dj#$G!ZH#sqs0S>!xTZkurw>Wmtm+yB)yCx9fH4F%{rzJZ3a^<
z5jsJIP40@~EF&2MYoO(2S@nHHC!<tPL~5c+B<PoyW+n78Otna7Po~6`W^D>4i3+B+
z#aNq{ZLl_{7}A7ppvO3WvxoMi!u&QR2ux!4o{CFb)~7qUx!0{3OE9@iPBTAFrU_9k
z=ukz%N@jIR>p>5iaZe_JX55#Fku0-N`#Y`bPu(3e(y}Gm-%YAawZA)5`RaZrRArQ?
z$$e=CxLb1TUUyw^IR7*OWCkK$)+`%BOOz!dqOszPjGqSlw8DTDM{e;Es2BF7Ez<=X
z@=qt}g8TTViCB*hElP)@K&2(ZBe3YymZoAgRhDK)_J;cg#`#a<PY;@as0j-Y)Ku!Y
zF(67{UA1MIm)6XOo7$>8#Xn$)&<NhfeFGR05X2SiqOttTmbBcBkCY8;<R2g+JE`8=
zdIt>o2d?mwIG`WC!JkS;>#bQa<Q7kX+PW{zN7q5-CmHpm_3JwR;XnN;xXy~7<OW_L
zAPEjEUrLLuKs~siC8Sin2;1M4?AE=0x{gSG5(&H#gxt4gWe{2pS|R|A1y`K78^59P
zu2IunBkU)9H}W(Nx2`Uo?6?h$;{T#3qjpYS2%kI^K6xyBvOOGU42m?_T4?3JRV3bB
zXYTC@!Ah3#aOO&Fl{!2JG5_&Nwm1i=a$s%3>ss7=^?b3~s%OGPn=R+Bj0T;FNL4t0
zWhQtAqy^Tz_RwXo=dUD!X95wHHOrgOQe(^7Ms4xMTk5CgtCx$_wmlOIwAuaqYti7h
zMC6xn{<TbS%z<|DO%aytF-v40ffY(^fs55<vI$;^+NN)Uf@S;D<>sp`#cG=#OwGvo
zdC}l%B62pI|Nj910RR7lmwh~w`yc-|GnBarxgAzWC<l`>j;<_34kpu$qNAb_X-u6Q
zms)5jAx%w<i`15mI+fJXw>o2PqP0snN~g5BTe=ZOnQqSSv-<D%IKRj5@%Zq1KHt~p
z^SM6P_PMrezok*`QHXBQZye+^Yni`cDfis?+l|71zzEMQmc|hnZft*#+4r1h%|_BV
zO<-hmvBe5GL5r!S-E7e!Cv+00IbAvwe?$HfjMR|8D99sgiY#^>C7XyX7RpLP@9nu{
z?JOq*GC3L)e|LV3ku(CsNHpZ{AWGc^St2rnmq#WvTWHA$VkT!jMU3I^*hH~&<1fPK
zclN#EJX>TW)zM^VvdJ1^izV_R40D}kbEkqi9Y(>Ec%J2pnA3~+FvihV+<AsMjpf5G
zd<}vSBU)1Nn>b<{Np3=-;4$G?4jmwdf~PXqrBm#@iPwH3N48iL%8E3Z>vmG?9QY?O
z(qI?9ySdaHlOO+jjb7s}d%n94Fb07`Ue{uQlNBw<A)gjoJe0G~bYC};Zqa0{V3SS7
z7B2E4JhOePJXFM7hN0Ng|4q15Ns@>9sm<7pzraYUiD9fY<QEd90s7jZI?F;R#*6rc
z7-;~3aXyc{NK}z{l)OM(p{ahck}g%+%R|>PmtiTV-1zH_r1ls_q#?hPD2>+-I>h%+
z(ByaONaHaK4-PrHrGg*}z1322Odg771`7tg`ohbZf~6EXmS1NsjatBPW|LRxNImr#
zmif5d$-VacBw!eZC5If=QlTXaZD^?|mWOJq$GZ20pJ58@D7{$zxVbcA0mFw)Uacb~
z=rgqP?NF0Q3oJt`hl~?d9Fa>(nY%F*ay?TjW=e7D!Q{RwM>#)V#@Ckd^W}WN0L(NQ
zuKDCM&7ImVnk)x?la4e7!*J!0H@8&i$|Q{~&7J>Pm)?zi*!PL^EYnEptI4oolMTcb
zj&cc(IfieRcmC5T%ER4ajr~kfF5;^&QkcNFpGUS8RqQ*O+i?3QQr7=Y*BKBRb?y0h
z9jOL}f#o##wM1iND|B+i4Y!kzEYOzpn}$$y7x9l`q-zO`n!E->QFP+bTsqB%G<)H6
zogL@dDkG_-CPR<ipe2sBlh<RJ{hH14I>$y4n~oV|Ep*_o)f5_voLZS`#0a|=YAZBY
zey(mS>HqG%RNf>aa&;wG5PV(9Nf4#Fk_BD(vB{XYt#Km>SY6GFJ>1Cn5GS{bCg&oZ
z!<_H}?$#gIra8N5U(o3FnBDAuB@{na9Tle^j31Ll#T5f%N5zFlIJ*h?4NeMc?a=;s
z(D@=bCkUYiEB@P1R(%~f<w6OzPINQ$%cBSv`VsHti+Q-nBi@w7JUd{d#XMu~LWvyo
zJH4<T)7rZK|2t21(xq~s+;6I`o&-_4P_iHdTo70y4bQp7`hU&Bf9S@4h#{8M9X8+d
z!zre#KhqV*bQLpQPkjU3oQ6X2Kx>x%mU{#C@|3kqFD&Jp8$ZlQx(vfOwOG2Fz#ywX
zXb$T&o^#+o(vj}QFvy&S=#~M3EJZ(u<(&^2PXA?$t30My7NakVDVD1lK<ZJJ9*3o;
z9(|?egXIE+rKZ9Xqp&0>)QnM_B~hNFQ=WLm&5mtdpxCOZ*oskXB`DMkz=i+DjsHfy
z@b`qqC+jIsmQbExDNlA#)C>UM+*BoQs%o~t3woaXOnG8Qd4i)n*+o$^fNk>UMe^qa
zaO+zC*f+QWm<*V@wnANgPSjMG>Vu~3%St`TOr<hYvCPzFrkVj<Z)sXAZdwdJtbBG{
zy0;NnGca{c&7vl7^X?@|_v)GVr=DV_`ZH5;%v3Q`%>Wu&nvBIw#$fP#XGE4TkL8%d
za%8g{IV?4^Sqww|N}}|1QQ@|_0=EQRj|5%t-z(v`ry7p$KZ0RUGW<CHE9pW)qldUA
z*MsOo0zoGF0K);JTIgF>$s=@&ipiF~=@X}|6{&q`6Ivjir+u^Tw24~>)H@&C05?M`
zSM_zp#OZ_G&jumIk39hK06(TVs=+!4ZkPvsX*Oj7-@MRF9p1E|*XWX@E`Jd>zusEC
zk-&ahS^KZ2Pe=EP2C$W_c(@y2D_imGfRU`gR@Rfq2Soh6ci*!uj!3k|s#Cz+T4S=5
zxME;z5UZ?sx!*gVPJ&Jl9(gR`<r?L9lRy~fcmu-$qb_JBRvCusdhAEu^>E)k;Jy=a
z-#z8389@JpQnOvDDN+UyX-~U9=iMA%5Z`Mo5;$H9qXnO<!g#G-l*jm?qv1z#)x93>
zy$9TTBJRDXTr~sO<V)FKjEhtxR<!p@z-1^X%d?7cHxv{~R<Rv0QdY4scXfw+fW>E!
zhffZ$h`_KQ_^UhAR=T?5`ffCh>4npdCwF_C5FV|GUgpV+Sc}uP_hd5H;(~zrt;IPm
zuQ?(%wxs-!&~66;7|zI&La8~THd4)zU15o`yG2uX36pn;9lc%MpKsh8Pl)e*C=#5x
z9`?h}=eBEk-6Q5H78fhZB?q^k6x_`T&BXJj7kZ5@PU><IaW~f=+}?3;yY|8DCBsR{
ziHBmJ&G_6H-yhfe=BePx#jrnc=e8TPD78A2>vsF@3#JeH3GQM;GjZppIi90>aa~s6
zbvS<kw=`r=MLSv4y&^ZnXZfWIxSS9l%B2f-z(|)a7@I`($f*w2rcpQIe4oOn0D=k@
z1Tm`TBnZQ(p6goW8TZ@Z`*`^N38h71;@3^nD$^;I>7>e3sZ#T#%BukVm5=^fWN^%K
zs&YhWJ*2djDXqtpYL+Q0%MJAB$Jy1$R)LD(;rZ}SME}^QaW;tJPvZ|j6nq-jZ2OXN
z@HuVeq`|&gk!pNb4|mrC?k*8`*Hf;V0rboD^1o#GJ*BPeJ*Z`MHerOO9r!iF4@A({
zjCc?MUo&!+9`^B_7MjNUxX;#ljt0edm58{u*PYgc&<|+}J}0*2;tu<eCWWVyeEq@3
z{2<KT2^_?(!#==pz^K>PSlfJ}>lO{-J{W}u)5A&ha11>>j;>|^Tc%{)h`!F3x&%u!
z!oQ*D>v;7ma0Oq-Wv`H8VC+{&c*G1XKj`0#Ei>rJSF8;dUwWyJ*H{~V>1_r93=1N8
z2CVzv48Iw0IWWiKYyu`i8;{xV2SOXOKOTf8W`B+b+s7AkiFHhg6`vzuURPtP^>r|>
zWti$>U~CYpFqg9QNBnm-2R-ye79DzIKLQ8at4bp#mskw>@08{T<QR0mg`cl0Dlz53
zBMhA=j&jM#5&yN#`SAq?h2FMC3n2T3sb+V-SVLSCm;&~1AmCn~cdK^Q!Mz@GtG)^>
z$E`Xw!aU+kKKAb%!h1nf0MBTxAdl^|Bqb#HtdWKwFQvrREC{=wY7zn7nuXwXHN13O
z<H#Kn2;7l7z;uC8kNCyf=tSvy$kQ%5xq7tW1%Ey@*?e|LgC65zL)_DYuUXa@I&85w
z@$}<mu_k+a@F0kLd&)r=?(NY#<~6>X<vRdpoND-S^SW~x8*Z*Q3pkgNc5}Vjs5jR?
zvE19!hSiHT?2Z7}k;d6=(c2y94!pO!4FoW}yWWdx9>=vL>D3J$$FAAz*wvz>SLZ>c
zAnDZ*kE6C65UT_=$9GxYAqi^0=hv{_Baix;<1N5Jh%N5`(*;J|p%-h@AE6rx#lgvT
zs+&~!83x+xhIp0HtVF^S<+N=Q;YwMrmz0rH({yE|*K{gLckX5z{4508i$!jM?rG3F
zimh8#vZLyzKl}^}y>mkjl+k_?2`kHK42h5|>-Cm0Zqzh2jPzPejT7cF+F_rcp-L<w
zrNVcZP%OnZbH1`m2Z}XBT-h`;iSYPHFMe`-=V)%N)g96u_2LzlXA{`|W_U^l6@)e=
zLv5Orj9d-k9bZw+KPQwYlWVUMn6J)b@?CY9uZA%BYRdt!3LLgojvLI)lqf59Bu@OG
znhApEanKic<ZBu2ut<2=5W(_Mwq%=b)VfIv_8b8NYsEo0dj!iyF)qjv9_lAz#PQKk
zf2Ch1gET}ooU|xV5xB6H287F<BMiY>tJo;1lVLbS)|s@(QxVEwEi9B<4>Nt;%vy21
z9*-0nU^gxpJ6{^-s<U8hs5I^>u$<Dk)QDiWGx?gV=-_K7?M7dpbMen<T5iwNU7OQH
zvFE9cWY0_114EvAyB1W|CY(hB!G3@`0_Ch2L#U$-1Tegu^}Kr0+tmOWmdaq!XFm>_
zwqcHFmWQUL%@H>Pqs|eZSVA3@g(`_Ayt`es!ow5g!n>D3WGqs_Lqj_m%VcD70lGrU
zFje5jv>WV^Xka3S=@|Lv=?eUu<i>Qx36(?(-rb?%X-Q7QyX~L`EHc1DQ#u)5GV)Ia
zC{fDLSK#`89Seq7hKM&CB}y2@BV_H#ie00*Vp<dFGZ(y*V=v-0oy`KP)2SeWs?!rd
z1XQQzE{$mN)hIWO-)d9o5>|0Mv_dzu;&@mEU;xRnHf`8TF^24rhn`gl;1$U23Umja
z+tmgF7~cKT^J?=b*AnVQe8r^Xj6f13kZ21e9Rf82xIGljnOcE6c)D$>-ox{UQ(i0m
zy;kD9R*Jn=p85v5Ee-tP=qd{|J*g`_zAHVhD?O!4%>Z1g%FWRbHY0(EI&j9ydj#bV
z1mz+@`BQ<K0Z<QaO7s2QV>sF&Ec$3@G(I%?XqcJ-B(&x3%4;I61CJ2CN5RUMNdkAY
z#27A<w1EJI-_i2C+HHrcfw2Ir+$4m)@TAjG5qE7$NR8)3LtbQJ8$EBz1nV1^=G)aB
zW53sVt=D4gxntMD0(%5Y<LDa<t9BL(d0{Ws;h?tk*PDt2scmr}gsEyH0PC;YwqT5|
zF~@CHnOL0t*&Z=!6>3g8HNznQMMC=mTAs4-8f%~Ik>}E|LK1zch^yn}01!i8+CPz-
z`?iVnpb9MB0W6+@2Bv+8F=U`^Ab{c1K0L3cWVx0!2=Ti=o<z<?T0G7U+3?W`|3YZ;
zD-t=79YX!+)Of&_n26$!e7G5^EHpoxP`}!&?HP*-qT?A$ZLQB(xjWxAjq+*U3fz22
zQKRDgmMqtTM#a#UtgFCsK&<MoI=<^&6R97p1xf~=WzVaQw*Utre%Ay{7Z_FkA;u<^
zrt6`%ue^sF5+CB=cG2iuq*GX(rXXr-{%y-5p_Z(!a5#Ej;?<L0f0NGbVTY}HDzHqV
z>s_l`rh{q~GyHe^T3v9mDs{4AJ6T<GQZs=1gXhg@CbGizDXzuY+8)938%_&Tj_o{m
z9^f@6%RFJ#a2=!eAM<PP=|2SB{>}5w-?@*k*p#Hsrf2-FUAyhx{)~SLR4JOUSG$V0
z_~~+0N&xJo0a>{tC(6)uBE~L5#9U!K42wp5mZ@5S$c)AC&N3QdvM^dDD=l!<DZG?$
zmUgiwdR<_~hNu9ufWVBjsDRDDs8InwE_Xivuy*O4Gc0KO)Vj_8)#Zuh;>Y(ilua6w
zO-rT1u5S3~2n#>N!pm6rF_xNTtUyD=#TztRxBuOboNh9jYBHK^GEz3Fd9taeOW`b0
zIExgQDaamw<;F5}V*$F6jc(+jY6d`sua1HC36iN;jU%j8L#$OY)~c~@EMqm6qk244
zkB#c3L5-X-D|^Js5V67_R&I!z0p!d*f1rB)l>L=eJHoOXV%f=9c4OaI#;PqhD2^S^
zd0GyhyHY$oA5NCLF8pOY2Za7F<6R(hei_#~`bS3QT*#TDe-OP*`Bvp}mspegJ$Mkr
z`#owiyx-Hv`6DB3F2pSFk3Nq_j=K|2FIo|6(%gdwL2T|R2VvL@zM<pBr*%$G?ByHq
zY#->Hb_JdTqBw563q(QO_*T0ucW&>3ZsVZa9jch!iT7ito2;jrtS6hSl}&1%Y+7A_
zTJu3OFn>8w3QzdK6Bu|x1gjaqwdv+X>tYRes2^0qz<m|p7f1yj-`55L7@oTBMK!6`
z)xhI2-U3;(%^q1<fSQUJx?>H2(*qiFDc7e5j;T`c@U3=LOhV$IvnnMJzNG<eb4RX}
zp_@dEWJ5%of@quDW~9zwI~CYg1y-cMN)&1a;9^T$@fhE1^djI|tNLEra{hRZ!yOWc
zT!%Zrbb(Qujbd$9Yyi&%GF3zD^g!`kiZ*;}7xa$<@{Wxja6znjsJ@61#7FmY#;nUw
z{Z@vytO2JSSfYB1fe&a-4RosBj=-Y1TlDFH!nwDa@PVDsPYy^W8x40sUhvRV5d%DG
z>v6_jl%c7uj2~qUR?2~us<&G30qv;)vFfcH7BxLyU547UG7Mx5+R6bt)mtq5VT;O_
zqw>|7^EFklYHL*PoeK9>g}X@ME>Wmiq_|FkN?7V9d;V&;3>_{2VnCh0K!@4rFb`ET
zfK3o>Cq&bLXzi-c&$>Tf7*W~}DeYxS`!S`OWy*L%B%6=kmn`~RS0rmNm>STYdn<-N
ztcN~fkZdq|2Smd{v^Le}_U_Nz5v9qH(nO{-8B?lRri?N~gx-kIYVrlzTZZ-)puKFg
zm-meUY=S<yBVX9)R|;}Y@6jg*<Vyj1NW@q(*6_>pfWh2bgCQ1M=`Cu%Jr#F|={N1o
zo+Dyl{WwV59>K9utP7IML#ZMKcpO>D8Otq0sjUi<jAf|wUalf)!uncM-mNO)5G?xo
zVM(XLaEPTd>7Az{mcja1D8C-w-Ue^S!`n|N2X-bN+BluLcq()8WaeUJrkW=+R~4Yi
zd^C9(vcXRDbv(HYO$G%vn#@Dh3}6$qZzr@*1KQWFdcHUD5Pdq+cq-F)GSgU@spiQ{
z@CdPuk8abGDNm0mO^1}GGNtL*HwKk*G>eC3vC*tF=%dBim#5%Ce|QiF4~pTzQ{O;$
zNEswmlvJGB5n<7+C@DZ~vB;X8&|xn8RcG$=<1U52MBy(|h$+Yw&X|D%Vz3A?z#<0j
zh?)W9&cUrJn5#<p9Mr=tDRr{N(xDasY#*l5;Z2{MJ@|KrIog3iJJNg&%+Ibl?Uh}W
zGH?EL#{Jg#uB6@$k)R}Z@^j&^%Gheq5LweXp>*ua{;GKgMVKE|r`|$`HC`xa;P<@K
zn9@n6OyZ;doH3dMLR*B;un5f^Q8R$tIiegcW<qh9GX*0o%_(n<Ibt(h91I0v5W7tf
zvI|0R5YnMaA$uNnRl&t`u>KretbzdpuxVB3N<q^O{o}7v_`V-}9|PYP!S_qQ!L@1C
zLZxcqq{>;!$gfekbShk06)qx$i$tMjk>Ym}6y%N6R@klyy66;i(kbYOQ_yuMH3PU(
zV#{YX;}@7c4`?|W%h_GQYz|yt7E{V>ZUa&A{ZMtDt}E?N*^NBi+JzX~|LPKx+=4fA
zjA2q+@IRhp?zmkOy)1^g0o3ecm}xEe&C9+YS}xCdXzZFu6-+2AJx70v@A_55eSgjA
z<$C&koB(FLgD5X^bf;JTSqST9fnQoLbB+Tcfl#je)8qRgs>(E`Y9CcsGJ)Hz-4XxM
zn{x+s@6IlkPq0D{AiJtR5gWjxg~uR%$?%JS2Xl^Kn)tiN*S7zU1j4`lf53EsQI`zI
z+IS3pDO6(5vHr71f9cdjl0@MtWBEuG>;08UoeIw(mgS`P2^Ie|9FBv8xpSXeRG-T-
z4}J<fJFV+6Y8Kb^!&B}r7o7gW&<|bL-^XyPB4f}BN>w&zjNBt2KM;^b0`gOVngLJ`
zO4EHA(I2VqZPKm@mg#<^q52cQ?S-QLEySRH^iF;Q?I5~Cgr)8I#*2mzzkfnJy=Yjx
zd?#!kP-HM%Ftx+t`@vlBm)Ux7rJL%(SN{Zxt<ieO-UJTj%$4%M&taLrhZRDUIBHLJ
z7AiBP-F!RM2nq6L)AYwq0mMMwR5;xmd0r&8TD(XwvXq{F#Hr~iHzp~>)y?6F*WIIO
z!P9O!>utjG>|gFnJiVk-yxcz1JkQ=>xO8NPMVT*QZCQRU_{#*{bk{?BxS`99|GU=}
zP^DZ*H_waGcU<fIR~(qET)g~yVYswwhef0}VXZTm%o$8J$~2P(Nw11M!11F|`nljZ
zG17a5zjHn{c=XyTP|g2Vl?Mcmnt^Yt|LVq!2p)Aas3T6as~%iIt`X{p>%bXF-^V@#
zT@53>Q}pVH?cb}EMUkq-;5XTSbt9TYdP~5p(ZQn|YDZ^Qf;0Skn1AnAzG-0p{lE0P
zSK~so9GnV{jqtg16PNQGt_0xowaq=qZaDpdVEqZB17;hJYy?kUI}ZQiE<Rr!P+nwY
zuOKX48hz+*-&gZ|*2Y=M-GA@e9zQ!M{NvMA`romCD-Loa2XeVxHo~Y686gP<k<MBD
z-;H$f#;-0Hr;qVm-hjfzZ-ox0^3|2!`d7JJyx~Z9&Puol%_o)%0sYrJ+r9gR#8-6J
z%V-zR<xKB9*Dky32sF9{N#Ba3SJS-DK%*Dc?b;!iKW3e1^IYxht_End5gMf;)0?uL
zuR)9bkcAtvH?_qy<@5_R#_8CZI?;So_k0v4+xgF#y5+NV=7%!+W;V=6*=IZFK#QZ1
zV_T79)wIChp^aM*=W1H{B`A64)tJCH^rJI%8uL**vM(oQUuHuaW9FmE=c68p=ISob
z)`iSR;j=H_fHpQl8>z_UP1%%$yV_2}_qI6=|5ey@Bi!QshOUDKk?mQ0kHKE2;nl$w
z@0);mB;4J+?KN&VNLci7`L_|PLDzBal+A^rkM&@@Pd&}LTNoaNG`erTT02|kKi`MV
zetiwve-qm8hxoW=zYfWMy)b)Evob063N5xr==zF&X14D4**e|%zQ)(|lG!@#`M%??
z8=$eS*_+U8F!Eb9ZFRq}s$XdHijH2SW!HgbQ2+9Ea`x*}&@2_1ucu{Sp=Eaq?{7rb
z)zj>{g&U%f6YiT+FU%$d%zJ8NTV97w+=Nc}A?sYTEq~4q_5bbazvH;aSJLcn-#yiS
z5}psY3|jd6Pf0|lkY9T!ks*WYhaY6W21T2jm&AB?-{l4J7tRIOoyNNEkT^l#3u#mW
z&8&5@n#55!7sxwv%m-~pUmdyq)BoMWE$p|MExJ1o^4$k>i>3yz6isd0b+w+{p2huE
zuwfK^%xFJo;L#3#drehI%-<jVUMT^UQuo1OP?Va#r?wwN&$<sLKbpR&mAN%&bijr+
z+CN{lwRd$RCu`56k9}KT(v$xb_Pb_23(kC2Ag5a`L%e>QyICXe)#A{sY@od}lSw$S
z@WlSPn+e&^a-hAn^RO*z^ww77)&<(OZsE!|y_??jn$9G>=@C};ffl5A;hxQf-UTBE
zs%by<3oHAD)~|Y{muW%$Lc3SJ?w8T4JeObl<}>WGeR3e{Xry>6Qd~_7Is;W+fGS(W
z+Z?l9Dqn5#X}*#%v~B#tzKh1sLmZP2zL894Xl43<D==n_O6RM5dROn~WWAPr?2CR$
zXZ$IYx@O)9&b;$LUQ3(cL3`#hz!l&*G&370c4l&1Lo7VLe=Z{-`%VrNTRZ>ucvJf3
zE40l$LYG&)<+J0LXU7-LXY3z0J~<!Il1~eG8IqUkpmEzszOC@pwnEXBfO>I0eLkzS
z=jH#(d;ay4l<yBYToU=MFwFg06+Zr+8gdvd?|FI3=}Rt$C&&G=_Z(P*{o~2?Ir3Aj
zV#oCch`l+qzF#i({<8YP`1==K<A;}zb@>SY3i@713qMR#%zPvX|59{~zwhLK-EIrE
zs(wcJ;gWQ4p5B+k{I69~aGvnP=vlQ**^Cr@OdTy+W5i0RBoEepFHjhFg)H#?lLuL&
zMIYm(bJa^W**<+{Q$1_pH&4K1Yh8nIHzAxKg58uI`F{Wa0RR7dcX>EeZ}`5llqf~A
zg-VDKSxYgJ>@-=kMUf^{vL(wQ6otq#5i<5^WbCqJUq2=pW;BvCb~8pynz0<>cjWqg
z|N36v>w0F+d*Ao-JnwVf_nqgQu}51E$f_3;ey77Qo`9wC4n(nxzk&skaI7LgEP#7V
z*e97u79vDxDO_Md1>C~{tu`S0rI>J?j66eCRVyZ7(_wsHL0)MfIufpDkIr>K=jITu
zr@=c4;2kRE>gUbqs_{$_E|Av^i1q-YBj6n+;3KjZU!`+MZKX5%WqoCT@Gpy9B8&B%
zWM8KJU+}Mb2&vEm1`dA=70dN@=NQB9uR|RPg-J1S@lPE^Zr^P7A$sv8LphS2(XZ+&
zuR%F>i7e)Kl5v@~5tIW$DzqBeWar`cJWB=vM6X1MdCmMjRWO_l1?UpJ2pP=pVqIYT
zUcf+~wSICIpI;5nH$q$F5YCX1sbu6)sw%#aa1TqMG76@P5{XDPnyM&M<O>*22IIK^
z14q_G!LY>Xrj>`%O<S6?_=~g}!`;cD@({93D<^0*b0)#RdJBesrt+HU{BJtad<Qx6
zC9ee6Ca*XrKsWQ9Zm~;bRS%PlL$r;))9WFm;!!4>yh1M7``cXh7we2i**-{voM{D3
z5~qK$N{mCAgzV8mx@e(%(CJnEa-0KN$oL<I*c!M}BwVS18Du>FCwa&)+{PO`12~@o
zoc99Gu7EQUY~%nN?|hweC(pSL%+0)q54)CbRziTdgLhaQ;d2h*vm$WUWXHyTQO$4!
zGa^!ks+z)ji)Fp#2K%b#RpVH1Il;czc|Yx0d{s5P$_Q<rLr@?i-;j~VsH&d}3HPy(
z@%8Cc)xfKa(IYv8`()%tGE#%8I$F#pE4_L`u09YZx2~jogKXTZZDO*hYw4Sqk{ohT
zu6`dx+_3aT$VjhVwe&TSpQRN{OGy6<>4BtosXw9$rnA*|k&(%weoAuB*fBqMNXUmg
zPfM>}kgLZ)xn8IK@Pp#+So(TD<RW`RsSS4{e4y;I(&x<`B)xWK{dZjAWSSB_OF&te
z-}85O`vR>7v#a?@H?7<udM&-<rRGCSD)W03<N|H1|L$odLmMAbLI}wrgjfKRZl#;q
z<T-8Poc6$+HZ;Kf6BL1CCcv@Sb&P1%@tf~i_C}xr2XL$s&Qk;D(M3PE1ukGK_Zg#_
z?pe;%Jxhnt3-A)sHY+Evl|9BN?RVBAQ3d#H7`9S2MLtB*2pIpY0CD+{(`lO(C=vtF
zudPR_WNcR8cK|pC0FR$fQJuw0dIIp%|1iW3fuZ}sP%3dw3QI7wlzh_iCy6{K1;K$i
zDQJKr80HWRZGkuCaMR0ZX$!!&$0_I~8Ocqn;$Yghg9?M7!XDsF9dq4m{?FT?eILW&
zBrwzf4CMktyTQ;R);ce9y|0)sS3;P}A<S6-%biZ^emKHh!9NVK4rqcdns5_TK!FMe
zDb9Aq-tKZ^c*{CeVJOU$g;RL$Xzw}ZY}dA2!WLwEb*5L+Z$=QzwjI#MJq>YaTdlrA
zAswj02r35IngrQKf3C8m;7uA(s7El^x~=WJqdj+RB~hLr`UZLMzbYAdL|ZznY;d(Y
zdeP(H50YpzMjgy1w`${jdjFtO=RQ0NY9`h$3y$G$Jc7CW#)TGo&%o+XWhKic?m^^8
zEwB9LqY3rP4gkW7mQ8Ng#?6E{d|2{0`-9|=rbRE%qIXVPiT5v-kWvU2GeXI2(^Uzw
z=z!p5`+X2WpY9Nu(*93)Nnf?QXG{b-Rmwl}<9|!siC?|o)`(H<4tcHo)6YGA^-lK_
z@2H`D8bbcvPZCxB(Npoiv-^dYbi1DrGL(Og{s-RY05l9(^{`pISPfjv82u`TU_eIZ
zlaW%?s=-2n3>Gpzg`XN8fJPEL^D^4Jgdl?>$P6G;Y|vjy2zLjNe%9zy$~S(Nutv<l
z`&@uV6+E*Bo~eueq6mC6+Ob=Ika1)r53P!mInoZ^9|Z630Y2KXCSrLcteqHnf<lwA
z-A?v5oEYyXBligkX_eNE({?o{2-*9zZCsmY&(vv{j5LJs`?_(TE=~mGo--MV#MO;I
za0fm{!X5L$qjB}iwm5<<5ecJKp;#lutdRrY{Qz2(`8;IoN`|!_z{e!`=w<YS5`qSf
zpfP~Vw2>@*F`=u^tK@J*s`N=8DnOq%QQq~*^&=fqvBKHA8o}mBM~a|wWVA4F=GW*U
z9N`cVxsO^E#Tv<FjqCvz%I7<zm9@^ioX|IQ?L@t(uT*?FVPVY6XX5(AiNAxitJOoO
z@^o~q)lMM+#=MCTzRuq<l`NbMx$7G95*+wDM!Ud;y})CAR{f<}{HJR8CnNOD9D*Vl
znMOtmQLCWN_Yg~1<Sn5*_5vQKz(47t$4UqfafF8h$XXk;UJ2pkz}$6fbckDNs1e=o
z1yhp)Jnjk{@&FD+z+;@i<8Q#@{jIY<ZsQ2IiF4<ue(5aD5|$<}c>LphhdQ*h_2c?p
zik&Fvfm&KWZt;ba&r|V<lV2NYSF49m<?NLK#>ViafN@s8Jpe<}Z2Q}BSu>8BAG~K2
ze&Frtbn$-LlJ2!|r3{iz>3wKHuZ1W2f+4R-l&P$(>|Kq3B2iK_|3*ch3+kskY9eZV
zB_7UbQSd<kY;MA~-*ILlbxWdvxtb^UcS^p~$sWU8JyY1SPwubwHQEwwS95~UTcXar
z{V8*m&8W}*u(SzV#XmSFa;>k(!<kAOiGJ#mt^riWpiZeJRE9x#q6$>TAZ02ZD&wC<
zKn+q-M4&R#dol6~rDgQqxr^rT;oHmg{V9Y1?RBS^-noVc%fGjug6Ve)5d+7lRx_(N
zG+tRsk_uSLuS_IK29SVF^sofeH9o<&9$Z1^oV@#+OS8*N5@Ly9x<O&0hZJB|HPoXf
z2bg7=OG5SQnS|?P5OqpDp`uK}(U#!GYa(SXb*p(-qo9bCG`YWj?@z>?cY$tPuCRqq
z?k@m|^wg~)W4fC;ZOP9hToQ^KOx^OSaV;&e0yk2Ll$g{lIOHF&tCd0t&1jNpoe7eE
z8E(*HdhrCX$ObIl0u~3rAA7(bx4*{tK~s|`iL=ba4+2mVAyF_{TkvV-swSqTY*!1M
zVXnGg3)evp8MYi}L0gIT{m0K`Z8bw%sdp`$l0l*n2;lTSVA+s`74w_fbU<$wAi@S@
zb?7NB^b|>E?-CL7bO>{q`tu_#?_nX^n8}_x)ZS1SClhz{siWL2$L96t_Sx+x5EJjU
z_<Ee`%bPLn{)p!j*$4h;3zAo@g%`2qrrDPYwE|-&tQ=cHRDmHzeM&Up-MP@k=?OoK
z1U#^vQBS%Uy66fl?gbWO=dF}x@qr$|;;DZaVu|1nPVmPJ5%XdQW3<MQ%kwVWKW1{I
z4s|LNrVo`7;V9=S4wtsiPCkL?eXsS(wbaRyVrATbNq&ToUe7j}50U3ywI)g<<m3?8
zZxdF6^LsMjo@=Rj6IKVJ5pojnLMB6wvjdYFu=YrwS5n?}Z7^2YCp;ed8NHaW+GU)M
zbPNkBhrWL?@d-ker=nd9qR-piq{j-wZ8{mbr=kgvdh<v}OssHo%?=U@g*u%fOtDj&
z-_QM~Pa7td2M)Ew`pL*LnBv-XpSD07C&p(}0M7%=w=(k~&f2Ff26BQrV?Y<Dq`cx9
zc^BnQMoQx94zJ#WPFxo!TK-@3Tr5vB)M)j(I4L$hZE1o+o3WOXfa1?#XyW33JQ_*~
z^;|xP@ap1h;ip@1GqFd%&Q+wtZV*B1Q-FK~9A$?#aX_2oAf(gasKOm9hrcgjVa-5m
zE<nBtj;ev9bkTTQptu75^)lMi0?6ogs?Q)}L}^wBnb>a7ngm+21I6`BtRf4t2$pUD
z4iP}aT%=mPV_{2K*h8Ro?YvbK3%ds#dNEH@n8mAC!_|$@qB)3zWK1*}!$q~~C`6cJ
z5nl$raFX=LOw1cl8ING<>$aZrj#%zmOHxDQY@{&!XeT3|Q+aahIJBCFJ21OU{fX!@
z9@n+&hdTlVI~ne}ye*~2;S66xp-u+&L^L0#a;V~q3Hq)tZWrn4^6EGomMV3JR#TT3
zec)g8T%>UGu12vr+>yqqya|dt*&Ku-<o~f~Xp)BAgkHM{3Q9cI`NB*5|0*XQ>L;5+
z&u1Lna0oXdMwv=VXL*#cJa|F1kMpEwERVgQ+RJ%?jTZ7%I_Vj62i^uU?g1H3;pR@D
z8fwQ{XRlb{5LQHt9F>&H@+f9`901j7=1K7^4=zwGZl0t#i~mv$|6+u`n}bj#W8RW6
zB2-deA;J#}St49y=OsTQ1^z`BJzIkC!y)_zF!eT)iuRLwz5F^3m8VMqXeE02(I#)!
zu2*)>B}+H&Y80Ew&NOM$$Y?v@7BFyyPKsoD>;bE90S@;7ho|tfC1CX(z#$TTHXrnV
zQSWPtLzogV(o|A1%LB{u;0CMxX(W?*$k@v$4jzC*5*&9KZCiqX;SjI^3<`R3%T4K-
zi|9C5$&|W5C76q#J@ISTt-9wjRGN1+ij7rwn!0;rbotnG4bb-c0IoX1(W9f5Xh1O$
zt3zp!dn6ShM`I|7rOe_>=*2i$1&&Jnom&u3kaiEfY1ti<tkV3UAYRE7zm`{EhLbN3
zB|(DxzaTV3HWbA3L4?;Xx^CH>_$Kuwedml>c4MGqsj0u~3*yUmwLmDfyYbtclg!_k
z6f#DDM&f4DIzfLT=)V`ZXwRC+P=ODn{?1o-pUjShnupw!mAQx{bW=`N-NWkcq3`9U
zK0&CmD4wF9AZh1Jhy1@n)fUAQAoZqIcMNprHM<D%HT1%F2E6*e@|X=A{=la|Ipu)f
zPZQV!oGL+FrSDvAfx0u%eEQ0p_blS;vY~%b`p`j+ozS!3MaMx0`JWbg!-Ci4SQkUz
zBHqC!V3OTMsEdK!RTN_<=y}kA?qcAe9CygFB243ic@p%F+3SG5L)?LPf#e!^Zw{i;
z6nzwnh#lHDi$01&9H6D_1q;gIat`RD1F~Jkgv(^)399P3V#HE9jBg0!Jq>V0!rAT7
z5f12x9Kz)^cvJyAO6A-(FA?ND1#m^cqwLVS4rtvR!if*?7QwUYz-n%i6HU|M;NpYS
zmk;{UVUBtC<O?zviRNAYq_GBUs>hWdx(AaNXwII*r>SkmEgD@t@`qEUe<xdR7$%4G
zh8r0Xl2S7=l0}<*KQfO;#qcg{j|MDrd>NUhOq(b2O`9!foUY4C)3{KRSkJ(PD-f6X
zMv85Va}@&+kFXblu*o!OE~c@mYB)Mw<ATZsxeA1@Yr)1iT(0+Jl+;+C%XW5qxlxDX
z!Uoqi^5LbED&IB}1I3o<@A%H27p3GQ3bxCUk+~_^vYOJ`$r)MS{EU{r#H}P?<DH}@
zJJhq)hZ&zRyu#mP*M8HUd*5_5s#G@M>p}Sz^lUFlM)ACQ@k0jW*stYLb>vRfk)%s`
zQxk#J1{`h$c~o1YgE2>vPN^L?5GK1`h(9NF^$>(rR&xJl9sgc*QhQ?9@tGcsp#L!O
zr@{RTA&SYe$yWXfIS)_2H`sfA+3B3t_t+xKd4ovL(^{p5{EQ^F&AZs7=)6oWcydJI
zP^;lyMv~%q{%MBA$yP&Uh6UFX#X$>p$*xvIkMVrAwKFirAV;Vg8=q&))os;}n1ppF
zxz1tKmC*M`C%4Ni_n(uLdYj078y@{OQMu1sNL>Aoa$jitT{u^IVugyNX<yIYKNZnI
z&H^DRAy+}nX<2ERgW~BKGF$U-R#lIIL;+e`!_t0hp(4q19+~)RsPd1b?0O>4gigYG
zqUz?-VR7|spT6*{S)D^`iB-#zh|M1M?cdScUnDBTS;-Hylt#Mg(xXr8DqjVj9g#7b
z7P#^nacf$Dclk$Nz5zTU2{G`WEZZ`-?X&>*dM8^@-aY(>%mdV-_6F>W&F2E<$1R%{
zD{x<BjQdl<W{y{JZBS}tII~8V9p=j3I?%1VYWgXa<z%dh*Sp>duXn|RHP^CI@2ME8
zjTjwGI}_bCZPd(MSe2GuJ$y5+0BL$OEaQGWdsu`0HMt7hJ=OdZ6}Zg}6WWMC_<0T2
zv{I{6KIQ)J_<P?-q!E>DDRM_#R+dRq!K(x9*IrIHvNAV3r4Z64Ry9c&Xz<k_yZDus
zjaX2z#<KONB#f~Xf=78-EhcF@Nlxm9p47G~k3p${LAHd~w5Np>MMgT~8o&AWm;YM4
zKV#6Y7%}5J)>#sACW_e-TI)4}=BwEE7smQ}wt1F(CQ<D?=Vw5dC852OXH$sz+kVRU
z=0|@0o9`-%CRQ`uzVg@9DQ&KhHoBefM_0e}FlvF-*_EZX$-QJhHD+bSAGLV?hImUe
z@5}nj%0UsXS~+*qPuzOFBKWFMeN%)B^-M>~aw71u>vrLrX=r%kH~I)RJWfY*v(QYl
z@#4kJ8HEdt7d1ogmUMh@JPuDe4j1^JZ*jQQrBIm*p+%&Ls%IU@5plTb#ZX(wF$x05
z6-`fY9(?P&cAv%=(TE|){4=f?!pDoDA0MyXf3$WV)8W#a+ToSc;qoQ2!|Qd&T<66`
zgP{q{f{r-|wDJSj7<L&yFUi?6hY}0@)++oH!W7=ILqn&;!ZKq_)3Hi}@K?jsGX3TB
z?LfzCgS9ygX~TVg+nO4Wl^lS6L?K_B8t*P9rqRj-R)#$et~I<=s6`3>^>+$-H-)EP
zENwjGGZTPx3exLDonP>oIVf_&OwX(a*I5~Sz2%5pTZBG2`haMdkX@L1sB5YM$D4YU
z^1d3*H}%^*3d&=qrfYsDOZ#fNQS}!~`<~aStk%|@dbKPgGGnfS&y28;IQF;N;^&?G
zMl3`M&zNH@X1VkGs>Iy0)$m##sWCN1f9@LunTpQf%tU9-dZgAui09R^?XA=peZvQ-
zwIz@!HgonI-qAL{(cB;?Gk*DTxh*Y8#f~`?vH9T8v^V|omIlXit=r!EYJAIco2>`6
z_?AK&Griz!ieuN0_+#@FjjI1*@9OFm^(`l;eZHho)fjb`+vKg>p2&80%cp^TdYYp%
z?~KH;ZI_Z_P+Ut_MI9EF6-Q=n+Kn`u!bSs6mN$Nmn7Ju#_w#w{a;a*0pU}g%-hrP(
zX>ZmmV56etmG8VAM-*S%+Mlpg`wBkD)P5XMaUywmv!(7^z<i`p?iu`exRkW!uVHc?
zW3KDeNEhX2{tKmZ$44Z1;(a)noJqw8z(^zW9^aMi&qKZ+WfYOyF2~+fse5Q{I4}5q
zESib<rCrGixkX?7kGvFtqqsS?U>^LH_y%fYa6$(hm8wUBbE{eHc8<dw5Euag4=>W|
zY=r*h{lJpp0ep+Xf4NJxZ=0I)D(Z^1!WfZ`*ZJ@Z6*ZLMPq3wqMf^s~uhQ2wI(?}%
zUb!_o_{bWsq#B)sn#X59drc+wewXY>`QFneHW;ISzR7JvdFfkNN#K2*Xz|g+o0mSK
zjlu!`<@6P9og%>ZkFt5z+B$~>2|m$NjbOTcmt~}{yksf=vU1&$dzONb%L+X(F>Q57
z7CrxHd53s6aVKfNY}^8L;gyYZ?JzzIq5BheDpE()3WO@oz9*h2QAjwNcH>O{ZFe7k
zi3OPG5{W5fh?fWBqy*1GT*1eqw|u5gO1DlLu^ZaiCu7Sk#X9gv`~9#Qxsp%`F<Vc^
zcKqC(--MG8S{TIJz>bPB>%Zlc#T^8%-yaAR6l1zqwB@vk*uC++WiNVAq3NoN_`h*6
z`)AAj3Z}RScM%JhqQKfWv@x7}aG=-QpJNXHAFhnylupkpU3pyF{Al6fS;A23`zUrd
z{bO7P;-bPZw|xfUpIhyW`Ek!8Dw4Ulh76eX8hK@2Qs8y5K^K~+@P`724_COl<t2na
z<gw>ts2}$I8#7z&IN9A$0k=wI=0C7n?Qr|LJ+;r-(jzJy_~O3?-zxdY7q8CG%6J`7
z(XD*0xgVM}j(sXqfj7QE?HsxLP<+Fih>AC-9eCK?9^?#0<z+g*D4lsub!a+#lZR)p
zru6yy5{j_eg_y33636Iy8=UBu&B1mhQ@1Ow@x=w4Qy|;NbOpOMJM+b{AbPmNwFz=#
zmD`m;^hWvXLg6T`x$<x0!pAb(W4e}FY-UvZGF2}sP8SZfeskrDrXKx)h_v?L!B$Hr
zJHCoP+twx#(CrsDcv;l*v$wah{vW`y^z7XeMtTokrq=Q$co(`-qIna%gC2#7y;EI0
z3b4l4-t6nC4Sp2L6E)>XA74u-58wB#MfKYhJKNZ__geq0H#)1A{+My?eDlhLEe3K`
zZPrut<wpm-QPkS#915OVYcNQW20fXMB7bdPg~4(tp874X2E5ssqrBjy;M1&ylq`R`
z=Jn0qrup;x1Q*87d#e&2O`i9Tv$kjnax92`xBa*`JY@g&ufFh*)bJyNH~vuiH*3AN
zMkBT#!?wjc!}l>Lx7X$xx^yl)Ke?4t0Crt6dluo+*kN~bb5cCXWL{|Lg>@Ba+nKlx
zf3~%1w!LxYZ(d$m(Y7|kk+vnM;ogNUDbytn@KU&8IHNqmc#==;?>n<_Oi_yfb;%#9
zp0;!#w<V6Y6iZZ+0X@M_>065C;X(rx_rjJ;>QX|k<jt1uLZoDtn*XB~ohR<eAVwOc
zeDL>Qs|LfZ^KDBB)AY=2?KMLmW$lwov)n<o*{=gTo;8lDpIl19FK}Dj<%3np7MuAD
z-hfrbphoghBkWL1kgrNh9pRaBEfW#)0fJ-0z}_Gw9nGb$i2jg?-k>siZxH%fvl0gg
zk8V~v(DaP@A$Q4*x}nAd*Z{O37#7(qnX|-q4DG?5(h!&ZoxU+b->4a0jT&D4)EIWz
zRp)TzUp6<L!(Cyu)DIPsw-)xPt*}4+`&4j4w>|7!YxbFpWm-{W1MS+Fwe?nel!4IK
z4+Xz^7hYcl&P+p>son*n+3dcxxVU`#Ae9b;V!}(=Do2XboiurIDO5t+_=RKt4PEyq
zjb7+^A~u))vs;r38oGY;dFIqp=+vWU(Cs53(jygg%23}>TOr|3`GwM$E+64zJ-CiZ
zjy*biS`p*<4DJ^OvKK_(4GdB_uI3Ar-t)Iq(Gh9iJgusOg$HVJQ^MX&d$(Mhhd%AK
zF0wcXpPI!yUB}+4RiPdkwLr67>XL1}MiaP&8Rz&WH*E2f#J^5EJdF`q_h8kJd0Y<5
zNJ5kUL$EKCY^Ra?*G0tt5~$R01H*0Aiy(S%a63L>3%M}p@+Rk?Xx89%i4=(b?8KZS
zq=xmGFng9#`{StI8`o)CSpT2zPuKp&CV${VIRT~9^K_F^xV0~f(4$~9qp^i>72B5G
zfUdq`+n8@w)iyNKLUh>1FIUO!$m&=RBc-)bc-TO8dUD1+MGnU`p;Li)o#vEUhLW)9
zhqIeJciSzdm0Aslh5CN<LTaB?+0*comR4;ohp`)@$C`bI^e5gsN^;Gh5*myW8usU|
zxSnH}#yt$y_DLER5Ml*So+^=5Y#<Ay6%?mk+51cSP<5JF&RM04^Or+jvj376zo(>|
z({$%xbsG1YJ6o70+g1*>D8l9Lc$zxnGuvh*&zd0jrpbN=jCV73kF&1-P;1#a226BK
zkS(n1z^443mIJM2T&<tu9*VBnaD~~h@8E`~E-9^L&)HhKTgybo1@#RNZi=$EKv~(x
zhf7+^1Q>L-&0x01yq$@V<HPDZxPfO)iGNM$WNY~C@fP86)Kw@*h-)j3Ym0|%8=8r0
zPs^TGZ;n>_OK7HpTw!|bJNUxWo^4$=K2fLEFD(L(NLjL$_WstbQ`=8l&8s*bW*lX#
z>3n<IL*Z&Q&)@s-`?Ox2hh?j|*q-xW`2USE*`H)_NC@rKN{Hy`&C)B<XHRq+_Yr+^
zoGr0xFTtR-Y7gT+^YBB5uTWrq%p;P5WV?Av@c#1;R$>@y3&}w%hi6CL20iX*%%Hx1
zi$u<jsQ+1L)%t`AI^>$oo<6rfJ<v2k`}|!8^*_h^v|{e=aF3K%Px~o7tMBR4?r4mL
z!b19fkovT5E!w}`==`y7w)u8;{>B$W+_zHwuih->+*prhmn~bJwSh9+CjG!;>Tmww
z(EZFO(GuP{!~EjvJEOAP9(Lvv7?UG1n{7Z~Z+_sCxUryi&7i<HD))CP_bnzz+Mu7w
ztfpT2+?`p?gMYr~<=@Rtc{?}M=ePGymhEi)iy*~Y*|2lLge|!WzM&#}F>N6+?KF*G
z#dE=mX@lNr1KxZQVVCq;#x9phUHpFl00960G*|~b)bAg+LUtrk_NruLZ$&BlM`a{?
zWmo1o&diAHY_5<|R_2d$?#QMtj;tJA_UPPMcO3p-`u|?9&-eX)e?HImd7jrZzR&o2
zthC7O%qZ;4P#$cWuLQB}s8Jm7(jNF~sW<z**!9H4XO`N5<8Cz*n}TTUVw>NF+YBUY
zv~(A#(SUt=i)QS@E&azP{p9w3@_>DiMKiB8SRGK*liM`D4U6h|_Yq$ey>}F6<cC_O
z%JkrXv)3|(2Z<8e1^c&U3GK9?un|*X)KLGn#{!5FWGg`kjZx<pK)I!!<Pj8`eQ)hL
zZQuLzo<AQYa7jziZmY-Gnl!<=Iks)EM$)NRc3UGc@5UCFlodfMmnX)ysdvfdYv<xa
zDBsx%1mEP5YFq6qrXpKDx~+AIGXjt`eZ^7i!JTaL=eUFKP?JyY-e+zXpq8$P<f55B
zSB+%6u%(TlItj}-u0Y9qU|;0~3mUbvu}Loo*;=wolh@1JMwG^8AEwhi{LF{0eb)}{
ziY;%0cF8DlF11$H73DL0`T2<0(t5r*6^k4Ed5L|AGEqAHt)z%P%_TeemsjSKI(AW_
zZyshQJ(O3rlh*YZL5l3IB|v!mO=)c&MN2WfOKiJD*;D%B^(&@vNA*XEx$mFc^B>b`
zy39K67*cU5`u&q()kldOc<k-=;4Qr`8O8ZUNw2q^A3ZhE?QxL3@h2}y|G~Vdc0{)Q
zyeQMw$Kn!N+o;Iw???lREq3$yAdW2<C2^KEIN3)Jejt)qbHn77yMz&9*T=~nZ;exo
zSoDRfnT@j?@tr>^Vq4jl*#R@{tQD8ULRfVW_jM3-@8+Cd*`~kCrdbhX_V?TW-1o?6
zeRi!pE9s|!R#WMVCSs-NSB?U5rKs@ZjbQ`5r4QOU*^Wyen6~qZOI&SV=Vp%%8&GbW
znJ?|LZ-XOA@K}(doO^uo8u$WQcP=r<l?0D>Hv@#?;l2?5gD7ECu-`zAFiH!u0p^JG
z*M0-fg%6Y<cL~BFJt-`L++lx^q;bh>dS?g3Zvx$4UES8q(Zu-~LH7-?`*CatXu_Ot
zyq1Wn2X<c$f2e>zj3geJV_DhobdK?f!URYzWtzk6d{R59p(`xf@5Yi{&!T^Kc!cmV
zwJKJN;=&1~MYpu@tLq#>hTNCRk}i}LtyH|a{-rB(q$`usVbJmwC^ZJe7TXo=dW~4A
zH=A*wUMQmasY<166LQeRnny1U*^CyO?zcO%FKy!mTP47~==bWA;8mTN+rS4iB)eD7
z1GYli{&)?)>L5)wIdtw$`13WH5mUOOmsfX&R^QpNL_t(6zDrA|WwYL~ElSH)>c5hZ
z%mV`H+S&?Bv-S^Jr&$Ora8iI?QGmV+H<#$zMy6SO@0Xw;Fi0(MiV|K6_DjeTUekh{
zfZnU^@0ajc;G_iIlOX8Fw5K01{gfX-A&nkhm=)2YRx%>^|LfjnvEMfL@|r?N{le3!
zuxsOF*zP|bq2t4FQ)K%Pe!QNb8_6!+XTf!!-gE2y*gL3sWt(QE$MnwoN9YQc4|$5J
znI3tIfKz(v^t~S=@_ddni#}<-s;_Wz5qwSIS-eUn!}ZHX{F<3Ob`PI?aP4LNkk=73
zsI{b1xx{}~3=q%_xHjHs1r!mU7H4LZ0TepDri#fO|5otj7N=8aVU=>h%Uit@oGdLO
zPD}^xaTDj_CPdHBC2nGzrIwMUcHN(-)AfsWiuXA6Or^dV+4-zYc39ntbE>~ZYv(D>
z63=uFtaTG`n7wduf>%o1$EGeDmDpNndJXkHJHF@YByV&Bi26A@CDlSzz)q^YL|UuQ
zN{dcOzSlNvh8%IR&bV0n|IiB;JB?xP#4s1``G{=H_WR&;M=@_=;DT!JR-HZvIl1F{
zxtq>N5v(M3X0%|X=4sgH<{+oKAg6NpNe)oS6C_c~r3aJAC3Aei!PmeM`3~B=FI*={
zia+S?lwUQfzaN~jaRIKkNAH!cft?lsKYFq;lIn6;((V;5e{c)$U0i$MG1@p{kx^z<
zoyb3KXOyQnWRZbSxv<?QP^zvgxOj{HddiCjAj7!K)4&qbb)&lv+#Ol38#zC47t+@E
zroV3FCHSFo47OV9-Wtw$oy|B;moSJJ9Qsx2zT;3``>fqS*p~rSZuF)^r9l4is+wVj
z{+z?~N0lzU?crA(hGmyemaAeo2FotbX~$%!W=++fvx1$og#90_VXvA48S4TW%bTnj
zJX;#AVILX;4IDOA?KiU&JzLU$_`DsNs()J`X+7mSWG-*rTs&3JIh<8p)!-tbVci@B
zr1>?6sz2PTiLIQ&&bW4B#;@&Khr%qu7M~nH2dUKusnz|5%|UA3xIlYcpfR|GYtP5G
zB?#<}+xxs%V}5R97UPOz8O89*dYqBh-k;lNMzQzDzA1>#8^>agV=)E?4Hm#}h3k?z
zPDdUUA8s}Y``CjqNryvez*>5H5cZ8Dk(on1Z=851#zb{<)@l;gFpDYt09RuKTbu(2
zHBZ438-ucwrca409}Y`Bvj{lMa&z|H42*FSmWakA<TfaY(Z}QRIKdC2B8c&IK?*|+
z#xWbbk#2?YkRJ(1z<~w`9axD|p;RwSG#D$nfA$eXsm>Cu%B|%;Y)Ti`LVm3F0)ZVM
zE%?W(YuJxf<6)T2gH>a}4{9-)f3BLft*4IiYU>BNJy;dg)@KC+q@&Mz!A#(K^s3YO
z>w0Fm(j@hDkpZ_tk(mZ#c8ztB5rBY*6*M4y=dV<O286gs6>K?-V64uI2U|9#(2Hl)
zf4-yTy{T!xsp))%UYnZJ(_zTzu!0|dB&ud7d^S5qr^8+~z4xgCzJx$6_e}_Qq2%Gf
zR6W$YdE<VAi&mcGVW-y=O4WJ~4R|?{hbnGElt7o@o{G8kVE*;X722?g&Zs<h)ChlQ
z-)uNC_o5u>mD|<e^14X!H1OhU7WIc7+SuVNYEbjlijLoW^j8k3K|0~@FyHx4W%ZSV
zXnLXmg=Rm&=9_>rgGPLcHtXp9_jH}6D|c#2zE`G)c+l@YDl77+fU@)MQi;Chx>gwy
zna;qN`DmR=^i4%M<*xjLa#x;Rx@YcW$|rfp6q3xEw+;NlA`~r!_^(EV$_Vp&r9v<9
zDiAu8LhE!jFQ>9L3-N3B$055_V#K})%DiCtmEad&q<k9aR(YW*DfX>=lVchE5*zx&
zu)tpo>ps(+E7fC+dfFL)M&z_pSjZ@xyko4%?;Xv9wABQ8PT$=1`HJWdX(`hihbed`
zN3G+($SQ>sTI1d7Wy7(p@xL688w(RJ8%y!CNb&#0Z&Lg<HkwzTYW`d$xV;*JHo?eN
zXKM9ncY|VfN~#op+Q{NB`d0O;4%U3h?*RFPFF69Bb;9!)+rM&|@Z5Q6<Lk1JF0e2K
zOF1^y1xXGOp36^x<%jc2b^&#h_5L>Dc_Z+C?BcIy6NKkUjgvX4R(?#VJf|_jbEccD
zeOo{fNRM3nbr~r7CM7>3vhPV&oRb4cIV(HP2`J?z@K#$^+;5TH7lLDbw{~B6fRtH&
z-1r?_Eo)r+xVQ6(OF=-jY*9rD-P&(=kTM_eDhQ-(E6v*Xh48%H6Qq1c2+9@}N+k?^
zmlelBL88&sydw;y=ohz4GZ9(faKIKk;8?z!qbyG7RxvdxI1Q{6D2pc~_@#$o3q-`f
z={aIcIV>`~IF`4~HkRdD)kAHiSfMSFtkCksU)zo9p+J==>+CqxI^fo+hhkdQ$<|9t
zCYr$tDiYh`eC>HcOQ`9r#a|a+k}f_c{T~BK7dHvl=Ly%1vrRaqpdLY_N2`R&u0?<P
zXCJ>VqDzO$UHn1HMpCThQ(1B7XCUP_0NI0-zqY9tlx6>wKt=a~5ul4a&gBIEzVmLi
z3)38Z8$EzQcVhmJQy6p;ygV9SuC{p;RkzO=2u28;DkWZ;kWN<|_b5gVSm{p5Yp>|e
znNjW)IW+AvdE>b4aoomWL?*EPc#jdY8ytOaB=cxJoP^c%VB`ica-IL-6h^KI?iK}i
zQ{B`sm;`6dVj4=}Zs)-h=fJ4?DR6V+{zlUDDS73?-7?NB8t!JjsbM_>R-6PkqcOG4
zgP3tr!OSPCx}X5{WkvBHm~rprpG&Fm<p}ulU#x>KKLevE!KfG0hYAk3iH$vo(ez;x
zu)vr5`P5Er9JMv>uX8u;ua9DCXEu&hrw#+^_t))l6V-bVo0-Fay8U%yFzRao9H=KB
zShkD&^2Im2)s_`gHZ)i_H2#m98YVMfzDaNq8smE&jBsh$w;nxJXqA>0uRVzM^x<aG
zReg{(pFU_N@Y<rcY9>LES08kR<wLu-Mkb+I6Yzob8PK)G!eOg?)W7h2PS4-mEu^mL
zEFtC76_I4WNpe0zuT9eQ^mga;cHs|OfhsuCXY<_XG-FKDYWp}<e$$C?^$|2l_s>ax
z{}I3S!ZGW;KPUeHbobARrSN{Z|6i#ryniwTv}t%8eA=egC%_qG_GOHp;1pP}J=x}R
zd-A5>XpdCP#AilQz=rmbYT#*jC4~2|Lw@Q|u-0jAdEztfKI;oxuCU!JQ~RVh8;1wL
zv!%Niwti)bHU5C^<8iKg`Yy^aqbl4r&-q9WEwT>H6|*`SmY-UK_Jm(E4Zoc3fz`SH
zF(E}xNs);BA#TNeCD?xb;VnfE%iiAd($R7mMa{=O8HO2{w8PAx1<i4_m(Z@{pXD{Y
zt@q4o?g<JzT}Vl~H<I?kYG?ef4spI2mG-$`RrV6cc8|=gRM~3aEyI>XP@7Fv`OIk`
z(75G<6TKO}2|SDbhjzDSM@_R%rpsnT&2XaJR(eut5(A>mZx`5~=t;c?$Wl-0bB##$
z%3t}SMnntsRQcDogh2zl@fLYd_JXlbq1}L3H9V;b&eSy^d(_k|OD{g8TyPWp%b7bS
z!=>gq;Z@@Vm*B4jMiz0qyI%&ZMl9koq?HRo-+vk4Vl(cji_MTuAY~)TLlGpM;(XU*
zQMnT{xfAxB@Kwi-r?Pf@U7;#+c6=_!(JP;FrQMc>6t)+Up{;L842~UC+C&D1UlIZ_
zwexHp+HqT)Y+V-0Iz;^oT^7>-ad%m~W;0%HG@sTc-l*LFn6tTL2hCxBm_b|0WE}OZ
zL*GZKw%%K*ws>>tapP<|Lvy}`RZG6bD&W@5why+>wu||V6r^~Dy?y&Exv#0?(g^v-
zi|WzQMZ1h4L~K7HfXzxj!AG?|^lRFpC$Cip5NeXB4;3!lGkV}miWMGGN>fjBEiTcl
z*=6RRIM4+i+GNi#Cykn>tccok^Pbf6i+7cnLnW#0K1H7THpmIR`E~7xTBrGSrmZF5
zw%L&!S&K$aP;Ld7&##{+hER0azLixl;vt66cGyzeu_7m65x%KNr5K7iBvR?}d^oUY
zZZR{3M$>jsM)=lI%{@RWQEk1U4Sq@@6hn)YlnCvurl|ZY4w#>p<$M{i`675D!EU8n
zc%#^0#t~DFx$bTycWizHQA`5=^=_yf+uT*l_NbLI$&Osf4lC<WIm^(7A*{8?mZTuE
zMP^G9*zUMTETmamfE_8(md^*+kuI$hwyYhGC1p;`IX4uH@<=ViWb3bFYy0EsL{d;X
zDM)Y_;j}czozcS1+cbc1$_OtvI_AwGt9=@1Vc)8z2=!z$zhQpy$lr2m(81*si-fgc
zl~=&4x8CW*W;X0h4pC93y=kQ)!Pf~pBaipK9h(1^7%0@i8}G|{)7Hu#eQEC7rMVi(
z4&Iv`vo3gEc49KyyxL_V3w8UOm5NB5{k)p|7B59;94B#~h76`S4ztG(?%vb##^a{2
zbDoLetd~wOF8IQ9;x{&|S}xI8hb&!OBG!?SfE()$qQV!NV`1?`DS-|Nf#dHw#Za-1
z#01=EcMv7sMhXiP#m@?M2g%`QV~M{{bLA)Cesl*><7dsW;CLdRK*zEe{@^rITmo*S
zd!GWYA%z8t;^Bhb`?7d=Y_Rp|7z}mqdtkwlL|X}b*xgWmwz={fv-x7Yz56dN&y{~6
zYSRBceCiO2py|+}Awp<7<|ur{RXyepxrq?wP%Vl%-*b?N2!4urI;#2IdrHh?3Tmx)
zk*EGsB&+^BolXS5^E@5%)*djuAgPi3V@Ou2t!VT4IC`QW1?1Y~QLVJtH=Vk}@c5t;
z*45dQQ`z5i7;Y(~bv24CBdq0>8pH;i%)TU%>vSQPQ~8^Pw6yzEC<wwzX^F}ZnpA#=
zh5PaZ;Rtd(Bgr&@{EVJZl0>e!gE93V>ras-l<<&DZ$rjjlP?Qu(e|gDlXE)?0j8!(
z3Vs-5h$`r_Us7MnQ%Nzv_UXj)yJ7p7@y0+;LJAW2C%RLp@xRTn;_<}u0ub!qo`ggt
zK)-jJP~bVFu;QZl48d*_S$sw;k>fN|dIEH;+k^_AVU8`2CteqTtcl@iPcywvfR1*X
zP~sm-VarAFXdsgu9vw@}IL(xo0R7QzLXAh8W8LD3+yW3W%PM)c*&WA4CTa6;D?NkU
zmQ@8WB+b9+&%5bFKwakDn76*2c4k&2bR3DI+G;SL*J9h^ry#OM_FNg`I%@0*w@*BI
zCwWY5Nv6y0LFr+awd0{q*kvZX)M<su2~c!5iW2W<j@4qv^G6a>DDkntlr$pW7dtKy
zI~Ha;8M#Mp7lCNT5J6%P3|qLq|5!Il4!@m81PMSe`ebpTV-B{H>z2H_>EQU}kN_e_
zElc?5r!P?Z0Ahw`K=2(Q1X~oDN*H0ED*if|hjdOCaz_|J(JyV8c4F8cPP?FWWufB^
z-zqdqNOhg(la}9`acBVWyzgB@)$n}c65UG_oRpT`OQZ!`jF>th`X{A5Hn=Dc?@8<#
z#2m5PBb@8paAMVv>t=V4#thQfcOFXTu9}g@40LHp52f!7&g9x<4NJ$#AclvfuPj{{
zF_k-2o=e%0Bo~QoiEc8341)b`w$Js-;*w-33+1+_BO{9pce5pGR$e|9LhwY9ZwMni
zQiC{vdG{%a{81OenQGT0gwXA;r6hPNrIqh;0V$qI<UCynbE=)6AVMn5j`a?tFwIV>
zAC?HTI6xO-BaC3_ueDA)(e4kYTtM7SD?jZD=_E4O8#34J<3vUha{^hHo^U0J9D4_&
z<39#IPzp9ViN&B1lz{XCADj=TSST|URPw$f!_RZY%J37zQrVlRR`;yVpYoOVKGPeW
z>c12_)t^1TrF3FEY~)w;Abq7GCtuOgCr{K5T?(ix+scl7bi==WAg$xe?jxpCKO57&
z8Z|Vwx|=B~c?af;J7@Gayb?h5_BU`ZXxzL1M*WH~sw~ZodSR-nzk!3W5upy=QWr5S
zve9DARSe;i{Yn7!%U3Q7qFuxJ^!o)9mgxnHq7#;7y1@y_dBH4VMLHZP%5Fc)1n}LT
z)L7fp5@}I|%J3)YE1zEO<SGu1xaGMdYobd}9dL37jh)%PPQ{_&tkM`bF*&adH5O(x
zOSjhXHbmVNxGCW8JkvAc5l~(G&W?I7Y8#goOfQMA`JOJ2CLSYTV!v>n7Q{bdDtxMV
zKvV)IbwVh;em^Qg0p&}T$R(Nu6>gC68+CC3)T(xofe?x_N}Wp><&wJ32@KxTB=v0F
zBF5C^dLcw%>fG^6&<z9(J|j#*H_T;UJf!z{lK62h1ZLIV<qOxSSjCvjYg9niH`5sQ
zq#v{Yi9a$ECHf9!-&le=A|9RRDYpB4a`0Hk@wwWX!3A{fMM!mes<plk&nP2#uSs7-
zMde^XKkxXT9)HQ3C(SaD3diI3{k8lbyZsSYww76*N^C7F*7TS>9!89%GAtyInFFBi
z^}>Mfr2*g3;|zDSokFgz25I@%fL2Noc^kO^?c06)P}}y`+xEcPg}1f?5*;2<B6(%3
z;p3U9CI{W}rOU~rj|n%^rPEE0tu&h-bUce$k>E*uwnQqn(@1CrOVSRw^%fzEq|K}x
zP+XNhCt26u-(Ko)=^D#Df3ATb$?@Tv;Wd#Cm-^CgOb711TvWbXLTBjc%QcFTqQOWl
z>;yXe+UyGS<;ucH-E3#Blr!Q_Y{6w>I^?2Nj1Bvu2+}Hj2_(A0-`(<SSH;Ur7nN^$
zXI&LvvU5)6046{|j^h2~j2NNZ2Bk8fuG4=fYr`>)U6`z~T;TkTbF=_aK(4>XIXa)A
z7tV1S(}TqH6zoY!ZP@(u!C^-+J+I(`0cEHE=FYq0*twg|ND-VZaAp+X?7C@KOmoor
zx}fvraNIxv{8oUg_CVESzL}d?Ci`CVS-Zg5RN!o(Gjs%JkM2pG+ml*s+=q8z_NO<)
zYR^=vDthPhB&@M9Xf<j2l-%>-1{r4-4L7jfw0SZElLyk#n0>cFjDk#nYZo<eJz~}`
z%>75~2S(v$rCc;*8smb*xb&alB*vu?J`@2TQr<jzSGOM>2-do`d1PM&_q@Gki0*U5
z)sJFa<UG#Edr!*X%oz8iJez{7ym9sRxO!u7HtKJKUj1#*ql^DF$btrJA##S!V2iQ6
z8v4DOmBt`Z2b_K&*dl$eMr7mfK*1#pz!u*s&Zv0`Ci~YWVfEvfw@q+~Xt;#hrj3H%
zUhhus`SE&3UwvrqKQ@yy>6&sY<(oFV8#aX-XSiu&GXqndgoPx*8-SZ+eD|!piT=y!
z6CTLPvVzdmU3Lw0rm%+fP^0`v@Znc}J}@Z{>!Gk&QeJjdL!oCSa-*Ou#bswKy`<dS
zu&r((lP}f2*MCsr<Td(LZuqt58F%bP7<^qk?)~}kug5)o>t5sP2luXfRzKhr1%SD4
zvNEIfb9Ac;$C|6l#y>vaV&b|dTi@o(#a&fn9hn5t@6qs?adsMJs5*E}uf%+I&k|2E
zI&(I}lQ{UYXu-<P_valj7lM`3#p})d$JD4;x08`yLV)1ph2Y6H;eS#hCaC9kqnwzO
zPUM=)HGBU_Nx3zK?z_C!c`G)g#))ZHbo)SXcwKJ$AeOXQT%ua-G`-T8?4DH~0MrUN
zH_HRqdDymTk?oXY)N*e^et)9$4ORGl#g5tj_oqnD-=E&!#mLZrbaXK?c`;6nE1wE6
zsfCz-)Zl{3@b}}ZZ{kCQ-(jxNOMbbh#QTKj#WVL(9Rp!{$v02mfB5W-QH}vQxnh(D
z$^QbE6(!fDHwxRm$o9`~NhcS!Paf)p8)X<Cc;-2e+Mz`<j`PHFcP8WqN)crPSvyL<
zQrLI-XZ6CrBCIox#niJ}^|%`R#pDMDOAV}4Ir3iXO_;eTu9QFaU|{@F)@bj2O6~UE
zAGxZG96G1RNa{ZftFGlwS!8})cwL`sX{x=ajqa;2_L8c0<Qd&QX)eB+lQ-6Y`re%x
zSy$!7cU|P9kxg16|9%PBZp2dC&zCRhZYR8zJE6V8%f~#GDs1~fz^e{WX|t2*l#t(X
zZ~LqBk_}kjLF=6F`b1b(&s=r?Ts87PoSds}L|8{6tW}O?pAcb9vvbuS5Y~+0Xw5*+
ze8kLy@RotPGx|(|G5<9p?9KR`cOzmZ0x_d}bQHWq{tBM*2CDcu<RebD$#1wxcLbz%
z4we<>y87*GK!qN(L_gHnBt9}x3;S5kTd?NN<@fQvVe94x)O1{x&-C_MS(twST4!hc
zQ~q9in|rN=(xyWI8q?Ocdi$pu#Xd`?+atvB-sHD6xf^I*sA;Y%iTka)86Xr7-5#Ci
z6(uDLE~v?pl1&ME#kFE{X#+uH3u;uPWOG7ce5g3QW}|fCZQ)K^eTJ<?;OP3Gafr>-
zKu1leb}>ZA*@o2ZyROekr<$nz+!L);TRNIs;ZLg-Xg>ABC<D^9I&7j`xXWSe7TmSE
z5z@6Pg!e!H!jUV`F}s3eCca}j!DceSrjY{{!2z=@BwoA~&XA+^fx$IL>?`@Y>v5**
z@kN>N!5(!}SraCQqW)nHVUQ5#-TOxbku<v^k+p2`ge`)|$N`~Lf)dAognhgSFVmyO
z4I*J4^EQ;h7F=8LG<@eN`5fjiP`4KYm!SKXgYQzOP;A9>1}jlvm?MH74j33^&|=<1
z2BDEK$}JzM`B~AeKY~b@+}0o3V9^m%YTP#@%yWL0GB`+Li;t$Ajso}oWnHcqb2}Y1
z?tSDw#k|H-WQNFADcigrlllNf?M>iD0w_Id6RLSV^LdT)!6p=#ZP%<f!0{WRzA=yz
zr?LCn!6aCHWA&i7GFt>A5fdyehLKQxaeQxQoWo7JNEy7E(7<I_0I%Y3^Nqq>dAI*V
zO#|M!2%lPnHw}TKhrqC>nESFgj;?lAIh@neA_M<1Dclz+T!{^a?kT2kjnF~UE=_?;
zRMQA^C@+`B?d**Im9?Jb<xppgbPPz#6@!wg6;t(CI?4fQeQoEL!MV9$pgH?=OGmyC
zk%Ft%p5GgR#9UDL*LE!#9L`bmwk$teS15%XzkSXGa1Gj~91e|e)uhN_t&=qoTN*&B
ztJwb!00960G?@!L)8GHcH=A3CNG{2e+t*j+PL$213*oy;h_Z>?Lq%;gwv`CECx$2q
zrJ73h#W1Ci2_fY&i<w)^+}g0q|HJq9e>~3XoagI&&ilMSpYu4M$LH)ZdLu^1W4WJ}
zONxCJR3b~u^`*J%EZtRL8PE=WG$!w}3EQ9}W=Js0z>@_@S+(<nXN}p(C0d<;tjhJ<
z2_(XHQ;6!*aS#h92iSJ8cm+q;g$IM%c3CXj%f@FV!KEI^zj8q8PCo(J4*Xd&P(~ph
zFV0n-7W{|xfSiAYYJKlhy<XTNteLKQS!wdeJl$5VrqcVRyxy;y;B|%{7nQW!Qga<q
zfSH$^8(rVP?{BUn4)1{}-oQy|!~C-bRd!h{YTd!zJ_?6s$-mr#FU&&7wU=&%ryzG0
z59!zCPgf&S@P&YU@QNaHoT8|9E|(YMY-^hsXXB2v>ff1~QMf^a{e8r^`n<IhW$^7)
z@&l53N$<DB|3&Ueo>g8uaps}?)#p9Q&WsNZ1o;5Q2U(6tX_p1(yezIj0xnCCe=UYj
zA|RFwIb&9neZzs>poQQ9o>?K!%#N?7vhXv9$3e^MA48wQAe}Xf&%CK`D*f5A&TTu=
zcYiG*>BES5@l?gnxJdP_(S4jTmL9eZ?m!7>UYR@zf6^=UH3TY~x@~ROx>QyO)WzJv
z#av8B{b$a!wLx#R*3EHi&F$SJ`;(}c{{MK!enCSvb?Vtoe;qJPntE(j<(D>?=Oh6?
z1=+Cmgv=c3v0EV6N9wUBD!(3qcz;R2k3(SM)MMVnOg+XUFfT-KBi<YY>!KbD-?S<m
z6GdKu0wX|`r@C?@UKRxVKy3?Q1b}#|hMbpB++Gl@8eNkq&InNBosrwHb7Js+#9%67
zI1LD_5>=B4VN9s<4#?p&K(JtOcnKj>k}<I&^Jf8sI|PA|i5u3Js_(>5av&i67)t#z
zf22V;F-YkHA`-+<dPdb(<fMRbWeI}^w-JyR7)lnKR)(h|jXNd9ahAp9#0?&lCLsM8
zx#k>a5H3fVw*=+Kf`m8_C2hKbi0G!44pK`c8Ql#8k%yQlT#D0d%4t4oW&ZSbQ=H=j
zneuSKs}a!m9$xiT$BC#`eiW4-#Y+%Gap((Cd_ZfB6JrcO=jM0myZp*^tU(6-${ko=
z>0m5%{95W5n#ygN%6$$mb)Z#(mJE0a@mq{b-_t5XSnh<??J7%8a#s5lSnj0N(<=$_
ze;b#6rd5Wq+=;8F4VOY&aq7mUJ1BF%6PEnKFM0`HVAPxE?pKVh{Bsl2*mrI|PPG4_
z$QHUbrnWXFx9n5)C`pI`ikx5`B$)S{7VVxEfu==Nw{$$ASJZM;lx(?%piYY}sR>GR
zRuPT`qFj>5JtB;+^dFgt^o>Q8d8;x0@LdJSDYx_)zvY>W%QHjMeJ#^{zDM!)4tOo-
znvASK{LPaEF*`i*Ve^BB&7dB1jYFw@PcUd%?X6q78fQF2qWM7KL$pR0LFJg)xgvF=
z<G+lO{P5W?o2x7>P|#mSrhil{{-}W0(>#9}ZTpiCT6d{^vY>b|jM54Wo^eah_j8}n
z9jy4&skqvy)s7Bg8dU?G;MLAM{J?a6pq=oQ@~W!?Tq&!&_F@<<(Jh@sd1B%o^&h@)
zOZU!Md!{h^x?pYZn<pkRRo(uxugzDy?c(p{tz9gG@2u+nR;2#=XGe%7Lapl?^5_P>
zo$HuJEApBh2%<Ei$OTvxng0kPQUQtbm3f9xzH;M}g)I?b6tPzH`Ehc{I2p9yb*>ei
z*NX09RD7zAbD!`S>c=XxD!gJN<2<_E$nQs%XXh;~mfty%17~km6c&qSSN7t1PAe^;
z8@Dxdoa(zLnw49m?c}u3cP<0Ev}Z{Up1qm`NTRqM_hGe#er^HKy5#lfNk9RJ@72z$
zWY!S;`*ruB0rT>yRrC%2K6>Rr+;eV_PBXuO&woQNY6-?IhBsPufll{~nJZ-`3M(u=
zb`;qF${J_71*hiXgTIUvYfj&PR<N@V(r8GFaFJi$Pg?gi<~CelV_HV$U)7Bbuo6^g
zf){-wOSkH#hP!Ohh1Z*mttRJ5QD$7RP`0?5Q2i>A59oJzzxcAntk|0RRWL5Sp1KCG
z01ywjwiMpaHJgh1qQ|lK<fs3D!nX_G1}gEg_yR57y5k}@nK3W_V+<CC$4d!?Ju~x}
ziOq;t>+9N^WKcvsW{Jn|6$mbWy1{KT#o{l@&|&TzVFBP2D2TTb^O;vULRG+hVF*H5
zw5})69f2Q53Xc1|G=8@)kLqvA^*84JueRj+N3cKou|NJ3E%GW@Z@vaJh3n1lNA4bH
zG+Ra+WwTH@CYz1F8CTJCvlw#~tLySZqK&}OMwbiMmuRG-C8@n#sdXlqRMYe9p?l2m
z&i0W`#t$qB9`;(cr2pPR?vSaV{OtzTmGn1dNv!W-{@}?ZSPJ*lhx16&)fl;EhVKWX
z<rhCyYQlN9t`2fs{Dr#4qEk`ncxhVm1r|Dtg%(>f@}=dwusR(JjDlI69`73_K{#s&
z`UTNQlF|8`>ZQO@2I0gb`(6<4-&LmMzH*o^f3|@y?%&PJS^ccQG9;}Y&*MbuQXoDZ
z^90XXjGf`nT|LL=4nFW`#VH%3k4VpZwhT{t@UO+@B{WdB(D#$CH2R|UWs|qsHx*`+
zGm`FgA3^_K9{9C9Ff>!$GE@EhAGBlt;IxifcudY63mfN8>i2a5(*MbMc~rmSOaL-x
zA@8uj!zt$uS)*g{TVUkZ$x{+@uT5wC4Q|T$e|?i@`rYpD2!isYgwM&yjRtixvd8eV
zTus>s<J`%}?S`Mz|0qu$tt%V(%k%E(&wh_0j?_8(1iF9nyj#Rfy^;&q6aYhx)JX%)
zGsDkrasOel;pchNK(<fuOnmqbny-vmV^o?2X5ZNgZo~z4gdh8V^+k5X(8w@#WVo0`
z-%o2Cjb#7+Ix-y4<(p>O81;^HJ=vU_A=^ARq&0T+cTMBmko|o9wVs9-yErexlUIBP
zw+dc_OH$^B78)?VpOFV|l|J=uYWnV+FeELLa(`_u?S739y`y^ae%u?1l4s{Z-|9)<
zQ+>W#owt1{cfLOchKd`$^QBxFe(V+5;5YfUv;NAk8x;fLjIL#0vI32DQ8D3+1~4yD
zg=4G8D^XxvSLJE0tbEi2H6;`0d#PLy$JUc^U7CjiHF@FVU#bx10~yyXIE^42S%wFf
z#-XJ+@v^wmwKabjXsnIO4P~r@cyL3G0E$C^#>mZ0-{q-XGmb!=mjG%S6Xz443A>>@
zutb7geEek)0p`b$H0MA-e1bC1UMxX@0P9DiHJ}VhHJ-g3e>Vs*EtcRUhS)B~SAZbO
zo0<+lsq!WqM|GYSD4~4|-x!RLrOMBFxh8{o=Oq%(KsIax0hUe8Oavj`Q!}f`Mj0TE
zwk-d)L;{omdntxEPR$hKJZfp_b?R;zhfbV4a3Joke1_(L<gv{6ExnIk+<ergvmBt+
zlWDRX(5s>umD;p+tIZ_g=VjMs&H)LdLmA#^tcE_jjktap_XeYZ`n_w)>w4Qtb>jpl
zZ2sT50lIXG;IPymr8|PeHL(dORsg*&Nc^)V%~_MK9z-fG<x=@N3B=2a1*I2Q`W73u
zJZ;sWgMV6T$(_c(3&d<UMtr0pLs^xCRRhDNzE-}uF`^6YSDeJVQaI5Wx(oe}BhLDF
zs!_1cvYA#-xAC&stjrxVkU-WE@#tYGcslr5Pq*UoYmi_skY~r8gnQ`;o;wA5RRzyF
zrx8vpM53{XND@70qVm86A}S5vL&Jkuh%=;8ZPpZF)mkVvp`j|!*eNKsT(dS_v(E3u
z-|fN65{251qLcB&1#LS~_CrzCLy=SuzSaSO?CFLqFTFJ~{_??Ka0&N$g#w?9)BLBd
z1OtrCZ56sp{V7#lM*_E43R*|r5$LB2^r^yJ<#qA*3E&#^10&=8RLvjabnS)*-1bcz
z)cnz{xZ17Njt^oYs*Q{jB$x=Z#ZrsKQt)cGCsRdw^@v?U@1pppBRsK*J$T~flYq80
zQU9F=7B8nf!60!>w<5tgo_JZh3hh6eZ@%JUC&<ZL3oJ`et3rQ6`<+W_>+R$pi1S8d
zpf>PDTd$!aFHeEtrOH!Y5&xtNO1MQt_fp9qj-e;ROPc2)5dY)>O#Zh*^XFD_*ti#w
z=b^F?p2K@13oNl4kUkwqFA?2mQBw3`rfx=^<~CT2_T%T&r5}9pAy(UPC+2jr*%Ykx
zXy<dA;vctyZzQC?3_X3bzqSK&w8Gi@Q*Cyj>+9M(p{MSdL|p4+Qrynyg<O(5wKQ+;
z<n|gHe8H!Gw?)JTYm`?w%bn^AQY*Kfkiu$!GAHWVYpVhEp1V*u38??vg`r>3C%;_G
ziF>Os`=cPv(ot}Cx{9t!vWyD=hV0btE8j4kJ0BJQNQt}lpk&upJ<`!P)20!%)23Zl
zdIJml%Q|a+sQ6k(J29;tvZnl)*0PIzWsi=Q+{~WpX^#diYIrg=wYbaKpuUPsXu;8|
zI@H=;!0ZK#-iEQxfHIc@GNDjWgteld(BO}gU5`Sv&VzcmqTd=Pn^3%P>K9M;KE`Bp
zv9oz%X+I0L9IMh-)!hKhMgLgq{iUG*pFQR4nrk!fKcq3`dxc(77pl}8-w}Jvv%+od
zk8W_JNyN8W*P^<Pkvgps=C{6}$O6mgrCQQiWKrGuA=>Xk%O$6qlhP@Au?Gs7CcVt8
z>8eN0ni+brG3FhRUY$&fLZ&Vw7K}x8){;~zx+sStSOa}Qr~=ES`id^#=-#9-yIK$j
zcN73W0-sC;%&wZR;OuNm^WqZ9N?=t}m7!(`*P_+fAsV@|i*Fpk!nhTQ>nw_CwaXYU
zib<?)>piJ$L~WM|VTyxd!G?=B5-Gb~i^M~R_Db~y*_T+#%!a<+=(yh(q-7GZ;}x>#
z7PHpd$+d{%aepR&WGUnFQbx4K$3_pis@oV_T(-OLmuvAYZShI;4ra>hOWT9cy=Tq^
z7-<|5llpZ_&b8!#%(1^+7H??}Y+rq!?epzsjP<;tlE*%{lge`6wR)MO9N*d9_d~xb
z4fq~9Ir>=tX@g%`eW%4q<?Ngt(rV2|u>2j_k~6Mp2~CFYyD>+WmwdNjn+*Nqn+%Ur
z)5JJso59pHQ%;#W_9O_^FHR|dqV__uCK4!D&2qDS>YD^HlAxw}6IJvXAHmqmSF^sD
zhcZ5@VK2*34uFi<VkieOqitdoD8xuh{wryR+y*@)=7Siz&#3cy4B(U0Fko-fS55@J
zN%P;R^AZe917S>?IHn}V*OW-eJmeJYW6l9SPqykjTM%E<kdp(Y=zxr#Z2d~olcVTB
zjGhqlp$uJLs*5w@u>&FBpYfOpOjt(TAal+s5aq5iuMx^effC3G^$jY7u}<pz0CirR
z!L29c-=n%DgN(YUF4g&EkHOeb36u}SNRH}qmN<5dIuBuRdx`t|o_;x3U}+P5zHpKx
z(^tM>)=6o_To)EM*|@osG-f0pL)y{BPY6nA4oW~6H;;YhgZ+gdV?1GN49T;L4-OI%
zf;K$$BjwHolwM-2S`g}}=CtX)!c8(Wg3vn8kPuEZ7?dSH4rF}xr4GnA<zF~ytpa2O
z%(``caiH$<E3KYR)8$u-cKM;bo1`A+O+bCy(x_o?B-zusdAI4PjC9mLI~z4r8;d)q
zCv}$=wP>AYON*O9n^YJZ>xZI$rihu4K{P|gM#6LyF&$;Uvr$a7@kZygvhH%KR*#|S
za_WDXHb_102m#f*rBTtI4DB)W1|AK6qKH+IZrSDbdc@qyEv#>(_J@4T<g>jmy|%WX
zNH4waN!GijecGUJ-wh#uK70Q1kh-o+MTrBkM+G^xTbgyAm!We!iTULo=Zu`Ik25_S
zv%CVC9+SWwm1S>`#o|)}<*9P4g#$`1%j@+oiPJYn31O6-C*0=$!xy83*_^l)h1mg8
z+|}3zowXsG<ko0&f*ko6b+c*^G;7fh%vTOe3*!WwloOme4be;s`xnr0hJ_<x@B+hP
zGaqq-EI5TAN`*3ZpBPGpFt~+~sW58J@sXw6li2WAz~p_z!L49a5pmFx3fs2Jf-@vb
zc`Je1Nf>-9Ms}pmRVl?(IF~*!OE1Lk(nB3nB12l|{=Gez*E$#U3wnP>AK63Fi@)*3
zeD<TAFG{w5AdOgGqgpj*W1qkDleSBodLhhuE^zWMkgj{DH~Lr2$nlCD`nK++humQj
zq4Bm(b2kHLUkA>HclJwm_G7#&h_$Xav+RcmlA#bYCvIv+TyiaVKFhM_V7Z)MaxL*{
za;+9Ps_N@5k{*fOZr%}dtirkCpsAbbXm)7MOonUjzR{Ckj^;#bW9qe+=D)=pvlbae
ze<<6!H4PCIc&7j1`2~HGy|agtKQ^9vjL1HYzj1z{(yroES&`-r{5WvYcCQfnVI2A5
z{KD<KbJ<zv7o_CVj?rpD^lWD9=C+kIX!b@AY8zv0{qHwu>N0=>*f9uW^01X0|D=Sl
zN<#P-2;VQxH<9MQRA6M9aN1-!tg=TELRARf6@r%~AcDl{i3BS!!)^IffD(wFNVMvu
z7J)c=`x$P!oC+;!ktwG_f>(Ovm>k6b67`g5CC+erPA%HT2?9|_U`?+k%5)|2llerh
zN!M~mLC_`B3U6A6sy(Gnhkhs#8?8qlQHavA2^;SsVWZtB)(TOPy29W+!r<M)DeAcL
zVXKG*#OsfuXZwV~HM~;a9Z_1ucT!;b4dOdv>e<u`b*zj8-2oB>rk*`Re5b?M2gbTI
zzN0G=-d$kqv*6qVQ69@+4W%g_QXEfNN*<VgJf@#|)`a7!jx_|)KX0K}fTQH7XC+M@
z`yc5=w%z@v;qEh6@KxRac(|8qsCLRbX)StE$~%+RvuPQH*qwUxqe@Yb*5NZLqFc8`
z;<rV*HQ2yjx3hesiwn&mX(I8xLY4fFuzV^^9xOZn!H<BVv~9u|nP!|e3r-uDH{r>M
zkj9<`(JgDRlWS$AZ?R{A60z{sZ{h9!w0F6!!?zTo+FFOz#__<uUbyB;xvxjxdi&jL
z#VBO!Fl6Bmcp+I+QDDCC$Cc8kN7ual4zq23cM3*Ii%v|z7`MVyfT*pml$&~V@NG<u
z;=EJqL9vAltCT?%ASlC?@<@-q?KUQ6+q_N+W{Va*B?V*JI-CkTn!X<0S!o{HdeA!s
zVc%K`8b?k$h9d1$@i#v3lx*%Gz~}kWUaI(0Vt7+1FISfD458egt|B5jsHOeXQYZuI
zL&WGY?t`&YAZ&cE8)TkFJs7^>gH<^D6|wmW3}02O3WU-K1YyoIe9bxgL6kIQo;#Fp
z01}?A*?9u(T8wOIV!Knw>v!pc@mu~}Exq!4PVYD~MXOy&Ew;>_ZXeUXNk>bh+LfNS
zHz+Q?AW-Jqn0qoX;!Iz)Sg&-7;qLia2hHquZLN0gJBR$UFxz)oEJ|r-hA_9;X};Vu
zf3&>;ycpR+^KLGgt_=PXc_{i?pINX~fptS&&=+<Nma8y6O2T3sDY?^CDVX5#QHuq(
z9i<@;E5C;hxy}98nbI^}nZorOw>4kTw4)@aVRLj!wmTe3NzqpuN8Sb&Qc(%{wKbQ3
z&B?<e_t2GYb1BXg;zrDcaa)Up5<5y|8rH~};w80!a;4;J3Cn>*T>tS#^97V0B|i@v
zwTHg*Hh1d|L%G9Njb~=M((>qWFTd{GVc6)KmIqhFmMSpfRk1J#<u$O9-1Cfha}FFt
z$yCOo#po&ouH0Vw1K<|-(ewAwz0OjM&QQpm;{u(91g+L}lZAvNtV-`mrTMnj_0Vwv
z0gEtP5FVx=6y{+HQD@N0eXZ+e3&KJyem8yW2#%lw-<`+<>A|TAc;K~Zl{8)e7xF;6
z;nd@YNVoMN3rxSOs?KaJo7sW$rsS=;E3?LGp2;0A2F|A*E>XO3=vH>6Dl=u{@cO>p
z-F$JoU5Wn@cvhA?lnJ@1{ZS&e9Pg7l{S3KHj_H0FvSLt1yp$U9V9se_cS`&TsXz92
z;<H-l9x?sjB~AX=tFP~-!rN1A^J*%^{`41(v7D+a-|Ndf;deMZ6<*L%hI>0*jenJ;
zN2<JKj0|9fCdD3(>8JG-#1;mXNYMJ8(Il0YTBx{73cmG^%TqIK>SbBere}`jw<!2Z
zG?aBJq~M&SHvc!Ur@H~WEZKNbOMO+r4&Iu|4|Ncl@5Zm`E!GNwXAzof<9)R8>RE{2
z4ki1uE0cF4gPAiDu^8akxk2i&HoKAU_P~y}CyOmUJjr|l#K7-n%MWb&{mc(Ki|4i4
zlT8-SOT^0eo-Fm!_%x-QJhPPgfk7EJo{Rk$EVXJz;FF44a8<YWcH0@_lWwk>*%Tlk
zEqpaEW7vL@y!?51F-hKvmV5YE7w&)=>;*|)lJ(&^tyGuQEw&U4DdJ8q)lOGM2=@;2
zy(5-_TUg!o7vT<jVB2ospxUtWS=^16V%r^D;!(I*R%Xo}d`1>Rvb|KMBssC8^ybvV
zDPHWfwcyaQ#vyszsW?q_gOp5JEqG2!rg`i2l#D{2lOFt(5=^@Fm`_UPp7BQnUKPWz
z>TZ9zFx0t>EZh>d9WQQi9MG1g8|ss5Tf%C~;WmkDAr<hU6Z89Q!e$?l)<WFk%}>B0
z9>bHWGQqO}H+pgk&Fy0P9|p=M-!rkPy+iCV{iN*k={PgMF)K5W86dX^-&n|d*_i|F
zZDNZrJ(&|ys|W1h`|bAY_gp66G_+xr*_jaL#JTo17v=;I6wI8ETWs10D#^|qY;S`s
zE_gDPq*kF$j#k94J#K_caN>tm=&mpNb_Yrsu8vkG%O4hnAc3~xVbNb-dj^Q+F-j4k
z(|XP?-5lfC1?DlKCo{&o7dsH0ZPwFzM=a(I)zd;)xwJ>b3-Au=q()5c9%Y?B&e@;0
ztd~1oZBsdm?;5EzIFoX4YV6fw=oXLhFV^0;LjNbNyO#UtC9?Dq*Ug$nFL~Bzt46W4
z{xtj}@m=NN@yJ4bUF+X?xn|LlLH5PP;c|m)jhP=l6^~Os4Mzz%-#d}YUPWOr8~4c`
z(%(s2x35{o?{y3=)UfIEPx`{pf~@Pe00*4pFXqENq@bjKKo7|ww_4l!T>m{ysUTGv
zXddd@lUM$tZ;wYFP+9D{8GNlm0vYiI$0zTVEg33U<>h^Eac`&y<WL-LPARJ%BKI(2
z#U;884`ETg|8*SDPx89efPT}k?lHsm3K;b*TFh+<i{@&~MD}HsaIG-%s$cQO-&QRJ
zTiOwOslpPaQT^Y*a)r)D@6lCWvG&At_p(bM?2?HX?i?u^voD6b)B7@J-xcn;pKPBU
zm~LH6xA_0pftc<Ac8LtTWG;qV^nNsIXjD+KNpGlt8L>syUq@a1x~6ISePrpv*R|NU
z<ts~ng$fR(jxOy6nsA`Y256mp5Z$C&;cptLsQI)A<4H?LKW)~g`40QDG3_Jsgt{@U
z=w=8jA-PMCVaYw{$Ho-161)o5eH-e=@;0c!5->$|Q!dfnnbM<z^>S|qE>5j}Y8Ys?
zj4m0(bSL-Nj;YsA&Gp#AfWF{qA)XX%MV=k&Ol`RA(R||H;kQrGPHdDE8}(n^&PG*@
zHY$uX_RO%kw;IOYHLS;PQs@ssQ`acW34_mi*&`szj>5h>a3#0bBOde!z=>@6XAjpQ
zyXp}H;F?(s{;omv;FB9H;Q<*|Q>;NC8|mM*E5;!j@4ym5X##1|x{@(h{~{Y%TZaHg
z<HyapmG4JNhq?q$0D8%K;Vw=SJn0%qE3Z=tG>$RKd3Zg0UyM;%PvdO|?jEVpv}Zua
z*3q=xF-BLC*rK2>qaMAZF0aPfPnqoQ#D;305rJCWy4fXeFyN`9r7s&0eQcrZh=9~L
zS}KFVM`E~BUpL5095B(`Q#0(xYPgDXe~&iyv)GTBn}xxC?1?cNV57FMQL`~z6<|+T
z#BlS0Jz;T$d*vrPYzM|jA7do>|8+3NXpoKC%0{tcxLba*m9JsQS!|Tnh_Bp8<9il6
z@9U^xz{oDAPi&OIXyaF)gSlB4>^x5lxu1=aW}{XQVhpXG?})7TsOig%^l^*yk-L7r
z`sz2*z@=9S7NyV7&ynBANx3W4zWQ^6PDch4e<eQudB4Wu>BvX*114{hkgm^r^(($n
zQ=V9SQ*uXd<B&l-FB{!9FA(2QLYOBZR0fGYi}S;!`Ev>kv>Au&QI|#r^9E)4;d1<N
zknoK%&kD-l2@=ZbRfr_MxWs>$dfe0th`4lW?B6dg&+}-5Nyg|-+ThdH<#6JvPf(Mm
z8Cr%m=tClFv*rk^HlNQ^wqE-_xUhBIrtw452G#*`Va_>bk%O6Y9$P0?2sm49G&!3r
z$((!MZl$m&N5DY_z72!gt&A7t)K?|!np$q*9vyBnf&L!=00960G?xoJlkfY-9YYRt
zsDzw{5HgcuCOK@wh>EX-3KbQV!&Yq$Ar@f{<xDxJl1^e8vWgrtz7%8Daw<DGZ>Ii_
z-|zR|>v=xc`@XN|y6)%Rb?x=K$8&Zjf7Q}7wq9_MRpTA+bjH`7)7=*~cFA`51tBY9
zXx`t-^VTR@zQ^kNfvL(Mo_^}jqBD)SS75Tr5b589mFGp#w?_MNC!;NJ`Hcm3y<<;-
zTSoK3m6&SG)}hFH%z>=ZWzy59lZ{9D-mfNy4p*c-KQnaLulukc`bAbybiFyD_Hom0
zxo=m0I>h*`YLlK_>k6;`l|?%=UvyPlH(D)o`09m9xUTgAvE@Eu;gGFYQwNfELA`EV
zY9mI7Y%BDqe6Bhn;v#+AlCvm;BS~+_N#PKZ9CaC7iZJ|4)NniIAV*zwLr#d?xl?dk
z<d3b;U$|uA>H;CwIu|$ah<RJxg`9GH>HROYhLY@!etCvX!G^no!1t@C(o{DE6UMMf
z*l;)I`a9y3<)?Q4)B0$x+Ju~DLU#4TDgT3e*ux;{acJ7@7z++<$A;urPtmEqcFbiu
zNq8gNm}4u30|`wj3B`FuQQOxKa%@#MG=#{X#c>T{WGk_afF0yfp*VNoCD$RG_o^EK
zLgdk%I8EUxiS~6B`q#hdi*+C<%fe15b^$K>k6;*2+__N0N;}zTF=bZ32Aw096|k*(
z5%)3*d9fGBffiGs-gUnMO|2P;cwRz$vr$a6P`>8b842jJXuBXjjc4C2I4ilF*efVM
z2X~1Y?gc@X6AO9vXJZGy2;|M}#Ckz0Gv9h4C!-ELik;V977}h-$+~$~zHQ}rWh=ib
zMJI2u3*^d7amdoVz)X={`ue!SIX0iD`EM6Ubg9#uiIC(e9F3)DefIJ}ln1XXEWeOz
zTT6u-<Hh=2G<l0pp=a%k8Z~7*VsjfcEyq5mW~gp@eu_OAWVdrH^K_%8?(fe+n~i68
zs++dV8?Nm2c=UN?*Daaq!Jy}cEAPZ&VPYHCcf?KzX&P9E(LbwfT$dFb7P1Q$kG&IL
zCK+#VulhqvU23?|^P*uhn8Fp^?tu02F#qD*VvoDSEr;i8qpu%|WJ_+it$=)QBH}MT
z9w6ANj2FyBRt_B*o3=sN;AYRJu=lY!CDi|7abyY`(b&0Ofd_0eV8^B_EWX-(kJ;#V
ztuG#+%T3*E?!-*K?ZlJ<Q&eCGq=}$S+caP{`a6N)?4Q+-z0F0L_XED%BXP&(LZ-vV
z8^882Sv_>t|MWMj=R56T2kl`Ai>xz&|Hxt)57B&*Nb_TJyNgH-E||c+^8c7O&6`I5
zz20p;8KL>SAvN3~HCWT|wvntEYp1s0kF<Yk=I&m@sHc%4vPco}|F17d5tlGiLYS#*
z%{HT&=V|JKrjN9lG60~IcWUq`D1MCA9InKYQ-v_XsSWW0hnOaw#9}zLmUdM&kAyA)
zo(`-ep>u9Dg+{)!@p;?ZtOjzL{ZhIcLwz)N=13CBB;|2p>=#<KXY=^$P)w2Y&v2?U
z>rmeitr`W)G*2u_VQ$A@ZV%B)uUYN8cL;xgwN^#il4%)#$olj52<cb5QN|ltdei&k
z<=XGWL0*#DVxwSe0^_-%?a{%bT4IV???^UPXC`RC$B-qybJzak<Zqo@@A{VE?9!Y+
z-_CuxQMy%vxiH(y`b3TT9Mtl|oW@OMVV|(DUKrS8o6=`2vBn|)bk@DKjWx|V(@!x@
zx3QFAf46VDude2_*rtYqs>c)O*61y^mEoYr<DK4^V}m8fM@!_R4btmKdx6LJ`&(>1
zn`(;wqt)X%^J~E^wuEqxQ%yC)i>RpE-xu6fZD>(bwTPE-kBb)7R*`ZodH4!%yE>aA
zUrUPT-QA-MW?OPxY25@C^KHwCc-F2K)~;F`@j3lXXSAjh#$~u<2u(Be#JHd_F4Z=A
z)ROEu_qqjl!{{1t%LyR8I*>jv8Bw^MzMjJop^5LJ1-LaSe_i|-bz6ZJaHi?u@S;=H
z?QaY2(k;}57V2Zx>vEFN*Aj1PiClC|<Oz)RaEUv$BxBzFb5xCP3$?C=ilWV@vZCI$
zSbTK1@>f{t5_m+t+HDVt7<~3r^7K|^c*NuJqWLxbmiNu!5q0B5b8Bx$O2nfsevQ6p
zPxC!$<*NY2@1ps7V!YQ`m&~`afBdbT>;DpUF{I^{BF*;{&9{p6)Dh$DM>}%9rs%ok
zEvCSr<=egT6wsWvx7f2-uO`sf#m=Zrc^dpoQ|9oZL)7NjLce%R<a|ryBi5PnqNkFD
z@O$Bb!;8PFx3zwLEu;ls5FYq=+-GFbIC@i&Mt<9}^}pP_|K_&)|J-(87YCv?m1uv?
zG_?&cdPHrGFZ4^dEHAVyKW4R-7d?}l8Ht*8pz$VJh!at+cmHa(5hnx*t;7lF7qxD5
z#XI7}YeTE-BD)S?l(RkhHi2Y$YQ?<c-8tJ4cc;iya*xQw_d92`?~>#@{8Oh*9j_@f
z-bte-k|kNk-oBF-Wqq(_eMlu8q+gJ}lWaNRB#%*8zou+I;RKy<+RM_B!6@7zrQRc@
zQv8$Xrsva0`Ijf+(hda%khT7q@TW1@imk4DC&$wGrX9G4*T8$ouKC)h9Q}_?o(lRt
z=5JZ8!hT|oW;|D=KIr*`5!#R&#7mS%P&vHoHv@IF+eOKOAHrBI5l|FpTZiK%AoK(o
ztd_7wtq3T$T~vy5)Q_$gBvlMI?5G&F6Y1B;qkF0*7!SC-uy&zWNpXf`u%RNYP>F!k
zB4+6Lhi}CLcEmsYn()w`9wLAE=0A7lD}~I`+Iw0gS`Ubr)eD>T#6Jva?@^?OoT7*5
zabAjHef{V^f&6B-;{ImFQ%|vXN}lmsd)^-Jqt$MFkiJ`zvvVI-T&h(>IG|$>)=4P9
zQzAei!N-w)g+_Y3qg7F)fjKi0qSxB;w9?<-`@GM?yfI*SBia}BzU3*n!PJ;o-{bNY
zm<}>5HpBVw5Fh5hU{39NZi4p-`B1MoeX4--#1VVSwDrlZfIP{DFymHL$%bm_hPxl?
zA6<L9=8skiP*3*3G$i?aRt)ero*wa)YUp>tMtgmzuLo8=Fg=2jY6$oHaQU<1;lR!3
z%fKE!vRi;XY(4LZAJuFB1))bvaa#6a{iRw>g#$+SU~Pp0JR|}@38N15D?C!^j#jux
z1N(whL#AFU+55w<SBe2;c^rOa(x{Is7VrDvSB_%9)Y~Mh^r~z8+_Ra^f02i8yS+dJ
z?RpL~7+ct%Y^DD}&0_jKf%EAMHpsBmTw!v|8>=Kg>8Ly@mTYA|&9v{R&e4JGO_m_}
zd`N6elDMn~%g^JS_5P5Ek^*_VVqYAX?x;+X7=OU2ZWQZ}qx0r9g=^Y4hvhfo;uzhj
z?dme`I)zef@NRxDyBcoTTQ$4P(d(1s0HXz%qK8LrLLGwoezRB1<N8@E=6wY9yhjz-
zed(b=nTh6o8;AE&!5R`jzPjDsmyU?sgN;<gMjBrWoYNPL=ogJJ6^(Egi3nH5O3Sn+
zr?vZW+Wqp|>yIK-u+kb>X+RaR(v}?gJy=O87{$nzOdj;`=Ew(hI0TD>w0FZOGh7=D
z6LanZQ^kmGrHD|)hMnpm43nD-6F^Z6lM#wvBgKzM@$;o@l^200?<qy-5t?);e%}-#
z?k6<GC}1yZU@t3Sqv!UEM)ZkBn21K8MIxT<n7k`Kc~@-mlMZWEVhhYYRE$+awaRKw
ze#*f5xwSq^ql_<6#tSKzk0J`Nex+DHK(n!amfV;F+!!!7X3zDwIekLY56U=-u_(!n
ziJ>@{bB-$~q%5^Npy`&6Dr8`}5*kLLAiac?Ckag#6PgSXnwnBKC63vlT5Sy`0~8}X
zQk$A|Cxw;RbRDi7j4P+lJw52DKbc@KX%8rP(jE;<*VAxT1iex;(~#T>W}Jg@4;Ene
zqF}wI+>CrILYaVJ5-?E0XhH^rn*rl)E0~)R#whuRQG#TYJbkPvL<{zur=+<U_@1;T
zJ|60RUYis|pEeZ%%_gK2wf{N>RN*iPc4mi$y9mffl-(=Bb`xP=xtcAR^km2v9zXoL
zQ6j7G0#2wdR1u_Qd6h4UwADGdB&ke9aJqEen5&N}(qVTH8rr&<T0}%G5p#}+(I#T9
zJIjSsNfTP7Gh5TrTLDP(XZo8jJvY^1f6--!=|l*rhcNwbGW`KXG5trnbbXmb@Dj2<
zOJc`SJKrwdo7$PV$*}BQOGwf&jbs9%840^*pb?@NAqmvp6UN<NfZc_Hxu9FsTw8&%
z6<KhP&KW4NKPj>GmDtXT><bUE7`IkZ8ilk>Ar(>7?13U;O0gI~v#}UUuEqhb2AHeS
zPf08<b8D6GXiWhW)tchZ_?nM>okpp+$@r?z{REUlqfaUG0RfRisTiT$eo48VO}TwK
zCr@im-@w?G7hF|S{B#AJlUEv(lNYcTYo?sA&PZ5?Bv=6z;RL`q0f2%z0b%s_zV!Df
z`g;?GeZruJBD;^U{(y2@iSd3hb-jbK`3~6%@@UOO!S-5zp=@#}n_ZO6EXrmrVLgPf
zu18pZqiCkG-2nKT415R!k7D2#71=3-^++Ptt`uvRvyr*oIGF~M9)N-;J<zRouB||y
zwOQIkMO_kB|M~lcU77mY!&jYuf@8*}!eb5#>1xt-mV{wT!um_qgPzXtcm(_?ppNjP
z_i<WjI4uIMoB%5&OelOmB4eE<p;mZk?W_Ye9drnaW^~-GM#sH)^jRw%pOrQy!5xz*
z7>m1;0a>$$t=R(#Ub7GTo#^{J5%oI}{rh^M_G(AQYet#%n4qZ3F8al)Ta)!*?g_yO
z37Z?g3P2sbDet;)k^{KZ?g?S_kQoQ;j6?8@19HY;xHsixZ%TG=%IT3R-+vBA<&K2x
zZ!mQTiB@rW(sP`&0FlwvoY7f22U|L)zjR@H7wHJN8=#JGxBIxmX}H4#+&hb<{zu!c
zVg&pQppNhf(<OzyJfMX$>BP)~M5~kx$dUqVNdZvsl0q00=tW%=Q`ZimAqRA+?oFm{
z$bTjlbu^QSnKu-8`!#s`m2OJU?Ju1S{XRyuL0iDps8B);rtr|u`4Wu^UuFf0SyA#4
zw$rHRl2<Qc`8@pep5?EV`I&ExXMzqco0~#3J1sPWARwSimd#<y=755i&BJDbd}o4C
zGeIUZCf}oyGqQRA^y8ie!yg>fy!;ur&l%qD#QcF}{%~WO06#n2zD!&(pafj8Di6Dd
zhgIZZf8CPI$}|{t_`zEp#NM=pmYxCKZz5?F#uGfQ5jVt2H^g$V#&i3X%G#C6w3Nz@
zDwdV&!-;xuA{hP^{0IFH7I|q_e$IGu?A-S;H5)eza$_fyU=@>pXzRYZM$W-il&M!4
z<wRMqSA?v3$U+WwAt!ht2f2_lJZ$i4*dS-vz^_UVR%siRTNMH^Gsy`FEpT(`2__9e
z#C6LUI!lJIB}4tCL)+CzM!=l_b%Z<J#~G#Jj0m_VyN}3~pFlBB++>~zVQ#~sPT5_e
zN2CG|s=<RQ-SnH=uUqy>w@hER%vq<b+8JKr1TVRAwY2~3ArFI}IBT<6YRHi?_b<Ga
zy*~w0FW%g|`{VK~O7hnrFHSb@@6^S^f3Dj0?c-CD;n$}Lv(<(H%(nVymdt%Zv8L&a
z-Sox7i~&Atq3k+lb>JPT(Dp3z;#JJ5o7hEFcmz9|^<0jyu-ARfdmswj@z+>t%FmW+
z-Kn4Sc5p#&VAIXQZ1>H+lNg_YTvGkTY}$y$Re<mPWQF~SC;k;w&_-6IbYB6P<222)
zh1-H&eZyQiWO(`2Pu9XWCL;Tr0JxWcdz)kIvU}}=BG2r4bELJlPk~fFo0T?oM8Lpg
zv~H9*n8wc5Dz`=Y(j!syNFcl!%xQ*knjxHRh)EdeY@cnG#A$$VrDOiKnPTuv3Ao1&
zH~=29IJh(pE`@`C^S3RN(OKqcK?3D;mb<keQ>?<X!usTPCx$eZAx&W|h=aM}Fs?X+
zyA5FsX<vpkiXjcGmYlS4%pLa#OwN)IyoA6h>>zhJ(bKT>G$6<c%yEKooFJTS2&1R@
z($i4%v~JeI$E1z(?zl!UIbS~T3IZpkPo_9AT(JySAV?3))q`>MAlz*TW4QV<Tu}^H
zV5O?04KH_G9hjUe9~g$fsq7&4I?;Qu^d2B61k4G6aY7)RZ3v_H_|kh&^d4ZPpGg}x
z+;Poda<P11I07fGPyXP<Fvc>BfuP-B?rs=&H-x(lVGLtmhB1m^3<TwYxp^>d9)!CM
zF@%N>6rW}!Znp<6Z_NMwJuvy60og^L41fz7XX%QwMB&~{_`fgQl{eB_`}BcRh^3)X
z{o=hZsxr9yY3-w&_R&<@$Ymt`GM0Whn7$3e?V~T-N3#J19NmTer^(f?yr0iM)w^tc
zdGX(<f6p<0opB^*Ajs~&p9dgx0zc~p8t4WBP~%K4bt0EKl1mq#2YBcN4(JA&=>`H2
zq0HNnj!R7Ivf^}E0n4c&nQB<3S}=1PhP$j@c3EWu7vMl?PjyN2oPB}OG4j{vSrH#7
zR>1C*Ja9R{?g(Hq!GMg?Cj)>&<1Acp7ATy>H~;qqU~+*0*;k(oz&BH_N&dzjWkSR>
zAp&T}rYuSmhtkwV*@jv|L<j*mZ$;<<j%-TP5~b-2WgEWhk!6*pW^}k$Vce_dF{_8N
zHx89<94gq@221YZ0q!E0yLbb$8UykD)^A`u{xdklrr_z7rlP06+uJekBykcTTng}x
ziDKkL39`cuG5`*;I0I>%ffUXFc*h+1scr&0mx57b*es^9KTt5h#*{s94}qXGFgeYD
z?5a-&z!i<Na>ZGpa8^K25tv+LK=#uo12AsNwawqqP$saa32b0v>sgd_4rRTIvJJHa
zb_jv32Pojk{x%%|x0x`$m~y-O_q7Jv?`xXQ<N+t<CYHGgv=$z`goiERAxqm3#@zH}
zZlai*Z)hW%KznWBFsrf6q+52t>QmvERpIol__Q$)XAA@sP6GK`0{dGc`1dvpkAYr}
zfwIRyLx7|EZfhdWVbZ=?o2~UN3o{t*Fsa=u$V%%4aeF}o+DHm=CIvf_5<IgF!@Zza
zy`UUG0S7AjNN;`5IbVOdoP`@>&s+9&bY;Fv6-Z_ZQpf!9Nsh5eh*(GGSO6UF3-+f8
z_7epA$NllSj<LCj*ptq&01TTh1?}aTD-$(;5H*!Z^_j%3Om0_Zch@%55j8IoH4Oj-
z964Q?%Uzj0UE4736f2@@H?6az1Y1%9N-p)%b6#w!HtJaTNo)H<MkU9sj7oxuWnf}i
zC8^#c`+RJ+@^a40{4(%IL8ZUBU2;L$4I<C5lxNsT;_vDf>>3c{_6h*VE#!qh;Du)M
zLf?}3&~vec7Ir2DW%|7y<K}jW#IoxOJQWR|3J@ei5XfW-($fV1q^t6L_walbdA=`6
z`~%Gz);$d={a=1Pdd0jo_ms9ec*IRmoJJYoQU-u8a~8>%#WH4t8QU;S8F)n*$N>~j
zo|Rf!-p9L15WwtXC*^qJ>4H0HU1ppvvs64;8Oc<}GL?gw+c4Z^_Oi<?8&JT3Vk+Nc
zDu*z)VNs_oi5LhR8uT=HdW{3?iUfgTrXV|A06?}XFJuod<mJFRWPJ8^!LA2AtuM|z
zNd5^iJn-=9IxnCDPxd)Gy0{y7VCV1U_d3ATxlLTdATT|h>az-%>t*ay6SF-5Z(>dX
z8Du;BBQKV*EhlDgqk-Xl*7EyLYrKFUAf^tuyYb}FF8I{tx0|>K%8fF!xY6$oe=n7p
z;lF)HPt0ykH9h<Jkv)c9Qz!9$+N?E2MpBFKG_*b{6WpUQ0~?E$jAL?eAH%=Lehi=X
z`MoE;&53-ziEbR@3QROMjG6FvlVlOC&*DCY|M2OB;$mNJJj@vy_Va4H`bB>$gVw<w
zQ^$~lFdUm0#AXJKH;y^r9A^e&W5#@bX8^IfZRasvKEL}PHtf}T-;*^Nf@BvC$Q$@c
zKD|eau2gbo#}ZTu+dAWZ`KM%VG)-D+qA<5WC6l6->#5Y+^p(=6TbW1RBT6PybSFnk
zCJ{B&+7Ms28t+Q4Uc5!|i6@|}1yM{b{OA)9^a<$jh{W9|uuaguNyr<C8Cc{qkPKR$
z)9!gx5=-Cz_!7SBH9YvV=4rhV34V7rKkMOe%F9YPSa0>wRTMtyq^58&B56UloR9Rv
zQ)=OlPil55X#P5>sXOxdWhEbJn)xQ1FIED-{&`+0itiZ7PqM+E&pW9(hjLj^dQ%A;
zw^pSL>pX_D`MKKoFIn(6Su=NH73WW6tkgO3bG7hcX)9Kae6=jzeXT9otUvn1KcBMx
zI1}NCx^OBH?oc@Z9y&Ah#X@#I(vd%*UOAvJ9|>^AN^>$)c?FCtt4Ef(Rt`uF%^D3U
z%gjsPT}e(JR_3EB%?=MKE6z*bSxGh-no^i&ADzM6S-~9TlN|Xr4tyIYzGB9P7lN-y
zB<CXWRe29phkR03@@$ZS+Cx47@0&N4t}_D`2&_W}qAD9ChkT5NMrGzN-(7jLdKol<
zTq`^v^L|F!q2cF;!OJfXu2_HiAaArKn)gTe!XGV{zd}`U$f~%5RdL6wBIv0RQB@Jg
z>q0jK{KhszJ+~>`&EsMR@o8>TEuAYS5PZEkzNdivrXNzwYnrJCE8ear_y2x|EBWTP
zWc{isFyP`{_bKxlc0Lv3ZQdul6>N_GoHlRc>o!F^&+mVm|A*lAR}31bSRE%qwbP^8
zsZi|<sq5D$>(<ouu9f!(s+;v5te-aDig&SlSFs{$v{i1n)t(po;$CR@9O~Y@#GCxs
ztdA?AhSi$G=lMkKt*)%t*I9gfJHm=Cg72xbg#^Y<d}W<2=`Mj&)*o@?-)!XH^T@xC
zk#-#lcJoL(?I91vy0X_xDEmTAVEk~{HNtR|%bmZ<2;e-ZZP^!aZ4#a17^b?ra>hd*
z_-Bno7u|tQ`-s(r<|5HSH(DG1eN9l9dflin1^tm4QAkOR_<qG%kQA8cb+L2m?|MU(
z7j=&^zub!o&MS0&44rP9PW|hhS7>*yZaA!6098P$zhTM)VoBRbEjuU&x&K3sdbkUk
z@d+w-QT4NR&$XE!SwK=FT{2H;9~Ygomy0ffFbvXria&+8|FACEVUL)HnqpLatna%P
ze|i(mm$ly7F^qF4jumxpBf7Vpb8ma({-Z<T$GrQGM^r2&G>fU|5vi(K@(J@f6c?o$
z7^zxjbDtfhD&|k1ZakrG429wtQ1Sv)II=MQ2>Prn|IeU@48QumEWcVs0#60+z*8?+
z%ozyw6vRqjBI~)eiC0g#R8K*wr@X2)t~r8A>LehmS&8H}3geM1U&=G|7$#TWu}aFa
zN~(D%>ECiT$hNz@?6~@h(ieL>ZIu<JCy8VOhlTE}Tc<xlXKXvF(R)sK1i0CTn6H9A
z4pZOe>mREkw7cm%hAQkwgY)#yyC`{95vEfK(NzS`(DS}-TcTADD5uTQcieK`bwZ^e
z=*Q;h4+Z*-+pP$Gny>Gf7OLp$mXme9(9xtCRY0xm4fW~?<uV36t<hgf^z+<v6l+jd
zOY|LTx{snE45-Rsw0?<xkb912P4{$acXUnn*U%gDud&y=^_pj(;@0Tt4C<~qXfnW<
z!VlXOI&rYZ@MMi)C3P1ibmvH@%M4U6vT#Us#r3G&k+~XXVyp{bz<?RIx7!Uti(m3m
zsIH3-HR^`$4l29{LCYfCo>`#pyPfE<Z%d+NpH^F;mJdN$`_YLm)JrbZYgM67?c2mw
zfDEe9gC4pPThQP^j|w?{fJ~jT!$OF*Y<#R@oibuUk9bR=GT<$esx$QZsJ@AP;hwDO
zJR}uT8EQBbb&V2bJrtD+Epb%UdR9rzszy}K)9ed1h}EN6)w4*dA5yg3z`iiRsW3nX
z?U7aOL%eVnX>qVp<*9;QJIMNrf}N-)*P;tBDqM@Pj13jfQ0Id=#QlAeE*36TDg{I7
zCqwlQpV#*f)jwH?%GeMNK4O$}h;h-mx`1}BP^I9)zxfwt+${Vqs`TS70Q24mLGKO9
zfSa?RcOjMCSA5H&X42bSHYxUH{;lQn3npoGR)*D+Z$Cn%A$=m3UdmVd#)t0dhDrw&
zCPVsmB6^=#^xboN_2s<F^Rky=AE9bSeKQ$DS8Aa})lfB`!ak$wgu$F$)GJ};efnvk
zhrHZg)qRB8I24v>_l4tkVAmdo?rQp7a44pyH1w0-8qhi+1FwI+J;zsvY{?Dc5c#nZ
zZf!YkZ9#5r6>gF33XyYeky<CH@&&u{UrKN73)D~(Iv%MrT+BM!M>rlCc0BS%?U83{
zAkM@r)G{#m0kt^9-Lj@rb0E$g5qtelr1ehYllZ--G@VC2qbz4EsBRUN3!Qa*<P&((
zlT4G5Ge}G2_HL)z8IdQ=;E^-wVWuu4${BO@Csv)Fkdwl$9~<$hC{(MPiAf0yuPpSd
zC@ebBw^+Gz7H(Bh==XmB00960Y<YP!RR90KElXLV5D^iDl)=cJ-56sq#?V-*AvJ>%
zBT=?wU*7i2SVCquC`OsmVktY#HI$;1FykHXGTudR-rwo{IlupY=RCH1?>Ucq&ONVl
zUiUsPi5P?!^`b7KXj>q9N&)>Y*tKx8*$U97P*ZN^@sA2EJdc0T#&t9Uv7T0K>w-H}
zOmv5i_BJgxAhzdocG$?&a{fsQHGKg(bhf&2(UqDwn@&`1Smf3(e(_mHUsM~r8EWA=
z%7FW>4;kP>P5&1`l+7yOCY+K!;cGqms&=sqzOG2wjH+F9r))ZUrF=3!Z8>_fcJU&7
z-H)>CW6mx-W!D5&^i%o%NiiaDYq_J|2EL~exFyW*v5pkLVHsMZf~-|3hwo9M?DD5%
zRsl{U*uyIbL+PzSPny#|2zv38azmFBq}^{rp~`OLOi{1%Jsl<{#>WXN5wJaeWY>>5
zu6VL*F;+3rz%^z1WMc?a*_Grv>x<rBp~5X!`2x*H-$6J|lm$bT{ZEqehCFGF3kW(j
z$-uwhu<^@cmG(UB$kBa7i!-qNZx}R81;8{_sk9rD`+c!jP5f$(8OuZSJxTop&L<>R
z#u6hFf|Ws{om2pA1kCeNzqtrO@=@<^y#y1t1VmPj_YxG&^_x2wlSLm?Nfu+&>s0`U
zMe|}SIlQ&pts)LqJ3;+et)vnqy%U}>f!#}$(Sc_?#}?z&`)VY8DSGocdhry!*I18F
z<>f#r5kM?=l-s~P8vukbzsDL-0Bzwjt3=dRmcl(1DI_F?L;yG=SZw5kLRL!b#K}>q
zZH~~qB)2)887XSvXvvB4!?0lyz_b*r_Oe6v0$Qag5Ooo)La40BNNMXspbiR#8#uA6
z$BeU~!&vC>RnnJc$I}OrN*$loSTElx%Sf>@UB2Tdwf$Wdo0!${WK;I4rm?P5PebeV
zH3l|pEg3xeb1nclGWQEN^Zkv(_MwIpg{Y@TeV$2CKX_6<m{C9YQI$XDDC4Qhd+FF5
z*r9!NGe0c(R;P)-;(ZieD$=zN?c0kk31ePrD_uYPy2N!6^|}Tt-`Qx;aIU`bMXscw
zb)MllBT!q#fj7{pr8KD)qFYxUI=8hERmz}N3>f0{-uX{z6|X3yElKrkNPXPOSlAN(
zye0kxtyUCxW(lp<g{ovw<-do^0N%7_|GkmQ32i9HW`FZ$f6FPuDMQ1$Uxrc2tUPue
z+O?$-b(lf*pY)%k7vTKeSoF>Pe-cI(6-;-x_&>Al7bhnFbvKAR(U*GJ-^_M7m~nU-
zmqt;aN6S4zl?5|EE!<<%{Fpwz^)!EgYwkkcAIwCOYWNX8r0_`Xx9Y3K%=GZcOW~0*
z55Tf#aP?V)#=JjqRqdm1r(*UyNP%U2@jku2!RLd@?lTA9Om)=FWsG-NFhB9^$c1*@
zugpIKH(+Jglm5WACnkCKpf7c*NYh<Mro`G=O>fa7QO3AV3yu4ompd(pOyj$AK*7|T
znHexjQzGb<W?TH;C{4L2P5I8E4Z)$Sf3Fl%epI=A;n^*E|0S&Vu<d@;Vc@;y5qJm7
z9PXH6*-P5Wy*D4)bO^E6q8crU#}D4DZ~1z&{t$*Kh36|aZ-_+N<+2X-qW{1!72KO!
z!<c^rt_*Lcc_2$^t)o)v^<2r-!00s8!Aq!vF$}rpO_91^l2P^(4z&vA#p~&k;s1-_
z$b+VIxmskHz3Z$wlrCq*%__w?JFyy!xo!}a;&ZGE)k2J3c!cX#fYXJtKpOY&!&x9i
zG>m#pz5=5jiLBP<>aY4l-$GVjLRQDny=sv2?@ygaR#TDH5W1H%SKp9(&JA4UE4Kp!
zYa~JGFKTdYP3kbJ<U7Q+B5g-HCglh+Rf2vRN<VE%KaHS!&F6T<)4fV?er^>=E?J#>
zx0vs}>a#6F+iCLM&h^{onQ>#5J*hiQh;0wVcCOF12Z?_UsaZhpwF=2}x2r~3g~b2G
zqdUU`G{f2aw%Qg8XU3=l+zi7~3yjuhT7;pheHo+kIivB6(bu>*(~v@pU)tgfp0x`T
zJug3{lEcc(V(of0(_<CV-~Qp2S3nRI;Ht#3XKum%i+jo7+gQ2#Q$f`>-sq91vEAU?
ztq-#XHm3GIm{Z3*o|{qX>XfiGmYJ@6&LS<$lwOVY=<2+s+sWzbbZTKPBr(kV2FVqj
zb2IAQo!4GPMha%o>odd~(b3F@L+c-i%!i$*>7bzDjj5^dZWfC@H<Ohf-TS=rzP;3w
z`d;%Pg2O@keV24EibW5=>I=WZ>WyQg_gtS*YKcyd3>st^f1as~jh1qcqQpgK2frI6
z2p0qqOBt1LQjDb91Ud^f3tS#1$BGcUzUurIrj4wXxh*U`Mv%EpH%tG!0C&TU)m?@Q
zln|67-^J0t>T&<Rjk^&<*DS_Kr2*+aUqz5M5W408u6#M}fCdOgQO`p5N^{$!4fJ96
zW)x}H@Yy)`rWxORGbMgsmz#DkJ=MK8<4c<HMSO)&uOVsIFi4yJCS3ea_QrI{RUM~B
zotf>GYK_AUwa&3sSw9=jM+E=;H$kfEU*p7g1C~=-Js<R!ShYW&be7djU(;Eifp@OY
z#4KpYKkAWLiutH<!YbQrY`#41q9x{HZQR9$_h-f;nGik3*vu0PF+2B1pRI&?sZMvI
z{jr0NMyM=AqI%1X>i0p~YNJqFXz~1anS`~Tp*Yo*vYxPcuY1SGL#`*T>I}!JBI+K$
zsa$GV?lM~DLv0gwjfaqyT1Mgm_*P0q2WU5nT*gZt*tRE#Ri!`^i=4)MS7Uyw`qHt`
zx_iyv3zqEjDwdA1Y~2UHYq$=@m80t(gXpsdxR<9?dfO@|d@qCkeEIOewXz`D$0f#D
zvr)qAPMdw<m7v42fqXqdx^@xq*pFuSF~<&1v-80zboHAwlLVa4!wH)8Zn~3~68=*;
zoO!l-bnOMp_197P=R4T_Cg{tc0{tM_dtBozI|5KQg7u~VG0Vql|6YLKfKu#ofx1rk
zjRqjJo~(LxW>3xErSKadN;egli|LzV19QtAr>;V$x|1T|zv=<|Rm-m#@L!kUzhWrK
zHSpdBqpLIS@iXq$U!80I_O1Q<0{oXLC3!Uar~dI^7;0<iPFc0Z-?6bk!O5eiygq$d
zAdh}{i96jfqp%>*Mg2<Wrf_hlBUoCj8Lgr>XCKaJF^O3N`!7|DU;Jfsau?K6q+34b
z)ryF~+F{)~?S|&LC#Is}8fPxVijQ<HMo3kOYVDUbvG;u;;tuNn(;?!TwwcYumiAv9
zIB<-@5Z}bd*VnYj9|5@OodDNS`r6*V)Lfp+i?wAOdE+Sir}pk^CK^}U<gc0B(mYOK
z==<hIv{{5`-a=<Tx)(2v(`>|Q_ORsdlNr}nv)g$5z42^o7kEH+@&97EujUX{o|Ph&
zAEn6=We<^VHQc0~qXruufL89#nmM5?>&)nN7&F1d9|+XcXUd16vV9r7^EtiojNaG$
zm@ecwSHn@+>B`-1+Ea?F=QPs;-7f{Y$299U-+kWqR_n!-s2g=fM0dgZx%2~h6Q>ZV
z1A`q!;b?cXmU!y@gC4tAAfbWoLp|1|`=?4eGvoJTG<V_M6r1mftQ^aY-`{JUhtZUC
z*I<Te76!Tx_druyG?~g%piA)uHmFziTo929de1+=X#3Qq)w_G;0IRL2Br{&tpgC-^
z$GXy2bC_Dhx;&qkmGWJs<^DfH{`LhSJ0HdrI#WNVjarJuYdB~gZ72%!dF4y}JfHJ9
zp88ple?4(eK*ywMXqdGq0UndhlL)tV46{x*t35Z{qbz4PXdJw6GU$>1fRM#PQXj^6
zg+q>-Htl1&rY&DuKBg+F|J^k$H&*eS&KZfSOOK^ZWGdidW@R}Xk9vG5(mL0m)};cT
zr3;^`fV+{(zUVlZpSM19aFe197_6Gq-hxps!6-3gzvgz?iz&N<B&r%uh`~zoMf?VI
zp6`!WJZBhZU13#=QwHiLyj1|&lPY*cKi<%Q>=&KSGY_|xn}F%UD53zilxO}DuYSQ=
zv&b^!qO~Rgey6{K(q|fCL^ku`$tIMKIgrfENoJ2YYADcG89NV9ZG#G+_MmD^yC0v0
zhNVV8QY|3!wmW}9^s5m=Wb+3Gnmc<^E$;dXzFT<R#il5meIZ=G408?_TX}!`c6K{q
z7Uu30*Vh@%jFW9`^R^r|<u(@Tb_D&{3)q={OZ{-Z^~n?av!U*`-yi<->L258#BA2u
z8~w=+7xLEHSq>>9mzDYTgYqfUoqu=UY%wBio+@=W|52{$JsEYaF`^x3`i`zYH{p#c
zd;5eqQppXspy{_qGX^!9_2WK1w#!DAS^0P^4&Y3){mZO6h$ET0V_e2yu<&XFabft~
zWRP_=!@n%?*tI$vZulWoSt1%tc*PjBWe~4Bdn3FSY25I-X8m;tm_R|5ZOZa)X5pW*
zOfp)XPBCN8N7$dOBAir>SS-sVY<BK3+cUuv^J!1B3=x5=LMVHxfL)V3C(BPxvpgp}
zd#_4F0T3l{U(1{!{?KV+4`|Z!i}^Z*d>wdv3Cl!xY)7Zlq#Y7cb>@g_gi1*!!Ij@L
zf+5F)0QMV0n*D@#<z)YprW2KV@gM_QezYfFsfjJ|@%Uln9TBcxDPPGgUWUZpU-Sq`
zVehA%sL<oO$DW~AOkP;V6Kvpj8h{H#;KF;JDWhr2!5e|NL(_{V9H$LKJVMBolV4<c
zv03=8OmkI18RSk})36@riv%w=sL5zAZ?|^)E$t9dNC2eC=m1A~KM!j8398A1y08&C
zqk7Ed$>J8LCdPY5_U@7vPI1d8NWd9LoTK+Gd_^9<!iAlu9YWFx87*#!fCL0Vk{j;2
zu!*`M#w9KKkbrkOAsLWq5dv6(r|!UZ(+TM<ZfSr__b5*DA=5e>mJ;n|?;{>bJ0u%2
z-IamY)Cr*+4tZ75(q6pfB)maw9=_IvU8EgC(FqwZZn+4V4qC|qoz1>Hv%sEDdV2X$
zXv@Ktqbpe}(bICL>N#@fBE)^!qUD#1p{Gnp2dSLGn7%?br;v)*Z9a&G$^eBk?0Nlg
z_Mj%Yx|pY5$kQLgm&I4kk6gj5WK~bb_j<+7#_T(D>U~qo!OIcwQ)ZNECWd%$YY@XG
zr~;!8sxIsI<J+S_v$tRmMTo|?c`E1FuBNj+RhJuJ4|^0J@?j5k0Oo_L#mc}=TtEJx
z;p}1&Cz^_{CgTqVutyEaT@6PK$nPdGY%dicx~b~2Uq0_z7T(60J?q4m+CIYhs=>RK
zi??xP&#Lg`UD)CSe`-S#L^zsCJozlVlq-8*(IY>1_P&zUa>$@j?KK=E;V>s;ReLrQ
zl7NLITy1)MyeVa(Ona83Gpkp!ssl-&K@!ZG9;<O?$5ab`Il5bYT3giJxhyn&p}kW~
zRWO_tkNA5p>4pRE5Dl;3$IdpK-Q)hAVKkc${V}BY;SZBpM&Zw2#XS3js#Rz5FLUxQ
zOCb5bvH;UhYkuzkB**rBaCiGBnV<9QuGQ>#&1%AbU#7g2Rs1tN`>y5el@)=AwVen~
zelJDpIZu=)5Q$4lv$m6Vx24+H<-iq`C<`*<QeaB<1n+P{%^@dBwmBvH5#S7`I8Ibp
z+BI3*9jQH}16QEI70f8v1fX}SeobL}p+2=rVJrKK&}6r=qouZW2L#gfR!&uiM9J<)
z0Nnzf;*j8&#y9Gi;FzhMp;U5e?iZ@XvX(RH)qCG0*@{Cz`JvCyKh9)4JuNtru>*>q
zIIS<W9Tq-unk>KdN{#bbmUop=)#J%2D#Ikzr~;oKR2@3nFL)FUvP*}0rxEtK@ML_F
zoDA(=l-Jcmy?YeB`B3jhPT7O12R}a7PUi6p!jpzH$&_NAK_SmzOi=!Nncc<o3(C<j
z??Fsb-hRLj2eKQjsf&Pn2f^p#mnpdb@Sca|3Cyo1%}nvs@JW)BHHYEjX@D7rr?x1N
zjZac3x{gXnQmL)0faj~;2_D12#~XmSRZF{U_&63mewDKHd+XTIh)aUUC&8`l+-vIm
zYU?h-$IU29Ovh&ug0hUAMEm8tcZ6oTeD|TI;G{ONCv8#ee3EEYXff=h30d_RkRQ{R
zZw=%R2pTm6o{;0JEXRM947(SKIG$8NDOsQtkTj?+@O1DtT|SGD+V+f{c;+Ix?a8lC
zB^>S^DGu!{mUK9sD=>9WI-}DK6CS%J?J5ZsH4TvF7^MmFT#_;mcRQ7YX6lA=OF~_n
z0`w5yw_Y;TIgvR6q79_=Feg%&HF)4XSP{VyNGlD}>d`bU&51PRtjO}>vjlALr{0x`
z)-uI^t+l?j4hv1~TkE@`pQn6yawc&Z$GSzKS0JQQRh)xJUTaL>*?7{kM$XwUIa&^t
z_foiS|5OhM$TqMmIzY8LP+i0G`aNWMHYhyL&q?(Y)(i?w^V<~=<zW>NgaXOkPI*u@
z_o-h{d7S(Z0_wgH1iPXOyh~fOIG=Q|YOWG?#f<#W0I-Sav#|zj1_VXN$qQS&A{1<`
zk@I-<Sa&{j4F_F|B_%L1>e9l!wws{>JQg<U^$S|iur*NAj{}?=V-NFtxpQ{00blG=
zgiI9jcYgQSa7`EZm9}VqK1r);?hb6tjQqm@kc#P(vIe9E1fuW#v7ig8TM8Z7dG;<;
zh1vA2y$$x0_4W%sTGk&<$S>_2e$4pZkQDI6Sy<^TtaRRJ8FDY+>$+`}lo>ve-BxVa
z%JEA+LbKOFYQ04y7a+C7YhK;vht+QdB9cd__GIMU=Zbfik$1JZM{nb<I&I{-Z5SYu
z`SM%}WP>Kml&wh*<*{u)w+$L}gVwZF?vqSMY!~|e#^~m)Zz9XbDAZ@)4ER@K^R^BW
z8h0XWT$8g9chjpcy70}4w_woZmreHf5O;eO@2(*3-kV&C%~OZ8G}T4=O{z+7WZL+g
z)t*#UpH$W0?^)XOQoP=X(D>AcLOr>#e`DAG;xjYKZ`jmII=S-%39Etxp?(r11W``D
z=6U+8ms%#vz|TS{CkeovNuH7AC!<-O5q>MrQg7Er#i9Ugo&2>3m|hmJggIerhG)K)
ztwd?{r?irQ={{a0m!~!IAErpiy@Ikkh}6G4X{Q%RlUfT1zQQ|C+NlA7Tz#T*)l*UO
zl_S8Z0^Y$Pfw9In=9s|PG}-7RX<%*Z3d@t0Ko!*5KtD8a5{R6HV4ltIv1C%I@I0S1
zX_IKMQ4|dA_B%=135WbE1petc+r8F9n60BH$*I51fSfv`0{ox~?5YyI%b!Y-)<~Qm
zFy0NiKwRTnMvFk)a9cYcyVroM)q&YkB&6W8dG6s`zF}J>X4}g*UtHJ53s>AdH0-pn
ztYkm%2M)BIZ}l6)JacJlC?)kOCDntHsz^zFYrTCNemb4#-N!o`v*lsE-B*)>f!qD7
zyq+_aY6KtE>c`{2(v$}^#LMq#O93AzaWT9}JoMJTstLHAG%N6E==DXfYCKL|nX>3T
zLBlG+y{bP=u19{FG>1~iAgd>PXU%gRKXlx8{9yjM{tB_L{>n_0Wb$~bxZlOz5C8s1
z^(2#xPY4{zWDiqtVF6ad5~ERz)d*L2m*0A!<f(CC;zvO~^fUXO`3b{9hC$(Q#Y>jt
z_PJ#PsbqjEyS3;YGjYlbGjS?<sD5oz&Us6S!VQf6Hyu21Jai;{=1o2UX7;pd&^%Yw
zj9^i%YL@uYnffiw%T^40$f59P!^<$A&%V@e^Euz*soxZFH?M=r()lAuVs7hkSfai|
zv&{P!M3MXY6K(n*1NQ}<j3`|?Et&`_!y<*{I}&F{!ijytJ5+zi=#O7fd-EI2anUs%
zxDcbv?YQrc1PT~bvPW|x(W2TP>8-H97rkyP9iZ@$f4D2jq~%a~q?0AasW#GSf#}oH
z_~4Ftbqe&thD&qZ>bc*lj`A+z0%+I%xHS)yuh+c?dAJ>k0AH`NKv!_|kRkn|jvH9<
z9&zC2?!T4r>r!gFrd`g~eG(nD|2ggze(BTcQzdGL@GZF|k(lRYRWV+&!TUU0a@D5$
z$|IF5F-o<ON((r39lzZzC^`bJWJX0i@F<BwBn;@gKJWlP@UVK@lyw|jJPGr4z2-6c
zb}_2VdUt(BQ`RwS2>)11o7c-X`e9LJRv(V%oox^Q{{I^^{&6wZyjnv-?`T9>#@hu>
zRBVKW6}VcgsLJV7wb&@R*n17@78$kstGbciEiaz@n{sIjlB9*6R5fQa!q@hf!Jx3~
z-gm*F^`k!phkzq>b73>(lpoj07_=XVNvmm%D%!jh0vuZsr~SOCT~VXZq_dum>|9Tu
z%mITZJiOY-lFc-|sY%&LTpn0X15{W9mcw}IE{Ts0^!|XIzF_|`6V?6xK3}NjjL`S=
zJL?srF{|BgZa(*{Rk%L5nWjomxK3M7?<l~b-N0X$9_D8|d3%73DMS>)%aclGk%;m%
zvbZHrnu~V;*ESK0e7)Rh<ZNB?G>z;|=gDx#8W6CgLY!n1@r5Q`tr#aM%y4k;e@$nd
zz!^|*MiVjJXS5zMIzWvGN1COO)#dH<xCJ#hHxICG1MzhwPQQsL^D$fpX(q~rmE!c>
z!23u<wW6vs6rvg}A_D2*KicfO;YOcZ_4%#p{#W4KU;i64CNYrRdj40OxIrXhrtfGE
zHR38fV19m!><<rU|BHuHu?iV=A~ViJQ5a`l<50zA6@jC>QSDI183MO?5@%tFv6#hK
zbPx++0dK37VeS{$M9upV2~v^Q`iLRD#M-dY)tZ)1Z^y^TjJI4K?wYU;{$J!Lz*c@^
zDv5Djk&UffVSf0wF}1dkw2~0sy<ziiV@hKHEcJ2F@zJ74i`9{7je<z|A@ETR5M>N}
zG<MWrI;fTawXkAsptJ=1&qV=3y_dK#ADY~}flAy-ev`!bgFVOBoeoMK_%9Ok(?|QC
zFUCF%v0WUV@VZwcv+&6*JvdgsIDbSU_U)L&%@W4RkKgoylhYZk3;f|nTZopf`JAr!
zmadY>%U1hLa-n8jEJB(VW+P6DAylAk>uPh#@145qN0^!D>3IE*M=y${gzJB#j7fYq
zp(h^T+QR9evsstb^|-b*xI-Rbg$ClQO8RNUhLq*bZTe}SjXTI~HUCs7_@oA?6%Ia$
z81<xPxk5mRVESe;&OU*<=uF=<r*B$vZ^G#@tLq^8CX&8+gnRQg&b|Vd;s#EI(NR*T
z=Hf2zJX~0?TOywsi(Fq%j83s?9ra#hZALG#b`{5oKKD<HIU!QB2Qs$nz>-*boTDYi
zu{O?eA=qaul9%u7<$fVFNZL*{_Ep?rK`>-JSlaIKo~Gj7d{Kiw^3%*o+Lgmr8^$jG
zi{~Srni!2|GQD^Ik$I}{fvxJ|m#((s<Cz|bC!&Jt^6Qs$>KW4Cf+cKKOX~7X#$BmP
zjWK<V?4`!#F6!~|KWjzEcM)~@hnFy`F(<NW^077f-@XTr7>-|G&A<OW7-l@)AD(!^
zZ72@JvQ@o^%r~R=*Pc9ZMMkq<#Tj_nd4L%49&?G<Cp?H~@1JOwfEtTlhVG^5IpAar
zSQ2IETTr<)UCCvHxDPJvJ?6j^B1y(4)MQmH$47iNU0tYPYPtrletp+x;|8O*m;=<y
zAldRDS@A)YUWfSn^Lyid|0uJn&2o0<ndjKZmBKS}0PUdvewq3Bm0B9hz&)W9JpxcV
zi8Zjq7|db~@Mz(S!%8U0oI-ky#U|8Lx=~1A3aJa=z$x>>4;EvlwXtz+r9Rw~0UtJ@
zT&My}7oCfz>#P5k?ZFXF8d*%#?E9B>p}_N>=}J(>?aQp=XyZMxLrRPbFK}nDtmEzI
zO0=<*`*BK;aW=}!Ied4=&{F%C@;hRQmF}%yX1}2ibyrS5say&jKG+I#NOVULf)nFf
zy54?|crLZ;OQAQ?XU-P}`ekSK8{Hd@A1^GEec=JmmH_VB7yQNz(~#}CYizXW3zUex
zvh<tXBAvG+g3{BO4lhu*by1TqP%drCU+~-`hOd#6WJZNgq+UV?%86NF&a8Me1)ahx
zk0<L{gfN@n0Y-y7oSx}_G4&ksH`-FfdIK7&QC-Nt#LpW3bUdN_k3;3|l(rB<Y5~e9
zqh_cNccBe^2F)C4Mv+mB=ZcJF6r-MN7)yJeha}P(jg^tE&Hl45(8~8w+&0vgKnD7B
zdT#sK3Z^*He_E726rV;9*Q}?r<$VgV%$FUgc6-SkOhDoODcqAbR9PlV-JqEpwI?#Z
z53RY3JQ~OlpW-V;#%Hmt`_bY>fzGec;`gVDGb?t2gPe_;!LM;%3C&Y33^14h?&1<r
z=lkQ%mMKpWap#!^dm_CMfsyn~mdZVJzAy8_?+M`cf^jhGr;xvWK**>o^YlWWNb%|!
z30!m<I>?DRT0cehS$VFwvh1^>J!$=2<-}&zRlxH+T9q&rpN$O(M+bzV@0c+o|KCJ0
zo*VRtKO|(Sko1Q!+%U)rsA;3wHLa@E`BZeQV*R1B64axrqWluqw4}~_kquvLvWef_
zV@w6;iYIA<z}Z4##Vs-7Ay{$bjKc{rmwjZpj*@4GO{16Pfvka!hL;_OFV0L@563JX
zeBhdv#n*9g?vkD;J}zdCR25YRQ3|Vo{{sL3|Nlgp2{csy8~+QDgv^wzV;TEWSw_~e
z#TaJBzGNp$$gYfu5XB&7Y#F<Zu~VVKgffaOUl~-&q#=wJOXG_v{HNdd|3Ck8?(=%T
z?{n^bKKFb+_uS<?mM$7Uc=rP|!YSDy;L8Ycy#L(rlM)?E(!Ha|D=#}WE`+NQbb=7#
zjwIwlCNhqM#DxGaBW_x&Av^uWa;($l?f()|_rf#ep)=y9nXLmNZN^_rEj#3bGU-LA
z#y(zV|E=_$U%Rzn!ZmB<vZ-NG-0t~5Zxb!wj(*fmBJDYk6_(MvHTdzoEwMlVXd>ta
zQj&LE=;M>F2@Uc~8r6>w`u3I3T<gtD28giRzy9!@w|CV)LV17G$HzVc+7sM<=Z2dh
zZ33DO59Gb{OWZu(A9zKB7Z2C-TKk*27ggVmvaAT3mmtB4P2JZYRF`N!ohZB*XQQ44
zkB#-V(g^uEe7nB6n-D46u)Hj`n>@rd;l^ipMg8C~=dzS$)gKY{7OkM99CWz;rS#4d
zdsF4_H#y@F=b%=6zrGCfg!sucb0TT<w9X4sxyf2)ZVNJU8>dt^JSUOdpqHG2_|y#C
zfcbZhNNnoUI3ctR2yFvI2d*k{MvibsDsx7{IU*amX<5f;SzNR?CqA9+85!`{9PnTh
zKj87<7)^{b@`voktl`G2!iLJEJvXhChvv>E7tNiY%+E*W=Oy3cmGBk}om=9n<FBgj
z!~+X;0&Y(!yy7|rh|I=5y^cqFRH8i!(9Ww$z{pWxq$)7d1`ye-K+Bb<<;u|}WPkF^
z%Wd8$M;pM&k}|Z3T(lB5Xiav*4uo#tCF{o(re<snm<KM@$Zgm`HvU!H_*ZV@U*TwD
z<5flM(-q1`8~P94&3|uD41DR5o^rHQMcNBFZ%+L;6oU<l!7#-DM=@x?W;~({TG9Q4
zqmx$^uo=;GzkIZa3@8Xj26NNiS}aH=EJz|3AT_lo$zVb9U-FV`#n6hvXhi^8F&jM=
zY*wZNCj%8}aKQSd%=pJ(P%bv3*UGS55flMvKPDMS|6;fqML_Gq4Ly-$EgP~HoZL}_
z9)pRO=@8JtmFQqL^U=Y*6!3-3<7ct34GI`Rzg}I7Fubh@k^$yPV_^;0ct32s3^x8z
zmi3Xi0*gAn^D15e_6)Nu>$ANNrp|D#vuCBvaHCCOqv!8R6!FlU+2o=*^Bd+L1Hn1+
zIynT>BQ!UxKxpDg!+b7K$XWDhZqQfR4J8n|ke3W%&n0Ygpf+H^UT#APvJs)S5h1q`
zp%9hW*&kAvJvYDm;Ks%7hWUGHq4C*|8u;<?uZMekGsy;d<X$Wp8dr#qU%|)U$Hyz;
z<6Xh)FJ#wEW!JytNUWg+0SSVj1VPb+zovJ%R%7exSv>65a4m9)zq&TZuoMPT2j?l^
zVa@oR0Q`;|ey7uNqD0W+VtCBb_Yv4cC0pQ@6O}i>!RHa=``MJ6o0OXbintk!fIeS|
zKF?-8`aEQlrnX6w+oVlUIBTj9<cqfCr)<K>Prc|#7dD~i0PBOm^(%l#F7|pPq3KBh
z^du{K(lq7wW6JM*%5Qz3;O$$Qn|+3xeQe5Y_T9kl3{rk~Tal$~$yIQ&MqD9wXA!$o
zfZYLOcN~H1{{Yr)0qc=Sm)q54<t@yWf}(?%$5T}Z7uH9l3%BnArzaOQg$FvoMdQ+c
zGr+Skz%x9+gB##!NEHl76_iUA?96<fnD`{5fWi|)=ak<}P2V*!pr>8fG(889q5!1=
z0D^aOH8)KSH%-};+cXWOr(LF}!RcwO6dP_cW5TX)<*qNA`MbWolnh_Gxu+a7T@gx=
zI{>q<RqzW|5RVm<!3x>~rQQIftN~J?;{uzFQRXAxqm-&71&TTbYXWZQPDk9(Jqeat
zmfi9*-11Y{B2C&`LUUkH1e=$jh<k~;*@?Q?#An!YsD6xYcbLC!f0+L>GF#amoztrz
z{jZS7@8f45<t;qQyYT3cJ-y$-=<ncw?_jI%;OY0U$M0eJ?_s6yzjB^}<?lCw_YS7<
zG0AIIkBzSf<m@-%_LRmF3$w>yn`1D-nB=5=5Hu?oYRzT<)OtKodo)pdB(c-kYs2(b
zE&RIZc=PDh%U+fRYnpRyJvlFiUq8!CJeil6gC&cyZ^67T_&hv5PX?c750)C0m9mkQ
z`j#UBvbtD&30e$;x>!QlX7=1xw8)<BS$y6iK2HmOF(X%VE81`?noYT_=+LFb%S(&!
zrA1>HNI)`hX)$4GG4OwhAF@>`c-ttUJuc857chZuwZtqD#~XyQgbs7T6#hs9#{zk7
z{Y|_AR}ITnS;<zdsx3eJk|?XZ3{23dQp(=D<S?c<cjgzoWKZra!In<2)g)w?zzBPC
zm3wk*=I_ZtevPR88j<@oA{?6-IvMaXQ8O5NS+fdJV*BI@^cc8`F1w{{xTUPHRs46E
z?!cfHY+iy|+)Gr+PE^4rHeEO38m`a(R@3+gbG3;KDz$FQAkBFRA_pn;-ByWWwuz;1
z@)`E+VY`U6Ex_7>v9^xDstG_93Q!dR2;S*HDGF|tO-L<W^nwmY>L=hnGercq(x!ub
z*R(u|(6oB!Adx1f|7JRPV>)<vIv6({+|YP9=5R<L9&|XnZ}g2-!9(^4_lv6n*-}_s
z^}~7;k&{Tu9uD3b4lW)3XaW=6LxA=WYy$QWkS!m#rGDIS@*~;TN10~<d*=<ed;<Q<
zWG4z+LPsr@I?ziUh^6qF+MGn;yu@NQv5CcEd&zD~hkG&gl+PdYVF$e}U=FcBy+gtC
zD~I^6e~gLchp+#2!G1tDQ?5OW_S5Nh_SgBOqTxYP(I}f|2U~e^bz%L^{sJ@=KQUS0
z(EDhb)6bf!U-HJ!9R1JTF8el70f^m1VY}zpdU%69j>q$*gsRbqqLOCz*{<xk&#t&L
z+6wr7kh=GXoGfkpJlXe!aSz+{Ci}|JjB$s*_Bj(a4W8hVUJF0&#S6Q~gA>e+_s)0>
z_xtmGb-gCDm!;mhpQZk?{k`mw{>;Q7;TNvg@PD$@{e2!;Fjb$3<UVsd%u;{V{@$M~
zuAJ-`2~T=-<Kh(HPp*3Oiop}E{wp?}>+b=#*r{(3a*?a>K7X6(_V)nx2xfn6FTPll
zXd^mRH=8E;_)9FcIG@Kr?W^DoHx;Sx4+{<7`!)VZlPs>G237}&M)#a7KUaXduTekR
zK>Zp;`PxJMx*DekeJ_(ty~eCb80`vPZZT<6{Z!M#(bzWG(6->@>Lz&ORB-aKn-2$1
zY`+jtT}qR5!SNWh*s-hUhj@*2wsl%J2{H@hugjlrR1JiC!L8S<Kj!zGXl&!qZ9YEZ
zY;wJb*pp@NWzpDn7u+`6*k;+(90=dWd%A?lU+35NTFj+FR^#q1$MMJayi#d|P8JkS
zLqg$RV4F2D2ZwhJ^4HbPdx~Ye!eqve?aNJdNif{8aq6Z$v%(DhOFaU^Enus6N2jg>
z82WePBrSSCxzD^|Js^DBeXCfw>Nf~c{1k&b9v5Lk6xSw->rU|tPkBxjNY7Wx&P(GX
zq^&MCSY6a4ii=L&6L#=fRm4XuSzWXyit|q0dt!A_W(sK%1T^j8#YN;>UDP0!DNT(>
zQO5PB#xvtOF0HAyUYo^5m=Zlcnf4sRN4&*Fe6f1!W|dT<Xxd|8(PJSyZ-$Go$43NO
zJ=G+7w0?fSaBHMB!0)Q6kI0<L*}G5j@6@zD`A71@UF)Z*gz!rY9lIW+%KWRsh+6BX
zgF;WgSwF3v`my^-sJ8IJe49~x0FUPU7Xhl|a9qZ#IG*61LH*IF<@kpyx!>)o3?7?9
z*#{*292VH_1{)Bl6=MukbIJ1ETaQbAE)B)itC0-g8uK9@h<F*QS4z-XzaGAlpZSP*
z4N|WXbv}wRuTPyHj(e&`>Xt8_ch{Itv)*}D8z-nTU#mPnSoHHzR!GDuJc|M9D*1^Y
ziW5{O-JJICxi2$6iu>7xW0@Lb<Icl+TxI8N*!vbeg7}}Dn!k@vC8fkwUFyk`nTO$j
zW`KXb!~cX4f6F@<hXnTDWgd|=S`e7x%w(ppJq$Bow#H+`JH@Fo#R*^>z0FL?VoIB1
za56?$@9jqY-Zj;vOD%y9O!eqea%}l1ba+a|h$~1ys4l~VA=Ah_<%r2tF**q|Y*97J
zu@)Q^`kZ&csO8=+495_PF9Dg7VA>>@E)_g``L0%SIy*ltbeJiznTKPGK3yshm8V$`
zt3ahy*T!KA4UAMOK=P=(IenwMsJztDD-?!C6b7Mh^r{?Gi^>}m%KL`OtEDbdLU2nl
zp0OB?ipr?h4Bj}5SuEzZfzg*ZF)lAG71%@tPBD1t%=9&;Tr4JE&nSeSbueiwz*5|+
zPIh3+NOkhmjY;D>2-~Bjj_C|#UyQY;(NIa{1BC6MknJ~wEtpD;ncTVWh6+nN5Ou=5
zlB^51V~8RdqHW9^$m(x%Tg}xfd!Bu*m`P)E?tQJb>f~Y>qfuOCSC;Z8Y*O)QY6rQb
zvS^5@rc4SB&t~X3VFbp?!PftzPQ^Mf^hitzXACG8?d^&I6;<9Jnl`oz)oVXP<r`++
zHb9)0rt*nV`N|o`zNrlo`UkQY$GS?qaYIZFWzyMce+*vl`Ea>+XSwis0m(XQ_9un~
zgDD%0c{|IHkHhdzd&;8Dr&4XE81l<Zz;%phF8XpjMzq4a7?pkYzUR3xRC_g5^{4Lh
z+o<-dsP?FO*Orcx!3QT|F&5V`7W&W4%DwF?yaQ3~n)R-&ru|&Zg0ur?=&DZ<TQpaF
zx+IzHGSsk?WidYte~EViqFsaZPKo+0it<gL`fZrmBf+$>QhV2BddRKv{7deXcmwk;
ziOKDX85CpMn6RhqvmMXAc+6zKDfhnkTJ@o-Ig7nD-_bt8f)o2=i2c^YegLt5PWCz0
zDw2ax#>GIIU>s$ikKkxTtH>8ZkqoOynJEuINJ?jnjX6dfPrJdx2)~5!FvpaEpNGrv
zr&Mw=!p|_mu}mFPjE4m#L+1G)j`qm%&k^HQCD<Q>L`pxHEdiAND+ct>7IpD2#=IUd
z&nZ1uEusZluRGN3EM)G))$Q0ZjP&R{xUUU2=Q5L}2(<VNMp6LA=L)7u>v?2Fpzg1o
z51Gk6lAG(JLWfY%&GlyR0p~LFXe?_$g_JsJD@^4fmq6Kzc2t=pcrBY@9>6*^X()$~
z;-F^aGt6HxWdd2pb9b$RS;q;`{GmcmW231o#uX>ld&#;yd&U(c<4POzku!p`Mp2oR
zH{;K86Q;f<mOx#y8Nj<tUUL?Ob#j-|rMP4{qWFg$TkQDjpF{>?vJh1qrS<6yM_-nc
zX40DyXdNOs4SYb-+UF-6+>H#>M0~h&5a|P&Jz`fSGadZXB<ZeQRft_xbi+R_;({BW
zjIXeZkot-kghW-U)|Lw?c+G=Qsnzt4=*$YLX@l6alD-y;+U_Q@%I%UOY_^X%Bpr?N
zKGk$SWsMKMeXN#s+hJcacefX{9ZzH#)VP=1?R(X-0F8Zd8EZB~mP0Ko-!X|nJh5^h
zU(0f+V>vh^!5jLV8vFd6d^DQcTa;A{zpS4jJm{l4PP@irv9b{MJ|9r_KDE>D7M3A+
zmKd?G*uh7uvAuEHcp)=+)#1>jF?m=yRJuE#WnT86&$J=(Q!0zQrtfWa-xs^jZo#4x
zf5dexl4?=*pNEy##5Mo3n)Q(c>QhvG>ZHAX(r86r5$ZFbJ~F(b&%A!!WZZzxl+;a9
ztmwOf`fOjH{8H#}y5azfI+R1fP4^vRS)hu(_}7e^aV+mxR;5AGdYssC_M>N~iMlhz
zxJhR|Ut@B{vQqW-eZ8!YnHnc3Z>RcLC*kfpNDbFb^L(^v%o}EctM{x*ZgG*M<f(Z%
z4A>jyd0o1XKD8gm@Y!<6`qOrJ|Az85Z_%w77(>yC1$Sg&Rrdq_ma~mf-iALfWXYYc
zgW_!(ZRhHo9wZA9N%pdkdn20(I1=)-BlT5QW5_H2(9%m9kZ_$L?YFMg(;qf=4);|X
zr#px4KpUpD;dLau5|Rm#*bH-S+^a3IZsk@ZnLaKljUbmOur6Nc67$rAROBxl4iQR?
zeG$lx`?|jl6^5p@RfeYj@CrLp<=8_wW`#V^9Sf0I*3PAdoQf+%Ek@Nx6REnC5DAa^
z=(i!BcEJ0(_xMnY*7eZ@>a%Ia#VAT-T>a;2YGkJ4Wfbz_P>5li*gul>o0B1i;~|DW
zwJZPDkw+~yq88!xo0(K}6LohiBym~053<T*Zmh9drlYf379_z$7KkvBW#iRVN=G%3
zN3H@+k$6)=I7YOOUMWq{+!xN>ZJl6x1h85qm}&CGkwvD)cpjDQC|Dz#lZBY5I?!yj
z)JdbS)sbRFrl0@t3b07<lPnTaoC(w<@`_HSFKbb*cjg@D&FG^i*pcoT3BJ)@{8f!8
zK!XZHMz3(r0BbND;<g+!z-o+jL*>aP#XF_Pb4#o;N{`o+-W^`jsL|Id3IZteIbs3e
zS;|jeWR4p!%ncaZg5`IKIRF|w9{vO<(;9!Fpd)|!q@0fKTN8hn{jqBRZXI6EG73v#
zqr`)%<YJE$_ppGBKg$X&rKmK8bX>MT7M|`_IA#dveMcOCG%l4EMkB4e71F>8)NTdy
zwvi>3rZmILFPV-iVKJ1_Pm(PoLSZrdVKKRo?yjt?6{y~23&_1UDouMpPYVdr|IAFM
za&rUL;X;$L$js?w$A^l3WyZrw&q%vlrv<P6`yx5wggNlATX}4wIu?obbmXWkOb@eO
zD0PTIjyxj~Jsn>NIWjyQWn8JJ2o6zQ4n;8z1k<8?<h=mLUUMBtKC%^$93LU+1T>~j
z2W6=|wh5om2`-znKO#xgx%AdF6c&9aT<nz&|CO>=7>pnk{;4yoey2p|UnYo}W4o?_
zq%(|2<I4;qEP1l!?C~wxpyvZE_qD$bjbZFNLcU~%T<-{Zd(C~1SsB#%iZs*qXiDaN
z+|LwbhA%b5mm2+$(Ne#Y*-@2i`24lD3cFtN?f+L4nSil<z(j;$NRa2-8VjP|N%j*w
zQ@{31FnUr}w#%H1@D)zcQ(@fI1*yK{N8GfmT0})=Po565)b+QN46~$^vJXc*$VXU)
zLvg&VK{2mG6*^1d9i>>0@qlrjjZeY;zfuuviP8n-f&sGsS*_Yqg8le+qS&tw+a!C3
z@v+9BVka$N6Cu1219px~SwuEqIGrQmGiCPMB&Uu6p^jCj4(S=S^w1SMWrb`@h^oW*
zn!rqp6{MN%>q}?gXC{(dEFsO-kY-|Ok==Nc!}zO)pes%tNhC1=Bl($Y<)J!oh<Huu
zcyZ_rVyWapfTB|e=gjx~&>NNzgF2R^#HK;TTD;Y^fn|}?%(`}y9xhZMzG2y<NssMy
zXC$f`@0$CVK{Bi%8N|{wyYU)_@sWn*0H;{}`sR&>V5&-ev)*1Dq`tguS&lkW{)Fl*
z)w#wQlbGo&^>7W`%DT`Doen*x>wj)O^jv3YHo~>`{b}j@I$qlrEqy<I|5D7wCwJzZ
zp4U*v`Y5TnZ!K=d73G>V!j_7*<skQ1t=8_=?b+pt0^yE!&&cudcOJ2$+q0hno<pAg
zz%)z6Y;zjkN^h2m+Ai?i7jZRy0}+(a$eVx&#*BmCc~lUrbrL$aU6Pq=>$$FMwkK?_
zc<;AvyCfX!f50^N_t4hPzw_81`JXMlpE^D|u-paZAqx*_zaf}-LxIDp!5j%A2<i48
z2x+O9aUS%RP}^Qg7<2?8wOE=LGcE`lYmXhz^ZYeRNP#<*j<k<+osgd8`01;j;>LH?
zjW4R@SPS7u<!_E_3U($Hyr*$msT=|S*#IX#&8A}&PJ^=5^+b1^qq<U~u$&X$oP&D0
z6W`Htv-D7zYIiFKbxMQq11G*gA--=;eBhav>7j1vrybpD-MJctqccK<i0+qa-P0Y_
z>FhUZ-|<@aOLgv-9MsJkgzX!J1D&#85ks%<_H4hyN6VT$ke%EARwgmqi;gL|yIbQI
z<hgqo&r@=!p73#4clQB^s<zT)u}6N=Q2tI>{@2`tC%@+Whr2}<R4jGRa!w4%t@!7}
zYP{*zm3Z`QqFXoS+_{x57h=A1bhx(%htd70*Ri}zPqSa197er-#Pq@JqslKxee%<d
zk-U1_>ZbqMBU(}eZ(>un;a?tYknD?Bj(Asc1|$ebf7Kg!V#xDg#bok~l_AgV6%&RY
zE<u1;nYNH=+Os0fl#m<Mx~Z7Ls4rZ}AMPd^l-tOz<cqE3lMU~8zR{}uo!?@3-)S@!
ze!0>nf6LQB{hvCK8Hb!u<*;l&H=9+Zry|94kCQed>UZmgg$Es;uzl_H)B;Hx?=D6x
zE_SfdYOHIV){LTP_DpLkb>)2W7nyayDF6D}D_}P&JN@{liF&r(XsF$2OhaHR`-8bp
z?W4b&%RD<GG}LUKh!i`sN4SC-)u{hkjvB0~jdRa6P*<!d2BStl=&R?UM$<~SC?N?^
z?%w+9|CATkqxv(zx7rQ%K^3=b%k!_duS4q3OokkbFLyDiKciiL<{9+_s{YGlk#1|X
zeyenai!@5L0i~*0e}+KKS~kbMLzUjxv_?~3dGkh=ZWe8j;A8-;bMK>DYr2bSYPmHf
zRQ{nm+`X03;_|>HIR$)B?XiEfmHk#aeYNPH;AA`R6NL?$nAY#P@7}C-Jznn8+;RVa
z4&+cVc>HEbr7U)Q+(m~Is?=~T@xkpkx&B!nRK~8I33`&XZMslbL9$1=Hg7OO&**uz
znvt5Fuhlm@3te+wa4bq`J>lDI{m@zTebeb{5M6(W<TVJF2NLCqd;mZ~!h75$yIkU7
zVb`bKy{PULVXYBJ*Ue9^!PJ?xwYaXH@-`R6|15W{dzyW#-#(Y{2Yn)ET#?N&$gYDa
zf47ren%bG^hh8cTSeLNd<)xHR<U@By_tue?S)xnW3!yNEOIXc}drad%mQ!hCo%)$+
z%a*SB7w+PZW@jJHF1v+!7^h-8e9Brmr(ND14IRCnG8Z6O{iH|0E+eFMuyghil>5Nn
zHRJTGKKbD+{!W*Ga?AB=d|_S`_p__h@^0TaW_ti(UU$3B4Y>>Ey4k*V7ko5ZaHr_N
z)5BJ^W&3StQhduSta%&Kyxl#+a`79A^{F~D%L?^tJ<k`G<ly$L`A*l-+PM__aNqft
zXZZJ*)IIrk+3{D0*>NrMOK7H@I7iuCu2A!oIXkoP;c6YCo%jnOafY3^%(Uf}aNE_!
zI{d3n4bAZH0@PQ-osZZ)c<z1A9aS+*zQ;4M=BH7RVs<F7!-ZY$B~HiBs?06>$lJG*
z_UAaXzhoalF3FkzA0MBj+z^r$DdJ8e_&(4UDde`Pdw~eK;LHL`Y{I-4c@0ch_wiH6
zl7ohOe~|bP$M_N*3lb7SLh4aTe}Cma7pik;JD)vT`o<!K6d+XH*mHaX7|UXB1%F$C
z#+MPv^dY7qTV&bt(SOZ^Bw(^AjgTCemLceiIPwI}oy>iY2%bAh&?y+|tfx#NR7vCZ
zA+hm=I<UHNNZok%)bii{q!C;ryiJ(8{J2C%aj3J~9pQ0-sD9ExH&0z+B*4-7L!qTk
z-C(jG-!D;%^O000VcAu~QQ$@F6){<$+lqpmVfpxXGl~D-RD{~Ajyh%Q<W5G+n<I9H
zDThfJ&;Q+Gapa<xB16ItiqYePbMe=Jq3*Jd`#a|uQ!glUFaKT75*Iy8PQJG994_I5
z^{z4olsD*nztpwofIOfDwG;qEK)b(PzhqLYrWlUa3jvS9#T`&{6eUHU!T4_V#QPuD
zK7W0(>!rhw$NFEIa;jW<;&ZUM;T)0SIXASc0*m`5V%GQO$42uf)Nhri9m}V?Dn2ju
zUnJoPPr)|Ne&oa+AR~f<gihTw(Bkm>{$nihAohDs{BO6db5;rQyD&1JCe3fScOjUj
zjEfgplnk1Y5m6m%F)QTjsS`HMAUrmY%Fui4`^IlM=7gg_?Cu}_i>HaXN-c|rXXU<`
zFBeGF);i-_@`T!v8JRd28J|+1fr|O-C3;$%wp4B+F4u*>^?xnSzq@A-P-+_}xeb)d
zLf<5kn}+3~!P(@Zjhx$vI%)XHV&RM7MidZzW>tw(a3wWkbYKv^@FjGi;_^ZTe4(Os
zV86QTBw0(4+`%R<xx;HgNCcgpJpe{82q|o=P1<vVUU25&Qen6O@bp0M!+~DhKyS%F
z|3m=~YvgDLpVWokVYY}~=%t8UklAc2LA##C#(%}eL$HDwxylqCMkrKbPugpoDFU@}
zt>rbga{cuMO~<QkTIHjO7N4Yg;B<UBnkWZ?XTs)$@?H+qdUAn=IP)}9-=*i~qfaY>
z<gqXzy1mNg|836+Z<a((YlP>cFQUk0a<qG=)`MVV0|nZ=1${n&K98h>t83+G6~Og#
z*my-sZ!_iQL&{AY<)$uBF#VS1CdhCT#HQRP=mr*ch5q&&Aa5B9E2F^v_SUp*4c!$$
zNI;$oaD4=@4hO7<$b&?<_5<if33Q`Cx)Gdi^aHSd2fGu4|6e1nU{`5X3AjE4T$cx~
zTL9MU6li7gH1=hElsi|cPc2h>`0p}b%k!@sVUdpq<_unOs9vJ+fY%pgx1few(Eqib
zgtwq%+z$Q@Sx|W?Y1)kTe*gdg|Nmr{d00~07x&d{a3}}NDRT-36wN8qGIJ&sHE{%o
z96-yV60PKhmGe9xf{^BfqL^ADR+^RN2v`o8W|`L%%*qj~n`QZ)?(e?;yf4pQ>+@ZU
zv-ZQ;XYF$irH(VD4l|PuhH7@BrCUy~OShd~`~3z8=%f7?(u!~=hq@|rhkmXP{iF^Z
z9Px~pDU6))06coe<9XLfZr4e6*ONXKHTp=U(dsbupVFb9poL${6shjP-4C+xLWTGn
z*<DHrB?PHif>aSfN}V8e`jFb7rrIe@wZ%LYRdJ&t2kRo3^=T(-K#Uj)Y!x@v6$nyu
z1Su23(aZu9fvuIm7Vuz!Z4@sR$xC(SrJjVT?mLL#rQ&$0n12(?nrbNosW_QUY1K_>
z5KdxIcVJipzonuH0KKJBQ&4G-<k>s(>~Hm{T>qlxlCya_cqo$-W?dq;QGK}&uNYxH
z<han2xX=S%&;U--Ixo^14tTUR{5jr&i??9oAM~lLPOG?6q&^H~x-RsHZM?rc1PkFE
z3UshefmuIun2|lk8HBA3!UhLnMT4*gLLr(^2qqM=v=?sR!Bk2i541tRhFKTGhhT5q
zhG3y{v_P<Rj*c}4JR^RL(+gYgg|T~KgkBgUyD%cVP&>QuUeUba^HI^wvjupTgY`{y
zwb)F&q?2{OBQHFW7Y^seR?+hCl7;v@z-Qz0lsEn5H~nQd{q?a>ez-F)9LEdC@csy3
zc`^xw@iLnhs+$%dT)?94A+>=+YC4D1V47<6PSzEU))fxcGbqQrjPuz2aaLy>RSx^f
z3=n;K*Dv4B0vWA|8H!YP@2CtBQQLbEGYd+b1)*m_r)ELp-8#%}o#INe4im6q7i)r_
zAe&k20Vd&VmfcCt54<q4TN75<OWst`<38H#TYALTKsuqGgSMDM|C(H8fB*aqy>;oK
z`sSsp%x|B+$%!8AyOpo!wKlm7d2{Ej*YA6t{MF`QL6=A9aUXgEV1u{xyawG#kTaJX
z@BV#1vRClW^0P1hELU!iuD(s5T77G}4kS3=@~KP5&58Jd2<GZ*xZq$J`$@Pd|4NMZ
zX2EmTyT|JiLfekJe@lpL?@U(E?!G>HW7uxCZF=glu|)Fl*p1<^w?`vdmk+cJe#=LG
z0u1}JAIeM$Cog}?pK9d=r3orF3KJDVyFO^HYF6SD>}KMXRy)u`718-qC#uR++CB)3
zueJav2Jnt@LMr`vym7?veE2sj(}>FS0_;%5z`zm?0IYur_la_%a;J4=tl_N-v4&qW
zt})ApKJd|xp*kDRmedOY?(#O4$f{D}PJeg#*%vP~-5&8L|4P2s7Ozne`%;>^;CkZR
z>RDCQiSbV@ByxH|!gqz*`8v$|50R7i`&N*~ztbmV_x3&+Ap|g>5(m@QC7}s&pvaKw
zL#L~mS)Rz=1}Jld%*~LZ`8%wT1A14<0bs!XXu0|Gmg7uC7IdN=>SU0+?%S^E);2nD
z13IxH5}Xo3?v)*q6>W3a(Uz8i4C@{w-tFzA9dLgpoB1RxB3oGGLumFPoAOMp0z?kA
zZfFP*5y9{Y##dEB54+-UNIfnWfe0qQA(vu=BB=W!lv0q|+}uJdFD^^KRB4A6){*%Q
zm<~F|@)dJhd}Q}Aj({0xaF~n1A>BD#Y<pKzh_|nio<3BsqpGr&nc{`iU^J<F`@TjX
z#k_q#dHZUTNX0IOxSPIF-o6?npVnHYIHPH-p{d5(7b(1uQc%p%BXRVcG5f2TE_KYC
zp2+77P4^nU+nsdA9I0ob5J)#5u4C?MXc}cS+3H1u_n*PtoH*+}p-E~7CX;70y=rKx
z^PWHn|FDBOW13ws&9zMOY2<ALa-g9p+<OA)m+<)Uh-b^gmif;upLw01k1<y|4f{Lw
zQAjD@iO;?hG}70^%v-H?cbg_x?!LX@Z{91*-POyq?O`T|O@-W@6?+}>{Ku?lj8U6)
z3nrDery_N4!Q7lm%tcWM%G|`@0F|8Y8_M4M3mrN&D8Y3?`kNO&V~*at8zTZOOMsS1
zbG4EFSndYPSsz+9%31J7P38HTNBf$4>6bMN#oNPxg4^ksHYl{rIdrN?o@|iEk$1x6
zI`&EZaMla3AQ=>M<n1uI2Bc;i%x!m!K4MCb@tysW<wIlcWyIuakz!9_%A7C<>X^^P
zN2HFq=)LvUdkZGTrg6+koXbv_<22?w<<zaMDw;~_y$$2D4*?JXEGx2hG%bxZFWKlH
z=PB}Fcb7)`t8QgsBB8BI4$$LApvNKPTN8?+Iw3krsh1nWN8BxUErS7El6=$0S_(s5
zwrm%*g)uM+lT6pBDM!{4^A+;|YiXi=$;sehw!ENV>D^88i3W@Zw0+6e;HsIy)dunj
zcLUoIuc#?n)YPH&B@NWK2GlnbgR4~XBeML1<L3^KGE1YU^xK!TP~YA}P3=Z~`-u8h
zO-@3%R#*w(%P(0=FoU1r49v->sXOPUJldD;v%1Azd$5-L+LuaE-#`XGeGGO}$UER%
z;pnkBsb9QWzECAgrHDx0fgZzlUmn9s-&GlJRdIms=GXR}si;qVQ_Gh|S<1QUXO3_*
zo^v#!_(l7xP9~HP$@ZUW`9<X{70v%iBN~?CX&JL$e%oeISArWF?7xru3`>zC_uNb8
z@A0>+39wA@Ef{<@r>5&MF4KHh#Ssb%&*tlfSvH1Ry0ogai%XQ>pw-@0@sZ$qBK-@B
zpJBZXpaT?gIGk(jDlu)Fn0MB)zg>lhDv&W4h-p{ZZ7^`jV8D|b$EZt;!_f<(QSMb_
zQ0q8Wq`iEERbGX1_eaf&maC)O8&K}240N){phhwg&UL2qYrS066G~9-SOc9pGSPwS
z9AHpy!-WKKA>-Jbvl{LE5<1^3%JQJALA@vUoE!ICBcBD7d;v;squhaPHu+^E*%Z!I
zqVw~PoP!AeSxCuBRyl!4HU$>4A6Q8FyXCK1%N?PS{Mx!SE04%_XRaj+Ye@EeQB8`!
zNs1rmSn7Anj(EDGUNDH{c<dOq0RFGs$m8Ig_+5@#LO_3iuq161b8vS2E(4N;4L`-5
zFM{Y$XNV5IOt7V4Wf*~ZTBO`l{2C{|W*v4^+(-!MZv`Jc1t6QoaU^lHocOXdEL%BM
z<lp`_TsK}U20#F?teBwG6gbfw=%ioDSCq4n=Nm?ckL>ToYLWe0)XDnFWPLgA{%FY*
z(8csTTfcGR#T=E?mLdShb_HQjEhYwj&Cg`_0Q<UwBf<4S`nLd=?A5)yfjgj+3D8Mt
z?h&N_AfA8I*T02E`rOLG9&8SrYznORZ3z(GWe05QmfPw4PAGKJIkclio_rvWv)75A
z(e8L$+Hm@O(L?hKYk&;`_DA<Vhz7N8iThuB)w-4Af2}VPeE_;Nw&}OLzx61A``jPf
zksWwGD)2nQ@Mv>s_$=hXxkpP1?oZudsym0=V4hYIM-OWCA|HIzW!&iK>z)n^IdA#2
zJ7!B>I6gPEL+k0ZX2|)el#ab2=Rb#>KSX&eD)~^gvpKmVHDm>Nd>j;whwX^ZOzD^x
z-BCZgPdFa7Gai=GVc$LN`E(i+vSMO%rJ3OxB9u_#Rr(PB3G3$`v{KCA2EAo)Ppn}*
z{=rH;nkIUc+L#PKs&@-oIaK<ym4{X9n4WwvT_3m-;H6+8{11Da|M=LYj>Gka|4Cdo
z%PIt=YSAug2V?MsCj~Z9I2)GL-B$u>meqK>m4ks)wmc$GH43F#O@_6O3-+{Ijj^n1
zP^!Rf$IgSnCp7X2<ASWSxY{V(5X&k8rF#6|`w`!GQs5tjgR`vey%LDBtVY|dYz;iJ
z<OQEMKyF;Gal!TScbD)!1K-To-pcFC_uN91o1JY1+d%qm&6$<kr05ihrifno_fvmb
z*H_nIr+7Mo_25yP)DwaE@Lv-z+_yU`k4JLY$c=Z=6GKyx!)MmV1qxA{t}g`&uLPw5
z|8At;i1sb5_AN)&R$Wxb0BbrNwSwf<*evRlI{x#WxmXb>|LzdC=IT9e&CeVB#|3=r
zu#Ur}j=h|uSmYO>W~;1v((beT<OsfSyP#V<1lY~on%$q6i^+lVC)EEZHE4n&Puy88
za<|Z;E{JPi;jhZ+6%>KVnfJ2!GXA*Q09=}{D!W(q6ulaT3d803s}6v;;k^R?9swl`
z7o#Pwcw+$EYUK+gss5@&;0rhCbyI^s<Kh3V%7qsG1;E$vF9aBP*l<BXT+p~6?W_ia
zpH1gOqHxL{1|FVVFJM(0`HcUacSR$r!o|QNn_S;Wj)Zef>3nKk9UN#KR7IS@a4k8~
zfomFIFl@_>58}p;3j(7c_E>Jb8&_gnpjm+mt|BYkBrAAxC0r#WyCrJ)>5csKaY4#i
zTy+$V&FVs<f>DmHri(hc<kGIQI0%5+v$%5stS%AgodoC|X|6t!Wk#I;;-ZfVrjaJs
zSpwzeu8F2Dx^HlRaLlfQm{9@B02R!w;U9sZf^R!=4><An(ggjdofpOP#j|fbruP2*
zbD^hC?0Ls}VN&?A{;Qtt9})))FC=pVZgB&6Vahd0VexU-)hz=rv@dsDIkgaE#qP2<
zSv50R)ump^kW|XJlCfuB&v8H7^ykNk?jhhAB~1(2)j+<*fx>MWbGj$fINy4XJwW$d
zTD)m~j~0D14mN3)eK6={L>uk%x@U~p#J1lEr8JDzs(cYP>3B`&!jE<6{JL>btMZ(E
z|CiycZ6TfTV0AP+dY`4J8W$*}12g$u{BIT@_zVB6`_BmL2Af}RzMX`&`0_&Y_ne2d
zRk_g3jk(I7*_V>Xd$v2P_TCh|p`BcyEnH)~ca*VH`ST&Rt!qfosHD4H8quiYqO4|l
znsRxXoV(pd>1g$-vnTHE&d{vBeK$p?nyUsoRGpkcBaHY2KP6_pckW#SGb^~sQoqcb
z=Q>pA`6o(y%;w`Q;lxD4%yVrx!%SFM5z)VtsK^JChxvQxo7$}i;j3U<bLTm>wiwg7
zrq$VQ3fx-3)!3zxjR$JHDu8F~(+^mR_IlvHmvpPro_Vi`g+C)YBPEku=45G~#EES1
z;7fjmP^+!mZ&eqIP-~A-Yfou2%Bxe@ao6dUCiYtP#_TzWwo;BWJ=@u-58M`^tCE67
zXSmQ`oM!VRNqIx3+2cxjmOF^$$<8agKtBne>7FUhFP?%+LyAF0?AWKZLPn4TBZxFy
zTtu7sNTo?mnNqSx8)Nmf*1-sJ#0UbRl$<v*5`~CSO7titvTzp>?K<)P)a3P$5UZKg
z>>CxbdAoPdYdlSqHd4J8VkMkczpo$kG||Ke+>;m;(j}eeXZ18uL-Fw5JcXU}Usd6v
z38auNZ=+z@JO$zTx|H>ZkS-;~3s;nO44*P@X6CIgVDj!m!@Hc7=3@i;zu!<)3(Awq
zS=Ye8{mdboXEAU+Fj21pjnJTaD^tBo;Cfe-Qd5g^N{kufCfX!uID!BG)n6MCfiN{?
zH2<Q?uZ-rt^IICGnBO}YelzZRzghM#C7>Bk&J%Wx)Q*nU+M1o?{m%QjgDvAqTN+NR
zbv$xzo}q2f=zN>u?E0#<-8UYqIK}~L=)fd?7yp}pzC2tT9y4Za{;{b;%pGTxk3H`)
z@PVEH0JcC+xEJsBmklu(MpPZGEsZB`T3{cHMaO&X0uwbV&?f3sNoA^J34B-d`DYq~
zHVbsgPtzr~FWi&{0o*DxF)>n7qU4=7dha>nmBJo;iY^H;ku_3^eTo(_q9zzorQzBl
z+Ey<6e6{z&BSeXo6(J^vC_~DWAvt)&QANd+AyIh5et3kKwy7`?xs#Zl%$7Yc^po(@
z;+U=XsmX@R+pZ<YYm?BY&c7_GO?u!=*tW8o+KRM}rGfkpKYOD6`4+TmhOG&pc7`1m
zu!`R4jlATIl=1OJuKHKP3eNgA&#*HZnSEY9=H4VXFVbFb%Y*eXEh;hPOhU148A=vI
z)bcb($YQ))YnI@_m&uLH0ET#lRJ1atk@LdK=Q6dCN%SVYGxtf_)oA_FCn=-Rn#jmG
zL7V*Ih49(uKsr>>fK_i)QEpT*^Won`?B8d*uecH0z|hNt`&gc8<W$oehm|OQMsu0Y
zGy7`V1KcxKYncw*bjB+5X76(l{rSRzSYi3BR{e^W&R=ZEg^E2=Bzw}vjw`dp5*@r8
zozlQTt<rui1%5HN6DP7uy|fFM0dmxX;<vUS_7Z%)!YG#W9HiPoB~Qa$&)+BSS=4Rk
zEugTj1|8Yt>3b-_4YE}y*{VTHYShkm5oczA^K_j_jAG}a1W_mf!T|RUrCC)!UhMa(
z*e{Ch%HsL7^TJUAV}s2+vcr3sux~>;9>YelQ&b8*LXiB#yz<CD6Fu8+hMnNoq={z~
zh-!V5j74wVj7iH)(m?-JIh!Lp=NNRMMo1L{V)IJQDC)J1oRP~#b@2z{5Ue-_vZuf1
zhG$B+XZKf<=0GWX9fQR;o9uegV44r?DLy9e4m2DO?5XI0e!OtZ<B=(Ra?Il*Odimf
zU5`gNiYLwH6+BF@o$dE9orgXDj>JgrOICw~Z;hMudytK<)#j~xaVaU1aNAw<s`ez6
zcgMhzogBWm?c;Ji-BPceY;0rIGPY4V3sRd4NedHa^Gm+sco+ANk-gFh@b`(ukUX?_
zG+NxtB)xe#+;~qq8^yTW>8l5wbosyX*^pdlM2^4nuA>igi@;uKI#f*)ww#7DJu9{t
zB96}agwD~V)|jwI4y)uuInxz$Ao3o@eW&5ZZg68gI)#M3xF?4I_JX^a^r4F(PQ`HJ
zBWygo`_DM{?wHDsU%kye^!#_nVs5TagaQ}%pn0tM{e4&Eb{qCxGVCL`#^F9+%u{KY
zQzpx1)j3$Tme@eG%%EDjWLaOK@G9DaORrgw`}@lL*8Xobr@2Q}ONmsR=i(e)EeG0h
zkZ;ETpV1|iNYoXhtG&lAS9^;$m5eo)*y-2t>>wE-kh<rNbuz9W6T=|+{w~q}E?&^O
z=5$#}n{&+5dd-F<F5Gm)e{zc|f1Td<w+r+{btN47+p6_Dw|CA%Hup(vn3xb$_!wEJ
zS5_V5>S5_Fj0zKT&`(}x$!7VA9MMl6cd6RnT`}URO}07GD#`)gj$~b{Zu)bK^e{ZJ
zD!N;RP?T~V$z<9^>0F&;E24kG1$h_Ydmka+T+#=!$>oA<+;pyqG{7utfmZ?3>s4Xx
zWqe%GW@giN99JWl)4_cIq&WX7BoZTIAv12aKnOow0IlOPTt8y5kf1*@$=`(tvOU2W
z*l-w;U2-^GcxU@%c9qs(c9rV>H6XRs9dMh*3r@axr~84Q`n3MVmHps<#M7?s3|RSF
z=${J-D}Ss1bD`*}*t1^;@~=Abf=8bw-=`CGe)|E18!1+66K0$p7u;ym%-anI6QhHl
z0s+xtZGttWlK9!vvZBisG2`<av|5~Z#fKM!cppSsZ*fWV!*t!2o$;|;Z7jax^Xy@x
z!D>|Z!<#Q2DhpaNx?E*vUYX6jB3!wo({=mM>L=yZPkC1^^*=oJJ}8JE6eMVIPxQOb
z4>G;hC81E;75z(LX63r;TFc(9=HS&wLaT4`uEgRh+Rkkh{BDp-0DZ75GrtUk{Tt=L
z4;!9hef(f~b=)@e($a9e`JFZ(+m`v+EJ5!7I}Y;aIE?U}=$%%3Zgye3qNYmR%`v@C
z?zS*W9PcdAv->+#`#WY%#_h|_3JE}bZL*l0_jCG{7_5}ONE)3z8Kji{nlvhXC(n*U
z8ZFxEZI8v6v7Gdz5{Q0I_SZ0GB>?`U9-1h>&pMJb&pF$BC(mht^IiBDN1rD1#6+15
zpu<F&;pY@Czt)eY#|}lj`4^FI`myv_I1t@4jRjH8l`R4&KUdZb4|pI=Jy&+tG}cRH
znZAvAH!e5n=GK16%j@3xD9(hN8@rRi=sX{#H~Bxg-1+fg;zH>&vnQgz>bDRSe(3_`
zjQEq`!(xQ1@%@i1*@vGuZy|PdvbV;{Ka?(*JTcSRtm_E67FTWIr?T1Cw~@=`m8On(
zE+{ArA2y_(2?RfRFuo-_B%%rzQH>G#{d>EA1@Z(gzHml+C-*Qhg<b0WwDmDOg>t`}
zazE?Pf<fX?0EMEHSztYv$}*}N+<h)||GuwPkcZ#Z4Te7OjW4jnW{P{e>asf?!j=lK
z#7A0xqc1>?P6ZUZeIvJ;PigQp6a_^VcB;?pRm1EmWRG!*GS`YS2a7U`iZUBCq%ay%
zS{hRA0vD-8?F|>*Vf|{8J88vTvQedesL<|!KAAONtJ!9Fx0Ef6>W5nI8gp47`GW7T
z5F0Mh@@o^!nhOT{KmH&5<@oom`DyKfoX7cYj(=-Zn4b4MHlOjUUg^GWSzJ$Czrl}d
z{l7$a>y_{Iw&*Z<_WaaS&`Wq()8QUml9J(P?nT6zjDg0(p@YZfiZ12Nk1Y-!&M#OP
zdo6U3UpGoPqx>%dl@GphrGau2b!6Awp}($ZetZJ**uI7SvFb2(UFYE!wPcOLtV28*
zE1rxt??5$85+^E!O9Q+ZE=^f*N?ve^ny-m5&ncPGMMTj43&z_#<@zo43S#6i#Qe@)
z(*yfyQ@TG+VrXH|1DE<@yy0x8pedV6T9ZzGsDjH{{Ih<+1(!(x5Cxap^<fX+S6#}T
zpIhudTyVZdW!Wi;cD~E}lXf)ie69H>`h?Rv<j_MR<x1pc!*Mq39nSib;fCjx;=<0i
ze447FKs7F{Yqu0m%Cq2`y2k2L`x*O;uH9ldsUtjND9_kLt#1%7cWA>iZwU5ZK>I+e
zQ2bC4$D>uK2?!5<T%CWl&Hs7(q;W>wQ3=-znyvTumu`)?`F?zaBh3T=a3;;XZE;ym
zUH=Hm?6IB>Rhu7CIOdX>^q|LjEL3goZsDi9hb0ov$gVy1?M|vLlT19Ly7t&)Hp#jB
z=bN2fYP-75s0gnP?3fuA-I7?;-7!<RyQ@+%@uck9wW#i&Z8!eW5njEpvr8#~D7-qn
zW9H1Ru9ISk*B{=H>b@bBb!c`+V)t&!jl<~$Ou>O}{U^czZ1kQ8NAZsq?Zm5#eYd$?
zwP#<dT8I>QXP-^*X~_}*h|`iRecfH5L%aKAHf*gHQsG0ncCc)`G|c*xrkX>M6oMcX
zVXOuZvwp3oYs5=+wl$_G$faTc$jPNHi{}8%uMwAq-y^jt4H5wV%I&SwGVxiGo6@oZ
zji|v)W)aZ+YMiJC)nJ}IZZMPcZyco{2vrn>0(FW~n?@kP?-9=ka;R0CB$0|yWJ7z#
zhfK=T@!wBsY+oVX-$I<VVDo!$hH8fKn-`0@nQ!?58O6AlYpZI$tUXe>;(DGA*D7SR
ztJZK%l#@aD3K?Fu!=dk>Y^OmT*?e^mu=4u*Y=@Zi<9ZeP({l;w$A6q`zL?v#e?_q=
zF89fuxLnOL<GkmJmxsS7ey;eqG~%&xKmYyD*l^ypw~EZa&HKOooNir9TJiq{@H@Z<
zk)0RUtCp}+M!pXt|57PF_<=XUh)euDZm|q-dwYW6|L$ez&;a3heLv%hdp;4cLxBCf
z_(AT6;xIlh(z-w3$(}8h${wSNEzOHo+m5q|o4MWVJcZ=>*y}PD!ddW<Y`BdkXjUOP
zWAMWlq#}r=rt0CK1-hk6&2rI>a?wU;f%0XQHnS%liAZl|M|AQ|Yb)=U-pX#V)BFw!
z>XXwYDwa4)a=`ioUivi?0(>qTT?_{kPia!oWv8@Li`kvU>;^Ow4#x3MxlPEj<-jI=
zVg$%3bdD2RT+5`-1&phv!NFeR4knJ;#Skz7?g?UhFNEuD7{3w_q<%Q7d36*r#s<9S
z!W)|l&&`J4TnShHLD5d)5qr$sHjED@!LQ7PANxUR*`&B9!SCaFsRd&L39kkcK87D#
zHxBx0oVrPQiXXa*=Ve|S8<1QH&-h}T`kfN`Ib8cYh4GV;Z5`pFw#heoK8_!<Q)?^#
zPD!_pIA<N<sn!Nn+pMO2F?RiG?D~V^h#x{E4MkW-n5wlkdla2KnNZ@&nZi3;1{gvj
ziCX-ax0NX`gw^8{)Z?WGRlY+ScBbv2(tgP$7>ZLrI}8TOnfQTBO2w(sK`GK-J9rlP
z9rVj{4hx;)A+sMkw;TYMqwBC>thu2`!1;<pgnpsLsRLevR#dwMf}F{)dHT?9jg3nh
z8=ixBs-5^?+|4_6MLYMPlR@ed(t{#<2Svou$s{{*8yMA2z5#+xhHFTi5=U0ii_(V%
z>=weS`8^82VoG!rrjHHS&4pJt7dp;{6IQ}ye)xlvzH>rRwVVEV*7C>KTNRU_6L=`y
zT0X!U51fCi|JPRkAO3JW)HewlYE3p$b8YgN{VZ{iFV~jlVeHBS05^7xsi)Klp&9$o
z5D}zaz2X^7G{d|PYOld9--FDsBcHP)duni-T%~Is=fRD+<B$kyc^H`h;8-6t(t&KM
z$$jS_QcVLh%RxxPY^aU{`K>Hc*ui(v!B?HIKP}4&@hZV9tI0uA|CTf|+rc-=!55*a
z|EH!N%tUB05wb|<tS0a5rZ5LzW6j%5g=>8ZBc8IzzU==400960Jb4Q|lkNY%QZXIu
zpaYSeXA}`?%F-;hnXx(4hz>?gs;7k_ilR1QXBksrPSI&nk)EEuDfgtFj1H8Z=gD}G
z>T9KPNdH^?zW>+je&6rU?(6zo*XMd)pX>9w@7L;N)NmNOHbGQ34_%vtu9X7ubi)}J
z1MSjtVcjP5UNw|^lKOlP^?5LQ?@Bau%p(i1Q35t}-a?et52r1FaUTim8Z2NN2MP0~
z4b4!l6G$2;cW<Py&J^`75%n$@@Zt);=?+FzEk?hC0jUI^=NQSDjbzLUNUepAp3K)m
zxmT8;-^HS|=d950o>6$FpRQ$&zub{N`>x5LLkKYM9K{o`(q?KT3vUp47?bX5({7=U
zXPebqf_Rr_ufj?T$xaZUc?gSc4WyfzouGBzB%Hv@D4sP$o}7s)rhyHWlE=9~oFA`#
z48~BN$d>_eEM7fUtAchX1n}lVyUP&WC#W}Q=n95T+EWJW&Y|A$LTML^5}pYYDyTOi
zsL0_+i1d=9^pXq+r|@bSyyX~e9;|x+4>z&HN%yG%PdaZoO8d9~NJeU-2wFQ)0)a|f
z(tR1$ok>kzhtisgMxF{sE>M$iiRSnO(RrsCywh0iNoaQ|yjv$6;Zc(#vT6Jo8B3a>
z-9(Ty&~ARDaAY>>b|UI_FyPD;Dhm3p2RKoaF_K<Z#)u#Cwg>VyQPLZZ;@Eh#QFu2a
zgd+vnz<!Q!Bz(TqyS;VAK#aKmzWoH<{^%{Sx4w17+ZgdB@twb8u6&4bnRw}x{_WAu
zp4#!3r^#PPqt`6cM>^9+%E@22<f+o~&)0&+t_4lJ^iLZJNgvrw{<6k?@>0;>ALrZk
zTh*Tra-EzZrt9RsszOr}L&hS5$!rp`YT0pZOtMe$u0>^%ldLRTD$2|QWmY3O`5b4?
z-bkw~JUMK2D46AHrUR*D*CJQ+>19&ia0^JrF}G~nw?u=4i8@WQAn}SRi%v@JH%ab0
z7_Kr=nt7zU3JJ#CAVeVjp#W?l0JAU%m6X{R%9$wtE-L}GQi8!|+p<Fd_CTM*r-NOo
z8m7t0+xfEfZ^cFsZ6Ids9x{1qnK`L)KIs%C|6bqyRj7o9qs;Xw#&tHN4=un!cfqzb
z0<{fkzxN*t`;NU{_wbhe+Ox<lg4g|LN;iIRbf6r69Tv(KoFJ0!Db&9?WojqpfWMqb
zD5V<7V7+u4U!h35;xxWOnHHqD`mFtHkxX7~&>(OGwvHaCqhB;=A|Wl`v1|b+Ou%s@
z(G}`YrFs{G<%+AS`xE-NrClsZkaHGO#REx!sY-YxwKvgOddcjeI!moB1UdJeWduoJ
zlc!GJWpKA4U9u(x=BaN~9uiLQIr-}FN77EMEh(@~+8Iw0oPv?=3)Ke^kPI;0tyzX#
ztl$)s6cb?ZM;gmn27jy(gQDmGv5mBzW~f7;cS`|o9>8T7>WXP5pB2<67pYGe=-m)$
zy`%I{E<o}#sEcXHM6lr?`d_T{P!>RnME{!!q?7<DSiw0c>aWprFNE8C&`Z_O#tf?S
z9;$ONdg*KG?9wW%U=vQT3Et=<+!id_#-lpBp_g9T9EkiZKT~ujjeUsi9PcdK{CM-L
z&5whS20|1N<X|8)R-=55>6dt%g#tK&k26XVU?T~z0&siT2y?ssvH@9Bbt87E$64T)
z*`Bs7j_e$H9=Y1YtIbNFs**f%%ie}38npW?#;r4^>P*M2GpAOD(2%OwW6wFjVk^M|
zk;KWtkb^f^EEYUynu8kNLbGTrtCTo_jwqrbr-*WFCw1lmMa%+4bWsB?;5`d)xj{WP
z7kzh_dTcZLE*y;&O<jaF=1?ztp#+OX+nx!xRZuTCiRMs(=!T07!$qt>32nRxAJ2o$
zT#qNrW5LA58kZA{#o!%fEM6tu>tiTl8EoK<c##6dH5B<7yx@%=vVbJ4APOTWfj91l
zWmaz|P%qa~F9)DsK&0;+rOR`Hg?@%pVM6zl$F$JKd-J8sLE2;?U4A1Q_=q$djsiY9
z7!GrV?()9Rx5I_6smQe@CXFJW{qa8gImoq_C>rZTMK%!F0Br>8O|b^rShECuvrrt_
z-n!}&1l~j`r=TxfnZkWvH61V!X*~P+Cg3u3ApIN8dyUa-*|_goqnVBC!VdDayjvS3
zwwE_vzf=Ee&~O7mxY?oG_gJ@Y*l=TvX>L9F>iL?r$S*geNQ<3r2ENVs?_ZwItEX;8
zZFda+u-fTxp>qB66}9t^9Y{Mpa_!AON9zt7R=l&*wx+fwi^qZ_#wzFjAce8&bxhJV
z`_vyb{qoy`hRX=T;SOEYV_np+;c`Q3&cV9@U$%a{2>SM~cozlwZt0Ereug*>UXRjF
zwG3QIY7j3t{YH>K_3nPqa4E@Uy79R6;&1;>$C6Jt_phKeRs}Sk<}iH|<53SLXo9C7
zRMjD?zOo;s6Cys87fcovOol#6FVBAXV|w!b><g=Iq6dDjg)X|6UT%8&@84^)&;zp&
zpE5)#JG?3AWtkh1V#$#|>`|jWWXjuFDOoM1ul#8n<~Um>Ia^8}`Hq{5b`)_}#8-@9
zt{VZ7(tl6CG_D`kU<6XLvV>C@qq)d`7=vA*1D(*|NE&by*OSJ=O(_Y1KKFjh9gT6D
z<voCS8bg}pjR)x!WbnXm#+x4u2NI1p)fp$cV^;onj=w+v3?c+RNTNgJ=@4xOk;kl^
zug^;$gCeh4-crO<1ULwraG{E+3#l~JMACUj2Z_oJ{fu)AT#!gsb%Sv(Q?|QFw!7M3
z&4zbJFM7TvP<JTQ_*x|Ux7yHHX&{9eUtgN@c3SO_a@jG(S-FA0I9JPvUX61plr8<J
zr1}Ka80Ky<QXEq@DVnc_8R3fNE@d+n=c0nk0;1y?(WSC2EJZT~cf}odrCPRS#$`*5
zL3z=j3^nFBq*OSjJXSQvF`{n=$S+GKqUCynhf84eBan!J(XR^d2QqZaOLWV5##0J>
zRJZz*pHtwQGWkuGx_L9<fCu3~jr`^Z{T$4X0tNoSGri%`%D^`=kRpnjV}jqfI()24
zS1kE}I@7!5LwR%Gq{Bx8xoy2xY<#lc{=ui?*DALD*e=}_owMpe{2%F7U(Mi{xKv}h
z)t};woM%wN;!YjnhZE~Tvrl#5^F-{IO72K`p=Yf9gXR;H4wdx(`|&Ae*8_KkQ)LI!
zd)2GN%yYYjUH2snyFOkwR)}{UEA%X`Y5jzd7)8$g2!&CkPHk_M-X9aWjUB=J5FqMx
z^b8h!4+|blfYjBP^_}x!c~=IiQrn&W=N>ye$^;Zx9s}N_Y&o{_8ehSH3viGMSr(N}
ziNuL~=;$aqI#ecffQV%$m9!AqG9@;-4D0GhuOrf#pzV}-i-2dqYZ>qWoJb^VxhTUj
z>9UuMH<mA2J0NA0CclQs?Pae~?=ilD;#1i7_XFLg{#9Ka*!YRRyyTBm*t7@xexYah
z{ld7qolJT4PG)i7!oG1LZ6fsSXCh-F^!e)N|4K0vHJtlL@S7R*l3+%TLKd%(&Bj%o
zly@of7qU3qfkMxUcGoLAR53+VRZNe<t#yrcUqLRef)~y?;h$gRr&7p9H3}xaf`=vI
z>H`_NOpc(0BhV<e;c;K;wsZ#38N^_Y1wqESps^~_Sh*7`uFBvKz2}0@yEF<4zQPJi
ztO%BK7?oIDh)h4R;Gfc`?AK>^^t?=mR9b%wSRMHG_c@($hqj-nGDD6&l^#LDEmO8r
zj#S$^iY*`B6B2Aj6L+;B@{Yv&ZK#0-y*rvNY^s`i^58o0E3R<Me?edDhk(`l+R`EC
zqH~2yF>m|v@L6^^m<y{V06vPQHYbRVn8FT}2-m_#@l-=uPhyDh8xm$upr%QLV!xKt
z@X><^QN}r$P|RrYhmWGDX`$$vWzx`Gn&T%JJlkKWb5%B<{m=E--As<Eaqe_a=&3o=
z4K?kArz*`nd`%L*Mk?Y9S=r1Z?`07wO}BR2Xk-r|N_QGA&kwh-LiR9tXGc(sUC=D>
zZb5y5%Tw*#VWMAVv(ALS?ZIMazV+Gbxd9Qi?jrLc6Yp5Qtl%u3KSK&Ue_wz+aR;ts
zKh7?KP6$AJI%qgj(aDg1HpksTI1IrUsS6pY7PvcMMLS-1%JtYg5k;D_74%e2k!DMP
zd;ya_uM&H*p>%n#7j{8Y+k@bFzb|V;F7>qrb~&7Uzsmu$T35YBCuF*{J&=s07=DZG
zTH>pEO2-peZl!W&k(}8@$M5ysLM0=(Lp;tFFO`8o_@8O5XkWmHb1M1cOFdsPgk2Lv
zP{n%bn0k8Lt3=scHLs(Dw~4^zdF`B>t~@VeY0>gJRv~XQp6h|<66JN_UiWV8#tmU>
zi&)yWM43_}uZ#E6Jyh^w7+UVl7Y}_l9z1%9A9M3XQC#z#=kB6cdjpFfzi&9#eUFyh
zOG|c_MZJk$jxlq*jW?{ZGO7@$^QDqM-BIV+sPjMF{kiaCmA%n>qwj&9@>_SFUnkyt
zkvg!0ELd$%stbZ5OzryJ2xi*{43bA`Tb@dOKUwvOWHP?Z%t)F&zRmg2E}`Vlh8jG<
zLN`REv8-ev2$|eM$B#Mz9aDqdL!t%@ibv}InY*Y0S9D{Yl^!vnvyz>ul5BI!HlT^v
zv->P`3n_wk6hXP<wOjUQMV}%v0F?rztswXqk&+EIk_}e06;9cov+_X)b_i{Siei*l
z$@~LRDJpTZecIIR$Nsj7yKQiiW?Nb`1nV+O_F@T*Y$6LXlUZgKo*GnK%LI0|ef>vl
zW<TC>nt$YOS@Pu7p2s;}z?5$m{n(a>DRHL&KmOO!<b9>CwF}aZ$z`se#{+k^mKfHW
zAScEH59W0I`O&e)e$C*}@;_td1ze4p=Y98EQ0syMWb1;|iGN&A;@;S=`37_R8q@Y&
zDA-u}TI}$(ukE`=u(9m*pW!K+f}?}CL_?KJsr@*i@kEi4Qr#?(uiR>0zXP>u{*s9w
z-2eWSH^gh7FLmEa3p|<4vsp>i?<lq8OGcgHL2q!xk7YkZhv^S*FEcuipZnSh++Nlf
z#XNU-Z%=di#x~R5mhRfhyplWdMWZ8Oo!BSQ9{VP`YtL;jyXx{j=(fj|`p*4<^{4kb
zCR$bX7I`N3T;e|jpUBs}2Y0-xH+9MGSuXqMZZI!ujtz<LR<Jx{Tkc-HmE`F5rEP!F
z9(BMDb-)zjUy0EC#+38U2aPN4x-lMnY;)j9qOB`_JW~EMeX~XRkL8wA&(7eF9rp~L
z#*R+bw|oqO-`yBAHSIP!DR23Bp!l09a@1^4w9y1{+ypy~o=bmg`4oN}DS#x(zL~m?
zn#GGYN^sLY1>a1;mQcj;3(ToZ?5J4}ep)+fh!Pr|zn(v`bXW6T%A4$Oqq=Z^-K5iv
zrb&kF`Gg|Phby-}TmkRG4_6YB&YJc1C-wHT52tMHT}-6r2YKF6JnMY{OztH#-}QU5
zeQ)#K%G%pk9*pWL>BG|z&%QTwefQ}2-q6%k`$t;n4zlCbK6zm66uE5n4|3Uw86F4u
z{a4suCej0m=)aKC1AkAN`(~{;pWx-V{kL!`ZgGi2jga9O&v4}67I%Z=h8?qKv%ize
z%0O>4=v_9EPQ}fufS=^hXX53dYg!O=oQmcsrE+wh($IN0WfD%wrpKyi2GISijCK(z
zbz})cH=)Da(P0i!$G6{jomd2Yv4=END$-ccv0+_Qj&i)ZEiH6$E1?)aRPOkd9X3(T
zNDFNkV=qh#?Mx5#wST6uOi9xYReY<?CtqAY%C<`neUTPgMZS0jT%!ClJ8Fy_HBrq<
z3*D05wSyeL+TNpOMwN-`d+A*gay-=DBO$$Oj=e{cy+?<C;E?Z%{Jp6}a(t;cf|b@q
zv2Sp<Z>SbW{ERKVi<90ZBgez+8$#_HRN|g?|9#-xeEDCY&jvsgfWU*e@xAimB9oeO
z)0&e$!+)#|TLMLE^1lRzMOkrPh$Kx8n#*{N^J2~xP~9HG+OVW&2QCh`fslc?2>QoR
zhh5QQKf|n)q;AOWk`py6=%}%T5a1@#5E%vBbTCA!D8FQ+3}Yk{tc)&y<d_F?j3}A-
z8EObE-6Ol}EKx%S{hnFrGsgG)k>(ElCF88G9X=C#eA3*nj&(rO+`H1<srCyiEK|Bp
zgEH>PBHNHgJIvGF^=a;9WE;^>89QiW9khu()HHWax_cbiW{rJbKRA6L%QbJ@s&gwy
zI;+l?$vOPlK1G8*MMw!=kb?qe+uvr@X_f7sgw_x(_!l93Mz*^WeC$bj;2u_0SSiTi
zGb#%!hpjquVf=^S_t8unU1LqqGvRzcp?f{fXa^l<5sY^5@qDP%(%Ylg3cZPj1t3x+
z7OsIo%BUx1WC(;qIHEap^rkGDgrOl}^lBL2SsdiKPewb$(llcAYAAnyK+9a}HZRyx
z_(3|_0E!fdg6C3Clt3YV=zBKO9SrQ&nGL~8cPMFBv2dnvPAxTJHG0)D>5`w4&X+D}
zhVoG$X`uX_k;3b9P^*$qtJt&vt`Go4a;bnqHX%{0j4Y%Cx{zi*7mfzcWuO)cVb7OB
zxxy?71xsB;rKrTg1DMd6sdyHUej+xsQW7kqQ1*q;oJ{l#GrdLTbr~_s)*-fuNYr>(
z@ZVEud#&^l2z`+Sf7Q&I+_JBShtT$_C=qh-c_3=vGO1@SZTZhkr1t!V-iMWXX3>^M
zqW5LeB1>qISbaGB=U!MylWCd~1p2*%wmy%xo}nq(K<>UyN52n6zsE|GvuNv;w4;6+
zZ;U?rml9vpw4-#5H%kAefM$l&ZzAYti4u`i+LECQFo-XDCrg-xlCI99EyKa_ztk>d
zV3}|ThWejS^gp?@br`tw|7q}VHtp6*>VN1c`2I*?;vAG+63UKE^Z)<S4Q2Uwk!I;3
znTh(0#4;bRpJ}&}>Q$3XBXEU@XpkD9q8(&(q1gN&xKbGzeM@XUggNm|cy$a0A)}M*
zrGpsGgrurN6`dn?_zdfB@wb`~>eHxfd-kv6ORXW7X~Yh1F^sVe)%ak0T4KSkTudAY
zVeSSA57H}Q<$RN&GSi_GK1~4e6j;leh#^dO3sEu}Ym-ggODU_7?D?s62=ltv1L`9p
zzKH4C0j97LHq<6e{8_40lqRE<KCDu58JnHh5Qysap{<Rgt+mnzRzf)^6FWJy!*le#
z5XlE~&Fy)b^>g)6KWnDN(B(?W2e<4*0#S3jh?2V6-n&q|VkTD|j<>!(`6Iva^pxEp
zOXK>16*un2<j+F6Hc6IQ!A<YR+{n86Y=7>T;I?ynG*t+UcLy!#F)b)wLm-j6-P`_h
z{Td1m5Hg+LNEo*}6f}0Y{Z64Qnn`yNfD2JDQV-(pXk^h;x=SSP&L;YSDEfg=eX+yN
zTGg8(8M#^`M&Qze>Gpwi`->XOnGqSd^iW*7Mn<O6?ZfEXD>W`5`k&>DN7A1?i%E|K
zNr6e<_egpyLvub~V~-vpJc5Cf4OJ>I-#ci>34Rmh(&-}UbQkUTPci#x#~W;iTpmfM
zHMT=n3NWV2q_c7XlV3?a?>Dq5Ryr#SFo{H)W&%DXfDhJ90!8t87yNioxV0e*Kw{l!
z7&jr@8v8R50i+T@(s@vn8x7}H2(xY%F8I0Eblz%$+g7+WQ@G#;&TWoxL5FC;CbX|P
z%xL!!ng;}9-MS#sQW~$?kLQ4M3;lHrN*$%8G9Z}3t7h<)Vcc?I*7%vM7O>aky2PK-
zZGOC3TWuY8yV`mY<<vXMsdC9b0=93)f)`6XFi^mp;Nypsz-%NiE8th=o+*M2m&Ijm
z>&iv`GO?drW#h|;zs`29fymP^Q5d>~HNTkRH%r3ylCaHr3MT4j&7z~q*}xtG#jjk_
zQ6%XI1%Blsk$1g_;`hkPtw<y3h_|r5FU;LZeK>Qrim`5|5Y`w`E{gi_CER*G_2Dq}
zAzFGZ%bbpm@j&-UfOQ1wLzMKOjr5=bSocfthc(oPbabD&^q`}3G#5DH$7}voD*8y$
zQ5kTA!fRe7h4}DJuz0iKDx^pPPP8@~pkm!RAW{*HSLVk<<J{Q4<P$kcMKXX&;gvCX
zaEzM>ro#Rz3aXa*QaVUf3n~3ZHo$|rahJMTXEO`3h2U(TITli)IWGr+41oex3jr$&
zUd}o&_jD9qPK1yt%?7MELMB*SYuZ~w2Vxw(!L~Co$C=C5e`$5^ySA~CZaW#%Gm`&Z
zHP5ed$gi?g%KvRd?D`*2W^d)4`k_Hy6N1p$p-X(MOC08T&A2~`IbK=YI?X%_f&gNR
z_`B*}UHgvkxS0i(zm6%n_jT)T!27v1Pn>k>{fc)?iCf57H$+9d;%ME7B&0J)N2q_Q
zTS;KWmCCtAa&DJy<<Ap#w64C(`#D!2PFm6(Q&REa+LJg&+!|cHvQPeaz93&62nO}|
z2-p)olcdFca_@gL6r?5v$su-;?fI!_3oyFR{jG$fPd2YQRI*2PCSo8yVt}*i(9Z#8
zs#_&kK%(!>6ira0>%^I^F}ns_T|d2?c~>J-cC9#`)v{sST$Eyf!9OL~qg?H8wZCX=
z_jmr(kHHRtoys|F&OT1_)myn4;Y;>}F9~*<|3BZ%33Jh0BMd$tz+jhDizQou3oCiS
zOJp;ms56!rA$v+el7aMo&UJJ3N`1*n3gL`lP7Aot-xZKOu5R3sEZr`ic595b(2dIk
zALj{XN7S)=&h*c@UdZ%0^9-^F5~9r_aw#)y93A{JPZX-na^UW&<q;jY7oE5{i~=}r
z<_H9_wF{Ih50&w(9l4c6uAg!x1{BS&hNrs7Q-x}C9k`W_+$V~ayBP)YnE*qzYA3F<
zawUOL@XC=pixED^2)`g(%!KH0PVP7-wvItygqO*bMKWcmj`6D?hF@faGjL8Knew76
zjHz?1<Skwg%G##qEp`bE*MUR~4DT+$*JkSCOLXx(ZIJ^1d0F<e2)=e+N!`J>yoFxe
zauV0Kq;4k|TR69<jvXNP(7JPd8FG(!zP4Z!_tAyA3a~A%QLHWaSYD@`bl9sSw?({4
zS0o{0OPpiv7+k_vwxUn|f<Ni-PTH1A2z`!Gj@c;36m6-;(u}EEu{OHbpX>6K{al`|
z7#k+H&5MgQt=DGSoo~)$dN2RhRlkYly&UMOzn47RZO-u==6IGV@&v=Bt%L(zmFEHn
zd2$4y_^A&6Scf0xA=Z;q5UNzqnvg&7q_G4vNJ+!p?TUmrhG%`Bd@TZ3+$ej@(Z!YV
z>MzMwUErO$%$x7nO;LcK5;ylSZj{L`u@niLagiRl$Qs$Dk#B}eR9$$OF1&{4#MXv|
zY4eEPU;fGudh<{m^u{l~a9{JOZv5WDeVS9<agp~E%;>L@=&#uNWbXa{V$5&u^=MzD
zxqcr~VMpVi_T#r6-#|_=+X#YqD7iZJ$s+E+2oj`*_HNy+_dGhE07g%sGuEeYdWdp8
zOQuNf!B<52@XxaNOF2C_IXwOOJLgrz_kQ%-CA6MAS@K?4a;N5cF{o8BwxTzl)3Zvh
z-w(Rg()pGl+S9~tUoceP4*@Ule++nu0Wo989Nqq(Xdmqsf9+D~i1I5AT>97e-F+W?
zF_Y?L-KYJ&@cq89F_XZkZW1``JlQn~|DppS1yS=AH?o`hWes{#2ev|_-_^h|I&ULN
z`&R)l3n}m+2uwt_NGeb^k>O`R!byW!z$UC97$cCtNwoYRGEHb3Dza5j7s1hHVL$(@
z%LP#V-weKn=p5fEkc~4oh#Rd0`+4}&N%+%J-A=F;JkEOIe7d3PjQu7@e|0eFL}>n=
z(EMOWe=xJeU{w=WgZ-r-z&AvDwm68~cFQ()TfP=-k?9Q%E`j-NAQ1!edkXNaf3&&w
zwz*yxFbnXXzZqg8_yXHf+rzW_*HK89H<4JSw!6VW2o<`64eli80C}IropiYXPbicj
zm^w&mnh~O1=5=qWFTt>Da1M7t$<?R@>6XmjU#QZ=%-_$RL4jHQwP)8L){8XMqN67Y
zIEMr>FA^OLiXQGoc&2<pZ`70i&m_+4w>l}vu{)oZqmhSfC{fFX3|4ePRYIrE@^6D#
zug-GNV5VXX{{F)<!i$v0WUb#Ruu-X>7pg0nEHIyg<cWfaKtffl7b#G$<9n2-cQT%=
z#_a~bCUyhw8+LyKVE{2>Cmgu)9hN&)y?h*&H|22P3hs2@bTx!@hVsM<CRmcKewL-K
zpgd{olm97`{kJal=zDGo2my$(FFl9aTS)_bwj}bnEq6fO_egz6pgNSl^3aoR=R;3S
zC7-+`pUe%-+x{N_00960RGE1+l<)ulZIQBs%2M`a$dYU^){JF{8OuljOF*>0StCoM
z5Jq-`?4hx5Gb0%@hVWJ*yK3y~+ZYNVL}OpFX8BI<^ZEVpJLh^{kLUfm&-FUzy6$Va
z?{hEyGoLy1#CqV|W&ck}sEg7IF;WW*SNx-|7llX51t^sDp)dO92mH^zOzAc>T6m+S
zb0}sa${TW_LE5_8FhgHq0*@-v>xMR>iY&UJN^z+9Oyr1Fw<ME)4=d{K`GpMT1@3eH
zCPGEwNjTJ9uL}(l*4>h{W<;3<r5(R~^v&RW3{7+m{m~9NdI~%ux!%#oY<iJn(Z?xz
zk)1o|E~f9CLyisdHpl2xk>(E;WP`)EudLCy`adnuw7k`0yFgPnO{an3@6<;(Y_&$K
zH~)Z6xJ!u6`9$X)cvYJn;pJk2&$i0A^C9i3m+XL)Bs83Q1r@B=Tpz3OLobGA7cGWT
ze*V~wOVgQq;h-v<7LKYI`&733TBhkh#C9NIo_EVvZniBw>dfQZ6mMfs)LAFvX(8Kz
zuf%NIw{yn=%*S@u>DxLPBL|p{FaDBdj7()YE?_%Q<=%Ya)n5HR${9f4=EHy$QD<xI
zXo2MTjvsEXH9E990{ZG#YI1xp?OfyAx#mYYW`1?Z&a?Ao*s}9K%fE9?V)6E9-r1n*
zsb<pQhSXxw!)_#?V|}Cf>xtvlrnXGi{r&qL3bDsh@y8z5McaBnk>pq{I$$qqW<j(~
z1{9eYdyE&@wwGI|2Y35E5Umd-txJO<UnU&qupP>CZ`(f?J!1r&8ebPZdy#O=$+LYr
zY$?=#!lIk^hciTRUwGl+y6)(U2H*Fn87a{=@6v7TusMEvQY(8Vhj^@J^0R);>QIpF
z0He+jnZR<K#(MDZZ|DD7wgW-#O---%GdKFPoua6-rXKsNF360;vmWtNLdrpr#2j+M
z@L0iUO654rx6&~9KFlIXY<p))l|F7LVEmXmw=*SKpEUiGrfi!2`jcmc(wZNSoU}Nr
z6!bZ(TF;6&suVtRR7FOq`lRoxu6K1W(m&dXav*Rn1Rh0|g|t(&P+mfpR5@2iwG31_
z=RZP(w^x1_H$Vt_#vvG;g>fo~1_>H=fe|Ez)9wqwmsCRf@T2c!Fi(3Ekw3(rFmyP5
zGv`U&d6cp<kDR;C&GqSdv#`BiRabQiV5?avc|>-eifmL$ekVK6@5FC7<IGR=dyTD$
z4mGMu@f-vHeBra*8{Ao);z`5b&~w|)fa^6&eh&OYhuK?G4*WL7C2vQtJ2%!EXvn0&
zuC(PLJ@O92slGzJGb*ZWmL4g}cpAfW9Ou~X?Aq?!$+elQHG9*%z2c5B|9{rK-8mzw
z4aRtyeD3%P>w&E7?77#psVOV8X{$6_4Q_X)O;A<l<G}0m$N|RF38rv9L{`I@>d;BG
z`#RFx|LlqCewzzD62x$7wC>w1N{{@)cxuFa%+7jnttqOlBdRS`eAYLleWoC4JT}eh
zz+U0F^73iUd1S=}WEaC}8q+a`RUPZGm-h5R+kD~YjRpLs<~x~Vg)#iI)x@w9PB9<V
zuZC02gJM1f+74feOGJDo`25HzB=by~yFBM4oSs-{#N|g`Wbb;BFLh_C_SPJpKdJDq
zqmo*5I-`)+joWn>>Ce70HLD>mlgzJ)`xK;qgmaV33-zZ~c&=_j!R@*=iCsFTJ+-WJ
z_*Aaj1K=qYnj44@W=IK+Q5VBT8EZu+9i0CqodlRA@qp)8&u=l^*ou{#V>Kc1G>Qw+
zow$*Bwi5waTu`tWc35F9NpUV|E-_e4Xv;uqPQ17z<v*)5mjov95V@fJV%R(bt(q%a
zUx#W{y=mbP5>H<uK#B|cly^&lZ%e|@K#TQNFgMSZ<*=pEf0lnsLSoKjG!fY=b}Ex}
zKp1<@t+h!~NfxvwcRn{WS6<I6kg9p)HSt@}x*Er~jq{7ulHm-o;@KAYCCw9Jh3(Gl
zHNa*`Y~#Gdpq={Ilvu6&KTUioAxejiDey-#9eEzd3Y{uR8?I)Br;aJM{wX2b>aJLH
zmsUek!$n|k9$@JfRN)a8P10%**tsmXC<E@dzTf{NNgi*h1pSmxK=oT+T9jGMBal#p
z6!8U_kZ$V&6bs0he>+QSLB_q?Is-+3f!06iuiw#M|G^Qm+EtWi#P823<j+Z~x&1kt
zP+_j!+Vkfd0Gtg3))3k*2wLv}t;>McP4w4^@l!A3re4NQtweN-zb;{G;N@({rPZtr
zxsKf}w-%=TVy6ldrY2*XB@tOWgxf{BEkBQ`=8I6@z|-F@qWhwv`+k6ckGkWvy>9DY
zG8<l*E$T?*|M@Dp1LNC)`H{4)yb8I&vvcW}^doF?msWO4$PMltm{-5``#gfwEvWac
zgr%!_Mm<`po>)62sCgct?h%$5gq2D|5q^k5AL$ES5OnV*Z=wk4qEL`N)`&gC?&@}}
z!~(qX^K}$KGA_i<DUXm%gH;~kgKR(9g+%V)+Cpf}QO!v9w1xPebt93}6A9MhSgfIz
zc2aQYMUCT>ZWYr7s>b$j?vT(Jtro#;Hok2(+M{LU3}NQkRvWgA|IhMovq>!QkD@%?
zM2Eoo*ncl*;I~s~k&tfXUX-VV=+I-{Z8N@YGg?a?&JZb{?Yh4$|62ZSGl_+KT1yYn
zAv1mKw+X|PXdi#xTgo$r{c=HE%9)O&{^w1J4-{t~%$*OuDzqslHCs|#!uFq4ntcFn
ze_uvF)XRXinbz^1SXd+DEj_m1YGrz6=WEIKEIe5ADcbA3`ezTmawc03EzEVD(eYL#
zwMI0SHAhS!=IWtg?p^<?v2UC;aMq6-_g*8I-@JJ|)ch-zych?Y>x7f@oS3znj_Kp!
z){#*zPM?Gy=1FZavXS?OI2F5d51lmT4&5Vf?YXy(FP%~Qj$Ie}!mH5-?vXY7&Wp&{
z)&Qj$jie29e-LC&6R?l5J{mL$UrPD;hi4Phw_7s_4Zgo{=6kS@#P;p7P7S*ha2p}5
z#Fe-OGMmmezn+Er9E|&~<U)O#!~N%fTBkVZG<@g-a60LPTt5bOAht<o$!EZh=Gl1;
zef!6fxlo~i!^Gg9|3)&xoj%Rz6-aGe1C#HKE*{BTX<H#kxA1pX{6;oJCci6mX+HjO
zBy)tk{UtnR{FQD~<Z(~z>diK=s`vKx)>7`Pw&w8To}cr+w!c_J-bJZ<EYRtQvn1ZM
zV(d=2-tM_Try<UQ;@8l_q%%GsF`AGV-B~Y#O<(IdF`Vn=mPTdiML(Cc;AacYS7&gF
zXK7B6j_yT8<^G_*DbDB=&(xeEu=!4I*1hMlWsW(Qd(zgsso)3jX1QBVW6zVN6RZt1
zz{@|Up<KfN(cdPCWUz*<YyQ=~2CED>?H#JC`Zo<|qt+NWPP*cA>j*x5`+QY%CLE^)
z5&!vt28>bfdm0LjdMn7_5RKF<01cCHoW2%;%PBr$rwGqw7jHv?FP!!M^Eo)x#%=t*
zVaDi<3^-1#fpla0?%Oxbq#GGDd{?nzO}9xFudtbWP??cubR+%ky(G^Mrb-nyVzfX3
z<;MF&TPdz;IYN4`n*gz&27dvf89u%DIT?I~EjXLj`#6^7<UFHtRFv%x`f4#or#PnO
zWP#0cxmlYYPKtR6^tbW1;vxyBY@X^HNw$)tiitrn%CoCPW{nnse8cija#rTFz*jk|
zR2qH=R;;`S2ciwjzxe)qdG%ti!uycGpY_{Ls+SztX`N(88+kn@gHw^_;x$KvF2Cwe
z9_a$ha#o;0G1YDw!bD!$n#b2lf$Yekt>mRmoEiBBcEfGr>kh_DS!bq4C22`BU(NX%
z;lnUo-opB&dgVFD6BELRJhI&=+&j2yqLDoDt5!|RwO9QFtu0AGEDXKfDSrW5Q7^V*
zA&&i9HueLy!dLG9d*$Q1zB0<c*ax0YpFGF%rMCKkWW3h<!3qVkT`s)xN$F_wFcd%9
zs8u?aE%QOagc#^;?WK*g<D4B8hpo_4LNmOyjXnsK9?3V)*8?fO>C5#>rHk1PtrRP-
z2!!2C68Y#?ZR=vKPLSP<DKVrNU_#ubWZ606M~@^*$84>=7~^Z{K@;uz1)N7FICk|B
zW^OoROl`FMNPJ?gC<+cnsWIW$B}d}f;GpDMuI5MLf^czz39#4zpi*T7rDlXn#fW&P
zfUi9PUkkvc%Hs}S1MW=RH=MXH=52;jyO*x!0xnd<nakl0i;D~<V#U41($z%4g<r+I
zlfi`y`FJL{wcZ3w%)1w*Rthfsq^U+uR|DY&Bu0)$OqJQGL5aUL0pK<eZUzo+n+LbO
zM=d5`nW#ZGMm8iyHqMW1z;Jii;FmxGZr=@Zb#)P0GxaQ68<Q^<_Sfz#{Mmbbf2O`<
zWU;JPBM%PAQe!C{C>>ceg9nt4p4<2}lHF)QyeI_rl#w)Z>}8}j$E3sm;lY3ER=NL3
zpg*74zJyI&_^Gzj1@WtIwf~GZ#|-JHn$LYB;LSt!h_)9OYtIEtd^W|OdtGFPmk(C*
z7R`iT%rLY6Dn-ueu9bWZH_5AG!plpNb5h`UdsUdGZy9(B#F&BHl;lNfVjuUYT+WUM
zS_&kaf>cY39pGizW*7CK8D=1go4}1sxU>nr*h|T~16Ah=wtoPQ_&a*Z;@*<!bz)%q
zZ(`o5V0*^=F(&vEy$L%p?*UXD9z5BuS@&;x-5s2_gq1VAG&R0fUd(%i32tvNaSt?+
zBkuh~bT<x5yS@UqPpXx_GjY#wB2Co03sv{tBiz~fm$c{c^YBhz01a-PzMh)%^~R-Z
zpUlGE)M`t6-^{M_G@Z0A6`U2+{AH^7dW6Hjb6?U-^RaRypAvh(XBD>mc(~aYb+Y1<
zESH5ZUsHtfg9k4Dot)yzk$J%R1ZBdHe)z{pxCkN(@}+_NjH-fGXRi;O;KDp-QWZ=h
zr_I)uASTi^*1(wOF+r<1&9zvFCKn+(<1SzT&IC+-HmAaXF?tLU|42SxPuBZoiZ&{P
zh~voT=T!6q1$xj%N`&+=+y=|Z0#3LGa01q#8fTd3jyxZErH{9al1f%gWx!izz%M@%
zFwB1*AGG>bc`e0Ev(ID(>PmfUe&lEY=LMKHy&h307*TM5^FA5be}Q!y*?0pva$La8
z#F-sAj+*Eeh^BggODf%#dFce*l~NabRP3b4k2B0lyffjpu!$@E2uahXn2{<gxGla`
z)@Fizx~8zI_S%g#sZ64C)aZ!$UHtcSco4v>Nu0bcKwd|~gZ_?I(|flGM|1plccnE*
z20TbLfA1kAOp%~1N7#%_6(Yeo*J~3H6ED=)Tvk+=F`ZEbd~+(y=uR-<RzI9AaDr#L
zhOk}>0Itbka&AaA{2oQ`=@VMe>T7Y3FgPU4kI?egGCqBy1HEU3*~@^0aS>WzgqD2r
zbU)np$;eH1+K|l@LXTR0(qMMf;te>_>8|B`O$Fuc(c>c|$T}%-;ojPt&5xWhaA&s(
zTgXwVWKQb@ZiX{^FW^nB@QpQs%vx9W-g~K&k>O0UqmxmSwj%WJKj}08sr#PbKgzfh
zdEDtRRBUZ1eJ>aMhX;4!oz9_$V~pyji$Tzd2#Tb0JOr~?;23`hvMhsH#73gIiEXt?
z79imHbPoR*#3eC7oTwlvo#P$q2n3Bmppp?N17M<vAWlrMAI0GTX0capZM%ucQa*jC
zGtZergVH=_9cC-x^@!+0kMov5rYw$h(*(s*P}xZFW*R846l6)Y(3t;|xmH#@k)q3%
z&k^t$!KWmMza`k2&+*=f-zbu=a4UhRe5$B1Pn*Q2ih-TNgJ=#<NP>Nj3f)nU8xRd3
z|4_>30Q4X}dMgP=n;Fv;aK%#3KLqM434Y2;du?X?Su<@kKg|Fy?ye-cLP)n$5{xr7
z*02O#$W9x{N}Dq^en3kVn&AdCHOH5@DG3^8P^DG#(>%b&%D9rsp-XfXE&nc<NS7RD
zS{U^Kic_SZ`uu_`CeqyqHYGvE$DNn(kD{o2JqWf(z<4FWiyP|qJb_p9)8ark<nd37
zb@#p;4$=i)*B4x3T2_w*LS6vVK!Tnpb<ACn=$=C{kNJM-fbw~VNcGcshq#V|R{;@3
z3&EkXG*4Jp6Y+D2U>8sMyar_}V>wtquvwnM3Jzpw&(|x1(3SH@P*_uznM?!4n&%BL
z%LX`Lx`n)98Dz8!qF<hgw!p-~0B{(<uRL=K=CTU7Rh|he&y=8;#4bx@FS{89DwP1g
z-LPalE-sO?1nh7JzM~<N2Ja-`xl#!IZR^BQ8Ii!`EMS}oM!ysi7lbaqi%GU3^m404
zy~W|ZB$riUfdj0g@biHM%z*+4zySewzC-w10}MW=jO>;KOwB4Ik8%eB1ArI}%=&Wy
zI>Ayhb&86hB7lCt?_*Rp1dwsGUj*VAMdlx&vMnN*1A#o#e)x5S6cA&A&WHtC2LLZ(
z2L0y{SAm#P4NM2kYqCdGk*IPMsvH$@)em?#5Ll>z89)!#<yb`zLlsIrc1lN|He?l;
z=UBb>&b10aQLpPMCn#bV&6dFU06wxt7S$oRs{u%E=tfjIn5J*+E_vN0hLj<&Jf%Ap
zR4sF=RuuyKA?rdc)=fqg>S#KUNxS_&>j_>`#_d$P3Gn^hdoV+p)bM<>rA#;Aj9R{e
zUg^d5eug&)dTB?IY=wuWycVSwe+cp}oASOHiBrmF&TwnAxQl;@qKW~`cty#E0%Sup
zRqXHH!&~Fl2sX#RbW?IP$e@a;<|}wWc$En+ze5;{OAw8DnvQZ91t|#cB+xMik{eYZ
zNuqK;Ycv2lenu-4LvlZBDo`*AhJ?FG))|moFGy}N*&Tvb01^6B2z?*P?mmR*;cRtB
zJkU`JqaY5+B|>tQ34QtGpE+bD`e93;;~+*M7m~|E=<~)@=@Df01}@AY&Z#?!VyYfO
zY%K_~KLl-;A+~SG*&}fN45+Oa#I~4h13_2m6Dm{)6(7kqW71!`t6d?sM2M{kp(2rN
zQ%<JzQ@s`uA8gQSFCyQmI}W@gQ)n<xCR6G<r~+<{%)@U*&Bp1-su@&)P6WGq<JD=u
z%0Yy@lB4WPvIlpcU8TBXg6X)1Wg|y+6*;SF-gNvy2VD7=NisRm%dZh~m9PS)K^`)$
zj9cL!*<DnYK*Slv8R$9tc~rn3dDazpXuYSXBq`gQPx7i++!h&SZ}(t~Zlr(hgR;1-
zSawZ%G<7rWT432Vu5x(dUJ^S+&>HShQWxFGTI1s%6UgKG9q00$RO6#`zvsZ$KSFB0
zt|vu>rKtyJq4-bFtN~-8gXHCZ3i-bdu&sKm1k8rW7WVj@d9+TpJy_rKm1;UE^bYz{
zFETD4<$3W(<GGJM=??XZRrb>3m78hyfmQbDEB6{EH(a55-^$&`yb}WpdEQQ5T2W(P
zQA-Of{4n|IQCsTTp0716N6+_DZ?}46VdG>Q#`61Mna}Mav6{mG$2IXU#r5HKn|qwl
z!sx~3gC(EaDqBO}eef)p6^?~Q#?4g`hakFf!HgA-&Onx*jkKjj7z_mXtFr$~JZCFg
zZZ!x|CR)8~LaizQ+=4{EISPDpM6W7<as<A*o5Hx796f3^CLOE9em%?;P3CysU@G%8
zNV%?wfAag7HJ+4yuc^lx|9ppFww43UpD@QNeVE*nu?`zv6}nWLkoTR@V;}rJEbp84
z=&Dn2S4-o!mdDSl!+T+h12thERL69fnub`vMx1|M#Qa>CrD-U%H;eBiVpYca&nPWp
zCM}~eEh99dcQg_os7r2~IpPcE`x<G*xw^F59{GTC6+pve=q#P9HXVZF(pwg~75b!I
zx-X$ouG;4}f-Sm2FVzTT?dmCN*iZkqUXBJm-bL|LBn&T$4lIlM?4oQqXTJ)&?zW45
z5K@;|i3Z_>)Nx~s3H+2VDa$UmZPX3c6pKUithMEcLQ*i!Nh|Fb*eg1;c<eIQ>rewL
z?ayUG#jsbOHH9cdA;WTGR!aAtRljBG@-19wKP%-CcsI{zmyZzIZ+@lol&>VztTfcj
zO53PR$eJkR345hn-Zf*L8imbR_Jizx#D$_Qw0-XGGFfTUKZ9H<2ShEin(Q)_gvMB%
z2u*K=VV3v7yJ1GzZj=qxazOgB2>=EaqhtzDGSSOD`!Mm>H;Y59N<*!zv`xyeFe26!
z2EA2InEH7G`x}v*RY3@D2sO>AAb=Y}d+Qud=qpd@{3Au~A?Ye~!4<lS6}lD`gdc*?
zm3z<<3K{3H)@vF?wrdDwuEF}n?6SFPm$+zuq50ej^&`*w4WUNzwnN?iyKFMHLuEgg
zUzx4^En|^SF7ChXSeM<mM=t!S)a^YP6Yhyzc~$qP(ldSKL3=>XGwq8GL#9=p{NwMl
zRy2aU0)XQI-Mi>1-@q=|I}O5GJ=VB-2@|aS%4z6{(@;S5Qsv1#jnk!Xkt-pAZM)4=
zzS__|`=N?ImArgkFS4zkqpi3@G%r~4S+p$!uNw_82HvN#(J#Aq#bz78ADx)0cqPYQ
zrmPtD?gE0liV#)0qT@wwk`Kjh3>@QZ7;-PINCNKP6dk)OFn0I)iev?MdrceZM)X}T
z$!8|_7;<TeO)8lbl*@DZDSbZWKP-o>ty=ntPC2lfJmtCG#M2ZQl387sr(BnjQY1+!
z;-?hJP-HjLY!T(QsO2mAs#>PW4R0(@&Jj=NVwZ1%cX?BnZ=#oP`jji~wJDajmBEnd
zFr+99X-PcoEjtw`ET{aK9}_kPBwnBjP}Y%2{t30O*m}GLGHN+*?|e>p<PaHnSepuY
z*mC}?;O!IS&%m|ncU33ZqaWHP#y;4l@7S~lW<P7afUY(jwB=u_$lCGUOlzZ}k)Xl0
zp2o2YM7Q0-d*e=^p>cF@Ydp3Zj;${CB<NK&j3|qY-=~I|%STlAjO+`@L{t+?Hv&CQ
zfp>?-E1}6<ybb{BArLw=?jG6-8QBS({2k7yJwxYsJ8|jS>|y-x@E0MiceKwqHV&HB
z4}*RmH<=CnUQM3)@H?DGV+Qg0P|ClR=-1jq-Z7Wep8q=IMm@wAV10XkhiBrJ3cW&G
zJIbbAVZIOQ`Qj7wjYD4kkdLJ4Fa2qnv}ZfhBO;>;brVN*^_GRLmW9ohg<;FIkNe5S
z(Mjpuy5<f=Em&y7$qzf0vY<=Lf&hyRkx@;7QO)bif`3oejeqRfHp=SxrqgK>rODFw
z)^VoB39XRVR2YD!1f)L!NvpXD$O&M}OUOn{K@*AU_$<^G*wTldE`^-M1RdWEI^qSM
zyi}L`<Aj7mHj2q%5cD*Nu&+Yc|40t=A#l--*A@b>1%R0rhinib8_I<JeDa?~ki>;o
zmpXbQ=D91U&;EJDI1sW~-Qw#o=NvX;#@$F^dAv*C9isPEhpvJXM`7t-X7t(>ZJq~x
zUk25B3B0i`ws9KL8Re)Bjdc>%*g87jqBGL0Gv_4CUv1VdZp*>nVC?a>;hV9?XO?rX
zQlPNSZX2sxfAaDp`ulb2bif8+mR~Y`l&)rn2ss*X4iQi7t4>oNo-ykndHz8%er=Qd
z+Q$F2P39|LGYyLP2YP9h=Rs9LqNxhB)_+&VD`MGT#d`DzMn1}V65*9yp}q%w&~OBk
zw=L?W-IlQ}D*w5xY_!W?a@2oxL9Q_n%!kOfKR0x6?~`(a&1TBeD_ZZr-v~~-SM&nC
zL|P8`=g7e>V(_gF;huB5X6tZet6s&;g?rIgtl*1rbvB#aHLZx4T}jsnqDw?iO>1o{
z15e3W#u{TYY@gn#HzF$6O?bAnk#jQ{9??<T`c8*A^3i^>#F(vCO>0Kd?iG`_)lYd=
zo{)|Nel<(ocV-+L=U#adzpL7D#5}!~nzqaC8X?Xjd(ya<nsa~V4W%CPw$-r0SGB^o
zfl`0ZwW9{v$Gu{&TGN`Hv@37&)|Wy$O0$gUDr<c|W_#<_uw_;C^wus#v!ONAc+7TV
zb<B49jFGq=k33mgJiAE5%ZvWLL&Teys-_y0?;CHX2@|ab?$(srv43n$PU3PhyN!jl
z=rWhx1EDR<0np=Wb=VHW3$Ft5e0QN*L#tA1?@@1a%!(|T)*rn21LqK=KDxk&I;wJH
zfE?vHN-7d4P}{QxkyCV4Rm|rI@%Vv7Li{u<3eKRH8Kr1WXT}4@v+|Ldvf%o`U9muN
zY`04BG0_E@Bw3sRY2hgzF@R)A>6a#{lqP)~F&Klghv`EPY5B^IM~9nZ{$En_Lt=4|
zYrINLAU@*%`z`0<y2Ec+y^2o~bl<=*bxHN;8h=YLFhH4*o3T^Pk0$HJ_>jxV$;pp-
zrZkq%bbPG(V0~&;d*2)Fji-#mV&jaP#6HL9YbJaMKKtJP$K@>H-`pzFg0qRoX*Nmz
zvnJvxdAinsaM*^#1>~_lxjTuJbwOmDoxR(IN(Mzpggy`^DssU5)hv1{qhs7Mrcy?`
zoWto)+|*14-<$a7n`dM`&Ct517A<-=8k93vB>G;*UGz}H>OROLB8}wz`Hj9^T=?U?
zXY2`SL=uaMi_Y~!5t;rD4q=J773HlvR(YIVH&e6Z=44Dr)^_7YY>2zEr-NCGrXomB
z(;eeaGx;Nzp$9>Dm5V^tSs}h>uhbdVKQXSmFz5&Xd!xcOqr$qQ!cb9RW%T=Qw8DcY
zsJeJ0L}q*h0M=!a!no(Kbv*e00{{U3|0I<OI8@&o#}$#RQMMAsUQHOIn0_Ja*al-F
zL)q0ODvT&iNM+9$J40m_gP}5rWGPu<qPd1rS`daxmdY~tPyL_g`#zuZo_p{2-19#7
zyjLDoa900%EI||$({j`^@w@s+6ih=EeEgaDaV?3PAxk}mD)12w%BK%`73*J@F1bq-
z1x2(SRl=Sxf03o$HS!C-QyTbu*_A(K;<uJ13fhwN-3-Wd1vX~5;q~-S1|8V@9zo3r
zn=1(ZFl^xD@72wGcVRAuW<#T&bP5@V8yP!6Nz`DJn;Q-ItPIYez<VJ431cZ}aQfS!
zNRTjJaE)eN36NZz(lB5M28^f#7-7l=Yd~*9CV*+c^&fh|2q^00CvFY67SMpfEf|h+
zw`YlM1ll`wyM-VM(I6qG==D(w)wYtm4RzJR=!A=t9-Vp)1G-fzepWV|!5FG?#9@@F
zTyNNUT_be_Yo-&hi7Il9EFv6dou>@73=+vh=^^$k9k&phY_wseu92)|QHmNXP>m(B
zp}}_C4``*pWlt9M$^pSvMT$LvT1Z1dcE1b|d>d|PU9{t)L0TqU48npCrikv3&m-#~
z>}ph2ur=A!i0o;?u9joR4H8vZl@QiJLa-*Xt`b>iKz^sdz97fu4LU<uU4&pFvTir|
z-33ChE%{x7V{{_?xGL)iA^04!&W&8waU4%o-w-F@wFp!B?xtYYlsVa?M3t3*j69Ew
zyhJuROkTaOeX_{Xy2uj3I+-=)LcqVy`m6A;jOhU><(I=xfB>%vs$yf86Y;Imv9M^b
z2@_WUrB5X4ute=6?I|XO>=F!cB&OTDneANxmk-a_M@a&XgoXZh495DN1cV0`c?A>|
z8?wSOVCiw;4MwG2V@d<i#;!;rW8uT>aLj=zxKw0Ow>@>oy)s8?Yz&O0P6Q5QJ1)J|
z0$Y0EdiQ!A3Z`~YV>Q8+bl~hOxJpZaDG4wQEOOQYx63$~LJOyCDXSzM)?NFhQ2V7w
z$|@reD{wVCu*k=Wx*7yyIcEcSqe3}fq?kT=$6<0Szi`lYf?O6-Oq#so0$~k;_EDX1
z$XeTu_DLDaSNlalw#8rJS=g@afNWSmaz*kB&+bB-S<Oxh(N!S7z^t{)WV{^OXT~mT
zjgH*VK$|5FIa_11)Sx|Ca?Id3AD<bWbG*d3F1^19?9w}bd_vxWa;x1@?EzC-2da@P
z=Wj3OO1bq#S!~W;tepKkqU(>QqgbdRes>_YQxt^sFq6BOJI`S|m4XyjAs4#z9=u+$
zo=o>i>R+)QQf$+S#O9blXQP#NDpSA*9{^V_Q|B^vXc#bv!io>=QAedEfc|X2V2Y`L
zThnZr$ZrPq-f;6f>2aA&T&giN6P0%SGIl>nZlpwR8kP2xBy8a^&U`Y<d=iB%F^1M4
zpdBT7z9@&&#8#DMA`vfY%FWN>1IEpNNLqG)fZ6d>4L__*L0*od1B|Mv3!;B!QlhAo
zEI`+UyKZ-w!nA9HAB29l0sssa>xL~l1Pyaq!w(W2*C-sjHfG7P1Cb8|cioV@DNb+8
zbqrA1aeg!q_G`L#$VbcVMz-Td7!eRSC?R0D%?c3Ek;t+aEMN;%!lgeNxOgZf+Y1K4
zG->8V;r1}-O~*cCKdf+J-kXBFFOGeu%f;1wZfk<D5EzvI9Vuoz_Eq#U4@YA2OrW7A
z&{Mk*_OzfT@G%?k9A{QDz=#><{t8{&k~~4$S27sU517m@AByR&jiUM72W!b7nxc_k
z3#Wa31H@{h`pUt@B5?5o5F47~H`!-M`+AD@l>#ny0<j$KNdG?#lYNxddhNDCO}RIq
z+8edK<gNPeWS?z??gH?=JHcJ;%)~%!f&s(45HC2tlJR<ZU*K8>zakEYKb<Gytufd)
zDeTk=<^w7d;(>irwCrH%4C8uWv^P>C*tJNljnrAPPl_6&Gt2#P)|#bR3RA`wYX@Oi
z@pEgeBEel4mMhAB70-NZg)LNLI1=0wu2erzXCxx4kmSWIH0W>=yO-dOOJp8|Fe=p;
zuL$n-d>`jTW@Rd~(h8fa%BX}ey0Y8@kX4?Bt!;WyIfi&6(+LkEAFv6JI?_T_IeXTZ
zig3j$=eXzFR~b?`bhgsZOrt1@kqaPUGO<qlUZFIa?ju_`9QB;31!K?+7`=tVOdCa;
zR;}WN&`LwRlgY%01|PVt+LtB6{-{vTUbw(oZy+{J8^pp2hatVpyf7Fe!!cB_Xfz23
z^Tm3>7_5R}s^eVy@!>ax!zZb@K$zwn4S|I*((LE>FC(8j%*h%4YCnhNTk%gn*29U4
z3xY8mvVk*3g~I{JIRo;q>H%qis%KXhj}=lgHnc$a#6_4Bam9%W)U7&E|1|b2dzmjm
z{nnuR8}6`;JcErq7(;6Qw9h%LO5t$#r$8m@h5J4}u^RL%f=Q$8qC>(v>l1|Qx7`_S
zUvtvRye_y{><Cuy_-!k(trzYz&R@le?|a44re3XlbkM0DBe0x<*%whMp~<<O6k_RB
znUNKu9uFqFgb88x*;QsJaBOly0%E$m5S%V#y}^BKs!Le4Ygi(t*!cda5dG+zilbjJ
z#ZTzZ-yZYB6jxx1k(Ew6Ia&uf)btQHn|k`G2f{0sww@1;e$@<d<3p2=_cHa0_F=-|
zMZ4)N^AJPbdPU-By8VXa$A#l(X0Pb{I_~*EI4gJP3N}S4$>nB=xr9Z<Nu?oGNu!>>
z-AC2^fiPV&B<ry2O=OA^Ij@3M2u}3_k&U3hj1KAOG^*Hv#!3OF8c=6uhIWK_chbd5
zn#peRk+Tm_H@_&~#L+rt;04B-qDH49N4Jw2E{!vHAj0mOgmv)8$0g!xIsq{bAjW0x
zxIAis8_hNe>n&+u=Ajb?osUqkixiAQQ%;Co9vT{!k5=n}3k@boQ`OqxRxk-aM@t>h
zC8pbj1n9sdavgLRpW!PSazbv|dzrY7?#gXo=QNDldwDw0&1d)qj3El<5Z}xC|HIJR
zOe4$DQG05_wn0}daQMH%hP+;;ksX!6Z#?@jqr&}6HT(DR?4xL4AC)O_YE<syBSsAq
zdNAw|5m2?GhSdj-N)|RmK4&V!!e|Cz-GvQxf4^^K2kQ5sz)_SI7_Cv*;6?<lO)*bI
zj(+?Om*zK~?@i!uHgIj6`HTTd&M*ZlxaK9%0yJeZDA^B)%)-S#8aQ52x{Z2~?3Rss
z0jGVLfqzH=FGVTUm`F^cUW}mx?;pCXRD+PnN4?<Ba{${Zrh4S)n+U9y0N-A@3Cv^z
zw&Tol28fzr%2sf#N}{*ZNMsPz4`|QAw|_LSxT2JRQYV8jjWV0_DD^i0S(Zkafukdp
zdPz1|e(zN2EwQOYsZ&7YI2?^rdRby)Ky!7!JSx7{I}T5kr@1~h&ValGa>6c;Di%fy
z!%3px>vm>c;Ao-2cgMo$ge%`37=BN5eA+Y4EbL@kA3~M80!&%Tn+iDAO^KCj<Mk3S
zoUuy<&(|Ag<h=yox~Ou_IP;L@Xs+7#5M{HeT^YMl;#<d848X2T6+>1GuK<wgzFT;-
zc%r-IsoGF@J9S^esKmW!qRUf*iZPv`A3rn4a1~>_L$3UX|JJ8^#gS6@V^laqs&n*(
z=<tE$`a8GlMY=~{An=ZvH>4u?ZWz98?dOF6s@;CG;L#kuZGggC1>vJzYx^%L)dM+C
zHw@w$&1`=B?#>$9RCqtOS=v*t{h4d`<hM}G3C)qx^ibzl_3|wNdZbXj$x(+Nzw63-
zoXj-qe%n+(Bl&*MIDIYj^tH(9XN)oY{`HR+8rvG1-+%J@@%xX~(~W1Gu}#zT5EYyH
zyQ_OrSY>k|DvFZN>UP##H~lY6xM*p-?0xrOr&;6O!UIt?*9oCM?O^_;?_%ET_BGcP
zM_O}2&0@Ooh!K1b2W~}^^JY}on{4!x?R$UQKHeZ@eZL#H9vZkF`FKOZGvr>IuB-L8
zwc<BZ7uKJq-n+SZTL&>Se~|J}x&5uA?*)-30|PJnE(pZF8WPydp>JE%brbAyqYA$@
z4GK{$Qr?*;EK?`g@y#5FRy91HRirF5Z;U*4d?!mX+qrNT)g(Hrp-U;<SLFD%;|d*;
z!|jq&z9LWgj&D@@OJPQ*ufH1dUCp6)OzOJb<j@=?{IGZQ8I~VJh~4;jCXn;1UHYt)
zIDrqel=vft$Zg2*ee-iV9f&;-C38>TfmK`T4*UJgd=XXsLV8Z$Q%b0A`ko{>oABj4
z?ul&Gi#M~EShJVHaZlELBNW!ZR3A{N85VpIbV9#mNbm*cs;^KvBGFa(3svdefvfhF
z>c*Vi*|R$>a7j=O0g2OSSG23h6slC$<Pg$lk@mPfEfYGVSsgMW)g|MC-ph1$MW#(<
zImtyi17jPCv5l-OAH(>4vo)+NKUG<-$$67Bdp>to!3HN@j+i>Z**T+2&-{YvMpg#w
z<QOzyx*?oL0_P6jN61xV=3=^Gl>xe(%Re(GqADk{W{quf138zKI15Nzi)`ftVKydX
zHU@>`U8~$ZnD3%oi&oa7XKG`*t1#O7m9h#P(H{|eGqdy=kG)CleH>9f%wKUt8@|q3
zF%i2b9W~sw6FDjDS*u_iq#hyq@p5)JP6kV|dUYxqpUkbusUq&43)DWXtv=kVG~By?
zF7QfIYPnfqZWWOefqQ(|Lz~D4wg%;grRg)=syBw^ew<7j^Z3z-`m)Y&o5auUdHf0S
zGP(_SFoLuzhALCzmN19u#T}eL<VKK$=Z&4F5fV)(;yU9;f&EdCxiQS0!8Oa)f^X)c
zSaVT7aLx6f4tC!_yuV1Q;d|z<Gr(T_TokSiCoFjUW&+9YdS+f&v$?aUX#eNjc5yyb
z`FL;ds}(^KjR}^iF-(|q?8RwKAczs99rMNx(+IJq*V(!8DHU)-hbp09_2GA@hp%m_
z>x`=FOordNYsLqd6`$H($FcWqs1^z)@_`lY_rpx<S4MuoyePj%BO~s(k<{t0)iBd<
z(WErY^!Adbq*?EK2oE%=ui`ZYGu?6gHAsJLS-G^6^HWDRxYPz`iYCn`&Bl=tKIMoq
zH_|+HSAbcWE2$Pu(xboD#!OdX<n=4X{N3siaUa$uW`tbT&XkXC=(&c^2@QRqs@bhy
zGSrJR?g~oiqlHCn|L*_?-q#$xtu|D?hYxzF{M+GrF~X8XdwtfWvpY-V?O%&2PT$H|
zg2Z%NBc`o;VhPou+=VC9a`ea%n}IY^%-Qr(`Os4N@^dtExu<MH)ih7;)6>xF@_p<p
z2D;bft0?m_!FW-J0f%bm)Nc91YTQ^+=K+Vnt7k3POET}5TlSpL+i}JrWt#FimcHDQ
z6MNSFgx<|7-qdSnZ<prxE;|m?oTgHyzxKp7$-eF*EJb82MU<B2dvO)J@g@!feVpYM
zZ|d|{jT3qv;L<J|+>Y|*=glwm|J#Fj<t6U%lOH|&$l}M_kN!_&C^bUI4y6p`s^Ta)
z&DnNm>?k#fSG*|>XKtZAdcDM7SW@y&snp=&o0aa@L~q9#S)5^<Jj1$Q)4>0k;*FlZ
zyi|WR?Mp~3KO*??OYVhHKUZlgD&svM6qSP-xkL*kgGQZPB`;d&8!pzRF3<Rk7;40x
z7Fr0_4{;GO-MD5DHxs3N+5Y#lVE{E!4*o)w)Y#JIjA(OB;IDAn?!jE+Gqs2_dZZd{
z)JPTTm_BV^0VpwLsj=&>^vhSm6EckOm4^X>tk|EmW4_+wK2JLwWtuq|=W*&i?~v8u
zLRI@HoQ(cin-H9A%Y@e0tQIpw>4Dq*Q)dUl*^;%R>1U4}Uuaf*7Czh(K6UokzFNoj
zU=K;fCRT8D(>qr1bCDgz8P1r8?@pl&p57`Pd)^=Z$P{UX6q(WO<3L-y#~^%=y~q5$
zYQn7_dL<0FZ;w6{KX$MqJjk~Z{qX%~<wmY=quSfB$KFP}bI&&bUuUC-n#WRxzgOU%
zQgO#en#T@$T>jQr7lC_<tqITPUq;u2d-QRX(`O}ZaCd&~JsmZdr9X49aaZ(DMxt^=
zm9NOVgKzzwo_Z+D_#tF+JcUE@#nG6}M9(oh#*f4+A1Gd9x7@GvGPWNgv-^*PRrwzC
zANwve7v9<I^`f~rU@YwV4lSD-$KH#)W&9BQmbWhOwAZvf9H-(d1vcLS#saR3^SZ*N
z?5eND_>ZZ}&K<};{pYRL@Uvu`-rzfjhd*{yU(+0ZCO&sI6{pfNVX8c5+S%-^<-Ugd
zZVG+$!?tRjbb9Qr`=3zvKao}IjLy`6wldA(jS&AaJ=r-t->WL+mq7W|c-IrYj9P#H
zd*$9f%Ae<|1S78F;;U;V-`3PhJ{Y?Bc}kUVRhoPt2Q3Aoi_nKGe`el^qTg|uRcmTZ
zO(C3>1nhq4Tb%eNH0zgi_4LiF1(qi+WWdsSehsaNYQ9C^FOJ{if5S|Dnr#87KI|-U
z&BAQe?S(pzcH4H+S>kS1nbLtr8}u)(fmino?$>m@yB#dg=DKz*>jYgD|F}@_dRYN>
zLhDAzTQ`3bDg~UVSbic)>2~E_cH&;HS$^`%?M3MzkvH`7$(q}XiACD&?q0rWm6_3h
z9a*IhUo)i=wJyHP!5*a$ofH@J{_`^}pUEAAzbXIL*8OO8v#k7^<)+HHbIPBBer;~e
z+fv9@Z_U{PISLP5_bEfr2UXGATNAdG3#$tw)n#NLYDijCYEp7MWR2ir!Ijj_&5^-R
zAHc6Xn!8#Wd2zk(&WPl-`HdDIkCM4gWm!wR$UA=yt~b7K_*Htj(tM=Gz?JnBxAAB0
z$0D2qJ2=>SPH%qipGVx|Hr>Mhh@+t#MnKw~P(vw|^{qe*ENeTyZ(ypCe17-XeK*Xt
zfE0<%KlxE}=N~piZPo-n(%ss+`^@K;!)LRQoIkm+UXfp7Cn|heL^Kn7^*$0`>D>-;
z@0gTd@>VV2$;7yt*7!Ic%uif<>8Q7PLw~pPg~mAlr(1tITl5qw+q%N%Q(}G8tufs-
z1ctgwAt(}(oS?{&e;3xeKaMa~+VfG4DnIluz1DSLd#gzN{6f6E^b7dU6XJ1qh5zQ4
zw|zR4F#l^?YktDKQF~}=g3`)a;Z_g9Ph#zVunF_(pVtLeOr>Iy6{rdG0iW05Kd%eK
zm5Hs?%B<9yw%-W)+@|#T;@^jA#d#hQJP(1*s=X^0g?PsVHjB4yTHUwsFFE3ZpV<EO
z*qM7g;T^9oF6`QKGOkUd_0yddyjJTc=`EyqKe@FBzx4HU+P7oBZmvMqGm0kV-(76o
zFKcGrDJ8HVSlTI;=7${@IXy1I?39Y{lzO6pciC<>Bgj(~G&>(ZA}3hiDfPHhDkMck
zC`E;7&y(I}Ce$t!D<gkV*+fXjtW(B}tcl;Lf$z~=c#*y0r!s!0aK+CuE=i$66JMZ-
zKkdNNNAez?8n;be*{zD#$c*tcK*^dt@4S0{+%|q?xBNnR_KK^@xNYHzt7RNnp&~^k
zXx!Flq1>ETk-K65!HXxWEG6edwYz}v?t&EqC!T_|*%SotEo1h>l4mSy7M^@pM$l+s
z!jbnx3%@^ErBTN0WT&&hg6!=l%?qD}qVAzCiOeSbFek-J4yD8>>m=~VR(Q6^s+|p<
zt$I;Qc-9=BEx2l@+~aJaY6eJ5(sr)un&V%oj)>fIK6ztp&mWpIcXL^H#<?tYq)e{g
z*<p%yy`U_3iYBoXuTW9=cVx5#w)2>|tBU@3;exV-z#~$NrP~V2{0ht7z{~_;W)s<~
zo+-R)sl~c<UiHb3-r_?&1F*$9rBzRJ{BSC7znYmy&%jGHc@gx$w#CSFUWpA}GOH|7
zZR-qVYfNNyKAm^vX3H&w3c}Xwo*N@QH$*1eya;95lhfN)SMT%$bed=I{!=%rC6tLw
zPM_(~Lr%)aW%>9{%8M`N`QLk8CU1P>?BMFs_Q?UUVO}gD%SUKZej>5S`%?4H4jx2g
zDGgEJljMtkv$tQ*ZYn>nz{h_oUwjE^;9}U;*{=so<;SmT9$M<_<iYgYzV&*SDm9D4
z+WKK_)j@d0K>Rz+B{Pjhv$(9Sj-D<39<P)HrB#)5o>T@;%6#+A-qo@sp0oKT&7(k!
zuqAqHwamL<i!Qcgc3*!BJXNrznX>iOlBcJ&nXmQ{D?Ze@<v)G{7{9S?p{=^JR(j!(
zIWJW^qRDb*S2Ax`8ZT9Db+7d5-u#|g`$>=MSw2CN9ukW>1}^GtuX<`jCOx*To;tJ`
zn#5C5ZJScdzyFtAJ+;8(h`_3m{NkL<Do$l`L~#{&vxUL0rq8*_5u?SqcwY0~RS65c
zVAiLf&B@PR>W^8sbe!qj*PIq3*qnUK`%GuC%!-rB=VOX1PJ(evg^GkvfuD~V{VW#X
zQTMKV65`F<9$LNo9@b^*X)<_90jIH5tiJjQk-a5B;9Z<XZ$g`LZa5sS{**}JdHL&Z
z<(+-iX6>-rcu9AwVWso^Zwl{ygzhH=fAFQ(?l9^|%tf<tZTH1_WXG6YkNu`{Q}&JS
zhU^>Dk8*k4i~;U6{!ZTF{OSC~`56lD_`{qV({IqGjEkQfCfA~kYc6gP$-ll|!hUMi
z8)<x@Qgcy0*EG5;?wjfNyr%i@d9f$c!6VUSXTG&YKU)9n|A%zsw|VnhLA4c;&;C+L
zX(tAc{Eqkjwyo)O*H+qA%Ev7)?|z<6Yg+8>m8U_^i=W*ihubWK7p8CRHl0$8yWTH;
z)n@b1Z-XVlQD{K_K+1Hu<LJxuH{<?O+U%F<c1;D3Jfr&p<F;Fcq+`il1qQ$AAI5vg
zk19`$b=h2N&hY%fJ*rhtd;fO-wPr(8-6*AVF}yM}IxgfwZ>Iv?Er5+MvSD-G#%0SM
z&n@fHLE2>LkDtL!+?Hy^p6(!+77^`~Cr$s0U}6X?F9decx$){+udj2X0rq!Paaj+4
z9rEv}eZ@h}SGp$2!+&)a$<pqkXN6qYgU;~0jR`=jao+A%GYZ(H%h_XLtZQDWn}l&Y
zPp7KVspfR*p0Wb=5l#-eQWuA0(Y|K0<<M?+B&vNf>MtI1;d|%cx$@|x6oNF`&C@dE
zpfcL+B+@BJg6>R2mT3`8zo)?46lm6K@U&$B%BGzpJ0G_$!luIOvm8UDfe<zJ5SC20
zBhy{UK&LkKQ5rmB51<5P^RS123lOJ6)<s9v{$W^)%{<IzmLiwZ2&!zRJAul9IEg`=
zLiYj)nSXL7@8~p!vZD^Oqp)PIIhk7maniFcI*Zggkqmz(4P1q?mo?bSI_z_u+NJ^W
zTthT@;5<QY5F6X2#TG}C6=fj*Z~?+<hp;}UFyj?OAuQj$fH0ITuF4j7Czv`wuIE{;
zRX4V{-{bc^#N{p<l5s#DKhXS$EJ^DvaIJ)w4?5bo05<p8=~#-Q9YxWVQrM{-{J08E
z!~j~cN4hHZ1Qzv19MKBM$^l#~0+lp^lmdx>bRWFu+N<$ik&Y&X0A@*=ff-@iKi!U$
zW^lBxsUW?B4EnNxhw_eMsh1H2!jbwC!yRyiMBt%eL2w?7b=Zoi7+B=l1Fy>ig0q3(
z96)X%#q%4C1qmv$76B8nhdnQJESu2T(=rd((`5UyI{LDSJ2&#IK2*oXLjU?}CC4(5
zf5T4dfaguXUFM&h$!h*3a)3KuP<FK{yBb9ZCPG+R8bk@JBBx|{u^ezz1~|G0h+ar}
z_Z`AIVqJ754Q>^x`P7MQLPkbvSpCCWtD>9MMK5H5<iGXw+Y3lS+51)5``rms8vnEm
z!y}UwDh%<c*DEHtt^rX+Gn(PVboN1(CY&gSDRQWQ=eq+((7+K4cZq)%8mpFL`8&aN
zNo^}Mz1X*+hb(N(k}hmj4O&ZdqUt?#^!Zu(IA&4LrRzpV(SpyQ;?|Cy6}{7jn`vZF
z-j1f%#buT#RN&SibIaBYQ2r!M4}n|D9^yJ!80jUTd}I*U?dFy>*<6PT@WZ%l<a=C^
z*DU<l45qE~t$5uG{O%A?n)D9`icw1sQA?eF{dOT(0UY1}1N`qE_@6szO7ow7W#jz}
zP}&<UCCf{*<TCke{MmEt8=kM0gVc)hPg3>73R|m#)?mHMK{?z*<FY=F`j+?Vf*w(9
zz3P{XsZj1T@gOT-I(LeXb8djCJ7B8Em6uaj<4)IUZNwqC(>KXw14YYAMC4yx>tJ5;
zG;k3CdHWrg=6s7(5&`@<eW>awtoeDWKm{}21=z-5Zzr?2SFjVuWyMBMVO=Vj_av#e
zeib*c^d0mi2rvn|WJgP~qvZvdgkRz97-!G_R;71Q)rNhQ9^3?W3W3t0`cNyxUrlo1
zo9~VXfCy+O0!qeVcSd1*=-_iS?bfZ3T{lr;VkEg?1k@1$O-Dc>rjL@((5%U*wDY9A
zgOso6PAcd^2M76e#LU8n_{lI(@h9gcQA(3^8;et_#3}7UNYu~5)1#DZ5E5x1z~9##
zJRPS*#VH9RBqC>-6+?jQ{h|l=zy}sI>v~jLHY)7_DlNtNaPSCVKnMNrxh2zHUO+&P
z;IRLx{lf<;I9?5oUq(O=-A+WMdEv0$b4=qI=95!2P2@kdj5C=Ev@}r0yCiS$B_OJU
zaxhK<v(Z$|Tj%W)9UXQR<_*E1b}(oPOhUd)Av_;=k^?+Bf^rCbl=MCo+(~CACsn{L
zD&fzm?49mF(*FPe0RR6~mv=bZ-~axtQhS$DdsAwZlB!j;1raL*HJV1OwxVJyT3XZ|
zwK@br>`_5cqgJgDqqS00sJGp!8o%)U{PVl6`*}U?`@GIM$;m4@IWN1s%qwE=)Dx?(
zl(6H}6C;T?KSS~|MN`hTs}C_qz>CWFh{~hyK^XKQ12W^|pdxgvhe@=NDPu||K~&yc
zR6bEuUQDYd0b1l)WHk6NC36fS<IV|pkQuL~XTN}2N~UK@=E3=FG%1-4FY7C=z#Z7&
z4&_FJDHlRrZ8wYKEmaBE7(QGH=)FOAwLMSeM^=`s{EeH|f?$YqX??3L90h`-!0<~u
z@!Y>;vBEYGUD&bms2bLF@Q@pACMT(1e2!TUNQx(9EM$P#Z&#GyGWKRiZau+;T{-+7
zqPI#PfF*1B628_gkEJ+6J==D?vz~(nZ!+u(aTuttWi$6ohI@+O2Oz~6#>E*{#Z@mY
zLMIjQc4#w~$xg2IaXX*R`j=pMMoj4dFhI}0Ik<C8%BxMvgF5Rgc<IR(RI_czI_nu|
z@UjHgBfj{3RSptj{;9Maj-!fH*V=0ULnS&Ctf)#NGpDAn@zB94WIZ7^amBKI^<~L$
z8+m-0IKE68Kh-1k$v2C%0V=K<d=;H&h7mcyt+eG_EjNB=YZ_;Hjyn1VKE{SOPjw8m
z{(1R7s#bz1u&8OL@X+z6;nb(6ub<Bi1YyY%l(JD;DrW&<he6m%G(?~XGAA?12P#vI
z@%M@ZBQ9eIqads<2pa{$%4pRTL(5drV8k;pywU|PISB!kHE@Vtz#D|^0b#kNY<7Mj
zQoslYG{n@j;fhg1rcIe&GI&84^Jyug)N?Q{3a1|yZ8~u)ApVFpz0^;gY|)?vE*y$8
z{ixV-Jr{!UO9d_Hqd!S#?Z~%)7E(>ZOtVTo?@JzJV)e1|v5?y$dgu5iIWc>EVs_s8
zip3|jjM4_IgqIKWJ>fY=Lt}$J_AcODoF(M@_?7?{APb8Jyu|~6`GgDrRt{{<69BPW
ztFI)$q2qAq1nC=*bD?o#-v@(l(k)@LTxcZK7fit0V%E-aCl|O;1Kj8#k?$e{01KOh
z-@)R8-{OO9^FQ4MguMtj0_Fh+<D(!YTh+jYF+dnyz)_NQ$pIR;!8kcVmrvjUV5^Xj
z!T^X6a#knQjk*QMZ<Mb_k^h+`omMShEgj&K&31u@c=%lcyh}Yllk=`_2{RVpQ;M8r
z3z!`(!y6P`Xg<9?kGG`cI5B8o!N}q-e`k7o%9DWw`+@ozHgor6xVs3x7gC&PT%2fC
zyhZ+QPATA@qRkd2t-~!zEsZh}oS1P*dMo%j)H2lWXQ=HIAFp&9W$)gq0shThBX{_p
zO*J}KaA&=fgOVj3zWAD1?z-zN*E6^^OwmWuX4dRs@zv7$980(gcKkun_=D2%KiyKF
zV0NSs5PFN`3Smh-4QX`cOIBtU*Dt1&!AF`GQ)a?D&VP1v(%G~Xoj2b`!zrG@JNV3U
z(}3stLaNW>C9gLRIqS4hud!C&Y+WK>1a!PSSx=GQ$OiCvhn#&DFiVA;1%<kqwg4SX
z@*8RL_0)afczDqS+(R#bPX@_H4&oa(m4PKI-Ik;9BAb#FNJ+|DyiqyOG37!ifV_(>
z(*(e$2jGK7&N2kd4q)&EPzg5H3la@<WXx|Q0DQ~=K8XMy@}`vtE%7M=etVdo`66hx
zw-_&t!I#FY-85OhIY15sc>168p0wAZ`34S1J~Wc=5+Jd5y<VPlF05Ui8vBocN3)r)
z@QpZiAI2WIBka*EaG*Y)&HQ#U{I&=_5K_EpRJ>_fyxAkw*fdz*mJSbr=BbUj!Tscb
zw~aCajp9tsQH`mmF0YS1pOCy2Z@S6@Z?6&Sskur7Dth3C92eRXNWBC>CMK}E*U7yL
z4CP{u`Rn=jOW@7-=@H(BKY{|^8JNB^V4Ts9w)_xl`Jut`gK_DY^aPN|d3z>y)|g?E
z*G;9D$LpFkHV4>f5CM}R4AZkC&Y@Nl_@E|G%`Nulg2wjyRl<xW{E9b>Q!kbl!2igE
zIe;a`k%s^7vqX{3-k^oM-@W}3f^B4<+o9d|%fL((COztQXq-`VAUlyn^>|ZsdG_95
z17m*!<3L0CVRvO<b702f%`!VQRlo<ZoukL5WY4U;h}${7N)mjp6MW~((nEjGJ+vvy
zMUu-oW1Y4fG*>|`<Fa#oZ8Exl`d#Or!kAkCP-5!8*S=dEtD(Cio4!RdXW##myfeMR
zCr4H{C*$Kp?#GFfj}s-Dd*3^S#992hpM_wRv2%}O20cC~^;+3iH0GB0W^K|4(-S{O
ziFxfEhuS-d9#+(M%;U?Z4{loIdVW)}1h2m>NhzJs9nq0_<sFi8Aym`v{;U_g<)0d=
zcot@-Ov%OQyScH_+OQRdnfVj@Y@Y7xryDo_eIoq&S2Xj-s;;d^>USfev1!8FFAU-G
zB%!9w=ShVYs5*>8bow0L&o;ZBZT^^>Ehz{W!ZlRAJ|KM3IwF@p!bNBU8y04aJy%<m
zh;xfu0#0yk@Ic1}%DNvL{I;r2a80Ub*21VnD6XN94WTVh2p1=WOA}6sod3S{%(}d6
zXs@Ju(`D-URo(QCqK+3*N3R}0Mx=Q;wS75tYp{;iKT0qwQ#FB_I^d2X#d;JaA=p*e
z7)h3E9{5LlWiM|7n64H~=Y?UR!LS6FAd}PAg+=mog(r3O%A)JRbSYrEcVKO{!ow(N
znUE1CoC35t?ku-ToeQQj#jpV5F3@O<R5V5U=Yf0bgv>w!-Wltz@{^sylbyDha3j!3
za?#P!T}*FW3ZzV^7OXu1I$<k1dS_jBw+Q^=@)8pzhJ_s@@E#3_DFV=-0pL)gWefO)
z35G=iqX!o7N?TWynY>S*asf3Ai#vuTM0%1}=}Hk`NOtl*q^wJ)tg8Yf0KAZ(UFFNC
zUcBWBb}ybZ1DvwTyWTko{CC|>I~8(bB>hutblp&|TnLU0*N2>3ZUE?o5-+#d8X94f
zA|E%<Wl)HDudEx%5K`#bH_o9}ljKp8lptrff)_F-UqLhjKw0Ht<SF6uc7`dCbD>TM
zS01s-pW4s)3G|#0tZ)keh9m5Uyc5D0sPaQ>kU_MQA!BnA;jw`EV}ZoSC-$MlFM-YB
z*H?~e{%h)0nymdhP4E*CI{-+E1fQd~cuJ{aO3At1M*B=@!cV|`vngrpgrGEfVZ-&F
zoy5@mi~n<{J9jj}%8shgUt&AHl13}aWRVjlp=djRtY90lPu{Q>nW}+Qx*J!zTUGw(
zmP)D{MCPS$s6**_-$PV>cxQA3$q;tP%RC2pnXsCqKeCj6e|@o*P@IR*Crpt$l+yG%
z%0<zOPoC=$DDgj811}8F6$2av<x_z27t_~EKxKstOQ8&)6R^>Nwfv-oaarMeu+&S7
zyoXuq`ZAO8!jo&25G76@P`)@CAR}^te#uGW>yyThK-?qY9LC60o3gZeuv8RS$^m_J
z)%c+95OhGRIkp-<U4k?Cy*B&bS!(;WnNOz6gT2YMVfFotXCbiUzp$&{dbL(gERWTo
zQ{lbHO&G57glT<tBoDdiA@j3e&nZoJI4w3$3ZY>ksbOKDVZmOg-lOnS1~hCP0NoIo
ztbOBFjwms?V__awaE=BNs%+wk-X&$#?Q8TNvKgPOvFI%@^avO`{<N%NKi}X@p}`XB
z%^&lX4cB7bpn_g<U>U&+Yg#;c{*we6!N=l?qYFwH?^sL)7XX6`l7b6Fv>rW&j;ItB
zz}B`Cwy56RXB<&M=fNcPhtDy)teMueXLdt#5T>2>dCv?HRDdDp%Ofh-CDavTBw3kF
zJ&L#t-qI%CVWRx=y8SC%4%I#WnNMCVd1EGK^lsJZV(MZ+Fa&y75<P5y9wsmGOXY+H
z2=j#8b<GxX<B8y39NW5+%tSLi`vuhA4ST*DJ}9US+I<3lwdAyMrK>rZ%xO3EDO``g
zASr+>=RBZ$w+<GMs=%WlC3`w0dwGBpr}h0O@7|2)mJ~APhgTwxG)VhTCP<+>@q3$q
z{2NGsPyj<%)nB!Ig=7FUne76ucoG$X^h`a!H}2hA{3Y9bg;4;Mg4{ky(i^|fo<yqQ
zmr^&+cVp;@_0NU^{P)A}oi;EgDy+D)jEd8@*zy=-6*vYQXdqDWdYlmg$qq-ddm(EM
zyL$q$3Yieq=hJ4Oa;Fi6#x^GZ_=%0wm^CCB9J$U})y`SGZK+h5G|uD8nc1+fZ=h}*
zpDa5$K3HI$Nkm<K^&l(tLcuQjtpanr$Yxyn;3OL71Z7xR2f><gW(<Kj$s@{azm!F$
zJt5VDM%9Cs)q_1!3QdfG&0N18Lo4~-Lv9ZGtgJI&2;B5m8|P4KsB~?p+#ay``^(O<
z8TT1dSvgAXAZ=%7KRB5oexZ2|d+*%7B)3vu?uupGPLnxVdwT4%jA7eOS<Ix3o<_M&
zd3lVj9UNOJimlYchKp$JFt*sXCqqv3niw>TASy1?kW1xgdpjxpigSGH#=Ysm%{o$9
zTSTZHP}(~FqbNrTxvK78SeH~tyLdx5DU7+<?T-Wv;f6+aIEH#7i_N}0fR>;NszAg9
z5F+iTF4t6!xk2x`L8INEa$1kD&<X_Fermnr<zNHCCkmNAv5t#*cn(0W?Np8J6e`L_
z>mQQKe#(J*10Y~OrRxfXF;{FDmz}Fk%&DzMJuC)sM`#IB_1Yi%Ld<C+-|*w7RJ{|E
zzEwH4bvwOM7x=sIdwM4fu{hmOB5jN1Eu(k7qlO=Y5e?qe{rd<Rd=;lCz6x#D-bhZF
zq^WuK%6T{OYfDG7!7&?%FmkDXK4>_&JY~Q^I#(6_XiF1sX)XnSGkvwyElM>#PS+20
z^xKJG(k(reg-DZjcG(ky@_l{~=~n5uIg#_$j1A7XEFjI7YM(a8x7PFYE2ub^{F>+R
zQJx!8p8Ivjb7%RMHK%J`1AVmvdCI&0XJZ3!Wc4r>hjpt9m^Jw;&b^N&UAbKBnAf@Q
zD1-Nlefa58PPm-M5jK<5B#!s9Dqe`UI38BOZxxxf<2&nLUm1Mb=!&x`3qa_B&rxoU
zc62~Hwz<w4Cd9bnCi%>o)?IPj&q%fi#ghX4qc(O-P|^Zj!DO+p&%k^0nPr#5w!cYU
z6O6t4mT%7DEl|0kYQ1c^10iZDN=o1vAI2i3!s$lrp9JemxWL4CuX*f7yUQO#3v2lg
zRGT5cU*7C;$3IO-V(t#`CX_jTxx&iBCZzTItY2C*nJRoR;;WzWm?-XUN$Kxi4*uh<
z8zjP*s}JcI+V5t4dL|UozFyK1F;V)$#aOena837QU;2%vuL`96+L~+vAn&+)X<14D
z82-$EH%%qaJ8Q|K#s9xeHell`|61sav`sExqr3VHd2f7iC+}DCQa7&~z9&TXYyEJb
zCQ<5rKM-T@9(1@NcrQ(X4H!tP+!v7<)zv?&Q*5}j{0L!tviKA<{ta#(d>c9bjo#Sr
z=Z7Lg;O{5Iyow<9fLfPSqQ|3lQ;iwlC69UO*Ir&EkCy)az>qOZk6&}n>O(i4d)g{A
zexuR$ubGSDkyx2~0Fsi~Vp$Fu>e09VE_Sc+XT<%nf2r?|5WjXlzyG5O(ntQ{n*r>m
zXoS6e&YNu&mU3rxu#;!z$GzRASkk3~d%v@9d?CSZP%bcb{NY=);F1;ZCB1FTik@{A
znE0({`HlZZDLwI@_)eHs_aCL5u;+({ZmyE#VL3PGTs#VQU_1AIUsdhDQ9BZ<A$cmt
ze#RYlwr<>7&08#SDrb6ZC%@yOOKiu9pXSn>=CW=t@E-cn2KgvinjYWEJoJMQ+oQT8
z>P$klDHm8f{)BMw@R)AV#c#plx28B2SUDE9QV%JOk0V)ksLhTeMYKRn6CBzd9NKRs
z!YRbVJ7jmF^^b+wwAa{q?1BYph;%uJy5<)RqTxmy+RJy3**LX5;$Cx5tM1%2J5H7i
zzZ@r2%b{)7%}Tw~_535Qgs52W!Scj(wc5A;+Vjkzr6BpMQO9xm;oWq9*$u+Gh5aOH
z*Q+1LbPccz*e2=NYq&AX8Pfl?(g~jsp87&~{kiP3m9vd{nH_f$*^UL3Gd%mN)PJ1K
zy5~N0oPA%Ajav1>JqTyY7OGR$1`fTZ-uqE7w6YWVLwN7U^}QdE)i1iMU!cm`A}NL2
zy5Y}K3Kjbt<D&qzd5e9I^$asP*&KlOVuQwd;T*|@`^kf`q_oImaWQR7N+Hd%6tvI6
zc)27rxzKI7glSh=$x=+ar_TbuTte|zMs61$b9_@+d($Satw#|mQn1RfQ(wtuaW^(-
z)<&ctrDNofLc6PDgm>{nj}G%O6Sek-s6xs`SVhMO$9CQ5tcEEzzs|BcZ{^uag@XOC
zUgu-N%&dl#<L#gNA6Bl_2M)&*hBfA9H4L%&Po`)8LPLpLzX`)zwGDeM4>!4PP+{{I
ze6aa@Apf77<I-9;_<Mf(Bog;ttG*O!(kdzZhg#<<YzllivH{#dt#K7bOvn@u5BKN?
z2I|$+J&`fa&$nFv<&>G9Kl&m+-(&oXLfUKS^S6Ol`Ixghdlc$kK?w?hSDk*<B7oa3
zxMqa3tTtJbydp{sx`fy!PZvvnzaS?a@V_p;$y0G+1l5lA{rP`VY-eflXPEdi`tGv;
z_A^tCv%wdKE@sC!RJTqT<IZ}z&&IpYsE82`@h&1nyU0WC>_5(wM7!)mZu4UXwsxXu
zxD7}9`rTt$&i1m^HoK@p8_94R&US|GDoDJG7;!4{P!%c*jRukUvP`A|FagXaXhbE5
zgrf<cqdP>>hC?$<rYJ8AbvsK(m1ER`@ZznvV4N;`oO$$+nQ+LA-Qj<`!#@ln6<^Qr
zeffDsGTr3XJxqXgmdPy)7#EKoUm$XxHD;Ma41!304zjU&nEfU!7$<S*shkLUT;4%;
zt~SG@sTz#CM^3UCz7D2nM;sV;iJV}V0I3u-h&R*ZX&P8I)(R6~k!f;2Gh;Pm+5Jz)
zm;X{;&ru7te9;QD_&0rLyCwuE^w02UT3c`DEb{e<Sm-aIP4~0p*C)|hfi9uMu$I?z
zS!8!)&wDr>mizinves{55v|`kN7K~gq$3ofqxCy7^jFm67r}=@ArxA_J67CtPScEp
z<V>_ON%7);?X9+J%q&cV<c>za6mV&+GJ~}qB$W9ps#&YIiay7D?wl_5SA5{0&YLEC
zE#a%Px<|0d!y%QA40L->$PF4{uC=_S40P@vK6hq&F1ebWk2GCMmbpr4LEDjr>e!3F
z&ljXjTVO_go|_}3vO3cKQCJLjr139Wck3`~YEWBLMoG~v_G3G&*|xd7+;f!r6Fqyy
zZ)ILh`)>ch?D78^Jiggy%Al9?#@lL!j=$q-uH*6XO!s;exzIq6w5-89=|pl8eEwc)
zIojkdt1NSn0iPd%7X(bOo|&JP{>EQ7^t-pHwykCcmY6d>V3<kxqB>rSC{nFdvSXU4
zOv!|bVFMHE7x~DCrIe(&5`1L}u*Cqd$w#V36#Xx>Ad0f`@c%v<92r)=i^<kys5!hV
zQk-tD%$CU{+|2~ghefjGN8Jse6?m_r6F0obFg9YMHFC7J?Lb(nGkAd~AB4ML4lhQ$
z1hg0dp@g!o1R6~-ijg(S8^X`wi&w7(88BaDssdxGk!5O4PU;bl$QN-@UMJJj4^O7E
z$xnGom;-nBx(Xo}gXp3zg=QbMpeT8$E|aDaH7nJkuEJs`M^H8EwkxfmcO(yaw>@_i
zQFPSXu5#N$G@2?DBfqeMJTDi1-!f<j_V%t1_8xkCFr7WIUQ;t;_gcj>rLXQ#c;s_m
z9q%%}M@Il$>u=frKHB8UWm$&`-4zYJ(`&*J3cfBTUk-WjSIcL!+`Q{=^klDm;&KQ5
z10{U@bVI`0wqLWHb+2Mbv;4lZ8PkOF$bj-lnP&mFN5Q1*o_Dt<zv9Shzmw<)t@22(
z@<_2~0kcQJSBbq}9H>B{<(aFf!06Tr-qI8pY<Wg?_gAE53pa{IuYfxF=XP?47?E|N
z?}_5>H9i!JPC-|!W{G|Qo(=^xD8LH~iPNt4rKX9Q0tFl%>v{CU6R$U4Mpd4PM10?`
z@Upo20a)0q9=1A8QsF5YajM+^+bZtM^jgT&kA1ENQMdj6=%1!v<jbwS*1!14KPYFH
zS3ceW@{LM^h?+!WC^^Jl!#478YP8Eo?S0Eiz1c3WyZ7z;V~EwWZ!_~ci5gA5F#cR}
zeJEI5U8VQ+z0>)Xne+Si%D}*4&G-2Nu%P3@pJSWe?xvExeSwWiBy#E9zHRNi6OY1f
zdhdNW-1Ht{YtM)3HPw9;_JzTM9fH3Op6$K)7}&@jiAMX-K1e-N=4`D0%BsAP*;unW
zI&$jyG59;Lyxr^E!oKn^<TrW8*L#UYdoasLTP{94Q`<P)Hubn7a=$J$Qwv17TSt}5
z&bUSjp^O{8qz>R29c!l0|4CK3=482E@zz4?df(sbxBV}kbnE1^GCtP2Ub=T*x9`Oz
z>|e#0$QNsBpg3Q#*#95X-;83#f9h%Z6zL_gAX4;$4b+1T9;RxF<!OqU1si;nppG4j
zW{76uGPo+uq-@Cxd#jiq^;wuYRzt<oDktjY%TUYx`?N3pOp3)kt@ad=fijZej!Ge9
z)R`*fKtGGLaMgKc5kZOM<EZ?+8@x`(Y{OST)ZB-lRc30}r_w{Mv9i_Ik19TFZ!&A(
zCS)COD*X4=QlgD0nd@I5BPcCj_;^Q0;~@PNovg;LS-*ZTr(nzoSAn?S`{?Z)(V|=T
z?03y*P}VfdIhXTcqQWEk{sr-)C`qbavlzLN^wgJfD`_y3M+GvTyF*M$mOpbqc`y@_
zrZvN^nGB*p#=OIHL(>}aGiMwyl1@Ms*OMQ`kp(h7BPyQaKb5sm#R*~~>85$G^bY(+
z&VW>pipePHz>GTvmM-nKlfbb5RyGm_j?8FfNPZye{|56GZ+6K@h1*FE#l0d{zV?HU
zdq!23Zz@}c)@!P?uhPn@#o(TQ;!E49QvGf@_*7{T^h0W3qRFhP?Ek`?s;ud7Mwruw
z+AxW#GA?5K?LLsvbsKt98#Xr^f%oNlag_rixH6V88xegwWbE3MMB!9ez#(8`8~LGY
z#_cU(X``ZRs)5CYPT-U8<b72tXXZ#dd<lPoc}TeG?_;moz4EA^c27{@NaI!<>(07a
zD^7FH_4=D2q@**Hvx=p=+%bMin5Y^Vl=u<PjP6!9Z>8m|dKW)MK~#0>Mwk#)!{Vkq
zh^ovx>~3!*ozvo{Cb|(+J8x`>4RJy8!p^3JQc7y(tyeg!(D74L#0IDCh2-vqZIM%2
z&WO7OQc73MkC`P;pG%(7vPE>69Gi=tO0q>*Uko}nmpm<&JkR)h$MVL<@<K#ErJbf_
z6o>m*_ktVI4^H%>+-a)lMsV)T>a;cjEZochj|i*X4vtd8v&rg+77myIeQOfyHh`%$
zNz=mZI$w|gt+OF@6?Mmkebki1BJ$u32nw+-W9;5g-od>If(koN-8=R%{?04do^{*T
zyr0YSh_P*R@(nUp=GCd5-$oXYm%lCGbM}g<RDv<tOf%em!?q><xGWYXt~_Zm4t_Ok
z<l*Hi>m+<sJ!F2P2OrsuUyNW3dVQyq)<Am4k5NUkEqp3+YKw2}poO+Nd`fs8;S(Fk
zXR>*7e~0k=7nXU&=YH>do;m*A_aS%N*5=u+%<)6Wk$u~MqBVuCHIlbD>XzGL;?0Z9
z801dhTEn{C%hXy!>1@q3(ZR2>-OCr`PBA~ta15n7RiKEN`oBMuE#>W}s@qQ~4_g!#
z&BeDRwK{SYw<T#0bKTz3&c{UE8tcfV*p{?iG^Y=;rkJ0gcD852cjPK>7xP`@ORYIH
z^Fwq&Dzx)v^TQ9wpX9lt_M`2{b%<&=>{y^)+(K>i60b<O4`EKn{|L6Z7-jGEx9_*<
z=pJN!;*oYU6in`;*6O29&=mHoRKAj^+0jSMhoVTPtLV$+++B@qZT?F=@ztjHjp+&I
z>sKbK(}`6BJki2O@Um5e*Pc#kK8mrwHI{Yn%1~=;Yx98p%?tNno+`VkTG`Kd$dPI<
zvtTIqO9XSQl2=ZXM^4j(vLC&&A1M`8q%TN{)=W(?<XisQqmy{<yp~fUHOF7Ja*Oy~
z>T~Q7*&26dn&@*>+O_3F$?41w#I`o*&(G4K5C-$J!hRyOUd!04C`4kbs<5BWz4_<K
zO_a+%f}*e4sa1E?5?T`t=4q3g9*Mk8?fVd#Y^by=9o>rNEtMLz(u_(P=UkJ{)-iOD
z8ug(^IqJ--DP+Im`OaI;vg)Ie-89+RDo?Z5Sm`<sRQCJX)heLk2g^2m8TAHr`@uX=
z#gA_2n?p{M)aqswD#T)y$fxH{Ue<`RUzO*)pvU~Y#2yO=icV-*fEPuFVt!Zi@WLgw
zQVVan-kVQJeoC_}&{mMlhBACu9<bbKVmN0@y6lsYv@^dV6K7~j9MkIlkP}odG7n*z
z=>C5I00960WSDt4RDJmWXOJb!FhYnK`y(>h6U~q;ldXp`cG-6#Vi?P$3?ciTr7SH%
z$UY>7M%Ju}G);pj#tbsD^qZdVb^ZSMe*bvS`*q*<xzGJMXU=uznong>)N6T3UP5IZ
zL05ogsgKW52n(fEs`_U|x@SdBN>kaSsT45UCk5XOqK~EFoAHbfb{hYY@sem}WUF+B
z6h$>bZ_rT15X}S4aHFV-{q;~Os&rN)&0y(%R-`I%;Q>|*En>W6BtvB(cG+b`%2Avz
zQAY16Hfwp!)SUUWgFoc%iXJ`}cHL!x{cdpfZS8Viw$Eo`0^9}Xx0bneqh+6eO%=Jb
zlj|t<z~R@eUsW74f`9GOqf2h8FBM=(yVI#|fAQ&UkPoZ_*Ie*1VxHSlU<dq^Gy0OA
z5p=MM-^04M@VdMC+0!`=X-Hm=$p@-_ZsyUd#v9#hLd1$l)UV%rSi-wsJrz4Wu_5aR
zVNAJ)_@_L1rM(-wur$3iIUKF9Lop0N(;v5OFkNqdqQnxuQ<DSgu2X<S|6ux8W_oo9
z*OQXQi%B$oBRjy3H>iA*#yg<g_!u#ebj&aQ+a~Zkh#9;~I=-m2gZnt~MO2)f`0>2{
zvp4`D2`H__Gog^iKEYK9jOz2PU=Xl(5aRzF1y<}dyOVragW|MIf6rGCs6dG9UIM6T
z0|>bn)64Nea?9W~2PQKD#DI2lVEBImAv+%>Z&g#JtiQ-9FYG5}_TYN!?@2}Le&M&1
zf%FAX40pu#|03Bz26DEXdaeA$t$$GW4J~dkI!-^U?R)Gb#5Z%}>$PVmaSpY8Zfuy-
z00=wtJO+BAgEY^=hYJ1BGM?K(cu|!U(4G|hQ3?pftg_O+nq%7K;b)RTZQwu2$?<Fi
z#N7=H1W3y$WSA5)O!N<BL}&up3{D7HrjWteQX0a>4|z*4@g>V7FgTTHSywQ!{1C2%
zePb3{mN}+M9u7{<2p53JrDV{h;15zVteGVs?O$_Dt~~r?az+yvVnHxrrG0o+8lu4u
z86}tmkSnnaUlCe{94#X@IevtIuwB@Pvy&m}v<yvJ2A1*8mh6$tI1PmxhpdXTrrhRH
z7*o9%`VdRd8O*zY$m&JVfX7^{f35_r9<U|E_w^z^^df+yayx8>9LZz%PEX_O(hy~S
z$S~oZKiLDzuoIz$W;5FF1+R)fZQD+-+`xRRpz1w582c9f1$}0x^qo%IwuLE$=izvL
zd~ucNnKI|{f0P!p^F<f0OpabDd}~p~q~vr#9WBf0#!zX(V9J>2qO4A0iR_9^&P{f0
z<OoULAkruM`=<Hb%`w>zpNrT&mm;5Zsjs<3D)cDUl~K)qYhNe)=`2qP*(-`|WfVO+
z7bowND(A+;pw<iao!=?<?s&-$*N=EQqP*3ZXv4G!FL}o<wVVhhhI`2)X7m1))VL9S
zt$mq3_?%*3BQ;~OYwc{HYR<9r{7lr-^<G^e7V32rsZ_pvU8DTEcDl`HjhuDi2iS`<
z7T>OGTRiRb%UrLqxA`2-0+&dz!s(F1lkKK-+%4t=0xn*8xmNEVoFohH$1!;1;fA9E
zJ^-4iIVMRS&YC>_3S5pP_^{B5&YL{qBKWA$ii#QLQ23M)CSMjljAJOv!_Al-K$^Wd
zCSM-Tojl$IF1H}~u+rw49lQh|b=rI}BM=H-Fv2{Pg}=iw&d9?}Mg>*@G#zuyLwPty
z@^~Y-+>EfwLhE35a1&P5XdT52Cn$W*2va5tAICBD<l$D#4j>I}jwzFegObOa!G9hl
z$MX>odte_yRda>0ah=e(dcoDz%nOJ}xv_mP0|Oy#i!v~*n5@&!u;V_YZOyHH0H#NX
z!NSr5NPtb`&`$s`KvvfZEDS*6cIp+mO5%=9fO(R*XR0t#09RtKh(C!N$hfSuWyFTb
zD$9jELGDXKdy-RNlLQeU%}9luDn}dOD$Rw>=FkT;6kU0krl;uoQeipO&AR8Kj-qQZ
z5vk+4)2xil3B!N)>3C#)#ZG>C7^ywXtUqFsl<2ut&(}^0mCKoF`ML_rN|Y+h{leDz
zi8=4OihyQYQj5LPK!~GXIa@<+4k<4Td<Mw0R^-;%HE=C>>!FnTchUU@hJ@h?2Q%=P
zp`KPVK4QXaya(~{N{<Jza9TGhZFKkH<C&E0@@$O6L;;dko*gAIA@&s^7c>W~llo)N
zni9<G9M{8M|Bp*Q>QuuArm#v6=GvLD(v8+xg_*kL>us}DodfO_mJtCuGj%i1gU?lU
zw#;5{dzjfU6_Y)?c98IYG*4x9fax^s&5yM$HI{}LO2@Lgay(l5A-m7s&39qScuo9q
z{$f*><g_vIoVa3J;5}w=d)T<tQR{N>{P&S_Ux<tJbRzo~{r)}i4_imZA@lo5tv@k|
zj(4<DtQI}T5hb3-^Rjd+WK>3#sOJ!(q}p9uLH18z{=QH1xj%t}hs{Owaqsttk~(H$
z3{fKWC-BZnd5GYe2gal?5=mFZ%ed9<G@ds*p1%rj6{3&ZUTXe)((8|{%0b(DQ@m2{
zk)yNMpFL}jF9)9GRGkA%NYgl2^_tIr+|WF}ml@mB=3O4dhAA0?FNFV^uW26FDvfPj
z``K*aQy%o|=XN6HFwyGQ{@bkB;}X+x(kKNXH>7?`egDpyXzM6tVa*^2_p`aQY5Wcm
zzMyjuI5+R3>sh`r_Osd0yIewA<YxktJj*3sEw&pfYi}kj4@$Uqgud%v9%R%^Up!0Q
z`kiw&b>me0zGaN?f@1SW%c23_#63$#;RU(8H%e0WfdwP(U4iz2BHoS8xdV6p6<+Wf
zb?*unUO2%lsiz)go4PKKe(uVl)V6oTWbE8n_#v>D*|3RKZZ&!HJObp|c<Ir=ukXsO
z98Di3QNjyKnyqsRsT<46t#h7@UhWlR?lC&48#DHSFwe&BS>@J@1ZpCwJ>%{-IOoHI
z3l}!0-iAWh-o=iQ7_~eP-#p;ot_?moyc$&Q+PJY@!U%dZ&pI2TcJoM{Rd^%!&#3UL
zUuLSJhJpDez*@r!BlB?ekf`Q|A0!m-Y=As--ay6Q)gS#~uWIcpc0?>4l^x4<9$_!%
ze{4bUt3YVS`hL5~dmQf<+Vs!lW<6>5DmgR&ZyF?@;@H*NPvlqR3#+>DOlIJ3!a0ka
ziD}1Sqz9xPp2C?|*-5dln}#OK3`j{R@)=ZJ@Jv62<6^i0;_TkMp`QmJMtVU3Bpi_8
zCbA_1W(Yt?CZ`z!yT|WkZoL^4=yCm)%oOKhLntBo&EUT*ai<a>Gt>sXlf4;gTa{vr
ze*tmRCk_kQ;zl?as_b#*-EZip0f@og3_sF407F%2>l@qQ1pwk9%tnuosWGPNU2CGw
zxYR@~?y3z4X76)BRul^Nx&8*dhivMI$3^9U6@`~0R^aWN-b2}LbDHeyQLC_p!>Ztt
z@_ViONYuh%?v=Rr9Q%sKaaWn;Q&7YJ(aMkV6tJ(TM4!5Mr~yS-Fz4_Rt<>pLV*7sj
zai8uVrd^2}<k%NAjx%Pq@KDCoAL)*NUqrKqt%?S0>X{M8*Nyg@U;h&??7naRaM>q9
z8NuCn_);mqJclqYx8?O<b!Yh0_y?xmj;5?KRtUF$Gj;1WS!b1*QwY-<f!W|QtLD%5
znA4uT3^lX!?iWF7iM+Let&8nRKU<NmU3p?VYIJSXsK8$ZIpaj9O_}|CT98&=e~PuG
z+{GQyU3IhrW~|B8mb=K43L>obnl{&5W-omn?tB_!zZVYsQMTz7W3>kw+6R@FZ9*QF
zZMvrH@W3yJ$sx<ICZ_dQ$6rZEbzB9lpM8C<-g<%j*TNRaFM=JN?zaxy@L3=i2Rb?l
zrY8kVOm)jgcg|Hjjj`AXZ@BbxZBV;<@-`#D#lxlrQJ?x|y|eo$)VUQ=Km3bB;;211
zAbv6PMUPuRyq!avw&%gOq`IR})&+?6v!l?&PY~^w8yVuA%nTDH1LA#se(Pqb3{jo&
zd9nqBJ(Z<=6~7oNIVfysft1}gBo~rsw&Y!auXCnrwNrwgnk{9ipiPqh@U>GUzGg@E
z%27EB@T|kikp#72iSCgwT)zD#Np0AfR`8{zYr}c1HL`kPQdg4tY4KNC_(DtyQ<Fi|
z`Ndz7og0_J7Gfx^doP1ythzQX-CBsTZ0jyJZCj2l2W3-QUsKh;|EXFy?xJoZzqT&v
zFSiap^Eda%F&Roj&J+$BYu2a^i%k_?PxlM_C8quzaXGl`?G2COa+`F&ku_G=6zq#Z
z4Xqcd>GrdQgH_DN=IKHMEB-A707I~>tw2d(@cDVaz*F++_DM(&Yq!adKXLH8Wx0g%
z9jRkk!T3r3FHm-WvXvT5L6fF{W#rhBtpsRKuipqUZ+f9EZ$BfR^Kv~MX}dcpTN~}s
zbYs_GNOsk8^TpEPqQeYFwW*Wx$#<7t8z|<0Q~UftLD$X-r1quW;`+)v4LX~rB9&%Q
zz(4pbRz~Q+`0R%G^ImQ1j;qNPPmQ<)e4-A^5p}{c=}4Hdn2fS9d$sVJb1j;6C6EED
zA7xT54j|Z*sZLRX-=%-juUD!PyrXkxOH3ko2s^K<!qv5!58oB3R+m6LXB0o%mCt2p
zrO%Dzew-|PnyC2su&NM)_hXTp`DWoUiPx;=s5Yw-|9WSkVh0%}^C?(-CoR14TCg~p
zwMG0AtLTa-jFboN55F3pWb<47Vl{$Q@kkVPbsSoq|5o9xCy6cRt!yD|K)>{++O4}o
z6@upMrsqXpa;@029KW<YKfcbk{lDzeThH7_>c3?R(`H4c*iRrOj=SVEI|$$_c6ar0
z2L1yd3t#gk+Tjcwa0V6q&;q_hx$>J33HD~b#N`K#jnDEVJSv&WSJEA<vb~cw+SDYN
zTa@6#PAZyt(5UK1DiV$I=G9XNjQ?aQGh!Jhv+8lPj!UD`(v4Wh`+A#wN%nv!VWq8A
zPR4D(p^k&9mTilBVBl-_z>zTK=xOGNc~n|r)72IG*g_w#75l$KeOK&@(6*y`O6SM@
zy~@%HeOOoKZw`DsJwvZ<{6Mc(9bPu`upTZL^mgsxd9RY?vu99Nn&nfVG&uMq%g2W@
zuSx%zpw}gY=DS?Rnz@=F<l!+*ynUX2MhwlTU)FzL@9CAYDGs!yaoH5qRf&B)TUw#u
zluiUPOYrK0N3+?|B2wekwrT0ehSTDe50^VG<gZRP>WL8OPW5)jc-do2pKaRcg%0;X
z^XR{8Vy^cC^G*yir&u#ruwtjm7p<CAjVO!Yj8;TeBT6GU-=8z9j~~D2ncXyG(KN(c
zR=iLPpr^VyXm;3ZcC`41CHjYTUC%LjA)k>^zT$=$m2u7XSH7sR@^zxn1UIP1FSc!G
z=;6XrCX%o^qZ#Z1C@a9O&h&1xY~fW%Ff$VD01#h<eWU!hON=qhbLho;=mj`#5@IN^
z9SQ-CAJm7s0!a<$w@?~eC;&rAg|sibg@N~Ot8QWFa?b~!U{^gz`x;vqfL^&!R2)kg
zBw=+9RW4exIkdc5<`nliXBc#;<FGz10*J&XfM_h{_yqj#5xekBSZ~Lhgt4O&&^?h?
zE5~=Q;Gz7m?@0Ws(=~D~nQ|`I%<xcCe1#cV3LKRT+Tv%Ily)@>P<9|oDbx7R(fBi?
zl5ddjb4E!4Tui@c`UE<V@7s~@zb0^F3EUmBE_PtpPec59L6|bNSY7xWtxuWO$2`P<
ze7_D1yG%$0(4>FY>v&8NQqR+*i=zafE(9aJ>tN8Xl;nGY;j;7X!6zv=HQF@`y;I3J
zhZLLu?L1VnhIuY63%#@yoFCauUvI<+|4i0p8W;7iyvy|^O&{gr|40yal91|<A|gW`
zNQhDm;ZtzI2c|{OI;HuH4(z<_I6YFF+TlGqAV(*|iK*&zGTm!#@ChqAl#enH0fq5l
z@$H(K1yG6{0G-kv_sG+Q<#(uDI|Oxk@7q;<ME$*52+CRww$_iARfj3M-U(7JMkBpl
ztkq#$BW4aoIKk~(HzhZRobW$Coo*TFw_o|{u<{kUeXC$ZMwZSAp$MeuUGDk$$xegL
zX)O6T%LG8@RH9qo!=Hk}gm8Mt!}aO^%D@JQW`2}v09sLmJ_$zqK`7OtXutiY0FMtu
zGj;l;7}`(Y<<kQ^j}(lRIIMR?Qik21;&mD=nvUmz!oFR0v6Y7XNW?44z?A+j@M3)a
z@}a%$>UdKoV%TBZN9VE&UuHon_X?T!`QVF0v<~0Oa`<@|$6Nd(rNV-Ok>P{$u<?=M
z;R0vzRBxBEqJp`RVb*QB?TSz``ov9_w>ceA^DV0WMW~xas0p<OfLa478*P+=e*&UE
zNW(wD%(pc9QiMd&M(KEIXoIhjOG+k+g_4Kwb4td8Pp#y&pKqw*-oARR5EUl0k|#%d
z4<{(8)87C0J*1$#$$6Tz_xkvzJVx!6!yC}!7YboC=A}<d$LARxzYyN9h0;;Z(hbsC
zD4K!G{VY@#tV>Hc9e+}$;Yk(>NV)Nn=qf{L0Mh65C~CQH*om$llm@^55>CY0tCSnD
znJ6#Hjb-MYHj-(0PptK)+yJ6)DADJ*_J1TCMnr74s;;S!e=HhdoFfHXaZIdNao6O+
z7lXF^dGN(}^n#tnf5h&>n}BL&X|U|A?cbbPe;w0u@d|zY%uwwQQx^$obj0fBj9A#7
zKX2og*GX`IN8k|QG<vvNb<I&FT_CuF=Y=A?u_hK5VA0XvQnUE=<X&QtLB2$NOBE?i
z>Q~3R$abyNK#1s`gTt`aoCEeJUE6atsJ<nweuo(@nH&07<nIw=yBx56`OGwnfHg-8
zi&rk6|B15~W;?%_QyjFHgoJl&vu8Wk>R(lS3adN#($!a%eQaBDSf|C-{wcby>#v<5
z`Tqc*#95qzPzkj%ySDEXdS|`@Q195<Bit+aZbe+^o%sN)=VNQXI14}(B+SL0B1s-Z
zM_AlTjn^$vU1Qi5d~<Y`__BT(Q!5VZxg>RWctN@y9|Tef878^&G_HL^zM5D1)c8e9
zPqlM8$EwQ(f3#iJZ69u~zMTqvHJx*?`eXjr_*~3|w?Rs{)$H#-ii%C2H2AEvow>1o
zqEGfH8cTi<cS#UqCr`~ZUy>@qe;caGJ^j>+&NobvIF}QtFHgPTW$j9=>T#Cetu|i|
zD9WA8c-~_n&s$|KCVTlm`{+3d@S5z+K`N?V8?M6Mkmr4EE|y>}X6H4T={d>&zB=i;
ziY8mBhG(h9^hH0;i+<mykur~SjPI0cWMA}?4G?M<o8W1hKAT=`E~Y?IvH73B>nb+e
ziD`eP-hDGZQWNsH4zp2h6;WpK3#_qYiTS24b-%muLss`izkK348#S0K8it(V`urJu
zDsu+OHEf9o4Cw-9koqVE;4@1Wr&6}?2ynu>Ea`=1vDtmiz2}z2w<9K<HV6TH62Dg#
zABWWI?u<S*{IdAzafm^$BVbE7TET@IuyhyOHt}DmLOLh6l@ITARNKn;S8y={EM;Tc
zrh6S(w(@OBS!{aX1e5jBs4Re9HrB+S#PrD%_&m0y_Z(45>`Pafb58U+s&3heMJWN6
z-k-#40z-Iv9s4cuvzg}|Z}$b(33>;Z7S=hJlC`p<#3AIM!YJ_;!3N%us83sIPt(h2
zud$+5;y=<99weIpY5#OH-@&qy1K^BFa0W|?Nr&u`ElbD`R{S~EklH)smJ=y$UMX!e
z;1F(bNI+hcF3S>MLR(^K)P_EJ!;ZZ1ny`Q+EHIl~z#&va{3XGV24)jSN}Eqg+Z;Fq
z1P%$wi{g-80wzZ$ltxJ;L~+P383<AV1l{)J$XtT%Z+<F~p!<SZ!bX|MFa0Y><s|4j
zq?icOe4&!Oy0j<QC=J1kSwbZ?>UC<A0urACqFI{bb3UcaaV1B(lS?)J+n&#h@{wK=
zO^&Q7jVg89eXiaBkC?5s`isp0yNbrr88idQexk>;CH^!gMfD8PBOIE6)tB_(r8sk<
zMf8_WM3N)0qvFm{+r}c@=t}OurSIfV_zySKsO$ZBC3WhHJLHHHE6zn|)F@u*Jk{T8
zDZMa~b>*|Kf{S)0T00-DeQrA#x*e=i6j?y*I)GBgh+Va%QJ;b6NaH1E87d#K%Q5R6
zm~N*pX{Jka2cnf_GG>S#K=ey)G$;j+1JNbZ@Hpm0v1abwq+HUVOD5oPLTIbYOM;nu
zRi#mvfM_e@B^wzk7cr(Yb1$11vk#>X5M!Q~Ms-8ue~}O8%~r=<G7&NM+p7on4rBF?
z;hTgQ$ld*eGb3N--X6wsu28$~qC<x8ZJ_O?5qukSlz8Eu_e!_s_EImtEe{QGU*ag-
zdt4e7tG^O!w-Wn$<RD?>pxtu`B~4}iKEY(D%%@@Z1SM7!?V65<L8$>oOBtDatdygh
z3NDC$Mh-&VmaIfpjw;SmSI>?dn30cSllOecM>CfAV|_eAklK*4$3Z@-BXIE3fchA~
z20<Jk4e6DJR2ablSKz&JbS!vZA3|Xj-Pdms41q!+L?VYjg%!B3uS7SvhvA1puISR(
zfpmj3Or|lMGZPdh^+#X&PcO$lN7^B4iy)O%{}?FqM_=X-AT$1^5xg)H#7;@vwZy-j
zFgi2hOnBRwdf{|ua-y>{0VKBticN?o_9Cw9(%@_)h}srNa|;Ay;A}~ToD6<D2g%E3
z!-mjo&{tFV6%)D?{}Ap%B$+o)mzMOPW##cJ!H{PkQ?#$U8U+O^5>7`5wKP_PJt#M(
z2df&MXc@OZxaeER7{<+`hHyhS=x$+oc(#|>pys-4P(hzW*++@k{^f@~Ut5_TYVzgQ
zrw`hX?(FckZGIQ8kKEzKG1H~Gzl~+XM$dd%=hsj}2CVGZ;wt_P8^u>Gli&YKX{&@@
zd-x=##@HZOY@ow0cg&&^s+}ITT=T&?v@-VcvM*m=rNuL+bL{Kabczj^eI?GC7(P1_
z#G3~Zq-X5T<UxMaDj{Z3sJNF6^@nz@&ijo$opg_bnLH2KRaH0&^)PfXT~8~k2it(+
z6f2PZQZc8*mR``~hVH(reGT!9mN_+OV<`^O3DR4AO}qFs9rs9Usc1@`_(;pZGl?s6
zN<NuMRF!i5u3-hzCf#a4A<lo?sQkUt&hrtYEeAGrVs@(h)d5R$!qJf6@?cL&YkI68
z?U<4h9#6m0i9kQuW%6&PZZYH4qoH!S$(gM@PJ^5ria+D(J;lixX=Oj(lO3N<nHt)V
zl8zNgel{PcYJ9CqSjw~pW;hDZwrI^La9b=ZYs`2)PIs>uyKJMwZ82l-d)D*u^I2t$
z^kl0kd*9-*%TwXP#Wl?n8m0GZ)|53y%kI~hjZMWiO@x~W7Z+WaOD2i`_K_RVl-^1@
zp6}C?4%FTmui?-XZ<+{vf4TXsws&*L$ZU_QIL4z@oqIIP-uEGq>o$~oRKVVsZ{+1l
za?#A0Li<qx^;(^1Z%v%H?d@CMnyAC&+Z*$N^&{T5jkHoL+JGZ1Ud?Fh{cUj8=*m!_
z)_DHtiknu6$$X$BGd~-sW#!Y1&KzC2ls}rAI8wj|e%~Os$L`Nj1nThUiT0{gU2_@7
zZ0?TCb(if={3xQX?<!}4?qIFf?RuYkV386f1pU&B!nfA#Ds0}dm`ZTJeC{Cybmi<7
z>8l~$=g$-l(|35rI(eDXl-qeII!m^Ph+|00_m~DfaAG5fsM3sz8Pd=m;#G{QfGZC{
zq+haoKp&$j==w4R#!gOkCKQ;G%`nL@H?rBZWVf6?hD*@(NeT=|HhW1Z0Mn}VF^WGw
zIG!XFsL`s68P?FAX(LRLY|jXep(fvBzVX44olu}k^D1VjL3>87Vsr#t`3MEfA<Oz0
z9YNRn6c`72*qMMbB`aZ)8*Y-7m_vm0F((9FAEz_`$Vx8>C@?KgA5-ljYtNN(TTWpt
z?_y~EJwnH1-USqrREtSya3|GHOAnm|^gO^eO!lIHTQ_V;uKZiD9o}u%38nxvSRq5C
zm?5Hn$Sp#f$!=FAz?FgvLFWW&-c0z1MBAYXNr4Og7ZzGSnR9&QuH(Z?znNIq2kzdt
z<v6L^DH8zJIl<GfNctpe0qplZ*=}ju?v}4ex;Qy{v5=*{l1a(wKQ3t1Pc?>05C$X0
z6iLxKC!ApN)<4`%w!4@E=YAMdqW!PbzcZ$w$bxU0tUmW-+q5-MrqA)z1iQ}H1dCTK
z1ey{*eBh;j|IWU^^d&*t+pWCV)t%d4wx|b=_i1v&kAe)LSKtS{Sn2iokn=XWT^T{<
zRT;E^Gd;-cjIRM_w2%-b|26$!X~+WG(5;*To-ZQ(;l4|R$LJis(GsXeNZ9?AQEQKq
z*zB*~mPsWRYKKUk>7iTd3jL!OMT3((+vkgU+W5E5bpkt#w4rU^*(t)G6BeI{XF7(n
zhNX4`_v<K!bylo&M-$et0O?DKu-JV#vJ6|$6PQ!>??`rR>xaZo?DIb2UgbfVv8|#1
zvvW^`FFa~vKZIWX1Nt@bCz0m}L7cE+CT?;cA+C0uHVowJbm}{>S}f_55;{B`<#L?A
zsv~shd+WI)TbxE-b~HPpctWN8Z3gz5nKVQ7ngcuu!n!=|!Nj2~&bX^pi>Z~1Z3@WE
z0pzAGGjOEzBvN`<|NrN5kKu4E2Qe0Bv#EQ3G4j)LkInnor@1kqnFp5t4*&rF|7^H>
zJd^JqKfW1TLUSm`G-pXjk`mic3Nbn6e5!=rQAuQWpfaa&K9n|;$RSaooK}VvIg57(
zX3a!;vpH>yeeXWM-}k@o<FV)cd_Ax0dS2K4xbEw9UH9%s-*4HyT}&N+dOzigjOs{(
zR}UI?AU5Ws&Z?nL&h2qwhr`UZ5W@_dg7342-rGf=3=;q}pS?K#q}T1tOox`s4A!&z
zKdt9`7e7sCy8C}9<61uDT9*9ZYYo@ZdnO(|6JLB_O5d%0`~|noWhTD-Q&`S7|3{zJ
z?eZ2K?474{lQxh(&QqtY5)fjm3DTqMUO<8B=(?5j)cSd6Po}wA*Pg3hS;x^#bI_X=
zaDovXTv-l}GDtv=55r3Gk&LQx_@~+U!HRq&{mqKis{GfaDD-bN#GrX4{IcpDh&QYj
z_Ij7hk_||Z*{;Bn2BBzFco-uY#8X#T>XhXLAsER@ydc2W2@)KFplXN+C?mO+`apU~
z6C~Ktes^uh-U0IuJ+JQn`ssC=5&K1EoKy28n|}_$K3&8=2l$>)1^Z1<RYeFf_UYQb
z2QtecRDojK-8IE4?v~v??hoc_t9k;f=Z(ib#(v83uOV1HO8jep?<YZUOcV7Y3jt&G
z)Y381TseY3^v^CNn2tHbl~d-6qj4YZ3Z9<C4a4|$wzy$6gcfwZk#2W2t$6gGteipl
z<6-}#6>G36Kzu!;+;y4G=>4d!QbF#nnF_UB%JsY45m{asf>EKw3xfz?#?BDbXDTLw
zQ32+K=`Wdx3ex>^kK3dj4khrEba1wEC<tw!nMBE>4d^Vr=?Gnozz+-q_yB+lV19g?
zd>6pY_O<o(lTIbEJ@b4m$C9X?c`>h_Ut?<g)&BJbq1sBeRzxb<BGv3fkI!PxpT!Eo
z4eiH#S2!bS3l$0(l<ob{a8w%|cl+Gt+^MCJG!InUNvhEtj-&m<sQu|?S3z_KFZ(}*
zfZ;8s!y1lr@gu(h)4^+a5+DdIv(T*B5qW+~U!2TYx}`VJEIVbwv<-@w-f3B>Kj__T
zU3>R0eE{g)n<z1F3D4r{JkOc%8TX-x=AA&;09in$zXgPC-f?*z`gP3k8B<Qm_`;8j
zh=!JH2Dn?D7JGhO^?h~I?1e*@KZYJYbMvit+>b`@I8{&mx)DHn*S22ut8IM&$WB1c
zhR=LHxp98~#>A8zx89js?=#$EZGenP!!F44CJX@02x*$=xf+IO5ktoG&V@9UKlmY^
z+98FE@!?JUGqD@zb7g18R+MWj*7ZPb^*3^09%51kKc?D(n9Rb(p56%B&zn|#gqY03
z#hR((Vm&ve{Qz|e)#`wYEf6fd7=tf{qgo|!vEy^eLakwVTxkE67GM3pzBsk5!A6r=
zFn=1d)CprH!>Mq@O9XNd#{&tLh`sP6A%+)JJYA2!x-GPuMs??&oqMl1a#<+8{ebt6
zuzuqK{~T7xk>qT_Vty1_Euh|Gb^x;8Yabuu>(gFj*6P*s>psK&680!xqM=m32*DbC
zaiQkz*iX}Ltnv@JOUOGfF5qMh_thKc<v*C1_~hfW@*ZP1Ek7gQX67tDt~j>RHE|(r
zvTzjO%NxOc*EfRChHnI4S(|f+I?RvCd0Sz`o;{Lad}*l6On%JX<Y;)g(yJ@wN;v>O
zD$kQIE+**07$4n%E{-g*BrV=T$$JU9x4;;6V#N}eoJg$5G`JlyM0Gv1v|BlLCy4xE
zr-e2cBTjX7Nt-+m*d{7ZMfNqEiac9&D)P#jd_vTLj~03GWw$<yyemU0X_v^UMHRz+
zuHa=i4>m?_xq`?a87woi9Wy$5bY4N_)q;Xb4#1Dv0`?YrYheB)S(s{K4189)%d#pi
zv7Vc9M+p{h_QWY$lcAXvMEN%3a8{UNoN|VRlp5xzHQ7T0^E=7HKog_?*J6II+xGGP
zkbD3x0A59xC635&qX`y|!?%=jcFoKk%dHqGwNSmojeg-w_7}k{LM$vHm`K8+G{kgi
zMbe@TO5R7PXcEESBcPsmuXH~JdaX=Bb<!w9GzyprBy?yd%|xr_RAl!@;9lkcRLQs1
zp95y^A^<mFI`$fDFw#?si>JHC7-#Js77qce=Jiwl=idhwvP%RdHH=dhtr8C&6Ac>^
zC59*ZR*C0ViLY@+0@p?Ye^#96LjS3Fzfkf1D<<hZCaD(pu!s=q0X&23{|6f0{7QOt
zrr+zk!R_T65oyR{5gL||^=4?OLw4xkzH!FFu*t!A-!|fg)y46DBtk|2xB+<5c-OcW
z!1Knt^>4q*AHVQTBl+?X*5DtT5C@&^%C*w^a_Nu@n}dbXn}dp_35vz80{7#8{yZpd
z*vfKkL<Q=<P`VI?XJuFQ=MmOQl~&RPp5Kv2P(WNizgBAe7v5i!*}4r0m(NxuT)uLD
zEoez1WyR+ET@^uawjeWR8rq??HP|3Au2Q+Rq`lNxK!*p2ps*=`_>*izM6|P3I=>IY
zZ%A~_LQ#DNf<tD!psUl#Z&!a9cIVrtXWeR1%xVADr8s@HfMLNj8VFe*vl#YVJ`-?P
zs_Rl_m*=v5z~@KO0iX2~OzS>-E|=A@wF5pov_Bl5ua0|D#}*6t{Cj20Q+BR8*7Z_U
zyB7bzk6fkVfQ@jwv^utKz-M^-LkiXu#S6!+jS0SbE+^HoZ*7Ew=c>i-FeQF@;KAXm
z3RDlg73bT|uUi!*E0n}xynUi@_iH|ev_i=gK6b#fP}d&gqRKMSnSu(dg_G)&aW`j9
zs*^kDFqL3(exiKviI`xV#)HR-Ip#6JS7g?7@IiWBy+~|iN&c0fLeL%$Gfkx&GH4H5
z+&Rb+d_YpJ<iiVbXBqzaG~QW4>XK+BsR-mK2U!)Z+<_sa{sO81Q@s<xT0C|?2tHPQ
zpcG`0OH2-D06Z#YaaIJr4BppG?HsMLSByq=Hg76DYoP=UZb`n1L8Zwqm4R9-{oVC;
zQqvAEl_|%b1No1NwHAu{_rYR~q5fxUt9C;eU5c^BQmu+0qf27`#RLTyqwAV``LUX+
z-Lvj_%-jE8c&oN5H?z-ycgW~{pF^d4o-DOh)WoQ?r~t&)uIY1-UCySqY5{HT$m8v<
zatcNbwzCJBMswkuWCzwXlHREl*X->s4r5KHTli|i0rp_Y+_4bJJUv)tFRJz+kR_uW
z2XK_Sk#<%A*UCRNtH7oDK)KqjeCBsA``Lb%%o7e?H$ua#{k_fj4z4*JM`+yPy}b^<
z&-*I}$Ax(wG}25dunWxTNWaQ0DAmC$UFH@{1N4Js1aaIx+^>Uwd(x>l3W19PPUGIo
z00YPIb_-mnr}t>5)}x(_=X+Xrmb5B9b9W`WyINI06RCWb=wQ01Jp8~0FYMIXNNP8x
zDV6vYqu)UB7{z(Z2ws<sVf1B|>_M&Bo?zNmq#)~^NF{9#TH6oombkMdyIQ33V3Frq
zkbhB;=h40q646}MogMAwRq^Cg=KTXcBSY0RfqUTgf$}Gw>Z)y@=6<<9zVClGdZkKV
z)jf+|%~PxUK(AJ0&C$>qtvfaA%CbDcEcY6EfF`SM?oG}3iuad@+XlZ)+wxZ*`uE;;
zth?BDDWJFNz;Vx2uimQp^SxF1&7#t&J&uXhy4v77!`E^c${OH1^7S>`FC{Q{2=>Xn
z^{4*8%aBOrd-0NcP9Re?@Mx4a;UPC=Y=x8la6!p5BUEq@Ixp&+BZqc;3<|dvsSI-j
zz1b0K@JH#*>(J3*@;Qfi+y7rQ#CNM?FRLKQoO_)nllD(T8R}V#uXbEXb1hll)3@)<
zWRlFBQI+O{^)GBxfB&UUfZm1p!OXwhELQ#ft|7$FbEWY2hj|yj`gd*$9tHEMW99E|
z=QSDDa=&!BPd0T0tTwhSZ#6DpI}FUHN~6xuBpagJf7`i_JJ3I!vwVBqZJ_bG8{G5$
z{170$k5`5I9j~eY<oi$O+Il?h=g$9j7)$ngIJs)Kx~h&C9k-m=$b`?|Kvvc*TP4t8
ztA6|vBDPEl%e8{^!=&8cjbJx>sb-h(68&<hv!3Zo4|^%`SR2r!^Ln6)$kIK@)>7!C
zG{Gzy9H~V#<ANtiL^Bu530qLB3?%X?(M*JqQA1UcTj~b28m|SabV}A34^WkVE1eH1
zB$~#2rcUPdO|1rP8=BxfR|BWS*o%jkZ<#LNBJx{2*p8$)xxmRgw_iF2LciPz4Rl<Q
ztP$^{K5V`e=%~$ohNM3_%zah``?fpN>>|t2l>3a(`g~8EiS?vprr8s_NE7sAdY0J;
z{SlaZ$&j^Z$6Dm8;U8pmRNQ{KXcZ>hSFpA?H@t1R|IgH`{57!kJ`fAs7IG9+YC$cv
zD6xqHS;tZLe0t=-_?$p63uSzkS_<ewOSK+{M7|)J!5E)wsXo$6^6%z;BtD!pAjC@O
zOj^rDf@wa@q^4Y&kIu`vA1-EXJ}x6I+DF=au8*{oU%lOQ=h-cX(2*8*jnJ4_uehk+
zTAvqwHE<b68@k{4di*CfTKJ7XX&l0Rg}RO0b04v-ekN7<EW^R{oQvr>Bu=>tr+iVc
zVrJ~T8Mb>fEO%{W|I*0*YD%Lv<DZ)YPip^*dp&0Ppz+=8kjJ{k*Lm`3pZI|%k6GXQ
zD`toKhn9b3o*7`6AXIZ$O0jHBZ(uPtT#qclIS&mklb(@JA6c;|dpj#r8^7;wLCl(k
z`A70;-66kUqLvSw%4Ub`{E#7MH@He6cX~q;Po!ZMt}KQ|=WnI=H&DRq<&UiLaklAh
zSI$~*C>b|UWI}$2(gIPM_W(6IK&oFe364f-LIKtP_@$rRTnP5|Q=e?CB<4YM0rJub
z%i+h^niIV9x48BHF+zU)+w(30@p~8Y%a6H``r)47yUdXH!1Y0wb%3$Q%ASy$0mk_o
zsr3_{3+mfd`(jWF>RT_9S8U8JhdbHHmgR`Gvn0e?E^cB3P($$eY{Z%tY9Va3ll&DP
zpNLqC-k9D5PHUv)@CiE{sp9m;8I)js<;>x^<ODi=6TN5RbVu^Y#A}tcAhU%hKVHI{
zgAhF`%ZZ!zS*xphkj?8#6Q1qKBj=-)CJK6~?e8QPBrXO9L?}%>Agx1~TPr^58IE#`
zJ+#d*<`y9qrNG(Fj>RLGTSc*WzQ>u6A=;)1XZv9+UTt#99t)B|fM~E^P1eefbdZD;
z_#h1i;(!gA5N!?-NrN5c5V^IP-DN583rvV9hls|O<nh!rkUL0lm&m(EbS#_p(r)xx
z-M)H!2RlE>_eL*VYYC1e;HgwpCQvUgC4fM;iO_8@NJ!m@Jp@Kb&Wr{gsDLJQ!(Mg6
zA~N9640uewE8^4jd7E?1*h;v3!Wmc^l9qJJh8C$3Y?O45e)ux!VA8L^NogOYBW|f-
zm#sgQlr~5zhwCTZ3syRk3n(|J)SG-Oo102Ub_1&a@a0&IUNvOl`nl{+Y8HiN*7;VA
zNpYHVye&bPt|n9hZ<{1;h2B}C$S_cv#oHz>8v|!bd0B^4mGquzYOdzuwH*1UnYs8}
z9_?HVLPa~_O74oWd8^qccF2?R2TGlt0SdDrS(fHq(O_K_Rl1tc3mVffq;oamuc|@_
zE-$LO$WHu1Uro!&*tI(wj*nJzvlI*wnY(mVa?a>VoYvjcvU8Gmaysf^{%^-=aY}*H
z(fr~o2i?R%+Nv00#%DdnLf#%wtgcS1cixkJ(_QT6Q+hYwP3&j$0maa&#QES7|E;|}
z)s&wr^Rvg!Z|x2B+uDnv_CS_6`<4X3g-|4!_+b2h+K?fqwIq(D>K<AWhsH_)|EVcd
zs_tcm9Ec~Xzl0IzRe%JpZIQoRLECx|p&LZFn}DAeL7o$#{DNRLAe765@!i0Sdx|8s
z42qN?U|x$*PEvKjOLmi^FVJ9Pr;0yz#f`diuPw!g*R;k*|1+@@m>`%GW6ppi$2+)0
zXIn{5cvem*Ny1;!Mi!AUP-f1mQ|(7J&c}nCkKW82D`t+LEJcHe;ee5Mi5O$*)ZgLs
zB(bSbq!<BHFG8`WR){P;C(~@KX~zsW&ku5*dox|Fn67|LCk3;tj?75Gn9!zVfwdWS
z7W+^KDMiA(lBGD&Dj=LWGEE{a$eTIh#T<D<t4N|%v}hr1L@3h`EEGZsB8<xegDFX3
z??I6e!oW)riXAmnWT^;n73}%>nikqX3k^>h5KS3~w!`LYA$yZ~2X&CW(si29aOSH*
z-a$vKyfo#aHu4c^0Lpw-DsHJl8o0!KWy<*%jcrWh?X|<+hjWgf#okxnZd9yH83<zD
zIKnxO#@^54`D!2)NCT^h_DaTQVR>)&y0Pa=4l5*n^7V8s(j^WogOLx2118kpDMV$S
z1r&*aP+-(qFCyNFih?mH@zmbbAZ6aHq~L~>;09>>tppD%j%|l8@g=eC;O+a0mBfKi
z#<J-WAB1h+!xIr{2N8^xj%wuZ3BrOG-uO}D|55nW)+iBJ_eW&h|Jz+zzBPg+p~SaN
zYHe4n%rd&bk}&1oC16YU@HMR4cVrr++88o<8t8UXmeDX>0n9yR$V$`Zb|L8sCfqJ)
z9K_gJGoX*I5Wz|V^Mm!d+IO(xY5}rMh39S4M~ZHUhxTim-!LThy`|+HFR*7iB#?|Q
zG99Ei_kbnRo||GcMk^5ElzT9HNxZ{q?FaA2dKo*(1$5I2!kE1T-eCpKOg8U2g4tWd
zyKd8(1x%$;D6`j;GlRyy&ExIVXcr;X5yY1Fps`|d0i`K*Af~=A&C{N#pFpa+z|@!G
zbpIVEJEd-v<|)F-^I%q!cn8$lKk0jXN(p**-m9zY(*eJln#ACXdDZ9n)*`|WFrI>>
zKmsE012RUKNW_;C@nCAlOOXIaswZS=j7;mz`@2FsU(q}xQtF^7buo4V2jGWb1{~%X
zNpW=ku6=Dep^KbQmV^(}ZofyW12ZEmm@~bp*B<heb=qy^0wA>UW>Q@qZG1yIpqDnT
z%yjHRJ7Nvw0;*H$#F!Dav~d~EO*Hngrz+IEaW~}V&F1^noj2c^`@+Vi%{^~6`)dR&
zCSff#10plc<RGTp)pTr|ZTr5=x+V=_Y9?Nc-f@`js>mX)`IU7s_RiOBeG*75jpO#j
zp4xsBphV-=Z5?o)xSx<jYkv>hgm$;T55!|6M<>h<tw||wLaFWVQ@0{MY?}rO&Hp>{
zDtBW%>LEV@`C0G=fNAli?XNc<#yz>vK9tP2z0^K*2u>nC{2QG!ncC53=3Ruh>FWTq
zr(%c7<D%0QE1&e5?e%LP8k$id8BR5q_3ETxbKqRZbZm~*q_5;C-OQNlsLa<vw|`8<
zny61n(#?9*7l-}-)|hZVEAua*+yA|bO*`4%1>?)xws)yTszbwBK8k$#46KCORPd>7
z19hQ%CVo>o4j3&9-%IZpqj!k0rru@Zb+hoZNrDr$+mEd#T_i{2y*hrj)lAI+c<=vZ
zu_oTDNtRnnz()8UT2$BQ_1MAoIbIk!_8zM*x?KAraJ%iob{l+ov53EZFYc*gWf6X$
zuVcKg1IC{6DT>r&e<SdZV%P>x-lY+}+278yzrF5jBK9@Cy|A5haytpmMJV#&&^Ub{
zMTEpGVM&${M906>5N2fxchK=GY#VD9>I3%IX)=7Pa@OX5;W+kJM>Y?iKoS<D2*;%(
z4S@Ydc#$a_qX{Kw!U*kcIT@iiNqB*z``~`cl__nP^sxd70S&-YBL$wgp#pDiXhsB`
z(DJnXNAgC@v-Tg(k-(lc|E*{v#xdc9^VHSy_N2;1(EN$kL0P$ftt3ZFFT#@ZRn1>7
z5C$7M_jt$HvrZ&rE?!`rkmBwKZhYz^{Z=^Z1eoun&-J^5RZyFnQ7;gW2DpoUD~#0w
z;u|V(DcW30LZ+~fjz3EOmP%CS52Oo1GX$aN?N@vFMt1}X$Iwd>s%kv34}7D&{rI72
zfx?d2j$?4?g?!kKn6y8FmTA!YtJesDO-S_1N4umKx*?+RG~NH|5o!~fK&vd+jt@YK
zec!-|Z7xyqKUIf0yQHanVjDNJ-~XHX<F?o{p+>61|2iZ`uX)4g7RCVn02KGzn0M%K
z1)zYDZJ+FZIK%YM<_w>RuM5L_Z%p90^;^<k)_(t4*bK_LfHKNn7*Ess8+Jrwu?V9R
zU`k00A?Yjl&EqZ5SsZ+cwN4-l_7OfVf`7Bt)xfA7RQP;GCJfB8g5sPZf8{#@BAW{5
z|L?Q?^Nh^D-|eBeGZ2(074Ahu=rEGOyr7BvTZ-BAASaFFo3h6x?N~1(oT5(3qL?;<
z9df9$#u-&G^K>Ck#!;|C8WpUK%OxSin5ToDZ|;{yeWE=GXPzeV&M9z0vU$b`W=|o{
z_|0g7Bnc71>^Z^-K?@4=c-J&=dr64oo7A6Z!7(}1ixdQm+2cpUoMGx>Nt8gQ?x;CK
zTn(3)LK&oCKpZ&_rfv$)P7Rm+1&sL+&CtTYoaX1Kc7?l&qa9&RcB~3)CMB3v0l4(g
zxYR7lFdYNtx_YoG#Q9-poU+1GCmZ<kk@Z8E-}~5Mzk<jytA_^8utTwhlpuEKXyT|+
zAnslfWvFiev~1$R4o%^E1>*8=7lvA~L%rCcZ~6uj`v%@!z&UB4fJEJ^iK@6=I2-sS
z{(flN>`Kl0-oD!dUZHIra@;8}e{u91Uo}(MPsfkb@i10LOD3g&KCr2V8lVqUPxi;5
zapWw@IDG)ZUG`up?BI)CKH^(q+bKq;C>+E45Av5qSOXIMww<T`z1+P2*_J}-P}I32
z%7*hmN%#?8nr){xC#7H^<DNsqP?X(KWsQ=dsE=PRHy;$cbzD8;UN2DkFCf!_aP)HX
zS%ALSc3%8(xmgkjfo>@&5l8NDeiOFs?VqSi2Ed|E9Z~+UouKLro(u7$_q;%#Zz)re
z@(i4ezdPIJxzf76voF4`nce1D-u+@j^iB2N(HB*=o$hCTcpkqQF!p@&z|;S#zl<hi
z5CR~K@s+py2#`P-((#P=SNc-x92nyXgn&@S_}E+iZ;-$o((!^A0Aq~TQX{38R6qh~
z@uLo~9Sf?PrDC4)ouGBS(^R}gFJ)>)9hZ|b<u=QX6yZEND|n`ZlOs*NmK8oC38iSl
zFSBeRG)4GXR_Nm(h|J_o8Kz8SQzQAHjxK8C^Bc=eAf5pf=K$#tqeglWr*s%iVBSB+
z%<w8&xJTMJz;pDBpwWSOON(;?Nn1R`IWhlTpsI#TPMI2_ErK{FJeapqcz$X)&!)7+
zMA~8lZ81D$N-SmSrk#K+iW`9OETK5eo3usnQoN*q48_3-Q?EpX$pj&UDkR2mP--0f
zd8Y7kiVz|z?9t|IX7dsd%=IE(!kA$@oVIAf*?h=LP{U2x3&1jX5DkHD;en;`R2t$k
z6HeekV4OaoE-4<WaBca9#?`(uzbgk*o9kt+h2+yR>}1T2N&xj>W_Kk?<x#kT$|H@d
zS5AH})V>ztLd*DUB@nk0h$EPoLmb@;EfeRDaC8fKau0cOXo0vs2gsrvw7~ANg36Qd
zc|{e|o9SLhZ>HM;{CRTpqagR>b}pP-p~!b_0LE12yQT~DG6Z_)?c6<ahpowynYvG6
z>g%fjoNJjVya>RpWnyCC53}#1_A(3Emt(Tb`s;iccl{FC*95bxFUO~-LXE9Qh}(Ir
zBQV{Yt#_WS_qxxO(C6BGf$XAznM<<J*2L%y7%8UNlC!faM(M61+*}XV^Br*q(Bz%{
zMv6~t$*EZt!*o|L*UgZHabRIK)$k9qPzL|=Y#-6Ydu!sAGg1GXB0tQmfU=%X3lfdP
zS<jW?!ZR#P)i8go$+jAppGg){ni$Q$p7}u)m7BjZykdT3*a7@`xOAX6KeIxN6*ebG
zte+1g=O@K^tM-jp1G~je_MFyoG_r5RcsZIY_#o8$)B5w(fyTzIeKIm)bJDWrXOaiA
zowEnybFS|`cPDug0v2z(C6j5WD)W@Ivn=tvv{iW}A(b?xPa*}|=xK;-e0J)eHd#-o
zYs<mn`8O_pSY~}4_cn>Yw01=yh`k=hUN>Ie6kXmt%Rat)d2eFeuKKmv#G1HWwQ;+?
zSR@ZxBvaVOW#alltmCHK;^wtkjdY6&TXIg;>~8vvhx8kIthb_EUx6SojYG94*jG5a
za|mF?!db3L;jAt5Erc}tg?8iTvV`FW+KmY2+oIU3Ru)Zm77sMYr=<rpJ$(E!wFjPP
z4|HbF%4E-Sax9EA22=<Zb+%*$PanTKS+isG<-^=okvM<3IOJUm3Yv^rczVmqmJG~n
z4}Dpj#TR7Go@VhOnX}{c<)2Qs6@plNQ?4N0q61ByI_ZyAH;RfUZX)phV6*%731^!n
zuKDSe{I&<b&=))Dr^je&_fwPn(v$-c3RVyKPsP;t4MNA8{73+tYa$i)@1UF?^qq=9
z*|)X-5zD^*)LZ6{ck!1Zzv{B<#1{0ioeJc8Vpqra>u%@!Gh$FYyu|nCUlnM-_Zfa^
z@*6x47~ik{qfiE*I_QjYsaA$_wrz9AbiYd*<G!WFZY#3w_ioAQVV<9+^~|pp+h)|q
zwb#<Oy?4~;X;~PElI4Rj5_%X3JB&o9u6(1VK|1*z+U37d^6fMK7Jhg!ddB_#00030
z|7@9eP*Yvh?&*Rk#n2UyUP2K86@<_Pq!~IAnj$R(MCm0|QA+626+-V_x-=nZ=pBS0
z9g!d<)X;D6{qFtan>+J7YyI}wv)4K&*|U>O5LqRvqdAWBhIQfjj`Zb@^o7D!=iFON
zF-44Tr%W*rR529=1C@~gX=JGN4KsxBKl$?2-KkwpfEcEX=a}mwA`>9v4S7r|Mu^}?
z-JvDjiWAmljuQEf62*>h@u;Qxl5V|;C3F40YO(I}1PF<|Xgm{GE31%C1gzx%*7Ck8
z#=ut>YO1gGMnjZK(~;^+Ub11rmG*hdDL0>wCO}3LM4%d6Pz@^$t?ayf#Wa28QT@A6
zq2$`cgxbW!{Qx}b)LCO&U1Qr`16Tt*GD}ES)6gnZ9UT>fLbXOmA)}+2d5qclakaHV
zP-t>(?LT1U`zM!#N_{!0mDAw+CjnVE=4lh@k4SCxf6->;+m4LZENGj)gql{>ikLx+
zO(Dh*2o0$EvolntcAPxHwV=LMUk;<cbqK&`L4C$+;Sed&*!1KEDbY%4(QOOc#@*F!
zM2`8ew_f5YRhwY%`#-9BVobK)5G9{0ecP+`bap^z8V_e0zW@U%!9ct(gkHX!a?+3?
z)0hkltSMwnDrC$rOj-Z{r!$R}!NBUmI@lMnBoQz$w=ijJ32M7vTeAwa-Gth13wI?|
zmdTYn`9jj<%SEn$tynJFFjLJpBY@rEM@B&2);>?uSS$m9TneqorOQc14e8U3iFHb=
z3XBp9jPeSM76GL*>Bg!$rLKimVYbDN9w!sSqmIz(S~dt|pr$sxzBYYoeJVIPXROlB
z^JJoNtdd{$+|jPk%0dG|&@W&?by5}=^BA@{)p*SsV!<$mZR@V3fIvt;7jub}6DLo;
z(1HnS!Jca6E&y_!v~q_>1;q$!ekKc+rmE!@j6g@E*rcQDrJ^U()%;9YE8w-l1tWG6
z(Z8+PL?fZKrrNI(3nhBTSSnM$D?Jt~kZ4Z*{zf92zFX>hL+a!c9axBz^!oy7rLpuf
zs7^jqrx+@VM?vZf>U75-=Gx28lOe_u<<ZHL&k*@_Bcn6P`E_;qb*<KH*F;q%%AJ|U
zX3Vu=2x|yNq`)IF?@BG!Y@D<=n^Gr7x@&2e$7FL-Cvl<$)ecaRM*yHmG`ZHR>Cxx5
z(6U-78j!?by%ddT^s+UZ_*T|ZnKfH%`u9TBG4FAyxlt)g7~8)Mfh$S<{;69k69H`z
zEWp`Gl$Xj~X@hZ0Y&Zr1wXo3MaFr+rMnWy-ts%71<<~~X0qK*ZIvdpm2Z;p-c?AcH
zfDKIgq`J<Ao5W^k&3Hp3l(e>12_oVgl>DGd#5qgUdEu&<KEoJ=orH5ocWtm>!Oec_
z8C{Jl4WHjkQ)vx5(hRM4&&fs<18!QdfTi5IWJiX(g-^q0C{>-wW~6TAJRs4#U0oEN
zSQMRC6uk(zjmdeSre|?i2<)i$F|9^2+J$qPrsjc?>8Cu^Nq#{XKx>j8GRgnU`0e?p
zP|bS{{9Br^m!BGMU8j+H>zYHVqbz;%<tO2PYHn9ykJ}E=4NY|R^_!;cT;17taMLKS
z5;MN~x!g(8u%4B2Tw4%xBhmSL?*oJ02OoPMgn^x212K1!Jc9G!Sx(oDJPVsj4fSW3
z1f3DJPcbC<&M!4E%37FC4IsP2;)%cYRHub=xido7V?Rq(FkQ}pzQox9qYu5(Xz3UE
z1aS*&y}7*^Ru+@6;iRQ!Z+0>{Z7k>v)GbPit7m+QiOhG-&vWL>cfN`IIg?y3t%*tB
zaJp~sps>!!9+Oq$JeuQl+ps=5-|2R_)9uQ^-2<0gtkdl;gY}ED7`5@~2X-0GrJ+~a
zIA@m!d{EJvdpB#mt@OIjFAftak9IcLR8q6xRJ7nE^5LLs1`#!bI+{UQ?*59{8N%_B
zQ4V`NK0!EM@+T+gZS7}Fd43)W!cJ?^GaR<gE<H1reKT{9g~=-Y{Y;X>P5r!*>Pj|M
z;=Ru?VI?C6F5B30<GOeHbt;ZVtrTAStvu_4i>+!joI46$Nw}EbV#_36wAyca4(9=&
z*~-;*q`N>SX0x*eQ}S-kc_P@$%!BT0xh#IG9vd#}Mb;#HJ>zl6AiL>WjOJR5{#sy{
zzy)UVc)n<_-KQZbEV1sSLE2^K?#bB;2t0t!KVW$GSZQCTJVcH~xQNV0*BR|QJR5g#
z*9GmX>+~PTxn6J?WpeIb=+7z~#t9D5uJ4}FrL2WL@d-dT$ayIv9|v1xgbrnNtUded
zCa~%zu)f!|6G4jsDMW!3`d3X~bHINJ4`t}B4MInnB(by8qfKALhB8`rqo&%v5GDq8
zXVd!J?DaAqe_B1J&&Tp;PN=sW&xFnm$F0FQNA~Jsci@{m)@_IM^T#vlBjf7dKB>Pi
zjtwb}ttpNbHsDMu@C*k3wf;0iuCv*>S4Y)4og&uY#{R_rhN{1aXb$K@4#+OzB$eqv
z;_AQ+)E<}u*$qyCz7q;Z9MAmdKc1=R9lO$2ES<~Io43AunTX<t+fDb{e1_it8SoQh
zT3>d2=w5d_bxfym=BD}P_X<yg3eS%f9~J;A^`%_ygg1USq%^|!GhL0Rt(Ush*TU|p
ztv@iYzNxL5sjWd1Tg4+?4gRTL7O+hxFO#R=Lbe9MwOM{e$%{_3tN*ku6q480N}*!F
zF?Be+Ji{SZvB~wlP9FZFPJZNP<^mY}(g}R8Uf?#yfE8oFhM@*kr#L%_OVu;S!sPSH
zbi`rinA`rF8BA7wxs|P=R(>!mKR+=2@WggGMS1Ih63m68_K@k_<lOJ9y4ae3YT$mr
zG=qzL&e_U6Dewen?T;exJY#iRk)st|VWn=Jc+pIX(PpXPCeUc}8uI6maUEyLOsom&
zdyUw688Iwyzcvsew;7vx*dVuADZja09v=NZ*;=(M5DlT<7y??KcSk-CbW?Q-N^rl@
zLv!}WOl-SvJc2kXXciW+L=xug3y;m&!;@*q>?y8mT?@%4ogNMD9St5GRoaPo=cIKl
zJO7<`qpY!mELynmo!;0t=!pA0N7<jF?p2fSRbEMpy|l(%6W@Nn@wi88at*PFec{%a
zo+YQFo5}Cp?N0c%W1XIbfRZqek?Cmz;D~j)ad*n6l206D$)wmj(`oe5Y2wpq-h=Nr
z!ekkw*?S2~`tFYl7eqKftsx>hPqYA{T7bIz2ulg}tB)ETDFl?8dF%<H)_}FFwuWrK
z-$^Sl)YVOpGpzFwL-72YRIjC*^}<`qyYWYh-p(H`kK&IkBO<7*Edm;k(0=MZFFb<j
z*X633OJu8>74<*RlvN1Rl!@KDMO#*p?)t*RvPG9?;ys&Cj1Y^)HRG>z87=G9*cBb-
z?;jspgg={empEM+Aj#c{jK2OT??oag?*#+L^G$Ae*{GmD!60L3;v<56%0?Z?;k87d
zbeb|xE(#EYlyjg%oq8enJSbLa;T1_x>`2Fth2ROX&W;}r3$Ix4EX43ADtH+Q$e4(;
zkI<LpDCLz$piJ^<Uv*CVoei&<{ztqZu^{{-9r&HAhT8DY{GgbKSODrr8tMmdX_*{{
zbAM4sUA?qix3p}E!ztr%0g+(E1prA9c(_C0zg_|k3jh{888JMB3Z6p((j!8muX+JN
zdO%P-BT|q7`KJ)i%L@_;!t?6DZ~fOOfgcnR0ltM2NJ9w#mp+o?dj4zlv2N+3DXvEu
z*F$Kev|vDJG}2M{U!y{Y1p^j512H_33SL42G9p6u{@2I|2ufl^3Ns+Fg?K4mkZ2HI
zN(avNU!!z>P;>+sfGSKw6#|#W$Z_lN7j*~;+<H3RogZXDhul(!Q`|z*E5bkUgWl1U
zWpafN4WsPu;aEfPH$LLERpAA9K?Zl8%Nx)kiz9|?mL$n>X#psEE}SVb${xD(<xdCJ
zGz2fA17`vt`ND_pM+_OG?5UT&OaxDS>Ha+LB)|6X)7qIGLZ*E>AgoqC7>%S<ya-jh
zAY*@i9{L~g1S;PR?0f=J=R)$t4aHwG9-_bf{P&-mB5vNKeRryZZDZzH3&Grb0;H)5
z#c2wJEu<jyk9zu%4E;!{v>~JZwd=p#2rb>-|8}eU?Pj{yq`cP@kUpfcvPTj(G=^Rq
z37*&^+x1~PmQw?P?;`EFk(F^n%;>dJ($Y2Rl|AX*<0yEWB50oW*dY9@m}mtIT>%r;
zfT{kG#BL$kZlU%HHN!4B$uWt?ivyBic(7VqP`o%Dni<b!6^>@6xNB7uFP=wQ${Y!J
z$c!a;H{ug@H^Bo07Ft1&?W*o}U{!Nc#Yem0^vru#v<v)=h(BH;`i+p@>vn%}VEqkV
zZP%8XCeGB){HZ@h@V6G(9v`*?%cs1@2ifB*JHC~Dd`n><g?l%j7@gv{qP5<E%_lk5
zkA@5JSP938OUH{Fpi`(;`cT0WeW(t28b_))^#~!eq>As|PF09TA!+Vj)bd|Q5nle<
z{|FEWp$nYhZ8N905(^hMxn?ZRoFG1xAa382Lfw;cs?kOgUrDLhrp#ldbj`Su4sGJF
z0%SS99t?jU0nb-%)4yv~OjBkl6jwQpHo3o>L~^XDuu@8QTtc)`Dz$4wcqrjuc#>LM
zWPIf<v`HG;1h`Uq9NjPW-NnXJNlc{F<E81qd)qoeky8Ju-Kho01>18|E1t>SsSW~K
z_F3f;5M6gxw-W)|B&5dVcBVPBdAV?V{Iv9_i;Y+n&3m(y<oq*_#>DnPNUv4l9Qtq0
znVKCl1MGN1c@lCVODG~hD018y-_&v9F80RcBlYZ%okQ@~bjZS75cTYYK2zg1>JBE$
z)#;re>^2I8qlmY@?H=j8z<{}{@AS@UzLlO2!=gL!09#TY&mZ$J^0X@Y1mwgsALh((
z^z!z=Y1JA7ZjB7LMp)_=f_F>DyJ?@vD4oeDEPaZ@7Z5FdlEUdoy=~E;o6n1Iv0nN_
zhSTB44MgJYl;B@dAI*t`yG)`UO5z4W@OBDIW^wprq9rpaoG4+5D&2fegv-k%Gcueg
zKdw9yZ#?4WVkCcL91Jg2YfFlEVMI5a9L^5C8akKT&mBT!p8EW0Laq_ggqwo6-<I=E
z1m<t1-|fR$Ox0Qizwef_@z6QR^&@47?-p~_TEI7KlU1Dj5p~I0fYQONcq##B-P-RG
zCgFZtDWlVFCMohqhc^ypCya(#N&U94Lh?uL_kMU5-NA6VI)(LCvvdFO{BsBMO{QLD
z<tNSj9Y0pLzqa=-Y~x>vtHiYS%N*A9R;Sp;Y=(kop=&>%^;c)4zM4>t*{pT_%h)f$
z{PcJ&!OaQ3tU_^kOXE;ekof{4mSI!b`1Ss?8WZJ3_@b5GX|<Ka(W~}OLZ&CUsg=`=
zZyL6)UBh<2$J17@$FYbP6Rly~^|a=faE~W~7gL_#)Ib=>_ISD_Y%*!oKQ>DEMf{<i
z=0p4I+ZVEI1X-%ETr}I_IizOE6S!aB-qLSYcknJc?Xa}C_Vv=Oo!@;PARKb3Mqhr)
z;c{=3*lB)wfM<d6=d!%qb(0rh!O=K>a1oPbsC@SGW=cQh1Gr6~WJZm;#`Jt|++RJ-
z!v?*>B8F+n?7uF+>3OE*m4;Rev!ra+?HOM)f<JjVw~Bf?w{AATVB#nB4_~CVn9zPa
zYJRy}IUFa@c!;H{XqEd`XQKUPQ(B;LPOoF0zGEI26dP=J<Ba|089T*A4ADgl=Z-%m
z+=^(&pA8SXcJ|N#-Ejn6IAy_uh~Y@8GYj%F3%$X4qt$<Df{?`4wj*6HDqLjdX;<Ox
z7K2BxWaeX6<unub&W&Xhf=o^oPx_9DMb@sBxdtdE?U9yz=A>Ia3o;#~eIuiAxA&NM
z-t{6tw$G<lWR26N=(BpMYXBW#B;hGjWTPNxqwqh`RsmhZ$xy?&->UQ|^dV(f$AyZ}
zL&{>6G#?Q^G$RMc8Rv(<&8iHoFo_hJS7NFNb6Ka=QTl#9=BL6wk5ee#`||R;>-?SI
z;i|Tu3PlC3B%_OYvPbbQNs}@jDBy2*^*5-;4@oQc>9;9Zg*e_e<$l3FE#k7=<jLlD
zuZs<Z;B6+<*ZWIY(u_Fm1xu|BjoG`)A|?3yV@t|pg-`zGS|Tl&)88Wf4UeYPn}$GF
zmje6`C8V~WD<b{1kEVZ^BmKptR+><+e8q4qLwp<nw}>D8O{nGT__xGojidon_XN-j
zpyA|LO8E+c2h~G4m<a}ZJQ38rBr6WQrFag|IR~hp3pk*8^1=I0*8v<t{@iMs$W+3R
z@c>MI0B&7<U8#!w&@y{oY`JxjnDSMDvF{i1MAR$r16qMv@ghy_B2DE&Qp#op30*--
z><*Fb4r#9lFzf<y+CkYT8~@Vj24L0-Nq2rgHUDjWZ8$sNwO0}HRoID)XOTpX%K0o-
z7rZp#8JwqY{YJL`cE;iDS(nBQ`!YRjk1p%kkKR8V2YDuxZxVg=J&FWc0k(_!pKnY^
zos50Vrtp@2_JM6|;t{Lk))?{v>3&#PXA^kR&WZ)YiZAwof59-;-0{l911qYHcKyjf
zzOqYAvr9&^%cQCcpw$NW-9e%A1~~ViaO4Eic`}xKU_X2!x!%tA_+5jIeVJK}BsTeP
zR5RaWp4UBtsf0^-!myF=@v@(m=L7#5lS*#eOMadjflD*qQ<=D5Fg{y_LK_7EoBtba
z6@Jtp0X4|Iq;s>lb2GC;7rjFlr9-Sy=-+ur4N`r2sL<+gPw>=7>u^u=pOg>x3jVH{
z{)4uf%eZIL2a`FRlDuDMA^U({%YnFa0lrhP@*y(uuL9L{;AqVys^*f{=Ca4@V$uF{
zAfEN_rKyPS#SQ92g*}qhA;;id`zFO>YWR}4XWMzm@geo^PcvjYh$I(giFxz8tE)_x
zsku*^>TacZN-%tAXD^W4%=tRKY8ru<^YQaO7xz65n-yz58*3s=zo#*GR}phx$mvsf
zJQbj2U$H(wlyW~2<|^4?+b<0x#3WdXYK4Vylc(v*jBN%iMP^D2VgB_mrrMl%r1EEu
zmC{IM)*nZ{i%7l`BZgn(`j+9u?1<qrM?r;)*8%0n6N#Al3p$a`l}g#qPcKT24<k#@
z2wvJ`G;wKfRn`a)%}Chj#w*<CZ8DE)k4Z2?;HHvRrrxjoPpn&+GTq%!-rZ<p??wL1
zKBJnv>;cRKmQZaftcD)m#818cDdSG+_J`tk9Au;Y<?66bfA*(K&ZGH<xQo*Qk4yit
zTpj-(I@^o}-o-AyU-jsg2Xviz%3ptATU>2pb<|8bwJXX8L(Y>1Ye)Mo0__FM$7=$A
zUcP{+uCqE<a^)vcj~XHoi&6E|BT@B;VpeD7?*!)%{KdYu>w+BXL);z#I&za9S?j!)
zyU8t;yJ_vHhI#*%U<Wl!cNFVp)nkU8$7DN?_X!2Y{y#<Ta~)_Ck4r+aX>Zgpst&#r
z-Q)Wu)XM~q?3W-|$4Xy%31hvkW4$5?3-Smykem^VBKQfxc0&$fwrVSBq;d9>Xvt+l
z`Fp$lY(92snWlG#oVeSyxY`kqotT$tFyzHuo)Qx;zuxowDfWcD9&sF{*;SLbrPq4-
z(AV%NcU-=N`RT9R$W5k-_$|Gzt?#9qBtn%$9UMu1x>NN;7p}z9@0vM7$EwE35%*8N
zW^{&MyxwRGI0DF3%)kHB7{FX=dxU&>l=tN_@l>R9Ye4t1_|P=ew(DZ-r~RU|P2U%)
zzAr-mBDC*I_3Cu!>NH$*h$h*-L3Ai4*<QV`Ta9uGU3CVkJ!_Mi_iHLR#(5pIrkoNJ
z`0kZ|`8B1!-Chj{IkFUcLhx_5ZN_BDjD$XC+Luj)?K5*omwcNqR)Tk^oOej{|3$u`
zfrK@tgtfyYIohY0Ka%BWH8ZdAF(W=!#B=#rCd#?Y@C_jn*6MhNO8*JSI|S3rOyRqN
z4WQ43yQZaqrsZ9ggek*>u<RA-n>}5LD=(FI@A3Jh#>r`GaePk*qw488<7er--btq7
zx`1rAjN@l94;NrD*VVok`o623>GhiKqu*E3iC0-Prcr%Cqnh`M@WZw%n-cbjVNssr
z9pJhcBud;l)Jr_<C->~c2$W&bl|szriQor9D2f5IF+Q_r>)|`E;%3$4smtRuW*9?1
zA3b7oWn*N78XD&7>BXz5dayCBN(l>(78SX$F?LA_Q!FtrzvpD`yW#w1@yC1b#UJF|
zo#5wJe?oYcF#a$E#uW2=GB&EIl_Yf-0^=74inmO(mfQ0m7B+K+4-|{_`a#X(2!pI@
znTc~U0?;`>^N>Ie6u-<LOYxCj*|^@>Ys0(eSTw~Ln)JTE6o;H*wE5l-EWKY@mbxt1
zXW(PoZD?sKpJb9;xZ4|9+)@)@;Ilg1;z}%eXLbLEdXsL<FtG#rzky8VqM(4?quw;a
zka1_1#M@^(v|;5^=U2irZ#M~#&QH|KR4!sq1X`L>{X5N`liOHw1^JK<w1m9Myveq^
z4<(oPhXfabf#K_8*MILrRl8eqURdhstQau>d>9X&SgK~CO9lCNg--~Vlvk2S;!H--
zK$(>zB^5PG4W3FA8c4O0q`i{FxZ6wOV_R7f_0G=RM0lfFKW#(PR?kHEbRy{~83!wo
zoIYu+dq-f{2Xhl{4~vME=37Eo%{)_+62S$dKjcbcq2iRTTyUj0>P6}hb4n|^6=i(L
zUFI4~ItF7#8IyxRrMT0k<B+T>?E2rgtNevkY^>O~6ND`I_wD7Eo^_fQT|KO_YD9nd
zQh)fZH2Qo=o=8a^O&hgDE4wGlj0hTZltTvVh?wMSMU}yS_?dNtTQX;$KU}Zl)gwvk
z|E0hEMG>E26gFx)$o`^?!Tvb2gifrDpyYURUe)vdD6E<ts)U*mc%NtTtNz>JC`le;
zdo>YzwK8<n^Y;GmE+7+g9P3+I$t80;^RN$}|KTIar6+c%v^4t4pdW5_sQ)EQnjW*v
z)J=3$Gbl|@AtR0JNaDRTTGy_~U;E`v2}wtmv=Lp4q7U4XY`!KX+)~T^4n>l=T=r@z
z@vJw`@8{B6R;v-GjXbqi<4Iwi$|6kgWUxj*l4OhMcd)Tjdqv(-of_v@#-GQApep|E
zt6U-hek#ob(2w?K7EkYR(gpZED54sqkPe>CVzahSf!Xv^NOu!XGL2)GA&PT*jv}vi
zOH#j*;;Dk{5c~%D0h#Vt;!TlrE;J^{qDtzUi{rDF2dfcN1=dS-#oH*@o;wp$(??*L
z>WAxy*`A48)LMxWxEXz)IeqWB|A~Hc3GyyNaxUu|KER!pq)i{-ehZ^-#i3bkjhst#
z=2u1i#{HI!h2gu>)6=qsESC|TGY6B|)_;9r+s3!W6*m$EZg3e-ziIU-;<tP^IS6Z^
zC|B|DH+T8;Z0eu_aqa#}^Q^}RjYWf}MXf<a1E8Yezc^OW@M;P}HHA4AyI=c5^~2%a
zKtIb;Smh*krmwD<W~b7l%AlCEK>wOHUtMwTyCh9^i6q$qU)L3dVw=xz*4V-pT{Z;N
zXK7I%dBlX9qhgkN=$WN5@4Qv`CZKK}P5=p{fO@BFzGUov`cW5aFHh6&U#xp*$lg}j
zZqXNX?x1k2EJ6-jwpS#%re`0op5eduhrT~oz2i(BW&Mk%>iH3+_@sOe(*{R8!Xvg*
z0OYtflbZ^QwXP`kz^Rv;Z-g{W@>z6!5ql)JVSRI`xzVMgXR<rGNh3%s`~Hmzt)iTG
zCky2fL8TO3(S$55!9js(<#nxk!Q(TR=SNYzW{JKR56iCcnvDl$UW&%_Osepi(Y{@q
z>iW6|q#3{uR))3hZG7_zkVj=$(Y8Ns&lEHp3L>PF!OFs~dobdgK8rbpmW_XUsF~%v
zJ5|AMi#aJIb6P~(s@pDJToiL!q}$ycepCysXF*453$3I<N0S|X%cmHN(BLbQ+?gZs
zb^&;ElDEVX&4ta)Zz<nsiKUne3qGRnIK>lhBRWngh_*|EkGhW<zEYB2k?n#%`A!@E
zPQZ0<1>zRY_V!=hji+0MU$+Bh{f_{@ycCdKn_VY7xC>&`DQxK+cfKjs`H#}P1C?6Z
zHQ+(qAVoS(#j6`Mh6fqLiGUzQK~M)67fcC%L9`RhhF63Kens5-M-(7kB2EVq&b%Pn
zTOHSMggcL7<jiB_L`Blxilp5&fZw~tc}Edm#SdbcpWouvzM|9!S|-%BPbdHbj!a1|
z`0A<3yhDuTf*HYdkpg%j5LqxS6%ptODQ5`bCg>@ysIw!CazRCVL4|QAn*^^5#-SfM
z{D`ETh@`dc4!hnRb|RD+jslQ|3pg%C#CZETpiuy6+!Ovx!Ek|eRG83G7a8tlk2t90
z=4LAXo(`M^z{wv@yT=2%6G2OR7i13L+zR&!`k)PO<Oh9@pk+pdeL``Xpg5UPoNFdJ
zO)P*wb3owd2nDflg)MbB*)2|bMR+Jbh{Q^ImGDdi3W<oNL#d~tJ~H5VmE?MW%hkhC
zeclOT%Npk2KR#gv?*f;3=<#Tx1s>_0c$)tM00960G?@!Llkflkm-8WKQo@`WIg|4o
z=CrY7LY9z_Ly}XGIVR`h%<&^j8978s<g`?iIfM{}q*+cK*c2PXfBOFZkH_<MUC;OK
z``UKj*LC09<8jkoRm-vh>yz{S7UkJD3zasVd1xxfP@)^LCl!<OC;IHPH=S8%D&~ui
zglMaP#Yg&^ANXl^#|x74r~B-5H$Sk@0!3&i*-<$F@Vhx)2~Me%lda-WISahTX*(%-
zLUEP@v|sE}*~9@38DL{!el!u7l9q#NvIUnE=8F*rDu@Fh@)8?0e2`e3moGvb2qG_?
zq#GuqDuGl=1_}kBQY7dx={+KPe&i*6DkTTiV*y^U23yKvWeS|^6a0P7v@KOdru;Ti
zzBy)O`KMBZac4Bs9_0(5WLD6u?HE@Ai3H_fl1Mqt+7k5;ibBhQp@LY9qbdKaHU(Ni
zQ&2jp$#y6mVXUMD>X{Pwv(UzIzH*u$9Hk?IJ(J;dHq*(OP{&1bp}i>6ct@xUB)OE)
zL@iNSKuWzmDi}biub^E(sn=#}{WB%7s~|R57+ag+Btoc*y;~d;`0j3T(4D6`xtwZ~
z1Rwv3uRi|9ELdp(s*3~s<yfMqgwE!g1TBgKd>Mef!Gf($8WZfh7LzqFU}@rpN^?VT
zsDU9W;I~eca(h$&fKpyTbF}N>)$=3i>Ql-cQMEGQNd>Tj5LPi`jAZbt>!b)4mpSH3
zdd^1iNFZF3r+hv}xE4ZsPI=#=@#deE)2>^h+Mx_?8wR%}gF7thq{O_41a)<j+sqi1
zVwdie@!^|D!lSoF8K`prs*wa;GQCHQIRTM+RHGbJo&|Wo`k=<@pvK~$22#~8E5IjN
z0?6f^?1-O;=cI&Uj~Dlc?bX~?iLhh*vOm4&NdOxF_B?aro8K<*N$6~MO6+;Q1H1cR
zLwvDyPsc<)t;FUh+_L+)l4)nYvc?SM5q68f3`2UqGJj-+Qw!TtK6ZNqGG0(VHZ!uK
zyG2i-ql)M*S#*~ax{FuzT2%oTUuTyou5sAK^KzB&$M2w5>(2m%np_rm3wiIwg4^lL
zC6{cAPb$<DB#M_2#Z}3??9_XM#B{z?=9X$(d_ke6C{cV@);pCb&MxC!Q>Yn1jI)5)
z;_c<V2}E&ja<(HmTa4PzLMMrmGsl^`PZPy;k7{3YvV$NU4In${Q5E@PodStY8D~B)
z^G(^hB!ihUrn?eLdB_e$*>wBIXB=#_y&JOW2#w_<TX!ERmEH0`Hc}e2JS@58#XLsM
z$&pg+E&mj{P7!@Fi$0k`pR8Io+sjQ#Yobpgx9U8$>h3K&?FHc_3pE8S@SgJCzYBKK
zn8(p+i?1xy6epJcM|4*qtFckV7WM`0@mBK!PsVp3YP5vFdoO{=Z@10cgfm-?%is|r
z-fI~<$!U%#oDv?L*&<4CuOPUCNR4b1*9DJP+?l-`{6E-3=}li<cbP#=Z>WYd^Xhqm
zyZqme$EMsv)*Ge%;>Qc>Tc)Snb^m@$*$pn*m9UA=eSm+brp_F03DHmwi3;*~i}TM_
zQ4e9jhLP6zvj93W7xe_PARwVbeIY?d+Tz`0yhG%?>k3*#h%>RoR@TeP1uc`r8EtAb
z3*Fe9JSIcE#!_JZsL*_=V23%Ej8nOcQ?>^=76&<*s9r0)muXk4ml-pdt-oEBEh`cD
zBg5z4FwJI$R{&wECjBMm1T!VTFEMUrU6dwN)Kyj#iDU0WE+1|69Y;)*JgjGYNMA?#
z%cqPtp%?O@isoIiRr8-R@}Z$^(nSC<K+eCjD!`)I$I|~xAXw=|A+uIt`s!ZURBaTv
zv)ajRuCiL$fIJv{X>%~Q;oVilr3=lWLY?h4-)B!0hFpqj4*ljiCl?W#9o8J$?>Wb_
z946M;E*250wleEh9CFFO*-QXS>$x8?cD30ozthc?JiF!A9QxLCuB6INxZ_H5=<|rs
z|3+Sfs?N06d(H(c&z>E95h^#+PG6qQUK`Pmubpr>HKZR~J8^47f2lv*3o`oR7jtu?
z=bT1FXg9N{44JcO4&8bGLaHppq>mvbH*?FP`Ir5meqa&%tlw+YywK2)*DtQ`qI8-L
zs<HGJ3Uz9W;y+?Xi7=WW5(n;=<(udxyjwkIdNrypn%T!P6a9bL%K2~~#q7i1t&S#E
zYQs7=RhLtuvnCo<#l6JduDcg)e2RmZoV({9t=cnGzu91a&wc;*C-1ks`^dh>yZUAg
z3F?@)`zzjuDeb0D6W{_(-b=}ULwtSqD~z5l;2v!3YW_(~i+B$2CQN5sz7s;wSdeIS
zxSspzdxyTSfz|Eg3&A$--(LB5s0nR${B(N})gc(zaU#%wx9t*F+g`gx!`N)mDA)nJ
z_Qy7D_e^Z<<bP##@4DA|(sJnV57&C@4PSu_U)3AE8m#;(TKV<QujdPIz(3Sir51$a
zr!S3P>+N59+c8DkR5t>nPJ=0--R5^r?>*{hHAmD*_J;noi_^a9DFd4Mbr2XsdfeP=
z%MTUp9a}i>#dzP-we$H$7GMV)2f0U|-S{irXcrLo-d*qKcV@&|0zd8LyXzHv-21S8
zDESP{_hg}^X+iT2c7NeSD|$TV$6~@|&Yei9dCm33gjdEffR^>-q|ue6-zff?D6szn
z_1j?1sFlbh6D;e)EhC>>;0@672KVwt?8vZ{ZoolRz=5=GqLWtQSU!D^$k+!gZ-gvw
z)M;t*hL+R!D(HJ7jQH1#_#!%I7M(MN&dHeCJ?bjxoFfd@*9=zkWzItSYrrz6{?^@U
z$!gemLFr3@b;aLzdkFF8&x8Z@m?da2ooy4sIR01m7^8qAAtM<m+$TUkW}ee0zzHyK
zN(SEQQ-eS_5-zfukMs%fE~dj5?L;@_S!hBVV7ap=W+|KG4CyM#Z{G%mv`vjjw}BK{
z;X|z?T6zU79psObZ2SI<TCJf5jPRhJ#}o^^e?~1#IVemz5PFsOP5uhqZkC$=iJG7K
z9Z2^$(AGILOrj4|&<8*x!;nh>2dx1I+Pa4qwGKb|C0x)pS1kknEi-3%Uq*L+&rs3*
zS6@vyUJm5-NpRFPFL~3$(&oQBptp5(gi+>`Fyfcssco)N1}qJGZK!c;Ome3CTHe<0
z@+IG$k?>bvbg?qqPApFoAGRi<Q+nmv{C{Ete`2+^o!GXW9Dia}e`0xlVwJ*>5|vt#
zNS$pb{cWdHdvz>(bqSx$AwRL~K8KE14@dq!(tjYk^9Z|^@JIKzow>;V>a_s#J677}
zvSrxK<upM$ck4*Jm1ZP%(f_xIZ~0#8SDl@e48|6Kj13`UO~~QQ-=f6k!o*Rcxj50>
zpb&e3=)^--{<!CLj@ju`i*gt>76}sqbny&EHh}CMNcOG~ErpGjWDkpXy+pn4|IX{|
ziPy>=2HEV3jwM$iA|KRQ+uecPuBm$|Z>DHG;gTS=R?78-9UXD_iaSr5`)+#Nb4dng
z{F)T%>oKb<OaoOF&=BUb6h&rmF;=AEIVbzand67>73;^~(w)ZR@YJEmSf}&@Tt@B4
zX@ASub84~YOyactolKk;7c(b)-_8Z~e*2{t7Gt7*w&(u#+~zHgFGeB-Pp?J2sS4NE
z5tfL^HGLF9KGj@!%{tfg>NK%MY_o-Zv*nBU%jb69DroQS;AHQ=A-9#4@#{1ETBwgL
zkmA+G1gVB#UGwabF%B*B#&T@*$khk3x<}@}e2snUxzbjc=vElpR#=bbc$^Q*6ebM8
z&yju+^!M_saCSEQ4}){TjOMSY4WGxyWdB4S8y^c=U6K4#F<wxOog5$2{u9ZvYb3JU
z!L!@JvfJ^Scm9A>f4cNR*xr*L9Q_^p)0uo<x984_?Y4it^JCz|_EyF|3b4H;u@{@(
z%dhA6b47o9D`&r_FJXajaR1H0{l0_ydn~v4B74Ud!Q<_Q@t-&52QoGH?ssP=G20(!
zD8mWj4L4j4rRx)c7W;AV{W!Z`4L!g0uOaJSb^mU#|J{JEi;Mo{P1$8{IW5Kd{^jZ3
z2i+fd=X1RTzpS#qy77mT?EnJU1nO-9B{w;k|K1NDBp>$mB?|T>Y9${&PC8sYw!u@)
zBFVFI{tCa?+c4TAgR5CjV3%6X?{XU*if;1YuqdzUKOx3;<-1e6Uv>0`Fm==3Z|)5q
zRwBJ6G^Z4!t2MrO-8kgLI-CO<Lif;RqxhP-=bDtLZAI<-@q;@y%B5H8_n!4m#h)te
zx-0{-Q<b}%y=8;{`7SKt$sW&ogyKhJN5|-w=<|U!7k}VWLcX{+z4)yLGKkx6jg=)Q
z*!(%>?y0eU@3&g>GV89|4b<J$mehy2e)tB-PA2O{2;tdQdG{Cc?w<=A-xN0D^BDYj
zj2k9Y6Jx502?DJ-xltlNGhP@H6it>ej(8tIu81O6tk^>XiFuy7Ql0PeJVlO#4l$yp
zN00@^3ZISVF)I@)rwKLvCRxDSuKBL~OsHM+Bl(%nh0jps&6n~RnR$$IH@gFCyMs1K
zx{EQjZpGe%`G$-jW2&+VweBX_X|nM2&_Al=zgJ6{L_ka;?n-saN_KwxL4@BV*Zv~H
zqsU4oh$_uV_;BH+RpOI2;|N}<PJg2a2jht0$Qn~UKf4>{dGo$@H@J_4fs>>=7*R`C
z?AZecn3WVgTZ-;rNG)xVPrNIiIG4xB&11aJyRbO?r{kOb>%(JqJr)&`;e1=9uwc7+
zfmC@7B-hJsK_ilHn*49&)ePQ3d5r)=#HRNfA#p!DPb~p_!|VP)ski-8#%a7u%zQ9T
z%XWRL2#T=_hV~p9D1@8C)HB8Hhq%#C6`MV@L!nA-3NA?X!PFAJXJ-Z#)Cb95^jYbS
zrdP<mI6k<}y#^VEWA!?lxr@rXaq>Cb;C)z;NiPDyJ?jh#*LH<@o^;6MJyI+Jp{08f
z{kdI17l|%+fGXn8l|Mm5h{Gb>k&2zXik-t~vIc1IvKOeHjjt0k?_YxMeu<e^gbiK}
z01ZBrJc3k=h7~`MEk&Q{!uWkdplvYdGk6^NMgjT8C3Lqly1Nr|LAYc-v>4qK2%T<2
zqQ%q)gFVo$Nc2ZFMGJ7FilWDR1iIJ(>gEi4R)Hf+;|9%OMR92T%=EOTK{I4g+{L1}
zRHYqSaD--HM9Y)G-p7NzRz)#*#168;4+4LNb1l057<$&B=sKe4`d|eC;xMi7Up@3J
zvmHN@TeyF;3}mL>nqTspF*|qbclfhxY31&){7B%%2yEzJeBfaG{E{^_x@&AbJmP_Z
z(S$0LAES`22;~Ps`Hx1X%`cI);wmMXouJt{{^tXO^^!-d6{Dv(e|4WMMOSuV$YccC
z1%s}{;}pd0(ZeMQ;xKf!1JqB_`?04RXfU^ge6CTk^8<RmM6na6*x8F<AxCB-&~s-L
zJ3BGt6F7wq4;WPienbqe=4{&%0&Q1{HuZ#2GZ5&34h)&yfjV14wsD|Ffa>4RfLdH(
z)M^Df^UH!U3Rp!b7z72kV5ZX2m?O$@3cyk{>LG@#>i|voZhu4zrY7MpIy)RR*us2G
zLy>L+8r--9<4ICrzYgVjpuqkTGj*aw^eGH_5-D8b=I~}5tu>6+3WAoo!;(;CDvDPE
zK-^0RVI>%}%mc=w3O_<AM3|G$qbLPgl+pyXtcF^8!{1mI-MmzEb4tN8Q0`9UO@|_`
zDFwMF71j@wgi4fz5Jee&aMA<C5aBDq!mlf=x!`h+a30V<V$IH-X<L%6EBGDG6Q1v4
z|HtqiDz5U45A@0$`b{A8%I|Pry0KXMok}?sXki-+!KMiEg(9qB2*QtW-)h+%Lz@xl
zIxc2so$o^U8J?wTcf_4Mf~Co=n#Z?lR7?;T3=vZ^g}#gS+H-}ztM=NrtVPkjCG!0r
z3Q0lHHHOBB`G}gAQ8h1D>?N7Efvo@XM6cOp@g520{699&-Ar=N?36KcT=HGNA|d`R
zJ;*adx;DHu3tWO>bAZj3V5}WHWxh8YycLelcA;)_+}^Aay@ODFQiZW{f_YS7&{dd-
zD#1O3#;<~S&<_Cnj)<wn>wBvJcJaobvWQnY-xK_Y_6KV%4r5+veNPA-+P^-u{|2)c
z4+rtpV%p)L+*-_u+Q-$<pka(oAgsKt0>J?XT`fo0Rv?r<i~4xmmLcBh;g0`@_@6ZC
z{KFs>zE3(Uz9f6y!z@*O81m_vFW05%+gz9UtwGna5&Slw0mvsqZDY_izAM9zl)q1|
zLu3Ec^n8cLu0dnNxOmCK*|OJTBe^bBr9b`NFWBB=l=|d>UOkh7CMfe<!Bqp{s!x@~
zQkBF|`t@8D7uxjeGb%2KR%ApVK1|dI2O~gFDlS;TRXr*$peruGrWN>+&y<QC;i|1l
z#i{>9?H|e^!UD_{HH0i0YJ&P#L;bzsa+XE*mx}DC6cB-OZjo~8@P-FUt`iMVv8kFY
z98|0xTFhKh)rujA{;3+C5QI(Oku*&F<MwkAfnT(Mx(58``XK`o*Z%kCT)+NzKiCJV
zKZgzugzDoz3!yJOzj3SKk;2DGRcJJ(rb`hT4T45*1Sm^OP~V@6-U_HQ{`&KRxPi&X
z_y66O7%Du%3k2O)wGv-KARwh^2~SvX1_JT617n@6;M}g@tO6A+MaO(tvi86!NT_Er
zFZ>UI&^CW)Tbsh{(R~kzK?gp^SVw{~nb-a78AWYa(McRMrw+Qlqug~eMEH?@<`uYa
zs**OoVu}qOJX<kk4G(^%6n#%gUmYG?t@MI<^y*VJB{-;hJyhLEM8?}85HUPeb0P%s
zKWU%%$8E^*us4yGc-iJBVHqJ?eBq(t5YM@tw3qxbh=J`I{yT{Du#7L*w=)fSAAb-Y
zs<Z})DW0&&d|{ng{E%?RfItMh%?l1x7!X=f5J|Ng8CTz*CK>v}Ds>b`%O5Vdt|gpL
z#fMjJUH&92uA1&`Fj}6>Z0KQg!UFAtxpu-Mb&Z0EO_b`T9`j61B;(h>uh(T=fsS9=
zBwWOE>qAbtxJ$UqoRV*`yxem3t^VVX`vDsXDRrN_1)1X8nx_93^N&jXKMip4+y^a}
zHg2U@z0^yXxic!qX#Q(ejKb6l3{7<u*XIwt>@y$xyop)UP;-oLR0~eR>)AJI@{N~r
zlxXtRX!2ERI=)K&F;|$t>fZL^4Bx!r2@MO@6#=g#j%sAu8NT9w^p0{Z2(72gpVFVY
z?+p2!Bat=wxH|0G6qjd^U-typ<sia+=i3ynry<v(Y;&E9-vzniv>PTqA#kl1aIG_^
zWcS`Z)D6CV%Qm-DH~5V4qjv$<rmV{+m?(V4OtqYiwmgf=Jd5N0Z^F84f-r-r^?|v}
zVQK?mE?0)0CZk#_khOXcmkQiROh6z^cNh~efe9F_1?&a9!35NT-haaUpA`SY#SxlX
zavc^K3X438>(s(^wt&?8FelnU>f@LbL!!<u$cwdY)-K4}kC>7`n8PrpWCBwHs#UOZ
zIg7&u!5o;a){&_BAJIsz=IP-avx$8?0TXaVQqJRwPd2nsr5f5eT#<7PZMLq+?CK%=
zkB4pTX{w>)#b<+}aeQ49?;>!yQ8+mDJo{RQ5Ty9*@_8Jefa`2VHSBcc;|aIHBc|2V
zHaR@S$<HR-N{ib)-Db0%O-y$*nF5+keY&ZDE-Ii@Y-eTj<DEWLwO{9pZ!yoRRKvt5
z0(buc?!LQQLA;5x+ibZ%PO7x{*2AVY-C<aq|3AXy_}gx1Dv@S?WWL-s6`JvKB)r(U
zpYa3mFzTtzTGGR)#Y{t2gz@~gr0H5lRg`0+vebv7yb@(8oU&AJrlHJNXGcP`o-)ap
zYVB#KEj06?GGnh}g8UU$lxPAc%%xqf9PNzKjvmGFE*X_-Sg&|?U98Dh6-ZGPm~Al4
zXn1LX@Vd~ymrctui-}9&ii+imj#YWmWt!S$>bFKMnEEbTm)*r85E~MBlU<sp*Z>nt
zEEamnC17N>DQ7C$a8+dz3OZu&$K6HOK@DR3dF3yh(IoKWqSd>`^leLlyP5)Xc+(ub
z=}3IRUL@^~+4aAc_nk{dgNkvwLld9TxaSz$^BGRrz0rpP>({p}?{^BUpV@sd8UXy0
zq4QnHe@K2|{A_(#%j<DWdVBtA^)GqTws`B~p+Jh%ESRUkG`Nwf(m+)a2<?59t~v8)
zdc2*tYeMl!bCjif*Tv?j!saMSTD$eD?31&%wA0%!#{|yV91ra-gUk(J&g6qUq_>86
z_z6G}|L@wD-K3YEQOi`+^64eT&5JPix#H$kn7f7=RpW7^t6NvK>X(TIn85|ye>j*y
zJ<On`NoMcH!=@<aTpDPoeX;gf3n(cr&`~64jz(%HgjexW6N(EKT7*gas<N%#isWu@
zoJq#SmlHUXtO=>FNcW<z$Q6mTj%l%<$t8bi8>dzVOa9pZtgvzooRG%|B<f?QYwUPN
z4+O~_)15N;*W=3M=cG-a{gSn9H@lI4y+5d!Jr1|kHiTSn8%pWbjY9gXha>%8gJY2X
zPcW0J4iA>%F-!3@J`RnN)BNx#S!3AO{we2OjU2nRZb2#BhVQoXF8kiYfcX8f@Mv@Q
zm6u&N^Um`I+B2ohc;Mqbiln>v!${A|BZdPne9YN<uz-azRxjxa?ac&<7;}yVC&0!E
zXOB6{1`yEmieusHu`q7FQ!$BrJ?5+%nn^nb$pYv5IJp*CSK04q5c)U+7g<lz0LM^C
zz|CYXln-DtS%PN4*(0Xsx5%o$nS31e0016m1KS@1DkKR|7gjiwk$l3v%Q9a=_(@)o
z1*`g;^q#RNi#`fq!z7vy9Q9OwK|(@@^16cNqXfPv2)r)rbe<r>Mq#_-U(MS};zm-~
z+)OQ1sut^Lf^1*~08Nk&mBG4jLPBR#R)QwT0k#GJeOZ7FNdjVh>36c+8`yqbq*Nm*
z)lIbX)wJ{G{UU`iz5t3f-1LJ`B7pfxOe@S(<{@P&QLbdsv@B6&bukKhSNqe0`qNuU
zZ&OKc8KS_vzI09iusK=acHf*Ogaho!3LNcA=UsdYU(8oq%;#OqkIQ;{H9w!XA2^d`
zKAL5&A(}YvL=mz_Spz6S6*Mlp9y2{ZlDr;8$Ptw)1Ae1WRg<C2O@c~?8y=H~3OY>?
zippZpGF4<dl!7qulm)6r2|OXR0pKgA*~3u^B0x|^zFuZNf?&r@dW6m#uryHu!$g4n
z|7u1?zAfnyYexPw!OnyvRV^z5e3F?TKzhVZ`JhD6&Z3>PMCG`@yIOs!l%n00lmATz
zY>T02C-|ezumDd3P)!`*>0^fm%qhF7zu9^m)dT=fvw_bY11cxwZzT;_>T-b3u>uGB
z2DlfO7)kkdi%YCY`7?b3CW``A%#-283LNVj;9XpTFN%n6a<kCbHh!hXc=fThN`oz1
z(w!FnZgTsYp;E@wWO>h7lSNnyoTiA%#$*9Yh%MMz9!n%D^N>a0<RVcjl!ad7M?OEG
z%uO!Rqe62~XbbS50Nu|TYy_bD<)WTJ7PuvJsDl!8KU=Ve4EDMl_F;jO5V0=COxg4;
z*yc~AOVpUry|_`(!<9<XOyoHmk_&5w(?>#`F-ZUdQ3AV)V222GJR}!5X;PFDltOFs
zBZZIWWjaj~>a>q)J#*4zA?*)<G^tNn%Zs@dNF>ySkS5D%QI@DKC@M`33=zZ@I+{w)
zYEw>C(2gq|)!*z;O2Sy?tko)kCxsH(n9J(uxttQ%MGzY#jKyV)2@|gU|A&7bcb@8G
zbE-Wj`1qH6_3=N;f|UZG+Bv{;|9klNS%P+*1AGa94P{BRI+kb!NPOcWSw)MtQaMO<
zV{kL6rimnEjaiZ+Su(~x5LOIHmmkQAU>{|UT_HuXQH+!*%3>5{c8anYX>;>uQ3|c7
zf>z|nfLb!3=A_6%+B|?1sZZ(5qg@>@$Q=7fSka+$rqDc#Xr?x(DjD$DX(^Jt?-pV8
zW|g$m=+cL8rrO4pD+b1u`NS1Y8Ei}8*ll9B6?5ji<*{SL6<+cdoa_W5J8_epjL1~&
z(K<rFSlu6HVxF(K_%c&}HjZVRJtN){u+1*9$CBQATF>t%uiiF$PJD77zK?)Ef5ltn
zsb<tCdJyrR@3l#*-seHG8`qI4x6Z0NzIe`ErfIdD%~Ga0F(PiXEE`B15f56<E~Cr6
zMimaCT7B^swY-12ildrtwm#O#j*j*i`RIRS`whdw)_4T~T{st&30aV0E*nJ&y09(Y
zTE^Q~&by&NQ;b-uB%i*rRl-Ad(5K>ZQ1ur0DFM2UHU12Mu9J%@hb*u%NBK+8b!_pD
zGTs4liAdQ*q)ehQd#s$EAK58{?4(PrW2e^b7iij%hgl0WXNaXHWV7lkUb~QzZtZd!
zq$E9y1bj9>S2`_}*xi<lx@U#AlJPF|90_kE^Ei*VulnLsvgt=g6Wb~#qWl3{#T9he
zK##bd-?EziR`Cc5=YyZ{!^5<_70X(vdIOv-ZrtzPgWkKhE;ptwH!}3RbBXSpGTu)L
zTW%5KAP`$TQr`PL(Vdsv2q%Y#QuSHr5*rCz3f}U+)2CPWs`XLkZMO3QPbl3$WHw=j
zL(sc1vn86aX8}>dyZt`^00960G<OL&l;8XQSj&=~i3-`57-AB}4B15}lERQAsgxx~
zV@Mx6A=!78U9wcx8Hr5xUD`&|*ku^oj9%ma>ihp)*SXJg-_Lu_d7g8gce!3+bYIsL
zH`&*QyezUF6iL@JcQN2>9DJ0+i(hH^#(&JPi5E8=^i%`vihIv&d8h1Zv5Xgvj2Au_
z|9j53l$lt{<h>MbW*7eHCEm>*4J)tRvEo76Hn=^{*lKC4o*%70V7OPa&L+$|5Sllf
z=6!;O8%{|@Ri&c(h=roWLU^j59Z}~n<yf2KbIJ45(xJmgS`Pi_Fj(Lmd2(-U*+@rb
zBZ;M7=l0w&W8LrJ%pm?oua#r)?WDx87ajPKE@oaQGp~c0=dJhjT7hsWs>~+*sZIEW
zEM{KeVs6TADP$>Ed&_2UlL-d(8zt&!(rj263c`$=QP_qMJFkXN5DTU{%Wi>MJ0-cM
zu$Ji^qja^kqF%ATprwNrYxgPx9GS3H)O)$@t9r_kX52#gzQ1)C=6$q(sAW2QqUX+$
z+4GMV!^}EoJob~K6VS<PI0Iooudu3R0&DH1iYl#lM3mM~>}aOnU3_FM-x80to{dUG
zls*IeMm$wuot`Rgs#NY9=RTqxq6tdzy$P?&Z}4qN{!|srp$QkjmJ|_a3J4L~5Pa4W
zm#va2toRm;<9T{!pfl!kdOD%_Wad8}*VlW#q`K`!M*1J_-G?k;t%usp{iDn7^$x%H
zUHB&c&n2~a;&7NbWb=f??$hUzo8d)j0i@z)s{5)w`_2i4olMc4OoLU|lh1RF8D~X4
z6(0toVUI4Ee5q{Wu^iVI+#1|3SxwI>FVOh0SiD+ZHCnY;ZRP0Y7^-IMSW#JN)%r%o
z(Wb&GcqZ!WEA?^pRO!|>RmVd)>!Dlf?QZP}Q&qunTT8CE<%!ny_&<CWPk-p?J}i^#
zaUIS`^L&5d>5shQt)~7fXVQKLbpt_~lNi^eAUCLI{?yi$`5?*VHuX<>wSS)mZFgMp
zPBxgFe&U&LpfMTuTIG}8qw2cBV<8`0rIq<n&-JYl>3_|XP|SO{J%`m}${)9w0;f7D
zB!QuO1P^5E9w(}GFFNGm-=uFt_o_PUb@HQLwVXOdy;1(g!70j1N-SeZIcgTI#6Ze3
zkSG7IS7RVEu!SjDw903##}sPxs)Ye34q6?q^ZfI&OOegZTWR9@MZw0-&rZJ;Kf@cj
zBftNkg3yVhckMka_|t><mW;XVN}0x~4)M7coUnLQaH0dD?>;-tlIblO&lFJWb=r?;
zRa3Zq$c0p-^(Ue=0m8=jU&-ePw&JhI>}{N$R!ww&Bme2=K5&Q96J6F-9yh)krTZK*
zEj{6o{m>2+`96nq$N1u{^%rt|Vl>A19`D4Ml%9yR)_?xYXIO!!@w3d=8&PMRH9h&G
zR=sxkFj_m$>tcT8O1;zC*0{Oi(f>t4#*_b=_#<|$ZHr1{n`p(SR>&_Vlx0E0I3+fy
z{Ij4=%Wtef$<wN{<Y-jaO6;_j<gbGD*ah)q`gWq!D=qYk8+cq^F*fNUBUEGq-h0$v
z%8?Q3z}uXxfWjQ(|8v$gc`4AKcQMrA<+43ttHe|3Yh8rqj;6sJGUN2zAkSS)f0%W0
zbMkuD->jnnQd&LVdqg*XV~s=e{4A0;jx0XFpEMZMdD+8=-fRjp-sLJ`%FRS?3Kt$5
z9U99%p?O;W!c8Up>kbdGkEaDaH*ccLdA6b!2Jm+6(@+@${P5yBM_JDSTWi<V<8bXz
zZsj=}1)3Gs>n70qy-Tck6IU1M*~0Uyth)$Fs}<#?{mfz)x^Hvf-u`KM{lCU<q>cA4
zwrNw&XXdx;hKpCmekbsn3hlst6b-&+?&n@0_*xMNy(uJkI;m`gniEYb14-2X^>0aK
z)6}s}>KOjTTdlKK_1QWLEyZhI@p;XSbcj1uhp=zK0blgD#SM7r&{P(3siU^GW>Ys|
z@i(ioUz%m}ye0nnO|kqVQNR3R7EkFdw{S?B<_G<NxPEJJn~(ZFm;=M<_JL4!1N^tQ
z6VMKl`RBbQ7cUX;19p<1FA)YkC7sJ~`A(QXx5SdcjSBR9ch@Y&-~pyUQGF;Ou5SY;
zoJlJ7C2{bU;K!bnQy0c-sa>4C)J+f}Y_q}FLCk?%bdAcfMrD9kK?7f-iqm&k={vX%
znDiPCO9$-M3>2Kn!%F8k0<f|Xq$AK8kN1lr_N62CJIZi-pecI1-_a2+&=J1I#*}5<
z*M!iMCFse4OH;|L{}?Y|&H|VV(`~uwwybnp@_22b$q<mXnjKCqU?`4g?Nfq1x3z@!
zbtC9QIrJfL;!xy2W({~70p4kJSUepTNrx4XMT^B%nF*HxDA<bWFkC#^WCqF>fgbOG
zm44@%k9>z!#M+a%&=mb&3FHg(5{x2Hb)8w|&QvXI+y+h6O{S{WzN5zeL^8vV2)u{P
z5q#zdBbL4duFv6P&-On(+gFg=A9xNtW5roQ2yz#$w#xPP%DY}xf8gAFzzFsJ;&Es`
zX`Hh#!CJA#Rjdo<OU}%udl>=smO#7=&QyTV3Hk-&(IfF_kM7#T-L-UOoakfp5eUwa
zjbH^{6YZ$IJ>w)!cVq!7xqx5}AeaRRelYr#dTyQcmP}|M6L`AAcP;@ELIg2GAV&e0
z1g4=7iyrH$)m-<Dq{GwbQt@=DNV*jH<y#c{I!b#TmGw{Kx@u+Dmsz@MeaTacFW)Xl
z(t~UOJz;`+ELtaSzan;D8EhA>{=Foye@S>hE$%=sngg6d1VKX}S^@V240JM<G~DH<
zv3@L)ek6@<V+xc?<I-%ewkr41ZCpS3`HK?{7~wRI=P`*Jf;-PfFjcJiA=KgLGxPo^
zU5y3E-~wPA0E`8IA$|TFm?Hp;lbH!&W=gFQ1nDG}j{V7w{nE5arr1Arb0(Z;Cj45*
z$9;21uo3I(b?j&k&*&3Q^-@Xg`ySZgj;IAAHfV#C_Thb~^bRYI_+v=a9~zxD>GEGn
zYu35d&e-o!hno|eiBvlxRRC;?HO<np1Y=pklT^~l6w<F4gs{wzNCYCytboh*YJi|w
zfu-zF7g39gl5I^1R-puQQ-W!hzUpQMWeF7pV^MYUfhU)AUHeycKWfRY_p@|q`I58O
zU&5gt<ZSqQzcr#kx?oxkmnnnGl*T~|8|SWD1L`(_y263Zlv+P!fjAFYKa~?AhVU6M
z%?c5-LGTC<$;5hV#*u1bNoujA0Wig*!h~zWgxt6T{l^@kDl{Zvh^SI15Ismyp}<ji
zsJE+uo9t{u-ccg&947A!gDILk5rtj?@##Z6&xm_>_sRz=di!DECuC;l_RJ0$9MRc9
zo#>!?&FpZ`?BsMbD9=o@uiXJpG@*_>-AJCkvVP~>`W;-nw>f#5E!KOgtKs*-q^<^E
z@^p5{LnB11C4e*qkVXI!=`+xsMGwoNhgtvAD6(!!$WsVeS9|?<2)Lle`th6)K7|5f
zfgul}p^Dgfk*<Jvuqr9$F}hm|8j8t$0r4Xq7YHLB>LvxM5R7^f0$R{GCzFWCG%H9*
zofjeoWD^5aDa{<T@1HDvR}Te(i&lUO90gC{q#hW3C2g{ELwXy*@@3=J3TEw~0xKBp
zZA79$az{Z=SAmnqkm{RxNANI}PN>aXU%JHt{q%yvCHAS<ea*kO9<O1E2sC5^n}b3A
zD+C5PfRNG}Qp}py%AR-X-{6^Jbc35GPRJ8pt23HgC{U20gOnqPJnYi2qEu+d!9A7=
z9VYT<&{$b9EW((qbCL=vF>wdGOpWoOcqAgMrTI6E-2_shyoPRevanb%nZvTM@>J*z
z3I_)*Qh|0q3gIHn5B+yj@=p;zies7#C0An*tf}Vg(#gX_*@Jx*!^5DLe0S9oL70HJ
zS-ltoy-4KYqC|~@DfV`^rKrzEHDy7CK!(<YCHC_i(tuTGLq8p)m<^rm=h52ejKp}P
zVFbI|V%^<L@*3wNt1*H#7{ST5*x|O=!Z}kx%m{>H3a6F)s~)XH0%LFH<{%BbEdwh}
zfeI57*1=Gpc8t3>_v|$BQYs3oG4YHa{G#UMZnjwHR9C|PZj}UIa(8yf1EaPk%eMby
z+|CKWiot?CI4Iabu8H7I1@gg%V%yU9mwamIXULK~eCyf2m|M?sLM=<(F51C-F2Y`w
zX9|s<|96(>&nvrLwR+&AEN^vQnK0^)k|CfVj6Dg)-v3hl3#a`RXY8>u_7rHN+!&w7
zZH;GXeH`K#pQJWzS(sW%=C-jLXKE&wp_`d3?1?$<paw5eGd(C??6lJgw0drgGfwDJ
zH{J3ml;ZDpIdh}lWw0;a-))j=S-a+6A?3KvB!xJ1?<sA)P;rw6J2DYAWr3;`a+9om
z$Z$xWkKyFMV1fJUgeaiq%=M5alIL5c)-;c*6MNj7q)$Bgb^X&v{Hh}TO)byJN4)yn
z#v8wo?oESIAz9l!?%L<6Jr38$E6~5ve`%&?sqA{7Yfqkca~@Cc4a7g?SywUjYPYh_
zc2ZVJaE$N8Rf(i7INvaIj2m~9KkXG0z;~-JO8z1=!$SR3YRMauoTyjv*WFA-GE^$x
zI0%A5{gh+V|Cpag1$We|O4lou*AJL{X}r=Y$C}QIM_?gu9m)>Np@2!aQJ&0<#9TLN
zyzFq3l*ml|#epzcvRe|raA4ivr230$B5?~<QI&$bw~KET)(hni)?c*ANYCO;PrqGR
zJ>CT>l<5-uMz=3_x39{-{&u%-JsBQFhVK=~9I557O;tF=WGug>_wz&hc<-(So`90a
zf?VwKUJJV&L)N{^_j;?@ciS_=QP}zNx88caEU%!^9IqgazNIV9m(BAhewAP^$MDdc
zPpIDtA_X=5eJ$HU)x-Y?{t-Brjku=R<`zw}&aV-6liKJ%d#%Tph`EfWIESTsZ<!WM
zOkpk;ZdBum4ZC>EBxIwS<qFA=;><>D;LP(r;!prj!AuGu>x%Qek7y1_TrY^zdf*}}
zJ0#&z0Jr+9(JaW9cFg%B#cWAL6*_yV+9k!d&fn;_i0Y0oqPsV00rYO@cB`~m>S@^&
z#0&q_HqI`+(9Pu+oh{~d<EmD=&wxoO{8IL$H7N3Z2F{M<#98~!<@yY0j^#Yr889t{
z$5{IgW>30!T@A?gQJWFI_9c6gRjY>M=GEuKMzPDKZ@a7m9>4sKb<4A8%qYgvs~CYL
zZv&m43)j4AIeB;SwUUvqxQegb)$=+R*jcVdmsmt(6kkQgO`ge*Q{ex?6)tTYSIYN=
z%P%JG=J7Yb;S>{JMWLE}tHy^iBVQLye0$<1FUVchCz<#r$4yE$`q>^zX%dh!BuA1V
z&(`?XYJ=XSm9r_>AF`HtfJ^qhA!l!HEd#aaO*oViXuF_m_0qn_js=)y)l1Tg?lhGM
z;uZaU{@cj45z{*-eoTz`jE@{)`$c=m+dVw{=V;~cG&BBEtt5&r@)y6CQqnkR^EHwZ
z1F&t;d1m=05<wSz#w}mkE9RT!pH0$>(_W(Je_qoFVZQmp__zSJ=CikY;HMGP#Dd@p
zLBoS7!)p|K=P9G&)N`AI_lKWChf9Jl=vK6&*rVq2+v7CdNz=zOg62G&y){oQujrq8
zq@ADB=lQU+^@c@2Q2zzGXE{b~Z<4k4q%Sioi-5JpzwL-xgn)0{Lkq1Ml10>Wff4wG
z=|c-K!KU9@IQu;wP6TARUYgTzI(Mz$<4WbcMl0?3O()Hm>506LE2T}r!rxml%l7T=
z!EQQrk`p$y=0U%=%I{q_sLUmWIvlQuVJ(l*-m>G~avaX60GYrgey*jHX`#WU?fUsb
zi|0bDUh@1>PF4S}%%nx2;Qu?E%S@to495)s+qgiKj%^$-H635?a0ynmIcVWrshsJ!
zYv^3*qgJ(P53NkLNJh3*kD8yV+8pUq2@7$4m3-y$;_vs>qtMzbqzKAFRoV+bEB{k5
z@A8g^1^I8zQWjL7y{OGTz9+JQyWTZsn-sDeCuoZ@ATRdF794nng1g3~%n*Bj1Z~5Q
zuW!Z(+S<IW9wkYv^LFqcr6-6#_4B3?wm;sgMG)>Jt{i%K=j$@Rk)|NLBR#|f)zM}k
z+3~)It?SP^g!JvV(PH%}T9neSCt429<2?4A!f)yw;Ged*dTHz)n8<pB(UpQCHCy*S
z;s0j2@EQCpeKB7$_>KBvie|~P$6u#<Fzgz!w<^7o_Ma|Ck&PcXdzQbg)^t#l<a11j
zG43Y+vI|(huLP6i69wgdU5LfGBgVzd28YZeQ4*#9Nhq{bdbl|`3gtX-f?EeWer&4x
z=fb&8+;1!W$ktN%tEEb!VAL`F@w@MiN2WmcYGri7>)TD!js~x@Q0iHzRZSSrKo;Y7
z4&!$}@ZbaR05vC@!ia^;$!c#1D);xDyLJ<KPD|=Tzxm-gS?f8=c+4~R0+Sxc76C2W
z(f+io14-$@%AJ-H@4&vii9G#W)`3fc79b|O1%jcQkV*zI7a;aRWX+zHuB1mCiaJVH
zI)W8plah}}rm-O<9w+lbkXPBH{zN!MNAqGEIgvS!lf^pBb31yJW<1%~G=FYye7SO~
zNA`(k=nai%b574LqI)7~d!x<*dk3;!mqY*Zy#6BJSAS>ms=nSU>Z+cm&f>lq=?}Pf
z&$5K&d1G8}eac84%SiU@>*4C_VK^ftvy=JVk#1U2g`I7PMz6Ww@Qw9;Y@0js=MAKh
zW}$SJ?OGO!6+9O90W7Q5KkbPW%(mrqN7`!@W_7l)f|G>d8*%;E5_jat4Wy-Jp<I?N
zP4br&lQgcz5PWU93j#PiCASWOVBVx4yZxEvi=yvJnyXPQ=aJ?j+ewbF)6mV&B}KMp
zcy>j)vGMLmc}89H2d<CB@>+!@*|r{Ym)JLyas6d78x<`5Ww+-po!F2VPRX{N=r23H
zQ4z^-NMmSsV{_b*1G!(!C}Uk++u8<o21$zV%Hrbw_~3-UjR`U~A(SyVZIKUiT>Hj9
zmWXXJME)>A8lNmYnKHDN@<{EX&JBu|HcdPc8*PaE$j`7gL25x5)=Ai#Rz}G&?_7qx
zmm-mAJiFHR!`?X@VHqXJWy1Krc<;c5c!LQ{@BB_lLlZP#K6Jzx*S>J)KjdG6e(1%U
zI-zpBl0V;Gb<o~7YH0UL<`dxljk@*j><iC#$QPbx3P&`r<&9|m-4;J_o7Mk<o}%<@
z!ljRe{ln}pLm%9xyX3)6yXAqO-u{4Yc8Uv}Mc3*3&Hjn^;sJ~^p0Aq*vX=E(bomve
z=ck2JHtw_fOI|RHf1lA}_KBT>4Sa|TJtNlNlf<!617hM+B;&T{2W(xPJHENj9qD%}
z3kF`^`Eliqbbiiq{sfQK%jWOS?T6vD9@R5y7js}j`J*xgVy<$PzhzucKpzCT95BLC
z(@~pi$A{(BCS6C#&((dD8)wyh>Q<kL1!Oi}3A9WYQ1^+ujyHLpAz#^eO7N9eoVwci
zrvEWNA7}1YUKOraGp_qM$G<YYE04aNp5YbpA@fzxT~G1XcTY7;p2?_qo8)!-u4nd@
zZ&z-DuHT@%4od11`@S*f%bRCtqT(v5{>K<rr&RZ+%_JYk*E+=4ig<a+x4-I*YO1at
z2We({dP#NlrmAYyaJ?gomsh&FYSo&Wqk5+fv}$vpTLs^IMgE@p<!n%ju1&DgZx?K%
z)go#qJDjxsNz{z506hmX<Ey;}r)Q`@J^nFXY!U?ji5-8L1+5xUJNw?D`RLTz+m`6s
zSqc2*@wK<OhT-KDdJBZSti2xeZ`wa*jm?+F56UqUWtfT5OkP+cLRKW)OqI#2%1pEa
z#8KT-vTIu`9aFwD%j-#&;J@4f6Q_r=VB5I>XAZ!b1#rfBJ_G;dhHiHkdUY3y#-o<Y
z=$vx+lM!@I8!Q`M^RsEzKPF6)j`h=s^K<CZ;U*tj1Xt^d_ZyG*yV0$~-L12$%skE-
zt`4CGNYDf5pX9)84f)IrX|Bz)ugzP}<ch4>u+kO&7b>@roO@;6=G?jsF5b_KoXZyL
zH`%50`&gRGe{ly)YkeS+elv|OW{ORa#z*~B_<gRLE>=SqyNpe+!zL7xuL;s8Av4$D
zYc=#U;$Wl$#*3|j;3wFbZLG{T2ouq6^9g(hZb;BKcmWIxfI-cC6QI9?%zV>cyQ>^b
zPbyL){qh?NrhlXJh37VXB;EY^i%^tBkj^3$xhZW#W-Wyq*=`X!F73f$E0|EAbQf*1
z1mm;|x4#sg3Jxe4225)h3Dt~*a~n{b0rW*8T8N0g2z!pPln%F)4UbDD$fXb{F<5;W
zl4Jz7)eN8SrqtjnO?sW`=S}&>LHnaXJHgH1dyI_<DemVR!K@DF&-1M!f@22*V$k!9
z(?a385%j(sdf(=`>`adJO!#_cHoY&B-lwphA5Xtvge?Q-9T)|CS{zlRD|lBhoFk4P
zWC)1b0HUGA{i>04)f~F2H6UsPh^Eo2;^|e9^eP}U&B>I?s9ZHb&;HzS9C?IantFtf
z?m+WEm^qwGiT0lqI12zj0>C+$IiQORo5_kl4<X6B`PH9S!k<^gCy0{dMM$${^m}r6
z{RsL!8>~+I&l~Th@z;b&16{#9<W?JUttz>ehg@5gdAChHbZ{zYh@rQWSDR3<5kx2m
z;Flo@M_`l9@G)-h>dd7{FH)%<lt=6|0|lCn2u+8brbD?V^;1B<;O8)inG?2tu^{Mw
zLPCYJ3E~}q%>ZB%y8JOWl98Lk$n6JgJ^(gpjBD|XYmtm=OEvs{Tmz)h971;vL0&t&
z&vxUzAmbYgku*spmA*%|sihEVQV9b@k{FS6CY9<)+~KA?nz$yl4H`JDJrP@Lh@awT
z=*I&25DN7cg*pr-BS<8T5J?^s>R}2si@2jq`O8iV14A7c2?o*(Z!1ljj{#gwnD-#G
zU^p#!v4)=-pSu^lHNb4eHtfG{nhu|8n<mw!P@%+~zW2x#Xg8LiKKHjdi+aG&ny83=
zes&F1QMOdkd*pF}e*Rl?hq4$fAApF@fI&B4@BuK`nvB``Z;t9SK=K?Q3Fi>z%NT!S
zfjuxwUkY^$%o0i@O%X}n6e<senoC645m5qQ^9!RJ^7f;K**5q?+?kJ$W`)n_XrN-d
z_&Eho<#AFk!Ehp7{I|)6vgt-fK#?VoB7?IKK)w8lx^H2DvpA27l}E|Rp(u(B4-?#3
z2*V=@&}a{zd1HvXB8%!L^7Bw)Y$)a;G+9=LU~Put)*txMtNv=J5?}BOJ!@{Fh9W!l
zp-kqaI5qa|wDvW;@POp4zAvcpFQ^+UQrs(2IbTp0zo3M`zBY_*k;P0svnLBSk6m+I
zX?Wr|im!-SSIX3E-~Q$K81PI2Jk6MOhRnJ+p!^)p;m$ck<(ZR`qFX@u>v{9$0;vN=
zRp|13!?m8(&b5B@-Z?~cuE2zHZcnvMY|r}bR>Mkz`y=-Ivst?|N&eZ*XSW|zChJP}
zX0mEcc*OS@{~}MxwxMCXguzDw$@*EL{N!~zQMqu0Lq1W8zni{d1Zd|!5_mBy*)?>!
z@sQ@#KSqehpiZh8P<;MN(ZpW&!?j%7*otq$p-bEBwm%94F1=R-O7Ee}KO^~-lna-i
z(J)pg(TDFgS7KjR_0GFEBB7460S%RT4*j<AmHrnU)6+^S^Tr)#<(&Sp%^DT7p(CU7
zwF=tZk-=JJ)mW~AzT!A5;<k3l=f_tp_xm%2_3zFUUIfEd)C`oFIO}@dyNm1wWgIB6
z@6YTP24;wc-KXx~EUzX$c|_=}rxiYVL^bIqT#OHw@9lL0<N&9VYV51NUMH8!cp<M@
zRYJYLgqr>dyUQ1r>;1nbIjlxSBVGkvwe`uLQ?41iZnfN~`zpwc1tl9%xbBA2>E}A#
z#NRlZNy;CA5%fQTkafcaf1=I?qh+^h*~-IfD#HJi@3S9ieimM%%9wKbOb|;4d>ft>
zI*t!<FL_UlReE=)0M(Mu3TIC;oHgZ8%Q|xVoT=f$5x}t|;8+aceTzsWj1UPP6w+Y|
zDT_FyOqr*D=?lQF%<3YyX~(4=VV)+pBYJw=3L28z0Wsb1WA|5P-y?h6aG8VZhEjTa
zVbLuR%)%ze3Tw4-8LXTq$SBcYz1)6~L$kNJ$Xpj1@;u<cLx1Xzi?AQ$-&UGGbbJ<w
zcyT;vVUvGSY2JK%wr3M@Y*!X}Z1=_1orUD3>0zmfhGJB_w{f_3;gP*m5cc4J7gW$$
zb}1liVG|}k>LRHZCJ3+fN(@w28GyyB&&VVPs>i1eni`BY6J_%guD=Wz@q4+UnzQX|
zcxbI^6@q(}I#_%C<wlj{BG4<FkM6dZcM5p9k;}@=g)nn9M;SJWfw(c*d{PMLJh}+X
z>5Ml2HxA>lBfP9Ym!uBLkNj~P{jn;)`Vba(Z|B+cAGgcnFrKB%35)sqql+$+viW_8
z(dJWTdYOA>dQJk2bO^;so2IHg+ANcT9wF9h&{SC&qQVTvD4=q|u(pzK6Ey!100960
zWS4t9lW+Y0>r<$ta%zdvoMtj|nv~3`wK)t+DaWYEatcWk<`6mMuq}ivS)yXd`81W|
z7BWhbLt=8sVdOY`Z+^eW_n+_M@w~3*Yxi}(uY33I>)zwO>63>Rl>%PaToefWTCr#2
z#JMj+e-AANOzRU{4q4avEd{*YQx|2^&qq4&b4FhvGEh$8-oNyR!TEm->GBrJxoaDD
z2O=F!b&k;xdri-5xM!8<Z>3+p8j#&<X!T%sVdNb)U**x*e-noE*L1;xSBFts8nO;<
zFoOP?&>uthD{9DCZOR|*M}Pi*U;0P;+M=Z4qGbKcp}k$+KVA+QcX@~ZDeG|_(1vw+
zXaA{SYhY_5Wt;52q2^PLLkF=ybfG<9NkIokl1E@_*xIr4Sl;>P>8$Q**-eO1`rB<s
zrc1u|e<+0Z1Ie{J#A^i@uzxmDI4be!HAnC>E_&&gekR-c&29;`4<usUXZW!0DwwJJ
zPf9t$&-DFNlU&;!exKoa7F4b8cAp7<S0zZ|sJOb#goOWZ`7O+A4%eR{9Dqal{i_~|
zR?e%MuXdt?-Lo#bWnIMY^zK=aTAebQog;5o2VSfWlyd@dwi$7#DNN2LT<y_y57g|8
zO}|~H+4*J%CC$z|ce0*pZHLLXt927S_9ugnCc}Vp%ITCT$>B72-F7tkrd#txw}!pb
zf73nhp5@?{HDI%_uD`JE(LQUmO;gwH?L!>u(Y*v5A}oEpNV7A02e4+R^PQ{+t?lsZ
zEurw<9hF4AxYp<3_OD&Hg$b5^zyD}#pT*<ZbqD1DHsg+wM*5(ynpWM|$Fp@~hMIL_
zE=!A7jU6>%^eqR*dR6sQz^~Db-S1z(23Bg)s^<foYv%*NfYp9CBV?#9S&1oU?f0er
z-_~k765X1Zx3I42Q%TJ*l@fNIFgrvDwK4v1Q2z0`hSM@q<lhK^2e@WI@j?~rN>sw#
z^mTtQCgJXLsb85=zhrbiZjfaEqhB-D_ci`A8oh69--*zuObOw08Zu`!WQ<*n)1FzO
zcB{&Tg0KRKHHv?A{ng4AdLn(s^98#)E`#0&WFf_noX9<Cpl_cA&vW`-fZHo-($c*H
zoHM-xz<||m)?auT?c!*BMpec&#32c2X6?M{GabC@BY@K`EJ#|3C4+?Y9j#?m)7b)M
z;pHBIR-S=Y@VdM+b$R$ewTpFWFC0IghTVK2k(%OCT`KmQjWwgBxP-iVbyi*VWJ7JG
ztD|n@>Mb|c=Qwvx(=&q4huX@v+D9&q;p+n;KW9^hLn`(z*T`26!9Hww?XMYv#pIdt
zFV@HhuML<?Oa{EQNfvDueyZ_hHkW7DGmFff2_V}Mh*;-Z%j8MJi-YycYXVf1jpF55
zTYqr<zu2A%$K;?Xai~|FOt5#|n}z}#@%3+S4-5uY>0=YDjjK~e<Lt+l&d2^5e5*7$
z@*i}|kz1Dvn(a0E>3>CNta*r4FkAiR-0YTL@6$Jgvsn6My)4kpO=c9n$u`+ne<$xi
z82$JgXPU1T4z*2Z68B4jP=2mZesh$yXq5GW7VX?I>;Rm0?l|_j5VSKjzZ!=U(xf4O
z9Lx`k>M1&y4;IS*C4oJ8yacReW^|_rto3L+yrh7wm`RGANe6)GV%Sl}#bB$CNs3NJ
zFFz!?^(VP$%B2hCH>5&;sLSyS#h^35YHp}_94cN@u33ZjpXMzi7c(Q5?@7m;QSo?`
zIc^8<vsr74wxHi(-sTtP3flGzrMnE<X?$$}iRbgh_LPX{N5)p_V=<P-XR%XD3KDl|
z@N?Mno(Vn3OLy!NdQuX4mS)C7A9^m!CqMKQxMqqyZ!OW)d+3V%VwsUul$<|hhgx;)
z{vSRP`8h1q2^Cp?V~PCVc1V{G$=CXmuicYNVWH&fF~wIUVvH`1uyavTN+P$RA`tPI
z1tv<~traKNp)BiTj~p?Uh|yr7YSrZ&B}8VQCig)0)*MSse&B!{sfurmQx}=FLr#Xv
z_<LTQd@18!6>lw)&{M`lUARYc{2`V9IHBjgR6gWH{`gbjVMhx}a-ge3ehZG4r6~LF
zvpUuZy$#|z>494-si&9Ja~nM=h@M<GVegW|-!NtGlE<Htiy1%twShzfo3PJ#k~EFc
z$8AZP6q2S{irh)t5;-Ar^l_k%+zHSf2*KuZrN8TQlV{wI`#5!@7PX!Pt*18+qi*&m
zH~&H1oN<>~J*QQ^madS8B9}thd&TiCP`0rWyK%~0CL6r0W&XK7cRwIwr|!mS_jDzr
zZ31y}|B|a!nsKyz6<PDDcujF2c}w8=V>RE4<D+6Vf2)f~w1D0`yMj#5k!|nhp#1L9
zs>V=$6DU7={H|rr%Xm#~7RpaWw*8_6-YX^fs0nEsM~Rro`}RoNKkDpo7D~_xX}gk=
zoHC3u?N3hmgECc-Ee?8aYm1|aE3uV4V@nM$075{$zuI1pEhWX4a+xS)%~5qWQ(3m4
zGQLy<M|*l5X?xmen}<=22It|lGB{03l5Km8{i8Ptegh@hp9FV9Ny3fAlHn;}&#t6$
zyao++oc&FmR-j2MxQ&tm7VD4ns8XEKj|1C5_r*biz63Y4Vq^ay?*IeG=wN--M!g2X
z;=|FA-vzL+#+R~x8<Ovr%l`c$3_|JL8<tMUE6g4EtNkck{%;p)3ICpU!Ir(b<$J%^
z$3}c=y@e=X+;}uXC2j^eF*Eb?k>Y?nHZ~RoJ)s0frQSGVBJl_-^F%}mJg}P4?w8<H
zMelsq^vP-5KPs}}p_5<dyE4vTqN@DYGxA@hN?L8Yz18mC%mO-w3!|w)sIB5yWwCBn
zruFL`7|+S)89swTcQ9}KFmK#3Z;UW+1UR&)Hnb2CbLV?zPiUrCXlBpc7%jIQ-Cn~&
zn`e;I>oa>AGka>Ei^@8Q`eM6*E$QU+By##-X3xtVV!iBVdFesgxstuMwLS%}02TQZ
zh*$a)c)DQwrO7|w3T6JkZI9fSFAJ9JJqMTfpHY$b_b{1U!D0n2V<G3npFBMAz4F_<
zm;KbA=CVT`_EQhE3;m&T+ju{wy{NJ@!loKwZH%xWL#*~0xqoJ;$yFn4XB6$^qrE2R
z3r?uX{-hp8O;S$<IDb|U9efbI(GP~Y74{_cEJxAmqiA}MX!Y81LW(=QeAsKqIX6%P
zAFgxX11Pl4J))t`-H4nVwHdEjDuK^?X!9W9+n0&}&s(zWKQl7yRwON1Rp!YVnI}87
zhCmT_#zAsouuOQ`L6Wds_yh{xCI>g#LCqR&E{)gZsI#xJP&XB2pX_0wL`9PoHlsC*
zh4C+Ov?G*cg?e?7Vu_fa4oDfetgsVOCM_9N8h>ngA0;`uBHp+(-uOklaV?Gpjob!*
z@AsXMl~Bo^C+?RAE8$-OeXoQI{j7v*K=B+4v_=NWwc5vjOKRg?`l<=qPm;_D0FgOx
zh4x@Ie1aPO<UpnEDyPWDb7r6t-uuMe52#-DvbVFu*aB2$wp!%h&1oB@_m4=sY4Bcd
z)RaflQW@@oHqsjggr>b?;zUcwVgsK&1EPZxl-x9mO%UI!SLP<H8dDR~3`$Bpt+bI=
zdJk>2p3>Ew-CX}_HqLN>{$2HezY+IhwwE#;qD049JHE=RJr09%9=lf>z@T(rG~tRV
z^Q|S;QAim|e@3h2STNn;P&yusH)*--wD6R26|Pt?qoP>gVQIS>&OQ*qR<gyu3p%X`
zEvS`$^)!WY)e>t<Fg0;!q5-D*b*dI1;gtsMX!j1ZJJ7eHry4R#)pYQ`JJFIEWOx#}
z!*lV|o!>09T?V;4AeCGWhj<3-;Nx`g56?r8^{`P|fi}cb3*rfec-HCQFYN##lQA5V
zcJ%oU^m(9fMb`k6YU|)<JJAm_$V(K_JjmZ*orxQM>|Zm!><=7Tgev638ORA2Uv``Q
z8=Z;acC-LMD_X!Ca}K-1;NZ(N?}UJy>WdStc9aA_`v8U6Q7{UM&v^zDw<6g4%M~xU
zjZKX9zr0tDo(Kv+Pk4~oeW{d=G)hNBh2pn*4G*hx4=WU(`^T{*$`zm2*-=!)o^I1c
zatXN=FWEz4N1B>|U{Hq_w0rxNp$_KQ>NPU^tHP_dDPqf=T^4WO(rNeJ8%*2}Fqm+S
zV7G%PUdJe2K=oLS0eXT1gASC^?nRK;?RMDe%b0C0NoS{720Xr`IIt>g5)k}|ed1*H
zy~9C|*q<6{j}ZzNJj??B$ciaJE^MN!&}fScQdU4JDGM%tAs9Ll1D%j~9@|_8(KVcy
z07@@QXD>dwq<En&(K65qwavx2nAI*_FUvTzs)|BgY1(4A3;T3YTCEqBTaA#X_fu*M
zn;JL#7T*UB*q8<Or!Cgkq%D@KP5g~Rd&i?^-PDS?b=hf)OGn9rwq}7wzyM6a+Y&SQ
zBC}R_fcl*Z8AbXNx%{&hgI_k<B#RIP*}Ft`%idRs2*qFz%e6n7a%;0)iEk6ViR@m5
zSF;21uju9`PEOc07wj5x8R9YoT7m@Et&{7k5fg%d1~<@%SQ7w-8@jkAKg1Hd=7XMi
zE&ocILJ0|zf5kwX5Q*5ee%fL$DO|E|v!0~hz>jMf;KPLqF?Tsx^53xJH#UuZD!oe{
z7g|9(_=Tjt%Y?bh8%-elautGfx-%BX%)CF^HE6HGhBMZV&Y3?DTyY(?Yp5_Y8|1c(
z!X(KRGd$m1H?zfvK-Th@*&a{iPyOZBGp*76Gn)6e!26gDD4F#PQ6EeG=Fc@(UC%sa
zAHLTwY>N2Oe!inkA9NrG@x}AfyUhmFX6USIASA_eju%Oq9lR{58<IVGs-K@a(9MsC
z#_C1C`E|-OLV7P)x)Cf*18)bhW87u4)}e*RybF@t<>|LG(>?rKS#*&@<xpv<4EiZa
z4@S60(d_9~{;eUKqyZno9e2dB`Y?~8Wyx0lDeWYoDDP8}yiV<;zRX$+9Rk&tTMz%l
zI1D5|Zarr-xV3FPOh>}SSG|!+2E!pnnvgFC5sj(jY#`qx?<iPDB34J@csrWkFPn2K
zPa9&S1u+6cjOuhGkUQkU=0BZ+d^!vHqzTy$|M{u^9KBVEfPC`AM7d*L3=k?+A+jDA
zWTV24R(#cgU1ZY9@f^eUwte0hq#FjQk3l~0<L(|C-NS4X_;PG(x9-MjD0MUFg#}SB
z^ff|yuinP$m%U>~L`%I=gVis38*K?s=B3xXz9E0m;^WP++gg;z$tmD&EfNyDq$Qra
zA&ImMH>sz|$@WWoj!k%VObeV*=aL{wIf^@!UI-DRP^|2+NIY7CPabD|11;f6QvX4v
zbituHWi<V%1ve+O#LWnG1-QYsnn4t`V-&S65~<HVPaYRvL5uGqsq>pKk9ngdOm(&q
zH0R#Trp1qu)UTQ{uPH)r?lEPa6{YxWzKDNsAn{s0GJUjV)r9#VgEC)?-cda*zJ(T_
zm?D;gI0*~@GtuR7x)jR%AW1#!<u<!*#~}LF3U{p)+^iLVuosDY8N)OtS}Xj>GkcWR
zAUqUPpJ!HL^-L^dN275}xp*e6-wJxGuqV%qi^P$TI1ytUNn1(U%3AMbUJy-aLHfhw
zf-qfAdIHcpJ!!r|J?RWu(6j}!1rC*-n%o2Iv3`|m;bEy4V{WNeY_Qr0qF9_!q#D~$
z-*F5bg7xML^{9U)7xur?qdu^qwo%C2e1Rh*OqjP+pyV=|SrkcKr-){zX7Fs}FjGvD
z0=32FrTWCuX=Y{UXU8*kG-=ATHe>d<q1DzdXVc97rBL#1vAKr801Vo#sI*NfA>=rP
zg15)!;?d9e<#Dz*(5pRiW0#3oy)yKwwdsM<{NTyc&~8u5+!h7JZLNo^pNLSuV2gEx
zgYKZ8%>YvYU*|DNeZUUuYKhs#O>pC2Yumw&wu9|$K!|V140845K0`pLeVIYII$`15
zXQ~hlPmF7`!j9H_)kXc(HPXr9+e_BW8{>Kh<7$X;4fIow^WEY2#O)7~?bmrozm)o}
zOg?YT+kAk5_0&(L^ueL;|4Oz`|3o4Bdrw_xam8UgO4I=*sGjyabK37E!nAR%vx~Yg
z-mHrl@7##p&>?!ELOQ6D5Bta|Rg@iiFbEJ^J+)iirdu5d+Gk)3X11KwZuQPw+(}yG
zkBRYBw)#*mF2rL;^{TK1HQ0jp>!y{?$EBZ_fi1Z>JsPfF8z!i@!;Aco-5&0sx$^sA
zUhbfV^7{tE<@dAqvkZyXj{Yc8?(u|aeN|obbO-glQ;s#idK3^BhZA<iS>3a9Uj%(9
zzn>gnSA(i3i@RZ0(^^yDU}kk4;9$YOIIvQjj#8YK(stOB!>x*8j&J4#dF60*jQN<%
z@%lXFVyo*S89N$@V~WHxNx*Uio+0y;=aIM=ByPVkE=F6)6uLv%hY;wrM=H1De*TO{
z>c@`z_~DKvK{7>^hhF`tFeW(A_p!S|HRyc5s;6aryt!pP@CU&LQB>6wosa?Lk)I>0
z-*2#M-fv(7%AG!TESb)BES+Yy*-*&z7wwzCLynUVdey{~X=914KcEbC%6Jj<_b{^;
zuIS{B&W5kkgXMA0%$X(M<+i2ngiUeArd%|Q?Q#MZ<Fg8yayO~upb1mm8+{#PwL|+7
z%h|3bv!aaUZ&xE#UdGx}QFhww>eZF^B_CaJkzVe_k%5u)ckfD_uS;YUZEHf1Wpa?k
z{8RpIjsD2<ugPrr{a0S@HXi{6*sTk_8k00(X@B?K63PT^MRmpzbH<w(VGAQed$T}W
z-x|m4i1zhmKC9odK%F!As;zG}_E-CA-^H3cZi_pH6X)QbuDee_ij>ZceTEb<&2<ia
zR;rjzJM4T#juEu)tqk9Vu<Pdkk0;A-vuodRxFxnM)*VIFw|iKu<K$GW&DwXxgzGtD
ze3G-hD@>NHWNKM)%#P|S-!)afdy)d0VjKkqyb0Iej^SXG)UrWtNdkL^AG5s%w%>eg
zzu|4a0f8@f>^wPTmWN;M01`^DY=}5+%36lQhFTP0L;a;ev%sgcl-cdIOFWEU9n46X
z)q)Kf+14-TjtQ8s4pUO3^Y(8Epjd}9Q=~Ov2z}d-eP*mg1sGzjo10_KN~9dk12Vg0
zFc%l>v7<Uw*pwP<>Lz>pSrLDI)|?dxfMNxD+rlk(xN&-u|9iE^Z~=>dpxPs}fECqH
zz(R_qKH04FDD~;vX9t?T@#9Z_wMPk|Pb{N$Tca$N!e>@)za40OzejihOJVjKj_l<C
z{{SdpiYv;;fgJd3(UY_#N=c<w*79g$V-Q7E1Yb%j)!Z>;X?*N<Mk=+e_J+}BXFa#1
zuNmj(F|w`qswx?3Dj7LrO>5p!z<`}2+?~*Oa18gpqShn3bephp9&D}^Cy4Ovdzolo
z-XNO_3j>^9<niw@?yV5(YVfGxE8JT;jF{2REdPEB2MF$TwcPn?`9<lfV;i18amI2o
z3m!aLB6PCKV?oci4`a1M`)Yr7k;nMQ5(h!neMRN|J%TJ%h0~0c_uRO4rmF3=BAqRe
zlXIW*rxIECjy{1>P8>@)(e=?~BS7D|?-xw@d}+~i=*N;zcGp5)mGVsRtKxQx#K>S4
zz1Dm6$})`cv3{(#A(({`O?|#uISu@}`Rhl$x`rnDE2e>;RXn41TVpJi%4b&LpZbe>
zVGc#!ePaU^)9hfD%J+(C?u_02%Qtq&+4NFWt*NS={>CklWU^)&xFs#4xI~2NLl4I#
zH^K+cnUhY0KKI`x+Hjw3^@39Cj-}Rhaa}f+4GDcyFx7`;wbPN@l3qK<B`ez{gPKjf
zJH0~!vtrBh=bM7pFh0_?mw$p*Fg}d^tPtY0rT(Jnioa`p*$zYo-C--#oEdhlbV|DD
z@0vgm(DEF%c9l&@hu+`VGYGUFg~VMy{vF<1KDBj{b$>(Zdm(Wy>&HJo%bHDae<4*i
z*8!1Wz6v&31*dYi(nt>!Nk!|#<LNAs{fl62D){$fnNHg=qb_ZR*7Pi9iypr<-tkVV
z+`tcbKjh6yKXcfUcr1Ikg{LvX_*Q5dmjc_A2>HCxN%YNdr;>;)XYI$ohJ3$AcJS;D
zU1Ip;Mr{nJ1}d?H)e$0E-X2jRlV7^eQLa5E^)Y@4S6H@P!T&sh-Ez*~T9NjT!#sC8
zu_|lg5CLg%D$bPB@$r?ad)<~yR%lT>ujAWnmM}go;2*D-ck_%+!bL<r@DBc5s^x*N
zRCk-tL4}s$7i~U2LtI*n6k2?;q*`PXFEXDAQYpk%pXI~|V(YwH>z%Z0P3~cxnN1&E
z4a||1{ksste4RH`F3*V`3^Dv*v1=vf)Eoo0G6WtbYOD+$s;#ZE{IKOZ#}Mav@7n4Y
z3?VgG{I}Ak_yFnmES!34j(i|Qq``tej9N1M+OWYwZ3Qae_`yDJ`1LU!C7k--+-1kP
z?!6($8!Rp{hM9|P)F|^Y{GfH#H$dO5v+8eN#y56eo7Vu3+`h((7p1$YSkG%Hhaj6e
zLsul|E7wI3f+M$cggbAkbVpOiqN!h_sgcoCq1Y82!4Q?bJgEq3T;H!-+P#y9#-(QO
zc1!@8zS}_vI6L0P(@mo$rr(CA=C2aq2s&r{11~6PmCro{+{pVc!|5)V?xE6?<TRY*
z^d-qDG|6c$iYF81w0AD9tAwQUz6!%)UQ{^^Dtl-DsKi$-@11?gNUC9@YVnFZ#Ieaf
zZzS~^j}+_l-@K{gJWDP_qEYpdY}Qx%Tw%s%Va7XQ#zA3*l-T^~qdb#+E8_f&k%qVF
zg5tab5l&Wfr+0-k35Gmvp#Qh>)veLowC76n%9VtbD^FH{@byKs)BBNL!$x}XiWbDN
z9XL|&HC}qG)1G;E$N4F_kQ0scOHG1eXL|Ej{EspUM|ur-fk`Vur$c0odHiuhcSpXq
zM=FIxG<oN(2pwVk5@(=Cv<-M1&-rl9IdMkYi1rnpLiEr<5eBZwJ2HC6W!?@`8&zf5
z<XyZ16KC*^R0NH*ZAnMh7zhX4+;6^IE=f|KY0itUakgt7NTT>?b5wt~ZQX3h*<&y~
z)4Ttt5aMV)UPbJ#HgeeOdw30acfd`(xwCsu3N-vS{vepn64N~t(PA}scGpSBKHWmT
zM9Ke7rhfQ+ZqAlt$d||(_7T@r32pfoK6Gh#dG|{2p`S}4H3mAwU(J7bk&@-(sy~x5
z8Fz0=Y>dt;6KaoeADEr&Ozwq)lnA;CiLXcJLv^!Kc_A_k>DF0>dC2V(0TCu42=Wkp
zba~I}hQa7OjKDj>T`@a3l-#QZ6a^_H(nsgRbn8=jyJd*GTBV~4GXs{&s@1OR3>+)S
z^!i?y>4mzA(dIbmkRe4Q`wbgKiyr(3aqI=I!v1TzVX=^1^LriV1<*W$BgDD#2L^u6
zV-c+*hu^G3oZ7sRv|@CXmwjaZ@iiV8;@An)94=llQrbKcjTjXtrZr0Q&p-B#1E~X7
z?vwInQ7q!%$YFsPgiDk3eqrLHCTX9Mf54^N+!u#<Ig%K<BI`JR3C*)QLe#9j4h7bK
zJ2R*DI>B1|bmB+Xv91^G%$rAf#Yg5^j`7q41{;7|E>Uge=7G&)p$HBiF|$EhV6G)c
znDO4A=Lx=1dOR9YC`^=+*?eHxNG%$%codEJFk*3bK8j-~P7H6NTFyiCdHd-P3`H#V
zjqJ}Ei4;tqvepI1L9FK=oyt0c;-OD(-ilr!D{s<7y>9_GDdaj2Elw0^q%OuHE{<4)
ztz7OJ$i`p37g2paC^q1+#l*}U^!o`t@zV1_KS+oZhMSsX#NSrQ48f;7yaLg-jmpn`
zT{qf!WK~0dGhQ}vwpG^iT!l91brR#R##Rt3Q37*&tGx59%X&qy0_kgKR%;35fU`y8
zbd1zPQNQdGh|7{OGi%>>Q9_@n=tGwq7SrEf$@V^BhM8(31ylx#F5I1n8f|zb$r{zR
zaA_w$N`p8r$aUzts8}z^d1M*4lS2t2bOKi0;s6Jo^R=n8tlFSJ1zlAw_jQsa_QsU`
zVv_Wk1Q7&VG>^7P5ia{>lOQ*_w@k7Qwvq{LWKn|eDT|N{UdN!NcHU^)Gu<i@M1VVL
zFbY*B#2(>_nPq)U*46+P+yMoP>``c_Ze*&ieDdqPT#DN0^UskcS){hhN(7Tr781r;
zOw#KEV2h^Fd?|vTUv_PGz|BR>kWhcXnipztqDHOr{Kja0jILJF>w1UJ?Gv8bZ<=(q
zKnp##pD!D!S)8!`+<k396U@PX*L|Yl?F^irrbiaCy*rd}oWA=0)~0eALh?x!e$g-D
z_`+=+PUoG^)JR~H*uuE-svmf?Q*G5RfhP`}9-?Km6T0fBznPiJBgha>wo(%Z4?jyn
z99}l+T-f-s5QtdR{dxF;^gYC4xHu7P%;P&s{18*233{_4sJs~-%h)xd`k={4ZXRU7
zy9fy(u47<7?s+*EnyV1|KwA?L>Ywoc0{{U3|3sMyG}LeO|4GQc6qD?GMJ5T!u23kg
zM2sw%>_svk`)-hIX$Cd4&?1eZ{N!WHOvo}t8cW7BO{0=#%Q6h}|M>pS|NPFG=ib-z
ze$IXFeeOJ;bLM<zAz;bbFjDXe?(%A7e9U*TMf-P{k8R`Gv~j;D|IxF@qKhqv#p{o7
zvY*GC-3!AO<Fb5xN3Vq)e_W@pe*4aK$2$EEeNRm%9ByFDnnNDSaoZ##AW_ScsZVmC
ztEAf;x&76o7V;wH$Wt6?2b?zA=Ak}mrxUJp!0a%`i{YeC>Zhwz*yxrZ|CJ$iI35nT
zJ*z^kt!*Bf)KHrE|5W}Hjy6E0SMT{L933i!v)XE7mW8}!#jou3YhYAP+B8=o#kfNV
zu5k#?S#|C!)?%d1(ch_=rC8;R`Domf9V!ui*B!Sw^1kh-VEN!kTfp1qYbJ-UBES2c
zjJg{KyY}6W6S*XkATm?Ke|+u5aKydfL}TlS*}LukRMwJedOEF^rH(&}8Ih?!$BVo*
z_5m4pS!9jz6(7>NGO5$H)&8PhO;?NwaO=Vwu^$h<)Y7e(PtAA3TEz58moH|;5?jR9
z`*LkyIX1BD|8MhbFu9vRR@W|$aKc$D&fQ3zYMtk&i3m0p+H|j-NW!WXkZq&uM(zz$
zds_vxgpD~aR^Y24Q2P)(cS^%LFSbYR!}sbVz=B$=h^Z#kK5kp6C#C=UQiAPBvti7?
zvAAuGLst~nJ-9A&w--Om+u7pm0o}@lxhl)D6Lw@U`Xq18v**G{4R|O`a%PM_;Ld&A
zbk80LW_a$hPLmwt?~#^@3k++FJMwlvjFHpUWHOW!7-*u_vLE(R#Ypkhe%QC1Hgr^D
zobD>&`8In~qX(Wt1>M`5bts0R&Jy76bXdig!<LVz&MM%OOqeL^fg_b@jCv{03X(<)
zz4_9nAPRp^CGG%sro*_IFhdqi2;t{D|Ft9&hGfws5o+Cq;u)AGs=iaV`+k(fwC|kD
z4sdH0<`hd&2=Pt|QP%Cg1$7)sAN*DaLsx2h^rBxs(Ah-gAHDvz5?o0KQ9yK`gbH{-
ztGfW+F2HPIpFyxk^$@!V?(WqX)loEtfyR76V{*|L*#eY`6vALDD4m6Q8HI>G+B3Kx
zr6LL!p<V{5mnA^sbj-K~+_GK)KBxe1P=HG*z*Tp!W4%B>G|EaDj+_R+q6;v=?AW~s
zS;8Pd94tox@^Cn`(=lBHP8WgDMQG?C>~_<Xj8QrAEJ<lZ&l><bKfar)v;*9d?#;^d
z)?*b2Ax=X(VO>BSSMUL3kAgv`2u40^H*H$Q1+XlN8>_n)kxw*wiqe<I)0OZZv<gS?
z6||G75`KtQaUMK?_Lfz|2N4^x(cXdVy>EsGi=LpAl<^N}=N-TTZ*XtEw<!DB6ywMH
zbKu@W@AK?uS_t!FV3iVHSqD)>Y?y=&`G7Wl0jw(U7GZ}Y*uV7<>V$@fYVY{n-^bf-
zdXo<z)IXpWYY!lLGs)Y8@jX=YN5c(b>EuhSU6Kfq?g&&*gd*yM5dLWt!dw_M$ReL(
zRS6-?wt;s<@k(0|g*_3+tG)LL;fd7OJ3!@hGAEO4z?u?5R8N87y@PdA{Me^&I{lu>
zz%k+C9e&S(2j;U&$bp>0qm1+7{qy?)b$z@DJszaT=Yu9C<T?xdTL%PYV16&)uZ34V
ziXfGdrL^&V^hKyDjS_M&C(#Wd*FO&o%x?!$wD59Kh{eDk&q+qe6o0Gv-VZ+ZSAIlZ
zBC2MiEibXfMj7Km1l1;#h*FFYO$MaN90#@0mf05gTrEloQS}+>h<waWJxYIprKCa(
zfmQ_NP(WJ-v0e63wh>eTqG~xRSUyHN3Q^<;nig7mvEOS^4jlvYm0}ciDA~m7W7Xc<
z<zwE_PMiZJ(3b21*JCzYXbMr>g6>fLchwc>XfK^6pZu*+URA!VdTr_n74T^bU@pq4
zm!_QSsosJ*3rCr4i4mg?*A6$R90gTe!Achp0-sZa>WgfKHf`7kY=a`i*$iWfAF(<M
z6^BPjDaHuX_CXP%=+;YY<-L?Ggo|7AyMl-T5(;TK#DG!@yte~iNjc4#7$D5{25I|_
zgZk*!M;7=yP1cbE?Y(#2T1QGi&au7Mdmpbsn~p!gYZzrL?k(y1K*#UpH8^ZM!|=^@
z(q#GrxUYc@u_y%oS~WRhim|w>1?W)z%ozXhs#P*DhWMuu>X=efYtWL{2a4pxMPTyc
z_N0hQF-1{`#`|Wq<_TggUq;fud{p^(_=#C<k$KGaAWH7=G}JcL{V~0asL!Abwv}Dg
zs?U9MiE?KOoN|f}8yv4|^uoM3<v%5M9&_Uk=)VoHHi$8dLM)_%>gBCxIX4_ABkmMj
z|Fj5@6wVEoqc2o~9c8WJoFzxPx-pO^&yn?@I8K3wg#d8_W-VPk9n8Xjx}^zQIk%wF
z75c3Y0IvGXZFKdlerq4jNp1Q)ELh$G#AlAR-&^??ZD`vuEpd{0gM*_ic+l@<fM#!i
z_}m~$Wg&pv$GCSNn;^TF;r|@K$a761Db7>i+jIbC!F<5*?*<FWpiyOlDE9@FNGXU?
z5llHBOo70BH)F;aXqD$gdr(e55yF6_0kfVylMYs6K<m;3an9e5jB)k9d2hMvrxH3e
zf6Fc(naTQ_mw17#p-r>B0Oqv-i$ZJ-W6BX?QaVZwkMdMxO3-X=qY$?DhZ_uAfyK`j
zcpS8c*^}W0%z38L14`j|67*!kPcezVJI-~$o-A{ob)Ec;&sv@T%vd~p`wqFS1$<HW
zBYyWjym-YO${jFa8xUi_+!uxD$N(+Nm%TU?2g<bjhFEErFg@l}HCfeRL#({(K0QW=
zr|L*gF$QYnId&ct*C}vS2+%ZOKBT9lgT)vSUb>tUeY5j((I?mkAi!iU<@Md=oLGuw
zlj_5oh4(*^tA?w@>%rIvT4e-n@>Wr5>B>~bM>uEq^~isgX+ddeeJ*L!FF(!Rh@|J-
zD%$A0RU~Y2Rpf8yd|3KI;x6iZ;x74xk0qT&!mRJ_zEZi*EVRlfW38rIWn%`H9Q2Cy
zE;&4MaF~66@#UZC{=5`b5$4kvUCqTPFlx<$1FYgG^_5E&LoKag^&K*13sJbRn0b#R
z)zGQw46_Aw>oJOHTbg+2lyzu*$3sY{3S&||lF0mg<|=Zk{YHI91k%?I8^&A>ozk)%
z6PsE0Pz^y&Y0Y}5W}8LH54SiT91{Z|;a*tQrFt33yJ1<uR%4v+9!UaRsBdaj*pWXT
zgUrgXBUkEWGAb>yL#O1iVMkE)GM_3fwuVlXbXQt@9%;F6uzV!2UdG%k>IpPCIF?KE
zPz~K61a4GX42`q|-l+eP2a)Ai?sTOEKl-hF-n0qfTPHLoat_^vre|Tat1-}6a8i@?
zNB4@f%iE)8)CO@fa}#;X2l}D~ts%FH4#pWLo<Fx}XWi#As-`M&ak2ChOz>;y@+vJ&
zuWLo~DSX5AU7?`V5%QBaizFwX6w``UpJ4Ig{m2*N9jm)34aK97n`kKJ{2g~K=Uv&a
zscudRGC9lr6lv!>?3%^<sl_$@lI(%z?X=L`9*moXe$@p}B;Twm7Ur5FxGzKOl!y9U
zh65}yPk9$CG@-?w<j4}<p$Iz@Lb6(Qah&BN<WP>J-L0O!Ju8QVH0MM$J*nRV*&3dO
z%cu)rAD3o}fHB!ksA4%k&~Sp7l<DJU_>(N+QHvMHrU%IF|HLO7til-iHv(~2lo@{}
zF9qU$Uc?$s?r+QZn=kOePP<gahtD2L1is%`n0}pZo_I#Da$QdEyLsYh8jRu<`VUw~
z89H-gei=BwLVfvpyfk@97q<gAZbv&_`c63FU*Ai=ht1!2tq<5Xewqv`!bOsQ{=ucN
zLaN-#1NWY&e|k`*el!H<Rvy3iMDEjrR#*3)czHIgKtix%Lfq4Ijk@Qp9L@=H|09PB
z-yl5Q_+>GEvi0eWw>`y~2{533`k?j9SBK@J2WJi+z2a)Kuk7>2#v_~Qdgn9Uk<|=4
z$K%~C#|~FiGnP6wMb6X?kGKS^h3J@0&PHWa*}^Z2X~Fuh`QnL4&&QFTdGSEvb^p{6
zzxsL3bp+<|{97CKFF$@c&U2*KCP%jUV34f0HoBqk+h6<|+_}<-D&)^m8<9H<6-ph?
z?0`Ue$bQULfV{M!Qk_=MsL9|V9T{egydimRWu%?idz*W0Uc<;&JP-3435Hn*qq#p>
z8A~dtdc6778e7!VF`B!Ry-IkI5q8#uWQ%IjEmQcF7w5T?k#-k{ky*S*JWuUFjR+&|
z-<m5Uou_6|^N<nOoqV!{=NDmTNk}%SCdDUh3^AN+pC81?84Zv3y2X8K8ueoa)&X1X
z<htj6wFVA}umEX0&z?Eq6;O-CQ%+9ZwvsGX!|ZOxN+~7VWs$sDJR!STsm}Cnn9xe*
zPnBDk01NW3_g95uq+vfH7by+fdhgqXD@0f>8Xm&VF}<wc(dISy!O6r(>h*Ku>{qWo
zUi4B{Sk-X|*l_{~jH|3qR(PCT3fV`=r%!!=UE~tA8HJO{*KPu0ag9~*P%bgNbLS8&
zY1rP7OX}fsp8zRwl~rjYjG6}C+@%emgr^wMsYghbsD|g8k~aIHAK7_y7?aLZ#PiM^
z2#{pBKb+Hw5zJcSKgX50^VH~PY{lDlj5wOe92V#0To&kLuS<mr-YNZ4V>s>m8F1B6
z;3TyQJN2=PrTh;*z<1v-;4Dp!-B@VH8jbVaEd*zVyS8%SSwmf~7y&uhG$JFwitER4
zG8YsKcb(zlyZJ_V9yw&g9Gj+Y+ZZy?l{@AZzzwUzFSd-5uloL)uN`w6H0HgM=Un#a
z94dt!gze=WFbJrp52hzqVv?;&;o_Vhr#U~B5)e=5gO$l`Wt)N{-N=|%AkR_q=+vpN
zg&iP=I|lTKrsOF9Q#$q08zr^sb|!#lznCVc|2glNQJ|9lK*LWre`oJ^d*2?oqO|`0
zL3_qu2>~<zO!Lyh+k+#e*2NoHo%uFV0>{}yr+DHiB1O@&S07GWPW@bxIruh(>-kXC
zHVvUPI7hN#^SHm05;yLa<LvP-Nk3!X+dM1`j%&`1Z59ii-}QCd^9<)O8Ms@-_0zs0
zg`-uq&S8xwMy5)By}k2zehT}`x7)8_EPkIS`SoFc^1JK)^Y>oNqf`8Ecf3?_dve5c
z{#1~<Tc{v+{z1hIqT;=b_F}@F)po(@)}NoBrWmGNS@*yFR*Y1v8DwR@QvERve9X(3
z&F-X($jw^b$3K<}w*_l_JekNZy-_QPoiYLV)^GFQERs{GYn3uf>qBDPHz6Wm&EzEt
zDH09X2fxUVfj-SG+GP&2M<dZ1tECBtREKB79}3h*T-Icf4^#4v%s%P-v@DA(Ke1Rp
z(a}2@GW#u(1Nm&`Rf|v7cTfC-mX_5=3{vu%B`Dt_SIO3D_uTFKVqF;TRoZyC(2(e=
z(u;p?4lVe+eDm?<*DXe0lvAcUMJ*0rL_KVFwmf|C(!*x`D-WB;>!Tw2V_#Qb8X8Rp
z&jWFdCf*l;wy9@><6akDyh+3~M1^#ofb3hpsIed6)h6E4*W0G*2gfZ0v9D*&#K`%)
zcq4A?Z5?D~#i7zy7I6ly8dYl63-tc&W>#gBa^Z$4r>p~G|9ocl%u1988+zWlci8I2
zJNksmL8}{+o{`@D^a)~lFeX`U!{mRaXNU>y?f;?^U|$#hawrRb4OlZmofl`1EQqmY
zq&qM6B#5m1)neHyCwp#N(GZ)}oz3bJ?_S=&q9HmfLQMjxNfOEMbY>2eOKR<92dFvS
z0J$d3Y1MzeAvH>~FrCg~;_|>Ul_|nbG4AvvE@!OR;a5@>XXR*X4;4ruCSz#k9GXc+
zGxN|)xq=m8sZ_14e4#8&w9nPT>WKIr+it19!v0s~x-*ly+o>BajIIn`%<7v(%l(3)
z;k2{d*=~NT7I(Ih$JAzYHS?I9X7SX#62XYJ!2igGbv8dCre98R#Zkz9n|%^h>vlz!
zpO<X7kJYxzKQ5i}u?iu|<)Af#*hio+*^Cu!W&208JO_S>H-CS=rWm_-6_Sq-<l+c&
z5d=91#GUzQQG3NLso6cn{UnV;Td1x(`RGhdVU{j}WxtItCnOL_UFz19XWJj5rClKi
z($NBi9c=r?l^ShY+N+fsD9^@Lw!IJEQ%SI$Aoy1xaHgeYtOTrf{7G{p2xw?Qoq|A0
zXT$pxq1c!8P@C$i!hezsUpp;i|AFeN#NVB+xtOV`%L*1s_2|N^?@ZSWW(7;8N_Q8F
zW@xrj`;K%Mo2{_1jcyWgjnU_CalL;059E3wm(UQKIpmqnlUNO3+Ro}^ZtY@P-)F9!
z>|X2K?#Nu*c=J0g?}=deciNzLvp~jFP#wI{`ko(y=FL*DHF}(Kht#sps&&1Rnh;L8
zTdHEer&wvtEBa%neos^09$xs;S%=hu0na_WJzDlZ^zBd3A7}6nCY!H?U9j=w(g0r=
zX{-r_ll8SBU0|DO(~uYVH=$J(dHY@(@*H0pUBfP@(PuYnr7A;NjL|ih+0A=Xl?f!V
z{F-LkoD+fca>WYD5~r1Vi%5F9VkK`sr)2L*n{(uYsi#+f3$`TgZvf#<;x;AX<a}-6
z7g$o-RM<{_X7cG3QK7DGDr^UTOL_n+GeD13D3q$uxtp(Zl&|B;f8eqSL8l0CAGW(T
z4Re8C28HO$cM)iqb9_Z~0H+|pfIX;{TG{z#^}zGH7~lu^+-UCd1uM9C<6UoKUWGiz
z$RpJmT9qsb2;>;KrHc0BQ3H5I-g&LAg4vp6rIT2{AKMMQ7qbV>9}0{$|Cv2t9+A3_
zz~5CJP|o!16l0Jl_*GQ_BHRcBcRnOleF#6cY#5M-4Vc3Qkg=N}SHP2TPu0!li<Qro
zKq10(ODsRPY*vV)ir`cqP2JufGrDXzyOmSzk$QF@W(#jvi*xY~-)kFhpFx*CRD)E1
zj45xQewQe{HJQF=L$jpaQ9B`cb$uZERR7G*()K|2zq#38i+BTP`F$m>;+g$3`0Z_~
z7PB>fT<D>*MW2Q{Ro_^yMIVb^n!(P6+B>W16pPTW{ah=bd9owU(uMd{W;*C^?jvlw
zX_~300=cSB#<X~lacyDQuwB7?lg4dKuzibFv#yNg3|<OrGjVXLW*^_Kh?gSIUCRv8
zAeHq=X&3j=*?%^J^f&3YjYdfyw`|svzAVC9->lZdf)RZa8WYh&GbNEjGuX6XoKB}w
zv8Ikj4e|Rl)ANSz-c4#iCCe8xmD17)nnG-GYIX8VZ7yF}mM5}{Bd$f4+nQsOq3<d0
zgi9aTJ`ux-*LB;Z-M|(tPpW=eNx$Y+j`+9DpfdY@y4+q~mczy+dESvb{QL5pJS<;(
z?L=qv(E-gMPTp<4wpLod`^NrK`{$4IXRtVf8(F>=G#KwVP0Dxj?l;*ay9VaR&6&>Z
zDE<m~Sgs0e`>xNxXCOR$6;f>yJ;?rqzUyag!tEDa1!V2mHEeVqdb!<prowZ2cJ(0c
zV|>@u>gEa+kNd1*7yA$q!ISR<Zrfk)S3Ya5x>m%EPsb1f-q#()eVlDUh{Ks!T7D8_
zVYjsEk6kI&V*J?7{Ul}nT|)c2#Ge1G)pv>ioo1aJdW;&qi|w*yF=sa(;jjt8>>=~m
zAW9L@l031U8-2`ksNM09X$@@;w>9yDy;9Aqv+O<AO5ao)XPj|QS6c2Bc=r7!fbBL<
z*VmJSDC=A9ViO*c!rXAVQ1Hh%NGY&2W#-ZepsEzKjm~Lfq+V)6d;wwkpzg1Wjc4^<
znvHTBzkHI4cQMFNsmu-yQN)%WN4Xe$QmNb;8dBDM-tcLD;+eG1<x@`#U!Tsy-@X9@
z9^i&tW@N6X`Fg2icpCEmLP`ls35JYX!@|@-oIk3}`AkE~tDi{<!8Jq66{CN>|9HE#
zYxCT~ER|UmqkBgCOc+*8rh3k~N%??mxb*STPXwF3G}R+zQ&{99EHZmN(#2}+Z!UeY
zLiHipJ9?tCGxi8)^+ORaAfT>4r2NjF5X<WPgyzaWlL?kOq}i`KZPVg<mw45xWpgpn
zL(BYqW*JB^)==!yjLaTXs2J%vwNlt7P9CK!h11_^Bb9}GiJYB5XCebx#*#SE?q*a^
zvm(k%i1ZASv0vEF{rZ~2)k%`^HW43#^CP`%E}~Hu%A`<IXS;$D={;@ooQ*0P$t^${
zvj1q|{6_-YwTn<UZlP{K7L8h}Mb9-+t(>~!_M>EzWT%UEqh!TM_o-GwHhC}`!;HDD
zth<Sj97c$XCB%gj;+zO^V$L=gC6ba3u8<fv88;Dqlo<CCWuin9rL}>yw&OOI=(#(P
zd`uTtt&6*;i&NFXS?{I+#weUT%SIa4hwHteD~ZeN;qFFh2$8;vlH93)uniuPgLkn(
zH8u!Yc{b>%Ktd9^Iq11ycJh+i8`ab7WMiBsk(+_C!=q9aNpdva4@e$G&&{Fd$mqE|
z^qgD)N>~b^wG|Y~f;G)GL0yAgVr`K`2z5)LdIEG<7$LsCRo+7G4!*uv+VP%%Ei6oC
zcfcDeJTJX#hzjquinM$}x)Z=a4#MY~e_*~%at0~LLD2zF3k%DJj&w?M4o2_ei7sAC
zbwu3_*#Glds&)fn_t6gd2H303eD6W|KClF`1hB-Ck&_SZFM;K51`bG>0fG8(X?jjp
zf8hm=jyByH3!-iF7F=$F+sa|5IXVsqf;-}Nf8iG3G$g;j&Nlu~h&=6YQ}~YNbMOk=
zIFwkJgN6mOgZ{S{LB<FVVqpf#6py;52$!W17a{p9n`VsgBNk?%*jj8wFYqWDC7}!t
zBn3iO0p3H?KL>6_V^{?kJ$9KE;>_k%@V9m6{PsEHO)6_jyd&*v>+ZukqfM>b3EtkU
zZ3nm`3v-5bMhNji3Q^VVE`kc%tnDDJ&WcuNPOH<V)n(}*-WOmb6yUwI%YUH$J)m8_
z0NyOX2(u3$*st^u%7nppn{72h`XH<Ze}C{%_8NKRXoR$KN0?-TYUP;b&Aydkf;q8n
z2-*HYU|?`N0BFHIA^C~Mj1kFo`NRCD4$jr<_~ehDIwZe<PG~^X0)J`qQ0Dk<hSFzn
z3)Y)e<*mmpxP(xE4&_(`INt)CA&UlxwOH?0^a`hbBU3>Czxxg78{i+&E7HL-40xc_
zTa5GJs_eAPUf{9;{yDuO1B{gil-v>e*`Q>(_sjok^A6<fbwh~uH=qU@6oK<vc(=Kx
zhAqH(1N<}k`3x{z9x!)D?8^psm3x=RO^j1RyLQd~@gA#Q55L+RFr3sJaIe2X1c<lE
z^H(nb;!POiud&{FK?vI?SaK7?+-WGH36QbM^B4IK%<;kubC6*^02*M)kK!iGwHfAC
z40ChFCS(O62Fu8j+IS-UHC^q-KCMl-4JwzAIb~!6&XfZ}btI6STLeT=u;ee0o4}G~
zr?BLgw0I}Nd=p9?N+bRsDB(qD@gOb!IB0?<*Tqf5Yt!Sc=<(+CO~`WkzyAQBG`3os
za2wPpA#=;fhMZLgL=BWioU`hI2pE_b0oJuRVs}8tZGebDjMiL}s?a9X(q+=Y3=F7U
zYMH(Ln#`}Gen)m2%d|Be{QPcIUedj{+w57<AC++z2HH>e(8H<zyQib{?BmB|etFJZ
z&tjdmJbTb0Eht!UAAG-b3K1N)8}1r?=r(yGVK+Ws=C10`jcm0KSt7s*9nZ;G-VV+F
z2%5$FL{5u@x@Zh7)*$r6S7Vwkv^u#kH>+3XZYMA(O%`_LRK4dM(@0g1DhOS^u2<Z7
z%fdM>Ne^B;M-PjuLJkMw%pU_^)EGW-IOK3V&O8tJVsjPux{3Qd=Xi<~7P)W8CgMK#
zx#)1S@*xt!G>vAo0W1~VL*gd@mwhn&3d6_Un&eA~A9Qw~j{P)Bj{S6CwfAtygV#4V
zu7<6BYrTnEdvj&q%sp|>mOG_t7DD@U+w>vB6ET>IczO5A*Xy5t;|z9L__w^-zR-07
z#$GrYabkO;`5$fH`APB@)`wd2t^-#Z@zTD%Mp<7R@zPThwXY>69b3MsA62zln-aqT
zE#HtDQU5AkRZ)yj@7IPN?#pNuWxYuZf3`2Z^)l;?Bt^M<S}dcrnY!TAJ#C7zwlW`=
z{SQQA#HkA)bwL8OO>cc{DYg)Z`HD*zScu1b)wnURkac6=|K9Ucc3v0y4+gA-0C70r
zs<ZiKpIzkWit7Jds(B#(bDoF#H|?{1wRs-*o&%5NxhEqj$Dyb#|G}_z24IK>kO!F3
zjC;Sd&mz$P@)m$B0w9>H#U{L@`#bfw?+0K&|7X!?v3Az*C0K{bpDmVI{vb5+L8Fp{
zI#&(<4A7`N;XLPs1H~K-R_imBohU^E?E|{S(GHui2e8y)GW3}z=`-ItYprKs*Ynmg
z|0V}~^k+)F?M-o9?q18(Sn90Jo2*+-hmZjw1@^BNLR7%VF@C=7`m(6)LW-kjQh>vH
zjcv-ZXh$S9ab{sX0iGn78B7q&NHM#TK0(vBg1<jH{vQAU0RR6~nR__X@Bhc0<xE13
zLxh|q5^YYUQYMl@Q_d-e9Jh=)B&Uya5psxxD8~|Jqb8@xv5><wGjiVMuw~{quIu~9
z@48<1>-l)SUc2A-{l4GtYrA*d2kYg#xb`_lo8#Pm_{N=C@xaAJ>D>_L=)&U2RliPz
zF-UY0_A7yS7oh4Fx%Ih3Xw`0SQ|nXuy4_xf)+g|g)~DKmySR+6zjFDUU0XDl`1-?L
zA*j7&@{B~z25NSp4G^=-z8UrV__$EVo-P!`xxqcRAKS6#yvb0Q+m}S5n=sqln+*P0
z*Umk5C_<ac!UkZOV=qzmXVFk%hbl;x@b$9Xxx&TKuJCj;87-;EIGuu4(|i&TOD)h~
zyh}#&-~*m^;S@>DrgTleqzFDmhPV}7GnMKrOlpo*1P;Xt@v{PY=Ge=X{pF*DJT_x^
zfx;c!Pdjm^H=9}Mem+SN(uxcNE4p7Qb&A;~PLYu&hETDj%Zekcoba=(r0_d*Suq4R
z21iOpTjMukscruP7w;uf+hj=L=kOcm7@R;dRh|#1$^jRS6Us_3j$=6lyG=6|U=JTd
zE(Xm#w=w*!aCc68^&*Nh0vyme8|PfN8|&Z6<xK8WAjIXt>rAF4`Hvt=h>P3_A@3&9
zBjphQz&cV$D13G?!FXeZd4)fJe(aeEg+ISTQBWXSOu!SF-Pn#GUx<~W0HM6`0G_}m
zj64~7BTRWCLwO@bIRrCZfLCuqe1?!a`9Y9O$jKwP2ITKafb}Mb(gNiHHr-|k?6kns
zfRBW4F>t6b?U*%C@fn;WJ3V8*<W%$_*pfv|fnTi|teFTF0$}LLkWe(8{q%upFNlRK
z6x#!8A^@IeAbJRZK4$3;>~{j)WX&S7Xh*>Wyf?IG;-{3E&Oy$E%7iGLpk%sWt$cL>
zJY8@PTU~(XfK~jfbT`UP=G;ykfiI93YXuvy%BK0~0B(Sntt_xs!C0$D*hAp%g8!!s
z5H$xr@9pl%{-<kt2&%M`@_>0|fHlEA2CgB)Ez1{f?oPAushQ<TjW>Q%Zx(JoUqk&O
zOnRaLv`LFgV?Tnf?ilL%S}OE7KnOqoccuq=j0P2?K?P_`pq6BS>j<LeJt{gh4w#`H
z>k%jyvk*j)1koh8Vg~r_e2HibTrnGbi=1Q%)J=qEDHoqG2PXBZ^gbE7YI+E2G$r|B
zg7QIP59r@w=op#-1GGerAw~*Tnm)oYp$n%zr~}OI(Ns76#=3WyjW{#Zy=k!QPGPo4
z>22Ni)PE;&mm}R67%)Ac3|JpfHf_4wy$%f@KHrWK`G<*oOTFORATUj6i<CV#iAu{~
zjgUP@bFD2~{{oEPUsV~Ms_dO@zL~x4H|7DAK1VBVzG+ZtuX<#qW&<7{M@ww}l-LZH
z*u<3B@bE9+k{+u%ZD6lZX@A4E!q>LK&bGqMwjvMoBp*~c`q;MOq3zj+x8KoX|5XVr
zSA<KCf&FYj+nn3>g3A@dC0=@t=FE_5+n!kz9s{?V71|t`T>IGpmmZhOl!*`s=G}^-
zfvkA_-*62#gQ~NS?Yv)2W24{x(79Up=4zqY)xwyo`&fEXF)jOF-i`OtOAKn^)d80)
zqvX3v=d42Cr7mOJQkSnw|I9;G{vcHT2q}KQzvVsBi_4qMMxWg#Y+OH2Go}=0qYbJX
zRgbLn(x>Pao0Me@t@n*hl|N!jFR0g5{`h>e&@c9^bm@gD%h1o4Lk%v48e9%dqlqq3
z%Pw>?N&F|9RE`m<^uqY*(Dj+qp&xH7ySUmd2H7oMPVr?8RzC5wWw!K!W6H9N>igjK
zOQCX{hX&EF<Qxc<8iUD<!I)ln3>ITn7!Y>>hw%b(grazs;R4HW-eoxdG8;ujYm+-P
zMqrsuz}IY`kImIq;&+J_a;ikD$?V<|-?F*j@>d^QzI=6sO1^fpdzEJQjxqBB%Zj{5
zCNZ|xivC?%*rK235jqSS^P*nb3%_^bsy1T$QYM!5?!Cv2trJS#x*nnRy~}O`%Wi$k
zZrJ5TBA7m1{BzLn_KfNEiXR7_=dQg^qD?om-*KC7CHT*`V!nqaX@9gn|IymT<s7SZ
zX@Eq{^l`_)^Yzv)CO3F<EXmiH4nkH6Q&SFmxb?=`{p<_dgrZ+>Fc)5683MVNU7IGV
zN4_Y)N67K}i6|;AJ4d|m!l#Y5v#yrKO=EMSsjgjQOZO;~Ve0n9LLV$xMJjhvG?nIV
zqYr!ls`T74(~PTd@87bV*E^qI|6jV7#%P&j|D4bFh7zW(seCpeOilzv8GLrJ(br07
zhV|3@W`iONnq_8*n!Bh0XR|qV7I=J-j|=OZ`bl_vY%R;C7&E6y?GxU7$&a$L(f`PC
z1f7m-)N9&QLk@;OG=g143LSHA))3jhcR3t}>(JULD9M$<IgtV^FlbLwz=Gv`vphpH
z1yPO1#ZsFgBnKrFFUIk2(su`8l7kG%L5g$;W+JYBosJ37wO*S)gG!&AI|5#mREJ|k
z=eRIcip7;V(6}jPJP<SPgE<6_OYje3uF{IAoUZY{r0<{P58*x4N!WEo%+(6NVhS&0
z-V3*gYqyANg@`K?Bu<bvG^pVUb2wdUcu*<HnB^d?6K%h_!9q9IrtWeuE=D7mi;7O*
zF2PaQhc>oZmv%Q<w)RSzp`bftfO!w%J{dr;oEI`>uxB5X5I`(6AqW|eM7NSZ5CQ8m
zjwRfWB3S5vmK9zB{s?2!%@Xeaa;9u65LYJQ?XP`YgpMG;mYcE-p$K@OSh0pfN#6y8
zDFQMS0V&EMnCaqtdJUgv1bC2BnagnM2(F<-dJLcT8j8?P%i}CnqzqYUr%&VF5(=W>
z_QEu94!uH{T>OfzVl+$@%{agiKx#CwDI+_V?yYzr*@Ji|nhIj44PIw7W*zVoK-`%D
zp9uvPJ%(p#UPi-TB-1<|6HiGNY+w2Abv~<pGD69nFEfCZtO+fB!gqqA>4I(c(Z#WK
z!L4m|alQl1&tC<2Qa&)}rhWvzC^2mF(}Ctpnt=}PvWir*8MgTew)r9U5IDQwZOS+~
zb5vn(bAQtJHPb^-r-jMm)|C(9dl0N-*E!31?Ld_+J{-?}X}CGMqi{%@`Ez4jLroJV
z$!ef1Z1mSzj-V?%nkraJtyN;ECmvi=kwV009P}w1I9M>$pV7xlGB%nB#uh!{dNdp6
zO^F_XGLDB}+)ijqgiB;>l!~UdMZ+bsH|)swOi}8I@MdM4tU0QnH=H@M8Ph{hr}@hO
zIzYw0<JOdM7KDg7K7*YhiN~ukUmFtm`sFk=B1-C3dEk!7aTH?e(d_fJ_}zerfxYJT
ze+)nEcEnW525yJ>MPGcdKLy-l_!aNRrqVY#rT5^jb@ezd|AQG+#8d#TeQmcrVk(`P
zD@NUS2eqruZbUjFU2$R?3E^FP?CAUR%@gfueR%?|R{K%fwPpSX&4kb~Gs=ZCPaXby
zpXbf}ut@e9EG&aKY4*yS8&)Jc1`87=PIh*{!g_u*TAbcaxL+izM_J8a2Ks}7e@u)Y
zGcey6u&{|Ajo-YA7O-5D)w+Np*?P)q&&-d;Q(;B2q=Cj$=Lge<OpMJbtBK)7vcs@2
z4&r2H2W-b%WASd-Yj4ENs7b#KWwo-<d-5V>Rdt}TOlL4{#Kf4F84Na-T^LOJYGN$K
zyvQUh4EvUG65HtRRV15|=S|F~GA-~1Tks7wW7qUcawDs<DYFlH;1~TF#O{5{_Lsui
z?lt&;Ad>=6MRk;)0wLh7LAamv!(UaA^GgfEReX&*mP%Fo`&VJViV}Z-^FFDRcH8=8
z*;tNLO($LP8mze}()(yMMA6Q4gz1)w@2UqA-WHxRawGOwgr&WHYZP?+^Q21I2DIpG
z?qB1gY<k+_ThzP}&j!?nt9{<c6EtP7P_Sx`>;;NZEF7!zAB7f2ChtyGgcL{e?o3u7
z_f|(eqNK23tAWwH{xQ0KLGf+M=>4b*J@o(1fkfS+o(~LukuJDSG><$H@f^@qG;CGx
zJ$G|ea-(dbkt0gHV{kb=2*@|*ElID5E#};8G@D!0ptcBa2J=V#i19urafWKd1*(`^
zWTC&7pqs=Lb8k{^Zhj@|ae@Zt7RBf$(Zxb+==+`8&!S!LZ}JJ!6@uTy9ujX9Ylk+p
zQ~Nme5)1ldBsp^LU=~&mq@jAiDDCC!jg(Eop4(9NhV?JHT_R1{08PLKzvBBzKVIN!
zN3p&i)%z$a533zVTd0IJI-V-TzVwaC8_=$%dFr5LJfgbtU3qlTUx|*dVUXZA`K}Kr
z>b_B&*jng7Z5GWz2fd7)Zy$NrKAC(k-U9DP%b+@3REiQ4Omc0X&-h}7_8P8@FL8C>
zdL($UxW#t3R`=hzOK7g8apclC&;ErH*YKqSde;W>d_3K+whhgG=<gSx*S4=*rcFW8
zJ+>Qhb*qNv69GDV0^N+P7Td`~@<g+)8X{K>llD*7;X+n-!^4`V)|~PmW%s-85J45R
zfk3Cd-1figx7S>Eyp&R0_j4T3Vx>_jKLd=mzY@(I&|S;TxAw&=apbBBI-+Eq>(WeW
z%ZL6IqTXcd7v0~jUmmoDKCx&Bed5meVBL3ca&yU4_{&}>Tlly1OUZeBoYScyU!*_J
z`CsXnc_m~b7}HGyP|*p;`#yY<zC}8(A!pS!9}RsiPx^A(Wc@&n`}?%F;UnBf>-klq
zZJg-%3?v@`o?dbX?QJAg+y6=(ei8aDtglreufbm<<=_vb4_XiZlAA5JUXDB{l3QPR
zmJp#fKgBI!MEe8TGWSfY722JC1)L6!BL@zq4u897_!zL>q5%7{_?@vIsQsf5jIjd-
zE{fJK9qgKj1fxR^v4fcnS{Bs}7XgV_=XG2*=#&N56`+U_v1?lJK88(H>{`^H9gWAH
zT-ntTu|5xV)_JBiFe(q$9UGkfab(Jv7t3d<$m4~&^zbb@cp;oUCio@>P%knlCQABZ
zfKRu@0Ak9QM2rw?&zp3BU*kz4n*XJnK7cD#>HvN1cYJ#6wp6t*rGGamc;x-@rFXFZ
ze?<c=5B47a5a?|*G9<zba>=@S2!1ReC0{}(w~FTenDHtf#6?W!%meuk0EBcAuLl6>
zx&Z+n9Vp$C^e5*KGFZTFKFEv+HdRB!UZaWH_7%_BF`ng+RZ3ofMDFy7=Gzqwx%P?v
zW=am(#kNoM-!)qH4tqHJOz}TQwSe(2mkPxFoSWhdrPqI3?ii}zeHk9uxTM=&Ixj~+
zk}$|p@mA#G^F6V>LTUdisNip@ob;yl7vS!O{KfCS4D3Y*%Ji)P(MjJT<9GSp^=e>C
zH896Z<(pfDPH)VK7X)C6f-ps<KL#s}wvSK~oqDS*sHU0J(xjB8rs+5E$;s(>@WZP$
z<;uD*axk+aS<i;DucUmIZqWSg-}Bk0O<}5Z?fK*XCB{n&^{UEkq^3*PqGqO;0ZhZ2
zn=v&0LT&wF*pN`<jl7W`X(mOJnOVTf7dpmvmqAt6iF)_K?a8eLcH=WI>ek=!JB8a%
zf;Aj^2v@qYPdQ)-K7Jp6_GTulSe+@9sk$HZmTZ$Y=20Z|Yi6uz{oV7d7x~t9zM5C7
z-YAs|x`dCu3N=hc%-nDvpV1GSi7yUX(IVHh4gMCI76?J)|GGytYhK4=cEVMN@w=0+
z5=K8@@B4m2806n|Kd9-~&_)hk4sv36&uC^ZAPnr}@BfJe=9F_Huzr0K>s3ud=`A;C
zrJ9<si_JH+?Xa%TM#yekJoa13#@a8kG5-JA9B+FNku@REd)3X52)g=O@56x8?+koa
zPKx#KS9rS_m+CHMO^MtlCzlcPCs$WAwf<hYC|g-Ex>)(Qq@-d#w#bI>=>^rLzp=be
zpFS!AVoWX;RHW<HK488}TaSw%1EX=Ur?oIHy}^>ULjKmN-v2LixHXTaF-eOsV@dWf
z<2?7fS({d?<=7ywa#9oq(pU3YX@O#b#9jm3x_t-MIMP=jc6+u4N%s2r(onqyc{k4H
z^gFDV&FNV=>TbZGc(5Mn#~Wx6aX<iAQ^9HPWq9yul@Wij?cPM=RQyGN#_D7wUxZ-6
zWkX>Kr~iTT#HqrkU$cr%WeqV<&ya5y14pmf@U#wl{Hr1+YHi)tNZ6h95sWm*XD>=6
z9)la?tLL0Oh8|J#T#v{%+j?oEMwyU&feS`wBzW1%-GPvMGPMlf_FKzAAmk--7I#jr
ziCMojq@V$*z!YZkyN33SflsYS!oq@bt(G?I0jziB9)z3;12X+zauzr@7tXAXE+`jk
zY18Qa)=}1lAP-pY!5~@jriM@Hs}*!NwzxrqGpStOvi|;<a%#)<vO5`NcWle<2$$Z`
zQB97o0l&#m700WJC!2_?d25XsevhZ7K2eBtcR4nDQi6=q)w(_x&x)*zntUle+SRC|
zT@)Wm(%?_={!^mz@KOylQ<$Wv0l^%WZyu6mS4uQgq!xPfxHd2T(so<!^s8hEPg3a_
z$O%jeSCT{{zRMhwQV-SLo3Zw1ewayO+FbZ9B);n^@_eF1da}2s&qsR_UIXINl@bRf
z$&-%XMp`C9dBnB<V5;-@9FQC-xwfR^@{q6UkSvUKEVQ>08pB4sAg0}mS9U-uCFb%U
z*Y@nPj!(>WBiY#?TU%_qtm~m_V%nVeawNX|DpEf&7o`aqa;d<V-$gbh=W>xo%<!Hy
z&^%$1o(AN5(zuSqd#I$ib{XE&6#1VcQX?sslhn}qNQ=+;WdqVdt(qxy4r<a(4r<<=
z{qfPc?wdh^$agKao&CB{BTjAZxdr6h0uRz8IyXI5LO)jx3ggnQom*f<!iAxnd=Lc=
zBwL(g;M^x{JTD}sQ(YCx$x=JVS$kzpj1}p&^&r5kG4S@Ygmy97gMdqs6V4)XJGc3t
zPB`~wIr1vhVhAr~V1B`GvK-yW*RDZ$demXP>Y^}D`C53v^cbnn6q47gu6`KHSVFq8
z9C;LKzY-i|V6ul@9+1ymgK+j#Lwl=_!yM#mrS2K=p&ox6ec5=X_O(OkLJhCF_s^1-
zjrn4=;);;eu4*GvE74r6_B;OPEu>VUBPH2Ug|sXW+5ZeR3ocA{^d>EzfyiR2xs%50
z@aN1ikLsWTDv&{!O8mJy$mhx9EF>uiDPIX9ig`3EuI<5mu=yGg`>sc^&;fap({1GK
zM5v~C?E+?{fcap>Q^xH`PV$g`bw~l`Q5<w_$*Vl0<+`EzCs?DMGgBTk+8O&a+I7c{
z^RU)_n+uhJvNJbb;}143@ItsdR-m0L$D#LFY9scp++oh{GE&P5`H|@@k^Z)rmAj;;
z3i$0i$Rg1IAFW%Yry3A&*GdfZVl6cCc&!kAy9^)Cm%nlg2}~JxB>j_zfUY28!~%pB
zXQR8M&yy}QS0SJSFK`RVnrOJ0Y^X$fE<daD+vMcKag&jE!4bjr`a-R`zH%YoKEs9t
zu2M>*DTYGt9(znm$JZIU?OaZ4Ph#$tq;(@sc?NK-rXp8UliGFb4ATsRK5vYb-dGeT
zI;~myVhgXNeiE(H4N*KN=p%Q167$}W=Vrjy<r}a6RWmoT7Qde1GR_Sfdfb>3xGTCL
z-EgeR%JkxKP3`uGf|Vwu<rkzS)0ZGEWBaV_)o1lBk!mT1sW8pE{Vvr@HzeDuN)0);
z-a)p!p3PpDK2~s({lVFZX8rj{>$5Y>`f-ugjU|!R!71xpjD7bnZc@i6gdv12Wl4H$
z*-N#a5tncA>G6-B4K26(iME;r2lkqOk9Ahp8=GgO7$0+O%RR->QWsbEGBTiGH27JG
z*up!p>%VRfudPcH^-^!Br`=Fz`otU6B@<1b>mSPMIXY8Z{AABMo+3IGR)2tf{QRrs
zw-nL$(T0nk1<`Non3?oN^P$V>!cD`cIQ|!YM?5R}Q0^}s^sL0MgXhyu{cD-&h>1T%
zr@43J!kV&A<$4E&ycK$X>Uvt*Q#tgZm>6AHCM+GxE^{9uEO~(HZ4|Q0M8Rn`y4hv*
zEw@#yRElH@LxMtLdxv|CjV@%vyw8hG<k@hBJzul%o&|>dV#)+CM9?H1*CjKxf(Lyb
z?~<EZaZ6iUC<T7eLb*rWTjQSHPRk)04ETrZkKUz!{9N8rU0dFw{z*T)JcsykXk_|l
z#N*m(W-s3EomMWU%JnyVy%BhEy{hKEs0-NnHe-row<Z+|PKJV2)h}+>+&Yw&nys;h
z5z)SDgCz|k{qJfVuiX9H<yoHl`sFg`ZcIBBSeHA?y%W3F0h!(F80VpfvLNn7ZIw&g
zZH`OQLpc$$9j-!b8-AS;3DLV=o3lGsuB{@R8v}FgVo1a2-JMvp*<1h%RhnF;J(CfO
z?wkuyrAo6fE(=2ee6uPXNTImhdeFa-R8=T|Yolx~k_DMAfz*!K<=jLCO4Vs=<VV7W
zSF2OJT<_@bam@tpHsbfqF?;n;kdeTI&=H7jaO3xp`2DL$P~vVbAoA~Xef+)=e*YYP
zUje@#rwHtb6*|TW=$K<)O-F^C;sr)`a;s8VSO9aJi0lp=$EM*Q>Oz4q$<PQN;ETaM
zOGHbaAT`%eofYr_^;G8|I$2W~k<x{;J31k$rJ5cG9K*A3S37c<W4MDb+`brYCU9M%
z`|&Ztj!~!h8K3uubNwwlabBCvVst+i#1tPxFb2&&x6uI`50}Sp1Y&T*iD-5ago-MD
z!-*7bfx&r_!WWP$ZSoAQ6m<2`83}}BrUX2O;qHWuo5=$cySS^U^1^@<N{k{ggtjI9
zqBsKlqYcH4->9cXoMFf%q8G&g*YR;?aGlrTvi$hCyYRYXAudv<8Ggf=w96dAo3zUu
zVo#m{OhMP;H{z&!5R!rtkOPyj1RGbd{hkmg2`Kf1AA3PkF!O|0ass5-fG;`|`e5U4
zSPtO~)s_XY%n7(W_l*U9M<1{4Z7}{2lkfzS!1QLA1kOwFFJb^WMd0hMgl-eV$37o_
zE<XQ8Yxxrx>3?3PNLp|gXeeX0bc!YNnVg;+s~VtF4e&+{zyy&OWT6@ww*nDRN8=9a
zp|W40ala-D=`R3G`#_uT=oV}T!X2Qu7T*D1lg5Q;n3aU5_-%{xq<;^FlEyQ0;2y_l
zS55=e68^JdJA^92sTla%T=<F1bT;zMkRIrXjC42h&1*p39xKkw^v{Gciyo`9G#?`m
z6R9Im1_%(!+6nH7aQ=++7>n=jB{}JToPd`f(N0z_xX1d^?x+I|Ea4g{=`Wc@vqNwo
z)yo5asRPq6hbJKCJxl~K-SyP-VgPRZd@QEhnM6{+&)<b3W%T5PjvzUmn?!<;c$9#w
z7?lo%c^-LSOqWU}l|#5#SP3|s4CWUp?!k*LWRNU{55WPhm<ZlV1}l=T$^)+oNrGbs
z`jlpCu8%NfqUJj9?;5yACy1BzAh8pa#atOysue#YGZw)y2Y_{gPH(2O(%sK{&~+{8
z?rGF+DN?!u9>9HxE~?JBnn+dAU?j=tF*q=w2PE(<x~T90Mje=kQHi5^FmFW?qtZzA
z5G&@#XUAbG?vT_J@b-7$$ufFHY)6m`W+kaXNL5NeF-*nf@Py2;fr0o|<JWy{->R6x
z%M`P=Zx3_ePRD5ar;CX_(gl1k;ZoUPd-6k5;D9wlEfc{@DE{{&6v3+^23p8YE?&Oc
z1^)9EUtzY`TH(C&S7CKDFS7OZN|E3ZG=RBx{z7&nF+lbSZ%f3|Eqm#0$$u6V(<k?b
z)C?aZmR?9_0WK_jr-MSyEO`H-Hwse*C+KIr<#Z+9)4U%u^70W}#A4WhcNXosPO;<%
zts5Kkn_K?2)&18$YMuSmihZ`Mceb(>+dybE@A1~9X;{sUxl|GwU%_*-2HD7WA>>I*
zpmdKn?)1j=_rpRS{BzbI7kSc*5UfFaElf7L4(!e}JS%aACUd&Dj1U|RPs@dCWe#$Z
zTXYG9*!XL}+}_1AG#B||X-nW>)*zokaW{b?0}Bp*1N>6hE#$xWH*N~HITu#6+qni;
zEEXbA0wgGM?;5ZPZouLc8eEe|dGl&e=nRpsh8D~GhwvEHk=M-JJkr<<TuX?29q^cO
zxI&&b2PJ;^l_BCoL5r<BD#IPc^ulf^9aUnA2CY<>eCax>Cll?ab?cC>^h&VO6t!t?
zimv>Gl(Jom(}a{iQ9imjA<bWVZ@L0OP3M=QmV(t8ute&j2BSqZ;30D}GkBLCEOsD+
z0qrJhE0C1sQJB&FW{%c_oWNb&@im4s+YG`wmKi#2mn$q=-;JyaInd<XF0Vn|`k5R1
z&#v~L#9IbuB|=0~v(TyOoP_T~TC8=ygp(60dW3w*_91N~3n6LFP|imD?QuO^&)n;b
z@+<@o!S!h`T9I5EO|MpMxo3)IBiFv7t1BPy_Mmwc4}NDMWX&1pvJq=N&Ut(<>5ony
zIQ62r$hGZ+{zSNBNR>vJ)=N*@AGuGAT;DCgC0|fHWA2^lzmeM)gkZL*@`mZKD#CNE
zmkTJZmts4kVeB)2=6h#`-Zm(b-|nY^gR=XQd(QrT+YpO#c^Y3mlM@-AqHkDL6Zq+O
zPwoE!00960G*t&w6H6BkL5k9mBGQ8NE?pD}h>t2#rAm=%s7et~NGJlKN$;BAqa#YM
zQY9cg3Wzif#t0&!ga{-M$iMi`f6mOk-#0sVZrj~Kdht_uvsdWM<#3p0lSBmHRLA~Y
zMLaakCqK}dc%)ErD{uRjrLEm3U5xd++tqY#!*p(ybZ!iEZoI8-j)6Aqmn*93*Gif%
zuW_2iguX1u|8U#R&fn3I&D*=JqrP73kA|h)yrrWf{SSYKn2fpxx?PPpZ||3~^8QDF
zQk3@(bbKyq*fMW#H^0ac{YiK#_<hMtXJ7@>Tz+^vCGc4TB~VzS|7H1FNBBEx`}8uk
z{bng{UZ1qwJ+Rgx>gi}tuGX#ZukMbA?%qjwDNj49<$wiXv@9`NdM=A)Q^A6(AJ!S+
zyIuNjF+s8RXu){bn4nhK<#X0{njwyhGQfr}+4F|*iZ&}zSm0wLC&Av#R!uIl6bM%_
z6<i96KARA1y=@NalVzq#vmDznlPy?}bJhEgPOU;!$QEag&&JXS47B0_1miZkjk4tn
zq7@G!?6%Q#)OE=A6kl{GGuej`rvRKq7p;~MY_~lH>RV*#OC0C`k@@bzm%(Xke6H#p
z-~a7m;G0s^cg}xl7wwNE+wtM#rh=XIqvg|rZxLTY`aa0_Wnenu$eMxhWkxRC2p6u3
z3kLu`9^w{X^dn~S14f+ERPZug^p%8Q`|T}I-zS!1mN*)CwO^04tjtMtyM*t*i$TO8
zY1}+SVY_G}B$=HLCpHy)MK78u?YAXS7}7T+e=MIuJA?1{BP}-oCfWePAQF+Z^E||7
ze9^wl<eQ8*S-^xYS~}sk?e;TJ-z-aC+CT&ySqaF6feSaxg{$Pk0f3i>_{lCh0!a?y
z!zoS$zt)e|O8ad``~>M+mhVf(?8lNt01JBjBZuhB)ZcW(tNQpyFUg-diM<Ma_9eKz
zc(N-W?gjplesqI<v}nq2dSVRFe-6xk6IquR$AmwO$Lu>3kHqkYj?w+<{aZ}HyV~bA
zyq`dZH<0PLp&&d{D`g9mN2I?!!f{ss3i77vSqjjm;%R)~W5EQP)KqXk9XXiwxHO)|
zxY{2zh>+gK(NQC|h7N=W5Wd?uUTOr0c9of0#sEDBhGz|On2OHpgP^0UOuSS`tmvP3
z(F@xKAUN`%k$rF(Z9v^y&+0qUJ{62$XXriB4jAJ|&Jy+68JbBBKR3#uM!6#iWhEr{
z5{!^k<}A_Yy7l6E@W*4BG88Tdl>7Q|vLsFXF_lA#W^mAW4BCMfQ8^@O^rN)x9GVFM
z0j8keCGSetKSk_}Q>tG*MZ6iO_`Vyb6!OyKuTz!zXl8&FnAq<?RpzC!U}!t3qLRdN
z2%P7j@ku<{iVs?cH`1rx%_6JF!xgSm&!vgx>ehQg;OWDewPY1e=o&BdCjPBH_0pd^
z!c4@k3h>**nF(Yfgm~7DdL2nV%?A~Wagf%do=QVo63;^5Z{&})QfO>=gum!KuF;WF
zswI!u^!XONP)`+Zb<~CpS|r7yy|#0K<hchdRLLd`(9^5Zy{pyCRGwILyl%Y>C(%ZT
zXmg%;0`$3{fx{NbNVE@e7O*&vv1lQ~c%f|g>R!CBF_jgGj?=AIgTRx9u{C4?PUu+)
z_<SmwjSD(~_pRjER6wG=i7j$)J`DEZFgBa4%?UM%aaebch<p-}ydD-2$^IaDJsy~f
z6bk1K=?2{OpmCa>5+wy~AgsqxdkU%GY&XyjOP_8%%e&<8xWh)JyQ1?9--o(6=aR$U
zH@mUk=^y>c4|uxJ=;pPTHV)@nP=2_m%ylT~-v2npp>Xy4v7~M{!X)#TTYULpVf>R{
zZtZJ@29wGy6z`3pZq~KJMQU@28zX7Ll_c*4XP9iT6rJa-QL^vszWx432t(aOe%X(Z
z4>@jZV*TR;d%%%gmYes^3sX4nXv4#?1}=&Qq~9>c;bScIe6E|#j=vsU5lQWq>=(HP
ze>T=&CORJu>7OQi%%@(?a@)_rL3RZ7;0XtfK_Cj7RR42=RxH(!lVWZLS9?sA%EjgB
z)|cMf+m=FK?Wy(U2!69TRQkCkxdTb%%fh|Ut#`JZ48E_@UpY+W;~_cI4eNZMsja<_
zgM{vHdi_c=7cCIv3e_@P3tA|7Ev6FTDMGTP(S>TstOeaTY+NbBtYlbCern9<63i)j
zt%8`e8Ezunzc%{yVwBKw@;Adg9roO}Ry&vUMBbW-6pnrcN8R2U3h@kq5=OqmN7<GS
z#k3^$4T2^S(7YeI@^CjKIYt4F2DXUH!9~+>)%g85a*Qi6QbL3S^YuOuOQEiU7Eqd?
zg}pmnVjI9w$GY{l`_8+E26MlCcMk)BEmpgSjz{oY{i1Wf_v_wD?~=<zL=S*a3kt}$
zo$&s!6pl(sxFsxVAP35M?HH5`bq5kb=0FDs95NJoz2n$I9lC63(9WrM$=?|Bb?9=X
zEq6}op&&@AzS*%mGbQ21aoI_PrpJ(6Xbph_Oi6IvNk&q|0*mf>E?xY>*!C2P`9>8}
zT<6f&Mtpw~BC<c7lw!+agkL%4T<X}QBIs$yTL3jgm=<<Pp@2a#aSf7z?|0^3j?hfV
z{CxcO6U9CfLruwye5ARe{Asa;OSrSeR~)?;(3#fhEB>Ke^Iqm>7x|*szf2AVyLcy$
z-l%m5I~7}PE#6Cj<^8nUPw|*dI?NB)`-)J{vC%y?5|27E7p&zTc?A=X(DYj}-X-*^
z2d*3kFIHvPS`=4he7`l<%GGOGy=Y^(h{~yA(~|gYvU09h`u@<~)fB;;eTkq+8cO2B
ztfr4e@?2YW*Q=|6rJ5_q6<W7SH!XZ<@AxCz*inNZX@yqxFlhiyx9wX28)B0stFa!Z
z$3y8?v8Upsn^#k=4V+bpys+H*#gIpbD?!?N`#K0U%7Q8yI7=Vt0b9Cfa0XR0cve2r
z17sm|3WbT6K22xwX4NEMHc8NGTY?pJeJ~dk$*mk|4YoM5YSIQ9%Gh}GERX+JMfW}F
z#KbGGcQFpC@+gJtIs$3ZE#`tj*N1bPB2{@U81Z90_%Rb5ZKQM|kX!|q#Wa`2D=rIm
zE(;MJA`hR=Kg^M57%lFc<P=}+zRhz61s<@89JJw%GzD4I0w>)NN9Bm4ti@5>7f`A)
z_}co&I!>ak0%}|{u#=0|Vi;d*tHX<|-bt;NBF;fjP9>TvS%x|qMmlYPysi^&iJ5iS
zRu@}^ozuw(T)HQI29-28D-(GhWbu^&Q80jJ*!De12Zlj^LqcD0A^0vF2UudzEqH7q
z68aX8T?E4Z7msZshsqrbA))KM2owg*L|i{HswI;Yj(bv}9C$2KO27NC8#5OoZrH8y
zZvougiTt)y22RAF{PBg9erCL~A5cvjBEKW`A6^6(#*LNR!hd)+30dt;Y;6ZltBG{t
zvv`4r>Fd0-*AY&srYDBYw0=oyO|Sl{in=)wd0FP`M*Mi>Ll%_oDV?hc)g32p24~eG
zA2L{QtZwwK3NY)?$NFZS)Ol6loK8Z#FKC-pe^o#+a)fg`ofY-|q+|@((NzIn9r0M-
zKk>d7wr_w?r-71{>B>!GGE>zy%JDb0YcAQmE5}b3=!7yy`AA^{PMVYB>$5XyiV_%A
zdo<R<8N~;|f&urIV=Wh>_$0Alf@Az>i_=cM7{Rev=fz2#O;Pz{EpkzI5bO_0tRZ1B
zR;Ltjui~QJLL4tPx1SDZ4Dn%c(r$4k{uIM6I_kVWF_J?)8*X_K`G6Dqix;bp*VfZX
zJ~86O4&t?Kb(oOr%-mSmaA*>8-HZ72znb0T!`9-p^>wQ4b@)@(!Nl83tzSlLb@<cP
zt%<iGD0yR@4qmMA1yt#9=<?rIb~);Fq^>g(S6qoY5-27N$rxzM%#^9f=X%0>KrPf0
zPA}CH+E$|s21u%ruK#^B$_eYYwtGORk1VLn0TNxLE)cHgd1AB>F&dDZ#AtmkZ16BC
z8M*FDr2ZEfoDbW8r|9eS+xLJ{_(4SQ-^hAEY5bN%FvJyNOqG;Bwnmc86pnNLCV$MG
z)?a~Fjw7475(`bJ-kb=5lh*uVcU$}PWup5^w7`R8Wu`557N?zfF#<zzPubr>yJn5C
z$VKTxl)p<VUneBS_GDGVhK}OZfx`JM-5UaeVKV_zBxwa!$OSC2BscQ=?7cY&QRdMd
zALaU=iE+J+g}uy8{B(O4=740sJ#7#y5A6$DK#{@?LZ&}vFgztG`c0)J74dtM{{5R<
zl$EA(-P%8cJvASD&K2|1lRVzF0>9sGp07WwZ@e&5sZkn^uQR)E=Bo3!=Ta{J-#2wE
zO)cuaq%u2UxR)S_>^YTH7z^~Hh9Ftg^Ejsvw8O1WkW`Es<J`%);W~5jrb;T05hU|_
zB(e(s<P=`mvDR}vb5f3+LXRD5Q`a-2W(?Vd?Sx8$Q8TqD*h!cEP(5L~GzTXvv>=I;
zS=qZTI>8ww08uso+}ox_2`H_3w-yz~dALf|6cx6uc^gblG)FnYmSkAgycc`wO9~lC
z&90;nFIV=-39DH{ZDf@8lPK+sC;)Vo6%}?6z8Q>8s6|Bq7950c#XUVag-km;t~+P0
zyV8xy>&+T6bc)su>>Kd@f!BanIBqd_i`Ly8mQO<3dl6G-TCKP+^39R|@HQ~xd3*8s
z#y#9f`yKT_+xV&s)0I{$lTuAN{aM4xvZ{=6yWSAwLvOnV1#`iC{a)1<_IA7DWv+`a
zTodPB#6INpTdDz9R-P#=kaKdX(}UG=+d9=b?bL}8ZWZ^`0Vgu-)ZK8sHTD7=bxS!)
z<3a-?;X@6q{Ct+Z=Z>GLE8FM`hHU!|!Uu!V7iv-Au%#My!iVCX?i_ojogc0{=dZic
zmuUJ~&Kk1GtZQ^W{rE1#m3}-bW1uRdq#agX1$$m|+FVe>eAduBaH+-wfK9OS0?Ju`
zN~xwFaIHC2om_QymukNGFVzIn+aD?c>&sOcOMSpxXtgQ@4!4;#3=9S)Z~&XRU>kj@
z=8w0{FmWc$K=sb*stlpI*7xr;0|`jj5;^mk4;!pR<1uVLtIE-!$cHVeL}Ly%&spU-
zGyt0)z1d<Y^(Vu<L_>A9J{utFQ|FHm)6-XUCp;+2{Rs}7IuI9yiZXRsx}0~{xUQ~)
z9zKa>u#7We76zL@AiW9Jd2+p`xff=*DpDZksmQQX3>6XAmtJdGxv7P2eb&Xg!Jh`4
z`KX2~R%~gJX*s}a&38=H_vJap$hL4pS`IXeHL_Iwv(~Pb;=Bt^UG|53ZXvSPw=nvA
zXb7JlkdWV9)VlcPwu--d4)12YKExD$%m%KUTgO2xm!7voB+NOQ%sCEah1unV%^Uxy
zulUC|!`L@N@Bh-lH=}j>eBAVT?QlM2VD#vUgz+hd@uBO~RMzeQ<6N$O`WVPlHC08R
zvg&KbLLOp-rkh}Lhz(RY4$s&s2~yDb<lxsWaksn4eAc|8Dnm>Xi!KS`y=#LDox_l;
zh%a-~KgM;Io<bEs@i4xKvn|at_#nLbV8xIIQL2dB^=z)3<BB=hyK+|JG)A`CpS$KK
zXG9ugSU3Y8B#_ftZnE;SqO+VLpc7oi7a{K;(mFHD__A!FjF(^V|1kf>LRni_=e%xO
z!hFxAyUz~JxQ43OHE=kQ4$9hGMO%}0_5C*wAaO;~k&~M&Hg<vI&&|8qHcTk|Qjw*&
z5Zg`_u^*b;;iXW^x6)El5`Ho5M9cmWyfLe_5ZTb{b43<LKlu8Zc>%t$hiijvPSjQv
zDZY4Ek(zqPNoY*riI?INFHWOoGodYl^!&7u(3XSHmi6#^+w>3kyKnJ#tB2pSW8P28
zJ=w$bT%FWhnhhvFQKW$KUQ}Rf@}l9Rk7u)^Y_1=eH&x?!is3e12Z_=brXXeqTM+0y
zPvfyY--E!stfv8C**rMDouFjBo0MK{?cWcKKha=H>DaqF!mKw<`VzuTKj~Z4UKz;i
zP6#zUa?Og9<fAvM&H|e$FceIyHe#H>X1*ai)0_^MHwR_}0K%^DEZlvAHLkKnzA-Et
zK0hqo81`jgMpC0uozD|^@+Ph_ja|V7(iqmnSnvwdBY&#k6^}#rHTRA2xXKs66S2my
zaK?h53yondOa(!zjbXWfPq3Mmv-^e;bo&<q+89<CSNU48F|2xE<{8*5f?46yOJIRr
z;S*pQ!C3HFpRqvooWsFm9*1#D_YHY^Gl2=GUS;hlw|hH%1VYT<*kN<-{)d~N`JeVQ
zgueW2@#@3j>4x7-{=0Awfc;L{Ex+0X@06Z*qmCRuc(z-3c~d#ujxlT=SJgsi?Mr{$
zH_d4LjID7aAohK+>m`nhgSIgT^k9m58=aI^;|${|Q&Wy}oJcE?iv#ryTc(0MPiH*-
zwS*-YSS=l)EAuq3%S;I-nhIVs6$JlZzA+X2H(&Eqo+hTYm7{V-mj_N0li4zO-pbK7
zqbpGvgET!frjBI(1eDyC`195x8OtRj%}Ta>Q^AA%d`(-qz#4OyffdZa<nMTCDp;4V
z$&;r!SKInUUoHb1W%#&4U1wcDHs9yUx`2tP;AvCA|KymdU~Rr8cb?`<ZL5_vto$)9
z6I_|WZ7Rrch%Lt)lVlbUB9eP(qsm{<Y7OtXKCN+idF#|82kJM`W!}Rk+n;Z(o5EcG
zG?_P*S9$=SX`yvMDLHB6xqe$YeH3AT{mzFcd(+8zenx^8mMHbhmU_8@!ZIFKTi^BS
z|5Uv<d_GfZ$RtOtb*jv6vKH@0zxOIQFJN|FfQ4ne>2tiQHR~(@ddh@e@aK8n(bt}D
zD-)82F5lN>8NUy#7Iv4_i;etX_;$(F@(Hl>eq))CuZ!gq>9wzMl*r5|I+Yu0qS(o|
z{(m_?>2wa|l<3;oBFbaEwE>bx*{gok!0yMhVMn{CYWh*`FZ)r(1JdB_l<wqD*Fn13
zaTarbsnTk$#I}j<fV9fC31cLeiX}Z7GawCH%>|Jq<hRF8MXQ3)^;hc58CP=!$X;wG
z^e0&NA21qEAAN=%?Gek*ORupl%Nm`^sLK#*(F8`D4pf7;Yr9n@Z9%&EaTXu`Ql-^d
ziEWtfK()#?j4@K>#LdV+HEeYjL{^vIwqPbpgQ#aYBL7jjK~H-ehxj)R0Um(fr$Z~n
zS?ts4K8v%^8c<7(J5LT{)ODdpvkz1|$6+C>Y9KP}?`v<5Xy#X}-M$wM@?ZA(&LXU~
zdhIRi$HXVaIg}fsYih-m8$&&h&(#!Tz1Gw;NW}xuRrwSJ4_%fbY&RmMD*RgWx!Pi^
z$6AXz$#EdMAdM0*7TwN4TAYk-zvF7kIydR7Mp`VP1i0%ik5g?tj%6>><~%<)!XQ@Z
zbCXc-HMHLv8cecqnOrws3ym(q-dPJ}B{`^As-cG_*YB={#!`gjNnMy|rHg3)BIrV=
zcf7;ul*XX*@ypODIlANdE}vTvKuSeU^oPH46n1)!&3(5{(L=v|w=VF#a#)WoM#KPJ
z{TxgGomBsB{p=qKD5fuB;wTfUv*jK$5u=L>K{o_<VUwMIkz6`fpt%cB(%`XxCvDPQ
zS(?%BCt76>tG<T?9s1h+WMMu85A+SZo)<GX0C&ze#WsX1y!&{WZ=mf7!z+Jbv>5??
z2%$aAMg(QOO^G{CSx={iW>7=*j=Oj%*RJ((W-0%9l`bhMt?B>idin?Z5x$-Lro@Bs
zg=?Lv?eD_91F|dnMw1UNRP~KoHpnpg{YWc1xL_W`W$ETs*;iDf%=ja%SKy(v$_?y0
zeiCa;6Y9BglE8t-N7k5>Q+*gFGB;x%287UOof{~;xGi~}%nj<poQamDb30(#?k{Qn
zadoCrFIx7jTV0AW1K!L9Q)q&pIPSF1>b|pd@p*X2QBBSPu0<is<@ixS)IJlT-&er+
zfq>bA;)0*5SwEYhl4jNF^6@&AvWeB|ZjZxEZBlQ-?8b$^TNl`r<P$XIzvTHyKAWk3
z46ta^7Hjl>aN4Hi)=r*J{-sR^hHCW}7}+Vg7?JMOX#@K&QQr&kT5uTDg<_3*6)kIF
zZ#uX!Uf4dH|G`>gBrE4Db~ZnvwC$BBPPOk=^rlyLcFW}~XLv-AuCrs{;|8pq-J`-4
z!g~MGvUlN%U8yz$`ei-)bu&>1VVRfF?%`!U2LApDbLaWD8dyyH9a{Tc{S=q}ZQHGA
z+b#RQtZ&<O^4|pR>Ss=erhZ%UUnp*I^L^X^@!yi4S+cKbW5a6&HTnl8%q=n2w%vWV
z#8^7tSKy?UlsAd^-~?$Bulc#DXGe)~bo6#(3W*)>+iR7EQW_Bb|A?n!oox5o91T+}
zXq$SccQ+8i$on+`Hd%6Cf6#)jSqs?Ff(zshdk<)Iwarr%%~KaiEA{(HT0=T_)vyVg
zn^Et4ikJc)OeM4%D=*{KNGosDu!=rwT|j%8>YT}X;c2>-pTGdD2j*$A9jK3YKdIvl
zYSHeq+H&3gWcvyHh+5Pfi!S9L1x`jg|ImK$NX5<*H?q(H`?(A{)Rf=bdK~k*?@6nR
zo6*v%2Jyg;AG6yxH;tEf!z;G-HjQznbGU=sMhElvg<%m{bhYY?6~C{YF|L$_Y-Q8c
zwn}dOe$L^?QE_xNZ*O032{!~oWZpb{1ljt1->wm%9P(>_@9AOhWEXDYshRS9c<@Bm
zqsrIk3{0o{2`hvHlc~>X9c>R51S7A(56?b*xL@^(y_7|KGI;+X`4qL6QB?YKZ=7`w
z?XzAzzF*67Iy-WoVPpL^rVlCseS2Y#eg-??5cF0E0)>L2R%7Acet;xC(?5;m_>Or5
z;{Hu%kH0G8vQ=imeQDHW)!mQVn8!2xFD|<YW)eFs)G8HcfT40?3JiFh+4TdoF-_mH
zo+u_m+J!=tWZ5SqhwpF&un*<n8y&2L=FL)vS}QK4o2825wM3edJH%CcgtNb7D6tDQ
zC3ck0tfz}fUQxt}bqcc)a&S-65|*vhp3Q8gmVf5H2B#YJPF+vgs?q2X{_tf>=5a^)
z^!A?3y)TLd!R%Ba)5x^pQhMp@k!fw8gf8h@U!k+U@}C^EzVf{C0l4D9o8l3RGf*gO
zpOia;1yE*X^HHuQ6e@W{wJoVqaXoMGYe7onDK#(PeCYVR`kJj@_g$s*ccmM79Vtqk
z=w_v778{i$S%=H$5CAf5;BPl0q$K#?<{Y)m3<pXc`i>1_<I~WR{7@Dpc!3MG{sFON
z74Q3Ok??d<YW*=5oe&Um(<?XBvKetR?<YDT=P2}FFWOV3MW~VF;d-MNt%p2;UH<UU
zwQje^RzCkHx}$bC-gYw)(mcaZoUgP1s7X_P8F`no`mn*0e5LR8VRXQnuU$7!g;&?a
z?6)k5G#At><FSI)8{G|AUJU~khpDf2d%?NC<aIXs{+0e@?>-YVtg+E2=dx9YtvHmk
z=x(UG*?lFo>ETRFKJa)KSOZL*q(6N`QZ$%zKg!&2O}H49F+|W1mTJ&1>REew`Zj;l
zx9+R$w+jK4t~lrSqg%0kB}<gd)>gLf1KxGkH2e2^h=J1g;03-vT6gsk34n6fM+}{J
z4*I?jLhmub<{Qu@;1%$t<qPgws$!&OwAo03b-_YN8kNe2DR6cTkd;r`0I27LqOfz2
zen8i^RK<?U7oYZ06g#xrS8iq~%6im4`HSb9zG-3#mgg5jl8bP0fb^IUMk+>JYF~NZ
z^o<=;aAkTS#2!=ddJj+|1+Rg-;SSlwIiO1#y8Q?dk$>OfmFllWJAwVX`S&vc<(_{Z
z+dbY{ZT}x^8)rT=%DTglIXE<v$Yb~YoX$@=0Xv1>&7QdN;S8%pUeB*HHYA2y5B&mc
zANox;|CuYY-KcF^G_x3*VR0j|zFPI@yE!;q^qZ-W-J|}D(ug5Iyzi+<@!n3K;=cVx
zL}G`dPF&nG$H;I*A~QYRL_|O!S4UM<D$2|2M!R@<W3t4L<P{^swas~e7{%u?qwXYo
zGn-rpOA_9z$unkE#`MM=Bs{eBrSqJ195{E2@1o{7ctoKkR;5<KJ>W@Vq=R7-XMZqx
zv%`0e<-X@5%k=E!?vaX)@C>f@@FCR{T+vtwa<Xtn>H;=PlS|(~OAUF}YQb~HQ}nPj
zWt4SNsXzB@HU<30Skvy4_~N<nOfS#YKQ5|n*)fIbCc7@Gnnt+F#<vM`0wPmM-fSkm
zVd{bf=07Gw)Hm7YE>AFCo-q6?M=noPg%_}e6-?E({IvF6O#JA}^vs+8^2Dp~f@fg`
z!r=u5)DfWv&%R|{o)8OXtRC{o`o~whayo>urAWOTorRlDGa)5b>jh|EbunQYg@siP
zd}GxK=5oHN_WbP4EHz6*ZT)Gzrv?FC2|R)*j^wLcISb#TFDYd5lva)vYgwi#av&8s
zQvS*`#Y{eD5l&~3>IGDu$0O^`<6KC)bm9VP&f`%IW=|q@OO_~zZcf{hm2I!CSXix}
zVQofk!2m)#e$^;YY6e&PeWp}-;8kPO50^WhbFbfw++FNaam&7<HB#{)D1E9a^lX9F
zrP_R@C)O-1|M=}A3UZt}vr4qiRPx=lW?`yL%$<9q@ApNa?Ve)Wy)36r8$T{<Kdv|b
z0{{U3|7@3eIFxZ0_lF5(X=Go@*h^xvXCGuIOWAiqh$)i6ScbC8k~RC5oop$_l4k5%
zvPBJztwb|Mn5l_(^gPe|$9uikb<X#E&N;txpZV*a`?n`zS(P*YtMoAbY#YzCY!Zj2
z)Qoh6fkcIYP{j<vB$fAWhJ}Vi1;RIA7-Qn)`j}jl^VUtHkbkp+8eZ^kwoS6^f2U#|
z|K^{u&*q^!K{FmvnodzBVLL(VEmQAa_6K2?+Dmy}9`dE8Qr+&S0^jo`KY7JJ&K|ar
z<l4=nPv?iHmTAbhJAqwEEn%vHnlOg-1!}=fRj@BuwG<!&0gN-j<8z)eB|lU#;8+#3
zfHEY~vWha^D26agUMb`Lg>+6Y<7U2l9wkg)XB;-Dm-{Ql&Ur>oJlJq*@mlV$0mch^
z+E7%wKFZ*N%q?~Z8qMT`dm0TF;@%s`gu8)pPxIk!Iut7zb9Tr$n#m9M6bW~e+}lbd
z?L#S{Y4DaC)TyZAM9t<zO%S>y<N`!Ek$X?b`AH(T4B9UV`2v1H-1#OugchA_o5(GO
z(?!B9=9owF9*IImGf*|p)^&w4xr23y?rd-w@G6D}E(4?l%a{WpgZ;@qs~7-WMv{O#
zgSr8L{G>@^e=kqKF{9qlJ70|E4xvfQ?5{vX>&p;oW@pLeJoUG|IjSeG6sc4Q2J6|~
z_CDwCOq-WWXmS`zd}FD7^zgdk_L}Q>Yg(*Kt;YF5FZ>#-wWTHGyH1bjZHUijim8lw
zcc|gx{mi8a<Cucn_O4I~ZD+>x+^#g#{X(9aj9mBiDtV%1G%AZJwEd>QZmimi41NCf
z4h%H)l>F8|M5`?&sl}xa0f;=1(7|l(wMWF1uj{-O&%K#Nr+93LDcNX`h=d{8JzE{r
zGoG5nQ!-WKN*J<F%oWE~A>rTupx4khOi}XekjBJZdR&zgddvXliAczG!+A3Ab-9;{
zJI5vFen5`__GGPbo{4ZfL1*ipN-q<Y@SKeuJ8SQ$)^zo;u2yg5bErZPA&?nWNOSy}
zrv{npvAQ8o2n3)CIpLwS&H~Z7M~*1%LY`_Tlv+1DbQibr4l~y6sCJ7jZC^-W2))L<
z7lMYGsy#~_^1(fXs!bZ9XfHIE+P~*{9>C&}vNR<5D$QnE!<hzwiWwV{G{Oz0XIj0E
zOOz-((c<i3d}=?C<!};vReR4sS6ZO9CRzU!F`CKx_qg8%rgsm+FA45EO@Ey6T?J~(
z`S!B++w-d|vw8LX(t(^yx=pl}jRTgA<yH1{mG+po$&~WXx{($;e|pa{C_<8e1>6V7
ziR4GF`@#Z?DAC9@<HMrO-1S@g#(~wmqofJJv0M9nmG_UcUn-dtK(}uN{k2A(f3-}3
zeBd9HBLwXC)hMO3Y+E{b%=WmYe3;=MMCcyI$%xPK4=!HpaT_>hubhANOtZn)z`jD|
z_?54vpV(W!r%L92jeK`8zS};^9y3B+eDU9WRc_kEvN}z0me(7*)c<_WQ6FU4P~4S(
zzdX3DiwJf`+bkrLwqGSQ2RNboOvYX4HzD-`!Go3gedFUU^Z)YhyguRlKHPf>r`K^(
zeu5(#P=R2>Lz3hpNdhRGl7tgB!pZjU_y1pC`T;t*tb8(6eN2dY_WM1bmYzrh1ys*#
zDPKN%^2%P8&#r4A6nMa3#UvXgHA?9a++V<ryBK>P+ozNLl;uwRWcT~Ti3Gpj6q169
zW+cm0nhUq)Zg9ADl#|!Nf~R%7aERP+=G;m;mZbNh;b+g>vA$P)!*SgBHf*u=H-FyT
zN@>F}z2|{agWX@2qPdl5YEQ0y;k>23<F@l<(MxW%;ZC(84pg17a2mcId|+pA8kFD9
z&hfsKzMI$8#Jr#LtD_SkJMK{EhBcbl#wWF?jG!=vn^Hx0u`#0iISL~v)A5zK#REl5
zQ>W15o{5$p{+GJ3)WYi@^rnld!f#L>AZh&YD)AY!^fYdgx%EtL7!lZ<`*LusZNbc-
z0T#)M&IxNBtS@dHtatVeZ{8fJDOr#kL@-9Ex6y75TSCmWXPUiZQY&2`=7Y{fGth0)
zQ5a>Y%1lA9#226vP>TI7E8e(9->^n+Kg0qZVsTVCKb)qpTCoQBal_Rs=_v-<<H@-y
zRUeIQW$e$f>hJPAkfw>^j_#`$piZ(-oam36=#QlVQ44gavNPCe2DlDA)?8!8^BUhj
z0>aMr^V=hpgjZ7maFGLpTp6F$R35kp3+e&@woWSmK@R-^q<OFI5i_JcKJ>5g!cp`B
zp#HVSetvesAOO|U^#*3b2lt@I+5%zB{ruh0N*VnHBmiunzhGFuD@7N0O7~Vx0dRIn
z!pk!#2>`5a%iWX)ew!Y92MA;AFX)O^dfs0^2EYdU3r7AkLM5No2>@J9lCXIOr3`>I
z@wM<hr^gl|l@|I7fP_uyRVh&dmqx$CbpqFae%UGU!I=Qq0Y;P<4eVUMgQbYIhgGU=
zYASWM?LOMqr0zm}%P0PpxQ@(m2l90oX58W5I=NHw*=&psm6Y6{N23(3!%Wj2@z#4`
zU*vbrk2?VO=cPB#WroIp_Rn|~3xdDPa!sfq^Dp1qJlC)GZWP5L0|SmP!$EoqsJ=xb
z)jR4up7(#bX32~(RHPW5CWj0a14~BV{3A*`J-_+0{Nj-@*MW^qFZ+J;rwMbA{B<*?
z`0O<McTahbxo5@0&x&g<sb9FL{$b;rVP<G1XkXN;Sky&Nj=D54|FX}fVZYkQs9JvB
zW#Il@1n)#%N5$o~ipzfbX7u`IkCnqz&-E06em!RHDWW!Q<^NF}_Izn)n>NgBdKviZ
z@bw|bZrMPox(!eJ0w?_`_SCEECZUUQvFcA-s)utwr09B>x$Q{sg)_REwYcM<i>iRb
z^90!!GTX$-^N!e0TDc*Qqp8?LoP5R>st;bj#2czlmVME3?;oY2L<I5obdLpuqCn|=
zLy!vI?l7;B#c%my9ywFjc%PppJCKT}!I`tFWOF=vR(0fb=j~JS*)EC>yDWJyd9z2(
z9N%D8r24+KMh=p!^25`@+m<W%u~c%G!KxD?I>c?&X?^V8U^()X<O$LMR5B;rh8D{i
z9dZyIa)J6s-NcNlr$5buY4GC6kbN3#Dl)`a{mFN!!EK$q0L0mkrr?1`u~eMb$@_^$
zbxSMn+!BlbLK7Aehjr4ypP%mTE<H-04yW`id>g+(<|~r<zVI!@B7Q{RqImeX>z{xF
zcR>q&kKB4<)F7#t{TZxKQSRVOs1G=FlFd&Uva1vDk)d))-?#$=Hw7QQ&{*>O9lh}D
zVW_FgcZG<E%B9?@B_*r62(+!#T<^8HUi-QTt-6Rt%U%8PKi|s>BfG9tmq?F(uTBp9
z{lB#5N_F4OFDup5P;q7JuOQ~#M3Tl?!;6az_ewe98|^+of0xn^ygP)dEDD@uSO$_^
z!%H>(gGIW^v3D&d1s~3+8*pzhmzNi6*=EVvQrh1g2JOEienz}fQ>xax8SB5bsZ*(R
zo?M~*cdEQ_{jtBj<xsN_@*>e8h)_#rZ4Pv@T4$DNwE*w1?)ymG(`lfd|Miy4dP50J
z%nb_KJqFWB2nT4(%ZpxcV=s5Jy!l%E=6i#i@1g%w+nev(6XK8wamu>#j!F04Joxj~
z{G*2BY&&Q{VfTIQ%ZMBE?P;ui51%;Q6RDimGbpoQFTbEzmYSu_PwsrGXvyebX?jn@
z;+}}%KWo(HuYIb>_C#?;qCG8^-JUl<OJ0SeEc+eTO^+wjql@;esX}F`G-dx)x3bg^
z+WbIm{xyyzTZ#6Tf!(2)=|RS_)H!W_V{QIqZT`!VYd5;52Mx<o*|jBg{F4ShJyCRK
zoZztxJdtQelj6=LraAycK)SzXzgz>Fje-fHWB#bi*Tg#akccI^!SFU%VgSmH^y>2<
zgORZk5BN&;XIDgNxlX|I*ew2)xfg7ip9xL#cO;aSof>OJJ8K0y|Et$JYwZJWYX#gc
z3M>%cP&B=9BA>o2FVyMt`#YCMxNS<Ptx=%8VC-SN5AvGeh#A`DAkita#K168Sj_O~
ztwxJsU{}`qFF`S7C!@eF)69<+nI8@RSz~5llbG@)QROcZBcHU4G9eZSzD&_QHq1qd
zkrjxAnwXe!yr?pRqTD82@`tv29(FwMeF1OKFR#Iii{p7~OXGQxU;LY<yapYq9sc2q
zHPZCkso1xu52`k>Uz1O%IG>6QJ%bPclvMliY|#)xnGwbG8ldQ@Aes^ga_WdiqXapn
z)bGMY{j?x6BYNpIz|m8kv?nRiQS|+qvGjo@T9f3Iph<6)Ed;&tmfV8XF<mB!7K~%c
zBhk)5187)X`qA9?a7@u8TFJesMA8<N66B=tTlo!XYX?{2$9;0qkrI@f49V)}{ta*$
z?&s!PJz=LVd&-O`qwi&nhP2bV-0bJ3A?QxGz%INY2|wP`UBYl9lOcg`N$!S-7SJBX
z1ktj+*vXRs@xmo5>|vmYmTVH6aPOG}h{e=d{^yVP#CCAT?a2@tZWmnOUKJb361-~6
zOR@x_;;5gt5YJU(1ws`7QOik^rR`;ohQx9uj`d@5TaqCkrF)qj5&2`7Tw~l=L;}Pc
zH)fTL-hd*M*<G3vAq=>&Mzjs<9w!v>G|YA^uRXchmD{Dv2|@RU#F(2LC4`Ln3ZyX6
zAM0+*EI?(f!9fx4h8$hKc{D**^L{Y>kXbNt?`6wtp4~W+M3RlXdM)K#&W+o2<uzxH
z+mNrjV8(4~UuV_#kJz+4Z=Si;%UFoWo*U^CU3H-)K!P1cAvC01W{NQj#Tam0#YFNw
zhv)zi=9m!*9aWAjw|ZX`Avzut=T_J28*lZ-<u%i6`qfBn@Lef)c(41&@6m-Xr?_^t
z+(ELo`Jk*fr?%P3Ut%GqpxIN&rTz;->J8bxzMxrT{Re=o;%of&e0sCT`VV<xa5SQb
zi5!-Q=m8NAQV>1VmOy&5_xcY7;z2Z`hm&mcgdzz&=4`K`Fp6Ju*?Y1fsqRKT#kb<u
z_(k_vG|)=d_gLzrHs}R=k%_Qrv=U&C#Tw_rzSoQ-EllSS{REE{*iY=)Pxum|c7=N_
z*jB#jAVk<#YL+Ym&fxg-NqVLT5!RJ^V!eq8Fj`!}BZpDbbakbNho39kw#0{v3miY~
z^Pi*egI8Cs6JU27MqvPw5;KLLg~AUwPUR$d(f0C2!{T0N6}-bJwI##mrF(fD5p83b
zP6M0+A_3-xbD$1MK@m*sE9HqW8k|D|x|40M5sIkKRR%WlCn8mX0yf6qT6s@4rYm=L
z$!;koA__o6{}e=lma_}<>~N<H(Vvg32<@FnLZ}L@oFDF7>1(`_4~sW;Tqd(EJdQ~8
zQ+32G{p>;?G~PXK1ntA}$(?bbQ0Ce3KF`e+-^~@;eOTjo2<!f(enkA%CSF`L3Ar>8
z@~Qwo9ncH>jEEnb2r*h$jY!AeT~}oxhEQ*jh|3}?wHf#`>#B{zAs2{F(TIhJbwjDs
z4!6ikRR*4Rz1wj(#CW}%I_0(A%|eWGFV*WU$iUAJhX9FRtk+jA5b*$VNbN8?b%>&>
zcU+`*d`a+R@+l(iX73OKSwOFMNDwAUzl}K-aNfaxNdBw-YH`KGX(!5TxQ}6dWd*c(
z>E>OsKn(fl;&|V}J4*Q3&6VyLvhxU{8MNOsj%aohfYAGHhUb%=ClHY9D}J8GK$#Po
zypz?pp%q@c80hY%=Bt8}(k~Q-2m4^hfL=4<m91C=SY*XJU5WY*B1WVjO7wa`>G(F`
z6|><ZAn`92?RbM6nU{y(N+d_B%dCLd_y0B}l4%Sn(V#t`2_;$xdy{z<4Z6Mud_kfS
zjO;g}2wu=Uiw1?=D&|=+VxGMfnO;OGeN2p9U1xB*6=@)>xgJYl716w#u0(wi5p_~1
z>3Wf8)4{F6nkK^_Ao0EPH8UT+75kLg7RvP@;(L`GaGY)ABIj6|!KOYU5A3$7Z+SEZ
z=JZfF6iNA;Fc^8}6}ZJ+(`Ye`_OPP3dW<=YL+$UC@ZT1@-}T>pOzTqnt8e&MAH1z8
zdjL+YR^q1a1oM*9_{eF|6n#me#}f(<N1Z^0_M8XnRN6x|&6jIrnS`yO!d>OGWX9>W
zL#nsZ{(92@sKWLQ`E!<Pj+ia;9NUN33XA^+J@e7TmeAU%Swy67E>JjzGZ^JeJ9f;F
zYJ^?0u$ALp(&2-re=h@{|ImnH<j7r*V$8Zj6|~B>h8dmR5pQg8N#Bz@N4z@0CDoo^
zyi+#Ve)tdxA6f6*3fIE$XFM)Ff3;e<rf^<sL;g(m$EMOiy{=EZC8dFJv7`C3<{Abm
za}PI|hqC2VnhKF`0tfkQCfN?!e)IjXi%30a=p78RcJWZJZ*D1`Td<v4qQ>VnQ)EXE
z^{qF9VL}F>giH8jp%EY+?vhD-^<}U3CU{mXeMqcu+cBngQmlB}aprcB@%6d4>o2w)
zbHGcU;0Q;r2*;PTlb+K<p7TSVjcH@0X=BzAjzT*&f_UdLR5%^+C+B3h%_D3NZRk;w
z9Nw8T^r%i9@0?8y<J~RkA<av~p9*B8%b$YKBYR)$rNYex$M>jk7UIv2S(K^)qI<G?
zp&|6>1vOBg7_|ANK#QKMcj=FV0g|ry5Sxj_JnlH+3MEMq2oCFCJNw_mTH;q`1R|N#
zC^`F#v;LuU+piyxmmg5W8`@z0Cg>L~o6>-4XC#}4Y=R80tBIbBxJXK<3Dv~W%bP&+
zkhlPbz=7a;)tLTE-QVyAA67ETtLq0t?w9vT>cW^MJ{_Y1vI`emBI~N(nbvnB3yI-D
zL@IdsR>SPSR5_DEdVbhsE`5P&B@^*{`Algj{saqwP$l#ECJNz%$%tH)wC1!%h<Z{=
znJp2^1{X^=67gxm8{xogVycD2%3}L}f&qE(S~kqYh&;Gy9!UaflaE-U{vI+=ySrL4
zdej2~Tpn4(RH;~==UP|h^JK5C$PG5ww|xDMaVf^u+3r`hCmk?HSv8O!b+}ImTHhzd
zYPS@Bg<YLzo{;Fv<@D<XBq>-o+Iq|;Dd;7;PuNttry5GkFFGbg+%UlCmAQk@8Matd
zE;3uTSa4yy1TkKK|EVj+YdUEHkTkJ+XQ#rlC5^E!>drx{jQE$aL7uW)Q@GyVN7*H-
zEQ`7;6?ZH+YOYk6>gHD_r3i@yy-;#}p>T%Ilksl$N^Ul1)<^+BlFpMTP?%Zb`x2Tb
zo-@+$)mAH?7PEf2K*C%*qBTFIZin%=cRJ$$)5+I-9ZOax5@<@8^X^*$o@JJCl$LQ+
z`=1Ulj+S#~(Q#y9YD<TzVg$G~PTp8guT_=~S!mf|%*K3e%&lun8!WXRSgbI&Ub#|m
z$NY6)b?JRetxxwEN8=br_5PWcmAPVL>HX5u`?u&e&RS}b)_viV=^QuBn&P%H8Ly7;
zTVSD$rH)}Dql<T`w`EJQ*MoXgzh-<t)i8UJub>C5sMh(b_47}sEBnDqPh~g%bepSV
zY&)1d@3%8~jt6p&=FLiHwb(r_8z>RnG^=s4_sHyS9~2GoNj3aA!}t7im4f(NV?UGE
zPD=zewqSuH=|*x_aIPYyRuF@nkQ^vEZ+LMQB~0O!I6uZziiQ5wQU`wD;5C9wLBm4h
zK90$$^r)Q{yu(H$KN>q{uo4F{uQuCSZdmOWq!@O>WcBW?a0rM;dgQ6oJssiT5Wme@
z$nioehl4{}T~RH;MtfrQGqIbTZN5(j7n`*`kSrUlaXF`;HzrxODM`#W_poe!!dI}C
zJx%bAo#hkYiPPlHod4E;U9E4{K1J7$Z0JYU`k&hQkvryzvGYXL4r{1yV>E$6TiQXZ
z?MK%>&zL^XSUS&`v|>Bm)DdIpM^`oP4)vq+x0e*{u>OXJsd8j4pMQFv>JOI7Sp8Kw
z%KhWD=cyh>P4BC61O}*buvq#mYAc~^4U8(dy1rtnX0Ay+>OtE3V6=QNhX2&g2h%Z=
z6g!ion$0CfHHrpf7MEBSS5-Ebu2HgfRW@s1%M&LbvC0`EgDR~8C%NJB_DoA3vDgt`
zF;8nrpD|xCnfmO?2J6gLdqY2K$=Wu1!(m^sB0DJ+gT}899pNSh_7!Vy2)4BfV-E|J
z%>AUe+PRGFlj#~Ut@G|3^X^)HEw>u8bL=Ih)cV@7rB_V(IjSDUmZy+>Ja<&CiUi-$
z+dlj3^|)a2vr(f<*?-r9WB;fG-mAGU*iD(-X((&O)-xFCcmmCSOm#HaNniEy1d^rr
zuJR{jmiT{yN*sL3QRr&*tI>YImxS{tCY9a0!q_<?d5%T*)9Vq*jJT`FxU2usmbj}v
zELOBER)M}Xt+VEyUk|c{T&%drb*+;&*%B^RgNTC|QYvII_%LSn6O*>LMSJ#fjH$O(
z<z!uD=&ipeQ_RnyzE<d<?P6q=wOBesr8Q=m^c)<;iEqt8TVoJ0*E+81*$mLtopH}*
zx^pfo$Y6Ix%P2Jjc*34J`#|YcU6#FJ@@!q^Y+cO%v~{-5x7LcT)+*Sj@kN%s!dKE9
z)OYU5Y@JW7l}N3XPOTMpUrU#h?_AYvopEjUnOdt(!(C5_j@*y(aeWX4JpN2s&o#dH
z;q+WfW3xP1+h7m4N6PH9^J|4TC6|oUuc?MqP}KJz5l-kO<gs=X7X$70MHri^X(PMW
zUtGk>dKi~~HivC|*z;*F<*&G!rl?4DFFOH$lRCAf#hr~0Ull6r=LnzR&F}c}3YJRP
z%SkO^Yd!QZ)WS5i;JVfm7rfRZZqZz;g!S7_J$gZHzQn@+Z+e(|WX~2XRYDEVQjZp5
zv-IUh*HY8hFPIYHw?{>mGUKt8pl#D(9hjv+7&~#gpfDag8~W|Ept5i7pC9j=++fa6
zH22Sl_tlZQ?Qb!5hu=5fH`)H>Qddr`;+*W<p#4h~9HiM}$~*Y3M!m?so&0*6%4>wR
zO<3fYzM`q^QH1qE&eXQMM!hk)L3*RDYo6NMYU@g$+E&^Bw5-LL6M|nkXZY$(xQiL%
zeBhTM{u(+55YbM3)cZiNWNr;%ZMM}GMm_zOXczI__aK5ACcO`C?|-^0W4+b(yKrjz
z2f`Xmt@>&BL1+2DA?Bf5ZS*Q73e)5U<fJ#tBMm>-DQ}uYmDT4{w9gRp*9}5fgG&f{
zLL;$Ff1V5(hobF?c4`skd+Ad+i4u&CM)DSdt9jo}ZM_Zdt>JfV-_9e0lTU|AL_3e3
zCSQ{ub%Sr3e1#)D*uw>Uh4;<b^W#^ylX>rs=$KXwDgIp!t*IT?G4&6vk=QJInHB%S
zQoz@DLdP^%z?YHQk^?D#Ebk#+&k2i`ef?x@EFr&4RW^HLR{Q@dm%Xu6dyZgx&aJYJ
zOl?20&%N1L7)<xiZsUW#o(_^v<F2r;l<us3Qo>}T{qoH$LES9E5hE@8T`kv`M#1Ye
zOtkDZg4dDMN&_A8To<)M#X>ryf9xIB5?isjN<p<2qfEx%f6?1CwWXq#=4|8ZndAEV
zuB8tH5#>C;D`(6z^S?#MWu~~E`CbXt(p8Z#M{DF7=M?Ac$mJSuzI6=Tb_{sQQ@<5B
zqLynsAN2Na-k6xfR^V<zxaunQnb-8LEB%*e-qX9kn7b~GmoC4hR>TetHD;IP4i0N)
zy%SqrgoVGvI^TwYW|tjmt62{?)MIabko)%kgg?w(u{XcG^QQmub&9v0k+w*e^~&C#
z42Q>wRdR0MnI{)Nt+7eReXm=cbmaVOXG0efN5!VPRq0GKZm`YHK+~dFy0W<`^PM7K
zYN`qYU)#>bdnR>3r7d<U3~?c1t4=g<o4*NJE#G~NZHiw%n){g3blv~^_BT8y)|3su
zse|HY$BTnAWVuXF>1ARF5cj14-OaxD6N>7N{5ZTQzxUGw)h&*_ln@ef0WXwzL=eKp
zCLX23_;{1WPiYz*4%id0#;GU5%>=Rg8hecHh2q%fiAS^OaN50MX<U!!p0frzTxQR?
z_MCJ#Pd&RM<ko|pM=?L>&NbyKygLy8)<Y8p``eV!;`6PCHw?zoqXfn8#$ffe@oT^y
zkPcpCMM0KpcQayf;?F%LJTL$|w7nUT2zL?0E{Hh4Zs4g-Jo3avDD3q@QO(J4O+!=(
zXfM(PRU+hUOuZcak=cuU0oN47P8p#zFW^DwKP#67E)V+P{^rA@Oi`Mwc)YL%lnuP9
zg8;CDT@(7m>3wm)JQBbZ0bm8YiXCfQhyo|{HDfbm#nm+tC0p_MALOrpu4^Jz6f`MN
z+LL|;5(6^@NPd>pa&HxUodA+2fB+;0>s8=65)`0e-Xr2^!bgJAYnTJUXZsntqCuJc
z3}gTp-Os?g3QIupkp$^A41nM>{S0<UkoamW4apULbCl;G5OEzc#PDN-<ZAm2^jK;r
z-e6q^kq&ZO*I5^_94yZ`C3&JyG$MhM9RGx(13eZ}6ZTBuBgdyubW%_AGA6P<8(Cjt
zSkrwSJfdHjqAPNekP%gx5p`x*vsD;uG#pP$Ec<;y!sBCp&=v2=GL@k7Psf#Kvz6lw
zaqkfcAP?O8f4dS-Nq)}_ipa|*JrLHom;m}e00030|5SH(INRO(zfx3fYE_A?YBgpl
ziCtT(HL67IT2)FbMo_J-F>1tq)T~uoiPhR-D@BVZR;>~-5>4ax*3b9(<9A)>zF*_q
z@B5s*lXG1svq*iOY%xeqEc0wnG!^b&8LY4fjup~#=O&KzfK|e2;xEf0ToQnMHVhGA
z1=01~Srmt9CQS9*k;5ft5%dKhle!`AL?A=agzI9EA(k*BhUuO=VBEbd!gT@2kRi!Q
zhzw>qvsPblF%GIb0GnAtW>V9T4s{2$o^^6Il%QRz5CtlbbpEa!C*wJ*ia^pVzpv`*
zXW0i+gd`xEhQBq$BOSOv@9jbuS_s@3@yN8E{!<pva8Lh`TU&xI`#JN#Iz<qyC2_tw
zA=g+y8>}_l;(hMel}y4dlfQ-#1jYv1(+*K%2l>RzvQsJIaK<5MF$jMQvY9Pkqeq+q
zM;Ar-5;2oVDV@sJvt0Vs{&qKsaevnI(v_sJ-HY<P@4|LpYk+Sb$Flv_0qwB!{MLzV
zkKit=HFMr!S3Hgl4=v>QE%F&c_t8x58^};U!3T9kwhvNF{$>zy^VCTkWza%!66fhp
z58ElyxOe+#Fy+)4w3UiFb=Gb#=PrBcEsn3=b#C{(&GW)r{LxGAQkEl$u)Aj!5*5`i
zGbttfFPDx>sJ=0cxT4ydrd4W)y?=H+(@@>TD|1}+6XJm}-5=(xt=xhcwvz9sAO()s
zx6|I-wxEA`<I>Bm{LjVMM6*|ti`TpVjF&{4qwi7v{%0g<qe)cCrA2<g$2Hu>?JjFK
zgSFP!vgjd0`|G?5Mn8F~MGuWPZ^?%isiqdI${!`TL~&PqRZab>dcPt-tSq3!qN+aT
zRLV~0rV$q_W>WWJy+3RBf3gmU^fI^KS6DGG-u*jDXU-qe?)y~#pldr3U!>+W%eyf_
ztH}I;YU5tOvRY=-$cp=dn!0y3?Nk$dbgPS4r~0g;Y$Kc5r3J6c^DCsqQqJC162&}g
zxE}8*ia%;hA^KN2Ltv6bW71mwoFpqWH7zDT*06`o-{e64ktmjOlSn`5KMs5a+)I_A
z=-uNp$~jG^h^ojw%AJDRaMdSL1x#1zEBO>Se*#zl*lx6my_z2BHLs-U4C(_pyvnC5
zcW-<%pWHDY-}%2hvtwR0S6nbxY&s&7nq?=Z7RK}B1!{ap&Q7&6!EhtPVUy&C<IPxT
zY_j$6{xp5n?q8dyQ}dV08#%h4c)yvRznnc|SukUn^mkY{Hfec!Qv(zCJ?&}A6+24m
zR7I-(RZLSf_e{5PM@QIrdOkjFi7G+<g;J#F;h`_1F=)00aEhC&j!=;5wau0J>CKgE
zU`sR5?7^XLRUV}J&E|^D_MtD|J^Rv9<Tmh3E?`bg^#=r<wwMBCbAT(lbp)B}KYF{l
z5+$(Konh3$WWXQz$@%@e=v}`-z0(3EtsC?D<xhl*3KMhUl(rr;u$oWkx!sr-xj!M6
z%&nveF!KqqOvqEVseY52q2EPHklBX|H~P}=B@A8<^-CSRb0fs()Gpio?9)<A*bn97
zhLc3&;H80vI~jHzwZ-it=6u<a2Eo}b^9x=^!P($l?~;aQ)a0V8=lnwD)S|0?aCWY{
zk7rWrx}@xa)}$f~J|`34-F8ry>))<!GH+y(v1vXj-v3hnDK3n8?c`Vm&-+DKn*Ayb
z`Sf<Zl9@q`l4kSv$$UcMqNlto5ta=u2gC>&_K46tDcpHvkhtXMK~hpw9A$S3@F1n%
zUujlVM9`Px9(j6v*UZN-WhU(u&<&o$G63p=a~IfC_^Rm!O$|aznU8XfL)~s15gjW_
zI#SE`rl((09_3nYwZ)vu0F}k!B5jASoip;1b|%?V?1HrFh9QD;()ad`QAs;5jP;Lc
zxLOST+|VE`I$P0N`9%n8i{ZTL%I<q+4-har@!I(uaIc;7few*$gOH8a&Yd|)J6saM
zP+%gSZV=I~v}oqJ@~1@!B7j)A@LS~H@EnnAEUB+krg`?ly;Gju4ch5eP)~hCt=i$4
zD|GFhdMfjLkQk^ZZ;-a!?Lc!26*4|APb~O_3Sj|k|6^mwwW3MF<28MK!!MC(@6Fwt
zA~}MD)vqn;GeZqyF9EQjJo)8_ck|zUy`Yxu#KUJq0LK7L(rX1Tnd#8?Sm(wNP>0X{
z7zf=_OXYtWDyE*3XTS_CVV?l!#=PCs@i!JPbW&yIn~MFJsm{umQHK02Qn>O~=kR&b
z!E$68yWk)dv!$sa{2P;{=_G9c8{33|p^ms9YwoI!zqxo}YEq1;D*J>4D#kRn;n`)j
z35nzw)9xX{J8Pc&S7|tjS~*BD@ccygkc65wQJ1vV`Hg*ER_>oaLhM)hDoKt;PfCk7
z^2xvHb{mYJlzP+cDu^{qy&E^ZuXWqo<Vk6O)@?>$O8%c*M)TV5;Rm+*alJI}Hi{j+
z8Ly9}I*w^;-8Q4!RTF8z=ZueTzkb2bHV?PbY7+?EePyQA)<w6g<)QURtZ(b}iwO34
z>fCV|4Xw7vCQrCxPjvwS*!RR6;#L2#o2J_>G=0LgOShY%6FMmVkDZ@LgQVtAq#0jL
zlnAq009tH~)jPRg@wA{iLaiE}|3C$7JZo>aa$4cpO5VCUZEyGdtG!)D{<i>-udSP}
ztr<r@8`v^_MKyk<m9sy9r9YtJ)>9Td@6Fg2&D5B4=msE&&6i4yRe91_XfhV_yJ7&{
zIWNCgBZnv7keB7FCwmN|mDgwy@+RxvGv6kh{*++Q%HF6GSC1GUnS}9wc1pS>2A3Kj
zuFvj6U7xY@%eQQXV3tjjBHkda_oA*?@5dbFF-SF;hMx=!?nR_735$2qnj(<7q`Vgg
z!ON>Bw(@H+XYBH8zoR-s+K6Fu1(;0#NI9q1G%l=XEYMw$B_m3<_-m4zeud!A12>x5
zD4|I@MtD@GKk@f{Z5u6DXC`9R_cd7|z5t@UWz|11{^M(7+|qVrjFoc+)XChAoG>!6
zCX4+?K=(DR5-W4Gh>+^X*g&1QfrAfkmG8z5aHqv2n8g2uL>*_0xlUh^j<c5xt4os5
zkid6HB<$(cg-FMQ?<Wdk?R)MCANP0!^R|x3OJWUoipTlWv?4QJVg%yH<qZFEAuS9J
zF^oubW~8PODW%vGEo9jf?*TDUXRKhKJgnnn4#aaQc42;cQ}^Py_mgCvxXE8<QpF7z
zE%(Li4{Th`ZCvmEmo05vs~Ru`4H(m6mt@0XArgfCx^(<q8_uc*siFp{G6h^w^U0Y~
zvARs!am!tsa%@3EzqjG=jkNXlv)r{B!<8T0@-o?^J};^IO1&@}*Twqft@mSFX`=eh
z4@bm@<c6<amw}Qi_2369V^?DW2Bd<M<i13rW3CAfCNLcc`5B^gaeh<0WiILWWt9`9
zJq=IamEfv+^(|nJy&k|GW9radnGfI*wR6MtLVgBj!)q|#teUB~sm#5aTObanuW?h~
zp7gq7{CatkjcRTsj?`fj228#^*Y+PanUGf2Y5soghu`+kbl$>8PiN!gv2?69c^{+G
z#hstPwW2t0p%o&f{?Ucd{^B8TeG_#oJX_8@W*=oAz=nQqn<Qna!M0({u30y8#FJ<{
z{ut~nWW@V0TYbY@QyKB|Ss!RT9$aCN((HH)yF4Z>tQFLazLNV$Z-5J9^l(&K_$M_!
z#!cX(8r1^2udE54m<Ytfr}(R>^XrOAzm<G+V4JS+P^=;Btt9;Z%8)78vOf)d&FWyQ
zC4~!cJ#FcPw;VjOXERroYQTfuFsBrtkw`N<(crv^ceb(?B;yy4?E-pzd&YY)W<X#q
zVk4cEsFgwsY(h<P?cSsi(rq&`h;tQJ2`nkrIO6HmFye{v16oci)zr>4!-exw^S?cZ
zU<2Rw;%q<MYKpJ5xi(gND{l%L$kc<&vAA|P9(+;lkYAIz{Z5zm9xG`)_%-6EIwgM)
za$wK66>Il$@66kvIo!CF+IjK~m8JYZia-4jGx~8>vqED3?etOV-bYz^5gUip_cz{-
zykWH*r8bGl_(^ZmTy}X&`opV_x)$S~bS-WT47}Q?U>%FT^6+PfVqr{zRB=nmH{P;#
z^d+5iA(*p-Sk&f#`D<Y#R=$UE8qN~fI4RxY_Z&yDQo1U2S4<M6czdjY89!%<55h+G
zVx)Adl8d>)vNV`@IA%D`Aqx(6g&E7A>ra_n8JPIrH)TgL@uhNSHVI!b@$z_V7TotS
z?E8>fT;`q4a?^KtTRQ(g%$2H&ifpk#?&q@2(44Xs7m>oCP=v9ggs!z=gk<_bi%y)w
zJcm)OWcp;a^<~@Icf%a-Mf0D4tP)(U5=;YnNsg5-dY=GeH*R7%Zo<+kL2w=1rPk*J
z(_omwIAy{UT=}UmPPP~)QM@&1y%wXUlm@>5wv<P@tk-72rEVe{<z!7TMpXDoe*7!P
zOjlSIDr4ramRWZZ!OKA~!#DAA<(S!cpq$4QrYA2;g&DR+Wr(i3M8F>+;SONn1q@?`
zJ^pGgyk81j1+>1F3IC+AuE7evd(<VTv=!lksiRE?m-Acqxo$>q+{+8kpj}>5U)Jrp
z$%s~?lC6n2*LGbiBKx;M%f1Y1qZG0?XgtoDDHW1x+1GNJ<5D0s1*}^#PTC%pFeTY@
z8Ld@WU=_ph_>Fb<gq>_*p$KduI#5>(23D-Ra>XgYx_rQ)xR6PbL$LBeLsXjK#dbE0
znpHSl7i=617d<{OoFA5q$guK*!(9f^b<Fr74BGDoUdyr46^24t&0r*{@I#jCvMhM6
za3VcFzPab-2#MO2{K}O~c{8lL7aive>y3tUxWYu!fOlXiU-KDL@nqd19L^z$=ZYo9
zcae1WDtF0eC4A*$^RU(WCa$B03-QlpjtjRdcSU3Wh=O)x!N(cK8nS{kTj69j+QSTg
zjW9aOQ=^%1vaBOn_Ayx&No=cPPwCYkA=zU{_F2TvaAKz|=1dxOwh&G1L=ig~@#c;N
zu4ErzjF6VPNK2OMXM*cz7uL^kZxJE~XI&FxVT7L>&{H6u9pXW=6J{2%=nu>X9}>_X
zH2KA8JXS4u;1-GK8v->Ry0F9~E2`D6YO9Me4OEH;9tr3yJs4w>)pNlbnPjUIO;~QS
zl^Nqt4&Y3TS3K9Ksiq1Fxb*XD)rCJUh2%PqbPwa!habROQm1lm6Bz-Vp*(dzhpVMd
z<6e_5D;P<$^1VOPtSNIX?<>kKzWN?0_nMaan(0#iz{z~XJaJ?~N)a2T`E;Uxne$JD
zp!Y=oIA<v1r#oCuDx?Zc#C@u18|^)=uN2MY-B0gpx0x_L%f2epTrTmWqy%Z{S!d~4
z;t`O>UD0Th+Gum%vr+6xV~IsYV+>sS7O6rvI;`=ryH$L~i^jvrYEG$L4;AJ!7<+VB
z%^ZNK01kfX<i14;9(h4HX(e^pn>{CN%x#N{%qT-IF`dCOfQkhGOTTo^Ztm{|0F^(2
zfJz7{m=CaD@{`+noSnOk_*omZ<D~otg$v&%NTox97BzO)0tD)&yZt&;Z~mzIGWA0>
zsPz$TNn3#J)Q{H5*{#!y8LiiBx6D=S?Jmg#sI*Lf?Jkx9yqV<#PKPl1SHq94*e<>T
z1Z_sM|1<cxF}i%vbV<f%A#!*@t_3X}NpFXMFL2r}CW8pK!|HSPa;N<|6x|Ucx2;D{
znBL*rQ*B0@Z9>{)HiG+YMo-=XNIOJa^i9W8zhaOI!L9vBqNIm~xL>D=-^ChfAM8gh
z|I0Y|h4)povNN+!nL1i9Fi_h~1tI+K?UH^=i177(ACVy(?<R!4@AxA({-YYp(<=i7
z+he@cbsB>RG@$~!tCf&(K8l9HI3+=)bS<x(bwA9REG|N1$r|?7-K*`|6t`@@LW$H;
zrcA#=6JS*WGHMu{n4960MN``Mq~qF@)D=a&m9@-ut;C65Y4;A5@>-Q5;`-@+y^54T
z7M`;36HG%Pnp)@iEM?)F!v;=>N(c1@fwNqNED5#*NY2WmpVyWs{X*zH-})F}9&H7s
zrnfE@6;~^}mv5Wc{3qKNi_&y{43z@#zClS)-*-PPT}d#Os-~eK4g2x11W&WY{6V_t
zL({tt^I9J~hRZ)xnOb-YS~Lcfe9%FCVAD0%pXSPC-z<DC1oJm#gGvwPIi@(r8L&x+
zWmP{FnKL)8JJfU1AH=)GxwGq6gY>;7t1UvdS5Kw0MMbqs44BlU!+NH2+*7C=lH60&
z!NbhA<`%Nv?Wc_Fyp=bpGZ4gTn=<v3GpnfFolAC~r<D-v=u2ix$=ttshgPD5jT0Oo
z01lw|FFytcj5}^oIBqRpxqnBZ<n8A_w?Ct6-e;Z!OwZoDJ*kL!8_0-P$MG)J)BjSJ
zXgMibHVj{0tf#9^y<%HhKs{@4xjNP4S?=9ux%z)c<*V%?>RGyrvx5>XGMbm)%0~G!
z8axXG7iC}hzQ?6KY1ADc+#L{EZl`R=Fu_>z;zyvztclrfYxi_@wx`FeovQ82{BpaO
zdGi6x&P-k`R7dFQ+hg0U+i<&=nX>`SquW6&`}`E>=o9n`C@gTk`*is|Ehyx0oED_M
zy!<|T1>PT%#};e`+EM2T9-HPl;sjf!?hUR6dmN}ogqTSZVLBaLNqf4{>FvwobzC5u
z<H`TgjP3Ed=Ay-g=pdhx#oKA8mSD^Kdn41qo?Gn^K|Yd45S?};tp9LgI};MbH+84R
z>GWrSF{u6RrjvdDVOrVm(@LjP)fw;}EsE|VyKN7xpbO>JMK17NS4t!CTRsKk0-9H9
zG+Xg%RD$dbtHw9)y1j}>qN8b*>lPr!G9Iw@3vl)qJn;2mb85UrQ+tcX-IsyVm!U4s
z=_VLd*$cLgclyZL|5*BMx6QRkpkkpHtW(I36@Dwo<jX*Bel28NQBA~mS#$Q11e1}n
z{P}u%U9HX+tBn3ajgj8ZfWb@F841twS`x0rze+yV?biQvom+y7+8--7*>s&-^hYnZ
z`Db#NPx^zSKZwHZKcyB04vv&kjC#~UYs_)0#ogDLk!tgNYipK7aDrSs1&}YltCM2T
zqrNd<=J@X6MIb*|7VZE1*guIM>7${WKsUIu$ygRsJGmn5qXDOC>_<`~K}P&gPBny7
zFv)rs=hVH@uWE%|Sv3sFN$R>~9gAd_#Q8p>lsC=kN|?&6PLz)1e!mzl*OcIx5JEMS
zdB}UW@6vf^uCrF$iwI-}B}kT<$wvdF$r)jmM5!G0u74_L)w)&I<dSp75-OKNy&EHT
z=(rU86-J!9nEI5Xo~|h`XI-*RycArXm(#cYbC3rtp>KjO-&##lNG$zuzo^8!^uytN
zP|ua|!z+`A=XvJvO4X)B!KTEhl#<0Q;)AwSvouqPg{lglm1(02QDJj+N(<vS<;<Dw
zI_x-gJ>KNKloDgzHw915?2`I#3ImQ)IS;*pp7Ddeh-b)a;RxJnpK>JBAbm44K4Nf^
z@jd~yij(hNajWYeo92hIt079JR@~^2`7S4fhm+?F`A=R@y%)dilF12!Ae`j2iL3YK
zhi0oGlmM|$n6pIYSE(bE0!dz_{j|ixU<S~gs6znw?+leLIeGOb1LC6EAAU`<&O2RG
zz_s}hxHg}vQ|2L%&me#J1@jR|mj9c=Zk}8UJXO~Ms=@YFqnOem6wz8mI4=PC5xNaj
z1|XBhTKmUqOLiZgTq0Jsxe<c#Rn&eRja^DhHsJtOShCRoV1_tDslH@G0nkz6%x8hd
zfl^ew)}&CLt4z9$l*49XeP%-ochfZI_UGTdAB&qZn*l1_cuv1H7B}gf&avf7H;ST*
zn_geu%jim<XInIXRM<S7eonX3=gl2Eu4Kv<+mVYu4tKtLNzB;#ADwO-?ld;HU)K)h
zxo@9t7#hu8Q7-GWHLP&tq7jNpJM}B<u=R14ndL<dAL*_8wI_f2Pww)fBt^D3AOKtg
zB9g%%WU=i=QPS&;cKe|uXLuKew+vb)>kzarYQo&{db2x2O`TwF_CGqh+3lgCZY|A*
z^T_0{<eZB9+S=u)$YEXCM;Wh(Rj#frB`eAu)g+hapJJ<Oi^+|XPO~%<Ts~FktMxN4
z6kWXqn4QlWVcl;?gxMf2EzzdNb@tVr&Y7a1e<?kwYKN$2Xoghk&Y}d0`)EDvqeT?e
z?k-#}=JZaU*Grk#OZqRT&+ADyCJHnrnwEQ~m@kN23uD*!PEDE@lWsH-X*9X6h^q^I
z{m13^B_e<!a}XNX)wqxCULZmHrV|F>;I}^<ty5lboy+!3Z$|;(p58vEI=oovHka)H
zP?h0D{-RNW*RO>n|0uWTw~I!-+@2r42<l-PpJSSwJI^z7OjY%K1@(NUxx4RF7bMUK
z@t<C$<8!7}^|?j$xn=csSmj@J+g=&db28=fs{G$wrcfcH-{na^f(6>v)RTTR0f^%t
zc-l%^m;EbZr)iODu4*r0Ckn80Pc)7%mMcKmNf43Ze^JY@@`k0ci(iT-k5eX(KhJyA
zD3366eK`zzAzR~ivURirvmW~uP~{euly@9CHnc?xd-#WC;98j&%@%|g`Yb;Y<PSu_
zSReBYg!k}QXb*&<V~h%>&oI?>0^Se3N;uclA)OaHmS_nGnvNxk8X4fv#cv)0f-wY2
zvE)OI2oDEQEYtcAcT-W2D5#(X5$Dpji`j6QHZ&aMyiCiupV6zqND`oemPLRrF4I<Z
zF|+P#Q;?EoFVsA90Gn?7(#~mP-uxbV$?rtaiWdDPh2Q|fMxzK0+9VF}U3Ms@huISw
z9YJuA#0l$=F0nuhv(@-7a6v!IAavRYtj}=5GF;Fb5ul?Bh<6bn#jZ2pa=v_rhj5RP
zbe#g~K}{CEaK;*b_VZI<vXEoW3mj;!H*8vlEZjms0uPGCg7AWfgjkS#k39#KBF@Q}
zlqrT_hym5JK}~y*RJfJacSpBc2)-|HEAzd`$av7pPXseIf*GVM%yAjYv#i(yd^&L&
zaw-j(o#JfpGRcjSEKhMZ_Z;Wwd%j#gu-uFcS-yoZ1}rBSo4+rJcomy}v&S<oB8xyL
zhR|Y%Ug$Bij?EXriboI(kb!e`jyYn8l-T^~9y3Z@stmSN1a}|OV+O|Ej|!ANe<i&=
zX71S1aDs#+&OU}9t3k^6-Lukj%Y?)wMvfOF)3coQ>XI5n5cAOlcQM2~OPC1*&`TaS
zl|^tDK+GGG7+9fHJ!63mXf$`p7XlB{ikm+-l*)mWAeoS#)-`rY0UhodySiKxA90oN
zkOpB%1*PvAvx&$TUf!S}s4xfSaF;~nJ1uW0>_4X<<<Jx0bR;zMKAwSuzCe!RE{n)_
zTi#II$5W8d90Y1g#D#GCeWr>P9W0t6`YRXV<LN6%Wyd+S1w!;79x@;+cMwlQ%yul$
zLnJ5LPY=ja9>iO&W?UkQY9KZteyshn7Y>XPNGW;<x+Hr)!A_}U`(sT6D%oCXz!TUc
z(M1pOP`Hy}K=x6xz2K@91(8Gcd0!gWivK$LGYTI!nqwvK9OmmXT9HDq0Aa0A1Pg8S
zTkf)0dl#&gBCbM%^dXI)D1=~)v2Qa|GfkN4sR83Wvj~a;h!I^<s|eypG$B9?@q?vC
zlEwo&iy{P=kW^VZpNb+PW0oj@^UPi&(C3a-&Ll9JkZ4#s{}m!vh>$CoarP)eO%&mg
zV}Tf1lKsqr{fr~#%tI8B8nbi}tK2?lNDVeNvwV8syjGG|`Th0akjbp`nlc?p8MNF9
z-d|$aZ$3Xe$~5F`8Zs}%*~n!Q=Y>w{E+4oIOc2<m3?kl+l>P$uXc^mVD}#8%*14-q
zQeyA)j_DKz_SuXgc$<)vSUSB$5z#SA7qBnYupEDXCrs>}?_<vm+nzl`?90%YB^T^V
zMqCiEPeexS($}6nN?e;I_9TX&E`S)z=A-G6pFDZ|A`s~oeR8<7&yQi+Q*n(>J`+z0
zrs49#2WUOTps0>|HQs#xcIgw?Xtl2>i8q@Xz6z!I1irD_m#(<x5UDmUC!xt;$#^dz
z@oFJ=y;qE*@dv@U+Bx1ros!gVQ^dz+{okf|b{Km!64m*f%t~uZsdhFizkvjHm?@5F
ze|0_(vi)IgvF+;gerBXk>X9;Us>cs6uj84K<V{ihAp|oek3WopYcNdzWm)i`$9aoG
zBuz)Mz|FAnc$qyhk+_H(t=zo2Tu$i|y_paE!Af`h;rc>h1GGf#1d?DR$qsy1I4mX^
zT9gdEH~^{>3d>A_G7Nw^kZR?{+-1p7%m8R+07SFO+?E6tN`_)1NvwM07|q4I4ATQ3
zhgIa0RV2m1oyq}umIH=xHSHS*IzYp*t^xTct2`8N8m@yoq6c?Elb}NbAjJXR*odvu
zH?<Q-^iJusvIz!uoi~++kKzXsUaJWUj0Hk7U$P{N3SY!0T*Jt3J<el&1=q8>IVOT~
zJ8;O0MY+jgR(dr?)Y#?6icoHp>!?Z$NO&E20pG8t>@!{2&RzC{1b%_<Z^(wyJSAri
zkDN&)pH0ycp*%z=<3S&A&d6rKNF?QllkzQBQFL%ujl8)>%yi;om9yG?dfS3d>D&Jg
z00960ELR6qlK=Nc+#7dR3hvB-BeRrn<<=}q+*F#GqikrtD$X*&kt=gl(l&FDnKMi)
zRLqq*zm`a^IMPbNiSv*B{^xMH&wcKBKF>Y(!+Fn(lE3Sml7BTRMY-Az^u*x<&x4*K
zOm)A<>cz=~z&=VfgsF`IGo_gAiE9&g)~o~xOr2b?b);kfz5yW8w@2DDPN$izT(k1n
zuFB+39W4#a8>n7C+52Undhe`rtGV+rt<$})O9OdlJu3#PC6+_Yk3Ep{lAQ1+B$~Xt
zF!43VIpuyR%<FA~rQ=Nk>b*GYcRK351<grhfLd+H`n@;mrg`yLDvDpJmy3D>pawv@
zIa!aje{YnSdGY6DRLSw;e*UNvHpTsjFkQZ2#!>mG6B#HCL~oFFaaz{&x7EYx&g0+p
zY!rHKTszYH;&YU)z;uJp>S5&@X)*g&MdP<te!RZcsQ;_&SDQdazX}m%_D68;k;vkU
zcaa7tt5H+=uYDaNps9Rz)N{j0_C)r>jYxwvTCV&(>o|8=a>n@&S<d5adP5pZfko|I
zM`cK;ss7L3_e^P7Gp38$Lu6P*n_Mrp$r(!X=;LU$dGsdDRP+7PPzlwWm;_<oYuq^J
zG+Y01WTyUO!Q{1D`lS<m{?%~f<7geTzLMBapZoVK7T=GAr&}Xch*JTK{%CpjA#D|6
zt*#1DiQWrY2n-LXulhB!AYz*m7#<GrJ^gH0*@4B{qe$XRvJ;9_E@CX}j6zEFmJz0T
z!Kez#XFRY6Cf=X?rR^mlMW3nXj1s}8G~iPl!JlZ#=R%-f`^;gE;vpd=1pH}^`r&{|
z!rMZa0=~u}p+x|XROVNTN&;{@4S24q_{$2FL$LkQ=;_}_Q7HtTt1AjpR4OQo5=@*q
zidgx;=&&;iF4bE?nC1rAJ``deg}AJ=tt}Og8S37frv48}#mnN&Le#eROT>%e%}VAj
zW;jd5-zAup5X|@~#2XU5NW%20QZbP*ogY!%_LMLk2(pcso93wIJb+6X3&G2s<nYf+
z4)Ox8UCmwGgj&wLNC<iDdJ>A9;U*)vkq0<OT5}_*EyBTcUM|2wYr&F-41*w_&tA;1
z=SEUmgoEhG5I{+8;gckA9!^h|2hMvMhiLBw&hueCxRD|)!rqByE-gfUdau=3x&G|n
z`XbpY9!nY`rf^{8V6+5*j2CAqr<3vJ4~%3p$O0<Jr`d8`4C``gnk4IK0{Or|_ugkV
z*n8P>gVZ!A>!~iIRh8w3rl#q${N7#}@;JouOD7lDU`4Xzs+Ex^sA=3Ru<^>!Ncfa?
zPhoX^&%;)w8?uoBJqPSjUs3>Rsmz>ztFYB)9&knp;cYz$`3O)g0TBG(B?+oyEv1lL
z6vuje{ymE0It<xCas1ycIT|o?iU4~A_L~D)S^~*Sas0*M`zen4OxGen6M_9=jq;Mr
zTv1Z&raTK6E3di)_Bo-vq%!%yJ`AXT9L0xkf5lOJ%gx(UTuzzka1e3A`1$1Kc?hD0
z_yKM1%)H&v659<HJVa5l3GH5q`Reo+TtLw7Xrrx;)oJ-dy4bxw<aeE|opxXV4xfJ>
z47l*mDWCw5cP5L#kp61e`}llbFd%}%2Y~^FfTuHA8-|=y#-5NwPFs=pOCdFOuT=`!
zPU#E+Cli39T1?h)G75$a(*m`{tshP{;H$~H|AW5P53fnaJQQC!(xzCFdSn6;v)@0n
ze}t1C%Ea(~!g9TFuRjax^GNT%i%nE$O1iluM4yrIxr;p|Nt&@DD@&0IM(0*y^f5$l
z4C6*;>iUnj$`8FU?~1)K$}@S8Xf;RY<7%%6uP8<mdEx(qjMs!$+8^ClxXu=SbjNV`
z#OQ#RSkKcWkpV65(q{94vun53&pLZ9e*}f~!lDwVb&xYroxAX(QCO)mVV{-5&`$i9
z5xpl7*SB63NUp=rw1(XAaV)q#7k^R)f8Xth7pAZ8t<dq#gYh<wGoEtnd3y9vD;Oh?
zy(9P{&{w-D1?K7Y@OzsLv-%FrJfq>@tD4u-N0?8$nhyT<J~J7c_Bwj}=`M`;<9#Og
z?&)sZ*MlCf2VMOc;(q0r5F^f~Vkr3WP%x$jqcJ<^W_Hy-XR9T{eudju{Xg*^1sDFG
z=ok`5u>uI|0g+}`7b8N<7N|RXn&P;p2v)pO$F1T6c%0jp&n$YQ@yYm;Buj~&vNN|A
z4>~DfCp9T$(L&5!7$N&}Aj|rQ(eeMBM8{BrBZ|`g12>e~R^IG+RvcwmE8^$G_bbc@
zDj&h+C>r+ng-~2@YBTv|6TRf6_FAc?P@Lb-pEnJut_!CfqvI;f-u7=L5$_~E2fPPe
zD$K>$6-Vo5OYY~_oEdb{A+^|=oYI+)7xL1{t>Ms^$G5|udnI0)w5x#z>}UU8M)0PI
zZmNt6*uNQQF=IJvj^y0Ot*8sGI8y_|T+uO7tp6T7?4=E`fA12FEYHiof@@+qsVA`J
z^x}VU`k3kJ(TBakb2!XC4jY0lvl^J2!C`Ett4&OZgMIAsyFGys;pj5|-oOa8*+w+G
zyi$eOr0^W&@B~E@v{!s#r?|{1JXxN{)*sJWpv!F8<%*2z=!d<tzi=3F4jqUtLoRy8
zX3NZ4aS+Qhc2ML;LAc>n|JxVo*`k!N&~v?3q8Ai{5sN1^saB$)Q3nvm4rjgm^&vlL
zwoWKK;gB@UdG#1~$rFgtm@#H7e0)ztf2{wzLu1Bgvz=En>^baV+x{);9gA5JcpW}e
zI;UsmS{fB7tsaNhQ8glDT};wa4oQ<b&rh5;QtT~b0!@1}Qw9NYh!M?W-P50_I#7^%
z(%((&`<~kMy^EN${!N3!yU@FCy$H6T4j~hQd9OI_1*G_B$GO9xEf4AwjPqI^tV6=S
zv^@BNp>rM{#sPF^qlK3ca;Xep2&IW67@w}-{PeiP+FBk2(Yqmlq1?ihBya;x@0JH{
z{3rCo<IuvC2)Tiewm-qR4jN|B;tg4lJ-ILjHHZ}M`Jod&b%m?&eR7E5`xmOTZz+JI
zI?YuESH}bD6atRUWHne=kQyx&Uk3#%P;&8Dk$zoTsxLY3CKE#kD|~cmUeK^V++-u}
zut$wKcuD_dho?p)Rj;|c;~^gQ?`kVmCGk;EJ(rVzhBNF9UCvDj7VVZ-^}|#O>zL<h
zcM9vWIW23`sC_qChetcUC*;;unM8R*X|f4*$=;%umCD~uzWIhp$*YB7MjJmlJXI~8
zu|j1NG+uj)63ll&Fv!V$4k!X%gNvy;7&lh%E={8<O(RIo1uExqy#aX3Q~aA7RhX#J
zxiZIDpoZbX1yPiIf`)fuoeKRA1Td|)`6lK=R(KDX{sI5Aw0>{!AvdYgXemI9It}Zq
z5+qLfZpd6I0%8y}ngc2sUjkuD*W2VkDW?m7RP|y`_Mw>CfeJW$<T+4bz$iz|oXjmX
z|CkU70Ts$ArjpFN=42Hgm0toBQv>GRBES|w>$BcGX1{q14$kW{S2>c^gtZu_&124+
z#}M1ad4Ps8O%NaXZP?DlV$VF~JULfv;t?V}@_I6}M-m8x(;vwLfe{(c4I%SgEv6y#
zM_fRl)`Bh%Sr{_^l$0ILMfcqU$cgTjAe80?ouB0<YjMxNuFMYSrTfYQ?xJKZ$b2v_
zEh8b4n?5$P*WUPu<FB?r&9Nm<hg~>j;`mE9J95>6_9#2jeb}y%oAo!H{N9G9kQG^{
zJa0jbfv^<AGoJG!=08$nE-{WlqQvD`#gb7jaK<tDC>PFb8i@H0YD_TW7*~{w77Kfu
zEQgrq9kz?MnEKsXSe@VVunBQv<$6F5Ee8mLgH44%7)N9boA0K?gn&(nK$sR2eVi-~
zo97<3TZb^wPUK8=8b5yZn#8;oVRc!FmQPr9<Fug64^Cu~I!zA0S|d4cOWELJ#$C;L
z4u{RRQ#OLYtpvbKj=7x!#KXa@LLi=FVg{S<rEG+NTZurt7L)5Z4g!NeCS{8xbbNsn
zmy3MO&EwMZl&2S!laYzd^W2-UeA^!yZCGeXJTbAEl-MlZGF}JWNl1u?w3sD?sKOJ{
z;#+jL6K^ubTUyPoHmsT3;~tAM6P<968*L0=c<~D$w-GbZ9QQbH4WWz{z>6n^sNPCg
zL#U(eq~JUh{sz4GeG2~u4BkcIFXOZl*UqV<J*40w6n<}lxDsfUum-!-d?h{l=8@Zh
zDOO9ruL^XDrPN<cfjcnZ>xiAK?D$usq<8_U*#!nXm;r~f#4D&~$_zLcD>KwM5}o9=
zlvyvkrQ(~mEiv#kp3&G~c*YMtdn@*UKm7HTzaqT9t>iaOX2c#i2M=yVr@s;B{{8vQ
z*1F!zh-td%iderwOo~N2?R@3krq61NKha$&hKoO6Z>?WFhkjTnKHQbUz4#L|rGjS*
zoI@v#k}?x!43eI83Mly6n1{>%Ox0CUV`ZbMwg#+hj>yg&os*q8K(&RkvN4Qj0_+3k
z=v0mf%6PVieINrTjet*DZdV=Ot`cWu%Cp-!lJ<m6f1B+pn{9o>053q$zs^W1?vN5(
zlxll=W4SK@cSr?Zk)6rMc;-uOw`2I@vNF#z{LgGG>tB6ocBgl#ea3KW7q&&eG`pXb
z$;<Gs+FJJznDRebkU97fr_HliRe275!T>(~8MogMUc#A!dupP9eWV+=Uk@G_fG#e`
z<e!=--C75(E;4^lP1HQd<Tr-TUtbiIWb?ooQhV4ugK@D?1hIvxafu-XVe@FQ2)A*{
z2%^BBVU17Gmy}5<>a)vVk9&wahgYPi+k?3{yo(>0%bC&M949G7d`@tIg1O}s4Jl@a
zIqvP`YvzUeU{oP#ugj2ohQ?>NiH^#$w$rN1n&^QNy=BeW*G%ch=;TtDzJU_RvL<Hs
zG-3VBV|3mq$tC%#L7r9T83nJGmX``=g>?E=SwU!Oi9Rccv%^E?=!|TaergF9D+t3N
z!dNa4w#Go*mX!Inpvum1l^vd}c+e8<t4#cR3umH2tmGWX&*+zDhiBkS5X39i=v!I6
z5QZUH^hb|h0j=fH$9?sNOMHJtMp_>I9Bp}|nb^C;h0aavb<)|^R%#2LGAv{}b>r0a
zh(Q79w1QsfR5e*-w4r)WiQ$ZP&*SQFzDK<B;rF#}_1ym&xM5E0{u)?fX?CD3c&1u@
zJybOIusQK^^0ubMj&$YiSO@n{Xx>?(!Lp0dvP<H6Nzkhjsnx0}{D#Mk-<(Y4WJYZH
zrTR>x_M7mK%FUJxCAIIw)he&Ujt(E<HMIn<T<8{M+#7$88+M`FIb*OpS>i8muh9`T
zcEb=yyBu5IaFwH5L=Pn)=KWj2*z#Vh#!MN<)hgL98y;2nLp}<3bjVp=@SL$;jHKu(
zbjw{oboSLVwk3W_*tZXty;N<DP7ILXzi(ZdIQeEz8F#0$n08wDIZvL%fNY~T+Uiqj
z%P;7y>#hrav6?{D2Whg$Ss`pWk{4Oa$;zjY%m!&P<(ekonFSum06i3QjyU8V!Ps59
zSL-8$wSW%@Q6X9fxXTkn-Xs~e2tDG$nDcr3Buj55?}nY=*_Ib{B!v@?J6h$Qa^fok
z6z=217$<_SGkFg;cxZ03@>VX?x~f;_85H)F9oD+s5t_Gz^S6sKxNNXU*3<tGgqu^H
zaLpRP@D^vAO~{`JE=%WGHkxo#_tXsYn!Ma?A6@3e0^ijhJb5B|;I%pL<f$?!^2oQ*
zSwx;UU*3Cl)yexxla+a2bo}i@LhKttlqxEc1sA<wf4yY?dg=VALHwwx6kIg<b$t%U
z8a3$&nR8tnJ;iw`tciFyJoJlPE5>0%u--0Thpp;;Tz+0ZcJgfRz;MXyT;h84^li45
zg#U-P?FFO@>1>C#0s|PQYAq0DagS%cO#Jx1JLht2_+cs^-@Z^$k;Bh>x{HJ-P8V(P
z&EK=TI(}~I;(qtTJgN3e`=Dyl>!OK!Y<<}3_4Ter?>}7@Q>(n!R(aL?xR2)LIib2_
zADl2HPiHl)^dSD)=;yjODPetzA9zu?G_A_eyeqYX8kM1w^>2-gD)&qINBI2r<yt`5
zT`g~=%Fvp&yvsbX4~mgt{fm>Aqd$<Hd-Lmlu~~<YouyqQBE#}u)opa;*O^XrnkJp$
zH%|U8pJVby^M`J!nD^;=-zAGbNjz`TBwKW|+I8=@>*{3sA~Jn@*sLo@&(d@ZK3yq5
z&dV-Nj_Gl#sm}N3Kajn<@+0Rs{UYRi8=DmgB6oU<J3r(${5H+*bU1ywem=AzH1ppL
zuOl1EBM?>3=F_8G5Ki0o^m;;K;=<O4d_07M<3}eR9kGv#fvV{gUUos8SRW`hSDQQ?
z14Wt`e5WC5I=6nt3E00MfnOmGR92Y%K!5v-riN~W`>voz1V-EUS!^uXeBFi9qXMJI
z*elI0e&2fum*a!|Htf>}375?@YPU?P{-jW9$BRb9V2j))RSI7Te-ciF@`wAGK9>5<
z^=L$FMC!W*Vg0d-pXrQUXv!^V{>T(l$($o^On;ox6!VU(f3{?ykW9IGPxAXIyHMMs
zRSJWIKL=E6pY>2yo;ih@r7kU~sMf-*{WeZTrfg(4e%`{5{k%&U2fB*0?snV`cT!iK
z6^rb;pLN$U)9B7Ur+D?}hr9P$Y#&vmYBy^dP7^0+N8f%iYcCyMxkmDSNQwBtBhX{k
z&fVLYxn1uW+QIp@KNrt{PkuFXOu1W2cGxsLy3`B%6F+o$B<{|o9Yfm<V#K>0`KMdG
zm6zfz;~s0^o^A==UC}tRuU6`$Z&Xs5mdniSmtFYD%Qq?~fyhJGI7a7f)f3%R<u)r#
z+^v0ET<qy3xCEjfy~MSDPEa3HGJN_W*5%hyw9vOX&5-D=<boY&SA1gIxn}dP+sU_9
zkS3RQpcWf)!+u-uZpV%CuLs?U^D^Qy6~)FCHEq6IVfE7|ODeE&cko0mFz|8UH+e+d
z9RjhB(hFf4>Vko4%xW~H*MM35I`Eq(BJMtcI7sP*GOID*G=A+UB2LU}?IAZfU9fi4
zd2>I^Y+5-ED`_@wwTY54BXL^%;B?_yl=CJEW)`Lvmxw<L0p%Vi_wpj*5(#I&Qjid)
zur4U4#!N#~kOs`O*U7!sh`4OR*#Qa?%1pz6`S>+8M4X`4nhzArFIZD^-jswjGnC^z
zC7XX+Z5l{5mvdTtV1D6Rfb*sStT|LIE*XE83v>?`CTi(<H+-tj(~7RW&U;bI-KRRQ
zOmfW)PIs4Ia~u3LeGt<8rG*qscjsDj(^?4O+1v|he(AmD!%ZLFvt}f^TTVgae4)*M
zxi?L?n=3g+{Pbb@wFuEo6G-zF-nd%{;}E*>tK?qM1N%RGO#W;f{&Qg${yeyU+f8|A
zke^LT-*o3VxtnimsqDC^?8s#81Y5`DW{vYOj7yVyoz3HNv&RRhVNlisT}HD#qnVA^
z$;jS$>9w}WM~(MqGzT%7xme@n)G!H_cfzLZyM+ec!bRD@9&eKyw4|=6&b*^xj$mCZ
ze*7X>=O#@2ZoYX~s=0zN&Ii_2Q08GwQ}azRj)<Ewug5ekT2ny8wOemis>Thctof?P
zxz{W-2vg<_nD2|$d=YWO4x5S+&HR*k3t?i6`KF>&a|vOb8(iH_S==Hb{>uAMx`zq%
z`f0N0wx{@g`y`An+W#n!zUE&I>s=K`TuD!@uj+WF?C+W@<NvH9Rlk!Hr5&kN|7mEk
zzuD7&;Sx&x>Ax-r!~OeO`t=vW_W~x6;vS(*F6cG{5^r9&pnrH0Y_rk5()F!1!@i-u
z>ZlK@Nwt{s4=Y-|7+brbFYAmtCgnmRl<<SUDkyMOP#ntSkKmlwPk~<m#e@IVz7%*4
z1<q31hDpWS{S$2}sc&bgZ^K~mREN#;%G-Ld_>pfeZ8(eNT>Znd8vb2xiRt>KaRzM{
z=QVQYB?wy*@ZXtwE4CNR<o)|b;OBp5UizI0S+Ol2F@&v%Bpl-&mp*(m;`GSK%*!|W
zoew^>J-;Hf@4?o~s~>FDmThBSnSB|6=NTtwSU+;wvyT(is6svU2!r#X_j3t2c|x?!
z@_{P-U$%sdQzc*1A6gpDN*77EUb1l)>Q*HLu0P0>e2~aG<>&v6|3%xY<OhW02lm3o
zQUb=gbEiPuj>uavr8~1QR)AQkm=fPE$ZoII_er6P4ir?+nDF@bM+mgNT6C4|ar6ww
zet|}5rj>~)jZZuk`}yG~X?(lB(n_zEzjcpi$~mV-v5$M6h$)@LF!xn^&B40zzYQq?
zciu$^=yN(Epvi6Af6qhTZgsoQcD4LwnKn?r<G8S;hL|mfNBXnwv*~@;wZ7r3X{m?Q
zBecGa?5|T^oD^^k1hfp!_GE?I?3Otu8(SC#w`*X7U0?%3Yl?+AV%@5zP<-PW(DUN+
z4PAlW2A`it>z1m2pau1fH7GwyOO^v$JswHjxN)MZ;)dT9Dxsm`C{xgHn@2DHlRwQ~
zq`!-JZp!7-lnZ20!>4P}ZYl~_FnxY1s!NrTv*%Uf^m%&Jp#>BKl_|59%d=_k7JJF*
z?fTb(3(HURJ7%r?a|Tn|RLjIOIxw*X^O_xO&B)~^?8cgPy>UYe8x``MB4n6dAHMR*
zlyGhz^}6WbzE@_i^r-9S?=62u%%xl#67Tmk6L}j~U^ti3Sq|5|eiaBFatVn(8CY_4
z@%(JMqEejK?PJeusT^cz;v;HwOI!Y!YqbA`qIBB9uWi>acZziBHuvZBspvnmb+yTS
zo~{_wJ(F$n%+}H-GyLMx=EtB{PS*xbCZ0SLz7wb^DkHs@WfOHq<;5MLoI666H#J`g
zDQ4IQ<|jS$-G&FQD$w1oZN+ZNNj<~o=^_rkF`s$!W-0i|YUMlRn|m+jzgbj0eR@ff
zD_0=LuIkj8)MRzn=f*M=n^Q$gl~32Y@-w0sIGW+`nAtJYmi5Nzt{*WaKbmJ|SaN%O
zw<Y)brhZ3hDe5;$Pxrm3_g$D#UiW))q}k&@B~mu^b6PS;lM_}GAoC>TXU+FCW+mmH
zTaXmOLR%bfw>Ww&<Veuf<jK#s{+6d50POjYrF1ne@^d+|bYebq!Id@UDd)Q2DuQ+R
z=*R_>!hj%QtO=BS=vIF1_@f93USv1@g$(&nLjFopzS4pL1Z$I@-&k<>O8{_2_t~@S
z@_X_+Z__05Yrp^%O6Oa^^F4XM`V3h+E#Hm#7J(ho!rrBHCIUy<f6Ik~Qu8OIktLc~
zF;}wBf!0p%1(pPTQl3oa4h!CU5QySKlIW9MWU?G8yG4o%bqZ}VXDL)nr4xjT1?U8&
z1tD3oB@e*MM>=O_GN&wrP5h{J0N{m?=)5F5x(pZjsqW*O`hQLzyiRmIwQ(=?Ysndr
zWlehwO4AZWXwCf%4VF8_RF!pcWvaqlSgG#HOa}zke%GW3%sbMm6_o0pBu$cbV1AJ$
zU*`b=_(-Au^C|qOr3C~)NWXbWmUK4=IknOwQs0?*@FD1SsI|;I)m`uf;HHH&vLqi&
zbFa}F@;%;K_7-rHAqjzQP2iv%c`x3*UuI7CB{=9oE=qOhW(F%UXEEgH+dzaY>56;#
zdwi;UAanL0R)JC$(;AWmh{8xuIOjOEhP(kpWk_70ktJwU0dxy6i?p%*9D4~FQU_?{
zMpnlUFQpDEGrbU4M@;$qteX=x_4`OK#sHm}wvgmT=BO<BCJ%6#k92w0C29EL!l)2-
zUrR{L$2l0F03oSxT<kv1=>ZD7ByM_yB|Sn17!z1%6u}Pfy6}=Z=@Bwy-Gt%gq;YF{
zB-fhn8^1B$0QS4IK30%iZD)zE-F=t$1@Y|gpYL_pV-k!=L-yFs*2c60>@lafx}0%Q
zMr2IKyb>!WVN=ng>Ti-moOtf|GsY@}eT+luu$v?ps|M_*|4Evh;z&8;!i?4EjyZ{_
zV+c~o?h<T!qEXj}`m?JQ(;qHdsszSrVa+Vb=(ORwf2*FW24ZDM;^1-<C~8OM!W)16
zw`x%ja$>46gvqDGyn`X1zYSQ)hF$u%YU2ycI|pen%D(8<ec6BtEbRHeRqv|;RAj<<
zzzj<;qXL)^V76(~JTT?PeE&e}zFUAl36PQugM!ZCt<h5To<X0CwVanOz7YITen@bv
z{7?<uS*7KH0dU&0iYEOJ@P-M|otx<00%Z9F<6AOw-H6r)*HVr9rNj6%Y1;R|?h0U0
zfH|d2^WpgL{{yWLZUHw)fUsm37pQZtHCh-J_7T)ML*~WT2@vYufjTM_@3(*>$3pTS
zkO>n6b(+8mJF*PEE-AC8@i9%I7JUC16CF7s^jFL~nG@cuAqhrBA-QI2hVuxB3Q-TM
zU{oZMYx2pW*>zm3!ylZXm(NvP+lLMLVKcn9F0rQVvgHGwQLmL+iQktCn<_#jFA4tx
zZ|ithYOyOfDKxQ>?|rs`zGpt1p7C3HWGPoWt{JYxKJg@t-F(`kzR4&Iex6p`{rx*<
zAbe3>;NnU!O|k2HOt)!P6u;g)1pX+(;*YP%RnB8ECSUC9`*49}-BnN4hB9^DpSAIu
zbMo<yU36~~jcD$5j5Es~7iX+~=I|#w<^x$9d7E*FX0zk8zMRN(#5|Ru@aLbz)F8_C
z{{R30|NmTfc{J4j_rG02l9()!O0tf!CCi8wJ8xvknth){%rF^b%N|*>MrAJ{B*U1p
zW{V-DX2#e>Gh-~njG5om=Y0S9oiq3Ocs%ZX-gEEkzV3OQGctr@OJ}>5N>dO**^%*C
zW1n8;M0#vnm|%DYwG#)mowmmWmr7qCT8`El($<=>V~EZ67G>%d-*Aj}biq-C^tQ4-
zCQ<MD@5&!9A{WLGX%Q<fFI5SrHby${k>3ffxXdBy|EAVJ?KKE>D=sKR{fy4-l`AS)
zs5`zcR%o4me@V1j){UY81AokDPGs6SLjTgQO=j%oQ0En>rVN2==@(+@*HeUccH|7R
zy+S>KN2{w9e-3q~&Xy&AN-j%|av(_x;&mMm$^QyL1VjiGcwK!&vc1lW-rO5Hb1ivl
zqHQ^s$aa%nzf6kwoQ!h~os6UJ?Uo5{=sI>)2gz*l{3CVy9J^(%yRNS>yi?Kt+Uv}B
z{n@%R`R)xMT&c^z#T0Cc(T+!G=I*yil|B-bA&f3{<sme)_xE!4rMLC;G2F~S#G7D}
zhp3mKQs)Rl=PjF-<OG-G%*s4K*MFZkDf_%6XHv$tB<H%_eG>y1q;Bk&IGaV2yMGq%
zPh$|kot4LiT~Lq$255kgO4~QZKAZXe;qFdMI>vH>${Ga%M!^jT0@TbyboVRzOHBDR
zwLS`NMUXlyvsqyE@%+ZZ=zqx?!Nis;H71U;XViMyulT*}!YOCdXO6)2Kp1tZ^-~|c
z$q8crt!F2#%p<;C{;-Equ)=q!kA1fIM|N*86p(Xaz-5ymrS+~8%H{jO@?^|N?Sp`-
zJ&uWilH=8Lx;K_}s2h`)k?3<s^#9IlNVM8N5>MSontlAp(Co87+^-$Ok&r{_PsK6E
zwyLD!JJ*wo;Gs3h-lQL=!~;wlB%aS&xjp4?ky&B;5=Lw6wa)DnFxy&~kI_`jpQkVU
zboTr5^UK>1r1;988_U}QX-M?@pf5j#m#oD_>fLSJ9U5|8_q=y#)vwL?>R!7r<9$49
z%(iyoFE+i&Uz2OSVjJN3a;o2|HY3hj{L34S+or*M&wmuU*Xp{PZn5T41oWBAWQ+Ca
z>hm-g&mYd7!=yL|k<of?4^2ZYJ-?WG?xSVOOQiwsV696AT6${=15Irb13oV$27Wx0
z_{~%fnVz*01J+uZyZMU_N&`(+nVwIUDSlkTP3Q9$JzvNVq}pa?%|E0ORzdIDmMPcr
z78f6AA3<QcH<i$4Gln{2zojK-c28z~iAotT{4L!-XDbc})zr--R1I{j7ED)FU`(<W
zoz_F66m(C7ycvLk-;|#t%CgX&QcP!t8BlN2$Loh2$neJoZlCm6fiC68y22k%7J)?X
z(=Qf-)<+sO`5%QW7?(LgtXD<K5;_uPyTW)apB>n^(`{*2bTRm^Nr#2>)1WHQo2+$9
zl;@#M#lQ|J9|q$%fLxLy41(48^I$r;S@zo`eLajRUF{i&f64N<sIsLYa$9X*!7`8u
zI|`P`hk3q=6jedoxC%ve-Euvvu<b{y&KH+qRVJ`A0rSqA?S<txPv=W(SCoZz&J^%O
zr4MuH_It-mE?z~!(}!E~59d-moy+(o7Pt5LPJDvZOp#xRg_EpmpGJIpyVSv5W&{X0
z|C8PFbu{kj0|A|9ggDs^UE<A;++}AF++|)&`J!{wm>C&jUYZ;jHQxEC#UrIDTMQ3v
zX3!&=yO5<p1h4|?Xv+(Gw8g98>EaHN)IyB@THBMlc2V?Cs9VZ%3;c#&_rPORUJhol
z8<%w2I1Ye6dhsS&+U`eK7S*7k+58FM=TQUm^k`+<|Hv3|?;zD0Grrn(EYunUe>|)o
zky6XhoO&27*k1`)JnMNEZ8lH|fGS4)$AtTeQCHMN%$wFVWIPm$K6_3)-)UNV?O*RX
zaauC1YRy57v%gXf)8r@r!ZJ}gME+5zO+{MqSC^l*TlgvifTlX7pCW@sB9;hluFXfo
zrfu+wSFc^ScY)|l&hmT|-MeVZt?J;gz<(W_U}N?^d)qP%bm<J;|Id}U=mP(yi_x4_
zeRYGvg(CHWYcBL$6z0wGJ!PP8U1Y66*KqiJr!A@Eq*m$G$Jck1(YpzQ>)$%fRx#e6
z_LR{TkuM}STzqD|iUlV+M{pSL+fjsvm=Dt!Z?1i1)en&`Si6S#z=W&0BfjwmW{*D=
z@~o)N!K#YJImj=h$&TM)b_oZH8s##wH^<nBj(mEiC|_2JB9NlMK~L4Yhp5aFX<U2N
zr*P;;`aemLQgUq_YrL&<4<QEm0MRw<`me7U_UV`Si?xhNhVpubkK3HMOGsjtNXxpx
zXi{jTMn-4L{hy_yi+_U7M*4pFsI5)$yE346Z{!L)Ndoer&{I-rg;_%)>O<j^ERnEL
z<h2>l&UmXK<EKJ$OyphnwesKMhpThxrTfvA&q{omwyJ&Wp=8;4tt^XYC3mWg#>h-=
z$@FtGId9qd13RwY>AvaMG27CGbP~+Tw_9}az}A;sF}7k;I+}dFc>Ixu+wUN~sX3Z^
zsnYvLZ9QH`Y&9*MRbwJOYTwyZGg|eln?$}bX-WS*=65EMe$Ux2Ftp<Bt)jcGYxRA%
z+C%`}?qY$@O8f6E75CpuKs%)Qi3JLpdn#>Pcq&c$H{4RmXuW(bV>gCt_?d4Wz_(5!
z)DHSo=?=DG`;`2Ej8&#-jYNUImh!?w=gQ@e9A86?-%Awyc<3B(3NH72(b^`{v_hhw
z=%I6wYi5<X2>Mc*(%hS-hN5WG#oz0%y$W7nVK0zg1#>wrKBoCTWd#Q&5gkf%%c7U(
zmfO4vs3s9w`I`^r=ay}ohr47tolPUOo^Niu54{_7AF}JoIa0Baaf&mEc%w9Tye!AX
zSf=xoNrX(^rpe{GJm+SGRxf*lp?7@woAOT0^=A0S$(9lO3CERsq9S>E1?;p1d^O#c
zZa06mj>Y@K5BuAJL82W!L}!M=D>q<B0i`_F;GR(DG@azsk^TK6R-f13oc0dw`cwVS
zI~&}0h@1Y~34m1~j&rIAi-^tn;1Y=5L-Jk<Y4Y#PpNvpKL^+7VPb+&Bt=A{F(l+kD
z?T&KbZIt|;<f_}yQV`+NTc7-h>2}$ya^OK*`R2@!%(kzW8oP3<4*f<jjR&S1+nDtP
zpgMXQru(GPp18}>t;f-giU+5#V0&=l5)fmw6-rZu!o`VY!HFYq;ykbmvEcM4j6O9R
zVg_ILe<)2hO8-g9CEjj1Hki;8unD{ZI`Lt8Kd_i`^yAWFWE&5rF?hS%ZQg997zJyQ
zoa+`H(QG;JQOEMF6dSHMH5}w0BP#`U_sKxz&{nxHUfBZ?^KGT<B`1V&cV16B8^um{
zJW3%J>`i=oyj!@ZJ*lVNkr*t9n?D09W(Nj~$x}4AuvNHu7FaO=rX2_7CT>M3u12t6
z$8ht)Fzr~dKpZ>>1<GV$6rw;8IBzpU&cDo#n8ix-1X5%<=sdCTN(F5YE79@{O^B1h
z(F5X%g9o5M87z$FD9|IEqd7B$$?g&@S!p&v$_X|sD^B}?_v#6UxsE6H5r4krm1?_t
zuV#MxI#&7}=9_R}p@Cf=87@u==*}IDtUIt!!LF+_(nmn-<Z)%G`zr3ZlW6NvkSBS3
zil(Z<Q1t2^E+V9=VEa}&OQ4)+tI^1&17&qA=SnAHr9Agw)t%m<iu^=fPX4J-ypoIE
z4U1&wME+j=lQcwoSKgV~OMh2BU~({le81*)^CcX$=5}r8BHC&K>AnLzeZ;HJ_?$+U
zsetpWx%CTmMH3wA{A-`mWn>Qviq_l=D&e9gJB<wo_JS*JO$YX4h#dc#e=LA5TnJxQ
zXB3SfxyX%+Pcbc6eX`hMpwUjF)&%nVO@`R1qu*AQgtoQL3*RDD4?~h&=hSR>ex-Li
zO+>OEh5!#G4Y2HM(Rl98qr)_}IR}A=`7hj^TN6)y?e(BSq79h5bu;?H?EY1%>wxR1
zn(bcKNVommJ{#2)NY(Sea&J=cP8T<?eG+Ih+FVpRMGa5u)tf!v1pIIdFK$XV=Qz+b
zqi0-bye}sIkLAGGm#~l_q|7!rjy6w`lk+#Urt+<M|Jaa|!)`O}FMeiPl7;acczXX%
z4Z(N!$f7IXzh;B#_!wD7;NCrQ-DQ6r!!jkXHrd2ZbO?`?N;|RUIl&51ynZrD@wy*M
z;C8H(7xBpn#5?~Q9JeU#WxNyz@rf(ZkRxWzo`_9qUN`HJJ_+i@C)?6arbr!sD%FNh
zhP&kC>M4DDjEj|a`6{!)7+-KWL1lzp>)z?7GbEC7bVp>O9ZdIBo^LKN@)XSlB!_T2
z?x!pSBuA&1$kZ)lMdPwt)Pc*vnKw!$(e2*`&IM+MewRQuXmL4)DLz*p2>vdSRfAr1
zt{y;R4H#ZOHk{TLX(ERoyA$<JfGe`1u?FSm$U>jKk`vx->r~Y1Sgy&B|DRlNTZT?r
zm!~@{L$AL7N)G2rd!m_LI%FG)<7#ecy9N^<9GgtM&KtJs>;H$QI8s`^+(B-+9vLID
zGB(b&IyOGnK@Rh2qn3=7mcL@sYmqS+TJY*o*y`%m&jYA-q($+UG3v?~a5f0>pzkMC
zv32GfeJG@NZALcu*hs0{`><62jA;-4(AY*x-ClN(c`;057GPy2acF{R*(d}2+xsA&
zy6gvmv$vd#@^ll!pB-O6e|qwk{OdF;BS1&Ca)7i;g2AUVim%Iqq>sF;8L|$Vd%2EG
zQ!b!C%{OHv48MVEF!1Aa59*xA{CL}}U-i^@w@0T}+Lm=v>Q;_Yn<-Nz^hG>P-8v;a
zF9U9Jne^!7=!=lE4dP)Gpgg{mTJyjMZJQ=6Y7^>%n(i)mq-j3)2)iMt0YLu`UU`Jw
zcM4Lz*tg;l=V3~DCD%3_hozH10ZkpV(^VNt8h}aW#mj98pcinGCB`ER^r?9kAE%J^
zHdUlJu(vP&L91LF<lNDDH{~`~_UInhn=@-Z)asCau`tl!JN1>ysO(Z+5v#`fU&4P~
za^8(c(@o6}w;D6=9-DH=PoH+s`dN_uz{Mw^L1N3)XfPn4p~TnC08#PX!LFvM!Pe8U
zqQCiJhWE7C@NxBgbqCLxd9hB67j4(dbEa6V(=~82s;=pGQ-6pG1J6$v>qLE@<*(}h
ziYjBD8MN`#{2|s!iu}U}<qw+$4N>7g1>6}~X&ZDYz|;{)d2Nod7~`?e_?W%P2yN=2
zmnRgfI`}R(jfD)^mgZGoANKj(0E;R;8v5?2QP&c581=btsk2+T$~!+}Sg|<YQR8w;
zP@JcqQ1krFVaXWKLW~7L)_E2-GjnT6w=!)a`X-=_An0O*x$voQRoBDd#Hn#syw;8r
zRJjVT<)D+Cy2?V5kS3Mb>G&o<EJVirk$J1<<;!yW!s;LvC&$-?$8X^~^mPhij7Iuw
zbpUCr)+Fb1WeOL|=2KTQPmYh`JGPR0op1JqwLn6I$NBLcU3jRGjzBsF>bEn-z634Q
z$;w$}-PS=(Q0=s%umSy(PRm`Hyz9|t0SWupd7z`%{29>I)z%APuG&`%lAmccg1yFk
zbLFtYk;t<Dw931vqpO|N(d0<v!P*~9sb5DcWX#bDx)Td~uwM*>>_<m)-SPfu^Zdb`
zs@vW_m{@%_Pl4ztK}xy@iZsZ2R9(`yU~ttR=b`40`y4UZljt?s(?`qY;^7R=6i#1z
zfBa$cUE=m@)Lr=1U~gu~k9lS5bsX=|>$o)NCH_;#pFyQnfER`8lwYqT&LXml0BmFf
zY4YdqhzAMK`x?NYar^^8PT&YGQ5c~T3)qX7Jqd{)nf#bt`X*Fb+jP+&BELUzQ!#^g
z&QT1oJvw>ubko?a&n;?yRxyr62_B-G8N{Gp2}rLx&B~TXLaFnZn#xs2#5I>1yh;(E
zdIE7ReWeeo27LDl8hU0ljr$JyRD>Gven0jUQPK6YPFle?^C9Jk41dq@V-KWtFZ6IO
zq{k-YthCFoBNZ<D6ONnw=!{Q&U~e@UX>aw_=TR*dxiH&08q81uUyA_6@((E2iD$Z4
zX-agy^!?IAefsOcra|+<Y#*C=rqEaK_Y$F#Y89}mug@--3!Mtqin?UJ$lod<R3RZ$
z`|s?K5c;2dvh0A$_vFl_2)~q2D16w!!qm?_IhhUhH5Y2^rLzDgRoR?RjvX_q@rxm+
z(sSPWnYL9bITpTrl%XS2>}9GU$Nmq7?3;}pnvHG${V+M^lR4(`Ip)XngO>U76)nau
z*$&wbP3{C4+;wWs(*@7fSr6GIMi19D@6ROeV4CHzPIl8w`2g&w9u9UKt-9Bm5<MIM
z13M}m#nA7e?ZCi#(w4V+S62g9d%-k<X+wzXh4wSPH5=}(rK9!r&_^nbl2;q=j|Sc>
zoN*_Mt*<zmIjJ|IR@A2uT!k~lqM3{2B6nAt@``|XsJTXC?TR`I;WLQHS8o))@0vCm
zIHYQ;#M0P@Ydwt+iJjSwpSeW*@c?L5{D(8(OP79dH=yS2K3nU8>&pnD>&wh8K#k|^
zsq2T8Z%=gj)jt9L*eF82eFulV3mjPe6ah<8Kl|>PFRXj`657SSBxWA;UH1`gIrq*d
zzBAWieM$&dtFis;I=8X6sslS~%HD0oM}2DJjk1`D05vf^*(L9`JmS!;LVt#EXGZI<
z{~4V+lTm+tWA4h2_PSS+dDgm@-$dD(?7n=y5h^#0wyxuTV+(XJ*$tMP)*Nz^3aS5H
zJil>xebKqxr{woydKfzys6i}nVs{GR59*kx%jD{Q80a_rwxaQ;PJ1tZaEJO%o|B<s
zdy;Jkf9+4PC}t$z$?$S}5>ign_)q_(j^To3bPS$fy+iy<&rb&nYN+(tLUA&aa<BBO
zsA!(xA2HwT3qEy4MROsp<Eie}z^!nu2A=U)^$F4UmsHrl_iD3$f8JBf2C?Z{1Ruwl
ziy~^{H93h@(nKE-gd+z;l?&`+Neva`1oz`cPa{NQHOcXsvcwe@jPsu3$Lx4bU*gJf
zj6_dya*vY(QA7}@bOv$jaEqQ%^%nEE4c9p?616|a_D9bNLeO){ftsp-<*JW9W*4=4
zk@EvEr$(HTMw}eUc7iK!XAyaS+fy5I3e9Psya?tr#(XVaddq`Qk8RIK$2c3IoKzu!
zoM3+3TSHv1BBb~jQG*ZDU$(b+{x~KHHGdf*&H`TK1e@Z5SrKnb_7)9}WAah+@(?E$
zus9po7d3w?w%wB$vG+j=@E<XP4`YFvXN713A<=AL0o>Ly(``-M<HNY3=Gh_ClMrrR
zj5Hg9{Ym6|X2U7*k?zD3$1$uu+7J}s0+Gr>)4R^>c3J-f;1#=;^Q`3Hg2BUc$!P}y
zOGY2DMOdl(F`!~B`0wb{k>#TVdomS8i)n=3xk@;;a(10r>@GPo2=m{lc06<-8!8)!
zk^77gDvoUaTdXM3gKQCi;Th3}j%w#ZeN_nQO!s?<c)UmWu~go9Ln~*a6E{MyFr+W@
zxF|*y9NSS&$MpT3L@Fk6qVsYTK%aoWMKD=&VeL{V-CL|IT658w=nSZgOuR`DGubIr
z&$?AOFst+L&8lZLLCr=z-6hFIkr&7z?ihZi_rCc~NXgnSwTaFfm65zMQITmFUA8Xm
zSCQ?1`>Txf-T9M>Is2_MdLsH{lz={AL2GN^NT0cWSC~^t-0}x0Uu0e^WPB)3@ER_Y
zK$VSb4*eVao|liM-JX}b<zDmt#l5l~j1V*F1~a>FjTvtHyBo|`=RrruoQiVXb`@Oe
zDnu0g-HYc4K<>WvwyQp7*c4Md7|jj^>oK#I*G>Xny)tCJfU|gmhv6w{2bNUhHP314
z&6@rDyL$g>?&>vQ?o3l-qof+6j@MSlMx|ObRP}iNcN`@0W{n9tB5x8T(+=+uy9IHN
zMG=jE%bi95pX}cycC%n+crjT$)FI|0y=HdzGIigR6eEuj=%pt1Qk_V2B;kY9%oua_
z22nq<cmsy^R&%x*W#*+!+Td%<r;igYzNt7qZ^!NJbE-)v#OZ9%s^eFZKZum{Rp-n`
zxQd>+K$18H1^c4y0ETdX;V0m}@q_EkOQuq+&6lms&EbNNOa1GCl{N>r!t1(IED`||
zwHUyJe{Wfp=@2?x4qBuvV~KvV<p1fpj(I^&^+7?7K+}}r`TQIK9z_|ceAFRstLlsD
zU8#@1!V}(RZI>DE35HkP?zu=kR^%ncn!9-clJhvhqB$#;89*8DJ&VYB{QAYVBo8w(
zdXZ}6(0P5b!R2hN>Cl}?>+NSBpTnLXyuE!Oi@!7Xl=7d?`EH$H74hZb6sh2rsBkW(
zd;Te9qMK>g1VKfY@ORKRX?_Hzm8MAX3z1$u`Ryt>=x&UcT|Ff^Vrx9f#Qq;SW;=Y2
zp0yVTK4+`j$yyA2&KPs(o)E3qyzaSh+c#+K_NsJoh`_CMdjS$;*Xj_GH~e9mv>`3o
zC^^Z5GmVnlnf3y?2Vbtc>NYG+|9?OyZ3vnk8TCSTjocAYick7b;#Z``ng1qkkA${e
zlZT{wO1RX7T1hP8?dx9qSM^=VO!F)e8Mt;iGqeH^`Rv*xdp>oMM>$h=GVMaLe|;Z`
z127<TPr_0^RA)gcQ+9}E{P7MX=Z|1nLUe-cf#ia5*B!_yrbOT+7vxnbdfr^vYT6Tm
zO$71r*Av~uKJA%7RZ3<%07eroHkjnbQa%=Qu@fMja$X3q%^+pRH|Mkv!exD+6E!=T
z6*+!UXEQS^ul;b*Q}`Af)?ng3`}oomU0!fqNp@`+r{-O~!03ENNS&fz3(fKCwr_<m
zR0GrU)4#}nd|Po}aXf$tJBs5;QTeMumAZh57M%gz;jpG+4}NpQ$FIl|$O)(gc1?#H
z99~B5o;Xm5V+i*!#JGVWMRF83QCj11x;+ac@E8p&LIVrp;GRUJ7V&mfMLZ(|#i+u;
z*@;LfieZ6+a}$xjH{K)JDOgb&;W#~#g%N#>2IZy0I4ER3I)WV>Bqsll#e)QJ<IyPD
zQ<R%5<!7)Mhsp&1>cy3tlA5v`AGHMgN1s-Ng<NtZ84Kcb9bh>^U=Oi6%0-d#*Z5q0
zSdKmH>QhTD($FVK@YUB8FALI85k6PCPd3?_#>q=J;GppG(c{^{KFnf&Sv-;j2ZW#)
zH*gFVBD~iIVJnBWu%Stn;2GaeGq_(<Kn8MjO9lG)F%rC)0xE@sp{@EDLwJTQ2_8=Y
zb>SK3N$@xd5-;c4uZBL&08~?uYJCh&IeMd2D$)<-md*lyhH?wXDVZ5^{$;jA04wbl
zkaC)>oDFBgOsh)rua?tGw1K5oQBE6?<SI^=2lQ3nPO<bR)mk9l_}AcV9AR~-mYk$o
zS5koyP39zgeOol;uDP}_{Ar(?HK{<K_9mO6rl6-}0252I48y-QGZZfG$D?gwVkws7
zR7P<xgCEaGvXT7@J|uWO1$l#pl_oJ9NQ|2)jO0GXg=z~rcQ4}$p79@v5lew1@W5Qk
z@Hu+3vKL(R6RDs>9PZdjDyR^LYfWWXw&Tzjda6|^;oO*hHCy63pPmb<nw=63r0}to
zv*J|oICV2s&T<q^^)!qtcKle}_y?Tog&yCl6f<tjcV@;5K0O<hFB`=SNKs@f=ft((
zO*H}v<HAH5IE(uNQ9kSU-aEb*39|E3npMcB<sI9$FQf_I!HlWd{$nz5&OtX)4$@?)
zk?o+qV8|Rqm(NCiU22p+sMn_lq|nq&>GwDe0?p_}7r<aK`F|`2$+gr79deW1o{6LF
z4p(#AYi@-v!AkFp%{*FyoxMFaV|Zaz+>VxUjHKy6<Cn#t)NKDTVK{p)mY6zzi8Oak
zkJ=33M_csywornE%lYvwhWM}sO35*jmZILkQ>-s@5hX;*U*W^_VVU+Y<)`DEq>cv$
zd(J1zhw))|Vah4v{7=VQ@Z|Hot4$OgE$L{<lyOfIR9;V@cNN-)y-3o$K^vuvnwX=_
zz;>9W;yle=pJnrpj!@O`mhF5_xB?qZi3>g)7pcZC{Fj-cux!M31P&}jnP;I#==24C
zSJ_hQ!>*i$JK4~JjY#c=a(dX*@vM{O<9Ko@M3%X{t1T3maJc}U+=b^gg0ZFmV-0bD
zSPGkn+e<vJKJ11OtU}oBjC6N)AK<Grk@p5nIt^$`N<7#7O`$ub7Z69Or2M)cq%VNB
zBAft_el48u(st&EOinY1OeQ#NN1h+V-rtUtfCA7~Lx0(G+SzmP0aLp2GbHa4p}$>P
zYuf?&A+D+^#4xI$UAn7&J{yx5Y(z+ElkW1J!=|~zv*xg2n=a;t-hY|R-hS+nE|5y?
zrR%*%!l9r>^WFXX)B9A!2KBMa?vY-@VGQWQMs$<9o5cO@!cl-WxzN96C2bDYR0QNA
z_qmc~yt+9?3VNdpLfCE04YyqK9}t>vMi<C@>r~{~RW?;Rm^`-q#;kklS)?j|9!xG5
zcz64ae)p7Vcluxf>p}DIlK+vJp^RJq((rSbXf}}d8L)k6_`+a;>cPW1m|x75TsG@=
z9x7lzcnCb;zDZ}zhG$!p1u(ac+l(HU17}&1N*J_v*cKLCQYeHaULf2T+t~ghjG#S8
zR0cV-4hz^r3Z(uY00030|7@9iJd<zy|L3fn3#-s7QO@L4In1F_j+GEXCCRCk$~Jaz
z_&Ba8l2Z<=PtFpmIc~&4Iew5+ZEI<S?BuX9^BdpaU*E^~kN5R@ZukAV?)UY+4v+0|
zqt4HOgt^H%7HoymV6OaWwp^3()<p}p9M*Wta5S&>Jxxcw&#Rv67+e&7ppxro7EnRc
z=|H?0M=0gh3bQ?!CiLOp+>r7ReA);iyOgVap6!7(35e+Ra(G&Mn>Ci+S{711Q<aDK
zkXb9v8uMqFp23UvjCU0$J7?C$&0<Y?mhaCMCx2^a59JTBha5b4uO*ooS9$8kNMB8^
z?2yuyWEYr~R;$7Ma0qXPe-M2=G?MWC)`%zW#@pW!xnYk~Xg(83O=j;OL>GDl0I~S=
zvGG$Yq*82UZQ#nIO1$joIDBk8Yd!j60Eq5$IcuXJY3f7u?AxHWD7^)2m^WzN$LuOg
zMqx%J7m=V&4?LjF71tz}%&5d75^@mg&mf|#CrpKhF#3#8>6`Qt6}ae+a`m}$`)tjV
z&JDSIL%9FL)ifhN$3v)^Bc7AyMjM(zWYNWf*2RKUr13jQdT?_aWKud0pJ$A0xV?V6
zXSpBiOujjWJ5vt1v7)Cx;_hs(LH;!3`y3(l6vE7eXs~MDc?9W1cuekoJ?DAwEN=dI
zv(mZYnvNRn=|0cw2);lU1sYYg8yR`008;fOD&~XVby(CyrLcv^$L`2UZ~+Ed8Sdux
zQ*p0u32R!dEStQvd4>_S9h@_aRm!n=a4*F*`{?%yR!C`7<<Vi+Y_+H|$IRftRar-t
z+S3_}<GoOuOgiN#8G8XQl8JD*H@NEB5*$<3yI%NCAd?MkdsoBhCNUqO^F@CP-v`GW
zTbkte@jQ#UVN7FRO!1_TbG#3)&kNHMuDA4sQuNm^YH(GbEYQZ_7~tPY(piBOz7|gZ
z&uY5m`rztY!7a5Xu4eMAu(ie>nH($ZkB>)nVjLsQvuExe@BMKlvjuw;`ryLSx6JP{
z8ch~gGh@OpEE)9@Bpf3%w0f=9YvQez1;MF_Z=(f#UogP6ef+*U75UmNVR0pU+S>Q-
z25M^vHz<qTK-iP<9CPTK|5k_f`;kmmL+Hje?)^7^F&b0S6F{d-K~r_0{5{0@Y6#Ec
z>1JM~2~WF6$T!5pa@s`h;v2Qtf_af<7dD{!@yT`_b=kQuDI)JqP;Kr6b=ek#NT}bf
zkYnks*iM$h<w-Emj5$eS<;j{Y>=$xq<MW1m97vd9FL2Apf^IVGccUcR<r3TFd>Nez
zl;r)qci|(J(mN0j5@&S!Gw6~$3&55uE(9e(Asca^yZLIdXrM6oW=F=ESkMiIdc6x<
zatC&!MB6i99T|H#mjK}1(<T|8CXmm&mtLQa0wvaM+?nfNFw#Nk+VS>bKv@y_-8S3c
z&I~++>eE5J?8->s-2YJuSG~+TS;o2V!u<7=+HJ3e`V?QB0swbVj@>Gt?b-oFo@i__
zBfj`3BMX4q^D(68A4PDl7V5G)@94jr-iv9)_0+N>U2b(8EkOZx?|>3mj9S)8ExW)o
zNh$sokzaP0==LD3_?seFMhkWNIW<_9lPAeAmPVZubSJa}9fJVQeglrTFj$Hbe4~Ko
zeV*Cyk{WDE9JEU-mU+WDrGwJ9<Edhb1w)y&*#>v!gF~nR9aK@*U;+m|Q3^lUHQ2y`
zD}m*xv-VVAH78M$DW!|D{TSj8*a4zJEJv)Cvv!nkm4cR=HX%qb>E65;rLBWq1i93$
z>qK;l{8k(h{WKyU9Ltf@<tL<V0jOXY5q*>ivgLKd%>DaKM(*+)mOi6L1v2*;E&b>h
zP>(~DWMHIGMo5xwK}c2BNg#aB>?>F5wSO+W#E>q$EbieQGu*m>`^*=mf$O+#q5QqM
zTZ$*PCiAycZ}5!^wsd_1(Md<Q^0IirF0A6iz35d<u7)r{l#=r>Y*7P1=%VB(^7h0A
z?2g;I*?~?4Y$bM}pVib602~8pJ|=!km_p#RV|bw0mXg?(+`CU6+2-w!GRof{b;H7V
z(e8xt;!S?u&m(BV8KzCj_sy3*eiPwO9w{7#8XbY&a9XmnTe@k@s!HK$A0q7j__?_x
zGk`ebrN#BIL3yO`GG6d96lT!3Sm3FeI{jBWq|F7z@iP2bU<Gb*EYGdk^c!*JE|EBQ
zmzenXN19ack2DOI?wNKif>@g_Psk_Me)J9WJ439!&8+g^g~}7Abojx0wv1D@ym6nK
zbJMo+h+EZEv^W!-+*Mmg9Y2#2&`BMi*nS*!{2j+s8zqwx@JosCqN`Sn8TKfw8dJgf
zpo^+W3y`9YCv`PkW$G$Wy{}qgejHdhqFt0oY$%5*%MVhO2<ct5BFu$bVbxN-{b`ut
z{xqrS0wrLkAlT$;#oo}4hI6sOL5%7sL7&HAp5lX*6mKERDj+Xfm~gPYc3hA`sTRtr
zjI)wY9k)*l068*MsyQ+WRP%QnnQc=!M@AQwkVXbj&0$2yQKpJ5@0=iuo7yOK47r?Y
z9?yAlm|0NGaS>SRI4=KVanVI(rIAIc=5QiJlUZQPyFGDWAwC)kGbXE%s-el|oj-o|
zV_Q0Xb-8*9GdM%8-cEj8J!cdqlPo-ggY`Bjz|9T~(k2fqpbiOY`&ck-?*z}as~1cK
z&o>Zr3%59_KG9$t6V+n+?d)?ai-usY)y4LrA76_SCLRD{WTy@+ysB6JPQ0VnC^h|o
zqJK23!>^B^+<M+MtjPG2<*|a<_uF&U|DYc3YC5=!cB+lm)ME+EosAdNq`b{Zf5|U0
zgq|rCopTLK(!gm9s@WD5^gfv0StCt(mblDWan^T#mgSiui5_<Qx2wP_EKBDihh8=S
zUL?=0dBOW8$@0zPdG6%L^VB4G^g_f~zHKw`R7-=Wvx(b}nStk7)@II%v04wa5HBnP
zMB&z&gTaC|lhUdMHHvm$`n2lOB-L9G31qiw8Dtjsutngg?U7C8&CU*35~65atnnad
zz7Nts!=23~f2QFkw-cn{>bMc1D3x3?&D6k#Cf42x5Nrrr7q;+AnwUwylubTR@(uUz
z3*M?EYdVkjKQ-h<X%hT;Arh?Vwi&2ASIq{MEZAvA$b-!Z#mP%UvseoXd@fz^d#2En
zHz3Kh@aDO0`>ya@l?m=dx+v44jVgAb^-v0MMv#O4|21oh_4A2GMy2Ya5AQhJ<g0*}
zSL{msd#e0%N2L;?Z)~rVsSk>@w{PA>=_O*rv{dJP_UOXxMB&0&$96W%%r57ml9^pL
zMHCGKyP31Gt&)qw4{bFJKFyqc-YWSNxa%44!^~Or9?S{&r51+~!I#IgfF7(@HvXed
z{*QYwfBg3YN7_#4m;ZnpEe&8op#IX$?3-At{ImSX-{-P9=oqugMv!0AC5?lPk*^(<
zew0%WFwbQlA^shUiu;NCbS_)JE$Q>+n7JsWH9@HehrxHf?t>fsqC%TXmZTnZ5K_?0
zt6HRLD(Z5te>}CWGICd1cj&r#m7-Q*UB7lJXXVe4pc4(=8qe_7e*acaR%c#K$0ZU~
zLMw9;uNXL0_$yy-(=Chkc3G)^Iv->|{VDCa@$@Hs3DidS*FPT(fh|+->!v?lJC93j
zIutIYbD6}${N5b%BzgM6-6K+emrQ-xsMH(w^u2kmYFl2_PVM<M-M&aO1iB2Vo_`!*
z6qd73=T`-;>#9<LL~7l9rl6UMi>`X!5#8xFt6cH2BKq~V-dxZdc87SBlPYc6Jh0JK
z!YiJM3pHuqe3i;^+8xnVp$j#Yz5L3H5D%9&kFn?~#}!Ydg_?XWu!<{?8eHf{(jF|S
zk~?41T!Wh@Yz5}Mjkvp!%ni(2l7M4JD_f2!H1WoMtprb2w&?V{@wD>nD7ATHJ~gRW
zey~dU_=o)cx~4pN$TOcjZPRsuPJJBJhB?-lW&1=N|1fnW^aFM@^g+egx64&BZ#*ro
zhCT|f7&A%@kZ`O?*ZOceS~3pf7dUlIB%(go%sagITWZkQ_o}_<g2NiV<2>4<O@X`!
z_w%i1AbrPs-0Pu}nQc0O5=xD$+{J))fr8p?#q@WZ{|oI9=-jFD_RX$?S15Lo7vnHu
zvf9TZ-Ne5t6C!<QNY2@M$lo8&Tls$6+WZpX@B4A3Jba;peYcG>pJ!K^_qM2_yDE78
z&wO6=yXaE?J1fq}g1al~MNtdvk-NyX_r9M@M!lb{Tk2d62tGUCS$!T!uRbp#3;|GN
zs1%~Ju^6PCBBR(U6l*RSXa1fdqu#D^0@k@KBYL5<27lvD4`kngd6lFjMiLggCS$LD
z0wPL#a!cZaR0Uk!4Dv7SNqg(1p4K{3i0TbeZof*)QG=iZp_%5iqmb$gq<xvKb>_VV
z^02)C$dL`W-}#OLL)cz1h%m*)j^d&R8<Av`N|Q$8a?E6uTD20)Js70`(x?>aaeILf
z%y{z1FT35O#~lS)Fk=8jSr~G+qrf57JeWa~ZG9Y4PU+v@+7xdt!JzpwltoFx?Y>=*
zsY);Nzsq-VV&uOchgyCp-@{EGF%cX4FAeut9@0zID};HETqOF|!<>{LyQq3?)SC0H
zN-4OsGML_ovwN#j8BE88>G_meW2Z%$ipQk`ApMjYHJInf#SUL%SeO_@hEmf;iI8lS
ziN&QRkRkb6FcopgYf1#5)kU(kMhv1NM0(LNeVP$jijBtwF+T1lDYs8YcT6k5EC3K-
zK-+yTxHi0^%6y7B|0Jq8`n6g$=?>7RZJ3mg%P@ot(*730;UgFOryJlgrVu&W-!__B
zPpe2S^d8L%>a;W#92=7Fh8mY$LMaK_w`4OySTbkkLfA%`6L*;2Ft>KLgxo#1c53;|
z$i-oL;PQszrnL=W5Q73^$#QdR0sf^X*D3NNm-lX>T$eXYhv~^@2;k>)YBlg~Np^ZT
zX*kczP-d)Ey#RWJoqnA(97am*vxtM2HNw|&y$Qp+`Yh_;$4u#>v_d;tVGVp%l06Vk
zn#}Vu5txh%pq}i3>!isrQet0AEIbD```;$ZqD`kDboReQiyZx_riXC@08&7$zi*t%
zAN&a&ZaG&14O)IHYt?IVW%=!6lE-k1aI}{}^y8tx*n=%E=h^}*O5bQkKi+FqntCwd
zOh)3KwgOYS@(t3H{+3g0$5L!QG?0BalqA#F0`G6hf<q1I2i=y7HpTOyAAcMkZh7zu
zI(~*On@X~JK4+yHoguk=@G+?q>m^udZ4$57E-oL8C3RwooacIDi&O(DM<2`qMlR-P
zYp^fBx#d^+T-qr+)7~jN+J{x7Fk_Y1TBcrm^ME$oO_N?RV-?q0meUG+wkFK-XO{7;
ztz0aS^K_!yX4`TF0cg3hw%clD?IX2Ky(^{x207+GCip{6(k1y4V-jGHS{P^#U4)9H
zwtPZu5^KY&TRyEb-oCSL)~S|T+`X`OO6kSTN%tcY?zvXPIxl0HY^%gc_vcn(6Yi~x
z$kaBv(&8V?ueS&IWrus!la@CLVQH%wPZnQX8$J8>uldlAuRMr;B}CWP5%KxI%~9T?
zsXuGKT?w^O>qzVfU1ffGV^V6wfck0qm(<9hU+#P<);|}8xUv2x@s9+sw0P~)a+%Z!
zXda7h9l^P|ZVEhug(&pj<qi8XGI;cl+`Ac(BRvv^T!4drr^ywTkh8T-uLOV#FyPu8
z0ZGn?{PMdP8o4%O-I?hU_%~iW5@>R<r6g`hOh)>VZG!GbiR7wnpLI{&xQR?QQocd%
z@~UmSb<bDp+zAPh4GQN)!u!J&Nb%(p5s$uhTqi{uUd5?OC+SHf*!#*}u89u)CtACz
z?DUFHDYmk#KDx59EIzu@%j(JKh>evVi6DJJE#yGxR_5nTr~FlekRigqiR(FsUm(tl
za^*Ea)Sj?{BuDFidXtZH<qv_V8X(6R`#8j%mxx@rzuN8@`#eN>rkofHdzf|O1>&kG
z*H9Bg>siPZcpmpAYjF(^foK{a*O|^Z1Pl=x_&%i6U8NHq8rbL>A)Q?D<R`Y`iGniX
zj3`G^9Q3n&AwOxib$o}zagHPa^ivFUfuern5#_v(+Q~gdFVC^EM$RK65A1StRZplA
zahM#7d);@S<<g%jky>fLny&-rn!>O;tLF*`5%1AN(w&x@koSId62;ueCzd*^pC@ib
z#{Hb+<8IQ?3&YoINV!*CHyj?YeA<kbLjMR_MxFss_uo5#-}U5c$5i&}Kn#|0ubypc
z47}+f9JX?>kK$v+8}NEom*-REK;~+*p88d-k?9D(2+Z7J?N`Yq<I(4H(yc_>zS(~d
zv-(#cLt$2m^B)d=OkKTqrgp_}%}1`xKuzb))ck*S$?!iDoy`vyZ(KdS`VRVMLj4wB
zG8g=+O7@@-+hKyIV2T#)1MSKKhxUV>7^0u|gC409Lj`9kD2U;p#JdDQk4o|P#eu~s
z89$G50vYRkBNTEg7mr6v`;)=S(a5bvQ?%tL-hDIl_q+hef%!S!$&7)F1%W&s$cS;6
zy?@JEwy%3wZSG{Fh*~$a<kzz7L)Gtb=~6%9tZ(!dryN4Z_ZHuqG0#tO<cns3u`_M}
z?p}Y^u~c5~NjPxtms0G@17BWa5v%5i6MUy>PiV9JX>d?s@%q@QQ>KruSEg^c5et3U
zB^wXLC4M-boU_iVu*L0>Y2Le7;;V%mYWw0}zUv`Y(<Z`s$QCLr4cH3<<d%rEi|zwx
z{v#e6{8uT)?A3{)-(O&6$f3W2itS_QW(W;#%VVLz=<e9r9^NUv^x5|(i$<t0SIn>f
z|A7tc4$xZ(P*3|+8%O2Dh+{;+54>l%&PozUT7AzMU)5|YqR}(`(KE->Q+-tTVoz#D
z-gh3Q=1LNcjIO9=Eh-f#UQ*3!JgNBx=-@u$i3!{T>^`cOe&M2ORx8mcukTpcedlk~
z+-jncHzu%Nx%-x0dM}>}>$psizocp)n)a)BzpgCrM9?#IQ02+Fug}l=zb9TIx~m%e
zml&;(_Uo)(IuLu(e})RXg!y&$cskIYXhig{(^4QBC1L^{qwkNJMSM6}dhfpTFf~_L
zaLrfMy%$lb+<iqay~0P;U2rY*zVjG0citd9M|Z_ZfylgEa*|(IM=igojQIu5(@Ot}
z&Qa|CT6&UNbC3M<>qD%65*6mXriPa$GEV@zzxt>e*xzqe)lUDjn&y&mJpIo#)sZ0b
z&xbHd?tq-?$Vyz`Y0G=gYu5Mr4l(uvtnFi73)+N^;Nu)=K(T^waY#q-x!A#5jJ)^s
zdz#DVjGN5!E82#g=bqe-j(P2U%UY^0_z%9*`?@uzKe&RcYgnvw0!_>(?76|;T|hXp
zAsY~P6rGsGQ*vQ>9qJ8WYI3VY`P#9BO2HK|hSz?chZtI^JwPUoaJwS_13*9N2*^Sv
z*9vjMr1|;r1aV3&yd&TkV_b;$=m(T@I+id%sny{u0Qk|8JQ*qeIZ=*^G(Tz40wK~)
zzRoaL<jDZgol@2X?ZG0P@CoQi725D^w&hfKp+kWT`%Z(sj{NLZ<|zg0gR6-2MT?gr
zJCHUg#60ECY&vQU?3$gIZohV(+4Pe7z?3*^mo_N#hGQvZZ6J&|m@p_vjSbiacLp3_
zJt)Q3j3ex#K<4qC=0ZFdakP5}S(IUJPl0$da7Wt7HyOBF<e$C(zH$QL4Fw{^@%3lm
zcJU$rXqB>Sq$I5z9Q@1gh{8y?O6fI{tV>fLj>cB+n{D7CCZQ)mJ78KYM`O3qq<RoS
zxds$uveb3vqOiYZiw$s4KbF`aWrqm{`Yb0Z%t`G>Vizs0N$$Wa1JUI~|K+p);3bEE
zKk=PspUz=U4g*788N{CnP;^{|R&y;BX!Lhni+Vak%@Cd3Prk&4w)50#xh=Q&`nd$m
zhAdf(4V~oqnWBMxWSKlda6cJih|cII3u-`*<Hm&Zi}DE)G&;PWe2l%;!9$Xu9P5Yr
z^aryne3U-jewKwQf8ZTH40I?lxV=oQr{6Q$fi(QSAz;jKj{N!_n}GNY*&Lf!20zaP
zyh_E3?m=ESKAhvjexpEhnnY9xMzebd@(sk;Z~WOoxA4+^IZS+K(9^lECx>$cqe(au
zpzOH(TNw!#U5`8$pfBi7WE<YjeHB7B0XIeLwg5xm5@a%{J@lCz>_d-4v(JpkRXvvN
zoew>`o$yEE5n@@jPm#$wvD<KwrDTKu<itPx3@teW`h@S4`&qGNkDA}QSiBDYr;IOW
z@3yH^!}%h~%+|$UUR8T5x&uV7c#dN&M|)3z7_|zqA?wvqTI|vKCpi1=y0=&X$}`by
zv-;y=mHLF2@kZz*wDG_W1O><}R<$jLr665sg07f?;ffUU4=gQ@-zg)ApWZaZx^Ah*
z+^|k-Gz2jdx#w5aP@+JZI^GcUCy^_u-{(M*YIvdF=Tn~iL9jLT9<GNqjRaH`@_pu(
z$CFNPK6-)h6Xl-P3^=wSJ1(>hWit!0h{7C%)w5a&)(Re(ynvPR8T1>9{u}?z9{ApR
zR4n4%qRNp8bHfdBL6$;05JUzns<bYuq$1VdL6#RSzDsV%nzQhoPnzlX)CC{+O+g!b
zD<NqY$zAgWg2k@616PoH%OR{vh~`Rv2|jOC?QRl3$au}5-~)P6dh;vo;#NH|6Owvp
z`<;ZqqkQOpy_~SYXL}+cVyqfxyhkrinEOqhYvzR4i$|zrK?KWhI(8e}SrIn)ekXik
z4^D&|^#j_dR%-T<J^DGSaB4!<U1i$dT?ORJ$WU(w-)3Y8PP}da-zWiHO#z8;y8Rh$
zlDxeWP|mKu7Ch0Sm)1XzmANhV{@DwQTtC`KXSlZrqQRZvE;w_v1h*)zsVy0zr)9VB
zooZ3!pRx_~cXr+r(8f+2{a%?%X(1to{L{5Xzz~6chc;%dsxAGCOtxs-kcA2khr)OC
zd$W*LwJ%>9{i1@tqX`O+8eAs*p4YdOWK6u#`4wdgs>5ug_)R%1##`U?D$n42_y0Di
zzMeAJl)<^?`57sT?3(@VfOspAAqT|LUv>N;h5>*l<+p!LEEe5C2{_IH0{CYoc}`ON
zAW=?^G+(3U@x~s3vsdRAel+`jz^5;b25ka9!me%S=?HvExo9FSpn~glo$t}Z3k%~v
z`iDCn&i_#Tc;i4OFU*xyYuZalI=VGgFw?RNVIE8WmVLiP2w|Q;_hkG4;4MV)-SPBP
z0J)PAb1Ufk!5vUU$i>o`@pKJF8vyU+_4%(DqfHv`)v+ebA<1*BrSO7N6qG>E%D%q=
z*amk75`Y(+qB3!45ej+kbPWW+QxV@f*Fg|sK<p@F9|lCdoe;!;1QmY60r+|e=qd_X
zn1l0YY>MJR?Q6g4v73fJn~INFt}XmCi^^qu2jw#?ulLKH$pu|!i`0kD0d^o11?ZE5
z^~+^)Z4JRGI#*@mxwdBDa+*X3?|KjKsVP|T1}ddru6Oqf`|I0K!98pUo-qYG(~>)Q
zhP9<9rP(scaQx4A1Lmqp+@ww{H;Jyh4po>V8?8g@^Qjg#Tj|3D_hmX@)52g~!451u
z=Wx%IsBnH+{pFm4$#90vE6^^D^-EzWlTW<k1)%IPMTd@U@L<2bjv5U^J?_hh;~M$9
z+?U?7x$oGzk;`)6)46WDRMhuZpbQ)Ez+88bDe?XeC~clB0j<3%KD4|y7WK(|7$JNc
z?#j>|+*SDdlu(1^F*`x%ZS+d6X7!;iYv#KNZ(O(yu2?)4xA||*rea;O@T$8>F?_c_
zs+gKXE?fS+rUm07wU=2N?=`?`wy6AGx336V$RTk5Oj$P1<Z1D0X7OQ`u?_08ab1+S
z=C=Vx*VO*Ps}>@A!-DMuQL{cNxzbRL@)TT(U-$L|SIr08ZdQA3s#X+>tUNgV`=0DU
z%m6cR_!Lt2v_!_)Svx`Kak!EUwlvDWRCPdv0~ZI^Qf7sCtw5e|TmVOjhr@=i-&_|?
z3AoOb(nbk&8T`{lz)|%Lc`vrMUNmpC3)we6cN*O)rU#x{+!|b4^2!k~_7-6_bJO2x
zHRkvveaox<{b7EY^xc$Mx3R646*5dt#k$k#2Lj!FCFgjAeuwjzMt()JsIf;5taLte
z;EG>-UZqn<US+_d^O(WyyMKTj)T#k(W0EjeHjl;%`migmG+0M_@iEM;)xO(JAiq-u
zN^;ju6^IpALZ86Qs^&n>V_hNyh}qW<eIZ-N2L-pZhrhtghrf_g-eUq>7I=y$CUt?C
zf{=Ro%6oZUTKNEq**sTl>~UwAxbSLx!mg^PyS_`s5!+NEouW?@@2V`#dpM|n?ni^v
z^wMPFzcEop=(TIhJ_UEilO)cpJvbom$6-BmJ2m228guQjASPVb8lO6^HRc94m)%i5
zG5D&m024Axi~p~wY2Tx}`r#Jlz|4VuB5JzHFDUxOg7aWxAtAVFU{!Z~vPf)T_R$kd
zD<{vGjt2heg8@t4|A}irGrYte>Us;xT-?{8=Jah@)zzqjH(z9mA_snNXjY}&)u@WO
zW3ue+=N9;<;d7?&k1u-r7d;ur-@lqXF;+8l>CV}P>Hh}+0RR6anF&18{~yQa7P*ax
zTp>5PBAFw(lKV=glqAP~CE1t}k)!0wZIaR<Ek`N7j+J3<AtBqEIii|v$(G?i{U49-
z`}=x+Ui-d3pYP}M{_gSkejeW#T&(n2pr#IfbH%Tzul+$+>E+pmOUp6p?KgF1YJ%{G
zR{gGj(H)c+Z=jH3)EyIAy*{^0#i$F!>sYh|;ko8rL}9H3g+s9e5$^hz+!L>>B+eEJ
z&rG1t^`rk#?EbW9%F?U;_?VPD839}W#BYC1ob?{JlG7En5^7j!DAN|T6l%Bv4N^eY
zj*&$+>=x6>{Rg|ercN8{<pSpv5O0pr?XFQoz>e05IJ$$hqqTl6@;lCRwq=Uk--pY0
z&rwt2n6PUUO$OU=Y3ZqvIppqp7Gh`^b1?>WAeJG}_jPWlG_fLisAD+yed~--tI*x|
zt*qX!+<#JK-;rZb{r$H1;7@;lyQJB+rgT&oklHH@@<z%+Q(Lu=x0nuQ>wF5DVr_h(
zVGT*Q0v>&l&GZ%8-xh!AWytf)r~Tj#W8-ZX2TO-nS8OLRKDuk){e`@8WpAUNoJWS7
zdtP2wRR^~{LrX0u^Qqv3`TyX+dY2e4Jx=y{WgaiK`>yEfIpN2FuZ_~5a-WFb&`k#v
zT`$-fysVA6pcp5-_ADsCasGqls?2B4*4N3CZm%czNz}&JouAxx<*%=`@^hq}_H{(O
z$d!C+Iq=lq@l0Zk%UHTL*OaF!>PdFRWy{rKl4tAf+&1;|lX?>JajvsEen%f2bGd%4
z=<d99<R$rm`ViS#|1SNgknOfS;BTDKXg%@K6G1>arKG_3p8jLflLJ6eY6<tcm&*Dl
z8Q=ylJc8fgXZOL13?XPa)>Q`{0W$c>XJAhX0|9qmUcI5hXYi2}CJpRQDcN_c<P9lI
zt$Xk&JWzlzWa6{lv>)n+9pr`w8o({M4FpJwWS*GspX#ba-z~zs^`7#?SRD9oFrEJ^
z-48(Ch9hJQs6EwYB5^HxqqWfp#puD0SAqz~XEh4os+pR--oV|6IxTd+7W$bMT2Kpp
zz=b9x1K9Dx`S>xU?x50)ax(ZBPUlLte~L7Q<VMTpg-UemaMG^&PMq-uRG-2fIA$Ih
zY_EmBgez3-DGac}XF)E?U(MFMmaQ3)t!bOBiSPy_v;4VfE+x3g(wo}QES%1BxVkt-
zS`rh5({ar7zf2oAgG`NhMt%?oG-dnq(*~e4?ZZ&Mp86hK<fO?@A3!L_-;<`T3{^i2
zoyzvVCyp5)`&KcV>uR$7!)PzGq2QkS1YCVS+*BMR6CxviaO|T=(Z(tLQ)~CmeR*Ym
zT_q4k3EkN^<xn3)UzMOtl>u#P)KK}Wj?k*(^wrsX|2w%rTdNwzmSUO$^e(>n^cl#|
zSBWz^Yq$F0=Dz2`cu6l=hJlLS*@^P$yM`G2l4%u!Qwv6U6x4e-G8N&5LFgUD@GZR|
zM-ZaVzleAi0nM2Jit7-1PK>iPCYWe^q+{OnW%_I`P!aKr@}>-UTQJQ}pM}ybPeKLy
z*Uo9UuZ7ENBNR0-wUoFN;7lg)N*#017FvQ|v!ws3t0|Zcqqn(0W&76>@KjZLdkXv2
z4Z6>S2c8;AZ!co&D|hLfM764S9ZzM)XmrixZyJikv4M)d(RPj;>>X|ISXe%B5+#;L
zjD2scbRnTQ@u6|oo#Twe7UM1fOGcty6|3Vjn;^(YoMA)5(NXd*SRGL)OgT|_X)|GX
zEgx~h5F_i(IFyu8mQlX6acp=kqI^2d1S9Lh_*)F1co9h&7;1lFd4>zL8o#E4NK(d7
z)nPUikrcp|-TU=0g6EwPtlNA^<aaN?^|jPoaK6;Mg)E}hbFc|+uSpm*@u6kt5<GAR
zQ{na)xSAx4mwb=xj4uC5G?_dM>v1MH6#^265w#u#=5HzY)cOw^BQ81;`b>Q2y{8EQ
z_=7x%iv|cORTwwLjhw_<C*XNbyZ#)k_%DQTa*M7pR${(yW6`YvF(JsPiz1jL5q=re
zH8h!r{iz!uNPnqFn5mFRG(HcL8NG2l)hz8athbDC+PFjRQbMywoq6l(u-arrb3$y%
zcP&mO%){wRE(C@CibQ;nI6_z%CXtLd-fJ>Z(yGT?j22Ep%yB~rZv{Jm=m>1ksg%}B
z>&2pMiwO^G&{4Q6A8a2<uY=Se2!M4HA{=s{XR)B!Y=JR9%apgNTrIv=z)9nuFN3!i
zyJ5TV$Y2L*sDFjoO>l?sckKk($G*R#hq}J>cKxcm7aTv)`?CFcz@g9cEwqOAh)Ahd
zKf#f~$-(hFgE6zSZ(c<wMF!9HZa(f;{rk4%S6#!Pu~Fn&n;sNCVdggi-F@3AbbWiS
zS6e`a@U;Z{gb(~*1a`aZ>{*Xn#WFWqT!ppa9DQuLCa4(X7<_h2!t!nI*T%TX+y=E9
zQHu78L7EleRjQV6&v49wCwx_;2lkq%#WCj)iyNu_qE!G!!BPqy4x+wv6}IGohx1ck
zlB&3XSV16%k1EMUNXNGKe@fK{?ZFYaEQm_xqq>lSxqwIo;BiD9DOe7uPmSkWf2Fcs
z%6H!(rSE`MG3w6QPc2j9$9rqzPdic%+$9)MSLW{xwckRR2ak-447E2R%uT8MOY?S1
z^9_hiLB_8rLU3{HjXQ^_BhG~2Lg4seL_DluQ+fRmh`>`E`#Yum$suIxq&>Abp?luz
z{@7Z^B^|Va3VMi)Z>m(2^Rg=QwhHvN;=oJ=`Ghl|nYlT+sBl6Bmv}vUb5feRPm5q&
zMDEaqV+7Zs`w6a`E>oqcI4y#!Hz4~MZUD>P)L18g2nRVoWJptowFp7pfcaxM)gybe
zk({L3v-KLT6gV<2;01_1g)6zytn<i8fEL=0tfh?R9<=bXu}a5z`&jYyc-xVa8sJ1h
zTBk0-pVJ%PKfrCJ!b31{h$K~jynWun5h70QBX9cvN|~F&S(~loZMB}QW_U7Z1f_of
zrizibJIFjvNKmHO!$k!iQt&JYRbpmCd?Jz(AHics{ltHkeoKPFQ-*w~yL>=Uk!AC%
zU*M{vwYVky79kfYo-f8tw|!T6Q5-Nm)C0RG@I7e3cKtKlW2J$1KGOQw2c%(zSn;Al
z8g>u-7})dHUn0>iOV7`vT{zQG8TPgq_BI{%=74<!`Z9h(wSS`2%B?u|F&9F<@TnF;
zKJO_4e@C1puB>D?XpsS8iEAi5qS&V(oidTn)Rp9It&8w?2CnDU*zAEe%R^adRbA;6
z<zou+fZp-}e#*yEWNCpI5B-7){aY~-&dd5wLrI_0(?_O7W#8yGOO)sxTI{=cwt_81
zEd|M|zkGnJiY54K$ni?JHMb>0qGkm7*i=dGf_1^LBWIla^Ly}u<z%Sz-Bih8skR#_
z%^8O;!a92bSyab5;>7T*F;R-fJ38jwzf2!*s=R3O4_vI}`yCVUed4SG%1S(g7QNl~
zSO+?dlxoeFE|PkYr&oH}Tsk{8x0yV;J1M%$a8QrZd76L^n@c>oTW3c(3nEAs`*b~5
zKn1TvIh^cK$hLK&3)nkbe=fLxPg!Y@axu)JFW?_MK<eh*-zb2bq=<2`>|0)uRFso5
z@k(CwJ1OiMan{FT_BTQLoig@?K>u~aJjf75Oo#Q+X6JPYTS7INw_j;Ij_-bVP>&;1
zkF54rh9&{eVLGkok!xkx<AUpsa%@jd-jNi@0O`Iqvlg`TOqOlLoxJ}u*y_}p(4jOm
z+vpcwX@VmwcqQROb+mV7lgVEp&v)NdarDfpe~R;VUsB=Ug&$KlZ+)BD-5rPX@IM~?
zF%coZ5c>W{^)PPY@4~08yV6p(YiYd}XLKMV$Dc#aXm0djAMd;)J>DsltDIaeq@f2U
zA6ujEniDu(Qq+zth?wI0><jKcJ**_=Y>h5N0vas16P<>|8N1JMqT*$;yv(RoG$*P$
z;k_;IIS2pjC8Ox3FAm4t`<hl$3!W})BANu3<ro!^1<Z7KREPD&wFjb=iM{?9si=-K
z%#NJ@G&mPaAvsD?t=!il7|yNtp^Vfpz3(hW>LFB<cWnbE_j1}L0FylG)8Y3hA&Kxg
zQr*47+I{1%)#Mt(2QzBlVLiI>7x=u!@W6};ti?TQn9kBz)3ob2W3plCDckP$7#AaT
zt#R%!!{7{kdggFYcwtnPZ>nVlrM?;ec0^-$=i0R<MOn?QUK~E=+@wpzj~EnX)&1t?
zr$=Tp^ZnPJxaF$P?k`nvE#RE$<)5`AhrRy9WVgv0`$oV~^U^^PzE%&+(zT<7d}gIz
zv}k!mc)$BpcjbxOEtd+(mo3lVeyS@6s)ZhyP5I3FG_*YTiSTax1U<S-cHMDF#QV*<
zzWuavthEIBz--uWwuP8fIcJi{3F5VwiS_@MB5nv+-V+T+FP*4Flph+g65+6nRV51|
zr_*xSdhF-okn~x}Ln~(U(r3K_-D}*Q+Es|An^g%#TT0K~&~N#E_R2)fSe<}ybcSAw
zoW{>^o0?(6bTgh9+wjt$F}d%p5B)Qmu0V$~=lA1|O|bopw>cuSaN7H>^ZI<qbieoA
z<|w0))KG<@uZr2%iuHN}J3}keamRA9ugQQHbYVs#pF%77aL054?qb4UA7HWHnIHAN
z3rBs83c9;^0(Yz;`<j{bLX>vzjK|&P_XolwjYcv;D;0HnE#4kjE^Vpi!5!<9UQkfn
zSQ>j~F5uYlekr7K&7kG|+p(otyV_yt*rar`QJGnQnD`&lYD>X<bW_1xta@Q-Joc+q
zLT<%!Qf|f5(Q6EnMGSP^;#b4|&vK~0wJURFFO2{Gb{uED9kHt3$uys|tPqPct6q(=
zo}59xYG$1cXVi==39LokYG~%uSd;B{Tn%=Dcu`Z=^Zz~)9wxpW3$YiD7SU@lJz2dG
zuu@;+@HRtc`xo|VzT!(67Jt3Nu>ieC*sBsEemOwelq$!>o_}-XSU^VwR+X&iObvUH
z`Jdybt+$yw?P|{->OI<go=Lc)mA|>*tr}l`*;1Wu?Vbf-yj7_mi~6@}wDNIg<1&t?
zvvij@*jN!N;$|Og+Fa^Ctozy5IOoFDP$>09nL2MLZ+FRx%xiT}=WT4s5vC+4M3Ot?
zDz@ZQib2@=lP10>t$!fYDcxO?fGv?=9tDNe1$7s5F^}?x)R6{3$Us5ld%loET%DEJ
zl0li*i=aKwVO|G?{Nme9>4t#T#mKM?*CNB8Hv)E2?ktLN1eCETW>;_S7eE6`kaYr(
z=~A#z`4>zfnUET?jtw&1pKUL>E8YW{bc<KA%TDgs+Nr5y-pL~?Wq2W<@P){6brxX#
z>tJp5F|(_ae_YVB(C6NBIv1`cK8e4Y2rk2LGkn{=$AC*Qp$y-vokBzY=|lcOj46qw
z`WfV#sJ0*x=g#s%<QomvRVVrs;c$pODH4PnUc4_;bo6ISP~gY;0r{VPpKV&3G$tF6
zmvE45@!d=u<T`oS%^ti*UbOo*Y&8t?tYnBVIWlfy{;U)2O(i+f6gO>`jS+dmv=r{t
z=SC`~VG7;i*FbyVy&ebZ91-qBcTe*$|H89No?n=a$i^&7hhVfi4|ySzj^NA#Xd)8i
zg8|4iDOdz&IrwFW56K5@kZJx%wJaDf?cVF*YigOWOSF61of19f89nBKG&c!yMF6r;
z3Kqsm(2yZMCRf-X3;mJCSulRuFekw{6Ly(4tlcTsV}7TnHGrlkK@JK)=19S!ISDc{
z#7E>H8)S|@QYQ<>M{A(P0BsR<^Gv^Ay{%WxJHc(VhME{;1s_p{tMeYV)neVOt|k?B
zaXnh7Q>42Ufo+vy-UJa331BXiYcX%~6JL?$xR8m0?2E!X*LazI`*#|7V3G3L|0p$i
zKS?PO3sG5j2eAv8UaRt#No?L?ujCJ|&mrSaCab%>R^9D5{Dx9}Dld6}Qf*1U$$4wv
zBW>1Go1Nz+NP&DRh^|<IcY}2D^v4^rMAeC0l;d`k<9e(SL3-8c&WZe1bCCx~%|faV
zy~?I@!gWV3KbfCW9ZYxyoo|`QXBZ!{fb7Wu3yAQ&%J!GcSAw))-Oj<Rcta6iq-+k=
zix#ZhIjFN^k(De;t`3pGT$p{%T-M!rpS{<<)6?~u9C9)<8A}d1M%y~gc^*=6T^=+8
z8@4cpS#o$sJu`Wq<5A>3a!3=iM0>9(C%HS2oeWml0p}zy_E615eAzlOyDqpcZW;z4
zhZHiWm3QLUm!H%{)S2sqFop-F6PoF!Utb~>+X82zvGI;6)XVGhqCjoLGg7-8vNe^;
zzdjFLKf&86(7oB?4O|xC?B|hUPnn0@XeaW>iFR6@)7jK};>1C6VijC-!UMP2#Ds#0
z!sNsb@|F`)DU+I$GyP(3TGleer{pagWQY^{pw5olZKk>I&OIqAXAk+0vXgnpL^!TX
zod&aI2U#vJ2E9AZE~bihO|^f7efzaOH#Ywb<=P2JMM4UxC9%*yJS>z35kuL!h3qO}
zgYuO?be>$cyyKy@60<RrPB+vX&#(9t;vburrQ6YB$3nN}4rM-|H7m9J5K#Lfc67_O
zk1%E8^CxWx<uN11y=7~#r4kC^{c&d<US<EE>PHpp{BL>a{{IBeTskIgng8vzDMaA{
zs&rUvkY;%Y%Qmb~@?(5FkNOh1qga+KutXfESrTojbj3}5VgyHi>l4!xO4N$kPP{A$
z4Tx&rngSPH?KJ8n{yvB$VZicKg$Pj`zr(9)ZBRw{``Ro|Wr(~g<TC!gL!Qz_`o-(O
zh><d+m(o|nK9HxxC{WU*FW8_ebEhptDSc(^cLhoU^aT~VR5AM`FKeF$M5S-7GR0zB
z%Iayd-SThu?#i8g)XE)aRmeVyCJkOyI966o8DT%ZxujWR43S$Mat~y9ODsM8!Y)$4
z#0m|$H?p)$A$&_ufu*N-wn=Gq-9p?M`||1~6G%e@O8yi3#*yLC0J^aRCA^e<my^QZ
zKWfO5Q-|<S!U0Nn7F##3I(;E-<O5?Y5Ov71e$+nv8)7AD1+h{IhRCX*a&e=0n&q+$
zTOp^~n-;5#8qq<adq&fk2+f`4ThH;^p9<XO*z`g4{dwE2ABd94rIHiW+dmBwt^H;(
zDC~=nOpmVaRoTh}*o4QF!Rx<#zFnYISzwh|_;>T+&I!e<zfauIBgRhCJ8tR`?WgHU
z&mvjaf?aXj9iGBn<va4*APU5gCFZijlebG!-_7q&=A|or_o!96#dg%#^~CQr?J2T)
zESw-c=QPSw)U-{IB3s6OR1m^T&w<jbGufJ7_!&~sX{>#1jOusCcb(fA)en#FYQcL)
zMlV+njP4|9L+1V;H#k;jl6J|Dsm>cXD255WtN-y_<b2(A{I88R%G_F<)^<8Pd*71(
zrYkL+YXOCym!@kxaBVzVyyNu}7z@c(XPG~j-s;*P<As&FnZ2#zUE#BGyDHRw#!VY7
zb(1Wjjtlni`ie98zZ}5@f2n&X?3~>maQ>-(Bc!|vTEf${y^uVq_(1>Wn~00?K5cow
zp53th;u-kEeJO-p*gEj_{;QWwaMFNwTH&>GYOk6?{VTL{1W?Tfe<b4{hb^65YDq4N
zPkXP_9b+gvHGf_|z-j!|pP&4(kj8fGIj5Ux@4xI4MKmIk?zyc!{@v1vtJ^Rw`aHdI
z{(I<5#%@hsgoZav{}d;po)XSE)e+7OK{ot;oJ|bGh=@J-wQS<kw(iy_SyuyiT{B8}
zLjLgQLAEen2Q13~ytInbyPHAq;$v{5iPP9-L%0mzC^sq4jx-&(zNXrZxwyWj0C%47
z!0wSW+Y;0@B8+~}-OLUDe2f`#+L&*2fD{O}(n$#yxfKG#V(x>w&{&K+vD9m(<-wM%
zY%M3=Zl>uU=ETx_CEc4mWkk@Dc|Xcr){AlQ3!C4xi)#obSVp`u47+RCl|Kx-;S3!x
znLON;U&ub?Mn9;6hyB)Ix$&Z;Qiz9--#X`ng@vwHNV7FSU0S@TX1*>9ZuVvVu9;gU
zW+LD{3dF+r*DE?mt>R2Q5GqIa%1sr%u5>KSb3F*eE*6KI38VG6tq!Jz$CAQM+w+a~
zl4hi>4yJ@NQo}XZe}K>@M4^Kw-s?a1ql2-{Jn%o_a8Y5j8n=}|+VX#-KsQbXmSiDq
zC6Kbbp1OQ^y%K~rwwAcYf?%Swq$KoDaUx1n^_-K2DyIq(p1LKbqu>kZoZ(mt2EDGP
zd^wbH?kZY%C>AjsTZo7;98E&d!@Ijx>YkJ@UuJy0iat0LduNCdz_5~7LVU5hZ;UxF
z{{nHyY_xU>(QS2qn(cSA3p@miTk?<ZVy7gAO(5y*gw>dbr1*}hdBZZ|hTnAl7vjd}
z04+!YGzV?YeZru2Ic~+duIABl*l!>kEjz|Y7-vW%Slf)sy8r&waq)TG6O9DxGry7L
zD=g)4M!MvQF4Iw^3+U=$#&L$r-YthS*jLd?LyW{>m>OfQoBbC4X!D2p7|{DpL~`5g
z%<nmqaah{PF1?}^KHY>{g1@=%Lc44HIpyd8)yjJO=1zfj=b(<)5Jgv7`$~GY|K^0u
z1QhqYKcJTtd!haCNctt`${bcn54inf6Hx+-5@;rV`%+()F|bE9KjJ}KiqJpDv$oHi
z?=rR)xYRd(JWjM9cSW>6{ii~nFkT@qhqauN4Q`?Esr3sVMc6t*KbrW^Q%^%Z@WR{(
zTLXlOssS%0oy-`Fu=m>9zY;b(z;4PJXEzDYvBG2vIKdb-kkyHr5_WthdwJu-nU3O!
zXRGOf9j{-=@^5^AZt!}!gEnq6FOFZCIIWZ;$!t7g%MnuJ5tZKoK0T?jSs;TCBnJg}
zFz0WQV+fbvGvFpU03?TfzzT-cB@#AKmhwm$T7=7a0rwO)ke4*LjLX@!oG-Q38%rXk
zs00tFukN}x28eF$dh4QYKi=Ne;#Uv4>-x5|ILheAOz5soVCmG6m~hjbL;!UrF+Y34
zL0i<<^W2%DSe1@bIF>wkI?_ksl_zb?RQm$PGb{7O5v;H02lSC;)w5vrciJvje2Y?E
z9QoFeUBC;K>~>vs{Zjyf7GPbq;m#lfIc|e6tgAyxN$9#)Nl4S~x0Hx_gBe$v>mRSb
z1s&4BC4<EzJhXhsH4PDQVqpk(!>-N5-KpgBzVDw5Re~*F-+mP!mjl({?$}>j(imR(
zKJzj{ZiIfcd@)RUa1h=M=w_Ah(VDLJmI+4`mn`ZU)CWRknt-SygM)$V*Cj}c2Y_>b
zeZ0UEe$9YFIKpC>em!q-5eS5$hX&ISh!fWbaVCR<vBf3Rx&~r_Q0t<_ESVEV+$ZwK
zrGDlI=|2iY_Xnb%1)>E5(JRArp~FzF9-Wna9{P1;Z~%~+?GK^}snD|hfY94;2N}#2
z_mt}rU`#(5><g%7`v1<>%!f;6YJUHh;H-;&Om<dAOG{!d;dC4_{X=Oke|V3`deU5U
zq0Ts+TX1y@JWLX^pZs8hV|&vEbfJMboizAj9vrL#Rkz#w9MY(1^FA}%{{l^0d+$RD
z99Lfe_Z7#ykgD^&@Z;sc#c*H6<MkiD1e%)M^lK(fsdm>J!A%pni*k;@P5Ci(q$v<k
zE(=)R@)uZNz0O@EtObwb$Gjp<aRCW}Kn5R1f(x34jr=0@@Z3pkq#;~{55q+=1xTj*
z0F9LC+Z@}2Xz`g6pKH2Nb<qvJ9ANx=q_J2X1Ga_c;3H@D((sW+2t9QSALR`|d6Na0
z<xOYorQsuu5z*=x5y~5TN}MjDN|0`O8rp{jEvmXe@8H*tAQY7`3+fnGO582r6~_*>
zy#9GHzxh>eW!weI%Y*V3)FyJgLnaYNj{i3djv7j9_hIXccMa;G%(I9h<oLCJ%N*a#
zoYzK~XA%`9yZW+;QYt919OA`)h3UG3qk7U3ZP<q}%#On-gG^#QXE{r=Id8k0FPI(5
zD3}v~24iGZp!acW{~u+o5q<)U5g=~><PB%QI&->&V>`k8RvE)CNgaXD#msd!?9FvV
zbm3`&>-_r(-Fq_<BBWps9)a_KU?e`66G?;%sM(uQIa$O4ckpVq`E6;~0T<dSKfv=g
zTulac>EF%4ddT;D0EtX<dbYU+tyh^4z_E?Mup#n2U%)8STr|tPk?f}0Q}G%uwO7z*
za48wsBeI(fkmV0(WtsEQ>d*_BU&U_xbnu2Ij{8hQP14`Uy4gn>ln4H~Eb(Kww4>}q
zZoflOhg`F{_n*t%grPw~<(CSc#8|?WUu4VrFO}ioinW)av8BFIht3L)eR$ED=>fy8
z>iswsD?7eP(PN%K2q(D{xCw==>z$e~=T*HpXq)=5YwK;57Im>2y*R<>efC!d$HZp`
zvRnVgr4eAuPYMUtc0K9?&TK&@IUCQ>9kDm5AEI&Tb1uTIVCk6pU9kSo$ml|BQp1C5
zA(3;Ze?~T(-a0!s^PE0_PHOmh1U8H9{Cu+o^G5Nm>reQ(t4|lajvpwQ<=cGowv}^T
zMR48EMd1wn$03F{Y?-MS8bz02Yb0XxEcRF6&-0rv{W4C}D<Tv9sLkrvh}5rgzvP!*
zCl|zLv@3P{+XVY`aj&NS1$)T;M)FN=_n`PD(<wR+^<|hsR~kp;>T6t>-`7Hek9ylb
zSecl{wUx`i_)T;V2?>jQrZeT?e}LAux_al;{{R30|NnGXcUTj_w+#eC5kdf^OOY<U
z7wL#fSCB5DHxUC0l7t$Ojv&1#O{!7?(i8#&4MnL^L=gi<njq34!3b~pz4!im@B8NL
zJ#+5d{bqM(cJ3YDf4J1pUi+}irEGnJcMa{SHs-+=>yk>}>2QP#Qk}FL=;TfhQ@pV0
zp+M}z{d7@R+T>K<^f3IYl5JyzQpp}Wj{i<-zuGokB=>mgyKLy8>&q+~8~Um{kq^^t
z+LuY!N8N(6-;-7gUXmoQ^?e%Ryrww@noN<qCC}}K{sfvl3(1FT<M$?Ls<@aHx*mbe
z5ts3MYDR_#4UMvPO#o3`#J&c_zy^$(qxmx#wR!Zw>pKH;myZdOv5tbf&kna)eIkFm
zeI8);$@$m|SoQqMFT+-pu2{$93&YkCv5rhoA1Rgm%5k?`5+H;qm|=Ql#5D3*2Hm<y
z67?x8!?(I7PVMXcHA+P&uI%%=P|b|NEo^KloIbb<I)T1Gx34AXfQ=38f~q;{aj%6o
zzMSbrkAHB}TJ=&82+6#2+;=OwsB%`ztThx;()I9(c4)58y3EGmXUD?&W);_>O8275
zoBwI3bs39w8J0B}SqEPuWd~pK^t#7;C0pOUQyW-hyEXMS=vDKN8@}&fj>a1mv8-tE
zHH511uiZs9j$Zwu#pnJyif-yFgN?69%jne`MNjZreE!FM8OMNGzgtnStkE{4x-<1v
z(%H8>>JVdC{u@99J=2qS;JB-w0KTeUc9RJ3UjSbKc-hzx7hhJd;m@p2fx%m4KR&py
z&Km9(&Fu@FpN+lY$7)@sLq5^CypF6*-e*0jxLk4BSR*7XO#P9m3~xn+(G{(V&Q6<b
z75&QWTpSZR$IkTEvih?~EOEbkY?!!}Czuer{QRHxZlv#Lr{>S`rICXMe{axl7%|Ky
zjFz%w8t{q6{}W=E6=G{K(DI9w^ov#S6HJ;XXXy9|ekhF;jlGKab2P}=(yQbb`yM*$
z#?#W<R?5;}%2M^8)&>b|1XPAuH{bF29<OmG&+)4`>v1NV@v9$8&$r!%@R%6zG3FUu
zUEA0e`Jps;y_;Fd+7-fcDs{-kre=ZzZzT>1m6MeQYZknp-XS?e@_3yC22{$&ral53
zb-+N5-A_kKgMNUg1qgQny!C+hGvN6K*o>Ni$8VUG`h$7Aew)R|Vw=;$D}xq754M%~
zjb(mtTfOKv(&%45?0%9El)4g>I`e~@^#}JR(*T|SUBkp6^MxRDhWK)vhFyXuZGz_`
z=l~tV09}BFIQwpr!md?CLG;C8DhF!0q{jF7R0!$HRa+NT+^~FY)tR-}a@oYPGi292
zGjO&@Chl3hZqjk_!^`3I9btjQzIF56KVI@Lsb4F!H!Y#}+J8&(y3ZEf4Km%ys$a>-
z+D9#VX{0~@t)2e-C^N27k~7yId&?o&+Py&Ttl1|w_aqs5N(k@bWLcy6jJjZzk$b^t
zoOg$u%&8D|K9}eI^AU!d4n9Hd1#B`h=lhyE8iyC&DH(C)^4xInaX33<?xD+(KgK*4
z$jbji@5bik;tzk*eAglel-=jI&1brQI%Xc#!KQo__Z<z^atKX@M>18qW;P{frhFY=
zj)|`|?>qUn!PkdB2NZop*DE_?Lw(j;NALc1@=d#<BS8R+XT9>~lBqRYx1iREEnsni
z9s1c77u)`poxMIqn>ax0lF6xW;)ECT$H<wSEftjw%BhH(`0@_+!(s4;12^+E+u%Cr
zfFaN>q{YF~;ywq-TwG2G(ct_QBs1~Dq2hhh^#soh=)lEr4NkME6r;zUO(Oheu1fq7
zdLdt><G`B<a(O=*zq7hnzQ}$5B1BWxH1E{No93+>|GMvxEf)q)a}t)nRu8M4Iv=EY
zC+-b@tD$R}lR;j&-NI5$4oSVC1)F03F?8FsNlwo2P|<$&b6@RZqRaW?4rI=4F6`_2
z6#Igum~MgAkLT#TqjMagl6Pv&BY);>Uy|?Pr>Vsm-l418N!GOM4}dHAQxyCIT&4Ue
zlK$&n6FZJoWue(Ep$aVZlQZR?dsSM}s>?#ryiW9!<61K+E%3CKec`IIeQlO{R!gIt
zz9zsmHaU*gVX05>_v;Gfoz)*!*AM-sKOG3Z)y{JJyV~kn8_lb4kQJ#zi5D#q9`dp!
zgA+SRGP0CXpeHTMR~a-3<DZr{P5D(ye=g?<oR(t4_@?GA^F8t(VBOXJzWU`-=ci%P
zZELkcWfn|id7hd3{OZz!?Cdf4>x!-AL<{UK>!1e&A4lsQXVZ^9yu@c^6?dyRdPags
z?FCj;we|m|Uqeal#%WEm!pR>w<t{m|5)fz4<;dQ?)wcTL^%+15xcSv|s(r0>!>+6C
z`>UBY=l$7-weWBErUSm!AGB_$C83=Y0W&aru$z}kzv)jV<&ZGpyxrN`jT`>t%qx+M
z(<f%Hj$IA+Pcmyy@;Z*9Plc7)1L?PI|4hy4U3&rA1W;^X&x_U#`!{Xhg`<8#|I)P>
zS?XV2q`MN%`|yi+Y0-VcA7)?LSt*IqqBcf9Uwos}^dIKB(8|LiOaMM}#?mvty0i#x
z`75eA@7mk>U+06&4d!uP{m9Gj+p*b-bEA!BKErKA?p)q?xxDWF&(-&C-sl&(!7p;Y
z{SSvyH#kM2)V=Pu4}Q7##j4Z!clGxRb5`q!<d*}}fABH3nsXw@uXGOh|6~B{!F6YW
zgD>~r*e?em$Se8bOPb5@ZveCh=FEWZFa8JEeE_-xb7z6>$qK*ClYjs2|32|eFbL5+
zIGp@4&pL$tcl3@FrBVKE%s1rkKF{}4x~WxuS*S~Zp^2=8Pr-tF`|MeQ>);U=7W!sr
zy2x4}K>OS`W8e`5%NJz+Z8(-=#$P=&Vj!nZANp34VQIN^{q2$w`%xKeoK<np2p+NN
z8C)tJm6#+rL13lXHnJlnB$3^PqPXGoVcdy=KBNTI?f3fB#uPG}3H3Sy=~_OS%_yQy
z;|7P`J3_i2=~@h#O?tch3RM!O$Apc&%tT06+Ac37-xP|PGN#g-P!nK;Xg87`H|Zw<
zQ%Ghtr_x(c>4lDCbI6JpqnHx~W9{qs!K8tFvZ4i*8>Y8>G3qwEp1>n=uz1uQOi&&=
zMMziP{#i&47K)lPrP8tK(GaZYmPc6$?&v?-y$@Cxb;62c-tImQ_@ga_DPg9eih}k0
zW2|8GcNQdg$R;dQQIMYhnW*HLk_oHDk{1#?Ry5l-=G1KQD5k`c`)qo$NhQ$3B<kc5
zfRKW1mD@hrBf!AV0OEncmrDjuw#BTrkkt!T*pNpFm(Pq18aHetQI%Ehjp7-JJX*b%
z!L8fOGyTdPYQ>mYWIyUrm|gKg(fMj?-yd|FbsD{w&q^SD`xuFiNVlE3Q$)G#$ml4b
zI0f^mj?^W+Z&tL?xe^$?p)CE`n8W4`(Jd|>y~%Nj0u9Ey->U+5i~n_eN?MSIn^JbA
zC|9=f@UhNor$#qSGc!t2@z!G0_I)Qyy6A1Dp-+1$n!mEje{o^6MOu5hz3!m+hzM-9
z(_DO*WmQ{^SnG;p>x$6-UNu@*Lhg(i+!@of35Qo5;JE*;2)C{n-x*ssD_Qw9v4X<w
zp$w?~XAfFjp89tRP1>ECc-WiUmZB8M^*-w3;)@6X8&X**<m?Z|vwzST#Y%7eA^{EX
zUDWoz|A~_QVN;%~<pnN!Io+Po>E@i?16#U!KlqUBo7!_NwT)?AuQu0Q<7}sG;kGW*
zwXbR$Uv;cG*}7zbH=Ghff2+a=;Ai3BS0ZWCW?utv*<Dq6uV>t(!bdu?yDW#X>wG~o
z`z&wPk05iQk>Eca-85k?^D&+GdT7FoUUajOAag7OEN}FH!vnXpgtcd)zlVA&_I|rW
zR$i*I##wZY^YKqR{4Md|eCU8I&@QAo!_u4^g64Aj?<Ft{1VRTk+%$L-Jwr9_J<zzf
z9yAvpG}jjY6ROw)9^PD)2>%1xy*x}!^NFI*pAS~-kuI2L>7~jk_wacUZ}8U^%zH0~
zsqS{-sSP<49gis1{Q0vAV{*{R;Z4Qe@Is1?Thv$|wc9I7k8bzxFtwX&en<*BB_E0#
z1Auj1Lkhyzkn=~@1N3xM8c;M0RBXdvh0$|cU{%?o2T?I+$wrJ+cZLO49<mWwJ5S>V
zIC>B-cxQo?hHNCgb&Zb728yoek^c!80$$L6Ass{(;o2HtC;x=u1(ml3Ajo^crI6!%
zjNWIwAb4xQZo!Iy%mF$U4cacf!WjHqH#+>?3c_lS@{L0yI-JyT@!u`>Xx>L;8}Z{Q
z*q8{gD@&BNs|(3CLdR34R35fy2%+RmJkmcnUw|}*Ow^k+qVh0r`!)z4-=>Wgpd~+m
z9M6H$Wua5}66LKGUh)Ib@f<|^+X+q3WKGO7H8Ax;a6aw5S%x?Mxp<2#fc?fdcZtW)
z^WMgf^l$`C^3M-RLvP_N_-NEe*x&eD<1L=CAVp~f7-Oz6MU4DQIoTI{*}Y6``7|^4
z%!i_SSY;A9(&gVAJrdbAn2B114T~u64#uN&gG+q`3JR`$9u@)b4%#i>Ohlb?6A;@{
zJ(T^{vOaFi|LXs_New%C3N~J@v{wT`M+KM03*?ktn;tKx-K()%{ltJ)i4l-h7<W#V
zzpY-6F1_{>BVfV0=ch1U{uY7``JjzvSpHOi3VDx<(YT?UJ~~_;u>1*w3X$IBCTK$x
z(%IaIA9s7azqj03R?J5+kDO{hJOpf%(s>@C%zXqV733wMQ^TH0yZMDEb2ov>kJ_Ay
z>1T#L&m^1Ga@lwOOIRbZr=*z4xZL(I2u@nMB-bRi_eHpLz-P6IWzUeL&!VGdlwMyp
z09kFSAO8v4(*Ws=reKJ~b-A=Dunv@UPXk>#fWZh1sE+?MT@E%<NFN&h$-5lahbcte
z_7SjGPCq;R)2U!UWO+LVg~RJ3zP+qHDUSF54Av1~-9rMwu^53dAlPhm+eklsZ2TwR
zsxbk>i;jpFa5YM29slWECLy%S2tq%?=Vr8ZbtHnPCylF~6w4`%?EJboSpks1gX)ym
zV%dWn@%qJ2GbB_7Q<A}|JC9Sf%dQr~o=UV_j4pcG108f_eZC*&C!J>F`>*QB=#fRU
z_PV;oTHSoh*Ri8!u}lI-oKSIMl7tc=B?+v$eZ^cmL%f(FQQ|ebl{tX}yiLF$mMEKo
zfAkyz#gqbDat2j~>aSFpoOTWnOCNHtcv!L1hO_q<6WrwGpi^J66b?jr!`bo0gk&8l
zcdNDc0=VzIFRikR1CI_OHcwvkeEqsU^Lpf2mDttl1|Qko`ENIu2jH9BZ}JewwjtFi
zQPy%tCZV6Kn2hya)~-rqd1S`HvQqm*l|4)o!L9jTGU5fCS<D2{=42B~k4z(hO#0+*
z?FXh%V?9l-e~TTf5(zI#=4|(Dt}jX%3R(3I+Hfz5^<j8XOjnByMXYEBZ5%SHMHi)L
zP#^Uf*N9cN&!Ao35@SOdO+Sc9R>~PjmC;p(<doiG4}S&wVxxF)3lc6BT-slp+*CdB
z#fIkKmfi1{jNy0i#adf^ZaV0Po8y&58g`M2`Tphd5ap4blwR|!BM*g1pA(P9yZ)m4
zD#A6@?rZ+c`x7L63mq04tMZrCG;98KQ<LobE&4hDOhB{0fu-Ghzlm1-HS1<h4f6h>
zktS#N#p-LjE3yVB<MfNuGOCpahZ2F$8j`AAbhQ}zw7U7CmDS)RcxP`b7c^OuQSH0<
zOLb>2M!V}Q3X-I4#IVT2je^ADfP6z_3_qysx5xuRL8Nz5A8U&Ujd8zeRn+INLIip(
zI`i@D*FQ-O3J@t@|9n-PQQL-Lp@17H4#qtP{*7Y<yt4m70SGBBy){gy-AvrPGrJdM
zKUp*OTxqw!#wT()n`iX7QYU;bbA#o?XA*zntoE!hdIzD#qC!@C#u>-el^=_2_HUD!
zc*tq>oBZ*_H7%;k5l6SIm$7yfWx*+L0$V=0H>_GO^<%)MH9H();R%V;Nx>xXS&Z~7
zW-K-%Dd#CNaQDAgC+|AC-j~17y)Ne5W<P6oZ4>>0Q}}Sgk+{#UaU*?;K~jos&E0dd
z!pxK|FPp)|`eJFtl{coQ4>bp0CrC<teOuwh`ez;O%wKyDTA(&N<6XGaEjL+l+8OF@
zxT~3ng0_B|Qu*+ts><Y^imJu^@|XUZd=?g2bAERU@A6qRFJ;#}=uj^#jBdZDGLrjO
z>^%m7{*b$p^UmPZ+Q+}&smjA+oNmD-Pf#zZD{(s|c|*}~m*ZVS%GkQh3FQi9%vb(|
z;zb#g7}CS}^znO1olus76j>sz-)HFr9z9$q;=E@*|J$>nU-q5&U^(#vAc9J-W}*uE
z)mtA?;m}H<9x1Z+`NhLzle3hr%#Vgq*gDTklH|<t3-fO?>&K;^JVdXUw!ORGa<Wn+
zU9jjUZ(iP|V16bJ94Zy7VQzIM4s}VguKLkCh4begTAVRnjFD#dxFq?`#(=H4qfQ(;
zRXcPM*CF%5KF`=K)REB9A!CY9q1}2xv%p4DV8Ka(<zHdA&MX+a;8RQ%`V2wx{rD7~
zg=t_{Ar&ETbFe%FpW=w&l33`YK?b*$&8qk>^zk5rS#TO4`9HL9Lt1$@S|lR`{tko{
z2F^1xg)MeoBqIp^jtM79BhQF8gWS{h9+OL(-1Rjn)-zk9G>Z<Gh`Fd2o0^a+4Po+q
z1T!9zD)4JXN{PcwIpog}%p8;Q#7UJHr2qaxzW;;~PK9-Q0-cx_FASemB@A6(@CIi2
z9zTS080*Oel8c#LZ={avRqV<T9^IW9s^glQpLb^2d)gCRWuh!UG(2=?*&Bm$<l4QT
ziFykg9#Y)B@AGtqlYY$ro<@(-)EOM=6_WS8u(-sCM1kPCH|*{&pBwn~+PZki6y;*~
z(a2G1^OE#=(QPK-M0+>VdFE{`V7KFFIk2Tk_8`*vI)XI&cCtRs!!2=zGvSvoJR<>V
ztV57~2g9!Nl5#}1Ooe0YJr;79w>p5M2geS^R$%OD7jo+G(i~eKLAd)soSanJq!CVu
zb^9Ya(H?ltud0OF>m*x481@~ZmYcK>)C$P+;&5XQEG?ndA<15hWQ#%C{xejXtV*)?
zCfTZPztYFON<pfc;G7sp)A>kMBV0F7lwkV_wf>~(7^JH7_SzMk77W|qdfjJMWqZvW
z*C7tSkZ2#qh80elVKBf!II!-C>Oh@9Qq4!QSl}Qqth*RID{+R7q&mI(u*xKFyYO~@
zz?u@A<0I0-o(C(2nPH;Aae}elG3w`l@}iX+Da(T61Yy0;z@Np;Ko(lTc(dg9DqFM6
zxHbr!FJ|T;4ORp*!$^aJg0Y@4>g+&JC^zx~3l0jxdY*yj#mt;p2nB~#nk6SS%gyC9
z424y$uXRp@{%8nsnQ{4rW=D0w2G<pL&=86<N&g8>Km=QzF#}%QuNz$F*g1;99iLr%
zkv2oWxX*)%e1g*z!fqN8^)Dh|v?%aZB3=j~1DzV=Q`mv<qQLq@d@@d07{M^e*NtrQ
z0&=`!O}?GsuQ$e?v$!wcT`kn)Ga)@Ogdqq7J|2?A=?4%ICtl}3&=L3?lX{E^^Ry&H
zmk`{VzdEU>k1#*+AK`7HdM<%4L5P^2q^?Go=LFv7lLDlt1x^u$xGP3{oTyGive+B4
zv3Mp<e4M2IiSP`xEiOkwn2`_(LdR+x(cfUv*Z6CadPWHIp9%9262dvD$A~abL)xU{
zl&%DdyrvzfydCjVN=}$t(@t7I(@q23@jZrxO{J|cmaQ;g*OEJ#sV*#37tnFTd87?3
z@m!2L3-h+MSYI$YQGH36c#CzrN`dgKBOa-2f^%dbjpQShjc_l4#e(Q3Jo6`w#2}TW
zx0kQrG+_t<A$UiHh9w7Ll<+KoG=f1s;M(TQM5e$9&I;R{z#V{EnfNHFeVpJ7+UB$)
z39uc;yy0@VfOc_80q?Jk|C}zXwoeeKgX+wzHCA3BD$(uars66Mh`0G`GTOZsWmR`_
zV{nz{QPPG)rl;*pzp3hjU6wi>$+7#RCw92qo*W`&p6TIn`~3|nLbj<Lis@4IL<Bar
z1IzSxJx_SRlP*;^L|`8=zOkL=cOV=mpby<w+oD78MLlYN0)R!k_gnuy9m4qoE|6h4
zumI)!evX6w&VSelPF4XC;7v@+ZwD`L&`wu+&-@|jySU5-hx%97nq97u+qgYl*>#1e
zOSf~7it92UTA$9^cX2~?=O6~xbsj};NThihhQ#2mNd%W(C1Ntd#s@EhcA#>L7sPhb
zgrA0aEnZ;Ru{&L=A|jhL8DVsb7wQM+MHV+{b`Bp6cBTMF{~<ReoR<<FL)GEhv1CV8
z!v-%a?pQ)l0l}r+)$>W4zrrRC_b&J9{ImQVepJMW^3^9&j1@PfFPZsDE*HJc5BuDQ
zQ$Dvl+TcMnR@!8LgyQlc_9-BMl4Q73VOOpY#pOoq`-qcP++-T=gv6uPp<R6#bbi>9
zJJFVPw?SdJvm+j*o`iE|Sp3e7Qjf*e1G&X!|6r&8;&%{AU3%w`k@7c&`VUWe%DuSx
zo-+P7LU*rQR}d{Ynm`OIVhznBbOP(WC@D;x@a;6m{9}&m6enIt3~OiKG$4e7wgoUN
zMx754lP0){8hUNP+1L`+jWPf<V+jXAI)bw{)|)(!&{kE%$r}iH=+soW(tdFv+NzW|
zY1+kgbMwqp_!(2PL$#tlOh?NeX=1`GFBg8p3H{d843UHjV_59sK_Oysv8U4>84M3t
z?4m&-q<3^5<5-0@Ir0tuwjd^r`Cs~u>uSdyd{Xuk1f(}U<K3C4dD!q@rQPn{gcRNs
zPt}9&)Glm4k*o2r)noJ8m%lUzQJ4(58QFhs6^B1Fh*s%)Q3?}(-(E#Wn{-7pto<uM
zM=MWUK26GxQ*k|4iGoiL+b;_057Og34Z*95Wi$#Y&;`ekm||mkyo?r}l0QyQQY>Tr
zoz563B*<~3uPaVBPa6Pztu3x{V^(1GFQ)_6EU!Vn81`t>OD#b>M{fvl9}CAtY5567
zh$Z<CR}8YM80D8hc~_Tmw&>Ak&QURNwt-25SoqGbQbTgc_%-Za$PHn%mS1CpR?UsA
zU!^topR!gN=yI=pblVpIk|+d}W%-#=?EXkuZ_oq3#`WcKnC58w<C;rGZ(cDg+IpvJ
z+_29PzHJ-7`bvrJ)kj!>EsrTafp)8m?DV}%AsV_wc~DcVm++3NIi(s6%^FUKbJI;N
zU_Copf=B{hpnGa$e!nhrBWtsVpyihY@WGEgr<5N++zREv8zAmIRdY@?I_>Gywa2Bp
zk6xxT=o%_I@YlXfcUu!t*=N&_e4KN1{e>=jP5Km~jhk`WThu-;qoX7B@tV?vt;<!D
z<#Iy>!M@>ZX9`Z_(x!*6Dem4Zq)58ye*74rq9|A|X!L&~Fq%0s^@@%-!E@E~IEvZD
zBE)m)%3%rC)k?A{RZPayT{6vfUe2p<?*{*nQE;6=@~INa(ifaL_6BAY%+J~v?DJv>
zD1PkQ2ezj-f{)e?G~RURjG{xswP^%d@dLG3P9+OoG7_Q-2cPykW2~OyB_4xxF&HZa
z`~x7r-(qBrcm&a<iLq*=ExC@DpxsJ3DiY+NAzy*$-UOF0;3Ya@tTOQuaUk6!j1`ld
zG;fk;Xj2iP?_s7~TUO~8%h#OWJ`f_56iVs@b&8pXC6sqR6jHq0biejRBzx(K(d|kN
zM<i3_Bqm?bQ_cx2+UyCH(8fk2hd#9uTd<)a-}-lB`4&hw2V*sjucqC4DYq~wy5%n%
zW97LpxfrHdz{wK93ofa`Sb-NN>+sbaTfaaN9Z_vwTA-3qe09LWBn>%)Ym0}SoC?GH
zDs1uWbUrsvf#}9!#>Vl!pe-J|1!YFEIY`&0Bx8(jL79ha&JrOGD)~jLYerjgo|Y^F
z(KU-|e(L`T@2j}w$V-+1=?*bPsL_<L;C+AcQ0{7ol#KW;Ht+v8-Ov&#5h)mB?2Ujb
zmy~y}`al&*-Vd+%EkB5%@JsK$B}B+6l%&kRRpQDY^Im?Sy89L%(U3yX{ty9YSl-R2
zXzv$E@5WHHeRQpqOX!DJ91F%ImUl6fh~wjQ%2xbu3KhT+%h%l>09+7*aG^4J2AW73
zBiGXI6Hgj_SNu4a-|AV=5v}xI99^WazH8$ANfQimWGJwDc3<C>0UTKtP%57}%oXR>
zome1m4R{&y<vo^DRCbN=5g9oY507r{eEH?g69;B+q$2BHAG%aN9@G6rbv*C-s+pm_
z>$~y18o*0Co~N)U#(Tsb(@kKClrnH-8qb^U=5?3)Z3+L_nU%Np{ezi%*pBtgpG9x>
zzpr6m@)Qre*J{~vX%4(oBMbVwnH%MsJzOon<be;C_8`YgK`!B%t~2lkY=C^i`s|R)
zOsoC%MQKAJ*WN+<8ucwKXi=J*!t^BKjF79lad+lZEZw5CEcTHrqjRL)j$KI(x^~R;
z%Ubh9>$Go9MfWATeOvR$9Q1kWrPA)?m)MCZdzyV)yS3V+qdTSDPV=S?EY-%flor2M
zU0J77>QZeSAiAY09D{XV2$(W^Jp<ZOWsZ0P>4wB$n`m9l@H59;<P){7hRt5=8B#z2
z*~ub87UsHsvHQOO00960Y<34w6K&Tv2_2+L?}jP}K|rb)klw@wJT!v}q5>iUf{?HQ
zqzNJrArv8CK~W)Asw4p{i6BK$6ib4JCP?Da5(vqc_xb1jXTF(l=3Lh~=Q{VjXJ+^8
z-g`jNP6n;WOAc=gny_%Ln|((>j5xv{bN4O`;oJ6&I2JBCmM%JKe@T`9k_vcL*($}S
zQ)NUw&b##)6P`6SN+g(kHeo(hdi)|HO<$(&>Z7<*`hRM_Nc5bt1>0(_W=srue%|wR
ztRv3o$>%-GEvi($BN+I~wl=Vr0uFz=du)7PdEDyU4vk+g*aKVN0i%q~A>z(i>#l!s
zS0er`XQ+K=EY|;Jb4Yp`(}=V5BcMHP{hZYfS<88ou%~BV)j{Kq7bRkGBTo>q*pU5a
ze=sV8Ywa#gYbQ;D6-lO7k|sBNlT3Y+CXId_9S33S2}*YpfH(8Nw|MJIifO6suC?t+
zwe9mZ3Ar{2$<1ea{6AdW&FfgONw{m1@Wuvhk+J!$p?M^x*53`!-ba7;bpAM(LyNrx
zJAkCvqyI`JZR~$NFCBh^$i~}qN=HnU0oOAd{k6^Tlv*Oj2K_g!mXXe_c>N1^@CWHO
z$TQqVfnRdTY7uAPEcHk!=dN&lOR5Qr`ZHz@Cx{iR9VX*6Li}o4ftF=+Q{Yd))}wZ9
zCbGxQPP@<L%akD&aic{1Z7F@Vsr2UVdQZ~84U*4_(@^@)q$dL<dagi0$iXq%lyd6P
z?}^C!zg6C1RUa(1h1~1zBOd+u{SToVUfS<5bWUTs=lFGI^C6<9C+D2bbkC{@P39J=
z<LTm3c}&_hwYAKgm=LY)K?19qaXyw38NQbOx6y{FOiCg+pU#XKUE9b#_0VN>Z8E1l
zP%MFFc60{)#ESVeXa?Om`o&AS9(}ZSJ=AY`Uu5mN>zN<35pyVhMfqSs`B%Pg`Jh+1
zlb$|qM6pX)sY_V?zpT|I?07+3?}GS^awil0w1XmaJ@=)?!f$<1jF-E|UhN*6s;>T7
zU2WAZ-upRYQG46o#k)5%y}8o`i(}3Pw=%swal~W4%gnnAVp0O!@X=Ls`_Iae*uPC^
zBX=3&I&1G;&dSx5H+sIGa=C8UHDL7i#^k`U;|{g5nXkrAJ1$mUxV<*#*IY%4{ap~^
zYo0YSzPo0UTQ#n8Yg{Myzx-=l=R=FLSc~(F|DU9q$zLZHbqmIIR9l?ejNksUIi&NZ
z2)xX`YP@*HX~&0)`<u-XxBpx=PcV*|6b#M;Kh|Rd-zVbgG;dgrsJ)zf@x9tdS0|rq
z^EbBL4&3i_CbGO?-0VH}5zKi$qMXOBaQ&6|mos0PlTZ7Z>?zjTIPFMQmzq@X<f1(R
z$V>H3wak3@>xMDalOyC;pRL=9AIDC+IBEU_*F%Y1v~6eC(;EBW#HGE1bxtF{-_^$+
zPo523m>I?waYizXxBgG8)vu7e$4Qqz`|yi@Nq^5mQ_r*9;z_-S?O8k8ldZJ)mkQ0V
zD5aLV*XN$U@gaO>*wubG$$ohL{0%{#ocHU6&BcB0_QT2c!w<}pXQzIQULxA19HVJE
z%B|-Qhcjg&_2{ZXY|(F4X^@N0Bj}Olsw-_((vKcY=fs5!dQiD1BxY1=I35FgOYIL@
zlPE**voosM91pW)zn5G^OOkuwqsSbmEgbs*-w=J5ulQ}A#OVG2gu+N#P)>|z))&2N
z#<JrSxHUMa!HIFn`f`OUwS#oi7-N<J?fl>F1YRf$cLR{y4dE_T3$+m$A_vusF>wSN
zh*Gm8z59lcRCuu0gwJ>?<#p=T++eC;&9cb($Uvcq<Iv8fTA_2^C++qd{1P+%<#|4J
ze81L%5HGv*)D$;D={fT6x%|}B6l^tZe5$i$An8cKuV&dd0otW?j#_qqrr1Yr@~qwM
zc`28Fee%oCWm0Hach1wbIZjqu?M`5t_qevb7s+jQE{(3WC5yjB8~cA@>9W>V+g>k{
z*>E+p-(e#%sWeNq?csOjkWWkfmCt*AzMYIj$NaH~4DBfvNJS)W!&U^pVebUVcw}{c
ziSPWii-&dq1@DE@`51Hi1N7^BA}(yLtTvFt6koD!Il|k__6aJzvk6(Q_>P8mObhA`
zIMrYC#E|`0?`|Gbf3uT6fEzNWZ2&92U9ZCV*J92Uhh5mLzObqG|2cW{pV_tDjJ3zs
z9f8s3@P%W1kqevdjI|<S``YEUR_DIBxWHG5sIwzqkJNPBwMtCsSZ^^;9EtwXkcUqA
zQ}d#IZRldcAN6D5nVu7$8pfVKkNp%EH?kt|=LO}3$*`CF-iT3frm4~6#hR&W<``~U
zn7e_(Gx8y&XXI?t)6IuO-#wdetnpN~`QYhl{m$xivyVV=$Wc)U75U>az~`k$YukKK
z3DVNfJyn}B>aQ<i4!gp>dg!66HJ>3D*4U@|?8T*&(IHo@XNC7*r?c}}Ij2hfVZim=
zQ#?q{sj$>h|68)PXP$|?;}&nLJ#*OAI-#x61E4lewO=VzBPiKS1}i8W5i^J5n?+^E
zU5i@+Klp3Da2kDff6%k}s)c6FsY_odHZ6kWUDg*9Sd~`X<8QHNXK3^O?`%lv`u@9;
z9y%VePDp7!RXbfHxPI)}=64sGRTSzTy~*EDsrwxse=qTI7xC4nRdd_%j?Zn*;R;Fa
zNku2&7D>@bMf%0k@rJv_L$CNn?EGfKWs-+O?$H5<4VgEqiq(8~u=mrXjge&kit^7+
z_)_SgZlE&zZ}87I)+UQdGX563l6v=6pd#QTnC^txqRB2v<daAAgt@{AWXq#bfp>rM
z=$~_L;<DrVdlgDp?l%3~`y>Ki>hCSrnJS99Y<yvuUNpU};h$}smzKH4D%R;I&{yIn
zZx)}tIT*U{vBRyP?ZGGDkRj0LC9?9R&PxNULZ4{)so>`h6vdaftqKJP9Y~7h@MRSj
zzC3W)SGlOCJhJK|{It7v0h>{?YU!iV`OtXGaP>kctY+K{R^WS>(5YeS)BC>E+X$d~
ztB}2$)9-kzG<r8*FW(ha6zzK@+PCn(TpI1GO}#Epy*}*STv6_CC<d55PyTK*U%$|-
zaIwwnwo31vcCVe!OAen^zXO%OGv01;r~HubGR@(S$Mx=%gaD4uFT*lKC1x3G6cspa
zd=<CfDPS3YujsXZ75Dbv3%-OiL%WQ7oBvALgV-g*<y_5uu=k|HS*HiQ+{J3}IaS=~
zMs76bzf9*wk8-F&94dV%(6a_#a^hv|IEU)Zp%!we1{s6VBY{RWcz-Jd>%z(8GDAd7
zOqNvv7C&T#s7c^ZOE^^je=Yu9;Hi52P#Jz`m>Z3za_Q!Mh4F;zy4{9q3OkmMe6GMt
zybTm#80Uc7A)F#Q*L{xb?ve$&!J%3#V<Su0i;oP3EUGSlS@o!2OgUuibZnfuBkQDW
z=IaZTlIb#avu)~w#|Qs8Q1kc(u}AqtmpDPe4pA1iMou#uLXf{peYnpIuJ%NC^xK3j
z1y=**X=eV|?(pN2T4`o5kQn`gb<V?`81h#0dut&DzI>`HT*3a}tT}>Vj+p+JXU$2&
z;aQaMtk@q?lo!hKw@5;aRtzN^Qr`i+-T|%d$oXlf@@%%XaVXri#;!B`xa<=~YuQkE
z6K-#>sX-t?>dOIw)YN>?4#!?o_q!o^4+U5er1rh048aOT$8&%AU7g>$Q<vMmTb}nA
zkkMLchJ_5dAJA2e3ir%!`;2H>MjkeuF<i0QbWz%5PMZL?h&RJZ2=`Pzgd8pIQ~r3O
z&FucGX|lBp`X|@Alz+)Bm;XU&{byznn$&EsT>kT*`;}ycoo&V5NhYvYd<$3wN>Y=f
zn2!=g8XFd(B=wLvRNN@TPl%&v0U8=|DyGWeEfkyqXqb)iF+v{3!X+7gVN~3ca(E17
z6A0M}Z{dae&39zh*k<(L&Qv9?TLt|7bFBFt?;@e_eFbWsMZpC#{I+x6yAW-#@K!2L
z47}6I82n7Z?Pj29;%CD!D0Mw#J{32{7!=}IS%5KyoF{^&4=6Z8FeV!nYJ?2N!lfC5
zf~HT);jxs>wct7xJ)|rJcM_bo;aqSb-Y7<0@*$$q8G~lvbP?*39<qUon_vtIbHHFw
zIi6vr2J*gQl?zd#ddO^Q$SA{1h$CeIDjRaHOqCPvQ9=wr<!qFP5%Lh0Ai*#TqlP>w
zCqz>=i4)(R32}T~h>BRkZE6S<tc+lo`GJ)K`pD37f<MDdnDf@3_{0dQP6=tRAe_)g
zzA9tREZmkVCqNkwEIFpNC}ln5D-Ys*1LU5)V30EBzB|#hjPRE6;4B!FjS4d3oV5i%
zZo5Pi)@~N1gb0Hlt5JIbh#F;t85lCMg0N(ae7T?4y#q119(O;pX!UMO8$NV*!phK<
zGgTuGtBqC#!Qi<a$N^7c{tiU{gpUjiDNLD&0{7T(G+c=J#i#%u;;D2-oGG}c2o<1*
z#8M~58F5ffZ7}#eo)M=GZb#RT!@%bll(`Yo4@(eb#C1_7su*zvUc`17vW_w#20pJr
zB?J&{%LoaE$TyzE(j5rugpW21DNdO<4yM|099@W|#i&Rh;<<Fjf+?6<go@Nd;;0iJ
z84FNOcQCjb&sb0gv4TeW;3@{?Y=jKN62ut`f<`#Tf}jx*hQw1Q#KF}X6gq&ouZ)mr
zNF#d^vv(j~P521IXhIabC{V_RBj!TPE=IZe5Ra!bG)+O7B9xmRt&D0n&d`K%@`J&v
z@eECM@Cdrz1_oZmp!AJs-q=JDhGrLqWJo0`>u@@hI30!Da2KAr5x>fauTlmK`Vt>s
zMV)lZ>Ly@cyAyYpB@Qt(<G`!gsFSK3qY4z3MX@`?sFUXyxez6>i8rZs5HR2&gVtUS
zd@aLIEie*beA_ahj!J5!l4KaPi{*e<1z@}vWSW3Xc}^OJ>*UYV4&Z6)@k=YYJ+>fI
z11v_@zwl$wL_ww%Cv6WWEt}h80R|Xyny1PW?^Emy!GLVk5hL1BY@!sSE{tmTv^?<?
z1-_p8zJy{Y48E&ISqBi+%Mxc`w1|pC9Uach6;v{erbV%f1>f!A%(xJ{DpAs!9F=^o
zFVfh&5GAcg%b|9RGQx#8Di&aa0W;6*#}S4zj0w4Pjhb2eLY(1j#;LLe&1E>P!~<c9
zoGKThAvUpv+93j(M>4{Fz}9|!ns0fc2O}K93HB#e8quUE9ZxC}6ZC15W&CdwK5;Ob
z2BqT^*t&=F$%Xj57^Ue$3`l2uH31U}QJQ+Rd}_xS<Es$IHW*AuV0_g8ozV5q48eqK
zRJai>7@H`~_}WeBz%st(c@gVjv{FikF!-k$<rF~FE=!Cxr2X(D_U_=rk;Z?DP?>tP
z25QFy<Et=d%>vXm;K)vuGaD&sdZ0E2C2mA>#WIB$PXAETo|Q9CQ}~R9+xq2935Jsu
zr?eL3rAHg{;5qy7dRa>)FYXH9mFD>)*GZrGx4wLRMF9FRCG(S$etkT{Nga$u)u+I~
zdJM|gh~|T3iZGnIC}~v;C&AD@h0$s#X<}e~4JtN(XkEsPH>ADtBo^-gK27+j!f2wD
zwBul;4adTTSX_(>@gc^gGkQ$H$RbpT9<7p^_L0#8<+KHZ-{ToQ>L6m%ao&^B1L2(W
zC)OF!WGHFL<p8n*KnNzu3}kNStY>pK{dwpB9$Jr2tVE@0a+dPBaN>dP?VKeSq7#<c
zMokk3zeh4My+LQe<8mu!x-v3_I6D5s0wbC*W&KeF^Nc?2Lm42rA;#rQNk*m>r=b=V
zs7L$YLBtu*%=Uu4N}OZvMAb6pD@NuSuor`Zn{j^Fg1x<$XAlIBwbc)G^mQ?IuX<LZ
z49Skn{F6iT>Su1(;qH^l(#@fX)7Ou)(Kg(DLZoZTSx8MT(UqNq-dZtaqaj(yd|Jo=
zQ<}BeO<%{dHuJ<u_#E0b`noWCODzi_L((NPWAkV<F%lr3rGZ3jNoD~U8h&bhg0(5k
z<yo+W4Y-h>0m>fWUt<lHARusvLGNw)#a1DYT+u>_2X!0m?#W?fehc${G+KzFqPDYK
z54xN~B6Q0zaxP@?U36h{y0APe+mGzBGb$?m7SO1%C46Q@?(!I-%!}{hydmB{r+Zp^
zOLvkEs9na>CPoTG_-+{fjsgC`0lqvPn9D(U_v<R@a9yQ%dN~LQy4(qNt_{~!2q;tL
zdD*gcMW=AA)n$b~z62e3$wItmA)svCF1lP5OS~X7L+r@By8oS6%j*q&5gB3&@2%B*
zN2229)lY1<G%#trNx<(gh?0;{>xbr_hPb(q<#Cv%!{kv*(QSqhHy`prdCTjf+de|`
zb1+T8kb!t;zNqNYwN>j9k!`||fq%%B=22=AYBP$K5mIV8&6p{JD0@jYS!n)K%v2cp
zyu9T%)2Pb<<ibXbDKX2l45OeIB_gfXBw8W_(T{+7`a<*vlq@SmN(><Su4Hc&%fr%Y
zl2Feu(UK>UYRXD<{1eY|%ptufC26%gq9stsEx{f?$SuL1T9FbX$Sqg$X%)*bX*C(B
zXSis|V@b8`N(bLfjHoGEiiwmQhn#$d*{v5<;zxdSnEd9r6uVjk<qzE_2GM<rx%M1$
z&6WHn7;-WJ`dUoXW@Xj7N~A;-ax#?sk9pKC3AF`9%L7tssy`G{ZiMBO-ZGrC|0k#P
zm%#OkXp8%eCVeuTOV{N7b!7*jwn~iIzaYHye8jN<T{+g99(rII%lNW5kduSRrUweK
zx2y3)WB@1`AC-p~69Z1j^LmI`MvB}bApkajzc&>q!rmUqGWKC(`*RUKeRy}4F@)>0
z4XDURNYVqJ^yA}m5e^cx^>-(m73hItY^*vjS_ZHp;}>%f9{qSl9qvvko>C4%lpc7T
zeZ+>lQwX@C%sZ;dZE<A_qqqDG*+(F}qxp!S0lXCJZZ|y;%etHAFn{2dPnt$R_lKzW
z^{=r@HqP@0a(&WjQ{UI0+ivM>5>-OL&l^NJN>mR+o8urKT*)aojQU}6iKXa}9>m(4
zyiMLRS9E9;dJ2P44~AGLKu?K@4uPxISdk$Sh;=C0-#p4lqIzD@(od>dxfv5`5Tznn
zEebvL7!w*s-X(82Xd2ZXKwfOb#1OMiVKHCyqHLwBTSbS&AWtKqGv1Ko{s;Wzqg!~l
zRX}!}?-0SCo!dZ&|K@AOZQ<i`5q1*5a{|6g1h63E2U)Xc*~t)Igev!vBJTx@K5~RL
ztH8Y^1n3Ol?@o;fvzH&TX1~%$<oXd)3$gq9@N%qKYc5BFhr%FeqCoa#lHOjnv=UcT
z1b~o{WR~h_wzLorYR1j8WlQI>0yj27y;-VIZr(PaDW4=yho|%*4W{5yay*zQpwNdD
zVX5xsdT8)q7!pMacr3&FsfXeR_rDSWc9W4qEY&!6F@$$Qm20TTt6<ULhgdjyuAvYh
zIe@%51&6Tx9<p$gbhu1EX>K8QXCG3Eg|p(`(cm4%kj6!Un#-hJd)b3Z+!zr+os4|V
z!ku9c3h}JWxYM@m!CV%fwfgi19WKruROelg0UXH4r5w`!ex!m9S6PZDl|zEk2~lh_
z8?Letkf+S^)#O&f>0TQMB*ILR=Zhg#OcBOeAy96m1^a;kH)yI4d52Dbu^$NWO!G;;
z14vO;Naz%yy$`8<nMsRyUP~v4u^*`O&dLCL$jCoAB+q`N;8VOuil>o75~CB2v*T>I
zdxU_i%Dga5?sHeRBzo(iAv+Gj3(F@34<Myk6Ww$ImNk(l4%Fw6O6de)_JSJEQ3lW^
zBV+SOKg0mEd{!_Lu^`FIz>pfI2otOcVeYC0Tho9mGv&PNnX3TVIx3Swa?%O(f;`(f
z0muXUH6O}Jqfg}WedMz)6Yzl&JYymL_I!R(K3|f|e<=#wx=h-=m#wMHy($9elW7!|
z-C4FKgy(6-4NPDmWcuOsh1nxH{GDX}^(o-~6d=Vyr1tUs`}w<GJXx+Wb;2L|!rAtA
zI5y(qz7H|8)+SE)(7|CNO>TfII}g1T4`bH}@r?3GJ_9rnmR%P;v5I9^APzjuA=S_m
z#n^S~yi+oOHJKKlM|vd&_{nFbA`#&dJQWNnZz^$&)gi<+w_t}Ga$Bb=>s#+H#@~7J
zRQc_2u!U22>X$E4F|iMxFUCLZqp4g*3eE`I9Fhz@@g)1J4L3musFUVhlms%<^?@D@
z&et=H#Da2Cy%+DIGuSaeq4Cx!ckMO+g^jDcBHpErESyDTUB~>_)=W9n13qqw_>uPh
zR>o6)$d9<Hlfoq@seLOS0dXw9Sf7~j*P}g4v-#aJ{xwQj2u{rSWhQ(~eM5?P8Z=|d
zSglmz+%z`c4z_MXPfvGT>(IXN;t%Uu2Na;~-?%%V&DsNVI{oYqW~@Ee>#MBu<VEu7
zug6=TIwc&UorzFdPJMzU4xhP;3*KsV>MdF6Sh8tS0TvG2+Rqc@doL~_{g#l$nQ3{;
ztT!CTbf!fEGXx#5zC_H=OhYdB_7GMDnELU3;!|cC?eiS)%kWGKF=1VE8P|eX*F17`
z8ozl}U70nTb<#7NolM&85yb1FrC<63C00U-GDpZA2J~=6mbnDGN)+`#6eSHMK9~9&
zv;C2oi5`)Fk2Hu<mH7M$dhraT$AxTx!+bwXUa}NjG=lW_kk83KsuNxO1ihGx`5p|(
zOuzV9_~}4Hqay!Km2-AXxyk*^p(ozxd(PSLIu+fs*LGI2n%3r+H@*tf96Dy1%p1Z1
znRl9d4<CUzyDiF~NDXYu%rm<?RaJ5`FYWFOfs3v8pEyrQ-Q9Uj=8v%3W=_81X2uWk
z{I&8Xbku2G&B?p}$`ScQ?0-xu&W)Dc#H5U-Ma?<cuGHJEXsc}upPkDLSJ>P)ce0p(
zXSNig<vbQMEl$uDU~A4wkC~Ak@uX-HVhGlbzw$ZD^u%UU;h$MpJ5u%W*1?x+;l-aJ
zr4&dZCA+aglh`2V;x2p8T~@&7-DT$rwJ?QR=RFvW<0+OUu#57r3uUki|6%<L2fY}2
z?u^Dgu!496hn0S>+m6I6*+cHKuI{o)?y~cRS~-PU7d#k`q5=D%LapY1Ex%A}rcmpX
zg2Ofihxn@$g*uGBE95GAOKS(j%Z03<a^79q9tth(6w#`LmgeuIn@HOGLQ8Wnw|3F*
zshn35(b@_ZiVU`2dyiAjSX=m%4>!{SUJXj|{~QviO>i^r>}R1F?+Y&V^x915*`*@7
z{NRj!svwfQ-(}o5(;$%dPkh^cFgdXE?2?be;(?8V$i5uW)OXI3d)5s;e!~hX7v4Fy
z#4Y*U>oRWLv#zA+D4KsjRA!pBijvw^4|BUq9^Gl1;`^`MwXMD?|A3#{qw{-Z@(*B}
zK19vgXgapa)Qh>@<=eXNnR+w2XU9CEW${N_$gFK-hAnfv$t!S|G$JotWwHML+w-rF
ziY-jJx}KP;pK3~b?bnvyaAw(RBfVZSqFd$uun6&d=zYhNY`>sb|3hLyu`j+I{-_Se
zA5ML37Ok5WJKgDI_BvAMpR4tGNoiHDzlW-&#a{YW|MAz-u9BXo!%6FYb4fV1?(B@U
z9doj`YhKgqJ83{WwcX-l_2$PChrvDw#c;ZC^J6=a^U?1&XWe7Vcj6F`w{VXHrj8?5
z1(<UDO=uJ3)W^{p8!vgWyOgKpmg`hUisv`YNtYy73pnrm?(Z8)Jk=_!J7WjW<yw+N
zPkeOYr34S|N*)&D-GJzRouE2|1vTUbO*<S5YWVQrZStf0duIg-jy_T>KWpBvJIgH&
zin)E7h)it=uADs{bg3bva(4ATxc8yyNH}g)wR7|stKz;~)Z~jr;yE~31jsgGOI!9K
z>5{yh2Ks-5zCC@&>!lVO+SBG?-l~(u2T#KfH}y*7t-%CI_vo?9`!mP7MS5OlSY+#b
zm{DF$&6He;fH~t_MhrhC`z&;cWLR{qL{w#16g16R&2{-_SmZVgKAe5>DOr6bqWyQ*
zi3gD(CENJ4jJ&fG%J(8eIxj|!JztO-Z!>F~T<sCz_Xy$PaNq{5SL7Ii#^lsXO)w93
zX3h4m_E<!a+@?0ZhjsEEHSq@;*VDj)P`Uf0RXKR?MmXP6@E7?BQ3Cw!;7v^*1{QQr
zIiL0bf^L#Dj5Z!fZ3XQIlt+;<D<OL}9$<L)mACd-_)avM)YuY8gs*Ygh@%X4EywMn
zardbUdWf+-*aK|$i4vK=MQt@&l)#jCW~WtCBBi=@JP&otddxd2-&r_#y)F4rcU$rM
zR1@EcR*(67b9K9t5(x3Yxr0{cT&&KWw>mc${S6cS?Y!ZyW)Z-8DEiw`YNrpiQ<B<A
zrFOPpleSkReW)!#B+T(`=C%lmZ0smsa*iLp0-Rj|pc{zDIex_)UvZA#<xJ<>1L`Xa
zXwocvKVP+xUp&UYGsYL4<3G7cig5!58~LLXRP+6S^eFAbN{7uxIEGgxy_HbJyI6gT
z*RHYJA-R>{0@RJsKFuWxZ+s12NsFIjs;vy5>c8z+NfX-A_5{3ck%Z@%oujnMIc9zl
zuWdho8>NY^q^WO3UgcRdlHxpok$hf*E8^`0)p<W4H%dFXvTn1HiQzR!Z=s8LS=Dn)
zvz2wpEwl@OAEQmoF@-lagIDC@=XBLpcw1ySi7jClK4uItI;ShN@jn0n0RR6qmkT_T
z?f=J(InVig$ec+fA<`aZ#uCYr4i06qoT8qRRWdXgd9YBaG;K&yBE+M^(BbD%nR^t&
zQ~OtHx6I>-yX0o}zxlm>uh+frb$#B~KCjQc>$>mjwM*F<(z1i|W2>|40lY1wg_06U
zGIC9}3W$vq;9I!aRA4d2c&-4z%R?+<sZH^+4kvrUPqx20+uR=RRg=c~$&3MfJjB`z
z_vS1=Fp%n*!468&Uf#|sZP+1aS+yp+T7XAEq0!*YASm>?zbu@a9R%K#hi?}x-yzBL
z0sO=2?0BN=4F@|lHDSWdRswHsf)h-oZoaZNdCQ&tvfp+<0|v18{IVA(n-AVR0u7*~
zX=boQmOwbRY<0);pKRQw4W>_%!od(Tu4ljQ)1)vkq;d`Y=Lj11C2j%xkIO$z5`ZB!
ze#gdCo+e!ZL&}j}3TQJ5Y;y&B7q?#U2W?PrV3AK539AZhJHchG7i`niqf_&IT)8X^
zXyXR|WlE>|Vn+*o3N`5Zxmk>+a>w&NY8=)xuqF}OB}dmcg6nnZZ(Ri2_JB3IaD9%C
zQw^&@uuT!#)d<!gL2jV<*VYRpum%Mu7WrH!VKsnlX<U}GV4Id6{bZicRxV2utZ{=u
zQ~F6??E69=rUo68n^oFWZhYQHiNopv;}W4wa&(Lld{vkJ#zoK@4#w%iS95&qYgl&#
zy=Z7tBN#Ud^tyudrXIHqIX;FQ)=Mxh33?z$UvC5pb?Fksv=@xigM~Rh9yP2+L9Y_@
zpb`8m1bR1tp2*!1!OwE=mLi`L5>^@LJ<esV6ZC56(WCQxoVhG@@UtuYrzt(!7duku
zQ>8)wE%!sm4^f*Od^*R+qK0)_(5nD_j|M*nL*JkKV`I3iQ1G(?{Hw@^N5W!(-j3=}
z3h`z)NA%B>Es7f|2kN=NXj8hp@6GN!AFlsRmmQF*0et?vj}<5MFHkQTQbp1I*1;p+
z?W>dadg>^oez1t?Xqu`ls0$JKyBB{$a1A0NKKQ$btcX^T|C_2nwIJK}8)5;=pfc`l
zi2qRCG3)E3bUi_v01@jEVZS0Gj#|furUa7?*~B$9mA|-D^x|UCiyK8Rwwhe9GP!V|
zFVMQjLDkJ<d$?;E*|p5qwd{A-GLUL}j%xeB-sX-5JuG)Qr>VU5yw6%r=qs>18QPAb
zhZ(_CU3!a)z+pF7t^-qZd`xOW>jVx8P~SbUd>nA_1X=Lb?K{D81$d&!r;~Kk9B??r
z4Yd;7R?(xY<@qRbLs8&v7g*nvuI795S)q^Jfb!Z{AD7e*TD+sXpJiSw`<i>n1zS6@
zV0o)bD+~dHo3XWJjIg{9;fG2Da|EaBT46nz7YoI?;Tb-GiU^p>yf}8H=q>3#sxc0C
z)|%Y0GP&brawpw2jOZHnxU7`K2-S;s9jvF;a;dfFsI?!dwSvAtg}%VJ5K`n$Qe+@A
zY0mlAqY(AJz~H_>q`vM8yjxysSXMfGx#(mV`H{=sph-)UNk@~Fy2WJjr0XETbugm5
zwCYE#vUgqoW66|<H@H1CV=%W0y65n8xZDD&JvG^9`GcyRF`HY3;W#Kv_Q_?qHdkRH
zLzRH?o(2b-sXmpA9hLL9o5qVc4mOjBa&4(9iVP(I<$_xd<!{T^7M-!v1N;0lT+dbQ
zxaUwlT&@aHTfX(Z$#BiJ82T#xGUee0_U%Aa)th?`t;6Le5S2E0hWPD_4aWOePL*fi
zfEh=uF+9f{o>KzPJa2GNpX!rGGEa#{QVoIfJcx?&j@Tb+*yx}R_I(<ht9v^aZ=CS~
z?R~7Q%9Aiqc~2bDC=LPU>h^^09dB5Fx8m)Rc(W+&NS%&hd_-*QmCHu)5kH=-U$_2E
z%Ok`1QQO6oLx<MBirU$Ke51vyflrHjMiW!7Xbi`Xo=&|I($wG5Gq%1mJ=L&hp&%#I
zAAR}B<dm1ZwJt&DLQaAI@BY>&{jDvnb?z5XE3UWX>y%2gOC|cN)x1=))q2#*dbCle
zFZPeX5{{N=iWOqxZ>x-4+ideo0yPT)HTU_S2>R(ImCT91%<sMW`JjL8#hHCyY6~XL
z7fehPOuW_UQ`PB9Dh_lm33M(9yw52s<yEB-{7>xiKY`Ta{wF32CKv@1Cjx9c-d@5L
z6-+P-ChAt}*Mf;*ojwhnzSQDCizxqDH2uxbALaShWy;oN`8H+Sw%Ka=+p^YKpRrqf
z63e$flVsQztkb8i)Aw4Z@2*Xmk#*UKX=$c;X{L5*Cc$ob-M<T#)(ei-D|L(Y!b$&G
zg8yu%by-aED=f)>mgqmbd$p$d&rTIg<QGhIkZR@3oaC5lXpIANKceL@29`v{ZZgUv
z+;<iKi7~juRAa{0TN*nBGSwJdMoK-$BU~F}&}QoNf~j_n>qj7Z(!Gu3iFtpKtz5zj
zGz<n;u`@C67WY}Ku@i==R?dA!sdq7Rx~E~FM9gbs7B+LODfNK>;2kp%&`s8H4M$@P
zVu=B5E4bh_c~??>qA|0O!L6p&I~qH^ViqP71A552?s5;M)EgT+{d`8Q9m(`IQXszk
zi@eDtyhy`fh*@}!d&rsi@)q|K5~|58Ea!fr)Ne6!y02lNOnlkM3~J`;QtJHyvVP2f
zT{l_PHC!HZnL@N{TfygFleZ_;Q;nHH3~m{<-qzTuj~SFqwCf>nzsn6vsn<7lGH}22
z_ek1Wm+(T&WqIN)A$e`;3jX369%<^dhRGeI)VrHFX)uFYxr1ZmB$x29<a&&mlLGS<
zTI1G_AJIyf%T~n0-DDGwaMCLN6La}8^A$3;>y4d)nXee!mX!K?9^r<V%MVSRdYP}z
zaZeD4JfrSwq||zI6DMWns|VZ@V`MLvaQ@-?C+^`s7~+>6@)_4~3(VyN;+KcqSxWtr
zcVxwJyIeH_cKPlN1F(#s_$QToZlg&!P=RskMh5N&D;d}=7RLUgQeRI)hu2Oi8hp$k
z1n>@$cg1Y1R~b=vifl3pZxJ-<*Up^X)sTdSFXv?0)x~TdYC=QnI>CKcpmq7%yIQJa
zu7UfM;LF#t4u^EP0!=BmVqTKEf-drA?CR@uz<nrq&($o0kS;Z#=~H#gp1~$lduc;q
z)}HDZ190DAc+X~OgKt;E<*dzBW(_@mlQ)1iO-<rt7tipTPOj-2jd!Py*4K%dD<G|3
z<K3;AZ?OoBJzBprjhKGbtYPkN@_~U>aFlJ9ES%kC1J)EZ-88+#GQG$$y}>fwirs99
z-5kA8zjky)f9B-+H!~;Qd!L@Z9p@!#YS^xGM^)!epU#~-Heq_!VMC^+kshdr4Ecry
z_)dU)^0}PI^_(k)WOel06RPza6yIvL`o7z%*x(^((twV*Nyn~drE+4%gStwJv)Go>
zNM6=AZRu9uF3q8)n#mCqoE{BL1;Odh&6m@YevR0n(h0r?49WY{>(%AIMJm4iY*KCU
zM*9aNXsN4lrIX04S9bIFuCn?z`QMRfH-Gw_J6Xm^bJgnG5M~!Pz5xD>_;%#KAS$6i
zslC8m1wK785~@%bs8A57P!g!Hrc_D0ROx<!`z47P)1;KCzj|qxGR;ewTdg&$tTh^S
zlBjxsqa){9(@l~sM@J>`g}iAJs@T`prXr`KHmBp+8PP+ppeHk9ZQ%TYO41MBks;E|
zV~_q>`bgdOrwEStaEkr(K{5Ta<>F6XmZ{$2f4X^_T94fu^;G&<d_Yne_%r0$A(8)s
zV}6oKxkdXoybJLnw9s>*()&q=&mxX1in_`CV21q_n$Wao{yrqXD4Ag{$}e7|zxEtW
zIQH$S;p}aBr4z49hc7uit2?;$%d55p(R6C0Yr}<_I~4(oN0Lcbp^>+*Lzb^+<kfc7
z9o+S$>CV1EALGit9^no?1D@LRW>bb?3aORic2%+R`+DJy0Y*Q?FeRR?SUIjnNV9o9
zZ+~p4Y`d(nU%@VBsj)w#FTd+yXGP3%V}G&wLWjqE;b>3C#s7=?)nnvH8BH6q{!{!l
zSk#nE*iBKtDj)T)zR)l9+y;tTN-SI6+l)Q{%(L`a;8|Z$99&g5gQ5=vbls{Ig;iNa
zcqq2JCj`>zUAOJH$5g>6SNMu4J=j+?SjfAqL0^~qL9~6Hp6ic}cD2mT)ATcxop4mt
z8N~_F*sFE-mWTHqJdT5hb?H+sf{wjllpZ{s!`obQtWnUR1T{8-<Nsa)l<Lq!U$fIY
zlKN^J63uqczI8~}`{kkc{leJkGoaqXO&%{ClH*QT;&+)fT{=LHT3erLyxTA8s_xj}
zCBU%meEV;9ZSVdIB5$9kwNu;NTr->g@z`*&h=yD@ifCI+rY%jTqx%v!_H<~unN06-
z9oy|XMsyuZa~+$aw&hdXI_zt5HR#H@ALf@6hvY$=9IRQy%O#0Wz^UK4Gme5&7(M#7
zJf01AMg_#V!X>8kZN4Hw;j*_GJdeo`E!KpnbF#I7u3k_y1d0@(nNHwT8Hmffz$^C?
zT>wtWLu_NZLorW}GeZp!jWT(ygqgG1ZAmDIjiM)zL=iPJ7!dauI8_QhK7WDtho2}9
zIE8`^7}Jf4dFq^*Ljj_9Oy1r9nGT@n`$(caH8X19<43@$a_}*dROu%w22LqJ?~Uo6
z#XK|4OniWhry*TbdO9N&)F}d8TA(NanmGc^D8Tavz{kPR`{(|m1KgRN;9~{&pCaC4
zl4uQZs-t=)mMD78nSY8OL;lZO<nWYhX1IcRImkO2JR1agBc|QlneE_NdAO>Gcbg>A
z1LoVRXAToZum5K{n8P!wnYksHmxrDrreNqPVv6F<gn(xi;15N-4wA?Wm~XG1i6e@7
zIrClkM_Sw&1#r;?_A#YneMP-_ye5B<=MIQ&0Q1iCHgaZOgNw-!9Yv2>2WNReQcQ+y
zv1U;R&dT9oYi4c><`p1mG`JWHNs*u!?o24Sr~oe)@w!MNEHK|ujinIr-77&Ea$Kw&
zsO$oxOr>(Z`0l)Ag$v8ME`n?hknIcN<shsJtmO`C$w`&>LJFy%vMIDYzfH>)Qb0+4
zNqBM%Rs~dk1Y|o3vW@LwEdy9fRhpl(jGU9XB$*XQ1{7vp)R0={evmDLg!5V29PA5F
zISI;@lUf?VEL)iM%wJaOC)44|RDkRkAbt=;&eGTjfmS;gn*uC~u-;bzEhQ+|L`o^n
za^YYlet7?Ctgbz5r6$$(!=nMMScvEjTjgXG7)Z%xFjwiROe!F%O3A+XO9HKTV7@%e
zb%vhX!m+W{*g8PV26`?hbs^z*)L@msd?cuYi#@s;bOX>*hMt>9e=pA3!omLIhxe<-
z>e$0NYEl(Hygb07KsN5MPEOW&18JZcT)G-$qbd#b#g_?KZ^3QyaH%s?V+-#>f^GpU
zYp6y}>PW%|)nFCDZ4m+%@{3Y|#Tb^$b%3P=)tE>Vi?iH0*l9mJsT!+i4{uVF8vEgu
z09Gs%=MHbm$tp6C_If~AGicdJKYIs=SAwu^Fl#f+LP>j_p*TDE0g`kVVA(-&DCvF@
zes2v{9qf%1uv)p;1SE<4TM58YfIb^bw-jfYbFgAR{K0B0)*k+@COz$kw*XiP(C5wY
z_nfRJ22!*ctcv`k^cQ+6QnWAroFEhc9pqqDXGqTuzVOMwtGy#I#2sWUWDWTH;dOve
zDx|j=zL1kuZ6LKZgSRV5k#khJiqzH@e?bsB2s)tP?aolS9o!dN0{11q4Yh~LQBo=i
zA5n7?13E+rLO*KQ?4~>~NYZNxWy_n9>Hucx+U8iQ+A-s6)t*H=&LP9m2o56b4)9Rx
zW|rPT2Axukuc;w$7Lggx{|XnnxW0Q7OEsOkri7ePPSd}+18&984h8R_{R8fe38vt+
zuY+y}zFo6mR!wpewoYEt%&2Rvnv5Jc3Anv)NKl%(hWf7$1GwcvZ{)n)_77kh6O_Pf
z9|zrbf4gSFth&ZYu%Eo9ni1bpbuDsW2jDi;kYG4<O)+CfRPc|V{0K^-p~-bcX8Z$g
z#2B#N#r^f+#CCUgT#?4{)*c|m)!hu!A5Uz3$Q`95w!Z_+J=~Qs{i>$3UB8{sG`>z`
ze$C-}r6iWD;^QXQ*J<=?*bvitfM{2DBTWBcV%kG)CnfRzJK(qRv6O>AzAQY`V#C1K
zp4k+OjRRjNzl{F20FXd$zrU(K4I#ll=U$S2G87l|`n8TyMdHOhb4hs~*u9B!XYxE^
znt-p*)lzxsdF?qiEppZ^mh~@W$<GwEOBMA?SE_lb;#O;QOKbILoe0Ox8!$H3>Q>h3
zYgen6wR*b0p`X8Dq)khK#s+!f9}MPFlYKOrX;{h)pd{*;Mb@t3Xr^H>@sH<M;|+7U
zFR6)}j3eJL4UZ82=m8Gh<=Ukrsv1Y?x=&<p{;2EHb{?|<MGO`Kx~VJplWSYJX{0HM
zd4<8fMNM359QlfQC7Br91BBh>9!^O#F^>HC?BeOoA6;GAiZB}#h_8i!Yw8OA>e?1<
z8fk$zbGcuriC)H$eCCxS#MeE*iMw2blte}2NS)P8HJ3I9rcsW#P6()_uHcWZZDFR7
zCM4!w2KO>G(at!skGVIQxUL5Xy35_uerv3Oqb2)8WuG7{)nNU*z2C!9FCT1ZWZW8a
z8VO5%NbQRJjTY105+1cCQ{t05v#+u4)>!iXhQ_Z*^E5n4BlzLF;ag*-l{uRUsO5Rg
zeJj)v-)>XGW|I1T1^MAW(f2OP4>Q+NHmL3omLF#1JX}v{G;B6R-+QRGKS8hA*|A$@
z+LLZeS);PQSAIANHRapAwIb(7SU2pVc+UYfwY@t-ySYm7-iZ8gZqARrD6<rK547U1
zrlu52l$me0l3_DJT_`8-@h3XdS}{}i>&vCkx5%ep*}+$)S0}qrCsPGvFM_gbikJUm
zNtc~f@YIzS`)1n=iRvehp<%NF5dJcR*C=1UUATPPU$&bgTRS8RACl>V*~zzL*NT@D
z2=MZ}QWgoqE5J85NeA4e13AkH&TyrzG$eLVR0|%nhAVTH?d!U>4~fu_XT;>OuU{tP
z_g5X&g#YdG{M~JRsOQk^$(3eq_GIh9s-sL~cx3kEA1B)ac4+7QU!`eB_v}ga4WX;e
z#?TJ%%cLP<f8ZS2F*f^PGx%IK_Neg^tMMYM@dm4LD>ljs8+BkoXg_*P-3>b)?$f@@
zr=8%_e%z;hGBYJNGo|%w98MgEn}|D$yha_V`I#xVGgFW%&P*9u5Na+6|9RCb9u$aU
zZ&0!|7k=HC{q8mKIgQ^d-ip0R^zo75u+VJvMq<|!N8ZdH!kWmBQ-wUW`SbvwGJ_z{
zoY}m^+4tc&^TW8)m!|*KZP*n*_T*0=WFtT&9nP<ajv9@{1g^t9!B7w9t6pesvH91p
zMrrnT+IYTjr`L-e#G6}WX+*0gi&)&#U*B3KknZF_%TT88LIf@2&Sa~^T}S`s;oB7f
z^egOx=Wi)x_S1MuxVrw}iK(AQn&&o;E|^MI*zgLDc`V7ana<Q3<9kxXW-W6X!Ug7Z
zX3cb_0*&`zY~jjuraEm$r8s71mO71RhZ8Z_$42=bWBd+^II4nuV32<wpwZ5;4^R_~
zgrhHMv?Sc)Zoczf_WP6sPvNH2gBCFzk9+t>TUyN|l6c(XhwS&1gpSvIi=>3mMBLeK
zzC}x`vP2S#JKM(grX;Z5@ej7Q8cD8t40J&vb=uD|_ESp2#_`d+(-KA8*#oqn+i{D2
z<D<&7pQUU%B>_7=dV5-;fLpvr<Hg}b=hh5;{W71vxJI~8BFR)<Wl0ET&qULB6*Qh!
zs`za4ocHL0g(P!;#v7sWlyRb{X-NWZv8N<yP7QwaUW@j#oGqm!;KxUsrX|X_#RD|W
zK%BDQxR)GF^CDY;B9<HX;!K;%;gs*uG+WrYl-{;8%Nvz_RA`!Ih!R_ld(}^yqjAcJ
zaXT&_F`{XjrEDTatUc~kJ8dqH%SVi@?B^@SmznP^lyLcd{MhEStJCJgG|gQ0b7$PP
zTDA>$+8l-3_7`8LIqm$kxqw!Z!?xLr+cwJI)f_kWM3;Az#bDP^#g0O+SG1C3+_oP6
zt_n7`mW}lrUqDHgd}&#7ID9i3+s4Lr^R@QkdWHN=E6y;)d5#@N6&nk^{zEHC!u59Z
zH&w7d5AweQw31x*XR3IM(2GwiIfCo$;UB-t)=Lqik(I2H1;^~nVe3&5<<&#mnTT`f
z=Brk)%Ln;=0Bt9OT}~C-3cdPhJCkt^J^bx=*}GH3`m4q%)t%?qyQzrsdP&=vguC6%
zUt7T*8stwR#$5IgRqQVG>Zk2Ig1g<rPrA#_e!$LNS;{@L>5Chi=Qg&?t<?6pjj7@o
zia5p@hY!NxneB5n!i7@Fk_s)0io+-4@C-J#k(PA`hhO#nOkdO!E?kf-p;uWFg4s8t
zY5YK30<tCwH2y`l8%2y6_o|t`fx;!+qw!nVtt)G?C-Z%kA}*niAJLq4W%|ZD8lS;#
zMKXhN`26-cH{rrH$r6T^6_3Lo!Qpe+H<8R(TvyIY=8yD6b>TvuWJ!LNB_fy|6HQy*
zFujCpV`t~Gv&&a&D?9rLPNsyDwT~@ao?cR0dBeIsF0T_VT$Ugz>oBe>8P~;N#~h$#
zmD94+Q^lUmb7rFp8j_{|(6WYTSqiwWi0K>14%Ll3wo4+LQ<{<+Hi+VTwWsYI_fn?u
zJ0&+NX#D*4Gz-ZM2b{Qvf2KX{;JB9-jUP1~O~Dzh8oR#93p;&j&N*!L6fvVc4JC>G
zeYDeYIvSHIwib2<(wrIWKT^ci?P)ra=(e%W7c}RUx!pXQepXcyZH=qw=G(QWZ6EJM
z)0{gc(N}2BNT7)%+8$TY!#~`f7BSw5p*bUgvABIJfgir7pH-AZTOo>X(4H1B-YHMJ
z|EFZhd3woWj6XvWpK6)I2^ZMYOZTUjG-+8KV+*;{OQ@CUksa;Eck{7Su~ze(^7sOA
zd_h67^syyv&seAF7=KT5+GR<!B5vO(e^08|N!XeEFs*nxS^?Shj(nW@X)5d_(e9sP
zA4w5kZ%@;ZM5m2*I!{L<+rd_0=T6%FT=rCo_)&Y>8cB4=SZ5FI=*ns?bd7&!R`}Da
z%?_$bFC0Cc^v>bY$HTRuC!fEz#|w(PnXi#8c}_U}_a)j<W_y~R<ZoM?XAeK5J#F`R
zrz-7e<n&S>Z5fT+!dY<YXK3@B!{~yZWQDz5!P$=_OLo&s24j5WnMNLQBjLgy(@VFe
zmlSEsEn}T8X-8M4+Iv3zth(fHYg|V+e?xm(@OY;p?P#au?<=&U$W)t2{<g<;^zc*L
z)1t;ZHE2hprvHw`okFJCO?GBlmgy}*5l#gHYqU@1E4~*n{>kCsoC&9HaUOp<{-Ju|
zA@^}J7MXkHF7?Hpnc1v=A7|iy9S~||jlfS{czc}G!n{{EoyF^BBOM#!d^dowP_swM
z%zrvD?<<)9<d*>S0)Sq)T9N)5?xHq#aahHhLeTOBaygttUKKWnqihSJR5H357KtlZ
zp@Nei20RBC77R|lEoh~Z@fX7)nV>}gh<7>L)`L1K8T$JAuSe!=w4nmDw>*KhAF$c5
zf+uvL{c0KJkwBa_bQSHbL|{b#aT~x*Dj6vT(0N5~6d{zs__UajCC{k3$Z@a)Rn;@9
zS8+6>Du@tDRL@XjRF!dVTY_uVGa3}V6$zn@jH(Bm1WPc2O!kWz81Mz$bRi7dJB~2W
zwt}w(18Hl)Gl_%&0+6N)nWMcE2m=o}VoR_ygj^yc66zvU)!G!%cFUrwkQ!a;SexZg
zJ^Gr5F7^5?%b{AN_n2eeq)Ir))MmV~3c8py#MrU&wZMx>R~S3WkzNYJ`T-}<(lLxo
z4vHBl^(EWt>Z_sy4iQS*R&ZG`nYz~T1eo6LMQUsfsXUlaNqWflNNwYL^q*j-UVpoF
zye(pQ)T_Fg>qv170?2z~26lCm^<DK9F#)l}U2QA4@HII+$uZfOS<T?qQyra*3tus-
zlZm@}$l-Uni7Aez#)XFN6K99=lHM|_OSy>@M^m%HI*kAYq9B@C9ZVDujXFW{MD^~{
zKQsfJw<6-vUjg~nM(-mh4mER(EgeZ@GA(9clP?*gtFM55Ng-@%Tfxj=@{YBR@ri^@
z1o94DeLeI`Dq+(@&Q(jtx;^CehWhI0muhOW-qs1G4>|j79Sv0qUos9Q5gz!G*H>_a
zVPpxwIF!o~+B$lu6!tR?9U(j*kW=n*wyby5R4LTczcetCX0ENDkA8_F9N$ki->`x|
z>+0`QD>REFM{Da>pkFEyjz^HAH#j=06dp0qXDPl^Abe*q3V&skC^J5la!y-1TBsM^
zUd7RjPr-!m&-dHC$lv3a8TsGlpxuj+yXSv32NfJUU}sAqs&<nZ9PS{mN-u|traGdG
zgSwfzi7QzC{{a91|NkV^eOycX1HkdK$M#g4^^CM=tm#2gu2IgKhg#vN4Mi%{Di2Yc
z$kVnS{BA<BM2s^kYZX0TA`jQiL)<x1xpC!Qq@ym~OLW!6Z(siSp7;0r+0N^`b6)4H
z*pS_h{5*}tCrjvekl<;$0&9LpE>~;FUM4wTZ+LVa8xTvb+>(Z$2^bPNXS%Rj%(<%{
z<*v4poWI247v^$v;ss-zr1NsQ8pFH|f<pm18jD{yR(da&n`QV#EJ@fEIE5<t@eZ<P
zn(nAIzw2A}mV}lX+~b|3#N5IHgL|BSK2Cbtnop2~R^=Af8A{^>$ymYQpRNy$)_lGs
z^g0p|pp%W0GI9%>S^UGfg_b>?oumtL3pIvy8wAG!bSxIXeyr4-TbN~dDVFqF_Oz1R
zxr3xl)19#9Kl+xvB_5>)JIkJg+=v2$U7Ub2PHM0&gCrhRxe;{+U7R2RLnyKLJ+33t
z={hc}Y@NiT5#+MFh%i|ocgl^>7-Z`N_D<5)+=ygJ#Wh4&Y3SG>@OP5B%#hu9l%6t8
zSHdczN-DaMl#L+2nXX$fR%$z<6j-0IDKk7Y%-Af_<u2LVj(?xt%oOR4P|7Ic<Sgxf
zSG~Mw(lBki7H#kpR6FP#$Ym<JbPA=6=_PQXNf&C{HK@{4pm)&Okjv^B()-%>EObaL
zzOv|j`BJ8I$+xAapv6Hqfn1hBZ{txCXkG#mtqs;rSEDRXL6(D#Ku)M(wB6QD*P{8B
zGk1YA+d{rAJq2eRbYsW~N_v|+C4u23u%)%l(@xi*;huuS4mvtHp^njZPdhyey(bng
z+7+mvijRdNi5%TAN<!DS>@7|W5vOK53{h#BS>zUiwkJ-Unj}tDqcf|tbv39bPY{M6
z>9O~tV8nr|qmUEg#Ze6)?+e3@M_|Vdloq<S$6cJNMQ27~$D^_1JbY0lTIDI2N^2Wy
z_wp;LPK#E#gH@ZhE=3$AMwS($8zPV<Ok1ZxH@FMN(b{fm>ypLYFcMIS(j4pv+KF0i
z^GN0aNIb?}KqSwvK`l4M;stU-v9@lngU*GVFh$%gMz%WWVwi0<+PamL-Z=3r7&(BV
zZdXpGtI_f90xMeEb!}P_$Tr33i3r4uY16dm33tI1TH76MT8em<7+GA2uJRN((%S6p
zW;}kB?#<EdBli-;7gr$OULf~!bt@TdE;q}vf8XrkHZw+g+q#&W_TI7_i3r|wL09l3
z)5DEDu8oxYj%@ww#}6m0SiNqN?bnbA0lJ0X@&#6JQSQ6kc!7^oTUhQpt>N+p!TA84
zBdfP@Y}>8ecN)V^u_S$0U>`~H={6EHO?S|`_u;qfE%{Vt_|LF!)owxBr;6LXdnXp3
zvMgd=zLOlfo9dNDS%DBZGM*r*;(Q;GXN2fNNXw`}iP0cm;~P;s*|Y{!%QN!mLYkIQ
zhian{F-L|8jU1+stYuIr)k7av(a81_#W^tI<{%6CmM@a+k7yZt9b`^q`^n-QF%s_}
zTfr2vw2YM$`*`tu7&(NZAFiC-r$#5b8)-D*&)U2skjE6Grz4ODm^M#~o_041Xu>va
zUW$0W7+G40uJJTF(S#0m4XuyTeL1pxvOP)Mx&ra_0{InJwu&K~5RGi%$WD;$t;DTS
z$QCc-4>aK>dzqF}1c~`t?Ui>QRuRcXJTV_e=nk@ArjVeOULY6gw9?$#{HgT27YZA`
zb2)!%Me!DXyz}z*=KQIxxl)ZGLM%DEGq9K_DZ7n$Oq1nV7qx%O-jcF1L%U&;Z0tl?
z$;5BRNwVmL#u@XB4gSFiD-dUnY_b5aI^Q>)XJpZZByC#_Iz1ZXn|x!Hoh+aMt>YOz
z=|ZNqtq!e=Mxr>fE}?NeQ)s1aqfkEg4_q8i6E4)YY0xxJ;|T|u4Y??tF7%-kvAv9Q
zXu>7hwk-6Wr}46bYy!FHCx+>oR;Wf9V)50{%yW=dSb#EkMk3RMQsj`>ew9`z728Xg
zCYn}Qi01K(6PYF>MNSsmS8Ii}sFY`nKrrjr`$aIq=gR10`5JLi1IUG8NP>sa@-`HS
zkp!;HnJiBf7d4`7JY$_4v3HPB$Z|Sk<l&=qdyXuJEGLNND-e4xBZFpo&Xvg-rm@k8
zoFgkD%PC@c6e9OB3TdVkd)a=9oFwklYImNOPv0Mn_;Y2}WcgZgX9JqTGnRxQDi333
zlDJchsJJp0vRonVY()Ec#%4KU?I0tOJGZ$BB3QBa{b9tK3)XRB{|0m{&zKvAEb=fW
zCW-yU$Re)HmfX2c?B9r%@Qmeh#LGd(BzH0x?^-&3o{=JM3_-j&vVD}!c5R9VjrJBd
zmZ6UgluoL+F%;RzksYUWc4<?x(8tTfsuhR}M>a)(t77k~V8n$hvm$rKi&YJ%h-W+y
zhQxRnHzkQxVkCwub0l{rh*gbfGtYQVjs!Z$*yK(oL;Bai#R)XiLT$eW&Ga;${Fc+{
zCLc;C+YA3X>(aos%DkqpFXk?d7*imNE;}yCYi}2Z^u@b0+ju=~H!3qSDwIEkW>_YD
zsRstOU)Em?@>~Dxe(aUE13jx0=LdImRsFW(d<6?Gq8q0}@<g<a3v43F<53|bYqgS^
zROg7WoMvP|AaQ|P2y%aoiAs`FP!m~ZuQp9b<aA)P#^j6mL#9`xGEB6bgr<;X)@qRG
zz>8|rakw)}V<I6cqR9sCbT&4Vfz`0TlaUH_{;i2f(XWRPYodt&QZ5;|3ie-wmRyJZ
z3C78UPBL1;l0_1M%g|_+jHyof1V3&+ZW3rx#vophsTFQ?2lf(88;PAZRFgH_NH+#R
zor&mUF0hH%8IOt}*)1!fQFV?4t7t|W2qZ3W3!&3r(@!OJQqX3y%u(Gx9f_d>qc#1$
zNFZeDBPBC8n@*EW3*irtaRRCHFz_T(@H?5orZTM1%|vjZGK%3pA-hc!(|z~@!FYu&
zTRO1HRo!ok?1Dhz0|$xk!g)SUw@JK%>N(Imr`w0&3DEXsD2<v2p)^;cscRNdJ&`7`
z9GnEf#Q6}C%`|H09Xux^0rKaeRH#F(85;t;#^@-}j3puxS7UD1MK{Rb9nFP6k^(VG
z$8B<o9jk+;9y<n^1f~1}?{^0dv61vfm)aH^m&gA5@ZbL2Q&3_Yo=_R@cRr!`+)^j~
z^Z8A0UpDSzrT*?)C*GS_JxT5%?kM+9erix{>$qzDwQc?D*6hWL<Y$jsNB@-au&T_Y
zl)jt0U$nqPcrdLdc4%?!m-mInt-oG=^mozH?kk&Y8WZPqlx(NBB9V=>Eq9*Y3lnZD
z*?xz=#Ls8{AIYzFh0OW&vgc&W>XK#E+r(~s^$J;kZqHYK?70(ZRsMSiug*AY8Nfcv
zD1Npl*~T(9ef|>0bVwltd+l`lTylv*YvdUmcpciD=n&w~{El|JlnQ3=ucsC=8p(zu
z?j79h=sG0K0~nnXU5iZRr1UahJ3g(3jrR0LqG6e5hm-;IHiSe9+Bt2-%Ng^vh&vq|
znDeEE5Ki8I3;*|OAmIA@53?UveHy;nO24$xXd5uo&Ts2%|Fti|cG<1H&^Y?+&qSMZ
zTUSq9vT~6`UfA}>lZvd<&O2xO*YW<{DomL4@78`aiTZ5ue$N3xO6q}$a(w93o&`$@
zJx4$GJURJ=zIKO?=J%r?S95E9-?R)Tt$n;B`Pco)=cz|7TGsgomUj4Vv*V8}oPIiL
z-L^AF_DB2Y{iS|^S0c9#RhK!1>N`T}E<3Tm>Nl*dI9&Y8-HP7!&@$ok!IxzY|71ic
zmUH$@@!y>P@9gc}^ZwIcUiGoIqkDXq{)4lJr>AS`VujC@k^AdMauOA)63-@M{p0ZT
zeWJ>T>wY_JUM&LC>uWbHwS0EZ>VS9C(4}pm6MuP;dkJ$hFvoM7|8_I%o8zw3NP-<7
zxfv?ynEyQWIWkrRH51|GR9r{^PK9TVgJ-(JU(=t`&~cD*t$Gs|m`+g6BsA}(VS1?9
z7S4chGxU@X{KAG7RRm_8?Z`-$G6%6TYu8gdazy7vqj`54e=1oO^L3)|-=tTZfsNzV
zw6wfjo#9p9lOmw+?-8zvJo8htgVp|?{>M)+{7sIft=>KQZ~xi@=YvN6Z7aIUOI_^h
zb7i>YW5x*fM?Wd6lFdFBl(zYU=6dI?=8WOS`OlWmzq)#Td-3T(=7Zs0e6$T84IbJR
z^I+KT%%Eak>^1JLx%MqzDs{W<cFq0Y71xE&mMnP2K0Vm?`}t9;!ACzPr=}bn9a1C1
z$?KQY&SlF+>)&*4Ynp)tpw!IJ{q<!UWt9`{R-R^Om6PD0J?YOCzL=`YX`PKx{Hk`M
zPpX;sb;Un9AJ0-B934wuo5DF*Ax;ao*82M2Zl29<Dx3RTnDG7)YGvj4f3{jxhC%P&
z*en}l_PmYz5S0JZ?BDLXS*DG}D+#$rAxSXVDHxK_;%E>nUhT#O))HC0qvItlrE5sJ
zBkm*PoJ=3-@4K!cDuP=;N>WF{vD&4Q&Xqa)$C|?PEr*Zv^fS4cpZ*HJ5ndiojSRYA
z>(6?d&N?$X{>C3cx29dW?;GCJ=R_Tzl{;%NedoA2Z*Gnbm-aOdXl>tS7#3f^7KJz7
z=#)*3bu3D;PuE%ZEe#kS^dI8ybI#${%@@-eO?Qea<x8tpRi`whH42YUU0zwZ;$n2?
zUsIPWT;gqN$K0Iax_M?MdFMM{ZO|tt!l|A4e=G@FaN9DjO>v!6<+^D9I{hK^Ov;{T
zgwIQ!976pHl?$}ykS=Er6|mSWh*ZdG%mU1LzUU0Bup7uP1nT6983XxL7y0|Tl#L6s
z%t`Ie)}k{}iiQqgjA(7R-uJp_Ev#U@&L`-7tNa%91DEM*tNa|4vR{8NjAx40hAKSq
z`~-b%1W@%l-%oXuGLTQwZz=V&QQoXI|4;#pQr)aKZ^M@QFNwXKGzZV0qW=f=JE^)E
z2J9*GyWVk(Q{_icPA)K$v18Xnwxz(h&SSSlw&I1Im#0;~nTH(<u`Co52f}s0(_xCj
z3O|n(3N9W#Q6Gx>{ivE83cO?TJEoePb-=WJdt=jKv10n`aH{@Jm0wgp&|B|OZq~)=
zJy5?KWx3jH*L7^73Rr2Dbsb}fOs`(Y{&12ZiVRf<@$dwFMFddwI^0iHP8kR%>61(S
ztd-@p<{1^hC{=mAS!ubj!AaF`l-RMwqK9IIXdt{8*c_(Ft?-+)LP5pv@$}B9UzRE{
z1bD;bcUYCEwfw}9<@*&{b9nnPy2vj|QQiTJ5!Hw5qppkUVTHr%dqjOym0wstaGAcl
z%5R+I)=#Z!)LV<{Llpt|y+nO?1aRx?d%mhy<bitx{j5?yE9I*i^Y{wj3e~GR^Qv$6
zUboR3zsJ{KME#0YucW|7Wq$WNjyYEOv6Zh5nde}~Zi(KP0u`Od?u*`A?){uy7ten}
z{Z1)gWtn$&9rIBEi_OGHg}BB{#G+sk6IKugJPUvtxx#J0lWcjWq{$l{wdUaVD4K{F
zr7&~=V?_JH_4BWb_Q8rVuRV$S`Bn8H{lI1V)~b3ZaADPrF)Y!(P=zn<nW%4#0B(Kl
z>8m<I9`GdS`K9$_<&hdQw*t6Ab)?Q5VY#sL`CVH*a8JIz46WCxj!1zWW%c(uq8zH~
zS;`}a%+s-`o1(j=z{Jidv*<2(sOqAh^rH1Alt;46X<bp?Dqyjh5viD8V`gAcV$oDs
zK^dqj0OrUQ{DCTPVQtA9mut<^_9(h&YLud^0~jNEc3kw#YG5Z@^z5*C7=0f&u+v9%
z#Y#U|Et*?nW?Np)p1$ZOu5h1K`zL~Ocbwj})KcGPh4n3r?7L-Iiu)F}e;T9Qy-x31
zW<H3%KO<Mz4^$B?`wh))WGI&%G7GV&R#9asu(v&GV}F%RSCqA=GF0J@S0(B@BY;i)
zRq=X%%WfyHZ1{6579|m_hZWWXRfmB4!xYsO^#LmsUU(H>--y;9QFTdyU8ed2sxA$9
z8cT8pV1>);Dw1ARRlm3&=&k=yZXSu#e?aR`D!a1GnO#vnDqy9V+SLtNUYO2@k2gVj
z>(Y9HGN8sxtpHw729$`#WvK$R<^}EDG|{*y#hDIZwdnW?g)MF@SsuIo5?vW^$UGVA
z{zY`W6!@~edqe*Qo33t_=y<5Y58sfe|1|>G)W0EK?`65L)sfY29RB5hbr`V>;1|pI
z6!yjIZ_79r`!3aA)kGcGK+#v1*4rza>deb3fYGX^T5|w+2lfcw1Yq3@L{DJFxPc9a
zfycuXmn!N5S14xV8>Z;rp!IrHQyB26sXj}!Rc*O3=Np=4!wRd{e?fYes(ML3&|9xB
zH=E=1dbIwqa;w(7xU1Vk1*|lCcXd-lm;ST-5nNr|LxC^Rk{qEoYtR@jFpcmgK(qDu
z`m-;O1Yi1d^p8ugEd%(;GJ1!vXWX!im8ZgM_U3$4V-sR=|LXS>IFBX4JK!WX^UWdP
z!7zMEB!2df7<|faIlE7P=edQ8%+KUY*pjXoTtOXiR`33(S(BvSLq$)~aRoGTOtbq4
zJeP#s_eNvG(O9i!Hvx^M;f~Nqj%N2E_$q|?EJI_R@#WA+r&Zn=)fap9Zax}Iz?V};
z<iyVm_-eCyx1VM=lR9Fp-aQF@2H`WQBa4Wisqob(&29zyjDTmjhV1bi8H9#r6F%F(
zSN*U-E}j96Jf$=|B0nC-YH(D4<YKF#$9Lf!eBgS@<6H13lyr)%g9k3N)gQ-TK@dpp
zz&_&RRN@;p^)VYBr6<jW-YC$|T;NYcmpGIJDX&>cOI1M-Y(>K%2qZ3WGr?ts#)e9A
zA){GjB}Z*D9TU@m(Ha|H%ncH~B(<DX1(D&sG@JvutU)DQU>d<CKx4Ca^T}OK=6d$S
z?H}WRxF2+{uX}Ir_vwbf`$0bkFNE>``RJAo>?CI&D8R;WM3z(ve9jf6FkGy~xPa!u
zH=N-qbvXy5zz(4@Kj(l3^NkJpI_r}!N3<aL7K}SFT@C|}hT#`HlykNf&bB%H`<9ZI
z2X44$oS1U)McVf;;GUt?EQT<;t6*Q(Co-hxp|+6Hl0tw#Q<UvwkuyulRWIgZp^)ef
zJcSQTrifbMvk<Ohmwui1)(+B7L?a<(o@Q|<u#KX8OcuGYlw;M4ZLwrX^ecRp58Ox*
z-GCJkp3l~;9N0-!n>m;>1d==O1##pCd1R6k&W1*^)L$TUu4PIevVuOxQ$`MJzL3$m
zyHH|u-&_K|gg9cW{<038%g0VZLuZ+|k1c+lW9EL*)@NVEJ^%FiA?)9M_qksR74$vV
zqkfL<s?V<XR61mvM}p@!m=$8&ldh*2ENK}7=xs<Z$1ZZR%^GYLS7a63w*o(52doP2
zi^Av7^uswrr;1Kk8Q!}qCuE!JvF#qfOWEE>gB^o8%}}so2u`HM#2J_oz#2x(I>SDm
z@`0nUTy=#O>==qqq=6IxRMKOn=XmGvl=N)xLl~da{7Z0gDR7;A^S$6=F<$3W`t{$w
z>9m;1hPyoFu^jI(U^idcYS+xwV)mTo;Nayj&S1tI0_MqaAv1<zsJw#EtKZ8x&C=lI
zVvve}rZBw3L+M2}tmi5BXP?tx{tnHPbAXkY%AwgN_|YyyVRYXBPpQv7mj#k{4zL)r
zj>H$xf@i`wmHremjPq1V7{FzQ<DN>}>`f!V_6_ElVtg|FDH)_l2GHBEvK*`a<E~-l
z=2^;p-g`G)@5Q{XjBn=qe4h^VVjHQ=*6>fec%RQdrJ_&B%5myVe%MAj@RIuNQP}cC
zzJ)LsVlxTOaKaCefmLwEM)vQQ2h#D_Lstj*hf;?(bxd;I|I>~~VT)3S&t<0Ge9}@m
z<DO-GH}T+?lg^(5UxXgm?z!aFmA<)~>yLaq`}P58=HPY9_{TEtSZ(UbvW)tm&F_N-
z-G<}Y7Y7gH&-Ptq@3_6|vE=QI32CQ>3r5q}7eRP5;oY@$nVide=cof;65hD6<JjA;
z?YK?4_$_Eu?CrN<HUT%VWy=Tt<ESTaF$t7uNqitq%v?tdWKc87@Ie|r1`1q*F6091
zh=EOu;t%dRu(|sF+LE6q+_3w2^lZ(oG{z2A<Zo*q*?s&a|4ZoqB7d_j`S~Pf_mNy)
zGi6Rr;2}#m`t!*ZXKT({eos!|%ZeqZuWHWL?445<_|oGqw<X)z+l9jgAgJEB-48EU
zT;Flq?>EWG2NT}0J{Bk}CmsGCqJ|6lSVQC0Cr9DxM)Q3FK8p}&g<8@oBG4OkoQ&;@
zLmi<Zt$H<tF{znu8sJncjG9S@eRiQ&qWg-Wp+fa)B1j$@pd&Wb7MD-Mrb3zX;qwq~
zPiiRy7Fi3Pe3kIz4)D@O0eb!G+p0WbNT+*&kinBr;>iOvvQVg^#6|FAJr$9;;mg#S
z`!Cp|Deso4g?TFprUgF{W!;zUQR(w#YE#rE%DR0wgCD?x5}z4M2gX}xpFV`l;N)3S
zDex6H^Qm2CAldLpjH|erF4?OUhDT-C0B@*Sj$1oqlCpdL&Y8Sk{|qwB48g5AnOQkK
z1;MFmY@D|NFGq&1g)VNH7oKLCJY|;L?(hlI1NXCSuiVc{*AzzjKXG@=(yW0HmTOW|
z*DNa3%0rzXJ4*@y-k{h$B<DG^>}=I*xJWpZcL(<61CuFvt#B<QIKrM0J20N9UNZ*q
zgg|l!_7d|p5?gJkdDd_(T@V1ZCZfM_flb8Lc=QLz?v_=wNp*k(Z=nfnAdtAgErgb2
zVv93tXfo6i3a1jW<E)`_a;B}ir-9hg3a1jVl|h)W`u$31$bry8fm404m0a8l%DhXl
zdqmC~$Fg%&Kj$K=puD^A7Cvx2CG)tZhl*NW&W-XJavhv%i#>sc0!S@h-*OE6PdK{G
z?ZnO2tcMr2DaSgp7r%J^Px7ic+rLkvmb`dgkL={+4KiIGh;CUK{&lx=%?8N>cqyBE
zG?=c<Fpz7Qd^AQt_$!#c%~8tx9%|kO53YE-*Yx#8>Ve4UQyG8kHVX4b4W<Rd5_$J!
zSCjPlZlkGtaBpH*(t=ad8b%HMs&|&Jv{}9)u$(sbDO;ZK-V%Pagv5)kC0>WDd5744
zpY575hTu+A&tnyY5P{z6UnaxPIRvgPyoMOUf_`-7)slhLQ0TTiDKS#UJ@qoLYZg6x
zX=u{-^~uwPw>^X)tcsLH9QH{5+pfs2+*mqeK0n7p=&@vJXz%yX<soz?@k!{qAZ$@}
z`gBOT0KNkWEa@=t7!!}N#h=EZ83a6rnCYnQNkB9B*d=J_oIM^$&19>4-fK2l9!wHC
zOv3}A%!8Vq!|)&h+u@DAoQ%ASLtjF=6Y4?|l17z!Yk*S`231OcJ$CZm)GjayG!Yzx
z0ZFgJ9`3+DiPB_Z8H*~V!ya@2A1Ygi>bSrLV%Zv02I=}!(WKf2a|I-@CzKIU8A~T6
z0=?0W$w+@3+5zcG)Da{kg(~&Z0H-2jsZtW0Y}wDiwd~i<LB>MT8*s8a@C8x2o>*p0
zl``REy1)x6OF$dAz(!)reRz<BjRs+}qx*&l_%33mtGY*l4)d{5Xy^(PC)wgzaVQ(Y
zNyHII9b}ohV^+|R#vYeYM>y)BAq_WKKbMTM>9_<MDbNJzU{@lx*Bez%Mw;VLC8Rr`
zZYLljs&tA5I2FmHO4;!1U1(`^-w>obsct8M<f8#PB2-&}WEw(++F;lj5|Bs<1;8wO
z!6Z@w8O;wu7}e<uptca$nE;Xwc!nuBOxJlh32dQ+iD)>a`%yDJ6nKZBJEoaVLK0mC
zWnHuUpoGcjJqV;QU^hkAN^aw_bQE<R=l=iz0RR7-+4)-&*V{kv$s_~<0fDf)u*eqB
z2ns4=!~r)JiIK1dK@`*gVm}{~SWwUe+=^9M1;L494TNB*TR?H&(1Jjw7}E;2E>!}d
zZUnXB_RZ<@{Rf`smw8RzTyx!L=A4r&%*}Ozx^JSX-dvOG%(}bLRFeP6N%EP+$})TZ
zK+<|MTt%-=gn=x4lP|YD6W;_?ACR0SapzLIeWk!a?pA8I4f?PcFX8L|hN>~iSu%)N
zQlK-}hT*?Fh-(9NN1$Plzd89uIdHF|zaRMp1wR^I-VQYd#NbCM)eOm&*<20{cu}(D
z2-;C1-9qBB;BGUt!^OXr0#u<LuKx3&7w@G3xtNg5-3)hIgXla3n2xUX<)#F2U7+1|
z;1JBMqgayhpg`_4YBw1zEW%s(dNx$OS26~HXu1^W%*|l<e;35ffVyMRLX!V1@{1ba
zDMx>I@(VIv6wbA76^29I%h8Vzh^m0cto*Ohsu#KVFM?k9;h&-EW74r$;5T=CD0jiS
z?NbqTp3|>qZhiA`OnAL8>DGpfd#v;mK}hHRO@DOdIlKOOAuGGorkB6GCBC~kF0cRM
z;?XzzHdJI>Vm-CypU=Jj^Q!yHDqcRYx?D%RoBkklgZ5s1TS5&d`l}-6ZdB-ex39@p
zPJCbX?pW>eHrDeiPXC<xX>3-$&D}`$6stmI=YJAHXZ`H7&NKAriffSpo1P~7=Z4zc
zI#pg<`q{GZqbbXXc$)mnr`zF9i{{>ac6TC$9_Vi}$Z1j2nSX+R>^xLBW5<mD3EDYM
z$4>Y8;U{u4B3obj;YQj>5sZK+Ue6#t-framu4PV9@mxffRh+d1vj^GT2;B65c@tTR
zE`M-Y#UJ#-dAmeq5{{jY=_Ll%a#ryag43K;1TzL%8lmtXb*KS0Cn{V<9mrD?jazc_
z_e(j!{Y)y-nWCuE0#_rQaoDpPNN0p%{)mG)_DscFZ2%@=_9`AMO6a{m?PYU7yn-@P
z4S^`q0Ayj6O`NVwtP<x{iegGQ(K;qm3_RJVP#KxS&GpVrZC@Nj;Xc^P2t7~tF~Lw|
zi5$BqiaCNbmWX4d9A-b$3~5YJRBM4Mq%l<yV!Et0IWNsk6jQ~?A(*{LV<YfoKQqfv
zP17;S$oeP+eYkopHai}8#!$T;J8OE5vK>|zW(-&Rm_G0hi@Rfhx<+1~mg%hG*@(I;
zIAH|yF7iSS-1va0L0&|d9^)Z(`-=z#d!*VN8&mNz3_uoU*~HnMiCN-2sVG3gG1DnM
z#K4n%8&yVE(-0MpKYyW%!lz>zR6j@eafP9XiX7_@h0ha*PttvyA`17zG!c5C?&E4h
zkqvSzO?)*In+0a=CVy}is<-O@2#Y`@?{mhDyJHnUDS5#u3a{Y=Z>$XGRfq#(fWNlz
zeh>#p54IEzWaTC<H6(apF*t~#fnANpMx}B6>AqUr=rdA8L)M(_tBu#k5+D0pct^wm
zrQkX;7hLCyb>kq41wL%#b!wHSX*3hHlye*j<xM0}4qW#@*^MNEhZ4^pY{7XoqLva)
zqD~ng2G(*yc?$k%PAH*VhCDzOZleiR!1_c5GMZp+T3a!B`6o*`;(nzK@*q`lQ435*
zLRVmJH;_<NK^@UTn45~X*Z@qz>Qy|3X>A3bXltb*q0tK8VQn^69}g6bXlILa%|^8_
z#+UP~M7d`;GnK$paqc-zKCvqFluFk=cUbF-4dA>6ac(Sdu#tCHt7NEn<|0EmXDXq*
zg^1<AtOv?_h#1`17XIKxoL4I{lyK5@%0Mx&ma~wj$T-beNGO*h?@-0GQEe4amgsj>
zd=p%yX={IqGdPIp(1$#Y_nRWRnU1`R!zOMZ?;;f8BU*E8Ld9ES047a6Bxaiixbhos
z+HisVFX_R%h)nwyy(=79Qis^xK<scv1UQ(^;{9NemkO~?QINozS~!qunh0`#4g?~p
z7PuO*j>GocK&&Gao+BX?Y>(<b*8ohymZ|PrfW0XjQ<?Ur-AD)wq9_B9h23f5{FRB_
z!SC0J+)6oFx||te;7JZcmjfd$Ll5o`%q3yI^7|A~{b>$E3A`YxuSeoa#q}i|UVn}y
z5|^q_YJsgtZ;Aq}`{XrwgLF}S1!oSCa|h{_1Bd!^HXA}F>2hq4-e^VGaL7h%C?0s;
zpw7gcz*iivHQ(ypZ@n{fpRO-Y(|Q>OEABY8z1h-lI*c`>X>Wdt+O*2*)ai6Zqw@aj
z6ot>Q+8aBJ->($&V}SiF_shh5un#7(V7`<S*q>vDw5BL(w7}I!MH46cG{<{*NhLU(
z<;b-^P_U?zoIG8Qwdq!`^bfRCF`fLrn}~molcxk;5)ITL`6c2331@PD4jIW$Q5?_$
zRY-oSVy5X<Cp3Ada<D;|n+E4vq4}=OtrTE7`f>%n^#=M9YMx4JBja1?S`G|M!r#-i
z(<B3*&|r1nOH%VfQkyx5GGHJJxAEof&BSdWtyF?QTyv_yLkbM!E~gqS(5c1ve7^o5
zq^*!3Fo^u6KxZP^mq@;Wt|1Z0lyOI>xD#Cyjh}*s0|U8!R09RYiafpq`(scugCvG=
z4qY1!16g>VFIS(5_d(ht5`@g%NHxrm0t30uR0E8r7vU7Xo&{-lOD;kn@{$6bxyg*?
zydZ8eWQal2NzH*|aSiaKWAkLPn2c`@=X$jY=Rt;L=pPV>s(=kv&6jA}g)YqtAh93*
z3esZIi?P5zEVZT5Z4h^oyML9g!yJ0&flq@#6a~CxroB%wxYD%@$u@iLO32WKF7yHB
zm>D|JD^PRor0S)kkE|ry?6|Wa5P1V%z=nMIoekAsjb5QO&x77=!2h%dw!`n%;^C0?
zu6h4XcE7n~!j|g}8E&D)-oU?LLmvFjnrg5@i)qcXpm*!>tM<S)_+1vh1JY{DyIaMt
z%+W6v&F&D0?14g3aXwr;l|CK{7001#$i#2-@ixkYo8+pg+(!H>q<w7OpA?X^l%_o<
znILm_QVp}DKxYDC2+$w`g4|G)3<)5zbvaPtDDWU#Q*dc``Pbj5FoD8u7AV<OfK!0!
zXz2<(;s#m@32aH$Fdjh<iGqPi_zil9i-h_KoiKk?N)iN-tf?SMfq^XC)0ZgE#66*q
zU6MTzVM}%Mk^%z>F4fHvU0m$(WzMVPP)N084-BFJDbSe+VhB=#h#<&q8F~v6xR9-@
zfOU?;lc^I_$<?<~b<K~7tKj0r=wpbOM;|{x0r7uH#d&b?Wcv6_s5lmV3=`++<E@kl
zC&|?|xcDymm_&SU`U%>8#`F{PwZ-rPXyTysYSq6n3xDcMyvf9$LLo;bd&tCpsBSDN
zFp#jIx{=W7rsZt?BZS*gLSV_VAi{zMydYUtk4`U@E`y0E*o}rxcNNGfz*h8xi@*Uo
zFlHL(LDM)7c;Ty{kTU7AXkfQl$N<G{Dm}zavW!6pAh%xhgby&^%<UGM1qptfBySa|
z%IpPn(g6}4Ob=NG16lYPU*h*n{0tOwSaJs@QmAf$QeYr4pXz3g{#E2rT%-Fh6mn2<
zhXf)&DbSfHU<itWhyuuMCHfahz$PE41zvU(z~ndxr-heajTxmt^(e}KKvWJau@d}5
z3kh}+ctLUA_zzG>h153&_^V~e4^m$e;q4x^rcrDU#d+b;5Qw6IU1lK<DfLt6A+8c%
z29XWb_n=iiz)fcLH&GrWD4Qfd)sL7-nrsON2t?k%XK;Nk9A{0fw?ug~K>!rD9#`4}
z+u*n?JO>KtHSbT(!Kmnc3xOL1B72~a6gN-WWKNDV$44k3QzcDv2oVjKCfyK3(4qRL
z<dHl{AB4M7LdX&j(SR2u8|u+HrP2*Bu>!8Ap>tdXO%z}&dd@}Q1oe(d#}gwql86~_
zy%~rOQ-G_{b8+~?8|XQbU@obbia(@>q`|->Jd7S<E*bg<ooG2OgakIEUJ{6w!$20^
z;Y&Qq#5<snTFDShtftlnN`Zj{n_6#<8cow?{c9l<a!4{n0+F8-=u8wb1UrI=BB*{P
zY9tB5$-T9}tBwK^c_xILnWk;eFbwfg)CvMoIZ$dPI8IXsxd=R=ncnzrNL?;<iUAUq
z>U~lt65(Z<w#6blXr>pw6arB+@E0@n?-c$Ny4pqJ#30r|{2p|_4{(zi|0Ws>34WL)
z|2AJhgJyc-K9G8s^l%jLwwYQ>;k(h*4wA$6L_EarMq_<|xn}%3=sigA@G*MF?I+WT
zD`_SfUr$%BfPpOhg)cFdiNAo<M<s{J#1<-_B?Sf&mQ+3o4K!`Hd&WRWU`A?%a7Vg2
z5(cvH8egJ26R&~Pm69Zwh@tYCQeYtQfj+(vDt>L6?tMEZp^q8F2WWgDxp<cJsyY5T
z9bHt1E~1dXK<FY{ViGh?CV%me?tpN26}o6PaR?eeF-g9&@auADqC&ERg1fs8FQ<)9
zhrSHM{Pl3FX-H=1Neh7^)VdB&v<IGrTQ}ejAoYNG|8KVG*62x^AQS?TJ#Z_jHCU>n
zkXuQ3C`C<`=z<708Zbqwn@#W`{wNsd&t`ZVMeQU35e;}zqC0|)mPmCZ0)hGF=%|YT
zqX1RtsH<Qh)cQd>9=hZ=GO-QjPXf^u3NRg=yaKnrflh`5WKuqaThrAMFfa)}Kv&yI
z=1!m!<mdBXVi`POflhW6oS*>H(S{Xx+zqq=5->>lFdj!&N5jA*yqB(amCQALrMvyq
zKoZO$<x@eF3IkdAOkd(~CO#8V@0PSfgcEhZO9~7mlBffgXqxFOJ$NjQBnTwso8hf=
zbs`L8;rYHqdnTR_sSilnNyJ?0fUgu7NNlAJ*r0>OU=zHA)R?553?h~k=uFr!1j~a6
z8)zT`T>uHp$uG-+dmROS<d+m2`*#y?pn+&~0SQFaK!uf{mZlDL5jaCHz3_BMy<fUD
z8hFoA-5}jcCN}@O3FbjBeepja5XAxq&D3`(0}Q&_T=L$Qm<A2pLbrPZ|609xT>m6=
z3FAoM)~&<+O?IrQ6S2*)dk6Ssj*EA`%Q$yse!%nRLv^2O?mjw|VIMqX`t=*J<K3T*
zQP;LHefm$W(%hX>z9aEha{sA}xr~wI(2zL!nk(%0qz?^YPZEyv9(|)<Sly9%`^!+L
z^JHT~ZPezT?^dPdZ|eCj_vG5F9mepGc|-Hs7T1Hnb<Xzr+{eB~KGagUZSe7x54WAZ
zylSjW8{e+Iz3SoTyRL%$J3gFkNE^RY8@uV(*BKcLG#OPJzq4R(mu{T(_HQ%Um7a6S
zW56U?anHF)1qr>QO>KXevp?<I=>F#KELm|SQ26%md4=!yUO(qv@SdUB@#LX~{mBRT
z-HWj6Y;%d}pAQ*-kbGSzDX@Vwq@gg6LZGuIqDr4>!8VubJ>E{C$Vz*J+%aI1Y;lj!
z!c^=NKX1E5fsLKU^GVok_Fiw`^Jih3#-`Xv^+9i@_{wfw7uFTp!~%cs7VauM2$^oR
zRNcN@qPKWEg(REaBU~~DWXVqWYJRmXI0$Q2JqxpBFF&GhehzG9->uWTylJkVmy)-g
zUU1M(6Z|CX4*RY*aOhds=CLW0r26@9rufPJx-L9gcrX_Ds9RW4$N|L`tK0n~ddl0Q
zkc`nIj2r{9WL3VJF53bQtciXWMq~RO(aWC$TiJ>_y#pwgkhk5kfMcg&J_+k&E4+a(
zo`vO)9W~uq$eW|SvisMC^@W^R;6S%<PhlS@c1zv9QKF~6JxY?z=@Bj)1F~d`R>&4b
zKKV#4`062BB+*YA`nY)PGl{)3rSNOEY?0LT_`g%P?}RnSZX5mHeC}fJj4`G9mCl+q
zzM3_jZ$6u`ciL&zTsJx!Kl>DZg=N=N?2SkCGfcz$(5ibs<IPbY*}3b&!-ah@KwYP>
z?|GOrtO<J(ww$e(=%*NuRsoOJ=-I}j=F<|5SMLwV%w@*g!f6G4b2Norz)J<JI<|A<
zlMaaOyiX6mS)D1fssx@MTb(W2fBi)6pWdx6mp<u;VmnLqUdGkcz@PT(E4zeDiY)fJ
z@P`5xN#irr;avy})T|%sptD<sdWnGys_fovp=$waj%Ixq@KV9gb?jtQF_@jaPjC5V
z^;%hACGgDH>h-ddpxBhwmx)h0V%W)2eSmRw4X|auzP?L1lOoHzE<8~1Gf5LV)ZtqQ
z4Ah8+I&4hEX5JsjFqe(q7EUerd5%Wh1-w+SxsE;0RE)%)w@*)f^C(j`xe|DK>`}I?
z!BkB4wPC#By0EHXGpval>R=WEoi#J7^hp-%^Af$&+eff0tw$I;227F-_6R4NmVesG
zwky``^FQe4zIn7kHdqPV`u0(9;j3NOh2{mXY&BD#blhTp?+wg)(Q%LcJ(%ot{@|tS
z!rFpYuqJ(|Bd`$YtXWv4&#+*Bkm#qqeMFXR?-8yX118Bn^$6X;UR#>C-M!!yLsR^u
zL&N^y1AP6gFmsG;A=Q)Kusvkv*Nu|GX;HxI-Ny35X|QQUep0uawuk3iHbu6#$H*N6
zvSiDBH79Hfrjaz$pA}NrhwAhd&w(oTp(FZW)4KXTD({m^!8C>@>q%h``;ZUt?`MVU
z#@IBep7w_ADf7E-+*K%x0^aU6Ru{@l#gyNc+{48?EF)J&4>K(mu0O7b2a0J6=j@j4
z_86z{l2s6MY`5Ks)X0Gw9JlpFY9fX^X30<eIyPmOtcnoYf~XPr%6{8g%PSTU!)6v&
zJdQhijF;@rhyvaW7_Z!&Q9{J7@jt2i=work`*^Jfh+=^KKI7dE+Z;=XK-+CgBTu2j
zj#gJHfi-ddpS~^jOmvD|)#iVE%ePmmvdE|h^6~&n&&27TiF0=+L|Z89)BQi??cpYP
zMnzp&X8Pz5ztmHn>n-nYDi5G}CVpDu`Om>E?|&=3cH-!hHIMCH+5XuqY}h((_TumF
zc1@VA|9j((1!3DouS1L0C$yhx$eKCv?O>=dd+7)JZDDQmf7%|s-tg-c2d{U-8E!EP
zFP8ltweVtXs(f1dfsj$#vb8qHT_$WTt?u1wVBFe&>Z@@;KX9z<sn6jwhv~VmgWLW0
z3~bNbzph}UXJ*;c^$uwcx9;UWyq`7De`v(#$DrS4@jA1|UfxMq{HW+s@D=s=)~uEf
z8!rD*w<@+VIry8{W&t{b;gPftI%DDCM7j-2Qs}m^Ffd8-`&`NI;gYZVbqsV9w67OB
z;{$vN@5_R3)9gHKNVh#D^C8>4q-Rk;y*pGN{n%0#T_rH4e%g>e`Jv+eh2tE>`=)iA
z;<R3+uJ%*RonN*M&OQ6*`^u$tnv=;(KbG1gIxHIIhE7E64QMc(_`EeG=f2_7x3h)W
zopY8YT`jr1^zG-02T7lJZw1+%r4^2cmM5{p&OW>GOPPL3D(&lFmip!LB@Z8eyf*d3
z%xfOqGVYWU-;74j|Nh7kOpc*_i4KU5_4bU5r>(7w`K2l$GA!C>S9HMfyvmqto5m$~
zxZUn|(yD)PkD1!GsAk`ucrTZj9}4_^Di<^D=#5KsCzh<6jIMLXF`Zv9$(t&<O)pP@
zfh>u)FIs6!s<cJz;V2l2cJcUu0#rfK`A~GRgvCE5r<6NDm9x=!8t@`ic?9Z;q(m))
zx-2|gA@3|nwmneDX?p$T{N9mf=FH3M&%K}epJj1hcP?1*?UJ%CiMQ|8__d6K!aU2X
zI?huc#%$(i^7-(=rhON`2D4W3nn&G_*F@UY@tK!b$ZH~}c38JMWYiHcPhXrrbgg>m
zpV*v(i!SImwBH7pBm4zEtMe4k^Ileu{m-fTPwVK;NG0lDGfTemu1QB)BYZqzMs<uO
zkab+!#LeaTp8$+NbH8_pv5r(m`-fUIZaA)u2ew-_u00;&QGLg`Uq5Pc&#rz6*Uc$r
z`fgw?m(TNWWhS7Ojb_Ky-qlXK`p<ItOd#?)x!9Ine9frQKD?gy`ohhLAg!`ta#_v-
ztiJti<EpoZ=k85IrfnX%yky-4WxaFqJ%6k=;f>r_87mXzLiOyCYVsR7uVXTM<nrGo
zepu~bxUS!{pRT<9hw73$^5U<_331_9BOE(TCkLiI#=D11C(-Py5f5f)e)~lx70;F&
zY$>F*wY#Ez<dJL$qpPYS3_uq4V-x32CiWv<RUw*P!da&4@)rY7a(s1N6r^P+=h)}w
zGHurq<Ou4=7|pH(R>k_AQ&xqg_{|y4_QiVesw3jrvA~BdRlCJ!O~qW#>(5CzPW@dl
zlA7YTUkhA~q{d;Y8%Sz|U*Jf#8KzQIB^rQ9*d|q#wJ4$YUSnG?6?qutH+eWa3)>VA
z6pm!i6Q4C7%{IsWmRC&`oju3dssyHqx18qK5UWCGt;lO2i?)=TK6Kqc!sNiG{arbR
z=X6~c4GD|(^BaDijU9~#stwQAVXMIl(u~%87SXj7=|KIQN1s;$Yh(S+E2|cy_{|%B
z?u$Lbs~W^xVu6D#j629$(D8V$O-QUj*2)=FWUY$fE53>P^)y!9)pjvdRpz3xa?UiO
z>lRWd2WCC!x`!10|Bgptgx{=@=VsVtRaLS9$ij-6I9D^VBE0I5XiUlp*LC@cfhRdT
zbX}9cqu0bHIx4G<iN;DnG)oMu<&by^^fZS=Fj2$|RY0Q-<v>ZI!ei8dGBwd?nU`->
z!inf-S|Dbr3S0|JN8FDf?q;J!6vVxvZ#izX8!hq{hr`$*6|y@;VGG_fC*-ABh%75O
zo&@tYvRe*(-v9A;?Z^2k`YhsOohY1&9ZJ<_DUHFyMVlUc+$9btnaY*r<u4*(E2BUU
z%@kE2$0U7zEbL|z=V>N(6X(^5EK50Sb<7!J;7QOq124mC`Ujjyn3tSK5tW_h*eQV*
zL}m5J(o%6*31?M5(-K*ls%X{%TS4c{1q_m(mqr(rRd9j{<{hL{4jk%dZZ<ef(lKq2
z&S=H_VTX;_vv}ZnLv<!*59ZpnHJ?T>BM=`{K^d(s2kweh$d$a=DGKl5YVUs=YT}p}
zV1J8|Ia*{1hWKD$hb3~XvQL47C_o%;hOJCT8dqTPH;_hD;V@DSWAQ3pi~*R0^{aSp
zpgXYh2>1WcOZ&S13238<x=T2zI%c34Sj!3HDOR5b?X%^`3sf;>w7Lp-G*Q7Gtp*LC
z@kNQ#MBP=KLIQNx8iB9-m6?VF3!M@|9HSKQa6%?#84o;dD7u3j1Ml=7sN0W8`!>pr
zuEQXT{<o)A+ox~p)89ajmG<f7#<1a{KIB;Jzdf~+ea<SQ8F>6@d7sRNiz1LU5)kdy
zf}YxcMiN5A0o2h13RWiP*@*(qa+WHAd~v`Tjt}S@$#m`Z!~gqM+Pk*)nh3@0kpwE%
zt>UE`fGjMaiBpq_1>n5hq816qQK$6!e*gdg|Nku13p|tk|M>CGwapmAkh4NLBsoSR
z*%gT#vT~|PRNok-liQsR=30nU5|xN{i83U2nGPz)PP-*jqtbzOuZX*>p=S5m{<|K(
z|KqXG`}w(EkL~f<9@n;v24uZq<ND~KdQG2(FP?+LF{cmLJTZ!n-W#=hL$piNn=1`l
zeTG#dCjDf?Vedyq(X-wE`V59urFQuY!gXd}qwrO!*CWFxFk`AFu1C)QBdYJnmDVO5
zpTTu?KI2izRTCRA4}KN6W~34(1)$2THWL3w>R;=%>oGTFq~2N|&fnlUb$;l!-MGM}
zssfEH%}5Qwe04RlS5R+wJyPqB)U)fI`1Ox{T5B<P4%YYiw5|>s6l8Bb5<a=b97#2x
zrGbV%xYZW(8?IpoZjeN5z{43D933#Y4fWB-yonp!iMD~L*Xo7U88@`x3=+o~U`Zb{
z0~%b$noz?J;?cu|C|zX2jkbz}xtY~%y4V8g&O%qv$MykDdsH=&(S4+OI<U|gmD$mL
zC!#VC#YQIZv@BwS3k%b+_$j;q9P*?2Hnph33!p<l<W_9Y@&%GDu$~=ljVp}+0x8&V
zrR5R|0jl9h!xK{htbG(E(8q{CfFNc7OI9pQV_JX#XPYZ60Hg-P+7QPY?|BZh+K{7%
z_r#%V{b&oD(ief$HSlSGr4r1uTAZ6C!3q<O8}PJ4p8&x{mRTs~8%;qjs{+srEQ7Om
zhZ}%Ye>fa)NO;e)m?yM2^(29Z3C96=+M?Hh;2f(W1XG|XIK`@fXv-`YpB%bp3OpB~
zNdQahFrTXl-V;(6kOdY<g#j%cq`rXrY%%w!rFOwifRm?NtIVub1Fcr55fB_>(StF&
z)dVjIsitIsK0?>0g@RNb>|~3XqL%s?ZUUV1y6561-)katJ(?rHk`3l(T%iYRVGe5{
zw73Mp25X@$%?1S0S@dPJT_E)vKAP`yhlmal1ZD`9NSODL;frwEG1f4knd4INaGD9{
zGy(HEoMy^#0<E*GnT{bNWLTdT2U2_CG+WF`Txv3|Rg0La4u8|&%m=MI&_DGtTX3z(
z=uaT{sQ!{Vx<?oOM&hgjSklKl2xYjkd<ggqfa(wg5aQ!XQzv0=V)?k!g22Q${wsU`
zK>}Jt5a=OTB4M^6?e460O`=Q_X<vvogK<ZqECiRO1}AK0`MA;S!Gs7uIOuZ_hps0G
zNC=ilnD-E$OK?>V%Lh+O#!ZmnDpO7i0ka8?H{oc3j32D-))(=BqXlI^s54m*h{JS7
zZ`jdZC!#li;5^cXqs0;@mas4#X<oz$BK+Z~)o<-T@aP_bKpSauqj`}q?;&lM;14;h
zHazVhZbAqCV9L2qz-)q7nQ+v>te7?P^x{u|E+7c-$YEESE(!B4a<~FsmBTuWqeb8*
zNbo9CP8|WW34Un8F$S{|mMpdE2t;$iO{ih1jDWcXei)8^?1CRc94}~=h<+ps;&7NT
zs2^FNj>x2NY3qwDz|n<fAuI*qFrCqMJK9Jh+71L|hzv(dAWk^4Fdb=B;)FW<`zZRB
zKE?!sGl&erl06I4nE%?2|GEoK!1G@dW;{VwADj@1HbdjP9BJ9a30?Si7CJ{CQvd-Q
zk>RoA!ooD>0|N%^$_Ky<hVg&_@Y=<gh#|uYuT4N%e*BG1(=ad#hVc-V&S9cjjAD|<
zViN`hXfH%p1CIh0aUJF}O^=H#BA%aU865X1%Fvddh%+O@Ii`%i2$=D3Kp1M>1qT3z
z2BZz4)?|-0ILsKdn(Q$TIWB{PxGw@A#$rfY4NFltOlNeP9sjRHbQ|zEg&c?Yu0%6C
z7N#TLi#($Zvi`wWz4Xb(!y^>F7nsq;XDwp2L+IWu@JIzbLd0ij!6W+oJ7C5MpXJDE
zS3~zU!6R<`gJ7mgccyM=ZY7WvA?<i{%4B>cX=Xmi8pE0G!D;If&2-=%5@Q9>PDX|L
zn0Iie6Hz_j(XHNgC1U{uFVbKT0G9MI_d%yUSZj&+(**P^!9yQe>&_1*VbWP^-S~@v
z*=PI*fzKHnx`E)KiC~F@c@J5839iXut;O>hI5Tay#+1P&U^c-!Oc-Qv`Uh*zuBxYi
zZ-O(!W9bwDa|^s99KG2E?|>Lfq0?&UO|nM}4l@SbPxjD3p3K3rGdWKn{tBF#I{c3b
zqmqER1^y=-{m}*g12KG|)9UCCvd2~&W(-Oqdq9YtTzj6=g`q<@5N?H%fCr0Z7mV4Z
z<}pC1Fd=*BA$I!wHK5`dY+#GYP^)+ZmjXtKZf*7<ralN?h^_-3Cs=mtFnMYoZwVC^
zWDirs&Vc_vQ1KitwZ+`6R?!Vd0!E?kOwrIGO%QI4IslJ6*0o^F$7&vfgbFjVhaqxJ
zpC1J({)QuMF;mqlp1`jFqeAyw@T9Lca!rr#0kC9)`2|<82N$kOtk8j9kr+N8JQ@9}
zk9h~zmx!7Ij~?}qhK$P)yi9{Z1X$9?+z0h}u#$-QJ_1@!@GwA<-1%W7OgbycjlUFB
ze8ykp`}E_`%>)lE1WP2$dq~nHxFv^`gy-+ZRcOO4ri|MJ%qBS9grNiaey}#CR*eC^
z1+D^*r6L067C1c|z1Ib&LkwrAPYu0C_K3w{#-NAD9=gaE)s4f8#vr~gu0kE2Hep;Q
zU~Yk@!_m1ecp75(L4E4z9N8lQhZ%#ak+}ddlEP}OFSGyyf}8-BU>v41nrFxFPDJwn
zw-_<P@%@SP#Vkxm{z4+10H0L-SGq|~0)`&sghK<#++ZB0Gy2$$|0xlD47e8&BRqdQ
zk-n6L>B!e7(s6L;QM8agW(&Bv$OV9<g)B^C{zd~viYtF3pohSr5W@lQbRM(bkYS2<
z!lOI=Xwgm6?ts1)?gdyX#Vpri+#_*)O&H$5$sYX-xRtC6p_uPAxyM*BfUjxEIX-kq
z4K!Jyh5$>!nB8jJmjt>gnX8Y)=<`DWod-MGV$SJOob+S?V*Tn9ik7gkkv5@Tllh-r
zf&SU#jI*@3(3@f7OQt;EoviU^zOqPf%zWM?DJgKPOP!!LKOX9)8@6`d7IOa%wXKS&
z7l+qHZzUd}f8Oa;6?5ob?yDs(%~{WzmOp);niW6%es22j)pyK>uEvK?zPxcfBPDja
zjobKHwYJ3%4-TErdHomPj6(lMOMB3#8LIZQ;SzI)RLKGJZthTp|E`Q`U+?sg>Q*c6
zh1{WIe7X_cF%Pqm?_)$)_n$mky|?wnB+QskYQk4%Eak4(#B{Eny~aPhBW>*1Uw*Q~
z6ncdJ<Z8w$t)?=}htUkYRvM_*Zs(gcO%o}@u)jHsrDDvSP)3adci?@#WL@=XEAH9c
z<;VDIjfNNJVK(xwDGl9MEuUME&h@)A{<h)LsA@@7OVkqW)umeZE;qHkea>t-oAv$u
zgTPA<r5oZrV*iW0^zhMvlgop&SME5uym6a)9Cve7yJ;NvZSUgSj254&9f;F%#L2JI
zzp38{_XY>zOcGBLFt>oXaHPo&W`4ZV<kz|ITSS^I(gglG58V#I9Mt^l^cW}2H7IR*
z9h2{~H^)2Gyl=z1#G>IR>4N3nL20URX;;zk9``h_i`|l5@6?sgH@r(J8rDe{{CT<N
z_Wut}=>i?2VaR{w(P}69*nBH)PVS!wUzM!$Fw6MsBN=tp=hTa)SFUE*lfDtEtCn&j
zH8EqV<Ck)^a{rw3SLeRC4>OEO-*8w8)x>nJ{&0=ICt$JVzXA7GGrUOOh}9pKa^o~H
zW2#pz<*MiYlsnC9svbI|tMSdcdX*J7KksKS=2P35QiqvR=W{Nx7w5@Hxy*&tY<S$>
zNVZP%H^HB}IggoC&0am8oWQv^G?z?~mFF^v)$GmV$qqBiG=Bf9FMB*s^*FZqyD>$U
zm&=5z6E=+-JIrWl{Fa=dd^j$1k}i+hKE0e)TD0~4@l4B!U$m)!%|{B&HynBR`g(KG
z-`*FzzyBOw5C1y6?x7c#@w36&j_~tveO~8Q&qr`#bJ^Q@Zzgvd;EoJZT6F5NzU&)L
zexLYvS(#Vz$Vf8#$@-QvFZ_OWy&d!O`|rJd|Nm_#-;OckWdA*^-SCw6y4CN$uQw#j
zyNwUnQ%k1G4xazj6aV@5jr)JAhaq@toP{_-Is4y5b&XK~ED{mCKIUII3oc|a1I@VX
zwy;5Rz`kNgCj^tPw(l8X#k_@`)|PO`;{ydi2kNvYuCReH9Xq#~cW$#xEEpPdg)E3j
z4|(4v9Huj}$gcA&1uBvPS=OgTgna~1<l3o6!rTNE4TB;X7-3`;>341bEB*#SwwM#R
z6-hV?Expl;y66beZ!LHVMosV*rI;5DNAGHn-qrmpW-`4J6yZDf6IVDxn8uwXgV8kw
z!2T%sJuyXqDgk0Z-sg|Qj6q75Bc*<wNlpFha4Sf_-gLB<fEf?!!jMR7T%`n>F}JDH
z7@Y?yw<D4In7441x1mafxfLDX)SrS|p$+OxN4W&dc#s^1EK|MgM?}DE<K!~JJ|cMG
z+G$F{l;h#D<=Mo9;YZ5;yu3CBY3~PObE-mfw&D2j39X8jiDSgACg=AoPq(OQJzdlC
zaplK+x>52&8+S>|)&qKTn=`WTXW6qaFR6z6iD&%{ljf6FKFK;)(q+aTiu5V}k&5)K
zzB`0d=`)6>)5WSKS1pO7+1RLRT_36T-W#fT5Yk>dB=WV*UQj~q=dsIp?0ixG{gRGE
zyKHN&$fZE!LX#L<&1qH2)ym~+!HQ#^b0=?$TpC2P9T@|mOGYLGXWO6uIy?{>Fg1In
ztm|mA@!)^%s_Jro)m&(jq|855Q4*}sx6LM%bUflEl<*RciCi|9cI*yS+zM&GIwW$p
z%{DFRc+N|>z)LtTa#0<<-7edfD{3wfHPa-qR&$P(a>H`DVX&gmbFT5WsJTHDmlA$s
zqa@aPuCY=cT`rFfRx~)y?MjloRvlImtT409)-LII!b>RSCFF>jRfp{fRkVfpZQOOB
zs-#1QmoO%3?iDo$NM6VDMqEof^ym_=H4?AIbLPcz?e&V|VG5#6c29*oJWk>jEs@o%
z-@8%bWj%MPQXXC|4-ZycbDWDylH5@pb|F|{WSgy3((#x#Qo<WKCfchyEG<-VJEZ;e
zkZ8GWws}cMA8+IWZ{)aWuj-TSu*<gRilz!gQ#8pztGShx^7-ZR`N4`J&$;`zMN<u;
z2uAq#jgo`bbN4Id@#XUPV8so`xg$xEU#i0{2P+oXX6u%8Jmrm)@<wt*Q>w#Mcd$J~
zp}K>9w%L{?9sRtKGTunOXzG4RcA}lqiYu}#5LwbBx>j@Qm2!N!93QM;dCukE7Fnw9
zV9>o)wIWM@iLUotzWZE$u{<DFa^|_nGVg+X(OLPT5QUzNvY<5ErZk(tqu#PpzPTXZ
zabBL%#M=>~aI;ZfEX`h8noZ_W|Fl&;3RA3O@Tht`YPE<BOCnax*}Ko#7t0NHNg~pC
z)My@ipu+d6i0v<l@Sdx4pQ|gDN5)F}pNrV4!<L<uFAGta+9*$zX4{o!6M57YJLUTe
z^7Qla$R=KTh{D@OSy`IxT$-)JqaL(Xc84hf8N3b(uLBh&z!H}gbH?s-#>H~2T@sfx
zUdPPG6BM?*qgI^YFLm*jm$}Q!D2mWnY4dY&LY|SrQBUEhsWi-07WQP@_GGIGJ8tE%
z|50x4j#WM#5kCEW&@%d*u<?pU!r<bg(aU>cZS~q4-uCqWsL*3ZS?7uedryg@1CKWs
zE<74tBaVJcPB_0t+K{A0t#Fbvn9|``=P14IGelv~KjIpmxMsC<V2iM0&v9kjkCX^V
z(Z@RcVZ`!|;VXq;Qk-&TNnym1sMCJmHtd{!wIEub{gYGi`JdYsd*6VMV(0)P>!TIo
z1xB@rnE|*55ZHScT)6}W0?dC8JRU!@zJ}^^N-^#$tLYuEoWC~vkIC^f+q9_1EtwaG
z?1_1n`0g`Z!l%W;r-*pR-R?6f$1Rs}#XAbcJ2pz)tmPLim|>>OFb(Q8Px+?X;vI9s
zUHvy`ff`h!T+5R^XKZ`Us0p7Q$g_M$rv6zF8L_+K@b*^%1M_Q_-}ufxx}XXd4{wjF
zyS!pKvcj*kj?P{|ps0gSuCN6O^Dg-40evLvjfUegOTkA1;$=D-P7>RJ2PtZqy+rW^
zT^fCI+6a1}2KKsj#_5kbfy`bt%4<S_`9gRLt{@cbhpe3OkIrM>FdR)Y?|kQn`0Z#9
z2Yd0I@5tiYgiLer@lWW{GU!vD2IUO+qzC(gf~Vkz4Q8@h!Crj96#m?x?2$bp1r#>)
zDHL-=t+<mAOj!uyaKSJj0V@b^Q;f+n9G!38xzZ2zZt7o25bJ;kJzy#rIS5AQ8^itv
zR@({yiDYFB*$|Liaxo2u8H21@j;!%Re#)(*3CJ2yTmb2>!+fSz{Du&0G3>zDzF)KA
z;`-GFJ*usrTKLk4|JzPFF!bZ3>*V5HsaYj7={hU9jRjNRl&P;lJ>e*?O_Ht)(4y9B
zP#yBv^SUGc7TTW|+UJQ&={*suFIu@JbAD5VyC&5%mwl=y!mcNRD6~({Q{FID+^<%l
zp^Vp5#;c}|GG3J^iu*(2k(NB=WlQF&rv4-I6h|nEBNmDy?($z&@?Tqo_Fg>^3+Pf_
zpp@qz7g3l8bg1{pRPS8&do!kHoYX-sKElY_NRv8P$>&)xHBFhC8q_>T`MD&iLxAu2
zwc4CLAwJ{Ra#i?^UpuG%;oLrcc*?5rYqy|U3B(=ou3rdhaYz)oI0T33j0o)D2@15)
z08YgPYlC`It5yPL6G+(&QjQ`dI@^O#Oaw1oVKWluUGTC3qy!LxLqQ73$_do&M7a8x
zt+)q!@tGs){L7xTg+S~F9`u8$P~;ahnq}OnZr7<^-KVrHm{Z~_lvG5;WhJ$ETB+`;
z%ucLQQn`7`YRmSYmDbU@VyfyP5>w9!vo(a-<C@eeQ)U~#JHoy@B1l-5BYw4C`t^U(
zuU7IuhQzPlbw^C)X9rJ~Uha<271oW3U-gP#1xUZf3zJ=Y`YCj&=^Cl&VmX<@B<fIe
z$W(kTyUUEZHco2#Tdcb)%YCEN)LMSZg1Od|xmJT(<0ubHl9u~xQA;(b26=2!cmE?{
za)~hcn0VRdp8nlh)E3p7jP_T($z=i3a&P%_clmP)GbvWO`MJ0y*NADP$28KUYUQ%?
zdiodk^y7rdH;=OijhHc1xfY#$eI7GLgX);ijy}#d?Czh?q+T**-sX4r+jaM^6(;A1
zTlP!e{!jYWO1^tY-14rw|9gIR^kivOcfXD>c}(2WD{cvpzKs`-sXm$>UFy9?>b+QQ
zL1F6XQ1i)D^;~w38FPJ{)LW@T9ag@QiE72^{!(vmd8NC&lEPdcE4}wzoStXIbk<`!
zYf_DK*(ZDYZF~CFgk!gkv)>sp_fU`i?v1|ZAb(F`?$M#%Ayd6_+3yUQ7fqR)7{dG$
z;-1BFR}Jc^9^F!5{%YyAA@TH^?*4!B+3;j(es@1!I3^TNKNC;G(nDK>W1c<z=5*<y
zK<Oa|`2z}bs}8l9Om)d+zcyp~#YyMn;%P>fWP^0hN`BOW>1WFH)1a~)<?<xyoa*=1
zp+TkQu`Rp%`-Nj=!m)hubX<>1qE-iD$z(P~K$;yOHv#E!vFdRFLgRgT34C%#B133A
zPiR~#*7BFCdCQNv%a2i*t9MB)-*zjX>2};28e62PT%@5~q@!G9stBSef^LYl%7w<7
zPICW+a{qZuYmE*{enRl^1dVPN5#4gpQ~R!nsbFby9b?UMu}`L+llcJN_rN@zS!lt9
zqA$x-+aFt79t`!rF$oLYol{>>_9paN-o{5qVv`ach1%Y7`SdX2t?>`{a@Dw1`0vR~
z?{AChIo>6OW_MD0q?=tQGJZVVH9X=F@{4h@d)4rjqi1e&9t6eB`#xaQ`mx3->16xG
zLdB}4b#8_2CTkK-)wtNzxDW@7(*qOUpK8x67%(;-Fs>Uv88GwMTlUFa_KA|Uf7gud
z?twDefbl@ZIdnV}p0Qma(|4EYQ?f|0Gq!!>p~p?K*6C%fD{Qw}lTcFQ;!xv48Yttg
zRn|MnBBE!;xOVLBWwhuGzWC_DaZ^siZa;kV`A4eKryvU~u09_R%`?ez(93ctY@fF#
zp|Hlqw#G$mpzPM#gkhts6vKy#t)Y=KSFL3)EwWNfvr-D$xsEdTq?w)mr`k^yw37o9
zh*w;C2FlJ3l(EKpH`Tc8I@x}`Y}4<tRso%T>l|})aL3ZRgqUjyMlW3^LpmzUnfEBK
zT<l-E1br>bnd#jx`}{xIXRF@_hGu%-y>ywXW5-NJUViDK`?YLrrnh&dH$e6|{%fr3
zt7gh}nc*6l;o{$##Z0yJ9mm2taJ30tvz_-X*y?O|`~1=&aqw(M)Z)wuc_63m1yuFe
z;g7%!&2I{?_KR+RFBx9DInd>5T{acHQWjGYb*hcx7Ph3}Cc(~d@QrGB_)zY;z-A<?
zAlf~DlkJXz%|jP9G@smS!Eqd*G!g=?>+9YOIZzON%sPhW{b-3Yw$VtDGrZtw%z0%`
zLmoZUjngopO8-61+!kZ_dNFP1&9$qe`tC+Gn$2>UzsnU37d9@8j<#>I+ZgSs1JyTF
z^pI;CCTa)QG&DS^&UhZZ?CBQIbhqa0_MOx0qCpW(t-;QCF)i>W%xV}=UF>$Ip&{E@
zxagLp)@N&crlZssL@#q5Yrscje5%*+9W1YF6Jf^tdWKy#vx{)%MdCA4DG}PE^<BQ6
zHkjK!*YkWmSwVxRLfb1kBTF+=aS`EP>KzVY8b>&l)?Mf-4ZY#sxOLH?RJ{nN(fY@}
ztu~lDKiBv9wqmcW2~WExD{SBm#zt+p-hL&OD=S=bsj-<;vMDQY@ZZK}5od=);MV_E
z5`5XGGcrGO0z}OJQoraBrej3>mwGMVhNQ~9Lu!}X9z_~wPPj+J^Dx^oC(3<i!xp?b
zG66-b`c$v(JA1M2vIz6Kukg8nj;~OmpD6phbA?7;DNQw6Xm{sns#otTqh&>Mm>S9I
zv#U9Nq(Sv++0v*4P0SeUGkLxg$x-Xy`U1T5nOxO=)3Z|l1saE(t2H7QFU&Q_)u0qw
zRjWo~wT8ny$Y1Y<+O-27<o4~-;umjfZs0EkE}ujdSAS1%H*jJp)e6%7z=2Ki8*-&*
zejILf(|!45>tVOx=)Swh(ky08_TgLi3wCsd3!ZG<!y10m8^k&NFd|HKwLx{|m||HS
z{#<YP(SwHby=slGpXm+fu4NdQREKBgE<d}7OFG53d!aYHG&8q-nyttGo;_sM^W%-L
z;KwuV$K$)I*IKrFEcrP8Wz(*0_q|?rhl&h`^izbkrCoPu)|a~Oh+l3LJ3Tm+BzB5=
zrWy|{er^!Fv<P(Sv$a3);|q5tTU$T=zeuOAKZ8T>u6kLr_YC*kogjMmx3d?9{$n@o
z{(48EANcUYYp!3@xIuG__(ZIu;!)#y`J+a|qn`%<o;?v;OQM)Agl(WT`mhaH;||vn
z3J6HBBfQHT-eqZZe5lS7;u4V|GM|pabVioj!Ivn|Fa<WpG4LSG1U*f_ybjXRKw1`Z
zmCn9R;2VKqcQ}rO*#?Ho!8d;bBM5xcK<5MQ4&+aL%oZH?4#fQh6*01g4d5ey(GR}a
zVou@46LEiN=%IM%4=Y3m@L7;gFlN`Glk!I8#K}<Qk>IhFqAG=M!WP-Vp#A;>o0Xql
zc5FSFJg+JZ-_TO_W<||-SWW%1Q`cVjR`~P|2u#;TCckD(Y%jXz{N>^OV-LLJ<pUm}
z|3$_#JTh1Vg1n$eWABQ#PSrC$RNWtbIW>`erGdTSkE;<;_q**I;^zzoZ%9;2d?GdW
zwSB{fFl5h{@0F!@IG1!$r~bx5z}E(CZm<^#b2HR7{W$KR%gr~)cfS+NqJjC}_aCe~
z^8SNx!NG&=Pd~(e{O7yQue<l}f8YPhwfykKumflJ&zc?jJ(P1}<Z$O~oNoL70{{U3
z|5Vv~IFtP!IPlNC&1Oy$LxdzU5lRj%a?_(2YU$|IbkIa1Z5<T0q5~b!N=wTvr<_tP
zl5*&za#(vD=82@9q9Ns}>9B|T?elzpzdwGv-tX)6dB3k+*L}Y~_kHiW?rSMybE*fE
znkU03W1iTR+K8gk&jtC3ilT@jn~#>B2aQH-_h(<Zk*VN}TQ;<RJY>9g-NhldiH50&
z?RUSGCjIHqsktwE^ZiUk&OJZJzkHKI_GiC#<-K0UOKJTx4<zByc%pm(0yRQs>tkn;
ztii<AKcAA^%cskh5u_xbbV6s7q3)}fD5u>@O|`@J%du7FeQq(CrKYUk-%CwHSMF*3
zleKi{$M@L6ttpR8nbUFj@+SI_boTrH{8dYok8D?_E*p|NuKwS$*Y+vcyI9+4#ag7T
z_Y>(yq5tphIB>cIak@mDh&HiU*#%|>;VbWbMZ=W%>47CaW6oLoKJafWrMw?Fh`kb#
z9)9wW)-0tgLWm<^%fSV#zfIobqXTZ1TLLW{&s)pM4+q`AdvLgQ;mlP_i2quhu8|yl
zE7;~FO4K^G_6+QAy7Ir}^|fc_%<IxUSB7~E&BT?OE|&|osb5aidaLSx`QP%U>Z?%&
z1s03Djbh5V<{CcB{iA8>+NxGCluOojPCsVs^YhKN(k&K?Po*8>OPvf&=A}bF1Wm^u
zrJVGC;$0S0NE~Io+49dlCMEOC^}nU=;btb|)n^&^GL|TheU;Dp)L^$Fzx<$b^||9K
zr!70ACZCG4Lm%}l-Vvj{ab<wi<a&#+z~z;ue(0lysc!{t4^5NiD)O(V59Q8{PcvG*
zt4&?`wom<sDu1c+=cAe#6RMQ4w9jl8Wn+agn|-Rr{iMeJ^ts+_tFco8Xi)%LQ06>;
z6PqeOWhq*NIcIQJ_(NOEoiA}$96eKhFr=oo(3`z@<P=f#XQgxKDAYl;utah(QnV0r
zKE`R`NoLB7=W?MHl1(yWO?vt8P<P)MHPOu?XG2cQEy<=bXg#MzNPl;P+rpQ)cN&xE
z?>4b7cS9@b??Tuf@@toJ17eq&b6U<x4oHn((BBn9KX(cvM+4PmLO|E|W8>t3ks@+1
z^u}o5cF{>V*hSesOL?G`s&LNc&SOCTEOvh0Eu>aDlR5LUC00`5WBR!w==L6AJN=yZ
z%AWi8L;Ig&&O*+-qmu11p*<IxE1|AsGj2$zQlSrhEy~sy3(SUQtY^<33sf^(|Mknx
zxY8q%b)7;D`q~h7c{enI-W4d?`GDSqvQ0(;@uHoT&OxKl4Wf}sXEV;aj(`1Pmzr@(
z&Pg~@p@iO54E@w8+%np(8VsR3`>~1g_DGR&F!aV~`*x8~HQ1F#lb%4S(4X$?&7L>b
zE`XK<urHK3+ihYS%G)hPA((R}cZWZ;t=u_}yF+!wjPpOdAc|fVInUzk5KDHILGN*f
zFVgoO;STd8rkz4OeeWjrnQmw$eQyZcLACW8*TpV1;tc0V!llAC`rcybSf`LZ+O8=R
zlIUOk*yi%~ZK8w0Q1NIxTl5od{hq4v!&2dD`d4rEva$ADXk!4IUnaKL#75-y79urF
z%;OsRL7U6PSzN;-s(Y&VcCDs2d(MbGL6lx8W{yG~M7|}GtC1pKOnic4$d_2kLaeyZ
z3dvSkh?eS}8nII>Ac~$8iDz;Q#geUM(0iN<7wG{<xEFX5z0MFEJzx|2WH+>u{ySfM
zPb;r*lab4P@}B+s_ZwL}9^lorJ@%ZlJI#F$-si-<|NFV3(O@*Tu3>eLVo6io_0SNP
zffoY<&Vzovs#74)W7_LnURg>*{-9@~>=|SBIne9?_RTV}d!1yfG$fFo>CIj^W`6;C
zb3L0pW{;S;7)pD;g{jWNk4=`_ZxLAsL-&l>yKpZMdqXtn0sd@TxqXzVI2c+pYQIes
zg%!5oln+zeP`2@iJzf-5DGnTkI*5i!Bwyap+q~IJM(jzVp-OT1D0G9!pi+$EbZ>e?
zit97L#78(AcoGd+$Q&*-SHf7!j!F=n$HY0D4M!vlS%@tcS|OP)3sIxT*kfMZ^Q9ra
z^a_-1FjkoZJs-fXDHGG{Br(#EAbN#2+hwfs0<>m5TYIb$PIm2T&^;nYmL)NfhCHIj
z7D3;2hQy9mYF`%{a%4G@P-#dTJ+>Gc+Y|DXK8CJ5trip0bsaC_7KwE@vYQfm8T2kk
zmPa2uI#x*%O%{pGIWn;%sSFy%b-f`WO4n>dl0%+pV`4tXl_w#}URrRWxsnxY+1nCC
zr!jFh$MuM0h3qAb3$2jMlf6`3GkfOhynXueU6!ICOnj2->JNQhEPmPj(lngyEZ;Rx
z)PaeGT-N~T%W`o#x0ZLtL{rWxe)VODG}dAsS8(rF9AA}hRhhkix*w;?zw5^aH>_pH
zCWxvq@p(?|5y=MG%lTYrg~V0%lBhcJ#D=_mv*f$xisCTwX>P4Qw4+!&(EZXpoV`@O
z%SJSgiACJn0O&xu_$YTDJn~^#$pAuM>c=L@KSqkof}sf`9~X1?5qn>f=}Z0DHu8_#
zMWSHn?a_~0MG>mor8~8;(`Zkh8hTGX+6atq#Uk{eiO9Gsf8Q)G^C`ndo5oqH%=>>f
z*))cwtUl~^c=h2slX+8zHbqm^$Nx!FuwH#a3OucDlhVH3keb^<>(ahm@;P)g-{;U<
zYF|L9bhCT<w=cH0H(vR#5$l=$ZJ~4-==*?-G&K#7(0|pVXM^!=Sh5~;FEZ}N|3)J9
zQP6+M(OzJjjZN!8@8HZLF+AWj<29-~4g;Q!t`q_EW|U+FeS@P%<IJ>lIJ!I?J*hXK
zKSN2@&}cRKWAr$XXOXDBc|Uc5nI*Oya8B@b{Grd(IDZl7rlxWyU^WkX1UMJ@IswqX
zG&pJeGeA0n;>Vi!qz=sHU~>U%`9UA6ak>d~6H_@2m|0_mfFt0aVL-bzIH&k$5a~h+
zt;F@~LO@@EJ_Yibc(ZfRi<<H}GRMPRx(Co#p-&OHJKii8T4x|9;6(t_H_uARpU?-K
zBfM2WN+#0h@S#Rhe|>q;+1{5nZ@J(6lSIjSo7wsARprpw$8!_(e~Tu$-)s%(YCfeN
z1-JX!OHnzMEW#D6wdXK2pbiCHCDNU<eM-IMi^(ElL6<!zR0F!9z}cQdOp_e&8M!Td
z!IK*6(eXa)P4ZJzXt)nMs6hO{F_Hb&a{mQ~|Dmded_UQTzn6qMCVrSHHwB`vyhYK@
z`FLzEfuqBdER-%GL+|n=dFY3uco7NvO5m9DB+k-<WM~-Q!AYtH>fazEUfK5mYNRg5
zfrv;<QxBSeL@eez5J~mws1aFi2_m**nR?LMxQMM-0N^~ww_fi!Oy)VvkXnQK$7rq<
z^gXVA7cN3ahhxlh(3eJm`gSze8oEoZ{vo;%$TLWa)2?3)K)nyFH1HAG|8+Ix<z!CJ
z(~7i;iTQ8mH!$ins`ajaQI%iTKU{y{d_s?M{#z5x2z){8m8{11Z7#a?D|~uUxvF&z
zdMQ9&Z_61tF6HXhukz{jmeVyOa-sF><wVT^P%!IC)-Q3+EDO%jwB0<ZwqgC8bZD+L
zXsx`2QjllCIhVHkh&0Hs-ZmXtAzfftujX^dV@|R^FU*3InYNn`Th{5&Txr}|c`c=&
z--45uw)?0w&ai$#I<!J+W>}B++3zuD`l;7`RIWoFKnj-Hb5?3V9SZK1NF!$Z?Dv*C
zkO$NX?%8uTYCty>9J1$7(moyZ@x3kl%$IuV)suX_Z<1f3Lc@K&2NnFgEbY@#X|i5D
z#pip7ypam6@}X>!BkG<LX&EujUZ8+vr2uK>H>7x5XkD85B_B$%x+kIFxRpXT&HR>h
zxh*s_-TbC>u5QwM^7)<}DFmOhe)1XWo?8o62166cp04TUq~Ckx3#XPSF8(r2(n{6w
z9QHbH-lob&`OD8%sp>754NyGBcg`Ls1J60INaJ7e`>&~{=q4noo=IEaX^oWvg@AvB
z0qxdMoZ??Wq|Ow--<?y=AZZ2q0?3W=p68%KP5E82LiJ4U1xc&W7l?cb-ZK|^*Fdg@
zZvdE)dDgFnpGH7&gtr+;HHk@c_)sHhfWAB`0m}u79NuP}G=P|7%ZJ)Y?TATgXtf8{
z*VkSR<OWCs4%?`uVBnw*SnoXP*c-GOk-H!bM66d!5sHIuz}&PHMBeKID7Qv92&A)c
z@YQOj{4@a?j>ZRJcOLLx<D_A@BuzBlSYAbdR-vC~%FRH-SDr%q015r94vTHrem&@3
zq`{5<nnX&Xpr6TdPtd@|zUx8n;F2RT3Q#=2#}sx<A-rX}@I9>=ooxkugHuN1lC^Xc
zGkDANq$`2)89Lh<8m*>$jOGLRIa2q^yr23Y*%Dg~6es!1{Grd)6fX%%)o-aYNS=qi
z016?0Spf7UQ81aR>!+=WIc{U|h|`1472Zfui&d5h6^%K?>%KuQI!4Gc5#yt#TY++s
z?#C*^Wc=eWa!g?3d5ri(wK(;f!F)8VTKL^RkG0sxTW{BX;4=rMrP(ZAmA8bTo^DZ~
zYe7Ad?&Al2XsxKRRn$-ls=ej0dP<YD#vKLK#nN62Ma_Dem1a7jAnS^h5I3A<LCs0?
zIl}Za)UZv5<}zt(Y3rn!mz6euTb8!G_g$r(k$KsqP?fHZi7|fR@4GLKTN+*B`{0?;
zl;~rwd!vCy5L$rH7UR<|KyPc(PLZke+?g|h#&UEEplRXLv!SO9X!iJYHSC7D)HH7R
z2B2QxJ;X6L5jE`iP$Q<hJ}o=}O90d}yoU(Wov2~MhuSd@5H%?1TThF)o$f9){zHA{
z0if{$eQOQ<jLV3``Ks$s5uT+klK?WB(HU0INVSY-=nRB*m2{htx5N_oT45&uHJfkA
zfc~jQeNM=rn$q-uuO;ROs3-ZB{?O+dR3YCI&)iOlE_B_y9b^Qe*$8bB-uD9ZmL@HO
zOnvgSt&TRa$U&pwR3^^x-PH+I`6VixdcfG|iE@#{d`(}qf@@c@YL!<_1U_s0Y4g>6
zqYADCL%C#M=k%*;Ug=jK*iuigDu_<d@O`(IcFE(vMn{r{FB_8s>HxkT>o7IrUDaoD
zK!ybU(;E5-m$3!+L^Ug(w^f&^1u`C>3$37A)H0r<3lUlgiQ}8MWFB~8g<S;HbNsCg
zXqOtbjgVnrN;3pcEU`_1n#tel4{g(+=JB`UnY$?R>#loufs7#ZCPH(?Ke+&{)uf#v
zQ*GRtrXXWEx(Cp7@K3U#XAEc#_$O*uow;;w+;APB=JNi=F~f-&c6_K2(?g%OIRQHW
zsAqY9BTNrsh7BKT$2?5TprHSFVm5v4{~)ww$P*IwLyOA7K^-u{Jm!%%C>hWY#2R1(
zEdh#yZotyC1iC!EB(yK?d^bj5_@QKkHV1DlfEH-dvdIFPJJS*{{y<Lx+6=sP4m8_<
zwh(Vk#2)_!>FO07muK?y^qE@$qa8hI4gH8?Y{glVbp!-njxJLVFdm}*R?w|#j8@bi
zp_P$}2D*K;8CVfPK;`8uVg{3;^}HM*`uqsq8jo!!2()-P3z>_^&=7u(Gcyq|J|Vun
zJ67qS&&jkUz?zM{*Msgyik<ku1QG*5ZPjUNpg0nv>OpVdinn6|An3$rlyzLz;|1$6
z8G!K|wY7$h;22T3VhtUE1}}I9b3R}^LCdV5QEH41v<#uukf<y3mbif8d000PT;c}@
zK>O4LEd++XDNP#`&%qW0!7+ZPAGAe7aDm^6V}?>_1+IHT0V4q2iO?3{i_b%=G-)ET
zz`>nK2aJ{I2%wqai_bwt1~gB6F$q(cGcDtW6+m!>*NJB)5gCqrs1cK>Pg|aVX#oMB
zw+Jwa#8wMF)Q-7=*s6{itDfDFAl0+GNRPP!v_3<Pt)X&U>vmj}YB(})(G2E1(E1n^
zT0ys~wYH-|geE2_s$BQ(0Ih+ra>hqp_^+!;%One|-I<1<)dvj$G);U|HZ;?KW`~bb
z!z#_QYC)-q01YA2>_Ai$R;dT&B2mu#TWX|MBKlIDHVZ^;!*=OG#keRo_7MmM@Jj!@
zB}+k+4Xi}`TLJ%d)dY_Stust%Brs%wnF7I4exe`rk%r(LKM}`VMY(p%b?++B>W?l#
zXg2sE0kl+;mP;1cxicL=t1o&N(2VdyInZ1Knj3zIh`lmry2K5?0)jkVBA&UM*t&oZ
zHDa3U(^e;79zbxM_XRM`iLG<_DzBvSFI7yd8_A^w5n`p;(kaKzJ2Cx_Tz45pzpUvu
zIwe^XdS}Emy0?D!yE9d@IMK2aZrAVWM&EO;W_{gp-NkYD(3uy9mbwI7B*ul-#L0qB
zbIwdRo#X7P(m8faa@U8e^Y7sApKa?7;#ntCCyUv0zD~6MoBycI<Kh?MRf6SC@|WO|
z`%JoHuEZ|jLwe`I-wU)?c6=XR^R;15_xs_7pPR>n7~@+SOB;Tge;YpZI`8w)>%){o
zUmGSLOW1b#tK(v|;&Kk(uKF1n_Vu6I;dA|$D77y66^B#Ahf}5l{<wQ9>chbE*(a1k
z<wXO1EbW$@Ljo^d*2gu!(5-!iQ~Y(q=0lVs164EY&)_CrRSL4+tI*XSDQAIEqc=*m
z?bA4B6R#r0Tb$zEkRpjs{O1#Os`S@Jx0>Vg{U$YirjLX-VU;Z1QKQ>3$L$p?zn<RR
zn%7ofDRZu|PK+7lOlo>h`&?J1cPP_OD-YUFY95+=5ldNran$ITGW~AKmXIc=ZpU3!
ztj8OgPL$^_&nr^zal}n#CQMu2N||wu^>}^LwUDN3DIG7SwLb@~sd4KITHmeyF=)+S
zc~|ed`3}9NrZ?EeGz=Sw&pVdXy5ze0FYJ?Ty;1e#Kv?GUxCO-i(DwC>bs>#)dtQC`
zbzy&L-Tqhk-R9-)X5XK@t#gz-P2O|xmC^BcjdhcCj$0~NK0UpIp?2Pr0qC?|cvD&>
z3pbjZ(BrsMriweJKdc*+Hn)$@_n!>#na&AsDyn4ZjpnN6j;dfWdVa6UE28!|s!ay$
znGU{{Vtb9%y1walNYm|qig)(kWc5{4H|=u>nhaPz-5K6=yOL!xnp-P#+*ZL_p*kql
zZuw*zI=v{o=~N|)IGVes$1zssIQIDxYeV?gw$9fA)tGIE)^7L|6!KTzEm>^JlCYnN
zF=1b0&j||S7LfWw&)liG{7RO1qiQI8DAlR$cckg}yY^3~DX;hZuKC9FlJ5D9H~sE4
zvFG<uk58$*cfUwudwv&I{W@FTxNmH=3vMzsP3e_5Jv(Z8cEPW+*Ogwv$<#0VU;VZ^
z^KX81e9DoApC`W$+uU{YdhmK`yXU92{?^=${pABr!Ka&RFC33s@S;C-^X}M#f62aF
z|6<Vo#bD}uwMFYjtf34XTFd`la^zK>#tk=v$|1YH){X1>L&NimEaPH*|B_|guQC{_
z-H;YnC7;iFZqIsN_xJWY_r*+GU6%y^LzfwxyJdvjJjUU>Wmb-E=iel*eV%l;Y*zp)
zq}Z__C|KCJ@tETLlH@31<D#PKj||q6Kvm?Q-d~!*NL_R2@_a#~Mp5;{k&0)E^%ltn
zvC8sV#rpNioIb1dw#n=LSm(Poo*$|3QI=m<^t8hWIk>;POrbnmQocqRlhtTaT0O68
z<55LV<w!+;=f;gA0XxsFD^>K&N#?F%MU+(Qj8xp~>~-qub?Rh`?>{ap=p6ez)Qu@z
zERwZXv6h!qBO|e!x_WOHSC@6>%I1~%kHq>YFI{dd31sPa_Hv4=qe@h9$D>0QJn~}a
z*|nLSy+;%^?#T;;jfO?lQ9-Q!3yrmm-$z~j;~1=2oxQ_~nkZ#oR%5MQvYB(TS*l~g
z=m{ftZgl);^Xu-n4P|q`m*{*9G8@ypTwnWz+fzHL-&-74rP&{vd#C35D_Q-GDsIHk
zm~d!pgp};sztU#1+k0@sq031eY46dajpnlzlkdG*6dh%f?C7${fZ5EEn*Mv`GyG=r
z6v(RCStIzYWp5a)!9Z2SALOrP75DD`qjZHua<U&QzpFQQWNf)oDN|_g8ku!X(RVtm
zN4+Q>jLb?<5*H=o{RW%QHx>w0@%js{w16=fdg$^oLF1gF_-7-tS{2%Jl9$ISSJWy_
zuT#?dtWMLC=lTtv=yJ;$ndPlqab0n`Lvi}FB4mMMf=Pv<>h{x}fg`h)D_br%-V7X^
z+38kW62CQI@Q>o^(xA??PB*?H$URwK*hnsl|C=$`9jJ=<gO}pUJMVOxm)aJ`YmDS2
zDoYk6uk{=3zSJmOknDWEvCP%qx!&2&xlWahsyxWf+L55j->;1coo;Sjs`&7BVCVJD
zvAnL!oo>e!9ZQn;3LBRc#qSOpe0ZTTol*VUq*kps9vKNsP#P{u*7O^Ec)qb%*jW6t
z<mOQ5U~qA2spqNy#-Lv3o%f0bQOXNhjm0j>c45j5^QYNyIU59x21W5tM#7#esw|T2
zHY#O1l(Ju&Wp@l6$HKaX#4h2>!oCiPYwjPeJ=VsK9cxp%)_#e@t?5o}R5J2PwV%Y}
z|LISda$S@%>%?G-K~t4+Q`HMfKwsx^>$nkVyyo$guw{z=*5yqLOqFp}$A7(W<>h<w
zq<tP<`pqxEgfo819!Vkc@*}`_AaCC?q;Ceg6c<eb<1;Z40a^*h<G{ElZ=%m*oQ!#b
z+ic!9J?MUf<Al(EOkKQ>PY!&|2Xugvh;j=AYKN|zg|4Kazm1bu;^gYU%or;qKqG)C
zkhf|XLZ5-!;N%1#nu(nwKr4YL4v0K?(S05wGUg08J9rX3=stwA5UKw`ko$lLbxad*
zw(uPEpf_=x8iX?mw#IzrSo5v}>3O7{0qs$fb`a#l`q(UlGncm;NKYg6{?HB$=>SnW
zfPaQ{bcsMc9^FrrJ0MUal%kIv*U6e2tMj_h+#EF=FG$iwDM0=Jcv?ZXsQq|CoX8|$
zsa`*ga6i;Q$`&5Ws@V}tWNKoiWNDWTx*8|<2c8IKgI5Tkr3P;{&T6hU=hfQZH6id=
z$eWGCAM0^b8lb5jBnd%7AZQDtG<bmNfZhgm%m^s9@;2*1Z{ZZRh~gVi+&!d^#shf=
zXt0Kk<K)|LiiIFC^!10&?-03H%*W**8DJE=A{%<v0ISx<s#PZ`?aT#A9Lgff?GUID
z>ZOn6lOung{KJca)qi77t7Ef)VjC|-4=Tnf?jVZqKyfxqsgI@t`3o>@4gHLp8Hv+!
zLhR!S+7lpVC&h&ah@cq|XIdaoyXJUT-k=AFGxKm!2Te$Gyw*e>;fFRz*^6i`Mu;Y$
z_B%>S0?Ma;cygo#(Av)9>p^ehv~D3<U%+kdr*4b?@4r$9-h+9~k@>mU0}k0F5FAA!
zo$y*0pf?O6PiRM;AYoMxi-}02I?&p}o1+KagJ`)R$CQWclCB-FOQJOxcv4?yn779J
zQqHR~{m#|np@SLbJ2Ji6Gpnn07N7c?a`eX|_g_xNsWTtX9?tN3b;|1%YwE4#uY?RQ
z)4wSnemshrdaIjS=kiNEY-+~l!^uPWGpMPA$Fm>&v+~)GxfZ|FH%?{mn96QhU9)Sj
z&}<|kX-5pjCC9;Y?%Pi197oT&L&a>X@T3)?j-G|PK%oanj>=y{aMA!P7B<t!(7Rwo
z9w<!4o%#lbRl9l#tiU%%6K5_!pmxolRlDj5l83GglHcqHKSW4ME@;9xe|F$`1@gQO
zr|5nqC94vdLO`lh^K8906!7Db#zd+1o7EJQCH$}&_d_52+RpQ`Zq5f2rJ9ka$WARE
z?qS>H5z>VOCn9KZYMx1kZbE+DLZ*fg`B?pwFGxk2Sy~ghgddvVS0ZxC1!+-w;9EM4
zoi2bDT=V|{00960Y?*mj6Ib`g!zNNhKv@h@Bd8@pAPNF*I4mkvP*7wu=(qq@(IQf%
z)|de|B3o1lxU@#F77-x`1+>}>Y7#Vo=CxF?Y8#z6qNO&@Aa#abC%@rc{`>uL^SyKO
z+~?+;&$;)^d6G76N`RHtx+^W9%NSOOMsPm(jYlST898smZ9t$EGp-Qbz%j)a<}HCO
zvWo*2)A&u^oU*Njd6UMp&AP19s_Z@I-QINV<gPC{Qw$u_tT8oPpWb90|JGqn5$6+^
zE?ds&F3#kcW4g)i^k+7wUs=5xYL1^-c$_omq}3-Y$Mk{Socp$?GjDw~+E03@XF5MS
z|94{L_)U{I@mmU4Od8Wx>-Y|<_`liBl0TW;mB~5X!>OD#rhi(W-eMh36dbrR8~b}*
z(kofZ?6<Lx+?W|VOTdhs9|6}e&1meSbt2HPQT!oJnlzhPCxzsu1UXS34H}xMz8<O%
ze6Rq0K!U$pyb9PYF2@oMQ+@N9d0fOxt;jBie)B*^A)*`)`z{H*c0m?)D}qc3#Z=!0
zV%uqA+mudw{pUCSHoX1Z`8yPR9aVFlyZiN-+pLg3hu8!~gj}sTe<rN(%(Ox#;=&o*
zIg>fr!CmnVWBLOp`wXWoo}<?r(%G*yXVY!xIC8S*b_pEDG~Fuu2`BpiXLJv@&0$j*
zrzgAc*GXf#&#Gsx)l16ubPOkd{HBSVp3Q{|CXMMe>z;P2o)OMFvsLe`!W*19HC8WI
zj_H8i9E0uY!Qn~sWI<8G<2Oy?^lUBMKWR+ctb01GdRTyX(96kPV$Nv;XL#0_nyu3|
zSqtWH_6)v=SpUrG#V^x#SXl`;g?1BKBCW?XrSNE2;n8V@s;@QC)@kE8j@(VPwqv@1
zQyO2mY>AbJYnQKenk}bv%BGXHV|tZSx{Fg9!8v%NL}S}Bh2s&@wZ&mfZ*r<nbK=C-
z0-wTJwk@`t>N#DL9L6-ws`@df`YX<8#BlYbuC<&r9Vc$qnEqj%mTfHvu@b=Q^)Ibn
zJeanFYbCHL%$m>=Z#||dg?LyY&i=Tk>OIzJ6FGYBrW>|nx`7iAU+B&-<3&E~h(eAu
z6+(AX-tsmFykN&OS&Mr=`}`PFzQcwJdPOUU)Mz00MlO}1lQ88M8aPV}<3h&Y6>-<V
zc0_6(NDgNFrKrveX%A#}2vw?h^^OwM3sb(N8neJd7o<Ia@d{zQOg|4d;rO7J`RAlH
z2QG(x@jBh6=6tC5b@~ipM9#CH+q7T3PS3GP8?t(3Je?88$+6lLXmeFQrcI8UzHw;z
zX)vO7-~l^ayB2cNx;aBL$8?)rTCPo++3J;k@m0UV5l+i_tNyq#{oStRw(X;5!!zzV
zy>opr&iWCDGj+<Q!?t6}*j+gKahM(a$meWFPxNmoMM2lE-_1r#7d;biDJl*uQoe;H
z4jFeAS9Ls^cqy=Giq_XzWSy5e68ML2Zi;czrz;<JUOue7tXj6=MeiRX>oae<AEXS=
zf4t*X>E{b%omc9wxjnwS^HTk_rnmDt<O*$v?myFqqw_j?QzYm7c`@fQr^=1v@XkDX
zS1SnPqrJ(Jo9U99DEVX={brqHQI+v0yi-p;sRjFT=#M+dMeFt-EGqtZoy5M%cpERc
zM=rVmCZ^KgWYga;I<p&Iu$KNNQQ}u)oUJz>As02_1;6UdYw@-nm4DWeH!pyoAT+Mp
zXonZv(3!*Z<}lBKmc==5{yyIxl;hlf?tJ^cyKViSOZp!ND*iJa(jSZH7(KA=;D`F0
z1DBa;m(k)O^U0C-ksl(OM-TLl9{BL_`vaOhw5H;pA9p`B<0gr6@n7%n<e>v!JvFz<
zjrF?0e|_?6EdD-<KA0g<2vBF8IbUwftu~sKK(a;x$&JqV`+WLCE0FL}<9epB30Ng>
zgi}l$ImE%8chfelz>1G_B{LV&nF}aszl=V-j+tHs-NT)Aq<t-j%AsRA$l`VTKfJje
zvyO48g4DS4eX{rh@JXfbX47{W9nS-IPNMH7GIMGmfu47aEN;SOk952>_y|6)B9Wev
z$c(RneD%B{GByL3oyBFN0m!;4XeBO-rY~kNmj#HMj@ModWd|Vf@&TjU;^nw3ir$*R
zoE9Jxbi8~y^m#S(mlEWyVdl%BiMTAEHnoC0KJs)ubEFA4unw&>*~%d+JYhFIxfM9@
zkvqxEx9QBcDCxJ1u3X2=tb*?22|CiR7OcpjlRC(H7Bsg!X&vKM1!?ev`(*tEFgum*
z%clDnox%f8NTT}^nRzu(pk8r|tZ%{%k8}#wp{#j7CDI{@%!C?fhF(!bZp*+8XK@4T
zP)ZdPhZ~~lwhZQ~0P)Z%SckR+AgkpAH4o;;;)W<XKZE&NfK1dWSch_}A(qhoHOyi;
z<cu5g>ETwepO5^$o;lP6?2=VS!tUGoBUU>28R?lxJ0>!R8o{zQunfV4C8TEqSjI<A
z>ftI}7)_V<lQlbWVFNkp>s50Z%;F=*_3$ZN7)8f5lQq3$%?CLu(81r4HMJls2uZI-
zC*VSn9=;|=>vTgopJmjNsTY8I5VEWqwZ@g#b#SO29!X`c@DaHVK1!zE0Lkf$e-*kT
z5a~@}&iX5bwRz<__%Jze9fYPcURCHzf8;j-@*7MK)q%bK$j3T(kQ~UOhZ30|+JTdZ
zo_gh$>X6pSAF<IHpON92^wdP=SR+`~238?>ZV4IQ09NslO1-fP&yA+f^^=`D@m$s+
zb?0Re$VW=`##4B16fJ5dJA27a)}KI~@jJ4!7VHW_MAfJho-5KDS${6-hTiY}AqF=`
z(u*>f3ISrTGv>+BoN9DP2{x=@g5;<pZr(%RYy}(m$iRB$d=rRB-iX%rMffAmI-`kv
zpGhA`WX?B&gKgj-f}2ap_YL46A5rLyHMlv3{->XG-ih-rlcNV^(-LX>M8>KHnXZQl
zN#_ilcNXW323QiSkWX=5G+ms*)Cw#vI_UdqBs0MBseB;S@a0mR7e&WrFee3;@j7Ua
z9NAfo{HX+6*D!PC$ON31Pj|P1t$fR)^~~`mFquv5#irwr1=pGqtdFZZmN?A3xa;7g
zPjfyWs*D^rW=#JRSDeKa?6&Kwkd?S1ny$}a8Uz+M9n@ZpWCvK-6NPk)mg%6wq~SUU
zNoTlK$V-3AQ-S3vOb^z9e1D6#4jLp4S@d8cbE6$NifB)k*B4qxe~YyaeMSm1Y0pIF
zXd{Sg191ormyp5+5XZNi(xX*498K5slggbqY`5hX&$w;3>L}%OCZNKyQj6FT@C^(N
zGogQbTH2+Svlx1eQZ8U}xRy{gva8&p^{|wC!f=?$NrTuB#@!%1n3*cIXx%MMTuT#5
z<t_uAZk9kbq9=?xD%Xb*<$!_?%6y9&J;gQinMG1dg$b=Bj8UMVnKJiM<_{V~h@thA
z*@rn$VcDofoC%}IgtTZZ&ol$bCzc`%DWrJw8GEk9Ms0akVtG(zc>n{MFB4m0amA1q
z6fX<NTr3wu89xz7U|-_waRs08lUk0OkW&N{1rnMmMK7iJps@%r<U2~?!)&Xtq-!k`
z2<Qp6?H^v8cmx8Ip_i5jnO7C@@PbsS<*U5HOpQLSaQUyMZU5+`maMK=@ra>}+Obrd
zde~Rxb&=Zfs7!fmsW>#dl!rk?%)W^a{r^=P)n}Q|?IPmcF@0L!>mB`}VQSsy%eD%N
zo;JArk+31ZKH7He&#R9nPSdg<$RB4Hx%-~@ZS}kM74O>fY?{0+&8D|TE;@0k`=a4c
z;Pt6f32f6acQo{bR~X{-?J>2o=$Eu{rHP+DdF}f1@VyJYlTWRdo!I@=kr#b4zFiy<
zeTOyg{pv{YlVY;qt0R-@WBCgsqHn);ElH3ilJCabv4)}7u8%#S?>*svJg$2kp=y03
zpH=YIYn`2ln44JfTvIXO36)8C$FSleYV&-_6fQJD?Yy;|*Y5#c^@K&YmO4d)78gj+
z?Hph#K1yxgK-@h;+@(u-tJTi2#N8;c+Z+12j5iT0Zqqs&5+*!<e%$9)_nMS*3l=Y)
zd!*j)*xR>im-C7#cl7_6{yw61xjnOF)8e_}%H$<;mlpaR8~;x2Vs(Cs@7u{Sw)B6d
zX^JVnk5|j2=ZlvVEL|Ak%Q|{8K_(^NNypd6E**I7dVeSHzVWr|im#`geDzLhTOT`f
zNrdnHz8RBP!`1rOOcA)ZQT)af8#<nt5d-ddL#<^zE*85_Bio{tVM2+UEA){@W=&k&
z4fw$lHz`l!1zic0tP`sKcKDW!(;6Six(Z&hR`wBb@dqq6#1uR137wVl%CXqP)Pwnw
zd0fa#Ez2(F{pJDvz{Y9yayCw{T%d*BvLI7zG4)^rvGp{ul`7@MsAW;a)<`hL8#-3T
zv%$Jsw6g7`yuMOp;H-<|d?fKwUZttKir5+rPB&B6dZ=qaBb$YF*HPD|O9U0XIIYZ%
z*qUzYep$2h+Vfd!cFJOmg^%8z;)ne>v&2bwe9LfL-6N8<f4Rc#$;c^w#R|9XZlf;m
z*{n6*U#)Pn-#AJ0yk=?Mi@3V^?4pX1S!*&pN*tr}B5K1P_vA(KgB&z=wbuo1sUMAL
zQ0<rBB`%J6g?7#uHJ1^Q{Amsvo7yi0ZV4ZaX-X~C;g}{i#E42(INh-mEXnA?hV2BZ
zTZNip);?e-DEf6t5$c#`oo5vn>Dgkt+bXV$71Fwz6ST?Us%OiQ4$9$2>haq69WI#P
z5z1kKB$^BPs1sh5DDIUh?!jQGuf(@RF&^{7sN<PnsS9*6RI)_`)EmXSW`DxsoE!tx
z-q5u&#T3kMpC)08Hi5-C$rW<YBv=!byTQz0$t0;l?FBUiO4bTh9TO^9oGW}JYbzA%
zv<V*(l|Nv9AtpZ-=NYM@4D&lo-JdTB=0aR`LUy_0sRwj}#d&B2i}QsGw4gg7$mCZ{
z-QPeYohFi~Qbn{nA&N+f1a98Y(K3ZKR^Osc*j}pmnZ=2I%i>%qRh%-_R}o3kpsJZ_
z=%E^bCSev<Uq>}em-tsGR%#RMh@^B=eTOFDjb@;F<J!Y6P^dbgmq^l64L*_`sbF3<
zn8#rCu0&rVnCAjHbtlX))fZ9QuM&NavHB4#M<3J>B~^G}^*FUX3w-YaH3di(hDa77
zMBj1hHD9t&s;Ds4R}y_u;ER6h^)90C0MS0H=9lT}1ZSczAG`~ed?i)<?hYO1LWfa`
zyA(`tgKX4>E+XU}#hor0mjlW=C@za>PaKPB+YySpK(d?*%}^UyO!vza_hAt4EBT~E
z;ec(!s56-$-UX@*m1K)R4~wZ`7K<q)2K0DCZDk5Bwr!urutjTNF?qN`jv9kC(Y6~1
zf+ZeO1$*im10^X!X7aA{SKXihwLwR;>8NxcNlGf%nGJTnjNU4)-#%hyZfyHK<V|hs
z?TF!DE?nPs-s|FlmkpbT&+p&y>C=#e^7OyX)CAsints#%!iUcyovb7Gaqj)Z`E}Nq
z{$+h{v-OL&1@8u3Vv&gpNAtTLC=SaQZ}OGFiZu*9Q1p2~gAg&&-poeG;6UW>0bd78
zR!bFq?obUEszIq6OF@Pk<f%4ji2VE1jp>r09PqS*y1_=s^UH_qA}1n0A3P0~d@fZy
zaff7FNQP4Tmx9G^kh9uwml(cB?Vm20mIHEk5-5S?<Yce_Elz67F%vSw#FkYwPh;sX
z8!M;A63Vz1uw}H<+alsxL{dvrD8trM<9=d9_*N22pob}A9x!JD^K^zSsQY`V{U0=j
z0BrCQwckgwu|komH8>K(>rF^*spUsDm!GU;bD6ER@4YPtxRwJ_%Z~w)B_Wa}2r+z|
zqWO{~QiaSkSV;^=0dYS??;?iTY}wm177J%$I3IvuiA1U}x}$|$v=F82mI7-xl%p1Q
z5svpLyXg|E9B`<EvSVX$HigX=&m)xG0!b7Xovs$XDuM5n!R(=q_LcaQz~eDbj5?YL
zqFvAvp_0uaaEHC4kF}32Iz}B`Alb}C=ct8$mcZ&VSPcVTUx{l8Y>Rn5r<P>`Ul&vw
zDp?}}b!>_S2Cyks8V%~a(aUA98|JxJBh1zcUkW92UC}8T;W(l+4{QmR%$34DUg-5e
zNuE%(@5%bHMKJ*LMz5E_-k4{BMz~okd@htYxT3Zip%oFg8%zq8I7s0;Ug)=hk`?Ur
zQ7vb$k6AvF6&3JWt<Zsp`vI#7Hr0@xXq6N$!D<dsm*z`mb5S?7FsmGX?18eSR@6Nf
z@}FJMdELT5Q_V5z(gs3*n$T0F@N%^<hR{cXU~jan3?7HoT+<43O5y%eWz*(M?Ddf@
zg{w_9azY;sTAL}nhr)qI=!ex@r10sI1r_jWt<av(f0)YaSL*)W`gWudD@p$LkB*#Q
zuB<9v{(V_;hXMp`#n1L<^!khFuGD7B-I^Cid$%^;dh^JiCshh}Tv|RUu7tdzT(M@!
ziDP`7eegLq+~!x?WprfFKSjy67q|FNvG-6;Xk^l>BKN%6?EkN#WUGl+KN4?BK4G6?
zH^0R{&G1J_2kD+nPkB7ky+OQ;51-VhR^b8BbV)NQ?;+(tuAHe$ts~_Z#Iu6n71c^x
zJRn`4+96k7)#a3~Z*b+qTwUr*Ql3TY5>>5@V)r(&JAyY#$>hsocRqYnpL!B+jHLbh
z$>d#l;}vq$c}L?~`bwh8zeee=Pd!Q|Z@?SR;Ei+uysApM9B+)GcVwu}3ScK)YFoAP
z^8k2*+)%q}?KisAV)Ee)@!oXR!Ybuo{_tG^d>5v@>cmd|u#Ilu85x>MdnKxlwToAY
z=(AUDbzD8=RYZo?idO}}N!3aRJm&}9K(Ky*OjT9$;ZoheA+r6tI51u1QKifZgrB6S
zI{cMrT=F^Hz%jD@hIm)HDy&NR#vkq$z}+ytuulB3KWwiXcuwxkq!%WtD%!;xMD!2;
z+h}jCcta4JTCH@%huDom^aI1Gs`GqUrW-g+j$9W<q^qV?DYpgkTI9}bFY`~5l|QeL
zv<l*#z-<zjJoAT*0@w)Cqjlng{xDBBFi4JM(W8kfRlC?mM34L5Hcl7BHbKV7>Rb*!
z^|~&6o<96ts;ZW6JfRCeLOR_L$E2%#s&YRIG~P>5o%B}*Hh#POf_MhsDAk9b!ly>j
z%bUsaUb6gyJXfF#|BfuL6>kkPrd8)oz^97z;n(E3b-EnAKa169s|$ZluF9l8NmLzg
z6eqQblMwt|3Aw64oWwU)>BHstxoG;kezJEbey)Lh+`4iHyW%j}dtDrouHshZzVtUf
z6&Tr$=VhHZ-{0u13m+tVv*?$JsvGTMw&U@*B6iqy%440%t}6F7F1kksUJyH`($(2?
zHKXfv!$oW9>O|G7n%vp?&Ld=C6E6By*SQvN&yxQ#zAD!a7v<3@t>OT_QJ1W0Pgk|0
zWYaRbf1N6{Dz_IG>B**AaZU~$)<N!Cw|`gqtWazGNhBSXp(+;`$LTur<heQ3xkE~^
zXpJgRp6iG|*+X}<ibZ^5|9WPdh*l*3cM)=ogz{-c7OkiShGz0j5BUbjbNzIk7s)pl
z#EXKAtE+SE@h9o}&Q5u*@_)gbrt2Ie-(=B$C#rsI6x+9n?Gb#Dl>GRz*q(1J(ifb-
z7e&$&`^k@Y;fvTaq5il*9LqPJ)E89Yi=yd@X7ZaJ@*5yG&(syvk>6Yp`vn<SRGV$_
zMd|v24!QX%+jWNy#p8=&=$|rFZ2}`#SFlfR-coJGlw!{{Do4558o#-l4r&#9@{OAH
zs>UX9D%*88q^J5D-E{>xxgm>gPE<8Eio@H);Rt^7IQiRUaX8;tt}m#>Z${Cd_mjWv
z!f!VI7i>W>`P&U~LAq*DmH97!<6VJ~J$uvY#LoUk8{PY7WJD%CEm2k64ul;fdilSL
zENt|iljuDXjiliW{J>fKz-WLmsmi<pKM+ly&rsD1jFWZmzpu7DOkvocCrVjSKJ(<0
z(VXd*9`(aE+qa7lr_8yXBLk89t~H_K_B_$Q57xhD&u<OiSgLz}i2U)oSeUNztTJZ>
z8rk#P>94dzw}#8jPWXX*`uA3GF5mbhStUzX$x!m(QhLccm2;K(F8<Fw^56wAFNaoj
zkO%+A`JZT7m7!7!jGnspd*$YB)#gE^7+Ry^$<6loKY6sIRSfZshV?46No<J(qc2$(
zU9k7X)Q1HUgo{FIv$+K7DucRUVCBnjN+1sA{EV{61XeCcVJMT^L81GJvE-euwm4xH
zErC=L$YBb-fjQ4JIluEnE=ZvhnDY_JW&sn)MW(BHpOr)RJdhJ?1xguvfsJxOT)KHP
zP0oj?!x@DAIl}&*QYcN$izn=3z-@1&r3{*aId^DzTS_5ysnX(qV7!KBO%(42KEaHO
z6jHk*m$}Ggl!{pfYTXdNnx`X*bySQGlb8cGcTjh4QIG%alk;Kf?tEqr7n!2wy)1#A
zmO)Qp@Z6W#T>^Py&V$t5Eb!a~xgN@l7XjCe;Pm6gGx*GSDRjsrJ3+)o0@r40MlUtv
zgN8R7lYL9g@L@i!fYxex4n*vFldM(4!!?Ery&)x->=1QvKEvlCZfYK00zEE+9>d^)
zFY{Rm<b}yzQWvwp0~h4`P{zy#?*K7ko?=-|AjK4#4~$vB=);(sDdaR^dFyF$cC|Q{
zSnSo7!zPQ5$znxVTC|ov4@-hjrTWaEaI+*xEq>jWB&}sKW_eu#Y0Drj4CeYWQ%az5
znCv;VH51HrLCQiIxPwC2x3e3TItqyb=zInaW?&bKFcn<O2G<x&=1z341=m~<K{qeJ
zBs)rNZ6Yik8q1SXCGrIsuCYwTEWL!Kny?(Bkeiq+#3UQ`M81|n6`1TWWtz{-=OW%}
z-nMe+cMs&2Cv16_xmd$<Cc5(h5zKrkg?@KO4snq~C^dO0aBxGc)ru~{?;bUII%Asy
zj(1R#f22lF&6zx#St^B2ni8rAzi4p0nX2reDuG5Z6HBP0DyK6uE1(rxg)QNiZc6CT
zDE`z8)EqezPx!@v``$=v8N|gB_GuJbv<ghfxVa)9X%yB({cbQjm~oRr8ZYEZAj7uL
zs;@QcN+5SE0jH9(K!Xc%C4iY1!puX6`r}j|pP46x%1sHCM12(4-cR-IBI;R8xZwZ&
zH;pQVV$_N#Vp}BOdLzfmARElkqE&1!h1l*{xNUAFW;jBHEMVff$R}zA%Sc}a>0yxW
z%Lqy!N6dgxZJ8k51*r~Yc8b8S8^s3~l>X|5gsBz1#5O(E=ELkv1q-sl0tPd<5`&3g
zfeSLRTQS3AD5CPO5`&L1!w5E{Pw%-z<@+!h6;P^H;YbYrfEhwe1{TqIDI~)ThpFND
z%wjGwO|4)N89fk{Ck+3zWr;@NObq4&I+zhlA)`A|#6^lw%5f>Mb3?4ua2Mfuk8+&O
zSm%JF9h4)BXpe{EY$jTYo-hfk2+wG6w3#aHp-O=Uo{0(TsM6_-Zw30P7Pcik(@nw-
z4LpXZEiIn#i~$;N<XRaz1rzSmz+1F1i)fN7;-G=8iJIMDRxmS3imJVkhCpWRzY(o1
zLESJRPQ_(`OD;%5023U-1S3SvaZ1l;f~9DgNmxnLM1ib+O23P!`8T5KB!Igh3%cPT
zldzc5Zy-`n6RA`w8m)$-h}1~n?u{HRL#;7oix%EqivB!?=-Mevd4vjBz^vpVv()hG
z5>!`)>R^!U%lMa|A7M(2YRm-5E{Hso*|E{^#op<vN23p?6|1^5e?)G%X8Y=o$UQfb
z8c_kZ{m)<ih#dF0;i2yCqlSk?8C&X8>{acPo8}(xKV7=<1uc7kY|F42I@4S`5<k%O
z)pt2xM)Za5VMojP*Iq;H^RD{t^@bQr*x>qw5&d^wU#m`#wUh7C99i?g>uW#lM1L~A
zzP9@7X+y8xrP<eaFI*DQf4^_*$E@LMefL))Fk(@M_uouQAO>Q<h&S?M89EJ97HEu{
zw8m#bW}GWxqcL)b@ZG>Em>DNUZ+jsZ1DWMQ71MjA+zpwbHr^w`b<|WJW_c=Dl?_%g
zSnebud<|ITf=uo<&NSs7qRw3<!k=Kde`7;K8+Lw2o%3O`E6{YUaRL#36U&`z$|XFJ
zQYm^A%Ppcr^BE5=;;1%mDMufAAdT#`ko_>F1a-%9aY~d0np}{^046Mi2}6j^<J1#A
z6DCE=O}UjsXB61gPd(X1bh21Sf;y7G8y93zw=u|+TTJ~Q00030|0LLbJX8Ju2k>*Y
z*_zu}3b`p^g;Z{9CMUXb6Ke?}<w|NSqHEjLy1`DmA>C=Iq^(n_Ye~AHq&q2;k}ZbP
zjioS?<X&Qa`+R?Yygm1MZ|8B&>zwnMozKUO{kzWf?;6Xl@U3cF(Z36surN<Qe6#}J
z-gmpEEg`$2G5gl7U3Y}-eFw%om#G=1>C~#W?jsd%j#j*hnb>Hpb~;j_)85xU_9$**
z<Mi~iZt5KyCO&W4m-;08^Ne(ls<yZNyWWgFnycQie!^?pgqOO#&#-@#IpH-u-QZ>0
zyl;Kz*xsW4(bo39;r5<gMxR#qkNQkJF;BmBv|?6!AFsNNRnykBNWI)J-Kx5c)IYj&
zBGp;FJhMV-mR_+?own%d(=XL&M=Gq^`?|*dY@L{#o?hXghF#QfdcQ&D7-_y5&P*44
zvpU&tfK1?<$4E*227CI4|Bx*U#z=G3D~_i#YrLoR8$4{ca{gvDFl*{$W_o73)&8-=
zOVx8tr>0kV#~n+5KXdB#teBX-_QloSy8Q;6i5Jf5&6(-%ji)kAr!p(X{8moPn=v)5
z%KLf$iC1HObJT|0C$8Kd^LsKjzGs%-0`=O=^wZz0a{EvCOk61*ds#R3a-!PXuHEX&
z*vmQUCCAf)YP^a4CnCRDl~sHHtZr#}w3N|*!gu1E`P74>>E`WLyQ;l6*LZ(jq$V3q
z5vsl6{xvBR6lXO#GyQq_m+I?^o{cM;oAcsN+=#v~^62%!3qeImJMDhuPOxGwuW~;j
zcDaA0D`-yPoy*mxdvt#5K0dhbP@B*4d78o}&%OA2bYa|5ZvFYg^^xCXwUv80;TE*o
z(!<MEYZ{vVz$H$&C5`n}wrsmsvh>62i|aZ#@xlvN2D-3`WlrggGv1^QY5D7m9&avs
zEYEtiB_RFFhO|FLBh0RZ-@SvkCq{N}O8fITI_(eLu_E=$!-)~C4U;;BPt}3FxTXqd
zcu~rv&Rw;ZB)u|h>T=}N<+a{_${u^pdNQta@9;za;YB`^+0j#%i_#5MF{RBFaW~Qf
znp*l+?8{Qc>>oe-Ky4d2WhAfoUYP!&C_VDlMX$3R?<<P_?Yc6u^z4Gkt^VnGjWK7s
z7x|9AX&zdi*nLZq)RgSA?_fg=I<$W2q;Z~FyP%>yFuf@#J*+~}RsUiyCv4-d?05rC
zuG851ulv(;7mcm&(3-N3{&g#A(OAovi)uS6iS21Rx3jToJG<wtlzU67{gv0lYxlo=
zy0RTDDD`WZap;a;i@Z61FL&X|4?j7dhst+cF#Djut9pLH!#vvi;un?wiVW`e4E+5_
zpY)N}Ly~(WQfu@MUTW*_B#Np$6gE#Qsr`DpjoJjlv6>3%k^>b9hbj{2^WxsTeZ*<p
zyXxF!FL`k5mHgX&9=lKMc<uF&yqDX!C-ULe8|iO8Mo*5;EsN(QS9X4BfBVGNV{~TX
z&xNy|B~cXj^-q4A{pM=-{W8B)&8ZFE%bh)<bnknYRPI-{`NWP5@Xz<qPk#Q5sa4<g
zlYUyf|K$0&eAoBRFX-DR-*6AM<371bp*L+gyPkNRFYuCYY`ya6w%@MZCw^)UKxZ$v
zMLR`GOp$8#|7P!KJf}~y|8H-fP(4O16MuTmdX`F2Je9gAmW$xggcCnsSbpyEdbns*
zx%|hwREKByw6ruxDm8d)A**N@MZ7Zdq-=xu-S0@ZA1m>jHVvWCn}%S=MdQ!zJy!Y(
zyDy#iPkH#)jLDPY%T~|V4f&=WNt=K1|6lg38=CiV!N99QS%vRNroO~41@UUft8(a=
zWhFfPig$$W{?WVnW7li;?lWmWdf$2WUb1Yo^g86Vr*7|1#LstI-d}myyzYCJo}$(}
zfBU|tLkHYP$%#KHUp`U);aq&yxqK%~cZ0=d(C)hfmR`dn{xNAi3wqzJdw=D>$9`)%
zEWHkT?O|*2Yg#0%lw*53dj;xEH7*ZUd0p8q2Yl18``8|$=I!F`a*nXOy!N#3rYqtX
zZmMM)|DTvE;y0SNG#{QCHT$b?T7|Cqc*@cAHc?mx&ntG{hOykXvV#j<j*K3PAw9i2
z@o~{X-*bMSwtrkOMVsz`UF^FRw(XsI_-u0c?A{pCsdax^Q0}%rEvlf!A1n0Z?pgUK
z*WtU5^<Q56U&qb!9$&O}JsDvpEBB@2yZ+2x-q!YNa8mC=Uvg2`pA8!(%g~4z_tBH?
z(hc{v#&X(-r!wEB&h}rC|0jHMI63j>N5t+<c{2XP52!CluxmN|#qgOYj!%O6OcWvl
zP_2bE{`URVxXkVXb7G0qucE6YDR8GxdI+_&!|I#qWbMB}soGWU^~yC|By~StMX_RD
z{0<M3^(AYH@v4&DNUFPm<i}&ri%;-u(FpTmw_seCBxfzhmcPNPT+EpllUUr5sY+Ig
zoB792=%Ov{=Ib;1-%`EY?D|HFiPe)|noK_TZPd#j-MikmJ*|&jmsT<QBgQl+hUj|j
z(|~F8<m`Uk;+pR+56osr73`zp%BI`Db&C&GX&M}Q25X8ow!kXbv*YQ$n!v8TBPY|O
zyDmuSA4(2~P(3H#EJ|8^?q$^c<;^}?v6)+fk9Av(7UsNvZZ{*^K#o1Ilq`8@DcL-@
z2Rl?Xj2!!Li}b-apA;4UZJy%Cz)~HHOzRO_*L{{4vAPRpA6;(1e9@_S;jih`I9?>h
z8N8rvM*NOVx{S9aybv%<8pwFs<_PLhIWU^GIaqYNlJ|T+Bcg$<L)#olEs_Io(!NGe
z&6Scn$f~5)6pV75`y6E~Z6;HBz_SegI_ka@(Jzc5=04A0@SDktc)%MBLUR^GV>_M<
z%Xh~qSI!Yl!zd`v+8<bXmGVxWWfD!bR<5)WWnz>Zo^>GbT_GilXN?{=(}^$33!4{0
zHR@i86ZscW0#raJ(W`5W?+RMZ3aWGWN}}jh5hYRu3>VEWqG)mD=hR^~Zq~fZCmAzj
zS<h)}3xMqnS!~rxy<&<n_wp%5s4VL>ZS7ScyD6)N_D*w3wEjtGT!k0K7f|%Lm+vrK
zuLH}um-A`wGI~~$M9Kn+1^03ZgL@sgffsw5p(|Uv1@3+6#9pbYnj<p7C>gw1f8dL&
zlty`$X*AVNS!E+Shf##Q*g#-oAtjp^`@d{`y*CW6Q?j|SD8sQi%a#W`%Sc>D{WnGQ
z9;4)QV>1|u%~=b1z#9zn<}5so9W-Th%`Atu)1RuZtlBJE8UozeUFF7WC$?ni&~^q;
zos?BuMGr!N_f%C|M11T@4es~7gl{N=-jGG2^+!;}a$q#AKUg$Y$!pJG>}$v}p!G*m
zpUQzZY2*khtduO7bSTwCvza3zU_t@U$RGIZs!%2m&|J2;N*f!|0Ze$3XA}sO6$&$X
zMw)1i6<cqtDqvVQ1Q2Lh5!4(xFq)PXEUK#H8D%hH8v=A`S&`H`a^Ou`Km?TxZmpe3
ztu~nO0QZ!DVbmO8%>$lggsh_`q=*VI;c4!v{fv<20DB(r2E(~IfT+2(m_GULrb?T6
zqBu-=ly@osSa((UNgiMsO<kt6p^Cm^!VA1ptAU>ih5LCS0?p|^Ex#5F(-!zswUh;a
zi)MrXQ@RUWc_GA>05WYs0M%Am5GOhv0xVS(#EL?}dAwShunuL|Hw0+Wu18RF<-lm#
z^<a^_k{6P}U^fKl(XK~Q@5zBTX$cWjJrFG+snrz|9^y6#7-r1@^LW6sjHq?gq!dvp
zCOpG!*w2V+4shTBZ!l=h0VHs(-HvOnb+<p&LRqjy#0>#*x(hsb4WyO;16p?g)k|5x
z5)Fj_%T#fHi*&&;j{9zfM7jk+nCpC-LA(xpz;!-PGtKCUBZ!U`2o1T;cNwd$1EYA(
zcNliyHcs+dq?t6%Ihs*z6)mp-_`RVvQ5C0OEHvdh3mMyFwRN<-tH8vj+UK-LFlkD)
zD&(2+S|81bs?!sf1I%7cy>VUW_J9#Cs|}<@uAn;f#N`5Sgi&Yr#NjR6W=gIE=j(Cr
z<}lo4wKcR41;EaR+8wGmgJPit_pXrfudKG7_TegUM^kMjZ5h~`Dxt9x5}6kW@!WrI
zGxV<mA8`LUPg|DJ^PM2NP#~mm|GCRxTn9$+{<*_&(qu!gwU(CSc2-$-Xxp6Jd)nb-
z=#RC<NMP%gXjHdT(~O%5nxBh>ALX?c(NquRcRSH1OqkF6XEpF+q3|$o0Ngb3-pwJJ
z?<0fm@34qoB=l1OokYn&qU8NO`|z~3ll30hpkB|udAz5vD7lE%cDKGvb4iA*9&6_M
z;KJ^GI{#~hbZwCRZoWDwx<0ruMbw9Mc{cpk=RVyc>MN+<g$;_rsEc~OYgxEmQx7(+
zZ>`%6&tC+0Xkm|aPp`)Tov^-OtS<wfYJjv+WTViK7d~|n`jmwA-9&zy%(sF%1_eIb
zUApktKEi1O!N3ycax$=7Fp!V@&cJt&unEFxE5U#ZGmQ+~fNC#h!jQcJKG?F&2|~1{
zNg&AhZwzMyOo5GEQEej0ej1`hmdt^S<FNfkz*3xXEan4+zQQ-mT*b^Vl1zt<ahQ*8
zs6P(qggv)oepMg`Vaa0Hn20^s4UND7!!c{!P=eqHA9+`rmkluuarQXmFB3^70T_+^
z6^vc3M33N@YjO74$X})s2?2N$sWy?AK*ocDShmY7JQhm`)fF6B!dyZImJ5#LBh?vr
zV-nU*2sIZRabfNx12>?7i<xA|{wsX7ahns2*iMrWpxnPPBO_o6oa>4PYQm8bTe8Fk
z%8kQL839Xixv^LX6#5$f8hab9EeJGZE`aQ-k*hYq4xD`wE>~Ya)JzaaVJ1NKZ;`9E
zz$7jE7sysfa+Fjs#V^o>a_3^sQ0O7_wLh>%E3}zlKigd52<6&hccIWT=<7gWvv%ll
z^fk;}W-$MeJ7*bW?}v0i5_5d65O_gHNunqZD-dr;W<VIiLzB-CZ-2}RQj#2GCv=DA
zL6b^2w`rT&P>^PWS;0y_;`mzJ<TS+lp&-o}P1DvNqCk@?5pP(wMt4X^7$*zT?&5M;
z*Z>sz1>azGlMdxl!9a|@Uj4tOR%j)maJsn!2ZhbSw4qQGwf6^BYKP{a_BiHW2L4lm
zN7hi74R!<qtw7*At<YLR;S6($5fo;P1wx@&sC@viRy#BgwZ}8JYBoFi$QcT=!(Kz6
zwHo+AE3}$WXk;$YhQj7z_E6|Sw9p?|tsR<+7UGy;29o>koG_>`5D9}N_V}<|V4;rW
zJUMjXQl=YJxC&{4Bxd+9A@IDhgoY0zVJb`J#-vUa6e<!F;+Z^Rp%V(6#nhunR;6HO
zP-upL4KekIg>zA$12dRdNJiYe=A`1;IA$;o3``~02*8cVy&x>A5@o~8g}6d3<erJ-
z3;|e#+%uK9Lro)s)_9i|BGyU>oh@LyFq6o@M*`J3gts5x1Y<NpC`q7N%(Nf_BT$ty
zb0bvP11FT3tk+B)C%8!qd#D?_9tU*7_Si9>D3D=DVhK0lu|2w>YjD7D48m(c^A(!S
z=4dvXk03ClnY{=OG;xK=xF!SrP%D9o!c2t<rO2=?Fj<TJ4AFxmD9P0~zZ{0#=3qof
zE<nxvfzPz$G6LJgTrwAOv%wBQ@{_1pAW)_)&qU2&<~)P=<L;b!5PKzZ43Ze)-A(~>
zbR>7k@}*0eTOf82atxL%!MmLS-Z7St@oq3?XDPEz>a>I82L$IKCWXkhMuD@K>nM_h
z6zm!#KP@<qW3D5z?NOiu(}l<;B5&zfSZm!|NMZ`R;jwMH@*o`03G1|D4l0nhuw)tR
zM#4IE<<U4`I5tyPjuS-jk^f5bHb6`r92-U!nn(^3fYHdpVC+mK8iix7#<9uBLQ~0A
z0`Mks(?ntn-5U@%#k-W@uyBH0TM)H`=|BdS3!?Ion;H0fM68)0Hxop;Ft?L|8_?Fp
z%-In88@%z|wjFpRX_`b2y0;l~Hv;a2@42C^L=syENg_)YLie^}_l<z}aFcb2H(n;S
zJbB;fq}gf2n<A4!LoWD9M>LIyUEGND24VkJqOCB~6UQbYy(SV70a%3eno7K&d!vF<
z9xBHO>@`R)Eb+qMI}3cGBgr7k=PqTEAQggGKoUHjcM_OkESZPr5wPQyGD=eCaY&vc
zpy8N)MAdv0IEzW8NY<rb3`m|OputQkQDuVy9hfYlN*57%&6#|;LIg`(U>*^x*Of=&
zfKHf`9rLUL*$7E=U>=M)>B|4Y0mHFkUAeK~p&CEKy2zcg9#RD&8)1n9o|g-}p(DvB
z%QaKg15&L*K0}h(c%BfLZ!Gb|^GMiF%aiJk-#;O_NbnHP+(lG5p}<*81B&KR8?%Ju
z8G=0!(}1X&ivk^Fi*$!{pviXlua<3UEkW8`ECy1}B98xso5Ud%4+MM8Yo7M;!vsuB
zkW&PEoSAFLz$i3rD;5JQ*K59r1}1JnLk{qyHd5g%yJe(Y4~;iz$=?uE#^#b)(6BYO
z36f`{djf!OwB`Be9y~MIV7_K1BtxoT<OwYCzz?4Rmgz`Nkmb~+Oe;v`i=;vl1N?9f
z@Px5s5q?+;duqw_N$PwG$<GSLam*N^$^iw=VtP{~F)3IYBtIb-hne0)6%_?KFw==D
z17y+*TiIGS2}``;VG^d+mB-+KP8e(_6DSZo6c53A5C-eIA~;|;)@GvgfX3hA8<OWt
z&4wmdAr-JJS$8O(Fs>&^<G^~ZD3M4qn}*=Y@pB-(I1Ducmg4kcu@#W3<{x?Un{^pR
z@zY^F9JWH&)gK3R!Yb`#3I&n@$1jHUh*+hrYXlA$j?L9|B?u1jk@2MOhauT?oEZ-B
zHHpt80HYD#VC+&QdI%?D;>@%WU(<LA0eBO6VG?fw=?x0f8n#&ykr&gzXbZO42&g$q
z5A+a;WTub2AjdC-^jO$eBVZZs*x#5T<oX<6SoD^T6Respn+BOxBJ*s3UvXv$xMRBd
zu111YMlyfMtQMJP3rx^5t46Ls@ux|l!TGyqK*y}HwUFx(bX5TGwU%ou!OX%u-W57#
zhrNSb&!ekW1IJ_LL|F};m}(hb;mJ+P?%B(l8k|Z_l}(A(6dBM~6&a|&qdMi>;Z~F7
z@|tItuGQckzA$<4@w3T8O#z>3YIoVAB`KOJe)M^At0gPFTj$-jHzUXBGWGt0@l%&I
z1#H*UDV=v}Elmyg`IOp8BRWlW=xj%9jps}!{FZL##em<=i^De&Yo2fYyQs(cS6S^~
znSr<h?MiO{J)5uICa$oRwmlmx%Vn7l9>rU_%~Tc#d+PIR45dpIrZ4H=Y=B+urpW_G
zM=M<{`85<NUtubxf3pQ9cjP^zQv{kH*?ZWH3`k6_a)J4Fi=~8G-~+zhc{(NaR}ev*
zRpnyHw{w=RtOZ8xwp${#QD}Z-r?r*}1uUcfAe=a$&Lv;~=p?SSlg3%mg(%CpKZq!<
zt#gSS0EUYf)VXN!<q>~l?!7Y<c|P=Y0+#k*P!8}&Hmk7KrHLdBRpbTI*P$%?!Ju4V
zVJ^#TFbG65DG2t|<6kqBx+?N&=#4hO&i1?=13{W-7W``zDOZtKPj9pZ?&!#?q`QD<
z#O;mskl3`!1<&8MSgKnKe8As!p6-(RtBxSft8$_6w>e9LYJpL^w=I!6f@pJFOG^Z-
znf-M*ab%s#>H(mW_=BA^(TZMzvfTUYh~f`*E*l1b;o@a=E+i05;@)en$n&Lh1T6i*
zx*Xu~Y*ultOAARFt;kzV=b$X7!Ma>vaW2bpu<n1+t_6D<@H-8qbVc4v`k)Q4t35Ay
zpiUFbir-0*?o;GR>4Ubw<c`Q^bR7`w(Dp_rNUT*=0`X@qmf~uG5BM|B({)mRITFMN
zt4gNxXF5xLYJpL^XD*RigJ_1WrP%_OVZS3z{8wFx{{YZQTx}<fwW4REtR?-9L~(Up
zNyGp!Tx?rcLIBYoyZ0I?B7Nwq1uXKQV-7GYn{~amL{5^1C?W&tt5Md1LC0L+^<0+e
zpd*NOt}ytKF8_?7)L9W(Lw{of>}-$RG2l2_Sz^vVLy`WYh^(i-u?6nvh^(YLfN0y;
zjm41IxT*xl4__?Rt_42eho7fAr2Z-*h;yq-jQHWs(!g3^)b8*lQhN}sy0!F%fMwiY
zgcFC=l>`m|oy1LcQnnTS2Fh~lFCvPY>Pn&pfZ<}dx)P!$8ZxzD+)NSaOW!VF=?xa;
z0FPy}Zq}AGlcZ6K$kp`iC~M(hQ7-UiF3V!D2t<px5&TG>-)tzQDI#Cedu)JR?UBg?
zMVe@q{AP-Dk0Me^@393YcYJt8pADk@o6xue66;l!z<l?`QerLe0pI;ReRk@vM1uHO
zRf!?r-C4S-78teLeTmc#M4N0a%@?pJ{fRhna9v5j0MJSN)=s+3ik^?MT>2A<;<t4r
zkpsYR@xr<iFxM2B?!7Y=AAIN=1T3Aw#2jFDHtR-hiDs^aD?S9$H=rzs!NgqPja=63
z!9);k>80RDdi?u_Qg_9N8u~{YU}yV>9RrD)XcqkY6zRW;5B2nqw!j@7A1djd0@mSC
z(G%C!I!`2?MDB$ySvZ#ZY6G1viLS{QRz999;;H0b!X=So={jv-_@#}Gr8)=x-R(2p
z;P?oMpGEG)f!1nmpwp$#*JL}ad>*Zc_aOHYFMW0_-JlH&zvSguN;)vY_c6VfH!6@>
z8nxnm_C~~?m;sFT*&BT6$?^ju`(>MqT6KK(M#kTo0lew+CnDZzTJPY2!0j%5_)Doa
zr3ME^?#Pxe0G1yZ$@lq_I<1#<Y0{?D>cB{eENuaB%3)<p@ba;#v8M0o#Qqz#ht(BN
z&re+ZUA10lkRKDQZcFdZGI`nhb;^8uXAUpo$>ZNv3txUk5+f&X(~9d<hw%ZD@vjKG
zMDvHXb~0s-aB?~=*3yTKaSlvb`t0VjjuWg&LoZbRbIyOtn-}wxo%EwF2iez}HxG^L
ztT$ilms{@QhfA<HEW4vP%uIwMM_237k01Zzb^M3$NJjSo+PR{siPb-RIt_XIZ*8LD
zc4}pt>8xznBO3c>sVVCZnYWZ&NQsG^9ZC&N#At@EVnamCvkQc(m2=7_A9yBM?xG&E
z3X2o2FBbl~azr?!Dd2>r2K<bvUo~~JV$ZT_+J9gPdGP39Tf!Q&enG=BE!uw(U8m*1
zXxe|lqQ*)dBcnc{VVNH7zsRmqIq)Wp715=ul-v=hpa0NRUYIL#!8nI__5Q$`tDI)}
zvf0sHj>-$Rq7saAhF2d5Y%b&+=hcG+Q>8<v2ruFkaP+zLcj}j22bOc|^J!ffJr_u#
z!2*sYx4xu)_jTX~p407mEwJ`u-dZ{f>B4nKLn56b&I%RKNtAu9zFI+>wW7<qJDMQM
zF5;|J0mDVBi#TMiJYvpS_g-6B`AXVZq|2x$`V{cg>aM%jIm;f@Z<Un?(ax^ua_)&f
z1H2p7rQH(^Te!`X^_|(N#VtNrZ!9Z+PFr69Y;P!MtD^OaImX=LQ}to8^4GNWSAp!N
z@)}wTSk`*lc<l+1*5cn~ri|Vq+8zSrbVqyeib*Zy`m~mSE}Al$CF%(QmZ?7dEt>tm
zg}zkh9fEqjhH{wZ5z%!>4veOG1dH-3c{}#k2RD?HX&#YX*W|#Pw6ch<nP4$8Eva<_
z#>wXHK<gJam)r7yXX}&Jb^V(n`iODzxjQoIlbXvH@_;w$Et<>mV4anjKccVvG*{$_
zaSro-`U78H<+RAlHCN3^`N>xF2;-dP{R{-Q6mm}Rexm;e00960blG`W(^%U-@RM|-
zrR*S!EGk<82NB$eiV;P2jBK)qA__&^Ms1w|K@$+2Va8Dq1_7f%K?@eQx+18!ix?sT
z?#uX$wt%BEL)8&wczd4TpTGC*b=~>oeA6_&lQzA2onIV`t$Po(im*>%T4&wUW%Q<4
z=!U+hQ<d*T56+umpTf04x~FpbODyzk|BQ56#2mbVUO&CUg=BeMxd1au(o)^fMVMJM
zy}eE8T*%Jp$~D5wlC`zn&?anWlGZ|}I)RH<KMrLEe^5A6tZQ$sn-W^dE{oHy`<A}R
z4DL}l7qQEFbH^*8M_8-gTolV0PsG-I6zgV;r9GL!t;&62&};RB-QBqki?m+48SeC9
zX0TkjF9O=#IQX-2AN7laae3FF0wLBJrnT42SVqfZp&R;UOjYg^J;*i1I>WVrx*2j>
z8w)+#-;z$-!q$dD?@z$Bg1#0&+o}hH`=P#c<stUYOKieyt$SY!pRQC7#`Z%K>4oY+
ziK08{rD*lzh0I`yVll<~^ya!Np_S~)IIZ$q`T;Xotyo;duI$bIMhQK_j_%Fn8Cqjz
zb&uw9=U{7bt;s-3DRf7qwy9xo$~iWb%Z<d=&enc2&{6?yO3*qDwD6oJk5V0o{$i?l
zUdm4Aa&Kbq>!8}M+_n8JW=98|70-9Go4DLg?0r3SZO`Y+m<t}dLy(hme>0%X>IM--
z&~aAO06nJ&s>WQ32J-pz&bmPhMbJq$v;mr;3_8JjatoGG*yB_CajjKfK1$D54~F+c
zed*3ato9|gf3`NDFJDM^st1$%p;Ktbks>T7NtbVL-2LU!;RM&<&>i7UlVyr-yFS&@
zxKI<Z)8woNxBsfB9n2i_!!JXg|J(Na;x=q7e9P52_qP$FGv6)v0gpW&Iu>oX=3H!4
zcW|b};#Lj}O-~rY+_%`08f=N^!Dk1>MGyMeZ0*Y4&nf-+CfJfxW$?+EFhdu}>X6Bk
z$0>u$3?uPvY-~NWuS=ZSzg2S7N}>oZjgfKU>sW0aG_yy17pt9ZcmqKz?{5>*T%DDJ
zB3KiX-2lCyxUvUZS~##3q5bNtgo-Q2W9%BBNy;lHW0DL<>z}oxp#HAoDDsLWkpv`n
z@TKn10aPMKi;YdKP01@3#55qeiT~yXl?x=D_-}};MP!{)6F37Ddoq6l>wVOfNa%Bc
zbsN9L+);*tkTHxAu%@VSVbC^-btyFtCFYvRTBdB63rfOp3q&@K7g7#AU@R*WTYF6-
z+(5}(ycEbRc_C%cG8>scFGR@Pa^7_&qt2lmFBQxDK}Z&J%M!W~37JS8;EPI7e1VZn
z0z#HDGE3+QG$fNz0qY)K$)UTBHsk?IA|8~q;|tuO{b)%R8e(Y9ggjtDOadi0@Oy61
zEI|p2-$P{0BI~%CKn#R<GCE*QQwJiU&ji+2`6U*Px)EYy<!>9UQ!i|r_3GWbcg=}U
zpFNw|XJo!`9R71_I69X+cL6>|n+smO3$z*9+d9AJ`^LP2OXrTZbtGwCTxe`Qth_E_
z{^47@kgo!Wd@(eYvh*WR5b=_i`2h0-44+>PNEnHs=Sa(HTwFw1qC_wnVT6nAWwm^0
z6aJ%}%mTRoO`Uq-p*p~in2Y}iWEMR4GH9u>?1Z>{nw@MSaQ9%Yf$}|+WhC^Wq<kw?
z1_(<R+1!D>e6q}(umllT@NhTiD>NbpbvF@4Nbqp6%nP_@GIf^F)2RD0W;rPD5Os~D
z_=AXf_-!Dw=eh5ORvF9Ai_2%&$pV49C-XZf-%FK6LZ3>?3#nK@NL<3cd>>=uPDs!Q
z1oyI&74xBsaIa{lybbq4WbQ~kpDCA?$D+_gCSF=DA!9$|k3AKQGAh=B@CFgr@dh{O
zYcygtT5l?hFu@zdvdN%6i|Mw6o<ZxEGLu004N=ZfWeg8rVI(sFFtUWML+U3}T|!>H
zfH}o4A4PWg6DeY73e`1{z(9nSce)!p%wrV%a#IpUV(59Ys|N2YqPloQ9vWeW_u0!@
z`OqfZ-cH5?nSW9j?_+YnNcrUm>F-Af#n5x4e>HAjMERq{Jha^ix3`xa<U^bADm$4K
z$o!i+luZX9ga_KrhtY06bP-+^&2+TkRfsGA$rLgj((+^!n#hcomJ7&}|KJ-=vB^MY
zjASA(3PGX1jM{_fO=r}gyn;N55{bfgZwl%|OcAyV@kjZLAVs?hl<y!<A~5oxpti(D
zE7>MLVk2me!5<;A>AcKJ=mi^@i1!*WjzOG%(*{$}J{u1NFxmy(ZY(=2E)TGid4kt&
z%wABwn_3?My)P;MiCT{kzAj-GE}ip^U>5Pqjmh;B0J}g$zX@M4^gOw~20vd!t>+PI
z&~_92yuIu!AKHZH+R4no>%S;=1w9A|XSAIMqn&){B0M*mX=%fA5!nRfwSZ}nmM=u1
ziHx~Wf-vSTx{}^NJ{fEzGc4?6bJ1cz{9r8W=1WY35&=V?a3Pdb;I+UyN6>x~{|sdN
z&Ga?BfiB>+E0Yh(cT#_cLpufKFZk^)(sCE_Z!2OmXz#>7yF=Fsyf5Pdpd!umhkMTh
zU^9k6K|D!G!l0K0@f_dVP8x4cN-T-l!21?1aEE3KyszQKK()(Ej}I&|A|)2YSO6n8
z=<lfaD%8eQ=q<&I#VS8wlf_)Igq}fdmNMf&{54V6rBA7Rvc#OQ0Nz*d5I5*6)H?^Y
zF%f!8@DQ;|25d5!1D4R!sLe7a1H`{|VZL2(ioFh0c8Cp+$&kiJp-^Aul?U-xI`ay|
z?<Grk#5$q3F9r1>#6oWbch4U)ylI^~Q1Oupz*tJ-gHfn2Q|3Y3PG`zMd>I*m65&E`
zFAC~IcnQ4)czr(eeTp^~#Fvl}2#nk*s4cO=N~Q24Rsip4ydF_a;#K?#J!PYk@+uI<
zKWNv#t>^qf{5G;35cWcER|;xNBwMLg`4P#$I}*=CRO5LS6;QQ}%8^&WW7Y=|8BH4k
zfp;kW8o+2bbg!|hMI0Ywr<wsOJej{i{64BZ68c;cPf^~05V**Sd(WdFVGJVyFbadV
z3F7bZ8x0rEg7mf|LO|m!+;EdJm@R0$hF1VpnOS-4z#=i}Z9%vL7`Z`zM;lk638unE
zDPAE~`GbTkrri>H22EJXc!T)sqONx)M@lSJ5+ng(yruCWDAbo}^dNfDnMM#_K{ld9
zg0Rt>g8C4Xg^fbIC!e{JqRj#EJIF=^MjjN@mQY%$^85%TXpF&o5EaHtsDw7#sD!*8
zz&Hf$+PFO_p&XxVq!I$d>pNINzeRc`Q8|WZ@R@3UycL<_PehBMDOAox;v3NTn%C2X
zJwTZhe!MXWBQf+mnNx$GE~0XH#A>wB1V3%BI>U!H;YvG|Dd_o&>R(9@0Ky4v<iY3{
zK6DYTjAokKa3!MhMS28GvowAo3Qc74r155C|7U#1DfR<UIU_wh7|lnazRZvZF`Ui}
zf%yGoKaVI7Hcp@n4v&Dg#c{PJMW3o8&@VHFuSQ*nE}kM8SQB^j%$v<|wL4ln7md7(
zd->blzaBh1xxH%0<+griN4$G|UH030E9)Hzm+^ZK@2rTOl<0cb5WUuz9r1W`Jm<js
zrHQ23p&xDU+~1P_g8$JkF66}as>XZHS&ggSEj<*GVHS{ZC!^}0=+$jgKa>?zzj>Ut
zFW%yveYdrt%HP{}$3G8Hc|8qKH4N;VeYfLnO<$_{s9RU3-)gvd{j*~3(A1+fx#HIr
zljD}wgm!mChJ<!UHOX%n#y8hEF9?{hUBH|-Va}T|FT7QO$RrW@M#?Qhp}yoO5Bw)T
zlYd8L{CSpXdw~kK7(0Lc=J%Itk)lh*D|wf=#I~PuVxMI6S}jbNpgz*5IhK@|dL*;w
z!-SxEXVx*T>2u5T$C1AI@pqF}q#mj0ondh%vC3G}yFVs#Tk=Y!H&4^Mc=3Jp>68`G
zhPAO@z^Y}Ym!}MYjtQN8t6P#@5s$zB>-XAIpHKbOxK6gZ<#&Z_b$8&+Y2{P)A6?U5
zHG&<<>_3~i_Y8S3XZ^(NBcphO%;QF5lXb-ESxsR#W}i;*v2=`2RTgI&mZ$CZh<bW`
zGCr-451k4~)U^oeiRtIV)s45KGZGf8vOJP=DqQVdQ**7c?4es?k7LcXZJRAx@M}Yz
zr@p@OITo6_$mXJSpm9vikM&GzisahWpb&?9jv0TfmREjU>{w7aHi0_+WX{7s0^ff0
zfBVsV<Cl@GCa#Bz0@q_YSI;_pbI@MXk-bl5r5+q^FjcI1540am^Vhr|)A@(f%csxV
z^47e+Wz}-fHq;Rh9Rd33BZ_#pH+yxe#fl$_`u|x`KgG21U`oSp4A$uCXILFK(X8=c
zGjZHs>0gCaMXk5Z{$Ll_HvQh70sgY1Ry)tftnW}3PJD3t%>3`N<xjrq-fq$@dHXJk
z*BBsGu`?L#4$@;UjMt7xWw$Q=R8>&v7gOpxDWsXRP*Se_S3<i(oEO+mJK)>v)m3pg
zY~h}9X~P5G4L4ml>KD@7W!)!<tMi#(dUSn>qS&jeXL3k$Rn#-Zp|8b*x4pVd4uwsv
z9``K0MDZW5uIQN3HHKZ14~Km>s^2vDS;5%hrrLL7y6LUWMT8;pErwPSW^t<RpE1kl
zqx+HInPDoC(TDU}=UC{si|h46FIHuablS|hb9CmP!LN^u3@3gZSu$%~Q&;Mf_J1$!
z{93-+ZG-y5n-jfX_D8EfoH&$oLlE_T{xL_Bn&&xQR#RGMrA-|@rL{*H@KB$4EJIrJ
zd~wXu`>CysCrnQTy}<{T9ewz1;8T$>#l<1JAf5T}8`T?X*y6_xB~=z)?6`0HeSGxd
zPW`a{Rr@s6#s2FRhUH?1bwojrW_wZpk$p{u)z(F?n4!F}8*4WoA};wEec;t@cI!6V
zI&^}V<poVHzL-^eY_@LYlCY8XHxI_>CyNVAf|qEx2eG=9=0lI&^*g-uJI2QQ&6O1J
zf?w?7rjF5@7#Fw}Uqouxs)Jvg<j#)KH%+KpQncAP_(d5UePdkUQ+!cSyEZL&IJ)-V
zrF-TK&sNP6e-PFFJHC5~1e#cjjGqLy3ctE8UsPraY7sX$I?e$v=((-J>R{g0F_X-<
z3d=a$+~HO*uO6Ch<8Upw2+!VSI9{14T07fqlF?S-32uxR^!!#~O>mK6H@mIE-CVl4
zLq~8?J@jph+wj6a-B+}XEV4T@^7O;(*O#v5MYo$=59#~Vf56(MWbJ`1Yd7tFxoHBm
z&SYq2>+#Rdiy!89PFQuZ(ooxNr@XkZ_@Q)S=soiS>(|DoTjuy(+p<0V^vA>7xas^k
zFP#d<el=|~|7@u5x2ON`!KtwJjDCBb`1ihbDu>@+^_eEjznkAYr&Xa>Y|l%+dw6>M
z%*lg&rXT)(h-|9@SFafP{S3BQT=oNYH^5al=tmb&eP@=i^YuULgZ|Pkn^mmzPsK_e
z%~*6dYxDRR?Qdt0$xkD*qqM(Gs@`@r+kri};+$jj)uoe6zT0ug;!U>0(q9hc=TCF}
zdhb-kmpIq#Nju1UlL|xc8wFO+yKLA>v#y_?&g_bmnc_Xa^IbmojnCTqZeG{I;CWXJ
z^|ztgk8S;VtDzJH?#s(>PikN8J-+kV!Iw{GmazX1!|3<(o2>U<2o3Cfc8TBlY1+uh
z&nq9C9et@rzcR^l`f00xf>YIfe_o#7mN-fDINLe<VC(l8OhdJ8T%`O|wTDMXc8YY~
z)eOIC+oF5xC)%0()Rz4q!|#S;=CYsPYhITYt&-;NUo9;#6m-k})jxj?dSdsFp$2SC
zZ=Pfgf5}g8@qIh;WaD_<&+haICg4})jR<IOeE{2SZ>tV4Rop0Lr*ZZ-vH#RT<vsSD
z*neh+_Ov*rJo$?W*r&Kr#D3pvKS2qtWchLO;NvWxtHLoWT#gPz?Sd92$j1#t@tqO|
z|IS|RS;)@qsxrc?lH~`wp=sFeC_20i+l|XD`=U@fTpbYJ4^5<Rs{`y6@ptd9{m(3W
zg~x7oIak$z?XHKu?W)S?j}rG*p;%m)T%wCwN_)jZPxMD+(hbbPoW-i%jo!K_cf%l{
zLU||x+EX8Jx4UYTI>1D6sFa<=Ro%eu*Fm#-s#xqkZ0u{wlRhSZRvao~6}?ryN@yi3
zjg!wi&Pute*;oKB7Y=mnf^JKYdkl2I#`OD3Sw3A=7ht8xI>|;gK${g=RhXtwnMJYV
zyQ&13CQ1HlH&l&jlI2r$s_MVy-CV_0MPr)T@+kuyze3MM%71AH@Jy1M>N>{KflR=5
z<(n|*&BlOA<(tA^8gqxt!nB3#qOK}qY(ujAXg4$s8;qiJ+ps}g?%dbGqjS{(^ZTKR
z^k;Q|i{T{t)Sjlzu)%P7kgh{ce~yKI*EilzIf_3p9?*h14N#0a&Y}&_B;}}+Y%sTA
z^0D&XjbnA=-RNRQvr9QD0?O5EZgnSHt2IW7QKjrSF8LbvQyp}9PjUzL6FiCjDNn95
znmvk9MQlcI@^~e*lC_MJhaYDxx#VCh5|@hy#+O2WOptpGj29SAqIdS{%0f1_D_Md?
zCd(VTp=sEiC_1wZyMxQ^`^NL=OtmJeADT$NR%;v$jU7>)PBX>sgv$eU<K^`0Sm<|s
zYCmNne?Sdrn>r1uNIcF;8lXwa#FK0UY^<zzqq|P+MprPJGG$@}w5wjz-koft)<_hI
zrK~rXd>uPd2hHqBzKb1!jkTvd>0vb0io_x|r#JZ<CA5-th?7SjXC1iYIoL{EZZe=Q
zh3-g@e>0$ljWuSkeo)A!bR`>OE0g6--Ow~_Ac|JDVFS3_sZY(Lm1<2)KQxj4pw>9U
z#%fQenPCIr@|ildoc<6C{jP77pK=O+U=^TE>NJRA%5hfM08LU(Imym5G&X-EZuD%q
zYu_q9y+f^8&=2*cqYtr%(&=bM^P^%4#d`EUa#KQ&uvxv2q*&vdzD;}92<f|Z8hgbQ
z4V%>fy`VU=2TLtfo*~&$U5`*KHA((cH&l(KCd+*cpWnl4)0=G+XUf<_?om6IS`Y2-
zdX&|_%DDHD5PK3PAFW%pj9wiJ)%35D(|;JgnEN&lR{g<fXvLW#c4O}&UnR7XHI0*p
z9%oItN3*f%xLh>wb{BMeg4}c9E&Ph5tXTbBAsf^6NQ_NSmLKkhrePPN=(INM0xq}h
zdyCR(YE5K6G?9L$){Oq|y~F0@=*^?g*BI)*ZW(<(_1`J$r+%HX{_Mcn(oIqH%r<Nj
zE;s9Yi_kOGn$Uh|BHgOi*uwqKIy^GQHigS4=-y`1t+7yL-`fD?N5Q~b9$iqUF;jdz
z!3H%zla(Je>}JD7cz>{W<1F1<PkNZq>{ot_gubZXaJf6sT)hD(On0#e7kC*H)j`vH
z0&ig=!>6lzOVF37fqZk))RLPGuv@su9jZgI<*1WHi1G35Mmlrgl)=oggq}p5vY4wt
z@le#YR=?4XG_~TE0;~hy?hbv6Vi~BDScsu`sFBVHI4xydEukk+r%dJ`P;`sBw(Qwr
zP5xrZEdW?M9_kM5N3kr_$ykU9@ta0EJK(g8S!M~<piXk;KS1%+uv_I8NAeddZXLi_
z{H8nf9f~bQX(J(q;GRZ0KA_VXD@*8clwQv428u3G$q{9c821$G+yIO$p$dfdr(y&=
z8fD`63JDoAk@FHmlc|^hZUw;p;JI_yej#(8uW%q?B!*rf**%8e6^aF%J&N&gxt;E3
zK2&YEP3R1_vk%nC9J&+bl2ObUMruAZ4cA678`^L!&^aPBkJ%tq#GuebW>BhdCfP6e
zqtmPw(ak_;5sVh2P+!K_gDXyFjDdn8eE}yBHjkm8K3s^f*$B5S7&Cm+)fUl>L(=%n
zPg2DK6za=FdT{mWOe9eJNctk2yRg}fg8Fco!e%L6S-_Y#4Q7JoD7+HU`Sa3#g`PCl
zm53GYb~*`28_W0rMKN_W40>InsGyFbT!M?Ly7#j;NONb702oC;djyKR{N_<og$a4o
zf}0GQZ{QEypjm=u7Jq=~n$7A)P7eSDO&;ZON@24v1-0eYdT?vo@Jk4{maiWThHv1P
z!kHI9H`RxGFV#;6!|!-~F5ixr;+L$r_lEy2ykTEzvxs?-hHu$}Z{hQX5qyg|=K}O1
z-tbuJU%<>#<5TT)Lh$TQO5b^IE#OShW&}pt_|Qf8)M%!r4WEkWJdkI6rbeoWL!pUG
zs#IZ2uKA4LJ<Xm4x>3k86h@IK)R%eU!TpiWJOPRtat)7LEo}aVg8Fby!e$=+UH+JY
zJA0-B#dh)?fRQT&wdK;RbZh*$G|(K0e~0LNdCw}KM{RWTg+o^4zj{jV`KKos4#&5k
z+<vM4FdwE0WH=KYwvp;>!Egw^1>u%R^_Bb~WAfjV=<r>93y*sdL@aC?d;#=Rkzo^j
zO91!6QnwZiJrO86`OUUcg&FzIf}07NZ{nZapmITTC;kc1T{P3vy`O`?Gf(CVQ0%AP
zMM7T)^q2X0=2AT%oy|EO$h(Z2xk1wfdAD#gL|1DzDP-WQIq7W4%>giShw9M0<>*X_
zFprP#G}2jsnHfx|CG;dZGmE(i^bbYV2bG(p_)f8IB7l)4bR#lzBDIgtn~5-<d_AAs
z=f_!zp-I#}e=ZK>_4B^ruvr4;Fkf#?!bl8lCihk0orTmsgbP6Pgm|Z&u8I#;<DK@p
zKrr(Y_3H|HKabmh=9$9iJRh2dPl#e{+wciMCqP;OV=L7MqtHaAQmVHk7Z2e>^t2@?
z7m4PH@d@_2dOkD_KNiI-Y{QQMoek28G7F{p2o##gJdo-g$i-i9?J4#cqMMAg3SpFj
zLVcO39$Za2GZpB!k<S4)TA1fbL4CMXVV*I*wt(?T(VhkRU&-evjC?4lEjQgtm*&S!
z2YI3Rd!TdTweE(}HoBR-RuS_lh+CVY{RH&;$mcw6lQ3@r1-0cwR=PQUoCplzxC_wn
zcm=zlMK(HDUICxk8N}^R(e4ELQZfkTLWM&z3MwKlj!YzjY*4a$4u4l;_?QH1ym21h
zxC(731F@5hiHn`)VHE=I@MBL#l%nl)`~ROKBBoi%7Wu(hvQYdtAampu?}qNRk<H*0
zi<m!yIM=2P-vh~fIDuw}D*ro?W-KcdTaUH-zo*Px!oIBA<sHHNz_+#_$N3X;#n5JQ
zToqngNR2}XH?)M0m)gn7_)s-oY7ZyJ{uRj<SvPH14oaf%QUuPU{R%y4EGrRPyW7EO
zvayT|SQk?V!l2hB))mwNl!!MR@9!4F@l<?k8}fiZ5if=|lLxBsdxg{igqVbu2=RM%
zvT8n5jo-7EVIbra^=buukVh!c5>ps8^Py?@#3;tD4W9^PLgYGN?4;InP-r5vM`~?F
zW(?tvE42v=(Cco@9$>wj%7}p87g*onm)J<HjmZoPVm$aC00030|18*PSQA&{u<<k5
zAS5g%Ac7)02_TCQ^<hLEP?UhiNB|*<3yKX=w9<)66-`*Q(y9ni6dgM#F$O_E<A&50
z#0_g40n-+%R;v<-)CIJHMgKW(-w%`D%+1A>IXRPMPU$tQ$xk{7lx8tY?_f=c@VuiY
z%`#!UDw8k$62RmS9iWx2qFrONO6k}JTcHEEwvzlG586b#mPK9!&cE6uR4eyzunlZs
zD1eCvRU+3S)lZr9Yjkom!`V^wbh0#>4NX@+jg)Q$rLXAPZuEu?`GMi=se*|Oy{zIL
z#Mp&u9+1*#2>@e{6RH`|I*jcm^alPzYQy-Or;afa;xRTN^rri3pw%4VKDI_UPB;em
z`;c>h=36yS483WmIjH8*rJ0^58%<G@fqwwm4q!@z{>Id_GZJ`Q4MSD#B;|pGHcadX
z&15EYU}8k5cdU6hcbSX7G>MjAhl$;UdImHDyEUI&-HP1;LN~;pPOj!^=F_05<TI{j
zf~x!@)?>U^D^!>BrFkI1h~4ss{!L3*Nz>Z05)drVR>%a}6{Ir{+DOx`CN)6QX;a&v
zl(4Ztw$LBI#Dn69HbR}mq-$wpGDBmhN}4PUVnfr_Ns-dEAYp)>J$(y&O%`B!L^y@6
zJpet&5$<Md0>%mLf!3Q80nH9|XFT-9EUYm~aRqNZTy$diRRD1%{r2e@^4j-5eCql=
zr|Wod?%1lZg0yKI`@}6@4^ms*TJE;Jb(|G*a0_eu$OTbo<mSHii^)^o{c!jFTJ@R_
z&SzF0dLp}dB8wGvq4AeLOUkoY4c}%TY7GvZ6uDVD@K?m~sL)9F%cik6gKgH#y_8d5
zdn+R+WzkFdskMfj`k=#?O||8}olCucW=ZOv`I9v4;)vl`8-wu>CgiiTXw}vvwu6RN
z|8hdQX0~v<cc8|tIHE$j#;N0%*h5<A%bvymTW<P%=SmyVllG5`v2tMhPYtiPKiH-9
zzI@)gGx0;<Z?-S6+v|RxxpdTVcuRcB{7JIAr^kK~`R?U1_k<ajOMi=>aoK(Un*QH^
zT>9Qyb9F*&)R4Dx)!t1`i}!x~!e+y$^I`f%r^RtiMHg%DIXtcX@^7!x37Iw<QqI2g
zIvS?4_Y(XoPjo@N1mM|f)e#;PN1jC>c_m}KT#;u!s->XpJ0wpGy=_<afK@jB%Ci%t
zplm$Ii^SHkp_jqigCM`nwrnSO>x4}NH?M+xKj<pv%^dno&hkuI9Jt8=`EFhf3}^=M
z4#48aA+fez#UK`V6(g~Jm@O#&*G47D8ZKOzwc(B|VPSOTb4SZ1?#Epf>4-Ao_`IjT
z*Qs)aF0Y^7KAVobOPI}Aj%9=$Y;}Fzne>{O+%fkxv-@44+g3!mE6XE+d8ay=nvhVv
zbq;g1x?B2D#>^JF6jvvg?M#Y^(%7|0gA~N=k`K-2s98%MS!|>?1^4c*FX?_cHSC>T
z{;lURE=gw}M4yc9uX1pxEsL0JeW-f)BF5!y?92Hj3r@7LWS^Y!AIis_Uc%{8=B&K9
zF65VA>r0;hxBF#5)}r>Qait$7j`W?jU9it5Jg)S$bD)nde#}9ixTUh1lZOfx{WWEF
zYvI;8aif8GDIaBV*`>}Ufk_%&{GzD1(l+P7wS>>LFTu5~U=&~cJt#%6$t+<20(HeU
z@X3paR2b&DXoKgUn+6uT2vkpj^axU#2>m0!IoNG$^LN9KD<mI}{`fk1aZsHOy_b08
zMZ&4BBf}>bR+}PsF3euGGI2{&+`qLiu64%-4qW30CuN828xq!=mUbOCR8~bNY&kT4
zZ|AbqCyRP+XM3*9`ejV&-0ia`*EBB8xc&3^(k!$6wTRa{GTpY#Zu)-f>?UqYb=vij
zJ?qm=fgH5<{oV98Kjq#ol%#iB53|yBb=}Ym^!a=uuN8fc=_d4P=tN$fOwtccCEnJ_
zCgRC=ZdacRaYUbsb<t+c7sT5n=%&8paAgp~k_-sD8X1BIHA<LzXqqzUj3ka)G$m}W
z>Aa6Q*^ekCW&4yt3DA35*{yE9bDfNh2kn#iQ~Gvve+_i?ef=-!{+N09qX(89t@Tj`
zRY<ZZn6%KBo%+oFWVT69LsQ~)cIM=jL{Jj6sXsZ3s3niDU3SuRKFFNxZ#|IhSJoy#
z?`vguy7go0WcGONKFJhHe;vJF16^}pZ$$4~pRDCy`GbB^M&PwY5~WEWs)SZb>}9&S
zjS_oGAA?T8bSz7E8FWXAF2K^w@JJaPdiCZ$gQ%*J@$t21Bn$M=W_;}-^jx8Gty&V&
zsb`|+(sT#9p>^oFblp_*$*RS3a+Zw8*H%b!Dg7PvoEAFJsbAIKZ5<dLRmSTa%-t&q
zGzr?&-<?G?TL*UZll_%uQdWug7fLcr`d}rrQZhrPTh=I<LFwnA?=am&OLqnIXo_y8
zrQ61OiV2EbOOd3YQ}2krOV?fLhGwAl^9fcfYLDrVJ`o^TbzN9LG?my<*X3lL=wR)+
zTwBy$tn)UDRuemtpm?7sLg~)5h-k#znl4-1y-DJ$ho&pt&q`KVC%WN#)A`9}Q2=qB
z>^i7)PlW!a?P~AN=GApE@TxKipUQ4S7t}yA?`L<Q3*c*SCx38)?9$*>g%X)5J4gww
zltjvO>5Y;|Dtj(^2h+J(L>16ODY__&2o5Z0ZSLVB$=99P4(Oe9-KB151{yM-7~6`5
zU^-@>0T5&Bx?=mGsl<W0E}nH@r)tjSve6K+&fjcUO&myq;(dk)rJQLo(1_HUE<0S_
zBnj3-)0NStH<<MdJLF3o@#xMs*o{>l3;Q>de_g`mhtc{XrMyUz)0u6L)~D;vbwlgX
z+%%m%oaDHi2Q0j&OfsIzzKZ77K>zB@&gnPUo3c4*u2>ghHe?a!lc4AN4XcQa@ana%
z&z(+X&qD_=orlFx0VNW9zn1k5t|0El^nTqrJOQ8i1#wqv>?H>;rSx)4!!+x#x;}Ti
zl7q~?tq8ij(de4g%b|wbw1ZmxU{<5Ck{tB!+sa0lpD|V@^(IooowZ#@l|4m!YV${?
z_4O1<wsdAYq66u=AG@I$sK<Q5p%wMObo4$P5Ds-+G5yd~VozPy82D^cZ!L1sckRQ`
zLdiT+pHK;{ln7)xS))Wi_02&EOvkt2<<N>0U8DtPS!YbH$ems!`J%IrixTO&v)#}P
zG-Eyy+KOgiI!+&s5TSKlasAL#;&fe?i}lHJwC4uw&<wFI*o<cpr<0({K0H#{%(UQi
zVqHy_J>J|TnWl%PE1S<sHd!ylSBdqxo8G;=<J&Kp<z#lSZbs`Cy4{QN*ycq&d`DML
zJR#Y;f|y8l72)5gB#x#&Zzc4UWTB~#jn=;C`{$dNY;=ZLCom7KCXOaS@xGx5<u^>r
z5RF(?)5XERX_AELq3OyinM4D;RQAdrG+@2Kox^rGOf|;E<lz29-35Ku^fcWx^H2cs
zi0nG7{3a3lptftLazwSKR{weH`&shdnV@^8Y6M6<S^d6hsH=22|761_<?FJx*Mpz0
zyk7F{l_Bc}{nxs^z2H>v#Jbi0RARmnJBpqBA#CW7>5`}IJKySUUfp|3M#Rv&{zK;i
zhm^0KN8C?Pzlut(><Ap1vaq`0`G3I_IAl*Rpkt3eVEYWl$AFr~7_tWiSFy+O<a%Hp
z?@C<=pf0pxk7?8e#!v_-xQ#tdAlD=2CBf3|tbRvqw18B|dq08hA5<fBn8MUhR|@bI
zSU3fMJBHDL0?_Ttpeh%I7u}vgs%MsMyYNH}L}e-#jlx*&LN(Nt^5QF`;glC}pMw<v
zg%jPr99rh02&db#$kv(CrS*d=fct!`2!ZJUw2@<;&Np9PLB0a!>9i3C)s<D`D?e%z
z7$RKE%eg~gV5HJfgIWHy?zkeO9Mz|5*ynQWGmYGSN%bk0HadNr`7sz;PaByAMh~k$
zg{VK-W1r8{3hrW$>C`_nr4jXm|A3(xNP#2vIFkB@XWjxv9x+Aj40qlR%S-RCh#AGF
z&+hzL`QGV@aiUMdf4dgtd+AtryV%(U)sy7C)m|b^@s2{unu1E8l~lM)kv6V)hnfoK
zxwB%grYR0OL+fH^HBydVLq%bl6wAMK+fgibmWpzmG*sj~f)sE2ian~Z8y(kjbJX^`
zKlU2_!+Ioiz2v!a-^Y8+H%HsCSqQaorgUTd;6gCOM@AXgtjW|uo>>4!ZZSoFFx)3{
zMH5sz_|#Xx-H2WFhpuC~w_?6PQS4ardCocp*zHA*0ir_n+<0gkQ`E_DcjJn9s<}KW
z9=PAaeEp%>O!sTpaiGvRIv-O`WMao{70zIHCb@_Q%|k}Nq>WDC4n=~|`PeKvb(cGI
zmNDX{+IF5c+J^lEsIZw*@A|<oFvLMdY1mKUR2a|f3P!FmhfcAFa>kwJZ7Vrdyu2^y
z$>NI%ANDu!w(Vcc{;4gct-*Av_}(Oud-2?lvHs_b$72*C_HI_SHOcLuq1BU5PzS?p
zcO%u4{Y0$d>y6a7KxkUY^)pnOle>k}H!IkU6T3>Rm}I*<tGX!(s$}nuEV*71qnKd3
z+qZgymuOGPburW!BsyAhy@=Yp{G`E@A8or^Q2oXWrbOr?e^IM*l@qI)?Iltd2dF5<
z*eb6Q=qYN>*ecsteu4MsjamE{g%5iHqk7jQ(IPu&XtnqRRTFNzfL1N`6S0c}nkc_O
zXnIM&S!%UY)l1I)`{+Ve^({Y<TQN+5(96Xq4#vvbyhP066J?aMQ&n56tOlCtQq>VF
zi&4~uB}**PF2yIxsbnXZw9tND)f&46oFYo(R5drY3sbmr7F0m1QWPj>flYPa73q}v
zLENcI65AC6Qzf)HQL!UX<on?{#oZhwDq7}nM^!mH5*`lcDOfENs#X?6i7M1<Xw-bq
z_|G|!h#~;F!ypfFMKT&RluQqx>Q<2HK=hqz4MI&~Rr#x-!PJ+mDtqi~f!Ao_;8{d5
z6}iJAf9Hyp(4e7YQ~-5k1sMfIJ5?_LHGx&-tA++sOIcMM>}%`4Z5jL;QG_CQnB*m{
zXfX{MO6CVpEi1@;Alj>Xfl$$`DuEgrOl@UVIbwqa<O_N4FcAHqdO?RNObvCVXnaLX
zI7I_;4C4R=LJui}s$CS`^biJFV*S9H-dh3;Wva0>DwZV|s-dow4_~n;obmzkIoNkV
zF@_#e4&CRXm`o30k=JIHePWEIQ<*e57yHgl(ZqmeV2Sfd|5hv!DA-5{Li%$Jb7;_1
zQp+_ss}77{8Rv|Nh$0XPVZxM5gNBk>0o0ilWEL=duR4HG5iEIt8X8RHvE&Ze?E><Z
z!FU@{L?IzI<a4fJDGeG*x&%<AD@Ye$C{(2a%8n)XRzriS1eTnQ1s9N>24gUy@JH$y
z<bJLpi3SZNQv#^k@Rt3Jc8?O$;@11u6<*+_zFERP^~}2cSznxDvL2tM);h@tI14(_
z23GZbKZAQQOo7nL#ioO?Ic;7BR<Ws!a(9wnjm@cnu5yvzj?IZt)Q5@UEG=V;P34r_
z2_`Mn!jpetSI=4Y%+%_0Vb9o0%Ep`Zf5ojMmj1tBY`$6l1^Esb9@$hKS1xnJENsOL
z022?o3CRstPi4?^0cp=LAgZb16pIZ_Q%{Yc=7JtGJ%mEnGsxWx!x$AzY-qD;>LKiK
zp?WGp1<-mJ*x_-C3I?<eJM5;21iA0k2eOH2bZQN)hYQnL1~da(GM@}-#g+gC2gyaq
z5UwGP22CaFxds>2`4P-wFfKt9!ALF>rW6`9l*|pF&aWVIfnm4mJVH%n^#rJ)!PG`p
zj|29gfUKAI4gdq8I!}iwR1I~d9QcZP<3j)1_;c1D4$a>`Kq@y({}8cmXUl)Pb=ECi
zA+Q}7Dlujgn+hojuZJCLO*&_2M(pMJ)fufag{u`&$;MXao@+8i<&oISE9?f&NU9%l
z4dYcCKVl;rb1ox_X~+PJw5BCAXec=&fI7N@oB<3wRqp{ck=5g?h6Yp1SUntUOMzFx
z^z%OgL#66H4W?i<)RmgaS1b>wW`dr1*hir7qz_a;e{fOEq7T@Rqcf==<h`T7@Pq0-
zo!Z9g2~$H|DTHsf{&+wDieWau4Co$ZP?d|>i|)Z7i)K>v`oS20#$z@JOd2T3F_*D%
z;W)Ds@bDpL1N>XHgBW_#4nL@Npi?V7&HGHl;lLw+yb54Sg#O0F+Zia2i!)SvoTxDX
zZNujIK{J_X2R08epLDEwoZ2S@9{%KUfNRuy5}@5o{1*l~mWy*$d&W?c0eT&~;RjvA
zM2*-D#Qb3v_T-p?*h{B2&`<~LhMV~!1Db&e=9BzZOaRObga9O;i^tNSsbmEg=cyzk
z*vNtq35^odP&OuTGuJSn)*s39Nm(nV17>H0pph~zo<M`9l3iTfT_yR5y)hVdh*^XX
zESTgpXeb#OKpk2^Mgn|?$_OYo7V4{p22<%Ql!JXyKr-aLX90ddWu(CrtcJQ$QGD~#
za4HI*^RQlEo<JumphsNH(R9Lw9Gof5tRKt==t8U)fvFPO!Z8=Jaqn?v8p!Y>IRICy
zL*t>XcKAMZD2<Bq6qcBVeL#jE`5k~M0eX*#-(oa7b8)sRbPVMWn%l8TKj>;^^DkH>
zVm{-jNwREpQ-$)WEC7=~^d+r1la|3|HPf)gwq`q!v62ktL7Qk9S>!2z-?!<!@TkQO
zTg)~G0hoADC6W=TKFy?O(8(MIZm&8$nVQ0ermIg!QcBSLH{HdAF1H~q4BSHn6B~M2
zwJlP;jl&wTS8ekp9|Q9=*2n_dC=2^3UA^rK@-brG<Qe~1HMj|k5UOo9<YPDUCic*D
zF#0!b<SJvtcbwS~j1;Lp0dkggmpx<yMprVMTd`@tyu&d$(Xy4UTIWRB1DO1vPiW2A
zw1-?)GaH-6HV1%*tI5MWsDbt{lUxGu+i+p`3KP3vYaR<=;z9F}hf~$-Z0HYJ<O2pi
zUbQZg%4I{BsQ(V9JV5hb^eLU_V}zW}z-?48v7r}Le^+6fiqwD8s0>;&2ixRkKFxrB
zrgz79%u8-q+%R!q$@cq}&pxBtqgyoR2Y!@{UinmfPq4A_bV19+4EeTCDV0-y?AbJM
zEaBEHj~>^IEy~>A^#ymAg*?Cq{-~dKIqZS5PygwHtJ^o9>c5%$X{hl%k*r;K?DK=S
zr$W~%45Q2OJ--P$wtN1oe>3CNS=IKzz~RytSj!Fio1>LU+&L+OnQPxXl+kZ#F85}Y
z<^3~rfS!5t;b30*A2Y&!2;6ixSorMk{J4SRudhVey&8YKv1~%gKP#Od=@xDFocp9;
zV#z<xg)NTOzbX%H{uy<Iw`(8d53E<R3ZJMl(oOkZN@%5Vwybw$qj5HsACEf5^m<#O
zHPGsm-Z7SFn)OaLPm$}XHu`qvGtj+hz5BYMOVPaxh#Rfw-k9FWebFr9M%`dqKQxsP
z)D1G=>e=yg1vGSFd@tJ^y^;_lK{xb8Pf;FaS)!SQu4d2~KYGR}(?jLTqfN$0>z(Yv
zpY+cnsr<R<U98v55?uj3l-PSoKNy|X8)c3b5WVE!5#`ZD=pVI%h00~t8_N7@`2$yS
zun=FSGIC7$-b!etF;Ui=)o4tl^2KOaOs~JCMFZ8Q^txDD;K1JI<SthmgFEw?XhT}>
z{%+_}v|$19Yb)9i(>tZFg+=^YHz@CirV`WY23c@D;PJl&baZ`uuf4ftB{3}tx}mRS
zit-W5(!wMz)C`WrADuBS(L?3RM@`1*aJA@L(|Zqdi!ZT>9NeRPB!(KbgO9rNJ?jQ1
z;*TnfTd4fI=qoLB{r%yeQBUiPMUUn_b|eSY_)L}2#x(4ugjO2o$$D2c8s|~N@u+7^
zudijR26}vf;PYp4PY{P#IHjTe^W)T%;ytxuj}&LLb}m}`W&g=?>v>$3e7ege7M1{y
zcTUyE*Cx$#DcMuIZ%@!+wARl$xD)(6$~Lw2745OlONr|*_9ea|VG=`)TK=PMwr3rG
zBHmUZ*-WwTqEEEY_4jxEjE;flJ779h>!b83lQ1ZlYM_61?o#y6;hJ{YqGQAYAM>2m
z#J5RML;sviA|5UTG3#^vs9kf=eVBk}nNtoePZXTd^P|!P5#~7o#7&ZaNa>RZ{k@i7
zqC5s?-R0c*MVP>@Zw^8T>-cf~&`{#!2}$<~;v~u6j~^?PB%5{xDWRt%BGWDwTKgiU
zvu7@yP}K14@ncOAksf*pKXw?sSEM{vB*8m(IiUB_1<l>idUSG{fCX2$(sRbs@ys#_
zm)g~ePOgDI>D-mw-)<ck8=Wi`1en`b69<!^hW_?UA`K4Ar9O8OwJQ#7!USV2?d8w|
ziGuTb{`54#RC9X(@f*oMtjtV=KB(pIR6d0Rn_@V>0TVd%wIjs;>iF~ep`paZ6Ounx
z5En^)CH}NfvedLISP4BPi8k%BfonM1gC?5WeTmH^f3NbX7<yOBf84#xI%A&r(+bH}
zYS&%#jTXB8zW8VBmn@vIv7Oc#<CVehUu&v?{@E#3^!ss5Vq26g7I>TeRujcZP(#08
zCNT%D&u;vzNZE((iWiJA!;}Qg>+_qc<k?vKSVVhG#W<XIR+6cQE>V^@N_g;HP-2?O
zHv4%Keq=?lvOFHzuC3_q7Q5F~IOFBzk|avpfr_=zwfDu>(Od9yD^>nrHCgdJUapoz
zn8X1}Xr&}iCdhA;<WXV?dMic{W$~+oUP=)#Ej7UU_P)~HbK-Spsc*uQEX_R4)2@Gf
zc3bzKAA=9m_6kcD$4^*f*KjaHpw(AIqzU}ZHGYJKtSDC|B|tlCD@v6~|GgJz$#MNP
zK14DJlNj2et?20%d(>69<4F~gwUqb{s@Fnu?~AXZ+5dlWOhi`fz&lkEcazvx39XdK
zWrEyBiJTHAqS-Nm5KGN|Xnl&n!%{={NRfRWei>Q+H3|~uVSPa8LDyD536Ahbwr1uy
z;S8V^kV8OoRNa{fePpLmt0RDv<tZ#TMbSZ)7s&-M#Y0<}ntP0naa_$9RRm8u7j)dj
z-29;mW=A`A2nZ`2oflY+uvHObqyYdXKj<@B$CtD$2UZ6cJH!@7f~+;<FFfdZTGmQ(
z63|?;>0GBeR>~7{kSv6p#MQ*nprK@4fYh{ttOJ_;sxvfcDyt(%4Goq~Wp%Ky-?x$%
z<-K15&2H5h1f~Er)K$8XFWeF?-3U4)*zbsNIz6irdf7#2Lw^p)2{Wa%`mY^8M+_DP
zU@C*|<Op?aP2@PC06h02j{r@DIxhj*WvBU0org$6J%y)CQLf;*54jY;B!=E*Y925;
zJh+<isyx1Q9q71&UGj(KGCQtf`9QeWQIlagVxxNNB%KIg@`L_G>&T%!w`X;5uza>K
z3_Q;wTX<Ig4*&rF|7_WLR1;U<2k^;4AR)4^E(DMe3?hpUR#GGbqHF>q1_hK&MHECU
z5Gz(m!dkT|J0ix6iaJJ6)S{wR5VQ&?APu;eM!_IdO@nBnWAf(uKF=TTdERrF`<eSa
zgmdTqW(E$w(H3H{7h(hztKp{yLwL)H#b#jUh5SsW5l}N*1fyC_r(4nBV`MPUt=OU<
zf}4z1bx@=tAOQ@w;E5xqLX|lZ0CnGmH7-B}v3o0V)RfX~3TvotTxc{M#VvqWh}J16
z5#qHQ4txw<xrE9S3TY5Rps*c9KwBix5=-$y0wH!NY(T&qN!C?B)EYA*SrgHqfHLhP
z8Ub-4vdM6<9acsLu7Qgq(T-biF#+=;SX0mrIxmh0T!}i<d1T>UHT>D|`4R{-B3KhZ
z6ifupLyx;64^z<N5U)zOmxwH<u-PJ@JK{}YQ{X$h9KX(gw-)04BHT*=k*f%3i)^#R
zc6cG%Aa)ddhkz|4S=R!uT4Q8VHH2COlwA(F$PPy>$ULGj+zX*nfmem$hhb)+D4d9d
z5!qCjX^%CKflcs9JIo5IR*8OHR1v$JSnZ6)K)k)8@GxMv0q-f9J&VqpE)2IsHbLwM
z@JS{x%YfYpr$N{+rVU(?55y}Gc0-6gg*{sYv_;}AvCUpcJj9NG(+JpHQgt=3(Hfgc
zswSb?|5;=<nP(#G_D1}uz*b>*Jv>?{>Lww1M7AkBYLDF@1DjxLJB$d$D*wI6SVxow
z@kAnaDDaj6?;%-gN9UOf*%rtWNO}*pW&$@FNN>Z{5LRK@@b<lQuLWj7h$W)obY2({
zI1lZ1MMhK5ZirVWWRs9Iigd0B=#E%Zq(nG&mt&S-RcsX;YlP9D*i@8l0o+E2^%Y4e
zq*wz~O6FM$r9Mb36__BBdLzD&^fhVIm+R8wWa(0P5W=RDVk?1%jj?M~-Xc4U1I4n?
zafl}tNh5$SXuLvE282vwggzUN)vtUSQA&V)?XVIua1HDmi5|WM`w}o$!XOzvOy{j2
z0#~95be^#=Ljyn6o|C$XGRzSVNO}iuaRH7JrCG#56N+>i+(N|`K!Y35rxw7=#KBaQ
z1M%(}4s17#)jtEJ!f^<hMUl=H0d0{)OKgi5k_bs7U_JqxM;fdKp0marNP{GFr@nMQ
zVfxbTB=by#<KD<3DzH^JUJp+dipELEZlcr_p0dYol7UU|G&_s{`RYseVzIt-zK$pb
zk_koALxJrEvVL-g9bIN7oNj?EhBEHK)0n`G1{t^E{Sa2JFP#G@ojJjmh%TkeLW#h6
z=<lw`s}%HiNOnj#orJ8TWXu%--4RPl1`&?bm+ljyFI}V&MumJ+QCAD#HiECO=rD!k
zYk;02%dCWleUKGYV1nqdH!>f}(3kFdslId>OW_9)W>5011lAd2tyG!69p(r5ve4I%
z?1<=a1n@acRv=1%5MxHDZX03@Wdy<=5N1GXDFYT8V<)LHA3KZ*wYZ=)kgP(K5Dpxm
z$@Yp82*_E1@WZ!FX>mqZLLdtRb{mY;!AV|ahOh%64;t|<V~PABRU_PFkNH9^A4MNL
z`>s&XA+l_`FkwEDNd;aPK0O3y6^Ncf$P8iz3C^;^_LG5)aF#vh0kus1d;eRQ=w(P&
zBYGMR95Rsgk~3`SG85rbbL4v{<1YNx1(<H|`G_dM5bfLT__b$JLh4tLKlnkrdtpfg
z+D916vF*2Y?YF%JCqw<V<PQeWZvAN}>Isb*yZ6`9KQN))Z~ncNpDTnn$*8COSOoQ3
zOw8CyY%!%|n8I(V*dnMU9sOtlyh7xspeB&)*1zvdnMlZi5JSqiqX=k=gjizhypRxR
zJQSWqz-E*9RlpP0m?eo%M5F$5Uq+E-R3XP3VNrptLQXv_E);P{NIG$x4vX!vOJraZ
zoM?v`L;Qb4zs|UK_BeSw2u_4BV-mj{xX&0nOO@%LL3fDHM9)F8YSFcD;2=%5Uv!Ot
ze5Zd{7xDBD>vzO)3jD$jt0x23z%L@vcemgd1nheP-w=IAmn9N`D^Ul!j3nHt|1Fm_
zqA$agBkBOj3Pn3Zft?1jKgi?ubeW}arv(xXjd#I|n7~a2<9FcSAguO3kAW>=iijrB
zWf4T+JoNlB^n8KnCJ{YvH0BO{-YdFU0VfmsSFJ?<q|0UqcYcANzB{IWIqbAVwnF0%
z;NO_Qx5V*v#3?FeoCNPS!c3v5R5ZW>c!4;ThTeo^kN#7HTH$9Rl1v$Q7XfV%t|gZ2
zg>a$q5cn&EF-TLDKuPAOetekx-eG$3@cB!L!&?^Z95{DO(>875+_9PiueTi2eECTd
z@9<@gT=`l!q0>>0_}%#Y6LsphCp_kv`#0Na!`BZFM}$22^y%VZ{gD0h-(P;p`}@^K
zq2B@CvFQ7{11I|ZopvoG-B>uzm5dH(Wsv7F|Ko%tpKZY;+42taX~_JZh5EV8x49~p
zu`xn`);71O37_Gq`?vp?HFnY_`bTv7s4~}3x;)GOg(xZNpIpP8d2gY@Wx~KzvRyD#
zXp~|G(bozCEr1t^^w(3{n`@Do?J1IAiDlv75wAzst)%cg1e}^?G$-W!g;LxtU!jz<
zeyI+!6i<ox&G(i1FRIP+_cs>4Ou0E}aj#JG?vLd&3@62$jD?5Z-=M#~wM&s^qo3El
zxbT<u`yIFTpYY5}ye`l9vO8|o>I_!RQ>TnG#fJH`1*iS`OCE3dZ032iHn3;y&$XdT
z18zsmb7mYr6%ZT{Jk5Q!%1QFhFQE^A<oEVfI_8&OGOn1oactMW7XSA6_j$7xzxid6
zRqx})nqL<2j$SD3u>T30s>nFxp-E+HvJ)y(t8lN-d^;9*nJbrG!FV06HJq<ubkyLc
z&KicBhT*7TEYvX8tGKX=8&|1&Sc4yA=Y8G!)#&@@XOBOYCk<{a{V8_Ak5^YQFLeGU
zee&bgK3!!U9-SJYWtHR6Rd{q69(@Fl_R&ZjHIl|I(<@Bw8s>0Vrq7WIhDn#HVx+WZ
zq;#>WGqLNSS0%&z@<_<fBO!=twxh=U2yRq|8-?Z<`D)7bxpd_F%*drNs@YDO@*{X?
z9UdB*-{7uUzCm?Dzg)L++$}uc%7wePlEJKG7<3)H=&HNqp^?O@5`T5&u269otGGET
zZqJCIWJIu?soPhFd+JwdTaJ5H;htr<=Mmh~N0aQRNp9@YWkhIKRo~F|JW8IUNp{jC
z`)QKXRBb`3wrdrPELSdPbJszeu7jsWLKdq|_-P*cXdaf~8#7hw^!f6xAOAS~%dwHW
zuxi~xjkk}+y9~EmrCRr3<Zg+F=7O{4LKPktnm?DtUFpiTsbFMA<{$CUY-4L85-PV<
z;R{3aXR^3au3VD}h9W%wMjfthW^$8UxJN4(rd<aWBX@g7?k-lnYU+yC=YdQ?e5Q}6
zLIQO~|24w8H^PEdmTS7A|5YimyF9|$JHm=lSvqO<9KnO@@Ziw=<Gz|OeST(SD*5BG
z<0Gs<RpmlWn2#o`40l<js(diQD)rEGIcvJA@b#hjJ}hp$E7!h4vN<w;uZLz1TXQy{
za!wU)6`D_DahJGq4Jsrr!}FzexJ<v6SQl<}g@o1>Jvwr_d*pPGYK4A{mzdm0rXVuY
zXMcr+(iQz`<aF1_=|I&V`Za!6DRH<wa(ds$=@qI!oHTEa;JI~pZfO2BUyc3ck#uZi
zcw^)SL^a=0V}Asv*WvWg{1SIf-3HbC&Ki7KIle4B-_?a%St*%QDWP`t>5JS`gU|Im
z`nfM%-V$)h4Uad|&NUI#&;>R{+#YM~=K1)ORAa$qBf)}V?u-t}19@MKyst!=zPeMg
z&RB4Ok-w~|ZzfG(Qp7Fol+5mwkmP;ain)*If-R3bB<>xO2zg(zQjx9BNmJ)I;jKeT
z#gh(+qV&8VE!&}(YuX{XEAOk6_Z2D?tsRoBCER2k%4#SZoxG~iDz=^cmFp`BI9P8g
zx%)uT_v&?z{^(R}n{1NY^=Kx{RT8o@ciWh?6QQ_v$k+w=7cp)laW4JYShCwvUC{Ke
z#;G4XM;^8z2eidrpKTLDbk3{Q`*7vrmVkY3_!2X%vx%UbE-)`@yJxLkJ0HKJzt#&z
z0`KBByN=}ha?cvMXNl5wb!YNgW5FKAO>OM&Oe?L0k$_s-7F^Os?nr(~6P&Tv4tUL5
z6tU?|e0W4(Ox(^I)xag5K1h8NpOLt;<_T1zfks;bdW=%+p}FgXX%@g7!rbo&HKpb$
zeuTL!;V9I6gisR!d`@fbpfq<F_Ot$`5#tDuyIo2#8Mp>=j}%s?lH<Z4cWMd~YFsa@
zwgCQ0Y`jQlR1w&lcCR#VXG3v!ptCN(QDR&cvC(99dj>Hs5;{vr@g+6Z09&k6_D@UM
zZ;HfETq=Qvp!VsMxY-1tZF_=cN|qgA$f7-g7-tM++NU&;flbiFW@uuUkewjmlbcPT
zA@6n$71#<5)k71VM$Jc|A<OoiP+T80!31tKc$`9d{1<5~Ib;}yW<V(<(&jQ?p>fIy
zYP0v|T6D%8=Gf9}<QGQzQ;kLLi5vfW+Ek0yZ<cRWb#85(dJ-((TA=)Ho4S6zy513w
zJg5AwUcS|2wYq+Zx_%D+z)ZWrL~w~Nm|xWPWV+U7wR$zKtlzZzGNNAXh<nV`+SqGt
zj0F4K@um&x)txrlmFC)&G=Y0jTXp9!yK|T(-`Y~r_P|EFfQ#ECNV2T73ycIaO4}k!
z+NO03zorSU+iO2I7q=xAwTU~1P2^h@$}2s}D~r|7n&j{Gd8cVx+fce;aT}>)_?G;A
znf$#_`Qz1&;Y}rN^M7Hz5a$lO2-EY!z>6+Ds)p;9QP;k2V!cRQAWRHsKbRm%BsUvF
z+r8W8QGu<{_Il{LelzQ#?UwCZpvMoO>r7yl!Q*wL$FE4sWS{?b5-x(8O9>xCfp-m>
zACVu=SStLD+*}KNB(^6}9=j8O?(G3H+5;FV=Z4Z5guh9`-Sp;YB5<DYt82Tqxk>ls
z&gVACknU@<_Pt_C(6&bRsq=H&@HH)?xmeI{DkvXPK*a*6gWE1=l*t)FrRmiU?#2><
z*Je4xO3r9dng*#2{qRB`ywFS=n5iz+=c-Qbi7CHeIio;nx=mfWUR~;lFFvO<t(P<O
zH7i}BE}esSnrTx_bj@^~SCQcHbglVnbqKEP%h-JYQHMC<vuA3}?X~7cx}V+g6C2ba
z`kE~_*Dj~&+=>KMom_S&mnLVllnCzIXuY|+zMd_*>xQp0(|Vie4$*aXMS}a*+HLdk
zSE<Ijt46wo#e$g~++I1OR?a9@9$ekY)#pVFtw&QIm8K&X2?{#7PMutWT=GM)V1TY$
z|G0xYr-K_NmlP?Zv(>CLHOmRF98yL<>EMo*>S~7+R>cBZ2ltL#QX!WVD5G0DxLG9v
z&Sts9MlLy}j9#oh?T7#2ga2Ws0B}H$zulCnPS@ue7XE`yzbA|35|Og+2X*>-b-E)y
z|D3Y#uv{{2wK{!?I(-g)$xIt>qHCn<<`xNtrfdCHs};C%%5#<Ygt9MCtyqZX_~1Ea
zTEA6l#RFwusRuskj89r=^Ne)<rGlgqfkOv(>oi?~2X36N-qsRe>xLVfX$?$t1#}&;
zNN~$qyJSATPk-&ljdae%0`rcxd-CKed2*4`GoiC>y|J!>ksr|1$E4{jiUfN)+gv)^
z$nxauV!;!-F8gsu+uV+}W%A?_rDu-1HcegYg!c?7&+GG-rOC)dPH{&YQJySUp1-F&
z535(Lkth3hwoSjRJik|YK1RLD2|qhi8*8tPHPT6a@l1WLkv|&zyyk@Re4zT#LOjz4
z&otBeu2MgGpgga?v<YW?!b;0G(s4=!i6w$r9c}M!Bo4g4_2c_cmE`)y+>cK`j6GGY
zu+crgZ1n!+KOu4NU&=Gw-@V?}`Q`qUX~2@CXERrSw|U(}N$veV&W~*APfXp?u0NFe
z<KFd-=R*DQ!wc)zr~I1re;t3&nKbU&<@McfaY^L2=bwLg*<INBhG}7#^GC!|Fl0L1
zkMt~Dc&I+frl;ZNolkFDN12v=NrV1huf3}|?)5$=Ct}g;ZNXOp_VZu;yyeUVlaSn=
zo=k^_9!pa7!}&6?;&NBcv#VhVw{(ih;gTzI*G*S84GovX3+mIqX8BEQ?QCqzO3Z%W
z+&im(xv%HVp^qkG&z;2IqdBGgccH+$CvzUjT4yxo*yg^g=uPZz?cw}*5|}xtspM<P
zvtlPJHfHI_Vs4lsx*tSU96>>^WS+QfnYis2(}tkM%)aCwI?uL^m8=rnns#3Maz@fu
z=GGlkw$GL0=XKAO-6NX%JT1i`_RHzd!<Pl5zTw-G-zo72{(^|3Z6d{1+rCAWiX^)o
z?+AU1UbY(ge>$W%Is$C;|5T?4P-2H`7ia#&*zwM?Z}(rVeg2=A!1pinQdIs%NzWYG
zpMDe$T{djKyy&l%x1u%Qg7#~d7p)hUq9-zv9Gc!P?#~P5m<B4GCj6^_$08KvXC~d^
z6y{_8&f*Ys@@Kw781SBS@(|yl@PO3*3S&2&b1+QdJ?6hbd^ZNT{f)mj|0sFFpCD#6
zOp<etHuqYd0mku<UhG`~_LrCW#VYq`g?^IP&51q<93RNrFz#<Wlt<z8g(~dF{MU)o
zV}O^&{nNz?u)_SNw>kZJQJlU&h2MmKEwD90QG907IZk0PcEeF@i%u5slR|+V(#Z;b
zQo#Xf-sfHi&p-w9%?+}+wsA6M95_$B>QwL96!9u_a&K;usMmcckI4s~?ads@o5qp8
zwto2ZCPn<HVRCwI(xu+aGr;S)e;(p&E#Utt?42=?N8)UaQ|y-k8#!C!6&_>Q;nO;^
zj~-(;nBptwWDWn%aNy9%$zEBWZR4a#?w{qo-}mR;<-BhIrVr-zaoz`p4BoIvc=idM
zJevDwVed~vd7gY=ZLi@9Md3f$|KdJ(_(Hld^DFEb!fo$)Xo_clDBR`unUHiKzxn3O
zulM{JBK?o3NO*RzeX@K<0I@IRwZ<(EXc#ThdG83YF8I>}IcV-Lb<N`~S7Ouu!7g^4
z2rmd3oa=88u-GBi#$S?g^kd7$*#GBSX8OyQ9sNO+S-<n=xM#e`b6HZip#`xgS|Y0-
z=#Se^Pi54!G{HNDsHXZotA6;j#89kkuyn}nxD>VH4Dfoc^C6CT0pD2|MIP7#am?db
z1u|eG$2^|ptlzU$ftfSRbDb-qg8TQ}<CvcWjt%TtKORgQ+C%1)hq5fjg4c>eV}KXO
zgExrp>2HS5iUFxJ-?=hsegB^Oobr>vzX$fL9S^1s?ICiOhq7p6!Kq@m7~qBR;50F&
z|J2d#>4vf8oaJFG_85p_fc!VX^ZCaOCW1-gjSZI5a*tn#`qvp?JpcHms9gR18h!n3
zp)^!H)?hg+7er@(*K^k%;&>PE*9xQP1A7P@?>JV84A{u=j%T@oyWxdpP;5igvVlER
z5S@|%6FC=_iQ{f@F2F3CH@Au6xJJu}ao|ev<3`IFxx5EwkG1Td#<>v2S}=BdgZOa_
zaQmCv-u##3iQ5G6!Ujvj+?UN!GtU6y_%AO;tpRJ)t=JaGn)l|mf%s~p<*ISuJn@cG
zQ8!Y=J5bAmxi3Xg{zH3MeBjxrT|;|7$$a~t{%$B%H&`-qUtWsZbq07n*WwU|TEMpu
zMiB?XAPzN-C6WOfIn;QTlm5aU@iObpaxE&Ng8IYmai}MOV*_F9$6aVcVPwvpP?q_a
z%UW@84DjN(%Lei7Z<~MDOuzYi!dTv8Ac_HQf8*lKuOLsj5X3GGmE_!t<|vCZz&L)z
z#i$tlg`KY+S}<qKg(+@8E35bw;Xv8R%KNe~o5o6dZbf;NPk-3&oUR7ohQY92P8WEl
zJX<bzao>7n&Rm}DDfT};BKfn<_kde#tyn+Uu659-Z3~Z&B&A-DqOD*pX^x`xhXr!x
zz$}A_hB9DrEQ>kO0AA}`HfF6ThzcJFqjKiNvrfu@iJUXb#Jp6sk(2eVqO!dKL7@f=
zr-qjY&0@Or$E^^fGmZNBhNH6f6B&OFCp?q2S03IGLyFFL9p;e-w2hu#$%?ewF#ttR
ze;G#d-*kwze+1a*zp0Mpp?{fwO319Y*)d=do$yy!kN+knaN=cHx~joA>Dj=or!@zL
zF6TC1KKZJ}L%il&(0lFj$#n4t{Z{`O(v-EcKP;N_CXlsgqM;V}TLi1{Or=vCi!`?0
zQA|fGMSP!7;4NuoIp0VBsyw6H^|5ZqZ#I<Xg8l+km5Y4Bfe#I;y2#yD_!M!<uJu~l
z@j(yE#w~R__&qMGt}JW5mUi*nmb!Si`9^6Ui=8)#=NBRyEV}7I`sk7sFfk~8*|E8)
zX5GY~_)s@vqqNjxb7O!PXlZH38Xc<!ZTFty_tJvm!`$4BKokSyQ`6=bUo`N{ev(q&
zvvl8@1#u%6|8cI3ocAr*kT`O2KC&I^en+}9#7Q?q|0Y+>5`u^dye`Z>1p5_;vLVET
z*iC@_?A%Jpz(&~5-i-x~eh~foeJpmI+#Lq{5!_g$(JJ6+W4BsrmAjprEi~$ku7Rrd
ziL%3hJ+!KNQ8o$L!f+D}`F#hCx}wh^5Jdo=8C2aRcU#h{423E)!~yE=g!5d0>kPVk
z;5>rcdDE(di6gc`l?9Rnfrts5Akw@=K^;oAFZrBB&=}hZpk_M-CozlKV}pL4Vmnn8
z2L-yxY{Sp;O$?497Bu}}L#qxt=4dr;(Vb2kH7-N~%(_E@G_V`Pc(f8IiFM-|j~X7s
zZz3z3a`Mf(qk}YoAgTqnMPR}?JjWg7?$Ew9goF`VyYnicZ7VVRe}f6<Rb?U?5ea0t
zT_0+7gsffA0*I%N!h!t;ynAG}6`f}!q?sd55c@V<>;hbGz`hSUhs~x9U)#a|lT(Ro
zI$UgzHIspf@RDVy^DX$lx`!*#<8+>taPMc>DM9gHEks+y+Y*cOLcAgNQuq#p*^#U(
zfrqR?zt9kU8G!gU<@{F*(HJYD@|^83GF0t|T0p!4QFth@gT|}));VN^>N1%G%!N=*
zMl0yN7$R^U8smzbN%__`6owO!ITSWi1awC>QP|Vqle-<iMyxzZ!2U(3rl13KUIGy~
z5A|_H>Qd1EY96{H@f5Z(oTmTSPb)$5kWg)aUZnF@5`pv3Y*(Z;1<i(d2ZY@O#E-&e
ziGc1%9tHFYccZTp6e@^!R0!IL6t?HLcA_m}V2K5JAqJ2XhOHrtNQx~37Fc7>q*yY#
zHvoxf%2@(QLt$$Ih^m0cjj;+UZ;l;i0mV9_;Sg_+h#dy(qVej!wF()b0%A1*^C84i
z&~7>}o(P<WvR#qt6qF6|iiJ`LbQ7ILKzAgTBBjBxyU}wA3Ms^^7D|aAVvB&bh_5A<
z;00QU|F?5!jd4h^hUj=e|Bnd@&^Z)JNeG`JohJg?BGW9frC!K1NE!(HLKuZKSOzSy
z##~9DQ5eu~)szznNyEPN5J`hoz*ELp4VC9^huJ`b&S(O}+b7Bh1NP8(^`Z<ClEv6~
zV5oHgH0X*xg+LSmd}hGAOO{&Fd4|GqGh`Md?S%O*z;y=Fo^O3Z(_i6<HMYWW3(!K;
zM@--ZQJPL1G^R)m;VC1`0UBI~?z8}2`X2xQ0RR7V)_XkD{r^Ak_h!zgoYLqrQp`Ez
zP|16!93ty-R+@4sTrOSdK;^w5LNs!YY~&P*tD>_Z$59GVx@w}ua&@t_YMb}A?{;0E
z|9-dMZnxL#{(L=NulH_y@AcXN`T7`D00c7R!y8ZER>yr;Y<2~tk*3tM2#2lddKW)d
zg{aPHJ(lC<M#%8`ZzG6DXK>Kb8Nl_=gh*lkZ6jp|RBd+m%N@6pJ=Vp0xvRQ0OQI5~
zwfmZj%%-p@N)8!jQ#p-z;|liz$>3^0vxaZ&-f6R`igZ00d=zG>ditR);9x=>1f<bE
zsc&Sb`cd(k*=AFyM!eQFcfUv_hmU4cyZ6_cY|XkB+Jp~SAFt%@msV>LzSw9uRdVrK
zhBPwIl3I?p4`>cs)sB}7Xh!?h#!9YWYsZ^3;q5EjpSJ}xZ<le9r+#*QnH0YG8JMaj
zU6a8l%f(x#OV!0IYc=oLidP2W-EdYwv#d;Kq0}s$<}EUvC~BGOOG@}+88CH~6pqC2
zlZ!V?m#T}m&}t6ainjpb_uy^;%{nrjSEZKf3`ZHNlUy)M>C<o5z<Oa!h0aj-10tno
zzoEN=hF8aCFHNNPOQ84t`|E?J<+9Tyh4fKeh&n5Ihz3}~>a>>bv#-A}QV)M!ZrNoP
z`<`<9%VE1##IUjSiRCz(3*~V&%FShpffn2FRzS-hTqn@HUgq^xsbxCNjxw+1sI#sw
zBN9K)0)bVeco}@6T#Hq@R9*ZpTFv{9Q+EJ?mq=d#{4a7X#_3Wm@DXw?%DB^MhC=e+
zUy%3+q;!OCzKxO^f&1=DJy)Cl1%cm%Y>~%(-_TrxlG=v*j+UMsaT4{oZD-}O3_cCn
zqAm@)QBosts=idY+H^etFN2H+aH<=c(@|2}aH{BLBfx>1&IR4#6mY7F(or-uTT|*O
zgo9nWUY1-u3Rj@etN}P2rS8>~dI#wc`|oj)7X()Q{|=E}vm)SNL^T1XE~a1elG?8{
zRg!)Ui4VYdiM2`^fvFObbR-vV{%@*_uTa!puZLA3^(jcZ4Om}f76M<PgRM^QLty`s
z&ue<VQ4RMIr7h`Hw5|UQWv9ka@$2=P(SU<7H5Qo4Prv3Zbxdih`rng<!PYt^Cj;^O
zanBLbBUmo=p)$4)m8YPpjlgN3q@9YkQTiqT+ov>@ksc1<l`+^N$K?O#Fe+mwP<bk<
z+KRX$l(bXPHcQ`xz)mPlUH$hsV!R$d&(|x#St&Me0Xn0pWtvh?Av*2S!zFK{Ebf*<
zvkuUClp3rl^$v26EnXYg!^c&2R^9-xd89f?mtMD78a^b2SK)4X$aKn4r%_XSq;PwD
zf}+%e>9bq$`at}GOq^5IflSS2RYWI(>Zmfc7b(@6+GT=&_Y#+gXtqLh%2K;jrh<`D
zgQ;g!rqoEYeB74K%6AC-PGr11?(2r;>nN#*a9{nXKWfuwW$@>b@#?s*=;o&=skd;y
zY-pANPOqlZ<Lu7@R5jETg0y2RUS3h^1JaIbxL-VEPNS$-P*WPD9d>w6MXBNGJ8bc$
zz?V-lK~u5+pm5g}nzew_N2&WYrJh8bc1+)KN$!gZ?z&>LJ#adf`a)A`7xFY;jHuig
zaY0RZIqGo=VU%$Ha=9=3DB=lbY3A#^@TllfL`gP(`3xKCY+8wL43Rm25t*i)gIpq>
zlAjXe#6BT5S1xRgc=}+z_tf|K$xPOlv;^0R+erZ>4&r5u<=4k=XU~3nw@h%EEtox<
z`Q!bAG^e-S`uA2o$1~pl#@K~l`=>7LY&_$a*|Up3-p8!{^RjzQd@rfqV0i6tboB0L
z;a0}t_p~MfGio|+$sum?$JZo1ot>60^vepZ2ijvozYb@AJQBY&dY^m?N{LP>XgvHi
zXH_pLU`jz*y>)qjq<H?OV$_sc(rnuiEeB1VpNwyvDgmEPXY615J#b76e|i^o{`|@V
zQRe-TOO=;`lRlh1|E#-p@QHY$<$Lh?f`<pb|L87?eERegvh99(M$ftPH~l(39NvML
zem8m?6bLFj2^is0=F0TaLYk$44`wBRj~Aq{`#o3-Td0>NJg*b;FHI~a=G^&Ayxw=`
zpS9WPG{PQ@eO2}CJH)w+&h}aEb4kBL+`BS6v-TE_SUVTjzcL$gUEKC|t@7;}dhro~
z|BCw!ejEueQdpkH9z!R(mWL#8ew$H$aYop7?6IheBMjn?-}4p(@J0A;uzba4^yejx
zFoG#x!IVc?fVdJ2jwz4hBMw0%OAw%|ca&j<^(Sy|3a2W5HaLF8@%Bo-jtZ7!KI*@c
z=Q!1=moRc%*L7>8QI{n_rE8}9?_Qaa9(ud=Ck)>d%CWPzdHokezb}-te-YVpAZoDI
zVZ#YIElG_YbI#l%_3u9P(RmfcTzk}s>~$~J^`QHlJvK`{I)J7-dmuauQU&*671`?A
zi}u<lvh7~rbEQ5ykzMKhj61H<G*W$-qmntUqJBftq%KHWF$HZPCuy<5vDFjr%wit&
zc{TXiRqr=@_OZmS+TZLM(=5ih`q%8o`^}8UR*f^R|GGCPfUdBkA)h3{wIRQ-sYK(1
z5BkWihWvY_n49#bX%n<J)6<<_bO@@q1U2d8Q>B=gGK@|ej6DEpmttg@o`3KU+<~!J
zkRA@*y9FN)IxJq_`YI6GR)TrX^c>~fsD+P*@NHxHw!L(+26G6{x5Yy$<rw2paylof
zjX5++CkHVn<BIbeI8n85s5KZ|hEZk?J))ECN6E^;P&F33LMLZ(79POPVbI1B%rPtQ
zLooEjoZ?m$?NW+SXAULv*>~U+EchV^$_RtpJ2+aq`HF!MvV_vZG#%z>QDIa9Kevmc
z6_hI6#mo(aHkD9@nWl7(RxP|cgzp{8_wJ?pYcfp_@V)VnW;tc^sDB2hxQ%K0tzj|x
z0XHzJM)ZR%DXM+TYl=TkB-;_r?JxVUyt6!!oX4`?($lc0Em`1RUK21kk*p+HQ1oA!
z_kAL{CGm)F&<0vuv2R0`t<L(vz{48?n0*yW%26!|M||y{`73vAZOqNGEm%LeEp)?V
z$`RjU<tRPN{J7~X+xNlHBlC8eH+Y@ye~B~s5Iz+K?I@xAV-7yE1dT)a=sH-%9F(Dt
z&vERd`Di?p-3j|1<X5&_IFop_G7vH;p^Pw((K+_Dux|)IES4YEOCQ%{9y`Df!$a%K
zDO*OzGdOqKn8&`2L^@WhOjVS7RGpC&v6KIfV<mBy3wkWOxc9f2k;p47d(%&scPG#7
zsoT!o^lD>D(Q!4J*EY{?uWj;&H(!fND>{BVF>EYIdwZw%=ZQNN%A-fEZ7x4N88(&`
zV>{Dn`ML7#qU^!--}>)Vc#a-5u)Li5#Pah<jIDavfXnioiX;n=P&zI-v=sXICC;~p
z@P#nQwS=-_PV2Fx_3)yE_t3nLmaDGp7jfbj$Q5P&iS;S$foEY<11Fbi*)IxC29i{s
zElF=$vUF!BYyw%y3B{K6TxBDn`+gd}k)XiReKcWXH)*4E=B16Myl~TwCEZ>(T8_G4
z4~I%XNrGiJ+M8hLPjd>PD%!S`pu*Hm<`3L~k78+Wf}q?m$h(8HZ#RESAf#AA=wp@-
zbM{eT%>;f!7iV7(A33{u-%a>eEUjeJrj%Lk&TqKQ86D${W|R_4=r%Vvqg2?=n&w+Z
zkYkpIjoREVCETX#PML)5XO?^LnTMc<mb8s@o3o{aBV`1QHdyHZBwI>AFhfr8b?(4Q
zSXy5=)Nl*-3F<C%9Pu%yY0}$2aV%o^rFf{J6*j*Mw?r~SayhNdusN2NH`;!c8REtd
zn&z}7GDBK9S)Ja&0sPl^$f2BIHQJudX^mjcR4`{y7PP%31P|s6j_+^?DzK!<(cAwl
zBP3YRf=g{~``sy{w`Xw@9>U>akW~p`*_`&ml4c#sKV1j!FsG@}+ZQ;?(freR=z1r7
z?jZkr%M;PPq+O*1b>>Vm|N9;I9F`{eWM+mzne3CX*Ye>Lj?Kz~vRT^Qbn7Lj9$BGW
zH<e*%^Iy3vE8KffP+<PlmA%)8rZJK9iK`zYC@6$(SO`t*g^iK&LX$sUCe>v^S{u1l
zJSt<ey1?(m%cMI7+^R&TQ!7WX%g8Z+{~Qn5moqF!ld?Hg5zPA)%=?mi+*87EXWqy0
ztqwt#Eorj!q(93T@fNh8(wU?m9i{Z7EY87)aBvu8QNs9QPJ3=ivkK)W*1?YEG*x=i
z0_R;cKM@aAb;4&3^1n*%@vQp0oA4Pd?fPg^IrF{;|Lbke&N0r;j8cXXeTB-|Nrly{
zX&z+^1oLd@=*qoP#!dRnl*wCf=2>_C^+QmTB~6RIa;jAP-co$NgG0N_p#|_6weZRz
z(b+K3S*-YRCyeRh5SuvyMiuNvOybDHPe(BDPZQ!W&517~`tV78MlusuCbkddgM0Yk
zO_+ig`CE&dEXAfJ;>mER{1$8-beIyYTgs4Sp8bO#aR;`>(nf<sHg{nH!p1_ZSzbzf
z6~iQ)2;=J#f<;>-QN}2p)+UL+?F=D4+Zhr+meA_A<^;>mGq}1r#AgIU(Q{%t?>?;D
zPy1-IPJBivI}e(?1QD)-tLhi>KVk$Mo`I{j*+gEHig=i83(H`lctZl)?Dt)ze;zz?
zZ_?zgpGA~YTmJhec4tOQ|I`m2{C$T0CMuhubt2|(4T~uCTlu>>?0&4$-x!As8ib<H
zw^>BBTL}-BcHeLuIqXBzomgRV&&LR!7DDY7LRWiXH;MH#m%D})x_Z&blPkrnpKgM*
zY3^Dg>t`$XeW&-20D-U&0-G2%lPj0FYY{B<3YI#`mx!weaV&M5K&Dzm@+ATjn2tv9
z_&y@OVda+J$-)WDMXvmIp<AWMupV6UArAWzv5^9gO+q6dqQV4bo_i@;;87?lbPygn
zD0pU`hDp5otVFc69vow-k8&>=36F#bjAI4Hh)IkFi;Nc-7m5^`z)h2wbgpL`i#$7l
z31Y3q7jJCfdKw82>?Z~`f=Vp%qX~@tBu2SHRN+O;pTJ~thn$7Bm7)#xV5}eUuQJgC
zABKO`C+7xGjYUotEZ7PE@FM<ID!N!H+TFu7-7U~65uxhAUY7qb*VIs`m>?+b;+h5t
zM6;Vs&4k`w#H*8(5|+Qap!hboX^h*1Yy`JVQ0ll%hC;LbM4v`bmgOHdN$F|;Z%wGb
zG}-RQ^7jx-R*UZW67?o1XBxn$Mo??35M3lvX#izd<0l06c0#llaqya`%}N+n3Q-+L
z!hDG9Cn!wru^7SKLQ$KAaJ#+mA&E7f%U#3@w|fz<Oj3$j<8FfFY3^boYrK`4dC&Vr
zfZ$u9$fXIinWS9eE=I6yDp)p>Epn@;;aD~}fpWDd!<UGdAapd+BwKW#0n_AnvS@;E
zk*m91xTjLIsh%d;q7h%BS)^d!CgBzzqT&Q$o?9L**jFgJ>L83cC>S*tYA0SDEfLw(
z)5cgfqug>MVN8g?B3595m?UVh+VKL5LXlDvZPO$nog31|YM-4T1hI}CFFw@34KWf1
z?I#8`(v(>3k0uEAlLW~YUGpLqOb{};GtNSXN|9bYO|nJr%S4ZSXkJyHb~Mn`SnbJz
zWjo<%FXH=BQFf(hZx7dLw?Mx{Bv()CWhD)BoeYJl34*FFu2axC;b69tnb6ORSUkxn
zVI{c>s%~@dk8$rK8);i67<JtHhC-|T#C?r4SyocmB%`Z=c59;jmB~XtR+5L{UA3so
zm#9C%IMYCjYNScF=$9gqS_4gnwQ@qR(@yw{7jfvC=(d$Gq7-U!9EtED>P|42+_N!)
z$AzNX7Q$Wj!lxwGN-p;&R=CTHNS<UAvsT;$=cl<p6Im;*Tw+}DUrpSfM#8lHL_#A?
zowf3K0^B+YDpZKly~Lymki=DY7RpqL5cR}JKk>^lQLPUxr0SDV15ts6IVregC-m?V
zzbq9MRf-PuaLKy`o+ToUdSX8dGr}bs3XKy4L+~^|DrNalLF(GQILxzyi)7ZVZ$qn+
z5L$-+ys!-0J~=IV^L?7HrM2Wuy8nXGb8yjr>DD(>$r3Hel3d9WMahzW!8AYM9X+LG
zt6F@qOG7DJJ9seQFxsC<Pf@a1xS0^+V*d<OeqdLVTguK49<&cdkEg`A6k9By+wzZ1
zm$Iuv29rb4@nesverp?p2b06m<40m#7E9TOZs#v{*ws7^9#qy^+A|DZf)GSCVTNd<
zKo;K4RTd>L>2k(v2|W}KT8C&mci&*DqO;^_YW>zUPaM{Kv9Bj}#Mx$xR90VV%={Cj
z+;2)J4r{!y=t&)LZr?05W+3&sbNj#l{lEGVWL_lnrK&o&qZd2-rA9a>`Bpn2UYI4#
zRdcfc$GBP2r|nGD>VOY#UYMc9%BfQwbE!K&zh7fawrKR;7~D+O({_o^Pnqf%xsi<`
z>)rhpePKwlVqKo6Fn{hq)KyPaB?E`OF7a<Z9q`ETEO?tzXY0RBGVwtxarStRRzXS~
z!hhT6T$5C(y8fq%P0s-}OFdfGQ|e^=Pkqj{PL*mgPO}V&{vys<iE}~*8*}n}Rr4(D
z9QKAp$G>^9DZpbs&$r-h`><ViLN?LqrF`3KG8)q%Stm0ckH63pUhqm1b?^}h4x3#g
zZw*>vI$rQ<Zo%hUVEx3aKbzt6c+oCvagC+epoBOc<eDAky0?R4yPLlu&{eL4+{=s_
z=Gam%s3h<!x;VDNHA2E!U3}&`(4?O{!j7WzY>gn_5cubF-ikgW<EoiGSoia({|DE)
zq)y_Ov=r+)xq)O2hrQ!_raJhCcB|$tZi*k{9NN4f??_U=KstLb)zy%s4$R5O@o>ls
z0DyS_xNbwZs+{2xu~$UutR?X}3H&87-av@ydnK;@z9b%AFE$26=Vx6o2Vk<H$aACE
z7%eu=5f@oNmiACvBs(gX_a_#z%)wk<7`n=ia)U#sd6;+e#J`8cxT?jdJh5%RxMG25
zxj<B5gJ%ZFiG$={ETP{tK*s^HDmy9}eq#symV<exC)PR$`@_81h<C3I`^BhvVjmkU
zVuR^C%7ghK+l3*;_288p%%%CEblxA%&_*<<)=!Qq5Z|;CH9@fRtPAB=*xyLhv{4*@
z76;^rZ(4|s#lqtm17hEPasE6}jtwsGC?h<I8$8~|2Ja7u|00VYI*u=Di<5K2+lR!5
z2E`laiT~t@v(Vzpk!;#JHjT<7;9whPk*=Lccb!-{0e;ZM`$NbRwCk784`uQG*bW^+
zgVz1z<vh%IKE`H_8SC=suYAw)D)!t-djrDngT?=qHQ!Hu+XpGm?@N(1%BO_H&o&=}
za%^^`=tv?-gCvb_-e0~dX}3d+y6q~vmA)fe1&VBBt6s59M~j=ZxS<;=Ia-oJQ<B(@
zDz~8*?)qO?&0Serk`I;W@5=5qbzSQ(m)bpQn$9XVtoKK*dgELbdrT2)n+v6;zcw{m
z+l-=I>>mF)JEqucYQ&e0{w~G~q*_yUH~QBB?ekkQLfD$GT2pf8f}ZS#%@1$lOInJK
zP0{zDC;eRkzDF4g@`*M5r}Dg2nkxD)<at~A+va}ME`D=5k3ajH_;gRe*vzRs{<ZzK
zglA@-6I=%_So!}~E}MPU*Y9z1#VIA$Bq_}41H5cRcM-q<dYr6DNq(fH%!tS|3+s;V
z2IaP-kI3bN-93Wf!;xvqx}l74n~tk*=1tiPO;ew}-Py%Bc=JXuH=lx<H~nM4KYq|(
z&l37o12h}(S7H~RgzN2~Uvnr^dSIm$WCwPiIlsk0fnDqdM{fix^C>FxrpW{TzYqEw
zSVAW?!0iM6YV6`<_>&!UGKcb)o_Oa$cm?Lgb*6UT;4$3b6=%^|JJH#7;+-Mz%5xq=
z{<8RKj(FFA*kGPG&Zd>KX_t76gA3xw%i>H7SnN2it}T|&5z7pT-3G;odGTBxr7xed
zY0le8_WG%SmlCQ^1+02IWx22#NyWb_Eqnj;)bAm?lFsatcTfO8WDi+o^#+Qk0YIk^
z_1h4?%Avfx0W(FzEkJ!VsYFxiJ!JhIL_G&_Pk(!}8{j1i+}vPTijsN=04o7d7RAd2
zpiLwSFlQ>q^G3ob01QJwT?qJZnd3i`@tMG?JphjZ;64%sF?US2$Ht_`27!Q#NCbsB
zU4WN`fQkSb&|?!!nsOvfNnTrs^tIhY7&^$*mr3nZHY`vqG%>{KA-z0+IKWU<roKpO
zfsWxVRl{5Ag`QQWR)~68(mj>JV5C%Q(kT<%BND(;F#H8kFGD(|Qn()}HJHS8BynAF
zhZAeKs6qo^!X9@{QR-vBt^z<Kk<o@E6;vStu-l50Q<NHtfI1QI7a8r>pZTQ#BugTo
z=Ry=$Edclna`-qhTII(^!y74Tg+(<o(H9p1G=Dp8FMp$<v5Wlh@ieu<k@a9PhCtb=
zH8751+y4Rk+Ce5clo1{9E*ebk;8pH{$FxEF{_!!k{V1=}2#QUB8NacK-xd-WGPmW7
zL`mz!PFKWL`C|Qk@pB#UG8)|1!3*0BTWW*K{o{S?yTiONLuh>h+}6bl6Y^$5(p%kf
zC_3}Un7ptUxNRNSY5_UgLtT;VySco#SjaJlQm}BWn0?m`{%xA~Hj#aIjoljeExL*K
z)(ARtg%UA1uExImcz$u~!lJ@@@KO#XbAFM;+wKghp+Win@goJ4$@O3phL-K<zdw(n
zHNW_Yw><`~UI#W=K-Tuq?MQZVF7F{0vd*DgURb=!PIiM2P4gZmvXj@?--*^v1LLaf
z<Yf3SJLvZu$~zs9j0XKXc&WQ#7j00zfBYHy+b}QH5Hd)BpTK)h98NKIZXefZd|s{l
zLE*)6uYPap$AY<kXZZh{T`rirU~<4!h<1CFANNVWmp>;7xO-2yN+vNhjcWgHjcRqt
z#mCZ&ooR`wpMLJ@>rCZLa)#AMjX@hSd@}XZC1w$$(?zM`t1{}KfowkqiyOTGSdx)X
zT$F~H2Y@n9#4-mvJbJ^>lAPh{dC@W1E!03ZE>-&?^FU#_r`tmpr9KXJDcm5-x6U0=
z=4ljakaav&JA-*3r`*#>GTY0+Mn@QAg*9(g(D{)yd)!`EuC{M;;D(DzckxHeq&~iw
zSK+<~si1?X-LyFnbuq64uVE%NG%Ih`v7@frGbFL5?q0f1mTDU|DRK`}E?8R<-&Sp_
zc-tM?A>mC=-YdCa6~~UFPttXY^+RnXL6}p={1cbFXB_N5$=r!pYqilE&Q|344wt-d
z9ISP@=O3X40}-P)E_w%U>XCoy)5F2Kjov_6k~N>W_(*OXS>~xIx$(Gz23yk9zgmpE
zmfZi<4i_H|2WwXD=^bjYMRIY;+wQ=gkc0bPwccu2dOiK?YJ7qj)Y(~bp|ex_$!s`X
z5T6jIkBh@ZwmJI8A+f4J1DbjdB{c$w@g><I5cG98G!iQV#B8AEqolS0F^ND-8i_sY
z5~E191WIB^cQmD*MwHki=(0QAO0-OKPM*rZ%1gMAfi?AC$DBhQcyTTRn{=7*fec1e
zHMtDfsIy0tVU8V?nnU=YL(4$Z+&g$WyJ0158nVB=hix&;(=mi(6X3iqo{o@rw=>oJ
zS2%ASZPQRYb|K^<PbY$HQOUNDy-e`#Z{N+faD#m|(yrzc6z4<k47UGvnediO!&f!g
z4YaGUEs|ln9Tby8c&kIpL(_aZctMh%G;Nwve|sOhb(j}q2<ariEnU1I$!GLuQ;S;;
zL1#XM$qR~sTh`H9EFcGas56q?n#+5Qg&cAS1q&g?>{d58ewz0>k=?q+b~^qou!;BD
z2s(X*5HZ-U#%_H)KeKgVMj>S&AoF%g{7W5w)d%x8dqZ3tKK)l7c{+b{WSkz~clXXU
z*AcbE&(~Jl+8X8mm%x(xLU6EFP3h}XyDYx>n)n~{p%~q`5d69Kt{u6iG<CIYY~ff;
z&40nTpsj7a@@r&mcz5BC_xI!RO0PH7h8qT6&WiVzI=UtBop#GFbE(OR>stKWJKdTc
zm0y=h?FwpEQ+|!8-O>FLGdp$~*Q}-}9a#o?DoM4jebk754<s~OE4<!P`^Ye`JnM^(
z)EV=@@iW(ME}q{w{rRS6Q{}l6*KQ6;;A{&}-*5l@P*bHKc1_Uxg8hA9d$;TLh2>`w
zC=1J@$rsX`hi2~AEa<<PcUoPbOnr{SvGsAV+(ue@J_DF{Ix&!Rd@yN)CFG$&Ga5)z
zVC$cRv+W>{9L7sMT9Fkb`7;`pShH7~rqQ3&&(<H|6&OOsA@E=<JlH$`e*gdg|Nku3
zdpy(M9|!Pl<}#ODTCN$2Q0V58wU||3_wlt7LP;@d`4%fnVId^9h{R?q%(e72N)cTo
zw>Avl?@}a;>0*W?^xOIN`{R6`@AEqQe9q42oO!TO7wHgIUaPe1Y>zPeWOHpPy+%~{
z&zOzq)3N@^Fr26myRv0tOX`gg_?XSPwutc85!z<41l1PPwg`Dq;rW%aU9p6e5uUdF
z4Nhm!U*7A)wr9h4CqMVKz47+H{-?V0w=vs5&`tJUXOsFu%HJmGrLS$#+s==YVL{#b
z$C6=5Fnr1TY{*em&*jW_d`u6KVwo_}dn4a*cO&M`^Eu+AAF8Kku_wVibMgemk~Pu0
zG0!nF5Y;m=M_ku+uaQhSFguqLKcV_Da=14nLsB?&ZHDDJ!nbG2HDWd$ryO{k=ctfV
zelUKbR}w4uq0Em{*rOA@IEzg6T8y7hzGDfAa$p(7zvxiq;DgGp#cZNb4s=eaBDyyB
z)nokbd^sv}6lLBvM|AGGXJnR{*M#xwoaj}{b99}VBer$j+hCUIZPy-5n)H@Du6K?o
zEs3^gdY`ATuTJ!K)?@Cv-7SZ7ZI;h-M4D%s_@Mr5!rUF7OSw9sdMW@_L+ZL$|BV^f
z^4DoUR80_tJvq_qXOTH5dDPQ9N1eJWg~z+@rTd^rL<*Za(R(f5QKu2ZZ=E9s2cSq4
z3Oi|{cd^Cx?)0&zeDyrXqkbro<QWqaz1|j?4Ye5llRU@0IpqP8wXc&@eyA^!wSSuE
z#am=vkc|4~JI1JoE91UgVaA2+ek99WG~}TY`E{N#rog9(=-W75m>e0xTxZCGCZcOS
zWle!TNoc-xZN@W4HxfOAO(iEPRd0?st~((!s49u?D^=(G`;1U4;h$D?ugoCAx)$F=
zCEwKXF_r|rHnndXmT0R>%R}`S%9dybv7s3wzOTP2iuOJoySVeyMTB}wTFOY$*hT76
zz@AtQtrmq>-%g~D45+tM>HQ**==YH=+g^R^6g}-+3NVO0a%AOf$jaI0V;9$pp8mOV
zR;5L!{o9sL7ZaA=SBsv$8@u@ZQ{4TYe%jc@<fZqvu@|*k_P+Y|_4>%m8zY;2R#2N_
zm9LLTjeQ?o+IMmVrP7jY73*<yg&w;S&ByFBjrB+w$@%m>R}_O=q2FI>?p|uX+V;(8
z?EBrNX8qXh86&Q*ze$T?d_R4kbiMoGFK6C6!ID>Dqm94XLfP-2aC_>duK$mboq6qs
z!u6v!%atV`V7lJ5lcdSpQ<vZTF553T^M)EQ%gZQ4J!QFXZc3r+-uCU8&(2fkCEGky
zk6AAG@>BXKYW3CJlw;RDJ+sW%Cd_ijM6Yt5qy5a>R7BdyNM^B9A<Mq)o3iL<<jUHv
z*tnFDkqvS2T5;IgC8+}|P-GnBm0qhz_RW%%{u<=;3bn~bDX}?>!O8Y1r09QkmkNu}
zmW%1fekhdbYz_lKKuo`W4$(8dIZWlVdjc^+8!ibX!yUha>X`oH>e`C9gey!#es_Wc
zaR)+4hWXsg(nlU>!89o2W<hZKu|zq95|n9RW_ds!=*?s{D4i*n9Q||ip8VEpFJ!E9
zZEBh4rF7(V{_z}=vF<)&Z}!i=;{zP6@9~E>&pN*d0&PXo=5i8Wj!If}vEjzERrbRV
z9>lqd{;IU!C{z|KzdW`2(KGIG)tX%0T1xzaW6JX8@-?|~`>QjVSqqNXRn@`e&7=j#
z<pn~R_(sX{X6BmHeS5D#J;Z|J6Jh4AnM`?~xZHC4>%z>d%l96ynfS&bd3vX6?C)@t
z?tL8I!T-)}X^gfk()pvmF$f@T3}Rz!Zd{9eNgQenx)El%rL{3gu}J4N_cybWP%=)9
ze5pCp7*tKVa${j%?7*a!>rAj&b>_n+yVsoyJJko<eTJ4bLmTuoK95}}di+?|QRC64
z(Xk5~j}2$!{4R?Y#x69OuSMI(hLGqYWE|#|9!J#Pwe-ngE&9j`B4h>ee9S{dWbC<u
zP>F-J7wdoWh+kS?Ei&ehdCY$b9hfX|5*g!GQa8rky<x99<`LCaeDZZM(rnF8HBPOq
z7%nnCx8l5O%`nBjLp$zo^R<)qu|Xty2QqHgtKx2vao19g!P?0qE2beUrcjSA!mBWf
zJS~saDxo-!^`?IgxyRh&Aw7@97kVtr<ntyATozck)e8T(%4+)!LJ#slamZk?`e$zO
zmUXLPQBxiX`{T6rmixz<_DYgqaDN>7*n0Qm(|4!slGh&mS46p6>fTQ+6I=C0QGS<C
z@27^`KCm0+zrH8_^j$5<2c#s)tW~cf<#*}xAT@-a*X}lQugIF?=7-uHMCl%%*h#R+
zEU3kVJjrV}t6Qx;-W8nZgQ_D^y01>`Ov`UKYs7>+pSvyjYg|VXh5i(63m12nE!7#U
zoyo92`np(26#8_Gv-1-Np&pl!VxK(5p)N)4S=*=;x9(MOaJqf|_p-)Xo1O*R%G0|!
zNzGvvU)&>uBJOm>^!qp3^hkpHrz7r!s`V&P2#+a$Nm|tZy)0?;$EL#=&}Q5}PS$ZQ
z&lY_9X~_+tE8B@XLhY8iLyLd(0WbbA+i^ubao!hVr|>2ex@2~|Sh^3mq*wfhFsSL<
z!9V`6tRC1kH}Xds?*Xa~zyE=AVMB!Z-4n@4juh1(D`CB2mF~YgFm6h1F+bl3lO3-O
z5rqR8at}n-2hu|VOEjb=k5*5n{kgX(tnQjS&*{)`oX5~EH{A_n*xTi^hq`~QjJ|Wu
zkN&nNc8&DKXY%2r#LQ-+4@buSAp{HKKK$5T!&f6WSU=B;9&xEPig;uubtaYnH{?ue
z{%iQru~LoWu1#)>!4Vad&*oOY{@Ry=S<ZVw?(%wa)>nSW-1WzkQx#3W%bFqcE+3+n
zoVhq@zMr#8#qSSX7nZ1{V4edka3waHvN7@8^D2ILT$cmUR>3?U*m#&ItxyADZg`dz
zyS`(CKKp8-cRW{K-OnHin9p?~5KlpvxAfUJ6TPo;UDW+dlYmv+t?GW#xT?zrs~N#n
zSmFjm4UBo%jO`*1v|tXDafJ|El>^ZVQ6s|~Fk}141HGA6W^9?n!6n?XdB<QpS6j_b
z3U}Ivn2rSc<4(IX>!FE*SGj&_ehRqLzQh_Num(5dL)4Y4k*qByuSSYVHe|0$9DK+{
zn*tjX2McjCQgSu2%mqU>Dsixmd&v}dG|9S_E2F|6RhYK1dI!PjI1#1fNXMB<UckQ)
zB+Ddg$*>$w$C<cUj&zcl?geDalTI+*_1PU7ecvuMAQG*!xm#5DuW*GWz;QMH8F|t=
zeYRGjbq+T~h2M=UECrs~z<+@|iY2CPFBwrMDaerwnCANIq@)HXV4D$p0Lj<J61T~b
zjF>h0>|03<F2I4U?DV7tD%bj$Q%eNjT7~}y?j4q>qd>|57P=CjnzHxBb1$gy@wj&m
z#JvineBjf=L|KI|5T@?4thIoyy;!0w0`$z-`{jWaOj;TDEd;mMfoP2Q0%y|9*aUf?
zH*>^y>Y~c>dyT%98$TokEiqR1zsz)guiWZawdI${<<0S2J^guE#3~dQSIgD&no?F-
zez|qtSYZ``i(AGm=R2-RiksYGeUO<Zt-+c00l24b%m8TO1uEA<jW3OR>O;&&0@oZ<
z0ynJfov(UvtZ(LFHtEhlTYl0n#PZ*@r~O1vX3u`p9g3T^j)sXL!#%R2XQK(YbPD?I
z**(h_`g<SgWITI+dHzeD;|K_zW<1+B+54z{<#GFixv6(jjw2}a@?vZ6qvXtI`~Dxy
ztkvdI7Gas%;`y-eFLeHh*%$qixV<Teoj<aJzfIB<A~e5{n}gV#@qabqL-l4qZ>C>q
zt;?h=Is-YKb;XoLDaq~pu>P;I^wn2&deMu!Ik6qUr_t+fV`O2o8zFS5SCNqDbvroF
z4xkTZ-7b#9=%2xXjwF6UYh+gRIvB@c($<6m)ZiH82s|P5{jHHH(d(cbgGpOM3UC`I
zXwp^@6W%>@-#tb%dfj?X(5P)UCfNx1dCd02+(txeBs@Apg`+xZ`vT)=2s|-i+lg_c
zI;K;a>%%f(oIl5G<uQ&0g7R@-0H)oI9t@4nfO2+@*~(zrZwqdZ1FJFZ1%f@Z<vTs%
zzFyfFow1&CZq)WIrrikmb<8$su1Kym5*CeD;UGqBpJR*-fk6|t9T;OU*_HY*4;aUJ
z%oc$$E)bNA0|PKDH#z|tjfZkf$84oBtlNUzabPuuRUojGO!lDI`b*fTtviNA6<CUk
z@__6#!Htf{Ef9{@sO^4CXuLpCT$ByGaZ6w(E|NxBO)d<T?Nh*nrV7kvi%!w&ZUV`o
zqTQ6Y(xbMr7(t3)<7`ndJ@O{7ZmuYlE^fW|x(Ui>3#bB&s7RJB?v4zc16t4(ws4Xl
z7>#%VOym!tD|AOX%mKaWY2A^k(Y)I>o`s8>X8jH6X|0jj6blz%Z(C%?cq1}ipf>Bj
ziSF7OnM$#626l8t7Emm}36Tlw50s&Iy^7R|w%E-%)d74Oeg8J*2yE6LO5gS>Qabwn
z4$g)SpbzE#F3w@e3Hh*x#II_NycK;P#yLFMxRnCb;8^7d{2=txt&!=`_n{oC$;K@d
z;5H6<vT>c{gcRO&kI{|3zn()LZG4LvG6H@bYYdtjmTa0-^jQ^-(rDvzjEx~MXri$L
zV*@sAH#;l>#&I8OL||+R1ZCsE0L&vd`cY`~St!SRtWg^C=(Zql99WHcR3NaHY+6LN
z^%v4;qdVpiRbVY1&I2~22{Jk&jUgP}(Z>Cli}8YW;^Ayy#w~$`co=Nj^rLf43Yd$j
z0*l$<Q}m}dfn?F}Zpv5b(MDO!_Y?tYb~u<Ga}!uMHyld;2{z4&&;Cvo*olT^=|8(8
zkIexs=(1Zl2@s5OyZ|b~K<KjFV(c8yo1WY)R*`HPYs72TU>0LYPi_@wQBW>GZkzbc
zI7PB)s<W6)bjMb43I*j1eA6kuO+kT8Tk9*kqKL^%73`eFgwWe>0xyU#J1KPdC<TV`
zND&}rF+p_Wo4|*2m{W8X_>Rqdwg**UD#A$9S>578b3hAv=oU^L1jC6JXo)aV^w4gx
z+Z@oFF6b6-lzhjFl7nSCi!r7PTE#^ax+`$FP5fe<q8cxdo^8^nYqW~5QUaZTFFM6H
zDS<GK>+<C5eEs>GiGf$SuIiUelYsf$ZG@@A5atp6`Rj>+RPHwQOGZh+D(-3ZOG>y0
z)9-YTC2&uxf!cSf9tjM<MYu6-pot&ixjJf>q;L^FQ|U<H8C=1dLK3f5<<eg7t`!+4
zE0aXtZKPKM&M7@ROWQh$m!;wre1YlqO%oR(i$hcttK!1l<SQHuN?toTDHY<vo#ZNZ
z7J6E$Uzfr4j&`;37|82?;Citp+6o7AfOlL?o|q!{#d}7nT*u>j9Zb*)2lIhXX2hKZ
zACy)p6Ax~15JMG5A6!#**YkNhAIMcU+bgiLe^_LC?R$o}Ww!K2@D3Thgq=<BG0j84
z5t+{)urKUvdLVsNaeKwdG|^(rzlsf-fm=_ceJtJm?}_LZ`3B7o5sSe)$|#Djd700T
z5xOG0{<Pnm`TTa2;_JlV9a|*Nn%JqiKI8fAx52XszrII!QMMg>M6Q#=!0cCAVskow
z-8sB5PVc!*#fm^6n);cN`7Cq%*qJ8Xn3(ynk$$F3Tj=D#?Un8(ZDeu5k>L3Piq)Ce
zkU*tWPIuMLpP`ex+jeC>^I7iAHz0&i=G(5`+peyA<>Ba5TASlBv)@6Ucq&bIdCHY|
z?!lkin(#UpxIN;M+_gJ?8<WrR&S{R>zew1bG4XSd_bdBx-j9H+a24yuJ+&QeAKfi7
zhR4TRw`jE2cU%cag%oQi`%Xr!q}VOkQGTYlg#F^NW=|D`dtTOJY2Vxa>Cnr`{BxBC
zB1vR+>yyvVm0u10|E}#Z>DT!6>vL3Ii&7_Y=<ohjfk(ot=Ns}bK6zZ*-?nh^3EZz9
zRHZZvi_cN#D6F(?zlX?QqD0;MchJwtg>>s*d=f2*?$InzpQA+4tTf}_LFCt{V@Y<)
zcDsjb1ph2KWMaB*jFr1GGSF-PK1#Y*;OGx~cOkF!=iNMt*vU%s*rdno;@I0a#n>+~
zS@u-)s~anbrs4x@aA8&*$`#QQY|1=mR_e~lG-0;Tu9U125Mg^=<=*+?KD<@y{9<Ns
zCKN#$F)uRBR?^Q_o^7=D*aUNeLsB*Mv*AF0NUD4MD=1WLJ@y35NfDB&rT-8PqzQ5&
z)<%k(SHF{St9gM3bp3}$){Yf7hl#Hb(BSmu)o;IGL(yt>Rfg2i2<Mg12!4R;0ORsv
zUZTaBo2^OiYR_t&H*No24kfvJiLq|ssFb<w^a0MBIu|c=m0^+u$?dm7Z<YMz?Hqn3
z-B?S(NQ!y#S=NQq1S^xIo7tYbR9s%;I!b_(YA$ExjcgM8O0#ht4koq;BU$FSS+2i4
z@U3|5JM&^HCy3P0sx+3&&`Bh@JhUnCj7gYCK6lh9Xs@_rcC3>SC%>JFbozK@Gu*43
zr=Nu@wSs#^+bd9!fqp+f&flZ#StVLTckM3FTiwk`=G!l9rcq)OcXKi?PyYCm{<|C`
z#JL16m^MEigO<!Y&!<syBjSz(GfNJ&R7HE54tO88E6)|qCd=OPD$rEkTKYtDhu$HV
z?Flr~TOGNb{tL5}ep`JODu@HDtA~rPAGxx%QAl`R=`rEIVE?P-*q3CA`wz<G_FqF)
zt8pBY!OP)~`QPIfNgt;sRrC1`<Ak3Yh5YaGl@5>paZ}PLtoU(acYV|EGC-p+tUK5=
z{YQ6p#OAxPUt98<7WZ8aSIN7q?K2k^-NDLswNo<tVL512JSdYjC~I=RCnpcm2gCZw
zIBkOhHL&RQ`m`UyKeb~IOka*y<J;fLfb>DJXc;GCC~zD0k`DHg9;4FQ;}XnC88WS<
z-wX!^K(yTA6(?hmT1%>@W}%f~zYfX3-asH)n)(TFV3Eh8UDrN%<!BfB9eB_Gs7ek`
zbmW!mqP*Xw&4*ikG`A*j&8<gU^c#k|!@HCgN1mNBJ&uYm_)${)ud4-Q;I@Wq*PS1v
z@K1&Xk}JVd{4TP=;Epe?&cU)Se*oF@c|zrGK{IACc-}^=x!Uu%RJN(<d!fcrOy0=o
zHB`9gFn51?uhKqVEoHy5mEqYb=4&&X`8T;q<iF!Hw8eJ)Wj!#ouamLD)X5;4nHTWf
z^hqo7-`55^<k7y)#@nV&o}yKI0qcb)gK1|N_g-UGbGH7AHP)FvDMdR|o#QS9TF^e1
z;TO5+e;thXPM?&eeXh<45CXkv8>@4qqIkFS{R*vRr^fYZ8vwUJNWU353FPxmz?Y>t
z{k#q>KV##maYI@WBPWM^-UZlSnUh97PnCQ}_Rr2r)ry?7sPk03#bAdK8JLehOEA7j
zqzyB23Zu>^;Li?rn3I83c+_Br6gs@ymE~S28#R}OM{zq|qA4Z7PkkMyh2u&!IT}%O
zH}QeojxIE%6nJ`|qaFPNEBQ}IiybDW;_do6WYIr-jEi|dfAkM`+6t3Amw=D$>rh7j
z@HKAX0c+6GJ}k(T<bUO-`|Gr`(b7(m9`ZO1<^}v~8fi(Ezcy$phn99`=}#d~(yn>|
z*+S$A8cy;en?~4S3RJv7pD7%j<ipD10sYZQ?z9(7vU~zQsLxapo#e}^<pFEZ2Ypy_
z|IOA8W;^I4=^=w?o4kPMrjb_U>yp{z(FdJbCR4~$w7XuwdLc5Hb^^@yna^&+vNWfW
zQnVA*1UDhjf;Lu$7je;T4y--XNLkugHNjs9^rop*6JU~UW3@B{!lGQV@CdHybF@(j
z@ME88m@rqdhM*SZaue^&HSItfl>);COxw_<;6?J^ALpg;Ob<$WEaXh?O<=Aoi(NrL
zv+-eEQ+IT!1IuzIHxI}@%u<}mh3Z;OP7IZqOQBCWu@t9rgJ`?Ffaj)jt;n5{r756K
zIkU{Ba!=9z_5#)mbAxH;!O~!S_5_x-aXMFucD|Z`7XmG4b7lA+T=awk3p1T7OPi}E
z1PX!PH2G=*RI;=qo`nstsYCiSc?N+>-s%K=UP|cYRcQLLHccHeq+MqavdLRrfW4K3
zRPt7EBIU#Sy<s$$5&|M>>qERz1+Xz{Ya#m9{+UBEw9XQOR@Bxy{HY4yQF3K1egpT<
zVES5q?qMuTe)<rUwzZmYPzbc3RhHogxah+UtgX|Bq-mAagu_ChH!ZxHpafojoX=hD
zsY9D-;S54LxzZWfQ%ZQxt3dg&&{KzuX+j2pMy_-PzON)Cki)?*dp@pGW{Rgz(`JCg
z3HY*<(9f&T@?&k8;u+HJFbFy1a2H^I<)?=kvXbA-wg>Jr)C@;7YAU+=le4aJ6eb^U
zPGETxX?_esT2wd{Z$4OIL<UyjNrM$il6$J|x*yev3eUllxD`F<`cmMRzKUQW4^cyq
zjS^<zb-5KU(c}_f@IXZun(QDs9s~7ZGgt8eeH995vM=jC4;X-6aHCyfl7&?KzP<`s
z^nwqI&I4AX7kpWEl9T_S%$jtCTj7CTaA4WZ@bZDrTv^nLetkAxiW`PSD`8pC8Otmn
z^)Sm|#u6?$R94(F(p0HRW;yeF&gBD2&FnE%tNGYcM;^B;#P063K)fhL`x4~~I^B)-
z2a~K##c%ElgQL@ZSlK*aH9FmwwNo<vw*qTYFgMH%o$kQeIb)dzeCWzbt>`yo<JWV;
zaA<cd3o&Dv4NN`EGM%xMmQ3H=TSk&cyF0T?rz}s=%DjN&>BItb5R?1@YkVULT*xm<
z@S0PJzT_9a#v3L3zFd6qLvP4BS;k*5dC5gaJ|FuLg8T{#4}n=JDDf2I@2Gn2hJ?Sy
z_80;~q{H80d!Xfw%JX#V$Vf;y9`tObtn&X$6--{hugfVRp;%QoxF{kGsGA@rFXVYw
zseTYo1-&UL(xf_scQqdLWWo*pOEo-85J)X;6SeqF2yoFd@q!(Md6sM_H<GG{GxF@R
z*784^L(7ezpr^?5f&ncU-djAYxY!y<`37h`jNz@wbAbW9874B<VGI*JlML%fB;=r~
zr{uEJGZzj*4bRi-%gIE>AcS`(-cQQ&v`n};6}Zh)M<!efOS;V9)EB&ic<R7FPqRE7
z4)n*8+!+l_Dj()~6c(<4C25t{z=1W`FPi1Lka{td{eW>eL9JXDS}(=8pvc3+fEJ9!
zEuKHQ*e}rXeb9PY#-buG5C-&StW)Gc<Izi4)B1wF5Kmc{5Q5d!EKh&~{js|4j0`3f
z4fAw_3FWZ5TIKiPz#1$~vwS^-JV%|kM@_@AG&#^a!N98l&qK-9RCKb8P!UT*l<$U+
zLl|$>fDJHm5W@n(Ym;@U>KT@ff1={40TI5y1{eazV8U=1SxJevA^wS)=Mjjo6B}Rz
z43`$Z#=eJ?7b+h*RM@BkA#Y}!h49j;Pn>~0(!BR@AxgV^FNAE&_zL0Cs83vh@8x+3
z)JqUgWj&`~LqM1iiruGKo(u>2WB0i;=uGM*n5PF!h`{dCDrdogHP~j&at+9WWNkK&
zW1ybfVM1vT<->vg*k*Ue2gz+xo)Ivi61G{Z{1F^jgT10zt_)caQRlxu{t5Bag9)WT
zlnDp=W3RX~o-wJ*FwbK!p#t`bR`~-sum-!TS*{0J5L4&3ubY;|uF8R4Fe6qC7ztgl
zp)O0_q%w9DQEm@e2xY9P0UyDXjx(ST%U0P+W)B7uFQdYRK(t%2Qii}$m^Klnq^M-6
z5-+31#X_{-V5N+JL}~3;*aQeMOS$A1Ori=@3C3_xv~+?2Ef~+Ya7Ve=1SoL_R7r;M
zT+z}82J~haC|bhfuPtFe^1Js#h;mRRD2NWgfEEnq{{R30|Nku4d0Z0P`#A6c6gBrf
z)Iu|ta!YY3DnadLWu|83TC|u@YG!H6tp><abIHmrErrsuQnQj4Z{27CEL7mCX<1zg
zLo=`0V9QVwe3{?p_s8M=oQLPU&SB=9nHTOdnT#5NVR&Lp^|=>J0@q<tH*mL@1e&l4
z)YOf)YYQ>51y~0>_32E;Sv}NL>eFcM`wQ#>oNPDN!HoKpz__P}+D3Jq$<PDJzOY3Z
zq;i03sTYW4EngrrG(x?{T3$zWjlh-ZaZl?7TCtV~$W|DkCbO6O%RB)GB`$g>eYQTe
z(U4&Slx^k4S)uO1lm)Yw7vddEsf|XAK%gw0`;Qgs9c<Yau0IecGN^0oU4mzcEMzkQ
zho{tSb5TdI4jI@oQ`0~@mdHw$2sm_8x4EHa=sR>#M*zlob6)JZgHAx1D>nxSJjoWV
zM3v|V{;TIebYLt2$~?Fb5ZJ&LMWOyXBaqE@2V{E075CllJ5*Aw4H;M<dNbF^3UxOo
zI*{#NfUh&8S{pIu0MTjO6IQ4^Z1h&{N+9sL0lBqzi4n`)QZ^T;6HqJWqJF^EWn!bv
zOalolcWYT1P}f7Pa6`@1uX{p`2N=cXxogiIoB>3;aOVMm$Jv)xpbGT^U+C32I56e|
z(Qe$UKwuU7@+#C9GXl%lmoc(H;>XtD=|G@vIkg{PIN+iyQ0t5te;EZX4V2{qb!({o
z7zP;^U4#0UEd!711-OJzSy0v}0SL@zr2{e(e4Ps$)n2yRnvu@n)&hYQtaPkwHNI{h
z8`VqZjjz+Eb{yuu9`5M?7<QOmEH}v{Fba$6%YEf8`%gygz%YU_y?E{`lfV=#>IUv2
zlRyL3C`{ddyLJqaIbrK?)V(tqC-qQMse7Zjofp`nSXnBz&X~HFz__l5+D4t8$(RlF
zPP4yK%<2rN(}rko8~30U>RwE52z#^;UuRC8He!SVy>zbH3iU45XERqH;JxFsOC7&^
z16+MQ9>B6&Aj2A=-ecL-QH>*TK6>2adOQo3U4Sgy2sN2)=P#QBB!9q-6B}rH)DlC6
zCE&A_`-c_k9*j>g+pZ9wY(gzDV)z3->0F@|>K&}l7Ooq>6BzVOUAv>ls<x0>0m)CO
zQFBoh*yNp9A5&AF4XfHpwiZYhQ={Bacj_mLsNDdg*1U;%03-lDuH5YauasTA617L4
z_eL*ywgY1k;N!tn0=)C=>L}DVGk8bY8vxl1qGv<!^b8<5jOqn2^l@#cP>&lkE*bFx
z0%fa!<dsw}48slAR*8DamSKx)!*bV$#)fB&t_OI<tPL31e0;JS8`WO6)0&aT;JyHO
zb*v3I*-m`24;$4>=73MeQ8Ny6mksx101Q)18-^QX!ds3-_2u4nmkrCP85o8SrcIxF
z+l03Pi@JfEXTmdM4XUX>?Vq*dxOsYL&tFD1LhWP?o}*4g;Mxqh-}HF1S%W0mpGK%D
z?BE45JTUwYw|y}EUx4ap$iM+vo4KY|sJk&)f$ZP{{IDU_(TL#+WTkP-tWbH_tgYN=
zfcM;>kG~wW2D0X$y%X%<mH#iR&wHge?Bu{80a@<cUVvB24vs>7HG_AYeFu=)5wA1_
zPul^*;nWm>VT{W<jap*NXffgi1<E!6!>gz%7={-vs|vNnmf?uY!f~@gV;5zOW&yl1
z)*Xy27(eXJMzxpivt}G(a3=v?J?jomwhuq-%SQE*nc;^q)WwIn#lt;|0fqr)65!4<
z;YDCkeYy4SGKq}37{l<uOzLs#O?dHGR4s1Ve%s%!UpM~2U-0?$tMF)x4a6zepLE%;
zqU14~{bp~Ke{cIeez!j3Y~fqq(Es)wgalifMGv%nTPOcK#L0ZRqo!sBc~W)8uzBOP
z(1nw0yISA#x}$u~?>jg?+4Y7t>femN7>dxk&M*0(QH9!>EB&V8)v+3t;zXgUriL|J
zO#2k)sLT3w9`Iydt?EAXM1E(nk+#kA>+3t3Hc%hBubDjJ3J&rAPW!40F9kAnAxAj%
z^X~AH)>m5p4(&GYZ(k9H2HJXvwo}_f;l0$dg&K3e@5~QdwFY*-D1&bg+-*a4t=EvU
z&b(a*hE&RXmHWF@_b(v364Xo6)k`0Xr!18}V%1AyLGv29Yxfjeb*NSOLsh`D51t#8
zj(k5P|9AUvqVUk)0+r?Ddj4f~(f2>){jS3;3rZt-KPK%DRtIS(O!je(T$VmO<=7Yc
z^3?Z#3V7zhO-CNMOji6akrdMOyR?J2d*G}+?c6@fyZ=1S|7LY?a=u5Q%8&1TBv@o&
zH3qzMaz2k^?PcYdtw4QLyjOOIK5L!L&$43kzJ@%D@2&X{=(8#h4Tin!F#GF!Yef3@
zh{rm%O3BL(4Z7%(P($8|&q;-wrR21?9cHh^#0|=C=PZbqRfQLjExydeYKn={{Jxmz
z-%T{ypegcX9upJUs>pkYWs=6QlCsr@Ij})<Wqvy|vL|jn(?(2Gsv@_m8)G$BS`hyZ
z<mP5&`3Y6m6~y0@S=vpkP?m?Ow+*VgvXtd5s&U@Rlkw`2Sk1y3if=cuP}Q|j8FN+{
zqvyp8ucU-2W2kEDRLwDOCRWV3QBB$5#avr8lx=eOjF@vw<<W_(Ow!D)q>RsJioKch
z6V>q-k$Ll(GsGN)syR&^AFHXnjqFHK_g{OUY3SWCpXngxjH;TqtNUX$ycUGefz)nR
zN{dwVD+s}pS<uZnt&~#Lq(K!uODVmk`e}MZx>ns0tMRU(cy)7*tLPh*(psfd-;24X
zk`k$uhN<_aYR-Ez&BUCJYD%^jb5qrjeEXspr8Gi4ovL}@&73Xf?62Z)uI5{`BKmO}
zY!x3+`t4R5-$L{~nU9k-7u%3O)^FllPW>^TX(^_CP}y%+m&9r=wjgdD$feCnzZ0sO
zD~OvX^F%l8jM6Vm9W|(`QSbP?{Xkud=z-HPujak3^Jm>5Lc{2$(dNz?W&fM*FM&U9
zP3-t=+dsDIS#xK?J6))&(AQPG*L6Sizwy#l6o1?CdHw5K_pW(<UF=M|v^~eRTDX3b
zU4rt~y&2t#YZ*zYqz;<#9q;QWw&#>p3xg8vh7Kg9R&*;Iyh}0$x98N?2=fx{cJ_2%
zias=}T9}t?H?$=wb!>aiM&FW&8{XINR|`%1BTbhHf6_v=n4i+pkOwh>{Lc4Be2G0}
zcc)IxG#@RfDVp75nrGsm3;%pMn%{Zh<jT>`9Vs(IYzx5Y@pHTdyPiC`_uP2oa_Y>G
zEnD8?`jn=m!zqvLL_Rkc?E2@)J$>U5JHOJDJzL%!J)YD3*MeQI#d6)|b&Qf<R^7dT
zWce~vs`;kM?E7N5f45w>c~5#W3&nD_YX3cCR+7f7lE2M|IkZ7@eSW(<@TYGT-&i@d
zM}7YmveA<{v|iJYq}g;s^<$a(&^pcRN`9Ae>bdF%7g?I2{&h$7WBtM31+pJkkt3c=
zPPe>9ITfM)bzNoNqcT5Q#dH=^xGHllg7ei<tC@h3nAlC>RWYxKCqfQ^E0n}=bz!RJ
zg16Q}Ov$Zcrd2a-S`pVcjb#;6Pf5&CN8UnQJ+;r0H8<OkZMyw&dV1S@?MyLcR8_uR
z-4(03*@9SiAQhXHoFY}s6~x+8d#sysTFIfRJqA@VSxSy>^G4Tk)~cIhHS=ni^Sdd>
zRWTctoLVJE-%Go?lDS;T2~*QkHMQPa6EUTunz_qMn_4yG0j^PUBGhB4noe)6lbEu<
zin*nlY1xVx$7%Gdm>4B(x7z*|V(h7XlB~JZhD5F3r2RZzvrgky$$YM)iB*0Vkf;Q8
zLb^KPv6yeAq{XQdVl}okOt)_SQB`}ZlJ;86*WDq%Dll3}i%<`xYHoXL9mM>7Rm^SG
zOzT#}F-~Jz#l$J)yVW7L5Jyj~XhY~UGfCW{b!`CS(}L!7w}i!QDvLW9lv$k+aq)pe
zM~xIY8K;?~vQ(eCN>w|TRVU=@(v7N}FTL9fmK_XA_agRg2(6pn{`N~^8CA`Q4Rxp~
zckhnOSN)T!Y&@rIH1HyBtSn!nY>ZHUObz|Zn>b4xdAC|y(}wWZ9h^)T?VNi7*{D?>
z@dAgK2cM7c|6NlfMiam1po#JSl=7f%zGEwL{~~gKoo1t_*0+Y4P|dU#^D}(3vmbJ=
z76^^&vb!D_5A&w3uHXCse?|1Ly8PqP+cSD1zc&29Exq`|rT{AX_t3AL-?v7YzgymV
z6pUND4oo1QJOmTS&eabk?RcRsDBU!c@N`rctau=47kRf&(@#EM=#PmkI~c;-u?@Rs
z^^+4u3;hWmmj$RB7fzj9I8`V(NZkFe$N3+au_K~`G{pn+g;Oaxp*JRzh@LYhQw|Rp
z{+C32)bI^6l|+2DbOQIXBXqa!ySi5tlRNYyp5I%|cSwKgULxiPr9WdoClQ}Ce7le*
z{rPNz#&!Ls`$z6NuvNq`b@@F+w`C(^HLeNj#B_DyV{w<2a$B4_F*ek$rrfQ&>!|8x
ztCDi3O8c^;Su-|kGJD&Avp_pj!R&!3)exlsCf-+c1&?$E|NB~8d72oPIaP7D{A0!>
zr+D&+3o-7$yV(<ja?d+8XJ^M{exsH}+N4bKMqP{BW-r7Y-im_-2C~m(*YTKl)&P7A
z6M7op0FOL;Sqt5%=Ql?(opQc*U1+43IsMLoKbE_eYZmVQ+I4gGZ_coS`KfE@^P%f_
z7frK;HvXjcYN>XfKs#WoC6P4r#|oyqg1H=`<ingCM4E<3oi+49nDbh}{Hz<c106PI
zq1}5@+gYkzB+$OG)f$sD_PSv%3T7C@XTh}Hh+i7w=d7_Ggmbc>k)P1*_SE=%3yQCx
zyc-%3!#OTsY65Z~9Xaq=(Pa&d#32VPD6_lDJx03nVW<`2^Mu;I^7gkSsixtGpNpo(
zNgGAbMipr<d1(^Tk@llP?J9w`Si#hX_zIZz9HxaK?XA$rYem<O5$5$?YmTC;5QY|k
zhY6HWLHSfM=TRxgIT6vD17eFgfWqS)Y?OxRSy0$PV0a303_LtpKB2ocF@})!9^_a6
z7+%DY*-}muC~=Rvdza;Q))x7OSU*;#&w2P}^<2OIg%is3tsrKO{{!IkOOJnu)U5|h
z=lK7PKRt6({)(RVu({Q`Rxspjb$?SnJe>BE{2{}F_EgvU|G(3^);;9>P*?Nt&O<z8
z`s*+*R1SyAcaoU8;FL7v-Lx*}dgLL7lbsqWuM3qId{x^We(1)@ems`)UA^JwVdGGF
z@{uzygKx}zC^8>jvXX&|!a62e{rl+5GgEJ)%*`uP9TV4f9PVT37=Co74_|E)e52_B
z+pS8Mc=_l|a>$LeU{+cvbw*Z0n%*fB;EX>tzzDSyICBnoo?rj4qNIQS9`X^7LLH$;
zJZhS!KJ5OvX4ldqOnQm7o=CYAEZuLTU0kG{)umk{(wZrlW5wFP3EE$qA-+AtZ-(U&
z$kZauj{waN3+<r{gqR62zl>xs39Y()WNx7~IH}Dq)#3!&$F`K?1j-*b;Cags8ykwg
zAm%X?{|uhz49?Jv%7U0*N19)Zs!uDlh7j`uOcBGBaD=!Kim!v>@g<zKf|!+1d^l3+
zM7dPTu~IbiL^0b-IO1~7%5xsJ!WexhJ_lJB0M0Msh;6kVBuxw^<}b=WD}Q*9$2EE$
zZ#i(&uZkuA3tM$93!wZ0hKVIt!vL57faxrb+aoFPrNj80z4f~q7QnZ7<fr$=7(ku?
z{1q%3@Xp?gy3>)mlSut#?H^<aT*WvC;hL&ZZyP(88J%)>raE9(L;yPgXH#6$Y1A@X
z=QdO4HgoRpjb|P7SUliVHKuPB>Y)B9iQWo(3+GvwCRbK2aOxzcZzZZ^#;Jetr~WmN
zY3x>;VyS-uE2O}<8|oDH*=B5-q2Vbu5MV*Y1J51-gt@4j_2C!zFD>S$BF~K_U}0MT
z+|Hu8J!%KOv=}=#8lCcYrY^@mTLBO-&aSw$O4LSM=L%Ej3iDG5=RB-2X;{{3lT$0P
zsJ^Tocj_n$s5NpXVbbud9+Oi^Skw(Hc_zSD1Ap8;2)eT5z`GDU9F0Zr0KXHsbrwiE
zy42v=oCaLlg)t!M-6E<TXm;w4P=jY!Ddtup2bXqRDAhfb#w4qtj&P*aiPBQau~pFX
zgwk}8)Xp0Wwxl=;rFf_#2gwWogNr!54wU;o;6BR3?}d&#Efn-Z_|+nCAAz!1ApKm-
zd0NVGO+=jLfM&%UoMP-9yeJKEvY-?OfooEb^Sa}n9ilt#QX^>Z9^`xgxTc8HZ%e5m
zP!evyoy(9^8;ZR^DunhvhdZ4?-wfo<9k}y1{DOCIPdxI*f)dgt^%)r}fIBxr(`TV+
zy%J8OKpFu}Q;{W3l=4!Jfnw~YNSaZ?87ikmob&J#N{ylEJ;;Lqa8nUy$d<w(P-r(`
z^)lqJ4TUI>c0tq6VYM?Dnt>p9VD)eKC#8m?7%PO;i$IV-p$Mc?#k5DIG~ELXI|sxR
z(*TA2J6Jyr!CLTHL10)4auh^%XEhwP;X4cbo<YW9Sl<N<OF+WYk?_X~dn?E|4hgs5
zTXgx&9kD+OA8&<>Un}gtkL-UjI&U>(9DzJ>;@>Ex%~aU$6Z&lx`B`~`mX>@&p&u41
z*^SHz04<AX0tfyTA25yr60;gE+VDLEeqyLZ4FBN*#w8$I(~+$hj?%7?-YNW;w9EfM
zbxNtOTOr+3^0?#8)<Io53lJV*-5g#bG~zA<Z0Ib773zLW<pRtqJw4Abz|D}W2UKom
zSy`dpz*h1wm0vNUjOog`tTRCD8O*9xsD1jeVm(jW%wO}|?r_%fepeoyY_`d!T>9`m
zeugeFIN8ke0e4U|xmgW;HvB+=UoRBZ4PSBrcO)PI=}5q1MU5rY9g755@J+h>Tt{ly
z@b*@ydstEPZA3aaIxh<94o7Y|@mou2c8Z!jp&wo3XYUOzvgA7n{S2V)9Ar-bxTuIG
zao|7j0S{6%;aLqT8~zf3pA_ouhLtYh!31PRIx^$2BEbUkibZBv@UdO(&Lasd*tQk&
z8dfBH9cdpJy}APO3P*~a_!moQmWqU2VSAdW-NqYqv*cR|+w~x?9As4h=vG8~?!dq0
z18%2i@L3IF8-9SGy$AB@hO1n_?Fq>IbYwoJ{lGPuZH(<-imTX!CF|kh=Hdtc3tM$9
z3s`@I^>ld2dL!<9VBL1sH7nFS%sLY0n*QRSEhifJ4zqs0c=xeg6v+%a_%$KFkze=i
zWBaZW+S_vG+H=ihVY?aBvKRRj0Ol3Z-rDjD2>j(Y;GkuQgAE@qXnzc4JcEOrLDLMR
z?hYLE8>ZhrxN|L1XTf*xYM(bUbPNvK2rVT&wD*4Kp*UnC&xdDs{YX1(t~fLZ-_C?G
z)KL45>4A&zZD-KuBrQtRt`B8&Du#kbhRp2vcZz7|6hj5@?L}Y~fgdbr&nlyJ+3`;j
zwReJJW);&66hrUfyflPt!9VE*ZX|(kH$xM}aNay{V-c-pWT*<72uJ=Jgui7%6KZH`
z=k!1${LL9$dXg3+YBzu;bQ6V)44K>U9~RL#ilIXI+amA?fgdVp&n}Zcvg5OfH0|YD
zybT{C$bJMlK7&o2L0ke-kd72QR)p9<j%$$u3%*NNw&zI5G1#;Xa(tx-`8fsuvvucm
z;6=F18FW1<Um?oYgB&{*A;BXdy5DrONPbokQUI4N0=E(P{(|hxGP%Hxe?m7^AKTrA
zZzRZm0-bvXM>~Vo3CQJi<g#umTj<<c<gx{SURU<~k&xqXbQ|<E6MBlkoSoCh;*bSJ
zL=p5f4Ry4bxJzViZbwNKm^Z`kEhy(l3cFF?IPhzIKoUhWHoT<Q6C@SMOGiQ~pmSkJ
z`gORs7w*j$X8S5an&Dm-aPLWZswmqGI+rpM`BD)HLnAw;m&GE6Ma0LDYZ~hNV)>I&
z`J6<=ZVqT%EXOMDzJq<z5IYP0@gT6t2W%ozE(FKS6_y`^Pdic8icqh^KE1GyZkl<D
zyG^i<3mA1$zE+fN1f?X8+`T2tR(8cS_4XGl?jD8P7J^;`zO5izSxnq6DxYCTStTgH
z2*+7aibo=!qlz8)w|&42%ENux(Lsh#N(3_K#J^oCcTn8jC(Pa^%C`0f9WD8$!fYJ$
zdN&dr06G@QMGpKnA25Xire`(WvElm&vb&+zVmQkMOi4iYr6c<uEACoDuj7z?7W`RV
z*&ZWz^Wn)>==E#G-5(<v`(Lihx8N@oWJ{sf-SDIfcqjoeOGnHeEB0GJi(?Tp3qG!E
z%6Viz3!c>qEgn|v|2k4LFgm^hS{#m?bmBLb$}JW9bA?lBqAA@`_psz!3#as;#W~2D
z0MMgIt~=@-J|LX}F3M_<*zie$sUB!?H(c)m(i0Hhbi`LTktK9L7V)*<8+T338QIT<
zH?~6ebrXFXNzhHS3c4STTzBHPl*(-t`}2fT>7ps!%QM81?<kzYL-%u#T>)T7k-XP|
zznGb`em|_Z_Bpf=94q<!MY#U$cuC7&Pwf-(#{8~-^5x&Vw)n8FWXL|@+kz8+9zzt@
zX6uTUek^JE^N}w1PFLijD>Bd(nNR2vX`F_4{rx}wnd*~SAO7=9Ow5<@=b=k4p^mG@
zxBvV)W4zz^@Smq+{Jx9}L;r3<{YD8b8+dv^UQ$}hNNm~ufnWCX3T<h6eZi)R;4FFa
zGNGAqxoXanodX$!4U2DWIdImYSo{6-3-fZ5_J0O4HZ<-#(4TIZ=Qv=RaX~}#!>@jo
z5KS1FEDy@Oxcs6*b4XOZ<<p}p)`u1Q8@Fo4=yJ(x>7lOQoCm#|9xXBa1%<toMtPcr
z2aO8*hQGx}o_jtRla+F`P5#=PGc)t|z%EnW$LGu&|NBb%s~6P!9#Z~DBXVz8GyCZ8
zzh5eDer@)7K*@an`=IfZ-`y{o8^?d#-Sr-qNC!S%@t-1P4P&?@RxX|;0R{=qd8joK
zYCL^2qn^zroyx@@l~4x>o_VM(66ZmJ9(iX^)TQXfhPn9D5@#7fK+bPM{m@6q{A6O*
zMw*$6uaIn(5qik^mryfb5T1}DsJg$xS8wkqWJxUg2v~ANBE4t;HI*C@U4P+1UcpgG
zY#(6;IU<REWdOB}{4|k1Q@6$#t^40wxTMnD0=8tqAi+HkwMMc#o_>H)|DH=apIeYG
z**!?`%|mUG7!DFJ=o*`&7h`jmpOP5L2#?9GO{nkt2s=KNnzWIua+jZxtdJ3&lU*;N
z?s!2Ek{i)A5_mfz*%Hq_f<C!1kzP4~no4eruK(vk-tv42qmN)pZcL){22k6`+Y;#}
z=o*>QEhZmJUF!Y0q=G!r3RKZ0(%=BWF`4fDvDB^pCYMy5Ct8I%c#U*2PsBdyFb(!!
zo@GEDSwVODSh}q~XD#a9@zRhyQQ;uLoIJ9UzT{&my&hVNdiT@n&GkmyM$wYr8%vD1
zBzCSlOQJVe>zs#LBUu(t-^!>z!6lu}bw4UuHdyPKhuR{UJ6Ma}wC?NCi;Z&KPfO;?
zY6awqCe#mowV9t*>uwq$*S$iLCadisS6o8Pd{O&^9FJa*pFb+rVCv^Jk@Ryf-;mf`
zMZK4MxsDtkF|k^|{%RA+Huv%^$-1kk$$6J=N&;nZ+Zr@)Yx}8mhw;_8`W>yL=ufD=
z_2ZW%UuER}FgkgBwL$%OD{12=)D887RuV3E;A{=;+&=ur9_M-jmz1BEz5?~>B~t%D
zEg_li{;_9neJz(%k(a&-wf`EaBrhGkjx!kj5^Q}^6UjI?{iekGDr#qL`Z;n(#6%Ci
z{#6snF*m(Kl6e(1C2#bG#7VctO<`HXi@2o1+)<XqX|UEc54A>;8c*NFsPE*GYH~-9
zN>T@Fz4B07BufTs4RqJht0{W1dG6?G$r4#@7kRn~b*!&8`%{m38;O`ZS|K?stCf<c
zFQI0?NP0vzMz7=X+dJ%85^P@*KsHXKvj<R9$;Q$3$1mjB9hHRlB^i>9ljs))P}|5Q
ziF8Zd#%jM8JUK^}w2WLrrCUyTpFuqxMZbBqV<AtnRhG1xToOk2pYX0my}6!lG~tbz
z6*M}o9k7xmg_EPGXy!EPi75Kjs~v$n$y!;`Dsog9ecpt373$UXbi#x;4jn~HcwmxS
zeOeMAOA?X0{|^8F|Nk7-4_r(8{|E4M&eqnS^?&+<{z;lj5u#x`h5QMP-2SK(A@_<d
zZMw3%ok>cixcx)2lYia5MNwChTIdfOYuBG5((kT2P2H>SnP}r!zjMAl9%s+ayPe1D
zeBSTR=g}2qpepwLv)BWpe%99;XY$L6m4{TZO19!E>4BHA_u0Pino~!<PCC~EmD8>?
zLj0%(rFjkM9e&h#w(rWZI%;L<l}0;$)Gg)u8q#fosGCY3)#l`j#+tSt(8fG|ltk&%
z7waV;Em!^&nIhO*`4VkB&yUJd{?r#cPe59$oZc5pVgK}`wq|21jo)`#Ib9X|kiG8;
z>F~4IeWP`j*Bc%9eZMKUsbUrEeOF2My^QT)kNxi*y?y$R4CStAQijiQ`;#4z{mZJc
zds40K^-s?#iuP8PZ(e>$u-&0mnHib#>)y)GXyZkGUzRenFE&6xTC1e>y#|Q*=dz3)
z6m6<|r6t-Z5d^Izy??dw&lj(qwxxJ#Q)gG6LL1Krg4UD%`Jcv<f*?uZ^iS{hK0g3e
zZoJZH#t*uwoKr*E!VjuoSF9XMrByz?(&)?&YE<s2A&nE<ZcsW9EgBWSJF=$Yhy}3U
z1DyvnWlL_aCG9e4dPyCaK7Fq*u-^;44m6cYZm%bOY2I{7avM|yxoKDIf4?7SI)#vT
zw1F>E3l5j>ILsV-aKidvMn<%|74eyKW%wiUW8OKq0)9J~fZS<)(_bZPoUF-|{^w(2
zeDuGs$2V{@1SwC?{}C0A4gyVYXiaPA1H;x$bmWVT$`u%R2p^qInoJ!~z(>Ko^>k*)
zxqFVt7dzE<fGl~D?xPG;Q~v!#AE3kEO!vA0|0biq+L11V{!Kx@15HDeEnMjyF7U56
zc_)>83IAV}#)s+b|Fh-;h?R{B1lS!geKu(lmHh~&gIbi%OgJaBL9FalAplwOBHc@2
zU!l0@=xi#SW2&_QTy~->?MMS5mp$l1fd7h;cXb1Y0q2-$=L2NPj`TL@@~5OwPjLZJ
zPb!~^6wX)Knvpt53IkP}0rn_(HF}Pl33{2zXCh?DjC24g`~dghl0s0m0AkbN9w+Tt
zDro`S<E&i@xJ)8}KE*{8)j^1DMV9VRN%zCveAM0udjnc3SP7u^41Op?8ip1#_;$#q
zOn9_n%_c~-4q}_Z-p<-9RMP!$H6M*M!qtG5306XAB!j;mA`L^IGx*byO-JF_(#O@H
zb`e-fBTL&L(jaspTjeZ97Xthfh!Rja)7YL8QcqPZjcoy^tZ@I#xtjuN{lH2Sw2{G&
zf=GkVbhav3jHUzpLPQCwf@y4T38|;*2#swGj}VWwR?^W=RK6>sT&Ox?M*0Tv*TRmt
z#2-+ZKz9My(MfxZN?HIrI%{VE2@}W*?$3!-G@r`1Mf?L*tIbFU5dRNwIq?{%@`CPC
z;c_SKZ&cC(xZGJA2qb(#UdRq6(ohAJ?~M2_RP8n+eS_T4!qK?o2B4Y--G$(2Cv6^;
zv;dBF*7^VmpOF{ezHT=`YpMKc$c;eN4`!qT$c+zhKk*o-S`6K#!TnC!^HkCTxZhdJ
z1`;Nb7e}YI)6p?1-vzm`P$e)UeS;XENsK!BR|~{A3zY%d0NU4Z=(`Clc9t0TpfXUK
zX1(@1Xr!SsGi@61wL)SngT)lpP!KBSqhefQ1W~c6)(!ZYBQc(VrvMc<44uK?Q;-9{
zz@saUrvWNU=q?B^anhcklBU8-1Zag3UIJ?8fP+-Dg29i3NW;)L2HyfXa0DLx^+Xz|
zng`uAft#JQWmM8sxLJU{F~ZHDHV7P~p>G)cIEXY1UB=+kk&i@LWz0CBa)Itr;0z~i
zA(b>0&JdujMmPi1`h$ZeXe)ys4UvYSM;Ux;<Rg(bxNRI%t$^;*;Yla$MJj13JSjlG
z8R1D#%K-=J=r;yG5h4vk>5K^gaV64R65Ie41<C|qYbULQN}38=3(y=RYz=BXz!g+9
zhcUr}NW;)Ij0sc3l}JlSbOTkMP$m^Fa?+lmlBU8%0<^~n7lGOZ;0hYr!<dMHNW)NX
z#sn3)NUm*%6j0einGhV|q&-O`O@$)_XtfcJ0JU?$6((pkV`3{r8iuAYCK$*?BJF9o
z6jUvQGHGzHllB~yG!^a@pd&`O7t{uWE9mG5V<H|R4MQCn6A-eUNVD9O2&gQeOb`xm
z(q>ahQ{eysT5f~`K&=<pMn%gR6I&qCFf^JmVUBDk(l+uEL6t9*X#&?fX-lc3sc^jj
z?Ki^ppms6XMnn4<6WbutFmwrHf`+^!(oSs|0#q}gObVRlq&-C?O@-40XtNPc1GV$O
zHWRd&F%bokhM^gZ2`l6sxwfrCplTVENr%Usw3SrSRCru~P8#8HP`d(bqob3IiR}<+
z7;4R!01*zkwrDP(qC;N+*v(0sMI}vz-2`Zn5q1N$p5U)kw1_dW86pisBN!8A2!}|k
z$l`!1Z|Ex(mO5#Rsidi}RDkvxVJWCx2>wb#dl?h45NQ}1z?d*W+Hs33gLgh#0Ka;m
z0l-AIq<t-E7gX|1ya=tg;J_ctP2Dp#LM{2wqXbX)j9B`ia_Z^UJ%IeXCDfvTv}4;S
z-{0T(cnLVvKl^km3wgU3I#e!j&sYbv>~lbE*gR7)Y6CEjA)x@zlxFTBA@$^~rJ0+-
z9xL26w1$tDsOIZn50EvRl3hZ2#gbKG#gx0Tm_YU{lm{^LB%$j_<)+N@l28h7ul3p^
z*u7SkB-Ea_7chScS9y`{r<h-+WMg!53cSOV#Q?H*p!4lW7eLv&(FTCoN7-^<_L%>A
zw1LWWKpq70V$4VfkOv>&zi`O|khc^vr^A0au`W<a3*f(;S<8X!Nu;FW>D_!g)^aeL
zj{cXy+zycjp{8seRg9VfObIdz;8AIL?h;Z@-YQz2DQrtD??e-^yu7urEy$WhSzSVU
z$&&S(74xwh%MMsQ3tbB^PfBL3BYkYjJSUk&;q9_sYXFX9Y=&0PK_3BREu8c<jk%hh
zr?zIAAeU@-Od#(8ym>b1PHLVU-VCz-L%;I&RbN60yxEN91FYVS{%%M52e|sV<dT81
znu6}7GA)ry3wVpnNS!5@7V`K&-bZk*o98&u7A=+Of{-;c(l^LXExZ7i>;!lWC=Y}e
zII&JpNekcw&a62=*91~B<8QJpbHFYtdX~YAgh+$X7&gyOjK%=Wd}Jrc^P}Z?Nk~0;
zskA&x_$JYoId{pnY=m!utRPBP8R>0HR-qNM$BktLba|jl0cMUwy_U4clvyrOL%ewF
zwJm?%Af~Ri<HZAc3izNG={`zcHKpqlJ&z7!rYu*WD;fR8j`W+g&0F@O3}`AYCoK9v
z|LZ$(tycUV)myWycMF&!AC{Out$bvl$#nbPgno?*-*qRe@f){u>o{%nMrY|u`<Cp_
zqbJ|~OMht}{3H3>gUrvXl#}mWN@9jWPX6IiQd%_Urv1y4mxUFbO*wWCUDrQ3%DVY>
z<;fk^UO^ZCUbjJ0d`FY)v+_5dVK$FrRvs}+;VsdvOVt#QYKm#T(yb*C>ovuphAZ)$
z8b2vh?!CAyVvmpX$-MfvUC$FFy2q$6&|kWtEP|#fel7RzS9n`Taavf?3v%xq-QyPF
zp;%6ENyGs^>4UAD?6~bmX2@D0O(bk!#&fd$q>#M2p){hVJi@t7xPCLot2Dw)6M4u`
za!a_LC4CmdDXkIuGz)`vul4bfn#-%zx|&^vtvpWYb>UBK!qFs6WWKJZM)(s;dR|do
zriol>c+su<af9ah9Zl)cC3k&!9Lti3hnnY)bU&iP>2ZdpOheOsdG$2S^DTxZ9%o*8
zgs-AHTleEB&GU2e>U2eIMD5kfx(}$3?JwO_7D3lMe=V=>S5y;AYGX++%Byp9A6kT&
zv78kp5ovzX`&&6#aobx)E)h#w2pbsjoGd>nC{Jl9?ft#H*QrhzwwdEu+H0y=c*sz2
zOBlwI{uyJ8i!`JS>PGE%3~e!_RpHI?#<*Bx9Bb<Obvz@}Fn+9bYE#Knp<GPY$cA-8
zk99*KhVcT8Y)R?VJEG^le-b?(T4@+>!6$FwlRV?mIKzfa!-o6v6g$nr&4vv;j(vIW
zY(>g3-MIqI!U}oHVTJEx2tOJX?qNyKDN@Qb3s)MR+}6cT=wgqR_Rf;0ROw<-p@YA4
zby+W@X>?MgEH3RGEsOqmP<sP5)bTjJ<-I<Nlx$t>eof;CO{0mgbYn?xn5HqrkQ&da
z@RM4~Qx=x>9`KP467MHd5%2f9N_f~`no!njrD=R4A5kerOrtnCENPZ}1knZG5n9D^
z=q0^7{HC&MaO(p{H1CdoG%uL~<x?FR@o9}1(Q#kNr+zP=S`cG!TWxTw!HamtHU3kV
z{iZxirv8lKRM!YMHQzfl6p~>gA33fIZV_&Z<#?C${^%<W50LuC7~(Gp{e7es@)5PJ
zWtSnI$0@%lJP>JkOJrR<Mr8F`YSPmUZ*K_?u%vIII7Qnz5e>Q{s|?Gxa;!^wA8I~5
z(j7sCuE~ab*K|h)b@K1f;53%hQ9h#49ocQT$K%vr7joK!?Ma$XCv}G3g&dZ&NHJ2Z
z`4nOhcIylqHJ@6E4G5AOkXzE*tNEnR8LEV$I0KYvfbPp3Z8R1<1H@|w$^+aLj)=~r
zKx1)U?#NfvW?5`89OJdSmj|#Ej>mN-`!yCHG!`bliEB#&R%t9k459Jur~ML5<&J@6
z0jWNTujbVYJFAHOXR*@oAill9FVRWvc)K*<Qh9(~ozQl3yJ=|vq{;u;Fzc4kmX+8U
z)BbynaC7rL-Ro?k4*}+y{6mIIw}hKni7%qs&u(vzY0!18GVI*i?o<-ct;v6^>q3PK
zk`3x>x-Oy*ZIf@Ou@Yy>9Y=IsyA5hy`<?4Tvo_($Bu#j(&g*xf87uLaqWrWb95&c>
z>%2B<!tZKIzm2x|^4e#Y1U%M+%XMB=!gX<mEt!Tb_vPhwn()nrExdMSd4QLq{Fv@)
zfhN2{UQTY=C+X4Z$I?HVievD)tCfFGG?pEH_JO<aNAJt}*zjfNo@f+Wje_c%7*-On
zQlo$kf${AHeu*@B`GT^5eLjhO^Xl(uUJ`q8ca<>KKQXE-z(S)Kke5GKlv_l#UtlE`
z%FDBKnmfYa*!Gzv0V#fo@3ywzBMx(aCDBa9N`o%G{hnW<tGv9qv>q+5x2Y4FY;K22
z>j91L&j#~bLK9Zv{h0PkHNw^2dnn&Ihd<8htT)Ac58-)%qSd*He>%v1bCqpr(3h^l
z*E3~yo%NlV?_+(byT~gUmtWJDw&~?7M&A<ObXG^d*O%_b<u<Zg^F-5Dh)R>N+Fbn)
zEYY;w#O&edGgvK*`*iDn*of6;Vx`}DTk>sWKArV)tX8i7!9(;z9R5=#{?mPRv^`e4
z8UM*fHod2Q&Tw>={$&AHTcM7gRM(~z)o;RTSK^~HWp@h_UDVOdUG-Hx^|pQ@OIsPO
zs~*Jm{fti!6j|mbK6H{@n=9HF(0*uWX@;%3|G0i}uxO*RY))tWkNJt=MTx#K__kT1
zd3lKz>VCEUk6rjS8(G-`(f&w$U^^Zozc9d*1$EXx#r7%me|U)Y$KmWuoPA&2Z;Orb
zaJG%is;Ay_xL=|d6kucL)%~B<DO=yaxT+U;h!P4Dqr2-Zu(1L4)Rms8xiPqO6)t5N
zBW$L;3#W<;rtCYX9y?8?MB>sm{ph{|@ijenB`ys%_68bzZKhJ<@XSm+lZdj%#x~=b
zHZs?qdhg->Ed6I9szTjAsrGFK(;YoTzvd=Nhx^O1v6cAO+xkM+Av1>|Tg)YI92Vvb
zFAHp^U@plx?V8^5o__Qn8dC;#rgdO59_cOJMU*)FL?(XXzIq80o3RByVI%YCNn;H!
zIj*-nh0QppUZPXiirGJ|!e)fvVKZfC3WiM8OKx?g)%B#!^b;l9$`*8`F|Zlwcz2*E
zId|xllkDVNk$ph>*Z$%;Oqp3{+5@cOk$$7Q$UY9gmWf{@f~H{=TkvZ(vbjBJKEq40
z^&3xN6-3Y{wQq*t5V4wtxkClRONz0I5PZ*V{nO9-r&(QT{^}*w`llYE^unR|?ldc`
zV#aXu{I0aWx}rb6`rAJgcd(I}^rU$VHzWFasaV`77Dvk;+R~Y}4vP!L%Vx^177W>`
zn-_Jb?amvL=hwdt?@l<bzwR#bEgV|koo0f?y;e8(4L4gk$o|M3I<Ia%p}!t1+UG1=
z+?lq&V5plZJLQ<z5>e1<ioJpHpqa8$1w%A-^Ubcb+Mcu-exf*A*}Sea3+&Ay{C1!y
zE_bNUNme;mw2atx)=tE>YtGXDyHvEyS?1E2mXbfTy=aINgMXPNI+{1+s%{?9|GOLi
zVk2u?AfiX&R@;Rdqd#%}#sO^E&$v~fh@Lxi-$8cSRhHbKcUg@WGG(5f<Bzaqa=nX(
zXiYM{>6*Uso?hM-N1VSQGj)bqU%3n4WFsq{CrVi%8cD*I<?D&JNy!~LH=I$1EnA5z
zyY&ehu-0FQ^LOhGasDhi#~)y=kMs%dBF8xVMkapazB*$X*1841VI%YH8TT2^$kr#E
z!dlO%Gl)S=#vddGwIp}w)Nn>I)*6BzxUC=jtRKwk8uwRcRO<&lL>Yxc3EksXSnG`8
z$@yL5<e;k6#GqVlWb~eKkKsu~zakYoI*J`71{K*kz79JYieH>5t1cL_S5GeL9w!E+
zAO_{zMGUIVT@+9_6y7~<f*pOWp6nZ*BnH)-J5-^bJfUw37Nt4MmUNC2gX&?*iikm3
z=MjVY2IHKWvZ8_^x_a_v*LZEuI5DV1TUkKYxCQp@5Z)drO3WSVcallxinzp}itLF&
zO=ju8FBNf}Wp170#Gn$3hPW}fah6D&H{_<C9MON@jT>!bvIRyU5(l>nKmT!z!ZHH6
zTx8h#G)9MU@V1`vSx?F8a$~8jujnZrM!1m6>vl86=+lR-1H0TN(uAM;9Es_=Q8D^K
zJS5QQp38mYAZ~CK|J<O@T8-alisyH_J;CS-eU^tYDH->;re8@M+_A$ac({j+*tExO
z*08lizcLle8O3sF`P{9YZtJm}P`qlU`1b-XQ*FJt+ig!C_ep;JyIVV*y4+}3&Ov-f
zpmBaK_lbk}j;r{W2K~d;_+L!%(oQ!emZQ)=^f3OMjN4w*d;TvdjECFWh^akp9>Yb5
z-ZK?jGm5Ptg0^(Jt;5!Y;%8=xuM}|Y)J2QB-FD}3iSzXCr=83$Hxq2lL40$dk(JAp
zJBXWH#ry{S<<<C~O!1;lx2M<|h5oXKac?rd;F>;}2--ipn};v35i@$+Jco-U`s7rs
zXB6upf}%Rz!m*xE{N_w?T>;lYT|}%XC6B8lf@bZU+2uyZdJf_T1C2{_xk?A|Jy)@?
zK|j12$C%>foo>BYk3v7}Vf-Z-H@l{{CxS*^Y((|;?nY`MH>6t%VBW9P5if=#7!Kk~
zx!g1Ah~s+uVB;!h@vKhi-U9Aprua9<#I`>k&d%eSsUy_-;$8SU8}V=RjJsAC|4zcZ
z^Yz7Zjk|KW=Y}K7Fz=Q4<8FQA2CVuQ>}5o4MJQGc<8x<<^9r~o>WG_N(*N{Gr~4VV
z+KPR;q~=)lA-pEgxHXsi(n)-Nu5nR7duI5FADQCmoziZs`mz4GyKzw*{vi|pa9<ta
zh*d}8A8f?z9;yFuM2`OXDJ<ozy7#~8+UB^kAy^8GJI@rKDBx1my$xN`njWdMpK*h&
zcutqp3`;qLp9?f@$mKqF5|_<2`Vm3C*|AKqL#MP0OL?qsbT|6N;jc6C*Z0-E4jA!I
z=(UYFs7E?)xc7v<@%oZY`j=DPW;aXUI5wrT&!t`bZ=9;a+bJb)2J6Ye_64HP{m;&P
zp0~KC>FWEX2M4EwpSbHQgAc?>=JyP8*bioUFZLk5_R{wKoi}UNoE_e^Fs-KLYuO>k
zyJ1FdoX?20a8-Kc-ozr-N!|7L?3)_frvkfN&+}umtB4QR-w&@!AN&-?z0~qi@+o*l
zFLiz|Wi9&T+#28$kmO2vQcQZ$GO68aKG(fN2%U`pK7mOb%9C=^cH1P0S(1c)degZ^
z1aJU4AX<z&NIIh<)Fo*LjAT<AP6G~5M<^|Z1(JGp%(Cy8W$j)am|_e1LC9)G!&-<m
z2<c*Xs1YFFENKDgM?<<84KWaD7~(Yt@p6U1-AX$s1_HvJl1@@dQ-N>+auo#2>^inU
zG3G$Hb5aeJ^c0}j04SCNpR>?%+m1jWrW;VqCf!4cxk2%>Hf^{7l-YM20%DYa!i)3(
zHD(7C^B2h6^1jX;nFcf*1EbcGKA<&hp~pDeBzb{#vyoDu;Wsd9J?S&k2067sPT_G+
zADsr)LC6n`hV>9>5b~1UF^T}SW=V^|IvVnl(Xb674MP^sK^D8hw!4+np%@CV&nf8?
zl{6LDCqVuH!9Kf=ZBUE_u+KT^I+gSkFt!00TaH|kUl33mtbo1+9c(kw*FfJGFh+su
zyphk;23MeOVMnGJ=?pOFED-by@US#^hG`N7NKHa4?MNHI)E8h7jrwXWFvBd#6G+{K
zoU$Wb1f>RosXAZ}D?P}zV-E1D6R4O?x{LCvj*@C++HejCvhUafym|suc#)=3U+sim
zsX@Hv$?H%c4oI?~q@E$ow@j+FYFO;v5e2<k55$2<zLeBb(lIfho!iaDr8^6%mf!EM
zNpFohg&DfISsd9TN>_3In+s|B@V4%O0|VU|(7X4YcGEwezbv}_B*^>59l^&S@2bCF
zfB7uBKfO1|dm5IS9yq%E&4qCj;;#0{!~OkB-X0b_+}(TblX%HnvG;+DODD5lf9(8?
z-Z*$Nz-mux@mb>IXu-h!)Qo3&#9v$&O8;4QHiiD*JNptN%9`YVyCh08`>lSWC)geC
z@Y+F7v^)GL{DIY-+5a>UmC?{;KUAd#H-=YLx;GUcKYUEJ$zfn_HtA)Rzr%n@XzTK-
zlk&e4+?(=`AC{0MuWZr^)q#Y)&4;aa)2asDn<|bU&Qcw47?_t$dRgV_FhB`Cy1c4J
z{`U&^rkvwn5VGW%O<JMap0KyxpBmlL=H66({L3-bc83AqY|_grj>7;w^xN_(Z~5Q9
zx;GUa{~{qv-r1xTDpA5-nNNvl`kuK>ZpXhAt3);fy`kT(lBO})9iensi+E4Oo)ZGc
ztxl^z8?tnTG|8U*yM@b(<F|I52>_x%UB9J=Xx+_Rs8v~he4aUJSk+2DzUgtR@4n2?
z?+0>Vt&N!rMAp`tlLl2iysP>PDAHJEsdm`08KF6`+6E@+l;<khl9`{U+C1J*9r@>7
zTS)RJ3;RNo?_KxjZ^qyM{Pz1(iR{b1zwEviE>kZ1c*j2OpQRa3PuA^XTfO;r>Hg;7
zhQY#5hnM*`zd88oK+pa+{~m82+_X0!TQYXv%=<q}%j_pY&)WZ&xNzdqWzYBiKjJE=
z4`n}Qdx!KSr0?`ejyR@V_bk|q?HxOE<pt?}b~V2;(#WocN0=WjK$Veo>FY;H!z!QG
zrBCO-T|5%E`=1|G!5i7tAtQ^%E|ifrZ5%1Mk=~s+!q8sus9cDqpAab5l6L=|UM5f;
zD{OtgE2{gVNoC`ebO*ljmNK@6bbzn?z#hQ`N{KS~SumYF5;Jn)1!)0$Bz9!E_RhY-
zuP5(~gp4fzaDiU=sV;r{C}~io#a*R|xY7bmm+<`&rAc3lyMXkva&=#eDf{F3;*HKn
zZTbGcDOamn9<d#-lJ0%pa%C)D*WW^Am#-bM)5h<t4BtW;I2ymFQh^TN2o5f}SspSH
z_#vKFsi;ej9VHE_^u4Q`Ca&~F)3f<E5aqPKmRSPQ%gP`6TFi;C%kAl7KH7M%%33tN
zRB&TG>C0>B8~a<{*QZ<ZZ=6vsR<(4q`>&AhdC{U|_mkZ}<eOZdr4&4Cv10efj@*4g
zx}Ponz!n?E{vQAU|Nk`Ce_Tub|M>B9wzZX_pGs1br1kp}iiw@LDit|ts4FU}w_gz|
zp=oFGBPpS+{F;tPKQ0u#FG*cn=!X`Q-&|;vS;{3lNn4KXv)A|g`TX(R{dOMPZm;v&
z&Ti*6(umDJAy2@E?FLELOdUlmEnxHO<qEv-+Pr~msg5p|hN;rJwP!PRC2W4KT;VU~
zXNdV^rVbYKm#CQC+QXT;6Kp*u=Y)tIuB1~l-p+B8`u(8yznv;}z|(Uxw=DtQyPO{V
zvhj0mx^>33lk#QVjh*a(3gD(^jcx1(q+@ORGrQY86mi_8bkmG&*X7>Tz}Feu2H6e2
zGPmW*w?1hc&u)lS-FyZtWM{>wCiLIha%^ncgZX&+;f$}C-0?-DOD6EFeC=A*HK}}U
zcVh%QD@f%t_*MkG7Nv3;d`orAdgy+w;BN+dbcxET|80^udj+um^V^r1Uw;n1Wr%-X
zN@r$#t(Whs20COq)yb*dJ6@i%lD%T!!&rtBCa1pGGc^-<R=#+x>Vj0hxO>kMwt0}s
zc`#52ybz_b91Ns@#i|ST(bz>xRF?gL>&2lffHyt|zQ}a?IT%P6cU&5tl;Kn_PpSqw
zWS*~+TZ6?`$X>bO!v`|XV{+>kd!}Uq&&s3Ms;Z^(=<Yq??Bzi!_rX9BusTX*KN$G`
zc6PO3AD#VZiORk|FiE^&1+e~e;LFVOhQ%0S)urJn8RzTe>D54o%=kLFDOik<y|TlH
z_h-aoa?=-koHK!E<q>OD6;gRb_nt7eZ;;A$uvrMKh*C`)Yz8}vl0NtB-V@BOML;<T
z6fINzb#3^c1l64W<{9Fb`0$y`_z2)XRl|oed$40opQ;)bW>eW|OH||go7ag0RsgSm
zZhoHGGd9?4ByPAgY@5+@LmpQRoSfNnT|VD%ic>~<HVz>w$Is1Fan_aL$N`|gc=WbB
zn=c;4htFs9<jS*O?D5S6UX(LlXd(93GsE?MKdAk@sbX_{Sdh7J3GmM4;i#9|{@P*7
zjD;uVq21d1Y-R;;<1=k5y9`{71D;77f!ythmc}lNQ58P}rn1X2#gBCCvLMy0&pf*L
z(UsxY0bq#O_sX!5;nJ@>?f0YWrJdF0(C=+wUPb*!ix*9KY&WVp;4;?Bt7Ja5bE}_Q
z?i;!5V&r-K;|z(9rvFyLG{gI<`+UYZW))_<O<CKq*2-|!L2i!%s``9P#kE_G5uZoC
z<{LhMOUIg6hSxsXQJU$P6=t~hZN(P1BaQiD3*35t#v&}z_=SmcCh%h9k{2c>VDrKD
z4pte9PDU>2HtA$LR{%FXHK`apK)f_DVqaL|X48LQy%=2q^cy(vA91(gm*1$@esW0J
zxe*$-47mWaW>XKA0RKClRWQM(oyjtT4m#t%K{kg3cb5R$jcrN<cPVI$Ijg{Lo)>h`
z6|aLp3J1QR+e9+PsmyIAV0SIixzM-{<im8}2HLns$Oo9!%&-YMJ;e#TYmM%PKyn49
zQS)(X@Ha+2gjgE0C{S=BZfphojS`%U=Rr1)sVlw`AAG{`JerLqHq8(H-30g#HtjQV
zf)q@H(dm?Y8ggP1>m&_WfSj;r`9Z-yuyW607b==e$u|S(1`W6siORrPIwT5Wje~<>
zoMmPcOaX@ARc1C5vGTphbzx@|%<_PPjX+vS0s7+`+30LOz7eu1#L8iGHa&la0O*2d
z(DNrCj~C$IWgq(?8!=W+1<6MMbU@7<S%)~N8I&J{%!F8UYTI$(AxqW_Y8wqd<#e3b
zG5KpbEk6vI34<mCULMaXnPAh!WZ6P()9@I`=BQwO7_iIO=B!{n6-_l?vS&E2i6vNX
zjiy5R50UGxz^&B$i_|tXBcF=wFlJ4F+ScK7t$;HrZ7KLI$mS(gR<rb&DYC<a<pY6a
z1^f$cdn)MFQroEbZkmlb);kjoGy&QRdS{_LD1QhRt(?)pz%?`*CI*rT@C|0wkC>1G
zD+r}f!Xd<D5=%e>79b|}EN95|JN9g-!~(OjLKi{d_Yo6U;6`frC8{gI2&W-Oj9HeD
z>w5fmE1)06^*?wkBz#3(p=<fq@O`(^gp)9<S?GEb;2Z2@KN3a?PC}>^C7gnUO=2CP
z0Sk~YdzL%oI)VwMJDQGKvD{%-Bm9z?kV^sj<H>B)kB=uq!UF6hjQY{TX9$2U=uUe0
z1f+8TUMB49gjw@oR|fvkOt^*u^v7-3=r}%Z0}1zID<E_nJ=|FUbV0-E;U<Xt0(`IR
zqYx6F#8yy1au)y{P!C6zh=Y1S;lW5X#F|L0I0+P4vgS}L==d|I<73oI25G{{*os-`
zW)t8W>`6bei4;76(8-i=Dza%3tB?jPKsMR4yrGH_>>rQfrxf%LO1LRVS82el$ma|^
zLx+5ZSdMT770)meMpA$w_;)j*6ZRw<p$a=c!>k2x1p}mb3eX=nW21CFZUzYjm>-1F
z>9VN;pbHv8ml-4W3-DOk#{x)r0`sGQ#1a4<x*OQt4LU?Y>29EX_lEX$A&PK34epO~
z>CQ6y?g;Hu!4Fr@;4=_~Wp@_z-I2P_O(3D-L#c>j5K;W3?lVUe*4?Af_XX5_z5)pY
zA1XvnPhwd^DFkNgSv(6yXHaA`kcw%*ROECf{y>MEhFP=V6gvLEOc+Z6hTvXiLL=<P
zZp2g684IyY;S?C8U<%M5zrsdW@$oB=P=wu}psVOI4*}2x^{30|$m>A7Q1&qu5*A`N
zV31}AfDY&`M^+OD-37@ak=HP5J~gEj*ks9KP?Zoq#i@H<%FYRpEC`tgfpi>rczi#@
zv7f=mnNUB2G6rKgi8yn5w>k7Z*Rns9K4yvKe8;Y_iup90Y0@7GjhztW2oVmYyT~6u
z$3`Rh_&G>ejP0bLk#w260O*4H&}BwQV<0XSb~ZvRJ6K7<*O&<-C_sPwEgRj&$KOK2
zv)E25x{WUL764sPC%TM^><PrPWgi0};bDw`KyncP9ng43RxJmOhh!1R9+>4zRf>SM
zmMkV!NyT|i-AO4s7eca7L<@mb3@jVZl1>mRm@E#Ybi+wVSSBDMfC^(SCKv~yuz7#A
zUn2xfoQhK*kd^>j=v<WH(QnSRz{XjjL6FCN#K;x6k>=5g9E7TlGcHNyRarn2r{Rkr
zZk}LV81O!w8^iGUV$Pj}jk8AAK^_l~gRa0-n#Wxv7^=E2MV#-t7axUCONs{t37%Ay
zM+2rJ!I^lu4he><Snxz6yxfe-r2s?l^=4c%EPoF&a8z{^MrTqy=t$e7s#7#zD$<sT
z_v(-~xN0suk%9M`ao13QA-I(pmx6`wMrH~-U7;!(EP_B<L;?EaC)sEiA3q6kPh#N|
zG>q=yE&#fq?sN|$q#|(YNZW7)RAmE;DEJC9Za4+#k3V6foA~$>h<gSLr=pwa9^L|=
z3u;gIpdu-O_$}E-KZtt>lR+T42!IY~tYg&`4jK!2L?9_}l^0bc0$#DKnnD#(@tscS
zw3MCmAdgT)34v4$JU70oc>=eGSrrJ0+;9Too)^d>fIY@sfxrVojm%ls{TeCI%BlD`
z2&5&zJ9KUoqsH*XSz;bmXfRZBADQS1+(@fwMMO~5Nya4})@-=%cvzyY5NOkZ$<&%F
z)RjLNHD-v&q{<Ik`5#<n1@xz^T!(u=+%~GLV(B#sveLL}90ZaT@H)Kmxu9l@y3z=*
zp>Zc-HGb$y6X0Y)%}jI-RPzaTXSxg-ZUviZ-0>J_CcxKN%^>ppm!O7<W>RV<AkXcq
zZqtB;$ec-4bm;jv%)_I23xtlR)W9Geq5)HpIhptw9Wn>5ngKtj;b+Xa(G*|^{)ZXY
z6x+N9c`oey3#zh(pHo1JpaA{xf7s|&KK>8HJ&SFoqFd=T-U6Tt>PWAlBAJ2s8QDiR
z#664+Kp?pYfDY(d$Es@_bS+d9fn>r}KGf$T;8#BO-si%eoFCGNjsMm6RMw~e89DOL
z&5LmdK2_U&x4kesQp(wQeoP+l{b0g9+h?P(zx3}mj9sf4YTdrV-FsmEj$~pia?y!q
zNwM(c%dDT9I|t`~4kpIF`pnwK3{@;Vc6;BA<i3kL&Q%SBjx~AK38uV4CZtUb-8Pls
ze>^Ghp2I0w!1gY?m4{~I#CV)X^-&-tX^_(4l`P;{SAf|n$px0;xGdlRF}{(vI9B2;
zOxx(CxX+cGh>QOfUwG~ov0>{+-I}pS|J)A?;cRhnyQ-`A-^us+WyriVA4QC>Vs4DK
zy_}cip_n8K_(T+@XxmZA_3J$AXzh$`+EudSGq@5HVcK2g+55yYoM#=Uy}Va@`Hn1L
zqVntt?PXNrUYh376>yMPR;WCCS{9Jr)v)T&?2E)hoHxryv9u(Ot~~o%7Vxqwz<iaY
zk)=2%3ph+XY~-cKO6CdEws|S;awP}jB!zyLj6`X$GH$!p_6E<CrMSCFQV}mnsUy6D
zwIy7Mt1zuo87CvWFYqFgw5u)?SKkr?4%h#P(yl@!6HC)vyBhWrS5uX7gUUFDr{WJ`
z+A?L_V(p7HlE1tZlVuJ5C258&wtFig?VlWyH3*2Uw|EY*lJUZ{Bu~XEUxj~+_GURR
z&O>1<YfutfQ?xfx$<^z;`O(^4+q4s8$9Hihj>5DK<(p38Uz|5TPWxl8_Qz)JxkJRi
z?}&TCw5L5sT#GLMda2m|*TqdkI$N{Qr#)d6%w^f5(1;-<&lV0PdMNIAbAGpfB9LWa
zgySt9BUVB+WKTtuuVQA5_E<SD)I(t@%lb$-rf83$l8e`QZqeGvZQ32O<B?p6wQ#6a
zIlq$-<2<)Gt$eRmen*yNt2CUV9F@!}9rEhRIz)&Il})E)Sv$IlRv*f^K&-`ic0P*W
zk|Bz+>6I+&c~{o>Rgynh3Xv@9AhEWQw>nnhDID7DrFh7doQ=!b?{~>TG(=Z6?a*$!
z!3$t19<Gu!#Y?j5h<Cx-uUyG|;gDR})J43zz{^U~I$b6fyd|tf&I_t|<}5{S*XVI&
zHllU9Nh}y47UYVC+-0Mehy@pT%Y78lB||34?8#lDexe~|N!cZ{&%w&<AZ`2_NvW5@
zR5p4;G<3Ce$ngp<ElLs~8XB+6PS^I_;H9w?Z(<}x)jVbcX_K;q>7iiAMn4eylC=v_
zNzqka!rweaqVi`xv9Fq!z*3ZUjf#{%7ilH!#IL2wpN+~&kHuqA+8k8EEFE&|8qFns
zr7C|8Dt{U-kp$t;a^=s(THP9n)JwsXjRur36FoRB-kjC;ewfT0BdE7XC^iQYG7~*H
zs4wTY7_Fe3L_9baGV_lFHAO2xbMWir)M#zcHtj*#@gQ!Fg^<~*WONd_I5{;=duOlq
z&K;S#t&$O~y@TfbR?771GCxG*7Ag;)l9})5`jhD}^MK4;KrFsRTEylU3z_RZIb2`P
z>=^BZauW66*vQP4#Nrg~1vIDXI{90)cHK7ZGTHHU+?+{5X1nrmCvguae~Z(8*sJ|u
zSjbL!I9mGw&6!)u^yxA`Ox!C}hMtlYZSP83d8hy<TyWCZhqI`J2`fWi$%>wJ6`8Hd
zxy0g}locHyTpGzGu{qO)%uQY#88=55m(%2zY$IYCDMNQ?qi&Ea7Du)!=fCke8Fj?P
zVC`dW&TJv`p)$0KxOjown53O~nMis|*a@AJs>n$!&Y`ZN6Uq)mJM$)yG(sfhikP0V
zq6#AE0vY4OSyjR`Rd!77Dw-u?s!F7n%<Myz9YNY1YjVzcaVE%$>P5`jQYQ0@uS;KB
zLP+~l!`w5>uwlBS1qFu<6QD~;-d|198pxEC`!o*@EL;Abuuj&RpgH@mlE42=wk9gw
z@(Jr|@^=>JMAvem(ruCUNIOxyRO!~Jd~Uw~^zTZyAZ^&1oReN06WQ_`qOvQcWmB$@
z$x%6eqB1k3Te`OM2ARy_ypGAquO@98$dxJgZ9F(evgIF$=wz)snv;K(<o-=QOH@|o
z6VcTqm&FlvEf*;(7ip{8iKk1Im5s_;_r;f^w42bJ$)#m8x|Zh>Pg9kZgUU*VCugm&
zEK*sySo?WR&TTJ_qilIVN!dCN&OL8^yuDwp>=8!Hx<#7B=Fo*@>pVHpzMNSx+SBFa
zQV))`?9oSJR*LpCnsfO&=@qSwjWiqOC=PHxJt)`IPt|!H<3zNV8L2nC?tS#4@6iNX
z{>?nj+1^KoH1+dzsrG#T*0QYy`lIeT-+1!A>|6p%=WC(2JElKcpf_#Rx7q4fFVNNA
z>D7Dm>ciFigBs~hG9iUbaMsnfYow=p^`F{SE7tvVXw#4H)wiqp#cF=8Mrv5=abJ_^
zS{HrU=(>*&WTCS=j{F$O8^=;?K4u-~^mvM!U~c)mNGrDCVe_xNPjf%FT0Yz%nFBqT
z13wsn{M^$&S+%TzPIW=)uD~tSQ<c;QrZ<18j=bX(?a~Ln`Zc_J^igpW-|35PPy0KL
z!iF!g<DB)|u&}MnT&+qcwSGEY9!Fuz7dY{Q>NKXmlSVdtxHX|gZFgT|I#owWA`f2H
znEtI9n4e&`f;?!!ckW1F_4yvqm~K_ueOB8UHGlUik9aig_II!S1|;9TPL`ez-u^i@
z+3<uv?DYf6cTcyqZdnh-Jb;e60#m6m<y0>d<GKS-iA9SQ6mu7fm=0V|i`h(x8Gwc8
zCofm50;&_jCE>tl^tz>t7+Z@(d)UhbOM&VN;F2)l1LL~4w7R!cR`r9}NT>@=oJaL4
z1vZXPJUF3l+SHbDl$apM6G}9qUO5gtXqi}Hl32k&!%x?rgjP{n!s#*YFwmjJ!!dCs
zf~}<0<wL9B77u!iD-3jL*=*gi*&P3`--bEx6*~6ZtnLpA&>x$_ZaITNTZ|LO!&hKz
zj#*s@1sH<;H3R$02^;%tw8bRR8@iH${bdFG3%>Fceqoetd^<9bwl>r}=;fWo-I=6C
zhL~r3dxF#cYqJ*8)~4l4dyXbVoUT9LTYFeDI8V3Np1+_qA?>I%s7UG@Lyn)OqvuQE
z-n91`hh%cR1wVJDE+m>Pj3;l)&K275U0N0Q)d4b%gR?Fqj$F2vTz027%}N~*MJ}`8
zTX!g?_oeOEoGnlXob65f(W}4m;Pp~<z+&>@6n=ey)V??EW}BkCLt*8mv$f=#wkas;
zhV7)cpUyT<+BS**r@L;IZ%$f@d{w@5VsDyK6PH3>wc!8htsB})DyX`PKj;7Y-ysd7
zzxcC>3?0qV7^aVNn|}(@eS<<+>AI;H2YPQ#*DR)xFvNca>7KzlGvjY=Fc}8%DJ^AY
z-zsSuYe+Ynk~#}c9fmG@rr)$|@rPcuLvN-7|3iIsjhbq1TqlNZTDR<iUdf?1uE1@y
zSL-ORKEPh+r!P}6N2o3r-n9gHk6stecxC@(Od7pLpY>#f?`D7);a4{6h7JtsBl|}9
zrS3W(U)_onxlg{-w0Edi)09lEwcwX}>$WY>eN9wn9o00s>$c@d&-M+KsIwN6@7gul
zOVy*h)sI-|KTvXk1>d|w;nFuG&}65oM+elS^rO<%t%?Zs=pyp(Dg4?3sa@~ToOZ>A
zeCea3{8gvxi+YE0H9zO-7TWWft%?mtr3pn+P7L{Lnl2|_%IqCdX?~`VzbyFDnL0R{
zq{j0`Dh@DMIyjGy^)ZjD%@LA%Q^Oe1Fml^CtX}3N4Z~R%bc~O-bBxvIllz!{ZJdv7
z(uxQ3epj0Zk&CD3j~DQbdzm-dI9ED2Q@nKREcL&&am>`_>Et~>-MT#ft4aDicb%oL
zZeNPrGM`WDWq#0vCX+4}`aEx4)B@e(M0HWVCe&RQmB$zMF-7X4MdZbHO~+Do(Ju#1
ztDcp9EQ(CB&`;{%%;;n0YC2NYMT6=h#!>#7R!*e4XffG0MSrV+Kc$x$(9T(x&%b-L
zR&r~A*2aO=%eRx(emavp{#{%BB`1AyoyIMgEVj{4Z{>8Vm&-J6&bqK9GWxQnvRU(3
zG_R7SbI;@F_m!PgFApN4Z)z$>G?j+W!MnH2@DgX;repj++BxIZ%N_d4X0~zq+Ll*7
zn73H{2q9-p(H9i(>Ahvw+c<xAa2&ooT(qI>>_Pbx!`w9tVHjC}sraB_=15}u&$;X7
z`R345<n!|R6MD<~G^%7W-9mrPTeoL{PMfHHbX22q*X_yUpYJOxRX<ux4!3LUma2Vs
ztLr_}eNfWWLQm<CPVGy;G<K<K-vPBRz3Iyun^N)7jMt6E26(R<S-$h_KHNxuy!&-y
zaz4NFsQ#j#%BoFDQ~T~9Bm8u(dHhaW{S7Dm&N@wLFxh3J_iL3tQ2TaiN}Y8nNu=jx
z&FW@Nig4a)mTqDm|6pIj33V+(dfwEm9?`7MUAyaAewTdZ?JsK%8jyThBPtdDx&3wH
z=H@SJX0=H_wbhnCXbe%;29aB)=+6}J$M+`Gw@I&cNS#tu33l`K?0?C@y5ZVkxzs01
zm-$Nj@+xyc-=IG{7OH!6c(7s9o2r>P<$6vK=W)UVE2fHnPaDD$b>LgY4wtW{-}Anz
z%h`SJh;xKudq8pg*rDR%;fn1m`YY1rRtJA}h}=6YX{;V{$hxqlRbQW`N!-ScI+rFK
z+WGW|kNKy|)}d1#EOUb$4G)buzXiN|8pAntHj>?Sv+-Z)Rx6TmUHr8A{L>4YR4)qO
zWYoN@+0zku>+o0FyTw25tY7>tGe9_^C+6@r?#p^N=ih5hk<;9oR}5S$=I(#{>kOCL
zI5@-TcvIvI$B);FS7L87bAB7TmOb|McBQUDec0>JugoEZboQZ*RlGm5zn8XWe=`he
z7{a%3^u1vU_?w#3YWRw)wLLjsB-zz=oWWnU8!CU)_hdba)Wi<WKRr@5A}L-*UKtfL
zAC55lN0?P3^&0}7@!$UvXB{Q3I-$Q9s2+aFpE}6F#>@*wm}dq!8CLs#?PzdMce?%3
zTHUvh95X-hqi<n`-g!TB^g?m4eg~8Nx~=GEcjqSh?n~6bCveV3m%Sh1DyEdkgPh<N
z7y9n$FwmtX$+{)U{QW6E)l4{$j&+!Qi=hDhF*kNgF}9(_noT`#(P9nlz6&j%4qQ*$
zy_vFm06vF)3UtLPp>IO?d^qqK{o7K;Zrg8WyF)g#%%be3LysoCKTQMbs7TSwcnzmL
z?;6?Eb1SZCf~LDSrTeh$+~tAgyOj&e@mg~7+#3>6{OOxdJl#IM{5Ih7eD&9Rd`q3^
zXIH6{PSm8DN_sZju>HT|pU3ar62%Y3ef~>VQ!$12d+py>FG+rl&e>Y=vQ88~ylSs^
z!;>wq!fOjvgoC8vt%KX;xmbWx7$t=`TPt<jIGU8*r#nA&!a(8ACBJj30>0iu=2it<
zJF*K+dz-)>$=%zx&}_Ef-_K9?Y~H~8v_{|cU2!B$ys<a2=SeY?_8|;wAg8y)X$`a6
z>it!97?yQ8`lDENVd0?eSmcSU?fK1phU38Co;&V@d{=(+%Qw>1Z#Hyo(x|@vot0nZ
z`(oen%KO=KgL{VEiTLx=hCbNrNec{KcnVs$8=5DY$25LVg?NdWxfQSu<~@TKZZ`aD
zdhasU4_6IY>y|)F_`M62Cj?%!d~cm_ap9dg1I3}`lG)#_*IZoqc+LPoZD`FQ`}S{n
z=JsaJK)w8XY?7=bHvZzmdvgY6t^NNP-rBY0*@jyo`~2fCN=`+d@I4<Ilp?od2TNMq
ziG#~e_!2f+O67gKF87n8{Qv$)uoM1>P5)rom@qozUfx{zWUa6=uZb0DnN?_*SWfU;
z*B$w{wj7F{J`_NQM)?{${J5XW0orb7gf)dgUvEr!?_&aGJ)~GHVi;ebe*EY%?gPw9
zo4(5qo=SrbBw`j;z~3kbX2S=*L*qQt7g-@oAmdKR*%i2nYFt4*@C4RmO&cB58KFJl
zLp~IQ1sS(N7p4PKXvSM9#{a@LQJ)UXz`7xeGw`Aa;Qs&s0RR6a*MD3~`yasZ&)L@2
zvh-6_H!b~Gzflv0btL^jYc*1mE}}(ovEBUGwKGb7^i!*d=|rquKawJZuImch#kouf
zx9e)xs_WOmb(d=2eeU;<PtUzykJkB|ot?*4H{CvlVeRyHX3m#^-i`-vCx8M3o5Zq@
zp+IA>vwqmw@z_T9^n3^KGX+hhTL&RfcXXNu`|x)9`=*U=9}kbhWwk}^*5D;ze?u*(
zgdTQaUtzMZFeWWM=yU}9Ohq@-ttTQ-ca-MA-a#)9n&Fv5vqQIt4qBe+0N502bUAc~
z1N$hGeUve2&OxUNFoA+b(|7wLP<PbFgPnYq6aKuZGI90AeZZaxCQL?sm{3<_!XYqW
z8;}QXn&5<Hf!)7?3SVe0b@x$fH1pr}sPo`dwha=EVE!!oxfJLHj^D?akMb2^7dCG_
zyKJr6eb)4YQ@0WvPD%J@j{nEb@2*YWK4n(C>9hGK>&b^N+J52$yto<d=(Vf8P*N~%
zT^_poW!EG76&KUvVt2pH3SWQnz~F_wn!3lkMy*}2KHWF@+M)&BDU+9{-|WpBBU*Rz
zz}eF)-0lyg`eCW#F;dxJIq_z|cA@^VA6jk8zA)N;1{=+#>`nm92s?uMOEvU@1G|*T
zE@j{|8GWG?^c%4I2H4;OT}j=2lKP9SwS5iv(-B<?cI&_fU+7xe?rh5L*NFf9*_SP^
zlO6bTGCGq9eG2{@03WE7UpUymG<#3*XE-WjLfsL^1Hf@J(1w><-UdDZqp`|S3N!*M
z;GsWbfXQTgAwD#$fK@J}Kx43IKP=jED$d6&r?LmI9jHG0p%u35=F#QT*ysvM+ybx%
zVNa&|R70B`*n61lJq(<G^FRUE4^T&X+yn&bjwXAsb5N{-R;~p5DQGf1E)aowqhU^H
zm>v4V-pQ_r4;9N|l`o(`Bd}f`N@Cy+lRX{rVPL(i@}(4L4Cd^IIgiH%ombjW;t&up
zj$KHD=7InzrbLirM|2(~jtK%>*~e+n5};WCG&8~HfX;=qavP9584YAYpMvB8prKM4
z{4hPO+zlj$qidK@cjUnV@L)6O7ZvANvu#1ca*XQ;ZAKa%ArI)ZxcMN5$qoSxtFTr_
z=oCsrIMVPD=+)yMI-oodcMJ6SK(ncFP1FWE>+&PuffKqF#N7vdzR>lw+uu@d|A90n
zPF~H%SfE^igvCLx)60_>x5wGDy^$;*tQeG6AYt>MzYRLS${$Ib+-aZqUi!=Hu^o1U
zLlf+r6GK;Ty!LY9aQC!^Ylp%PelPOlq)<Ps{lSlOEw}E@n^SG~dmHe74j%rr_3MIl
z*;g&SWy{o6UHPKb!_2ieGFf5U+5^hS(_s(SX<6+7;qOlTx^e2NT`!bRH}kTu*SK8L
zHUENSeTdUDwxnIV=9Tcnl+t!O=LeT*eJ$_f>*gN$l=er%{S`C%TKX5HeU8i<dHv4D
ztU9phTI=nM%84Nx$KIU3@A;IiITh`vIxNZ2k{+`rhG-AnmF&&>I8#4rT?B9Lx$6P@
zOA;$`N#{FsbzH==fc+Wk>oT_W<&^#^i+*}llvP8XKKC$SzlWgWZ`t0g8g<<F)8?K_
zpLj9y-^}m4hrb+se8pke8aZpL=27gPeYt`!6Hfl{+vB5)K3}b@y#MyF!1=e|Gd3v`
z*KJsQbYF`XXL&EJ_;7KBXa&@K9eYzXzh~JcecO}ORTJGL9X>x!t6ut^o}Qm{<$71f
zv8hik>jvF(U-*8oq`U9C$Sar9I8%)m*P5?A`Pi{?(@w#<2X}0Fme{6;=JB>jR5M3-
zTTqT&UoWDXd8#tD9~z^&a;kEy<oT4>>8o;=5qIYEw#?>C9O$irHYITC&Q#vd<aio;
zy;U;2vP??GL+>|M)=9~orR{%ZrF8zqPz^OydP>L^!FCPwnZ(A(vl^1xU;^Yp0N`1r
zsxdvZm}ixyW?ObCa9Nc*n+S;GS<P0n2b`5qJV9N4Mszz<ZEtj*po+ppyQMbq(A$lo
z15%s+4kqe!p{ssw5RH@Av<Q}KpwA?Gjl8)-(!H3#;Xwd}H#b$iTMsSf%}rDL!-I`p
zm77Ea%;U|St@a;qu7Wlus1KYG{hFyBXLR;ft-wXa(!KG}UmHb-rF-GQhVbH$(Y%}S
z>S;#jY}KF1(6&A$A)WW{fD))28$=Yzyt4wP20BhU@0=i>*zox9bM2G;xM;s*-VQ;0
zS3rOidPoqEp;mSX0*HXQyyK|ac|f@zs!URI2b6S={JTk+-Dz%;d6j}3BH%9X_;G07
z!+>K0$`6kNsJvBiYL-#CToslKo!qZnr8<YdIy2o=)x2u9I=D}1r8;*?l+q84P;I;{
zm@Zds#6_hNtwJ!pD}W<~9usWo3b5n7tvz;aT;oimlA|JV(GjV3KJ@n!qS=o%e>8~@
zNnp9aiqQPT8`A*&R<F6u8#DV>#wPvP9~aV8dmBU!lE8C<xf*D<B(RTHH6#sG2z(!C
zXuPUa^?p6Hm{*mi4zs-a{kPs<3QAUo^(~~Uw5LRA{m=+i;AO!WxhfDB6-s`@1Y^21
z6Qs~%f<;{#oB#GWa4yie&{y>%E~=9LI1l>hgec*$=C3A^t>niF!4yK%$$QiQU9H#L
z<30Lsk5hdYGgSQzA`i)rEdr?q`b@IM$eS`GU4sd1A7~KXlvMRDJ+zoNB~9&T*<<P8
zk>OfgR4G}rLy*v=36Me$2|_Z|)g6KmLNk|l9#y*x==VdblhhFd`u{H4+kJnZiBokq
zh}<P>S_F9-=rc*bktZFJ_G1E%2O26*nyN0<LyLLRG<7I^KW<r-n?Y#i^Q5!Yp#%CV
z=$VAqoQ&5TxvCC*&3RyAO17_1)ivBp#6MOhz0U43xmxbf*x{7Oo%ilHd<-`Z{mP4+
zud18<I{T1dR)+dWhhP?=iRFDp)#C^BmCz$eYW{$pVcDhTOz~+u-sgBV->A=44JJd|
z`lekjebw{|E1km|ZJc)MRh$Py^35>;wJQf$UVKrk>oXv6D;H3SoS%5M4bX2N<}?m)
zKRwQ|=Gn%py^P!})vjbHx1YO06$9Um+KiSLV>AzUOWYI!@2(slDfEzFWrn)BL$H#_
zS->lqt)4u<t%f!yshI;@1a7dYIFG_hh*L9-+~q32WN33A_mQ-AaDZ#2I??dZSyFpW
zAkskHq_xe0aCoDw);?J+U~P!Ldw3eTyLLMBro)s?`yW_-$YpOVb03_qg%5BaOKZOl
za2cw<8XkTlscjK#(m>s%OU?>L!M~HQed2;Y+#y+l2}X70cuAp$1oJc0$2$b`iJW*|
z$ZWOmK&ujZJV`xfpp|0TwCQMZo)zzOoO+D0b%iP=8G5d-wM)9>>p&}A)z$FOO|qm#
zuvP<gmv)~OxLXe9w%aZvhl=J|H`;>p%kc<DXftyDk)peQ{k1!Oh21|7ynpt<vY@18
zX&=9AE3~XB*G6}Ej5<%P|Ncn%#+5GlNjB%b>%V8~OAEW>q4)gs%f_yGC$~9YBx;<c
zihA?XdCh&baNCyu!qpGX{Xd}|pm8U|Ip*MV1moEY82~09=(p7VMym7^qu(0!U^aRK
zX%=4U2<1|wD{ukO-=Xfs7rdpRD(glk0Fxv193t&f@V-)|bo?Go?~3ulh1pD~yW;XB
z;aJfBCo*@DUp|6|()3msOibt#>~cSvF|4>u5iX|m+n^b)jVEc)67<EmMt30nh$+7!
z?fV=X-4Q7jU&qoXP@oa`Tb?jqj=u$Z6?T~_%%}H<Dxls%J9<BY&YFp*YJ0~6{Z4Ev
zfXPb%br&XjG^!(oiJ(6oorN@VsGpTkwL{}r>SqeRY<&6P)2&xQ<5&bvEd6{6Gy?yf
zCwvFWTDIMI_4n_ernOI<dGGCA%c#5c^y<qE->-l5>TiCqo>4HkIjX<t-Djkp?*pf^
zLeBu`lY+tis2`}-pRMYz`RK<M44xBa20+~k2b+bF_WiG!#~1s3q1JEr(c2Zk6aal%
zFgOr3JUnsZ@XHC0>q7sJWire?6S=f^(0$@Y>Nqg~w(qg9z)A)n0L2ZUmW0uuxhPeN
zD@IT%B4#7DG+e>r3MtSSd^U?~jnTKD{pr1QgkV$LXz0#y;&K`^7u_kvuaBTR5%DC%
zmX2R%aZ@SK7~G4+rD3}^qiI!l<^ZuZVvE2OO@T(>^*ll-$Lj%CiS42gLb_X^0_sgn
zqPx-28#CFTk7eybh)EPUjT0ZBL37a?Qv4+{-j`Jr%e>K-^z(O{m6Hy8`m$=u9CzI~
zR`9Yjmg$`;rdgM~FVL5jdmvHXad7&!-XR%!mRX`NjG^1RF{8ZW#Xi<0S@jjkP_9kM
ziuxorSL>AAlM-fA5K}?;+q>P2I@SPP<>YpHRLN*I*R3F?k`UXw-HkeS9Gd6sb|Y#f
zDlX<UY`1<h&faYfoLHkuD*mep;!~mA2#iRzcbgxza<({lR7n-|RFe3cQ6<#+4M)lc
z|Ek--=9U(8Du`(=Zk$5sA!2ieSO)4pu(?MHI(HJAUEC%XLXQzNms$|zG}G&|(>*_o
zpgF=RRlLI)nj7ULt>1$b`0XH~9c!(loYKTcouMUBm8oJ!>jbhufB%w-7F8Jsrxo?_
z$<TAmgswtAhJ7t7sxn?2W}UFQ{!TJ9!X{yPeE^$#(<$)ef+LhDQJmPu8m44uGc(~)
z;fX;rk2_|&NA0|h(Fui_MJLFnIU<8)y?k7+>9ov~2`;Gp3(@rCxq$?4JO^+~6er@L
zcj?>=M(tZWt_OC)iI9NWd+0-7=sH^Mbu=7^cQG2SiMP|iT{i9txH}cA<DfU_ToI$T
z&yMSat#%|9fZ97~xGyw^R(lg|0pe=Q)7EWw0e2_hX@I*=u{s{AqjS?4wQuaW?$~N4
zA{W%&MO%EKd9=Yo#dZYGoQc;d?{olSBJI;CF#I#x5r=02<5+j1iAOYzpdA#ViS{W7
z3~SMjd3YvbT<lG(XMJ)9!+#-<M1E#E+TlQ~2cO)j!+whGRJ<n_-6X-MkD!}?cr<bs
z!Kbshu@q<weu>2$i~Y3~?YEm`(UDjRYIW!)U+7wDt(toGBcqmqezX>k2X|NETO6U`
zl)Kru32=L;Yb+PT4*kd!^8rkb&^9E5P`La{4FR|ntrcJ{lL!hEI!@sdMnr)nM#NU=
zH<5-H(pv2?n3&LR%%u<AH>7YuhzXP>G<4rMaRm)pjP7$4PX;0XVEP#sg6a58TI)E>
zC7f8ngg(Qnjp%&J%&N1rBlA+D5`BXeYRBsLBIf*F%lbo8;M-}L&k@P?OZu6bHc6UI
z)ckmHfOW{K`s2ya^URQkh1FK}OXyL$II*jB$jbUv$<T0{knDN`yY;zK?ePW6Mn~!5
z#nY`}N`|&EPZNbH|7P~4{4{r+RmT6ZOt<$vx4C%x^rU6IDPhDsu%r*UyV$RZhF8&A
z9Wj`g&~7ZH4?Q`gNI{4|$`UK|<T!B^4O)zzbQMnlr~koRf+`nNi8YiZwlJNiLG#eH
z5`4-Cx)z9Sk<$o1h1D8EfyUtHS*<Qu*H$#B>dsn39D<y-f+>XpjliWmf+xqNptTh1
zLI@sx2}c3-CbrU-*r5Zn@DgqBXV7{C>!QLmQ2}))=pN#okpvxdqo_L&Q>l67(47uq
zZ)zS5FBxCHweDyMXsy5^C`1gs+g|~7C;U9bBCKe`p+A;C_uD$IjXAzE?@!Cvd*fol
z`$_96KP-Q~+NGNnb!b-oCT;IscI&}{h@FHb1s6gO5iS|xedd5xD?xpT#3oN65|65j
zO7H!D=oE>AsCicS>G8yvRb&e2o`<F*FjYZM+8XmcjFu1A9>kbW8T7!mXX8D-#5?e*
z-N9%_AEaU<@3E0&KQn^L?Fmoti9sFqQj7pRG8dKiqw+!OFcXzK5_RAchdLaf7@^^j
zCFrwpVt0`D5qld@*@h4ilx{jqhiK4T^qCZYGlD)t#50gQ2L6WCnn8ia;2x}2D)#+m
zw5;mR3?OD8ZvaelD9{L8#UliATm@PyvF|B_fZiRTfO-?5^lmG(eI~Bf_GW<Aec1O1
zOuh=JJF(6~+!jf!1KkN|J0hM+eNzo>a}e86-yrxb%a?%WdE0>44uKP^HI@R6z_0R%
zWpex~XsyBip%BaH-9ZYdH^HZOGtjRiRyGcTgIDaZe;f!t=)Q%1^?_znyPK$QzA(D&
z(63B!BzTjJ4?9AqQarxJsX+1*H91oMCjcI7IAMy>asO4iM9AP7?IiZtXh&i;;N3<U
zzEClZ_X}DCjO7gHIR|Cd*k}jB3&7+9&7$&7Q9b@)@K|UO(>Muutj2FRLL(?1%W-cY
z`Gvao_yRr!jkPvf1DG74&4|Y%Md={b!wNq}lQ?6gVMG!W>ZT~2OiTv6zmS`Y{5+}n
zN}7a)!Ni0<#YzXzTf>S{DzSmW8;#y_HD07aOHj@@BMqqDV~zopiGW~IcnC}dG-xi$
zk>ZsjC<ih6ASxPO$&w^fpfR|JC9%N-ThKjKchtb>jHoCu&7(jg@P|AiM~*)Pl3EP@
zA42DaD4^biE1gG0vn}5-x(;OnBMVU>csNTELxD!%Ej%Jkj<*0wHFl3eq|tdn3aB?R
zoz7#RuV>;*wY{5wq!hb{z{F8N-H9z8#w(G;7QjnHUn9nuR8<Z1ii43t%>ei)%biQT
zHws7;SSTQ@=$F|Fs5>#&!+123m<uk)p<@x_1Zsv7dep(_NX?+&^T!M4t|EQG<!H19
zz_cH_-`03;wB)I$F$`q*;W{8Ws0f`8eQGT!RGb0C7`w*WFp~|)@WO)tOmWbgbjc#d
z<$gQK80?HAu?Sq&qKkc@YiO4{(Z|48%UCEnD6_@RI1p0+Og_-n)XQh68DAKeN28CK
zMjpt>#s?gsW;@}iFVlXWq2fu!zvG+K=CV(1Ut5aS>YwL4x_WDI@tLG&t#A4zVo_84
z>j>K!Q`SH0%-H+kGf{itjsC*2_R%GWxbIS$@@8;?iwAFcjJdG<S=XD|wvCG~cbd$V
zytWPb(cWf7efzGj?;guk`8Q0vIzFxaJ!NoR`-hJ9gr4-Nhf@Vv$8X!VHCxMX#0US}
z^WA>YzwQFwtRY*@F-y9W^?UTx&j}LIi|Dj-AAWl-Im(+{wSH6Oh2IjM#7y1d{zCc8
z=$Cu!Q0K>?YRync+m*qV-;a`Q_)tiwe13I@m0|r;ZBLi3XLQQQ1%LS=ZO<;U?b1+Q
z+DL@5BQIEfYvD*~`bhe!+a7^(hPLM=nV)5vAsi_^J(O{E=*72&cYDcv%}|EFyhhhk
zWq225YVRb!EHJ#gWC#zM^ESz}O*k^Xrh}vF*-3uMHM|=zygS)+OjjKe<azH0&JyYe
zlf#!jzj<F?T9(PO3<=7&H!REi+Hc<0VaAC;yXS-b+2MSA&<-D=o-w0ca`4&nNq?k%
zAd+?Ao#);k%;o<K&w292Zc9(3^6QA#-(QP5e=y%(I8u?$KNQyMP$j1sJU5tP&kcF|
zn{TI#G%p+3aF#5aYqFf!WTpI9gQt!xs~=jq(!@DICO#*pE4>mMhn)P)1-i%zLmg`3
zTp$xalZiX4<bm4A<78s}kSNr=uv%_osB_arhF8h|s$N|8SQcZbn{CQoI&v`B%+f}-
zRLRfO$j6@=+LSahy-GgXP`AnS`rObafAjOykwVSTs5aTURkue4nkm|jKgfw$rm@12
z!qY?ZuMX+HHDvB3Cu)Y~`<wUcI+TXYC{s-**|flrdCBl7dqQTCX|Zr*OpV-E*Rg|a
z$~9yT7%~|_<|Rsbf+2H`>G9H$^TB2}ZAV14d}W}yGo&ulmE5K6P>|~{4!Ng|*ec~K
zgUl%t%@L`lwxdJofo2zNhk;zb%G4$tIo&)oLuATdx8-w7N>7q0UpV4XBj@Nkc9QRM
z4Lt*f9?OB2DdmZVo;jv3OGmB-o5yQArdFH34K!a5Y1$t3nh|J5wDLbl&n%OjaAfD{
zq1dZKx4tz*?j=1nL$Utm3Y}bOh>S9ob&_=p43U=%`-0~1lT3-i5vLlnk50aWtjje-
z4j3XW2TD_#Ex$6ybbskcOR(8hE03r)uLv~X49SdgB@4B31(|tqXl&ZZD5ZHtK;1ie
zE15Z#qRj7D5cKZMZSw6=|95ASw&bTxd>6Whd|O*DySAQXcwzRc7A3oqw#xjmbGPJ|
zXxnvLx8%nw^B)Hr<`@lgXhEJ)O1s&HIjG5gDZe1tlcFt}RBe|N==mTdbDpc?er-_!
z>2*mKm&W%|+T{d!&YS2Nm}(LpmH7vH+GvaZB<r(GLLpz-EE9`N#5&UhZ8@=!&sEyp
zHO$eG_4P7wx@po@)1>R#A_v0_p=pwk&#JNW))gtp<;8{@wb~-7u4eJBg5%`!dRc0y
zXG*o*D8r3zZP7zr(Wn&uVSmq3ZP8Bh<we=FH2ybAyX;`k-xu<)q%SjxPPJ1EH|Ch$
zFXdke_8hM*YO5;4Ys&EI`#Jue@ai10e!n_DKk3TT7a7N<wzumB550Kd`@xd#zF+-C
z=8$0UzHE4O-9aOZ_V=vN#VQTnQKsD&$cj&7#f~?oxE1$fkIwRB{v-4G{bNP%kuusg
z{{9X3V<W1{{;pokzwsnPK~~huvO+!6s>@gg?`PWB-*mCe6#ia+&q8gif=s$7b57&i
zD9cs^dp=so|IxDL?^fhnX=4k?q)W1eY5YKC*_t5Fgo&OZsV4DJ88^_=RvY_@{4L8Q
z7V>MGWfGCexXx5p<@K9JCh_-F>0)aP$L5%f7s$z<$jLjZ%Dl9<aB?y(V}*LosV+kd
zE63?>ajVMus+*cvd*Tf%qf7^u@=pYNI%#jUR+SyEDI0T27M#R)sVcKFtlVHqJtqtH
z_td5GFKA@BZL;uHak*bSw|{8q{C@xLx+xbbcWm!^BG@{dUGhd21Rt*6WSX|sH0`?f
zmV@Dy&@@fRA6--Ct-GZlHxwIQ)oO1^btmWinQXc!<cHRj1?g@Tk{j|2ulfwHthOz5
zO`Q2-aco)OtLw+Kn}-_1j>s0e+Kpe-8P5N)czvK}Pe_l*)v-={tBCw?NhV9<^Oa@m
zgX++Ub?j6V?Wl|rSO>J6KS*Yli6-PLnq^TUQ^7hDUt3<Vkng2TylrsOlFWKpRJtj8
zt10@rmg8t}N-{+Y`3^OSK03}0a!;|r>5!K5z0NLqm(K}uPrYnKXkBV`BFo_POw0LA
z$FW?xJ^pnCT8@H@zbJD|<1>|sD}w9v3;CM#?FYhq0;&>i43!&A4d-OZ{&o5k{=sGZ
zw6o-$Xj9fgzN<2^(@=Sbyo1ZaR+@TGkau2?T1G*8kdQxJnRw4osUz>y%QmK)oVS{s
zuWQxz29eO@EaY3&Bzo!87#UD(5Y=kc5?z^aS3?6CP%oPoT9;g%$TWz$wdw~twM`1Y
z%D--}R=tDNT$BZ-@y93=R|VH~FXW$3-`)`BGo>og)*#ws(w~#9@vrMn;g>AqC!8g7
zqD|a|d|PGW4a39RWDYKKTWM-NLFT+5k14%!G_ocBb=5j`mEmEOsr3Tc_lfM=QI*Ki
zs*jO<xQrKCC#X(j7#_On)KjYx&E{$C1K&;G+q(SKM6b7J(C05+%u-z3b}J*%^5{hd
za|8SB=x7XVKqjC|O@Ytab?Kj<FPio4%h<<@wq3Y)@ay6i55o`kB^x+vDzh3$*Lqn@
zXkAkE{r>>~0RR6a)Ol1B*V_m1$s{BMg6x~3hzdp!P!Nz*$$+J@NC~@ahN^%YQVnR)
zm_<|&sJH~tVq{!U6c7c};=+_lK!YYJ3RYZblg0$7(gD;2hwx^8?;rPk?%b1{?_D2L
zwf{Y7u3vAiSrgYIF2uG<PEz~t(ywdbdeCd1q=mFLadVP*Cj%pMJZqh$x$no%X6v7_
zLRuTR4z1kN3Tdvjx|OA0$_g>BmM`ed6^^Gis#^!8xk>89+fQw-8&AE!P4=lxIxRO-
zw;F@|dvnd3xPfsYbE@QIb?Ywujuvhpz4lpJ$o(eno+MsJVB{Xp+PTtP&G@Tq{lBb`
z`wiS#t=wY@sm4mpVd-61A(U#lTdzhi9^9zr3`#YL>gsK${<%CJe1ZGDPi?|!IaSTM
zC)N1%YK$xLi3@S8lAEYGyYv|?TpxOEZ(7LRChpE8UR_}1PS4soQqBAE_H6wdR><83
z?z~p+d1H{ZdV-~2#R{>kmM`qp2*-;W)f2{`Bz4gCQ~%VB7hT|P@TpBXEjL$B7=!$K
zHO3W%#D%z4$tmiIU3zW{H-ug*PYXesxV)qduTO{l4Cyge2(w!5+p8%V*JrBD&#280
zC3gtuY=P8KFmCcImyp^4h<vlW*^1;2*b_;wxjeth*Hmr3TYs>H8%k#@k~)s3cCfan
z&5w>BuIIYZ*`>XXC)MVm`mllV!+C1+hViwxBh3=@zq2})Rr@aObv!bDI8$AIMqO?U
zDy6dzNgajb;lFaNQ#(vWz8k&SFOoazJ^4{Jm+4i$X6o|Y`im{xI6C`9QpcIpj`dsA
z<wwUQ_1xujc15q_DRp_Me&fKnBu`!5Fs`{BS(czzvN~2)`}*`cmW)d>)zN3v(Z--d
zboN1MwP4)+S1vWRgCz3(!JFNe+;Q2HA6j#HQI#)M9lcwBvV|K-XZIy_h*CQex2U6!
zj@Q+5m(bZ|z11hx(V_bIf$_RLb#%k{p!j{iak3WbXpX+Gg}ar`9!%<}NbOj+rFM$G
zFyvF*5o06cGC#$A#~Zms<BnXa_>|z9ou}@-KF;5MN>n$VeSw?m!%jZ!Yp(9SC$0AH
ztu`K4a9oE=l`lozyGy^jg&Ry~%hEa?G;xc3JEr86nM=<S&MT`+bn0MUku$QY%Xh4d
z-C4ozeA8Buf9E3aBReQP^7{03vmaaS1L!;NT<q57cy0Uh!K<>_HbLoen@-m>*)?q;
z)@zAe_*udUz!QYR$@O#st|R1b3&(G1Ku)fouG;b`<zPSiXbRuGeafqIq<M4ZbX6Ye
z^%Y&XZ6fiCuF8#<eT<#j-AqHh?koA*x@T6j>1xY#weeW2o8hX<OoH=FLg~!407LE_
zU9BFyv~7a>9m*`$)$YRNn=$!(L+%Y-(o<bhSUEeqt2qp9fG|%Nq^yE%qD;Bf-Mp=w
z-Cx<9XMU0F#!D(?SE*8}(1tMV`VC$GQ(eFDPcdE1-=Phm0E<9$zt}bx<d+Jzg)*hJ
zyLo3h`)#G`+M25jN%JhUfrE|s@d``XZ|#vI&d7IL(CwwV06Nd2lwGWPc^usiVY3Hx
z0eR^5DO9z6;>BfMfEzF77(1c6nTl?|r+n$BdTHj(^R`ADB+Vx1_FY(-AJ4m#-8&n(
z<IT%scJOv3*C<~e(cKQ_<vAmPUCkfL*gX~O#a+G67zORAB|br;zo~QPcD!j^===ZO
zQFTt{94OOuesN%ICRlF{6gtB<NVu86r*(pTZs3cBf_)^GB`~raT1~}GC5*fVM!o{h
zw~Iz>p#wm@9QfppI|gpa0#}%R_;`9m^UquF{`tTPKtQG`AP_fMa3oN0Bm~OIJAZ_v
zumWcLL2IbE_kh`FfuF;^nF+Gd%zRg1$R`=$8uAy(XMX+*8+yFYkiVmR=+DaLx0#6+
zVOX~nvb-mMsVeA*?&nOj<_ubM$N@Q8I&?@GB-F*M<k>nS)UN!EKM%cdK(4tms{>;b
z%7*NeL26x0Hg?4dx#q?5_vf`LltH#=O&peEg*f-*d#Hknb<Y~n)#+S$B^#>gxul!d
z^<`zpV%2`DA&w+}XLtTQrENZEpEB=z&Gh>p-{s4Uj6WE1k$rvEq?vXI6gY%HyYkLE
zkQ5-0whS_-;{FPx{Q`KeA#I5Sys5A|(6(7{+6K1`Y-=I3jT74T1J^@=Eha#d6I?~Y
z%>bHW1Oskhn}=Y4q?iq)`9s^Oxaow!KY>9V;C{Pk&<dIZY<UFaEy7iSTegF37S^yg
zq0L=z2T+_Q3`XG&m?>mrg^Z&3D5)nC;JHBCCcz#XTn?cvh%i`UsyGh}+Cuw*Epp(4
zJ8r&-HjAkJizpg+KMVnL0hmZEIF4Iv4qu`wmVYZaMpB#r7$CHktfdohy`aT&pvA6m
zMPTe=P)h>DPVgxbZU!KZ5y;%Y0uO<Vq;Lip{!lIzH=S_rPvD*on0k|G3Y!B3KL~tm
zaCZ?30tokxe4Y(A{A8i1+CVHg{1V922S6$M*|66GvUb}63&k@Bq{fwv6ek9i4OuAn
zs&sERV>_*o8ZX{nf8G~`a<3zLKLPt_g?!U9=A+tMqI=tf?*CKy<v-PE(20>ybU%d6
zb3sZfhKR~9KT0h9RV9ZVnCrSMFX?`;Vpgb1p5Q*6ja>ES#WH!D^3I>PLl$?9Jwf+N
zb*tTYu_@Sw9Bjh{$(XzH%SGM8`8?laL($!1Cg}cD)t5Vxu@61@*PlJFQGPk1dl<~i
zcSeG`#y*q{^;8TkZqpt377MXMEW5@Yp<f^C4$SAdZpS+A=nhQlrkY2i(XU}xhYQkN
zG32QHQYabA?H+Sfex07yP8)aylINB;ewsq<W0^(&-%V})Y3emF^%Z#3Ry1V`@d2$I
zn0Ch<1D&!!nrYrAOREMx&}1OooTB_U;yOQN23S8$Y;54e-Ui56ERYjIJO2DG*T*PD
zsw27?pcE`L2McxEFlKpibUL(ciqbja+SR~6o-tjV^~tj3hM_Z1&>8aEs=V`^q-9P3
z+5fjJD(-#Y$QfWw7|AINSYw)H3ebKKxY^*|0%^Aiv`++wEfX|%!3AKMh;Sqd_l3!_
zrz9tb!QtF9E2n9fp39dRQ5h+kawcD`{bAs_{Ks_cZyshpxa!do!;huRb1KVfv}6tT
z_YK{`r@Dn<<;<`y*HCmVgju`r4^=QhW#!Fo*RAEuzDne~n%qSaS1P)8H+I6$5K+qP
zv*(MP`H5T5wMTWA=mvTzvrJWa5?vdL#SQ2#<)Lf8qCs0HDz4}*xf!+`W2SYxTA*w1
zD=U|)DyiNECu=@U;z~q&e#Dmh8JtR)-Lv_P-iGze4#Vo<TXy`VU9P=ok5sqG&9FWN
z+m(aux*%~~tgO7GQ_VN5JjVRK+m(X$q^c_KN?gZ!X3}bMS4mtg(H;(l`Wb#IWxliL
zA9Uu2m8Pt+)t2Rgndmx!*Lf;e;vc%<|GNWT=Z^*oj)wf^o_GEzX_+<P;rH9ORNQ-j
z$64T1So-v-u94br8~8SjhR6p~i=Xr}smU{oMn`IQlrvvd&YTLAZ!TjxD`Vg5PGw_H
ztoSWn20MR)NTH0iMz6B4C02a1p4tVfSfMVV5xqL7jQylyKYxEV3cVVJU31}IuVC6M
zV+$p<Io-7mY1q~Uh81N@3uUZI_k1(9)r$X1fT18A8|Go`+eKFruwg4cqo>wK6<eZv
zo{8q3L30l|@Q;)-i<NSL&VQwW=FBH|)&B4^^SJ~6itEgUK>4~drma%`kIp|EJ8Q+i
z;$>LsZ)j8~<u+(;9F}Uucj&2gSIH0RS{u>a*Gl<k)hIi&HU`aIgS~R$->G2EQOfs7
zYBzP)+NNQ_3k)u0Oo~$ew~n(J3%24P3ovA)W9>6#u0Ab+@{BU3qf)Ncak8;?EB*~H
z!zzEn17nmes)@sjtoZYKY8R{I#kz?`RAY?#q8c6AcrF&ztikjy{EiByt5UvK!p`bu
zTcu$p3k+Zx0w{g|(wT3@Osx3A07F<hc9@6#I=ISwi6N{MIj-^*p^jnL;TyX0r@Hd6
zawMXQ{VnPkiiNxIPgEeLO5c`l_KtGo&q`NzP403Dn}#}aFo~aGV=3~dJ^!dPKXMCN
zU8;+w8*ECELn_}BXf=en59p%v(CR7FcI(8_I$gAzA^sSW*v&RWtM4g&{Z+o^-UdHw
zzO#f)Myq#W*?tDUQsn7ue!I6}H`B0oa8>UT!|qb#oXWQvtzLtvZ|J<9>b#7z3+rNs
zqA3t&@4`P^fq=^9o89cK<w#%U%&kCqR2gEUZ2m{*m5o(d@$0+{p8kgG3T3kmni7X4
zS@G?A*zT(4gSv)BH08Cj`LpWk%lD}<Xv!L_--Um>0-3FB-Xmde>So&xKI<GPttoE0
zU~EET``g$~1X0q7#<uBU@Skbv*liwndjI|HOAKkH$Z1t`75Xv^yM049`cyY+oagsl
z?6v62P^{2}FRnmlDVtln+4<$jyUN<|n%vbAwk7(KgMIQd>?=i#@2l9Ezh(;>RH~ap
zH;_vap(_748U$e$1G+hRXwVcov2|j{W!)S%!*|D!xb7iSH0Yi(-%piq_Td~7d2S-;
zk6^y75j2>8YLzDcAjjY_8q9C?HsmmQp?T+@+423mhMuB9y}BAVLrx0jor8H_kPIzQ
z=3mgI&o?+6L&Cd<K=kf<6@O>>OuH*m8YtJ;&2UO*f_r8%x@TOJ{EuZwe+3fIrb`dU
zn(X*qT|-jzu2h%qW=P(S`R+iG|5Pb`@AU_jd;*I6rDH$Vu_4Si1HF3|y?c0%Y{)~V
zf2}=-SQycrLt@TP-0ckJ*L*sMymjE;cSU{)l<z4+<|^|wy4Ts*2P^)4FT*T<!!bp&
zVb-njy$b0N!HZ96#^&x;j|r-fNB73}4l2hcRWAqLzlucnhGAkC{?!V^RykH68OrV+
zvQNV@7Z`lX5Od|2Qg?qdmTASW4lwLY$KLX=eS@p+FEQ*aMQT)Ir_sG@u(vmK`=9Fe
z8;@;m*U%dD3xut9;a6556y=ycANxFV;#>6h-|yYs{?7m3A%J}i3EADdXG2fN^t+k5
zhnosN_Pri`*S>Z1yg2>P?a{te3-_O9{u(Txj`p?fZ*XWD{IspVEvfd#+lLX$UccOS
zC&K$)!N}l^OS6Z?{|%k`^l#&D=|@)N9(s3TMt|!|!pBb`Hw}|t`_#|eZ+~G%dveE2
z#Sd;e<jwe>i#Sui-1msX_OY+AA6GPOtvIki{Q0`>%JU6{eUz&YHv~T4+FYHm^24X`
z!IZZloc<5~$(h2L#(R8^HyVjeWwvWm`+=M9Kcm0AUi|V+$a>D#MheCocxB1h_H^aO
z&&4ucpRxZnH5Yk-o5`T86B9cb6i5RMy8vQhBL^D6O%@k7a;yqooVkiv|7cY(>!d7H
z5&W1zsl(Ow1#cd4F&hXbF-jsdR$7;h;x+NOEh8>D;z#hM?guV|Z6%?aWy3CH@uNo0
z`Vm|o@xm*z6ItSgFy~OgF@el_Ab3F`Zi6gtAlS?}!{=iU_t+I2J1L7(1WOrf>u^W<
zf^$Y(%m;$WjGhRMlh$REcvC!X>xfIPScQkZ8Eoqb)vO$Lp@>zDoQx4%AF=Hf+0iVq
zEzCJs@V!7r9SC+S#BGp84g^z;VZ9A8`)vxoKPih;1V3RcuEQPf3(g)nXIz;H<7$M)
zPJ3>nI3XUlW#n9r__;A`)%4tv=P>7&g71rETL*%@3vsJu&Iy`zH)YO>;5Cd~NJASv
zcLKK}NwakHoXOmP_x62PR+}?&BQ;C4=d#7E@wkP<=llz0CZp$wV$NmGtOD6BS@1R7
z)IwRStVj{J>AYdymm)=QEJG8jSv7jD8uvl8W=?{pCQF<TY3B6l$psxhi1RPYg5Zgt
zlQiiAdI#g7rL3#@oUYKHF6b~3=cj7YuT6Msxubo0*$chTdd)Wq{jq`$qIk^My*4pd
z%gya?|Bc}Yt^K)ZYOc4hKxWd{4lo?oYYx7^&0sjjh|4<}j-i?b!x<!Tc_Sxo1UFe6
z-N>QhcVs9Jwb5oQ5J$tDqlG?^xKHXhuU@pfG;*8^d``)-741(M)pfW#`t|1vJ1E9I
zsd|28dR{@tV)0n0X8(YG!wA=sF?7Fxx2%w7I-n;M@aBtMAq{0fA3A~o4CeYm-e$3D
zsBxC++gtf0v1_DetwMjIkSAg=56UWi#9miqRas&$m~*(`hCpUN(7vD$w?P)$IAN=;
zU*3E$@Ix#-VLObG7|dI;*m%uih5kw1MC-K)&P|ydp70;WXbfhnOdhYvRp?(`pD-WA
zK;unmsE_$-uEoL_h(PAsI8pvWZ&JY9HJlMpc!NBeVIpq0%&{-H(IQK_hMQJ+<CZMo
zf2Vir<aU_zbHNRvEMTDBqY$@RR+ymKcT-lVX#bw^GE~DD&8Wt`m!u(&z5$HelJv)w
zhXh7YgodnrlO>)LkNe~Bn-zsSjXxlXYc6wa3wE~1Vy@w)74Ezx^Zs90!%m^hyRY4Z
zad*Au^b6b!#@!h4>rTeqP)*?Q8?yLyBPV?XH(C5mBZu<8lgrf2(!OyMe*<$$3O`2R
z_SA7+zG$D*$Z;(Acv6<BXzyk0t;5~k-`>Oc^1o~Hp=3-bTiw@AVSHJyIsXDTgMs|Q
zK**z*83Q>fYlbJhMlsJqo{5;<#6WJz^6`i2G1!I(W%-vU=4i2Q1`;VAf;2(Zvau_&
zu}%h3EE~H#@r@RfF_38SP^e~agY3XSJ6^fAUy0f8TJZ6d?0}+O&iGP?JJwf}HL}Wd
zpa@`CMra7yRas(6JnqerRhz{nc-)=AHp_>bmDZ~#Pxh{zR75YF_s1Gv;_8bf8}>{X
z2X`Me4)*50EZRJ>%50#B#HftWSZh~p6t9iPZ5hEj8GOO9*%OmB#TbFXKQ42HCn%$s
zTcH6EGcy?cUl@GjdZ`TlNm(sCv3L|)QfMHFnN1A-Eg2i10CIcl3@An-G`<Rbd7<GX
zgD;e^eZ)OiWU4H24?J<EU|z9o(?HSELfi(K?Ld+7zO9?q6kE2Ptpyae;64zFb<!Rs
z;buUwG4Rz+D3+jILRf7AU!_eZg1E_WE^U$~IIoASZ=bCtDEz^FWJvC$JxjvPfaEc-
zrW2AAw84bc6j(!>%m8tdVMp2|DA=Hb;%=X10}69+9|7`p(jF$^W<b6%aCIl-OVGL#
z9+Kc{+GIS4n+&JWCd~vJ^w3m{Xahmv1@1F}nw_*&B-{+BIR<{&2{jY60fdKS_$6&J
z4a7}`gJ_dv!8;watL^L%pqK;hBSQI3+Mh|d8Bl%<e76(ICuqG14^7~^w8>-;HyPeb
zo17(hr-#tnXNL%iZ@_&NXv|3~CgEm4{2GW)Ax>LBd|Sm3Fd0Og_7)n*Fp>vJ3>4vu
zo4`Ki=XnwLi%MqOLEF}W*Fp)GyG<i3YM^Zqz_sPyux?q>;4ef1G_sa-eD*158_PHf
z#y|2nKHCP`_LOXQO!zy2wbGT|8pv4*n5~8W2Iwxt!>4f1nQPbBY9D36mIUn@aLP&$
zvKh8?SCjyg7wqY)h=(cge<8;|tE~g*!ryIKKLKWP=x=x2F|aHP3^yg00g$yR9R$L&
zU{f31n_&26xD>GagCeba=3*^aV8i+rD0>W9yW?uXvdv()8M%xEoiL@_0O1?q2pilM
zFgyo-4A{M*^xcU`D7K;d5yHvvW13wmi0cE>Jy@bFm=4$-7F+~acI2`JLR>FaBDu^A
ziaRiW`fj)hTu-vI7hLpXB~o$k2`-+6{x~SSNMNl1%gE3lPV`?$xQ);s&U6M4{zcfv
z|0~&;#vp`KU@grq6U6m_ojh0-S+EmeS1i~FuxR8mHzBSUYaO|a3N1e{|HII){V=I4
z5?W56dk`fe+$-kv(^NYzC%OY5SpcsG?8=23BXN7p>}rG?iL4#25wDM=SVX~plI-RP
zHu|%6P;u`IlxLt_2Zc(2<pP!wp<Pb&V<g;0XqPkH2atRcwl(d;<D#Km1iBAVQiXfN
zoPM5a=j%kD2S^seKLK`?LS-bb+{~_4s3fwut`RdtT(Ha%LY?UyB-~7hx(+6FLR5fG
zAh-iCi6(+T++_F=O=KmonSwIg&f0>kFfhs#qB_$rkZ?1hqwC;rJE5Zh-J0MI!r#(F
z5g=|d+(i>P32eSXgS@BPSfINH+y#iv2yLQq|1=SGk)mv9B9h>w70U*Q`W=c~guBrs
zN(x01=+`VSe^}o@c4x(dQD#u2GyNI~HxqiY4&K}eJpt&>1a~65nI>8X;wHnDPTGaQ
z)MHBDp4&;qHrj>Yl&K(OBV4&iu@;y-VXoa|t5s#el?3f3aLP##k^@(|D|&#*TlQL8
z@)SuBf(qNj`NrLxIwS}oz{b*KOP!<w2b5scPSD+w95oAiLZt@-?z!+kHn?}ex-8fZ
z5dCgU>@g<NO$c=WY)2D?fw(@f$b%)#f<=Jnq#zz-MUkVH2ywkwp5!PK=o)u^9wpQG
zfa0xLo<NiYy0!>c4MydGb+gD(7SJ^+Jpic7fnV6*-T~`=fL8#bZc1NZ5gunjs3X8D
zXrk{xTpzg2gEg21w*jKlf<BOyMvn3l;(D<d<R}U>Y>ZpD-Wb<s&0+viJ<#wXTn!kN
z57rr1X9*2c>8pXdTzJw3_b!;71=9dgr!lS^k0TPY0hmS;g@U*~aD@k}I}5G=L?;A(
zAnQA_lrF^eVtJ6IB<QR$ZcVB&&d-|V0Z6-`vx{*50i`>@>{(<f4LVDu`vciI@KYPy
zJ7D$?@KQh|F~*7UICDZa0bWWIg@d?0aH9unAPa5;L{)+okd;i9dJ1v9Sb=0I8G6Nq
znQdoV39LX6|8k<&kZ?1gS26IvozN=+{To6y1^$;N$^>zfVHcW+DA=uo2CIu-z$9rX
z6b#TQMD=mp5_9@hs>t7oz8Fw1g3ke>Q^MU*xX;Z*<-*+r)(t*k_`Z2VC{<K0Fn;=w
zrSAB!k0WcREq(7Y)=oeg1GN+AK}7Xw+`IO4OQM<puQC?Rzl)5!GH%712S^`5MT>A%
zpmaN^wjfK*p&}~X7f@%z4{UI6gX&E%7ZAyfS8NGhk6a0ABFv?UVnJLV81rBmvS17l
z)e6RmEFM|vE5!9;5y+kZWWt^Q;n9Tg?b*+VK_F2eG>gFf%_LDl@^qplS_#Z-SfPOD
zW5~oEcZ-Q<7jzh?KW=<`dm4>z&kgh>L5H2{kCSjSpu;in@14+LLj5v=JsJL;mbf0o
zO@<fH5=nwG<8B^%jK{gb3xLE!!m<e5E|bI;B+uEjL_0y54J!`tltSU|xZ6xTyCDfs
zf5sU13m&%|^dv(Pr}{G_+zdz(11mcr388)^!JYyuX^9yiZZd2`O9TZ`#yE?Aj1Sf`
z6mkdZNyMt-xQEQ^FH;l!oaz?=Rg2)0K;lVZR1|KXSz?(miojZ8thVGNW3`PZC7KDM
zma~>naoYt^HBeo#Fp9|93VK>Vb<Xu|B-|z_+o_%gR2l2T>&M13Pdp-!0xV~;=RzT_
zBP-Rme#bIaD&QFnWfSU`6053k8|~{|h*d;*cgXQOm#)qhL2A=_7ochryxRtsL#PT8
zN-4xD3Or6qoF|a_vx=y==|azCEEC}RU&O8VdDo3`LV+j1G9h1|FT{0Zh1=F|T*e9q
zu17%jg!%=<BoXdK`+6H<5(q~b<NWK5aaE@EHbBxwILZchHz6rd=t&_akzpw*(OKZ>
z&&sCa-v4ao{W<l&4HwXvFW-wZ@7-<NX`j{@RiA!%@XCt4X5PvDUw`}jXl!BiikBHl
zz3*B__!0H_=GVVFDaDfdr~D>TlEiNOr2hWL?EYTQ@sv-y2dm=)I7^cJPsj6kEBYU-
zKfgzA766uCo4xePwg+dfKanI_I3xs&{;}b0a>qSS*VvlNjH>2Y>IRN}q=j4fe*gdg
z|NkV`dpwi<{|9jAW7?dfgi7XIBzNmDrV_#sa$F}BlFAfXU2=#hl%dj^6^%?fINYKw
zGVZ1#6UAMttvTMcuBmLgT>I_%egF9E`M$0_K9ASu{kg8s9>WknhOsV2vUVO7B^5~A
z>&SW-Vov{PsVK=)W<DZuPZlNJmyDghov6kg&6T*flLI1IYbj0B_QZZiqC>N!WxFhD
z56gto#1SREl(bZnoswi@t&*0ojKx1tOFcOmL#*l_tq>)7%f=o^(q2i@@D4;DN|U!}
z)>DR!VHG<PHMygYDw>iUh!N!jjR7H*+|fKqT01#5lI2WknzbhmI1*i&CBL@IGWW1n
zQkwcivo9sTs>xfEWDBj5Utt-^hCc2pqFHa*LJW)LNVMdRo+(e+SCN8_l4;x_tJ?FG
zxE`M+dWU2h1lENXvUjxX;{8q-j`FtWqq!bmC3^9)iv$+EfxP+&`R*Xs!$7n=ShkbE
z(yvTe)9;Zjxxy4JALn|6i&|crzSE+lED<eFmGwR*AH?wAhp{e2vV4z<stP0lb!0;f
zKeylGs;J6Swsu4kkSwaYFIm`pAfTQcis4iGJ<3H@c-g%NlGm>!ukjB2-ISD_qAD-h
z;TYBpNB$D7$CHZrW1_8LapN0;uXtvlxMyQNm5H`u#O+)UkA4qSBRMsgwW&O1si-Pd
zHu0F8isAno#mZ|W>nf(86;os;1eSVbigkZmmc%JW6n#?^eKDL>i{W46w&hBk+R6Tr
zEE`Hnf)k$`&MLQWN<Lk;vzqLH;TQI|T@yun$-*B<8edBqy&d>bl#~Ebw6|;|hSlQ8
zH|MssR-_zs;O{IS-RQb!HG!o^NqHd}|3{KsO<o=$YdtJ$rI)8TaNBAn$#inGGe5i{
zMOQQ))!+7{JcYqcsxrE-kKr%nwh1NQ4#`dvSkwmc*(c;bgWNV#(RirrH-WXaGR398
zEno7jQMCCz_Y6VQqNk<UZn2VR^9k9~$7D?mzblM&H<ESmsAzMc#G;<;gW+H8KSL31
z#><LFB-CS~&GnM8iEPEIdL~;!{hMqX$ugvfzuNOZIPy0&OQ<_!Z}za<DB@S5&HWN8
zoqQxo=G-cY-II|l^i;e-9iB4h7*>%ZU!8mAWVtx8LTnx-dvJ#wVb3?_o)Jl6<7E#B
ztcDh{N3`tt{mxdqYV!+{kJV%kXMRA1SVPp&&OPJNe@5|`&IGeImy4H*I#OldACu2u
z_#dNK`Hf^$SRCzd&2q7_=<EsE%Ex3BhW{dL+bc&)lPKA`;BA+=`ChVh&X#NY5tC%M
zTP0f+$0#m;Ydtv#!!PTfr-;ttWw#$lp1qPhQ@lU^6!8wxSua^!46D+Sugjf(Tp><&
z;76B_rW|-*#ht$>dDc!&iDY?D#NX`seU5zFX34qjvTb`<D2n)n=+8frbJb+aBpIt!
zat=90+Z3Dd2QOpAu$mnCrri0oa`BN0v1yd-{2emRo{!?r3nhz(WakMiS_>J7mcfcm
z=(?@gghe_TaOM*$#3<394lZh4KT4|+QVKq=RBovx(mWwkehevLaL=R8S2seQig$HO
z(3Lf1z^tcBo-|rBGhr&lVk&;4eB?shMzC$^&r=`zQLg<cokqwi_&mDYQca|JQs(s-
zvclm0i8}wV5!x3PC;vXX&mOmoi<*$+#LKz}=N~pe=qFI=AQz=C$|uOI3FoycEm!rU
zE=atYqWm!~DooT8ARgADSn7!KPs!+yAp!<B9CrSC<oUfvMfsN`FY2Im7~JK4RGCPz
z{rg8GFOo(1XSJ)UmXFnY72s9~P?ORZ@z57E@V5i3<pviF3QEwR4*}9g18RMi*20o3
z>1rnEGbSkcDNL$*hfFdMlzf%0j)$(Iff@%G;|A9$CK-S}!B8+7FzU0k5td|2?<yvZ
z3rc<qla{|lCYcLLCZu=cp|@zD*#TbW247c9(g*tp(0Vkmq|b7-u;haDAQS9UB>fW3
z^2;p!!9G0nXa&H$j586Gq;V{d^jexmK_^$ie-+}E3QB}h;UVZG8o1>Sr$<BJdGg|b
zMG)BM4S_3w&da!!f|4^F+P+>IIttQW1*;X}lm$VbrG|$fZ8VVW4sVZ!E}e&@V_OXE
z;OzyttHK}(Xp4s~J&=~Yl9u6%aK1gX?Vzm}<hug6b{VHF2zuO0J644IP(q8WI^xQq
zEdgy)p_i`kp#t0oW1!Fs@H+}J3Z$VJ*r))PCk(m@GCU!>5ou^L$XEb>4J-?)m4;fw
zdx~*ky)+$=@l+7xCJfSbf;Z>`<{X*^$T$flxWXF>aIejQr%o^l$6{H&Cl%r>1VNKh
zUOY672A(>=OWfeggMtAxc!U6%p#hCPnze8sOX|i1kBkWhehOz(2Wq5l*6{9PTxc&%
z8$9w<FyJa2&~btt^#KzOO&vUP5{h(%9Sd;%=0K|xd<@5egKVGJ!N&@4Rl<P^@Q63`
z;ej;ul{8hc3qCzGZ*bBR+Oz^FzKqip3_R+kB^BXDOPb`fFJlUErh);HG&LS-M*|NW
z;4N-&r($u2;AAkAfd*Fg(QJhSInp^MI5{pDm>15DZ+^{?&RN6cVjQuTh5{!$1TO1@
zE?Q2oiawysAu55UCm?lKSfzmd+#H}g!Fa_kr19{DY_!1Tt5i20%0mNm2Y8hmd}mPL
zVgQ;3Lp#ubejjm-&?Q@1!~{*p1unmZvsGNjd(t9n_&_mxZ!d8PXsQTWFLcp%f(`Tm
zZ4OZdtULkPxWWbn>>hKV-U$v-1nqwnQph$ExQL|w@lY)qsCR%}-QdTHAVaV+7>Y*&
zW_`r9LYEwAKNGA}1SvYI>T+aA`>o+q#q5|~;!?1(L(sHN*re!4M;}n<5S77*6Ogeh
ztW&`5HV0~*U_V9B+kU@7wt=AOtJEPLDn|pg4zRr&e1A~TWB^74Lt$vZxQ}QfY|554
zFu{m%K@-x^-^_c`25UI6m>tzi)B__FLF<K0ijK_n0X+^;6&yVQxx2#V1?*mPpwS7A
zQUrPRM-{S71Wh7oQasdx1{xh;tQ-7P5o8FC2199Rz@m?6D{RV<&N9JKMG(?a6O$pG
zwT3f`*>Sx@6gb);NLeRLQFNrC52$kZN}$IHNY544C}4M)19zR^or<7G+?|DNeL>1s
z>GF8!3L3cU0Izj}?+pr43_y=yC;$x@_VL#UQ?jL1OweOokb-n{@7O(Ql{I|0m>t>6
zUjlk4g4PRD6djr91G*f(3fOi6a&m=D3fLTTd1^E?uqa))h@pi-1J>~53VEuTJhedH
z?f{3o!6S+!W3Vj*YD5DLeSCXiisDze5oAB)$h%9LQcg?MIdT;N&;_zfL3Wmu__rX%
zO_-uMeH-<G<s7~S*me?1c7-<<uob7T!wEjEI2Dmy-;99GJ^VLdTfcPN8a^EXSsaEe
z=p4SaKwK@|Yy~eZW_$PYmBBN6h2mxoU)Ch;UAb(t9UNG|E)$9=;2AtbeIV_4CGEf$
zvHg4aJHRtuQ0xkz@-kajAb#A-PcCAQmox##k9ctSdf=H<=%XuqynsD!43wAwK}W&)
z0_j-{yt06uFBD$|=RKjVBU0j+0GRF@oqr&`CIGZS_E#y9D<$F~mspVPDg=z9pr-9m
z69$ez%N>g4<(K8gJ#wzOJSiG#QtaR4Y1Ta{(Hm;o1dqDHqiA_j1oZ4M^i0u}gFsv>
zJ!=ie6|*CH`MThIlu-PH!=F@S-Foi>&U-=URsgiiY?MHp%HgN<@-3sF#Z~b6Lbjzq
zJSqJX4=thrwmYmG4XK_dpTk{JHIgg!;GTo1f25jLuyO>Ha~R5@b8r}eWsOwR8uls%
z2)#Hh5EUh~e9XapRRk6OwH-uxLEbCmrI!IMf#oR<?pQBwMHKX66}-O?SSGNXkmkoj
zFVOOb?y!C|v|91Izb(xN1M3$6xkAgUV2LNR`hnEvwbaME2-wqu^8-up(A^dCy32r(
zz_O(mcen_6RnjB|Ph1vQ=1BYgg4dhLm-XN#3W0ww16!J<eLEnbk^HY7+#9f@U)pC4
zpG<-bTcx&;bm8MnAOSK&%hmdD)<RmA)HVhTx(NndG?CX70M`VxT&e9Q*w;+HrU#dB
z1>l;<DV9Wj)fXcUP8|$735B}Cb_D>}Sl(<VCmjWYilhuXIH3TzDWp|^LEaE=M0(^H
zI3NXooilwyfZWjXC4IQnLfQrCkr;5`CODu7Vio`u0$QH*$R;?_Ozzl&OS%HQF_GU=
z1ciQC!NF;Q11F(WS9nta@Wxo)X(lHh1qX_xlXh@M0dQMLs{{wUp}98}Ml8KgUe*`d
zbG&9xH)30RoQznyX}apOw+^84bU$g1(9RRFx7ur*-&YK)yIh@TR7_;+IH)<N+vPo1
zcX85=`SJL=ifQM6_|Msu<E-1xH)nnIeinlRncQ+)6z*10+%fT`-)EgOwZFb-pRzGV
zP2QQ;-g>KOCfHn2R(fqg%DK1Xmlg0eKY2{mSA$x%+O*5b1%KB?n_a-ma`^EL_*B8P
zOVQ6tyT$ljzzrU;V%o)fp<f;l)F(l8^_>dYa_#2n-`JLJ)rCF+>garrppJE?IB`<W
zL8UO896D_WjK!<HYI?VvJ1cV#(`+vX9D7hVsoiy&(~o)oAU*QZx5CQ4LmdK<>9L5;
z?%!e3vUVN7HGKc47<pu#T=5scG<wT*TBlUf1%0*AM@`s@4`!~z)i3MKk-hYHS@|kx
z#+QPU(~|S$13KQgIha{Y0^48+{?IRt2Eqs8ezd{=i8jbbXyth_MQQvnU(Q(~FUpWk
zPUO!OVIj*T_M|Bm0xrCen{I=EtNC)56H@tst#ffLwe0&tvqwHPP+<ESHg~#-`!m9N
zF)U&s>F`35^*#35A>!SiqgIRVfk41Lw#IZ*B#$^*Hk9_4UH$rBG}O){H)8(WP#V@H
z7Gax9Y~^I_?1{Li-?1(q*IhY2wX<EfJ7ZeoR^{=*|M4SZ`r;Osk6Cj=db1hRYjr=W
z(W_X4=aMI?tVm_K$Fm0mOrF~1Ayy7Lg-%sCQyBY>+mUp0k6#^hLO<o;+iDQwji0{8
zw|Pyqy8PT-CEKX=aV>q^id2<%+#hk=hSX>D^scVxwKD#U=hRZ|kIMATjwBx)#Bh3t
zBgr)PJM52%Nl%{Wup(9Fe$O6^HF@fghgdndHFWB>_0NG>8F08$6F<LeYNgi4gY>f@
zh<}>U&s3yNQe#hi=gjvD5ps5Z=C2gmo){TFA_5+<>@)p2pFFy8{#j3Nyy)D!aI1gk
zL$q`M%w%e!zc=I^R$QLa%Kel0B{E`IHFd|<bxp~qz!w?S50c@b^8>0+TQihKH=?9t
z6Bj!FS27htRtHSkm;ler-JCaA-mjES1WO21jh@w+b@1*v{jGZ#%IVut<rl$%mB^Qh
z+kvX#)jn$nR~u@zdY)6uhgM_1T6S5>3s5p2NhyHbn6#Ep%KJ>}Mk@aRi$KbS#Itny
z^;XZtNt^TAQ#o5(E&eNcmV5hrTSXsf`B2{p#ULw&WMfUq7sZHevp#p=L9K1C&0gjH
z@vflG_hOfW-xJw0+7{xV&*?yS-yg$_PTU3I;-z2dKw^V@&pR<AKtlOc1n7u4IMKX-
z##M~&vtUrH;@WK%$D5sWJepx9+f7YG9c53N)dCvRw37=*To>JT$zR=s+np9u<*R$A
zTQY8kE>05Un??cWSzP|YK<qE#^<TtgE@<7oGwdIu@V;*m&#bacm40L^$L&Jw*7-4{
z@nc9cz2^1YHKjO}=l&Y$cFKsR&m9aum&+EKtZ;WCwq?OPxehAn>Pk(^K9{Q@GL@Q=
zm6{d--C^<Wg_}xos?U=&(w&qMO`k6}{Cq_w=#rqcQebto^R3?vpU}^jE2Y0sN?C(=
zP(3|KHGNifDwS=M)u!~LLiv*);)wc>H)`po0-ktt=E6B2C9%?H3)RjtMCz>N$wGP1
zk6$qd<}&X$m>&K(!jfvz<9O}&+?!?#^Fv3|isdi<%&fos>lZ9nZCX2gB7`@&`2H+S
zF5`b0{%kwp{<pcm&8y*knY`Us;x*jdZ}qPW_09-za}OVUs#63UWp>Z2j_DSvY~twZ
z{Bjeh=b4weV1}#Hz39DDii?dzLY+03jlUB4No2S3c3yW5A)Sb+-<X<?)(OIY@xpA;
z&8tN0^v7h|8Ck2*wXBRT<gUshsF@U6<smi@wwn}c;q}kamyEsA_rk2w-l0Y>a5M_m
zL3F0?x<{x%=dQXySYuGAhQGQObIk~miN6|&an;)KJ5T4Rn~w(lpEX8ixvQQK4%s1g
z<lecC55}VlRq(;PFgjX0_R}#Th>vu3#MA4njNX~rKX|>uIQPyq!X9)X7av@UIAc(F
zSZ9Z>7sgy`$7=dfE2ArUcYG0F+Z$2y?&J_i#9iZ&d-eS2Q)`SYa_>ALkn9jUat~a`
zuUEt=<Ja%PXlQZv(U*lFKGfkHqF=W%;+fjlzg}UOd*B*jH@fg8etj+Cv_WCK4oAle
zW1_`bMc->>RFrqX7qQ>os4DM34&j(0ZgrF*?)@60<+%r*5RTa)cH|1K<4-E$RPiTw
zVU}uf_S63gL42gciKqW<Wi)DP-}rikX|CWJAqHL8k3U(9IBQUNM2Dm3ZlxAyH9g(R
zs3cF|i#T9!M9UN85Xi*3%NtY4=)xd8=!My)%c(?U`C~5FQLNPHYF3o2T!Soviiw|9
z9%2IlZ{nwg*FHyoH1<l{3uCQqqejnlq!4rvo$1@}5$>RK4K5H?8ThH;FYU!#H9}<K
zFGXV3YuWtHn@Di8)u8vRp)AWactSW}huD#O?K<8UkM>i+`|iSMYuW6luL(hXq+=6L
zud$*Gn=V9EZL-s{u|cjVdDr~@|E>+?m64xGHo+C`w-f);6Jw@pQ-*kB)^ec;faG8R
z_2KQ<%>wpMQ~6i<pDL{UMrfzaty`@6IWg^C$sAjb8+_{j-Ns-x@JhyL%ifpI4t3kL
zSH@s%BESH~*Eo$+e&6FgsMi|Oj$&=*B_B*<byDBft}}`Ko_*?VZPt#;Y?D}>y(GKz
zx3#53&gza&jYfEQzX@OMEs6gvCV2hH>@=s~?R+sdTD6Dhln_LccCBk(h?)F2)i6-E
z-V<Z2U8_Rh<4Ez-K@6u4J5tPZL;m2$*zFBoc9fgBAvuIZ6F;Xs#7csBDCUan?c9nG
zjGk7lHGP8><zn8@F2r7YN=4pKHX(|*>yNFkJ0@@F8X*ep*N;!AMVvM8JEBwThRamy
zBVf^fKKN-*jD>D(86q_dvsJfNlm3%c`umYKGPR75iS`@7PuC)f4Y>Ps;@9Cam*UMl
zF{;|}O7ta;6fYgbaQbCOihiyu?7vGMlc(s`%onp-EB+AuatI<xJKi<V^#*O_ONTty
z3xu@>Ts8cSy_hm1L?-@5B*slE{&!yUmE-TKjkvq<H@q-zy73i=Py8`Ob`*|Lc2c{e
z6(ukCaTdYEgu5yaaZ<P7SeJ{H0GgLP^BE0y`XqOe3aro8xvV^~4eYkg&-~(vld-<#
zPek?amz7>yuoOHaMqX-JwW+hmmAusW!xGvHf8Q^ub)5Lz0s5*cq&ghCW7F#}3NL*}
zshcM5&MlbH6LOSoZ%f|gt5=9p{Et~Ey=J}<S5tGbC!aEWT@-qNllnpFluU_sbnfe_
ztQe)zBIQ%Qi2drN<7)p{tnxgr@=t(LyRwys>emXyHe;(2J*yH_sb7^XO8KjD)|Mru
zJ}QXLS)FS=KcST+3rh7Z#PUidiHc{O#y<|qh?9LkC7QI|LU^8HGV&~iXCkJVg2$q)
zhM(94VFDTI@1~6a3M=*(%$RQPs5T`Yty?c{9I5;Kr{mqSfi(3mZ&oG}{{7&6<t=sV
z@WYHFDEBqr|D*T*cjh-H?w^<wd9Tjef4v&?Z{Fui9q6qmO|xyk<Ds6|UEBUwj`%lp
zzY1NJK74&)Kyz%~S@D?ccjNQC>elHRS0Fz0uPd<I(}U(};&*t~X=xiP(^om}*{*~5
z#=qe}*O8p`1$~*zfh`tBs9&UgH-c}W{OabE<&L+}e(!I``K4>$EE@P)k>#?#-V3yG
zbl*wr4tX(A`Ea;YYEWVR1ki3s_f2&w-@u=2+wzR^6Q}-w=vq<3sJ!;$XUH{LoFDgp
z<<J5Y$JHQkH3#JxOe1BAN><1cf}aYabJoyW&uO%>pP^@h3Pw+<)~vc&4Usw^j+eU-
z8=%SS-Qr+Vmw7-QRlBYBuY3JT#D?MX%TP0tR`;+^@>6B!36=Rxr|Z1HcS{uu{6=^&
z5wTgZz{GsT0$c8;tEUEptsB{M9zIpJ&<-@(eOvk^5k0a;eQ&67dO%od(tQ<Xz0OF^
z(^a^Vh@S?9nuNEuZ&7oFVtKf*zUj_FG$-eN-O|)KudqEqM}Jh?+ZzfMWq!M?+CDSm
z+wSt+_xyU7cl|7}EB~C)X|S~<B6||_gSN!^Zu?*PW)cjNyQEz0#LY1IPi6nfVUw5g
zn?WnYVa;v3VA;$0<o>FpMxCY>`?xKSMuxAOdh71t_+yUUA57hCoL*etJ+MCP>;FnY
zW^sL@bMyV)a~^Xq)56~s*{t*r`+N4DxzU-Adk&ID1Kf{&N(<Gy)N%a&`hKUNqKJdk
z#Ok}fu=~P5^E*$5`Sc!DY9cc<U<T2dI&&}Z*FNe@btsi|KPND4q~19Vu^~`zq+S`D
z_^SU-K(s0;u{2O`u)YiHUW52$s6Jt4c*#h;HrCyjv36?s5cOsVV)M-K0cw;Yt#id#
zbBia#WO`VI8pRCtpFwn{j@=9VwvRei9a=?7%n3{$sdq|4YzVX%saHk9>I0%RNi(H^
z7K8OKuxT}j!lC-4nPJ6hbg^l^4Ckrgc<R#-#Fm-igVanU?BB8GU!IJW)5EINOlD}%
z45Bl2;a=e4KI%esD2+6e6L@Z<-X#sOAy9QBK?w<K2pCr)nU@Bt4kkRu>eV2A9!fYm
zvth|df)-ZKmtj4%;Slv=2x9Zhh6B`{im)w<sVA;@GW4f6s8Dw@dAnv1ovFR|0)_ji
zz16(yB=elWgChx!X^0Jhh9e0oiZF+ofN?d_&C)=_!GvyXKn<c`C?RoXgWgDj4mQA-
zVK=oQo_a3?v1Mk%LF!>7EcvdP`>M2?R|DM!6MC_)YY-=fz}*%ud;3%^N=RD<!M%ND
z*p*Z1;nWExZv|=idc^Lk)=g6zY^f8~yjy8E{Sp7I<#i7y=regLq^QzB-NA$|tWyo*
z{&xv4u})q-S27kVtE006{f82?u}+bU+F`_4Y~yZfco(+OlVLpFtU?WE^898H!>J=o
zp1C570X%DUpK4x99jWHsOpEeI9INH^4ks8gc^ag#(!k||2`{k8HHZh_CG=yHkuXtn
z!gzLI^iYB>HaU{fIE)yJ{kEHWx(oZwlVLI4tV%u2<OR+khEsntc`K35;;LG=PBq(7
ze^>Kvr;Yg|eyZhl4Ns$)JY^ELG*EMJ`Z?C3265lJ>3^^mNSJYR!shHipP^|jtVJZ_
z?l593mb#l7*oCEfG7P6lD%3zG&vynfoce~zGeg3Ht6JTrNNcHYs(Clku>Oc2YI&UD
zX#*xto%FOc&~$LR8yj1Lc;MYM7aNO&l{Y7JWCunJP3vG|BN+|Dh_Tp@yQ#;!upd1c
z%cn`I)Z<KEzzkwI^*fVifrRa-YTZ0VvZa2n=26q0`Xhd<<-Hi5Ry;FRQf6r&YH+#>
zyR`;!|2yr2)OCZw2XDg--JZ6WNytZ9cTM23soZu_=1uI@oV3jBz@VXNZS2-a24fhp
z5&LW}!*r@{eN*wqWS7C|9oT1{4Aa@4*AOfH8Ey5v&3hRhQ$N>IKUMRp(lY%K$M5s<
z(-yLd&F9P$dB2sZ+iG~4q=kopmi35#lNN4b&*h{oWCs$5rggFBA{kA?h>h6Ay$nkv
z?9#?$+~BkicF~hzIs3B=k><}}*Yj|D8MvvRwp6&9M@w7qN95mk%SzKg!fqz;mMT$|
zYuuDb8V}zn)g%5*(zuCL%}LY9e&ac0riE3FJW@T3*oe*9djySyHE#T7<#IKBd(PBc
zW6o#AkSfO4$!N_k#c1Eg$G#snTfuZ&M$#yIvv1Js6*i|9@z^`FZmhSb&;J1c0RR77
z*?Cw~N52Q~IVZ_U0)apfS(JjB00qH?U^OBROO-|R6af)IaRDNVv=VCZ6*ythVv8#j
z#YQI<G~zBG#ZndA(Zo}X*ix&tDuno2-%4yX6?-#!?|q(o|CoH{`wNrIoHOB>=Q-6y
z6IxepVhm0_9;6~FHRp39HeC^wpwV_Jq9Stq2Sq%M_DD#Q8JnV6dL%@oGVc1TZOYS$
ztj8?H1(@UhM6?sTD?aDjLm^?QIa5s{Kg|Oa@^#_Hc<kM#kg~#AjN$Xr;`Sj<o{K2d
zUp>o-6#&mpI8KUvKzgnut3{Nj5RMZnrJ#BR+AhJikk!l3M?l`q?|HU*q8&5Kne_*r
zm*6*2>|@e1kF0j2JRRUSLZuv3XQLk^*wbY7QZxz3FY`Ay>BA`IvJ>kLJTJiIQtU(0
za}`<bKzZ83<wE6nP@RQNO0cbD^>XwHkQ?}$8}(t1%w=bGD)77lA4;(Uq-Q=^Ev7uh
z@S#u{2C8$=9};XEnUINuK;FsU{Ea@0V0@ieE~q~bU8LAw$$BN3AfoC8&_$>m3ldhK
zDhalQOjw3uf&3bO^KpHcknwe9rJ(*I+$qIABI{R^364~~2<{XrCxe7+bWMUiO(rZw
z?*sWIez#5^#$ygRu_Hiz7o0D}{zlg4k_iq}y&aq{R0e>AEObbMZ6y<yqm@9e=XW2`
zhdD3@oLM=jzYK3lvHfKI8Ztpl)jPslLZt#E<e)(bwvE(hA`c+H!0$O1Hkrd@JFy~A
z-w8vc*au|&N>XoIn-GQwmA*i~0_~PyTS)yfv=GRz^Sf<V(w@n7X2*m2OR!mreN5Kp
zk$T(O9AL9hIR)sm(N7ZWX;QxwO#|{Pd~4F4B1fPfgVQE;f6Ut|Pkx76KT0HbWBMg*
zI;g)63uM?;y!tC}2q^c88~!<61ms(peu537>iyJMH+F-IvScE=0o2cfLxeJ%qp!oB
zbyX6aAb@z`+un%p+5;s);3R5+BsLgT`m$Y_s1menV@8r}B$ei`#s;!usWdM9VuR1{
z{cqg}b}WgLyK*}hn-0H7K$kk<7ld*W5k#R&qLx$=n}TGb7B2JEOIY2yyAH4tGL3}s
z?#e1IHXX(%pvF!ZPbl9ff_SJ=)RIJEQ&5(uMZ|pd3MSZw5$t3#je^(RmAkpvba*`h
zJ?@0p3FR~*h>sqNTGB~u3UU>-kW9);X!Sl}(}}eMX`L`oihV$)tt5|%s5BuA6e?xl
z=n7OT!M2b`m!V|P(#<#T*LT=4Db8#FNV^0NOR<m1v^?^tBbDX=4-1u{;Al3wEy129
zk1j=_pye{(^MJmCVtSoePmp#2u99LOl4+~RqYhM>JzOPJ27#kls8xb(C66vgg`ma2
zPeb|+N2b@ARe-cB@QD;VK&IuBN5xc{7(NjyXMm$Q=!FE^M&@NA2hh^VPt)o<2xf{C
zOM$-gaFi7LE7_+c^F&mi0FDwW$AP>Rs9J(;A@i1@1kiGgpZ1NuL&!{VW_>~5MYu<b
zeMI)HCi5JrJ`vm_REB`OY^0Z9Pm_5|Q4nak#P4g+ckr0gPV7j~*98|zvA>blyIgCS
zyQu(Jzh=Vu=%$CMKxml;ir4V^y5S;1d05;MwWlZ$<jK%c&{C^D9f!Tmvs4N#A5LW5
zfQ3gC6L5*GD>2yvYnNS1wfZ!{PVqMFm@+g4^v!}l1LY`A-cIZud*ye+mKpBK=^)P!
zJq0Zq_33!*FLo{E>Q4dd=xy@L>-PdJ<qS?#-<Y>mH+HUzGG`(?7xcx#>4egc^Rxzg
z&{gTic}k*;a5glrKLfOU!F)=v!Bn42jdf$!xG2|6WY>Vc1o$1H{DAZHD{PyqQp|Zu
zpc&!p@xB}X0!lG~lc;4ji48^*63~Ql^;s^OAT-4T>kjqV8n}dH>r&8hcT*s+cJtTk
z^sik(@rQ5;!7dP4YPnWB=ImOcIFBs$5?Mk)aROYzVeg16tz4@obM`d(Gz)zXTJG?z
zw#zvIJeA>8r~WhUZI#z@liTMeY7sMkI<w)R?+W}|ip}Bm-GqM=%5&m|(rL<>;He)P
z1}*#4f5v0)^Hk@#3MY{YFpf?v0TkyUUy9A-DXv03VM6EHQdi{lmjl%{#*t(rD22Zo
z>&A|8G0_v*F+dRwHvy9q$7=_6o2zLe$BRN2Z2wXoyt)8XyBJ3fyOdIlS7Y5+XBSh<
zMAjK7BH?Uc5^%h>V?TE_`E$H@=$mjlJ+J>8psHcEknBg4B0!CGV<)+oQYW&LfMOQB
z0!;24ubtRkuBNFRFFtzs_S+r;)z{1x4*LnE2v%d=SfPt4dLk<XiU{ZjOk9p;8@9sL
zB;{zhXlMAgv&}bSfg%?A5x7)?ZLl}h2vq^@rV&6h7R?8$&FZ<a*ls&jy?QQ(UFmHa
zm)Cy_sOlM<C`HiQsvGO!Vwz(+697dN%mF45N3$LKrK@Q?N5ezS;p~;Z8##n&Jb{x)
zl|o{JQGqYpo{0*8Y71i^*lCo)PmK*^iztN{4ix(gQ_lwoQy8J)qal%MF^LUE`EyWy
znffe&@&%?*z`9X=c00Te*bh=rzK3ZMu=er;Y&$Fn6vxB+B-<vk9OYU^GG_~k;vBNr
zO=R%`#k1jkf?X%FXt-8K=4>;Wk%{bqs*~T7KdzKuf}L0%ICCDlNwL3@XOv`yh&m&H
zZbH*okg)=NA;Gqg8Ou;SP+j9U9nfzOGQrNQ44k<L>!jF6<eAlEh9h-G1nY#R$si*e
zU6)`_lf^gTeGdCqIGvZ*|BNvGi?qJSoXtVcWb9wS^1Z!@?_%1NiM)Y{Pg)74#MYIv
zVqhtEHO;21&P<6#ZC)Ajj{we;uv>v;9B0^HUBX4)8F0ZI6xazD0Fxb&L7+g9>O&Iy
z4{!f)M5*IFZ+ZXB?^J*OyKj5j%QrHkKH~9;WjXBOd;I5D?)e?fI(Fi4N7u3SCokE}
zUw-*CT990_^HEdU+OkJY-T6Dxlj9v@j;$X|*l{@ET<qH9plMH@pUDnBzUuPx?!dY`
zp{a}SD2p=69~V~JLVL%tPTRXP-W+c>6tW-TPrDN_pcqW&Yn~h_$S`ArHKPs~sxvjC
zP(itB4P$WVZ68yJJ#0wmZ5JwXZ~QpY;%mAq)$Bn9I}6vuVQ)1STsOA69x1R_t=Vn}
zV%sk%+8VG~x7+oKwusr)9zU1eqclG^6pT`>0C_-$ziBq)9m0O6`hAyTU0LDpjKQm?
zougQnI<UovJ)&5*a3I*Eo3wlp`yDE%Q~h3M$mnekEX39sX3QU0e8Mn;ZJ(|93l6;Z
z<nB)F-sFJ=y{}wtN8yt}rsHTRaPYOA;@m02@x*}z?5o?2LwgPlEjnSyM?<3qUsH;6
zCk^?D10S%j^i4z4pS*T_x3G2WD~+mzuerZ)VBMji>897e_q6Am?}~fd#fraT2f|Hv
zb2NV^V%yANnYMlZ&E+riBD@&`r>6)g#Hj;nBQ{+jPS9-XREQ%6#tepWHJgqM(PnIl
zX7-UG!Miz*V~e5{Tj7B7ldv7w?ePQR`2$-sH8bIWxaSo|^~Tn1FnFV(P00iEdSAJ`
z8@3M(`3=4nDoRfo_9YI?V_)5B9I87swBUqc2^w-6e9cpoo-`~;9GJkqy52OjtMI+@
zEuJB#dBq~d*4Tkbrm$?yl|<~PgJF{j_i~@ue#U+cLtNF~69$(<*wn(krwsGoZI5{o
z1Md%p@iYgI3?-Sd!J3={hUQF74jTGWwO4Hj=`Hdt#2z*j^cMa1Rh(uD^V1BVp|1<~
z#$)d`4s{ueoR18Vs>Rz3_H0q7VnPFU>FuIxiV5$w$62nXu3<=`T71e7e+YX<wRpGU
zcv<0MwIQ&lh^IK7I#6rG9#I@$I1u`7d)z@o^{U0?hE=^qL50{l!>IWK2`3Dr*rF&!
zJ{)j((y<*|ojefqq=V-bn!VcII#P9ShhY(0bX}3(h<(yilw<C&?=9jhp2ZA!nL3th
z)+J(_&9C)}(sx&Ic$DgmujX9DKz{G5MdsHIiqh$-xYt{?LnS_N_VDMn3zj(B!Okmm
zmLm5@<3~}Ev#S@X;x;gf+*DJC_pLTw@;F;5)+^LsWpp3ZEuBBxLFg6Q&kA$Q752SC
zzT!cQ-)K|Ca?Qty*k<#Fs|xS3EuL>jCJsdPymC^7uh57a4V%!AHr}t}kV|-~Uzn-F
zPxBw-vbV4+9(%9JMO`?S+2T25S>j5l#%`O-Wvk9BoExye_Eag&(W2fefx<b~Z>%YL
zh34}_Y>PR1nI^`znJsw{w?8*lMJu*LKgpBm9oQZ5ey0w(OiT5fY>M{PTtzOs3&+M|
ze`<26EZooh&lLUa2BQg${}GoD&Dda#?!a7QrbdTcYE}Eo<|g%41r%Zr&z1L9QHtC-
z_eUmG$7qxdE)J^wC+Er!VcS*v_b7fSFWg@~SJhMHsQ6)_-x(wJsA5v8A7#7g#f#|B
zv4zXF%@wg#or*~f*atmTE6o>e3ll0P#rpZ0F0Rn*O2oF9FD}!h{`bOSHvIAVvO_Z$
zhwV?jcjY(dOV1N~#%+F_HPQQ{@e`Uqi$2-$?@u*99+>;@OwEtTWshoE`P|jLRY8T=
z!*fUXR&oA!&Qlv)_^RJd%pH9Q`>pD?dc`N@g};@}P4B6)SA4S2@0byLRPjfu-+TW%
z=ij!^4P&dWDE?@`4)j#zn=guctHg>wV*SER7jrZ(6R~Y(X{PNk@XcjoY4}U;ynZgI
zVHgRZNh;1qjdi0VU1A(8TmBH!$6oUq=*S7DKbt7L%^4x~)z(Fa?W!;nUFET+#!23D
zB3~GD!*SshJ$7UqH?nHOn7oH6q5hSU?etiuxQmfh4cJGLxYc$t$M6ctg)ud|9JLoe
z7RdUe{7;6xE&RA%AX|#0pyndKXUdx7a*4l?kP%2Ks);7C!KlHP?#V<Apr(e|LDGp-
zT!0!INKdBXD0ppy&)Y9m?{KCkgSgA^niShlTCZ}g{_du6!1_58PNJ>0uF&EPidXQg
zyVT(n+FI=M^j=6VO%~6A-W>Ld$a0cvb!WmqC5o4k#S)Q42#O=&KEV2kELB`9mkB>f
z%5u;nP;>WxW;%_K@zEnuO*)AUMk9Rb&6#Kfs3~I-0c}UcjZtF*={PD*2;VP8FZ*u1
zPx#A-MlPxm)g+SGV3g!bH)WzEP_vmyB<KJtPNv2N(z#Te13XlW8v1S=BK$*%MhY24
zHEAR^7|DI<dZ%N}x6T)S>UqX6mviT*l`j?3t2^FxkJ#Em{~$r*i^|E$kb^vJi?n8B
zMb9ZZ?S1T-ik{t(gON^g{K&x=e=kAfa;+*6+icgEqqX?d+;i)hGBc$-(SL@pk*~Fk
zuUTw|4c3Yd&>Mf<nNCf;mWAGdQ_+s=z^`4@yEA<j)h&P?#pp)g4G+S99FfIEUy5oz
zBC)|}jxT*66U_lNRm^09_NBU|YHT2#O?8XlZreQxTx+{0S-$87sM)Qa9FP5pS96Km
zEfLl5m{U&lNYLE{7fP|qc-`G_A>n^m+>lptgp$!IWVan$=;42ui_L&P%|WX>;ZMMS
z6p_V2t3@>lBsK;8TU6u4ocbH`T6Q;c=ugRRNBEP6|94z$2AnnrjUJOOd&C^B7_F+^
z#yKWg`=8`U$D()L)Z>!1r|7v(-Glb7cd`w_$Z4_ueuBp<v|lG;Rl>)UE7w-~)Yw<7
z-A)HPbzh2XZ@^}`cIzYCBmCPYG!!3=c8Js7mDY@^Sldjmc^~^-#q(W}MUhV3oXDaW
zf3e{4Qf*iw_N3k8ENzER%^kOZL;A1XDxUA47dv%dk1T4$K9O|i*gdw7@b?xx9;e;l
zQ?s@5c`Wv3K+V3&=jC+Cl9<1rZ}qH+d==|IQ}8%P`#KT3PUt$Z(yqcM2~^l^qY0;g
z^O3fnyUk43fUA+b2pyV`l(whcN8l>emiZ)YtF(*5va+PBBLYU0(PNwfq9ZGz&dJ_&
z2X<SsZlb*_rR_RPd*t<Z`6TVCuq&sRjtm%IiLIlZ=j&nwksm^xK<G+n$Bs{mw!@}q
z_m58+QL)(?xi2@wji=o&#px9N(fiml6`OZQUMgGS=vrPEb;<OYp7hzYq%Uo8=Y&n0
zJFjb(_1elFx~ahRFSX@<%4lY@3;hWQFu+SP?C)g2QnFS+1rSgs&~ZU+CXz_7C&=0r
zXa`8@;rGmxFOe{D5;_(HT!S(hc90CnB5Uoa03K`<=th9rWhhaCJw?`LqaKjdXB+mx
z5>F=1g<c5)^srHeeM$x_Cu@aN00(9XbRtl@6it?3Pm;A+=oCom<>wyJr;lX1CG<iN
za2;mJuusT<9J1D)3gE-X0^Mj(yBw{RV4KO>9P}I{-Q(vr>C@k1x?SiZ5O5PdmSLZf
zO_^k}fNBEJRiGn5awf8qU{8?AE6`?;^aH==AI9c(CV-?rq?-KIST|bcqD!1e%Ro~!
ztOYs=CwT{UhpTQfCz(Rs;j~*`e>X_l%>;1hEUIa|8tcX$^kolr!hIxrkZXA#6nDdY
zacCZ4njgsKh%6qUxS!*2EBlRz2_J`U0#gWOokJE=a9=yqv<oJesha@pN;Z)&*<H7p
zi#-C9J#+ye`Gxv&ZpZ>2YT_ojGEI}|WFhtp)3h7jj{Gc8>)BCDSKo`%QTei@hi#Ik
zYqr+8NO=2*E$3*>K1sj0)gRQSdsQ^;qzj#z43W1RvA;{2mfGDGMCd5NZ6B?tPf~eh
zZVdK9K+?|2+%h_0iBdhKAi=3AHZn9q=WBnv274f0_tpDJfiI;C?B}j+HNC@@;`ctv
z?TkJ4)eGr@J?dNzo#(BroKlbnni60up_{_F{T24Ky>5#z$<JNq2yTx-3Xrr(ZH~cS
zu}i8`n@KvuTUkA&AOkeT!$LwA%(-2QJ!Y@lD@>Z;u6qyM9*5S0q^)XmEcT{d(mu7B
zLl=81cTOoN22Jze3qlvpxm|}nYp+uajXv%=0)+Y?3K$u+XAJhdopGDmlcb}(m7As%
zM1kBG=s@Vka6)UaT6^7gq0!%6=L|x}qFKQBx!N-pd)3akOYO;_mwTI5<@H|%#$60f
zRPOk<RX5tjMHefm`y}Dl$;X5lmqXRpzxCbVaVL85yKe9GZx4(&j;N@&M%K0L-cv@;
zm*m<-CM?t)8iCD-)X&jocW$CXrdHJdFvciy)MjrGgzkJ-SSTK|RUHPNZ$SH6cFzFM
z1y?yfwu0~xv2B3NT|<V7sa!{>7wV>g&>Yk+!M2gDnP?<1cJa>~(BCDQG$+~~<aWX!
zDfR)GyOL}bQMp1GB-F`3>k9Oh1lvNkE<-86*v+>l?`d}htz&W8tWJx4Tjd%1xVc^;
zqbHN*Laze3dU#ZZ&Ew@>fO$YyEw<2m+8sda7&HYKH>&$$u$OtpUT*Fvk#Qu`C!rUC
z-0Lt;hF!(Wy#k*Coknc2-HYiUcQ#I5oYtLhtM<C@g~o7q-3-v`hyDb{z3RSr>^(c9
zTCD&y-#g~q(L_ElL+Ax`98TdjY`MMe8=-NMyKWpPl%g%bxLvJ?!~S4rtWqlo`d}$h
z`Na|aT_K}zru~5VBGgE+k4W=sve1z-i=alR3ju}M$RNR<CJUFMU|_t&@5#^ofybP2
zqTPVG3uZ{Mzmeu#ve1Dt+rbQ>E)W!Ep<@zkD_OW4tpP?ofAeAeT?gijGyMTDUxvR(
zvHhfZ4Ou9r%#QFEp>8@T%t60Pux;dvO!OWwUce7S?sAy*PP7=9JK+o|_5o=ZqV6hF
zcLDz|8T_K|lG5&=a-n+tWO^Pj4{~HZ*}n_n457{syjX$uO0X*8#bot*9_Iy#7ITgE
z%=$_61R>ToEQHPn=BJ$E2L0Vp%z77`^zeJx+bU^ZPQDOQW)3VC=)~Z~QWP%1o+Mvn
zp|ikvhi^^Y(>?*bkl|FPw#L1!@{BjRW;c;h%vhc2nZSGn4ok5)Jo8OBOz6(p&LrO-
zvYkmvNwXLZd+5$_u^Esv2N9i+1C)Sp0EiIDA&E^vYLVQDp{$VCx|>h3kn|Klj)xL)
zu^F&@4vOf6<v{5~IFKkpB#$AnDX3E<cW0=-VITFi?d0U(i#maPmzs*l{>YPG<a$a(
zaxSyciFE>=T`)?DUB>h5hEar4Cr(P(Q{)dEWJn9-HR_FVSR+q<gX=j`Bo{Foo!N=N
z^D?|3#b)z74e$b?{8pT_Xiw2p;NXWI0QuMIjq%vKJb4$_(^(`Zng9F1Zz<378XQL`
z8^lTT_7q7$wG?d!@*V0~ao8T7yqoLkDw6;I2YxS>pg+x@ME}v%b*63Ay^w$3k6CWK
z|6Y66^yAC#mpq%a{)+i-W80nY3vTt!nBFE>b*Hi5=hD)9`xEL;1Seduewz3A!?J~!
zn--33HT4`?_1%`-hIL(~^Lm<_(?mg<f)7nzulD`(YB=d(hxp>W@1O0yk-qrho92!i
zm*j>o9uGEN`DpMHdj06S_x$3wmiIh-v&b_=|5?H9FYnCk-Vu`XUdhyl-~VWKd;RQw
z$h~+UZ^LI34t-`T%`-jt@~@tHaZZOK_{OG?d)JpuJLUId&pdkYMXWE&&-XoVYyYve
ztKxfe7+ZV!jGyl_933(o{cwKtw4pyP?AG;^9v|LYRrBVblk4sgDM{Bnmr(S&1<u>i
zD)Pf^6QgCDLO1EJ-8khS+WduRatysq{z#O4W7*>7V+$8JH=oVmY*vdlKhjByiw7Ln
z{%u_FOQGRL<G(gq2flAT`0Dq;rsJg<2d%2VRybL&O||S?Y4R&)=VeFDth65<G1Ibu
zAAJC^^9b#}GFxe5iJf4$<^(%0G-~GUkBfiqfBEqNtF~13pXu{IG94^q=Uvk7i;J4+
zT2T@(%DOV$bnun-oUhMhhsqL9!LWR^b*0>L3z`mAR+gOcunx{LEo$xD6!MF>_+y?$
zHNraRW4ZN->EJDP9$&l9u(5=4vwD=6>^WmYXj2Zu-aN0}7ZEj+Q&BQ2)s$1O-M6yh
ztn7kycZul=w<O2cZg`H9b@x<D$VyXA8GCa@RB4c#b=5Gt)&BGJFCt5W1jDUUEq8j@
zCH9e}d8wx3AyK6oXX{S)U(*LRz1evFS^B2PQZK=9q3w@;V3+W1VU+brJG<oBrtp^y
zcVGBh?v%4jwnmlCa2S5!W4W`b@(mSY`Cykef1`MSnrXSiFBzalSVuuq{(0>=^~N`p
zlXcXO?ER~iZ)VN3xR7H%*w5Y<M3#<o9IlpIJ}6`FyN|T)xxwC-at#UGsUK+B``pM<
z7sufQ+q-J^{>6=NvV$!j{H@*R?$qv4`6k=Ry5|#9{sHYdkBT?_C)k^lqh?+g3|HOA
z`t&Pr>nhH<5c|rKk%Hmzqpb_&mS$+mIjKEoyN5v~CO=;Enh5PVUd5Y{qpgdSrhGzs
zPBz}sR<Hdp00030|0Gs<AXM!aHjJGi$}W_xBr-@ew)sM2OKB`w%g_)}mO+CU%92vb
zHcYl;=R>k)vQ#u<CS+I0Op<ME!_55d*YA(}p8K40pZB@%dCz(8?HUn^Ma3AjFz|)a
zy9I8J)L?FW*O6qFvkb${j2e6sj**pQOdgQzAt_T>bBrt>GsuA6GEAD~F~_(esKIC9
zm^Nv&pY^>q1%`C|Y^!_{D_oQ@d50QYj_;CBWQFU~BSP?91QF)5xB+=}dPE#)HXe@Q
z6=upS(jyX+Sawi)L@wThU*Su^eQG)H{Uy7@3?nn@>IZyR7M5iv$}k!y&Gsg-PMgr3
zxQ<2ONweJM7)c28x-LB;o-}(zg3&fanhnC@S_fxVlJC3DMf|bAcgZHQZp$&+0;sDz
z_^v!*X5eXhBa=iFNEx)i7Ydu3$R^*{2fU(;ac_KAzYr7FBd~Pz^7p9+<`@w^Cd`1o
zLn6&`0YH`!-AbBWPG)_H8|YA{?<A0BQ{fmbVP=OSeFvMwGKSK3a?%qec0>Mb!ZFtX
zbvV9DB#~t-$JqC$u5#hK9t$&>?$p&CIL6*|;r?O9KCrlcd{-fsbzhXRPcUc4Ni%o{
zNzfPLya%LN+1&zO2dV-G9>bB$0?9CVO{ofAaJHf(gO^D%kr9m&O=6jeGI;M$6-w|J
z(L~n!I+Do^EK5l#<mj>PD83|?k|-lNgsSigkKs#XDe2SMKg`)$CiM4~P3$D#PLzT9
zPGYBGS)Ph?wtyg$;73)^H=iw2G0sm06vTH6k{ziEJa~*$GRs?rk!(g)@Po7YBpH?m
zBoj%|C~y+%kSN0vP{89c;6&CFK>rq&<p`w<g&f_2vt#BWj$XiH4kxl4<rtO$R0VE4
z=9w_l*PW`c31?fFE}S{c=m!=>z+=*|tTUpF{vLDoTWLmrQg>87$I=}j3P|?jG5J{5
z9UwYRGI^iG;y0nM^8AA{#bY=VS^RPgHGgU$kfUR#==QmI%w;Kt+C^&NKX{B-BI_a$
z4WJf+@tCK=Oec40;Rc*N8#myjPPdOInIys4hXJ=D-99Oa6#%8%3&PpD{7ecEeLylv
z2Y@h>0z@0}?6Z;#%s!rNptuoyn1OjfV#_A8W_9Uo9y~h&K`lH3XQye?iJ2sm2j*-c
zJ|@(FP9%{`xBwu_K(>-hmgRr5yYd;J0;D6okb4*-VaaxpVIs}wg~F+<Fh6>spar`m
z>!r&`7_I5@dt#t*ve=rORd<*Hh&T*B&kKOOxTRL``9eF>wY)51G5EZQ*xGr!?oC|~
z@d5a}LUx?wAh_L2HLjj5NCWE%9efp32WiED+vCL7IBmNH6+v2c{E<&=x>JEDgxa1W
zwsy>_JJkTBMFzL?iLLn{I6ZX4*Pd#FwD92eM6oq7t8N=0It*?H10XN%MJu>H->&-{
zsNjVorw0#zq_o=H&D^*bW}F@nn{Ew1PLDHUBy1~Y!`cwk#eeWsLmgBL$R~)e3D|aP
zD1vGao^kw}zdk};OtS<_NQQ4Qu7@rzM#VBBR;DY9Ox&k-bMM~qP1JGuWzb(Kx*mM_
z`z%p+Lax0gJR{=p#b;eZvT}U0a<veb6vO_<=RZ!#)hhir@PC?;TUCaJg|+J|0|TU8
z((`P`?z?)6+Hrf2sp4J3NXpnU^#fWyA5l9mzI+eu(*d!o8XG?wJG5w^J!ao$3wqKz
zQ-8NA%&E&S?OqKV<y95dA@LKj#Awy-HylHK=4A;(*MeVG>Prc9eZLm}{spKjo^Opu
zv0L^fN3a8DI|u-&b7$9c)>RFl2SGE*pz*Ws0bmH70VDhJb_XM~aMHmE(D|V{=)5M>
zEI6m~S{?<s4e@JF`jXbtowF`s44rv}>~otNj7)_=XMO_Sj^fK>Sredwmf?@<`UdA_
z`qcU-=?jsv`EtR@1#+t|>oNVO9AB!~u9nnhZgHAyK@3f1Kui5by9bfUIEB@?&3XCl
zgUA;)-EB0moFpkqQf2OXW?aM_&Y4pFNJ-_n={j&bQgsgI%{c?-j}%dvgJs6;gmBIj
z13-BWrVm;T<Bv2ch*Jd>>^O4H@bX70sLjRZ#_gDK&WPA_^ZIcbi>l6XJ&O}@;56po
z-{nx7<I0T_G37Mot3Je*y?)$T(D`OXNH=*6Lney~K7F(X?>d&))}!WS{NY8LNXIW_
zS(g5M&P$OF*9C!fd<58*nCubs6eq&80a+1~J4MpzF;q{fAz<8psyAg>_T5;gFe~7q
zR)j+Q=V?o7=+2?HQ?ZEv90uSV0Ha&?rOKClGmm2O)~5#hE6TIdjx)X)Jv}<yU(v9r
z_0z=osQhq0E5KWBxZlGm^dE(2%{_XIPuY^V8QK^`+XI&_iD%;ML(s-}0F*3=>%%rf
z&_CnpyOU{16krG8v>aYCRHPhv)RuTY6Bp%8+xvQnSe`(S5g>1#uqKu(!U})TW2`Bg
zC#;C&foNj_ZBMAAf7b6jW>eaVh*XCa#?xc4luc<{A`*BusTA3ngWF4>5AxD-9+RO8
zB}ijCVoWY>PZ72`PLIi;Y@V}v+%*(wu@shxBRZmud1-rc<x63?I3n=QA~r-xKXj*P
z$&z3uPRjw^$wAxWEMF4L#c7$MJH05IDt5#diZCF}=WtqP=+1v=dtxO^Hu*TM0CXpq
zwx@Fn=9xp=v(CiT0?(V%_5@0nH1ct^{^(9l+TJ5uB4<91`!C<65U_#{Xo)!bscxE!
zDW#F41ZjpqOXSjA)UAl-nYbi%n4lS2;s^ay3C)F%+?Z)gJeH5U@RuD`1lUx79Zx^i
zLv#6u(#ThWbOhLWG?!CWM4wDtuR1IhV9(P}mC;;;$c-;;iDLOUmA~v9JYa1c(Aj|Y
zdzy<mr4d|$yof+&1KKC8h?g^QrRp#nGjukfT}pEiAU8g<CF<nkZvJJrz5?uLfDLF9
zXf76%Mxhd<3%~}nPg@Z~GjWURu+IP+&@QLBK*){xwnTw^+>yWR@nXPgIG~;5=vBbF
z%_xnWCCCd1bf-RLvq=%=`G6jiPTthBB90lrJSp@TVF2Xef<w@qAliD1G*K;<i@Ygp
zO+2dzo1LS_z$u%;R>ZU3G?#!fWGOJS8QS?3y$Vcoc}Qt|T831yB3kRiW`PnCB+my!
zao!Axk|noixL{!OdTD#vWlL_ExL^Xg@zW*ZNq`$quQI2(aFZJa%8^HGi6=90R|C<`
z^Ykj7zv}0zd1x-_<VKkiq@Eq|RxWNt5mpJX`z{e>%+RC2n#^b}T;xWca-^^=Q6>|o
z7l<DHL9gQe%Qmm(rn#h&8zoARns!9jTpX}q6u|y+iD(G00c|+Vg_qn2DM!lN5)CtP
z_W(Aa&HI;aQ_V|rc}#9RT7rbx5z)E0Ek)Qez<z&;$YX}qkD~{g(#AQ+ji7QQmo1Se
z6DJ&q*8f2d1pj4U2?Eo`Q^<{nN|49xh!(lHbVZmf!2WoNs0y&->4E07aWJ`&zZ@xU
zOH|Fo*#hi&df@-peLaYWHl9XqlrBL+?TCK4xFJPY9>DIsM3gW?Hv`&cv~f;yBX>Dc
z(3U8XiPH>3Hv`)LU$<WnH*Ne8x$#H|Qp1kuoQtbggt-yOn*}+zRiJ4gB}+!naH~MW
z0L`6Iwq%rvTm43lc}&@a{cY9z%h7<x5#0&2>e2G0=v>??uzNtO>O*0Zz^Zu2jl!i!
zSu3J`J}yWXHff4(uBVM>P#Wd`9u)IU@+C+kYhrjNZp8pL8GvqnKo11i5Gc$DV1vkw
zT%|}}D<UKxC$9@LGDU~i(Z+%55&z5PZ5A&<s#z25GI0e4Frxr;cmn;mkPY!P6xIf?
zfl3i9MM_!`Pv_&V>%!Uqc0FwmRKCRf_t32RCZY&4DWV^6kT<#Ph$6Z$lQ{Z;Xf{q^
zh<*UH`C}mZihjUH-UK$~F%V6l9}JW(Efl_|@8(@ZU!HuIL(JNfy@)*s(uK1uo+@Ev
zKV^1}4`y~fyfHA_homkDSYR*9zS3D(h3hN?7fWxPeJZp!>3}^L^1~k3D#Ka&r{U)e
z;O7+K=V(IQM-4X5l7$wFgcjq37UzT(Nq=t=Z@zw&gMXADbQLW9CPnAUp&PG{eQ~&u
zi+`jDKQb<KwMY65Sm(-#0(`f40Lvm5Z><i0Zi+qmUFhno|3^;2pAQLLmALU*XTag+
zGyEq-`13p1lN6z=JkoCl{rpYx@k~?fwhdB!Z6LSn3E+74*Flh;cnp9{JhMmV->w`y
zlUsU1;f6m3h?-%y`=uue{roXN6!S?GQ4q61EWW0uAm*;*PFfcG*I;kK(@Ihe4hsv~
z_}E21*$s25ul7f;ycjf(V2dP&Llw5x&XQ{lcV$0blRpTeRzg^Qo4}yDag`S%%f6bN
zC8B%%Zc#mn`Js6?1#(I2u8HxQ6K_J&AC^S}X?hkb@oqnF2tca;p}zA0Asc4yoDgd@
z#kJSTU5AwC6f@%<gm6M$@f+|d&lS~yubdHgxbQOWq&n!T1LvDK@Rj%cug%3BxRr|p
z^5Pz}g5~n<Oy?X$FvqRB-z$Q6=fQH9#6z?J;LZQ~mTJ)(ZO~Om&Nr{XSGf6KKN5F%
zu3B``%5<d85@uK9$9$dq_+L&d3S3@cOI<?QpxRDh%W731%2nR8t?~gXVvF8nWcBUW
z+{AVH>wg{hVpeMGYNtouH?^U^HML=Btuojp*LYNfaL7tce9g38cT*crXZTpr*dG~y
z^`N@uR_Idn&|Tw%?rPfOG@+I<jOt55HBCMh>qbF&L0ZZRAz^RzI{adOqjKtNZ{k*W
zhelZUFDyk*ciWGcFGXvHbdL1^2HiQv2^fjD$={t8v_l@rW!qg8eV-f;fV+?6c<i1K
z)=q><!7f0!$_Ko?%Ll&u<wDLDcB5?UpAg=k2sJRg0O19^yNA!^<Blaia9UU+ZEW*J
zAKMvPhCGZZ(Re~hNF1;P9g|$i6$s7<Xeq9n&fp9;IvLbL;Pf^W__m^cqop`*I-@7t
z=+VTAx>rka&+qVmf#)8Cqeg_jt@s0;C({``;YKo(EB?1yisPp<{2s;#eIcDug!h*~
z@7^`tlgh;VI$$$E(uO=ps#GrC*A$z<|Jfl33U9K#{Q%_`l!>2Ehc}sFZ_Nvhlu5r4
z*12MIn6KZ03vWGF@?mlO&SfcwGn@(UjQIv`S7aXba;-WYF<iTRRoHlQAs95)|89<f
zkn~hoCNKM54~ebXr)(WESc;^a>(2|0A!s>o?Nt6sha7xar-o$kCWoCj&Y!1!mlJ_3
zMQ(?BiWE+7QO8uACKHJMyKV#JD$F1+0cVj*?|*$ifq)ruSMrv5ZS?@x5P0OQr?$wP
zn?nA?)^Nr3|IB*D^+Mdl)_cGtt@2Oh+({@*>u#{Y2-cDLyRFr{Gzv_s?{Wgb8)?A>
zT@xN`nVY-jy|;gL>$dQL9oJn0;qLFc-N}@=qjp>&2EyN<#Y&P4EDOPv+H;`kRVDl$
zA^W3Vzr;6)uWv&86g_>AbXLcFR;DZT+idNd9mHIO44x1GhLj&N&bOe4$ix!@K43e~
zNHY3>DQukon<5>UV!mF#%r{7=Z^Gadz15EzHdG7MkuP*-hs+2a*qt`acMmaW-3<w)
zeP2i*e7p&tO%#k3$5h2Hs<R}tM^(M5Y}XKZq<VdjZ;+S-qs)(*m%D02sGZ&b(%K=p
zTTn&~$xR>xJQ68C0n0C&3(0N32lpj)=9r9jUlzv*N}-_IqkfT9LsUdwe7(M)U~Cwa
zK9p1yY=@YYleY^CF&J9^u3Mf=k(09v)2C~`CAF;e%OEU%1OtMgz6s99P2BP*LG4iq
zZ+vh7wzG8aG_;H(h^FvGEq*rOA*5WzAU}II#Fb14;D?mo^vCQe=hY(jb0hzdKe3j_
zdtGn*A{(x4{ib`=#SZ5}?Uw12*7m~x;Pp<bxjhJN&^xW>Mgfevnp<*vHGM(9EMnqi
zutsn2tBoCvTi0+ByA}Ea#zAqh6JGoO;<p31ep9fpu*n~LHg2n4p&UV!6X&2sQ=>-D
zt}uf-T<Jv<Xv?P$ZY_^k@Q#cUAKq~Ya?&z7sNAc~TMM{_EUPHUDHEq1E|Y)R^Di8S
z;yphGiLQ~~ayOc54aZMEguHhO>+*<2@BGSQc=Gz0R#sjE9Z)ic15+eu$`{}-ugGwm
z<HFp(=uy~y--F$LluKi4HR7iATHMUubO&sg`g_q`zwR>emBRiK@yl&SOG5j7ZrfU!
zZ@Q}+8azjsg;O9ky_JcTPaYl7x+_n{C~XZ9?6TNs&!~&F#@x1>jIBRWQS35q<~vC?
zv8G~uK~H+BHsVv~5x(ls&=^-~E_<Vsku?hozh`hy3^2aW<9Y9{xIWwU3()upwlB;7
z`s>ZJbDR5ze~)KYI1X=CPc)&%e)f%e3Qct(#&_ZAFcax3HCIa9Tk{l%m_IX@pFq$i
zwV@1NEy2K<+5J8Hu9TRUn_=-HZsvlE2R)yX(+0HUW2{O(7!RJ)PBpHwibb5D60-9}
zG?WyaA8mWzq$EEVR&d4|R}Jpf>8ui%DIz;?<MSN*YfFyC2P#Vhp`OBTO&~fczQ^Z;
z`=Vl{&qK;nw|eXBDk||Jmoa^2^7^}*X*qATo33f+v9jSk2TL7=0iCbd3|e8Qec)0s
zCvLOFoDih|p8Cly_tsnO`ih)k_gwlJs~n1m{vo{TYZDE6XrJGHQ{ZF!;!x@kVr2x8
z(`RS^)rW2D8@Xt>{u5ZkSD`$S3ULwULH#Qp5T$bGT4KUCS8u~R`@h&ip3Jj|X9X#b
z8ot^o2baiIW<J?rb8oV`U{PAQ2DAcWbMaHui=7n{gX5bDdpSghd;C*s<9zNOj<(So
zqT2W5PS(v|j2w+he|}v0i8rK7`SM1^@><~Dh6>?@7H@2n7=7{chZkDO_Tuf=IP0QS
z#KUVHzIAYV?+9?UvB9?NLReYt6#G+WMM_j{)N_iU{Z2k#ZPflvxm|nPqnLfA_zsBl
zTa3qQ``2qIGVk;8PHSfCZg)6)J~tlY9_IC>6qe@D@l)O-ZRWGi*-^agQX*$m&76=w
zcL)RfocW|D4>F@>XkOF)Tyvh?ug$77n{P?z!#tN_kMPZRNoccBIenOP8MdDP!I;!M
zkzWS$<@WsQ`24+KVsSnTlkad4eU3|Gn>Nzs?=&yeH6*+>nU_#u6Go!il#+aYajMLO
zzkKJQgkPNb=n-AkgRugJ%J=-2!fNah@h`PH*5^`Kmy*WP{u>gQIRal(Xw`2`oZ{<!
zf7yo(0^V~)CQje))k;u_SNOI(Z}C3iHsjA>v}B*YaV0;EibyNFua)N!^BlddM@X$Z
zr8)DYY^%v%>&uxAgZ{N2a@5{)`I1X(9x(-x>-QFVTUi%mBG=Q^wK`SSkDWf6>VD(<
z1&c*_Nv(HdMMq|aMoS|b@0^(Nc`GW3cN=Jmw0X;JuZ~Bpj}D^Noza>z0=2zvIjHrB
z_rP_dkJ-T%8Is;<CJFw5JR~^8HdDTMSoyq2ZE;7nD>U4!D!|r<OZW9$m^tlJb^TBu
zL&>X3K_`8SOK((!gfP+WW1R7?QaD7o98Bd9sub<5dnA_J)JLzlfz+`mZAc}iWaoSD
z-~4>bMz~TFS~V);8YEpm(ZE-!DS`-!DjUgms?<z&cKd<|x<I<6!AIyUyO+0Pt4`>A
zZcru6K{{y^t@Lo@^vp4Hb8Pj;?D}Tez6o!sN@3kmh)<RLp}q-e?a?ond{;{PCiv5v
zvd)aw6xD|x@-6k)y&<#Qua3Sd8d-S(I#?j55q;<65qUX_rUm+&XPQ~nI+vOa{Tp7L
zamuPzRdtj1ZqNf|Re#hSm$}uTN4kNM%BmL54b(g{Zn)~;)3Al7PpIEPgvH@(!?(@F
z@~*dENKB+pJk|6Kf~GZ1YdeSeSFL<NOdd~bI_^~^pVK#CmfplAgW~nADlqe1QSO^q
zWImEwPF6=VFa6MLzg?3OBeCssCDdK+XXnA`3!i_#46OHVP{DrmvK(?VztpVUbHj#9
z)h#!mq4etw8~n#?9aT38-EkeChOaNKUdpQGD;+y4mK=ZN&W!bc`3b(>zWBD}^i>VN
zeuS*BZ;(zJ_X~3AwoYivi5^5ASKmZ_K-JJ!L>|6gAKEt|raLO(Q&nv;jh<*+X>;%m
z%90YC{y2LZc}lsS(2J<41cm=$aua^m1vv{@-t*i^Izq@<C&W5^eCi$lC~_#|wevwL
zwj)@0pjyX0rLDG-Z^8M3>Fs+Qp_NdjmR$4OdWloFctTMLnQm~!mQj?IV$12np|Z*l
zcr_*cZ}!~V7bjw;+jp)N=MkD+GLG`M#-h%l1*Z^A?ipVy-k!27cjZT9bduwyTCjq5
zqPN{RTZ4})ww&Z>y_%Ehc0s8{!2I?RuGSH=foj!Ew|RL$M*nc=vI+#=F(Uk*f-I1a
z3EcEEV0*OFnufI{ZWC_<dm!aqWea@eKk1ID-m0=CA@ZbrgCH^}=$TQ8RRoX`d>_NZ
zr>eR8$mH*|B<1EdsZ>6orjEPyxgw=d9o|*VB*gN=`cX?M6ucWDtCQXoFN5OJ9p&jm
z$Uf+suu5y<*VWTcmO)i^BQ(w0jPE^|=|MRBi01WmRKnLc-~5c2mF{C0`&VVZ9b?1J
zjP3x{3;gmlU-Atq?wjCAZ%RKix?NP?EbhC)5pgmCE3?e|u->7VWohIK;wM3}qdwP9
zdrp~u$>_+I+IGG5O)%o%g;=y^dfiw<Tu1iJ36ylxn2vw#&9she-j$~OZ>U~-)LUq9
zM)EkS^n-^#ZMo&Y+*AVDe}@jg*PPZw&>poTAl`oN%927M6YImd)0#9Wh_=`D;Xuv$
zq;0{0_7?SJrd-=NIQ8rH<%|y=gSn%R!Xds_PPV?R0&DncAU`8N3l(afjln96xZ1@u
zpYK6xa2mTkp*0@)iqt3~I%^y68&Vr<9}+v)GZZ=8qy_4(0(I*VFsvgd2o$c~>6y^q
zO=Y8pZuBEOW&0R?z*hZxAD*^ln^^D6lh&j|L1<LeJDdAf-$>gEA|YnQe5*NODI@Lm
zKL#%{XgyBo%P$K;`H|ajosE$<sOffNn5d9_>y_P{JpWP;=fYNgig@wXv(F9R4&Ami
z>RE}vp!=m@zXe(>uYcdpx!rsHJH+qW+Xur({&2MQ$iJ-#;qBCzdU7|(h-@k5lxGyB
z7a^iIUl_4*i~D{B<<HYO^7P}N(w3u90YCF94umU$eSSwluik<W6sPt^OPNs@<h%CI
zeDJD$7j~tVapU76XlmJtIqCGfMl|hH#c4_Y{yf!+StHF<<V8z#_FbJCiQlnVc2ptS
z;n>-d#whGv{lQ^roKit6v;>O59^~dLb*U0hm)YL4GTpdQD`RlPZu=I`5Zd~gi+$G1
z=dCKC?+RR`pF`aTT@z$Akbae~U4jnlp@i~&$ZDXh92-?%y>^jRzcuP7p@#}^Y?J^@
z&MUv`b+274ALVY%441qf7j@MPerg~zePlcksij=s+v`?y*16das8ryX^^+2uMT}dd
zHEH%BCV@i)7f`kG6)_2vGH{3-`g;Hu6g~b|<150%I*t3!qu+ndxJITrR?PWm^-pT_
zR;T|q2+aCkH-sgu$!8CJ@Xk9f*Q_#Er<ntpG?#DYHVhP;ud6mo4pM>af2p*Q+m3xr
zXcm+UKlTpRK=^ayrj<|mXN^zpt98FWW!H}a@8i|}N@&)5+%&C8sRtnoywJ;ls`Rf2
zS>ROD>6<tVbhS^_5WO{Ew$!_iVdrz|Zt`NZk+0IjpwoS!vAI6cK*f)0j~WsXyEC5*
zeX8yq>T^}l9%WqetuF6#6-jTxof*Xz)$5D;27&t~uKa*pcE*LA_@f9DV(34%8q81_
zG+1;r>Vlqp+=`fCu4gzMC1x+T$<(luzoTR3mlQs1u~R}iBttr0(9pHtwlq17<T6_c
zpq~NX_e?D91&RAd&TGEowoko1r{X-_!Ketz(W?LTr$D<dbf&12`Dlg_+d9_b@76e-
z9A4K|iXwVMbwuCY5)jyED`(5>?hNUW-!8$N@76M%F27h{e!Up#Fy~pk$UX<1nC{p%
z=@3dim$D67-{uk-T&5Ij$YER6FpAD6y?H6dk=knI)mits_m6&T<a&xsw!y7j9e8#y
zee`2t^EO|{?)I}azUk=J4-gBhAD1P?T4y?G&wHEQ6(+JjpY;L<|2VvAH5s}$9MszB
z=T=iYoV_eK85-N#?C#mA8NnU!`Feadbf-AA`Es7%t9Q4rS)Urvjo|&(n&~J__4y$7
zZwl|t;ncmasj<RZ4VphX2U25;J0g>4y&6JV9-xj$?xkLhNUiPT9>0^@5pf;gOg^P@
zfj!Rin{0V59BY+4_uLHPQQ{h^1^MzyQme?LU7OmQHJ9HKX_-4J2u$>Z)|(1U1n!7D
zwA7m#spWC0J@U+k&x`2@wFHlY=x35_CEyQfgNY`8N=>sq3;ZG39|?Vj98Qg`kgU~i
zAGrT;QDC80<5kBuBHhP?kjgBQ+`r@TyFa=<F0!5@s@~*(00030|6F)`JkxvpKPk%n
zQcZFRg^1;rxs#;hmQV;Qw<!y43!4>Dkuwb;w^0Zw_xoioVaD8Yo8!(5X)d`Z)c3QT
z^L>1Ozd!bP@A27tugmlGe7#=J?QwHP@G<;%nn468Nmhzu7!z~j)FO=}sAGq@d9n_z
zv`NE+frbNDb?Bt^j5>7v0%@HGoW@s&)|)4-W57@YBARuL_977nGR73+T5#rB+X32O
z6?tc8qJ3!Ks)WM^ZD#-n5{9}nNL<k%@XIaQi);{Bjfj@qpuHe~!1Ow_z$(qS4F~EE
zV9ClqIZY}M1k+B#jE4fa06S?o(711HmRD#VW>x1K(|J>hFG;(vEKOpG#AObK-bJq-
z`by%0fT4}p)yp&zR}2W8;d|J^QLPCV3_=&52<m*_Mn-~>^1mN`ml}MH?d`|_6~2Qm
zf;L<g(2iMXlL7IF4cCwb(xGPDkuSI-1P~V*yd?`=j3T1XJ?1LWw*cTd1He<b%u}&0
zm5GeUfy}<I)_*Dm+~$J7D#W&+x)mup2?yX)yg<V7fT7%VXythl4g>a=gf4~>e*}#6
zFNn+<U#A(vsJ&g?xJc6g5ctjA<vwZ0$}y@i@DfpKiIUGd2fVvFhI9l~%~mL_*SBj0
zW@5yMy+nL<FHsL|;;jputVBMf+gFRYF2Qhw+1iE07iTMK&>em^Cj*KLynT)gZJk*8
z08cTi5R^LiIzEfBK;qA#W;*GV*VBog*VAmS7is$m$FnPWM(r*x41_uC`EaDR+g*gM
z<yQ^c98rrc<kyWYyxUDz5LVsc1ofQ|T<GEuu1#W`?Q{HW9kC%X<rOjTw(WUClkxZS
zDV!ke;42TIg?x4Ym2&LtmB96wJz4}!%sgGX_s~)QJFxwbSlfU4b#rwiMV%K1`JC-;
z5TkaCHmm&v7JsFazn%dh2%GJQxn&257(<)ie2UL{)Nj7@+Ov&T3%ac;ajzJ@_fTHx
zmBhz$cYIU3TCWEOE;XpUETBFx+B1Cwy!|<%-$>lzyI8Q#HdP+X60juEcxRX6HT<`M
z+UHZxPt%@d%0TSQh;3yh;r}q1{S9EYT1#O&z<>-Wapb$yD1U<pX7$@WFt2hQq~$w}
z|0_w701E#O6*VP7j$>9uR`}^8mm5$~$yKTK@1xh4)XsDQsBQ9<6R7`<0o;o)(DbuM
zOh%r(iba$ykb1*FCPrZV91)VdO%tY(l-qD_t6fQm8&JZTRVkFCM@A~>RQz8`&<mft
zlG=g(7#zSEaf3@VJj2d_c_X%HR{c059x(3<s3--4kXs?aUxEq^p`u~c5FH9m`Uvzv
z^MzxlJ!Xw9v%Y-B*_thrdL1@gB{ykb-+@MpxH_&%gYoz+ns7hPjT?*)fr>U`5Zo)I
z;uf4+42bNagpXRIT><Fq_&9cv*!IEPf7SJv&v8ot6Rr=S-P2Ha-{V^*&_$rV6fD5d
z`{-5EuOtOcFti<uU|FTH&`BZaWfeIJ&h9T_+lA}I5rEAUekPk^X1-hqL|oXUL7H)k
zQe;FMZYHA+GO<BJH{)i~L1YwEv<Hhgv`RZnCq*RUVl#*kW18{Y$w^x#s{Kq<Prv8~
zP+c9s2?2oUrXFj<2>~X0H)vOyaYE@JStOLuhD8Xj($3OJ?TI)Wz=Q?RQ|vn9%qX~-
zQHblR;-CccItb~zly+2FC=qgQ1ZQIbwp1rVP6Q(4=SjIlP>ulD(g;exgRDAVuF=W`
z!J*jx++b`fvoZ{4;#YL6_9j-ty%!hz0VE4RvVyvP6-p3YBAw3$<p@Iwhw30N)@jEl
za5fR394WA6Gn61cOG*+1tBfbYmjG0q<^iT{JSynP0FiHi@fyUotw*guVWPHZhx?h?
zSw4jl8Zn4NE2M}PoKOr%b~+G&j05Fx690L#&}v?~CY7Tyeo)?107rzsk%|q$6&_eE
zW)T6R5f(^@Fc8@gjGrMw@Y^&rjkF4&RRof~ib0gL;5xa{e>1bmW%5iX@b<|%NK7E&
z^|Z0Sxb86w!nzD3n*t>~KqFK(Xzty(SPa-w5=sEjI?>~tZHz&L0VYb8lKi3Wwgr9w
zLrw<YNiYUmzJn6(p<|r)bOkU7SHMORl;Dm=2yW2M0yfZKOBpC3k_b71LU;kW0FC#^
z4aRJ|q=f@Gx-vi<H^97?m~gO5gLwg--pmFSsu0m9HfT2qph8+5T78u^*oHIuKIU;R
z4ix?u(?-}Rvw5fg*tiPo#j)jrI8H&`v0BffK^(?dM9~82a~O!j2+Rv~UE((FW(&?v
z5)6GMaZ*%pmIOZwb+1uwW|Eyd07xZJOS%MT^8sd;0VGQYoMqObUoDW}++ZkM9hzsJ
z1V@8;rGb_sLPYOmnq0vk;(*Pjk^P0qvU>o_-sPyu;Go2?Kt$rSaYc?QHwIx}1`1Ds
ziu#}tkPX_yZd@}4j6VYv4Ix4Vu?X8ZkO>N!S0WqKm7=_qsN4&SYm1DpQFb!-AtM~h
zW-fY>r|ZSqzobiqOY8G)f4sVbc)mau2$L`|(8o{hK|;4@uF=RbZBdy;5?q;kkgIeP
zSW=h0nZAn33}MecbXIGo^eZ`iAZjQv$bE?6^lT4pQ6>?d6eJ4!fe_x9x!4`mjMnFs
z4HCugK@Rn}T)nzeY(+Q8HinG!MMZWB%j&;*Hwd|e3nIS$iFmqTQZWQ!*+CeTNpK_w
ziQfBxII}Th&>h8w(dU&45`Df05#C+>D5uXWuoH7%h_`%0S{n5#R>JIykLVj?ecqfP
zQJ0@FOB#5CAW?xOa!j^_iAa#>v3<zv^_goEQJF6#OeFPB(k8aQ%IV`z047f0O92zA
z6YWvw?rB=KWk_&X>GP`Xw{3}XNa^!NZq1zOk9x+f&l?&f+OmV-Um<^PiFy_zQP}jD
zs6~k~G7fSVXVkVb6S)W^GPT+`?XWR(^c&Oj@I0G|ls+D?A=e+3$*qqEY>;*k$5+Ug
zY2?dvaxYp>HCqj86cfL2@2C3loWb;8I!pGwnxT&0a>P6__=_rjsoetG)V=#;PllM`
zdSt-iCthh{Kl+2;zD_v&L?j4`etQHexZyBo7OJP9Cw80NA94m2&ej&Lt+&og8Jj+{
zu5R>p=V*4}sh^$N?DepFLEqJl);|LuZ{z>+{`7bujZg1K3i}*=+oC<EVdMspZ+(#W
zcVVmk)yc7UScF7vk=0a#>GW?+RnXg&9sdgf{A7-nD9?sU!)-cWi|M(=yLdiv^Yyag
z&^t@tH8{?ugqvOJ+4CaLLo;cW)=v{Z-<c>~#R&%g{`%=cNrm#1Q^CvfA8&f^TU>DH
zXjAiZ&EL(>=}-2+mA@6q+wXK&{3SBy`MmtCagl$})ADuI>k&K5!$DgDcpw9xx1n~2
z=cV=(ZLOby>vQDoH+}Lhp-vum_g>ZGhBvhBMf>;aUw!``i+EXLHRZ5oJY_TfE11gV
zncrY!KomFot422X%q@8r4jVA~q9Q+hzl*i~<n(Jr6^GpyLy1LOIS27}2$uRAo^%)$
zd04<h9(krJ&|3i)yVhROTXbTfEVl2`Wefc1)^O936k8?k$ynbFn+YWuqVwYQw@v8U
zvyG$Yl5$9b%!BBB2zU@%X(s2JU@)QNg059-8_jxJ*+G;xpZJ*)N>rQ(pU(enHzOf^
zyRQyn?jZMFXZ1HB3FiS#eK_$``)~`R2uNm)!!=9L|Ds<gM=TD_@a4TW7iKmGTl05V
zO_^1}?AmlrfmepBh%Ll@EgVtzNc6HTzH%@$@&iMbFJrCj9^Ev{GQnEowiWM$>Xr<8
zy3u1XKX>uwmOQpY9vjSo-p0D*kFxZw@lnf_s5_Z%`S6eJF}pd!@NxFr40+%9%GtEa
zdA2_1GjwmGwsx+349-spNzc!fnO`C)uT`Y4-NJk#DsB^(c&`l^wT)hlj>S-kBrRPr
z3}6U@{VS5_{hoMpLf*GS*LRntZx%(&_qurKS&6UOLyyaL*CI}zlQr>asEcsA_}~=k
zlL9Kfnle^G8T<UyZ?X2>tC~FJvsqK#U!=rVci%}5&>Op`r_;}=`?%#J;wvem$ez*5
z23lLr9PH9aN!cS{ZT^Lqlm7haGV|UQ(10`3-Ua`Km&$pKT;D&LczE8`iWABJ3kfz1
z>zi8Q#~##;-RZMwJE3Za<)k=y_#}BOcRlqhec!os_yz{2iz@z-U(l&OOYf{xw4C#|
zo|6Y6oK36VW}%KNEGnqIcu(x9DSYa;9I&X6=!Klp<9EB0p1XA-?jSlc%YrzFT4kYq
z*-FpFc}C^(buDVu6~JwdYaYU;nJQwJ^r=&EzViud(Xz25YP9^>hsW*7)sbI1@SW$7
z$hmq!X_QU#tpl%wYF`#=-T6g@vheqhJD6T4{13d=3jtp1{@3eo*1jilbZ?Hf_NY9d
zUV8oq^^yhZ_3S@D_64Jt6<n^Tvq7oljWs!qM-?9}p6A!pM1n~F*nEA*XpRF4vDPzI
z$jYb}pjQ3B51BGVK#a!>`<a?ah~o*jR|@sM+3HMy9buSSfoLBg@~9E_)r)ZMOC~~g
zAIgj=W7l*w{VJC&zGWafsvM1~KaJg7esgnq`B2%eA!Xb@@s0in3Z#(wOVw^!P**wN
zdLh4T!07pa_*%+1vS+-XkELw4x+rH<U}8^eA4Ju4zWOx*uj?!&8@?Q(y!A-?@0HB^
z*Z<&G+NpcIsGugUy2>EmrN`-lZGU|A@(Z7QNYbYsBRM8?Z>vq%sAAH@DE3MG!$5Dw
z?mhb){LB-z`GgCEpa+rLy)7&DUv}?N9A~|gX1&=AYQmaCDut9RPCE=$MOwL$MH1TD
zV^U7Ly&C-s?&MLRQn{zPeWkG`_I)RbbYB5G=bBC}==1}lMqApQo+Koy*d;msN*X;?
zv^>;Qe;IU*5}UuvX+M9QTpyY%!?B#Jymg}H-W|h(O6YP#FKdYU^6{uNF@`54)LmzN
zGm{jkKU3ps4;gD>gBvu4aV7-}Qd|RN64^c3z)DM1aLQq9F0e*m(l)i6Ef*e>{c3El
zTTTF4K&8KMxjN-Is`=z&|3KJ19?UX=5e<M_nQkbxg|{r8?1FNYFI)fmTWywmxme>=
z=PT#d>Dv^S*&<|B9`eWAr-5~vymnl#Gfvx8K*f1na&0Bfhh!d^{n0g<^5X^D5Z0Rl
z_3+j7Tw!Uf4QZM%s(d__FXlduor+`E-V*<iCQ7s;{ezVgsoWBeI|xAFslRmAnBrHS
z`<j%r+DPkkg@A}OLT%;@-N$Q;;yhb`tR$cU1mBIjD+eIrwMZeg_V+)k28=Vt?-wKO
z7=JG8p|;r#YENhBP8gbFr(|};!Loj(@Tde%O0Tv;xA@8#Orar`$c!w>W5xMtKmga!
zw*U21dURrG{?PW??QKZGit*pby@}H^KPPB0jGxfi!nI1m`nHP!(d4;qxOg4AfvcX^
zIBF_R9JQ!vrK^dNh$^19QuA5Tlmo~(OQ`KRG@>gz>k|}wtz&+vx<jsRisGChJHL!W
zAT`u|fFSLv9lNWwIle6WxfE&?1{jLB%sMfkV1>;vw?fcSO7AW#vTkCdv3%$gFnQmg
zwt`sD+rdrA8c~>E(+yO0aL$H4IXU55`{!MkNOj*dJ+nNZRhHStQu*#}SAW-y+0m7}
z&`=a~{jBsx)(loEf*@LRhx8+@ZJ@}bGe5iYCNLj5<WUK%RK)}p5SY!8*#sNq3aD|r
z*e61=C=$FK=;njrrqx)pDT?}(5`EXP<a9>00%%muqwtD#_oM|jwxRQj2X{d(_bqmX
zXC3m-D%s|i__xrzv(CIp)%`W(j`K^%#Z_xv&A{N7#bkhJORMrsfKqBbZL`a?-Snqx
z!a@?}HVvzE+=3Z?Jb44Gc!tQ+cfxg^dpfOtJPRR=8g`Gul1f5prTo;mWK(hiW^Oyu
ziwVG^4{lwKq2b{@AH?0d;H!&8R3g9+pQPDkfI}vn4WvtlOV;EVzQr!7nPLqj*vIw=
zta;?5>*<XDmJ5TmZxB>)UpUkd6S|qqe)U7hOftI^uw0sjht#+QfcegK0D%vxvF2ox
zNPyf~4>RUSBYd@=Nd|^!+Htp6+O}|~+5EMNvGoeJGtMT*d{Z<Sw>gj{v0}assohG%
zBVNdfUs{gD{l2LsJ9gjx%xvQR-`}@B9i31*`rY4f?tU=~aLD+ASSFO(=u3wvqer4E
zxr8T_xYzt8r<SBv>~g*1RV)XM^(aSQ2ZgRkfi(`-;||Hz{l3GW`Us47ILWEww5RVW
z1B)4w5v~8l%es2$!li|@y%77{=VIn5Q=cD=uuVqh=cIHy(D%bikcbF}YBgM*j*!*2
z3+>5lzxN6{bi%N$!~SsIruW?l2h`IevtRbQCZ5ZPRz;>vGakgJP%LI)Z>n}Y8$UK2
zg?F+?KMF1{P%iGC6os4HSl~NQZh6Y5@4d>+v%Mvg9PiAM^-Ia!!>FyQfST8$_4}cF
zR<4X^7D!s*w7f!mJcV+lbj{iz7kc^DrO?RQ&g6Le`M3BywLyB`q8M=J{J(cfSgbxa
zxGUOx+iQ)k?ekF-0;@H8C<?ufok31bw44*Jh)kG<C&eXD%w|2_pfNmC0~cMqhlQ<u
zs{Fho{H{W%Z?cm`-$=XVDV~OV{~Ov2YnIGWha|338ohv9&)3ol7V4S`vg9_P%vmMY
z4oUZJLAm7oQXh(^;Uoj<HgyOBHJ=gUmUMa*QMna^E=Ww!;<JOwgWaZQm!8@LT*C|>
zb6vK?LS55qoiO()?HEh|fw=gdXbapC>gwQN%@G&uCZ$}a>~{nz;r+z@3Ahw5q`jWt
zj1w`poAfUl_YHD`x!@hyVv_W<;sV7}>7HV6Gbvf}EJ~UBCf5ZBA22ABnDCpG5O}k#
z!++__9JF-qoU|G_CgF-@cgK($-NWl20EnzLmCwY-poiadr=5tp@5gqjC`8_R$c)pN
zZEW+}Z&w1Ya;UoMAkl8NxSzId6y9jWTZd9XMrXjEGR@8_my|pMZsg{ft0{okOce#X
zo3*F1^v&|;rz5|pkTH-LpaPi4_3ykjVb?IZMDt5vJ2uOF0qUC{%bm9wBZ7=PRG#9v
z?^<3|amDe;ncfkmvB($kldPssz&jO=-}Ye39=@f!6^<|a{1bd@4Rtk@0~Re@ft8==
zV3d^GX$xy@>{La`<#y-EdBC)<)u<{AtH$2=xJWV2kcG`9?ULF%{VC=i*($2TojOOO
zKmJ`5J}fZtL38~sLtIAMcCa}7FFL(Z=WMGu%w$zpV#!4w9G_79eeGgnZgUo~<;8U2
zA|~Pm{^4vEHU#5NAP$s&W3s3OgAtvwb)MFh_))f<M0T89|E#qsy0Qb&R||se3$N_F
ze0ypLt4A^Q@VJoo;E>#)t-Ygv(>WJa#>i^{uVs5jK}}61#}?pW--z`AGNXqq%VXCB
zK`)k;0FPQ#YkhUZMPXU+X6luHJ&H^XEHqW4LD#BP^X6&x^XBC0s$7}ySqJ5AQtekK
zr-MTLW|7-8!N-TQ_xKii1_uwkL<Rpnmu1iBv4(LTpB>xln4rsuR~MYO_LtWd>g?uX
z%~ujEXx{j_@wBY=pFlC0oB<L-OlC0FW_?Aup!tGGB{c;A5Eh!0#Bpsf)(yrJ7`6>8
z{Ic4!$tfqj5=@8B_r<N34o%QyHT+K*!Ot7Tr&GQ_ghxR93{HIdV5lcXqrhnq#AB6f
z8xoh+8;X3iHJS4DIor_gW#+61t;VR|9ps;WT<55_Y{^@mR){hkf^-k%rimsuyAldP
zuN>zY2LWiZM|<VPB^{}gTxexhS!9J-WzV_ikfbD$N);P`59SwDbJ(oA_*I4M!d1l*
zBjOAEVA<GIjB{S+fYzT2msEXO-`Ct6=@)G=&-E=`xsSB2tld(}eJ7d{&@$XFdiL#G
z_;s7=+_A_PDch{K#=%Yv!@7Q<mq&E()&<251%5&7%UH){uBQtR`JRk&8uFFbj!!)X
zn-_X|>pJKBf^Hzs(=se2Fs=K%?h@pBP9W0jmv$>Au(!%DtpK2_Okxt4)w=G22MpNv
zHFk?h?Q;9%_@pb>yF2Y>++l!j`9s#vosYSqzj?d(sxtTem2quqoyDzh&g2Oh{y4Yw
zI$><eLI~WK8K(I~4gEuTKke<|bIS03{o(?3%`6PQ94MgCdcQEdOXo?wH8XFBDu~5e
z@p!$0QiJT_aVbUsN%=BPZ1RK&Kz}E}nOd54^PAO@<TWN6BcCNGu;$dquL*)r-1g`(
zyHGX~pRlZer?#}4tp-X1v%?y5iVLj4X6ZeRb{N<BJbaQ)y$7R^>SK{MQs+JAx3RIQ
zz_#DZ%iXgLlGmS^nvaUJ^V~Q8r++aaK$AA^a3T+zOt8kgU61`1QH;4o62>MQ&rs8{
zfg&b3!O}Ll3_jlBTzSh!R4e4WG9E(R?s3R{Cc5&L%~12wrxx^Y9o>g@!3ATsJ~D|Z
z>MWnUIN=s^nr)?C4nxU=J{NpB?3nlm9maQIxCL(hd^yz?Ca>z|0`oTbsMX}l!4pEz
zrv4l?w4aBNeL0f6khiI?R!0qu;^LY8n&B{f)aqmL_lX^T?rJ9nc0STdh>V>FepYp4
zD^F-kNX=z+lj9R89roy9&W9h%iz-Ap&kwcMRJ3S$1GCu1g15sTn8ilr6}GqJ6@<Dd
zv8-8^)AkPM*7tlSPDm{e+_N=xw~T$Q;$+TC=`TG(iQ=&eqCI=fos3))YHGhu{FqK4
zfTrj~bB-Q10wJNj9rHAHT}4wf3W*e_({;jP-?D4&oS&k5-nYEf4Y{#z!G>DfT{d)E
z)#Db~ZxHz{9P(<JBtW_xk`wWJzSHUP+#s(>Ci6dvOI+&z`yYii`r@nYcgi*;2!j$t
zmAhNv<!tx5vJ+r7<!22<&zU{J(k<MDlC8?8s0N|IEX5jXNZekXhcjhi?{ltFmKSpD
zm$GBkKBaN#P^prli2Cf(p{CIz0)7ikEWRLE+DR@};P@j-n#?DZ-V>dVVrrwOmom=y
zf><Y%vi%llcb$_p+87hTe2+ol)GQp^Ce1bb<9jTkv&3p@x&&gMpoITu2IBbELXtdj
zZah|>Um?Ee*?l1$VcP`e_g#VGys|=qM@;-Yt7$6uHf|sT?mTy6tyHPV33pt|FTMZv
zSvk4zIb*C)^1~?=pRhu#osYame2N1NrqTFuxk;py^{g`=Lqv!{*Q6!_0w6*6|IsE1
zY^Iw6B_)#XPW9>v#g=zWZUHjx7F6K>XcHv=yMeos3a1TQojtlt^HAjnA|bq`jdB&B
zQdWsdZ=UE8xtnsg3m4u_3L`TWhu|fb-3V0pAz=KImo1z^T{_UG>Y+9m=GuluB-pUz
zWOKqhTBDKud2q8l)$!sAK<yL}1l+ub?crtzCW*(azQH6FP?9q+<~kmuwVB#jbW<GN
z+&v2ZTgRSkrsL9t@Ojs^akws@=ksM0AzTP>x)OyDPg4LW+<ZXc9l5CiH*2VWXd-qj
zEy4clF*|575((8iB@5O*4`$xEvc86C%mqD1t!76f!MA%z#ocCj6oSd~1UCXsWAJ}f
z!jZT@BYVe7OGhQQv;Dl=kJil|?72yNafLaLBm7^{u?L<S`2C#tV2Ias*$56*xh$c%
z_PVVdvxA5v0@pDADwsPgmQT(DDkMB^m%<c8Cn4P=0No3qRtU(q5QR9v!iiOGvphOp
z?95DkG3*@GVc`G^UjPe^|8$xUOWcSYAv~bbEclW`PxGntF8umKre=C0JU=b=h$jXZ
zXGssB%ZCXg=kgR+$CD(O*so{0c`rPUonL%QvUmJ@W%b@4W!U<eQo5ZJr?tz{8z8;E
zetNP)Z+HI9<STl7(DcUmwfC~JbKq?m<=!ff&b;(a=G>XN3sX1vXq46YAp9@8@wB8!
zYaTn8psuDWy!HQT6VB*w_gwf&rHMCCTgp^j^Q#{!-1uVK+Cv;<|9@?AxG|UA8cJ&_
zO4kJ!TS?nNYe0#wX6RW3H<@}fwyWdKQyW>%m7T_%x*omupJ{y5`?KgC@=p3{sUsQP
zW3ty-HL-pJ7*1|39<m0x-AyAULQ2Piy`3FZF3W0D-!Mm=jccBw_Wc7jnUdhiW|=BI
zdrpZn*bUeQ8;*d>goFlMY{E}VDP~cJiF*oD1Cszpl%kRIe>j5qmm}){M*@2P<B0!}
zxSt$kiqW(A%AwK*eXkZxaB_lczR!U+S*+KnjxZ^J{~eb~={{V#u43>hm~+S_@JXP-
z$YupJy#2iMausjvxAxp&*;c<qU}FUSyYveWzZYp#E@jtk#)9ZZBRr9F*)K-^2LJ&7
z|D1VeSd&fHEhthHR6wbs2vQ@2gx*mRm8t=0h7O^Z0HF$~D2f8oLg>;0MgvFyX`zVH
zLg*c(OOeovbog%cdA{qs?>WEDkF?3Y_MW}=%-Z+N;uTT6o$MKWb~I)GXQQ}{gP7fW
zr~xMz-L01=ts}=dOvU^Xe5XhaF<n$>&B)kpNz?mL?e*2+x^f=X;G7=@Zi0y^tkfR`
z8D=RXYe-*D!sg>N{p3kGi@X3&2i-_yjk%OtS|Lahoy35c*?eLkdpF6XlRI`vBM<@A
zl&yfq&9x-?d!>@KBOfK<$OZ_(#3bJnun_@-V8PjCA4@^Q<VCXfmcn|vaS{%d3)N3b
zazPxPiJrG|)blzoi4Fc%lh<-jd49Mj=b5LA3Y)#2SM=lH0%e`)Tu(_hH<gpdn|O}{
z#8xlEX~(V9&0QUHiht8)%H0Q1?d;a@S`#Htvs&DOfsbHfS|PP*8*_V4;070!<5uOS
z5|9Q(P7g@KsfKw<soLR(f}RmVRFaiU-lE2-L_;NORj-X44N1m5*ah+nPftxcdJ~s~
zLmuZ!BGX8&OR9a?sUJm{FF#XyRoRgrn1b(RkE+(;6>gfrKz_^goE#X<_0+FOvUC$a
zg*O$%ORp!E{%Xy4*3or*VUvGv^JnM2LZhjq-n&AB<GAhQ(kBL#=gY5Kml<x9jqaKu
zBRXlDd>feM<t1brw+qU9KiLuSxkLkVQSj9Gv`igt5oSJ#y{Wk1AO6Cpa;-b4p{qd7
zU&P!!=U*Fnv~XTKj=V~!^nd0h*6j8B4I&rr5+Wii5Nqv|?o~HxD<tX7sp>4Mihf7x
zklXf`7=QTCO0U>rbUNDirSX=OJk}{nS?7aL(@ZAhx73@)d}STGT&Uz1^8Q8MKIZzp
z*^}Tl%E<@5IhzMwhV#Nrd$VfyquR1<h#~2h%STm>+(czr$!$~AALkjIb!Oz7z2+Yc
zB&T*WM3o{KF27gGyAe^E+pr#Q>MRO?S|m}-$@|c2qAWB_t-bWqq0jk#$6wovy!tx2
zt*kctKAq?7umqS%l7r!Ay7+lsqOS_gt%B^$YA=oVaZ}Y^d_qljvmDE5=a|=Fvr{Ck
zX}jx0rIQ}>+E%Xe7hp@*DZ?z3)J5Y*$xfce>8v)c@&?XYfWugOyX4SBt%uMKY=Rks
zuF@A)nHa7~d*^!eb8^S9zBDT%o6d%bx`y@xshA9hEF<X)x8qI-C&xR+-fIwcO0W3E
zPIWB~YH>S0Q%0UXwk1#vwtp^f`$!^4cX3Fj^c(x+FB9T<3mWmK>~9!D_@tfZulN>i
zDDkiR3VmmV>^v-Y{+wFd>2b){vm<nK7R=XfabaS=fqE8vb~48NIlDdZ3VpLONq)0p
z9l&hP2(EvV^kyY?yrP%}{u~o<C+G9S_VUx)DYP>`w?@21#719MEbWF!A3`dfx~t1u
z(JxMf;MR^(lipy>(^e=2wYSuWX9F8@0@vuQu`E6ksAqI>RkM{TB1zoQjQLvos(}}w
z0+hUbKh9U2`_szYm>1^FMz6~IPs5+retyo?z1<k@pnlJ<%{WOcH4^G!=rD=D_|4?%
z7ZWR*b`3fY8HFBH_OBO@rHIjQ5#m2>o=I@s0zMA(hk=1J(gQSI3#F(5g<eipvAlx&
zwy`}#v?jxWw7k~g8n{9J&MC2kVeb-olo*#>k;!Vo7u#IfFkMUis!MUd%0{@M(ot6n
zwA@cMY8_DrfH(7osrRsD205WB{U2SDB}#Y7C9dT9$eEY$;!y*Y<n?{|&Fk#XU)=5U
zH9b#zs-YC#&JZ}3>ai_z$QX3q>dI;!GECM(I`8hC1u}i9`uEr<vm_HfJ(=qQde%Hf
zddW_9EpbeJaRM8**|4>1{m9K6oMD2}&|PImO3Mcgnlv2|R+cKLrg+z9n$WUUySWoD
zgT7%JlSazpjl)rJ6UPq%!|~n=Bod21v@Bi;7*clpfELi3`5>g_chHWK!D=@HZ1t1H
zRZGIJIv7L7q-nNdjGKorx$vYlJE2WGhM=LGdm=lr%$}P9F(9oPZ6@;|ldNHaqex$Z
zaZ~AMsXi80O$DEPF|BW;Tpq1(bVM`=6b{dFWuPs@UylKQF9iu$KyMb*T=TSR!Qj4p
z1Z&N-c25fM|6FJ#kXwC7t+D+Hi(0tP-xLZ;vA6^W{q7=XR{#PZ;r{~yp58bCVz94p
zzPSSb&wv9#&+yLz97OY4t#6vM1X#`#i3ELU&|L%qEh_oHV!p986Mg^QLhIdXbw$?5
z(Z&?%-jr)$ORUJu*kak%euGPq=G7)yT*cYz-|h(hG__%=Q0Hc4G<PP)?hr}>FcHzk
z;MNNgU&i||0_%2;`TW+;Q-e$r2AEO3D0P9fIK}TkL<J$Rer}G<fV_XW@er=0VB$aW
zP6BIDxZ3IE_Xye(EQ|nRd=@_9V&?ygLmC<*kS|sh4|4@d;;f}F)^+S_xVt^>B`yEl
z=E6HV)z{ZnvBp{pI!~>$4#JxXt2bFjwpM>w#0eO9RxjV$WLeae3YgAIlXdRo_$}V-
zyP5YQc`%!=O?@w3@dS5aKddkr+(0or5v_@ZkIB;0u)02wdz^L!J*P0n6q4REq0k{x
zVLpp9&uR<TC>+>{^)Jrwb@Y#W;Q3py3#31)eGJh}_XI9kP61!{1V=YEVOcG>7j*20
z4^CcQWHz~&W^7saW?Q)GRKB$Rd)3IZW?Q{qFtDSz0nfz{z6SM27v5Uzy%VUc*_xBi
zh%Z=9jiqd+%?k{tIcx+3fs<s{_b>^7Z+mx^YUp%Z?_6Jszz5~^0QR3~*kX%jMSr@Q
zMAz@<Uk8SZ)fcXRnGJcaS+H>3=E~8HY$Klp2PU)N4w&h!Ci;qkOn%RB89@$WB={o^
ze2+e@>K^o}y+r~}mxY74+ue@oYdfEiGaUaW{6Hi|yW~#N$xo}e;GVYzJ_l>!U~F=n
zzGuEX0K*~xgS3744CT0$=xeT{3`wY(vjA**0BnVrS7`#}Xb}TXJA2Nm7{GMldROu7
zTbjRy`0!J^E-}EmHR>+<D5NE2bY;>-Gbx$^Piqz!POw}F-~ls(UM8@BilRUuol^A_
zV27JH&bEj)N{UA%#5cd<;S^7xzh&r`#zCluk44+gHNV9v-*Y;Me8|6VJi+w!?QMW^
zM%98h%B)p)L&kwIou0RcZ1YX0-Tfn<TmcbzCYnw!zuq6D<-*kmCIs8sj{2_gGqdg$
z)zg`*Wy^vbG?v+V!d;_T^{Y-v&bu>gX81biQolK*<b?!)iqdNtw%f-}>&%X@d88h_
z3mYMRKj5ohN%p;y*hQ>T7kAcLoEUL+gycZJw^*p(n*lGUyChLGzQSdbW}MEnp;#dU
zI?OYb@|FcDl5HqS>4CORxUA$%@<pkE>(&L2h^F7*Wnsw_pYRG(DZ0k;ukG;rQ@ZS4
z4+JtRmPnIm@3YmhHEzauhaW4Ny9$-DHJ5_~(wxoj&2kxaSFC6%V5(x<rweo3qd~v8
z=QMY7jjov88+#4d@h7>KIE<8@CDPV7%YL^+jd~@yQc3SLY#g|(x)HxrF*GXiD?6Pg
zGSK+3*4uN8exq6uM4WKvJ2k3KPYh>V5j^!&Hk`_x5E7eMm%?(I=oq^v6zn~pWoJ3+
zU6mq)Z)e0P3K{Fr*Cqw_IC}I#i(iZ)#AOkZx(&3tx^LK+zhA#88h$zZmSJ)ct+O!~
z?Mc1@T1hPF$rr8<Uv4t?zn5a9RfjVnG||+d(y&nERxPXx>6NH<+oec2|5^ZJgb9Ms
z`N(X#(Y8@!uv|(QFcv{*3Upa{H)}%rEjLmyXaBhL+H*kQX>YwF{dmcQpi&uVvpR8c
zp!HgpW>!;O;wH2uB_i0muEAEVVaV3aLgdwe?c5ZN6Jcb+u{%dfJInyCqftV7(gL$F
zj4RqS?&*Ht^yHPZ@;`x0-xggsIp*q<!2v^J6Q?lmY_J^rqw6Z#5Pqe_VRTqa^y`l;
zuM9aQOq|G0&{13LO=!-f3jul;x{X>18no4bbk#`BLwF}m-zLHCd2{d(`fc!E=IADP
z{^UOM`}U48Q&<gu?Ky5T)#H~i$2z|Mm^+M|f8h-q5^HQC{B158ZN0t7h?|r9Ep`oR
z9e4Y+Ko`QH6Po>^24D4qs|{%?5`&a6O-eM*y794Vuo9pBXc~MUncw=#kj0F)5s%_@
zC%}HiT)k)?hdvem6!NjfFAhzbKl5k8<-1wg1vT_3R+awOO~0YSOxP}Iyu?dtCs?Ox
zPQ$_t;366&v2zd!1eOEvQenXN$4m6F7vngT_{G?(7mebW^P!f6c1^;k0KArCuZ`Nb
z(#w+A*f|LW+x(`LGR1>AKjppIt}S6LZ9!HRZXI5Xdhvvn^R0x%{lKVYqnPG$pF^B6
zOMVz_zU_CL5-ur~>N9I;WI;3wx9+t>^&aF&3}<1#ij~q->75ZcvrsoO=*5NmT3KV`
z?@`a{%yp}t7Fx=|bu%L<)A0Z{jt-px^3#!qomB=AVYaD}8sA9Ix?rJ(*)KTqy<dgd
z{)jYW3pdPAKa=0n$({qBmwG=1&#MT2DLSga6cXZerJyIG@%~ot1X|-=B(vvY@zsiJ
zyG-XE?YS)2mE0+$#v(aiKnpMrL=)6MX5OIK#mkxoAHg78u}B#%X3!Z8Ehf{*#(w9O
zz|pgtT>Z%WfmBt7%g)t}kLey?DHw=|>)Mp0V&OFUfR21im2m^qH)yB6qpW4a$qYl9
zX{ZBWLnRPNEgu%+1ihTS=?zkK4B3(|S(2Ry%7P!=!kQ{>vWkYc33h2^O(Y^)waeTe
z-)s^F?@pVUbD_B6k@-FEjajMzBvD+7dzbti&EIt=23hkA3<&{%4FG`sZh^IJw#TbC
zqMhufYA$e<z#@ZcEblrhSx~9N-+?8tu?`RgTWJo(^-Gg85>H=K$Z-w=T{f2FfC^g?
znUeq7jx&;T`Co*{rw(8Dp8pO4{_w@t*dJWk<=il8>&PgZQ3*X1-DTYU*!Av4h**zv
zm8`83kybVIkZX%`V_>@@ql3X1Tz%>>?E$Kg4Y2$1z9XYngkZ((l(})Ie=)VWnYd`H
z!6ztbvsyM*e5)#jX}ArVHb^TEDNXqjXEJel!;PVCDM5R1<ffJHndc*7j0<i|^-G2)
zs=iY#xSe}3lE#85b)i*5VbU5h8b`zrvovoGwzVfzxIxLNVyl8IW__;_Z8FO1c?IGW
zSsK&>FMeNvxZ%}iO-5;T!pqKkjm%rj=y;8=ITa{g!<x3vm{IQA|8O+=U=>pZ*OcZJ
z*cccYS{so2YB3cF6H~Tz`n3AZa*AKGlz}=_r&(%{#_1D7rzI;#s175S3m;_g+Onnf
zr<P3G6wzNjyIr_57`S#ZrH7!<W42pjtTR`_`7fi61&M<HzZq4Q>i=fc6>h5OhW|IC
zj#p{_rnOOFp0<`~a#w6{l-PF63mUMb9rqf!BzPZLt<Cb+2{?|}QpX+1quod}8)~tQ
zTD~3CXS-6}>_nJck#dA_3EmPd5ac(ttFy%c^e`BJcl>WMFn*m0<`~wG*h|ei(*Rcu
z<q&FEF*?6x_L_6TaiHM8Sb0?tbTJk=M)8K4a9-m)B+t}1L$ebdEVwo~&Li`iv~kxI
zBF>snjuSYE2NI|`MFA3cTiysHz%=kD0mXRDlWe$hbHQ*!7G;16G4~Rz-LS?buRsl?
zn^ys%yYTf~R9@E9U|DqYD;+kG1of268?6y+hXF%tPEt*dSoOvs2Rm!)aN2wg8ww%H
z4PC3&P%6%Ede57aqqyIW*rJKO6ZU71-Ur+ZPU#qmegsFqE^Z->&%cSP+~so#`!!SK
zz&yZ-F!2DoK)Zy=Ym_KjO8{sq9Dms!Z4G!irrKjKYR6t|bowg{?*1<p3ZRzy`66-b
zgSXVo0|DfC&8)9;(WRHaUP)Nbo;rRW9$gcaNYcLRBJ~u`(iZkIpULF&`ng(7x3L|2
z)!3!(9pA&x{;6ppGd(kV;zLfI+Z(_$F*L<M(?u@El0~P9363C|?mb_P7`Tk`x}AEr
zY4ajXO)NY(G`pYSM4<d)*l3q~i2O0<=>wdX2XNjrz<D>8|BLh3tV_DD0wc1fCf7`#
zvWS)FhK`jX-}el5EXwscwqGHIm+IQo#1}93J8Iax51e1o%<gEUulPL_4QDw3W*sE+
z8#<gl@T9vu;wI-ntMEmwtiH~SO(=<5tTqJ4!PFwh9r+4<DjWN!7Sj6<EcOB-kI0|2
zs%H)z$K@!}OJD2u+^P|&5e4t4qnpcN`7V!XsF+M~jpF>IWfQK}SJAI2P`)g*I_4>)
zRol?@omA4J>{}T?7bJB4qyiS)BE$qGsnmWk`Tji@nQ(I!rlyETh{~WTRs{|JF7WbN
z_xqlV2<J47hS)i2DTn-?!J*kYt@Yjb#syYNdArI}Q<iGlJNd<W2~GvRx!0ft1|aS&
zY-a}AX<_};Ow)p$4A9YoYU+RjHq1r$SuT*hUZs4c5iO9^119zMDTFc|iyiFj&H$D-
zHc<qv{<7;Ts3FlkS(a{$pM4tyyX8{oflVCgYwP&(@kS_CrWz4EM3mnp_^+maQ3np<
z!DC9Lt*P3Di=)vv$V)l#>Whiu2Xu2)z3<G=0W^!{<Jo{0<~r8(&dAm)B@R!B#W3mR
zuxTDlm5HSROgr_LY3J$2+S0Fhwetp(<$E@!!XvKe2gdg9a%b-+dL>LWWicgj*<V%N
zeN=SiK-B}V`M!}|iyeIX^q_t9EW_ROsfVD;H`?o72L)`7R+l2`KFQZkFoD|L+m{J3
zW5lfe!&OD6an)e3Lb&d;rK2gC*0@(OLrdN)%n)SsQ91u3fv-~8wux@(Dngk(LZvCl
z2kDoCCv(KLI0v>llP-RZm|Vx+wtRUK>MK`wT?DZ$O(iCR@T+|$&_K4l2k|=B3)-qB
zxQo6YEgj9oxn4YQMH3HqFzl`$YW9{7!SJO`v0<N|OScpU$GS`H3yGu3l>w(t?Tqw<
zFzxU0ORgnyMGjQS{%}5u?-lSr=;_uy?O(kv-a%Q9t3RyX-RP*gHoe;WPBJ?v->7zb
z62<9ze)HtyCf()4fxJ6La*SSjhiZ6(`m?#gE0&%;{S{=@<PrROS-PKzhO3|1J;>}x
zv~uHt$jh~9y^8`7ip&-hM+PlX$W(1R_QnSg$kbtp#b*v#vgHqtP^3^j%T=Jul}|87
za5G!}c%_{kC5(W#)}5uZUGkuMI!?cwLFPFNy((8vci{!_i-Z14%nkY|n)8>Y4@67z
zJsWrC+_@6t#(d9FzuB^)pF8T?ZhB?m4L*B`?X;5AzN-C<b-a;c>XXB>)T_hStLD=8
zpBm$y^Jp)Qf05GVrVz5Shxmu&c!%WR&`p7P#+HDF`==nGwM2Uxt8f!V!8dqidXIwF
zIXm8y_sl42nwMP$Lab3ADoZk+Bws3fX?v!OpYcbOROS6&5A;W)t`T`SyIycz9AA7t
z?s&srQ8cbBo67x;-I~vZ=|$n@?++N=&x8`iXox&%2uEy$KB~l*=61K<3eVznSlz&p
zvziEdR@_npr1j?0mv4?{$=@P=4+AIQv8%kJVGV*KajNG*=ue@JtV)Txf#WGfo8CS0
z+0|qB4WmRLpeDN*^h;_@9&r=(iFaeDu7J7ty26G22hZ>EOc3HvoFQfU{~UcTc&R)h
zWy1Med<sct8j(=$f64NpnN{QvRqT=<g^QKa>xGBtNXv^;nv88^I=S>saCmJgPzsf%
z^hE;Usx4g7+0Z&|CJHar_Y?2J%n#xg1)<R-l6o;gEW<$YDv0|=V`&*ep#Rr+v!=dI
zJ1Gi6AjA-0f8FSvj8`xt#44kLZJN`p$`aGq6?*KH6=UP3*6`KgS`sdt;IEhx5EzXi
zwO(IcJNHCC<U)T!<kjgzTeC;jX{w6-3AxFa5<<d@KD*#c|G9!Srx!-WM58OBk?fC(
zSt#B}TP#k{etOKt)~?{+!0S}lfYY-R6&#)z<BqSKnOZ!v6Y9EAt>%#SuU-wrUjOnn
zm_O$k@ZJesv#Zkr2N9_GcU#4?0&Jol)7bAqMf$2ks=DU&h1P%P_HAX&sSbCwzQRxc
zZbfFl7ZUFkIR*b=5ck#7IKpc+SApHgP!z=4MuI$n*}N#V>xnw=IfZxD(r_T!xZeBu
zvpn^@jcXFu=l+D_%i(AK@;n|+VbPey;Tz<(k{JPh?|go6cxozUprN_7_Y)BDkCp$K
z@!otOX5ih5@A%nC<5{1kigKLb%V{1+d&74M9R4@g<&*K17R{uy(a3Yg03J$ne+%)_
z+SZQl-)n0XYT?ZskISRf-~)eBz~y#&<wd!3LY|)RL&ZjaKRUBp#~1g4DHt%dZuND%
z*y>1<5iouH`jw{P?gPP&kC6U^$v`F3N5{o4`m`pdhAR^obJI>6BUdl@E~t!gWNj3*
zvR}$fPfc82)UnP&wkDd~`lGruej&f5!l@)ci+Kb`gnpB4<7fU#Gdqr{WS2bhu>cX*
zMn3h#;LHnUa@4j)8z1GeAb-hV(MtfhIyj5Xx#H~Y^tZnyjtgPzSHa>j|40Okv??d1
zV~ib2LEw=yWNG9YY~aIjty*TL5p_7R`aqR!$L0L~t;e6*eWSJ>|G2_+q|z9uGHKtq
znf?~Qg!2q2Bqx4%z2kYQoscohVZ}3)YYY9fTz`VPZbYl9QAE+_g`83>uu75~%nx_i
zpXk@dud%Sb2vO+-!p`v;nJZv0Aq6Z#;LSAk<8l%FO-_1z$c@INAx(^1lQ9vUR#C)j
zo}T8HFY|*Hor7?H0WPJ^o2L)NnDI_Wl`ffCr%hc7#2hbil+A*fPuJ)_<&rrO??f(I
z>m1)%++0|G%Y_t|O~zQ~3&IemFHHY%sg$h<zf<5Wflec}(-aq9%y{TLQHd(lJ9oEA
zrk~O;kNq4)>Bps~CNEmU%gm+R@@4<gjcnCE=*uDcGwl7ApFO@?rJr5lnCX)opT?&n
zuc|lp-!fgunOB>NQJH<u?EPg6;QK*RYFJoE^k1D$bxFs&{wXEs>aiO3<%iO_PxFr_
z9#=n7S<*GPRJNFn7xzvr)K`|50>Azbp$;Ld_F)NzVA}}Gp;&cjYlw89lhpOv$>~U_
zq_mse9~sUPVSe^*-yO0xoM%Q+f)%uhLgWUf`QOHqdlmG7MWrnxNk<K1O86~B2hpGZ
zxDc3}+S^y4tRpJiG!rcsm>l|Z-D}ZNR2H35<l%L}@?qw`GM(&jz=2?)bR+UW5Eh^9
z<q|=WeRHRPBKsFduhSWQ1`|rvz*#ujrw2d#E4ACZ$zP!_PTxx-VtpeENl`L8jxHhT
zej=yRghbvyjP@>GNNN!tnIvgv3E9u&|3?z-v^kY`2EUUjX3=yHd<#+Tap=m9qA~`W
z=|Q4u<0v9veE7S;UzzF-^~cMs{mK61;f<zamF^cqlWE+1OXiMkL@6R&#o~{AnVQsb
z5?0Oo*a#l1M_<XFKX$Q+zWV2OfgGO@-ApT_1|%*G@aad9Ka3^kC(rIN&m;m~g=NYv
z`iH+5^_<4;z0NM1`ib?cjsey+ju`O*b95?o_exXi{0u|;XI|9^L@s=R|5&5*^a&=)
z4z)0vHFhME^rrLHB+mv1Q~PaVKjjU9mpz-S3h@By-6xvT1^eP`ysRRW+p>_(disCy
zF`|M6i4j9oR=SBQ=TT$EW2*L8LxoXQx@Vp)!Q4{^>l<~OhZTPXN;fL}urOY_VwP9d
z<XE6XG?^A(J7?e)UesUWmkx9Oqx!KSmS}Q@1&CLqZ0Tu6&h>AFa%5iNS*Bx_he#Z)
z6>}`pVZ-vJbB}i`-2BikgoLZT#Jk@=d|$nycK^rjBWL4T_NXya$-bYT_U$6ZOu0Y&
z+e{3B4rTC-WC*nS#)oCL0(tsh!_fu+eI^fCPu~qiXKNd>MJ5wGFIY{#r#EDyH8x57
zHF>j+R1b`wFl0jz2+;(>dEnh@dX5)#=cHj&CjJtut=%YZVc?N6@RdY@P=`fY-MzCl
zdEO?oZpuzO8f}whEH7AB0J$2U{jVJ6`iw5rSU!y4$!I-2$WrY2n9aohLPl>_R-j6L
zWxw6!p`BJp!q(%PIZlcr>rbC~I`j{vbUr_cK}tRjiUE+s{UEc*>QUjHc<~T!wQlK>
z0!WcAe-l@aLEIDp86k~0nGgA=ZwqAfhTk-lc^;wIl8iRaL-T`x{ttT8)JzH^X#x!c
z+J#@B5$-c-CTT<?Yd-_MU4AGAotvDB&ie+8{cEGdeSiK^7Z=~req;1r<TMwb;ar)n
z^Q$MRmoT;8Q_5++Cj1Wo00960WOoNt(@XO<y-M%B2}tiHB1J@`gP`=@dr1r-AkqZ{
z5u}E$6aho8fzTBsbd=BoNbdsDMBpF2_rB+R=Q}5Jc6WAm_xa5{yE8eIeom2cWDG4w
z4$(^7kSU%hIQYyk8}D21%+l`UZkStTdjie#xtx4v%)NA7O6sJ?;k#saPN;Z9Ks+n=
zyi6VQe3Rg^ldJGuPCgM(dOAwS#pS&Pl%?>SYRvHu>sts6`q*D{6W9+`Oi5j-Gfc!P
zr6j<dRmdl{eLaIBxF3kLpfjY7zJ<yXwPW07w%I_SEoD+_W?ot*N_WlWJruz1?-}hc
zj-fa9Ek3bk-$?}KCgfm2G4?4k`Bi`d{sEOsaz{?v+)93rghyefwaGcUR1uw_VURRf
zE``o0ckuEl#~vt<l{tlPu)w|Q(iTV!Qm{OJOVc`#lBr=ZGMMAE>f$+#J+b6Sx*Lh4
z^WPR<wni!!&o7`s0dSeQ0CC@n0SBmIBIxk+E|Zz5un65SDhyXgS=8Bu_)E(pxJ5je
z6YN}4F5tH2Bvn@zRcCBb4%d?vDZot&HdUlL2+zE}=cY{M7M%~tjimzs#O>k&I5GF9
zsD&ibGY8h!yuwXD(T)5aO2@5WpLp>4U3A920u&Qh+eE*(GCuofx5SwA1ALuO?q4cz
z!d}Rn)!mF9UEV`ZgynUNM*Up<^m`F=TY$AW5hj-gL+QD=vJd^fmF(G(2HTU|QfYP*
zDEb*AA`_pV3$yDR7z)H%luFCY3|W(DHR?_G?#B6j6K&pikX9FA56RLnpd6}p+I0w|
zUpyY?EXDGJg<N6^&!95(h?eQ)&K@*AM!w}}qP=ULSx^F8*@`uQdE5Hp=gx{FH=+to
zF%F@l#5=pskQ*!4W9L=O2N!V#EK?yWf7rne|Lw)EQ{HLHh|b8f*FK-Rf_v#|x`*}8
zzWov(a507N2p3cG_$OXDnZ)=8Pt%WR8DqkfKjmkdmt~7c<P8pXa<U3aoaAZzVMrbH
zLZqvlFB-X<IM~Bi2^}EeSo@;OE4Z;XE_GB_kIwwZ2zqbniL%2%9eJ^J=njS-4d||g
zcwj?1!`+8*VcN417D-Q!cXg3bD_>_9p`yrNv>m;^E~DA7)HpVVPa322BHrib2=43q
zeoxt9)pPk!C)2&_P31m$zr}Z9=PUk1RnbW+*q}Uhr4?Ku_`!99d8(4>wbhRPA1`+g
z-NR4b)=PrPZL(n6xVa|w;qJbcWqD#QAGAzHMnR_ns)*V_W=ma`id#=#_H~b`;yPZz
zoZK6iEHJM{m~Ln(jLN^+mHbR(Oe;F}3!%&NUkbL<LX^+zNh(MX!MAyHt09B^3j>{2
zqf>yAs-$BqgxGae$J}ZxgpHj)WQc@8Nx3IWj9nRjzAWBx8P(I=k~VXtRR+l1un5YS
zteCnA%cR3dU0qexD)6La0>IOY5is*D9XHq3DHy(^ODXy<r|Mt;`s8g^4?_^OObMs!
z;@8#Umu;uA<%R4yeBXCHDBq5bHhw6df8yKMGaL~9bR}j-q3wf#kyaZidPf0T8K1PH
zkn)~AFV)ey)8Zb`rn7waNuWSho(yhf6~oBake{qL9+13~dwC|Un1FnPlhtoXo<3;s
zcndhcYUqipKo+bS*LXqP#q~v)R;$u3Y~aqq7E15Epxe4lfV7O9FV@*6Fqplo3XaxE
zVNEk^s*RiK{XWkQMnL35q8}qbo#u4B%p8)l72)M)@{j)t@ZiCg=3eVkUSDr~Y`lOv
zql)P4Cx(>6ZccEy<DVBge*(BX^qeqxTeS!BdF?E^Fl6$VO+ez9SJJ^NJ|NJ3B>vDQ
zpxj|F$U-0bhqZm(gAkk#7%Xcg7=lN!q}>cPvu&+b{Kaix`)Z2q&wWP?ng?BwE`7U~
zlsP#}m+N!?1?#XLV%p8vSLgQHZf>W-%)l+1zR_%y;o65I8Oj&pct}gpU60ejHufXm
zc(7rriRJe6*WzHHw|GMB2Mbx>J&%9Fw=S$!G1+sufiE$<ga5d>@7Fazq!E314Zwam
z$R_b@^eg_<<pxTB%{3B%V5r$va;O|oCcbC~R}KjIfZ%evM`~-Q%wGBl8$ylfCs<Cb
z*sm|*lwW7?A-QCoN$?gHg)JAU9HWH+7%E<%qy2RyF!3zPxEIZ8g8g<qNeL=~+`C%m
zm5uL`fluL`jW5BJfxpq&<pQxTlgyos@=yLtB5=YxVCH_5Fl+;|Q$-yR`>4p6_gF+o
zsQ2?~;XPifLS!G#nj}}6^H^GHFNt6*^yvct;9l3jGK`XwQW0=3HMJL4FxCwSR9sv2
z|1z+AOYji^0D$KYEQV-!TCFA0O)knx3U(fF$}%4G7LMP1JbXhly=lw-Sd=~}`#fx9
z=(AR}fg<Y_2i|wEdD*z~1%9nDsZ!S6?x=x<s6M@c`EcjWlHQwoGai$=7qhQ2BeJ^f
zMnw5_P_yF}&U>}tp#J#n33;0xH63&#To;hHlDBPKA<*yB?!6q?5-~^PYGWzuiJGH{
zZsz0No=CyPB;CqqOl#(ofhy7d2y_<kdt{7Bibiq_{0MxK++2j?M=s<?u8(1SdDJA?
z)vf+A<Cz4d2_xA(L$WBOSmJjdhw!i%p5o$=BVxxA+CWKgBr!hJih0S$LD7#KYe9e%
zD@KZGAUSLtF-gO`ejwbf?702$<}J%i=%*t;eX)b_SS>kF>mw?{wI!bpg>G_UaVNj?
zU?Z36I<uJ^`_m>|q?ZUB%%*19R9^+IH3;dqoO+VV*Zd%{(HFlGoZgI@1CGv_;BFbv
z9X0W+u5O``pYOUU9-*J49-j^|L+6a3ACXTn86lW!&g6Y6b&Pyu?(ZTwzuJ)kcBogy
z0Q7PLYozs`ku8oE<efVOe3axCDnWFrt4^IssWO5P2wV-E$@xOqn<1s}oB}Rw2KzXq
zF9{04L9dZ|&G#jzDOY+~!$I**ud!Q3gm@&%`8rhw{0r{6T5E?oW?kLD)?wHR{&h5^
zximYsnNaFT-t2$J5^6yjYd$0=+y{JW{m?~10p1m&1^|H7@wFe4MO>>+>C+IXdFjFV
z@o=zH@z5T@V*olIVeXzQ0@4QnK=nuN1!;&ptc|scFT!nKwySlkr$gOD3&nyCC4|d-
zt*y5IgUcr|G^TXc%m^dwH>m9AhC8vq3lGQ%j4nh@w)VM1`-0#B@wx1X=6>^)(wCKT
zRoL&e8i9pK*e`^tuQz!SKZbV7fmq%Vv%_>(SBF9+HP^9bLr>R*L4yDg7co3U9c68u
zui`OkE&4M}1hlX-|6#?s3jG(>h1-5YI9P%-1hK~>WY@I6=9p*39)c*%W^cKPug#pZ
z4MCu+)_f2fdpY6H{79j5xWFSHFN|Xz<li{?CL;F=vF`edU6r8tQft~|Gdy$Rh4+Gq
zeY8rzKOWoojMWx;0n@SmIvSm?#@S&c@v@!|wQ;vuam;&|Bv%ze2MI`&t7?h;C|7l4
z3bk^DUQ%!`=!`4)hiXdhw01Q9CK9i1Ky9(LXc-zTOopVky3b4RqmA~3A?a-{>1{bU
zd-A%7LAcDc<EV|M$43!}ZjJMDn<7HQuD)>oDb{RI6cUEhaQS%p>mG^Ui@ZyjoqTb=
zC*8FlbXPx(DJux}<@-K543*v65(cFsT+$I6*X%X>OvdXycqj9AvocKN9GfWX4fV76
zsPE2IRl|S%s|xyvkDg4HX6ksmKA(L$^jW>p8n*M>HwQ$Okc#-_%jQxg-TYhTjJd0I
zwx^LiD-8^v61UHD;+PU|!9QzZo)V9Pe)M8W!%|XuaPDRJv)9pbzJl|V?%p;l(&~sL
zIq?+it<uI4S8z|{4i?v10YVTL-S}3TiRnY-9xNedwnciXeaMGR5Y$**hz)v1*!neV
z&Au}aNNMHhC%xCYwEBm;(wScdU?G-?Lwj)WU;13bF4?+T7s)~pHrzsCZVQ8-?{-3V
z*RaL=(lt+?tuNEwny_Db^ICrM2Hr$o|KaHvHy<+p>gq9{X+GDmbuF6Ec%O`ZZMWUu
zua4=BbwPsBwQ$%VAWT^e>D#k0j#N?RmTI$7ebXm&;{TlU_4dF(4%5o9`@<D<s~O_s
zyx7M49)&vu(7(W%M%zw)#3Oa7Q9q?FW{0v%Db4K;Jrjt+7C4I5x&S!4DP`tUN-BbH
zY@Y&JER*RMTI#_5ve6~RX4<6eVt4uvCPU~tvGq;0{>;Z+v5j30(jWz$>5$EgH*JkE
z=yqZQj|QiMi0y%HC4oN7gYlNevp;Oe0PPzPHRSNF`QG=_8Z1AZcS$Qn05dlS5K77h
z`=x!A|1bss@grzx(;l+1F2U?}*}!E7VQu>-`(m{~vmKkYDq!<((3!7V+sp*#0e7jg
z|C`V^nW?Q)js3cWYn$y7BUml8`hEx!W$WSxb2;D(hrA)1Itw(+TTRY-V^Mvu*2oF5
zUQD20I}hdUJ8A#SH+9mEvRm^5Y#e~XgGR|iD3yaL!aqIlZr$h-YTuj&6$S&3I_RB7
z-?`7vf{gw_Xh+<TBeLd;t#Aevb`gVj+P6?P?*%vZtpb1wa=uuQW(cbh#AR4`;0?oR
z@NqEH>V50$(blO!ozTtc9l}W9&lmJg)e6e~dndvn>FsN|?FIOlP#!q+IBSEeqoE24
zD5+-mvaJv#K8R%Y!rTkZFvmu4fw-lOeatuJhjPk=GLL9y(+k7fd_P~Wgz#dYs#X!F
z=Z4On)6(mvChPy+rXAcJc`aB%W`s|Jn>gd_D$4q7(m4nF4h4z9{yyAd^+OA|=FO>2
zzF<09Z{0vMS;(5Bs@9B1O4{*RfBS%)>!vi()Dt3+sPt}^wC;_)M=%KHx`)%R6FEpD
zGpf|p+CM0CHDBAWd-7>h`G864G$^63QrY%Tm~ug9)M{;>Jz$Ezg-!sp?4*^*w4!yT
zm5BS!Bfr<oQ*y<`RXeO{?I;Xz1jC1WkVK0{4#{+GaQN6919kcp(MbNFpmXG`6dK7m
zO6fKH@eheC_R+)*O83vjns}1aDd3%-UxHchzDO8;l1kV7IC0UD?fribqZQ6XBYl+z
zbL4&K`;%-U&CT2WaunFVoAahpSS>F$l`#IBN|M6CdC_wFMp~#5w46BlqVeD41x&;$
z|4ClENAknQLrvIP$Z4*MKpWHIUiHv3F;iO1T03YVE15t40zL$giEH>)TK~KvC4jDs
z;ech;GT3QSvY{jppp@#{rr_+EtIv{&c^+QN#$ywFe810E;9$ZE_h=$4{G0C8RxZx@
zgw?AVrs)HPhk7%77i<Swl97u+{S0#|H5bkNVzS1(ouiJGhi?AqHwmlH@0GJCXByv}
zR|kH$EqJVuS^xIc0QqZB{Zn^()|fu`l{8US*-9DB)Vog4&IdMMlYV1yl9nKLQp=MP
zs2^d*-%gZ*f%}*(-4Y|PP3Z_T8(gL@@~%@ZB+bI@JSP&Yd8ne7w|p~s-e0Cu7!r`_
zMoxHrcl!n)!?f~ByBp1NO^JKBGEEk-Kfo22t~1@u&U7!Uv~1*u0`cvfm%8%9*zKSc
zT6u>iLrW3|Gm0Ibj$7j`oPC(O5S<C;bL<c5KJt69z`_)3GvWp;c3ct~izv`ZQWkUU
zb%D1W_OeLONfb4K-s?hAjMzrNs~-=YH0-=*j+(7aZggTnCz00$vfJ+k9k{19UYBxv
zC7d~!@BBd<mxe9N9%IWg-QTKi>yAh>h1|wJSX)K;xAK2Sn3qR$=q)UD%RYdg{DB&y
zD?jMG7gWvTuxBV0)roXliKeX&G-k925n8gApz*S@*RpjTu+&^HFo5$r0@0@<j9wqu
z;CT*pO@z*Sw|Zt-XyAD)_IpD^CXNEwMh`tg0MCOB%)-(dWq7>Yq~Y!IUuL~<y{eBX
z4Shal1!UW9TzQ@?hV|@$F||A`CpWC;XZ`Bt6YYvR7I%Iq9^T}_l6GE&sEYbllm9F*
zZUYtmucAbBM|mKKn^~;p80ci2R!;aemtR|GIN){}h0%~%IlQ#-h*#Hi4W}cE&ti|k
zuaD_zyG4)jd0)ezvAjSK19?>FABYoEFSB=-4cikSbHk?}8PQnwe$_KW9aGOjkD=38
zR>p}rgQn}#V>b2_YTk1pmAR3lA8GN_Z>l50YzQ3__dg%@sz<oR-fRpx&u?&WQUFXq
zv%ji`#fG0Ri}q~(>)WB_?kIo&U37@X_J!c=QU?@v8`=5k_H)UE+w4SlWUV!N<e44#
zM76(sNqol3Lz9~7|Ag^Cy`dDsGn;kKyLTbRJ!)UQA-;or9F4?E3;B2x^Bb|D1xm?4
zB^=qaxnSazIdY#X=_Ew^Skk<$`y*)9>^$aUy;1<f<<IT*kd<21L&>Yf6X<QmgPM(b
zQA~JE-~OP{XYE%Hbq_f;eP=_&)IBVaZ!R8)DbChj#&Q-#S$_&>;_jbuh3sWnn3P_B
zdndb32S)MU6~yt@Pb;i{syl?#4%}RI7HBI>eKjx+;J13X>Rl9v><@PxFZ7^+QVH=M
z#NXjPprB7VbG6+*5G!@g>7pcd-cMe4+QD{Q_LIeVtq23lG7t|M-*Xs{?HY-IVl5vk
z<uXq%e;MLPx}Cn?{?Lp6#q2xE@@EGp+b;V?qwr@3`ok33B_Y*eeeZS7I_yhAxXPY!
z6{hdw7f*z8H(<pmLZ$0l`7?<swFaZ5gkIuE?A&9lM4*l%l3COLcQHBdWj!mI6L`Im
zXpPprTG7E>{<XEOAOq7^Po25_V>CyyT=ML@6Spae(zQVMir=M4K_(!s3HPvx$3yaL
zmFklY|E~Qk5mhOO_33Sx+Zf%k-c8t9TQRo`tdmNA{Q&>w_nDsXQ2RM^979ji%~|(K
zC$}(+iQtn2iFOo1FpS$&*nt>y|A&2RX*FxxL1;1HcleYHs6h9X1bdr^N7z?YiOaCl
zk$W{2+p{+U(bOyiywpASq9w^;q{mCqD<(Afo(`!5G15OHI%CC}(B-e1BJ~_=h11VG
zON8+ZKF<o4fy*Aeb7Y|2Hj4E;^st+oQuqn+1-{L#M??17M?22a><<cNATA5_qc%JB
zXxk7nGEqv)=*8f$i3jL{Pg#&kV!-I0Db!5JAWL3jsEt4lqPS+G2MfiVTrtPOi_Vi9
z-@4kBOe8nbQdo!#KR}N^`*Jt?7L(>m45(-z87yn7sE{q1%SOR8@;ZYNE7;b7Z%!)6
zS*gikjFofi))AM2Vh6`Z&CUL1rzjDf-$WipWG-?}onI;%R#Xht$Hm{sC;2I}{CZdf
z#y7rGy;l@<_kn78chXZjHu4zf=St!XD|4h$z(6|td8$f9s|Z}EpT-E8r@T@?hEV;+
zZfBod$CZL~#}y5~HzE7tb=+&eFlXjP3==C>^!WCVQ!F`YzmSrx){Jk3b|3DAs%Yvy
zz(d@Ru$I5uE}_`bKFYPo7)uaLK)8wLR9&vhoQKI|#tR?cded9<l`Cp|i&5q7LXYML
ztA?VlV(%WWFgkb-loWrHiX;N~%+qq_`AWSuXpYuQu##QT5f_5oe#>a%cGR0!&Xt#u
ziaY#w@uUBD@hZf=^8VCKYR{EI;{Uf)xHk_rCR<2)mF4}cwItvf>+fxlI_+%4a>kD?
z|Af{;hmYz;%b$5-n06R!*{vToedfxI$%yqieB|Wvt{ZLmmeX6A*@^ZC4oMf4B|omc
z)8p?2T(7bSNIaYF^5Z61rP11*`&(;wiQOhW7uUyIx-O1p*2e4b(!%Rt(!ol@&B0;0
zTD6$q9W_DRb^%HJ&BmTBRj`*L&LSD!4;?V?$#FWyT-2)@Sz;!8KcpnkYz;N$+n?T(
zuO-f3D;`M%qY&wB6E>4io8@<}hKmd-2uaWf4DzofX-vG|(Q{~#>17rCk^M?f<SEJX
zk8d^Sx0z|q6uSoL<l{b4%TxW9W&M6zPRWM4KYfO8f1ri>%qFtsfacTFC1sLDr?|^}
z+<@kn)DW*RBR|4~ZeI%CebXA|UG$RThG_@$u4xNa9HgdElK5tLL{-K%LilF<w5Qln
zxe6;$aKX##cB<RVnQzBv?nfn39IPx=*XmGA%8b#G2yqEdB<P|z;)@?n!QL&8(8oY{
zzTM1!{8m<|SK?>$I@!9UkB|pyHIZyh$9EfoucquosO^y6Q%}PqR0bU(eXA`Rc>d5j
z`8Q|8Y9;;KpxWNbTW_0Lxe?L?1L@1|n8?XsQz9P3M69!iR-uhiAxG~n%3jL7#O{_b
zCFv?5;n5veGl4)wsiCSTQ9Q0@F;Z=0_NPt1LJ98=VKSx-S^9Q;JmZM!F(2NAapCa{
zl-$1iaEv>3;8O8C1XGIonRP;-jvCZZ18O7qQW`eznlSDUG0QGPbF$gfU_J01c{#Z|
zlIbIHn9>nSU=VnM-Ik3n)(-d9^T}7eJ@7Rz8h~ioMLJz<YS!<0x|LNo+=AciY968n
zFDTVg3-E_h3u2xf)h7?}Gkia3jd4Dzr>>e3OGEE4qIST<br!=BL8c)8(5-t$zLkE%
zw&>t@6}ELjrg>+?f(pb_Z%)<*^bNy3l^$oOMAv1<|GD?6FY*a4-Vuc?qht{P#g>@n
z<pSCI6eHWYN5tTlFHRk=MBQ00V^x`F72k3EqLeVSZ3ucSM#J^?6>Q8wO8ra>2YF>W
z#!xCrr4e0KxL!#2EH#TXR7rF5bbV~^!8`Je2cg=O3o5RgrzK;1y57iYss&@=j0c~9
zV?Ajd&Y!jIRF%X_9T6I$Ox#F6N6%Y4$m)$)yq-&`=(AoDiEt8$F>Yj6^bb7L1Rku-
z$TX@M3)x-7o<yQXEeO}eJt80RA5`OLrgIXB5)uh_jUaz2g9u?>Aii<;euPxrB_uqD
z%e>ZV8g}ZS5lHT-0(6AXvdya`r7VO3+AbdlCa}%_;t4#Hsc%ztfrL5EUqR)HIsmb8
zwb`1XASK>DVYZWDght||!gkJa9CIb`TXUrPqbuSX^y7n6`a?qI!x-wr7}ifr+0=Gg
z7FKsaEGW+(Ocv>kp)t1(V;JKkiW9}Y$*`cjE;kED#tdJbt8*Q?&>zM`h$>H8exs&Q
z-@`Y-{nafMc@4suk?>Yi)lu|2d^4^lQGQ{_GzM}xExa+YX4vLRB|EtyI4t^6`}(XN
z+kHuPl3^4RtQ%B9X;)suZ~hL`V<zk!A;Qo^BEs;3R-EgGAngs;sxBdyo+v}Ej6}_o
zANMCsO_WbnD6Sw@=9g>6#^Z94M2MyBQ1<6jRPvwhln4K|w=wcE&KE?7B8ulzv@D<H
z4Uj`h1<lKT6bh4|UvTNPp0W)}^Az~s5N{qSi1aKE)K{$V(i#}0E^8>B0a_}CT1cAH
zsrMap6z>tAN%GD267~3y)A(AA88t`5kj+I#&k->Sdy|iJ`>c>NG<9QD(OBsvnWv;a
z*HXrdise`N&QtR`w#%Z!Q2yNynn~>_^@Fd;83xqO);hde1QgQB$Tv}{D86fTCz_ai
zH7%$gjia^kzSeEA){&o-5LX<<z8#t{ezV6l<<knEm&{&UqETn%OP#6}%A?l-Ic;|}
z(??i8Q5A*p&OYQYA277>-NLC5E$SLM@0(>Ytgj9169+zibQM+99jKm0(bTTF2j(D6
zS#YkgnWFwyJJ)YY<KaU=+<+m@i^28jlX<4L)7Y>?bp_x4-sW6(0m$PJAjof){XBjL
z?SiD9VXe();-GlzSx=eGBEbR9Vb5zCD3gb(pHsAE7r$opO86$C^oyw6m)ByREc<ge
z;xd|f;JYbvT}#dbi}~Sh<`5Yf<!aLDyeYER;sM*ilEiH>**U+e6e{?eN;@)tp1Zg_
zU&*YvZ@()!jXF9EfIWS{YuQogT9&%jR?up}FlY_#IclaETr?2lDriOISzHH3tsRh9
zTqhN-9pHG8KnVIJl)6}ZIJyr9DQjN(Kk}zo{$Jbi(x2G+LCXX42j^PTmz=nKg@WfK
zo1_5*KcfQ)ermWoA4N;PST>&M;)x`Jj{VRG!cKVnnb0_jcHQmyFV7tKyAg%w1sM`(
zsznqavWBvQ^!W#Yw5rDw(8V%}>%Nu7&cpNMSBE_k8YQb{PL=o1Ec;^Z2A^C7P6%#i
z7|RP4R9t||{$(SKb$<x)Lm?ldSnT87`ibdQsF@u5`nBv93EQAJn`%!+)TXHegTtXH
zc(N>x#?;7Ui{4>Du<fH}KZ8SaGRY+!tHZJ^L_JYsx`3H?7yli}rP^2>7Y;)YaU{(t
zt`X03Ze|CrCG5~X<_GRO^>ceg6%~^2E2b*ib?N$Vy(bOcdQ<4zdNY(NwxmU8ldw7u
zc~cm^^_J8Bqqp>))bsQI_uWrr+SfB|NcHeqU=VvPjlXG7TIuPZoI)iy{AEu{8YsQ=
zm7Y!0^gAi0BDF}$*ckMRoDU%#qM6Ui#K*;*_&iy%j&_tz^$YVwVMGd54D*H2*jp~V
zqU6}f#OEZ5>YQZKM?8{b&^wA`(7(eZb<XeD*`+(HJP!1Aa(XkB;dOJ0F3nOX->=4j
zR&g)p2sD90qy{vyU+iZYOLyhzT$*Fbn)Q1h{jX5!$=iyTm-ZpYn)A6t;XT0qwlqt9
zJT<6$=Ne_C-<b1I{T~1T0RR6~c4b&x+p;YZ+%-sW2oAyBH4r2OZQP}S#@!*fyF-F|
zu;A`aknZ5_E@^__-sheDzI%VnRW)U;8mnZ?GFU36j2jgx-r-{WEwp~0n&}@M;U<7T
zw<h~Bg43@(D(U<^;*oZkVhgPw3fT;@&YO=d2o|BNA;tQAjeSHP$PH*LLIom(++8o{
zHhnzX<lM1ZW9}dgU}fORy2aV|l3l~q?G1a<cD2I}fO+@gc&5~r$mfe#i%G>17DjWA
z>fEXov)mEy@R=P^Wfj2k-}FRT9@<j(PSTlQwz&tRywk2uWCudFu;ER1@YWtSY{(Ao
zhv(6xr#Lf9osAl}2e?IFuO}kYnaaJF#z?ZbA8m7W%$i2X+r+pB(?3E-ne;bonns8g
zD0Ogs4dBn5zgi@)TKINmE$vK=Qi49_8jhTOo)`=Zq9DGiR+QJ|Mz>qtJQQzB#$%-N
zboKQMU#817yJEOkdyHM8EGU8gWvd^t{w5~Qy0p{SASOO?dL?9$(9;Y3>xZ5m$yoZ$
zoc!SxgT#Zg@iJ*UsXz01Tv431^1eMZ0nQRC^9mYF!`)EA-%c~VC=ayB$E~wKyHb*o
z?qo^DtwX0886eo!>I?HCQjF9=f~lf3M*j$DX+M2Inr<x2Rh=qPVJG9Wk|B3G=y33(
z-I@D*l?+6(j+i56Ut`WoAOzXFx<lA+?bhz~*vEPE94#yrhd5%@K;vAIp1pk<6Wh~D
z_KSCu^Y1P|8j1o7Fu69MHU=*k0{3J9{3_|EWVq;#hsRXjwvHBj9<ipihWi#l2mej&
zchtd%wHh;2153$G2bwqQ#NsRwXMnq9mk<Q|o^}YBgQ?e}($}F)3cg)o4TwO#(52lf
zBIaCdo|sexPX{T_PfY@fK7^6B$rIU-w7qxhc*-7Zgky4IMq|h09o5w%=pG7)OCU;0
z0*2^tEJP{0?IgP>(AxfTw~}q;vGh}Dg9xV=M0E1oYSbnqrEValKI9WIUy0pmwaC+#
z6k3%KFjFX(MR6LqYpMY%1KoHFl?s|t#ci4W=jJkwi%Tl8;JiF_rQT-9RCQC~wTEQK
zsm{9BRcf!1>iD#07ncE<98JaeXyoVS`ND7A9GJum$tUr^Au#oWm?6g8d~@He8@r+!
z1bKeGSroPc6Vg8I9J%?mh(||0iv=85h8MOIMjHBEULRGygtr@EK`hGG%V>}WOasPB
ziU&DDkcBF4#IavYPM(3;LzwRVYkDIp;|fu23>m2+_#b0xd5Ze;NO8Cq{u~pwSKD?8
z^DsI4&K(_7a3$XuN!Cnh?-F{*JppB1(CuEPqH;gl*Z%!%uxlVQ+LoS70IJoU7;OVf
zPP@~%)M6~33;(FLHB8Js>1`-=mvX5^oX7?vjkRI30Re9fz)kU-KmbYxUkyPzUky%?
zyO`w3ncW9D*aKDJ<g8LQRQqB+F$5n~o`V68IRrUNeto3R_|~I9o)!SYVLw!hR94^p
zH#UB)JdB}ycP&*sV^T6k^WLYaG|e=&y~8eal{mjq;8!Ud5ZJ`K8ts6xz36t79thQs
zG=*9#+X$yPs3sTRgN7h9>qBt98Sp<mBj9{JXG1QK4=~m!-kh#I`F-oyx|jCEfXxX?
zH^hPhBrJ;j>X=vVX62#J>do^%E+X7#K@WExi3SEr((-SxxH&o#LOCBJDy#DSB{12^
zl_QlGw*QN>6xhns^_OG~NU@ote5oJ)wc9fDML!&gGyU-!8Cv(=dhr<P1Vx#+P#}7F
z^L%)&T))MylwYIF757;fLT%i>F5*OQg)ZLjc19#NqRt4d4UBpx1n1^R@2(Oyy{ed~
z_b@9?|3_qIJ0gTWsPrwk5l}6FLSSlt;Y)-m^ab~aCy(`o)%5xl0P2X%<=iN#%E3Ux
z8iGtppEGc}W^Z<}kBcDyEFWXoi<h1Ie)0+8WbK0#aT`qK3irx|K`;>cHKwi{>m@h4
z158j5PS{)ZD>(IuxSH>9y*KibeAc);9~YJR?S(kXzoBt!<xy!VMbTF)TJO=zJHrU?
zzVDwEFfM=H#|YhWZ_I|blX=Z{^NK5B+KPZ2NZLGp)$$r*?9&vZ;_5`VGjc+&J4YGU
z9BOd;fM*0rzHE;V*YPWy6ec!;koKQEsCyYw)dH@y98O>#6VqM%DNbSpxq(f$Du4dz
zul%_(@ax6{SL|Z**9|tO5C4Kg16h!71le!d4G~QgEdMSwnPp)~4;N-M0Id3dU&0DQ
z(6jv9=V2YMos*x2!#PEHoFb}N4w7}gHGS()3>pxp{9STAtAl9-{uzMYUM~;1)wArH
zn8pbhlieU8pE&a@{}MX;956Q<XNf%(aZU->*`+;8WJMB4@lUlw@(ObXW%s&U3p?^9
z?>x{AML&Csgr1)vA3CB+dCJTZ@dt5Dg;To;{4cSYX@y8NZy#iyjn$vIAO9ik0#0*%
zw4xL5v$uKTIC-<?I?4Av`QQozr4T(>`i=63S9Jc8-HW49a$LAf{Xh68Kk@x@`dS_<
zO#p!fWMAx3c%<3waxq=J<fjvBA3*MOl}MEHRcLYmZ;7q^zJ?$tB@^ABk%K=l;>W%G
zxRof851si<95Vj~q1la!R75M9<}nDp;r_i*MGu<xF$kaK4{N`LA^fOM<FV@4F(3Pc
z!8_f;(+O1SE}_A&K?yoc7v?Aln5R$MgeLQI{GpN5f8I!sKSrbeTgj!MRvyG0mP4sD
zL>U&8V=Zh<ZLI8doTu#4Vg06#-!<BA-v--C5;@y)Eo?Q_W&#^_19M}dM{eYX2$%{7
zbKWo(!nDblXvR6193z{K@`E$p$dwuV{h_<NjRLPI^!`EnLw?;W9QF|bm5LcKfe~p2
zWRsd>fRgw=Ekz6G@=eO~0J%~>hFV#%+13#=*FL6kkk_*UYan5K=i^Ky2Xpy-N{Y^V
zXP5PYopDklMxg=m<K(})o&IdrzpY0}*HQN{L2s5`k(s`C;Z2gR!^t%XgzU5lc;TI4
z>B{=bFnxc1pR4(VOiu)=bd37BIo4qGMX=)1GOW1&G4+W@39U7iFow=1F|_o~`Lf09
z%b#D2MER16-c(!^oBz5<t(9k>ALW3r{2j4IMcz>$kLdhsDa$PZ>gDvNfB;{2+U?&{
z$=GV7I})v>RdY=PO*9%Ix@9r>?_?Riu|eEG@O0!EWl;+%@a_v(TN-?BUA+b}ISa-G
z;=D23hJ$I;KpZ$QC29i{&iV{~bQuu=h!d{oi~9q5_P|~$1@=)f1wU{j0K3%2B<M6?
zweuMkQMM~s?GS?=^|D3*YShJ@J&GSWm_6x}i4CnEB1Cu)>Y-<|r}rxlORg6?)W8j>
z8Z&Cc&#SyXkfWVwDlagQoC;|D4o48Oyp5c@y`9wfAg%N>$_+8Tx~ygZOHeUK%yDJt
z>&gc1YBy>3<8Ywe^ojr}Xk%f+X9o#N4cb6&AJPwM0U>!m5^tXAORaYg!L;2oeFV^5
zgm(wkB~<b`>b=xD4Ej3dY`%{RwHw(O{MIBs2ZJdK>~3L1=`YKFcX<bl?i9ln=AfqG
zNJ{><azdP}<!RS_rfAaW{;((@d;3aanRYt(SzqSlkm0<aT9M(p{z*V>XdTtkW-3qU
zB|#}``Ig7UL2GYG15!Op*=hKizxfr%ab%st7FxQLV|7tKzP=vh>Cfi6)|Z&>Pj}F+
zt0pmGkYU%T;P_gUd4jEa&~Ce4>it-9aE2?{{w=+e0$E6ijT=;-zZKtEvV7|8JNJ3_
z><2GszEkA}syws8E!pl8)k4u9OCnAg($J4-AR<>}9|hE~PFNl9VRY#;U*T%`lHF#z
zUz+7x&Fx8RvPQ4GA5V$(SxAW66-n;PyR3<YC7!$8qS4hs^RlcQE640MW0(DWG+obh
zOG8sk`n{#36Lj4fp?G(s$|=g$1InTH{!BMRnyD3DP|s~=9=4)ql4ZPzhu|Aat=)Gz
z>bwJ7BbLXfNg_8)`>jzUst2wA*nVWNu0^QMG0)nG4=t{a&)qQ-<BJ#KShT`fT`tPp
ziC2al`|p1vNVb1X7drP6-D_rYiDzX3oM!HDyF*8xmp@NBkCYuu&rPcE+)d1^S_Zl6
z0QOrmq%{J>T;gN?_`xj0Tol~#1hbq`>bm-mm!9Wtpa9AC6Z-Xh605Lm->-KIk!g^e
zEMUzEvi>>1rpfxk^CkauNX>C%W7_tm^gd@F7Nm^}`0X{8s}`QE!S7_vCP!w9Q)yNR
z3bQ}Q)BCiA&zSvIHd6ZM8dsbJIj6RGBj(?UYYSm=;1$pq(W+iIABUyLI09Db9cv~Y
zgq<<spl{;ORGni)e+OQ>QReQ0vU`kOUP7uyts`}kJTYCrTU`+)W)im~>Dx7QC$5&y
z<agGueT*NC$rmwvRdE%VTH_S*?8DmQ86+Pc<I-!!NC!(B09G{|tHvKnT^gl*Z-+hf
z+lH3R|KQ{sog`X;vb&63pyKdecV8xQb%d*&t#@;E=5CA4r*kI1B}j-w3xUFTsOE)0
z*&Vj$l#Q$Y$g}5q6YgCx2hzIYZ@mrc3J>4LpZH`6`yPr15<>pGr(B6|`%ebtSe@68
zuj;^`7^P&cL`j-O=~Dhp%j$rRLw`3w<V(Z??_R|2Sw-6^Lg%gX%1CpqF1aQ)Ti|Y>
z`e2_7L!%B<=^M#iKwbH9p?S?)rlzus6@_}R{_Exu0EXEX8Zfr>D89LN!FJbdh-7;&
zwd?PoI};KAxLnTfyBpv}2wP68y(;z2*+0w3Zz+JEdycS-yJNu|pP_?zA;}pFg1um%
zcVDiUz+QC?R*u3WDm(&HtLEu#uUNWw60oEapkaO$_$ODM3e4k`o0kypKnh$V&sMOL
zH~dp8oFX7=E7!Rxdxk4$7&TqA70svVNv<8R{M6OYrbX7q@Uuy<b01U%VWma%cSFQ}
zwSP=KlzmZZV)>Z{e2&vT7|^@?ECoJCsa~V9I189weokzDM1s+2BNWE1Qq#+!sm&<O
z)nX)On^M84u%1y9c4;eP!w7bEa5<C)O0l5+zo`et#o@ZX>NCrsreMl9)ncPCB8G8k
zv7WD>JlNw+?nJYh16TNN6rLVy`O)qmpmZ|7Id8}8ETDfGF|~Opu^EK~h(n_5`vLZG
z(~M1+U5hiR-sMm!Fy(Hw7^<GHy2;s!DYzR;*Eg~eifegB!w$sxO5&wR&5)6dOC%LK
znJfdd%v}#vkMxh=P5u8DHT5d#=&}qAm~yTWs-D>#0SCl!22)B`i{<hHH=>f7#o!Kn
z0QEoL$TaB4g3;}KMC#L-8?7A*GIdXmrZe$|9lqPXXK+NLt>q*Qcl0kx??6k62|aYM
zK|OBGL~QLAiiqUGgb1|InGp{EsR<hSLnTSiDBeylyZ1nhyf1rGQmOyFO)f<r(&7P1
zw4-+Oca<QW>xR=>zzNn)B@#R+R-#YglnNMEUUXvb@h5$d8(?^ezFrm=F6X&*6+E&2
zNU%IWrTGwq-4ZAl4(jT)X9cH8D_WLERue2tI-5~^v6^a+J^rhk;VootxGy^1t`Y2x
z_HkIa?$==Z<b9aCJC+p1jX#(u2@FnDT}R1761EITn;Qe#_EGr+v)qbtFLchDBxJ?Z
zoYrHKY3xI2mx~Jb3-V5rm>YkNOfqmS?^v!<a+X1L-!JX#jZ$(7tn7%|CEP@cO@~4S
z)fz^;8^orqp@LLPJ35Od76};1DyjrZ#6y_{@$hY1x~x>pBT;*;k>a%Fq!+t%pR)V|
zglUGKZdvjR0#Y6n+foYx2=>Z0cn``pzTY3UDE@d&zn~k^WQ&O03mUx9uM|@i?I~&h
z7<I77cGXG7m=7sWr@rcxxAX;BUD00XU|7OdpbwMt1clkl%15-Rix!qiTDCmgY9UXG
z5U;xVRBs>d+nDwv4LPQ|v!YO88HtYi0I03vhl7ZkeKNj8MeOUdB+((o2f}vrFwSq>
zk>_)zWvBs84(NjU&i=9QB(Of*y0OOVn82yUjXFzBk*dD49zPWdu!?P)w$DFd8oxqk
zhJ0p%eBL*(#-4KDPlSm{_kG2->32eq3ad6%zBg`GaV$Wuh29=W`Sq;8VmbP2A9qHx
zE-y$*<|H%mzz2&!IzPu|*4I%wq%(}n-35_xfK<1}R@NyiEkko#^W{3yh_*cIV3z^r
zJS8CsdCrPGBkl~Jk0rYdu1Oh_e7<9r3(6dH$S$O}$rJRPZJ(gY6ImGs@$zqOo+9O8
zPZelu?=YpZyqOGuWQvl3FUH_BiM6q1WC#{p1IL66Jl|?xH=BeE8sE-I`-F@yzMZ+h
zclKr}IWtbLT$U&gxO{UXPMy1tqfW1?DoDO@#Bw!eVKkt#T4kWlPvT{<S2&yT>sS>m
z4UU}#uPPvarV4fichd{BNLf*le)6~YaFx{OgggYCrZKaD2}gy&Ud(7nw6%ICPBCff
zB+cYb_@<~W3E8Mm&C<j&hvuR(@eJTtukZUr$bjC({Pgmcy>!s=30tgGeYNO9Os!H*
zsW<-aTM94<;Sg*qJm53c)L()L;NxN8^z4jyb-`CB+M!1i!JK~8CLDnhB)aOv2y0&+
z1$o*0!qQPR@AH)5tRXI15WK>=bhN1LoFL6uQp;>?ryQYoOym|@h;1J&GrKN*8Bz>s
zF>z7TCa{uI3FAeG$hL2eWIm)yQt_oUEn!oyKWiiUkS-*<D$j4wzrlIG#r!r&Z&ktS
z3l$zCxiuYCmID+|&R-Uf>hlk$Grj{{F7;L@z<F!=QIf^rktm~(b*k^G8=!*Vo@B=-
zbgQyxhhA>tGi4o)m;f<B70s7z4LNGgUHOq5%~bb&yef9QYBZ)!JEQ;F#!7|7hD$&m
zu!<`B=RGT6Q)o4dm3B^A-L;W`eYGsadL5sRecuV7`2`U9rEf8kc+m>5pbl90F-{#_
z&Zi+;lSF67J|M|H+-tB%U}EC9hA?NMRVBcbFs=1GkT25W_(HeYW)#}zDu#BAzh7zE
zD(aKPe35It$KXXQ@YyPMmmws(PS`u@(ZcCF^4pw@$pfQntz(8c3nyv(8nF*PV+h9#
z7?HtjK}HRd*U3l?8Eh6t4Y+%GF`7E5o*ev3I}-X!bop^gY++Fr2_e}fs?bC6iZpMz
zSm<9Z#{`UWvFH>4Mxq$Uhm{>^y9A6VF^({3t9rx8*9I{TGiWR7(vF!L;*XKK657Tn
z%jdL$r6=-HmH>-Ax*{hf7h_o}yoIOVV+xtvkCXc^B>u(OkBV4-l0GLVEKpNba6Kxr
z|49OD(=~g&(^MXoYIb_3$r=}Gx92=-u&?CmjNq0<hKXM|v4ETGiz&BLIHCDbaO;W;
z6D@)9+aaL}(mNEx()SvB1aaex4Q+#8E(H&-HD_tlg?rRuB7(~t8^0svx8=8q(Xzkc
z6UnvN5{DPRNg~O3^v~nGdqghz$_t;LxI6LOZEAGhlFM<Yud1!fKC<#TJ!LOo;>sg+
z&q8F}rIo_6tqC?dDfU=?vRqdBlwTsnvC9Z|^<-G80Ge#-86iz%m-=>+PQpWvk8hrj
zCDo`qohE^a>9<mPQ{!!;l}#s$qG&(Ecs5#vXH&izr`G9DqwF>NyQy0rT8p1pUko3m
z`dlRX>MQj)nhaR1BrhKiDcc>65dDeFq{22O)q$w3HDksY=jnznmzN#E*Fgh1ee^L~
zJP=e}ntO^H1)sjxYWp8~{^9FnQVU@-=>%Z)l6!SKESJ01s1Py{dHgnb%Z{#SSL+#t
zV3743JxOjBivYQ1a-xVrDA70*r5P*gb>C-l5{pBC5U90N##MD{i`HI?Ck|^xc`CH}
z%gAt(BtNR=846T9#UGDM7#RUgf17}KNl(#PLx<cUu{m^P)rI@SjG^wF8&-Y-@}Y)(
zSWqjw9~$@kG-EKWv2R@(3rcMEqeU{bOOE@uzD4LW2hZ<|5NXNbJF+{U@NAIE5c;JS
zS1Ht263_)1R|sPl?1}%UmLYk5^ig@Dk7l<?Rc#4=IS-MoDF-W~3f&ISBw%@h!2rKn
zZ=NV5ap8pwwn1jgIKy|Xnh(rkHH`7RHYjTscydyy?os`NS|$$pwQwM8e!TNBF~cdZ
zXE*$8t#zI7W4HMpL+kY3P=yVQ)7!?zlvgJ#qb^BvG7Lt#c72W+G}_o`#$Z}w#;Ro3
zF0vW5z$W}9)}XRuFXAToDBNFULAY)yGPn(DoS>e8+#`_>N$vHu9K@4}N__;Y<->pJ
zg4AzRDo~9DMo7BF;lAz2kdLqp0DoHt5KeJ1@KJRLzSps$>JFePGGFhdxDgrTnkX*0
zMEiK2xxpo}AGg2-qL25c^Oz)$GGC9RxRKw^6p$Y2{OmGGZaLB!CA6<1I9{X9$dKLG
zFJ=FgtiIa8zoxKT6|YjcMt$ejomnmDn4FO)rLelxia;-opV${h(}v$v1;8buu)e13
z1pTAB(TW0!dw4+p^n*7xM@zN(d=Or(I?wF3aY7YykSm*v4Apc2;)eiJB<n5RMG5(^
z#=?Dxyv^Lfqw2tDyy=a7r|$56()?e?$}WP&=HWNZgwqgwf*#_5djP@#kSn*2!Ks_L
z{~mxg4H<Xpj_<n{#ymJ7-=`h8-^JAo?J^?z`fZbsq;T`&4}5*0@P4ccryFu}x0_ca
z4rrjZBgbjdgTAc5h#iOc^w`u|3&1cJuPEmg!}G>+VXCA?8|J9}iAl!*2KO7*s9#1$
z9p21D6EtQ*k;ppu0zGq{H)bs9%7ZTOShb%%;nI*9RG`z7`Q`oEJn_PJ7Rr(}z-GkD
zNclLpR|*?${Gc|`8x%{vs81GJ03&wml*kG8_jnoedYyX@dJ_M3D@XL(E`j*<3xZLt
zxvI1r5H(tkjQ4nTAt{kM4A9qK!BRWsMroP67GI)t_;L|t0MB2(C<0Ao6lBgeKFK|`
z33vZ>bq4mn@M~Y8s4*F>@|!*3Ei}1COPt>%zb(KufAUTlq4FV;%o5}rb3`l$@eUU}
z^S+!iPNO*@mxEw8_J^rewQZaphQe+wMV_x62>4VKCc#5JT!lzSTPyCt42Mr3h)AIJ
zVbwa+ujfw_gK>ezokm9Tj7x^)B&|wb21TIiS(?r#{inrcx!of134m(0uiRPkeX+mO
zP7bE{CJp{QHUsU(?hv0bV}ie8^PX>dm-a>6bVY_^bWDUMqrbuJoAP{BjSry>*_n8-
zq%!itAEZ}_@OXr^b%Qc3a`&s*%f}4v3E;oRDtpGyJ$A-w!B0MkECVOZCUw?|y}SqW
zebY37gqoksx3_#+MzJOOOlLR&2KDszMiDBu5Yz0}cj>MSOjX{2u*Pv?!!+H4;-_K<
z_I&5T4{^1S|2E<&rG^oRz?M;zuW@kb{v$su^<s!QD;fHSXa#VpuCVAa0|!7VJb@R>
ztB2bBcG|{*)^|ot<ZH5G7agmI$W2R(&OI?F+c62FLvN{4$k&bwvP+23+MJBGnh!y4
zkN$`IF&ikHOn=4nxwrX(|Iiw-8nAsAN88Z9LNk2-UEJY!``gxtO&nqKF9mu4K%f=P
zu>@@nsrq$WQQT)O5B}0_!DwW#go6ngB6%u0BBGK3R&1p(GN!%yaxX73KRppLa%w9X
ziIzJi$?wFbU|URk8x~AVCTG46mB%C>etfe<#30i}x%OCPo0N`ej>>Z5Qy@p2vA4F!
zd!dPqZQZ=oREM1|A<<fV#~v%;l5Ivi6yBki`IT5Fn#*wN*KjXS8S{JcrN5~pq_f-h
z7MhTH6N{aB`BJnrIt@IQV0?)BM=d@DjGcsB>@?aT`B-J7p~V05u7<rE3lj{ZMr@^B
zJn=A<kP26lS<%`*a9D>jYxix;H?!smQ{vbdzTw+C^Ea4((2Q4&P%<okmlLgymf9Mw
zR9PtmAPL-cD<{O7#4@vDs73Z*qlRH!?#;%mrt=nwmr)|;1It@!g5OPHiZ$hZbAO58
z<sAu|l#grtMnS+#>T}riEh_3&u%#Gg6u3PD^8qX3Os?vaC7trv;s3J=ZwZ4T|DIe=
zX`d~L*qTlR`G9St<bchc?vnsH534hUDJ8}~=*9X8nfb;4gSCWYe({|Hrl@PS+4m$B
z#i%42_FDO2Hwr{~ei{dhcKmRFW=b?ZvgQt;e{(#$DDPW@YQ*GwnUl$lnUIp0yx1x2
zwB|lNX8U+~MzPkst-WU%5+ldI6jRP}xoMQZ6doWj9*SHbOrbjDBy4?^tQq#De3&oS
z#d7M`+^kI5K!v@H^4sFU*+epH8T0XYBpLm7Y6lyDj55}*L^4kq5#p$yyehm7`5q<a
zr%iJ^xn<4{Q@_BQU&?NHVQuNn3j>j6sGUK@a2lV2vJ6gMX}0d5yG8a_VhHUyS0B&i
zq=$U^BaW#>-r-4w;g2Tp*en~L9(hh&_r8r&zv~LAVMZWo5#6q_M#l#t8p29vtZxQ-
zu1$Qmvq!ir*qG^tMjcE<h=|oA?j~?ed<y!ZYI&3-k(#a)Vaw&tCCl|(Z{+^5>12t}
z8o4k$9xGg}@~Q5KX+>u{b@%bF3YtWz07E1s^MzzB_0s%C1?_G=2mhS$z;*+NbFkaE
z9rrQdUiy^%)G?I(Q2G=F|1HubMm-fTMQzvOI40|re=CkcldRMfKcl(D_-QQH)z_7s
z?X{{f&$`db)w1cCxOAf4aVsYBK?*(SH-|bZ#9IZwYN6$n6M+8#00960TzPjqoK4q1
zi4qc`cdK_HdME1YHM$_y?y3=jNLGnRh`M@Nz4s`qM3fMOjTWmeLPTe^h()w_b3f1h
z{@%~;k8{pk=bAI~ojK>sH8a<=*u@;Z(_Jd}Iw%EUEggB?{H%t;hc%PkSja8Y0ah`q
zZW&wdEjbD9Ey{$FeOgUH#{F9tsv78%5#2f6q^2ZJcOEUY4w)V+nD;v>(O;nB_8Dmv
zOn2?Ba&}GF>mS-HYNjEdhd&PW)xc`7O+>vA3oQ%!$%}6&yDUi<<U4C|PiQ_XR>z~B
zFS+N57D@ZKSN(JIh|UxyZ0>1Gp%Thl^ZC#D$UWXxitl7TtRF2tdT$z^wG?vPKe{HA
zzHXnSa+%TWp<O7A8MplLy!<Ciz0u*Ln}I0VJ-Q69RzJhwuo*rjZpE^Kb!veD|4$^?
zWFW|Y*y-6oaIRum5XJ1ypoEj0(z@z)=J`9&-Vr-8E@q9Yfz983P4#EydGLT}p-Y>V
zC}Z21Y8tTb*Q=CWi_ZG&eTxV_xv+?~GuGoLdD@FJ*;w-ix$#mL9}h8lSc;P{t}M86
zHv2PP@h2lDEr~QZ)<JmvvJ-pyY(rK>_W-kG&Q3dK{Dc8E1nah%GBQ~VI-jtw0!C0Q
z&nGDpR#ip$gK1Nz7UJk^({NV2Ca;<P*hkwZTvT_jT~QP}NgF<YM4Q^$?r`U-8h3mr
z#p$j&I7p>;c1LLXkr*zWWq;|Z9@bZ_Vc_yJ-}Ce3|B_M0!ftu%$Zm#DSwtg(ksaT(
z_C6G^Z2hqMM6FZo$)~GiB|#r()PYlT9k64SvRbkO@DlYs^g8c=2J-sclDcbYkDvoj
zAD8xCZH2bq{9V*`^H-_AsnyXocQv}}<4r7H$#62yUcfla{>@33bgenW-xRtj(1|y2
z%D-34;K%v&)1&$T8+i>9wJNIKQ$iWyCEw@w=`k0DOvtlxb^gvF;q1C@_tU+1n2v&V
z=5nt*A>`P4e!O`0m~saADC=4ac}C8aZKB)gwdg60S8ODCb-m}RSW$k+_{+}s(ct-m
zs@vc^6DdetX~TWy0-tr_Dyh3zN6!qfLdK<9a|vYnC!abIEdTcuw>;N_fMfa((O|H$
zwsondg~sP=^&57PX7_s2!H$l-Jas21U13G^>02JlSvN7$Qi|b>%6&acbY0b?Gs}>t
zQ+0%*rin<jyHmjzSzKzBT2_@BrsB#K$8F+c&T-+4D14oz@SVKY`KQ?77^AjUbwSxz
zvf2cTSJC1*)H5|hBCgYGmgJW5*BMkiNU^$Y-zvx3MiQSGa$G`3%H4c*IRyk0H8%>J
zEOvX?etTB2=0v1#1Yd+L6#tRtYY%76FQI|=m6&?j4yaNcF4g-{D5nIWe7HYG7OWcy
z%skCc>{zX3LMDtW?=Wey6B!%)Nye8zql#b9H6T&-Bb&^CxU|NE2ES>E1Tg!`(`gCE
z0QaED?oaT$j8vVU+JET@*EIv>U&UF6d?xJkyiY`B^19>Ap$7paC$0H?$H5%B;*BeY
zpb;h6JbMY6_J#IwWoz@Jyx0vtFfQ*rG%gPYI9WJ~-k4TV{Jn6Lw2|k7Tew}Z;n<xl
zyxPX7n+FTWwoPPi829EWb#~cl0=zzch4|HWe{lK8_yS(XVO^muQyAXwuQ_#}>p_}c
zsj6r->J?8l8V!E=Xe!Zd%c%J`0|~=~Wti~X(&^hvJyqpL6irMvhULAvTXU}!(r3D?
zNCP7ClE1djNNV8q*7OfU-kOCF!;(NO)qXvK(vOUamIBEyTP))6VrQ6Hp8Qd2j3AxC
z^ggiAM4jj~!jew-%kqkDpCE6=*{~3~1Q=(wspb-=!FV7j9j{a9B1CSaY37DdAb+G=
z{OxU@oA{ep&5m_8?ns8Hppo5oOg3ykn}7CmEs~;tCiV^H^)+qDms$2?TJ^iw(Z{)4
z`WaSB_BRQ$I8?1ZAOg!A#MkH#RS5$os@x2#X+U=L@$Qyi{;8a1X;@vPUaHUWrl14Y
ztXLuSJM~MGutb^Vc%~H?-;ijTC9w<3cqsYQlbFYOL=&pbkLl^nLRBq8yUfncup<tW
z@}HRgIO_=CSnZb}8N9yHvsGtBXm0c9c!~OENx^zp&J9<Z*rqGFF9Zsaq=OC85A<W3
zBnOHJ6sFlY2gV5$5}0=7@uegJ1xnIEU)~1^5rlp@besbyLO<o(i7URZatcUZ5h$qB
zC+kO#ZPYKBnDTrM-IrmySWMwG%_`96e8^wX@bJv0*w2n2yMX_3g`pwwL;eBMGy~)Z
zO{Y0DxiC19Bm)9`6H`!@M*A>Rawj9$-8fD}?K-~h;)43Eepb`3BcR*b27FjVZNC^#
zJVSzey#|f@JoxgzG6FAC(p{GX#8Fog_SI*gTWN9kj%}Y0C0@U*#l(x>|L_|c>rv<Q
zXNAnvXt(rO(bNhl%HJrwo6KbL`Xb%_q1+0Z!z41)OzyiKyI|dJF+RD~+8aV~;RVO4
zOt*%8Vp#z7-@A)b(Lf;?Reg8)f}nfF2gMh>^g9uNxTG_70v{zi2@Y{=o3tGF5wVPb
zqQp{2$hXqmpNPII`mDZ1P4~OjBz%3d()FP<FdsKOJ*9z(XZ9_!=JYKN2{fF1*28vw
z=Ec?Zrp$g?PqnI(yN5fx9P=cPTcr(iR~A3??cVKBBb6PFA*D~aB{aDf84ZsR-wFsj
zGxYryJ*Bz}*<Z40BcH3dglMU$D=zx^(ael2o`Z&C=8kGAZXVP6BA=6{(g)m!YO}jr
zO(tn&COn0Lf$n&E0R@W<f&9iH`?RdqyO9W`ELr2g28mv?AP*THaRi^f$H$LMJk}5n
zh9gkZz)73RRl@9wpnIe&7b<LSDQoxerU#sZ3U)y-w?dk%63RKh5;Y7^dt=Y8X0D<s
ztY+TXZM+13_^G}p)Jt;Kq~;C-mfz&!sGOR@%Jhg-AR=HPBk%Mxj|7XC!IOH-q;r4m
z7G}^HIYKfY!{R04QeRup(~^9rCC#f|Vc7W@)dTp(Kr=7GJ{#Lmo2Ei;|7Bjg38+3o
zW{k`18$H5F%&i<Q0PHPbbkFlzb#SwDUU2UUl@>1CEXf>*6$O|d#LcE-K=!WiU6#Pw
z$lXJt6qUgGMxetRlM;y}teI)bjw^hxIavHWdJKSUQ)wx}2|oGo<Sn)#4Fh;qp|VZ|
z8xF^1@?by-Uhn}am@)tZ+KEh2T&LBPn*}L}!1|8o73;Mdfa*pt0hqt|O@W+)%^ZGd
za)wv%%855RX#!ygs>x-41l5eI!g~CXbfIWMN%|z!S3cfmEnN?H9dlW2b6ItBSuOLH
zHzi)odbLc+c3iw`&b;hC8s@AbQhhMj?O&aO>4FvR8?JGC_TDst@gsm|A5;J)yJj^#
zY;f#h5K^V33^$9I1$nx`Yx!Va_vS&Y5V&`uN{i(so=IUqFcBD?@z))yaR9LldoETY
z`sRrr$RTt*T>R6f?ylLw5}Nwnr%gA<&?JKlr`6=GONS5os@8UV`66}6YDxDp<*8>u
z5NHsAD}-^vs_(rl&L%qcMb_Ck*35ijq#w{GdA>&d9kdEk8Xcg0r(zW&(?d(eVRHYd
zL1m36ch~#w*{tJF5G)JM&cva_sT$}t3#4BMy^n_H)?m#lrUDY&;I9#4c$aFS#Km=B
zUL(5=6wSbf)fo~Dh!sD&QoIvqLH2HNZ~W*)=0Qpj_->*~-m8@WSc;0>h@bV(cmif>
zXd9o5F>=8nt5fBR%+R9~&8ILg{3OkpBqpw^dBcz@fd#nP@L3S48=RdNhUJ_G0U>bq
zB$ahpu}@qUFcKKn3k=uT{a~O4qnlh+z<_A@Hs4Fkf$X2acPmt4_%;Iv0rU9yC-Q**
zb}pkWP|4%OtdKRTv_NsQ_^=@Lg0mapf{O5=mhI?_8cag|(KOh0mDLqd$@RX6E*M$l
zZSRvW$?A!cmQqPs9itqOmKx85lwIN8C>*m=f98S5qB7TA<jdM@SSB1q;qGFOK?s9y
znd|1)!zPktXEE-EQuAp3sP6H1F<vP)V{E|ek~wUY%oOlDe^iOLq+T`~f;+qKrGs~}
zhf=zipW7UN@tiB^FOuANv~g0iC1O&>6G?QJqhG9f#_KX-mhTX|EabvBz4BGRs@9g3
zFAOIwlH#)V6k6P5vHDfN?7eL^U(hLDha5VrY&57D#E4aX1br17DBqPtF{yHEOR(+u
z#xFm#N6PA7VYis_=tO{V2Gk<N+V5*zw-L>@ucJ(ml0sGqM${q=0Bb9A?~ysdGi14K
zR;rO=F<Kv9Z3M6=SRKo2LAl9dk~-8+2%c1;=EUOvAezBN<#3nm+=&*{;__xHrmO&k
zk<ID?eU$~4drM(_$K*GNCXADIK15Y|PDhdfR8{u$M#U^-0E~1B^J@~sh6e}k?S>xM
z6$kTH^ok-*p^SX{0y6>1FR@WjwXC6|Yimr#TSD-bBVS9tsCbwe#e7jo=AZGsJ2O*b
zM5_{l$Qt*OlDnYX;C-CaQdLtsQB!Z5Ef9Pmt(4-jk<)Kr-e;_rBBIpR1@X?=+?v1|
zj>=|;>85#;BXYb`wv@`eqz-?(&l{p;Exs73r?h(mCKenJ>kzcUM%teGcdN8#qbPb=
z&!ac+{85Dz7wAYwm>#tfpV52lDt`37Mdc<)sY;e|C52tOwrP3zJ&)H>aF>iW_x6&m
z&XT~#F_}W{eqjFp#j3ZKJtS85D77fq;^7*?=f>NSIpyV*@}rTG*{r^&gXVao@P;0$
zmw%*{iZSbC%g;AGGG#q#YR&6vY%^WId^$ol<x%FBT3&As0%()5<;N`XQ1{&;JaOac
zHJ*}3(Q|zHrOny7rOm9lrN?)=Mwe|TZ0$bP+dY5Cn-hK<+!p{$&ST7(X7}};=Fd8G
ziQ~saX1m&d+^f)4G!WtX8n)P?qchE}Pi9={g&wDzb5%m|&!c2t+(4pe6OCF1WHCLi
zDQ)SpWMkb`O6+0?BNvriHgEKqXl-A#9}vU;7TJWBb@xs=XyPLMC(6-h--;m4DW9{n
z-Lq4@8*jdd7}aqvADk05`cLrTC#>x7MD6t>nz6`o3Wa)_9ba(iQK9z8tF*s1R(41l
zj_|c^ef1;}k?&(@50aYHQM5i1y(qRE$<El`7n8G#ez9Zntlr@9zR8?eEl6JZ<`7pT
zNael60v;8Fs`oD>i3LR3DFFqk6?u$<?N%riP|CT~pAv{jo342yKqvp-Ue!te_NqXN
z?{&UJO1Sp-hq+Y=Vtm@TXU9QO*io$hcYmZKYIe~Tb+-2WFaHR(xGUCea*WF!lG%v0
z2)X&S7@Z)S5E0(`Q1?>riI)oz@NPe*lUp$k11ft^cbN!ZxPQ9U%LR~6MkNdUHXiz~
z%p3ecr%jLeWpKV?mG)b{?B{G2!~yt3Z7?yf=>s||)SH{))BJC<gd(N*k<>H+PHsW(
zD8#{djoz>1@luL-kgNa>Yl@_$!1KctpES1!L|IpwEWzHnkpBi4CW}t#Ep0v9?B8&N
z(%^yI42;1e#JKxppAv~O&eKUN%$J?p+Ku$c{_UcLx##~R#NX+jFAEtJ@;VDdDezg2
zDnM!G2eLIsh4wg1Hgcx1bjIC&&gCVjv|PQM(y2SMLV2ZWkn(`|iQJsP7zfXs0S1|#
zUSNX(J`S&M1?mOc%M%WTXC?DnL->8ut)!gGg3_%JS<`1_{sifoT|!lUBXTJU2Gz`~
z*}rV<wt^=Rxq5e^L}l6<kC<5R6#mUQgm)fQXw>^i_u?;e!pC0`QF^K)Mt+Pc2G#f=
z_GD}vc(jge3bcSN7-4<ong+fntL&xk9x_AVW1O&Hs{nP}X$}gI-`Y4p<E1OE^>?EZ
zYm6IA#mui5;6EfzPvDmoD(Sko*}E8!8d3#Uj+@P&1%<i6FZp0t@p%v-a^N)y><)^;
z^pS=zsWidFxq_W2qP3u~88+*D8ywMm9YWfFcs@OS*@X-pqX?Q7urhu~UK=)DPMxd!
zcXuV=^0mh4R}GJZqM7)fR%az`n!fQQtAd#ilJ>aJcrr@fjAJP}rqYIzdWf)V8rVF5
zX8|d}wc<z3T}D`+7yZ}gbFX!t<Yc-%S(brTiZF<Kx$QQIdiHdbTJv`K6#lW(^gM}N
zY&~Itj^tXm7eLbOKKlCx6cbEMs2r>a<eA>HDM<28Glkji(jPme<W$WOH{bSTl&SKN
z@foLY&X|%-ZcsXl{!^);c4u_vcU@wr*>Yn`bF2qM?=H#ef9?;UTss@}FD-KR1Eg<F
zhE};=1%LiUM-}iOPV17k0Fz()&Mw^SG~=BX{p3Xktyz{NtmsNcrwF&AwQCY>$3@+&
z#_bU%Wp-Q8?Djim##60(g)RzOqNL%i51M&gb_s%RE0b#+FjOqk1d-l9pnRogT)1td
z>rnBBceU}em}AACKi3SrzJ)9$0u2HWj_)KNkbz}VV`}sb1n~!lrngmnx-Ngu4bhaj
zrjGMK{HZfEy*|`xI{V<_Ogbg^R!xIx?sjZc{iBM}JJ%-<Cc3@r>A8T*)H8|i-q20n
z3E<|nfN(@c_UjH_<s=fPCKmH*FmP%xWRfYoqVXe;s3Xiwym^a@)LDa)^9>sTnZg6^
zRf4R<w{eMY6BBPv5xC5}{Xs@jwM^ki?FC4UnFIhiK*qo823HPYWfz1Xt<8SJ`kQ9R
zd2N5gzuV&kRI2T#Rm?8Pe|T|0;@otgCY23&*Kb%AGJrK;M~eFncg;$i(+pr^|MT!o
z;#@xgV;wjgIxKO%ECC9ex*f-S4nv$}HhdDEgbH776@2kbMBf&yj{ccs>CO`rCY!!p
z7ZaBiBcS=ILN~+i!3%E=_DSYHwtatW!==)$Jc4_jll$uEeze}#xd<fO976W^P<Me{
z183Y$(<WEje`JUt2YgzY_Q!;NoNV0TJiV7JCZeY+dGRuy{{q5*9(wj};$>K|UCvC7
zX5WK*qn`cE^7}U{88Q?Szc)xx`N=%1_do$(IeOw6r*B&xC-)<_7Ze{@?;~lO{f%y!
zdJB;2_BBerD5^%A32>>0R`gV5M879v{-fO~E#LQRPWA8E8p*f=RkzR<yXY}pGDkfR
zGJ}r))Na-a)+H~<W*(A9MLkg?=(w`_);}?hyv?m)Z7S7G_Hhq6hXh4?srt7+-CQ@@
z)JM*d=}~@Hmhx{m-wfoFU8G;{aC}Bdt*KBqvykvEJZHwUU!m?KJoN~&E+xA$gUrI!
zw|g+7w=O$HJ<&zlu_|r+fai4_NRlg6^)aXkCw9Rxg2+;^`mwdErQMSkG^=vE?|;Py
z<6Jix*LGf!|M!*+s=5Q+|AK8TH0C;PNe%tp4ffsvog~j~_ZxU@4$vRJ%QTS;2i&LK
zTn693#J@xU>Z49prslb)&}1H4Y+nU5#A~9qfu-lnj+p}Ljy8AeW`4AE1GahTMqgH#
ztL2OXnGJ{sSUC86aaN~F0-uu%AY%`Sh887AhNwAB<D1CSgAieXW_`{=6+(gJ>3h}0
zkc>Vi(W4jjSe=N{COb|pR0LS=Sv}S`0{omL=Z~|ke!t&48_Jl<?|SvvJ<=f;;dFyO
zKXt>}6+XPKv&8aUrHYN=ZaBz8oW=sylQ|dLH|bc07bLBYew=R_5ka)JY3bIT_&Q)}
z3)pzUv;hZEVMhy`a{JC@i9~Y-hlN4BL^ET2W#@1F6P*RDH*;=2w$gj&co@-IQHJ~a
z4TLkUi6BgBZrvsc2*}{^^pTW7xZUq)S@idq^kh!p_T1OHwT6Gq@}0`I7oEbg7*f#*
z-;!MlwOTG`bLyQ}b2+7+q?3QkQ8ujlWuP&%|E?PCi_<KvUXwPuQ2xRLDHK~M|HOe*
z78AxbsQtI=R^S%u*Dl(^hBxzd*&j)h_nP`CUsEjQx_(Z0?$XQ7T9_yG<}!dNp9>G>
z8zcR=JL=tVTYndFsVP+S!i>O(Dvyr9*EM5*?f`E05Oa-WrSWKpz_wOy1+8z9v3%5y
zmfwf}Pu!2%;az*0yUO-n>S$r~10<KU*dwnDk_)Y}-5CGro9Eyb*@#%+Zxr@^H42j1
zQI16f0PeADY{d@$yPBa90eMbHvC@_8jxUG+s_!qV-VFxG@Uecck&n(`<kNYWBrjC4
zwcMw7VyT~{a($(AFk1}7ghCze9D-*<p=zL9R*;x4*}IjDxl>(VX5$-OG$TM>8Kgt-
z8xiCfA7o&aXZ!jyWzm&RNAX@^)^pyz&sOWrOqW09w;2bhKgm;y(<mm0(kT9~6r)iz
zw&V5B>ChF7cwtN8$ctas4$8rT)4X;WV6iK^`&@2`sTsGx=w`*NUmpR2)wZhmND16B
z<hSQe-STPuc8~fOK6NN2YPZ7woA%F`b~Y-?G?dKLVyZa657mSn22Si^E*1PP0!yJ}
z&8_!q<DR(pTR3D54kip*s2hn0<b7n6m-KUC%QpH6LZVWuT*5(;EZIh~@R71_4H&xQ
z4&$Dbaf`uOFY>&&JdH09iyyAP>D(n>#was~NV59p-WlR6uLv)pl)R<fBjiD3!<_rV
zLpX-Nd?0i4LP}RM-A19zbk~MuT!L7}T3!J{qn&cixZ=ziahF805)_mDQF7dwb0X(=
zQ-PkzZ5l1RA0_3)dN2PK-6iF3Q-3!lrsRpH|8`w2DKBNYlMJX!<5TG>$@v|0!yz`Y
z@`0_929<4^tR0MI^|{wpF)-tIkmT=Joy|tNf3LrQ^`QyW$$)*@s?a#IOQz)CO%K6>
zTkgT_XyltYq=iI%JRk7jMHs#FuAKLtv@k%%^FHr!YteUi-tD%zHDjKF5y06}f~VKH
z-01nr;9H&JyOiN!Y&Wia*LyQ01rMa&-2^-TfKvT{{)a#K0oCmuOAOCPy~>XcU(%o;
z>^`w$J_ylcKFuST;WlOY>fy|UPx*&=M7I}s;=51qPK=+VX8G!QzF9E(Z7iuKA4L44
zm9u(kTgzx0<snm7%0~F<a94kf#$!yM_y7qax{4=gmb1MP#zb@+GuS=w@<||(>J;Se
zg?)n9K~!mYK1nFcsr!!s@{1{gW=}6;lapIAY>sk@Fz=>`39$B#gRu#48=Lj%YJWKR
zVAZU^NBK&Q;!^te#5WU7wL6y_1hb3atTlLKMVFFaI{bKHC3DTf8`rnw?~l9~-x5`$
zxR5@W=!Vmuo)Au6&C;A6;Bc4|Ac^WUvY+~NG^2a$3N=pL<xd#=7e)DBI3BM)u@?kJ
zjS!mv3QO#>AZj$buLW|efRDt2K9ldFu4k9BE)FmgYq`=F69*=}YC5NC#IMeuRa+uH
z_aLtUzG-Cz>+a>22)!Jqc9AcZhymYq=r>Em&$DLccPGs2mWZs>lPs@Fwbc;*<q-b$
zfB0%hS>L%~*2z7leS7CcsQMz5a1ojnl&{^B&8LZXf(_mY3=eJNPHY)E#)`T}&^P~e
zfyvi%(WDdG)Dv5sMX1Cg^zlE|WF0<P<cqB_Nhjh2(_L=8=QPVD^BF~lj^;-OjEm2}
zxQ;Lde0{&gR?ZIbB+6kUU3~HWk!tKO)!4JUt04@_Aq?yP@YRs?zH?DLGUk1Imqn=N
zBJ}1WG&?BYs3-g0|3ij}JHg<Qm35Cy|6gQYNhg@p6AZp5sYNL0AM4v4K568O92`9R
zVH7s!AL;ksY6hNYuXYx!QwS^y_*(7zxGVrL(LQjj;S2G+sd;8^IM!<sfO-1_j@4)Z
z1|Gg}()s5jrnp>o8w0@fZ-kK15AnIQxgo)fe}5N#$aqoPc>oy_i;g!ALV^MFURhBl
zA5c*O3#*>SA5e0+Pg6|b2vi2VG`tZp;ly2y&bvq+!@p^jU*^vTNTk%MC6oL+gqNR<
zy23siF{>=|t34Hl)i>V)RLzX|j~d+-srY#gr`_n+dR<jemO=aQd!1Rr#t#RzXt5PN
ze}%VILGgYH`b9${dj7;lMIyT9=7eKym5HNx8f#<jM=zRf=49(n(dRysQlyU_m}R1c
z!_~iCcc#H_kurqQj01^e@)gf?X*K}YTsj=gUqf7(j;RmRS04`oBeOzW<&Tq=`+$*}
z9L!>8gHJI)V;5CF8URZ|&D}j$H+l5!J@55ld+8xK^Rii=E{zT?#n9YTP^0xEzvHvr
zqS9k0?W<~zOYvURHW}HkNFCX{8rA$JId3w`5N%AORhRoWlP_|i8vgWI#(F{xzjT&^
zQqb=f1uKM}{rbX-SHZ_wNqv3T3_Hyf`S?Khe|_nJ_^@eoCZ*qweBi^z{bGd*!x|;&
z!$$5C%x3jm;7OuT$f-oVqi0X>=Wx0=P1J{Pr32XHoYNk!X`MP~q%n_26Up4m$r-#1
z(oCZ-rlt5{{7^SnS9!6XO2MoU6HQ_+z@nSu#@XRD>^aKi@}p6rj^0UjJ%sa-Y`Vm|
zvpG(-Gm`2KEvdFX-}(%hmIH353SmW?<4J366~d~r@`qpX8<&{Ju9kC&+j@ykZclrc
z^$=B?&M#{Ne&$Pq4gXzww`%7iSf4oQ#X%#K*=q(fWi+29+1z}6?}ud!?UvRwBe7#L
zBE{iHe;WJRt>xYwWy-oEvJU<J;EQ0Qx}%YUkFP%O+;EX(?7s8khS1Fq4@L>fB!rD3
zn7iLD`{kcJw@xH<sCfB?BJd;1x%z(q00960Ojrd}lwI>TkPwjWl1}N4UFnjgOF}vo
zSwdI|5s+M2I+mqba%q*2T54rQkVXUqfki^PCI0(<-{*V&=j?CixpU{<^PD>~cYgDr
z$mk1v;S$`%=(}ESicF|Ks+CL(7?1k#7PP$%IX!#UhQ41^$JeLz<CSO-KcNyE^H#v1
zL-}XI5GtveM57cWmgVd<*JrXc75k^Iu%4N<)VO1Tiq?ri_B2MdFy2~ZLqSSZ$aU0X
zE>>mUzMig%>EidQN06^KHm|%crblwtAqL&s?G_#Z8;QyNkXO|HrmxKGDrzdPAHDch
za>csb;x5kUPu9>F>ewwQUA#)_6{BDsPQ9GJB#|1d$iJsKan%nV(TwY3$kDac#Q$_`
z-%LZzQox3E_EILAQ&2Os47d3hJVgld<rCS!5mRumwCNG9Dcs(>z_n&=$m<lXUQ(Ll
zl^vcgotEFUC8MLxB2dkws$qd-QyFr>D2*IGkC=X&s?2n*N!R8`o<4m%s+w0+5CC^8
zW1fEZg69HF>kuh5x$X<W^j8Y#+A(v(^>5ODe)`omW_qb|-@_ww!mOn*N4QD*pn`EU
zlvDd4AQC4DR`?MRjazq<exflNN+q$EC=M6n^5`TkIpd1NCEkaNrG5=ff#QT>a6(WV
z)6uFxB#x<Sx{;L_$K;jFJ|yK4*6*F{ao1JmYXVA-6vc!>NvUTrqPGUWiV2OT&|<y+
z{3;y&Izl})qDO{ba!b6MX~TsWms6JVjn{%wBs12`_`X2JSpp3~j^rO5DPb+*{1MLJ
zn{ON%2+*XI1Y+XqzRYhHrJX?I;soVX#GqbEgw}m|ay4H#0oqfNK+J`*osu3~R(*?_
zk+2(!q4d2IL9|5c!Y}1C1S*RhS|k(3^pPSaa;Vr$jr=pyoZITsOx!WQvfaTL<y^(G
z7SP7im2CH1wgc9U>@`Y^GA3xqPbgEp&##-=ysnjv%A07a;^miC4H1UXMOKry0L+un
z$B+77QZ}%6GmIEtN{|m5^Xp2>XN@k}BB=9X@y0dZK1(uK#HJP<n6ZROu8<f#cvebA
zi1ng=^Qr2cZX~}dbgg}WItM`pkvvRn`_;%GQ1`neN>Ls7u|9mt#!A5;X7~V#T1f7#
ziDJoYOjY1gmz4gJ(5e=8))O~GH}NRQ$%oo?BhkrayAsh_Zj4J14g;wVseBol8yEC9
z<i`alB4icp;CSTA=3paa=*q<0DI4=|uAL1R9)!BX$&Q~2NA)vY@TeK{MA1zkHeKqs
zPY7HuOreA!cjabGE71uj1bGQ$$7W6Fd@b^0X{Y*f)hHDM$(eDND3v^>t@W=C<uT6%
zPOb>$(nD&NSg<OjvW#2S7KDi-iWN=A0))a93YbBMdDtVJV4bIgA<S|!_>@i1=0hZr
z9S1a_K}bTS48|=p<vE02<7{Pci$aFWd($Of|0?M@gb;<?hy(5wq4c%Xrk=SfB?Y0O
zZ&}x!R5G~{Nd>fmEXXKHj$mp@Hj+li>uRu{q(w4>UtUa$Up`L>ZT6F3b*!@|nkOi-
z(v4p}N)gS}M>5<E@+AaEO4ZXKR1u40zX;rQK)x|s1n!dj@-&KQ>%bE<;qRCCgCm<R
z0$<?GL7HE9>3z>-vYto2#5AK=X)GlsC;y3_gJ=Ah0I`@VZ>NBv!8wU?BMfa~k!i9s
zNJ0rWI3Z!kmjscV+uf8|qm+2JH0|x9-S;)-Nu5GgToHMfy+1qEZI<v3i}t1IKM!Yj
zbHR804@`X}R?TFnX-z@qnx8=x)}e3Q6`C@`Yd*|MZ5cV@r>vh??GaQA44TLgV7(IV
zrI>q?-peOwNH(4PHqev6uio|RsU0uD-xO=I28u=GhIdf7?HhF2Z$5puKF#9GD4Abr
z;Xr2rD4?Q3MZ%@>y5W7dHkzCWHXZIwanhoG-rC?KMyU@uu<4-{)3e8o5PM|24r~ch
z`9%aMb;kiIGi-1SmT5#hrpHlynaMtgRo}PVoNBJnI!Q7=%_L<H3YA#CIZZ9N_qaHj
zcZqHR`_qJrMP|y9dOhQtyE52LC;jv$X{+<S(j-AqT8=nY|H5w)M8=rXYCb|o466pK
zKjn)d)jkO#RSYYS0`5M3QVPQg^-t%ly0NvuTuit-Z=?Rm{V{n_tUh@PMR8;!ypYX0
zL)L-95wF~<)0yJs%O|@mmbBx$x%xgVz{vfVJJY87V%hpGQ5y4yK&o>VljJ3f(q7?;
zP1z@!oOy+A(KPFG3{DstQ0Um(wbI;&y8NPj`4KvD=tphw=>atHOOK+F`|&1~p~bdB
z1${HpB+ue=P%n!gNSK<WkRzy_Wp}wL<9C|&scbDQfl0r(BjJDYLi;)t>pt}T;_hvQ
zAvD4?P{Re$p({L1FlZq_GV=5jF@hX=|6BK8kxdRwZhTGUCo7%`nbSd#)ApJ^N>~@<
zL!%0<0>|9%<liu#*1fxGWI-drT|K6yZy0$|*uS78<9eq*FxDWtv!YoPst$R^!8XBk
z{w?>&|Hkm$gh_FSsQ#)JaG=hwTy0%<bb59paka{Ax*mjnpUUl2=5m$WwmD&p3H~G9
z9-vPW(aCf_C%!Ohe3EceOF~Ao>XSVa8R8nyv+lD}NMyuh%ieRPT4qTKC;7e{ZRSFi
z<}}0=PRMm?Y60MS^y)&n7)I=MH9x4Gnym>@)Z!5Q2{3sSrh(8D)B>11Jx-zC;0}mY
zBgxkk<h0iK|Ds8NH<%t7Jye|DZJkc-NsrXPYhABw68uyBveVKx{Zjo*K_;NIC_jai
zh(>tuKfboeYC@FGaq$b5>#DW_;v@EF0g4q;hiN#T)o@TxnGx0zWU`Q*maJV_3N!Hx
zP1o}?32N=iNmJ3&6zb7&g*p<<eJDiv*i=xy5N)TGfD(Hld~6o6TfI7n<_BiG;*tq5
zRN&iv0<>CMIlVf(<lGs3uY??{%mtB;GyJM#;6*Q`wT`mO4mxgK1Io5(R~^{Dv4}ue
zOU`3ef}qTd$F_Co#nyZR2#GVZm8wb*%JZS*0#-j-aFm3qL&HdFbWlGv+xjhU$x(+3
z*-2`{gnnPnWWy)@0eFWC>rpDW@8N)|7!yBaQ2v|#fRq>$jF5+BH^Rk9h-+|#k$doa
z#Lrk%D8UZKD3<#?t`OG@0{rZ(QSYEBfk9URl1b-rEj7-p`zc^I4kp7e7v;T_y%v;0
zKAFzIaw9HS@;(#AXZSJ_|JaIBcnz5&V9nyI0yuC^X-o!LAE(Z~NgR~DjxU1@#|QL)
zi<K2fTxD_sUCd`A<Ws)*gWhGYA$0he`8W9airPQG?ro4=mL4Ezka%-1Nd%^6t?rTD
zoy_vSxK-E<YT$>SM&Gi@9d0LUql0*w%rtrC&2h#C<pk%}R3~dhN{xn9t+X>lx_{rp
z>1T;VrZ$ZTY`}`$pkA5T3Gyy_byPAFBQ63%Td`MbMJ)ALHCjA<y8O6-l6PS2^`+Hv
zcen`44D6XQGF}LnAq1SPxG=NW1kiAM*a{U&a%xpvP{|*@daSCM9dc!=QGpN7ErJZ5
zvifUkZZj?43TUYjRe8NOR|QmB9T}&FjAML86{AP>TJL}V(RwKa8C*<4{bWM@j6%qI
zTiYsOhAcR?ANkJ5Mrb;?2*t;QXE^#rCKjTi?*$mL#$G<F?Cd1{-=)L<fFVoIbO!m_
z5By6hA-7hV6DF0J02d7sam`Z7tcpJcV@+;eC!8(<iEJe$FdM1y#-{?E3RGe_$rJK+
zlIRTUt`!Bay`(XA>50}NP)~WZjtt#3M0V|W_u5Z(^_EzU0ROI7Y}TW6eLOyAJu(xo
zvUI3|nOvfY7rb5NcFt2Jhg5FXYTg%5pNtS~6nbE;OtOFbt=Eib&FfZtsqm;z>NK+d
zu1ype6MoO_l65oyLtqSytm1Gq1FDU#XP_$xSxzk^t)zzNpbb4GzB)f<;(}=>p#DA1
z)b5vWVN@_Sd3Gfe<pfeGMK0wR(#sNAKP9rPTt$c9`jfExgMASCe#^GmENgnL;93Mr
z!6$*2PQDBlB|8CCN}FPfO7^{tQ~KU@#CEa_7h|AE?EsJ_bsB>+^*9p`r5&oB*0BG}
zVB#-iB)k@6zX2$b;|FSqeOa}C$#rA`*4oinLGr^p-q9SHC@!u?r)7is^p(&&WohYs
z0jX)(!$X&f%RGFBY!t_jS1YHE*7d~`2Tj=yt)cu6Cj*jAC<LnGck$J;w~k*myhwR+
zKD$5oAMUj|cJE*A)f9eA*O;vg=UHV+<1vhMk$`vwr=2en*%_Sa$q7^6ou&wc>8Pn1
zQ1DapffJ2K7<Esj`IkiX)WH55q8dGRZq(alJaYzH&*f~t*V{bC!~Xj&nfjcR$Ftt1
z3%4AN1OLiT^!YFe8^*g_?<Xe%N_MxV5pkB|x?YIdvSsX6(;NA^vfSRVQuukCe7wcm
z(9+p0ZkY*fuQ=Gm;?trS7g8B<n~IdiH_Qq)6|S{riA`@>tGs(Drr+uL)M6>LQ(FTQ
zH*cl5_&7cIAe$OYy}~<mWEkR_veIZ4yxq>I(##rc@FrvJr(l^v3D?Wo!m_bJ|9ST+
z95iXvzq)m8%4meny~-<jZ7N%(IrF8@1Buzk%FK1V`8J8#%kN#J?Md-s%%k0c{q2bB
zJphB!scV&GR1~2~ZO|f^W&WbEjeGf)&$bNX++3QG*@=-dKNuo37a9)r0g$xJxUk68
z(elxhY54o=ei;<?8P53j5hB7e9VWLkJl{?PKF|Y$ii!LV*xlrIbmtNF)pIl-A%;J3
zDh;_OJU$CFZ4kr3FCkc;g~V2f*cL8qL;KQYqZpR;#$Bwk#=gCjPkMK!1T;Z$p>nfo
zUBmO;Jy)5ipLn``W1r{K^KY2X29IuE1Eh;|FVfsf@BK~LFXiVIx5#DzfY*uZS@h##
z4`jnVB?O5MJ(X1wLp^_(eeHM!4FIwvPi_eO&{JlR<o{{hiLaw2p{<f3Z5T-Ub3l2B
zoL&%E56My-A}2Nf(X?%x+B&FU8)+sI8@F0`|7+gYj*o^XPC}XbeSWHxziRivl)tti
zO_T&L>+gTPP4wDcocM4*^5OUM`{LdU#qe2S^`gQo>~w6TeW3eb?BS~ZMNA{}BP|Og
zG6NsEr}hA@z@kEiygI#$w3zw7*-T#_e$P|>n?K;JkeHQV_H!3|20Ov*ceAnI-u?QH
z1=d}0?X(kzK|fuozfa!%*+zU}?nia%ou2OdSeTQ3pme&2kx8D}^in9)@}v&FxRjeW
zTk=xG+xp|Kw`Hh`ug!`52=lGSgN8-+&5d__H{)g*Mk$k%<PfOty;<s`+!D82yB|{B
z9B*aTZ67h3w$()jc)iZBzI*5W8>$DUMopgv<<lxYKS+{5{z)$ncvWa2G_`saVbTW7
zHf`gUMk=XsEl>fG)rC$98Ylo#xZLS?oRv}lBbF+4jBU@f%|s|uyKmo!9TIKZ9@N)G
zUz441#OoBM$`0WHpNV3*VHMPZunXvFO2MRmMCav*`R8QN&W@{f`E(U?>htj0*+?W|
zL5NtBYhd07hvKtV>^MKXV7g-<xma0HDY_BPBho1J>=sU!(*MHtNQw{s50?yY8>0M6
zs>4wQQSe~_5~k_3Kz+WbRPNg>Rkxg0HBhW)*tNjw<tQiTFe36{)392;VSc`|J9F84
zZ?HZqCSUowjD8=<u9FxU{N`21v(_KNjY7Yluj(fM*hq}g?~;~X$9KpZWl~)K-arlE
zQw4!WszksiJU;Dv4RlZ0*ojGAYYQS_CSIZGCMIlu)ZX^M_AzE=m@8Ump+H_8=T4s#
zy^JJUz6YIDf*I74B0)OH2+2QY8&!;^l`x3V(H~zS^Xp&Y8Rsf`$nfVNB%r8rg1_$-
z0L_mMQ!}YF+|~6hNH*J`38kLn=gBxHC?Gf?(M1AY<EOdu2u|Yh`f`!8Gg^M2w$8r4
zhE8}=_sSYEC_E`UwSZfiRDsJ~#K_|I5<bx;lzQ+g`oR$@co^%byYS!O99vn7E4WCn
z$1l?jPg?x1kmduTQMfo}gC_WhgT+Bk@?@wR)(cRw-tX=wbjwu+sDURS97|G}czw!b
zsMdJG$e}0k-wz(r)n`K^UNfE%1^7**fYtvTkRC^W`ef)pBYfln6{CWERmxR;#x;P#
z5hfdlVuY&Ev2r7=5>6J}6|IAU)nMT5m%|CCjqo9TD~mLU;1{n_sY04mk?K8W18W1E
zrH+N^H08t|UCYXt_b{iE!ys}xA<On9hmO9el=~<_ueWMbKu*)7L%w`)je5IWQ*g>j
z^&Q9U_gNl}`ILolJ%U@#)=UAT=IftQlkWq^p2{o`97N;eYLEHc>3^hMA^+%LWtaV}
zR&`FzFi)!cYk!Y+oadon8B>AN<LqU7eLCBS+)9(~y`c?8h0eR;hqA&+q=}*y+AA%E
zZf|KYX;vQ_WVMo>U=^<Duwc*MT575O7s75yBgL!*nzrurxKojyJ?rG<CZ42`R0TjT
zI8+wbV)7<p8LK}+i7~&FsgcB(&&Qi_8gTQTs#%jSb5)O}_NUzkrtXiR$H8-HMNg!)
zi0uEyCZ;|dL@i%Cv994K^s~ieZM0l|<dk-eDoHqy6L*R*^KIwTN_tK})-j&2+yh$U
z(7?YYPLw~1zrpc*o3R>d7n~sh^Rt~3&x@^sLU2OPmXBSx^ah&j_U>-hmSSh<>gu=k
zs-SjD_~95H`*$}(Ef|I{iJNV`{eknNog3R_VUzRgglpUTZXN>Ff*=hGWDQ|}`=6?h
zHe1!(AUWBf>F3cge>(#)=HH2yia{rzBQy{7wZDqV<S~us;W5vmffoCnl3=1=$2fXV
zln3GL&*`|X6S{JY@L-@$@Uj)<A;4~pcJgYyd-ZAbic0fiu-}O`@o$ct(JKkfKbSsK
zz<|efcHyNn^cY4m3ykr&wo?0pk(_-s^7SeNdTi(jxil?mzpAWkzY?tRe<d{CSA>cQ
z#Z!-)hl0X&ue^-yuhXZRfs@m{|I+EzBg4ym#oNEj<M$P%x(r!B=)(WRvl-qrV;Xq$
zd2`G7D)}z%6+QPs^X-N0dZ$ibS~NFRj#vd`BK}Ml;jwE49op&3`H>^}M0vDO$|>Ak
z>foahE{OAL{Ek!?sbe_9(1mF9nce+^k2*s;Tv9-o1du`s$WeB1CXhEGhdelwt{cws
z_Z6sq?dW3u_<W@)0Puq=Z>0Pzpc8QY@1f$&O%w}Y<7c7p;WZY#$Q)kNUk`0IE9}sQ
zdR!}XZ*<ud*;&zC2WY$_^?IRDq!N!j`sl0?LYj0elJElT8Ah)blF9V@f#9qSwV`J`
zMYX5y*9B^Ji*XZ0R2eeV%0Slng{<2P;b6dXVP8DP&)RE#skYXvs0S9I2;K3gSou>o
znWG}3|DTC(&ub2eHq`!?P`V>)&v^4kz9;mwW>5{+Fd}T04j?up<teyqS?v!W(9S8o
z!oj&7!RZt40@2)-ZX8jw{c)HdVCC?KyH-5*qE|P2mWkYy!*%vfIUBGPVB8;0^m45H
z!DX^bCr8iFiMrsyrO|LG(24d^0RMi43z7(0BT(c~W@C(!chBZq)8ytpzxdRG<_qQ(
zGFc^a{ls0iM*rex7Ic#>Tb6gQTL+mfA5eVZ-Oa7e?8Qlf_L?EY3OLRtXZErrNVYuA
zaVtAE-kE*izk^@dvAh^%5hdL79Oo<ga=9H@a^2o9HE6YiAaj<H!i|N^F{6!x+6|Op
znDWi4s;2b1ht>v<De=9sTL|@vTzK=Iy{W>{p35(WqtR8NzjyJm<E2R7ZA=ggY#I6E
zu~ye)K;F{FEydoTNe_a{pi6U#rRww_=H)5wA!2msr638y*xnmMUGMMSI}Kh^*wG-n
z7YPr_i;Vgs*zdoPC?U^^LoYQ;%g2?|Uen)+{Q-~aRg#u(SAX<}t$lEvjhb}<or_rD
zL@)hk*oenp*@A~>+PKm_UwM#q1%x3Megdw5aKyk*kVXfcf)nkAIoF-69EB*tUcAp8
zPXVMdJ2uhq6T!_N(-^|PcamoX<jGx`9nvCP7_--c9DX%^uOAdLu7^teH!Xvo<PnYt
zpW6xD8jh79L>S)K0=~a1zc`fJ2fXHV>ZY1t1>coVDqrL26wkEQ0WP-p-X8uaz1Zy>
z5UR`WyC6e^IPvI)z!*<Mf~EJ_N#u8yMn8q{EVdJAbMNSuq@1jbe)=P#(GFAZBl3;h
zx;^>QdaAfTA03mu`+7rXRgpP+Q8(H0`1PxLpe_(-q@wx*=%HwUFw-&Vj)pnA^gM|G
zUS-kIM1R}v(sGF`#C7FmC-;?}UH7$QEje{&Em30$Jjawd2Tvqzofba(3eMwU4G0(f
z=lL5RbDw=H-(@YCK*V}2XY6C@7CXqA%sA?^95XjaPb7y-)DJ_L@R8ve_wMFRtk=|;
zwguA8Zb!GCoZoc-Z>n?G?8FfMh3Ic&WHy8+Q61ygrNyt%zRPm7n4fz8)fC|wnjkf3
zA7i~?+n(k4LI`gV4_lsmAg^BC^i<v+s^2&Hpag7dlJ>g?Tsw5mYuTJ2(HxSz_JV>c
zi6Joq7i;8mlC04DUC;kx4Uh4+ghUb>U7uz;2AU74b3VeNd{24%qib5S>oaI+KJ+;C
zSX5@$n~U-(4@vgN?!^m!pWNfjTln$$F$f;=#=U<j-R~pzj^OHxz@LpDgg61Ds1NhC
z=j+~N-`7Xk?W4>XBO2j*L3rK(4N_7vb_p3@^@3lKmp_rVwWR&~#mHZN)13sM>J*~h
zpA){$bB;`dK2eMx+IenSPEbXtsx)^qR#u7HGV?)YO>N$Zm?O=cqmcja!lN=azh`%`
zUg7z8qVwF7NZ9{(y#QVxSjKkVM*EkRyc>GoE9QU3$2cZC1U$>UP;W4laB6~;Iz=;m
zPH+TDt>0*jOtQ!!$uFoFew&>`>;($IKAJ06s8Z_B&Uw0&Gid1H#s%`fAaLaaO1Se;
zd>vZ3>9k6*ST%l|M+$PoGLQX!&fx9(jl&4Dz?Tne6;(d@#S?)=8!}d?ZD@vNk>G7k
zoxPf)teND&gqrwr^)xyg7SWzmf#wW*Y^n~N;1FNtm+)nN?3wUKQn%{<)b5%9g9VFA
zX29Q!TF0xdek#jaH%tQcYO)8;W0wLyQRp{ZIhvwgWfRWFuHGPbm3c0XC$ir|vir|t
zA2?n1O3wgL6vO}0J*(?_Y2;Bo!v>3o8eldvp`w#}pkjeWW5V9Tn2jN{Iz$_~5eWx?
zjOROiZ0F?$Dz3y~8{a+5802i8sT+soDpWl$Hx5%`0la@$KJ%R4IP4?G<mU=2C9bJ^
z8N46TUiQA|S};=U-;c9m*Tau{x10aO&NHM;UCC$6)Phn?;@LzpW{eB;-rcV|GEUV~
z7Rumdf8!dj{T>ekJUqh|jaxHsxXO^dMd^JW(YCh!Y1}1ZTpUjW8*A$>Iaj>(uRlfh
zDxPEtl!O0cpw|^ZeQ9Efx3<U(o)FVdpX`_`L<6+QjwKXM!pLx)Fx}Q2=d!sI33xPs
zj~``ZaiEXy+ro-q4Ra?AF?Y6@y^rwMabBsEm_UJzsZB@e_9*jpwP#qz)sy#iYdmL1
z_swIb{i#D#kZ%XShVBnCBBX%#Hl1Pm3J1$&h%+#}9U#izhTrxa@59bcjP>wEi{|i!
zyuo9RY5vxK&mV6IbaxX8RZf;lqtFAt-ikLX9aD0Cgp7@pevxe;WEa_NXHEgj)YJC@
z`RO8C@!i5p4QS<Io^r<3O<kmZ-@Fa*VdWvkQ01YWbVg@l_L*JF!xs#?$eo@$jURP{
z!Wcx7=XvQqZKsmD1T~?KecDC5O)srw-llXdVTRj^kFmm?FKw$|lTJ>rP25|#_g>d^
z#IRj>XPmM_E(atxqXA=@;o;E5JHRCorKkViU@IWXfWDmNX)%WM=@^Ihjla#g%Dh8b
zKpUFxI^cHOqwUyAheI4Alikfzd2GUHPg@)|4oW`(ec=>9{aJXR@6)f3@+CWEQ2H#(
zxwnjA%{ikdMp{4Ap=a#v?LXOjeueDrCxj4}?4UmjZ*#6D{b#7ty3F2!pY??FtL*P5
z7(h>Rchf(0tf;|5Xc)#2jfJ)Msi0&hJ*1x7M{PgKrqZ;`p&{l$Dt~s6zWdBP4(itA
z4BXXYl6&?8eIdD3-S8{AF)^VDH1prqQEh6(F&Nz65e_LyPuh{4UZZ@wthCAM)Re6L
zRCbjz*Hiq52vN8|H3WmNazA$5GS#1c_{1q|8a0oiIREQVlULui)+mRPWaU;UOOHxl
zl2NU{lF3Wk<E|D+nx=G_V~|K7^$Opj?Vr!$a+%|BrhU?1a{5d<AyJ>oN8R{B)}Qu?
zLCL9?6R7%9z+U6A&9Y9bqA>=Y;zypC?!7oj@4eYxsJl8lpb)#*x%$4!aK>R8$wk+x
zGGKPfnjDkwy{ZxX$MOiM8Nj9b1p)%CbS9$CFBtPY$b*XCPsI1xxp=40)W|4}DsE_O
z#?jRDx`S)DD|Z!x>8BOfMQQ{0t!+1R>S{27apb#0bL2fatt^k+aXy8y(>}=*ZEqUk
zi%fXZ;_KspSN<OW00960Tz6$uoJ+GcZowrG+y@O#aCaLV26uONx8Uv?T!NDz!2$#r
z2rdBvA;91c0S3Ku-tXjH-@QL-?XK!)J*!q%^{(B`0zAHmqU}DB&#8t?O(*4%Lek;~
zd0k|Wntoh{QeBc*GRjQvcq!RsD60~md+ZTg0FqU+{549Q?)2N(TF))B7)5uFgNed)
zAGFl35CLA@RF=6lk>6sb)&zv~w7lX+NgCz$jhyB7NaLsYh7FcCmCi^bruaJNdSbNk
zmIh#6?Ocys<8`BTl<}*!Ja6xUm53Qij5nr<H<OJ(S+zErZ-rGTI|Lp4$)I?S_{L(g
z?_3OgIb8ybdNw8VMwI228(<1g2KPzLi@t-bF)qD)3Qr>MNu6OXJ@Zi`S#nPzpZ_?L
zqecvZyDTeQu9nIEWNN{>^$6;Ah96PbCJNuZ%e-mOmHuO&0+8sy%<>>&s#ip(t)G)K
z14dw-gOlv154*`yq)oLOC$vhxd`iJS#C&42eIifT)77mXcXP2$VnzhnA`AVFoBo3*
z38?8>NB2@JBqUYly^yFj!O~LemBT}|%_Fcd@AGHJbP3OG2qD^vytSnx4?@%m)W#9V
za^XhnSZ<36)4kMUsvlxj9<<7g_v2<*`0d5Uuxw?E%reEpY`W8O%HV*urM;xgwA5>r
z?A>3{a+(uG(H|w-Y^nq^uxxV<$SdGYRZ>$;F-=xejY%omP5dFT%~Cz1%@Y``cEO<X
zCXhD2uGFR}qoey5B=h2k1nb7$rMahOFy2@2L<*&6!l}8ZcJP!DrH734*k#<zcLL=B
zljnzRe%wmMZ_vvOl?TSHCu3mH2AI+v!o3|Gcf(ZUKRZsj{;HHRJy{nsx^mhEPnz9w
z`iKkLW;r~3CxG=~7*ck)Mz>mBY7?0e+^v^acNUkH)8uaQ9B)voZ+%a+1!<c6@>ANs
zEB4$YWqLxBC0lyfV<y)Z=gs8l1!~)fHd{^{1VQ0U14=R%s2z@U(2F@2ctM-FJPtF0
z1a-A09X>0k$ABkV!d9=xKQjG?G1h~#7e{p&AzsJm>Y_yzH0+s+iR5(kbIGKl=oTbR
z^&8)2TL9AiHJ@DsUO_s7z0_^@ZC#h9;XAQky8GEG<3jAwpXTtlbFx#nUXJQ$IWMtS
ze~AgOcK~y<S8emNSLOF&Z^k_p)pf6qWOOTo6(4@IFNh`B*9Lo;*p-A(qJteD_DiQ`
zfI{pY(<Rv~m9INF+_TE3Ys`+^ymltV0<yNnwsn#pe!%Rpo_wYJOIm!uV*ytcr#RBV
zP%l5TN?vo0xo10}oaR;2TV_mHr+<AkOsv+-zSLr#P{7b)bbha(&`S8tk+)b0qz0^{
z|D$^5+Wu|8af-%bUmNUk05hmI7{iCf8d)sML;I;VGjDJ%dilq@F}JfbDfS@(1e$3z
zUIl=H6zIETQksr^iafdOvQGfJ?6)B%(Kq+9vfcA^Wq*6!;>ihf|C)LXtWA#eW`Z_=
zst5<pNz^WS%3|_MEG_Kfw=JR<spN?YQ6=LQS(6t*2#ZGWg(mQXCcf`Cl<qfB+Ze)E
zbNB9&)5cW6z()pC#X8`lAItoML_YZX=X-n~LPjU+A;muP6tdO!jn8RqS#|o;ARsj+
zLX%_!UFISuQ!5L5s0g}jkI2**2pAJGD?mZ=H$C#vd%;S39>3hSax9|d$rfFep~|^Q
zcf35tnm1>|ytna=yHO;p2GdvZORqBRx6<c{)n$*6J!Ow%4Q2z<Fsn_Xc;GmcU<QU+
z%hsH-9m-}-(%!qMd{ecN)PqHm?dP|+p1y|AIJfjU9=u=~^{a-A6nb~+c~7qUF@m4+
zAxgnABB=+}WAY&mH)%x+@;>-fEAMfvRu${|gfGHXgcTQk0b;54fZF@hVN~uDdSOD}
zEyO&ZbeMgGnG!6PiDMOz-UZF*jCmxir4i4np#d7S+qu^;-ex*fH;s$x+}<N(kv2)P
zR7iqUds$jpoWsX5sAH}&4;>oD{kg9bx)0;+)J@jpQN3eAe5{|2i9}TC^~;_F1qVvY
z_yR$%rl+M1LK;{3Nfq>E<<)ndy7s74YtW7kHmvNzm&D8r*QTEWe3<PiB7pKx-+7Tg
zZ|mcz*$947aM7YU6uZZxDK_wj@_&mvCr?4^FU6BAM14e#N9*U5kJ_`B@hc{IyyA2W
zFahTm=d@K3lc<?WfaVjPPi@lqdaYVVbDWP`$eWU<{21~@l^jgGTjU!jHz-XLW+_7l
zPcHl|QXpHjM|)|aVy>S?iEBjrB#tkT?NT@tZtfzSQaHE+gYZ_imFuWlM@_3}6G9oj
zu{|57O7`1A=)NY7Jp891!T>5oi>>WQlHeVUQ@RulD!l2408HqZr45yT;r-b5@fc61
z&$fH|h<Ng{i-=n5-RQ+?(x~F=7XhQ5i_Uh~mjB5&f=RBD0smXIbl<Zm7-((uW-ty2
zL#*C_9X#g7>e`|EYT3SL?PEQ@bHl#XVj3}*t71YmJl7e!>%vc8dNTLcfnUEoC}#SK
zGw-Yem-f~{+R-ov{pu88zVT!wy`jo;T$0C~Ut%~*O0~BGIh(a(ukl}fzjRtH#SlZ(
zGJDUUc4Vq)kf3}J`rhtIndhTvReMNY?#+bX+K-8-C5~-pOAZ2qe$3BFy==~8fuIfk
z8;qfIRyXtKdT+pMRK1@iNX45vFE^5{C08BV6&isSD&@}@nz=8ZJXC(S=Dxh&&yC1`
z@%EUcKP`mzlTchKp5}^|Co@xCU-Inait`BXYAtY;SaeYC=K}FYgD_zJFjq-LGBk51
z7dV~__1w)BABE1&(~Ad??#crTF3YR!KU}sKE=Yh>PjNw6{H}ia5P6{Cjy!N431S~C
zh4?SI0=}md-&~dB7gL=?Kxf}(Qk~#mmK*<p;%TLk31x|vR*@;B_&{I9u0*V^*T%uO
zXzw0cN~p3<{mLh=Cke9+bWBbmK}6#FSY#3QP~omxKw>#CA%gNn$}&vA{t+V{zA4vo
zpq>}yi_+tv4mqL;1J~wXAVD<AvKXlM!1PNR30ro<{2^^IKxrO2MCmtXv)+f*vC~><
zZgo;dhJHix4*%Gk3>|+>=<zG5#zqdynWOeb4x9eQc1m|V3HI&R=<C2}n5n)xxSb<9
z34|=3sp}F5z;r@iMXwXhlSu+>^FZmQ_de_F??s%0g`UC%h4;-kj1>Am|GqT1XR5r`
zP=WoT^`EWi>tl_OqIl{~j&IaI(2+`~bR}^)_G%9BxzI2iE(;?{AL>%`8{JQI)|GGS
zp7UeGJ1OaD<X}q!sylo`xq=Uh>!wLB_d=#TXB`kE<b4PKCUmx}TZ7+1(BT8@@G;2K
z_>ybgJ8d!MQHK0%>$lGabOmHqoVf%g>7gj($eIW>AM9|$Q||=s>V9!LRVbrHWhMk}
zgjM`ZQ!wx<I-odJG5c(!4hc&I!v|y`BD7<Ep}ON!P3l*CU3B=7q-%wYvpxmu9qak!
zZGPWuCv)w=-dEMe$>M@1OLCEhy~x-#bWzp{oojSOF~81r5x*Z2s5oRly3*NaxVx~d
z&YR&&Zu`SADfu_Ap5LYVcVgXrdBL*cTSxKRctJUUtuOswe4ES0DDM1Pl6JgqVwR4P
z-YRVL&Sv_$R-m8D34&r;^9y-lT!`P923aR#zdTLiy;!dSX8s)w75=w!;%7FfO|B|C
z>rPcp<t4s3_y@vTX{4hbYBec-ZYR1)iyekUmAT*Xn%2`71dMw|vR3HC8XZ3`lqfhn
z+G5;l=90eTRelTQulN><4ny=RfzaQT)J^OFrh#|~6T_ZTIQADm)zX{oj;~)+?wj0B
zA5E!!pX(2ShXN*Al0z@NRnwu16q~tsyw@-1Uu3Bntc&n?#}0m*N~7`xgdPIzRsK13
zR2BrqF1ob#eIYH%Q%r&QSx3koXWh#ZJDK{6V>AV4b<Hyet!HX-zaTu|{Td)Sfvfs>
z!V?@qD7;l+C7!8u!?Tz9WUsbTGQ9BY_GB4q4>SKKOZbU3jLpYqxJ8Bv4++a%5)nVw
zutUn^)#%!|)kurPRRYQ3LMw=v6oZ3@3=aN+io3@LdJF@==)R1t8$c*SD6RARfy$1I
zZGO={+o6mt9zf_7&g2v=Vq4q!z%d&)r||!Eu_vd}QEY6-VWGUpk|b1{y|3XbT^j>z
zo|4{n`aX>g<y6`J2-?bI_H4-3eA3x4S{)(+M(B@pB?0)sL#>`iW+e9?-gdhaW-i~%
zN*0xs80(7%Zkn%j)rpg27af5}NVA_Z?4P!vx|~FxZj5m8s$i66x|Sn1>TP8EVNi#f
z328w}D}h0owl<m?4q?+GZIjkz3nRXDM^T0s;}}_@yeHfR4(mN-eBPvB+Yhf?o;?){
z08}tzr;wiK#R5OmIqd_|H@a``jG>kWd2h5X)8A;(cZO{(NORP5D=!8v`iW}<yZ6*T
zY@BWQp6Puy@kN+tQ9}!6m*E^~qosAz9Y(o{!sTP7wJ0IN3x`F_bY-j%^U|C)xzn+N
z<RYqsW%xA#-26HMqN}aH3;SP6Ts`B^N6BQGL+4XcoUD{OO>uVV3iCrDTXgz)FHzf{
zrLWVZf5>AaQmu^XM&M|PdHgt~GoF#}4omTxMVBX55a`~IDt|>!ZtV4S78yVJt<dj%
z1Xw)J&C4AIC2r)B&w){D0?Fy<qZ%B)_ZJD0%RfbJGbKLCL)pSJ`H;2;>Jr26n3M#P
z?-c}+zs7|w6w;(#eiId{X*(uhB$w}keVpe;ZjGP3yoa#)3k`2G5Zz7m^wnk_f(sk<
z0FT3#8l0&tg#aGyfa?%kKLvsa2<xq)Mc6MF)H@2?O<y>IUy@fyzHnjxg-aw~H<3XK
z5#Tuy(s<KM>K82$#q$>*FcYV1jd+#$<<u6RqzI!je9f*Pwt^xE(F9r7dYFY7K4h%u
z!%F<PCQ6@18@i05|28GX0_bKX@n$8Qb!vo|KO^VmxK;G@<RaQ@5{o1dk(Q!-R|im0
zzeSrAZ0`NVB`kSaHO_s9h_skw-*3I$>q}L8@^a>CRxYiOiI&5tWBk6KYAr<*^UsTX
zT456{mC>W@jf?I|-I@gFoHd@SP_Q#GRIltURSA@FJ5S{9txL|sR6tIp!TpR^oS<xY
z+}?JdND?zgKgG;E3E!E3zX6fXApy-UVSl7&{O8jC7M;V-HHBO3fokrUyM&`~GF0Vf
z3SuZ8@s>Lj<D;Fz=_wb!^uFa*Wd&-l1IFlNMK{uDIh55iqKmh>5X3;K2<ob$#J?3m
z($rWDU=o>1q`T+<aLQDSRhjLsyJ28Cq-tLcOm+)<d9+SL>`H+6$5UIZtYrZNqiyu?
z3Kyc4sA68+DnC51O@Vp^x%Q&)C5-}nYCt_$n-$UxSJ$ty`;of?B)+QtoS_2Z)07#t
zC(~_UjN-W>&l`W%WU%Q{%E^ViGJ4<TLq<ydCCMRR*@ZYMAAFK^z<4-zbF!roymXx0
zm3u&;B>pK=t&mX)`Z-t-Pjm`!^8jBIr{Vc+{Qb{rgpp_JVK3U~`S+6hGRNAbk}O3e
z?bQVKxoQ>gan%R-vZNIR_T4gRC=BtupbrY3FfjcvR@y)(ZA&3-wdgk{+?A6+HNAVy
zGLo7kDS}k{MOx$}2iC?ASR3PcqH)E=264v4Qb+rasX!SZNr5o^u>!Ed#c>DR#;{;o
zoL4#iE@<rNJ1|I1#?)ynMs*buAx7R0irastKmhe0y;?uG5N{F3jyp}v7k8KPy=9ha
z5y!$?f8grIk?^vuM#ECy7c-N;C6u`(JkKN)y<$h65tW?|Qik^e&hq@yEFH?Fwe73y
z%yVT9*<GW?K#26h9ZQv@ri+va=0cNs;Ay$*e2u}qh3ClxE9fse@{o*Hlw8aPaGb6t
z!sB@!zD&MUcxJfkbvt^`-wucJuI{k}BpXzD7#W&6(-p+6bPb&U#^rkK$GwA^2Ad1;
zFzietSO}EwP8V^0i8rSU#nZKadI_7mpQZ_z_eFRi&sqv~Vg6`3uXMD$Fn7=Qp*=*E
z{i7+}zpjx%zg+fG6IbOQ;Gens>S6QrX&Ev&!>)zX%C&>zvEy*juFe&=e3`yF<{v7>
z$b*_cX%gW`?+{5Yt^eHKsT^~aFs32oUy2?J;<Amq(x<+jx4GFb5L75+gsPB7qg>_P
z1%TXqE{MM&GWK60%gW44JPJ``YY07$phuDSU~j#|L`#UHqIqG_;))*pCY366e2sLk
zEnN!Kp@R}GF6`iIsAtq$@u`xg#88z;)>ZM+2Zg=l=)7ACp|Cg>l^^a!r$YHPE43VB
zxrewSQok#T+6Kskru6>8xqu#!goGR}o%G+$j_*~w971c?o*xOLr-2%&CUOUd`h+6l
zvj4*Pp?+q4vMlsaA18qGu#74(U>vpFqz<s`cr^a!>#jb>F9kYltZ9sJoi`-}0UE%@
zWqDvDG5<)wcU4}^jZT>0%MSipY~)%Ch^^D^y=3mO3*1ySjc|1kaxqMYt8Cf87slv4
zxajh0h>t}(p~7#zPvfw&6?&ZkUsj~yxq`l0Zx{6F95+)uG9!jmR^%LnsWBsF6?<cj
zb}}@e6>~86gEQ>LyqlLFvotvOZ4y=_EC3=U+f}k03bJR5rIkodhNIiD8p5j*=e9UX
zNgR+HLHo5pZH)!@Mn4O$T24LGYFIwh3W=XdZW0UYzZpM|Db(J@##_);J}a>5J8P;K
zL77g@%YQJEC6|uJ&{dAd?3X7_$=WeRk&uQ+4P1)fVPL8BY=@#?VkPE>dSPJcc&SRg
zp#ouG*^`rUbMiJDXJ8VMa^K9PMwijNdITt!On@V1QY)vettIWo=Jr}!sd=pqJV7A0
zx2(#=6JQTm<gu%PhEOtQA1$4ZPC?DSak8}LwY<ltT_tQEL60E$s7yXHCo>&6^@*}w
zr73w&2GkxhLC<$lneR?v62ZEpxhtKOPj3eOqY<-3d&J_W^s=M+0<cp1pGPC4uvuKh
z0dc&|2Q5?hFhMtOJ~KG8g~v%|IBj>AqYT*IJ9oId*O+j}T_0UF;5Q9#;M_=2!sZ9g
zf%D`?^VD#KjDkzmg2{jEi!Gm=qegyJwcKHXrUkVMvzdxaM>csrv5HI$^zcrd-@2r>
zq6A^UF0!ia3=ySmkkM~<l#Md?Z$Wz~%&tGnBZVf!e#7EQdVbWeuk$Y10Cqr$zXI>7
z95)LZTlx-2Q#(rV*slwo2aUpRLNV~##p&R#i2Ec8?A>0tsqJ_iLLf-1I@jaU_Hmi}
zn;&zr`>-SUeVJnc?+-SQj=j$L6;NFfVSwKbxwN2`3;SeLDQVa@5bonFY?1Uiqttkf
zrkLr)t&Qyh`=TO#>GI4r(e4D@uK0wV6IXfSQsK2x7P`6!`uUnyCV?E~N6|NTa;hkP
zmH(2bEy1d-A+mt?euJ?%aV#8v3|i4Uv>)9EuY~f3!nEMaGBi9V(1q#+wETo+_Kjl8
z+OVVmzEv|B!!s*3u~R;1MJEGJYvcUYMkbiUHU9v{a2yOO*9tF@8^1HJqtiN}CN&>T
zY}N)Aa?4jlv>lBk*c4_V2;q()W0S+iKgvJjpNg4gGh4VpfYo}F%sV$M?QiWV>`FNF
zgp%QG-%TP<xnSVfZu60BZ{e8=C<EIPmQjX5a^FP&h2B*0#3fX()9T1@Yd_$ckGuQP
z#>Z)Eyh^K+r_=mXBU48i0bVKB6bwXTu}x8e91m(wQKo}ehSUY4)kg4<vfA_-E|(U%
zHhV3+%_W0^nD*9BbuBz@re?5NL)%I0iY|3jL9Z0S!<yt|++iri=**_Np#>ZG0nP1d
z%%#ksc??z-iXn92?YaC{t$leXL`-bYeUsVP4z3pt<|b^yAK1N#D7+;WpBRf1HTY_!
zqsI2*IA~HoZs2r(n$u3an={)7*ZR*O8@F)3?62ZlEb_<Ke-eeWGz7`X<LGppwCFh_
zH>_f)vk>rtfMInXOUDBc+E0)amk7u~z;ml!6YZZTl?gput(|1$V*y-bAPy9eCs(n#
zJec&b7{+H4DO@s32~g^z5o*J?Ha5#?f8}5L9}992hg`-Vi_`|<HkcRJK)gK`aM4wB
z!YCbe13_vC87FR^r*qk6MUWCM-{k_>`Icmog^Dx`LrWyK9<|U8cM^?&nDkTP9rROr
z9mCMN{AnYG)BG=Wj8l3S#u<9!J&aA<zN*hE(+Qz+J0m4=qrdS0T@}ChK<Va}W>A(p
zTb6_oO{04f3B(d1aL!`WJ;4Q$C*|Y&fP>3Kft<nro-0u>PrYrRZXI|rAG~OjRlnH7
zXxmS9>1;#%(sh`57aAK^FpZo0r-9=qz01|bGqfwLbG!z05LIw`i!h=Wor}Nct|Wpm
zo6$>b7p3%G{+RiKN#(t~WDJ*5Mxnf<lF0uD@EOjT^nxiK^m`h`J0daMdt5@ElmKRj
zZOn21pK>0Qu}<6W#d#`VQv3;+D1ojE&<dtJPz$C=XJ2&YWvTqD(SQmblzR$O+w|l9
zFp^1;PQU8R+7U^HMaajYCtV7)(r?^htm=ra?{Y&#YF8}%g~80uY@uB!8pXF;CdfFh
z%$y`Ph8z=%-1uw8a2bs)4wgR&>E%G^CGWT(j+AsUqu?Hlap&pxM9{GO^LGkSVJk(C
zDNh&xJt!sdtfG>sEv=B=@T3=xI??ZOjqy`%=Z#l1z*{2Lb4RR_z_NzIvX;!g$o=10
zZ!1h$!m>_;odFm9-d7mOewN0BGi4aKwT6+bjpOh;R7|+Ue0DYXfud`?Gt9K>3v$Nb
zhA8+jhTw(@1uE8)iWHsH>lTdb8NJz{E}gLJmiV2Ck6U*h^?rRn9fo)HRoetjN)I<Z
zyv@trvM2AgYAASTH;Gy?dMm)!oX{k{mjsid;lLVq92+K@)HyPl1{gJC|4~iW1g|3h
zQiG}7Lr}66#RRcQ9j<@-tsVR1v=xs#_4Aeyr^HeeT6Yinz?COZPM%eI9nA-bQvVH7
zj472DI)imojCqC{1Q+Q-fn<DYAOpmYbSa|n%8{5cMsNy3|K4thAmRHT$n{ZHs9MKQ
zw*MSuyShl{)W~7M^YeG4MR=9gvvF>}XvVni589E%EK)IXCQ9DzHo}=A!?$jwN?_7v
z)@Bwu7e(~*0x>3C{R<Fy;GKavg7)93+$ix71V){&U|PZc<>Fn|N7BRkN8kj4)%KHs
zkHC(aCmf}>Q4bo1bveqqO1p5$Sqs5qFPZ6UMi~omZEoEl!#(OPGkQ-7H{n?8wnV+E
z{2MbQ^Sk;C?@%LsSx(Ikn7{SN@WId%k1Z#fge?U>{Lou`(1T*W@yVdsY`oTgh(X`N
z`Z*F(K!Y+7K+cvEVb+!0L$#POJm^s?sxO8X$$+9;7f6#sjL7v5<RJV%fam%Us4=X}
zQYAL#!{I=tuHsy3=|C4(n`EWpjKtM3`&x_4+|6+Zk%rkZ?j5Xp7j<|e3vyIk9e5}m
za-O*Kf7N<oZBk|Ks!LLB5@!{EKI|97S~+Q4-f#F=doH<h#xv978zzP=D;h_kW8Equ
zIF%)zgPb)Hf}AH<_QnT1go!{o@0+se>fiPjk)jwsq(VZ<R^@}DsqXJWPRikjaLR4E
zwC>zX5Y!(kafhbs1s;zhf5#ReY$|S@w@p)q+zg$!QIV{KT!xfA{d|&ofIdWHmnyi0
zeKFlPyHK%{g$#N?<b?$T)J4k4j%f-8eW2X>`BfT$^reH`4kn)5`o5p!PiAqkZe*RB
zIV2+?KPZdo`G4dbqx7JV9+R3iJ1RsP54|}i-7qUi9poRB?AzE{1?xaoJ+6#IwAy3t
zRJf#euFCs@qWaAF#a_?Ilkgz}sNDN&_{Atcq_7Q$wc_5R`5QYc;uow*^`x*xh_#~K
zjnUrcS>X9q>C1>~u^~(oChXhB%WlF#P?eUrz$*P=SXd7BHajg_NCTM^mBnh>9+fQ&
z+Q?D-x`QdiE*~?UZ&5ASf7B0yuGJ6C2+F5^UQ_=q$8p(0Rsd6KJiRH?t@?uY2eo#D
zE(Xu=b!F+{Q!ONy=SGfW8-wpJjMP3br814)Q@^kOvWDC8z>v7^NbS=`al}XH)6`<=
zOEByrU|jy*rI;7~*yTe3Kozd1U~E^BU|Ga|s{r7L$JA6Q*#+XYOi%k<SHz}H@6VZy
zp#Lhe6vjw32rx#<%!KQ=Y)fHA{_dtC(dOR(_g`6+8DRsld#l|~QTNM5r=Mcsx<Gj}
zcX{x*C$iZQ(q?zW?iqet)(lYgdr?Jj?1#KM%X@o!5au^s1N}s>p*PF+@`QWQhraz}
z5O?d;7Q`NX>v-b#3-f|<8|jb8+N9_-|J8IGJ6f5cU6c!Z^5NWBb51?*^=p8<?AzDh
zcfEiv(U3`9N5M9tEFMGKiM-WOm!eu|od<=CXpN2&f?BW3+rn;9nd;~1DCws%s%jU@
z<mDF)&g$KTpwW?9*hp7<TE{I4VD~w+*<5h`$s7#C7xr#juQe>y`V432T9(oII(4{X
zM$zb%!j{1pePgupmcbo;Bax&GD;A#f2*42z&-rpZ;5F@ncB3k9zE;<#JVOYdagx!q
zESPkz5H^Cw7#L<|MgR@9h5vA56!R_ZzqQ>X_#XfO0RR6~m<cphf7|{KinGtz```$D
zGiJz;2#L&7IEG`Ma%757ky(b!<rp(hkx)qzl^-G$LX?QilzCR>G5_;C@B6&#|LnE)
z_xfDdUh7_a-)j%+-p-G@=AJ*4uvt6Kz02d_Ya?3qQNP>u@I+3te14$hmkH-8AJmV1
zYV*C%VM7Sjhcv@C-4JQiT@-yi#vCGT+ua_e|BzN&)0ooy^W8YEjE=jS6Xg^TO50C^
zBGG^Q8Gs61q{5TvZ~qJkrR$GCljxI?ay3acnZB<-u1qko3qMi0^^S=>FSc}6E84Ql
z1`k?oc0G09LF`A1p$YB9yY9q<`7xb@qiqHbFGk<amT%&NSJ&)6i?a@MtW(Wp(xX~~
zLgjA>WU$hRFTBkqUBxsPfA{sg0~iX4!|l`4%5gHc1kC5Z`>q{dd24-(!*g9$_I`;#
zEz{<`74`Qo<qYYEk8K9&gr!PdI~isQCIb`}h`sxB#NMVY<@YtY%AeV`=kmY4)*r|%
z7V{DKX(_k+aS5XLsZ8UW6RC8RL+X{&P75EHDH}NUUXTrQWe&P;pjAC)l0RuHYyf{0
zYWM!#>@AXZcILUV$1Pz4Qtk>~;3;)WAH~Wu3lfRPV<e5k@Ovitk=c(<XtwiJCZ(*s
zQf=zY0DX5$2ji?`Zbm#367p5Mmras0@aIn1tpDSG=GE7<dC9Bq6n?gT9wv80To%qG
zr^wP;FR|TNyFSjtk?zqN>d_kJQI(Q`3$$;no@ALMI)BPFh?i42>8C2Sa_r*DF_#hO
zQ+3Ka4}l7gZI@4@*QHnLV?17H``*y@W#x>fpP4jtrwXzT9;@#5T({p+8oMU{czg~L
zvdL4HPycG+!Jwb-U6d>T;ZKd(wU29&e7_?V=b)*{Qh|GSue=f1xRLkmRe-9JxKxeJ
zX5?LaSI-7nsTwYQy%m9HXSOAcQ|P?SL1S5R4~gH=FYQDE&2w$`%;4EnnS2bpNHEj1
zQ3FY~;9YZmH@`$ZDZI^E{bIh3f$Y79q>tjej7@em%?!86c5`^|8Ob=3{lEnN(ieWu
z5}hdnCS6fRj`K-{!!|sx*t|LMms+&$3>DjxOl`V^RqJx3?xqRaA9QAXko+>DPdy}G
zIP)mCvpy#8_YtOJ?SqUQ)%C&3@4Oq`+;VnV_5yDieN}U91T-q96O+@GK3mi)DiRsq
zOcte;35FD{g)lokO-VChZJx}Z6wb&q3Rh8)e{qavH^ZgAD9CcuRz=?C?vgplz0S2i
zP(ZzZ|G3>&!^UI)N9U!_Hpjgbh+ke=ljzT`uLd09(--5Z`p=^J7xVA`W_hs4EK(+2
zRx?)Znl-7;d9iH9?mr?!&nB>5?s0}b(8_PD>Q6VpL-msM{GnlHgS4o9N#G;F1cLc$
zmCUc;^GP~0%mRw1Ie+kRUc6KhWO-OZG$9JRVj2pBF5q6LiM=qsuAeIA%Wj~*LUzxm
za`beuvm@LUyeog@b-3pTllryuHs?04_Pv$YC9-@n8qpd@o!W8##kSYK7vJ+i%lBf%
ziEpV&Ekx!|$p;$LF5<Ulgn}i{dW@Tul|8q(>F8qZ_-<gy>XwK|^t1aKV`fLYHs&1s
zV~Du+2oJ;FKd%Hoye(ci7Ke|^t|b~4#1Q+vqjSs5Z$G;s5XXFzvi8jnxvY9Ghv$}A
z=YML5<y&5!&<d>e?-_IJ)f>|DOWBInRKc5*`i4n?pQUMUOw}k%K<~RN=wRjz7LoV_
zh1<pXBulcS+-lT&ukJ#e<4vP(FQ)bKe!iLgHPSo!WDACGUO)<)E8qV<H`(HZ+1>4n
zZL4EpiaM;!V=B9&a_I*vk?G^P-%?n56Vh+Qno{*fZ%GK4qAK&Jha^l<QjeyGJWWym
z<WA$ez0zM?YqF%(IHz`?!N@-I+~xy8N==^N7%kv&&p)}1LErUxC&5eD%ShjmXapt*
z=hWm~zB1@9P>^5E<l=tWJIh^7yAPa+iNz~hqZ4Vr7u?1-&)l(fdqc8$OvrMw@)vs{
zcekpyYsH}2)6?V0U&C*GUaK*EJ>u6DW7?YEcJ(|ZS7s^c<ova~Sn}ve>Fu1Sw{t9i
zUECZFF<&a}40w6s_!#s4+na|czW&g!7~B(b_~)*+<a=Y?viK*}eA1z`f8{Pc$=MOI
zqQo6}`e5y*NV_}V1D5Yjc|Fo^@NZ5`34i{fFEkk7=;F}6+<SC5T9UFkjuoGh#{cro
zdi6kG-(6q+#Q7;nS59Bd?uyz^ro_n1($(hnJ<*dpHK%{)@ezOc4W?|4p0^xF)_O-T
z*mz6lKUsddTTn}N?v`{r>*$w1m;Kg*x)lUB$JL(w4Q$co*&IJ>7FJpt#2=Zyuo`tA
zY+s?5)P`<j+}-bR?<gPt7Tb~YC8+ZK?b1i2pIS~urC}Y+7HN)MIbnlK%z>qpBa(if
zT;1Qcs-Nebjt}%UxIQ?``L-(}?H%I(AkasYb872;^nyM^^j?ve$+H|QvKXDZkH!~c
zV)4otuZ}#&kBAYp{{yxtf8utVMt8(W@wAGYZr}qpW3M#v0t2O|if!?XQG4Q>DsC|A
zLTj7q;Ys6SvAIOM;{_cTMa`N-hj%(_+O_F_9&hG9WlrDeACe^@v->)`AhC;+!GPJ<
z6(jcrBe!|C?W{Ug)xu)1dbHm@pBdBF?K&=$h5on0x{$l4Poi$SUiGFzm3Atj>Q1nr
zuAxxZDDGKJgyk`mB^Cv{pw1UvnPJGg&ezZKg4#JbiDXrR$p;#qx3Yv$&sf{}?Y)yo
z{Ie`~4%nGb--9CC$Qg}cs2V=5>blwKLAvRO&XV$ivu}mN4q}5kTZ~559Z`t<gQ*Qy
zb>c_jd;*OdQ*QPeaf^{vXN?UiYI&PQ43?CGOghPjF$!tp(^AXUS0x)dZU|@2HnTO?
zPQCav*3D4i#}O8ItG+zrsWjgZjlEdm(<Ufz)DlnLw6hbdHqmQj>-+It1oF<!E+2Vv
z=51_mWI$|o8&i8mK*;}yS9aUv)LH#AHh0eK_N+=XHBUSBe63P;=16m^KhLUvT{Bg9
zs(8Qw)o-|Y=ktDSq=ra~oe|}{jpAJOZ?1Lqcbc{tBKPDya4Z#k4N1yZbaU?Ljd%7#
z18mHOo#fcUc0~!xS1g=r0I>{jJ$LMa&tACZp7S018_NFIdT)A#Yi=_wkeBT~IGk#9
zp#8|JH`B%K-)Zqv{KW?cv&x?$9;N&*K02^)-Dpp4z4E%VBK<VS;XU*Q8%vk!2HV!o
z*8uxVBwZ!2l=8~;=r5j3vWSU@L!I)kejxV3W~<!7{ga|lzK~5<0ZTgN;n9k9kzCyT
za#QqrJI%tv*<$VUB3mx2ue%OJ_aikvE2-D%eDyE2Z)VkIT;dfQg^wAgCWs3Jc@~L9
zHT~RfoOegb1k;BzwO?6lrcf6(@w(J)*%#RZmb#)!I>{Yf5>snlvRe<;)<v2l{jXN^
zlCv&}JL;r`FsFYidY;g%^K7*7$C<iCwwR(Y?UXyJH_hP9x^9Dp)eeK_Z{(EF&c&$-
zT(Y2Kare=7lSJ=T+v3*8k9$mVC)*4XtzfCAz*SeO_vD`kjK+n|asF-5&*_2q!2?EK
zE(!ZiH4T#Vri>y!<6A;A|B~heen*R>dg+w4rEIA2a8dWle(<1zc$43Zj1NQYGw-5@
zOJg4BazB45_F5&nrMuKa3YYf#nbZWG{@Gv89(`oK{8v6nA@5)Em9r~laPrQXz#x6;
z#qG~d)*psfV`rIb_rtnZ#<m^&*rF>UCRESY^7@dxE96SspN$4Hq>ttv_w~aKjM93N
z9t+Setvqa5Idh>l$6(nlJYR!Y>?^Hez$;)<m&;w8#N?_H{O_>04bqK&$o)Kt36@%`
za~qoV@LbCq3JHAG8)EfLv@+G{RcBf7_#Bne#xzwg)!sHu0P4wPcnV!L=f{SV>2yK#
z{*9J%R2yFVmQz&M&vD)+u7`S+&^_dpNcjJx3AA34n3QR~#?JKakZ8NF@M>svSNq7q
z(ltzSqDU`iX`8NoDI-8+-%fe|iFe)VwT7}pU)GPW$B&hd^S!m%>lP(1NxM{xD}K4V
zZ?eD4yHurLIj;Ee-==A6SaZmo%c0@$-Qm_`+#ThPOu8kojuLlwRL-fAu+6TL$p32f
zy!1W!`(kQ0p{M>~WB_01F>k!vh0C`EJc3KvF&zZj(3GP5ly8Y?LQ{M~u_>@CQKDG3
zo%<JGL`e#a{~zO<tkOfE1p<UcV)7?qa`!_%$wj`F(_w3Jbj0KjiD}@#BI_~d**6-s
zTw9LYy}Wj!`J=|NYee7GJ&Q|tPDIv|zB`}SMtN~oH2n`BBXUJ_$oX5+ekiTNoBV}p
z{ank`7aLiZcc}xNDrgxqZWPC^^GpzAJX@^Fa<NA92Mla}A?g>t)K9ibUF@ORW*SFk
zI38vz`Fb#vc7{x@=&NodiIpdg&?&x7${AiI*mKpmD+wFWBw~6|qTWcbNj@z*bMa$}
z4K1XWnlcPKwNk8%gqU!L%ZsXVF&CfXWJXC|ztK`+RBbr8Us=%JIrb_Sn7o{KnGoEj
ze0ByoEz*+uMEM)VEUjc2uiLNcfE^7sJ?}uHv1&~^pY&ii_5G!0IA#J{8=dmA(q8F7
z&h;G0+D6umZc^z`6xHKI!#8cv-iVO(7<205++^8MeF8`1H%)x4cCt(l=UcV$)9B#)
zp{F@`G*7WlXi)a=5l!e)T#DE4TJ?yhuXR?at!`%cTSyP^UW`y!=&;Q?+iFAaTppMG
z>JqrgES=H7Snz?fnKlr8N<=PVlEJb3{t|8A$x};qw&nNdErL%rFEn|VD#G@gb`oY>
zGZaxY^E<u1%JbzYdIw*=$lNR-!;^Q9U(tQHvPP@GhF+ZfmyIXvFi))Ynv=srWG*u<
z+l!cB*%BR3W=NUa9}vHh@9<jsZNEW+rGsB5+Pf2dyAvI}?|n?hDY8CTmYQ8sbzG5y
zs$W^XZTK1Q$ntl_zgzQHrWz`}%M|qMw5EpE>x7O3`||{TWO>~ZLT#2#;;$L~cyOQA
z%&}AD$+4Xev*dF>NLHU4rHAab69{)EIXQYQw`z_rucsN+GE9HlM^EOMmuNH%Yt0Vh
zGo$KnC)XF;Ib(_oPl?NJA<E3({r<);OV?TE4hJin;(eKRmMO(&G03A~tf#cC$_lMu
z+bH*|j--y*u#-O43ICoW7d@xeB)B!KGk7yHXv8PpvDawZWboSjEbAbTMBWxQ7nF(D
zCI5KM`&BqkSdYt+&P+O;!_cb1@lR<RhfUsPu7!jVWX>`!+eM(uQ;ChUhSe<g8P{8X
z+I;=)>rHe9vDX`WCI~L)@=}K;2#o(FzgYBRZvH9CWa-Kun*hz{^4|WKAPif{yNpZ_
zCRy~eUH@E*JC}D_30F=o{@8ipKDC9?bKY6|J&Tks7JbF$Xo)D^&*y9pbE;1z2#_hb
zM6*ZZFm+M2XZVelY|fC@gTQ~}bxZ^A*Y-%H`f=ya=ZP)m>u@HCQJ+E=&eW&Gn;2et
z4t49U*h<!5zeK)x=$|~GyE4R-=#uHL8`12Ly>yJ|mD}j@Pwy;%&$kDv3m9a7`c7H@
z_IepKM@L#T@1zQH2hDV7W-c^|QSVWTW)KyPE;CM=pEhG{h>1NZrp9GQS&c8pWh`Hg
z`%)fF^-Ss3nT}sMHJ&?8_3ZV>`<VXuwi!wE{OB%_`Fof^+*yufx-0i9a-6tG*)RO6
zO3C?M>mw>Jo$B?Nzw7Yf?`*bu`HZ`q#1VL|CN5h@pvxzulsJMBe>eK6dl|Pu+N#*Y
zF^{ec6b@UT99;>Y^JRVXTu@Yu*8cak%N}VmB*UOEc^h%It9{%udP={>n7UHegZQm$
z1-@5K@LhdkD`;+Wfdy8eDxSUk^s{EiTFcv?CA!rUgwRKGS6#f*9^1~fH%c#@H`#Ii
z-y3r<Y-@LI>6g{<vT3ZG^87?>jdHJn(ICEHtkpTa^cO>=N>r#`H>;qCuEx@X1s(mD
zHoBG0>xT*gvr*`hs`JHT>G?5Aa^#XKA(QvZqf0k6`s5f)S5e0GYK03Np(TD=Chwab
zFK}?0uJV|?*C|}^_Sm6P?sNG=vLlGzmCuR2EXl*s-{>>c6aVK}zHC{PYR9QifpTHq
zIo&3=I8ueLgFNMZ^>hn5=RQ&xA={x?l^<LmF2HueX22XMJuR$wA{#Vr9<G()qp*ae
za!a`K5TSxVpMe{G_wG3=HCt>c>N2#S@*v>V2KTp){h^M0jcvRw`d~T{OWK{Jw)tBf
zeSU$*^zTmoh;H}tpC0zegEq}yQ3q2^>gB=B_Y+IqAA`<zO`2Ww3#XchM261?t@~n8
zbG&{PiMor5MhA06iMqy$61TRK0>5dlJnl^6F>jx4QI7kUJW-D0Hg7l0Ch^<+Y%{%@
z1pG%>z0GbnXt`a@Zv{11iof7o+8cwh$PiQGl}t48^C@aaThmY6cer};r?qpWK=rGH
zJ&~i7(*Y@KpA=+^-z>dBmc155kW<Cum_GN)l5ydmgW-C=Z69wfdp^2+HoI@YpR2OI
zJngYo7dHB3T=p(;;L7pu0V>f0dq?O0`AchmcKFFY67{m7!eP-T`elFE%d5}saP?FD
z^Ix($Df?x=8t2c|PZ(?UN!a$toed63c(CVn>bZOLt;}r?wVML|T+-U+63Sz(dR9&$
z9U0fVX_(&E-{9`D?;Y`26WOkb9b@vAsY^WZGZ<EVR4^+I^Nh9TM{Otl@aJ+#+fF+3
zU-GFg@k0B)mSkOG+}Hg!+c8Zuwt{m<um32%PMZ(;-1FkWb`tY_@l}Vmw*9tUPt=Nq
z8^hu=?>L#P`o-=s1E;GQJf9JELpRmM>sFl7&!auRa~eLiRnMYkbc{(5H0CbQ?Pheu
zsHY0a7U+gWOI+4W6=E=a+7>O*ayeB<v0y}%ahiq0&@Glosgd#ewU4b2D==Ic;Q9Pk
z?7qEV=r;A<iNYDIKvhXN!C$E~x`&QOTWLcmn=p{bqusz?06Q}}D#r`bsH+15-p?pT
zL)zYGiBJjwL)y&f<Q`sajAp7zJVD0!QL#jHR%8V8na7{)<nuA9ZjmJ$rBgkOQUgWt
zAI>bcN?#%87(308sn{cW#g`_SDKAOe6l@3oL?b`Gk^jnkpgF#cAJ3AZ<tmzFV$DOS
zRyXn?^ZmjT`uLLv_>+rt_&~<ock2TBTJ?q*{Go5gT&rkzVteJ`i5lNV=k194rMy$O
zGI7q^sR?l@qqPZ|o%bBKL+F<Nwticg{}ZjG;d|u3``GN@y_-cyV)5GvfeEO&kom}#
zyL<0o;jege@}WD^^xF6z$Mg;38*48^)7y(L&0Kr9Lf_E7Qogj#Q{F|NAKXLVz{S0P
z&=}s4ae-7{G_l4%p;)RTENa8E()8{>c46nM&JIPVf-N#K_sbP~4;PyXLR{n?nyjwn
z6^V*I61hq$yL$8de6Z(o&=Zn`^*M#-*1PiUBsl&_^*)N)`RB6@{RML!{h_k-yxy{a
zybB~uJpXR|u^#)OPUAf%vx!f2B<l!`eLdIBB*Hqs!<yr!eMEcD(vE#bgS~jhpWLa8
zmX9&KW;bVEJD(ruoX+Y#@dk6M&4yja!^Q`N9I$fRm^I9FOo+evqD7^*>#+3d|H?b;
zIpuxQyfMAt>d&$3*j>bJwHrTNDeWfR;8E+Uk#Ri{FYJC$WjZdhp`;405qKK6b}?%k
zSvl828o9fQ!EMaiil$%k^YZWmEABR~2$j6N-vRLPU59k;@t4PU-TL_7kq3W|x;|L_
z^yXJ>I|Vy$?i6zt6z&X`XqFnt>-;q>?r7CKF`NBN&OFhdII5~Yt-Xd>*@~{D9Z7rT
zx>}X4t|!v+!IUy`+P7tF>fMr<EIaWn)!m+v=|5w#-k#GxX7-hs&;nPKJSPuo2K~Ez
zpIUiO+0>Jd8zteYk&F6vNHX&j5kbk*qRQE*xfR}5u~FGp9Y+<OLTQ)|$Kg>YO{vbu
zP@UJNwoRpK<m5mFo=3%Goz`<4PY$s}8AM<2JBN1vU4RSys4l&BwQnr(8Xcn%yW6pE
zjSly|IbUAWUw6K&uWbC4sKUqhzm3%hmdxctZJjzBEN)}_Cak!pg@y-t!u#u(q*jVP
zxBk5-@l~3*8kD#b4OyI(;S;Icw(~OLAX=hybh+STuwhGPta{Xb!4*PH^w|;CcFgwW
zrymc)aH?ECZ*Yr}zqr14#ENz<MM_RI-#4ZE-OfO>)4&@(+ps-t?0xpaE*JGX=E4~z
z**ochno_%8${#MO{UmXz%ofO%aGjprYnvdYWP9l?L~$>XQcAq^@L#2#%l7m6mJxbt
z&Vbo>rE>k#1zul_rGFP@3152>x>0CPML2iqua<~NFSC%`^hbw3)**c9%sj(=4O~K<
zN+z<mOs)phoev2V&EhiX&wH8rQJ8Deq4MOOxG8*il2uK~EcWqqNO18^R_amUiKB7P
z>Oy<pwF>{Q4|3bgrTDv&YL2H*ga@FIAmt;AkeLIE3psC?D3iOp(>mrq|HiU6zj&WO
zv^(?^x7-rWWet{&aYXHA-8@s){$BP*AhTC>_}L=!V$3|VL)1o$Sxw!?Ug?Sx+X(Hq
z#*jes4N7kHue_qpzWA0s;Vy63+supWne|y~+!lQ&%6?+z(~P3LbGJS%53#XP3T^x=
zc=xK|&$wx>%>kc$_Sk`+{EW7IPA2qvT|c@_cjStNMN+%Qx>~^la(Z}>sBCHnXX5O7
z)H{nhzYAcwi|_T?Bi_U3+3`d!A<<uT*+&^x!iPsr&yH5R*tyu_TXbZHti9obkoOJn
z01AcDb#Ze<q1f$E|F>bhP$=|Q3ee!mXUURe8L|rbGFg{wN;V^t$XCfWWIM70*_rH0
zzCpf5b|T**dy>7#K4d@g9Uh1c;)Zx3K1cu(ghU`o=mI1IU4rBxMMxRagtQ=S$Otlq
zOd%V{9=ZYDgghWG$QQZ;1wp}3BoqbRgJPgqC<#i2QlJbd3wj9ULq*UNr~oR2o<T35
zmlA~h`8)H$^KtVj^I7wc=F9QWM~V4==IiHM<~!%V&(F=T&u`*|DA_hZp8{w}fR@4w
zHAw*UC4g1}=*s}D2hgSfZ3WPF0PO<M?f@MK&|v@_56~$9odwX30Qw0)zX0e8fUXAU
zMu7f|Cn!n)h#5d^06GmI0RWu?kR%>*prjY^kR3&20Ym_h4xVtEV)OxIh$nbZ$P_>%
z00jf606;}}f)yny0Z=KP;7Osk0Qv_{u%OU80M+3MS18m7pe_J);|Z1&(+{9QJi&`X
z!vKQ<7&M+hk^mSSz_8$<RSKO17zKb)2beg#(7%o(;)N(hF!2DB3owuH1Ye3N1ehmy
zLJ)<X1I!CNA&Np30P_Y<2&PaKz|`Og_bBupU>fiQ9||=AObebsrcf)u`~a9g0JDxK
z#8Uh&!0h7*i4-~lSSmarK>}cp11ue$5JMp>z#@1;G=-P|mKjforw{;GHasDYLZ<<i
z7f%SFkPyJ0#S`vONDN@b@r1h+k^)$1JRy`qasaD<CxlT*1z^?igb)g80xSVf@S~6(
z!0O`(;S@3jSaUqVpF&muYmFyFP{<As4N)Wy4-HV{A;1>kp<xP*;-Nu`3<K;hJTxT%
z;D-Rt1aK;V9{@NGz|jDX1aK&Tg8=LgU~d552JlS)I|KL{fNcRx0<Z;uO#o~FU|j%f
z0azWt$^e!Jund4NPzECaivU;<z<dDa1~5B-PXhP^fEfS`0~ih9V*o}0>;b^;0PF_9
z{s!13fSm)_DF9~!I32*r08RjK41n(eI2^!t0UQ8eUjTao*bTt00CobfJ%FzQ_zHl{
z0Bi(cB7n64tN~zE04oAm7Qhz)Ou0Hy01E^741jq6%n9IA0A>L&9>6#NV*pGGU}}K<
z3$S|ty9Kao0J{RP3jjNVhbAaZngB4RYd<9bVhs>WfS3Zr5FmO0ApqnuKvV#t0FX-n
zkphS~K+XX~2q63bISmjFfB=9n1B4ME2tXi!90v#$fDZw@3*b!v{{iqafad``4d7n@
z9tH3qfcpU44d5>TZU=A+fIk5EJ%DQfTnXR`0KWwAa{xa9h!sH00b&dgeSqiyL=zxt
z08s*n96+Q2A_)*NfSd)006=&F!UYgEfUp9D2_W<U!2*O1AT$6z0`NY7w*kBk;8g%G
z0+=$>P6Buwz{3FU2k>_QcLBHqz^wpo0&oL>YXMvZ;5Pt%1>hF|eujs}C><^Yhyy^1
z@X!xRp9%m{jE8<n0GtEB*#Mjsz?lP_F~I2qoDRTg0-PGaDFK`uz)1s~B*2LQ+*yDV
z061QN;{rG~fMW$XCV-;{I4r=?0UQlLjsUU`kZpjh17sB-ivXDg$Rt3<0Wu7bet>)j
zNEbjl0MZJOCV(^mq!u7m0C@wDR{(hdaCQJ^4RDqKX9{qJ0H+6Vg#QNs0RR83mv@vD
zWx9t6a@kU5y6XM9yZV`$o(|JJ-QNJy(BvRNR4gN?C?<k1BvHbkfC<z^Oke`k#jps1
z2@w$#Ng}c$DCU3(R#sPCUDv=GaN)jZ&pqefbML=*&gpr6zi+yGs=n_{Mdfi+_NVe_
zDtl1bh02apwx`lknWr*CWs*v$j8W-PSwW>kWh*M1Q}Hh<exc$372i?u4HaKf@fj6=
zrs88N_E7N-6>m`SDitqNv7L&oRBWPRJr!%ISWU%BarTy}c!bLFR8A6Sf0@d=sa!<m
z{ZuX^avYJ9hzuq&l*kAolZeb9GK<J<xJBGNZWcF%Ta62D9M|BwxD~iZ;<m;;0=GGl
zLqrY|`I*Q8BHt7FmdMvcz9jNFk^MyW5&4+N2SnZ@@-~q-i0me^i^vWl+ljnDWDAjv
zMAj2oM`R6=CyA^i@+grNMDz-m5V@boVj_1FSxDp#+_vJ}T*fWob`<AcRb6m<<Mt6}
zv6^FWKfrwt_ifxaaChVG!rg(p9rp#?Ew~$T*W<3kU4#21?n>N8aaZ6j!(D=VKkj1O
zyKxud>i@bG_ZHk6aj(a{4tF;0Rk)YqPRE^wI|cU=+>3C>;Wpx4h&vqjeB5(z&%!+e
zcM$F=xF_Nc#61@GV{vZMOWce558R*d^5QHg;}ylZLs5s<Tb%1u4G`xVMSr}3;>;-{
z|ADl?JB0Tu-aqla$NM|pS9qV}eTw%9-UoQ^;=PHt8*eAxpYUG5+l==d-a5Re@SebX
z6mL1+gLwDj{Q++g-W_=J@ovJq9`9PbtMM+!y9{qC-X(Yw@W$X>h&K%HT)eaJPRBbH
zIRa^h_Z!~Nct7I(1Mh3RFYx|?w-4_ly!Y|m#(N#_6}%mIFXBCqw-N7Iyr=P=#Csg?
zVZ3E{f5f{N?{2&Wc(>u*f_DSn@9}2iU5PgXZyMfYyoq?@@J8c}z&jsrDBhWPgYZs9
z+K6+#ZqP2|C1e}21=)Z+gRDVTA&(&|kfq22$YSI!<WA&P<Yr_pavd@YxdNGvG$E6a
zi;%I%C}cQt9&$Ev267s55;71Ofb>OrA>EKpNC|0+6p&gZg#?I?802MSJF*qogsex_
zBCC;=$Ro%@$P(l}<Q`-payv2)xe=LzT!UPN%tS6lrXUw1<B>*WBys_A4l)E8jGTgm
z$Z<%2<Y=S^(go>=v_~wGM>0qf0f~w8d)*ojc|)9QRsAZ?Y{k#WA<TBnR?H^MddynP
zYRpQ^BbbLUOEC9g?!hd?+>V)txe+r5a}DMy%uLLsm?@ZxG2=0fn30$ZFy~-~U<PAO
z!GxIOF#Rz{V|rk^U^-&jV=N|*$zYNgFfojWslYgxR+#3PZI~^X4VY&zYcQ)Yk6~6|
zmSP^jEXLf0xf63M=4Q-X%ypPqm@6>TF-@3Bn2RuDF{3cUG3Q~<#+-pU4RaD^AZ7rj
zFQyl!8>SPcglUT@U}`ZbOn~t*1{1*?g=vjxi5$l4!t9nXEMs25yeZBNs=mbh74wZa
zH>&wroVkjBVtx~6p{m2;+^P5%(UwHp5cP=W#92`$S`cTMB2Tm}(XxcS)O3-shoTeF
z9z^>Q9Y}O2(V5~rqN`Vmvs`gG(b*FAR&||(Jr&mwolEp?aUN5%Se%Cy_Yl30=#%2y
zs%DKi^AxLzK0|b~IJc?UD$abx7NXmUz9P=;YF;DyD$%zjv})d$uuky-(Z3P>Uc#K3
z0}^HwKM?(e=x-9%s`-^zGh&W7Pn3zZA$BA&mspIL-sW0eIz^nP6ekfIOl&BzA;iuj
zHd37Rx_Xm1Pb+R9HlNr+ah_D8H?mT(h}gZvmJ(Yo&MNiGh&@bfJ+Y0%o+I`=v6qOw
zO6)CSdx(8S>^ovV68oOm&%_QA`-RwH;w^|DK|DshTAW2?;wj=u;<e)3rKXN}j(EK|
z52|S|&I5`P@qWZlB7QpYA>u62r89`1O?(`2ZJYO~pGtf(@ym$ox!kROI`ONB-$48p
z;<rlJPnYHqzmxde;=HHkP2%qp*8urQ&EJTBhd&kn68s7HWAHD;ABKM}{#p2^<DZIu
zBL4CC$KdzD?}^_Pzl`62UyomhpT)1iufm^<KM{W%{%HIW_~+vf#Xl2&5dO*dC*U88
z-w(exes}!N_#N=u;TQ39_-XuV`~?0CaX!{>UxNPt{zLdr;6IN4l-LV&b*<R*6l?I;
z<8Q%#S**4r{}r)UD_)mywBi%|eG-mU^%wllB^;;fYYE#azQz9r{|EeEBpjt)LuO=|
zL^BD;DB6&ylyIUdArY1EVpRzefrO2!QY5lsuTYgHQ6$lYL~jxUNSs7suvqPmi8D!@
zPU2h=7l_s7m^hEbD6yJ`iREH74HL^qJStXeUt*<LEqsZ`NUSFDwAdMHo+7c1#3r$O
z?LM{7i~YoYsA4mT7fI|T@jZ-%Rq!ml0Ncgtkij<4efYrYX`(x^$G)p#C%g`OBs@dS
zUieg;*HwK^RfB|Qm8t4ZRWAvLsOmvge+m1lI#$A?6~|C@f>=%7s*}WO@>YdZ4HoAe
zRcDIxmSQMX!>Afd)g-E#sG3jJ0;=w%>RqZnq3TPjzNP9QL34uE1Qi5^po*YGa4o?s
zf-4DT5?n^mL@=4)VuA?-V+lqRj3gLFa2~->f*}N_6P!kHGC@diJi!2hegsDo^d#s;
z(3zkk!5o4c2|gm&L+~!aTLiBYyh^Z>;3a|=3APe!CfGpmEWuiWrwCRNJWlWk!E%D7
z1b-yBkKhjkcM&WgxSe1=!OaAF#a5IF_7i+Xb!V~JGS%J0rWIYN?kiRcQuVcBwG>s)
zruurSZxowXGneXlVznAo-zHWoRP}tS7f^j4)k`D{)Gw1Tp?Hw$<y3E@dZ&an>R+XL
z7u9c2{XR*NP}3|KlQ60<Bq14)Y%8{f`VnHADTa|8O>(S+1JpE<yhv;-RhNrxshC0X
zYLaV7t|qyX<Rc^>BDsX*8j`C>K1Ol{$)#eO>sucnxk2m^sy-q45y?-*{)d{+NbV>3
zr8agonnZEMS0w*VO>1f@#C9lC<5N>ZO&v8Qv0A8W%3=$O4%Bp|=4fgrP&0*^nbd5h
zW*4bSu|vzG+K`HhJxA5qV$W6#A$0*My{|LX3?nsK>|j-6#h$8YBy};VX{2U|Jwg4I
zq-Kj9sOoxBy6f5kQ*%k(O6m@=C#t!P)FQFRtGY+*v5LD$Ehe>*)E2RA)o&uTO>DiY
zKZz|WUL>`X)H|d;6kArmPi#r?38~LXeJ!@Dns3E+QhY<|2eH~9QwK>M7OPp4Zb|w`
zv07}?x-WecN0BySwJ)aQVzn=(qok|Ec2<=X+ffma&WP=<Do47G^Z>DX*6HKLisD$(
zCz3uxtcF4QEYjza9!7cu={clt5vvs|eXCflc<Fhh?-Z*QFRiz%wJN=U^dCsyCpM{O
zF=;(y4X?CTAq~FtGSZKe{)+T>qz{Vy-u|GAhs1uX_>D{pvHvKOX(je+MN2Y{gd<e7
zk#Ly8C1WHUuF5A<Lq_jFLphToQxN-&s(P_sDT-t|=-{WSlUR+LOh+=BJgrsrB-4+K
z-t8A^`jZL8>f>MLWHKj`8AL`S;xqN<iv3hEl*}+Pjbi_*W}Mi+D8`VPNM@3R+7&WQ
zWUeH$g3J?Q*I4b}nbl&ob7xkOd4|k$Vzqx~o+a}<nU}<_v(MOPbzvu&9b|Ts*&|ll
zYUU%c_bWaivyaSQ#V)lv4rRU)`$xqWWd2U(02w`P?Xg+iB%P+Rzax8;SRJUc4%vuU
zeOk(jSRH7xF4;KQ8nSt^?a6i~JDBVcvgeT1rl7?%J4WoAiqT{zkewo-210h4gc@hr
zsbpu6y+XonYG#t1MfMi53&}1PyIGg+7rQ}mFWCplE)%;$&BJ81xxB3E39_rnt|GgZ
z>}IlC#lEVmTgd9&Z&kIE><+T8i`815eM{_XiZ{r<M{O0g)zpU64ic-+thHxQJDA$D
zsU0THuj+M7`dKlY+D2;EP^)`;ntJV7Co48kyOr8q)V?WJ`%djUVh1VSqIM6p`>5S7
z_89elruH*(t~kGx$r*8eQh4Nia%r&|X}MZ*mRytA$!abWtBp7}jog)DFHtp1>_v*J
z$ju?QKpYLW++E^mEaeuGTTE^#xyQv`sD71L4b<F9a%;p+Q?*X)6vflzHj169N{hiH
z#U^sw$Y~+axiq(f+&AQYl(37MpCr_b&mAClklY~&HGOlxk#8Z6{)2ogarA=oEy*86
zUMrhU6Ztmeg?vChL%yDTd$E`5YFqM}2bZbpDz-_{nS4+31IQ1Quu}br5+0>Ef&9tj
zr;wi^p{M=|@-xZLB7Z&k`Q+b~@JL<N#;%E!e~<iL3AIY)Kb5e(Vjp>(c(k_Eb)c@3
zgj%2LI#Snzy517%5!LmiuAhW$R1J{OQS_%yALX@n)af{{wWIEG>Sj|nkGciaEvD{4
zadd#HdrurKICbw(w}-kz;^+w!nu{}D*A7!?O~Fv85@)(DXDPH5=L+Xa)n|#LlTG1F
z3g=6x)w-Yq_SMcT74s<EOyN!mwVD?eNvM^&uz<q76dn*qx2bR+g{9)?85MNk)<7sM
zqwu&mx|fAj;^+<*R#MO>2|drkI&t(A3(tw8Sy603QO`vSW3eU0))eb0o=x#waW?AG
zP>Lfcj-@z(;y8+vDK?4ooc>`7#p&WqP<1)Q85FM;N29HHjW{|H7H3hMOL0EMMHC;P
zxLiW*!o^1<)Gl0HL2)I;)e>r_Dz2rtk>VB!H8F~tC~lKbdvWnk5^A3<zDRK=#SbZd
zBKCm#k0|PBrU733jN*QZf1~(4wjSFN+YNgS_7<#`vwxMbIwl@eJcWH$>~E?zU^k1^
zytM1FFN!^^>Lu)U>@MtX>?_zevF~8t!hVST6#EVKN9<2xHRtRB>_O}y>~GY!puQFL
zEva{?*Oc7hXdS7Ki?dx3rM`;#q&Qms>jUaD)a$d9CRTlx`g-d1NoAXww$yhL=T&F7
z>aODKQgo)iC-s}Cf1CObsozK23uwEUcH?O`m3Gr<H=A~IX?Gj#d(r+C8d}j%NrR!G
znua_L>u7k5hEFN=r8J1r5K3bxT|{XHr8$&tqeCw`JWt2LbbOzVKhg0J<yMpzQGSi`
z+jKgIP8ZT?Je@A1(;Pb8LZ>_FoTGDFI(MaWe>#6nm#gS<Jze(G^#;1FrrU11x2Ag=
zx_fkw(><VjmhP7B9q8VJ?mOvmGd-*6xrCmZ>G>MHM$l_Ny}qE=0eTC)OZ4te@BJLT
znLek{=WY6YNT09i^8<Zb&^JZj4)pCo-+uHRNZ(WGyO(}9(Qh05-lYFg^pDa%N&g)E
zyEO|-Lz)_=HkB@)UTVB}%8Y;iYJXXm((nr}9Y1k&X>{Y5k(W-KR+>EV(y`+&X(}~N
zojB&=X{DyAqy9?{pFDDEQ)9!-sS}%>_TOLCFtTa%n38^A+Q^9$|NW_vmy9iyyEc>?
zI<_yDCXT<b^zYA2n>1-+Q~Pp57k%%jiI<LUEX`~jHEQzI#)fhFh5t|2rlwi5W@pZv
z+^9G~UoG_YyVPN~S@YjDYd)f1v;X<y9zN{;@3m$v#{Hj_3I7RDO9KQH0000804Jk8
zSbJVDNUSsf0Kh^303iSX0A+G)W^HsYWnyV=FJ*FUW^Hs|a%E$0ZEa<4bS`3LVQr*Y
zdt4J&zE79|#v#X!B!YmC(F7I3BbXo{KE?zT5fpifC?O;R1oAQuK<$ItYN@xq>!Wr*
zajj+5+6ro|t<}%g_G)|W^IE&MYS&h)ZEd&DweEHI)^6MTJCgw?kiWWoK8HE;o8S5V
zzQ4ygXU=57(#jl}%y`^bJimOtzb0QMBR0rnvPOpYI$E55vzNEJolf56A2rmAv%7q}
z*Kc;YZTu*U-|w|I2mCx~@w=Ur)#7k8TdW;1ZjWVkfG2$(-b(t{c=%|(+vD|7EdiI+
zZ+E+50N&zijpZFYhK$l`2T`#eBk7wRcAq~Q|MSIq`A**J<Ht%LTiq_d#qQ$0qkSHS
z-ES62`Y4CnYQd%yyvt@Dyg`0T2S21UN*K~*_qU-zpLn02w-J8tnz&}W%Pi81u{taP
zA0OrR#Na4+ZHmyv++yb)wm9shIiwQJJ3an23QLQh_lhFA+1$zlKZ~D_YPOO%Lh#SW
zlfc|J+UE9yK{JN1TO8Doro&1*Emp7FjP(hp#d8<5kUg`-=W|;n_k6d->W_9>)->}`
zPAf#o%G*2nL5_Bpjqe8DPB$dU<#s`)ysbV0+>368uyl~kZrhq@2#>Xmw6<Biu_4;N
z7~lueINsso2fb@?xGjDHk~pe0U;%84%SMHIZf}&mCD!ip^R2v>#OYFm`1_zfT&;x1
zZi@+Zqx}JogC{yIUZpgTZm$`WQ+Wb@v&YMuAuvOEVulOi#Om}}EiQ<eABeczw3GL?
z@<Mlvfa3Pu89_QMK0gW*K~%fr?JfwoSz02@AcH}@s5YBIdQUj*uF;`!gJa^HZd<^?
zL#$iecVRw~`^3z!n#-P%3GvI+Wk$`NlQQCw-Q|E<w!veVgeI6^GMVym=rXd<-w|kD
zXk+9|kco<)!phkgwpgwUvQhCfSUG2?Q7YvX1*eJGbp&%dk<)GGczKhNkg2t&)kY)1
zsEq`xHxfGH$qjm4rBTnC3QZdldzu5@!1}<}fZU_txC4m{$*EPGUc(UvPE7=LB#Xww
zVC8-T5#-=z3?Pz5gG{+!MFcBA&}uZWN{%%2GP+<B+}n&KqwHnapa*U&Oa-%-NaTzJ
zsfuTn@*ahb<J2UlS8;>}<M#~VYlz@xxJfi>0GlL&eFC-yV{0(nVT?TtZZmcdMuS`6
zjT*e(ee}pv@;-&GLhuC4m^7T82%eOhd2h%KO~{R_!%W?{;|3F?7{Lz?8`d2m$aqF6
zKRm(!HAZTIiXU!*QVz30sltqml^EF_GIBCVCB#L`CKGA}s}rmdDjYH@amW+~9!Ij*
z!IBaLq){a!_7ln=l_XeGfi)OI5`u~3SeD@kuunweNXp*}QYlgKH(B}BAT?ez#OOEz
z3V;~00EwU`z#WV447ci((2)^FQU*pQVk3->F_Nqjc(a5O)4l-%N(eax7AHl;(+n%8
z#&A*U7#&i|srVqpVxdk>DGf*ka0;0Ylfr&Yj%8VZ6QH8vWuUIgM`MZkgx*wu;`Iu)
zf-{Ax6O^Zb+YHNK&x@5RTm*t=U<C}0HK2F`JEJ58WOXdyipWB2se~Y<0U}sA(SXJQ
z5fF~cN6BDLtv8?~eE~{PV{&+W>YW&e;yYC+MwTfiq6mR$lAz9VgH?e?O$&`81#T*W
zBUM5krsFEdV@ZM#xFj1;0>LQ>=%xgzG@zvdTH|-36k-=jsUviW96eS~C#VZhih33_
z7CL(9=-EMwYL!th1C!~1J#o+`u7*LQTKoX&YtRc^XQVP@e?pMT0HcXubRv_dlQE2p
zW!M23k;njK<`R~ZQ<H*J7U(2_4r@S@Aznk70))v0Xp*q*ph<~+EUMF?`5elsK$<2r
zMNUl-79liAO(#p1A(N5ds*FShVL)m^!8HvoJusiD3_^;trSa1cpr8p-ctL6esYZ|*
z2yx}1azb(_QnVbi>%*>MH=F2WQllcG#In)>UA3ZOm^q?Ius9=<Mg1^~AT<OjgD5o!
z(jwqd)XQ)|Dp$yEA0t{es5FFVnFGrj>4F78fB<mTLN$c#B%OjX>G3F?o`BNmiD)`K
z2~DF}lq#oEwP>o9o~+O{4OUl`hBE=(nc;K?SC%|HH8$T#wKB1SW=WNjo{X75(s8X%
zRd5~&oYf#8=0^%ZK}a|};<F-}(WsQ76&&el5v>$Pm>2*!TUbvv<Iq*mlVFM0NOCqk
zBGMcw(j97Zg(Qeb6LI=%eN&7m!Mg6)wr$(CZQER9+xD!n*4Vaf+qTU+d!O8glbnb8
z>+4FtR8pNzRed0putXwB@>c<scpxHnM9j(pm@JYjwoYh<Ix&Y>#u}gb9DQTlpEBe)
zbypIVSCc|2S}K59a8Q|CM8RyLV4~vHBo&<s#~9w1u+&H3yn-g)fSmC%6JaJzc<7eM
zcu6+&n8D&R4qg*7omEB<ubAV}3Ob%Ivw-78ohmNL7xLuF5G@Jd!9CPUmN(Di;X=M{
z$TKbc+X#1vtU#9?^vEz}*2|J9J|n={h<CPJXv3LOWsu3iJN8#as8KpZ=^RmydpSus
zB-pqNo0Aw_d|DQ>x&Y5|ltW8Cl$1=I5P0a1qjbt;0CWEvO~P%!JREV+3K1|JrWl5Q
zQyP@_ZGlD{`cO`vXhNY=9uwHezHBeU{NKpYX&UT)9Y!GLXgNEMhj9qObOgNMzr>O%
zuw9ZN4W)RVl!CAW7A9c}qu7vI$ZHK+mNv}&iuX;Wd68@s7<;53_Gm6b)grdEg7aXK
z9MJtf`gEepp~N#tO#1vx4<W=6HQ_RyghCc2Az`l1616D_eQJ_za<C^{<|I<aCMXRk
zq^vlm)g~P)&>!?*R*{`R+9U#p*;^<zun$E0EaJm;vC(t2E?L-TS+w;|or`Uhd(%_!
z{7Jh*;{qoI>ryJhGa^gQc#YmFqUd>2o@k>`b4;FW<#{K0{~mQ(bHmW)aH#T6gqaIM
z8X-+Y8HzDz{hKPWmTQeX0jUC?CP1vy67(Quqy@SmmPRQH6{Km2t;d3)(N~B$mbh2~
z)c5}$U}kZ0rT5O0=1TxrV?(OZ05(A9-$H<+r+dubL6ao?(-lBmiiA`uXjTYZCKP23
z%}?2V`I((VwB`!79VMPBq3hg7AIeu+!${%+rd7jFQ2wW-Vzy3If(EU}DekEXMqgLF
z=0f&~G;ubI1eY>V_NS2Y@w%P$a@3rquD6f046aZN9EqK-J}FueI8Xr-BBWVWvYb)S
zQ*V{74I~I#Rwm{4k4|`6G?fiO@HL{5BL_;95L0r#hhbB*3R3&h{OlAYv~GyV6gHvV
zqs^aqG&OxP#TQ9M=m7<4Qmb!?Qc%NERir0>6jpwiCN7?-Y^14M4>jV$I%^X=Ytqp6
zf1!T{V3ruU*qp6GGLIbmd&8DJSDEfyKy92}*8#9$yQ_mWgK8=Q7qK|NQu-N76{99W
zY!MVKfI}HaYFCa_l;gFarJ@AKj0C3g8%!GlP4660rVku8W0ahnF>kfeD=KzJXUY9L
z_Po1^J@cat0IFe@u{g}Ph3jOav+BXhya4Nf5NyE)jg>nCjp0f9t$9mOx|aYbvH`+h
zhU)QbK>R{ZBTPL9!2^>IVF(veZf|`VaM8OoMH92cew`Pz{lWy1vjygtsAhv11<wI@
z0ZV#Q37!aUO9An!z!pP28bx;*(RSJWhX|SyVy`O}9Qw^65W*Ttft$iW(83s@_opk&
zYmz0pBJrdH>je(?5D>i-z<AU~4^_C)<!KD%#>-;kAqtLq6$ngsl9Z<jnji<M1L`UO
z+9EV(onKMfk=vF!;ydK3f-DXSo3LY-?O3f<Cc;}!E2Mz%N46MYv}j9s2;;?i^?1QO
zApTa4-&76bAE9ybzIx)U>&~LgA~aIe@oQbi1)%X)(xZPIh<I=|lFmZZ^*E<{J6tk3
z(hS!mu9l~arb!>dB6$RfbVI#Fb%1`G&Kl)aA-Lcg;r}!VS0Iiw2~{9`uvtVH`4zaM
zt_S)<8^@y8sYU)t3n!1G<oz)GyQNS2&e!f$(o|M923AEZ-K|O(1vl<Xd-8=AeFtDh
zWFK{I<ev6#t#4zJwsQ#o_P+c1nW+WU_)#cophr9WSq;9SP2<wIQ>iY_C25ckT9)*g
z(fr@4JW5X&QbBaW;V#|pG`wR!4!wKu{c^L}2LGNuwgq=bC0vcY51c^ec2*o;J7#6y
zDt~ETT`?^XsYCPd5S$|C;Ya!H*LLXQ)}MaT2&=)Nweh|ZH^5g6I?u6nbIwwEYh6qI
zX`AAU`!^BNL+Eu0w{89GzNNN(5@h(tD~yJ}V;J0h&AOxB<K*0KPv6YkuDOlVz-_hO
z);o%H_txACCqS)ZA`SPwGH2?e>Sx(K*UjPca))L6x}FP&O>dCl6D`^m1LwdAyi=`P
zSnXT8YZULBS_2JYJt{-{ib?bQ3ETkf@nMTQuKN7G0xc(sHV1KsyPG0kz3pjgyVy-b
zcXF!-=X-BtqUwS!%|hS3L`AzIrcLqoNN%UY&*Ny~q~XNdxp}uFySt5`b?e7j&n55p
z@`eBVB5d`asuQ19)A_PIs|!5n)%s7D&t+efu3fqNa^%dn`?1<V#wVlWhkcdjMc*?i
zwwrgV$JNl&gde-3-1|RS^6Db+iAXwU*~}h$+n?%TQ{0U7kIfyvmKrBj-S1p$JuYVd
z*fx5fck8VO>r{@7>$7>C(oc$QRi`)3%!a34u7z!0V92!fENOb@;_K3Od*jb0`u3G7
z?rJ)M(eDy^KZ=UB_OB3jtZ$Pho)7*WnsaN)&!g2?f$LsBGR_t?y`LvH$c4CnMVC`1
z)mhS7<(yirXGlK#QnzE~1+nJd4_ApX4aqB1Qv99Wui0Lg<c(2sKb=*&Uy<Ek8hZDn
zS1bC|_pvd$df!Xv;>_%}wiG-MAUhUkr=F*GgGcN$UDC(+G_^glJ)h$PIW7%JVh`1g
zQDxXvR4;a4`N}>I&&sAJ&m%SUD$|{}Q%NOSMwyReWvBh?`zKQ8(@nB|`Oh(-0X;i8
z^$r`?`(j={9~0j<G4@K&Ht*MLFK^&4e2Jes^gN5-`1I^-*{}V@zgBNvEbTT;td6?p
zf3qIaMy4;<y=uSRea^R{CTE(Pa>|yAew=L0-ZDB5nMdFkbM2}%+WZz$&1Rmo=TNaz
zpqaq!()b?aeyCGUn;!6a8Lz9!<zlz?JZ%~-5|$?pa=N}A|21Me?<M0j5dQ3L>34FJ
z-|YIp#`(mjEg0ze9FqD(U74HPc(B&B@oR8Z{b(J)bMvH}&_0!YJI#Er2rL(0oM8VP
z|J-MaU(4FQzb;H)!L0yOD*JUh6w{K^+G(?{t9{)LRqvo5)nKKhJYLa0=zsH=NkZ1}
zINnIt+rGy@lk?TJn7SQQY&^V!Jwn>!wlN*xXFS+XXLOx*Z1=~|V+LkF6YCGXbeO-s
zV82F3L;7_s#oxP6RRf=CZ$Inod?&}&n#545g2ATr^oWuk((31ZFU;cuNz;#zUVj{_
zjWsuZdz_34Z()kV_Lb7wPk)M}U|(+Y`K*Or%_LhnC0kBJ;$O_kJ+oJqcK^s6AwR?w
z#mLK!Z>?l?)cBmM%a=31Jnd*BxqX_wxB1w@qsPKN_k26=1vOKhkXzM%{(eehI+8o+
zp^nga9-V^*1bSJq;Sa-(Gn0*visIJsqM_}9++fo$-3Hr#x_`XCBjxY0zt^fS-WdNC
zAHUNMHQBG{KH+z+X?|=qok5!4ybMl`YTT_{?ciH=+q`yr8kCR!JPekg@ilgPt&g-r
zwwE7_&{q5~UVSOo_^>)nMBRW#(rK;uIF#C3$5dY`EL=xLEz#1q=zB2pzG}UH)2_c4
z$5gK?J71N_*+2G1RBg%YzZ?7>O~VU4wP8LEee&k~k#n(FELL}7eH@y>_h4Nq<#PUc
zj6=8nE^cikrwroSV0Qdyt&m+Y(T&vg^Y$4JwLYtg)V&vN8skoz$zad!d_CKvx(cnJ
z-uJWn;dVJMP2dVXRSr0UpOGS_kCps-KQ2`Uj31(u+tT_zT^~CfvYi|!*De!|5S!tZ
zU8MVn0oVIzlxfyXnSFPe@xF+u*Au-O;ePJve$leNd-61Xs$TH2Goz{8Zu**Qkv8kT
zXs6#BQ0?+_|JDb;{`p*5z?bvoyW0H${tvwc0D$0U$E-nsaRZaW3>+kKO)$WS4HBin
z2`q9=C@=jA2E~bCaF+-fr5<Wh5jY;m;Rv>G&^~tHkQnHz{xQ9f4DvD;7?98Z%c+jb
ziS&7fbTBg${Nn`bG8cRB+e0J51L*1)alKE~?tVs^S~1Qv$+m^qVd^9+^JaI`d%Eo{
z%jqFIOPj#K4loyi7GMS4I+ysAPC+=`5xsOyPco?+-pLy9k<Ec_QDAJTcXVl&L|qu5
z4J&YTNnms-K1l}_s10k=DL<r98hVYP6QNyYQ$)5Mf#C`#1ihS5!mxFm6N+Aid49XM
zzfF)uCm6F<qF|3mXh76s)*(S)K=gMkIz@v9wm&KYDe3_;7#%w3cE4B99a7CW0s%HP
z-lCRdM$kQi0fHV9C%EO{A@7RCn?}s8WJSz^VHNJwP{9n*&#Sq<p7(RTrwML?>Qb=|
zLc27fpfdrnWlnN)7+{|b46!8vp=C~V^Ag@wp=%C)cbpn_r2l=n5mbs8ckDLQp`V^k
zeUyURA23=`fkzukb=24jxk((^*he|z>FJj}_D<IC**aeN*Yc!cy@U~+P0$Fr_vHxV
zV1jk{=_Uba0&;kdihL_ADA5%^O<2m{mzdNKRX+`(-qzMB6zAAoaQ3zfmCk`KlN)P~
zDO?p9Wkus&H#C-F;i!bIrDd!;M$xFGEK$R?Y^cc);#v^D7NKZCP9EY4l{YJwAw;K8
zMHKB{p@X9JFEj}s2EJgHiuL#WJ|!caNeTtJgqxx<W8IjwaMnteP*>l_71F)wJno}K
z3s&sBdf7~ho+U`MpSE)NZql}bkN|wv47PYG<I#v&$q+VwDuc(OL2P085qivKonYZ|
zQl^19eON1a2UDw<!$4yPw02qv67sf#q4%Z$td7JCJv|KclIpUcm|&ncC2JUEAL;}$
zhGvW{aj1{ZN_@Mg$>;}4mb%r?TJ}d_!MfpVqOndbrk6eX4hlOnvjH0c^W`$bRlfPA
zgDU$uH651dr=7ljs2XcktA&o}@+5_<KXV|0&TGO{J)EZ9mIgBc@2cVbx_nsM_{Z+d
z*J^4XSGU_jp*dq~UQ!r0HO5G86*fIv*00VxlrhpC85^LZ?5)(#;pi#SImEj{Gn1p^
zEO`T_d$=1kJ@CRJPh(`YR<5BBpCrB%AC}wl-*N%~xVqrLC6~cJ+gulf*;5q)-KT34
z_n?X_{~cXe)8=hl|5Q-#Wyg*RD(?lAj**Uvbrb<ekni|V0WdPZUWiv<i`gi6DnEq-
z9gCfyLLYeOD=&n`8^ZkmAP5+*qFKD5f&@YAXg`qci3?P+R#e2O&jipGexXFeq@Oq|
znhonueO^JyI=Gcq^Y-D&mS>fL`koDCdvYuc)AOAL`4=Yk=z(;kwZ;<uGN}!F`L4(#
zgM}O`L4eHX0-N=yx?g@pahJ|7s<o^!V7nr%wWJS_9S-!WFj}152B@<Uc1YoN*~D(F
zd#_`klvm_unqJjbRg4R56&GGD%&!zru)!gAf^g56s3Sxo69zP7Lct(=$&cL%<8;Np
zUiH!WMI5fV1|!$R9Ip5!#;DV!Dq<xz8<8?^dsIC`68{$DC%&P`peY;>@YzdzvH}E|
zT^*UDgJ?R&lA8r6@=y=_7oh;hq#FORRG^9$xGtSZkI(z!LL@3!li*kf*i{@C>2pD0
z7NaVq>eab7NZH1l@$8fjYZY5AQ4@7kgB2RCq12dDoLgDqS(dF|pkG@+j#aVNE~5n!
zUoN}OR*BY`fNE3I47zU%+;s-*c?3CiHv-;g$ZS1ftYCk3Z8(qYj&r>aW~BGQv<OZ)
zR)IDvrfj5-+ve3<6Ri}7wyp@RFPapw>wsQt6`L`lH<p1Jp%hsJPl*!CZHNIK7a%rg
z4V2a)mKx@=9Zar{4xh$Y<*AEsHzLBAF(!iyV!*LD>^<pJ*9c<%w6i1hEH<tVv4)rV
z(mX|&u1qjD!AV@5V}B1%LN@0xRTzPIGcpt<sWP(8F$u_kul-vDVuYwqR%IN8ZX8?}
zi7Ok@>)RK7?e-9|-M~f`XS`qka^%R|Y^vZZMZV%9txxK3U0S)g3gf3wv}t&sgVSS<
zmC%QWAHUkiqBoJVzg3d&L^XGhu<o2aFm_}W88zp|l;mbkx|o#bR^_*TTuq)rVDjH6
z0^85nn-82IQ$0>$2}~fG(%{I-f>{Frj)R+&V2G{KvQbi9K8wp)Jjf(ar-&f$XPiZw
zI8}uDsg4%1{IRq&`+L$-Ufarwrarb)*<NtW_OwB1{{3BLMSUhkMudy)yJY_aD?}r`
ztC5P3nvZ0HNtH0dq(amMqZ($K<iHo+yE$YrKV&&SWRZwskyykcX=a(I#$Psr;3lS3
zA4BT02(fpumrNp=&n`KSZMSG=vuM{>x;0q3<$=+ptx&jOxi~dhn%Snv&RpmjsK{%j
zGJ}D7L*r$z2uOQJ5<DBvcZI50XVZZ<h+(4-pJ?gH8?wF;ls|G^T4Dya?gicag4VaK
z9p2S)Xm~>#*ww;u)s?d5McwkEW_DxSzx~D*yKc+XK5z*l_Fx0N@ko<ww`9A}Fsu88
zAm}>NQf5g*O!mByR-E=xzkOK|w^eL4JRfjRVz1AX>tB(DJ@rw(W2!o`-$p_zCiP8O
zL6VrV+We73b@W^C2Fk9!K^zIT1}M<fxlTMjAh$Q-7L56CbKq9~a=j>{x?X&gCFu3t
zjPV-3Rqy%srU>v~%YU`<KOB5}7kBqq7kBgjExW<zQQpx{FT1gyT1+qlhnVK><$%w;
z25`V*+yZ<@1hHxdR^epb0^F7CiBqJ(zH&YY2*ieGu^XJI24A=1iSM`**oXnQVy}j4
zA-kxxsaLOOtIwy6@bMy$fdDqI0$1F@8}#;yf3C8Fj(X=Tt^j}2MmX#4Q;m0m2a37U
z!vP6)kx_#$&cK^w;nkqud`Ii8|7L=LC(FRYsXXh`+%PhXvG(;0_a6|3fvdZLuXA*V
z7}+CagM**rDEj6Qu@87X7p-$BK+X(<TIER&OBa4xbMZr^QNGBxDy`bf7YN+P9Vq_?
zH$mn()KMk@V|=F|r4u_eP#OkrjK?QqtjHcBN=Jhy#^bF~8wS6i(a7bPjvW=IEDLX*
zfmhAC1lCI=F2a)~GB^-KyuZgq^qx9Ye?~`wM@Vo7frl6eK%$ky7nr-oDFoX*<p+|!
zbYqS(G0d6ZR^;DF?4iPg6u+WQ?vuYr&zyn}37P!+f55Uyy@^#>(z}DZORaJ#TK25r
z*xdfRi8bU#2O)N(xVR$DsE<FS=#h+^B95qnhZ;Rz2%>^_Bz82XvQYT9Sln8+Nwsz~
zV7w5LDh}><6f4Ej$=pOv1&=uI9s>_Q4p3#Bf+G|@aio{P(qj+9XOwGc%O+cy11vT`
zaXw_#7<3SC0@14yxo+goARaZrvqto4bmca+?pzfTEy*398m&n@skmEgp#VoL;2sCu
z+Cf%4Z>+#`tHCH9xxh0AyGdM02Hp${Z;tS@d*zu-<=LIc!a)!#ub#CP=BIn5CGXrL
zNckD0%mVV`0rjw^28TfL3ZxZ@5^8mz3a=nPR(wBT>M{~H!Ic~egewvGYJ^;1_9*0k
zQMdu-Tyi67fri!v$*Lq!pWHqO_gHR~mQ~K6c?J2|CI@WqWgK~lMx6bp?)Z-)O%^T>
zR+fyR15;4nSe6z!cbN+l;N@7KKd)xq@|c}fwh$|Ch@~e~$ued2+%5_eR<G)G*$d_S
zXo+ZzvP!nK1c$1?Wf@Lg$@_yHG-%1a$4eQPw44Xw$A%&dNJ%;5Fqk4u<}t{HC6I>v
zfdQ{9(1j&L<r?+~Q??v1zf*H=am%w!YmOK?6Nip`2?0lTz^*f;Rd#i*2@;?emu6r<
z1wn64b$M`XR;-`^p%>WFGfeRnCQiM1D}fhSz$K=Kz%vZs?-QX{F~Ax#r^!q*ffrez
z&GRrJ47B<AiJHwz7UWtg>^k#Un<~_L1ITR7kf2v8$a;f&FfX+DYP3xMr6!Wu3=)HM
zeOd!0)U+7|M`qY+LpI^F4U*9e99*3_^e=P^=MA&+gj;yTiO@YUa839;!s)Me3S4uE
z9j$hv=_In9`L~`k(a4+DaG`_VF->~O#SZV9O<jATQ%NgpIE}pOf@i+sfz&a50Nn3k
zAut*)=6I3?Ue-2M^#CMyltu4w;oY3z$)`}UY7aFLx+awauMA4K!;jBnn>{|BCCI?-
zdQvg89J}@AIl!}Jw61YdAy%^jMhi29tk@CxW2jo0SgvvM#HLyri)L8&3KUrnjWJFa
z&*2zAE#K{bIOdRoY>qBKa@g7GPv)vI1PxlGo34BRdmTXtFy*=zlGk+94^8NJ{B{%a
z8ebWb7X<>MJBZ+nNKiU6?@oi(tjFMp7>$q$hc2i@%p>WI2y4<$_9^;J4S6b7pQ@;1
z0jWxQh4-W9Q-9b}IqOG0Z?9!MKG|bgvm(yr+r@Wbe0LlJltwp<9giL*FQhM%6Wq<Q
zL!M8MmK)rSL2s#?s6!Ngh$NOM?N34^ML#DUhVn11S0T&ynY|;^BO=4#?m#I3Kka_#
zT>1&Gb6Br9K-y)r#8xlES0fK@LZn$oYOP=SV!|S?BO0`Q;<b9!beiReDX~}wEvs0k
zcmbsXJFRUYd4e&T4&Bh1GhpuMt^f27qF7pon^-l1fitLnTsM$|NVW&4#`K?KRI7N~
z9clvjz4Z1#UW-5f{L830i>ntg>wL2@;ojBnqhF;)!>h<QYD7{aj2L&~h?9GuKF+D;
z)YTF7byI3;s*!wLQZnz=p}X5NKF+PO1J=aaGt3Rtt+|wlb*q>ej;kw{NG5bwAg<d(
z<qfJ6HeF!dR#^Y)I?!bP3e{ueNLrz5@=q*13|dpcLajA_JMd8J?0`KjB#dfUIG7cv
zU+8Ag3Kw+6g=n*aSgV^xzgmsl=bFvUphNF}<(YG>PakmQ3D<nF(D9_fGX8w~WYy{4
zbD`Q4(t{21xfKtKUbb!r@cI<C?LyXXyBABx^u3iwWs7Q$;O!E`S5x2qx2tp?Z1lKl
zu`0gU&My=&^%%zw%#X=s-u07Nh7Zc<8N2ZtMwz7}QBg2u(H-={gLI=#>O6=_^BlF2
z9h#>-;r>)?xDcB&&d&K4^%r6Xc{msDW@2ygyh9()=|5^uDDjD0{S5KnrrP0G-xJU4
z3nal1)wV7V6=i~uZ6(8QltI}65w-PtBJUjbNX{^omf6pHC`&O9=43A3&^&L_)Sj3P
z=VU&ic(n2P#hThgdN*v#YNHNEL9h=bZ`EQbADi)QP!<b(Rh(M`KGnQCyK99tR(wNM
z3xyr1s;h5?e(q?<`XyPtV^@vwo7pctx~VPf{LA>R-jT8F&nufOKgO@j@RL~j6wYnj
zKv;&yBfEN8{Yp~3lP`<(6GHV_4r5Ajz}gYA^oB0HqZK$1a-d9obg6wstG{%XzO8<w
z^~_E-IzoGYR<1m$Qkl{Io6~asAj&sgJL%Ycs)l4|2MfpkpAoP=jZ+*Ndt?e<?7~-D
z&!K*!MO*KoeYUSpD#jn%cS~FSYznkkH#);jI-J|CY`ouQzS07Gus{&&+!)+qg5813
z#NwUx;%bqlCton)WgnI>;n~-F<vcT&hi&N$?#J*7cfUxcbHp>_74{=XJ%5dBQbmr9
zaigG2+ptBMekEts%>7ok#htLGRpxfnIO$qq-%NofQ@7NmT!I5=)*h94MrTyqanG=z
zyD8(wIq8hfys*{(>c~FxedD@uWVgpF?*=XWxn%%NE!wF)^($Z<DtPNd_V=<NX$uog
z^m5<-6UXe>7ABJD6-YeBD^zpsNKW^%KX|0KC#v+4h<yEW?AZUM=hMGc|I{U*E>6)Q
z4`KRp*ZIR2ZVGp@J(A{ey->#2bmQ}m+OqhY30j_P&Ai(ozofC-p%1Y0h2#Blaln5;
zjGMo>VP0RgNxypFyQlH+#jruM&RS0!E&8N)XQ$0Q;7<AWt#h)3mv`#rpML`w+YO%e
zi}G#)3?6w2@@@dx-|+@dy%Yp?f<S!Wj{~~FL9O{u#dd^&-tqQNy(Dsz5W7AQ_{ksQ
z`N)N*KK@gEers6jy)Bq8d>JO%Cm!1F3j@9s{<HkKRiP=Cdph|Y{6$iG2C$0;+Z?r>
z%q%%K-n5I-3u0uQIL0vEU9K{rv)5omojAlW9^~*UF_y6!Ii92Or9Ou7&pgILwrI>x
zlmSfjeP-Ghv>E@fod(+!Xrnl29`E?dJl@mH9uhy__{<((Ir>7GBmUBfLlYN-Y+Sh`
zS_U5S>?4Nwg0W{!nJz2&K4JNUF_r*Y2i^j9@p45K{=%Aucqi~lT-=;7zW33C<7L@M
zh{Y|(-Qt0VNYH;_ESPiO17x41yaPFJK07DL15Y12XU?o|UFAct9yHVP*y}kY>(KpD
zQeaKaVYlb}Q3d&1_ioaAE%MM*k`-0SPg0xC6N>ASGEi9#QMD(Pz7j8K{5j=&GA7%|
zLSRqM@weytQB6r(Pmb94csLbiQ;ylSr<lVEGmnR#7<rjk+M;mFU)LPO#6|P@ig`tv
z18n6%?ir&S9%_U$&HZfi2ZH$qpoAP3<TK7b#+kdY)0_p#Y@6s4ccm8{&o8vMJ<ewB
z*UsIr6HeP4c5TpaZXhOFo|zV?oE2_v>-|@r*#|C<2k<-!wBuD;?||5J`dY*X&@Lz-
zTEhry)I-pEsC%JXs!?c9)L_>=&=;!FD3uxXzd7{x316Zsg!$+ZIrLx`Z$`t_8pqzD
zyQF}|^p5vECTuXJh5Gy0VDx~yrEmK49$7<OX+UU#dT8-4Oyb+W8@hp!6uskCFU{2g
zPfdDIX#GbIO^6i`uNsBi?tbrgs9eO({mErL!nJkkzTeg#y^HGB{7eO>TXP=r_$dC%
z5blveo7bOmBm7de;iYk<E9xO5xMYp3U6Gj%#eK&bS+V}5bhAQO{JrTlF<!T}st>7L
z0X6Bei=jOZ1*)OI+)mtFEo>~;wbjM129kWvmVQ?^Rs6k;7(c&j$9pJkt{F&I?-tuB
zR)upr`vMGXTUn~y6+GQpP5N2BL2IlKru$-#Kz2yUmHw$RgV5T)7h8dN3f<jc|K-x~
zCw1pbwMp*m>VJ6v9~)1Cjb7Q8TBdI7plp5@qbl4l+{unz+5c(jp=`%Zn|XX^8*1+d
zYr;UVFTV;3n$>23=o$)~)%L_q2mnEacLOPE8SN<Er8+_EYgydv_3i$r)=spz(THu|
zVAlz|b(++qxZG!7A*gZD0(rbg^{U!yUqLze*lLnW9oR*j_lZj#codfBMv~k!p!gjd
z{6~ie6&t+o2bXmu@TUXlbLR;2sl)R~Hh0T-hM{ZXWpl>`CjaI*<E}GoV9o2k_Yn^>
zeS5;qz*8PCeR}{H8CLHG+Ri7pWaZ{Um3ofp=AkM7#ju?MM(m~`Vj4V9n{U_dO~8+j
z8PN_-oUJgFf0mQS_7#}_-#*<N!3xWX@c1A+CNlpZ{?o+csW2<T!mThXh$XDL;M!!E
zhB}RFcfvk#pDMnix(`V8{_?v7zC+<}?b*xfI3s3*f7ftW7~#SG(r{iF8I@h*9%(31
z<^$tOV`(NEIP@XHuXs0@@e$&Efqd8`_bgeeVc!^%Kh0d^C$v`zt03s{0ZJhFM~<e}
z*7;nv+a&LC{8Dz>B%iQS?*?Z+{GrlwIIj-Hd9SQ$%6ZS+myqiy?n}mX&ph2SV*=v`
zhH+f|NwabgpR26yJFWB9_G&scL&z~6^mby!a*nD4`u611n>(8}Ln!MAv!k!z(_`@N
zODJ#y4b?>t@z@O!x{Z$X*xfr@DEyoT^w@nk`=J!PoyKF}9RUQE8hf((k!YHy54rjg
zX?#Q7Rr=4_)~4ufT%Vs1%ZJp)*XQ5Pv?)Kua|*)<!R|)}*Ms%(WX)UWv-QbuW2*V$
za@YH4VyO9A=dJkyD}moRCFT5Ktgt!Qi6?Edzt?5>5~EMono;pN*baGB16XOn(b+k7
z;atnzxp!%^e>1yi@oZS)5lInTX|d7&;Re**xs%!F{t7LUux@_7aeuzg{vjgE5%Cr`
z=E0Bb9*KR^o4)8K_t<)QJ9gQb`0cMdufh9x`EO13z`xcBY~t}>(dOV0Qi6H*z*&d?
z^v4Av`?AROhVl3=%BzzgTfDv}<W7Ak)*xyBN}X1>PhP4v;rP#IerT5LMw3k!KNW4!
zf48jAz6OuvSm3@!j=SXF1_$!f9Jk03!2F;i0lC3x5}${$!2HUxer6fpmHZ`XjOeLp
z+&P$Ef4zZGt2_HJvhPGB>{;u~%*OTJG-(}q`QD+IzR-(5=<~ezFXt+S{S;9(PV`5G
zeH>Earh7^;*$focj7FS_F1#L3*Mc6#!=-7`u`MY@+Y#4Cj-wm<15*-WlXWa2$+&4u
zq|8NW`@F~1XfMYgtq0l6V;ZB~iph<u6PWI?>L&G-hbd&DS`H}xQLZK+V)-qo>?jM&
zrY0(gVB}BP5WB>0pv2~hQ9%^7wguH~hU<!~{0pfB4^e`LG9At&0zZ@8(^!w`?<}>y
zPF}Mg*8vnrL#yLMmGq%9O7KrrGs#Rhb*YeuDcJ%N%-Nz+athql2o6j5>pByuNEF{L
zHv=5*JM?M{PbsMP=HKQ<lnI0J=4^y$wU5N<of5uRAp)gOYV=BlIG`TE?VVD4D=KYX
z#~G49f2dfg5^MC&=8s{K>2c6aQI}FG7}lAEwb#4^xx`yOWjUk_;uCKdjl&}nvZyjs
z{P{NZjPu+kwP|$mU<%9m{5F$-XT#*Sgfyt}vl(Sk!a8_Nv~zI0c1B{v=914Vr8zO4
z#o0#K(YKhES$BZH>M5`=2G^;L2ys{c(H5?vG}ktlyG;?NUTL2Fd4*f>6EMPHpU<6m
zgHoWsJzNI&dqqysS9iNSrLLqZas3WbI24qoygBBcNe@*=F;)#lTNCpnyz|BW_oYlr
zf>vFT-*wW~G24ejOF}GR{1C^PeGQAn9snl^41yw~fY1;?^6D(rFoXz3UK&|rOeGhY
zN7vU(2m>1o0FqWoQnY)udZXG%N-3#6Qmc3V4d&?ZLcqK`mx4LxHzG9^?C2k`b<OGC
zEX`?w?4#RnSeVH_;~MbeMR>_)3$)f%h=npws53F?^@b{b2#2#hGPxo;)?w33Cx61}
zXw!tvIWt{;R~EP~CziG)Dk{+F_|rQiux=aH5s+@1uTfB2H;#9~l%-%bPN>1i9f~fG
zgxM-Vf?*IzDC{2wn|MQv3L~52C{{IA)#`7!`<<~|ys|<yO!H*kN|@%*^S<eP&sts;
z_;2|C!4A6$x`YQ+LW9~N!7WhW+f*>y8mPi1=qmp9ICP}|!zROSSgq8HHgFY$OqHSG
zwO9rC4>r$VAsaaTaKspvq}<t7hkX;C?>YH246rFc3kr;la4uOE%%%gDX`#oyZz*lI
z87O*TS~UZOT<}SEOfrKL3}3zYEmsW9vi3#73nN-(t8c|bx;#41PY!b{11<yO%~uYL
z_W0FtsnFGUa`Jy8tMLpSeL?sWYzDtdeTnaN%zh)23&+GRxw0#z#mBd?DLw6r<R<?%
ziA6@dNo1!lFpr7xBzD*&U)C!YOo*M?icsoBBSCVF|HOuH)L@Cuq({bL+j819GHb*&
z2R)ts5NO1?f?do7^m#^Kb~6@y44>k1j{Pwfd5-}^8%-)@d^X0`;!tzl*O-eic8R*U
ziulq<a5H{_{@vlorU#C3eyLl&)i6EuX`XjUdCe8w^J}n_Ek=<of51m?x||E8#U}Z%
z%RO#!$nu)iIubn%|LYO7ZL`h78rovhbKP)1U|XNLTer5U=jFR<Dka53eq5~XHVw21
zfE)&Dyn<W@sJw!-1Qwxn6zxU7eZ)=rjfS0?_J*qIZJsZxOo>+}J5$m8iDcoE{GOz|
z-XmdEt+dO~$bJ}FY<I8!%H|_(jJwAw%fm42Ght0B2MNSc&KR?5UR4o>16K(ErkZDd
zNp1boR6h=&D$7*`=;HI#`|(O5HfmHq0~WVDF!y6Z1^P84X*gji%eGYGZnP1aC2xPE
zT~b3RU(Ri}T?gV!_bmu^&(lh2%C{HBnxi;Rw)){QBwAk2fpKB2fa`E>^feY^D&peW
z7a}QJE|Iq_)IOhb(rVJ8ZAzRvd$dj!QxV$;_5xzbsUGj*yV@HJbr3V(`TPbKc!KRw
z?piQt(swelE3I?GvLc|nl`BXo$HMr4E|w?%s-8QEWwOgBWqtfGUn|gB%G{Ogf0yay
z`e|(jK4m5am=2D={xc?{N(tzr2A4OJy8hR;NqB<FHV<7>AlDcWx4Nr;=~sW5&RJd)
zlg?>H;X<&9?4QobFh-6+Upp~U2j6E@Wu`DOD>vE1#i)+Wv}C`W)@BvImDcv{cACKE
zATOYQd~Ux2`e;fwNn)u_1A6QLigihKTq{40^(It9Q9P+qTe5U^HC8Gt%QC|>$KxiD
zIRd=S!<{z;4P)`}2c*&CePJqCGu5skd+~2cb4$URH{R6o#+;3>0ZV2sbp|cNT;(k0
z6xQt;F!3oqNB|hN1HtT-?cS%IKf(!eB2<Zizj$^e?V!FkTj2M0UbtQXB<ET)LgIl6
zOuV(O$$%l^q7^5K=(T7sIQJj=c^o9-7ovM38>L2)xX~?$gv={?4j{Ke6b0;n54uOz
z@;as6Z9?%~J*uXLMXRvXm?_lOG|gZ=GO%k?9tZjc;FtQ|-Y%No7mE2ON&77@IhY76
z*fnu2prF=ec`Vr1aIBzU)@3;ZU6a1k8z+~4g(5#cqO(3Ui;g(pxA<+FAMhc=kGshy
zHMfOuuxrU-6T%JWT*e8lNo@}f@HtwkBa#PH6JrBb$A%sfA>X^60urJ&sWHc%0+=r7
zA#2WCTH3i+PupHM{QS?GDyog^l@;8!{2P99JfDW&l{$0SHHZyRD9o^PG*Li9X^Gt{
zJvr|*$t-f*+<AY>1h5#4kF96#c3X=d+v?^sMzUN^7>yHutp=QGRO#b(v>uqvw{1@_
z$ml{f)O;2mGuE-q(aX+Re2_A0tcY9UI@{REYxqr2X8x>jWE1{*hHg6;|N4CV{$pA(
zta;?z@n^PJ=5H43$S#Vno&CCoy=Ai%gkpxqcla)Ajl0|1(pGJ}D=wSlRs!WjH_lSe
z;)SY(?OINE!uRtLf;Fp0`Aka(Yhh>$yXX>Y=@mldvRs_K?@1#oU$fWFJTgBMFIro7
zm(~7OPHxhW2jaS-OU+q9<n|$7lJwdDulAn~Qu~1B^$tDjQXNaWJPIlr$`E-)PtC=j
zido8~Ic893@LeGFS%)C*)mwk^P6KG})d9fR+faCKM-*QUFh39?h(3-0g<wJ)M2?V!
zT_Pk!jxdZYaU2kdK~WOnU=^D^_C}Fh8)C5FfC>sx%yGgIg3#Ge*F!>lcEtcG3WXS~
zMI(?J2;_xyLHujM7}QE4^al+A;tYlWNt1ktq4W@_LW}`oXQ2pkjR7vOS{O_|L#WKw
z-&`I!BN<mi#I#X9Be_Zic*ZqZn+RY>BDzBYP7$7P@;jpLLx?+aK$3Wn1O+4*LR2{?
zQt!Ip>9L}>g2&39y~I7i5xsa)NaRzHZUQ;7<atXWO(Uhq;Nz$epoHYq@PnTv4Mu)G
zRg(P@30;?gzn3gqKa|S2KDePN%jxsRO6nR~k?+9&Tk2%Ls!#?k0059B3jl!ge@mU5
zj1BGnzsku5Tio;HkJ^0tzK)vKdh)@_I`s(r+VZ+IcflnGwNm|OGOBcJ)+(H60(AtF
z=sbz(nxyv$$xA%_*pLTn3m>Ue7LFEi7@KSYFq{PxvBdW&KCCymPL!TDfdw{BWS#)j
zV?Y7?BYT7JU$uE^2h`hyok{PTn@oGNLEsVjOBj&YuEf&|&ShoZHB^XFDFTFa8`p`q
zyECiuL`igwwW`)5XgfAmZ5ne`c6~?e;)S$fohGduM@kA%P37uzDwGC0r+-@0sAM43
z_wX5%XytAF(Hjb7#T9n7?sAMNPqNG*I$#x5f5)6Tv&-6#q{_8qj+|1gfPYF$-<<!g
zL!6!UizH>bm23&AQb?mi4UxqMnsQyD)t7lQCRHCtf@%pbmV4E$tNe8y>D|~(ofxX;
z%9-dGq>ZJ|q%_&O)9IU{qwYAfftpsuE>Akzw_#A%VcSzv-prE{=FF~W#q!?o{@1E^
zEj^)IClND)a!uK>^!E>83Z<MAG<7@9jNEa#UAdB!`6iThGNT@i{El)I#wYIy8dc19
zS_Unej!V0SE9-TeLfXCYTC+1zh<xcpx$)4sNg;p9ecP=`dm>e9L%4CDZFNHc&+M1L
zfIC*3af%XO*yQ`1rkZT76X+8YBY$Rv938q-qQP7pSwy4h#E{aj+CkOn%)2Wy!(QC(
zGts%yk|(!Xu0+~UzmOmE@>F4AX}@uNV3Q$-zPLiRO=v0GVd7Azz4DK;M6(9$@o?t&
zHE1#@mDDY9$q@_ap#XEfY2;gHW*Oaji8G5+TU#_meEclgY;6$&Fw`8MQpR0^!cf)t
zy%mnMxuLzqI<0)Gk>XJ8Ji+jkrh@9%*>F9#Zs%_3MKP5ukMq!9sw39HE(j-)MRKs6
z-5{O(-PEsq5!1frZOtmi#${ORr>QcLr-5=5uqoz$Hd^QKDG4<AUF6zXv@*#H6zFyG
znI%zce><T;4~D#2qucAced++X-0Z}8?OU1)0ZA0C0|X8o^R#+@yzp<~3_1!tv}#>~
ziZQ$-^%vKgxa+j*vXDj8ab_@PfyVR9LA56`n98^89esrtwqZ}_dSwgPvG~=ba*%C&
zw3MqCX|3H-YdnJbmeXL4WXUbKzW^KN-gG=>uwk3GXOp#|@#E)SkVO`d2N{qD>yb_3
zH(8!Cn>~_NvmTq(fyxTK(Towfb?SYQa8-z}>hwl%TqRPIkQO@r42Cy&NwW7!#QWo!
zSG{*5>Kc14GHOIU(T}G=@*21@Y<*JXTbl{7d*-t)53w|ikh}vegx^6&KVows2KBhe
z?CUDCHpAbq<03h(N4$^?hh?x#5mMoIuM}ZU!7h6WWw4BNgbX>^*QO8;hGXTI=7d|2
zATmx~z<y=eiHb9#T4BRgsj#kFbs39^@5~H)ZcMp7mZG++tA9M^eZxg?;hzoK(4Ijp
zWu;%IH!oOoY0mF@>nT}4XAw9A2CG?;0>>gaXbj{peQrQh5e3$vqIg=wn1K#nW*9P7
zaJTp1KypvZ7i65TB8~)`Ghz;G@Pt+%4lMb?AmY0O(5}$pF$RVQsJRghDiS+o9QhPu
zU52|#ClyKL1RQE^CeFQVEQL#Y+uO`r30~aW+JHt|nJHF?hQTW$X%)_*$|;1~#7${t
zypW<pVtPhb&3iCzAq}aN1aw-j&iO;+;A&N5^bLhu&LZj>*tR>W+pJ$09rzc;hzAf;
zcWHx12;DqY;|#A*-AMCkU2Po~vf>SeLR2lFw7UjWA);EHb~3%3+xRR(RvC&}&}x^=
zy2$ke_z1-~2s~Io)5A~AxAw<LSOY*`41@+4h~wx!Sy1ceM%Tjf#8d4_-j>3Zupbk-
zt-{pWrbjw6I0b7E8VCH9_EtLg-XApE9yIR|C*HIW&d0tne?gpLcz5oP>40Yw;IG+B
z(drc$<!$dA!`hr;3y``{7S+Nw0CQ&_S~I)!rzO^as@e|)lO;Dnh^x+9rhs5`tEC;q
zy+j{x5kQMuQ;QSJ@5V*JjXt^N&EW>-KGKa6`I6d{c$bKO47nzLT^;0CL)w^Y6Gb?g
zYbGlpIS^1un6t&xg)Gx1aPjI=!Bv_wtaT$$J<$eNa`Cp=$ESAD7QqN4eA*^Ek;=Lv
z`PfC;82b<`8FHm?2Cu1rYgUGL5h%M9B&wxAtnPG5FxV)ty84-gW(=l=tC~A$^cPnb
zd;@BTABEEs#+^jsPO3mIN03w`N2Bk_W=I|RlP0b{aKU=Jer?bpVNu0q_3EYh@^?9q
z^mvXnZ#|Z3tE<<jKnk}jYUr`nY*V1yg`+1mZBrI+(?xcj^-30TQz26#_}1v(c*S5L
z7(|Kbt?JGXFP<(uD0klOH)ylDVqcCYD0VAQ$xh%zb}4nkn5S~7_0QBfo3E;Fn)ppn
zyRHJdzQGp6-znsI&_^)BDcGBY7I#)R?)<G!uNrao0B`uwmk`#e9hpo*SN{3p`&UnA
z=+M~XMXvBw-tx(7V7x7;?~lHop6lH|pFtCaxWL1-A$+HEwt103<7Y;Y^TN(f0i@0t
zVT9AM>$TXhNXopfaoHlj83+?>zAnxK$G~2g?SZ6PwU~&c?YO)I#8YAq(sa$5EGf9R
zd;V<Uwp7z$T8_`J=eE_`dX2?wmvXCONXlb5hYIyUq@k_f{|d1s`6TGHXJ+w>IDOb!
zN*?UIJTI>5y0>$JWz6DF$RN|)1z&_vey$%*<$f(f3*7Ufo+c=sA1L<IZG#0uo`Y`k
z#N7hy@K53Ha5ryyF}!+Pt7ZrAVhk<$p9d3agL14&Ey_P%_hBPj8n?=aVh2tk_*;!G
zPbCKDz&s8d0~woiS-uKy2MWE=;;uYgqdWUzm*g%vxQpF@XDxvXZua`;r#DzUFTTnL
zrtcj#qXk9OlkPN$z=-B!r$Y`9j0Z{P?82FKVi0t*JV)|kzzuo}9qqdQ%^v7pDuVRN
z4X^ok*$*zS0^CT#YuhN~2SIWRAT_fEf0{lcxiU#L#SerE^ZMJl5+(P#AsGOA0<w8Y
z<im4H&O@A_dJ^$)XmM{OUBzNLJ#O3DSb%JE2-kLWNPgUd%}c%>ixSm1*Ak|1Ao@(#
zijZDEG0!ykYK`pqyBj@-$&_TboPtpVKnoiP7#!0K6n=07$%p%vW)uL5Im<<;z=nZK
z>u4Uwa`wl9I~eY-klLysdnJmzLrg{r#wi3UWPR#uynIwH^aMN^Vv1rTdV`ES0lHEx
z&WNFKAvJ?#7p=Nd;9}3?Rbn!owv_w2L#yxI7PORf_aDB>oLI|%caJ|xtYRK6lMmra
z$3b@IWSj-n-#j7e+^x&{z6VYzo)$8)3G`<irTe<cvRJAJ^B?KExlJsLqSjP0<H;7(
z!v(zApi39lCki{J%DDnpiZI2mWg1!z=4Jj<poyb=WSqjdlFlFtTnkTBv!L=eUEGli
ze?Xu?Rk!B7h_@oLL?Cy@$gF4?>%D5gMaSeAVpqhcDhrB9th9h#;xt|?1mDda@G|F*
zEC|2eVW;r~c}JZ4SWJ&)h<MOrNd~jPS3NCVm}t>(wVS;^6}+bCDZQ07g{aBa${2DX
z#%067!->BQ$19JU*-AFX<Bjgc5kxiXPbG8(wH(2v3Y4Sm;_B}z_i#qRi?~ow*u-<6
zit2(F=JABt*m;6|kk0^ojl}NWl<Gd{w~~F;n@6IW##v&p{*DUT=qWMd^~}l)&1%!7
zA$Lj@p8n%IjU-tW*m)$fO%~tc7!vyd>4eIKNT-W<twJ=7K*e;N-W5BoFYI>Ds&TU>
ze0#~1IoM&`3aTD2$y5LjC2#D;Bg&@J$v~Ek;piE50=D-M(O!zQ6lZmP{R-~`JC-aS
zwztK|a_6M`>+bqNsbi#WL;+t$iM;~UEqWl(@x~C!O1Bw1x)mjkCI8otl_%o(o5@cS
zF{Y<TqLenUBX~CL<#b?{9l&Qnmxli7$j8T{jNVUNAMgEMM}HfJ*tS`#L>^uIM<Sa^
zoZ`X05Hv0)kZgN3QnwO7wz#Vos(4nVS5qImd5B>!dAo2!Qf7@Wgu{;!XTKT7a@51H
zG!tGh2gbS(!o~<fl^I0a#@Ejy7&}pcRTslp!r0kRW~?x-KV7iZr#mX8XoGa;DzWqL
zts(XcHC$sRys^dsJY-x>_ol(D+Pn};6ux_>0&LP|6{P1l9xpI2e14hgu_o$_W|9Vl
zX}4NTL;cxY!zT+aBdb@=)anYh&Hk;+$lx(U_LE6(L0-0?I`Y<^QM_3Tk$iNXcMK4C
z;*5re%L4rOMSsCG>PMq2-Che7h+(hn77<;PAW4O_30&3j;`kT{oqG$cdNG2FJCA1&
zjS&Ki5TV@g25Ah_R0t*)3C%i{@g%${p>g8)KOQ+g$li2CBB<|E99~F;cQr{!x>QHn
zc-j8R3j#H}nxiqpuo$|AaF?`$e&~EhbCL+zfO8A11*b{{<~$j|bD9V~+?PKqedxz?
zlyc|R!`uUqykZJeGs}0rBZViunLsyg7w(0-Q}lbdy5k?badJWIF&vXq4HdVYvzr1N
zvuuOLFIHJT@J^zbu)39J-bWvJw2oqn<G<77{DOVvaaVxxzH8(7;9H$uSv_8Zzb13X
z8yi}ISBUe?Kh^7{PeJF=`i)IJ)XOxdFF2&?7A!VgVJ{+He*#0zTn>MY`%R|11VvD{
zej0n>wy;Hp)7Q>uN#o%HCUw_eNb6Xw_>2|fTBUy0#_J+zj@&NbrX{1(qNjdDjhoi9
ztF`!LWP7j<>-DSE4`!$HkNS-iq7%|bQFNoB(HruArir|My-<=l+^gq(h2i<&EYc~|
zM0HKKFh?|a*sOav;vZ!$Z(G;Dl{Q3uQS?<)Keq35I~3l&nuh=2k175-v5{g8#(kQ`
z@j0>&Rf|Tx)w)Z0JxU4^exvTzbmAHFAGWy<K=+p3`3s?EsRf!;s+?wi<G}btc?DPo
zZCA`<yE7U3BK@xK0z$@EcI+SYVLLrl5(JF$)UY>xJb2l(+bSH8cBokh2%y&+l$X&T
z`9GbYvs8|_2no&;fYgVdp1oiI2`t5fZ=YuVR7dtz0~;jtIo<);E}e{&xffUE1NiYA
zB_6fYq1{~E@N@~9h5TA!xupwDQuDbWJT#UZzU6R!jj?W(aJi*XkRw4p=%PHp^VN=R
z->HLdJ3zfD4|oLBM_pi}5*^im^GJSb`&nji@rj)~pjj!eEr8}E-z>Y0gEatn37u(x
z#7HMUUU;dmG`oal6+o+m9yj1NX|Hy@ToE;(!6bNK3K0)CWD)Fm>68v{@<3PsS4!$(
z(SrUq)>C`dQCT%-Wm7c?56z#|Q!7@?6jxPK^5btUz`nK-Z-s4CEdeV70Z|Ws=jIgA
z6+WFG9iA=Jww}^f;u<m4M~{_ryX$W~g`eY|WmeTRHQV-Px*y)oGkxy--Vfz#^xnNU
zhBGJF^?c|QUX7pCM>eTu2F}gzbv8^K)SRHt>N+!JV>-^xW!9=>WN~TD+`rp;Y^5(F
zr84!wV8-7b{14`Hi3|j$<$+@*KXG=$A16}W6_&>dIcF{mdXoKg_5~$7<j40Ky-0ll
z5Yk$SovI|dd67=MJ4o>K6O-OMmrh)>2ieE5_L_ZwYh|Xx&Yf13t5VzWiE;!7lXOZ^
zL~Nk7c28z}?#D-dZXb^5yKm3mWJhvbOMZ0&ZO-5G2X<|#{;5KYDVcOBQKWYZ^8d8T
zsy5%g7;&>QGN4G{QEPvacTn3QATnNS^xKT~bn^18#cf99_*7}`^aF#Vhu0LAaWnrS
z^c+l92j@sp@>2Uo&>Y>*g8jp6Q3A|N<VHU|=g|!4oE|af-a30g9~yav?%-B7W^VIt
zX1<6mF~47$R`N9?QZIFW=Lc|WUz+@h>QSn`yZNYkbqbO3CA*NqtlJR-lb1IB$Dusk
zdIALQr%lgw;fuHf=uI`t%@*L(b)`OIQ1W@X7xjRz$Ct+cF`+JP>_z{1ve{oRo!QRi
z_qDil)#2%THG*%i`J0w<?7{o$z1M%!a~mhGLif`*^IheoOo!R|>D2-*M}NcT`0>o&
z<7N9JbNY90Z@^35*`_!@HObx<7T4#zwP{mt_485QctiW=OP=r3`3D;R^Ub*D`{F#{
z=lw?cqbL36R^RVw2;A@P)GzDC@5TPlnEcP}dDOrQulw=tMM?LsFJlsO*ot%K`{i;2
zFu$FgFPBICZIl~aLW>(Z-{$*zgPxe%+U!Kn=l_J_{#Qw5(qhJuwDAA9`ljGaqh{-5
zV%wV76Wg|JP0WdH+sVYXlQ*_8ao*Ur&6DptH~;xBcJ*GpZ@TKKdUjXu?zO&%a+@lT
z=E+MnPhYCm_M$gD=HBLgj7=0ymqjT!7FhP-D<gE<%y~JO635a!orwla4sw*4F1|8p
ziq(7pp9XS=AFP!$Ev{9JtO-u*;`a|<P@dxCo~xhydv<#tO#`jjNqZs2IL`(=+6RlK
zu;rbp;S?3)whJWV`w}F*3(mv_Q~Q+vRIKGw#y2ODUuJ@)c4v}5dDsu(J?wQtVeNd2
z%I?>gTu#%)lMhrUi&f=<d`Bq9sZ*x0Q~|zL*iMn8u^u%)n8UKNRK)!$z^Odq%Sq+A
zJc;<!pcL9<H{mN_a<bkP!7U*rDRSK+QL6X?6YTLQhr?6_BPFbr4w$MR#3T@kBjwBK
zqP<fHJqmF=D!i@M19lW<V@i%|Ct@>-zN&8+`}|bKL-yo1-&%g@&A?Bkb%m9;32UdY
zKzxj!8fIVSK{Cdvcc}2*K43wDFswa%$^W6V2I$1C0-sY+Sl9AOT7d&-9^ZfazO&(|
z)rz@;ZM~0R^#j#sp=t$D^+H=ZZWD;fwrf*3){0O>wKhgG!AsR?7Yj_}=PHXCt+?m#
z&|j0K5jR;TDlO~T%n3{M|L_9*57<E`5I_l`7`>}`CX>Wr$SSK7Q0jw_1Mm=ARkDoh
z70Gh9@WY9%8*La3wH8z7C>XN}l769w2^TZbs9rRKK`QdPXW~wAwh<%Pl1!^rXvhie
zpOh-D21o0&O?HmzGaa5mn|+|45DEEYTZu~(@6^;gJfW=n<i%+d2oCYpc-58oKe_z%
zUcs3q@KUsGVwY4L;RpCz2SG-hE|<C>mhWLWS+L-Q_&SziM&ew|t07vBm;nzL_nFD3
zizwED?bI)_6cJE?u8kRIJPGGpf`^#GCBBZ<adPlTXbKHtI##F&I;ymk%0Z$eEoCbx
z38}*daqr68;3x!3l_#UO4sJ`8IIW;ceP;keK8{TCveX^o9V|V&>c7Wiuq`IjCzjF+
z&K;?y59zoZ?6`ez0E8xs)*X*=uJRv9xCnVf_oOq-{DHnP*p-ICuaMPnDT-TpN*o@I
z+VHP<tarcfc~}QfJk@A0=I}odW4c#z<xRMk^Ua2x8S`*yTp2;^D$ld%l3eFWsEMED
zf#^X<ek?=VB?vmg47M;nSg72X$}{e1W_i5y-`7T4%wCA{xSN#LtsS+GxmzdR^i>Wp
z@38}Lev>@1`ID#5p1YtP4d-HUbD$w{!-@%(n8d>EpMzT^u>QFAVHR$n6XtFyiZu!`
z^>LE1E10zU&|X;CDt>XjsxYCV|Ie*07@LRi_GAT<vux39^q{y#h}}rehP`^!yH;l2
zdf};Y=Q1H1FqY`iVzMZg<*H-kvD@p%)x==~-|E}=_nZ@LVJ@?hgF+dI@JN^INEZ{q
z)5wss7Yt9`&K2;y%oTRPb=nKay4eUB!FL5D>E~NpZ9(d<>Thj#>Stk5FbwbZS%rF4
z(q#OAXnhLUfcmlcsUtCIInAb8{=t2aSrQ~s>MlIpS7TR2ftUCIo;gKbO?gNgIPZ`*
z-rBL3blTpTRRL!Xs$ZE}#WUoUGU=G{7(|d3g(jbR@BFi^boCddMguoD2m!DcuOk=C
zDt2Moa6#b#M(zIRYU5*&!f2?It@eTAW~J6^`QqrJS2ykhBeaJ<vM_vw{IGWANKT%F
z%raCTFnKup-U4GR)&tu?ae74=6Wk#S0%mqbhzH08&3g?Cg3Z2Bz4U>^MagU_A&H1s
zL7u?zPaD@&(i*#zNM<*lJVK;mvwF2_I(2{;7zsVEV25CcaE|i4-DmFahbZZw<8t&f
z1ATO~umJW6X#3hg=8!JwpGww>j(8R!oA{%*9R0cj5fv9XhfrOE^5))kQYC`q-_ja=
z_a<WBC}@ww)Y=*#R-zNAKw@vNaR+0s^P@}QFE4uIqbq>;G&XLVMbV16zfS5anwVhc
zH9Cjf8WH;qR!Gk7!Y=%1ak-F7xFLiTxe1cI$neMGEdFe0KO+&Sf)(T5@5}HE1~Mny
z@gy#!WT3Q4_B6I}JH&@H%7-w<uNo?9+vG$?&@5UkrGjL3WY*e7x4T62^D@jhF;vXi
z+3+dGhoxS~<j*B&>N_Q1=)NO*;yCKghmv9^7{yZy9>dQVEbum7tFC|94Qta^7l#`~
z9&Yh9VKGY`KrdENt5und$IvlKtBtG0&27-eW`3H2I2s|Ml<GLxxv>rBB58$O!g^>&
zHWL3a7P);b6IGZA7Tf&@XekkFX&5Q%kVtq^aH|MQ=|xf4Ty;2TxK6^*1@ysqVjyxp
zHf+1Gx<C=z`l-DnrKP@~R#MNd5@!YfwMYKSYaI=&^|nfG;hq&**jadS7U6>+J>gJ@
z_n03Em9_`|v4u-cCuhOJEb+#^YU*~n$e(}pfBv~px*6kZcyS^dmP2kIrPyuc9eFPq
zmd%>ZU2_{md4E(5m=LJXGnx)4ZJ%-wEqZcY^p-iv9!SW#J#TosogyabBRgo6B}m>6
zSkdENGomxe?6t{qsWC6FRIydnAVH-Mk;S=_y&0T9wM<bWJ+Kv+C63w#w<3QmR?oj=
zw4ev~!EHR=mj#-VlxohY=tQa-3a_6@7P{C~{!L^VD1ASPM=%w=Fy#H0h!V4l5+htt
zCy_G#;rlRr<(dppSV)FVfDovZsvmu7*d&hx?nuTTuLKD6ZtJghazunyNxu>YYO9Ii
z+8gfcO2pebl!DwzgD;mlsbQp?^rINq*N0tGnmn_V3{Q$MBI|42Zcd5tnKhB-7Z=yf
zM`OBPOufgO)6Lc~2UEU|*#>{HSjN>yUq`QEM?@-S4WUj7zqD_S4iSl}%OOcabmH%K
z>4k@n?!u#(=<UC4VdLY$#2);K9__C(!$t|Sr0i?jsC6ZV?-0f#)8&k9%OhH+hI-#;
zizJ8*<FZmr-A{6e9Yo~faUCTeL^LU?_iZo^V=8+d9zyh(<3)l{MdjHCP)0-$z!q78
zN*5XV@Yxv5>|o#3u$TM^loD7`8f~3&6-kSF_n5_o`^Ad^5P5=A_&irty=any$|Z~9
zMlHYFa9*%f>iANu1)DK0f;BQ!RIR+`s4UhhEPI$amPjo*CpU6rfJyQi%UPHC+$VHZ
z4jc_sFd;Vx*MiSbpp-l3n8?wF@=5M97y)-NwQZ+MrLm5<%d4qs6Ax-{XkJ=%sOVi!
zM{Z>zb};F802{$ZQxs-B=%_1%$u3{KbW<&lpEf?$ZDAK1iF3$h)DHQR>+jM8!tv?=
z2}dapBEef5vNi=*iL_%LCES1wrW*iiH|P&iUTGrJ!+EslEcAF2#BGUmN`|fl9h;<>
z`xvMwy+9pMrh=m6d!`akc|jXzypsFFsk!Xdz!%fIWXa!YrwOAaw|VbzUU}V@J9-Vp
zB0$Hya|D;izb6X(+HD8qvnCzn^B47hA=__GbMVh>l&05c+dcEvnB0K(<;dviV<Q$)
z0kFShhu&;Col|q8&o=u~ABW}uSIzGIs>Q2N9cNw39!)ZjuEtYbYIXj~8ZnUt1-qn(
zl)~o*Ske`gaU_waQPBGhckOPSoYbotPWmkovtqAv%a@#B%a^;No1>6#BQ<}EC3(l7
z`E7Pf4;T_l43fW%Ra|hfMd1so&>gv@{HOB2tano{`OgLc$}rm=c)P!qGihwXLLuE%
zsiSB|U4cp))?CG2eM*;u@|XJOR9&?}+=^;O>t22Uoi2bqtsN6XFADsLz8uE$6rH_S
zwk6)lYZuvmHwPC&n?@;d(w`B$&e%rq0rmMt+xaJ@%<k!ilQ*)=?(ae3D^hj>ah|7g
z>pJ=^iCeLcWQ&O>p;f$PX5qG|^lObe7(X%gomy4aomy1#Pa1Y3mB)_?4gA>g?p}2U
zxc&6c0K-=(n`sn>W*vb9BF9h`4~bRvJGQ_*>r^E_`gDQdW&=vwo?ki-OSIY#9MBo|
zKPwT*ZxGnRH19ZUtv@MR4(+8E-{n>^dT`7qpWqg~dl<zw?V)_1-~zTjjJMtV9JinR
z2}t>Ve)q#`25f-|{|7$vArn3O$Qbsv(78R*6A!;)9-CP8sL-qtFAD4;PtYvpk`8%x
z{!P?4n?BK$saOQ#t=INL3~$ufnHGX1xy-rV42PRLauyVMLeBzog?&?;I>Dzyl!)sZ
z_LGPD8Daf?v_L_aW*M)Uz+KurQgxF%4;oeXeMS)7+^vam2?hKu^UE3KO~`U=SBNoU
zhD#pPyDvyz9bfU|r;XOmuL~jD{sfsM_`}=<^r>yXTMl1UsK6UT1l={F#4_J-MSA)s
zUePjN=;r0QvUB3_N@XUa6_KKnvfOi~Z{AB42FgTjw<M$&;Rz9|E}f*rfrc>27e#@U
zn+1_mNb6#V`qwq~${vD?`kSL&d#@Fl`|f<>i^sKXl$%>=vVyzB@F@-SSr3weyXNpI
z%7|lLlvxkDg1Q$+%~i}beUVlD0dQyi5sE)QxD`_Sr(|S|j;f36Xz&}oM|9xsdOi?s
z_F1C_C3&}$Cd<%1RF!zQ0+{WPe=oHI4|b^$K61se!hOA$YEZm2CUQ?l++aXoVO}uV
zXT3E_IeN{&)58|K23k4h(!xSu{)HKhlncFnSk!OB5~(L3;Z<3F7=>$9SrX(WsU!k<
zs}5Hzj^J2c2dtz7sbEKl)W50a=UlmRXNeY7<X8)3lFq;8lFk?MqsOyftFSBq2XN*8
z(sNiwx=4|W8yK9KK{ak7w!NH5${Loqd(3Sao(UHa>)?B!@Qff;wQ%Hb#<!k2T{;cx
zUZw5|lKXk$M0lg#FUV0~Rct=YZ6Lnj*YNUq;4=;ZWXXP81@CWJw^w1wIuKbBlAuQ@
z7e8+LCrK+{Vop#PBV+>vOWGbB-oe#}rRgfXL`U{Rqb-=dL?<Ve={-d0dD$(M&x)$}
zxCC%lg5#7$*2}%%#3=RQ<0}4!3x4b`S~KC#&-&gZhg72(HCngDRRF<(r|v<1s&Bk|
z8em%d70ugAI&E}BYGAES%-4Pqkc9U&LR5dmf}XLKZ}xY7QW2uPkC`-Qy30DC#SwED
zu^ccpgg;`dR`L0f-8YY3+SbpkNuT~mKlv2Qtf|wPc+3;1JKu)#d?j<e2Fo^gci~@K
z;v*D=o|Poh01RRiYN*U=5{5koU=QqRi_Qx(hryXCVPGH=V!`kJF+tw>=HXaX&69|$
zEG~*Gp7p(5X5fyL_b5nLXe-1a2u&MSTcsvvx46M83QA7$i+*lOmcc-7O5ls3E<+9u
z`4L1+gMM9IY(X#SC*4}lv>YbkvKyvNd9G*HEd4&C96=Ol_m&UwV~WBG#bbmr+|4`i
z+ep@xY(?tu=lb*cD0wTR#XQ2;4_`;P3m=(dnktl;>JsJr{FC9^aNqY?5XirbfO_BO
zjei>CyZ;ITop|48*h=CvlWTU-_9_u*|CVsE<_ivoY_d8a{{D`_IYAKOtraPhTLjTd
zdEv9F(9d6$FHC6Utt{te{m4`N=XM2uuQK71x12lTl2-~gQ=wm$?070^8^8WC&vz*!
zA-<NQp1hnAh*=|`P=P0zgh%&L-&2++;2H$}!9+y*YpeGF@;iu;?;t*Aa}xvC;|g(8
zrt^t{B>%qqR+(BIY8SW)pe$Tcx`uzEDe_d134j9bcwmGyJn|aQ-M=cu4tq$LMP}}i
zgAR!OD)@@1M_2W4N)t5TEk4VqS`|Oo&i6_cTN5e&<%&_W1p*!a38=WpQu>u-^ba*3
zSGsD`?O67z6fIKVKOT~|lp3Z;P_=>b*6%+i%WniHuBj+`l8Z5^A9#+-Mr)$6O0G&j
zCZD>N3itB<CJ~78KU+U;LcutjM}{9lAe?x%EPuadT_{IA(^jZl37;w58ARZI!toq0
z1)~0*y+)UQvgA9Y&K*aWF@-;)SVPNIKPy0he-!>V{Ri{jsUGv%DKYZv9o7m|AWYkT
zi}LauXMKgG4$2LQoAk)-DcXvB>J6uX;q!0$UcvM>m`rq*`L=t?2*qx0PE7Rp*R>Xb
z+3KEOYP5ks8^UJUtay_o|FoyDn2#o&Z0^I<M!b*C^eGNCl_s(-Ep<%_dyU#$Y?FD{
zg@ceO$L-8?g{|`H7k>Ryur+?`h5!^wli?GHLetw(p0?TAhZA?Y)c0PMqs0p$@%)p^
zP^fc5p!C(`;?u+S3FEK-#h1s}XYSG;sfG`MT5goSX%SVDm9IPQz$oWk4~Cq(gLmGn
z+TV{~orIjtUq@<0jbFIYA6Uy|exMv2*nGM{@Y`6M!)N}AAF8vU??0OR;SjeW*4N+)
zT0Dew@Yuhw7MvGe;OgjfVShY9bA!dEn+|I#?L(A(H<0w@GPqjDVvHA(ad`_>bMjj{
zg5^Jn$zDY<A)bjH*6EWWo(*A#Js1ZLcq+MSV$p@U2svwFg%7mHpV$3T40GxGcG`S9
zzfIXdyCF{%T*E*+@?PDqXT&JnW0_UKOmQ{p6gS;3NK77k4{B~74AlEXtHaAZ^6JSL
zs)bk!PpL^Tkx22U#1(jW`5~`%T>D;6DayE_Iy{#;ZSK!!nKOrF20#`Fn8dXVr#Ev|
zXJbk<N>5;8;qSBV{TyFYmxoG=yJBS2&U0#?(WW%|YA-Eoy>+SJG^1KD@NsJg;Ya3`
zhuYlr*9PuO_kNS6u4r~$;|l$J)h=VDhsctOq0({vNk523I(JZBk~55kE**h37TyML
zvrrri(i@EG>OO1~sUCJR;;*|iaPbdq7Mh%OgMn%^-|oKPPduvHu=OPHPdu6J9;F!7
z?bgxf3Jtf2_od3;mX~UroYP3iofS7gugD{_@xuI{vg6Mc89RD%`w1!yV_s^L#`|5c
zXEs5Hl0JgjE5-LTHlveR<H75{gr%?^ATUo6h)?Mt?IjvX_O8VyjkHjT)Gnf^e%<m7
ziPh2((hQ5S7@oWSIz^eVJ1RJmyuO2V4LvD1{bmxM)j1c-)*_x0y9n&(Q9$06n^CGG
zIxjes1Xig1mhLQjja8`7Z*M|tSrv*C(Npc{-(az3d=|{>Rlhi5vl_3}DtXUn&g3RC
zXT|9((XPAcKFnrD94^aUUvwr;bLz}IAnB;?hfdw$R~L6i<MAcXC`Fhs&;Te+EV-oG
zsywx0wSW(H$v-ljP`WKD)-&de@3S04kMHavsw^+D>5bl!^1X5BOn=6luGo`8q2Isj
zOiF1@`&M#?=X@-3(>{eBVF{Oa2^BwvZmi(_WS5!VoJm5sJVwaIMnmuf`{i@<(uVo)
zMR9R0*D=6hBJo6lw~@Jcyjf7_73KPvy0N0Od%Ve92v>DXuNh^gexGV}q<)Wy&pgQM
z4i}sG#;b`H@YSLY;H34;RDN$Z6|;|0zh?&&v_xQZ5!j2N9BmGp-Lva@VxY!)p7d>1
zMS;u8UJ$G;Z1$Br##&fiA**<WrLXe%1(kQ9nOl9?$>n|3xFpNvSz!0Tg`y-r^YBJ)
zm4`l$9qNs;??I>jSaY)#xc<cle67itNO{sD_&1(<Tf@<_ePmr`)eSdvB?<Ls|C(rD
z5#ZZyy!ZvB3owmO?E5Gkdie@I6LEOj$@~IaVtL`z6x-v|?%Q9f&>M4SC<%PYQS6J}
zoRsc7Kj&l1jN0Lod=376%_sSMZECJW#CM#?RKnd8_QQ02nNh>f{?EhHthlC5)m5Ya
zwGS$CHv>fQ)tP^t9cStIXSEp>zPEvkg$>F^>#S@7-j%gEHd&U%UH_XE_2!>Xe*V9v
zmc3A-V59t3d9p-*UcmTtB<G+wd&ZbOIrx-biA3@2gZ}t{ES19SeSpOF1V7#E{7Th0
zHV)YsicJ5tI0pMj+<^txQ!dv!b1HJhOmT);g+#lq{G9J2vlGVDg6=D6M?I)VCs$;R
z(`7+x)%>e|#dDCz&ce?>FsMj)dGyn;+V4w<d*B+1AcFORSL;{BwrD&6`BS3ddl~z@
zj(t~1m8S&6(bQP+K9r8yj*aT;{=HEebzLa*G21UcDzxt3Q1W#;Y;`s@JSx?Z3fO!l
zX#Blh^CPnz{*v5`{z}m9ZxbK=Y83p;t)@TmTl{B@M_1tu!ye5k(s?JaXN_J2Oq6+k
ze=8omyGk2f%$DhYd5WKru_7kDM-2{g$njBtWU$qr1BFWtk9XBowwC0uPMkW|Rqon9
z^_Q_?`E#GP;2LPtcyY`iw4>X~y`A`)+^g;B)oXB^@nuj&`|I<EhOWDEGut+UHhYXD
z*mY)#UDs3SlG~@Wu*k<gJMR3SZR^5J;*6eC#PG-+jmmgVVcXBj)o`L3()^2&#e|Z$
zhhy*yIOVW7qn7ImwdXhaHGclZB4l>a$v2NX{jo%Tb+CHgPff~;@T5S>_rcp>Ame!X
zAhrO^IGIxLYXnw9SjII>*Z2Y28%dMGc2j7Itxv&TX+{^~=IT>~w&WgAVVj+`<L3<w
ze(80jD|Yi(^`$~7)9)yqMv)+!T5l~mn7=+ab_r@P#3{5G$aO2#o2x<cdwQX0KK=p=
zi4zqBK0T?qy&YADXhEH_>~VUKPh|M}tu{4f04swuK#lwQc;YYi#1gzh>lqJxcP(4e
zTsx;q@fQrwG{CA_*n5G~_!q!U-74Myp#^o-<aI)7P~;i;6c3?pMILT4>aRr=B(uQj
zCX^}-`rm2w#$QW2jwmN4%-x~AP-Jp*he=$z1PHD37P1!HknPbvK#Z8&ZcV&0hE(v*
ziiY4Fk%1uysh_}9!3y#KRg-`jEZ3EdUMyu{)}Qip=v%lEwm^qLYH@BhU2e9NVih#9
zY<N$=&n(<&@f(ea-}(y{t3Er+yX64yk^pv=$0hBWIYFI+`_0a*I2LcPf;4TMWo4s(
z00(x64oNUwTK6&k9hX*`Z7>?9PDI2l&FrN<HPFsG?$&eB#hY>xv{G%^EL<k0ejbcV
zi(`fX3=w$#s7Wr!3a92E8mKc*^i6X3-xb=nNWW>a`fnk3nV3eYI>-7tw=NbjBONMf
zpprzkc3OyU!k?~5qCvh0M@!+4U@P9;glto_zka26jr2er=AFN73IE8AC{df1tL$#D
z1csG}RTXTm75i5g@K<Q;EIJ8u<4{L&Qbz^TwrgerIXjv1thq9P%JC-pw#FJ|O47AY
zh1qmLTU6RsU9UvVa*G2f8Y^wA;ZwzZj=vBRoh<$3%7YGf9pSsA9q17p{)zl-6>^?I
zNDQ*eL(G^yjj_;)`Z{MwY^Z0wMV|!8{HRC%)@F?1<`>*_56qz3f1L@}aQm>|z0X%N
zm%VwNfu66<LyB?eN}1LdmP6yHDH$IIlHqA2nd?3`uAl@lwa%yNq5b>W0Lvalvusmt
z*r+6g%gy$^$1gKX4ZwnKU#w!ADQLk_S3)hRHv^h?^q6J4fe-$S<q(NYz`^t}fWuOd
zF}-OT-L<UuHi)|MQLB2umzveN?lT}#9J>R!XFi9Qw3H#>PqO{V*eqDVs6C-~*q*fT
zOzmo&P1T56#Va+aF7O3tzXEAaG%CvssvCR(k^cqO5Fb`4_mygkwd&OdKoJNpYB>Go
zKM>ZHRfe_=fdDPoMG9)o%x|FEx0;7vHWoWy!wv|v*1+rD1AbA+cdR<w;nnKdI%t&@
z>DgNKrmAPQQ-6EKF05LbD)r`ST$MUjO)spl0RI7xiXCJr$J;csN?PRHzf+FuR0~9u
zBM`qqtF(n+$QVGRdRKZjf6<AqayPj^#8y%<60s~v>f6O{%F-rs5up-!5}>@jJK@|U
zYnZcUTQr~F<WDZq#xuZeVwDHTqGnMgC3t~<_TW~3V!x(nsX5Mah$J659EIl`0bjUA
zJX$9BwI6;o=<M!d95x}v1)5^H^B{YL1zTX%(&p5eapz~|;6tpm_}2;-4#!;EjC+1n
z);f>gbz`wJe(v~hyf~88kEP!@oiecLX8lO6nxTAXzRclO$=Ju3I+kYrw_@IgyipLt
zjfPQuh7QII=%;kR!4PgZB87*Zdbf&9EP`3H2b#qVx?H@@h}ZxCJWHFy000)86OREC
zR}hTSj-ArZ)xmqQ`E5loM^Bc$)*EFNpzqEXw)JxxEXL*>$m-6ArI&js(4mqaC3N9>
z+<G`?-GUJAG1PW@uy%;i<Cpo^K|+&a^5cl<$59{Kk&+7%-XJfV3S+oO2H88D%dG$5
z&K(hdukEb>LYF7TnJ?QelFvL|*O;<XPN{31J(M?KSl=zDZ52_8GdE41?WYmUq&JgJ
z-OP)2Kuic~`(fkUiTCpZ^xEkW6p&@n9qi4jP}eORDFoExQR`=U6=Y(}v*s{dP;mOS
zB{5&4u^>UR3*3$;d*2vCFkZGv_PcOvx@{O=HJxhI1!0=gzbF$=-Gt>mZPvJub^S8-
z`e{#cCHi2Qv7jN5sSEi(H78An8S>UOC+J5RQ>~47hX=g+-yDQ8A&||YxDu534=oF=
zXf(}>qVq5umbVclD(1L1e-20pHLL_72DHI>tmz^#Jv5lKLjj{Y5B<6H@#1aJcD&ok
z41xLIk6`IrE;j!2;Qg3qmcOOPcY(&7)ze<O@SDW^i8`p~L*#V2#uAP)?qn@w6p1>C
z*kkko*?NJK^h!<_gtdq1N5l8af0y@Qw+^YAC=cPGJM|zlzn%mC)-jBIE#^q4CR}i&
z?@au|VKlRyxStsuwfoCX%+sJ#f<`OQF!3sYE>hhYHKeWQSOqj4(bnV5I*E(|wC|c!
z*Q9G!MvZ8vA09*>9tb*F_!3V}*k+{NotAx4{8H7j^OaVH?MoH$q#B~89kp{HGNvr0
z?Ikf>AcuVPI~_#bi%f@D$KZ|7LTT~W8Mv;lX9r-r*KTWT_+vd-kX+h^;QsF<RlEml
zGSXX^gfVY4TM6+SY8<(xQC0E6Xd?N<awEJEoe9TE3Lj4b3W65uFten|RwJ8egXs~Q
zYN}}W$%F6oRo0fz<(X5>G|`j5(?Fo@Ww9<HNAUwwc9gAFKZoy?o^cj1Fm(=x=iwHi
zcB26gx$w73*0PrEs4Q|W{;SmQKov8ad)LbV_W=G#<1=^bC!g9@&spAo_P1e+(NoZF
zp%1ubLwXx15;+Q=ACQOP2=j|rQ=P;aO6@uhcqBU-g2pk;b0`FOAI3UiK0D71nvqBB
zlg1(1mZUiai*yar+IWwmNm4o?>c8Xw`JheVuqiSk$2-5Ut<lobV|vf;ruw@YP0aMr
zSPE(|{2By-`v_C(wPJ0M1N;1##t5k2Rrns5BquiWtzBZKS(3F`Wtz9R0#8FxDi(NO
zFoV{EHkIJjSRK(~*)#TIMeB<5O5NOY7*$}hnE{egJ%1^gB8EZlW19}ccOn+H!S^ii
zn8NOUZ`cWh;NgAs+t=EgO|0Zx?UyPA`qG$kWT1*le`+6N`~gsz<qqH34mn$k?_#8-
zR*X30l<Qm++Gy9Al4rMxuveEpf(Sei7*)MJ*f!rCD`;h1JdIa{bO}UHqIS8HU*x|m
zELiKW<5*As7^bpJ9Kgb#U&<NUTI=u{^-vFGteu>0T=rY4<)wJmX%-yOV=kLzri>Lj
zpudLM)5<szZybrd=h5zh45~MA=J=?G$^9+er1JxnAAz4LXL{$ChH`7;SO(`vH3`n$
zT60e-ce{L~-}EK>P52c03IG+c#r>z)tb>9x6;)WKBA1_QQ|FLsb%<lD#8o?$0_4DC
zKWinagyIoBLhf{}y$Ni><nlDjOet|YZx0;Ds91TB#&}?~ao||h4@<8x<@ldl#@%2+
zNNwj9b6)z*-V;TZ%Zr<yD9TX~Qu`N!(A6h0-SY{CjcF2W<ojqLel6PWRXz_iFWg{?
z*<<aSMjmL6N~@6=8OFNeH!*goZl>Pos#GPpn6w7{lH{6>%fcg*ypS}HmJ9R!zbav@
zF*DdGV*)YLx9$}ggv|Vu@~^4X3yfI)Nf)Y@x)J`_i%PM>7}8@AZO9l33LUCNl}4Ei
zkNBH-T!dtg8@7cs2#p3CdBY-*Ltu?wV(%#`@UZl;k~hX!-&7FJ?q#;xa6vC;pk1+T
z&{|E6tig_~$h1~vhZE7xH>v))>oWRp79=NU``PLMi{)yVPPlJC*Ntob#K*+=)OTRN
zMB;M+o)GE<UqFka6t+WU&!hYBr^pVeu4PHSdT*5s;x)4XBE%^-_`GR^?TOo?4;qK^
z=pRaEz#pTWEI-KY1tl(Hor~-bQBJi@W!fxvs73x$P&F6Vy3L4XNq^<R#MwXh_R*ZN
zq|3_n*xf|8F-XM~)(E!b;o$n(bjim5fFdr%a^mj|6_n}oU+zB>>B%h0Vmrz-!_&&L
z>RTn?uFJD_s;@Pw7eBuR#39rL)}KBKr$wA7<8FT=+GaMD9ZZ36;7iA5sr#tPg{XVa
z$sDHZQ(4iq>m)kqPm$K~6TCRd*6ZbfK4B12G*g?4sT(kLH4I=ikNkA<$tg$od~h*q
zb$Cvx8D8nWLp8PJ3OIP)$W;sB_9mVSvYQ5*SWa0#%a^0;AaNN<;tm0AU$$(+T^i0$
zY<r9fV`sA%x?nqJwbuT77nIj%q|u%+{92Udmf||K&%|CYolFr!m#!uEX4?8U!@^U{
z$NzOh|7OY}TK--o5<xXlw@8(Ut4Pk9osdR+?@%Lji*<!{eCU9F``{e<<WnahL`cMt
zS@~3XGSx)73lc}$#j?8~Elm}Nya8CRkKvg_(tx2woJC7=e*Y}+3N4Nnlzj!?6!+2o
z-Wc*@v`DMZaxEh!_0A}bZKV`FscKNcOw4U@2M$s+bY+Uv0JFM>$H9K1L8hP{iZiub
z5QfvTiJheB3m$EA1De!1=ry)0fYHSa_LRRCA;9N|`{nOcmY%)go@BOOO;kkHXB&;_
zte&N$NOZY*_PhaeN6XyvFaR{&oPY7lfI!JGMkTVvQ*8fXm-}%v9T(_kG2lqR02?U)
z+b$OQb+>0F4*l3l>)ynklS7*!hgb3=;ACNB9*s3W#D2;nJLp%_o65ZrzXvp|24Ml=
znc*^WEtgZm4Rn9_m<aF7Dr(y7ug;YIR&^Hp!vO};pif1MliPn|^<TIC=xfz15mKUd
z5`<-gwE2{St%*+?A$!bRd>PdW!dw;m$~6??a90pO;_O>bQQn<;d6&^$Ba$_aiYom>
zcD3z)>@Rjd=l5+(YbZX*E5a-yDZBE5O>3b*fy)6LMTTZLq)h1WU)t=KiW07WgLh(v
z;7RJ$yB>4CaI0cSsP2knILXNGZ8Le8*YrFqmU7nnI5Z2`=0&Gdn&Od@OdNYL7jLrU
zZ>l0K)=_oNijWq#f6BaR_EuM<l6ClplCHbT%ev{9{)$vQmiUc?I%(ZuVGLIgpK<hc
zzd%3aLK%*cv(PCf9`Xb)BuDt@kf?H&nr`R7%MVBCkpE}HK8vVG<BU7c`83j9g{X!4
z$hFkWwKT&)l%h9T0RBowYXJ6DC2IXy_cg}GNYd<1BbJH6tLOAEYXI2loWzq9FcL#5
zzEycCmLgqpk#|n}e!ra3bU(!ra`Mt##;}7U3;eY!KO_0#1rD~Apo~L=fMgJ3bP!na
zSojJ+R_l(w?0ik=G4DwsJcw+tstwliTxa3!7Dt|wi{Zptc=&xPlW`}vfX75uP6tOE
ztEz*b*@|PF-LA;4OlOl@h!;*}_A*D6UeY78OK29QXVcZ4R?tP4zF6sN_QJn|?6Mr}
z8Lk4WgBrP@%r&XTMC|ifD3Ru49C<gSTS;__)ke;cQe8MqOM5{V?#e%Y%Zzpa(1mbG
zFoMOa6Q6d~Z*;oy-W0alKnLGscAZ%6=a6$n{b8PTReElF&T(@DH@q8bhcd*v?7MRA
z06X-EbaS!Ye8J6CeeHo0)>b;vkXx-qpp?gJ+*@JW*%uch&$OjDO6y35&ZRH(z(rNr
z+r{!h$;~N;%Kz|+k@<i<UfO=c`B_%y{&0P6Ql5E*k1yPWqyD!ioTZedzUV8(t_7QE
z#$e~c)vVR1OK{Toe5!*Ub!6k?4Mb}v#n>F>HJx#G8S6twY0!Rg=~?lxqPlDI)|&;&
z0J4y?0gBR%mdUS;u0O?%Szu#d$E;qV+&#6T#MxWVtsCIHU7Zi7PZ5wk{qB01QL|uq
zaUAV}(g?m&`Bv2GaAia_VkJ^T{ZB5r!}8p*;Nxkid}NNRMw}3!yyfzM4W)vEi3M2_
zIZA)^d}XP)d$@Kteo|~ldU1ffg4PfNN`*oma(*NY{z1fIT}9UTc;<W+b6gEWdX#!g
zoG5Z0uG?W50^Pc`xi(6ytT`h3=22oD94<Ev-ppAt3&c9h&hXQqSf6V2*{4+Fd(`^(
zPU2H1JvvLNZhPrhY4AoRlyNcrz~P$FiRI6a@-^Qt*faKL)x11k*Xq)|;%d+4ZVO(G
zH=N~Y@wjnP&2J+*7}vRu^13_z;U7n8{=McuO)EiK_{-l?>e%UBoQjb3l)+LHL4P=g
zTTbaT@mm_M;I;tPU!3_;k}DXQbGZtzlJzo6=QPP$8?|6p6uK>ysou21M{bvf{jx^0
zBTBAV%#MNB1D}v-^i}z&>#yZrYX`AUQhQph8$~4r#YKXcFJMAx#BC4>*#HfqX6Xdn
z1GS(g<BhdJYbSjbO9ehozlj^yTU>6BzHCe~MEEH<j!dnWkKgUZ!g1}wLge@g2A|I(
zu-c>noR!??UT!sCKC~|7VqLq%N;dT~LC{WVJU8GCt#Jh*R4c=8rxOz^F8$@+TcyDJ
zGR!bANm?N+6lZVs+@Z^hj%Yw?xew;Ce>(;~FJ2!Y(e-8Q8b)FYkihYheBkZ0WA2i<
z*IG|e`ERo=ZAo+*(zP$ZWUi&n&zOO9j=b5T_N28Yxl6z*-qbd7F3ZHFUTZds2g>9T
z)lNJCCo9@-bP-S=ilHDDw%q;1Tb1!|I?cW%?bDl1cx@IBRK^o6cTphTcf`}Hh=PA|
ze;45_ZkkLl5rMrW?j5q%rW5i4<OKWK@oTWw(27PxjLFvjfs&4+d{9hIir8nHD`$Hf
z=ib$o%jw<zpwIfdgcr1PkdFl?e$O$^PcQpXcP9CUcG)1X^CRH6&C~cNGPl$B1VBGE
zap}w-&|!ZVLqyFVi@hSfC=NfeK(V$_wqb*R><IG4!|j7X^wQ?Rmw{CH<K|(OL5&KM
z&irr&$ri+#LAVF~=moh3#Rd-zhy%gE2BYwoGK78pAqytc%Up+O1GeR_XNdF+fe+df
zAkYf~4SFI3@*8wTNd6js6f6e{<tKwX=sr}4;Gb&}Dj4a2pHv9r0ck=I*WBUYYJzHt
z1PdVcff;$2?ogru+<Am$NVxvuc}x~RG6D|sAS@tO{av?3W<Z_6netekp`F3_1Q}-V
z{u7ZPBepkusK1dRCpPG8D#ydn^Yi!~*Z~t^Yo4FTukH5E?4TanMX61gJ)5hzhoq<B
z*N#@t*Krf?x+y~6+iw2YuTt0U*vFhSc>-h9bDviO=qGA(c_Z}K3D5vh!Q<ofpP^q6
z|CdCdPAB{x83qJ|6AlFAKW*IquU@L7sj-nGi@~>ks)2)}>wkF!s@1)8W!DI|SUSQ^
z+A@_Bv1v#$B9M3F<CF+O?>Wg$Ge+!I*(PQ0Dxg(PTxO-(urY2qcS8w1!_ZN>W=`BC
zxRMnMREV?L=AYM{zFe+e|G8CfeO6yxwJg3?zkEFEcg&7}20ByMuwu1G4Q{~%=Fx(v
zAc#^$QET@@M<p@_ll+Ao9wFl{3orFHyJJKMP$Z#%7W;uSEF@-3-wbUkt*DoRB0>k+
zK$tXO<W0E^k>DOHXgx=GSb%EM{F5ef3<|zPGTISa7Db~9C-g?KK5=m0>BiO7)98m1
zx=O#G7)gL692%oLwv4rMDIWQ@qz4t)UKk8~0MGDN4)Lg5uMjcx5#&^WU{W=5FNh#o
z7!@+_AH+b?6JltLMaB3gP-|o^h|C0CBiwV)K2{`fNCK%9rDOuN6_0_sz=G-~rV^`O
zOX#9Jt0YNiG1I>gXv8M?VmmREIf4$Ve6Y$E;&Y7o{fnxd7=S@dlnS|gMI*Edwkl*R
z(gh4<_hNKNIAPox#veSd1F8rn6%oLq@0aGPcx#nTjY3ZQK^=e~$1*M<<F+u%plCw5
z9IP5{Z!gHK;w>m1R;1!jpjlM}x=EHI@jJ}$7{<trC;=&WT0}f@3LFw~71gRB>TWFU
zPe#)pJCS9g?qDP%Ksg#@-HzL6L5cBTVuOfL1suUzs(i<2s2NayP}YTdAo$FWUQmBS
zVHJ>TD=mddweeRg#CHy&&{H1e+X#?hE3NX}ibKD&n<h;lVc990+``?fmDY+gX!L?-
zpeI3=XRSLR+8|CU*>~#4{qW)CvW88(q>%Dx&PB4K`jbqq)~$2RbyC~WiRzk|5>8d;
z_VTd-riMC1R69k^WniSCho8~<I`XdKpOcBv-;W=mNHs!`Om1LF3dw)uW881$72qe~
zM)y+F;s|X9H@owO&EAULhV8i18J!Lf*J>y1t~%zMLJdamb>+55;cpRXd3V$MJv9_v
zlpo7Gm?!DJFP?@6b)QDcVJ$60ee2CL`7;L%$h27Lbi?$7L6sa5e4?N{Z;B`=WlH$p
zIjX^tq$G=Q%f4GzLt-Q-0eyNyBVhb=Xm@JO-r(cdwG(ZG_AZa`L5BJ^DyFEQhcI-k
zS=0mI$_bGeEC*hf;-ak{Hv|5sS>ssnt*gxOcj^8_FqYgaJgYoZYI#3FVl<^@BWHK=
z=%_VPVwn!TK}G0(4`1W_JPP?aBsSjAD?Vgw7&<^gOxe(b{Y+{fMO>&fTVG+9U_<@4
zFVUD6@o!KlQ!y`$)@YI=Q+GPAmgs0%@Q1)kl-SmV#z#Egu=!mPzUsxmjf6MVKn*!0
zig{teOgj-D#7hq?fG<4)1Z#TNc)Qktehd$tKWKS<9#jYX<5Kd>^p(Ak#cZv4h<B<h
zSPZ>8*&vM1ys4wLCUHXG_SpWUDszJ8&4U58U7P6leegp1>!1-^ak1XyM7Dr5Ll{!^
zl)hg>BvDIn-!g~Uj+N!h*?Cfaa%s?gqC;sz-W|pc(K)sCw8_#Mpa_D9CsQm4?3m}0
z$6)$8@Ful*V{6#4#}kUNZaS8n#XF7lWKwDfHChKVfrlz)(jva}v%Bi$f|T|m>;S7~
zK?^gzt;<O!66SK1r_gsFDgDt)$LnunjNSHO_N58)>2r^w@eJir(~8{gQFlpk!sER4
zEa!aa(d#tT9)rXtM{a%TzDLguy}RrL>tb)>AH<Tk?%}h)^e_zF8Os61zm6_BylnDc
zhVC^kwX0ohV@)90u~z45L<Ne>B@q8Aw;$gdHwLMS+<mJpP0{PL9VngY%I1XFdgh#H
zu5}dl?XJz7?18oDwZ8-Cr&~F%9l_P{lGqKTTrlswMHV-_OjqI!tv9e1HPu1{P+J>Z
zz2Edd_a@DWzH7l~j#Eu7HL>05^_8Z1@F`FDL`#)5-cFHeY+3P^Z@%GM<+*;;-1I&w
zyPpT3>$BBi9v&~}d4AwTw#(Y@(@SEuI%ewaX_}8@ORSk@t6_G|waoxn;*H8~%lRv{
zbrG++srPBru8YIFIlB_4tTVuEO!O^-1MFv4>wp2$WZ<un4Tj0CUs|KE-7FVw&i4Bc
zP)@5k)+pNWc2^&T<X#5sud%^7q%U*t8p#Cw4#x691i03XJ2ggm7sbCj!=^EH^5t?=
zo=kh-r9^JZJAIRQN_NLTcE?|8L!@Z=f!3$zJLUj$Nd8JMO_DdOrY5$LnpW?=70<{s
z1mzH_JEmu!h9#UT<ku5}>h}HhHw*dqDv739Hpuf3$UiDQP3E~?@#A*wxQ0RJ*pmd3
zgPXkGQJ8L<eu>&F@4ppZCZAv3eBG)IG(8uO))Va#EqM^)GoL$Q2EtMoq9AUI!bO+4
zuX|N=>%OX=6esakMJC$gF}jGAukLCZ0^}O@2b<8=a0W})2D;>V+4Eys(}Tg0_*ps|
zI`4r%9ip&<sEgk*4t4UL9DY_6kHSPZp}l~$n734zxtzfwIo(lLi+bz<wnrC5JqSya
zT1Fo|pChn&(*T~>Hehob+h8y}rV$MF5)Z02p6;76Vb*z%8@JicbZ$%qhCzP@PujO$
zmZPMA{c&p<#{owrPTXq&H>-v=!OZd&x9Py;`Z4Shp0$MS+3yw-M^bxPOFq?RU^nxx
z(FzCm%K~fK7&=KGwzi-r7dN6e%O|F%*TJ2C32fG$iTs{}^D3i%LE9NV=B<M|n{#rV
zZjP!zRuvbbw<HmHt~9gOw>q5pH*EXnA#U!t%f~`l<*u;Sa!s89`=v3z-^drWpJTKM
zVuoLqH>ha^mTUc3$=e>(0QCLrQkC{p2AlxO348l#$t1x6z(nk<ovrVS_3k=JrAj#)
z;Jn_7eWPT{cUu*o(pU0Haw95nYSv@)$5HTGr6Y9P@j#lX#QxwLN2>3(`sKUnUhaGa
z9(#=$cK@{brA_T10q;6zLcWA-IbYM++Fi+MLqEaZ5%^&Q<*+N@QMJkMv;BQnT1YqY
zCPphEcvu9h7DLX0B4s8v=xNL|8mapzPxDw{Qt+c@1O;XunylYBkj;p&FO@OZP(oAG
z;V0c^PpV1}CvnARs-lm`zYPDp9+3Z=ObOQSCb^M=fcOi5fMET9$<+TQR{u?+qBSp^
z(AC;=<=vRWjAEVV5I}`2PlN)Pm>Gj81os(XAeERBsZME<#$+jR(q-dV2$1#IA}@zs
z)V%f9fCx3uf!mQvPm^74)D_Kkz>j?*hsqk4%F87k-?pu*E3OR|*-<OKivE8dUi#mq
zbdM>g!&omQ+bGdT-kgn=r<|_MkFJE#hD%8@$MS*l6v`4lTW*62x@nEd17+f?ly&Je
zmGbF@EZuJ1DPWiPq*J6VIfu3zZ_6prq_12zUw6)8or(Hrt@1^C!_v))t!43$(3-aW
z0<E|~B~GCgaMGEU1h*upTby2t5wz2A3coMAWB4Y^CvXxk^fF$=p2FazU9NmvQ_i*b
zqRlPwS^?Ob5YZxQ?F!AFYOtCN*>I`thBw=fJ(^&VmzbsI$!WAHQFf+~#waao!Jm-(
zmpn012~ZxI$fm;RDvzD}Jygv_0Mzz%<la)MSjf)6;=5cJ-e@0?JZ?QpU8B4`XfN~t
z;FQw;wRtMBx`ZK&toDj$UjbN<0U4Dw#}s&G|4Nr{V`l%lWiz<W(&jsA<7()*8&oZ4
zOo3}UqFEjk@doptg}c0OQn@*;TP*aEuQ~R-m@{QF;2NW`tE(q{?&XXJRBWsBf;SVw
z!m5dicn}0+<ATsseCWItVqj&$s#Io<;06u^iTle|7C%_{z}^I0$t>;uwj6jo$d`E#
z?j|9g)S&q$mjd0`l`l@WhHrB0zO>Z;Odp6u*N(=n50=MfGhgMqq+`yvKEbbTcd0G+
z+So<dakj&UjRP)y4w5tp`4}Y}pVegO(AjP%RJ%4ODmpG{{=??NVo;0ahG4)>k2+!2
zuh_SyRQqk}MUeHBOh{f%;3AWv7K2`iK5o}VO&eJSUNBlcj#ga3tyfVt|1yI2Le(;8
zCEtw=(ni8q#idWtGcH@{C59eucABaiQ<Cs5U!2X#tvA`l)smXD1~ztE8SRb}QO12K
z+I0A{<y79eAnS>@bk0M}1bXlm87X7na>PuUEewTLCIv@=Qh2o3!L7=-O4Sz7dgw2}
z+EyUuxZ+aDq?NZHOn6&=7)*Rh7D-=#Kncq(F_FQux1&UDBR0#Y^tbB3Xwvy}zqJqw
z5FA+|LFYe`VtlkKMHSI9WwBSo5z?=mVMpXfA(LV)jiFkPYM7dt+Vb4~YIWq~Y_m!|
zZ1sY+qe|L2cQv&b04|i~dYE-m;if$N+hZaXTQZeFfqM_|&X%9K;{a6c-gKnmxOAt)
zFGVdK9X}r`YT$_-O{I{BJgq5j)fBnkMsN^m`vuIN3gl5K$wPib?O#rzx3vR+{ShZP
z#-0wcOuEpVNYe=GhLoWv;Ys^f)q1Ojxzwt`vr<KuU5%wwqx#o@M_M&##AN3O`}fzM
z5#79=!TL+_fB~)3#kx7F>llknuNHVCjf193J$U}Z3Xmn{@vC`bbL((X9pzg!9U<sc
zn@?azQApg3M~_*izqk&&N&ZBxY5+!;LViaR8OfdZL=MOkr~tU+Eg?DZC?o{_Y2=xG
z{l^*5;Jr#el}r%P3yZqS-0YbOyOD81jfE<qtkd#P<f;A`d}z1viPpHr*imh+H*K8U
zT%r?Ob)|*cg_*GC$w?KT=}aR}f7J#c+Uk;%?x;T+k!%>9V&l`m;Hr}U=8;5&z_6fT
z7W@)pUptPwm%O$oMpcr2<}Ew!-dqF-X;ih=z^S3>RoII?gkwjR`O;LJb%%@7<>P4H
zg%zq-Oe?u@SEQ(simL-J^g`$9F)w>MMfxJU=Ig7g2$UL|?S4P*L=%TP1BpyhXE5@S
zbj)My&U&JK#9I|p;0F5HgG*i;m8>;e?tM<<O~cb`#H*Rk3yQh;c5`F3)&2yX<{G`)
zh~nIZA(cr3dzKe5bjoQPKZ}E2Ef1Q$2!=OO9Vv1eemS3IFv{jrh}r;7{fGcly%F8^
z3)x?a^hUxpT%|gW7hz>CN<{OGxLI?~nN_UZ)2kb)T~$;IO^iU-KABWUrWYi(=GZBU
z1=q74m2vXi6DZaLo?I8<8<*5upHA4JfsDVS=pjs03rh7>7E#L&71Qkn<ubyP;X>{$
zgie@;@LXx>G`DQQi&Q1Dle-Ksz;z!@;7hxm(aq(;7mWajt*u6&n@iNP_9jk8z!~g(
zz+{M>jLfr5amk%t{K7Osh>QMTgOC@nn3rGq<mhJM@Lb!Cb{4M+u%18i8v-<haqF~Y
zZoUFi(y`I&5z@8L0NrcFw}6@KZCVq&wsJ-l3w9V>a=E`sxq6kwp5R%>N0sQ!%1uIB
z6;+l-S{y#j>{dRta358x+3i*3AKrle_JGQM^|VMmwR1hEru6+KLiOrpxx07m0d3?^
z8mt=nwP!#2D#5`OZV=Jjr5785pIg7F&tHrC%$7oC56^(v>+Rf|=dWK1y>UX1uVnHD
zFkD;l%IOD<5768ledd_5%h9%Ysi8hpA;|UtHF!0_-=gmbLd#f6eW^|qWizDW1OCyG
z@am}0qrAVR#f!pG#?V_Z%w*)#-^IrwVz$8xGNDb7{&7HNF}}UX!LGTReh&Mi^}WaR
ziWzaBK*=7rm-oT2u=XWW*l71hOoCE2OUv6pQnFLqp#Av~$XrC7aI=!?j~4Xd9o5es
z)hrZZo8Wq!F`cON0R@so08ph~!Ns>FmVzW}(=w7mmNnuCBRe5ZTt`jZPsL1JCy{Ev
zFhk)|?v3Vec{w)|ErTj=Ab6lxTtfr?-5hcA$L3j3RUD;z$g+Aq$DH%ii99VTK06{6
zcLP@(Ev{CIa-s0hj<H3rzpzR}bU8WP9QDu}(w~G@Eef2(Y2zZWnF`mWcy0z`KM!+h
zd9}f-S_3_^%luY~D_^d@36~!ZCk9PfBQCb~;9*%<mIu%VCUx=4><#|PI?g=mijs%l
z6Ez!)$mU-QK<oHptido{;iWc^bJT)YuIa~{f*ML;^OqHp#FN&d-UqAq-~;;96*1_=
zF607|L6PH-Zo|9<rLaug+G<-ypn&?HVLet<+~|)Qh^Q6@rP(Fb`j&Fzxc<i`$(0ED
zplW4s=33ei1}`1gi*{`dOg}LGH3W0}u*RSpqhK9H;Xq$i?X`F_FGFEJ){xa=GiGlC
zK^}sHG2<Oq|CZa0$9yKWFk3Jh3MG>8sCpe>{wY5Iq4)wZ<l=6HP|*U&yQKiyTLVsF
zIDU@O^fS~9Ve~Zh!5o?uPxvE0c_snHtKNhSNI(Mvx$DZkFPqvbfe26{QQn;u9q<pP
z!ODmLU`1U^8@Yx54_oILoJ;U$;W#(8ZQD1tZQHiq*uHUcW8=oQZQHiZ&Hne()^62Q
zO?6k#m#OLM?)g3EoZgvQ;1nb4P&9ThmZt)q%djkwdTt-~Un)<a$)KGdTYo^FKa`;_
ztcQ;6uyTUJr*)y*|Am0KE8JQX^=#4^V)gC$R2sILM?`)W5|1J%A(v>!Zh1b=2F0{&
zM|B(K;Q6Dt_eH$#rA(NhGUjZek=_&K0!q^-{;IfefW>AD>-S#e*)Q~`vBOX1&BpuV
zfua0pk0E~H_Y8Cf6SCq4>Im5lnD;AqVHAsbzk(7ukw6sbQj^)%plAwn)I*@%yyqSX
zg7NlWtDiRY{AwQje34o?ZDEI>g^w%~WLlJA6|zbNf5soVL5e&w%!v`$-<)|dVDQrj
z`RA>wT;N6c$|ePseSkpJZK@5nah1xfy?2YKRyY&J^1%r8nLds0KjTgK5U+Lt54pk%
zeSvS=Yj*;R${TJ?h|%EFJ0KhrF^I_rU<>7kVFIAuLG_dHd4r81>?KS*-Z2?h8<rfu
zB54~@7Sf%9y@|3|YnK|t3CRX{$+{J?CBJ##s~wqcm(9VUfc!1E{Dz&Wh2;;-q<Fsn
zBbpNZZUdXL0V56F2?(TR@@h4{Zkz{|yedq!mATvNnHl8#3&w~Zaas=`p%Ruu-&d1b
zshjsV?F;SS5AaE>v1e{zxL`xf3~Z<-<CN2(0Oq67>tv4K-On3L{3C@f|2h#c*e_&Q
z)PhJ%cRwPL>+)g);^?QGW*J{o)?o=s34hrSz|M$!vq3(->R&ci&qA@>mojG-#e;;0
z5Mmbd=(wmy#uKMYk3~R;0uCMln-3wfJ{6Fjc1j{OF?oPw;t`99yimd~pdXaIjqIZ?
z{R3*S6h1RIfG=XN0B3cdJ3Y3B>6h8EJp6A+?nCpTqNisFs2Xa+mb+E@VPPH<cF)t$
zJmyz&9~W?N30v=ZOt#=6X_DPC<5#s1XWk3uMZQ_?Q9bm=Z!m;&0kT}ZlhkRQnM*As
zoW{W!GS)+zORl62hm(5hNeL}Ju?86@dAzr()scnL;^%v;5YIH_l?ig+%t)8dGPkTs
zX_M%ZwI3kOkYtgH+iX>TDk6NENA_W4-0}o@Cc_ZDoiD#;pO3qXKUD21cv`M!FKh_)
z$pc^`6K!GCBhvPZ8-+EU&l~rKmu)%+=t%9t(7({^WwgJ1Ml=`^YXa71n+<|dPAL(-
zMZRz0ad+QVA!U?;(KxH%gg3&T<Cn7l>D)qEpL;{?+6dQTHp)n2PGWi1ha?+XUuC*r
z6)#dO<m~pJDhi(`RN!yt9A3ElxSo%ay?WyXfS1t#DkxO^)GwSf@enOiG4}U8a}$IL
zS<esDP3wXM*ZCO8ar0RzJK%51{)7)pwkJl5h3OpSmHAb{mwc>*z-frje>Rn--@hp%
z(|qNgs?%@UO1>UdX1cow-<LHXs;4P0enzQa%I?pAdvIz!tls}pLJxhqH%DWqS&M}B
zR{LAD@A(*52<Jcz(cEN;uI;5^rJF<Jsar2_xS+@|nuDOdeB8g3jGmoZc@9$(uJHzw
z^9hoBs37DQk>V<~?<~QgaFhB#OA8K`!(C4H8kJXpA*|VOlb`fRlQStegh{<Ay^yc<
za~;!lIH?r$?=jF^Ec1CIY2U5fIVE)G4-M^m91TMQ9jU{l_^x24T<+628jgw!Yw(8p
z`jau_?b)8}SCcU5+kYV&Trt0#ZyE)3yQO!R*Ql2;f3Pa)@=>22y}1&i#Z#G<W=NPE
zDM@Un2ISE7oq4@kh@meB+i);Dr-=SDMVXwi_ILnQidQreMbWPS9|44%dR$RnxUPt-
zbngC$I~Pc6yje!K1C>il@P7M=8`|f|KdoAhtaDCpt5uFCQS*7nobnUyZw(<cJ#p}P
z<AD?t?quCO|6#xI0v)!Kang^$8?0yl;0^4A!n6wn&mio1Ue)%P3|0rX`*J7T)6MCG
zvz+gFX>L(L9D6Qxdb{9IA@5h{63+wh!ydlV<pK0V@7(#k!%TAH(-5xl7n3~C`%5Pu
zwwPm{P``nsrd}>|^WmR-3D+P**268N-J@?2(4M?=K2uWuL=sHh!;}+#!<3dhR{Z_F
zIL<HWm*z{-&w%SIJn*k1C_G0h9BBh1s1F|vLa(ujGa20#^?M+kFuNnn>qcE<JE>Y!
zreoU%pFd@CU)%zJn)>3RN|CD;9fkf|!jK>$TJ|*%oocYVl={MWl{f|(B@>bF9gk<7
zxLRy}id^9dWl6w++b77tj~GtmRx(@}i|MZ5Xfo`G>=)x(<34P9Dx0fqw%=cY`*py&
zFOZMq#o2yN&|J>AS=LEO-0Q`&2~6YpvBUPsi4Z?5H%KL&Y!Py{LLL^8xj$>wgghC@
zF&Rh>aDX#3Hze4UG#DQ!NDkEn3$>kSTffjxN3wu{0y%^L=Q>#4<ka63+A&#J`tSxi
zh`AfrTu>J1cU--TVU{lhzV}~_RRJLS1EMSW?AoDmpyIdGuh6l+i+9woU^E=hx8O1i
z4PPz87?efb9TN;cdDVKdz)(CQHm*58@m?WJ@|VcDr>UG#Fy6g#r}bq+4E`r4He;(`
zYe!;ZzSzYVATCN{zTp2(YVR7Sr+RO&fL>$?zO|BN2bMRD(Z8J|za?+@sW0Lftw~3_
z@mq1_;UM*TCC)T$|6r=`hfDmpsRgJf%bISO=O95IpzHvCQG__<0P9)qB#YHZ$pkFt
zVDDiNx`MGsUkng@V2#K2<REQM#cEjI4J%x_^yk1p?#A_fZE)gpV=o7V!bIf=TOusX
z4<~PTnYeuqn)~^856A!UyFC1kED_D)o9?FbPhAakrS9*p99AwFq@rtKtOqYw)6d=8
z$e)Ig@AFkHkY_U-6Q66owNefBJ_VOvbwFab8T5gMD&zBoa_m~LP`lhgi-zn?EtUQj
zJ0-rB(|ki`eEd<FBz%t>&PS3RbcRb$nd=i}(Q~9F9Qd)&&%0Kli5j`stt5Q;!P%}0
z4XaKjP4;cSy=?a;bq7)PN2M!W41ve8!ZQ;waZ)Jpy+deyfx>-t1)E7QiS1l{1OK<v
zy^jVI0CjL~do`VOURo@4LMVwQsD5Mu1{9{fha7mzBo%0~H4{lhNCG6-I1vLRJTjjL
zOe6<75OxgC3Ty!Z4Ggta5D^R*yj6t<NReLf;G^8!%P>&fx7(<^{oj|WuCD6l_^{X?
zwicoOWoIW9_SfW0N?as3N2ZK3b1wTxTBeV-+?v0#DUg`FoFsc}AQhw4PLZBm(ibR+
ze$}AkH|Mfnn@=~J26qH)%IJ}>-AtP3sYQ{Qy<W1ut_dR?Y#Q{!D}81lqlQz1X0?4O
zD#jr-mIXEGyBt`0=m&xxaK9jBeCcM>DQwIRV^Yc{A%?Xk(0k5%m_F1Jzelq6u#U}N
zY)9$4NBt&VLpD$Qo^;fncnp7*u}GMKX6<iZtGjc77fHk|LnuF?;Cca-7uv-e9-@nf
zLMU!5-(%a(=?Xvh^bfBY90ad+;l5)VcAW4D6gTjX?4w=(kx)>lTw>%>1!A;{1WdFi
z=8t1RLkw$5TFPstS2z)_u^VsUzGWLHRx9v%b4o#BtHjB=%-L8BwEp`flRKQm4*(-6
zE*K7S20d<)f?|=PX3^}8RDoc!7zuUE7){KBRKcE9L2t5HtyDpR-wpW3#~lN$iDX}|
z3Md@vQvvZVOz8I>!46CiqZG!|p_l127-yUW%`Rg9HOg|kM4RW=xo00t^elN=U!S@j
z@M}v1h9^O=+c*D!%?<wryIBU0fXo~0G}!t<05>_s$LN8X)t$8VBTe~Vvwyy>;%t}l
z<=UlZg8ev#FT$Y=24H9fF<_cmK%Ss9`j8>K6-bJ?E679~SYI`x_8|}HzZP9cSIPc<
zuv12uVf87N<`q=H7Gav{Dy5-mj-QdL)hRtuQVkfBcjLKGjKlizPy&SOZZk|UP~S^3
zX*2yXDNp;F=Rii3rH{4q@3Tg)fwHJ_ory^Sknu_&M7!?-b%vOc$xTWQhW?;<iQ7<&
zCDa`=Vuho`N%Q86U$ZyVq4LZcIlZ0~QFUZ3Q7b5r;aqwtle_-tHEvjb1gKpw0#sT`
z?NGQjlwr2bTj)f3p9Xh1LBi94!u(oO*TA(br+xAjC0)RQDKqk+>t=F)KlJ`&L(i2Q
zL6vBROQa=_PRUaQu^^k@=?eg51dWq-$ECiaBd+Ag`tnnLA|y?bj{ksqq!vPu0?e#G
zljOW+ku&H5#f`MjWS<%eAVz--i6QF$HF(es_L-W?|MA!6CADY_H>oLg!2ja>AL%Xb
z18-0=ECDP+;CFS?gsJGRQ8^I|#z&v#&;FW%5)KOb*v`F2II}{X4!#)EU}s~-pv@t>
zp#kDP_&#Bqg^o6&w}#Xkt{Ti|<DeVDQgVZYJ|#C^7RHM!!E0uKG|hj3Wn)Gk+keAw
zYuX$e*3Y*Eqy<Cbst^XlnaneUbIbIUkt#d&TIsh?GJW8E;q15Bow#8)3!z>r_L(Gd
zM&3Q`YW!5mRI01Q#=p=Tag`Sze~0v4hW_#-C{~~fD#KAUiRD*+kbuyA{|w+JqIeeO
zS7XF<X~QXokWODr{N^wSSRw#A0XW|nIS@jVU-OLy*B^QvMIM%8DD}cpbMhWhY-n{5
zq}e})1c)@@-T;bimw+tBkK`6<MF$FyE0G?&{aEfL)#u82oD!Oa4+6ub>VW{*8!~~O
zzJzW_VAvUNWygza?m&=qNOKvcs-fmTMJG^Ypgh$l(dG#b^YcP2LpRGur%(<{)gP;k
zC=P3?J7*ohVV5XX-e>1_q22V@^xpk?v36;hI2x@)Z=)e}-e$Ek{&faN#c;e40+7Gx
z#W#p&wkbvd<Fsn-nlsHdC)$3Hm2Fp{KcLs+8{~}^kVUM(c?Ec7n<Rn4YByWY=cs@X
z&(YU<n7AydkOCGPQy0DZ7>AfFGtXllN+|#auU0^bSOv2nzgsGapi)GUm;4*W<jsar
zJLCbO)CfvV-YH*C;4IxZFQfq#i*5BlK49k`A>{zhq~)J8{odM}Q)S5){KRjpV13Zt
zaw6RZ?+QKHI(ZW9go`Jyp>%pL)j#M#UTo+R`P^ks>Q&!H?b$|m-GT93x#XrNGaUj0
zC}!;=09Ucc(1)`NA#~_wFF^0X^qTb|%LBH{Q6{f4Nnwc;jAVMrRy?15brCk~?SWom
zH_*~i-__Ol%(W>?Ks0wXzY~A@hiJG+WsN#HTG1a3>Iz3eDzsg*U*5V(@aIkTkWe-a
zKU#l>Mv!OgzaRGgyaYAYrYDWS?RG^`({uH%N<Cv_4i#txOTMzz{ZotQM|Gft-hGHc
zKZQ3}vY8|zDvgs|rPu?Ae@Z&{b(NYFc(9BP1wCD7XI`>uNxO1RC{#`_-Rnx0<bH!$
zKL%6@EG~<7ewJmS`rX?z=S)_-{~FIM6U?z!@m<_0ohe=UGYVRgaU~;go<I%=*bhEk
z#NEXI{K`D;Zkw(b2)j@f=^ugWkwddCSroi1uRM}oKBviMec=F_E_MUJ?Rk8<d<OV~
z6sRzJ5$f9KdSv_if!?TD4sT17<EV&rARtz+hEsD+dFh3Y{uNPRc|CUkg87Vot2XK0
z{;li*Bf*#0-TV4TzT|^|QD}6>VOSCN;Bwce6zJtuWh79O?82*i8y^lz;wj4CYIP8!
z6G<>LzmK+++BgI!`-QHd4YmYSR{OXHe-`6JB33s}7$f2;h;O<UX0-WcMIvao>)tAo
zO53L#NV=iaop8pi3bA1c!GNml+TU0i<w)gN27JEMF3PH!@<YQxhoA?N*uv)eDj)X5
z4ep31iga&9DQ5h&0-2x<z_PebA@d+FjTp%CU`|L4I8Ysd#OJ=T%=$Ot;EeLL?IO5W
z_yWR8Zvck~wB&_SCa5e6LW5>dgth7|fgqL;Q;O$${tC`dfcmef`~!Mg+o%dP<fi0&
zay6H--6;?e)q}Nka<ul3xU@qZ0eeJg>0?hFObn0S0($Wou(NdDjL-~XJF``2nOZ=)
zDPq`!i6WSdvTP`CQ^SwU-AgaCGRL$WM1leGH0AavcgvU~Os!Z8ZD}jCacM~lY)QoX
za=TayZfPsP7W<DyBS=IjzS+Xh^F;Fy1)(et7XsveGB3h{j!zQHH@zZQ;pOEARmfgi
zRmN31<N8V9nBjdDsrQjT0C;5T)XBfpxz+E~6EF0P%NKW@V6;o<Gpyh+MPTIuC{zOV
zuYbMArCCw0_#)UeGc9@#lVLXTLGjnxA9nOY#Ds&j5jy2Oa!x$HI(Pb>-h!o1haU5^
zV4Cz+<8l|sG@2!R#C*O4u{;1XM$0y)96HnUpbiHRuTXWu^{r+A&9_RG@eT?>9j>4(
z?H)BezhE|2o`U%CJ1|*slZ0Fn-`Qd{cJe|J4G&mApT1mTHiFt<9;pkqaECrj-LNe9
zy+f8FB&0T2OgS~Pt4O^=cv0MKgI<`-GA{o9AxZk;(83FsZ>ZF+7X8alDZ6O2FlIoi
z<9K+3bf8&Pm*jfn9)@G$$Zlhpt<2LdjLKbm;}D28bcMZ=RGLBDsd0VX#bN>lIJ6De
zaD|@#Yy}mi62r7YG8-kWBz9(+h9pTNaB6bfd;hh<wx|lAdxAb~rR5pC3>-D<Ja~ow
z>Qm0;c-;ij{*}<r)KSQ3kcVMOahq`B<Bf-V4IX>YcM#-|2l}S<%O>Z~*Pller|d0^
z?B8@3FgZH+{>Vor++bj3_QW#GXTpM=1eS%LdzDutP8yogZ#8glO#V*@r=XM;dSo+S
z?m<Vu7Jg!Qhzs{n7C)KTpt}Jex#vI)goPN2GksFI;O;@_AQr#{=-`inU@kM8xk0k3
z5Hs?GEyB2+)%b-Fu^90+0%p3rW8+?JI|y-<Aq?-FHF*9Sgz(|OQb1CL0A$4Lx^Kik
zkR!6k;A4re<w+E6i@5hxNvZxFsPzyEu4CJfDv4u=T`57;lApvKdp(~1cc%hyRB|M_
zLrG!M1B=094M5ObE-aMxK&HwcoY%!|wv_O*la3S3MfW0Ic#C9w4-O;G`S$~A_F<bk
zkW)eMUqoTkpSU0WNep1r`FFttBF9i>pkXpy`xlXToc*{>q1+#FTrWzH-vp5Scl5Y@
zall>!Nc~2`9~!^qU&N`tF=s3wkM?6VcrU}hSz?_5v3Jv;;J8hC4i}%I;x;ARMtXw*
z_DboV@VLbHZ9#thz1^of+pZU%-?&UVyF1(6QE~4zbGye<%UL|p#tEGj6o4s`LI~Y^
zT{k)(gKCzvI}?e!3hJ!XUGCJoLUMBDi+uqS%5Q1~{6-e2(v0ycYbRgDu|yW-GJtOG
zkC*pa>@u1B@vmz;ZtA7PY`oEG+TS_5`F@fg@%J~DN8!BtY2O2}a4f+_ZKoejZK)}&
zZjP_brvU4-YPRjN7F>XV!S~fRzNf8Gvl?00=UxKVyD_95!4L!o)Z#O%FA4Lg?z1J=
z-NeZg$L3pRU*%S$B`*d0nYYh+BZs~R?|Oaf=~H9er!TFwmWNaB)=?u$(-i%7YsV=D
zN9-d1@48p3&%;Qz&QQ<(bK*;UUd~3}rG9<puoS+>-rlmVsb+M$tW~0#z2wVIeNE=G
zpkp^Si=5?Y-jcB?iEb40@$oqMtSyI<HVY|Ft9noQ$_;wog{MJdlr0_fNe7IDmSipK
zkuv)>cUzap)fCUyT2R~AF2>ywJL4%Hje_%y;Tfy#{MzZpE~koM{*RZ_DS5e$MW^r1
z;e&J8HV=d@6^D<8TDIGE&++Od`zI^QRMq-a*zE6*(h_zztoO$;P-E#STMxpf^Zpy~
zO?QCAY()vbMn}iqLCd~3GX15LR?hFPLHGjuM}u=8A8*@9053aLv!3E+x<2oN+ryr<
zq-db~^T%A*HUGA^>)mLBygCCxiq4_eQfrRADLwZ=7N6@t@J8@B#!Pv_N#jIO)_e7P
z({^;Ht9F*(lTABDu}YSzso(yqJdakF*IQ~3Hy#)7O~2u1O7e8p!%*Iv>0?vjC9e~z
zUC5N^VIjt1wt;H~(G`=CBCX%fO@3d8py=yi!C0giJl<Maq5lSN{`gh<)Q5)nbQe$;
zfpQl=U|FdP0kEv#IcKfD&ei7<b{*#C%cQ&89y#U`eC@3g`tayZNl?ra&vZ4$Wv)kG
z03ZjXDgm5wR1|a*?xiW^y(Wyt65q{{4qad93qQIoI#FbtmM8Pl3e`KrUdtO|q2%BC
zY{n9|*n^g4$Z}IHHb0;r_<#FBSWq9z1M^D15(E@0e1Xk~XcdV256!o2NqYvi;+#m1
zT?1i@zuGp)BW}jfw>MMFv0#ZhN?cPH+>s7>s+b`ij(&ioZr1;jf4fJF<bttaJk)nv
zea5~`-v9@tlz&>zF+%QsQ}{6q+`PPRysENWATTPSStRpZ47nRfomxO|_2yR0-k8Rt
zl7GW5=IOPT_q;Q+lJ!hbr=!X_EZ-o=;#DjGC=<rKIq)msjcq6D>dEb~kCfwaEWmSn
znM{-yq@A3ZUdh|0TpNoGthr0)XrHg=)l6ZaA0rUFTPSLFtdtK)4IQKo-a*7fq9tLZ
z4(ti&I99aq<VZM>+(j9`PR!&9>sI}Wjei!ITyOl#+E!{qS_<b(7K{y!!v>tr4hot0
zzPAe{yuu`8INPHbbRTIPBy}gofu#(0ade1)tErcwuaK>-prj#kV@y^{Jbsb(Zbaru
zB7HwRU|=g^d3%#z*D+U@5SSlN0;S}sxcckH%EZ&LR{{BB53|F0<6u(cJMEVOZ(kmH
zDHU|SSt%EEp3DMrqfn(HSfe1OtH7qB_ygft&|AK*1<;syNa-&)G2t0TRtVm}p@P~I
zELJF4G36PR2M{kLS#gGf^b<5z96FJx8KVX;)m-<Pb_;MXgi0annPCe$tvL2PI18G!
zP`CWe6XyoVOVRfqkQ)(CENq6!1vg7zyMSOO?u5bxIZLcNxBdjAEttOG-wAeGtX*!#
zNy?B#W=bxZRfn1=N`p76qV&8;WnQs$3|se-2#iG~YlZ8~Z!6t~(k1Eh%0nyOMm{Zl
zI(?i{G>ecm1G?g5i|<)6tHU)5+vulKcEyZB-V)jQVr!NL%{3d_*d_t(3cA^?nXQGb
zxfDy9hUdn`HS9~0OO(qRHxcf<%4K$oj0U<jc-v|>DelV8imXL?3yj9?2AUuFe7PHF
zJ7dr$CoqK}0(yhB#=xS3s}AV$kn7E-MlZHq@FyoI$1reaOn(dAPz%acWI+qgRRqC+
zj{`n_IE(`lesI{15f5ryPf-hOTwmNy*$WpBuzYXgjq(fA2dOWTeE<9{EDy?bA9;4r
z@$Rb!uwJ<Su>B772fAKl>TdHbw+ESC*z!J{2gz0d|FHhfrw0LFblmR#3)mNa&H(?u
z{;eheU%#h&SNg>rfTrKS9HslB#zbAEM2kv+v8_C@m+=D2m(N=*=zhV~l+;nMe~r&~
znIcinG<HM3%I52jH2wQ2<@5Rbf3sS!g<Re7@IXKl=>Hdd{~uOM-_XX~)X2&3Kg?E)
zhP4aMVq^BL#MA6TJDztE<+Tj+lyGfgG%tGXJ`cH?4Dqj>{KDb}9qE+e*g)E{1Q{dj
z?KZXzh_U`3Ae+u*gWYnxfCnU?K|unvfd@L|hPolo(yNvKs=8`pk>Gh)ccXJ!1~+-D
z%C&LnC(LY$&)e_aaVi>cs;b@$-M4|!?%kwYTUl2kj5u%%CTQ_qp*sc_qw+T2YUrJt
z1iwZyIHs{_Ks28-ePlJBti;Z*lTm-)pWMkj`Noni#FtpLuy^F*%gM^9R{K7_iep==
zNmP_4L}mPpkaY3zXex%%YO@88wBrnbrt`2CUX@C(hD(Jm5amm59#01PER#KcDj6OV
z?24%$RpCo*Mo{4q2H0n1$s-(G2(qWqIV<R2>fw*ALh|4eVjk!P9vb~Nh73o?p+10k
zpS7m5!;w_iVCPSoG^a5x&8`9)5zbY@ZVVXs0`%5{XZxYHs*z<)f``qu*3nf};*A{5
z7u5<BE8s?<+Tt{Z*QB=iG9)|mL;`k+d)I7yXQqs22J^EBlIB`B%*CLC3b@({xX}1G
zY}DWWnFxksK-dZ@WcU824t(Z{-RF0($ls%6ix~%3tY0HlWyP&5uGL1W^b)Nt^fz9h
z3N)e;FAQfw{DY0Adf{5}cPN3p*r-71!ff%B7jq$rPjVIk0<K72b>cR+=<!r5r|eW}
z>?B?#;yT4em9~vTdI;!J>Q=Wr-(4De+i(wk?m7ka^!iDrMO@W5H$z2rGJ2DQYcNPK
zil=;wPgS{<U~{{md@sox^)uIUF`bZXQN>(Vy=>A&a+qX^Nnu?8jUcM?$CBqd@v1$+
zEpjH~YB<61?~LZNeS%}`jJ~b{={}EOamx&$WnEtg1O_&lwB3$SK|ADUl+2|Pkqkb1
zV=r-hh%ux1ri?`_jI-)pphp!9Qt}63Yzw12nSA(hE2BP{diZgBjlf}*g2qmtP;$GF
zVP3m9nR*nebV1LQqJd2<ONgkFNRtUDZAuaxgsPr$QWzK;F%Mx`BlZSyUC|V*6&CS)
z8>xmEPk}8W+G-sp?XV7^)>YtCeSn60Uc@n|V<HTVhZthDgCUtb)Lt@u#hp@MA2o)W
zH<h4aBaF1CTz*<2+rhs|xHXX`a)`+^6p=~#hMP=6J4ZvhX{fzM`igxn!H%hrM;?ms
z<#q!PF2P=hyv1=S=*p8QilRzs$V7l^qhRXD1ZKl|22^7^;`}JaUK&j5$pOqQ8NJQS
zPYaIT<)`Hs29x#sIYg)g2FLXZCM4!WnnGXqF*1N+NQq2ZJ!=@`udQS`+MmF`F|I2I
znH82vIBfB@O(v?<YzF^EnmFy}NYM?fSx8lo{uv;xXW7;$o2bDy?M9fa>-5O+g_N#`
zaH;_*ZiHN>`H8ISp7dUjoH_0)jq&zL>#hi<i?{TLfK9*4p(3Zn(IJrnwI4F-kk^gR
z93CDpuR=)1>*5FLYIumW>$C)7;NPOr>x{z0y+~nH?S+T~l3_YKZo<8FUpmx1Q2DO=
z7WH-&Th>D8G6kIIY!ub|Q}`AUll83BRN_^*q6gea;&=!4+t^#=OuUV5zz+gWVCWwl
z@x$MBT0-vy05LH72Rw*=vmw@82m{M)H)L^;(E3ih<M;@uU4VdL*Y9A+tPDTLDI?Lo
zz>&8~yg-$I0$L_i$JMM6sxrfbWUtG+mXg^)+z_~-&m}w<>MSX^d5NY`HZz8BtWl3m
zObtZPblVV~@o<9%n8L!W7kzs8*n6GyCY~1I_4F6}c|=>seUCh>1Iz7y?uCSjj{Cwf
zu%SulVee+{JenYwGCdXkkSHK(_I9I9-D~Ha)QFj|5%j-Dx<-5bJ77dJN8gcIMetBD
zK?@79L^sBc5iFwK3u!rq2%F4PjkfJBI%|;~bi+qk1rD1m0>3z}#l%%OXX~E>O+g)E
z*{zWPvb`tC(>A2C@DGKsb6MdTqwA~IYha_V3xdy(hq18cfq>*UwFX|3@>^T#{%u2K
zrx{$)U5q(^nJ6kK$7zE^Pb-#Ht?v>z$AQ~~iIHOPkhlb2<(=4{GJ}fU>PfdjS{a)0
zMq1F@>>jD|HEAd<2@VIS*PEwJwg3ksMDd$G`O|-6NzEYYAq@$T-Yh<|;@&9N`n}rf
z%1$0e2eT6*103So!A!r5&8G6A#*M3F9fC&OK4~~Ui@4f>w|)w5RpPzAqZhx46vSPd
zh4@pdK((hBP^RA)T!*^VrQewRxoy(R+`9?!T=q40x(V&B({JoIqCh{lIN;cqcx&%)
zmv`8(Z4^fmzsDx*b&`&a-!f?x%*#?Jk;{i))bzWMmTD6_tM$5*HG*f)9FoWTG=pZd
zHmBd3P~gVe4;Z=(hse0=P`MAYbqrp`;T$Xe6|rms@8Y1FwhnzCV;=h8C1Z0Ph{nY7
z95jhbXSJqt5OLFI+2E%WH(ORytK8gH4J}ytG<*r@K<;9wyLRuB0VwNl<Xgh&fcjE0
zV?fEU_s>eoEGiRc2x9U#Vc{dLBK+PhQ9a||JLB)j_5J(rJA9x@^6DqDvBcskoLPAQ
zbAseHoTz#(5x@S>EDq~A9WSf#gHZD;0+=6tHI8>2K@Q&Frnvv_P!N@uaxMM9eIg8W
z39V;i?7W)TqndAIy(3_Tm+{}b0W5wbx6NR$fz)Z#yfo%opL$Ky68>4RF@9Kod=f+)
z&P_NtLez!f^!To1Ye3*hEDq(T4f1vS0$5z3jh@Wybg31*HWz;84D)SEHFC9@XYfT{
zk>$kPZn!HpJ~w1s<b~ql0qmfrX~JDHmHhL7tlzmYytXSNXMxN)zE9SC^8xv$wjUs+
zJbyywLwIal6^lRA>eiUp8$?+=>~d6&)2_{-WxByZxH-Z;vH0j5-#)CrcqCg$yzs5z
z$3WV!|KG6)WJi(x{G>-S6{(|gD7$MP!=$VQWOjiTpLNf)=##SwWkDY)wTv;&-W->Q
z8IUhgojxb+Z~V;Jw}masM!obpa!@rLgq>PN)*=eR+f=J3*y7`Ge5Qo-Q+(bkWu8&k
zr=}`z$O}!U8QAG$`8<q8Lu*Fi(6!tp?XoZusUE4&N{>XcMs04^GP(K_QPOA(Qx?4>
z^U4~l#*BuQ;AZK0qK<l*2$Y(n>>5%>WS8BKI`A#l+RE&x-usn5bdW)vQUt|TJS)-<
zW%!R$)uvziz&zVf-S=~Mtc}a|a2~UPiNxHeNPcb6mxJ|oNlg3<H>rP=JyiV2>h#(A
zVSLh)aM4$(q-y$?Vj-in^y`*clU3s9jLcl5qEe$UK1NL*527%r{g-lzo8BKiJtR#S
zW@YodM>7{c**s5~CFS*gRgXCDa1g)CvUE&nF5pnnL=c72m5oXnAur#OLa6*3Ei9|?
zl~ATPsi6jC;I{ef-AQ7Oc>UX!R_&*BqmFC#QQ&rs$}30SuU0o2*{nVHgznKOPdzq%
zf-_3jy!XMwS;6Mtxei+`=`!9Wb+P7Z-EI=nOi+g!*66dgZ5?)FiPB>+@vYC=JqR$X
zvBT0VyUw~~svlK~NI?^qzO*>Kydp1x^3wp<+Ij4{lxWaKcA#R%SAk6;la!<qUkFD^
zN#%GfWh3t%T~m$wz{&hLmy*gohE|UUX^0NkA$bs~9@!F@3PT+?OwFxF02l*v;a(|{
zZCdq}wvzL?`-Yjw^4!{MVT^sGs0tsyHuSUac-r-fzpdllbOkdkew3I{beP)>7#b9M
z^fa2N<8Bo=zh41$kkq-Ol88=!kgj^DbEWqkCA6vb4&>xhZ*mv^y@)vft;nJJ)sMWL
zy@kH&&E!Gg-4gUIHP~N{`LME}Qg`3=O-z(<;~nNoT-zvd5d{BI8o7c+>IM-}CLyDm
zpaM;*aW&S1Wp&A)8H6DEl;`9W$f+o{H|m7YrGuF2k?`#+Mo$oaf#88XbwmG6;`S;|
z{9eGE_?w;shdhDtfU6$o1!olN4JxQ{wl)yQv+E!B9tp0WlLiK}URd-rdw<S*p<X;a
zuFmVd)(cAHW1x^d6L%>j`!4T6&14)TxT#QNX3{bZ3L7`;>Yrr`6t)B#R_K=NOp@GQ
zH2~;))FP#BnZfAyW`+;}K_Xq|qEf=2iX^vretKjQ(YG!LalBZdSVDLt$bO{qKIT|#
z0&$-X2yy2{fOaz9?%!-s6a9?{529E#zfWU=`D2C$Ka}mEOU{(H7j#@{z=tfs{8omK
zOpYXOluuUmzQ(~h08Sh;EZBHsxbR*T7v|%YiD3T2_h-}(cw7=~+!fayXk1lo|DN{1
z(&f`<`O`@tUT|&wFV6DXjDI<Sz&)$mJt9uBWT`sj#Bce9-I^Y6^13RrUMt71P+(~-
zx$@7{Z(M7Hja11ZC1Flzd$8*+*`}^r!0`d-^C?Y}o1La<Rov!c%|&A_qpP`Y7@>}#
zdiZz#D6ZzVcD?@X_uw+WNeN8>S$l{5c9l@5jdtKN#W?`qd^9zVzh`!DzxflBY6*qY
zg&*HsyGW_;T6aSo?k&NN^0;-ogLp!RoGtVEWm>)3=OZgZ^q;-_Wxp$Xn(XnAU4yia
zrJr!uOb#AZ3bbhZLe6*!%?Mrg2!i6J+3WJALF(A5(3cm{N^O;o?m3^}3Lj(U;Nm&?
zv(&rc3_d2_(f7i6cb=;s=-QP$LK01pOYvL|73`V?@gIf*+bPFyfQu%5@$<2xZDHDE
zp7BFY?YL>3O06`>Di89g*^{EdD$nBxUf<xfTKALCN$(6vp181la5gOOPimwW`-9NQ
z;S5dQvao#!AFK~5oG8&6rY?qUjGG9DD2I4;BzZx50c1XhsC~>9ekaYDSeyt!Y!~il
z^~rYrH_GR=2;uFj2qh6k(m>?ETyRP_=@Hox1v=>x>0gv{6tjGiTCQ5&S{6r7qg28R
ze43wCrQ3dGPM+NAOlisH9kAyECXE!VC%Ew@sS5NB^S@8CkIIA0N0>lA6BGyt=l@k6
z=^NWv{^um?q6wvgvb;2H0^x+$@|(HW9|o437JG(JQBWX^a8HS;$}tQPB0QLs9C)y@
zi+ZV1%g1VX>2O!+89dc$v8~a{x{<HF!?&rrvGUW#dcEYjvGM%e{Yoac;o9fJm&5tE
z;@kPE)%<Fas9?y%ign1iDL*hCJnwcD8_rq2V0OZ|$iJkHUFGbq1uKUibwTZgIN;zx
z&2sYS#9-vK(gA{6%EvYDsggm7a0kX>vui|3KX(bssGKa0-ztS$Mfc1dB2Woj`SQWP
z1(mweL0wG>c=S90(*v&QAMA^jH1CzcFYxm*Vc-&)LYP<7z`Ut*gcqR%8dB9H>LwjN
z`=a*ptZw)o)u7E0YAUc_BxiwB)Kq<{bgfnmUD#$REIW&f(gC^a$3^EsTM}%!lqK8O
zj_sL5gy#bF4PsW|O1CL$ZM?`R&<m26XB}utMe8)GB4C6@5i3;B;6;>vJ(qC6(UA(S
zh5S1e<*sKS3ETTFl1RM@A?xE{)*D~H$Pn<%z&D7>RM_BlTnE~Qb*H4Z40HtoQNb{U
ztT6s$qD5NkW-VXdsY-YuqZb0zqza*rZR(ll2Eb*2a)C*zQydJRS0pR6vXsiCVevJm
zsygLLh?FUVYpb09ZuR-iW-h3!;4}2GMJCAuPeFzmnD$QtyvV2oZ}e}1r`DZn-Pl|T
zGKt3D%ew{DQo<mlF$Opd%aUP~vcD0(gzkiqfXnD9nS9Ml|2n>Yz_ke7Ng!taRlInD
zC=#IjSmGm`tZ;_ZN<)&uCRPoRP*uV}k8nXbI79;TVXRXtr%MItAz>p7NY9;CW(c7{
zYVM#W)K0gu6fKWa!!m94W69kKcTxBB0j4Ssfi`R!qam9oI!V>Jl4>rjvSmc}CF-1=
zv*E7@l$uvluema?6eush=LAJcmXlWys^7?l#;8ydDVkQ^-Cc-OrY>K&tbA~VWf-?d
z1tSs+B}2doUaTs;7wAyz4K<MXF@RN(-yl{zyM6tLS71@iv%-DgHusda_R(`6!7zY`
zb4offC}}M;P{@eym8jp$E7c-kD$zI<Q0ts*C)#%x^M0Nzt++SSVBTZ-LiD(vU<{ig
z_(PC-tKIt0Wagn$e2R`(W8y*>B_@TCpIlxDL?7n#FQG%J2kK;xW$j{S%V+K6lS7W&
zfte+N`737%Sc#fYmdJ)ZhWv=>#645&lN){?8<u2nG?Tr!JrsGs2yRjtU2|sW0f|y^
z0h@#l*))~z#x8FxUv%6TbU0kBb0kA#jry*EmKhhHVlKM0#FRVznrYSvOD21@pk!3I
z&~qmsTaUuR2|FD)CfdT7wj&0^(>W{Xc+44F78F}He{vy(@~=lcFk1lAsIOSheUIFi
z<CwiM=hoWEPKa9NjrW@uB%K9U08M_QSZ&%qnl6*TIE*X0oDK0BOeMEqxE2XIOhbp5
z=u{MW;1sDnjJM*3(}X==bK{^Br%VZal-h405ADLK@#99ONf1{SE!6O6y+YZ=CHcb)
zLahC!p>Q5obBKdTB+E{V!e&PpD3P}Cyi;OcSQI!1x(_8q;hrrbgLPiHaRfvPi&9AD
zz{XZGh482&Fh=5n*xyriVR^gi;O$BCCtyg9Zg3&L$0)^c`iJ}hGVoU*5fjcg=o^!S
z&@J`hp3t|m=z^LeYbN_#YeO(%IQGB>9nl^F6TMnmwb|%VqP}H4ND{x)s$|4!qscW*
zJO;D$Wk9?rz=`M92~AjHU1xCDC25=P6*x!>BCCM+@)T&7xAS*7V|px~EG<gG8ATLE
zDB%HDBd#;Vu^izQz&I<M8xcYVCDALIR*H3jdy-ne`wHvN=5yboVcs85G(~G*>KxFa
z2LtGS4}ky=M}Z4mL0bu2MRN)I|B^frb-5MNn>{TaNWCGrB`fc0OLJ7uj)^;xuoG!w
zVW`vfr#T4@(RKu(tAUU^uwkt&rKMpaLazpnC(Wu6D>RtXZCp@oBqG_r1|UHtQqRhY
zjrIe(f~*ioDN`znQPt!^)#L^$>DM@oZ3X>$Fv~17M-i+Zk&^Pwz?LmfxFyXPg@-zm
zLnaN^;v>MJTF9z*=Jp8cA)giPK;OWeTq#ULj9j_mL6l)nG>{n{6;s=}NWuGI`mm#-
zgOev#!B+~zG9+24U=#aBdM$TImJRnD<TZNbIFn_Es8FSlq7YbKS7h>3YF|2jOS9}}
z6OOns@8hen|DY^M5bF+{q@qYCz!_3vyt(9&S`xfyO7dAXaFnRb8IHdRw<71U0%UDt
zKFO&lI+43IBlvkCpAGMDqrsnv2DirpStyeXjagY;5Jz+f{<5uL0=vbDik<rJ5?6$k
zatLvR*BH<&NLAM`=12#{Ftfv%*Oje+Jg#O4b*2jOBEMkedZqUm{EFrtTSGzZl<2K<
zbcu#gGDngXo1^ckk;s#&Ta2)?pRq+=WmPSWi>B=->Z8Rn?MrwD`n9AJ7T^Dw-0(y*
z>_fGnu6Uu`hgYn?ue6`L!oQaPWSZT8Z%Sb<2w^K#r0Kfxikm5GKj;a+MqFd508*&t
zJ_8Y-x8hQ>l-e^g%!N9}zRxoP6XK-xm-wt?-!5>mk~0<6t0i%~v^%z4SgRTf!JmAg
zZW*E!k4mTq6xfH}A`yEE6t#ahouR<y*91r-&mUHn6&cbrT*jia(_lz04@3d9Z*G;5
z%4moWddr{*4X^<w+zHVd(GS!SN{kPaKmu)e`e5>vx!?CLxO*cBS9zYKxv>fqA-S9y
zVz0R~7^sm+Ka~YXEI5^Nxo$L!d2~t)Ed#B4=29{SVM#q3FL+`k?L=mg*Apr(tUgUv
z#DJb5rZMl@J8o3kKO3-#ioh*bkP@Nd+AZkI#OnkXt3Y<JuU4r1JE~H7aso4F2JDz~
zjALTf9ufsu{6i=nxRp-}#541Wap)0-ze)$}21yovaq{8C?Z{?=Gt<ma(_<gp-AX{m
zSfuliGm}HdpgxXK2;Ayac$is`&66=>LzmtIJ(fCXFWedNlrWX|^}C=ilrc2TA2`Eq
zxBlvZu6x4e!B%sRZflDynl<AIHG^zA80n#0U^2lP9<$)&!~%=lmvCng(?M^EK)nTn
zj!B*U)farpN`$jK3+_Uc6*LY5xucNx^D#v?qB&J<)N-1v3`MStqVF&-g_hKd@x;jX
z!9#Q9i}Lqof#>igj%fD+#3h{a6kP;?;sk*puwsHqyOUxl0z9|UVkoeiaXe|V!AfEP
zJn2FxlG_KCTAt}(=te+K2R1xxwET-21{2I$w<=+Z5`)UPnr@KxkWAU+VIZs_>*NWg
zuNC_jf0%tz1St!W#qutQexU?rluO9%fA|t7f-|G1{tY;7qOF~Ymc|Rw;cA}jE<l`9
zzxX``uUdE!Qm#VPGM`AUh;D0%!Vpml<~2aR7q?)gwnAp3eQck=b4nh0Ln(?WM@?wC
z=Z8W+O&5$yVsXmZ1K+<zt}_ll%(8;i5_uU*v+6-x8)t|SqC>p_4PK>hGdN2APk;u<
zf)<!M!iL9FjatcS0wkkUN_Dl4Hl#IH2&p}fDt2Je2C6DgfsN9gSn7&hikMqU_3v!?
zfnw6f1!cYpsFc+A!-rg%h-x`n#;@u1a&8nCX;fW;5I`=D_=|5ErGxp`)QH5QgaF*{
z7Xm?drB}h3E13pi4U&~8XhRe<5~rq`e!Hk3*>am7^Y4H4d$%s^b~`X0*wO4WHj!u?
zsDUupQ}Vdkl>qXyaYx>ev-(@wI^#Cv{d$3kkyXjc2<s?C4qJ3Yb5M=|2b_Gm{Io@<
zQgh{=cZ(Z*`ypowcBDe&MLzbD#>bd|r@3@iDo!%yx1vmet<llIl`vtyXrMi3Q&x2L
z6V8*ed#4+K7Z9vaPEHWU4XA;DIQbPu;eH5wTg7NJf%}cAtkn_$$38!Bd`!uVkjG~t
z7C*2IJD(1={K1YW{F=P4r{B1z+UrYiSvZA{g4lkp0gkO#00ktr(v%osta^mQw7)ZK
zgg`)b4LOjtr8FY!gB^$)k~z`{^308->!0if4KWm=@>@jJ0yKtz@nGyhWK8)n3*;Me
zAbZOOJONG2&N<DKUNGbUv!QVbxm6L1`f;iTSZ2ArLw1^6Tv!fdRxE*v22J2?gFyLe
z!VHjsMfMhf6^N+Hcp30Lt&Bx@5pG1tsAyLz3hD~W9<AwDNmA1a;pwyrt9DJIf>VEc
z;vH?vp??<a(LQL=B_=A+9g;oTwnNrCoKtdYt=0xSbOp>ia==$wEP9ZGYE{h3y)X6A
znLU}%6OU#cg1q+B8*q&5W2Lw)^SKfH!dF1pPLMlKjva#aVJ3^J#JTjS38pH*MnwiD
zKQB%igG7)kv6wP6+w@kA($pAY%PJZj?2(#`1nR5`2Y0GTa5r^-(uUYKR%klDJ}p~u
z+1~lwvk2J)rNRS-E>u%{r-h<`n$)7_c<D={SbG=h9gHNvJW0_t0-Q|A0*8}i{2K$S
z6}T8|mQ~c66KfKvKG5lyR!s8XB_^1ebI?9j5pF~^;1sXYU$hBZZ5R|=@}7iqAxn-q
za*fvM%mgk3h_x@)J)lnxYcbF+CQGQj?)JWBeYnl!APZwxTueL#QD(3muQ%jp8)yUB
z0|I=3p&PAHicz1do9MJ|PQ(VYEl<G70?hO1WTcdN3M2YY5x1fRlwex>*6yYF5@Ozn
zNb>3Ggt@&gPYdoYNYo2A<O$P(1<)Bc<F*772DxHRtV0lcQ^Bwtj(~&S2kgn9v-8wP
z<jH`W@T_FPu+b_)BHS_Dw^{mF9P=?_kT8GC2T2Nk1@?~TP$^X~!}mfrF&swOz>h~j
zIKj!nCz0le`WvX5`kqh{GX$Q>v4@C48n;A5SuC%=2Gq!u6~&PfTrX~5mlxG4mZDqS
z6t0jB=%2Gpbe=S4l2qP4HC)O)*ef)MrhxxG_z3Qda1Ay^0UHRaReh-Q&3d@%3_n=`
zP|dl(<sdEq!pTXCYZkR<h#ZRt?ocAzJfBzr;bhLl7ablYmj%XUN5C;QR9P8VmZgS|
zcb8s17HhX4!Rd?3eDFA8=`}@O02CNDH4nx?9hk+rXJXI>P&OFtL~1s|bWZF*uX#Hz
z@_xu~)eW+YHj@p*oLYaI{Jqcxn@OVvNVd@bEO`3opb2^D`6qdq7#tQH9Xgui`wwfy
z5`ugse(@<ICMFVN10!Oz8{-KhFE#{t0dF+C?U9Z~_5^q6sYoiqe8lC-O$SZ1onMXo
zk*)!0L*Bh1H?Lt@zjGi13C}fnfjdqcS;ab}m|B|L(Goj*{kp+8)O<u1u;K6CKkH(A
z{J8H1n4-I_op499j6)6Sad7KI_os%xN3}IGG%{_Es@U()4Bx?oP1EFDHf@hs)>a-G
z@|K&@-`7VbY=jZM47Z4tx6Sz4V`Q+?F(%0y^N`rAWWoAAP<FXqxzUGY#Y|pSjpT7s
zX5q{3V_}9RPVW0Umiquw&mSUC*{+7~452xH89P~NyUPa6((s|Xb8K#<PvTmIcWCkj
z3wn*s`P~irk`}MEAITI;aNO~0IG%I>cP2K8h6ib*2ywEm7dAT6t5%69Pg5^08e4Vd
z>ULc|#>-Eg{A|x(n$Nump*iWN+ZdDWO8V(eUb803eZlVt1YZs$$NkEq{YzIkOCRIg
zW>qYmYn;a0`{Kr8dg~lJyNTal<)lqKrao&J?!yZgzdHE7)b7jraoDX^y)SX%qL~=d
z(!9zH#eL?k@?)1!oTD?YC$>9YCa1e(;pE!i_~mu@$sw=dx)fG79Q$k3?HF3sZxO$F
zk9R%?zkMIJR(L5WIv>wYueYoGsGpYRo;Sr)yIAjj{;6M2eHo6ogmM_?gwu6*@^xOE
z3d4<lZ@66du4{+Ee&;VYOyH_7Y#&a~y`}p7zP<ywDl>hy!%LU?zT4b8RlfTPS6o`&
zzP|V}N~o7%&nit<;#T244+>L8>9Tz4_HpfGbeYYnl4m=0PcE#u^2~G2c24#=?qc&~
zcr45GIC-e5t0yr1u%0eEOO0zXM~<ai#l&5qxId%Y_%H-P`5rx|XtU>0b~w^689<m4
z?MzJYwLi#L$ergXt8RZE^v%iiZMuoDtX(XjCg@_iy-M@8hu3^yLhF3fh~r+(w`sk4
z#V+DecKc^sYbbs{nCQ3`(?0zk*Y$R@QBZH;HJf``kB;#D8%JG@ulso<Z!oLGoq)~W
zLuoKIb`7iaWO6WcGA14=HH*c5LKD4n|K7Z+!Mo|}D$W`Z=036M6R_s<kVm6*(hL}#
z@ZOAdzkEO4EUVXisy+#sKr4u&)4ttp72mw(r)^!m^*2wQeN=vjk!0aZ3+J%=_L{_T
zlokE=CZ_9qJuokM99I0%*lM2idWdg5?`E!popb+qxjJm!e#zVHx0xH9@twvwoB77-
z%Fi9caQ<oh`O!JmY@Vh2eJ~tvU0pHPh3>sKR&~_Nuc@~EvVHW)!LZu>7jV3<zRHCm
z@9Pb4r@STpqV?Q3C0kd=dHDP%?vkFq)cRcTlE&f7m3S}E%`B~daKwz>iE)V4N$oQr
zuzYql#YR&(gf`vrvNKc=$J2M|OvO}SCy%vYeZX+r7kc;+N-z(f=Ds4Q!b@4L>j9A1
z8{{Im#5wnRu6NJ0kJ(IDXXdCpI+hpLeR4hbW-C9+>2J$E{O&Nd>;D|P{`;n5UUiId
zQIYn!vqX`_!Y|wE2AKcX91Ypvp4bt^kl95W^ZRbC=OXC5Dn{bcB7^U3zr+rQgwM~o
zcbnt7mC0ns-0wXHm>=+Z`R={+dHxmCanK5X%+JT9_fB7LxHxz%uU>hf{xP^%y{uR5
z%ldkgv@j5Dsf=${#pT`LV3_~Z`{7)4U2|Dos6X!g@A<EOH<u>BC)YXU{bc~7{NLtv
z%1YScbqvm&v-NxrOUadcxwgWaO-}O?fUnAWKFnD!&bRoxAS1OI_wC{4NybO@QhHdZ
zdVwdk6mRBmLV98kZ9Tzjva&j@@t`xO%8|hDu;uQK%WxdSeOvS9i{I*t`6zWTtIb!{
zA@ID>qBjb1dxf#eP3U<@r`z#rz?#Bgl$}e%DNn%a`_}x?b6dBwYwzgNG{{vQ!biKN
zalPk*yIQ99lj^Hp{279jfyMRvU{&5M^Q*>Z7NtoV|I_WdEvq>c;LNb^Kh>W3<v3ml
zm>iVLuDr{F%$Zo#e>0B5sPf6uuh>t}d$EQ*&EB=!yeoEV?G{_2$k8*|V$IoBS?cz@
zNQXz6XJ_YW^&Je6%whn1jrKw5<J<ZH4$nr^k&RZS3HZHlmNPxuvvKQQ#?QS6dU}K4
zia+%qEjnKAVa{RKnDv{vY51VGa2`aqR5r_oIsS${%lqEP*jH}CAHX6@cYQfOO`R<-
zTOX%#eA^m+#kY1p`C`bwx`TT)(K>z?AsijOOQ}zuvW$EP{uf){0GvtGv>V&j8{4+A
zv28oq*tTukww-L8jk&RH>*o9ZTes>~{nax)eNN9*%}mXyQ**kXr~Q%+-pa_4`kbzE
z8+>?d_4y0<od(L=)YG0`Qs}5+vezyf-+y1#AY@_cbO|u}ebk6ZtEKY3Ug^)|@V7sf
zjF)`8AjkdPXg^Q9*V}t&l23@ckf0Lnb<)M8(yy?(q?Nnlp5#05TPHOyrzZqApK_l%
z4&;|bjtCa;Mm-9B|2D;P8oZDChWrn>&^A$50!<NZ)ZDG*DNoWGDIq{?Zpb46EDE3a
zatKm(5%O}<Dtj|W*If6SmZgcuDli@mBLo@4P^s8V5gAMq+2n;#(NI#X1W~aEZB=9z
z^2x;fjK0Ttcl7gK;5gUmXhs!n<Yya=X0oifW<l6Dzha`3p=TK!E)keIVfKqxEZP2x
z7yrd&*7xw2F-9rR>`7{K@*?34tV#L|zf|aqM5bpkM+Q5I#A(umfuUFPOv|ijQFRK!
zqcxB!!4tPh?~D$P3Ai+wD)Gz8tYUF1m%$}`Jc-+{YG0#!`$WzYJ@fN7p)sudyQoA(
z1@?&-r}74S$J1IbO_X^b1t)$qj#gujNZS`_LxX5~tr;|1DhBc>qu8>3E(X=4^Fw%%
zxax|1=2AG7(J!5QiZAUl!Su?x32~*)5_0&BhNc9u)LJpsjR+j!doq-W%M{{21%p>M
zgM-n(*Zy^ijc=;xXz3&>Bm;KacRweuj{LI-mWEE-t-{kQ%%uMPOhQ(M8x76jLn2}>
z^a&&~1zwLIS1|a)a+b9_8rBmMcbvScqHVTyiACBqp*y$HP;H8p@Vh-lT!-6dM%_HB
z3c)Zcg)lsdF%TEONDvC4x%VXU!9mF9Ekqy@3Q%=9qxBwkDQ5}^j+y+Wv4)Z8cZiv>
z2H2wa=<yBk;%>m?nL?nu2XSSLA+B$L32veDZo&0$;RS9`onFLzVH6PP@(BY{6^Uw!
z*_vamDq;)KNV336C`I_3qhph#DNfPg=aJwSOgp7kPRTb5H&~^NS>;e4(#cP`WanT#
zC4Z_8$u4+hmhe1YQeD4C9ePb@vk~0A1`=IAriLNGu&0>UkuiR|QMqhQe!&0#;gLRu
zvDga+AfQzhARzqzJv?G&=V)u_{ND&ku!gP;u6W{6d6-exNUJ!GRPqN8d&WyxDJ#3B
z_LuapVstJ?8=6$WVIE#0Nd!ArahS-)x{IsNIQjVn4rJefp?^<{!|I5Tgg;AQ*9adD
z@W*ekF|Ydm9st4sNZ3%1uFEqVTXIepVQOhr)%kN(<?kMc*NFs)gR}d=i>VRp=XGaN
z6amx-(XSvaIpdDg)KqP`1?Pwj>Wmols=ah=nH86_lv-=s2JMp8Qw>-1s=pUaaBAAF
zOU|YXwrr5r%Z{6^5CKEY>JYf8J$tnX)ysvGW<|#1F`lD<=BsAySRPW}lz%O)Y#Mfr
zb~<dhF_D@*OsiH|99_%##;V$KvRBPDl~XT9skUl3YPMOnn-0?Gqs(^6spr2b&RjR(
zrCoDs(Jz~)D?`${T$gIvE;P)SDjB7@cS3qlnsC$>8g*5yJA%-gmRUCxCmpop3Xjb!
zhuqeT*t_zr$DZ4j*=)Ow0?u1E*CFsZiJlU)s+uE$b<AzcmD;3xw+5_+E?lbv)OhH<
zLGNpR*@k;)pm;ert+n9!2~n4zPqyMMv_Md+PLaBt_0^kTP`&^!3tjMN58$p;rlco#
zuJ!kj#86vis+Or5eL!VzLVO2LB(9w{R~EFmj8=Efm3F8#Kx8gqrJFC=X$EAtbeU}i
zc(ZELPZrvaw=Ovp(a2T7BHOfXwr~oTSw$2(n{<KGE~zdg$eNb~_1{>O%vEm1)6}eM
zq0K7k#z158h|o^-_9<fYA?UG73*R{wnRY@Yc9@n}2V$4%4((MP!Y!s5yKJ<m(NfTN
zqjCMZ^t2u0*kI4X=rrY4gy4<e01>yYq0Y?C#yeZj`JFW|Q@JaLDLC6=t@!(E*+6rT
z9TB!;w^^7I*dnGg>)}~Lf}1GTP!ZKIGOrjua=k^?yk^lVjA+Frt*ot4%19In*B%a*
zf1}YV2PLdcr$L)O&@ZU)hty#Zo(bBaQU9s`pqQ0xGiC)S+TRIc7r~`^LoTNV3lBmr
zCvk?Fe_0bM3$9tJ>pXQG;XtCAXDEC2tesD)aHAG@M@n{*O&W<MX$c>Je-9&=SwrSQ
z1~huzu&50Ru0J+8Vu=T@xywUXV=hhaC~>|;$RwO`Sb3@<2N~f=2`epP!^N$oxx#A<
z;IuZ_;u-dwN*B+y670+^0*|WGtSN3|qx)OKO{%Ac&N~V~?i~cH?76{9Pv@02tJt76
zt^KIBGB7K|Wr@`7G@UX~x>OD1nNc?|mw^A|NxH7A7AO_JX63vD1|6$u$9My-8U9Le
za<RC^^aq%!71SAK`Xk@6E(K)a-$tsb-EGiZ3;HtB8T<Wi>e`7`&h9y#1-D@&j*2;_
z3vf+SNE$dSOTa@dRJyIPF7+@!hE)WSBV1_Mnr*w)>@ho0=HJNrY=^$7X{)8P2P&u~
zzwnD^=msu?IS`dP;m-$SiCt9!;^^Px$+S(Ko#=z;S6{w7unCEH(G2tG1ShnZym!X@
zh6@i^Pvb;=fk~;@wb?l!rx%>V1zQ9cx&^yRT1;JXKe12mwCBa%uSXD5b;$TdC>*vt
zwk+m>BQZ&tx|o<6M&Kb!6X~rl4pa_;Xci-D&1M5NVp&0mp{|w`c!L0mR=hQhJATmO
zT|E=f;8ASl`e_Qz_xPC`=H2^A29$x`n1m1+dNZ&GyE7crXmA*AO8#_-uSbgw+c5Mw
z$MHNl=mdaJi%%&ur@A4I*Rc?Wo$AC<4yL9DW{?Ln{zd&2+<A;I-WF7N5uZ`JOBG**
zAuX&{JH%VcJIub}>x3DNMIJGp_ps(c;D|z#>N!aD*^{F+?xeIu56wHuMro``!A+xh
z<9nk(SVu)sw%FgRv0kA43LU%akh43nZ+$QE#{IRg&TGJW+Gj^7bISAItC`;Fs7KMN
zH9g!*NilQzoXr#;$;rzcDYN&ZpzDvnbB`BK7e^a|iw=I)=1(IuHuCbs?<i$aHJRuU
zGT-Q1NK&F7&$gt*pST~r^i;XbjE(XM%}LH^Ihw*S09hPv08^}_C$QKe96&V=BfbzL
zK9!mfU}~mFRC^LijZ1Z4*(mIWCBb$?Oj#<nnigHC^@J+Mj6b)Ve1)c@MSt&cwP48|
zZKeQYT3f(nD&mg-;_3vfHIcrcD5E|ojIkH`C99N#3L%ASm7BxpNfEsh+-A>FX<@k}
z7!lo4Y&Aq$$xz}#O0$+3aL}Y%VdG69Z40V#@Zh76`%6!Axp5;I)l*b?$M5i5g1Vx_
zl$<l5ko(hIx0Aw#o}T~BN%6Z^L8bClfFXB=PdfGcZE3rgc%n}Vao=;Jd?GZHQR!4z
zQA7{7`aR2t(l0UT?U@-wOsD8*^E{&`es69bT};^w71V$YX@W~c?w>l^jSl;X{veZk
zwnr*S<b%oE+TN5=%l(NadUOSK-eI20-kV4fC2k%W9Gh-=;9Ho^C*Pqw)FQ<!EskIl
zv-0{8_m#Cwz_WW(WZA19<mie09TWCfK=g;;;x};w!Pp7n{C#_Czj6v=<e1lB4xzD?
z49ha=nAgN|eryL5kDI)zc|xSw01s(*1Qo0yn}FGgeQf!>Jd(x@SsN76_^Amm;$(XR
zAxh4E1cd3|ca+a~vFdm=AZTWjv3KM|?Y|1(2@%3tprxbz52TRVv^$wcpI~ynG|ep1
z&5o-m)h`*qzpA0c?7u7#z5=Qp6|)mD%a`12IBOja3c-Si@sDoOlz#;p#+fsPXoPzB
zqw=;8*AVafH2%`?5waB0wCq@*rr~W2A|I2hl+uWy2?aKC%r_-1ZT6yA*)bt*t`Np+
z=I<!NmxB|#z7!)A0X631g)zJO1O=phOC(7*CM=HOqoc`@##~z@%FHrB$2~?!JXPST
zKR^LVkz`(o)!!jWpyK0aL9(=YadI&V=LhTn;!fni9%ET8aClS`BgN5{IpGpRmv69W
zF2jS}5QNLgx+jPB?QI0`HhdDVfH}z1M`nFJ+3n2PVOe;)L9Lcfn=BEb)@cmKw&akU
zfhfJ?=POSPmJW<#)SNwM@*y!TDrKG}-SaHWR8#OwFoY?B>Tx?jv;@zoT=>$o#5;sY
zyd(!J?6v&spuD4yYOL<4xI_`-;Wp(F7Sto8^ocYx$&;M>f)^Z$rdU8s6WKBDdD*%+
zYk|PwK)Bmy84vKZ%amtlH0X}v;r2y1LtCKSZzm?fE`1~Nft=t%z5LNkNtZzu{`_+S
z9vY=ucCY^fI{-;ye?8J!DEXpFQi3yrM#+dV;PO@x{ESGwMg>j47+Kjc<_h8RCV;}<
z&PB|N<DMupM?7a4fLFkBK*=T%+behXz~&g8OE!9n?HHI#zVLv?C0RC3<r$b=Iy#Q+
z8J%6?afdT4gcX;#Qh`vA9jG9O5@a?G$0vjG5Fd;vyCCCG8otOoT}~@%5Sz-!uq%Vt
zDW#b2M-VmD8O<KK(~A;eDIbk(p(x*QhsWr~Ih=QPD<XL8`(O+L958DhlRdGgCIc_5
zM9Mq9jFjJzr-64R=^ptgJSNLT#L1V90CK(JM|m^x>m51c2Uaf;I~B;ZO=^gWgXb&8
ziZA$H)i4%kkjfN>o|5sm6CeNAmpS1c)IBN1%+)jB?G5mEm74|z3HZzqo_2tfxTdh?
z%LxGbc-06Y?q(`z#NU&6*IVLYAooNBX(fpPwFaUv4qRvuT0m;lD_Jqmk+_z@#vrqV
z2o<7v8S#WL+`v#Djn7*{)R0?59%EdG*T`OTZ7aRsm{u<SHmN`qc$D<mT`~>h?tA{;
zYD#>N3c0Wt3K{>|*tzp~E%<sZ1F5-`J%7oR1bKS*k`eY6VfYv0`+5YD8iwH4njZg`
z_F!Fz$w`l-Ga~sMpV@FN@yBY+D(M~-7m6T2X|VqMc=ypaE$+*YK1{(h7;fxw336*e
zosfl?Hj^N=$5#WUr~cx8ND1y^QZN3dL)Q2=zozR69+&(!Vb@7@u=zf6P75&>D*nt+
zaX57|f~5C8qBH-aICo#N5h#uB)a>gXp4>p)KMeTf66C2ouJ)Fxp?@-S90gT^PMnB5
zb^iIrY00g@+rdj!_1rV+_l0&j#CA#x1*XjM(gz@)>D^)i#F(dH21*$^g#;=m?+462
zakN0Mwr}(uAO~WdqP6pGV{D!=-6C~~WLjUj^oee#=oU71L1*B1_&spb7bvWaQ3pP6
z7@X?l`wt+m{;6c%0V5Vge1ct{n9zM>>rlZ|)Voo%2Hu={F!4S{plcJq_(Uw|A@LUA
zYyyo1_E!g(!Qo(mha}bdiIA-b_b%&&6s!#9+E98?vUyqx-u(4dqCUXTf;bZ&;&k9+
zv#&sp@c6OHJ0YS(`0-~XUjXfYZL3q;H#FM=x@kae@=$ykYO%Y;k5KUWL30w?#+n+&
z<n52)nn?p`$h*1Sn=mU`F0fIQb0PWm*#d5#L+r%|37|q4fdq<?+dsuuFSlQ`gvOyb
zPj**~anzCxL|(O&lM-COa3Pj&7~Ag?kdV@DM*q1mL7S~w6CZr;_P-}WZRiQuWahm)
zVm*dzeU2Uc>#;&7s(rYkCkP6r9r8)(0U&h)B%o(787$pJ2iXwwf+iI_ga$Em$~<J7
z!Xg6hLSby0n82%gIFMlRn3QSVx#buag4$p<c5C)~F>Y^g>*3WWxR_+p_`LC*Rh*&g
zZrU;iw;`yN_jWmgOr}K|-&h}&(A4%2fyQ=|6ej4ylWRO*=w?+y{(9=D_e!2Q65Gb(
zL|u^{>=UoDvCHD#2#cJ;_2lLbDf3c0X+Tn?5#}2lJo5G=Jl&W!bRrvR_-j9MM}2Mh
zyWn;fht)yd4?OM24&|~~&h;0#1O-D-=7voQEeu5&Y%*(@%P){)6%@kR5}5@TOjpW4
zHh+*nq3IlMmZg;07F*yHHQMOxFS3KX&aV0G0nBitMiT2~S<fl*FG|C<!F#F?c@`eX
z7qSAksVc$aL!Kq~2$b(uq=5cCV->Dw_LS4=;`<WRzbS^g?wlU%BBuZSO70gg@Vu$d
zivpwZE>DUT1hHvi{*HHmqHV|jg0j&B*X~?cJY*VM(1z+K=U$_8%?LZjaeCgLbq7;?
z?HzaA7$S>TfwXno>-?iwa>pUifq<VZWS%Gx__BbQwfDBO?G~V|6GYSa%P*tAdIxh9
zKfY3fMr3(8&;?#6@R5PnCZHGM<edyIL_X1UzSzwW>K_?<56x~DM23Os(>Tc+jY<5_
zfbvmSvXB;`8FoE~T%kRpAPMr$d&(`q_`4-cU658}y=Qu4AgKOK|D_$%g{jDC3R%Sj
zV}=&T1C4IMkCF7l4Zjzm@%P|ySsC&th>Y{eaj}S>h|XI^umEU4b-=++tJJsTV4sI*
zpTsG`M=<6iiWlM03xUQ>%vXYMHN#C_7#8kl^yoWQU-)@og1IR|o<FFp#N-npJoF9N
z&L4d|b{(c(G{k}J%7~qsky=d_v8R<3@HcePueRfY*ekDg@ZVb?9DQIMevnNc>^_25
zvydoXn<Q_9ZGs4xjyN*kkYZ>I?@mOv#f16CaLz69K?fA<%nN22<FnhK5XsD5ErYL4
z>i4G!%m>HMyjL8C!MwrF6MU=kpi71`XejoolIImWhD*SE2)TK|3F<3~6GOGt3w<1S
zRC+`mc8OZVb~>hhO|Oohcr*>~nY+96*&CWb;KbaspnTp@1Tr^4@eiz#gV=%-pd~g?
zJgUhP0V&@<C4IiXy)~iJ(MHg7OFh>bb7J8)+X(|>Hm$~ISGkL30xg)j&Y`Gd={qw;
zn=-|UA|lm!=VBz`n2;5_C#)U#kX5?v#G)zivDk7Iqs@8ua)wBb{FXMGnyQZ8HA=hA
zma3lhdY=29E9I3xP7FzEP>q5Z#@-v?WX5?dr;Q^C7A_c4OKCEwYEW-|X}1`f<)6_6
zt^&#9xae4Irdh<_Y6s-q_WqexkF<Hm@xb~7F{pgFGx9@6|2=8K>|nE28hMNY_fkwa
zBxAoT#+6d5Y>$=fs)j3ep>*Xc;5sUzF}zR{#zwnfS(Cy>E5SvISs|CMt}x4^gZDk^
zzj+AV6`MC50(f-~{8jSC2ji?ZyJ@<2vYyoPUP!VnpiMQIrQcjjd>rdfu?^Ux$ZYTl
zy?~Z@Or!xNhmX!J7SC9-%G+2l&)Z(we^Ik588rld$1?*IxnFme{uJ3jUoLf%YLfL7
z(}XeU>Z&f;co<ajimUb=p8EYxJpRw}2^>N|Tno~0`Bd>keVX6S()Ebi_pY1#m?vYA
z6}7sLSKIGu5&zv=<I_T0b9D6>`=dKKyJfuI>0~DIyVJqx@w2%beYnq(ls}I&g^w2b
zsjZ^E!dru1LUcr4vV`>o+>zb=bLOFF=r%TuT!7oPc7Q>}n;*gWciRBNgqz!>oN}v2
zV>k)DWSef|8e`{P9|zz)QSxbI3MUAaEvLN9;CXjs2XmpLIp{#8e#<Kn-=#IysaNDX
z^^Z`L08er*O$}2uRcqZ4zt8*yX&kijPw^!rRF)|8Z_r?_HKrG`nx_&Qm@ku%!&MbC
zeVBKQOW&%cD-L&oh9I@HiIfMYj6J{MPW_;fLyxt5upkt;nc^2qQvC7A0xO0C-Pw!d
zRQKvNP1&cLbk?3%Ik=$MwB_D|o_hcR{xuzwkT>_3ARG<t0t*608IA0pPdu<*;oFe-
zT@I)!8pyq+kv*1r8{X9&bIC?wmYsdJa~8vCf+g(Z{&b!yCx||&Td|#I?Rvd=bNy*b
znT%_Uiz?movF`o;ZyH*Npr&xX+nPHncRpM^>e79B!`U}H3m==2WE>iaR42&bop_+B
zI<=4PmMl*SMvm*3c{X(Q{EYZnN?+e2reQ#Jl7l0DwQl7Lc>FCIFFnob%Fc=T;WE|-
z&Im(x%04dEht>!K$iTHh@;S_tBhmrD7AHHhg&wTCeJw3wk3-`=hrUf)tIw^2!O;Kk
zRVO<~PoJBIIc%X<?{>t%lUnc)!t%2K^>~TBd!u)HhlAP|+UzSlBdgd2#|)#Gg@a}*
zE`!+Yx1?DkTN|}6m6=@F^*^;nJ2%t0C3?R#S_0vJxpgj+?8+E?*unF3lFRfwOkN$Q
z8}imG4D<2WgoHvN88kq0ZiD|K^`UusYb`<UxQ#r~Q+ve7X$Q8Y?g14qC~!SA*u1q8
zhA54%4Mi_YrOkO@+RR~l(gnTS=+1G@`CouYhM;~}!v&sz6=-j(U9>)kDZP1vi0Rsq
zufIY+pO`NG-tq&Sulj)A8v0BNhD@WnQMJvsdZwPy?>rxl4{PENnto#>?R}}I9-wS5
zIA0DvI_m^5%1C|4)Huuwbnb`igk@}-;$VsAW$4tPodC%vpG*VrY%?oi2ZC5)4=w05
zLKb9w#65MGr%y2K#6%UFOV|q5wNFrzQv8>sJr2Q3mR)Pa=Jl#ocHOB4^%m#Rr=fY@
zax(#o8%SVusCd;{wUEYXPzb+r{?$nLfd!IU)f_VctDCTM78a_;iS&#s2*y8^{?W+s
zOlo9*G!D<u<7Sfv2xRBXQ}#HBoqsVxh_yMGzv7)fGL6^;W}6GmjH35-@C(r8_zB-?
zGs;ulj;ndOV4hD)Yd+V(ILRdH-fFXv2PdZv!r2PP02=n%P9@u615)dTnB$kw#XdT?
zu@#ncf;QDKFUrzgexZmrh97vmS7R0OrMT5sWQ?o;h64@kI;GP&z#_k@UviLM@ov02
z4Fonuj<m`Soq8dXyD|a%M3PW{6<o{jY%^l#%_(6I5@`uFrR5O$HyAaB2t&ULUp5VV
z@q;~UO$7d;i2Cv8iJ<)xnR>s#)Ucsy>^Qm&+<P_}3SmUo?uxJ*3nklUpzZ~UruR=~
zNV!bg^j!g5iN9li943AiX4QXI?L7w^3EMnLt@*~tn$y#4SYrthu)Je0ly@XLiVgUp
zznz48r63{JMyguBU97}Uw$d6hRg!;<G*50p_|dKH+C^^10q8+4&%xi}@#<QDeyznG
zZS{*J;BTpX$P;#A751vOZj-jrJgwOct*8J9(EWh4a?cj=Dz{{og*+2k?b0sXB0;f3
z4Gx8JK)U@IRl9<dK>oC;_a()V)dUX><XGH_aPx&!U&#e4HqVlooZ4eAxEySw`(ZIZ
z3mv&p$xsI<({5aM4aea{ygYVA8&#ql^gknOG;|sCiR&=|U&rk+1`)k?pFePuYK4tz
zh^y`iBr#nr){lENQYY!0()31tB%Mw9qiFV{Of6oMPxdDid+S?)`sKeEBe^ok?Gl*2
zgK{4O^#xp-e}ygXJwhHSjoOZ%iumDSuW1Uq0EOV~yhjYf@&|uJ3an*o2i0Ub5y&<P
zFu#OF*8Tn!x*)>K`XYX?iooQW>e_@+R!i3XLS>K7RIK%)aVsFwFMabOx%Q>QW0d!)
zsTEz+{Y6_J>+b{{$Pc?WWSh|dxi#vq6&Ts?mNw&}J+Jc3>beHCjEIb>H~!U36AcW?
zoxvM~`ZatDV6Jryl&7Lm^}sH>qfM<5{{?@0hZ)%>CFvB5ES0{IuB5I8p!&)-3lU-A
z!$d&Q?h37SO~A4dn4}Ir4*UJ$G5(c4bC?&|2h_qa^!i0}{myOKd7`Z+V}*svL-nPk
z=9j<o=6ahj0n(yZx@V?9cW*cH4fB*n!uCZ$Fq+x(+Z@f0Y_q_?Z&y=&%y5hKT{_4Q
z*fl>8td4jU4h4HFyq@_b4g9?dDH%V@%+L0w&VVq`Xk^8Ifg^L?7~-2-Rrz*hr)~A6
zFY+6nS?7mMb&l}Kvxi?>BrK0bRPL5T&@sgrYG}q3{}k?JFY6#`reD;K{T8D`$ta#q
z*=z{S4|ghcIMe{zo$?ETb|G0MdtXROl>r<k4qy}U+Gjkl)Jv3^2uc#Vct{t5ajlfb
zks{VDRvVpJ!!&0v0w;fih=DQ9O<d6L1*&@dRzZqaWzH;8UGnn2YLLMitQx!Qc)!V9
z5etzS>C63q7#_l+;d2L^EN!XvHj2bUJ9TkGv}Oq10w7R?7h1C)w~6dHU=%2wU7|t(
z($ozg&g+V}p6zxe<*R+6@Qj?-wY7%<a{_|~57^5qeZ^$?g4q<Do&Rf5(e&r^CbR<p
zwH=FMh$SynT?FtWGQPLg&|2_NsjhiBW}ITHH}1t-!%2}!0GQ-7)F*Z7-THz2es~ol
z!Br6X5WMw62F2UtJ{+6#C_>{JVYQ4O|AJq7UU-s->oe>~8aejs&H98I=>vMVzU6Gh
zi;+-ZxdRDC+4VwtD$6*XWHqJyLcg^Tovvd$6aO9h_D!}((LYvQtjNDeiI^5LybYw%
zm)B1tMgjrHDiwi8+KqrxyMYt4B4)q}^Ruh{Dza9LBGPhJ#f)*RY4F&diyh_FRe}y0
zu61`<hL12D2Wk=TR7G7knTaH&P>e3gu$1*ISLFv3(97f$4qN10q@()#Adi@Cs9+9C
zSlcw`vQgt0hcmslrv@PD+8bCZhdS5iV#$S|UZjHyX9{9KYFSx96l2aj1DerROmmFo
zB96dbAgFt-+;I2m3#0g7);vARO0zI*1{RK#BU&Eldty4-%1wmGG+b;pJ)6eN4lQ)f
zO7;VRyO&F~a2xHChp`6Ox5&weQIJ7O8ML;mG(#efyWE|PtszQ}N&ZxJ!%yB%zs)&R
zAj=IJe+q%QHf{3-8{q9$ya2b}p&mGZ$o@myfHd&rJuq9Qgli#L35QSCfb4C=(|SF$
z0QE0gh+9QLShg#tV-8eNFgj@KvSSj0#*C^P-GiT;1Ix*iR_t%4_>}~QOiEV79#WQ4
zcNbBMQgosv6t*0yX^{X{fN~zV4e$Q1oDBwb6kfYHntZu12EM^zPl{iMiheML(G;E7
zP&SsGX_#D6zVcj#h#IL7$reWga7bB9jd`3cW19(Y(u|t405|u3a;AcoY!QIPAsj8~
zqZmxy%@%^kl-c;()4~7g%OYM>DjM6Fjc_?gFKej|DBP?O#dzSBocA|7S>}|Lh%v~X
zt8l@%Rsmf;QXn_IXqKB6K+_rRe6E52#V$o`w7t3#9yyPQh-0bB=!5WQ5pWCwCt`Qa
z5Q3<iBtpkh=>^Ci_2M_>U?<Vdk;PTg6Lv*K4Jpq?3z9E!u=t8rpl6n?1hMm?(NMJt
z{cdqkC*C+6hIN@uffyX5D6OeWkYK&&r;4+P8J#_caKl8~ih=lPVCSCeSY?S#nJ}a$
zDYmSQ%v}6~pKtXrd1hMKy=S^5Hjm3^G7@yLonm;TZGCeQ!-zzetR&Cn7wT=YJV*s-
z9k|bP%27Ko2|BD|g~qX90#^kB)tmuBQeT#cWY!OHg;3}gEst%ZZFPt6sq3n%6PA6>
z)U395UqMt%sGKyHBFM%_g%c}QXQqLNkwx9WEIGC(q&lvv^r~i6Yl_+3H*L3z(JoyI
zB?-{)Kl^GvbIZ>1$F$B!z>oI7!0IOhF}Ba(XQK`AHF>7ZwJ8Kl$+QOcF>WmA#1GMI
zOY1$ivgZBSl@lxFI$eq_ZACLHq-4PBv~SyEP&QcqTqj%bV3-RArT;@<;^J9fUgyg+
z3%A7SZ&ocEs6_8{h*cQ0t$Js~*=lug=OJsAK6e(8utmyHJzx9GPp=(z9&^NXG%eBl
z^D3PNN!PLK(A-0`o?Py~<BHVGfyC(&h(NX;4wT=(_t;%~<)KNe;H8FN>fr>QNrZYM
zwi$3TOGZ52;-f~4Fz`}|qI%N{nsq&ksXFH+Te?-nkQwmHJG6<r6eF!RfVy@eRIj>e
zPYRQQvc@QZOq{DD#-%e^Apx!5EEI+30tw5g6osY#=O5xSJ<T_e>8&Udg(V53e*vk@
z7)4ML>>@Z#EX0DM6XD(oK#qf4Ckmgvip_#)#j#xB^((QnAPPTi?L|hHRj4Tkiun<}
zsFuK+%*-@Ec+s*X<w?;9bK3M4=?V~@3tY-Mm6K8~RMBPs(lq;EJ_Z0<cLjguEBHmV
z4z4)r_E0LuCUT(^H?~<ngx_g8Sp2(Av<B%CM@!YJu5c5s!5To$BgDgFT{rw&(o1Zv
zY}m$XFzH%PwHN%|Rhy1GWfj1@6*Iclsj+IDFS`Z}n@Vw#oc(<z<s9&Wk91uS@r>u+
zl))L-6FTcgbt^Kv9i_b4RN#T`>=n0e%z$`if<85)@x4!U{ya~n%^=mPw{E1PE!EZ*
z(I|Vo<D&pWk%#?<qqS3onk~N)ML@FovjAli$pReTFS+E_C%`?c|MHgP#Fh54e<Utt
z6|wnQ<fUhFj{o!$%PQEX@!yv+?Ha2l7cvd(+C(1ZTu=(4p{ZNZx>LBGABi!^6tL#P
zlJ3!<^XCuFJ?;_F_|tby4-!s-%c3ri`j%yuA0)<8tLSqL?Za{yMC&rHKMQ-h;g`4*
z924YQsar{HGX~f?E#&-?m$kDX=J^u9+L`d>qHb8|4Q08;nDT-@YC@_H2_WbrmGcCo
zBB>RdM|JBoc1!sOVT$%W>R_JfIJGdSd=OZeU^o%+r)1-2j0&F2X4BH}D5DPr6~YA8
zmrjI8zdd^NO;qoRLh_Jq1ZRKh8-<#K#k%+3lB0Jd)@?}KJ%jKvO*~;Q)vjG(w)h#@
z%vTX6CQR6hYkrxCq54td)%}}+7`|J6-a{X>TYi-8IL2Y*APxM4dS2#@8%kQ@-aeH*
zi5nk0@3@)KM{<86jkpOLVRNApoM_zA6)&le`RJmg1w0ts(K#vuhiH@s-FIkSd>%C1
zILS4SOkFHefV)JS@SeuBjK1l~L);W(sD@f(?0s_?B4{$6UHJY<=_=Bw^#L#a$S0|R
zoI)VKk3dAv@jyzFP2n)~sw=Rm&D+jkqqGAPV!5l*$du))Zl|uoo@ipB(Hp37g%$<1
z1Byo7pMA-a@-(vFzYe7td?ZkML};IBU|h~V3YC+*#5OZjU+JM=LNEM&(qq2AL)4&E
z(8O`B3LrCxv2a7f)yLB3R!a(##wt6!;Uiyg*+?7DGF`YJX$N+(z~ZnJ6~m1<d9`nW
z6o*0M%7?-BkWrJcu9qky{*Wkk%QntspMQ;@HKes&Uv{g1==*s;F6sLLHXTLtX|<Cn
z!z6Pms+zh%yyXeA(Q%lymoFNZif5h{@Unu?n#>Rvt94nqRMgGiDN|=wPn_*W?usw$
zmOIBNPYbI&#$3-a5;@j&Xsrvf;pi0bI=M%ygQpe_=(WtT(OqR*t;~3y8adJM=>AgX
z&=m8}_h2+~b!NuB=7@5(`AGzPm>cm{!C)^WxwHU%E(zSj9P|cAxLji-{!OB;Ut@&S
z^~owz1W<CoV^}PibeSCut;$&OTRFSn$A0&H>m%VXi!UD8>gL2@=P1dXbuTLkgppDu
z$||x0+8`vC8dcR{eQYqqJRahrroS}|8Z<x1lDPHNw}ry|3PpC$;$Itw)Sr`*?bpnf
zi0Ks5Es))ILc*JQ!{SB?w?TC227JpJwt0NnODYgFfEPX1*tS{9X&)Ul)-4+|%>Q;U
zBxtV=-=2c8JD4YE4|9nrQy&tBaVa3w?{-HzyD)X;i98z#i0#tfk))Azi(5!URA&&t
zw>6LBKreb$XL$qut(c{PqBYYE^op1yX;oHD&h`RdV(!_vsE#sYK0|4;YN-*^)mcIw
z06`x{v2H)%H*2IRe522JMPLxdDbVuCo+%-Q;ZM3dN^H;)k*kib6Z_#~T6GZ6vzHpf
zv)Xj^i^FyZtEUw`fM_Lqn4OYncB*74;x08m9)O75HArUKW$VH=?RkUHO*qIHmDK(+
z7`3w}sl8Li%S3<9Pl26Q)5$e>(5|VXQE))s#Zl}Z)5!(x)C#f2ihM56?x;;IctWwF
z`O0&xscjX$G@a_5mv6XD$ZCbyfvFzOL9rQI66d<g2pJ(Sc;?=8#O%@=s67{3k+|$@
zs-34(SG=Q>VyA3qg{n$pBUWnEA~B)C;F~B`J3pgF^9~D)sS;rySM23;s9N_5wrPCt
z95M}?k`yO*yffZP)mw$fv_q|>2%YZi#Cg{nDzsH}1jrt_KKvoYhgT@7vQ}6O2eldD
z-*9fhBdFWoclG{PP=)^D4obK6*u*uwzV2{k?a(L->!zbwBs!+&2$rgFq@D$to^{39
zyjG#j+T0#tpJvu#oq$<Gg2(x|=}9}^Hrt_AZE?`cuVr!}r~_-=VzaU&<)mU=R+hij
z8h;u|D@oGCTtxOUFzg(y_lf-U=P0HIot**nSBq%<s}T$IM|!^w>Z0)WlpEuXJkA>g
zZ0`O{;C19Bb`bwRe@L7g!k}-1@q6p#`|a(99)sC9YbG@o0`nVe%A?h(Nn-sn!z-#n
zJEz>~?#cLX(t?aY+e%=0mIKBnF@$N(!T4|C0jKUog|<VwGh^l#*5?|=gN|kYXWTnp
zgMLW(7vmv~JS@kr^?pCwojON6ri^O>Nz@MS!@0~<=qZA<oxC4_#2<I99k*c2=O-NA
z@euw}m0{cZ&AY`_6`G?X(=DwH9Al0GL<~ig581dh%d{JtBRi-(w~<V?cOA^POC76O
z4jA96ba@s(*%zCHVSLOFH{m|yqPT!>wHsVUEjWI4us*%T`iwr>7b(eXmVuQ>tsYX3
z8J(st+=Rc>(Y_F$0wKLf#@0b!-8aWxC%0z4Sd)9^1S>N<zK(0zC+h#;5lZZ~J3Q3o
zNvr$#P;sJApO@m`zKUFYwke{N{tmAruGrwCwRK+{(~#L>%1P<D^6jlC_HE*~dpf(8
zS*xnQ<q;fnJ002l&BxR|eCB!P-)#H)_b9~;hoH``tJB`np(HKJ41PUzZU<7}igL^S
zRIRVke{#2n8-Ek`^ZvB>y!9f`OJreaAt^O_3YK2O?dl}r&tV@XBBM*q_7z{h>voTq
zP*~<)nCp_*RaBGQ-S77sySg^7>b;*d^>Ijbu*DQiflnK$tZ2-nT!mUcjUQU{JOAcJ
zW5r1f9gmNd>aKUlU%XJg-oC%9RMQ3%>0EXR9=O?xU89)?wQkLR(otj2ZJ*uzh&%g6
ztk;9}*W^b$b}xU+U4G6{Y(o-!Seku&Ro=_Xa-_I!>~HXsS4UkrK4agH=+omxReM!U
zPDPB49)eNzA%2k*gncgeD$_^{Y4YZauXINzTDP9Kj3TIa`?`G&NB`p>xTtwAw@Ej>
zUSmJ)+Dd1q>f2p1rC`^i?8d$Ly8I-WBjXUSmcHPxG}QVy=OURj?vclkU+c4&<a^ao
z9Xctj<!>XYYy*Vjb6>vVCnXYm`Ix^yiBmkvZEdl97}OQ&0tBwSPNd%v_q{3N&ayYJ
zGR|TY^S(9&dY?<Ya-{x#J?va<MIlr1m4fl(Y2%(fONy;NWnzLVDcxVMo?~8pjb6x4
z;!nA|yc}EEu9WkD=C1Ady3J0_MwQ&Q$pdI^u7B8>xu2Toj=QOy@MU_Mt`6Zjh|gi(
z*glH7xnD;)^WHHL-}CzBj&4@J)Ro@=y@cR^vxjMWbBw+q?&+hl71k{pafi;mJ>{GT
zCdrxhYRL?_=V0iec@+D)jAzMQuO;{181of(y%_UFclsFfIrpz<^BMP<X!G+#PJ)lz
zZpxcXjN{Y5ok^|iEQkRH8;2P=XkNs9$z2xAedqvlLtc7sGXq}o8|P?o@T2Pp5|Cqq
z58)k|=rHi3rB9vc5k_Bfd*VOxA>{b`L;=Q3zNCzPh*zj@9E?}!A6U@@FurJiJOf^H
z^eEUiV@i>+1d!g;8G9LSkfObY@gQNRJicOm<#%o{+*W@F<c+pV@AP81!A$iDZK1bQ
z`~iU6KQFij<o#)vHNgE-1JX94L1GW|hmJUm9mFYjJ0)wR`-QJd(c(o{pYCXI8x=P=
zx6ineSHm;hHb<P~Gq7fULEY28M#sXpzxCG+&#D?M{Ps!}*wOWLity00Wk$dEb`28F
z*Od<W3qu1PGViu^6yGbyWs%sASFWP}gHMn4?%-UF)MHE2TlOuy*Bbx>e$<jj!C2?k
zdop>>t?qu8IgOmYLM3nEZfgeXr<bKEJanEw@6NvhH-685*zp(1N4ma;it!s`41=qi
z?!jy~jh?k*RY?r+!hw$J&fI!yr1J%zO3Ns~BMEYU-3%7s(dWK9-qJwK;mc4VJk*CC
zvyCGU`;Up1ChFbw{k}G-X|tC6LaF#^fx(2J9ACisEWRrOmtj+%*D#P3NryKK!SBqc
zF(>19>XB4J_xm%<<>Lj|M|q6=5m!tWpWcjR&PjA$GTxAmq$ShZ-=h~E7G>kTy-m#w
z2WU+uXv+w>X2!00otaXpgJ!pqk@kgsN1d0xh*R374D6)bjMN?Ht`6l?7AImSCN~V}
ze#2tJsSu~+SGU5KTd&qry<`c3I}ncy3)1LdR6>z)d*;As(m4}WY>_{S4y3WciN2%>
zoRTOR67!M}<D|b6MXbiOlq8oEU>w8nNUg^_90PPn)5f43BTr1QU*j)GJPu$TgBKGB
z#!T+WJ)*qD%o2<bfI5VFNzKQx9b;G%<t6AJ3(d|%v=!~vGg}K_e6qDH32ntU<`J4n
zE=BVS<&|+Sg}anel-6^eihE9)Sd*VhJ}vy-czq%e@(q7zc!dKHN`_7)-l#uu0n(#$
z?wO)Vr|uIcV41=TmgFuAaGA0c3)rk_GsX87M7o0ar+8YTQI=G?qG_`w&Dpg@=a%T3
zf*kX*&MY+r+NbQDIam2Sr}Uj!R|VG#+*<O_^Pdlde4+wnVW-HR$@oR1r_i2>xrN6T
zpr4U?1u+l!J%}jo0dQM8uyH~(_5K22f?g+J>?bgr1(3XupF800&=CECSa1o9V4(x{
z?&yU(Y~i6yNT3e!KoL8^w~W9_gy`hLI41tM%tWw_M3ANZD(MglyL4kAn(>gY3P5&4
zyy=J`^*~zz#FPPI^<b%i2&VNo%Ys}g{aPA`8wQXU!8n{ikh@4KL*(UwTC1SfB7EKm
zVY{%LAfr2^*?|l8z`X&J_TaUHvhCn)y9i0?5gtq#8JaX^hQY7>Y!<=i_K3Y<1UvdS
zsQ<zsZ&*HH`i2N@aPN)3XyaQ<g{nc%$G95|%#2;1;LiW3{L*At&f*(=t5;Y~>lu4%
zI$i@RZLr7q1JN)*n+S|Mp=UU>2KB`KPJ=sAxTf(0fjerX$t!Ijmpc5X3GLqtHf>Ue
zCPLO!X@d@X(zKD2CO?hA{i?Ux7)Cv@+LV+AmG&@3Q;Cc@%^G!UXiAfm+6a5SRcnT=
zA)5{E#*AxyjtxhZ>2(952B6B^YmNU2^CiS%X!HgmI+zfuc=8m6nbA{<`)4&D#VzSt
z84;aI&6?ltPUP=jlLSYChCTCCn?y+_NyTsA{~sqn{nTsTPXi1zbqNXt_}_5?_J)p5
zrvHTr*ko+~-k3oCA;Y`NTa}!VoZEUVv`~CtrHE)@5lN`X2~y7Qp@Bg=QB{OWZf*sa
zE*4ah{8xIt9MvngT_7#x@FeYN=wa^Kai3N2;Gp)lpZCq|!TNFS=ldN-@cm%?zH%{F
zbp7>tGIz6b+^eT=x4za|j{Dv2my@zIkEj<L*}9%h8~Ny|M|%~U`sJzmrr7it)%59p
zBw%x1-1%<O`mFtZz^GRprMn+DcqHbL^p8I7bKTB+&3B<$tb=xWY4`4E&AUyD!92@I
zQN79jc6_?FJgupce-m-=Y@yKhe93#|ZD<ejz5FSvQZM(-MPYLs;8LV`F3?;g+h7~I
zq3hMF&tmPi(L(TCCy!8jo}$l?RlH7aw*^-_V|=~elTZJ?zuv~8|HBJrrPy3m$;*>m
zt%-IxE}Kp}(dhZ_r8m6S=9g{Hz4-gBq{8gqu)%7db42MG1T~I(?^8?{{p__esQoW~
z-p%b8g#iA=x%D)T%ggc7_WP!DT@N)iM9ge`^~cf^Q?<uAYMJUI`Lr!N^QetN1hs|O
zpGjdkjC4a+_X;!ix$e?dw@0AoIZ6!kX0I4``lu_*LAM&`yPD%Y<rCnGA<WR39_Hn}
zwdAv`<`bW!klC|J{;%-vs4Po$A^5vVm8+{_u&_0~&gYpNYP>FUt+tz{>iJOQX1sm%
z_sX+~zAi!7L#INK{;Olh3L1pKIfSjt@#Ku>SYO-*`aSPc?$yNShQk`<iPOvYF??Wl
z&%|+_Pagf}(ZJ!8b?g)R*OT<O$)c*ecTa8Ple=o`*PoTYR@*OcIf&1fzASaiLvCU|
zTWQ}&H@90SwY+d$#0Y7s?+Vb*_wpq?XjR$h?~Tu7yj~g{U05GTnn@NHg$<&{0B??$
z&6Cd>hEd-p+v_4Ko>ylt5_6oGvN_JEKd(C+#|e>9CN6-Dq*eO{q9A<)Jve&t`$ntL
zf|sZbLoE2O*UMwJC~9wZ@<bgygfI5o_bgQ|EwmT{h>Cq#2Z85ZlFpkdH{aFe=i4nD
zTnt=G8yRDgC^$D{Tn7aDnE^?gVIf_-#gYFgA`5(M6q<OAfMFO?HNpmvhJmbA8OT1Y
z4|b1RqZ^;QyTcuqyEkeNC$?@+z}J=znR?o|s=E)5dscUkly5r@#0%bY|L@8<UbxWv
zO8l8DmzOH>d&B{a+AXpGF4fHfH!MMRxGhej?DF9VsqFGU5mwpdo%{WFnn0KBen!K}
z4(m88TKihov_ee>mm8}ykbZG8Q7#%f#!=60?tVXtvx-%Y)MbCK^U=X!o-=?IA-*)o
zZ^R6bIHoH7&u!@~#)8H^>y`nIe$oiGdBYB^oInzTK!PSMe-w$iLp`lp)=0uVrz1Y(
z<bKV)`#J9xcU;@dJq43Ly@9L&mj=kBK}mgSJ+p?#-JPxDt0NY^pri}mOS<<5)?a!0
zT$k&;-i~y1S!Fs#SRYi(nnwbVXC~MlR9U^AK+r^rc;0{mXqY1fMo1w9a3>g8aHsGq
zq)nnu5oe+Qkv9-J5V}aNLp*2d{|b)t|CQ!+c>UX2P42Ue<5h4)h##R6ExCG4i<?24
zP{Kxklm*2+D4~>t0Z=&?zm{9S8?B%jm6p$<asMb4aZ^t8{t#{UkV+~Q*#fJ`GZW0A
z*UDhXLgw&^1KR3bKrGE@fgi1_HEDW*nx^M`jh))J{{!3|^VlRIgLsdl#3T{j&tYs#
zu@bLj0vV9*jEOnqkK;~Wk4GC&QV*vFW6gagr(|zhPiW-`Y>g7@kyZI<FN_&~BD~Qi
z&~u6CoE|8VKM$OOQ0^>P0!j@~IQ5r0CWPB@o`I+{C==gZz~MIFB!Zc8HYkPt+~Gg}
zL<Ut>05;(!T!5w~hN3SI7mO@~h{T~R1f4)oaP@Bl4F&X{1L;BDaQm-h#2zi(;nzM$
z3qoLGFfucPTkHP31>!Q#ZUG{W8)D=7rGOfGF&%>?;NstrnR1sF1ekJQAoKwHQ)V!b
z|J(|5F)VE-oTV8h!|F-@FGzOo`niA@1RH0AB2ZkwDy0P+cr)s(oFEVIWig4CD*Mk<
z?umklqB?tlBtt8Z1Dl4~m8c!g`}LzWf=qx>qUOuY)<M6q0oxAWa+88RLA|jF^^yC>
z0r7*pK<$wHKchbehy&zbc<J~dI^Np82d8;zFa1q3au?@o-)~Z@L>mlyLL4L#iz~2j
zWI-{dXJ^e8+h^1HWd^kooFoYh-E4o>z+5>&9AHZ@x~v~NRkj}>)JA@?4AzefBo2fJ
zZ2!L+guj5$g`&u~i1SC3fW(3E!0plc6@kR(6sR<c3}OQ5VRBEvyg-Oxf+>*-1;Yz*
zl^z5lzr=I0pY=VadOeA$IExA60(oKXDF1VMWcH%~xHka)pQ63E5Y7*0ox{B#j#yUF
zPHZ3#%oXK2-pJa|a8+UDi!2ofCJ<XF`ni@Z^5~ZkzL-<dPW&ER1yCFaTV(04032{D
zv~tD#A0y|?y|)&_?S_b&8!yLf+!GiQB#1e)!z6YDD8`KYUv26QA+te|e+&paOgH5l
zwism5i6)x+T(;Mr2y6pm{}^Bfh;A%7JBU@R-Y4e#QGa|;Pq>&EU_OWktpB>%LyOY>
z+ltluu>$x)@yGh{LA~HEn4H-m2Gdt9H37aCK?Dtg_#$z}JMjS`5D3^~#s)FFNT&Hw
z0rX~9)z*x?W@WowG@#mWHcYd_f~cSZa374U^bna?IGF$K#7p?EXSN-S(`YAL7904r
zz=4Ty<frX!WT68`%QQPAh$vEJlpj{0%2Yr6_UG__)@Y;CV7*mF9!FU^q|-GW56Iml
z-J9AKpK$1ZuL5NSk51Dw(Zc)!HByxsG=m->?V5%_*B48+s!}^E@?2ss*BB|>13mB3
z+I|dCUDVRHq|ws0Rn#U>we~YdZR{ZWeEu8u>iwLZ;dC^W!Qw;_A=+8O!_s7_wnVFy
zCj%$Zq&tt7hUOrtTGW{oq2gw(tS)WtsPOkfAw)X!G;xsLGF3YBGV!RrI9$3ChgLOM
zC(-%|X2lylWlN@!VlCl9#`UqCTPHxJy|lI*XIe?Sl45CbetkVz3YV*+ie@R9mv1u%
zyYO5yPtHurvGc0ch1XnJ+^cjnP5HT)J4<O(wyf1z9!GBc#75G&>{plP2C7)l0Y3h^
z;>CP(oz_ay)O1s2PgRBA(thYqtRKLlBX9O#U@QInCMj}IDq6|1nWK|*G0|Ms=`G^5
z<}gQSD$lM>MlW0X8Ev9=i9c3K25HfVJw?Ypmw4JVJ)M1Gp$U0dsdE0tB$8r#uGOji
zn2piU^~92JCe{4VTzw`XhxKb^aRk-X`6cvpG8w+iB<iX5DfcNgw)!x?zw6zY89@b}
zx^!7ZUcRw~D(S=Z6u8rw8Mu!%->od34DIi!G2$$%3k8od-*}J?Am~V^r?yG}X`8WA
zCPDf%H<|5<E{uFGXo8YUFiCc7)o^jm^3P{mtPK6t#czxbF}w_&#0_<V_yb_oUj)_r
zrY}yBwYetRjb0~IQ<~1Cp|sul3FDU#E2m&-2mI8bT@2PWT`m>Q^n7bTjZ~8efYu_K
zr4(8~Ey?CQOEs|FQacf#X8aQy=Pc68{VL*HERWA|2>X`x4-y|PTn_g+X;)OQp(nG5
z?u{D-qv*;{-firm+-^FNF>^aX*ZLpC`O-~o<%6@mj?s2j33D~=i}|N&X}9*&4qw&n
zrR0sJ85clzRR{5@R13LNK)wD-TH)BzA%aO?sJ!zn@Vbnl+|m|zc^^+l=cn^<yi;&8
z*@is8GwO+Ap3l6`(Z#E=$mOGc{h~A(ZX<=OpDPZ)qvEk6_0H4yI&B(UC(w)QXnnq0
zrzkCN6tk-a-!b9XDWr}~<FWkjF!3k*PFZINRVUG_Dst1uyF2n<rHq&MEpX<P0=k+@
zyfoX1)PQa>_ELtGZkW8H*UH)ANvnzc0wGtZ)x>1pr;DCmZtlwSb!|6q9s>izw@d+#
zr|<1R=Z!eKWlJXV$)?GR`7d^GD^SA^gs{T7di<!+&)v+M()lCfm72=)Try$LPQ#x8
zcpbZB30yNX+YFL35h7dQ90a&u1<tcgzV(j*1;y)w6!A>6{+f&w3ALDA@ZjBnkk2_<
zIGbQ3Oa{bX5X}A)*r^QwCYc4GoPJfrxybhv%+}d4Eb+A-IoY_HSm$ohtfg%uW#vFz
zhx6vKTLts0E<8Zw0KBUkj8|V8@3$5OT%#`M(s{CvK8)({QR1Gi7C%_3Tyd6o;Qdq<
zh7?H{FxVdc+-)|*sPcd=b%B0a2*y2L#fEf?&87datOKfI$nqtEyGQ1N1(4Tr+L;n6
z{>6MV`G|Alj4ia{loVL(S8~%85Mgat2g6Szb**mC`0H;kO$F^Nui~8GS{&fIWH$KO
z0|h;ET8f^)M)>r2aSirBh;z7w6kOA_e5&9P>q_Jl(QV^K{etgPlM~BylL?Nj@6v)3
z&5mi1s%Kn`4qh|d;^_K6G<|hco6Qq0lokpUcP|db-QA%`fS|>SJH_4I-91PM?jH_q
zafjeqGz2JK94^0m&;4W1&Y9<VXLpjb`zE`yvj8{#&y4gBRy}ItOK?$x*Op%Hgm!tt
zBaDA9V5H=@n@RqI*<=Ew2MzbnY6)E!);#anq<DLcxq18ATR7DfY7o1`ryF|ATT`g}
zoR0NXCJhbpQS!K^2$#PGt15A1*ioPTmM(A<1x(fpiC}O37l?Nz>yV9^rg=Eqi_v!M
z0qR#rq#hRT+P1{)j*m+&IyS5>Wkx=Xu1M#PvT0IHBem&H-o*(j&aZgioz@tO&=e7X
zX;ySPl*>7^y2;Etdt8Yst+s9PLDX}?S|C%%uc@TW!vTC+0Kdrip=8y}o8l1U*2aJ&
zI=A@c`1^fsa}tIfUlKq`OP4sXOS4%lg9uKo0N2+gTLy-CH4TfDPY7%~%t`vA5Wxf2
z&IOy8M7s5pe3L!W)4U*mMiUP$zHUm0cLsT1yz=?S(qgC;hV0!xrXALoH8SxCEv&RF
z;$505JS0y9n~X>nsT=<Kn_-(s&ND~VBsTO>0!Xu9naDcOZ+qtxeTqTaM%d6((Z*|m
z?gOS(nbl3~wbgfnJ!42CQwS0IqWd<-h8pmZQt|Je;JjFYMrLG^FaLu)<%VQqy6p+Z
z7lmBxdj>8OB8o^@Ek(tLBImO0xho_p-2Q>JL2Nqty&@{+-Ngx_qHH3Qc{JoAX&LkR
zeirdJ<YMa}z4`~YIFkA@Bz|&~tZTaRNoMOiD9FiUG$9MI-F|WrE5n*!BYN-YjvM;X
z{M(0EqQmi&GzECxxNXG&#_BUr1W$roNDgku$$p|J@%7;IaE9;d^nNYDRm!CwEis=*
zRj<s5exfLG7$l`_C88wqv^+4$S(Rk+heiLq<m|sDhk*%wLn|_I5mRW*jI?&xPP|4&
zdn}E#yl>SIN)n(baaSYEV#$Wu*jFeJf33GSwz>(!5j`~W*v^3+n#g)}XKU<7QY2be
zoa;+A7`L&%jhXV6Us_tn+!*XHU-WNA+)*{^51wlsZ6)=kkKSgtYi_mAp@L1_4<vD6
zUI9}gb1IkJKZ{qiS_3H$bstw&oHd13SUwrnM#bmZOR8a};JwN?k<nB}j)=X2`bIHL
z<qi}B)H&E@q_chm$lHVf;#9D6C7BFRQUBQE<epXC5F>KBm~X#^DND9Ldaj?#H<xqu
zy++P=HwI3=6OZOkZ6>bq*fSeBkcLX}N^@DD5w)`pbFtffb>P8W`x)Zcc-}U&%wOC1
zS#^sLS2v(`h{%J0&7g!2e-*?3XqOT_Yb8Wk+|*x4(Dgy_wfBp`x|ajtRbv&_tTZ*z
zzoHb$gaJEkC{7ljAlbv0>Gv%+)rTaj$M2r{#2rm6NP>(2@<&?E;`&&mLH<R+bmEw8
z;~zOJlVg1?=jXt+G080w^EJ8uk^nhB^0~A{`q<Ai(9&0cAP{<kG5XRfR~w^)J=Ypa
zv;11uNW(E1u4fMayK4E1L7x&NPx*3M>reLD9b3rF?DB+yqYA>8E^4j@BOscVvc@*9
zdDsXxqmWynlk*TQodywl)alnxhlAqNu<`3uW#J~S+!6bl(sCA3GIx=JfZE?bi3u9;
z{=@qfa4V}lQa<~h63^Y8mT-AJ`PuYj3wKS=#(w;Scu_wjnXK7s<SQnnNq(ng#@oFj
ztPOkvRljr@CVCrbjL|dS7HTuCsFT<o)Yf8<x?Nktn|n{5dz(<Xka2gE_VRfJn{Z>I
zcQb_}oy9gM<(_;57gL&N8i^?qyu&XN{($xq^C!3P@RRv9vwXYi^D}KX>Hj-9k2j1#
zHzkp1+PiG+&4&vrOoddIpSOH}jUbT<-dY{fwIB$rg?hm}D7(Yqc^JO}M69NVFA{4a
zqd<TD7$P<1!$wGdYy9TQ=fsxbVGyMz`xWzOZn~h9n2(Nyao*tC|7$cc9|ddhw6|tp
z)IK0FzsRUiVOpHfGL4p~|AaW34=cM>Ftw;OCa^iPReYmp_|MvnEh|{(p*)0HSBM*J
zO@5i7iIIJf@ozeIE85Dc*Ul5E+WP987{Kn99mKb}4?PgWbo^kzR{M`qU5PravuMly
zyccoPT;-3^$U@?`|FpCI^Is#^Z`a<U*&|h;L|h=IUgP2k%=p;h*`G;Ueby`%!8rWe
zNDv+ep7+D`__$)W<b2?GCj0!(h+3Hh?61HMze;!YiM{nv7IEdu{13MhwsuF!XLzMd
zM8Q(iv1G{SWw4N>59BaRk<fF~?%*?2ZKoM)vZ^A{DHmQxt4`+A0_qXiRS;;JT>}lG
zs`a-WT7(uq5j3&_Emd_FlI?3;`H1qZDJl*OD-29OWMFhG=2nz0mO!S2W!WPA%YYS$
zP4DbtJQ@tp?rrQLb`4K(V*6O(#oQXwS|vM@>+#wcxS&e}pA?02g6>w+P!(QHBU~1y
z)}*|kTrFD=zooiJyzr?_PrP-ETl?o1om!m~WrI!w#{?b6MJYRshcz}$`&wy_NIvC)
z7@?`AZn%R=l^bhSuX%ztS<O3-IzDN~7E!pUiq@gwJ^Y;t_{{u7&V~qN6#5UTMP;_G
z?J`|v3v7S11s8rWcn<H??71#qm44M+0=>#VNIRBKFR0!H@B~z}%~ry79x5M5o@E>>
z)uE2pjh$iQnqG6_9z@SZ8!|y!B1bYF90A3DL4A-%v)j+la$>S))e5j_IKWq3EXKR2
z)N6sKMORGa415Svhktkg`KG)Sd(KkcaQD<2mv2=s!MxxezA8PceZVul1v`$Os?G8(
z@U7`9Vo!;9+0ue|{ByLiR?(c(4M|{72zh`~J;b>tI!B>C`yH#~RcV4ei}Y2AD##>H
z%6EmgHs`=hr&Zqxm_2WsWjm{46>ZGR!fC~@%IZ51KXc`+DQ>MZUq9h<T_aRf$YtJO
z6#W*5>qsf1o-;g`W<@Jz_I+CQq&?=DPq&n>q;+QZ;0udG+Z@LvotRbK&>5eN{Sn{_
z{~=;UDJk3Nx*?}DYQpJU+jmAZfs#|b@^SJedAj6r!tLnrK)!QHw8%3z4@P<Q&UfvJ
z@}MvKFF!{~*Tndd+SQj9`-X#K&ch_zs1+5j?4|kB1Dz3pdB+2`ZT?j!r^=$7_T5_w
z_i7(TN1n66vqu==m09PCe|VssxSBwY`i#z%Qs=Bc+Lb7hxPn0T^!&|1T+86PT+hMy
zHQp89a*vb*|5n-YMEm*Ut$S?;$`h@Td9O_3J-d-(Z&J2Ia8jStt5@gPdK6zE+CBP1
z%00c2ZJ?ZPw#oedLEq8Tf5q*)l)Oq=g9Oi<f6FH?!eDcP|JaP<BLm{HX0Ue3-Ie@V
zjmW7Khz5t}Z+G!veit$BX8yQF*hQb72hO=BbMXacD?pRQXG1bA%*Ke%4#E<YC09GZ
zbD#{_uHf;HHO&j+0<wA###>yP$c3*kBV}dtZk(APegT0=><h9mPjCEGG)Lvl#V+jn
z4o#RXP}D)aSZkND<kiA}$ho5M&Tj1Y8d#(^auIdKD7jGkIwP6n;86M>=Pg=C;(cav
zCASITCGWw!bm5f$w~?E#-Sg9?PI#AJt)xeqvxm`r_^%YHr_FYNHxvwo<Yd`y5u#c8
z%zN?&7Sz+`nP@)Z;2@?wh65z&K%(^V@b2LKwD9g^A(N3aF8lB&alGm0xa{We?(7(e
zKz6eo^D88)lH{yV&=$5U&y@~!&`7ub$auEyM<1bPtr3>&Q)%PT-?s+}6QGFhSX)#d
zKJOWcaQAFyG#`vB0_u88ah5%giR17mt}A8gpr5~YTiZW7{t0P}81$vCx2B;G;5<b2
zp~W+Ewxnd(Q=O2Bcw%;|NfzMANNx|l&PiU&K11_ixpJfq8uC{iIi1J~?@qYSPj2T4
z`m#qcVNC7CSx<PWb|6oE_I-!hOQ2b0#4mffuHfr$FAltmr~DZ2zvhWVmw^q~mRAT@
z=+smeFIpo}{ebOXtY<ivI1FPjqOa-GptoW^QG|Z4a<CySKDExihxfJSR*9kaP@PKw
z{hs&nS#iWVn+WZm^~#?*Xi(O;$h;2!(&s>v+QgI{`%=!TF_|O8*kPLefK9r0;v4&3
zea;g4JsP+U_Y!#ULHe&%;paX32|4NBDcO~t0oj%3NL#df20Wj8HoU9u!F}J@<UaE@
z)O){!80p?g*>8T?cjh}-U+*4in+--JxEf#2I4e;*vPiHmjTjOK{l3;G2eB&#-L)p4
zAr+zB6K&&BzoHetmq17!!$KsV=tES5ZH16UtfQDdO1xtyx-{RWp_V{Q9uGoL+?NP(
zi+I8pG#r@@PERgEst$j8C#XLXgxD$_i2C_oJwo^kA2#9T76R@i1}E_SRj?8b6WUz+
z27BmzzZ?x1F@Xk#NGj{{zCrdqdhj5PATAT36e<&rcCf<xo)1SVy*LAa{zDo)z2v{-
z^r7z+aYR27Q-^{={BfY@b1IxoAMcdk$AxgnVh2^Q-fO=P=x3x6L|$eLrSJcLYeF^I
z*8V`b_MsJ7mw({;6mXQ<dGQG`zcl9lj0JA=*W{AhO`&v*kQw{WOv=uoVb?Q$!;!Hc
zqd$kz#D4xb=hwLOcw&+L=jpFs--deg)L4+Z;q-(-8d)aZND+ITftnO=7HcJT?p3B1
z@udDZbLc_KKE9mWoNH{!inY+->`7xju8nw8zBg|dYb9N-7uz8TuLv7sv{l}Ix^(l3
zYoT28rfZ>0nwe1f>~$kKimJf4lH~ldYoWq?zbo!6v^k&KMw4w=F73OJ<t(%%pJ+zA
zJ>S&^qNnD=JFTyVo6E??7=G|$yejwrFkTfs)RwPob7`Qq|8(@1d>j=-@?8ix^Qk2t
zV)J02#>Z>KS}9B#uR+T%=BfYnb75POlvbin^{?-AJ{^IqsCrXzsnBu5U{A&N{M?0|
zb!h(%T|56NY*G1#*5A(2mhy4dsK(|W_w!W0a8p+RmgNl_V~|09mTG>((i&|Y7KWe`
zb2ipPdZqWsuy8~;U8iW`<+7`T?MRXG(?qu5_#aZ$v@-FTDam7YjG;Ys4no~kSL4hw
z#BQVQTI+7<)W~zsh<5RV4Z38du8ss-uXY^AWBxL+Zw`J)nUV|sq&q6|YdgA)@7h@_
z0aMd|Z-e-!?pID<rWqPp#WLijOQ3tE$>lef!(~Z&YFbL9W)p?P&HAoP40KB7xg6?W
zhiLD=t5{k5_MDhl*)%5Ms^Tiq_^XXB89GUC8#?W~+e{eaG%mPWP%a1UHu%oeR}IbX
z#tQV9b~R9%!#BAZ(5=PW;Q!IWrgB`;YX@qtsim8g^eJAY?>uz_|Bbb)ufj~_MOh%y
z9+qv_B0n9*^<;*mRS2uhz0(#3voFtyBjV=m{Bt__x4QF>{7^o#Q_QCSRPC{A1NlEA
zwn`QimbwSn&|EAto;?d>f|9j1nwyrjwt?HPsYQD1WN;4cOS6CqI#Y8}VKSqV%2yi%
z1}G68DK_k**+2Ck^Ce?}ne*z^+(!0|63raUZoz*UWm0uuj7ZO)K6Qm*w=YH;#+mw0
z856bTOQp8_5!4E!w?%jP+)qvHA{~rh8Mdx#D{)I8yi8HFXEjUxSMck1huA!&s7`Yj
zrx&jyJh60gJ*A~XBoxytYTm+&nBos+YktXu8X%2i=p=WHeCmXBjC|n4Zj5~Nq=8$3
ztE-7yfu}2#dziB;l$$4~plqV?;UvNQANttD+n*WBMC-Qd3EgZX`J8%g5kL-}i$b@P
zP`%O|CJR+eMqgsaG-fj65tA1o#pzU;`8o;je1Y0<=REdPm3zKOgjL5|0D~9qySLju
z7`R3BJp^J_zUHLmJeP7;a&~ocS8{hjxGTB3V!11Mx=OjNIYr7Qawgd8C-f)SD<@Wj
z>zozmDANKzq!r?M9@5lNl<o@arX~h{+e$CP>(@n8_W0>CKb=;_(~Y+sFz$V*GWTI~
zY1=3n#vTs})5|T7GzK?BWHu|N*7X~sv@QF0%ceS=tA%@2U0A8iQEV!mv-523r(Oqp
zad)%eZe+YjqP~JdbaF#<lyDLGKP=l_U63mI{uCkDY>i$T$_F(f&KV{p*EHvQO!SsK
z7)+lWkF6IkG|jG;<<T8Q)K!#JPg(`DrCvvR33nTE^-tv^dYT5G5+ew?<dK+mk(fqN
znpTo*J1RXCSChct6g>T1sov*P;kRPD0Vb)v=To6xSr>tyl_b2ae?6951kx!9cRTlY
zt(`0lr(Q>SVRrj{dW@k%+Acsp+m!Vx3Q}iys;%f$N4M*vBPrf|e`8zf_xZ5!$q0Zl
zfnB7;jh+486Wh;Cu-`?+U+u6XiuDj%<-gkAyL|d}%>%QW3#svY=~St^J2rp+_f%Wx
z$*b<Yep#-!m`2;1Lt<`m?C#EUa(@%(ZiS6bj6o{v)$Ub(5t%L=^A5MTe~aUIH+v+r
zIu4IqZxuR!iYe%JS|5G6Md@4>lUe$&^2p%UuX9RFZmEm$2>Di|b5=}Bpkr%p@~?n<
zoL|0^M_<L-y19GTBf-X>KqaqE1-3(`X1^+upwW}Uv8ULT+xZ19tF37%6Q0MwQlY66
zr?IEV6{C!Mw&pITtM|<!ELS2{UYZ9=R$kf%%vN3+2e%VW^%L_GPL&fp6He6=RM{Ky
zIo3HF204e>8_GEn++F3|(>z@f+#H-;9o!t;T{+wwTwPV%96Vhy-1VGYjokIzT`Ao4
zTwNvH^*mi6+|CW*d1Kw94kZ(Y6LpmnYZHO`IbO-|T{@BzqEB2U%h&D_r;icICJ4VH
zTp`$nS`kmfu7A0^>K^`X2G!&CHslx4k-X#U!Qgv#fWE}h$@~dG*)&PG6;O&Ccx3PH
zBRiu?{S<X8=KadM`S#r*o;{wwICj4(a^r3qoxkK!#4BNb;Q2|TF7GP;k=Zl75267}
z@h|(#w%^`JAEqzV2e-7G9M`q}VIz#G+{5~WQ?9AZsqUhWy+0RKVrs{U<aKNF`ZqBK
zt1c1sfoK>z?l8sT6PEsZDjnXhz;vgJ?uDJ-zrZ)bu}{o2RF2G)rL?l~gXVfaGu9_}
zuo}Y~$0oe`*thR<dUSKJwj}=MD{>P)|CR6a)YF(S%O9os;l`>)KPvsQoutT3xjl?P
zg%LN5(2I*9&M;anen+LmfUu5q{$rvAfpGn+s8n8@Ufgigdk^J1JXWa!Tw}>;<e%Oc
zTY;g@MZeq2U1PCu%ASAoxHmB6(Cr*y149223^qP|XD(%;_!2u)QOX&~6i$sc_lHI@
zZE$`$rIPg}on8EHzVmJy(a8Ti^sSC?zZgJ2-U%a`B|zbTuwWXWybw&sHNUm!jrvCM
zek-YOv}xE*7>a(VFrZso?P8!PW6z_;pGxP2T*p{Qa;Nc9S<gqV=IyQa(QIEy&%>wF
zBwYoE!*t*Bi1W|)8_R|V*_s!h8gayGuZD*?LJmirv+M=N>;(yDogy0@lcAc;g>oVe
zd;Xmd%{cpdp<k4|eR>#`tZ1dJXuo79fNl6oQ|o?u@2@9(RN=-UyI|%oRo2svm|_sq
zm`QK;1}ZT;3Rg3X;s>K3=wQW>B2>zwH$~FT`(sac9U({{>G7}<_mj+uaVuFpm^RTh
zBT&B2#wBb;m`X&pSGtVETFkV-?3Y2%!l~&LjDMCT4gIAhOF=%8#rlG)awo}FlPDgt
zp5M>={IKoO`gAdo7Z)g@(0B7w+Vq{XygCAh_>p>XFWnUaCGzrTR?>I=EWW20^f_l?
z33U1h=jg!+T=VQ5P4M_5&(IoSh8WCbpx;C{g&56hMKpgh(0&9$V6lMPWQVBF7gduh
zrK3t+%|Ph<-C_Yc0?A1My3tk>%ImNt)EJQHxAHgHnOj8sw8-IJv(;}EXo8zsEX<BT
z(o%rdwAKG><jbhE!*76ttbl{8dS50UP7UNOTf)Z9h6mfQAIu<8;Tk6PtCXnC2jDL1
ztJJi-b+DPrDs^U3dMgeS6RW%pg!ORv-m?DXdMt&5Ihr|`nyH$nS$M=)A3%@gSnhqp
zJJ0l^|GKC?k8-=e5_C>W-tM}AvLl!hW$=d?V!q1$_!LQAKqF5bN{cgq6TR&s>q1N;
zh>t@ay7Ec>J<6>4_u@emZV_OD*vNbL22>a}-b@KY@vpCvQF+0MoQM>*?}W$RySHo(
zb1}r`FvOax;t%IAS>-S#PABZJq_Pgn`zIuL^8vm_gP4Y<m@GoY<-JF05j@E8DP6xi
z2A9p;f5$NTtYhA#GaK=p-iS_zE@t1oQBOWA+M!dMwVeJpZY~?4ISbLOcVjX;9y-jG
ztEdj!c{bxar4c=y5!+^&{qJv`Iuj+wzscNtvQ-75_1!_)N&+z??#<b1?a{XG)!EAJ
zG0g5=*<Zb)-!>hyZ7yOuTlUi2ZATf8=Tg;Y%jt_CDk|ctS(*Nw>}>a+j0`Sw-U!Wa
z1nW0KU&$M&@CMesfq8F$=9^sjCL6xVS01*bM6kJ34rn>ONtudDuihIN^9E|ZS#fwP
zmT#o-H<B)AS1-3Nd@i+q?u}Xd#+28M^FMtBvR!(l)`Sc8h6pZ34Gw*_`>$acd#rYs
zA1v&&5LC4r+Trny6SnkY;A>wZ`oZE4A--?3rkm@eP9E+UUh6w#bo#qXE@brj$5htc
z{7YtNTi?<0etk#p)qm|j73<&e_I5fSs7-Zv@BMDOtzj9{Wgdwr-0|Wx)#2X&MXCeh
z9YueE*#&=pE!H)0i{NI_n*TY4QX7&e>iI^4H`aC{jB+c@q7rKd=YhXp3&AU55Cvf?
z<}c3KtXIIfjM663omhX;&+h{Lw;-Zs!&D>jXoVvb1a+i!Ji;P`r}L1KC<F4d`6Pdr
zdb%#eLd5^DhHo`YxztVv=q^Z{+K~Pm6@SYYzP0n1Q&3*|T-8yHnf-Xk<JL#cdpln8
zbhOhjD3P^i{^=44Stwpg?e6u2gsyim;{k($K5>`*IX97TSo62;e+qqN=7WHBkb+B)
zw6qDQUpM^pWAiXG9@g+9p8#cI&e-o?KjOK6=qBheP$q)XW1@ByEqDG1O6PbBV(K2C
z2Gj>Ij#5tCvmW?!v#Ob)NW^RoXr-Rqc%Azx{X-N*Id|8~NBmEMRFrnKQv5EA4h7-m
z<GF)gKGK~&ueVxinD`xtE()O##ao<}9pOoowEOd@8C5saC=mh&LN`8P79wQ~GKY#Q
z6s2DAlD<C<p+0huFW5vbY>7_jAZ&^Lo^+c&Sm5UlL;vpVwyIL^#eiX|Kl(X$|C-qk
zl<gQB`puL*5vp#MQKevAgiZ9gB80+N<crd$O_ZR_J>LFmgdo&76U4$8akf6?%P_1R
zeILSYzTm#7K`Ml4xiD|D7g$)3vMc4bM{rQY;1&XhY*>(r>nzH}MECo1<o=*v#+1QX
zp#G1Pk-7--=bYVW=T@Brqh$Y{f<{c@48GFIryh&nCDREYY`)9pIN3+>=II=MN?pGk
zh@$VnIOmtd{pS$uRqEG5-*Ft~O}dHXjj~N^b_NKRkh{GD(@8vjE{yC$=te)6SlH?2
zM%2t;KgT^XJ@e_DQBk}k?_6e4&GMd}E#GYBU1O1p@|NnH@QY->Rh}a-7BxD`D6a0_
zac|X)ue*qyYc<B{oMQR9<QD-$uK&CN`v7A&v+Z2*i*>pvEHms8?3`qgZ1+>2p)h9M
zI1+P`qg+B2#I442*+VS|rv2dlF7fx#dvYI5#_bU;VMK+(#W!>YRZvrdaa)o4jS=DT
zE)jqBO`-j!;CfRGzA4h*7`XL#E@fqE{VCROHr{(ICZx~l3tZNywWb`pLlV*#tN3?d
z+GI*I_k5S#Q}rpb1tzqXPv4F*5=Ik8pWCAjX^gC@7S;3m4$3C=J8az+Yw}xi3i9}y
zo1a^R?9+<)n=cfePGf3nmL~=k3o&dj^!0CFKU^AWKd?5;#QvB1lz2_T%rZ(PY9nWy
zyr&L6qJ(N=+TkMNM&`n$R5@f+J<_^)!7*=jaYa^fg*Lc~AF7RRryP=-TEc+Lw-BCd
z9G+_@sk%^7VW*)51XrO!@gsA;$f#x%SHx;)eE>7Rr>B=v+OJjg0hQ5#%92ymKhPG%
z%8O^j`+p(34^Qxi5Z`O_T~=A`X>E*DMy5>1$&2$P_-Ci6H>Ie@rl_;g7Ol#QSILWW
zklaJLF8|1j+scc3B={TiUshS~(Yo%<_m5Qerm6?f7xleR?OolzrebZ5z205geje@X
z^(R$k#M-;U+nfJ*NkaDd^vIth&DHtS=|Mtdy1bM!Ep<7Ldy0VQC>gR4M!AHa%;&0s
zWawvupJa+%ek92Y2oG^fMMHi^$+{9F)f{{KQpN$FYd4d1I69Y(m2UlTe19J!#&|^i
z?v(m&MBT`qtY@uQgGaZRf_Wt@X?1FASWkiB?RZpgO!knsMA~E@p;AL%wiNpBJXa=g
z5_V>+^$@ibPI*OYm@*`^Cd}?-xEpHbti>smjq~Xh>;Im&Y+2EDfdcV|e`N7Rqs%4)
z!#;duhc~h`7V8n>#KgvGN~0FgsR&^keP}FIsSlaKEYro+q>k9cZ;T`LJL{R!xEWXv
z%OW|O2=c!W4Y+-a(Bu(u+YHnuJ0bb{iTh!7=(nd*d|QI;JYuIj=zt}e-Xx&8Y4P{<
zXwt!OltEy-Xj^w{lI(YD3qq8gN2y91I<6TJ?5`FMAGjFl9`W8$2XW$`M->ar2!qVO
z)p4x%F~QE%06{5RTRdFYCu;HuPxG%Tw;~UKYAo!4in_p35LM%Y<gE1(oGWqD;zp`;
zdU3%}#J6)HO|A%3U9<;F(4k^|_-53T020s(h=yIc-=tCWY{F&ait4MwKvZoHoU=qQ
zxFf}L@`9GE3Anmw2X>)D#r{BJ)KdVe)C&lQ#d+LlQ3QY%6k>a2btNWeD-8qEVL6??
zH6Z7P2b<X}IQ*2NX9{jEYf@1?EaY3eFdSQ0UX4QDGX&q2HL0sE`U_joQ6~t9s0)k)
z>FSHAUT1VZ<Rlu~-nh@|9>FgXd$-_bv%1G{3i5!Wh2glV&IkR(-X%DmtjU`Pr!WGY
zBBloeqi1pjj`jz-*=CO$H;SGKIGt}|-RA79O0Bs5^_zcbpe((BSeQ?zueAb4n{OoS
zzSB1p#Hja-IE(In!=4y81ILOre)I1THeW-D)1#=1CG4BKK!w|*r+Ws671X{o!00<4
z?h}n|ZmLS(oFWqR4Oys+F|MdKfx%E}UZP>g?jG*f{?+P4J>PWuU|YTdaS~s=BiI8Q
zua>TAUb11w9ycoFVoUI(IOD2n6F5w(_9Yw!?0m3HEHuAil&fD{;PATEu9l$pO{fcu
z05R$ZM8Z5eA2JdP9d9aSdY)>{*XSRAPIDS(;9p08;y1opb2H>leeYg%=ilY4a3ikg
zD;W1KI1(NDTX98FFJRQ~9d;x=L|G9>?96L4;hlDbJCvu&L*mS3G)ByAG_*X=8+V~I
zzaQW8RhM(qsx!5*{picknyN0(KQ7B5x_Q2Muk1R@?s?w43-)>Pq27v)c(1$zu1)jY
zY43VlM01IG>7mE3al~f=Y*r`E20sP+Thf0N+mh^lp7)3!t=NwbQ)MBJ%C55}w=)<O
zoM?&V8f?k^@t-Zm?#Fq9p%kT<UKfg8rmLQiAMVwHcRas{HkWB7O@`V@5Ld20(9Iqu
zD;G&&2B2vj;f<6hQ74JR<*B5_0}xPP0ZhfW#mSoyQ`eYfvum6Qxqm+Qd_cWsz@I16
zkbW#lH;&@=#TYvRf{S%cIeI=l!swUPIi%@(5P&UMkRu;(Nsorgv=oIHI++dD*UF8C
z6i+F%({S%q#3&mP@(M={b;FX7Hc48?NcYwEs?hfeV4OrvBwno^j&B@Z&kGk_#`r|6
zXv&ENH^f56BaO|8vU@d26h2!v(0mWN`FxL-eJ*};`EjYJ?fTtY(M5Y#TkIQq3Xl9H
z=o}MVK-dnl^m~pD-Y#sHyVTO81U++yy4NdNHiNg0!DjW$mT_PS7<jjbA-%Tr1q@O<
z&sA%Sc}PnXp0(#*VTVr(!|Cd)ETX`DFz_B<$_f6BE`>+a5^s|VbjuyeY@9aY1PEFJ
z@N`!si<Q1yY{9qw|D>j^t$=`Rx<p`!46wj!3^N{I&S=FxE-nRw^%`$O85m$+V(Clm
zQ}eiEP?-|}vP9@QCr7G{UX8cco9TAr6P#)J6GD&MzeJy33m?xZ1Yak{-|K{Uh!qwG
zC$F+QYe<?B5Fg&ueT1d_(I<@5x2BRw)#Ncc84h?0z29wG$Da&FEXU2qVLxeU7?1g*
zrn^#>TXK~6`&oRPgzq_V{?J{%%SZ<wwbef}+GgAlz*{Kdl;lEbSWs0ZlI|-B_L>A!
zs!r<IC2CwvfSY+ex-_xS__pGO4Yk^tZ<008C%~h*oxrN72m>4W0#KD<y00u)&I;O*
z>uXS@5MkgTuR05rQ5Iu>`dLAJa&tk@UFja@x1Im0ymVh_FxCVZotICgiZSA0CcaZc
zOMvMnU4tqIP_zWSQ5Ks7YL3NsDrzk;-^6QBSV6T_C$-`FC7Jvn_C@H&@<Kewe0-;@
z)>TF>3zXYRyS`!y0QV_D&IV-J!7a*-vF-GE;OM!eb<j9zHf#9+fY#ENn^X;?Nic^k
zoV47S@CzqsH8-~s$|4<M1<m5)lc~~;AhnPW*nhPvldeZ?=_a`bo~j$wLXV{}_(8oD
zRY%G_)KD}l?b51I<sN2etQB;L&m%+A8I|vM{6l1gnkL+_M28#1J`dF^4`kEMBDqmj
zHL8L-yXac4ByYc0*lEY_A+Q(1?E^6-9NyyhOkSbHZvMHal{>q9iYdMIe)&4<TG*!{
z>+_;Ki&oeNxE7z@Vm27P!iv?ocuFgEFAM^-<Q{I}Tb_5z%#s#*F&m8YB+*b!`^R$o
z5Nfm}T2sp%`w#+JLae#u$b2?IOmT++vHTbQlCxHYSj?+GuW;lH^;gT8R)^-LW<3kb
zna2)}%4|@kx$#f;NF-<33oV&fC!5LT{JfDhTe297ZK%{0XHi7Mm>!a?ePYFTNWRVv
zi?V23qfW=-2aNHAmri@@l)~H!OYj45jy;#zV|(}dii%;?b0z0eslNi7dg59z(NEs%
zrs}v5{P<;oi#o3~t~mG3D*3<#!xnidwPHpgw_m7?EB<qWDTD3DC7kz5X~-@}RagS4
zzMOH;h`i_z0%^i7=v5f)sUQDK2>*3jMmWL1_XkrG=`Y>FA9hWQzYM@Xl$sy@(wn(Z
zRh=}jm~$r7(g{wPMVWB|7rzkGjTsPxF*oV_GHt3^;L4`6$N0oBW`Gxl+O+u7w7cdH
zaeNxzyRgQl#Ua!98V^olw(5uhCjH~@oSKWi#PP|k;>f=&9fJor^>L78EFGhzLTeH@
ziD~T3KOv8=z7LaX;vX~(u9@V7aoD?k+Oc#Dk&@6i{63?wsQ78e!oz&Va8ZZ&I<>V`
zaL-W%vtvJo#!+;Zvi@s(6f$9qR-umT*!<ib$GEQRSb%uo*nHDH^KE0&i6MQx039Fg
zJX%~->s+@J%g|-Ruin1B219+d>b>+eM<(I^_QlLn^4?aaSj?tcF$+V#SVu=Yy=|Me
zR#{?|ihd;v?zMHgwvHGFH@s~-Zt>K3^DZ*<s}bV1o>>P!kf|UEDq|XsL(nfXagrf^
z!E{H?5J#7fYul!615yq_NGmVM{p530lr$ITyhp>H%UP!lSZikFYi7=Ezl<HC#8xoP
z&Crep+LkF2>9{!K-NQbVv9Qt^E%Sp`__@}stOX<7zdxRQj8jC>`?~t;+uW2{JKpP}
z?dwLtxXRzD{mZ|i*LPlrprEs<U#lBAEN5z6JsL&)Aj(<j_i|5cIFA(+lxt81O_VNh
zk{7F}dQ4wc0#D}xlI-F5<(`CaH!CP!Zl`XQ9$3i=nwHzCP&F%EU?wkCUe%ScDhKA7
z1XuF4YE&6Tz_~z$v(R_to_KIp9=N_LhL&BthIJlb+7_-@?nz|VM8c=5<;C0@rE!=I
zn6|fz)ijR~UW)e}n08Cs&;m1CLE{1o^G=MV3#{dP_6|En|FS{vt)S!oQwo-_bApU7
zuGTGXap2NCaG=Drs;5bbxU+oE!T*?y(6>48_<v0Al8Rh_^PP`V(<8b^Bgsug(IJCh
zutruk!1?}7iGsFZFW+<e_6#K*v^=Tg1?hjOM_RJ1{qYCMhC6;s{ww*QCMHWgAQS%?
zjB59O_JgeaK&UcS0iFB1kZ=v85^_r$L`!UGU-tf)xE@+hK%?1Nj|vmv%k;!a^S$@u
z!Rvvs*wxzE-<OYFZd=oB7exH=an6VV=;#8&H|(SOWDP$s9Nlo6(7!wpPwkgI_}zz9
z(cHU5R||0Rk2(({I|kKYEWA9d)aDXBN<WW>HQM?sIrum@+-e7LCOD&IqTIkJzhcDh
zfiQM)SIZ7yg>6DYU!GrUO=Mei0LKU$oxH-eCh{#hn#YnGovd%NT#Jsz@#hWFSheFN
zoLVKQuwFZRlG?EVPHihxShl?`TJ5+Ur`885tleH0uXgN(Q=0?Ltuxe>tGs!PUX-<?
zs4(<#HwcQhVFNAx>Gbe;ljCjJ$`^4uJyhT1SQ{~=T3V0eRanal`K*C-Ey(@2^G&|o
zTEzcCQLD0~P<g!+E#X1dnmAi4H*5RMR@$0vFbrSBc$39S`LYan+>eLe9>AIH%rM~b
zIDUT9^OW+188o{eBhA{1k<5;PJ@TChW^HQ|Y&N88cTWo&Z}3R5t|J(t_q14H=&Jam
zl?(ZFsncK~eYzr`Tdd-X%H-Q;>de<HcPU|~hBx{O5i+7H(&ABQ@U@%5o~S(dI`ADj
zLBOgrDLOEv<(6ss!|niG$7FIPluyGg(e%P@ieN(1t<bdiz<+=g(jnO(Z%6oXQExIL
zln>yRVye2piq9%FIT*^P<rZT)x$x~vw#lSrXhFS|Vgow#8~bvET^%-S@qzMy0k}iC
zAr871+N$l=YD!eyA>W_^{l=ol!ncIFXfSybN)OSe(@V`Idv6aqkRM<NUIh+>+KGSG
zGvpIM^(0Zbi3m46)!t-X-shTJTN?itLCK0fv~zV)bRN<6F*9Bvz}wwkS7M7S+8M?0
zo^oWrOY5%gAJ;c&<}K71f0XpAQ|tr2hO{U%qWZ{<ZnS^r%FE*{rc@kJ&)uIe&ou>q
zt88;_AzKTIzkXjc2s@MB?d_f6U(4NQRdKNIZf0$*Wwq9~GR&E3T5sddw~TO1@W{+)
z;~Ub~Sy{BP)^{`n<y$Vd$qSB?t{I%NwyzO-Wr{f1XEd+d8b0Tjx721#xn?<T?6Z2U
z>6ln|47WW9j`#SIoeHcmWv30@?z>MjyIXzf&DVtmXj}XP08*3(T$_`|#uvoDtb+al
zgrqGd(a`bGl)r?Abd`7j%<LL;IT?Ws|Exql*nbb35?_rX(-xb24)xGbzX~?h-EoT>
zJoIe%YfFh+LrW=!l|(sId2jwXklf*q1j6o?4Du^x(MkKAMPJDG7e0qwlk#(plJFoz
z#{0v&GKpV|&&=r;>gTpW@#>GXBYRZRl&=VO_o#|HXEGmxu)f@PX$)?K*uC)gVhoo=
z_I+5p&vOayLln8=5*#y$GJoRpS26xDYBC_OZ|SdP{8M0G?yc$<*k{_iI=pZcdUy0B
z^zq#K4}K7`+EwMnsSg_FCF2E#@4KeE-8(`tWVbue9fR0A>-%3W`4W5RV&Oq`7{d!#
z@qKX|*A0o*%;KfHB(X`Wi$4wr#41M3Xp)Yz<t|VuumJv=!(sSEa~BAMl^&w17bFzw
z0Dqlfguz4iua(}i!_W9dOI$@e0E%0HztnIKz6taP)?k+Vy6S}`g%`kIPC@AcNa3aF
zuR3gwZ?bg3G-xjTxA-nHQGuzqYS%N?`AARZ;=e?*Sm$Fs)e8!WYNp<5bNazs_nP9n
z-b5vQb(o&Y1ro&-Qy|!!VKB*^weqepF$P~^wlRLEQaDrd>FeM>E_{ilYq~)Wch-`-
z@>u5d-Z>Yt!FmtYio1lw4*b4_A1s4s?i0m#J&Ex<Si(*vcc7J<$+dfF3DiYYuK@DD
z4@Jj;=z%yVUqlV4l3onFt_23_hCmqSurrD~s=#FjLuWyeJ*=gLAT&>mLV_ggf|Gvx
zXU>JTL?P>iMS>z+)(`5<=PmPhZddBX2=bSGe&>Cr*b;FfxA7eALv4j#?4tHT2Q@EE
zMV>lAYl}G6_epCn^`=$chW%@W$M7t!J2xNM2h-%5L-eKQ+OUJrhUqp;!ExeFesUH)
z>+UwQHV%JE<F(JGx5+mbbAl#<i4VVSswCF?dpM07>@R-GdzVBIF}yDf{kFm@#~%V}
z;+jZJFl}>)7I<eu>`*<^(Ocr^;g*@;P~F_@;9$r%)fD6C;hL%HSPg3a3N8v5w(oV}
z8L0a;HMG1!F5-;w+xjQr3VL?;2W|`X<u88Q5~U*eD*okrlgyV4Oeq`NW!;Sd@h52I
zP3Y;PWS;>QQXSot-1{EMjP(%)D<r8FU$jT?!Rbqq8Qr9ieIRybL9x7N`01tc6V@q$
zh=t$NZe6fBH;L!ixYU?ugNiY7m!;t{ZCHb@G1{XA*+`aBg9(FlrvnD!3Yyxe%63aP
zG3H37i-z(0C=2wFR762mj_|ikoq{aWQM+?z=#TRj&Mhl9V^#xnx4Mtv9R9u3w(LT0
zcU{Ohxr~y~5RuLe(nrO-|8xXTWu;;J)G<pR75&XZQ6P()Zf-6)@0)Az$YA99N$R{T
zJJ)Z|QD&OjPe*@K5mFW-uU(XcQ)Fd)J1rzq=wzIJD2b==M_#**iqm9~x>l?F!$l>X
zTch`jZs7~>un<TY|I{%_-xb}$v*($mNRvf2H%u=QLq|5ZL_Zw;&1{5%T}ZjChuW*t
z0wo1A^6khDt!y3do>P_s<J@d=AbS<{+-S1jH(UnS4C>p?vfPn{$o0e2FEmTUb6fNo
zvYMYrwo}n)sv<wRE8(V0MSgNsVoR~dAUR1DrCB23{!O1FTPI)vRvC*aBT4<6DoZ0k
z%soMGDcecRy-r^)+eykD8V%B;6CmZD>p7rHaf*z0RYFb4`$VEj7tue79RGu3MgBLx
zMU6^qjJp8cFZvEyU*goG)LL0z($xLbPc-es+*9=NiX1XST^8smhVyhX+ym6gjcfsb
zHbYe{xOzG9E@T$ERU4GR@eJVjwRsDwZd2Ed4{-i~_j#piCoId_qK(Xj-U=u_l{){q
zT)S1;_jJ7<A8N)uuj!h%km%lMdEKllGM!&I{fonjqV5pMxETjAu+nbD2e!Tkwh{w@
z(GY`hh(R>ui((482Ji|1ywU)=0f25Az-9pO9t_b3LqxTK><~K!h#fNI3kr~r0?3B}
z%t(Ob#zJyKA-VC8+;B*4G$c0|LYf32je?9x11(D-+!{c00MJ|m2m$~>8bDeAkX8fu
z3jqA30XzajO280mFk}D>kpe?Pzz{?*<OK|Q^#AiXXYuj%fy5YiBVbXX3q<-fdIPa5
zruH!gVsKkz>H@<sMsFc@(bUa75K_Al@_NV|M$R#Cfm7zd2gtXcd~Xa);Is(Q1=3<L
zpF`}@snOqfjw3YnkRf7C7;r&PhR_d~VK#zW58=kphXa9`)Z^U{QftMLYRE+->znCN
zYL;$DuFZ&YJ%oXzX{;JD8tGCGsUU7zt%g)Z)?7fotR=S^166q}3Uq<<82V>GU?R1g
zF>sR8B1{*^gRuew0_&)6-&(OAL3&ejTcqg%?;}6fL#)V}R;nRFk)m(?_$Jfl4dk0n
zu6<(&lr2|7K14cPfg%0DZyh5f)r12VXk^B^AzygQ)~g|dk=owC*5Ao*UCJcY+y^c+
z@ph0a-2?#%a9L}#8^8Td(sqk5<pakbfa5d3@iz}~c1E$^;!L#c&+YB_0#$!J-5Bko
z*EiK#Cgyo>3@^YtldAbVsC4a*d%=qf0f1To6K%Or$6+-IPbb)Cfrmf;IXYhcZ<+b+
zr}c`i1Nkrsipy!O;tz?~xfq2bu<{to8rnR$aV#$V1vlodQq6DATwF;>T*g#>9~zh7
zPd&u%?lLj4l|-BLlJ@l?dzRq|JCJx;CGE2wuSSTamD8{+gWzYM?8;ZK<*2P!D~Wf%
zRqX&nxU?@=hZsD3*^SWXS3J;=q?NHw3eM}&4z?{?C0n@W+{bD~r1Z20f81&GWMME}
zYqE^pXL$&<+V>e*NO6v~G<sFAjwYsK*{4+{X7^-|871*hrzS$*kCA}O5}enW#uq|m
z0#45wiMw5c;fEfHz&$;d=N|>;wdcc{!v=qoEE8`;f>^z3wjRtQ%zF-#G7@jdf@)lA
zOzzDm8eiZ^3yC*GK{Y>WBp%Ic&3lfMJQ8mhgW^RN*Ix9_^n$L3k%tX-k`fYcG9~yw
z6qJTWlQ8qX1@V%^Xs=k=&92wP$mg3vf2(;4i>w^Tl`SN$9MH_+GDj~1GG{|==wfk{
z)KRCBWaqTzn#>TVxBb@$i!zu0t)>gGobZ`NO`e#YFWEy*&+R#fG4WStKgv%gbDLG=
z*e~Vr)5<U=c%#d+F@67S$Ym#oNV^#cAgksK1KL<~w6mNvWUY)ED@Wm+5eG3B?3(nb
zw4896SL86QPR0^Gj-t26{iKiiNl#zu!U_;1+>KB%@cBdRH&Up|!j4&2W!kzG;zK`(
zBLe8&?Ths?hmOYGnnEKSXkWPGH)_1I30}hq`UuqguohGDf=4j))asfsdWQI~zoe(I
zIH+(Orm1L1vH$$s(cio6(^h*}9Gh=R=7+44Jbx}O^g(8iZZ8#2Lp4zbLkPKbj|rMW
ztD%lu96}yx?D~;(R0>A>Jfn`;fU$)YuF<ytxSV-rY1kX(c<<D<Pg%nd;4tqsz&(d<
z)`S;1iurbkW97g(jJ+wt@s&_diNCooSoNeq;3x440+K}!jtNKNt>=!n%s(38xY~&5
zcOu`-p|olOxq=%u=|N}&jB4%wWfwVJpFO$9t^6{b&4pt>p7WBT5=1(9)=)7f^6h1}
z;c-(Cf4r~kk^*~OgNvBp+1dh$9Lo%V?YhEu#~JU$n)<CuHs?W38qf^Q4I1d9FEk-`
zm2II`I-po#qYP}MxxoO9@`X;ut}-v2N(YoFY?Oj&H8-fC!@khkSYg(M0%-~;$Vm&@
zpzRkS{07&7$ICiZz`uN<6tSz+3*se-Fo4$=xLuX6G{pkw-xs?sZ7+0>uSuOMfVHwt
z1+e-xI3RZQ%R-NI07T&izf}(M82<1E8v^pml_MU$C3PwQVzh73Zz3o?>Pz{RZV+^j
z-iyJ-<xaEg`ZO@az5t=(Rh0O4l1ZH=0J3slMQ{b>O>pTy<(mc#MmXS+pj8TjB&|9N
zqSS`^R#D>EK`3vMOBa=Hz#5E404x@}TJ0oMKGh`QVlbbk7`wJglCLbFy8La~vRFY3
z0`AZhV}`nm!MWrpQsK-cYKtIBUFdDOuK}3E7m63#DGjj>7nV!%)daYe`RahRZorlJ
zt;&$Ya8f9!PzS19RY>)U3J+!CR8<e*Q4W#P-!9eQxdB@fv`Ry=!b#^qg^%idCZ$;)
za?4S~>irj7tBi5rZ|!}MV@rbrOQvQ(#@bMzW)B0jf$}D`G*kJeQ=|C?oJHW#q3!(9
z<IUIDQktqwe7J)c94KeRxL{ahoVPv%BYiD-z?5I|*&Ku+Px}#X?D<fE3`MC--SZA*
z;{TrehtC=nCUJERyJ3SKMWZ-<``w5^QKAZ*zQ5h@LBpcMoTPjA??Kds>RhA;_n$yG
zh0|Q5`}glaT$!8i;|tGuIeo`?f@gUO8RVyZ)PBQ0Oyi%ZZRf-qg&oqJAbVGsE$!Kw
zdC{o%JE2XxpHy7t$8RW!@-*ZPxuJQo6>2r2i-s+$9tvS}rTJKW7YMWd*rnxdW#;u|
z`e+&BGCyR)R`l2M<X%p~2KIE$^5l*XI>-~Bt9xa+U`k?o;BWlfB<q>-XVQqg)Hx3Q
z-2<)UbyPz>dx+)(VNIz-F!w_MQzcVTFDk*cAEzSv)w}C14W+H%FAo$WB_A3>n_f9!
z$DFc#7#-J!8mfJ$eC}M(IcG_VXJP2P+>B%&a?f@3jAGxrfa~!Yb=n!(tB@HEDV_if
z0~k?BMj+xU?69OD@Gbeyv^2_OnB_GOb_Kdwb}t(3H36)QLx#u*VFMbOaZL{^xiU*X
z_(?n&f+#$Feh||WXzgDwp?GqG64T@P>-E*RFWK+Zim~JKxoh}C9i@j=D*8K)+j;bN
z&b>_M=3*bL=-(h?T=?4nX-@lw?Y%>j{Gy#C%sBcXq+Jp$F%Ozjb(PxgVTBeQ0}lT$
z7YD8>W~cUM<_uW!BAt|*w-?%P$OJWcnTGcv{=e7aup7PtK8h)aVQF>+IJF05rLGAv
zDL!GuAasOQ^0VaL=TJ!|i5NO!I_gqWC25?@ZRCBRq`t*ryna+$V*=jP3sp4A+J^dk
z#X8V%uw1=QfG^6qZR>bbCMp8!-`zvhjbA3+o&Vv_1L#Ty4q?4g8AYKX6!r(}b=g=w
zfB0IH`0LL?Wp}JgJ*WB0|JZQ<9OXTR9wxE~@|t#<FOz!ppC;b;P7t?Ef669qtXL|;
zo|RzrZ&;FNoNF7LPpjr&woBCpX&6;2@DbcJX-AdhmMJ7?L#3-Q6+8+kZ!G0{=oWCm
zbxR;j05ndMBF3(X@`ga}GzHG2EdT?U0HID*iSm4MNy6HIt}<cd1#L0A^ioe{KGFqV
zF*v8(X)=Up;ce`>$o0@KG=i;Q00kzvYE_~PpH`BvCSa{xm~w$t49+CiL%o0s4yE*H
zDQ#2YLtc0rdc<;$8E{!`w`=fh>?+NI64(g}@+D~1hok{E$`mN7!K#`Cp>QiPxS*V4
zI$T@39R?U?fq$-2lkupg^aw58OoO{?yWN1fVhuh6(H9(jp)s+!%nN$j?Z*H{X1HY4
zl;px9NKFTdTs0-@5k=_{Te_&?k!hKJ?kgGkwhu^^TzQC8@rBAoH?ZG9`|1WfkKd{W
zanoR%0ja(Ak+RKt%X-13*!C+Il|9%Y5x!78x!M%CsJ7P;z?#XfSNjmuX_zFe^)~V4
z2E!@E;H+|!$?$jDw{XBNKA$lJ9k5ZaP*4j7Y8qKgy5C|@CBx9zD>xZ9-9Kb$L=$zS
z|NNFR&NPA7k^j>_g@uVO`kRtj$cQW&x?EjpgW{eYTAW;6NrUX30h)>&13-_#l_FxF
zW=TtrnmgyGatav}UF_GA24#yc5eqc)Of@(;YG$<~pU{+Oc$jPOa^%c<6pNEtx$}M^
zrwHL|$~u)Le{sc&;7!S6E{j{2rk2^$LCc|WW44G{mq(O!s!V2^t4OAGMTtnDxngp_
z%~3aN9(jjmDEqgp0cb%T@hzo`$pNn;@26*qAJa0;t>!YdD^*0dcRkC0Mbf?A?4=qr
zhdJOwSEB)>G_ezR**@yB+ya{W393mo`5QAvMX_o+B>fMl4X&;s87Y`L%AI<sM^?j1
zSS$=gD_pKI6!cjuIIa;C3`=iz3+_i`JZA_*ZAb{FUQ?#IUGp!KEiFX$&BjMu$7nNC
zj?xv_Xn!#$>C1O&5gN+pYEibwYge*1#^YDAw#HjjvNp%NR<gFob63_h#A{a8w8Yb^
z`RrU29Vm_K?WG5fE4qwnWpZsXtM5h%t#z4w6^SfpG<PgYGu~_~_|N>QM`Y-XNZqQ~
zYxw=U@56U~zY|f<vz|8Q#Z9~cMj(>L>~7et&!ph|0a;~(*KT&L)BFmTHPZ=hfQX7&
zJ8aD!|KEA9*z}{k&sJ|VEK3ctd`MRqAkV#A*&QXd`75t1GC<mHCBfz&SCu(cO4o_Z
z<}{Wfl3&s7wb<somlA_t6n;bdsMtS3lHZ$j2`3nHzl|9uPlRpFmb|CyQ*}HeS{ldq
zkh^48SL9sNZvGETUm4YA*K`e~K=HOX6ewQYJ$MOFtObg@OL2F1f);moC=x6<1b26r
zKyfH8U+(w$)|zw8-eW7jvMxDuCQiFDV?u)P&?L*7T<{LiaOGjKb2T}9u=R$)gvFaK
zUG}3j)rZRXRdd8kf1Y#VGJ17QvYbS%1gO<rrRtSt8CC3}hhs*T6Y|8?$NB;D>5V7$
zx-7gfWpY-BGY-7NtF63Q$R?U^r-qS!mWGk2A4BqDV{a7W{ZwDd;_b##gStS5?MVG0
z;7I>y?v~+!x=cOqB}vbxGhg(#C(lvS^^sJhukH~~sb7`4Xf8}sxkl=lwEaO`s*~=Y
z;B4ny#UtKx`Rv~xop5&{Ouca3|G~}kUvK1#*b(Av=RyU=kLyQeyRXlv?GIDmZ&egZ
zUrW_R368SMiT~wXA3^g@E403M7O0DoAFUs~ITHOlCnvF{56*vy(rf3Q6;>lX>O7ho
zkytYa7rbQXwF73`)liQ*|IRT<tl7Ebzl7<vbIuB@6CU{;%_#-9o*e<7Yv^ZRk^lFd
z!NVEvCqaMNSBdiXXxz(#32zzwo$HH(cryU@RA0VqhOS_K$(^tXpQ$V5B033R7|5Mc
z+oX~U!>+3_RQc{8Zr|;*f&bgc;~3(<uKkbElrcLfjqBgSt>c5sbH`)5m%jS;MJu>o
z>+MGuYjfUt6q=7SR<{cMiQ=KwEU_Zi@1sodQ<6~wgBp(AnLmEPgniglvIJXW$xdMX
zan3@XPP_5_Tu|z<DQ9|B_dA<>t&T@HDSKV$<79!h;@|dvsk7nO-rN^d4pAwDuNyEl
z9G^r<ecP#~dpW;lNqyL)y2f?RQ<3OSo}DucpWxZt?=VsL8X4QCNNVGh%_lNUWFxPp
z4p!WGT}J)@2<uqRKRZvsCV$Wg>*&uvyG{`qlk^+Us{z9x@FIWnCLCZB+Sh9@(<NT8
zJ?v-XDAuQ<iStP(vIoJajsg7#d7S5PNqxJi+XuOvy}Vc#7@O9$&&zZo`GXDiGi_AI
zhQ4Q7ShgdKP5T<@W!l^eCV=e|Bqa)C6W+_4aD~-qTuZ)8j|g9LhP{+ai5|20#Dw`S
z=5?A)#oo#JjY}#CUN5jb{O~(;s+hhay8~kQj_Th5ln(1ZJ&+PSH+Np&lRwCZbqwX_
zoTqejNmA@g@@Ze|KNYcEPnz>z^RYb0`W;3AuH&(vS)zQ0^&gCI+H)lRR`Oqu*nA?w
zMAq^;ds$^C2Fv-rF0~=wP5ZXi-Ro|S$ZQ~WWM2DhGRcS{=!rj2o+lMjAnHp!aGcK-
z<{;=xJ}{hv3v&?tvag*s+2VW=y~z$!x)$K=HcwL1H36MpAF$3-WIK^N0<MKNYvO!y
zo_<bK_;&&ysLvN<o8D~5v|`<n7K$Qne0|_LA1ho5=#;g3;}_+Odfp`K_Qo&Fned#Y
z5E9TS$LQZF-HLkmSm+htC)SE{7gqQf;P=%N;clQ1HNa28^W9xZVOW44(DUuxL7{Yj
zpSUOHT}t6VfS;7-o4bX=PK4LcYnpRAStZ2Rm}~BHhi9tcef<ExSicOg|7+Yl`)q>@
z2fh`4ylqn?c~oSB2BVoQ0n;g2R3AEZt6u5Ad6!=Uj!sTa^^Po`pd81Hza8`-{jjTP
z%4y=w3$92Lu}G8at^Xjp8Sk`N_(LAILyQ{TktKseBd^lz908hwHkE3Xgo#y!6xm7h
z;P+9?VvztARXcy9dBY<z$F!l@m0e}iBNoRp4wq7$dDEjEM-N^V`XN){V(jD*r__g3
zoq2OBzn0OuBU{+~+UI#8f)tVn#MdQ~4_;p`KcYRzDJ@Yae47fVNuCNXJeMSicL!AP
zYgW&M(`<i8TfAY6*!q=<<&Vlx8``DtjTylkm2UnMu61xk76o(v9}?s5;+RJO%zYgw
zU;%3%(6pGV{mZzi=c=kMz15T_{y#Z+68#OX(9%@!KP#?Fe?zFM#<l77r}7tbg@@`c
zEV<&7BR>AphZW66=VX?w6L6-~FY`i}d{fq;pumjWP+AOy85Wb2QdWbR=c;Q%O?ttv
z&Bvi1*yl*QUkLBSoqq?#Xc<g;+?D>2SO7*QM=m9l&6xTMs^lb%01imFv=K#vH^!i6
zjo4AVh$rkS2ZOpcjBdIJPwb~w0gz>?Jg0LnZ%=xgXjm$nV6ax?%`*R#qL)}O_^*@<
zhon4c#5_1{S%r0l11!e6!sU{z<7!}q+HyQNd*iqiQO31b=LDR>KVvi#Ij6P|m&S-M
zg&7U3Lu1;-`t=MZ+ydmEVZ<tIt}1Me%6=L+drP$x6(7BNPa-uDp7^2b$aiRw&k~!R
zxdm!4SpJ`Il!kbDmXzXxq$w9<-;ZwKe%-bF{IC-UgnLz2Q1~ZONzkCBZTj)T%uk4M
zjgc$r3)9juBCyKWGI9wQ6B(;P9EmVYifzP9dHMLKWnw^lD1^03x4kz%b`I6lQ9Wl^
zH^o0b2C}?e-DyB^jbqy-()?-Qfs;l0x_9a{s=$XK#x>7~ptZoKOla9>ZR&Jj_G3%i
zXx8OOT6)6B3$fHTI`k7lzveqE%4_uC^-rU}Lix@V7Jc~kqe#y$+sWD1DBTbBN?7n0
ztVa5HmK`0yjS@N`Ddz?@MMS}b7h*P`W@U~VlcTK5L!`AR_xCDxDI?vdS>E_6(!+am
z@??}L3+yh<I(j3s+IyFRw=d+|>l+IYzJFNqWM5MFI9>d8)_3)m`P4(7)Y+|!+YKvk
z?S62Ko~9bQmb{`7GkRH<wgrVQON#r^6&4q&sXh}4O%3uJ)7#n$#*0*x)^X_>o>i9S
zX5r6|qqlJV*dt@E6YmI;s^cX6^+mpjc9^<bG0*jbGQn^~c;6lXSSiAHq)IxFXJDe7
zgM%bl<j{tUiDhgZTf0VrPkp=yTuj4E`Jc?qS9P}o!cX^Bn}yx_m*)0u`HB7wPP}6u
zrxc~`E{*jS%*|Q(V{=w(wr87}1hH2;?bB>QG7s6QT&+%Rg4Fk{X}0ucB?-aRNLCUg
zO;DZntk!(*%)o@Qfm%XZ3fk`a?sl2-DGzVRB+`Ua%2fz&$o76M=eK$g*M8EIj~h*9
zR@u>7ykjeM64*{N=PQd6Qehj`<R2|0ynqk6U1!JzACO;g*vFyELWU<Cm`~zQ@#(bW
zU0r7bT?2-j#vJDy%XAzhlATH%XHJq7W3wTS0{vrtl^L)6e6NpdPZS16Z(6)3$6s>{
zGQ-FP3&Q-QppvdHJEr|RrjgwwudE@L|G0%h`{&kC`hy%qpy%(26kr`}C<P2!;khAU
zz1#6(@AMG~WK&{Q^*9~a)3>VMto}PIO|>A+vbgPgd*~K;9Dz3Nc10pD=U{0FV4-Rs
zp&qT?_jyAku<Jub)Z!fcidcZ$dK6e4{l}d<*T(3`=<s>!+u18}0qtq)dpBVM{KQ{p
zaQRvERZW?SiJ^9-<*Tb(1hf3>l}%QXys}|PM0iPan-w%^Q&z<xvCBdVDvS-ZZt(fA
z>`TS`4QcsHF>4Yu$q1`)j=rdb*Kc#^rNmVXV5^&_w&-xF`c<K)A^C$a9(YaX`<#Lo
z)ca#}<L*8Ky96wssa0n4w|spyZ5PE%*}V~ZN54Y<LbLff&#5KUd)Wu%)$aq!IEGst
zHr9$;&uqJ9_Z$VreBHbVqS-kilun)+qkr_o)dpF(7-L=Nh)(R)-Bx*+7>D7l(e*gW
z-;}e>r$q(|0rQ2Ul|EP`4W+Z=^06aBN8fqsY$Ma&7Env6p#bRxyOs=`fkDEP28@jR
zizo++<K^F4t~FV)l2?33OgEC`I&G{c-K1m>`3zt64R+P9w6TG~PveLM{!b#PK*H-4
z+~;v<fu6s94(+}*DHH(B9GLxg`F5YnB}<336c8O^pcB5)PSgqc!kD}WW=%F_Nq%7~
zzn7XHX&KD_dFJHJrybqNX5xoNq<cuEjSl2%=$h=Q`=dcVS<K-A=5B49hM}{!?o_Wg
zSG<Yx7D?^X)5~C+H(;yj*V7AWZ&T(_=X9xhI%RB1QHQj*^`Gp47f1g8i-lAVcRVSA
zt~5*o7fNdrdoFThiy(<}6MH_$XNDLte|!BcY`10_&d5z-vRLJ6m^=O(6qNVh$L+%%
zgC9jy-`YWuq#LB%es--veQGLNOSlY0MLX;cYJ6vO4<F{dI?JoS<$C@Y1L%88{>xVk
z^S<CKvdC6rs{a|!_M%qr@4_FXqjaDV2BZ0Ffcsa>EFGLPUVk&yI<H4ke=`Z4w|!^@
zN3k}!PUFvGw@xoBs%x&mtgM+>>W2?WtTA-WZHoU^DO_iQrwBI&L1~C{J9M_uQ(I=X
z(eqmbw$amu0(`(DdnP_0%$}4l^sl`TU+AGdDqrZ4Jw0D2%$|@B<*z*-pBc;^hp+gr
zJsV%~p*;m(>!H0UU-8j70$(fa{4?LBvwJuxnTtEW*+YG0(=$hBr|BT3xu$ea?H?aY
zV(gHj<^mx2+FCN6WKJe-KKAQ*3NhGkPpY849LxmzZDt?7W$5WJ^oFaz+U&2);OMVJ
z<4{TEhTOUG>x%`hl)JGbsY*2r{ikrer4~y4CmRO$>cgl`YALx=4Q$n8-O|O2=r@Ah
zf+$j6vEy|y58Kl9mA6|`Rp(M>!lEVhZ|;gKyf1E>YsF)?Q>|u~ZMeHFodF{c2-yu&
zN}INulKM|RvgnR8-WNC~r$%kQU!<_b8j!<d5w;tq_faSNt&Dtdmc3DzGvC;BAlq!`
zj`8J=$xiNDPwq2K?#oT?V@&S9wYU<nxFWW=Vz9VEv$(2ddvTD+Q2My+oj$o=AIzIW
z-yje_xgQnGt54T(&zLv1fM%lzM|61#fV{CLIH7I0XU!YCMYE|4<`t!B5U{bn!nIPl
z$ftSuA$v_NgI9Kkn`LD!RK#3P0a{js{#L0a62#YyP=sz$ibVY`OExvVV^*uqNh+ey
zMC-U1b*&9A>x-i6vsRaFqbM4by6{cN7mmEeVGtA>bIRL){q^hlQ||q$Mn%{ym)%KC
zwqAWK+e;K4S>8`Ci+|S1F7pioK5AHZ@-m>CX!3nx;SPY8H>DIvohYZQ-#nckrT*=J
zL62lAmq2{O`^}B?G@DR7uad~)ET0Q5WoO_`y|T0Tjgzu7ayhoxKW*c``iSUJ{bpk?
zY$?wh%FaP*WO;Lbb(I_Vk7tqX+k0)~Lmt8jSLFtGT;(<Ve~v{zX_N{5nO6R!p~(H4
zyZJN;#Z51goWFUa2!<Afk-(^Y{pPfdD%@x6O>|teqhMgX9On#Cnc`ngWl%p+**8M2
z?UDl`*`QF%Q#_21oz^~asxDxh1gq*>apg6zung-Kumv~qNJ@>qnMC;-C0y~Hcs)_e
ztRjWZNi>HtH6BKqJCAm{A-;~*_t9tY{hx<6X_fU>ES&4;w4WY}Y)%7e3N=fg+x0wS
zIvERdaf)+!nN`3FdVWN9%Rx<+V_qobTg$2lYjbfSC7&t99n0|UU4d5LrU(rLsYi22
zxEwY8*C#;F*jJ{CLqRmUk-n347>#Y-9T6CMRevd~X{G#{H}KC;XP>(m!>#2w5Ki5C
zAJyHLUo|5G>^p_lC%Q;x14!hJf_V&gNd(j4D-M04b)>F{TN21kY2KX#t}gC;)*S+c
z<LW~}LYa3~w%jh;*3Ay}xLmfYyL~Rlb{=uFNk;G4uf;+=*^jJ|uD|fz2#!@NL_Y{J
zph%8nFMhP15+ke#U{&+k<9pk<=ne*r>t2Kb2_Zm2ycN1z&Y9ms$oTT16W`)yQv#Qg
ztUp8FLmU_6IPeBNsh6-O9jF!NWfBDzLa_}cd5}52mtx^tZ7C7fmcvI*&W1~nsS$(o
z@QOjpGLc)nR>gSK2w<FiUX*WG&IQ>|d^)*)V79@iuYX?S*8JW+vh}Dsc#>5PXhs^C
zNCjr(#*!9UnBcC`K)=BFDTF$Rbs@Sf^LRQKdDaS(;FU?R_7qq<ca3G09~N$3F#uix
zRP$Uk6I?dW&+aUrEQ32`e!Ro<iQlT()Ji^CrYzA^>j8Jla*$}<^d|d-J#jDK+f*|h
z>SPGu+Z1Cgjh6l5%9`RJ{4tgPQK&#Y^@GjE;xMfZom0vZnhh(IA5!Qh!$Gd`NNtS)
zOS4w1CQhtb!ggxxO|ROjpDPhVe&=@}<&6>fjmKN{kw1^qyO9}S)9b_#`RguOc@_B_
z>3zq~o`HE1gKeo}`KWJNX+Pz?n%LjFmY`GVeAp(06@&5IR^HnbHlsd}2m2i4CU_j-
z&VFb=M$l`NW^<YvafO*`TP(~M7z)LPwvc13cyS+ZPW_?g+ZS}mR;x?IOY}En=X3^!
zp8nxuH7L|(0=62J=x&M=`u5yIs=X_4U3dBw=})u2H-+Kd_K;$ngM`H|^$-OENToBA
z+dr~+$#D>CVRt9{{O0ljQ~RvhkW=5s(A{e#dbew2Jr=O&9ZP7p0l?6xW$iXj_hh|}
zX;z(g=zQEHk)`PUndpjTl|MT0ZkO<nnV`>&z~@4Dgiub*uxW}Je$^^g$=pa}4QRIp
zR6KPupt%*(-xaCZVRUF%Oi2^fV_0xeW&VwlW|;f1plXU^Djv?8UV9TF><9|O8rFd<
zGwP2K6bw+wNyoR1pODeWs?3iqvYsW(LkW(e36BoX&ykBIFO8H9CI)2oWtJy3^J~~8
zJ;fQSGe;#f3XV-;lD9tyr5P8x<DCO3*EL{1ZT+M*7ny(gQJpf42l>Z@6#YEt^}6DA
z|4Ci|@oVZ4La#|amW>K2Mh^U1zfcC)Uad1gal5p`+i?HfxtZhbuyRI|4n{Nwv|;eY
z-8B!^2eggU2V}yQ#6pEL`XRV-)54zeQEaxd=s(exjLUaeWtG&(XN2p{3x$himERE!
zTbQ(~oBBkWGb+yCXMIvUfQBdHa{klKDR15r!DLHihR)n*m&kC;jnDch%LgsQb}wwi
zrg;hkHRRS4r%4^KQ#tgveLdj3q>|4dv|yl~nDK}PNFQ*0gqn!Rotf?uYsJQYZ1s;%
zbEc%`f>8mBXVi()Ld&whrLbRe>kbd9T=M|m`een^A94b-b4Q3hGOG=CIa(9q-|0dJ
z3!HhVV<$O*k%uHe@?vXZkML^aUGdiJcvSyO#9JCN8k|<?!_OY!q#=q=f4r)(6O3*R
z$Y^4l>HmKAm=)GSmF*MOMjbLf-4c``cT-vrzkJJwo_QyGTS`U~NE(!R$6$-;yj{}5
z(G^kRSkQ^9v;!2S&mISLC<1~=?-c=wq&}I=!KCe3cf_{Wj@#xfQ!^0-tFY6)i5BU{
z&mP&Nx><L~xAqh?Y>owqxShM%*Fj%frJp~iK|$DxPjw&dVx-%a#xZlM%n$|qehfU0
zP{&^ztx`A_x#XXIP1XCc)H3<+7lYa2@OZpYan-R7!#A;|+R|gD(&Ge7WegkLXseD$
zHCBl;f_xi{$ws0`UW%ghFvg@Fie%5xv;z*4j*@K-r6fZ4^0rBpF{y0EwxgjZBPF_&
z(&P61p><_?FS(yLB+0K7b+__+$1F+PnnGSRvLC?px2<>+;y3+<H_3)K>l2@a9eOBA
zTB1Mou8n)8ju!C$+klq6V*7-|HyOTAbl>}>zVr-Ij$Vrc5-7Ty&q}C?m!$nnP1vg6
zda*x34i$l}hG?$SYthHK(nL!!(8W*{KPI)pPbDt|nGYEbM|M4Bo$-o>yDZFe8O{jQ
zq!uXDc9UGul_loHnqk&GS~|G%29zVPFF>`Oo<Ha*S4r1=K();QZvjl(mf;6f#=nRF
zifmWx6QW@GL4~~}p>t6++fh&c=+|RRgL&$$@1N-nB<6F}HF4}ahmd>~V^K19Yremw
zC{EuDp$Xj32~3LIEKtR5OZ{p;POGt}S*6aD9;>2orTlU1OG@!5*WZON=}O89)QJ}J
zt=!ha`eiPW`!lLDqu=rc{!Uk_zs)I1-`t}K<YMh6joiFa#T`|o8nj2_{St^<MwgoS
zmA#ABeddbAQ*O#T-YUICmRm(99hCh%O*i3dS#RFi0Ik<&y!94tVtimzQF#6K@tHHl
zH{;;3U3bbm$tr!CCY_pf3|s2lr5tUa_QSC&nycpxI|OfR2>uI{@|O;$k8h6iZ@#44
zDJ$U0<(C~yAOC!Np^D2aLv=StyIAtBLxHEehbAzdwcB?>@5Vo00A5r|mfJ-)Jt%wa
zno{aYH*ml6e?3&19^Uv;AF<Qk>Jcsk5x!dxGw8YK8T%^bus}xxDQ(WrZLWaSVFb2T
zeAP#=D`2y#*fjHT=cWSc{oYCt<8PCqUPnbI_a|IOEqQNiQsG%_PPf_m@OUWdp+9!*
ztgf!^^KXo%Zj8i=wzAtS*xyFh!F=Y}LS1NyTWA{lGEuh9h`|&jQ)FiLTFa=JH1c6b
zp>2UNK0H}nZNO1l;=rUQCaI5EJF+D%i=%%q%At3gBS_Mx(xGh0)3v}go=<=@0(kWy
ze8JwewcoCY1u1LsS0R>hDcKD6^HH{dwEK<!+0sg8R&l%L$kIE|f`e;$|5>x1?R`~y
zrdx0d;hkQ`U(Y}Pnr;kUK9FO=Pkfp9XYgou(j7<*NZs=~7ojlYj^U*UvTw)32-AMY
zD^n{I08$3zccCgXt8Gd$SmE8tMAD*rGeeb;MdI_-0u+>)RW?-^l9|ra@R;!KbRv_`
zy(ysu=-v!aV{~s?=nlF!3ltaKn;M#k?#%>MLHDMI&Y=HF-X=zFl&Sp|P^Ap0=;9?_
z;#vj%(TzNqO(IjCHEm>VF2uXIl{BKW&LllVyv<-HEly>|Fv}PvGO3d<<<z8hpEMzk
z<E0Mk=Aahsdc)=Tjvzfg=scWQ03m8@(6^L>`q3bQcnL#pY>>Q^hZ<s-MqCz#Z)QSR
z$xSWfP?VLaTdCqhXijLUGqLm)<mSXHz9XEen|q-*-f!I&Tkk+}c5qBVLa}*#MnbWB
z><z+kxZwl&Z651@aGZFTdzpjkxwvid;@*v5$^;XOqt#dD25Y*0@2RZ)rcdB7v+(V+
zZ30ocjFka>p}SsDO~#-5GCWPSWrYpr^l84Il7|`n8NWM*Od8tCm-DX`Xl*L`z8O4J
zyUr}6n``K;*U@o0#>J#b6}kt+q;W9l^%-~I#ik*WIYq73y2n)tkkeR)q7J2RXBCUP
zYt(-RRC;^?u&mlhNv>FxHO)=0&7Yrk_B84VdTO(97+7ilV9--rv7&`CHCM?tRL#T0
zV)i^!B-gj>MsIYYEeVbFcJ+U<E>}lgN3m*EM<q+KY9;OFhwv2`GflN1P7Zx*t!|(1
z0xv?E-Q^<}lB@-k+wyd*si7G#ErynP*BH}Dx@zf6CMZdpFR`wjH2oAu3Zaf|9kxAq
zXn6;ElX)`PecH9;3K9yXJEVbX^UDU(aX5^uvkG}-cs*LEHN2oQQBe?R601enXf_N5
z))f-Ig0c8K2&!i_BVDW#bqn25Q*z`-4yMR2IWqdwM+5Wd{-PYDRx+(04lfa$c=L_(
zTK~GBCE3RTW9j_Wy_}T!DmNk*Enl!aIL7snHq^#Th=9Kif_Ju+pkgsZ-aMCmxA?f5
zpL8HyRD$<6%$y2F3q|<^NJ1HKut&sRckkPL!yxiK$V={m61yW1<<?=QME^_6Bi%IG
z?E>gTS~P**wosZT5l>s2R#BN&u_f{_Nw7rJmT1Pw9@?RNt;%si4~0($evqq0dv1w*
zBHonRB<Vvcy2Go{S6DzrHn;Wi^#LZCl+}|POI2A|nnq+bI6MQ|9}cjXBJ(5FJHJ;D
ze!HMm^u<!}#ms_ToJL?5;|j+pUTd^D{epds#mItfZhnn*Q@XCm5t$-|AEKb_4U*H7
zlf&)?WroN4;0n?#UqvW;S70B)x4wr3)f9Ah4s_FRZH`G}ipWN?Sh1%VF=2OPqu^js
z{oIwZdVU4XHipJi*+msDR#WlFN0RY-2q@?s7mrX#94hBW6!&S{tW9k8)Upy1$ouOJ
z2CK$KVyzVZ(gkf$=z?gKk5$Q^#UphYonF333Aef;weV(QUo@;b3if@Fq7zCQKgZKB
zuS>i*9m+hJr*}o)DBLQ0(!`RsZ`9hE@h0wjp@G`!Yy-8nuh;2ZrNx#!#bQ4ZM*}1y
zh50#UsVDm43yk6hmPCXdRoNXI@Vp#MkU;<p>1?tfRQ{C$xZW%Jt@>L=934uqRmGuv
z+)HnlPd{-{EgF0`p?o~>mv81@=cZ=n0XW3TMTnm;ilo4^tLPavs4Vy_9}Nbn<M2lR
z!{r}p87yO*Kah2h*;~{vx<gE94oSYt5PDqvPLg?6+kYSNg{|c4=RlX(OZ(nKONs+I
zdPxOQH9^qqj~89RH2(J7!&h<Xv{6tlC(jb7aLo3zjhf=}vFEJWLOd@dxnYTieZWLr
zk}y$MYV7%2s#P7+=Lr*)yk!%WP0B=t&@crx6eoq`+<8BNQLZIZ_6?IFnm2TL>BcEN
zREfHQ2{F$Yv}BL;-vnJb;Ohf?QGOHT{Xk2WfiR-rig+Z*OYTBO8de>H;Y>zK0TXmZ
zG$*tIP)@r4GRnPJ3<>BrCPXHQ)%|1vxS0^!srCDh^ekzB*s!k2Gw?og7iB*G+!^5)
zQra1jl%Vfk(&uK~Ii4U<+CTmTDzWDU?v#D1pX*h(cTMhB4}ClH^OMs?uey_KasNWF
z^FEj|%R^VjT#sTpZ4VA5Wz5$Hml#Os*W}w6en;Tz(Wy0i?-F&2k^W9N-<tdx#Ytab
zcskxq%T$<H<#<bX$gS4mRqvc`aJv4j#R~)eG^Fm+<e4uIW5i2m3SpF{&mW0T9+PX`
zgZ(KO`5}Wko8I)Tq)h9I_mI1n$F6|K&MhV5l!Z?iFWOR%z4$Px#Dls0im<-H2v#j3
zDKr*q2D6;D%v;T5%}O2~6Dq`&;<KaYdj+Yg69=^e)@3O4X+?%^sPAH(wYHiqxla|{
zgxo?JIV2&Xk}ZC1L(21L*I{xcF1=ZJnjV&|39fF5If{H0<y)=<O1tMKB2DNmKSosw
z?wc>XRf#Fox{bNqmj@$xV`r*CU-kkK?+Xe5k-FYu-OkjVUzkV|6-Tq!2$&e7A9`9!
z*?U<TKe0z=gFx4Botd=+KIV{N;Byoh{1L9~8|-%9``#9Lg{k-J;$p{r>5Cpm^hCI+
z@$tOcR-?+aWq}c|q@c}Dyt4$w>Q=`l=Ve3Z(_Gl9<ZkLXs3ByCE(0l1{^oPMG5+N?
zl6}>XnF>-HMK#wF^Ksy9H$GhkntGbNvS=G2eRImd<I$bmxNpgY{5U#KN9@3(1t4m`
z%i3Esme2x_F|b2o{CHI2fN%ctgmdZ620A!*R|3sApUyUy7tN5n-N5JPNjB7nw7@@)
z5O!H4j)m3B^Wu#2rb(9nVr^#!L?cn`SISIqr_?8MyYiFfUjW8YtN}UoJKTC*ntmWc
z6c&$oXTe;Gq}>7P-GSECL55l1dF9lNV)jlckOda>LBZ;)ok5p=3GkX^Hsko`5wPYv
zpC_?d`Z2AQESs{NXMk&cy4Lj7Y{F3~t*|u9p{A8=1sqAT99mk*D*cf2OwgLfolPJw
zNxmim7fP4WRuv{U1Zqt?TFH)-(#|Q%X?<g{M3d*%#QFyx<QWG2g3Vv4O5u7mS^eYY
z>xN$bF@8t8>e7f0L~Uur+bgZk+Q+M<F6H3{-IVR(Bx$(%;zT;BeX)r`<%YWBxw($;
z{swng54NJj=oMfmT6BEh@!U{%aDT%!?CR~6RCn-jQ$Osx*p#DkBiW%_a%{EXtGDFQ
z(XO?m;`4}XTH^C4W$JculJZ-4rb%Dz=F^6+)Dq6aO~r8a?a9J#-My8XMBzccjqgqH
z@w*wr+1o4DzkNFGI*X2FJDwZs=pS#iOeZc+T-L2eZNfL=6{VSzUcZ;M$raV{@hN{T
zstZFm;lq~^#vf#5j>}U0yrE)qoV&cJXj%&zHeyPG5->)MsS<4b(Darwy}(L>E~pad
z!-=fv1#%MfK$Rc|PQIDeMhtJ`GDgLgF^lBa-Ng-WBQZvSR0&8+ndenB+muW%$R8f{
zWUAXIc5*Ks;+$9BC)kooPM-wDIX|+~tcjq@HpRkeBHV+QV4D+KxMEIuc;g|{>hmGN
zRv%8);nW3AaT9De;M9%suu*_!tueT8WgebGkYKwaIc*~i51>e}6@o)`nbx_m!j)6F
z6Q1IA!Bg^<wc#Y8*-#TO{-xKyWB4Rdk$&`#5JT^cN+?-Re`~)9>ejbJvaTppcYvgl
zQ(S#72?hGQXVk+~e(A`4{?(P>Xd?N|i~e<)!MiE9%K4cKHR?m>etPrG#JIA;cP7Zn
zZ!y(>Y@Nlk2`Z+9+D&n%QDy;-_Tp%>s%J+iwFTGgA0QT<w^0o2>dib)|B|EJhou94
zqgZ0eV2H!Vh2Noq<D`b^fBt1mTGpDCaB(iG9&cAxU-&ggqJ&X&<xw6-AJxK>PP*e^
zLrkIGEj_l`Tki3TxJF3pLsC2yqokB`(~oHMko_^vRS%HS>{k*}K*jg3)-j$P?B7)d
zr0xq#FMXtbeo|J2mX=2PN&EoOizkI_ohojTg95D@pd<Ykkw3iq+4WA)%SobbaSyM*
zQ^v|j`#8R#%hEeSm!Xddv&SKmP#KLe<0w72_>@I9_5=vrpJwQaznvZ=I8uq7$q*?a
zLemk>Tc=CFT4(7e(xU+qg)aLQHNDdKko7)GR-ovI-fZ@<6wRO##y7~!zWO3neVl4@
z^!{P5kMY1eS}o`Bi|O!Mh18lQ>xI8tKK*kjKGHyQCT7UskO4J)@8?|;qIWo{>;`dY
z&+(~w6d$>+rHn#FWJV`RBZ$%CQYmBlFx%r&^XTCYF{98^nbEk|K1_m-T+Wh4q1A8}
z)`zJJ_j7&ZN`)t(MGy;8aY&-lm|4KXPT={35yZ=I3+b-OptzsY8^uswL>$Q#|1e6v
zO+yR9bM^)tcOt>J08BC@@=!%YoFL+Jc4usNqSm(nc?uhD9LWX$usrRqUISzR<~=;~
z7EYzRdMCLy4Pp4_?0xX8K)A^bZlZ^qNYB}?G2DqBPyv`o?rll^NJxsI;)wJ?WcHkR
zD4Cc8rI@ku_lL1*EcUy#)5QM7ZWN}g4jSS?_??ZjxLB@orkfKiN!0p%){GUn8jMwm
z5eZ+-0s%6?9uMzX9on2x@=)ssgK%}IggL%uN&>RUw>!>(Fp83@W17|kRXa!-%2|i;
zap_}-SFlZm-SRO0%A+4B>9R9xUiIh7ZfX{Dt;&{NY0TOm5u9hj|F&>drnx!)gc9_}
zzuO<x$o~;!`nHX6^>d_7+?UU|pZ(u^qGi1;Y!Z8y^}adK`Ar_y`*)U@d9-4%_KGhz
z>yKVHfolgVUZ<l1PUO}9vaQ?wMqN9c%x}`}ed-S|)m5oMA-^W+oTYfCzYd1lym`-!
zf7w0E*LP4P`6OfbnK9r4`A;JJBqDSZu~p^*cIrz$4(i{OCe&KA`wwD7FWOwR?{ULr
zCuGq>B&7nHN%F*$KU33~yeU&=pe+X)$f@R92|~8CU`=UpIAuRt;&3W{;D-FdEU@kR
zks%GVu>>u@0b*nzgxLflg*sX$!K`+xS9P8`#qu6HcYAukKeY}HlA#Xa;?YCncI2ga
z{=WsGcB5D!E?NrDmMs1O+VAeezf}~)jj3wMN;t|eQOsB&TOK-V_0otDMjWkit-784
z2AyRgA_a@toKk$oYPDc7!Qc@irPP+_%=oh*jq&EkxfrwAq}m{j1zXpRE6AAm5W()^
z6ZOfEQZ$XEF(=MGR8651W#<OayxvFV9#vY-u}~<s_+wCQQkwE+stlVt%XsKLxsG-A
z@u%JyT*)7Kg{8wkWPjwvkv~((=m!77>SXTGcbz-YeD8)^ht)u6?BzDf$in(ymM|p4
zNIWu#z!@L^@{jmX+KhcVrI2$v%!FeaB0$|fXae+1D2pzP%Z|SG$M!tmq^3*3JLTqa
zP&(yicVIi6<#VtjuQc8k0T9`3cL0dE9Yjx8&9`4x%dEE%0U9fPWdMzlKFf16MUJ;f
zA>MfFm2WqG#euP7(Uu67`HUY8QhO<DX%bP@Gd6H)>C8*xPBwo;#A5djp$$m!efEeR
z?e|EN;$=_3O5{r1<w}s^<=_m$W9Q70H!>k9>mF29?i<8Y9vw7M?ir-1ON);%!Jtkn
z{2h;GLP||+f=azJqzLSf=LAm63Q!vlu>$+!)}o{7yoiXUZa6s;FilO~E)5LY%b4-I
z0aJse&p&fq$ed#GU3@vk<higo#pJjkI>qF@&^QH{Z9AW0a$fMCVsc-&pBAR^2MHm`
z0|JDe<uiw}I_R<ov)1Xd`?B=tvPZMB>9TvW@Nkv(x|8X$`?F5zvd6Pn>9V`C#_7hl
z73py&b`_;@&7DfxBg`G>m-^~kX2$yr*=0Tw6QI)~YkuwuVsa=$L*8?sOf)QO+EkuE
zWZY+DbR5Gu&{73Zns~W4;8A3SsWL~(NtrX#L_{--v5lgdinw)fcj|RzvB|f^rDWL0
zn;%0ZT>V9wjB@0dHB!)*J}fsGdSS<asW{bGW5AyVv`~gQtt<EDHCom+n4C*MpY<3_
z=wZ%6uC2o)zrb->c|NF(HMPqjak{xa^o=#(<ps1Q{N<59KJ9ba^d@{3Yy&q~>?x$i
zLt5mScFIezcGr%$wXGrDyInf(_JrnN-t9(<`jO`+=tJB<bTO9A?xo@&3Gz(SZ7ScM
zVCbrV@%Bf%=rM^Ke-76jqK^aoxP)2$LaUa}mkiFAvd))i_LmOMm++m;@dXwK)D{Q5
z76+0R2SFAGNEQdr76(2S2kjOI=nYro4Og}eSF8<A0?RF!CvCVVZAd3=WG8J{CvEsA
zI+3pHZ!B#BTAc`nzo925iGjW--aw6X%TTq-<~>`NzpJm5gY~K#7v>r*tC}iK9Ka`9
ze|M}Px;A0+53S3r>MLbn-)gl}D^sn%XI7@wYSm!G>c*KlS4)<;IoIZ8+p40LWnT4_
z0&qaJ+L0B$7U`~)wvJ8BJh>Bith!OjI!L#wZ|=t0CcFY4vW!@T<pQQs7b*oCR;%^S
zVO!cXS134wd$mZntdOf+zgko4+9Xzx%`JaXhwNGnH1ICZUFx1R&-W8mbueX3PHWtn
zlj@ul&QI&w<X2=(FY~L9IDu!hNYAX&s$EeUoN`SquvY9sZtAH#e`E~5&%~YbQMK0_
zMB6+OhMmw)t>jqP`9-h4yla1^^n64*zj=h6+)l2X<u`4J+jWB0eKFdf={z5?u5bRr
zP8KFtYVw=(;g0BaU$pjTD$hsc>zgas$-(3b;nd1Rep8OPoxYfzC_E2++7n%GU&TF5
zzO!i#c;7Hj_t0L|fT5MKd)qjjJ+*Ao*_3osIbVDSw?=7Y9Q|jVS%!~=OS);BFMfnu
z2^)BO&uog?OTo<lSrg{X{;QAzPCkLh>P;>GpS676?7!HB27((eZOa<#6Nmp|L+AJZ
ztIG%GUHGp;5t#mIU2S<qE8_s3x<0k+{a;Y^Ji&iKw+)Sx{{_{6r9|wQ4v|<`{;Nb`
zWfQTn^6gQ^TJ9O1I-oUj0k`J(-w<1jy!5W*pttB~K5%`=Di8E~mxi%kEoS$MtN0;j
zAi)W+IH`I!(T@Ha634VT)PA>{@&{uwwHcOdB3!W0%_>$CqU*1R1VLy||7G%f-u!o$
zni$z4vIY0?n`=hptf}(CxGBaz6q8JbqPaiddiXzVAex(GFM5|K1AGa|=%Hw4cv5WS
zyd*uv>`XX`ehOUaooE(*3SQ}rZ5Gz)IoU#8CGQwG*%DIj9&Bos_6}O<UDzcAb_5o7
zZj0Y$z^wmTyn<XZUz3G;<)5-#;O)$U%dZAxCv2M1j}%n}&r0)CFXr$V3^!$krwW(R
zSCG)N!V|=0_qA8>@-<4xNB*hA?WrWGZAY}dN9bi{c>N*==ui?CQF9&h+JNrXn%2zd
z)|!6DcvkNZ^vXe=y%53p^55F)MwRyl-$sblT!?&tf!FEZw8se9D15qF*qE6UZ`B)2
z>RJ^sh*^*8f`JfS>cx#E<GtRJRM>H;m90d7-{nPm?VrVbOVvaifUs`%w(f$L8o@}O
zQIB&rs)nNUQ_FzH3B)YC3dI<T-hxs?3<F7^U!%3l4ua!`d`EZ93Oj%3a7#Z>e0?CL
zdd7--dGD`J(d~!OT@$vs5xcn&wz(j6ekOJP_w(JwJKy)+HCUT7S_mTTs9hy)NO#w)
z2stPS@J*inO4e`g8c_U|D&R(Jgq$AA)TtFjZ%<NxB|GHvLly*)5J`dphd8Uu0fDN0
z2SvLJ{*oro%$XIy_~8lp!EcYu86m*9rAw@nR_{*c{55}x8{F$ZAkaRtlevE4pm+vP
z05gwUYiFXejPJ0F|JBIcuy)W}*nSd;x_X3j%}h}P2fdALfJyCImk}fndJ{yj0-|aY
z*<I_K3Lbo>cmm}@6!S=9a!J*0{R0NUI*zui`K060&Q9<<l_5lDkEZ~3JuJ2PTl>Gy
zPx*EqgGW`KL}+$V+QJHOFj_v`35P%N#?Z{oek+eqESCjhPV~1WNFc8HyzH&<eQ-=X
z>L`mtE`O8`W)42ZF}xki&G~9G`}Gsji=(kd^%><){~G;k{j7`~0X}IVzE84Mca8^+
zlya(85fZj)Wjut+5>{axU;^0cyo38+pf)ttoExpf+fwekmg9kTy@f2`E-pg*!XPk0
z8*-b{pg{BJ0e+!+98{(Y>rM5MF{S7~o^jaN+8zJ?S%fm-mB8=C#W0%JNbmdJYiV3j
z+|37hh>ZznVimHr`F?Fy_CQsK{L6y~ACF@Wsc7(Qi~xDd3|3im&jlJ|Q-<SM))lXx
z73g!6tAwq387)SOq=JnXrJF>IG{*ooKiFs6piLg=we$9tDv0<bLdY2XSETSDCJ>US
z3WUTn10lTT4H#*o7UrBuQ;LQ31!Q?CG3#q|C%bDl)8qevZ8)g@5A4Ii>3?7g4)D%w
z6K{6Kn_l(Sh3QXD)|{qA9<mc}@ar)3{t<OpbqYq`#M+Dp;baUvKn7?8#ReVS&-q1C
z(f@LN7c$Is4ZP1V`xIYXm13sGtxyB2?rhJ0nTr<Ps@^{xQRl*n`%xkAeNfnn2Ng{d
zF)gQWlp;v|(<eEUt6WGG*3G&@c%0YPkjmZecb(g%cv5Xa40R#Wznk&^WV7zpi7q34
zvZyU?=1`T|w~E~#`HAH=X_y0WYu}m~p=J8du_0A#xHEh2{Mj!u9wUw7vBR8io6@)f
z8jg`h@YuaghHPn^hKh6cRyy*nGP+S$e&m~GbSQwUWkv^MxSD5lI8=)uHBSOxs4<NE
z`L^`7!rN49&pQ8S2c71gb)B1>T#3e>b@|WYVog)4)}O^@8m5d<sM@LS#XsxnsuFlc
z7&Yr(AKo<*75<5PG^kSA(GtaW9-jkD%zet}bi$l);-2{5_3^b|F((^$i3!QjM@GnA
zpxY@JQ2H*LX_r#!99M!oRA<7V`pRJU{=AoZo&LQq$<+M=Za91h(iea?0fk=pd%^*!
z1?ljp_uCS|%?NjE!B6|touu&_Sc7)tmk{!M-LR)>DPQDE2+F-K=&4%5SDmVpDQ-h&
z*G=FOf_XnC?wdl@DHpc^9Xz8NG>(U!8AWZ-5_HP3_&PEBrf5E~Hr<VZ?{p0>Ak*7!
zNzgN^s0|*1&Yo?zD(IPD)W$!8P7i`kQf6O1t*3qMC)>I^mOrU14XG@3sVp(}%}ekD
z8&O(5f>vu^pD6?`^r?EcQjfi#%oQD_Z5NNT2A+3KyC-QSvcK=z5L^~gDWQ9y8wiH6
z+eFYb&V8#?^~%4#+?liVyR~Rhrkp4}Z9?}@bLmtVbeeqjIQA8)Yo$Ns&u=AdSq&*o
zqP8*(pHrl<LIpJUzOg7lR!Bn@Z$a*6wKjCs#%-s+6!EIMEn~;k&7*&KdNs_?Y4gr!
z3ikds)~83AqsCRMG>E~DtF$eDJdoB*MCijt&YcatcSou6Lach^p3f=i>Qu`2n@E(4
z&h8x&l$+=DM0xfiDLKJYT#<E#p*h1GoM9Z!upgPj)Ue53{+zJE??9Y<1)Q!f)M$lQ
ztpDpEN^|qZhY}0~WCR}{SL!$-i5q_YgV-kiwdKnf#>BWU%7r2RWXQ+gcFPw*XUj|^
zD+YOQoyEm#-F}Emd!Dru9!{?anY$gF2Ezsh4zBL3m2OV6@3Wjb>YdD#!7=wXEo4@`
zqnde_-@mXC)OKgv9V|JR_WjzD=TPazGDhR#X~!Otr8%#WNqba3sH@8>OTkjYoY*$#
zjXl>Ma|h@MnyAuLke20y4^V}C5TeUGqyc|B`|cVX_KO_N!O@APDp-oVN^9ULhP0`N
zLe2b7=RyD2@Jj$GAH$=xE#~(drBztXal|UD<T$6rp`gxhs~>ClC5d!_$t!{I<XDC5
zBpNp#-ux%Dq{4on%9QF67?>xE-04sN86G&xPH!pE8mq*eJys}>UxgLVK6Qht;jaN1
zGTh3O#ze%I{uI`gt-|tW<#&MQrb-7udeez>RaX8v#)HgUM=|9+`E`-s1dX0S0&@IL
zLW>5Y1ml2(RO-z8Y7TXN3?1WadxF+}?=9w|_ejP8_5=_&0(5g(aP%qztpS@Asp0;9
z<@K*iRxZBy$JCbiwt-PBmb8{^O!Iv~&cHP5A?Z;a$$l;;p8M3aib48O9a%bdC*=Fz
zX(L1CqdGtl^L^z@TCSA1n$#8|9k%^`8%7_whO$o8jE51p(#d#Wf-B{WhYGmT%6PDb
zE45zVER;1*tX3?oAwDbGjlv}FdiBdHy`dBSMeS{mi(pP8hb?9oxl??Bl1j|ix{>yT
zloaEk5s~hMl-^j4%db>Ag5JMDv}|&H#}Y!=wEFu=tK_(KKdYMF9nd$KX@}IWRxRc9
zXd?1tMDnccqpjqjtyBlw+=f&=iN4eRsk!L-ZVA6plD|UNP$;AxC0Iey5F*w^zM|5E
zI`=&0;x?MnrY*Zp#ui&aYC7CSG~de6*G6=X&atS6*$CoTJoT>I8n8zzKPZgXO+N3d
zfuAnLGq}Q%`LFs;xMyiI@>PzXRQ$;quanU1O;titw(P0tz5{1m+Q6WJ89A*_ng>lz
zTA1tyE}VG1QGiTjnuq@`hm)vBc-rIUp3mx_`s(okP{@>G6R2%Uu?r+MrPu~qn^Nop
z<xDBIaDRLJCT02U6HRK)@W>y_*k+m3kgz||11`7c75~Kb8C%PykSs8qt2K!1<G5L~
zDDGK_f%hDxG&PX|wIs1ZNJbez@VkKA&J^Ugt}q)xAdPKzX4rN^;qNeIcjm;~ku72E
ziyP!s*6sKg0QomGZH3;Vtsi-nwk;=;3@ykl$RT;7i-Y;^Ck_X+|Lr25c*KuAN-K*i
zYtP2BW>)1|5-bC`fU?2z`%^-5gEaSP1;zF+!Sv=kiFnx!R3=2R>($u}J#BAI2|~+5
z&?ReADcnS!oYU<ayEB~5$4H3WQ2N%wrqaK&k%VR#lCvoLT3uQwnVP>XkPfaV^B$F=
zNV6fTItfs)zDJnR5-ApX!JnC?DfW>=oN;noS(*cUb5qOZ-ccs1NVa#SENW=9cXca8
z0Vdnu_$PRj7Gm#iUB4q9EjSXAQNrQQq0H>u9J;?V(T#>ksd?gFVi%bAN@wwg;Rp&x
zMVmAbTXtEnGMICtN6&D{@)jrzeF0{~O-1w4opGg0iWtn&VHbb~iGZXDwb5pYIK(z$
z{Ty03-rZlQ!-%R-CFgdgjEX`Xb_h%t4uJZme4G6)!{ht?;9=WAkoE7ia8h-qmHqyo
z!{b~1NyE0IAdz9)9?<%*?J%e?l&fV*Zs~_D4O7+#$fPL4p&+bo0$mMl8K6N7TUv#c
z9urv7uC#Xj`?Pf&g2&c{mxBSdAf~)>S7rIyVEP^N%bAF~Bc;d^dNyDJs?MTv-PQ@^
zOF$IOV#|C!->34f=SjX8uDteUHm1-hvb2LQ4uS@CIbhVEQeg+>+pb~PfnnF)VOQv|
zp7;&NGV;g@@yH6=$jXNiFM;GHq~u#p=CdM=bqQuW#L9mS!t?wT1m5YW7$SRrHfLPn
zOU|IXgs?YIi7gO0r%?)%HTY+a9zunP4U*@|+X|8P&l>*@Lr4g1g0TJd@SG8@w{wwl
zQ{Ivx*bq7+{6-~17{d@mNUy1#7lENz1oZ3X^{*9?xTRRGx=c1hbatu>`gQ3+kZ}?>
zU3c!oS9DN!HA&DKHwwfW^X6SE!LrIu?H8Dq1siB=JJ&j|J*Yb5W-7IP+PoZPQ6237
zfgMbg)(W3BPL}`)mQFO(-|-XnLw?lS`V=gkvR$x1=^JZW<kWZeqwnlP-<e_G8D-a*
zc;6Xf-<fZp9s9N$#kL#Uwi`|Yq4XsRrH31}2d&Jy7|j_g&6y(288*$CE6o`%&6yg_
z83E0i8O<3TjU7V50>#kZu-&!r-8KK+e^Qs#sAUV*yZ`0}A>!0$Kv0`6iN`a~C5pxF
zT4B6fJ#d|c#G}b-cda<y4FX&zBk^#9lcIRO@6<J4sn2XdZQ>*z4xlzK?&Z@t3y4yI
z%^%>(Gl>n3MT2nZ)J+_4rI*Ae7Ea2iZc>{>M93S88fL9eHjh}74vm@4;*R|mDMRE!
z4Wv^b%u6xk<%?64vqe1u$JI%(7zgiMov%fE1kjIJrCo6cPru}>Ihwf9)Cs*=BEvq$
zmUP{Ki<Ikzxa$VcHH-@KX2}O*$p?4I2WiQNY{>^}iAB;?U&>Wq+%@bogpC@)MhRh~
zg0OvtOi)86C?OM6kcrO_C2EKgB}9n|qU1kI&+VEsyXf=H_|_7%W)3HFi$03Rw;rH1
zLT*=mxJTCb))cfxNdl>{IPNH~)h@1mOz%JaO9HWj^Rn8<<o@c(MY8hR$Hx9sAri=$
z)p18jt&qI2TXX;EJJ4D@31p81QUGw>SXd-GsTW$dyNbyIK$sGa$!kVWEhsCRk2}~*
zex|J91XrRQSATUSQ<~IJm?YAlOm$C9$uI6nJ!whFi#)9jBce8m{Oem8S62Oq6C#gv
zTQT`8y=mUIF$q6f$L!Uetb}CU;UxwOQ)!6bZ$NDeW%rw!=wX)jsTJ5M@en_#1$#FJ
zciKLPn2p9E=w3qxH&8RE+xyMPQt&(C-hv?kZc2+@5&VRnMC*&8iOr!2>XsmPZh;CB
z)Fu5sMHn==;d^k_Np(a`x3T^^kMxyjKL!&l`zGu)ALP>x*EL%DorTTQjN#KB`sPRA
zV0tygE@TwJ?eEl@o1U=mq}5A%&f*!<0zlc}ufJX=A?J+3435OS<IHtI9Ju=##rZYy
z;Kh9G`Rm4W-|%TYBP8dG3E9H)ghcjf>#NitSJyMp`IYG|?U<TpN&2AgFHOkwf1=<0
z-<2Y-l|FW|m`36sV<ZLoB^}z3&P8HK<yqvb!XV0LU#`ekvXn?<&BK2NS4s!H`#Iyi
zMMkWZAD!$uQWYLJ1(|ZD(sq4;=5bWOl0>~|MQUiYA}tQ5V8|}V1L`Ro?OkHG2f{No
zKTfVnvqNoN35q$Avz9%tSP3c|pzvuic$wKNikZ_+puvteGyUOzrc1-wBcT1^Y{E>6
z$@}H|?l-Sb26=Hyagi*kky3hSDHf^BH&G4EoOD=BW+Z$YQ6ax}%{(LG8Z!=yB=-Fu
zt6;vwcbZ$qbv*+{Ej|AyO5!_yMFui|n#i}$s(jw1tFCLa5!RJ4*@VQIw@#~}6C+#t
z<v09%*R6Gq3f4mc>tWrhUBP@9wXK^uG?%P{a7G0wow}jC&b8}y1yNn=pG~-$JIT)M
zg4v+O?})n#f_{f7=wUZnc&r~Ec+^uoYtq;5{x-T^b6n|7NYvh>&Gmr3Z3q$P!|-U#
z@Mn=|w8#DPbI?g_4_o!Vq^5)D*hV57<JN8a`6PQb%eRG5$LCPU`%p*~`5!5f+{o**
z7^jXPV58c|>*6=`qli`Q@YeDBx}^Wd+B*kV7B%srv2ELSCbn%(Y}>YNOl;fMiJeI%
zwmoqsdFT7?tylL}y+3Z<dR5)4@$0?U`Qz-`=d50<8-Grbbl!DjgYxK&#20&N2T^7h
z-FmVFxiat8IkC;m_Ewu-Up2<?4EXB5Qr71a=|=nYDF@)%v*do?fDd?<04Ng?))HKY
z0-i%F;9GBbE$j!9u)BAkz(w1`Utab;p!ffYp{mZ5ywtoPL%tGVJ&<`lF#A2gbPAj(
zC71?eBvwy4ugssR2$f(L_=&lc*hn8yVx~s_Nrc;&Q#fHI?aG}w6g>%U?IW43KB#W4
zhUDz1_6ga$fSsC1HQU5o+C<u9u`*^r4GnHtt-PjBfQxRghSLcu(OnH=7*(lDO3ECr
z{BT;qa9rWAUr`VI4^1oDq(B%^nsh<-*CM3@npMMlx6;$8%%rq5-AVa^YyZ*E6Pmrb
zAQ(!XrdCS^)XL5XG}af?N@vE9b&s$>$>VE5pgzFie1Ig_4{J?Tr$Qz`v(UpovuWC|
zPiVIp!JC>7>zYd#9h#UAj*nHt;$zbz;A7W7+3D9V8_k>OG+H*%ycUV*IqCp8AFK62
zGrlmrV_1aVaTP(=n?6(uK8+9-sIXgY)ai=kI;<k;y3)r=5o>r5-UiL`{sh#cT#Cd!
zAxJw3I0|Y%^}ZRc#-~r%^}YkMu%XY4$E4RzysGLB6?Z>^Rv0PmIFT$P;l*f^4sNmz
zX0A}?Ticec`EwHZe`80~(3>H1?>>cHonz(0>Ohzv6#<WpzecdcLb1~0WBJs8ZrKgS
z|D+4CBl6eXKuks7vY{|zzH`R$UkClcBlu%1uw~R6$6b*EB`>RIl(P5Gv|!iO#h2E>
zN6RkrV}ynWr4wJul=Ne8K}z-u{=bRG|Ln?L#f;!bW5>4eJ1QDFwz(=~ft52_hZvJ1
ziGi6yVxpO%vx$aUFltMV#HUj&D30ugFihJ6TO>IkivMF9kH^4R&)BZ}%h$fGSmT_>
z^Jca;6MNIp?mOqvVou=nW6tGt#y{Wpk5sx-k7wLZhF(__Z_MYgIf3h)k*@6tXm7gd
zYmQ~cm?Mq5kkI=8Vn6{q6Er09ku?wG*sfNgK0n*|b#nNdgdJ{&R3qh<U=HKy^PR{R
z(Kyq|vocrYrr1=cK-SM;`vMJTUzFVO>tH+H4!I2k2V^7q&h3Ku6AvK|+K!Lr{4FMt
zY06<ebCM@a&Fth4*vlW}FW75Ml0+o6$&yT%Yfj|I7;7x#$Y^WI<R8O$c1J_QcxFeW
z2c+akm}?;9$mp7Z<jB~XLgd7Zwf&Mrq_t?|i8D24o{R>Gpx(Stm(Xx)O*mI7tnF%E
zT6k?LCh`=_HuK{5Kawm9PXw1RvO?Lo&n548{}5mIq*JI<(X%qQ^qfd0I&Gho#^`o5
z(o8UV`uF-$nbWHtImC2kHLi<tu;Cr)9Qt8Q2}5P$gFjs5h1}-@#<W|#dOe)|C~%8x
zyPP!)c)Hn$V5Uxa#!q!0aDNM)T6{1-^C-RX6CHgzGr>^@=?4k&rOrDC_uL;T`tmM%
zkqtG3b#DUFZ#`#cZzp{gF$t+x8epSG-?z|hK66Ba*#zS>YZ+bnx?p4)!Tm%fw6QIU
z|0Dz`L3BwM;UPchhhI=6#iD8;73H85^6EhEA91*$CkHsK(ojRu9D5Ur%D}`H*h_c?
za1BS3Fe}3-LA|+#-(e)lp%{muC>AsE4X^~#^n`Ans)RCHc)EP(Uo}hAMr^`wKshiQ
zdAj-v>djw!uXwxapmxj~w`~dLZjW5^Tp2hNjB&Yq$hSvtwru!s35E&`UN3K0I24Sx
zJAJ5Y&R^?XkvhzqA-noQ+3r2NwWn_`uX8ylnZtJpgbPevPexfaH)7@D{UYPHII0@v
z{S8<SYg+&;hqny^*uyw?0qo(N^MIBx&fkCvxEgmcUIlGS{5Ln_eDfn9ya{LtcL%n4
z!dL_Lagx)n!1GRMw7`9{GoIym;2FlZJ?a|HaX9iG?%4r6hI5Vq;KMjK0Px|QlYrPT
z_n72)%r$XxW~?;`@&fAG)HuHYb@j9siGIVII**_GKc(~-FJqLLKy-q;ZbiGkc^vTM
zOzbl599ZBp!*V4d0q`p9nH<dGv#}<2#=5*ra6h+%nbumn2l4u0uum3;%S6B#ek0xy
zH*~XRWJi#YqQZ#OEX12_;;*o!SDWL7WLR4j8b+5Fn&;$Hn&;>O`Odhtyo^6Nl}3pQ
z?Koh#;R#+&M+4nsZs|%=j^jeoHcIpN*|m}C{m<w%2fd69`&nr(T)=VlW=3eQw)^H7
z3G<NCmDGMG1<VAT0^ecvxfbrbMnpimg<jbPla^g7=%$%!6Jn>5l@-YrBAh2U@Y}>q
z*Ip-&kK(SuCx6Mge3Z!YGkLZZ?x-y094=`<S)Liv8<%aCx_m&mJZI4y@8uZIlYfvf
z(Xu2eH=dEGPIJ?->lQ6#>7Wd1f|=b3Bdxe%T3C~wATzWVY+LW>E3@e1V(=d)@h9<C
z!;FU^B3u2IA*c&xx8+d)<+B|BI1}cM>@xFxV~b{RFB)f0%1OG2gnqszsMfikVcDUF
z2y{?nL*2o-vtda;9lQ7A!nFoTgJxv|ly|)B4kt;2gz`4bN*ie9<&tn6mwA_NiEf=T
z<PRT8G&l|ARP>a|#`2WcJ1Lus?yDSK#0MY9OWq`I8tvbq`k{?>A?{)zm*X7Twr;g+
zR_fee4Nbbagf*Nbfn~zmFb`CaHjDs>5Eq!0hGE$rnb6KIQ<6``{v38BTS#X)s;KG3
zSp{Wk%qR$e`<ZXxgTE_ElDjo%mjv`t##Ch`)erU2;8i{Ly8Z|#2T<?a=58bk8k>#~
z{lt?JvoEgJ7K3@`%O_1piv(~rltP{F?)(rZ@HL0ckjjRtcvE1z#nEW*ttVHos18ff
zG#Ic#rgD;cXz$37SKA~{ve6redk?!-K9eik{cUr+>x9O|8whV~8?2<0pD^yBR4pQ@
z*1mPDM>YsucrCEMvpkjJ%k`G$_)evEh<t|Y8X6R6mSo8Co&I?V`-pL!<0X00FX0PQ
zVV?JhtdXVTsK}6=>q_{9lK#X`>4!cNsN4wUxRn@m&vDDA>RL?NvXXXKNxNAUep2V@
z#oQma3&R&#qYZN>;ie7C72b&qKqeV@30H6);3E1KvKx4@bR2jI^%LIr0yzpj`x18f
zCP8ddw`bhi8SX!Mw&?BB@yeC&Y=>!>13Vd@5rK8#+GC`|M^28%hQCPx3l#hVn;o5B
z=HD9aKX`WKKo*)tI`trzbNRr<izz5CdZh)5(xO*bycpt&qE}YUiR)_)Tp`)idoB;5
z4q{_u7hihcuua6XY7y;Ngq*tJ9MdDIF!%E0jxvSP#Bznw&2abbWMa8oMPj8~#R6#{
z%L5s04S`%JpDSOGyw+OM0b@;_Tqu{TN|3sjNYX(zSG@ojYlyPuMLv+Fb$>42`vrA`
zh2X3N*EGr-AhUWeS@Nu!6}KBwD>WM`{b<fms^vyFP<+{W-L|pf-cogGvD`ab?w#w-
zDky%OIfGNA`$Cr)!&>!BhfRFYa&zzHrYdlwZSpxZDNb-Sl3ifcI{32&J1db5%X5Ql
zTL>}xpDQ1m4OExL>NPzHvC6+kI)FXk1?Aua&t$vk?PlRq7hwQvq(P!(<IfznDO4_p
z6Q`{;3WLGv(wtrl$v=>Tk_{9+VFxV~&mcc}5kJDCLzsKzkXJtW9mVusX!!?^h{+ED
z0JU;z>IpH*1%A#9kP?4-;->T<O#Y;b?vY26v0?$c4{Xl2YZv<JuxOzKSfHCfR?T2*
zb-YWW-jaP16*p&E;V^79k+CUIoJ4oYjjd>y%*>K$(x)Udsce#OCev&rG#We>lj-6Y
ztxG~>K1GcS3le6<jZKY9vOl2Guf9b|(8o9-V#zTqmGLjZqu(P?n&_&C%e#&(b(yTH
zJ3r#6;7^y8u9$Lo8b4Ln_JTI6m>(-7&70IBmuL@2^sMz*H70G|F3i1f?fB_=>B%ST
zpzc@z(;Fw3i6jML_>rmcLdI6R%WpnPr{*1#(+;Vb+q|y|gf#s;wi=6dZtjNs1v+kW
z3vUid%rri?!G0=>AMAi#l2)>iXKaS<7mdZXU!{G-DX$=<;<Mz^j}0)aWiq84(e1wl
zB36jRY!YeP1<Kc-t#X*l`t~*zxgCCNcXDjQ{Gpef_>POY?6|hWeA?GkX=sm0cTkl&
zI=+g!0^O)3O96X}i2+2C7)tzNy8nbBe`tyUc%UaIjzsx^J#emEN#qn1pIEZC3wv$G
zomjpi3jIlZJx<P(_8xt?^*ARNT!SR`M{0)DB9fv1#_FFPSlC}*-0$#a`8Tma#(vcQ
zOQwyT_Z{r$7GrfFbSru%k?i&xCgoM*Ptr#jk;}jgkxO8Kb$X>A>;v-Dg%*it704I*
z5x!MFclI~lwO<MRG5${+Uj^eU&hRF!$AFf@)qtX^=MJ`_<C4cdl3mS(e$cmskY`4K
zC#o)S$TRcIx@UF;({6YLQ{rOP^kp4T5B(%(`fIh1-04(67ei>V-@jJu#2fsHZi7`)
zzT6eY$5TyXu$rT&*dw9Rh)*mbd^4U-+1d<$!!Z{i?E&uju<mnnbTF&G-)D7o1bYif
zev9oh5B)~;=S+@^q1oApRMHXG6Uj)fb2)VOR56b6RB?#p#?3O*nR@EP$uiJ`$1{)Z
zX8j87#?6$zb2)wX07;Bq-m4_8q<+7tZ<&!l!t?45XU93ra&9UAU$~atQRN*!xhL}c
zQGUps{7y7%!z4f;?Dqr!8m6Hm8F|!6=cP~?=3!pCjacP6I#`fqJOk#Iw#0M6>4qTA
z{XTOhP%JO>X@GQ&lw^0}>7Vt#qRwBID<LBzx?T}BMT;vTt~dZ>r+pAzuTDDq)2PDM
zP+R3~#pHSiN{TpP^RM4X1gr`+403L=d+MYymfWwfm6!j}=Q5wo6rXR&?#Pm8FAz^*
zl899ue+YrUp)S!;>N1U&XvNK9?>tfw^$nBpp&d<B@+5I2iW>NbKzaIHj(hmn78iW}
z4ybpyK9yNLF+>&pw6@^ZDyrBa5mJl#2>R4FUjTpO9%YSk!YJA7$CEP5k4Fow7%eTP
z0BN@}gyzb*Yd{Bkmf&hcOA6E)d=L4IgfkaPG9+Uu2zshuB2fPk`EEy&JCv__Q49KN
z7Ic@R;3gOT(wqzpSJT!89j+pEYFM;5Wah?lVksSGkMfHnM@)3Kh~zsuM@-r^E8tRj
z9|`)6bB9>=B@s!KQ#G=ByCz{LYR^ANi*W2OJ}kL%|4TdiTAUjFE`jRn;y7NlYWup<
z=&C18&v0*d|77jj3+gpY(rz_MBE%ar=7FhjK%{;IYNjdbFpd7J|N2GDElrY8r6>>5
zk)S$};uKiA)JM|AiljG3DKGsooAhzv!(u5vRg`L1f~>c$`uGJ&9H$CyP3WCH^p|lp
zvY-XlhrLNsjM;<{Lqabd)N#^9v56CZsSD~kjHnM-`i56)_~vJ{y7A%N$&dZEtoI+R
z_KpO^Yf~~wQ)2k!lahCVIjPS=IVImxBet75ByEON;y$4YVe0)MUTmcdkoOqUtQ>&|
z*#%)9<!4y=#pJvjt!HNF<C7vdYCi+tEq`Oax6rRL^2MY!$zqPuCN*P@RwcQh95g{V
z>jpVU>Oz#`8!fvBs0~3YsIOGENVsfq2hTl!pGUS;Sv^Au5UOrtF5o87DGOVQ(nSbM
zX}EoH|M&1`De!Nm!fz~1?AeWrs}+e>cNi__lJQs@jq5NHR>){pQgJjBI97VH-~6c=
z4xC|GroSq%G|JqTmVRp)oEmqm-uGR+Mzqas@LBGT-~P^gZfM!+ah>m2d+&G5Z&By|
zXuH=vS&3qiT+=zhXx?F?PL;{viMDH;iJoP21*2`8A!wdtn@F9_;7M3%p0QK4$~K)e
zn<fw=V|3-%Fv%_fXigKzwCh-4Z8&6;1CXW(6g_k;s5Z>AaZ3Sg%aab%1d`9%7I+)B
z*<zD|(*&Z=dKPp%M%kg0BGUxoNIDj9Ja*ZWM^WZT6jF??AUqb?|8A=to-HLaIz&Cn
z>QRu5#$hm#&BmQDsoBZZ#%N~%%J(D|r8QnG>=9Kz(s8Znh=${e=!mA`Na++!C97j1
zSxp;bma|!<$8cw)Rh+5VQ#APVaKSbBLvX>>^Ty)7=!hoc0_cdw;`-@`X5$3uh(_Wl
zFcZxsi(^`{7xl&tvlivX4zm~4#&~9=mG2=e{wm*#Tezv+Q&_lZ+?!drsoY~&jMjMB
z6wRX(-W|8L&sg&;@&ps~8|jQa?6-jr#T<`Rr*;pKd`)LMe%IIreEoUIhYNv3MKF0~
z<M)-2FO)ZmMHZ~YMR+yw=K*D^PI@qZ_aXD=6X=KA&^$(T%C+{BaytcqSnjISZFlkO
zv5P7Y&Z&=rsfpzHnQ){ZF{&Svryr81AD5>emZu+;ryrD;mzb9qnU@!vmlv9cKt}zT
zl-iP<+9f@qb3{Fz7af)h+L2SVXifDvP<Eh$hv?F_HovA@P|+q>*%pwn_THs?d1_r(
z(9jkTy!IZhdx>pbXIR@75WV(ZrrVQg&1g{H<{}Y()zCfUPKmu*IEo<GTU}&+;yal*
z^WDyyG5^PxE==nJem_-Td~ni={|$r1C?0t|NK2{cRPpyJs7(5*aC#v+#z`geg9Zo%
z+NwPoBmvq!ru31k^wA?}v>#Wr-<`RaN3cSnzG1)u>4JX|1Rlhl=A)dJJy_lT!PlH1
z%&(IJP!QtKJ)Y98HN{85^b=j~S<B8!Q0mRYN%tV<P<hu-dD}kO|I*Cx`v`+3hGlX$
zShE%0?htiqC2r2BcjucAlg);V-5%MJq6s;68>lXWD7`RGFAC}!>ai2i&kt|6Ygd}M
z7PAubU!a!(NSF@{x-ZsgleB4*GHH{rX_L-rldNfzDru9bX_LljlcZ^rB59MLX_EnI
zlY*@`eU<3~R@*&`-LVVZo<;7r;+H$YYkh=uzW8+3^tvxttv8|%E#?kX1KKB4!u`>2
zj@8|c7GEcHOe-_~u@*OaoSY8JGyXjmH+&qfyH(jAOtV|DK&>wOgGgc3m(z8(g4S=K
z{0=;47}*9+sFe1zvHXraXE+gPl+%88mfxZ03@ZVRGTP5pi<@~Hn?ObO7xtN5`7ujQ
z>>m}l{~mJ|3x03yhdX5u65c_W2$%~r{Sr26nFnwEyB5;G<fH;Ey^bpLN=9>DoT+d2
z<+*BT;Fj(d4NshR6-I3cmam^I+fA1K_v6yMtae&fC$r30Uo*m4N4CzP3X#0uwaJ(t
zr<l_bF~~DJ)~9`~-brP5?a#D62gsc>%onEgqXzR^_}i|Qb^nEWsf$vS;o&f{)ZzWv
zrPJT)Onsv-<kiI*2Z^0MGB`z#p;Sjv-rwdD_0w>lUp@*NM>*91PMu`iYO>#E5_lQ?
zWIto+ACxOU+(5m4cUqZg9r0qvU&r*0NuY!5A`X2cF8OWBd9Zy?(9L#ib9~Q9sQuU=
zRO$!Eah&3CoN9Hb{4f2`(SJwB`Xi=e)w0lDACkMfSKO69s=x&1f%d&u3@I!pY;{{4
z9>82c(@%b$@y6JF%59ZnSYj9u9^eiC??LYGH1h(pkkkOiS!O|zVL(j48|?e>#91aW
z(1;3n1JynLI19ZUs@qxSzw)1T6kOmx5t}s?T;e}51&T%f6E&b%=9jc0dh9x3H3W*X
z6V?un#5dW;tOicQH_69D$Lw!4%)koo@t23_g9825FtnFZv~PGHUp<fS_Ny=C;Nc+T
zhJGu<1oW-coN0ayZQY-1J&?A*_73Rq{>R!0k+GV`!}J0;M7Ttkw9t$JIC}b&OC!~<
z+S?p!#oU(*zbJjC4@c$0H~$Sv*!Jvpba{>5yd>)L!x{OIW)(E<4oEgu-e<hQXFFsI
zjYJBuAM&Mx!hB}L1iGJp;$z$Iar+!Pes21MeI=^zn0oHjKJssI;)u^d+08-O19QT!
zQ?E%KDl!+Ko%S@2k%K?KMzHmp9$%TU6G!UM_t#nx1}plb8j*yxbfKvP>k!ckB*84L
z8M9tnEnH)Dg$;DUsemnaapZ5Ip_V^_hFW=9vLr!5tvQWY>fjK{HG+m#;1SBxgNOba
z7_lHiL#Y9sRPuhhuvYT7!O=?e!=n`tRDzsF2g@v3uYVnYw*>>DL|KZ{L!%W$K$8K%
z*9SYOKlTk1)LO@LP%V*f&zeVzptTn$Aw36|d$vK9Mz%ne5P{eMl9%ox;oV;%EvMEL
zzP+mRm_$`AKaMR-;=bRQ#C2COi9SE?7wPI>tu(a!T65?H@%Cd9H9g0qZe4*4l*CTZ
z{B`?q$+|Z|6`a|NKgZhigO{X%v-|-%-1VDOcL|~Wj(_jfbnCZ*&ry<|0u!8amnCk5
zf0ligTCPFf=5GeSleh<ie83U*@C!!*C99!AR6!Ptz}8`2>Lw%*;DXjpiv{4ax%P^|
z3ok+|Kar{<5{iCkMKeuhCpx9mlu%5qs}_leshq~3dN4$@#KbCc4M*s^wWA7-N)V7-
z#lqkhY352DrKrbp#Wq=~EzK7z47ysGzP7VIo>ob67!y}E((+XdTg-G89-NFRii67X
zZxs{o6o;#YY3e>OngeO>r|gr1!zq93YhSPJ8T$}sr@0(c_XbbLL2*z1<B0xW5aEBQ
z%9jyX{-eO1R^J_P@8l_(uM>$b$skhDdy8D!zb5Rd%k7)!5{DuayA<U&*}m;Dg>FuE
z6Jmee;e+3EXQc+lWdyd)2<e{e*0}Y+PR>-89^n0D0<I?J#ESPovFcN7a9Yhv5QC)0
z74rTl<dwDXSQ#9nlN^^#YeF+O#4ii2aR}&-Z(b15(T<{dd?B9_1-_Fzgp1`#G#+Em
zHyS7eOuNn;N3H;4Aov#4Oi*Am7-1V5!MM!E5&D!{Kcd+bht`CI*C)$D?8WM@MHOjb
zc@knpxQ@J-pf;0woRZ;^ph=JF$3inbQjuf1zw~|8VmA3G(hfTIxVAfSY(mfGB=EL;
zS$2A$mpD1e7*gb0&y3jCibMCTlgsyB6(WlGP%JM&R(t{%e1zD>iv1_mW1mT*u@uN;
zuoNi#8UEzTw^%Ww*)RSAyg|GkLs*Q`{CY8y<imV1k<`O{v5>^aq-HB=i%HG8Z;bh1
zDM^p{U@Hla`Ct|6GhF_<3W9@XDT$7OW-DomNzGoA2L77*u8DzWJtW0MwvZIVtk48F
zw4&6Db>cvc$&Q&ILgGt5rnsGaD-g=LV)Dnuy8YmRP%0N=X3vil%ON#{wTdX!8Yk|D
zJ;EA*r8p8bC7+(Ew}|j)<K3bSjotUqV(-FP>|%fz=>mWeh@novbY4qGo0g`DW(=p6
zy%tdFytvaEsGu#VlVhGrWk6(%jnUw*OEXDs<`IvL;ecdB3`&mJPskdXQZ}-}t>Zx2
z#nrB_e}ijRgU3;%LOuM8&QrNn+9*oNLjW0fVx5cN&WOF|>a}BX0oh>*<DL`ADCrva
zvPL^JZ-V;Pfc~Yt6g=U|x(Efyqtq;-uxG*+BrBziu2Q2$s^WE$AEMNjdavVw=EpAM
zyOmoju%@s`G_eKAoeqBkRVH6_6yhrz4auE9j{k#+JwLW8h#x%pFeG=*CE`GyBMSF!
zAHkkx&dm8(oqsxAoe6t+kDKkD+k%e~R<;?UZS9D*|7eovm<RTT<@@0?+hA$tvD0gK
zjs-A=&?Dp8nFY%dNj}qsH1mdL0nixEr&gI$YkWdZx@q}Z`kZ8h^(Mk@u?IYM0a{3z
z_sC$9q)3j!*YnE;>7BkQ*Ney2izV)6$?7Cxb@GZ1C>faK$K-w*Fs6Pxs}5i^#BX$Q
zRa`*$snijEx{BU&hxjra!hdpo9qZ3PuIs?~hO3=x=$dO)$JD2#=V6B&&85q`)8VFr
zjytcBiVR9(#MxZ)&z;iu&m)Ix5-ZmpnFJ%+V`9T!FP*qH!LTHV$0?aucTC-PL&EDv
z9lEn8{8nHwfOqP37`^WX9l!J;Xt;Fh6%0LeXH3vaIDE1uXs~tatsh_GhaC7!<1)~)
zJ#>%fGALLZr~f^EscYXWSQ7u+{g2nrhWOuzH(uM7@xQ_BdmWa>FD<Yvt2>qP8}wT5
zyEPJi+v_t#n8Xj8*hk)XkKm6SMDezbw1wpBGX#g0-0v}+-8t~^d&mV>*(T$WNvNtz
z#Gp&0pv%e4Mk@=7=hL5zG^hB{fGutKt<R3R<RbfaYJ&nMNFMr<4g~!|qH4-rwoXqv
z3u4oqTo``wgHR*;OiE&DN#yf;oz8LwxJSim++}XOW=1BvI!c6%?Xey6GO5**Ztskm
zPvH-C)pSaE6TZ+i>=PYpY?bteupgUK9Aa*j=#L9b$#qI~h54q%0z*)#=OBS_kZ;=K
z58q!C0#iI&C3#~4Q@C3t{E@zCmd=STcrP>+PKhpPFErFZLGVH|Azdz!c))fHvnNn|
zt(egKqx!(~57BXFyA)5+wThyRZ<-p=<hW7!g8om2GEL{ddsC6RWM&Y;@@M0zGJ*#s
zX+>zc$tw3sVS&Zz3Jd4a5J}$Q7Hu8H8z6l-w4rE|l_AuX)&02aD%X2LLYAbGc4}_(
zw)1C>umcW0Y=u%rW;)n+J)iSZ<1T8086WaGAgW?4AYSc7n0|ZplVn<dCXl4#4bTJ1
z@CK*>lz0QofHAy45`Y9AGs+P$ULXx1950Xp0ErjK08oy{hGP>yRD$3!JX8WcmWT5Y
zxV87EA?jA2;UuRvpJgPcR-fr4p&VbjNiCdTl1c2GUz$n5c!AUaT)aSL07!gb)|CWX
zwRbDQU83r0nFVrZH{P96UuVm@?H$=`9EbSTX|cBRj2wwH2StdbGg*}g1L^8|#(C{e
zhBY<;_C&0`)V4?dZ$oeaM}40Gp9U^1kO;%(i$AnPpCx^n@{BKNtW`u6=d@yEZ#!{O
zku$s?xe}@Zi$YLFP3lU|FCd=`t7?N!ct`JY!mhMS@Y#%uaT#H8rSp|cM(SFp>^3ks
zoE#)2-8_Iw&;Zy0*HjrzHRN8XMK1TrENm3~-)T5R8)#L(o}(GlZF-fiw5q5;njp|V
zuG45NtGco&-S{mT&miVh&z`p4QWcNpf{C^^lrFnk5(P){``p+(pBLJ<HWctXTVfOT
z<`jLvJv|ouZtN=5I$PoukLQ5JKKS&`+-~g3=Upt(^M~@|-Kadd7Ie0BlnM^#i2r)u
z)Rr(iSu*C&=I@>p+|ay}d9E#FcDCfq9naCdvw3PRX?3=Q^iSm<yAgS2fbN=y=$C~z
z=_k>18ju2{<F(*i!pCbMaEtD3fUOLAC6kQt=%?cb^epskvz_zJ$AuW!>pNyThu97!
zr{i)N*d5wuI>*=!HK*e?fd&v6VLMbronQ0HG@sedV13aZ-?GJZEij+?m%)mxJ^s0j
zlUjyj+Ke@x#nAQx3v^aNyi5|Uw!EA_1uq+I@>+6Ryp$g;HhlaVxe2w3D)^)xa<++M
z7lC0UE4U1rE8KD~Jh>k`B^WzJW*0t~9cpd02s`EJES&e1^0WQ}CDFUKyq*8Vdk<z^
z2=~3Hzlu0Xrdxf!kXSoHJ#`WJilquKXww~7(Rfdi(ShPf5>0-EL|}_bJ3w~%_+B|m
zUG3j-mHP7Mv7Rg^Va5ParX%EKE0PPAE#XnM#e6M`XHzYU7zhl`9`XgppsCMul1%Lm
zMbkS=^eQFz1A7i7YX;@2e1V^BmBrf;Vbw422jH2~h^}H+2Mc5$Ld*O!nmJz4dLu#~
zCl3M&Fb{^l_!cnT$!sad(^`L6%j+|%xrg)kytXpVytX24=kar+xrCxqXAh3P(3X<3
z)jUF(`BR3(ok<<0zU&rqtCW@zYgS91zf5z*ZZwt~f3fED3-{qviz%}hrJKf8M8d{-
zLh{P*_e1`!zQTySTjkLMs_;%>U1G+i;9Q!=rC^uz4oe`<%kEi2@=95;ODo3hA$U{{
z+e0v{^O&XO4?RNuE_C*hY;!)3#^PbYEGZnCLY`OOJBQ>IIzx*j{O&A?;#NJQkS-d}
z7oq<t+J$MOgGr^Uu@)trP)Ub^DN)=iFAj}OO=dkD8w1Miqbg9aX3sZmd7R9lJPBW!
zlJ^+}xEB{mr>RCUFEerC=*zKusSjg>E6cf-E00xoeXjufVNi`N!p2=>rYJl)>SC+R
zAfSx9ErPLq$J;aP*b`%(W6gbEAF&OoQ|OG0>e%2cpC-wsy@nDbq1p$bw-u+Crw!1V
zry-;~;N5TjMfE^Ybs~Dih_eAt=KGOsc@Eg2dN8XphyduZK43)guO`~5uT)VrC#p9H
zAKBw<U>iDFokf$r=A4#L&w(o;NGhopQqPTX3qcF8!Wewp{T<agi)LR$2VX?DETo1i
zq&_%{{yK{eIE!9hL_a=@X8S8n>r)INpb{5Jvw&U!8o$h-1T&33mO(Acpp>Tji>8HN
z#lic)Z5sU_gVNs)e$)<r*1?BS+ze_c-CsYJA4YXDsOQ@GSpg5DJmcu6y1yzL`B~Q=
zM!kV<VCd+>sB+_Aco8+z!mmz}#cDi$6_V;0afxgiLWbgz7<8UJ*jJ~%obhHC@lnr6
zKy*}V9&7E=GoV+@>j<pM;8DP(Nd5as-~qYH02+2X0j(Q`@^8b|3>QsNU~yQzDC|#I
zG`wiEZm?B$urPK4PIiQ2)o_<Cf@2rlm{PPSXIj}qG>p-)#<Q^u5~e1mFV)Lt`a1aj
znQp*zU2JVLlS`Jn_edQ)zA@7|+@*=6F1Bl#JFAus_M_6J$yd6H|EK@mXNS7u;6~hd
z%bSvu((2l&SK1d{f~=Xw$!{Wx<aFPvU(%9gKFj^39Z1eHC8a)_1En@qCm*~0z&>@*
zQ7a_Lw!kCz#cp{~+&1i}8QjDm{hHODq<@hR`jA8$5|{SLb}D~gDm-+GRKJisD8}`o
zk~zjKp_1)*DRV<|u6`IRXw=zOe@YKmS3Zj#&8qr?z*9OG=@}L2mALgpc`m?j+qCy8
zR70Y8V@vKNnAA+qUPYCCnO3$)iCDJftMT|kRQo-%V7y+D(%fx?D)+TO7wTKSh?ULV
zgv#c}2g~Mf!>9B1K-0N<aI0TjF;%YUpvAa(Q1^wj@D-|Ba=LL_mKgUehVU2Tu4XOe
zZ<8M6bM!B#-7{FrdU|BiZf|UtyIH>c2eFm)<Qh-Axe`?CZuwB?nj=CvGL9$4I3kTF
zMmrLTC*~?+^A%5m=BVccDl2q}#4S^Y-NFrtdOn2sSdOM6IoBhFt>(q;6d7o_Xw%ng
zU2<skpCtooSE9+WjJrWSMTaHip}aST<?dTdg{+#@;r$uJnHT7W(@N4$v{rjWD}$+(
z!Kb2#Ge9a${gDeQ>V*}~LKx117|wzj&H@>}5G0xvC+Y<iuAC^E6(*V$C7Kl^ijyen
zg%{3(#7Uw8t~BJKq=T1~0X44k^402odsydNV6^=KTuGzWc`<O@{$OA0Q)<8I8|r?c
z1!`?K{yFZq%XPkiYuzunWIGav*%?q4I(S}8jdzxT*85ikQGN#1^ZTkdV{+c4%5!;*
zuvQNU=^T9OOLqC7*TjXb{V-H8@+<h(tDx!3p*mnS1!@On5QM58p^?^XXBl|>JP#J^
zo<G({N%J@nI(wMPeQO$WE*-c4o4>aSs`{VZUy9Xt2k8@rwESqj#xm=)a`5|yw(b!7
z$0j2(?F3<mkZud(6$oo0`k8UTJ>Goa9)6-*e5uT*U-%YmOsoFeWA~M)CJx^42VAWN
zZP;S9c$5Bz!XvVG?YVZJD#}lTd3=7U$A11aOtonmxC|_N$MxtV_Vg#r2xPAn-$A(5
z6WWd99Od`(88Z+KH3Pxpr&$UVp_-(sGc1-_iaIY1eym9mmj(MvQXfs(<PX^{m(w^a
z11jh!-L_)+QLaAlZnv9q!EN*b((KPi@}A%>`8dL!L;P#8d0@9KlD%y%lRKe4gIhrG
zvwAMmCS2)^uuAhiY$x3Y6U7GwwhuZ?l<YPVLi5`YLX<tq7LTXaI)LU@uFMaKSo(?2
z?jMRn9|-$dj+0G0-trlpd<p%z_?)H@(@&%>H{80@EAE-Hfu+ej#<8$&2=ohP?bUzs
zk34$v6;AC@ipN*fyzwo>=WcTWgKi%J`9m9?Zd8`LOFDV}p&Ku@@BEgA#&BO~YIoRK
zAwm-vpSb0FO01B9A+%nk{^2c&tjK|3-mhYNA4TaNLd{Dz6Bah(Sh}>Y==6|*Hf4MB
zwHTjW=^+D+s&|>1a9>mMv+KV#dB4VivI7{|&#uP)+?SoxL_D(+_s^=_;)<G`(=--n
zFmeHr79e6cQyRy}n#$I`B0sg>ux7c(%}#4NT{}PMg6e3Os+m=Vt7q+xrm0g9wz{@r
zr%*FxqmoWe2PbZweD_(*i6xV2!`O;Tm}T_ZHJIY=g1b_!QCujBksiawT&oe=sHve^
z2hJ!Mr~4^zcg#DTY5N3i!r1x_U6b_h;+3<9_v;X4^&VI&;Dbw>dKGFnCQ!N!^#^|l
z!CDD1(vii9DSQjDUY5Vx4@=)g4BtVx9+mr^#>5R+{~4q!({@wh7Q~ONy7dXWAwdiF
zXVzRG6y-kyrR^QMI$_uPo~58k+_G_D+OF+Cqgj)<Ve!PeStn=_xjJ#h;XlI!^w>YK
z`qm0sG(>Sbv?(QxcN-0?E)&4`<_MMjfr!+Ak323PH13KtedGMq!{emrfbkHKi|9S#
zPHNeSuoQkN-0h?%*6q}?cekaP#I%)>#H0^*K1>Nz<)yK2jDZqC8ry-l6rLM#DI7mo
ze!pB4&q;4EfH7`zTisNe+eH4X92dR&d_2q{g0;vui?t}%TK){pR5TM0y_+!}c3TsO
zWUv-({>fT!kAwYb5qH{6R)31<(9W8RkD0G&n`eq}Li9_e?@Qi`h;-HB$D`E!jH|En
z3t&&}@&vL#lY8FuZS{_kQEBXUKck#e4E3{uzpB0XWShL~PlSDsZ<_k1@#KWlWC?ti
zZ`|&Q^?la_$Fn|DrVX_Cnz0%FI)l&_ztC$xw{JV5OdI0B3rLXeEAZhgG#Bok6lZu1
zyR}p7Vk|{1aOqd?StxhltMUL(ZjvtbA1oRyh5HRJxPNEIwY9VC=UvJ7{638>-8OId
zrCs$r@{oA=FabI3*_v^SVnGH{XJZqtMM5S~TrIDTfK@gk{#Q3}JS9%rU3gv_E(BF>
zDC?7oJVWT4SE!4y)MwRlP36SA{B?yF)CP3xm#{-VxWi8dhwvP|eM7U!-kFtF2Y8P7
z-WdR?7lx>Oj#4Rnp<4mqK8P&{kScuyk)-gOCZFOUKIGcQY#C7$Idq|drIj!2`K}_V
zjJH+l2M7)X&bgUr?dUq0JRP-&Gx&KaHR04Y`hFyJ%<K7k;4{X(OS}>r{&R=~3<Dby
z_BkT{uPZs;dNC!gq6%S}@P!K2zv@3a`isgxBJgg|6_>XJiz?qC%ykSbrbAcEp}$S(
zSIjvBjJ=w$;lI{%GB>KN&7*F2pab%biCqna>;9PvA|`=<j*|<4HmF_^y9)iI8yl>o
z7#HV!wj7e;ikN2C-<h6pot+HnM0?G?-0Z_p=BoVxs>KkBIbGsb>0W+(;-nb4Koh1o
zx)3nbHOkoZgq(O3_&<y9+5-D`bVE^%R!LF_pcD3DP|2(FB9NAL8Pb!osudZ5$#h00
zfQ1yJ;dJ@Lj%%oNoppALqzMm8U|<yQL84#}ZPt@@*H38t7U+RLt3T_Odf6j#AL#I<
z%Z{@2|Mkd!I?w0muHo+gug}q6BiM>xYz1@t+AEq6DKqTQL(DU<e6eeU!cg;7#qdX8
zhNZ{#`gYvXVM_@YtISoNRhBkxlX8Xd#=EXf9PZ3)(|&m)@<2b8;YC9;{IwGSg#k{(
zi?o`)P~+j>UpGH_EzLHgnezW_$LEQI)j6%(S2=mvpDv9%nM$Kn%*FlToZU|X)FEv?
zO$N=|V>>nG9jN?$<>%gO8lCe5Cz84XgX=^Eorr+!;$d|g%$l98-csDE<zPCp2wxnX
zg&o&)NZ?j<Mt7vcwsU9cYp)>_G-%YwQ9`jRJHZUuF7Yli^0YOeEM4+5@wv7%J@-VD
z7^00qj51-PG`3;0S4%yA-@nD^nM69|*2hWkEv2m`Uh$<U@k11_Z5PvdQbv<GUlgP*
zv2LUN`zp#!s}^nEC6g`5kUP8)<y7vQJTo{YGh5wev3k#Ly9Q%eo|R2b_a3`AMy9QU
z^HLW5PSRIwsrywFR~v_Bh_{AhdOgEX06>V%%PtNKry*jb3(dFnHj+lHQ`>ejX~3UA
zz{@)v-$&_*I<OKY;Oy)2)>+VIHtSN{H8*Kx7AU!-D9&77h_$w2kC+Qf;Ewo&94B+w
zF`79&c^WryU}D}oVKas0&cx$(agA0PnH?Kf*wR-YoxP09?ZV~GaB(eCnV5wfXLDG?
zOW(?K1n!#BJ;ZV_FlE>~SsfR5m}7T1KG7I=aWJr6adoX%0nGA@+i&#_XU)uRj6ZGV
zNf^(d)k;V5>NSeaHlWB`2}(7p<jiB*m7Zw9afv?GK;YNE@ef5<2ecW9aRL)Lq&bH4
z>qfJu@LbZ5x<gPl{lbl)Im{Tf11HWycC!uWwZe}QAy3PGP3u+XXhRR2hIHD7vzf3N
z6>ly>?^XeQNg6r3BxYqN+!j%P&`j&?GXW1y+JJk(hYD}@r!Dbe1JPlJkVfuQ=!=kX
zJJO1aY<GL2&hUum;-XyEziaWvz2w@`y}x)FF4jX5HjNS(Ndudj5^{6nBfGj_Ppr6z
z_AOGIe&ym%QsKu*I&k6PcXsWp17@X^p@}33wV}WH&CHx#>lSBbp-j=a1C8xYPD01A
z90Y^t?p+U69CjS-4lRbg;&NYb6I~w-O!>Hf<M4HM{qYLPt%;-V>RMW#ob`?Sxz)RA
zwSV$+Ty0C=n16PbFMfNgcO+|Mb~9dJ>k}99ANx@KlA&KuQYz<wSR*~>fLdc$P6LWv
z!iguWNBD^+JeS_1FGOzHo9vK<O}}j8G^Zisx_M3mYOUm>FQhBSfKnrF4mCv0+GoH}
zx$T$hP`UM2kWt-*0L?naY#^!jr6(s0m&{{Zh{DPz>5%Tf7R5%*Z+-^t@RLLsE|JHl
zkoe!dDvfJXO(Kn1C-~v!HaisS+OxTkwu~#e5cnl;7DH1UyQ)?nS5V(31d9D$lJ-BN
z8-Q&iu%{lz<ow#Ny;+>F;<sdpW+;&z!l8-7p*_PcltbFpp1cX%4_Q~@?N@pfv<uE4
ziO|;=bA*`8Y*pLgJ)|EA?e+Fxb<4Qx9%wYZ(Q0~e9xRIxh=g(dfXVfMb${Y)Kjz*~
zeiN?*6ECc>TilgCflA*Vm6u<VZN6~f^^lwn*koHWjyu_^8y;oqjTvdxPwKK|KD=dQ
z*NRorzN&Of?6ewZ8);LI`g(2Nf@Q;33RNs0s&q2}q<Y&AAx5aP$S`YqkJ!t$AGL+M
zhN|skX?6C1H4)x<B+A6?%)i%1l>WHqhX#^%w`?K1%S`0%lhaZ8Dr!=h$)8)&ooWwE
zDZjtgC1iY}iC)|jd&EW`O7f!!sn!yQy%F|%<;!j`>D)0!Z6_-Y$|^&CY#Nq{?I10m
zg)EoAjrUa^IE$P2sEln_+T?~7eKt>A8_6v6A*>syi|oV47AoP;AQ(6`EZ{YmN(Umq
zT6R$hCh{7TS%Pm>8j^D@#J@j5eRE`f#t<PE-*u3G8v2qBWV_gUiS6R;EXWXkl5_V`
zF@Kg*g%x<A?Q^S8KV?5X;kw7C{c$OgD&AS+UM8)eenEseiFl)GD!Tc30MlfQv5h4D
zf+cb9!B*o)-JmY?DUj1^Lb$3`TQW(%rs6-w`);aLyMH}`D^Wve?{&<}ozqbj7=}N~
zH!7*hp+u6i>lOUTMX7arq2Kr6=%7ul*xF+h{~is$*3+5N<@}kE<#gzks7*R{PjT>y
z+`RR1gILq{YhYJXH$X}(*6K_V;U7rZ@u4ze%*1V#mtPpzGpV~D%~#=R0ENNI-xqt|
z*TZ)1ui%{@IXj*3j-N`ppNTh%J3fHVCi}AjD=St+`=JFPHG>4|RlZ;9myrV#DHnvx
z7ld-vp7J%GR}(Ar)(tx_y4N@Y{VNKa&L(9Je-u$-Revav<|*|`f2EM^R_OLC9saa!
z4v-&6aRRp8l~V*B^{Q47e?un=_~UfI$DK8>u*U`*(eTBF_~VTPA4A^wDYH^}vr@n3
z<UTgTivq~vQW2@!dyM@QLnpe8{Y2~t!kh4oKjT+E*{o(zGm2I}o3CTI(Y1PYD(NJ#
zFW&fO;}&NGvfd1Lp#Ab!?l04j-(&+}q(#v?Qqp?TM{5Xq6cnr|b$ex(mO^BgTtL!G
z!+F`KkTEEEDWpB#eVfJ<7q0Fdj_)s$WGVj8DS;hc;>8XV4p;JZU7~yR)$^hM(V@KK
z8T-N%sCQa^;B1oRX8b16lpuaV5WE?nJ#kE#6DXU{QrnTr)7}dZ>w7_bdb&=;p}|)A
z2==<^YN7JJS%K%HY4*1~`k1$0c0Ty7Hg$q^<Cid{>Ou_^vuoCy_?EGQllUYc`yz(B
z>oFVMy@(okB75Hb{6@K7DTsR2!(*R~f8{e--i{ie)>J?hQbL91?Hq#QZNsHrSp2Af
zd>8mf%w^G<d4KyiBH{1)5L&R}s11qfpwtzct_gF7^kc>ka`WiFrQAPFCVoE(Tk7Em
z#9krbTs<72{#G}$Y$H)%gzn=Y<kvPk-2_YxkpregaO&@+UEw)>i0mc_uQoUqLzFGQ
z4DEO?IdY+Rmk&2?Udl`_JFgH-v^othsJSBh-H7|s5Oa@8biR@X5{~Z%vukl!kexX9
z@CMt0-hy-oMTyRa9iVGLx8OUGlR&nRy+H0rjL41Hjp&V#_jm^3gI+*x56cF?{Xkw(
z?ojve!KR_l;P&{9wEc(d2Aw$MK+1w>gu$jjG;r7;SqNFcoyd7_z&Jp-_BXf&`GR&q
zP$Hfz2P+_&!9il>&=+Ed)4PJctdPLsL|Q^{%$HF#ll7jeD;FgiF;{SWvtF}9WDfi@
zP;O=43gq5)6F&=%j|Xf41#ei$5bMfBER5g_h{81%+S&XIvwz}GWNfBfOkCJN6>cNO
zm?%>~*;1ltYg@KZpj60(<pPujenixlQW_4XWbdR5B_&}Y=aG~1J8=mJ=2Dqok+~oN
zkjO}L+%ac)gLJliABCf+nt!cq$6xsG>0kVk+GZ~P;J+<9jrg4Adk~&eB!XejSxiL)
zRrYDtA!sC+y&RH`WAH#<w-4e2r3di@y@A>S*M`-G)JF7zX#{PAy@N2~-qRT*CF)Ef
zgz_bHg1E!V@PocmIun=!7g)#kdgdM!f?-I>)&sWO?8Mgg45}Mz88Hfk^h0{h5%z#6
z1?>j+0r3GlgWQm|=2FdJ{MgUl3w|`m%{d&TySL-T!DW-0qbxkiXD+qHZz1MnLRk~$
z=#DFg!d@Gz&q-7+fkwq5bs<F!bR^RWxh}k!*F>MkvctVkH$;t;42Y7QaN<4jEE$LZ
z<2f+!N{ac<)~y?xrJKx!8xy6TSkW)s1qS4tr(g?IE39A(?*#_1F0v&0|C6DNOqmW0
zI8<||#RwPZpQXb4yO1gnsZWNJU_k%}Zxjk(DpVv%A7%+Y<ZlQ`ABi+Xi1>d7eK1C{
zB+^8|PqZKYLdgcA7UT-J@KwgJm*yOE7fSK^M}BO{J0XN)YJrrTWFd?a^#c?;Qrf=T
z`_?OfktmYn{<J+?njz@qJwN6lf3dH+ztNBkFi{{6p#MO)j6jS?jA)F07*Pm=#DHXi
z$%3i`L8O6>gVKSbgD!)xgK!3Q1*rwy!Wz8>Xi7D@1%aMHv4Ca=J+hQy4~n*MgCy%h
z1`VCzK%xYR3Zoiv6yg-JAc5+@07Qi~IR`;!z-OSh;IxBrZ9y*=?4ax*uRyM#uEcJ8
zjEF%5q5Qypz`lY7A*Tg^2uebMyyD=3>4WTnlxib^k^n37LN>z*o3{l)Tt+f>BuIl^
zXF8r^LtnR1oXRD&3{Y1PRuB0?@ArY<?|`mwgD|~^0fetkW1|tk-r@j8J`;XE6QsSS
zFvqSeedQ&ckiN}1M2KZyx)(xmU&cFlVq%<k04FOJ0v>!t|B-MFq>21!a!ZI=UEvmk
z@!I5_T2#^@hdt1tU#Fn&9~>;Qjs7&~yC~QpZ9$Ht2GXwBOIunj9e`ZDvpVfK%-ANf
zsRgUrXQE^i<FTzWTuxalpS<#cnDb1ZWjX#tIWPU;Lo~<KyUwr)N`9t&XW0MgBFg+f
zawP(<{@+5S_U~!>HUD34$(<Jl5im%_iytoWKiL16BlCX*c+oaf|BosEi~g^Z124<G
z^P=T9fcyXWK+LjUD#Nk=`^0i+wd&exKWQse$l*pBD9I+{zDo^1g?8ObuWc7R;wtQQ
z00S|t8Vi~tdXV;*|2K*brkO^PhKMHQe-soo5qU^f%u#h^SrJ;uGK@6U|5YJ|^vC$C
zvLGcw3~7x~s*)rrg7<%-Y}H~!JH-Ut4`jtkhy5lU{-G4sMEWh9H_Hkng6aQz$^)?G
zmHkg5C}D-8lZ@QM{;Q{$%v3HN7%n~Go1EdBZU%Og6@;Kv*bh65ciN3qVGcQ~E7}qe
zuai!p4XMz20&g44cl1M`u9#HL8i0?(w&?4uQ8`{LBtxYG4>}D~>6p@p)z#uerBtpn
zZMBx0#W|MCxsl6B*ivr1rhbtt%iirl!iK1(gqEE^4O5@9)0DU43~`&a-&gWy6BNlK
zD3ow-51#M}1e$Mf2+64toZ$Z#mDclrztg4Re^)X1vwgEL#=6Eu((FpMEEY%^%S7W;
z5vR!dj9{eTD2DHx{9K4cSn)_~5KvKi$7n(zP>ydXD+en{j6g8sQD#KBjL?!3tjPfq
z#v*C0`zD7m9YN7~FTeefzCTYsEV`>}244PETX-~Zh3`M}-kGux#DSR(nJI(H4Y@SJ
z)k5+K3#>yUg^(A55};3M6jIUzaTP-R0R`_4y$v?li!_44q2qAS!`X4$k}y1XAN_3C
zI8>rV*kV(hRO$~@NOdk}DOPvSc#=16&9{atxgt>O9GhbgFW59MXIZM}2rt;+EO%<z
zwt^FC(^J?le^4lQGJV5R>l8`dT2NQZtKO4@tP|35N)5pZ#r#a$(}(1yx7sP(vz!y$
z4Lc&FB+vI}lH;O(;~8>;>_FM7GQt>Q#*EWksBH*g)&2C>{nW$?wC#UoEvwe_m*2;3
zkEY!+*NEl2Mo{Y<nd1uIw6CMxvf$1d?tF+ZXVDBD?|x9&YTh`P9p~w}H*?8t(Nm)8
z;Nv?rbBSzWSEBOd<-0X=$!yt~Ji@N`o1Q#!sB;U^d`F`HXWqZmBc~zsFvlJ4+ZSMj
zfrB_6q&K9^f^-GeBO<U4{v2`$Ht*A5kMwu&Wt~ZUTbLQxOa99UgeElD2qse>z8-pH
z5JE5u^d!{0w*$=%d=qrK5%vc~8a}9lfdiuG0=Pcqne(l4yOL%UsqBsW4hSXocAZym
z44aC?hNQ~PbSztc>%6Tk96CSoU#O2E<Dp;hf8e_VLLQOWYqUztiY>Yg+3hXMKlrkT
z#T8DToOiyiQXc=_Q2b<*$-LT2F+AqZP207@<Ms{8RXDa#>)bGN;EK-`D7>U*mm`K$
zgJDu(!DO#jzXKWahbu?jYS<ImKG*7AR=oL}g!O3Djw6ZJ$NrO8X>H>6;XclfbXhL8
zcUs=K+#Vq(L_^qjNd711^2TyAG*6LP#<<er>kEz$AF&WU@i)yOvGM0fT*34!Pq$4%
z3m@+8feNK-zCX`p^FLW4$xJm2{)4Nk4aNj|@0AV84N7J@Z~2$p>W}M#fPuN&7j5el
z>Qn)1N0xBvtJ(6qPC{$AN4Ft<L_X8dkO|l|davOP{Oqf^%yj;9J1UvjeAyG*6KIY{
z2MdFwdHw<QHosU}^<J_wglZA31;mx0o5KHxwYLC^qgl{!gS)#2hu|7qLV)1G-7P?{
z!9BP;L4pjy-Q6{~yEC}E>z({^&)KtQ_u1WhpPKsmtGBAFi|L-8o~Emcb`ORb3iS#`
z{jZ&~F3pOsgHi_7-2u;vNeo2`&7jYclZk_<RXHLeGfr3oA(Z3@omhiqkb8q^M-P7Q
zQLiApI=3^)@OzvX`>WnYMIcH_1X5;q#VUgO3+zl(jvOTz-{4H<8t`hs%=+;Ot%$0i
z-T3;i!+&`r@Rs&dAXZKnf)WV2(9TbVNAz9VTO9cq#Q%t?=0B8N=J<sz-XpaNQS;_Y
zjk<4n@+DmsD$SS-+!F$9K8~W$-Ag8vhz$s5Zn-Du1jjkiX@>un;J9|l0d++Hlk^KJ
z^<1V2iFBF7fcoc)db)dd>9&Bl;?Ec2;Pra6K9-30IE6HzV$6|m@Tqt}%;<^K?kXBn
zTb77KZWo*rO>6kVI;pfp4GK$cCn?@*y=#xknp3*M!S;d?*O#8q&t7$!_CUDyPIMQR
zX-)ck+B@yRcC9Ddil=zWcc3fT3jDcBRB+3udPSh#7B*`ks5(HQeiBO^nZW409g{P2
zD4pT7Jxj%OORu>xI8tpA8J9asI*9p;(ZShtcB7omZFIquHhztVpYd>xUOJKA!z&S4
zxvFcysyZh)?)xa}KwR~Afzz+=<EF-xF8r!>tDc2aFS0J9%pVc;QPg;C6XMvIu-ms<
zCVFPV^qp7nH(nK=w0BpeTeQv@Mv01DZ&Je4`E7~MZ?VhmSD9%_3Cp)!Mwim5$LKT<
zTOJq<cim^)JgT+|;@0?WZR=vpq%G5}<EZ%)N*uTul&Z7hu19T#xC?$tzpNkKFdF)l
zJLm~hzmB-X3G=0{RQFO)6Q#*jnUu#xmMzmUT<A*cIjr6jJKHk6#5Zk<I`xq@ZH~FQ
zJQb>NNv>c_kYKD}R4!QOiBo7%W&Qsk&h_v2;zNW&!BT34HG(<8i1C+HI<<DrUh`RF
zO>krUd#O}^4qOf0OAq;P<<s>`c(o*lDzoYZUzr^C*RBgy#MN~Y`OcBiHlP#%1NhsA
zWZFadTt9bJOv#qzpf#oVc1~$Vr4TP$FT$Ozs}~-RQYXUh|7^bCW@|>6u>pGfaVXUz
zbigJAn^Gy_6C1^UHqR)rMjyj4=p}OS|E<Yd^%2YbEPB*}ik$(3uq`~BQoXySe_Ffj
zYF90?%<nqQn{1{#_E5RjEozG2IL>5Wa?7(8nBr%2B|=*5)T*xvVk+^i^Gubi@%LjY
zTjp3&To|k4OFh<NTBu#MzuEulvNgT5bCke%&qBSFuA4wDlW=5^53)Lz-_;$JV3Rv<
z9(`1(n;2HT$f#y9OFC7m8d|tzFCI~^T5>yfGvYpT7d%H6JQvDvRe0&Srrx!f@i^A@
zTU|XodiZK*OnqwAA&YYN4dU?v;&c~E$fN@fJW@9^Y0kQs`JAcMoy355WLj=48T$p<
zegE@)M#B05v^wpP6vC`LovU9hR!O?Saliwu2ES+kGzRAH6topM)wzgpK=sFBR=&dd
zuX4~3e-!__z^wdyJmypS`YE)}?+R%YSl#>vuw*j~E&>GU4Hcv-B>cEAk1`Byp_^&v
z1v^g=oE0iO{5&w1<G~1t`X6Wo>#tH8Or4g0mRecx!rXs0Z}q0aFp~**4mlgs35b?f
zT@ift<Xc~X_~jpJ@Xi%p7LKDsmKA9j)}ceE0-X_ds6)npsQ@OmBX!+66X*grhzE(p
z2PNe!63&-td>f*NW|`|yGwD+?DfaGJl&P+=8D;n7lP$^YuEVuk*Dl$v0)XcgGTA5}
zn?IL_zE_G~UfNzMEM6%sVIv2d_Wyun6O6L3v2yQddxhy=q|Oz>e3W$JH-2Ex<uuUr
za?zJb*~^7l{f+QxdRgg%q}XJ`43&`MjgqmubN&PBRxeaB^_DA_RM`nu-HE2Vq;*S)
zPLS9m5N0ZdL@^b7%6};6{2px1zZfhn<RmPbXN65Vb0^990*rWNB=f1+;(S30y1+{v
zyC*``$7&zP_pb9PWQ(>OhWO?AJ^Efrm@ju}Zu*Lc>+S~^nQ`Omr0VO&?9pK#JPiZS
zXi|w9Vw<z`$bfL<leV&OULhL$wa-Q2tL|d|G;Q(&G{CF-i8lEa`tp+hj)-Qja2?vW
zO$nFCB2V8cPwYqGJWp!j{3jwq1!V#8&2T<Ycs@@v-_onfgb@}>ay~>bft{sLrj$@7
zJ(T>^QojAUIpPn#M``Yhm^fRDtxdvvHp=3Q*tJ3D(Jb0xq;yfPJ;Wwo!f}!-=++L?
z4&SzQ#Bnm@H>RxUItZ}-#hp$D`1lYKe#YwoZ`+aNL^;MWYhbOv!KA;DiQf+t{kG3E
zrJa{_83+Pj!y(c5BWfTf`l}i+%|je?3fZ9(L!f-SF2sPw&5=OYh#?gH0*9RW!4ldR
zQOeN}d?8%0njzaLT0TP6g@s8j9x&yA@#A}%*9vy((ny|b(5jHXzd}1f*a!l%`uK<J
zjOhZ(2+NdcOT`~O4)q%r+UIXdUEgTd&JQm9To@zvVxzB{9ls}hKoCQ^AD_J+uf}($
z5nEza5vC3kHy7?lweT9FtFz~RWSTUJkK;(OYxJv5Yo$qTEsl#b)6ZNWN^Z3l@}Pfo
z_%zX{ER=C^o)DeyDX_gsPo{A1I{3dp)|ARm+`lf^5~C|UBesnh$&Bx3cjKZu;+!E%
zu*2_fl!W$Bi1(l#{Dwq@Swjvr(5bKOe?}vDg&l5wAj5lT7_XlqsC=XHDami!07nDq
z;LZ_F@$a7$XWx=1`x1omuGn&;>Aht4jit$yAO0C3+*mvR?8CVOn5XNFC8i-!@8<U}
zFehCed4{w0Tf|Jg%@>vTPlM$}0T6C+{?9;Wj;NG>94s}8G+_egp85D#CQww^p9j_+
zc>^EZL)#d=?`@PQF&Ic8$Kg}4eKLya$qW)j@h61kLbk-8W-T!M-2GpIhy!b?F89_9
zN{n}yAUcY))Nng_3uqYIvCG=s`_U=$-SfHdQ-&|6N4*ORJ=|-e-N4DSG5nWwPuJk5
zv76pg_va2eR>BB~dcR5o;&~WnfA<QwBbYvzC1_4K_kv4nyeykcynQqgAJ#Vsog%CO
zGG#Dx{)PsSWW#SRJK0yY5$b%8znRWM6JriWzIo454@<rWQHFWdu*-k=^7?xNeC4mN
z&kJp?zF`+NVHdpOjjSw#Fu6tM+XeFMF5eoV%1i0B#^BPWivQ_~*yJ)w&sKtG^1t{f
zJ<B@b6H|Uagwk2Vm~-j5hA2a`^ZIrO<x$35ckD}j46VWOf_CQf?G@^YZ2k4kE8LxM
z$1B8tKrTICa2oR8l=x38iL60}r(da-%}YT#ZO!ezgGtQP5`9Zzb-g%nZkrNbrZTS?
zCqyaLE;1Pokm66`)5`?Re40d;5~C^=og`HFz8_RZ-W0S)m}M36+dNzs%D7`*LnisI
zMmT+3d}0v=p$Cd#qbl-z{L@?$70lzLh?$_q@_yVw|81_3q>`40R(@g0K`VEP8So`T
znE7cMa3@3U_yroUX~611T8T2vL$5;H`ZFzmA)4?e-C_N*-m1{4zK&lUxAY-u*pd;?
zs1bcAP=mP#K%R)i%U*o0i_%tHiDwBZKW<5kztMpX7sSK51zo!HpI*Om$Z1g6EJCEj
zWC@KX(c^>Ev{mrZ2p5+^Paxu@$hLN-QcNKV&Q_Hwh)ci?Apsu9%=S8CQF3D)uY->&
zG-7D7%YBS2g%HA!Hma--rZc(P_bQ*orFG9dLe|8dNE4SXEchv)M#+!gsN|JBq`z~7
z)pbLgo4_Pz!Z@fe7P=#!Fc2d7z=_>2#KkEYS>nyM*6&WY*OgQejibW9B(!u*sx~>}
z=5qdiR~<)xqvdERZB9+<{mbl>mgt@UkVdPtL89FMYSGJk=@sU8mk02Dj!YcYl^~di
zQIRm7T?Z^)OHHpREq&7zyh-Yxtn1Hy>9D$-&ciLt;zKPzcVGmw*7X|Si%q?!pxAhZ
zB~|$>D~qD6?VK2zm$Go4SYMZw^_)R)0K6@!H7`#QJiQ!kHXqx67i=TcXdD!Q(BAwA
z>XyYmS>7Wgvc(Q;?lF!%j?s+~#0WeJjF4=LmK9+Z1#AgnEUYkh%W-Z12#)w{W#?u9
zF}J+^HrJxg){e)-#F&B2a2zolu?{gvF`E6<{kfmW00itrjl_+RDbYHSI^oNHjN%Wm
zGyTT>SRq(aFL<G`B(Vb&7eAfJY|PfEefkDyb>9N7poI2sokP0pFAU?yhC(B}we%Lm
zxb-Ph=PKP47Fys^`>Nc2v}BoFepq-SPrZ#B2^)bc+R8L+G0kh?(_00Uwro?bUU<0;
zxvpNoaNDw!%f^g^n_Pk?u5Wg>{2)fHtJt70$wa|&njJS**{)bWV3NhyAdg#O-kIax
z`B9Vg9U?7ls-z(W3+=_u2zO$qiCXFRPHfFu4K=T>BCkVL<%8~{F~ghqq+4UvB;*_Q
zf&K&6_d{E6G~HTDo)W&p%`%{UkyW6=38s3K1a%J7&<T91Bgu)QEUNaFpn)si`ew<l
zOA}mRQf_(SltTROQJdZI()hiRPw>nmf6au`eY_$M7d-flv3<Mt(fLE0|53zIP=wfx
z2sS(E0$fUn><3H}_9|fj9XpOxEM@F|KU+WFmU65sJUcOgZ^Q=)%9T$MN8ipSHf+fs
zDUO89ZrPfnqeVCY!~jfy(1n!=c@=&mfo9kff@XNjH)IN13R`kdAq_d0OBGgyz{Tkt
z->;z`;ZdoZDR>fyLx_W(L_R)c@GW~rqLVPA+n~dXeLM3f>;grW;Q(%?pg$spaN<)|
z8!%Q;PW@|pZ%hJ>sB+K6)^j?feB&W$VdN3huzBe1l>Pw-TY6sf#AexWWa&+3po+28
z=u4C|ax0__zblyvp3hb>zED(=OeLf6zfFUCQVJ^z&N}?L=T6r|`nMHH^W%ZBN8G^f
zp$}0;&wnc~nl>3GSYw1%p=^-fA@7?G$)C&Y@iyawK%gt)Irav9k8(&px&rxs1voKi
z^Qny}bZ4?RN*fU+hvNp&OwqrR`>VhhZ_Sjiyxp|8aH)C{{4i;sonuV5&r>DehjC3^
zBo#!1_Cw&yMdpD2KO4F)N|{o=G%!D~|E)1BH!SZg`$rHh`7?m>|26!~`#V77{m(+L
zEfacKQu`E4mmH)aKDxJxSn}!~pZ;4Dk^XNnAfKRDf*12U;Q!fN6U>@x0733ShXiHj
z4H;lFN1$i!nhtXMS7Yc9G(x~_KA-mQO$yJCLIWf~`=?)$p)>EpXNZiiqpgag7wu%G
zWumVpNn1I^S>z^Ul&>bS|6dC@zy1A+yd6AoS8Y*sn$e|;&)ycP@Annz_VrdG+uQqv
z<m>AEf$^5UuWtnWj|&@dQ02LB_F4Wpt)i<e1#ZUMQ{f=nt$5QjWmsw0zCnZd1$Le&
z2soaM&N_A;QP|Y7q|Q)4zxH-aH}96zHMv4bxv5wLG8?<jP!J<Ql}Udbxy=9Bl$nZU
zBKxvK585#iDVcuyPOciHLZD>Ykccu@MXn#@NpNA>pY*Q=oJ-CTFpSPF){p#e4RU)V
z^w*zHf|_raY0!m+!t<xm<!v0(i9C4`6_9A&_L28d(!Qmope2XprAAahVg9i5)*+T5
zmc}TyI0m=sjb;F&L?Zc6?Dr7KmtlFJ_$<X3`4}ZxSWkD196Ik1!TBrOA_765qpb-A
zJAzcqK)+#2E?i0wacJ5|kW8#we{D-0w0-{+JQ<}oftxDT0z7Da;LAtm7UlTkSX+)~
zX7<3sr#K$DWpKYv!Q#V1)|9j&KTY-p+u8^P<xU};b>XD*v7XnZ-dE<Q*GA|Ab3cO+
z!jYTMi^=_}XVeAKif247;1p5ryr<e**Rcrok065c&4?|RUV@7}4waU;ZkwiD*-;gH
z;dnWrxB<;~yhTk5UfML~Ls6#*B+&+ayVLwa9%9wQS(?mwn#^F$(PYll^p>hlQ>adp
ztk(HdohDN~oTF(r!Kib{q3UVjG!116C=0taW3N)6*)4Q6;%bzl*)4We;%d~UX;-mV
zl53G=HaH7HW>z_GIG6$UZ&Ba?b&s8MWSPxa)nThuh*i1CDC1?eN>1Xc2?sQFwSY6!
zM59H~)d!m;4?M*}|Ah@3Tg~5KDuz<bNE+}>9P}0H^EI1;Ybs$&CmA!ORj&wJOHC?v
zRSon%Y4%eFF*rtrxs;C{_OYihJZjNAE(Un%YMxrzWLs5Y|ICGF68}Q~K?XxBY+NZI
zk)q~*g(}OWh_n{RCxa5XYifSxqA>m9W~-B8(Q==d3{TXnah>crqA`2V)*QMZ=V@u=
z9Dh)wlAp`RG-FXHFXN<DG^LcDcu*5#@gYwtR7-kVDJv1PHld*RiAK)SLP;iG>&NtD
zP9jY$XJM`s(|?B$D`;YQq+!*V7ho=K)%`AQIveSE%8Tq@iYB&U%uz>)(|CDyeL3L%
zvJQ4T>%*NX{{IoUc~1mcpiU9z@ya?R@34-zHBId7OQhx#S!dYP{C`M5Z&T6HiZWp)
z#Al}c>3I<br9Ov4*M1ro_?s4p`)N`Av$z7f;;}N)&b9(*X$3C(<>YO&w(`Vn0D$=T
z)U@TTEgIVQO#kG0V+TTI<xKz-@mMKo{aYVtXxVwkoE8P<EG~8O<@^ADY^P7a+9&}l
zI}LvuGa)go@8xzWtJII+^}a4Sf5WS|=q^bXfD`a~e~`?=dzh3KNnzez=D^+F=JT#!
zQ*;y&pcYf@mxi-d^41)Nm*Kxc6l&;|ejzv?OWqp6U@&~sd(-;O1>zKP6{ZEr74M8W
zQ%9un8vtV450h?PqoeYhF+?9^6bvzvbmki~h%U$g7<eRf+_#LG>LTUe^dMRx-C@+d
z{)vlde5-h42vH4b1~ZIkhqL~!Lp5YAP=s##)E2r6;9Eg}{?Z<Fmikct86f}@p86%}
zPJhEE^!5L2H1v(ULa(XIk{a|j+(Qq+##ML2DRhon?>`ytq<I}9htLt~e`_LIa}kTQ
z$r;<VO4=k#NF!&EEQ`x+3f7P5T4-GLKkBtfz?|AwLhFblnRd2T893nTXtQY0wOdfZ
zzpt=FC{FCblLTF#A1XHRoO}d14g6B<XDJtdN&uPd@WIBLR3wWs`X4r4&#S}AsGQk2
z)%cqNprB5$Y!bRxX@g5os%?wVJdB@tZ9yRdO)V+!$>{yHRnFvV!=X$7#U(oA49%Ku
z+N~F}zn-7qwF%QO0$t8!j^w?4R$}2-m+qfyRaV`brGwNI#K+<WNZyqRP19viuN7{j
z%rH%<u{X-Vpt0^Rs?f-&K1n<2U--%<4*04M`o0E3t?81vE(9&*c{eozZBFuoANN7t
z?hQcFf7rO=e3QrhN$&++;auks<isJ-lO+GIouVg&XjM9PE%<@OMhIO{=fiX@!rs(~
z>c37UKw&0duve2l`JH~hT^k}8iS6`49*yrrgvBzci0f20u@k06EQBkNA;l~0(p<gF
zBz}b8b@n%YtrNQOkK7+frqfCP8t6%nNET;}R%o&`m@Q^nrA58;<Z@AQWc2;W2)X%A
zw>3N%=J0{elQVH#fPzK1s}VJ+Gn@EMnm~Z2m^48ZXg+g#s2a_M{j01qkL%)s5GT5@
z2)MM}XWD6N+Npv2^i%K5wRK$zSAd*F7<`FvdY%(TG&4xg?k24!M8(kFF(^FC04!=p
zBUaripy<2x&5kDa+S;R(B;$SPpOB0a0$j!Z@6ox}IvuqnJ+Jft*nOdq<ly}=Fd-Xd
z2Jj@~X+t9>+1{g*l;q_boKTF40yrjQXa9}Bnc~}Y?<5s@!v+;qqOt(k-?Iz;1#Q&F
z$NgaO0ph|J!*nHz+$p1g_8;_Cp*sKfAwCP@lj}c1*$o8v1)izlk3eYf4HiEW0`|){
zh`(*ePUpXb!f*&9!8amke+7kTWRVH6|4E2lONY{tc}g8b8g;w4CFs1bSdZwq-zD7T
zAbQchgT0+92lu2P1TO%>g8k1|!VN(0z{h>jll<4w=c}P*h1bZ({iFuq3&ZV{|FS|m
zxCqj+0vbU08Sf+?xa;j6^G9L0Mj+`{*#+;(yE%Y*W8zZ3`L>u~aUA_jw0oP#Y>|lv
zO=_*lMVfS7G0krOmKzRZ(f|?TeK=wwTbtxBmI4Ee&1}=BEJR$^Jl5ADKVJ5>eP@F9
z9KXg0i_7-Hb!md~P?M)B#2*nBo9)FN?7wQ%RqSvc?;|2!fBNBW+7O@>tyA1|2YaZ(
zgu8hKMd&MwUiW}+*U0Lr`<Bzt4s4;|q*25#cs{q&(|Oa<)j{?OTVdM{CT+50ovj$?
zVYguk-~`&zE`0=P57hO~iEowK7H$=PM=>AVvcB<bKwec89X)S<x9Q?$--5gvFD5_{
zJpV)NsaUATgXoJ(=8CT~+#<>U!AJ_JNDgP3ttKfv6nIWr-{p`^1FyX9h2pFA`xeSK
zkLCvIoZj6_JKf|DZGk&SB$qr;6blupdufzE1gIWrURQp7OvYK(EKwgwD&7_te+cM&
zN8tJH@xJwFSEdSh5_$0Kx%m0QdQniNO|Ci6_!fQDGYdHgb5xW7IbPMuWTviUu|aD_
zuw<e(g=axf>FJOZWBB#Y5ea3J5z<sm34(XM%umv`GoYX%LWk&5zC8wo(QVLC#5An?
zSt0g^#350@=QU;qHJYTz5F(~%Z)>R$=Iuc41bO6Y=HL=G)@b~&e!Wf22X>#jB=2T;
zoHpKiuQdzo9v?7<@i+5b8o8;Ps|hU3Ea(X=<vOr9J8^%tGtX{zEv)r&Ru>XOTWk)`
zpY)G)k8#3dnDi%ik8#0s+3(~J?-h5k*R^XYnAV?KGjp-`9bNGbY-lpGdx=0xt3CfJ
zSm45&<K(PvUh90@Q>mN&OdEB2aFjpw><EI`gn4eJJs|+H8zhiA>P%(bqF7^~?vc(n
z*-EyR*%_QJpn@__W<}3?Vmw=C6B84mc1L+X`DoE(@M!xmxq6X&kJ1Y6e0FSza&jyw
zrd;Jy>0=#*vz^_2!c8mZx%FAi8{?|qZaj86>bPGgd2BILAtN0*^mp0xtdCj&Cy9Zz
z^-)q@dK?XCw#&QKsO#6A!PmS#u4F=4W7jSR-DsW{%};F#ZQ6$w3VQMLeM}*>a%=gz
zyFoWXYrOEY?V}J6w$P{HP78#qN_}c)JDz$K3Vhx+I+t1`3XB>pW4+B>WUG0`Po}AI
zZdUtUfZYr(Wj<W8g`4$2+p@1mg3j5+w8I{c_oZv;X=5a{o&J}PR{5x{C060!N#XE0
zjJg@>^&5QZR=Q;rnmvD&T$(YbHXb!~>$Mv8Jj*1KT`bQSOSD%TjX+JApSC^BzK`bL
zzT;=syqSm#RA^`0sVuwJ*XMo8uBCC5pWn)GSR>;$zlx+>YuG#KoO-X}aCtpMru!)D
z;U(~azfxgr*#bjhHywTLfd{xY;V@aVPkS}Y^Dv)b;jlZh&+9Z>B1KD<y*A+#<vl4-
zDtRQAcm4UO)*IFa%NDwi-KQxD&Wn*0(uZyp{Y9h&;whs6$y>Zd=&8z8@DAp@=}h{Z
z?@W24^K5gY79`mV^h*kz^E<_H>2e8&>#Prl>v|sw*YQ4tf1P^c<;=)l`0kxOiavAM
zx=gR!9fdstkeYdYs+U(lKdsZD=lE=316DwJ8Fmc4zH6~tEjSvJ$n%SBKdq3)<E_4{
z&$*95Z_6uD#@iRXlD)HNQ00bC*P!Vuyjs*_@LAc0PX~YaD{3^h&l?8yC)+c-bA7|!
z*jE^}h&!NRuU|Ww74TV5!(;ojYZ1!_Zr1$~Xi!>Q?ptg2BB^1uX?uGi@@(USH0yFZ
zQ_+_63NdT`aB8T#v=-nb=mRzT_~fK9_ISFkx}kbzwXxO}X84Nolyk>*hjCsGI_xd)
zDk6VD^bEXHuP_?+L16gxgm)IWkpyz+W$82z*AE!OZhymqE{q1G@<vtDxv#F+7*y{n
z>V82M5P#w<;R7jj#`h|8J%$0lsop;Cp6PA$fdqRP*4Z|;&zLv*46X@%u+>&>B@M0_
zeel%;Z-Jdf1TW~s=a+9w2-nd%2900oOIofTK_Mxob_tijtBW_=!D~niH_v?)8;d^B
z4BpSd6-HC1zBn!~P#SF8Yr#1D-tSAEZ<`H{tJe^$(4J8>9yjZ|wLD%)ORg_ZyD((d
ze4PZ_ab|hjVTANOIa)q@ViDT|C_N+Ymd;epQO;sFY&(lM+OSs@TA-s^+ek@S+E7=O
zTkubCeXtUR?`rLiuDQVRy}`9!JE7Xzb+JKXq&|WqvJONs%l(|;HE}z!n(cXc=K;}+
zD$mVBmEK86>mwquhYNj)>y?Z_Z@NA*L*5gG#`%VR5DuO<d5Peyc*V_BJM`iE`}+#_
z03aNYTn}C{BLk@z?~%9SArOcn`H}(CN9u(UmBxn!j!=m#_jm@p89>y&#nIpysAo<d
z9ZOPTE@x)qdw?a&ZFJLnxF}a47`4)ig$h8ILJ-cQHzu(afTBd>2Fswg#D_GBkOyhD
z?f$%Cb}8DQ1$`_a8<rGFa^=w17{$EfA<7%MWbAgoqU?Cepmi+2%Y8LEh;k>|FB|BM
z8s+UyMa<>{4URm-9`^X)NC)=t#9j`FEroXm8a4-Tof!3SH-Pp%E4U8DY?^Mx?3>^j
zA5VRa*4|s+88J^=jpt5bq++zYk35#6t{Sz=w|=VCUc@Et>&AxLO{WkH`Ccv>_XjH#
z7n3gj#?ikz6t$fLv)dzrx(%IujYnL9vPUEQy0xACj7KE9K=1gw6wRH#b*t6|8$U~S
z#3C(qDw@{?W{-Y_3hw@j0*)}?h#-l!2pOeU%}d-^O+f5jWx+BB;9P@F48OPI(J{p*
zE@Q_|WZ?DIlRWMkJG8?|Ye}5DL)UoO;BjMmZ=co@<=Qb|<rc8H<<tWuuNU0C4szl_
zCe<qj@{{UGmUeerT{HA`ANE@bw5Yw>g9Z3o(7+OP*9p#q0B06Jxw@8Wow&M^=miAN
zDPo<S@mWHG*KY6bKHPHw<I1E?MceZ;EvM0Qa25<WtF^cLFhmMmNpjEc^_eOTzJWls
zMw4e}T5J~J+B8@NT4sfaNcF6QQP9e3)q{fPE{MU6c~<)^G+^=4@9v(Oe}h(j#Tyi?
z-jo3Xeb=*cb<K4Er!H)|yBY2)K%f~*Hd4I-Yh<)?wb1i3>DG?3KgBZ8m5b4qZMiwF
zoZv)vpcnbJ3_P-|hx!G5cPoQiRH>gW*5=ap<vzP3X|I{H18J@$yM5`}1+X}E{4H*_
z4UV}2tU66fM?}oJ^kpbXW!U*aGU{QH-MI|C>7Yr~BP1~Ygq&pa>tS<J?${qRDOXwv
znjFy((`llo<<e;?)Tzd)@Eo(-&lBhci)Rm5TDtA_cVyX^S5$0kg4YX;o*D~Z%<deN
z1$)kR^V|bLV{$Wk-N4kM!yw`Js?{hyHbva{FUu;cL@zqOY<qw*z2Ts-T<>DgnCTJy
zi_V}JiVyR4YLIYJ5fNA}q`QGKGw5Ks&t8EYqDD?)-u4QTNvc$9a4aM=YH*~VtI#%R
z^aX)Ow(qjrS881Z%QN`zR;vA-e4Yi1;A~>oK{2?p1K@9o{4E|}!KlA;DEwgwmPHG&
zxPyhD7Sfzqbr;#3nG)50=R@tF9a#Fn!fVLm@Y9Jat#SO68!Wr{89IA}L9}@8rJw=v
z9;yr-M$FBDz^6gn&e(kLq=&XuNWU93EMCGfs?+ZUu5ZgMhy$;v+ZmPE2_KxI1g9$N
zcpNY)!#MB&(A_CWjo(1Sfe-CW-)5Fj%$cXV!IBlUIoylRmZ4M7M`)w-5v4OSydP<~
zA*7`v66u<`JMyw%puwK>K8k4fAT@|+_o3~#=z*oFZY1DZs5|(w-^-IHdbuz7vLKSj
zj+wT$&~7-}eqG?;4QkpD1j^|MrOo-Oz%1@xW&>=t<$`W^E-1S_E<sGK)u-!w{tY&y
zhoOf%7pUD%4vj&eCbz9F?~1gpvsD2A#Oa8!HErj?QV^8+!2nn=UU}^D+AOgQt`)j{
zIj(Vk3v{<f^`5?~Ev{fOQB+3Yq1i;W-HNPJFIc#`?N%6X@a9Ic+CWVy7c*x|j2B4l
zBNXjmbAa!iDn8O@%ds5{s!1_gvs;w4x8$+LW%HjhYf55I;|>?-HLmVg7T}(0A|y=}
z2M;>0xwUA=vjGu3LP2^q&$t2MGIB+N;xa;!AJh@6++dZr`$xiVj?ta%<j24Yvdf5(
zPYP{)u>>LM66xW$zPdiAv-w|MMgny|GmKroQXY_!E`?|X_i?L8qC{KwJZx4*7QFuE
z!eCz8WlS_7c0Mn$B}BReZ{A@{1VVQGsy%HkP$!4_1?=v`U?odCjF-0TgZk<Mhd`Cq
zAQjiIsqW>VGV23g-_Y!_^<rxbmpe=C61b>E!e@f|uaP=EOxl!rc0-)}eN0mk#Pzb(
zcFXJ|E%rm4OTU<=kcq&+5)5*{zyk~-QV48+P?ra7y1SbFK-o;OfQ>NE(`3m=F>3;Y
z74}Uzjzv{FSK`r>oupycsWi-2*~?F6Efyys;d%EI9IKqlJu*{A=qz#^A6hs^Ue6{u
z&AVi#1Q77#F7b6ZM-=TQIA1%2r_$cMUKPaN<x4X42u}$LzNDONo{u@UNBQJE0-iWl
zd^Xeeg>c4XZ#`Yjnu5DIrdkO(mK+ss(1{<TwDUY@mf2TmL5cgT@b$8{Vz-_4XaV3S
zl1Yi_d3p2_(g<0kPa^QBCC$o`Tks{T?xJ{<0EWc$_bgEfX?Wl?Gmp}R8Zmw2yQl=u
z_(mgutS5aVRa?RnhQ9P@2n)4BPf{Eav)^X@hRguOId%A2z!=r8k#kZS3~eP(-x0GL
zoP3<l8#JkBGPKHMClGmI{U&)~@Fpql<+~P&Ydvt(-uYVCw}H>C=W~u2j&GbXi&=*4
zwbt;<#P#6yj|cJ7lE*BSMX`fzwR6J0JCpl`FksMA%=0^(E;BTIUe@@S&HVAROb8Ao
zIg>@rbZPW@my6xztS}k~s^LskfZl(2;rf;dl_2ka(xh!ohbO<NNK{o-MvbMEbo<(&
zIN0rZ*pj~-sI@Y7*r#?|qE<?}bxmK~tX5x|czIabvZj^WLRM<CHMUUGlrc94V477g
zE!(<f(PP<t4p&RMc=%A(``}rIQ|we6*`n9X0URsJ?JQQndZcJyV<s!}<Vlvtop#J7
z^nAW{dmM<y6MlVKdAfNXx=Vk4zB)X&16<j=I6u)WX#h`1P|c^(-=F4Z-@DpcYMVzn
zOJ+ZVjxtHhG7@+nfeVeH1xz0+ZSm1@FlOEsiK~222`+fqn$|MZgqI9O*r#J7C#9y@
z%I*pHmXI71gNa3<Wb{EoS{7c)cShD_#BuIl<nwzEI_Si>4kb(tX-F9<19}8TYTsO{
ziiAI*rZk0&lnH$(BX#V4l&p(M6A?|OA?-p1rNw+K=h-KX1ntCu#K2-x+J!1giv_Wt
zrnD*Zwla*=p(Ij9?WM-IrN*Fxd9Gs(8vdP9V@STlfhf1bl==*Wy_9c%3k<~WAdNEX
zIuGc8NB;9JPiOijv|AJwsYeu63BUaK3D2Hx3NsI?yZR1Nl>h2?1pm!U7gLROo;@!l
zclBS$znLhQ37eXMnS#YD3EVS1)SEt0A8D3TFxcObVeWd(uZfTHA4ACf=}0`R8NjQ|
zr_tA$MqgUKX&^+DjF)TSOnkK}aw^@d3t+lh{oo^=4c@GR#S97D7)R%&>=`Nb9=RwQ
zg8S!Rh*AD8m@SfnB3WArp#i^}(y-oO?DN+lIxlJiK14q%#v{n0YwvqsH$QrC#hUuT
zhY@dmD>1nqfK0Z_OSD{XD{oV|J-OL_+}z*4J_bEF@(>F>w={b-3#`e{4LwJ<CtU*j
zc8B^D^!3R`ch~X{WmayzGK5|q?vC3XkR14Tq7wPJhjDiN8c`ge9QvQX5El^yTaq~Z
zD*s_$VD?91w%xM7oU%RYsp-0a@8a+;?<HJJdHdlca2d%%+m$8oR_Sk9_FwjY^7}{d
zLIbQ-)Dr>LVjhE*-*2^%-=f^39Ic6XL*1inv7QMAx6$4hQUr$*)BLgUO1=|J?YE_9
z4}8MCF(eNTB*q13^n(ov@6miViAN1(JIVb|ANnhnz?a<dcI<~FJ_?sB?!eW&@g;2c
z)J#bP_k>JIsp?zghonq2scIo;LFw`A|15U5a4tS}xA|AEAl+=1PiJKlc+g&=<NqwT
z9(L_;{}2~fSOETAM#CD%S($x1oQo?Bpo4^T8I;lw;o@o+Y)%fh4APv3TR!c4&Io*Z
zX<b```293Y+QRQWi4Ofa9_1^#`aQ?gb)UnJes)pRKlY@ZdjrItHPdw-(4*v?KIw^m
zS^4eMF?jFHT|ZskU%R_C_;~y90e#YJY@h9iogVI<PtAdCLO{J$AK?`})Zp&mA>rL9
zqEV+bA|7=fytGsvmmc0L?Y;VO+n?Qw_NXL@$JN|R=GG{?!#}y3vloZUxi5=HPJVJ<
zS?!J60a0!jj&zHHP)AM*2p_nv4qeemp85D3m(BaUoR@byJn;8e#|_s>P_Bsf-jDx0
zbIBbq|1+EkGF&lSAw9r6`+1ADuam%#_?;Sz+e)^RJUd@4P5fn28^%H()4+1N@G&?P
zRhi^0Drzs-OVm*R^E}=(hEH?_3*8YCqJs|;xXBe~q^!4dlU|F0(2srw`sl;Yoy%my
z&kMsW^LT%d7_(E&3KsYqm_K;uGB67Dj~vIV?hJC0Q#6ktgE90Y0zWU&KS~koeG?Re
zeJ~WpIHCnJL=wbXzeeHYNB?`l&Qq?PTLW*joihVew4Hr}jL|66<ZgdAKCIhNUV-F%
zu=|I+-o8GP{qen#ld>ki#ERd$U{e=vJ+Aa(JDGC~p~TI8!5N#{(5q}|9)*;Uudkz(
zmLodItD`D?pFY2P_xKgh^lIfXc+4urG`C{L$=!h;hwNo`OlU_M`;gWm+~42d<=S7&
znlxZ$-!qpZ|EAF@?ok}jE_D*LWh2E5Y6uu6CwKVNPmIYP47Q<CQNt{ti*QQjcAkyD
z7Jv{+=3t%&F@TP@{l}g6k)NW5y`*>EZy&H^#5F1mJmra?24`sFn=8fc7SadD_xVmQ
z=3G?P;K(&Q(L+3NjyqRsNgq#sP_=33pn~VAmW`A<4J3*3IqZJ!Q!<(Td@{%Pjz~U=
zFz2$IC8&B6x7dt<mSERRI=?Dr^%-<0PSzIc)9_0Q2wUNfn%YufMRRM;J~CWYb0L3F
z^a3^cvD}}4)pFfN*-duewN6O^6Z=a$G11*VDblR9MpH_`cr4sp^@kEmPcy*Vr+DTz
z4TMy*-DpVta>A-PGYRvqP)&#i?-{ZDMQx2Yy2g{)kk~6@Ld($~EVeC)iRFyR=dDQ-
z()p7Yn*f_>!&A~PMDoDniQHlA$u{A3x{AQVM)zWO;?a!L%EIq5{$GjpwJ;ObuElr`
zrO;4XJg2)fy9I~p?pDO|hE7QRdYx7&-z<8c|A1ci(qJ>l2j78vF!;rZ%jF|x?B?rx
zPs(NSwa^Q#z!^Z!<U@m!O~>xuX{%^(@w3>F)~^`1kF-B(>D~H#^de_fb+FP>PYu1w
z__ZE_HD`s**aMX`M9(-se95-1BNZSN&%lL356a>4kO6Vsu+sKzGD#l^%vVBPj`zxM
zmiBTa{TJ(j_DqQ#S3Ztk7&xjewx==fa<bKCZuMI6NA<by;;h-T6X6qgrNT>Pu(tY`
zR!gOOTFv4P3EYnnSL_?#Rh-~+!&n0hI>?z%vG0i{3aGn&)f!h`-nd4?A)YFK!})v?
z>7vD}9{pL#u*>PEwA0wyNPXbwLu>D@G;YT-i-%i<Y5Gmro6h5uZ>_H_;q9g?Hq;&R
z7?!{Et)AZxKRCQ3ae=D%^Te$U9^&x79K`L}51-o&K$N1kV(_c$)biBvg5QhzXTWq2
z1I$s+rXVhS5z?Ghf;8fzZLfpU>mMh_oa7~&DG_XOWxaI>`0WdbPhKD;u9S1@Ng5wN
z#y<Omx5kuxoY>!e%o)i+ye(TLEm~T9Nv+YX+jX{=k6HZK3hgHu#6asC@#nMRgM$GR
z0EkRB^+v-{uI+gu;knKFDSH=9Rnz-6WI#?&=gsiD3cS|}y4N?2OH+;e$xAhYgses$
zp#+H)PNQ50k-Q_0#_}Ai$=R2=F+=#~W-+N^s0Zfj_XGvazD-1bNKvzKTA+93I1BDW
z?}wFAiQ6HJq%C#TYD2D{=8RVnff<$K92i%!(1KW^V;|3UC=2wFZ!x>?jd=8Bcm2Jk
zGEWemB&h6I5L&XKPpAXE@;<j?x9KbK=)<0p`+E<plbC)EMn2*27aGb$MLk$w7b0oV
zhI6v}3<nlM61^z)XIaXRZ!DQ9-f&^UW=eFwnGV7K_M=|wjpY`aNaV{D+up@(etfx@
z5*~xNW^X&3sCUm+{?vfFpGs!dp1G{vrgQn2h<d{sk<OJ_=tM8%?U1)I$`*;ut^Cgj
zI`E9`xo^21zaRNoRd0D{y(<b6q(^29E4wRT@aEQ+r(Fv$sXQ)5Wzhbzx_bIzekc|$
zOk$;KKXKQzEmn?pO;D0mMtql_XYtcP^J*KlzI9>ELG7|nFG6P~7!glR9LYZXI58VB
zc2)YS#JBl?X!XioovWc@FnMF<It1^zKtz0EEh25~%k(u>bQ5Wi;#@rIfjg$eif@48
zT=s9fGvg}&6}a{_8a%Q`46Ctgf`l&E9!lYZU@?E&2EG{1160PyCa6aj1)sl8*h4l`
zpRvWKqWH3yqR~W*l=l3;qNfJsc}kh`MrA`25b^qs7d^XBNNlm5FL+p5>@Nq$m*f(U
zsGB;xe!d;~!pWyWY7@O=qkUstdAFdJsycT<n!Y@zdYyeVNB3*<w%1XM)N@Hti0~Wf
zX?A`00P7Vu8)sH%p<$~__W<6bN#p$VvmN*hd+f>cc;Hi~>C%0_`}oAjCBW!8yPuj-
zO5`s$97*(&uIbpYTePeq<F;@)!;*f?eUW%*raR<+IQ)nq6u$C75-aJ7J!>}T@uAss
za>;aM&|jIw?C!ul0qud!H|VEA_kj6p+~x=3(2ZJGF1pnmy)D)oS(>%ME&g+97ZXSn
zu`$z&4|*qozD2?}bY)vV)r-<HlV!KAy<-Q6+#279rXq-8nL85p58q2TXRVE>2-7aa
zlJm1WN(P<u$B+;tQg+*!Bu63l#TxRkBTEK>`t6ASg!q5KKT4hv69iFq+na#lLhMg|
zb`!~$7`rXOvus3frP8#j?^Bh4K{fe>L3(XoCx-m5+X<y<P2V|8w;@_v66%W(1)YAH
zOYcz@NmFj)W-dccYkvbEjemh4WD;qGNw)M2DbkYXr7SRqRwlq0FMk*+$AvG2{Hges
z6DdI6cbpEL5avU+$R74z5b;lV0P~?$WDf^E67r|=TTa9PfbVA(^g);pTvS5E>$UJ7
zp2Z*lO&wBr{rix-x@YfoU;aF7=7!`qMbITc9bq`PZf|lH?Al@2j6S(yV*ho}5I|Dy
ztn8MDz|eD-O)Y%_f=>(DUKuop;gJ)Z3~R5ratr&8vsc|}sw`D`gb}YQ_nunn4;GKD
z{g+84DY_`k<u-7AeG7}qGEKG83Kas@EGqy7tS@9!)f_D|4gyy#!TT#D`M!lV#qE_X
zeM7Bi0%$g046^y<C0+<^DdCQ|mo|5&Ws(V9ZI>}F-<OTeE$u3k-F3gt>z$MieidLL
zd=fC7DQJB@UrDTPYF*R4?jE<RKQkP8FPQcnftz*C_KvCQ%dPP4f&g&cG&-+*dDfw2
zJ1Y&x)egf=Xt`M<niu6s>M?`Hx`969T#AK8JP<CJRQ7iNp#$z2BhzND{RS}QRg3=w
z1G*M}<Gr$Vy}kZT5IIg*tUQXyBV-#R(Klk=851{zjuBld8G{Ckt|cX85)va2#t2id
z>!XD)eqa)-qQ={}Gc)VorApxAYea@8A=!q;LUBXD8Cg$}*)T>43b`;8h)5sVe~QRX
zLEhIih-|s};^)B_CF1r^c0sa*BYougDUxIFn+z^D#IhA+;oA?c1QE$ZDxNz6>0=^Z
z2rDzXrp8+uL*I}t$jWkDe_ce|w?`5*-h$~TC~|mG8O&X*x>SZupSm2`5T?Yj^TMf)
z(BcuW^*TQq`XmRavrc^SX}InRi3vzDj%TI#Xb7L2gJGB`5uoWU9~)w~3w^ppbFXHB
z5Hg909!UK*<uhcS1%juR4&+4(H1ZTCtBj0+g&{(+6JFV$Kk9Pk6crW?u!HTFXUZJq
zZy^$oj2t*9{Oez{Dio?XYZJchFXmRTMS8n5=A2?qU8ZS|#7||^Cy+&(YNNpVXV0Xr
zNUa=Q)Qu+k92hm*96STTeQC4q((6+dodq*Y#M_wE?kApKgl+K-TijheYlV(y!>{#M
zxtCs!A8oYNQZdn(55-?^bnC4X1*{+QckK_FKy^=n?_0IMbCEuc0mdepGBO_WX;-cY
z63HLoZ?UTs^77viKEfp7H9R3InCTNve%X7kqqi~C>X_r;*{bfkH-nr%Mc=kcq_YZ!
zTxqhL(-qlM1vN+SZStSKnt3X4bWeX#2!i7w<lC+1+g0{C(|%rP7dTA32WS(v6=Vfd
z)VJITKdq^y!ulL8rvypjd7IxmM=i;1e?f8BB;t;x;4_bQ^6zfyG+bG)w6W88Z+8f5
zv$9_O+q#wz5znG5H+34VY<9B`tba138uB+Wq(Y+9#2?uBgey_S8rK`k7zIY*l$tbD
zee^S-73G0mOea=``a>WqUQe(~@g&KA0_A_g&2Qux>9t^%b!hy;3^%f!(<s21<i7(L
z*FpU;B=#4~{1a|);^jAb{?5J_*WvylS<dV~oGorVjg&3KmHEP&hHT*~*NuS!g#y!k
zmL6nGsO6pJ^x@$R)fF*TQ(6Es?av{pJ*c-2`!S}x!R2ovtH&BRpIUfN5?OPApC+KB
z_I-1%O5-QDbFc`zN~40h@%}s~C9TLWiGX{ul)J+Oc0pwVCMG53n_o1QGZmCHf7vIf
zltreAAo{tK9~ZkeoO`y_UhN-cq+Ab6Rr?DUqcul|JE;k^W6SZTj-W20NvgIE{dlJ<
zq;~JDtA3o{y-P7hR%K?aw0TbtjRGTv2%d9<d{5co>6_m)G4RKxu>&y-7L02R93hJ!
znL-BgKzNpx!Gdk_6I;d;C)KVCerwyW-RDqo+Z~N7-0)R;S<I~VzIb4;N!>E;i0gyw
zxHVZ~Dq->N0=Ir-esu6v*6IeWN<u0mQgH^b0MJStoq<?0k*=lVR{!qZvSImMS2?0e
zNLwYa>Sy-oxL}6{;v~p&&yLHnfsjup(oEvSe>VGVX?CttO-)qd?8GFWmX@SU5|s?m
z+src9>6vd$gr6NgEN+oM4+UO11^fUUy$*`yYdXW+!^G>exrGjZM}KwBfyBuQvsMim
zrOmX{wVq&LbkEf&4=kXNgjbY<j-?YmMWMm@(dRdP$Dlc)8z@&FHYDxn_wLjn*_=NP
zc#Fp(pC`p=eyXY3&rfi1`_A6}>`^OLp1PTywgOSt4djD`+NvQ8f}QBkkWQf8z_kr)
zpJ&!(#_4)jj3#c(5o1%0p*v6ULz<#VSdx?S<Md2O6XDb|Z=RK%tZt;myHE>WBP~=(
zU8kA>5^I3u5a<gpF-j<El7CxNz%1KOC)vGfX-<@i`Y6pYe}YO%&B?=0iC6A%)UBwd
z_NBD6nO_x7KK}voQB4O5DHr@!;#qmG8D-@KhvJl@0l}J2`vYuQe_w%1$#;vOi$gJ}
z$*LRlQYoFB+7LmgSEfN=U=y1Jy~*#xBw9xL*uE;^UR0(Z@1v)ldSd9}an+bM23&f{
z{j%)1ShJF~;zsPfrd_gly*pQ>uRs%@4hr_SskVMBYxFtXDHlFEPfn-qR9s)k+dUfM
z^Op-DqJ4@z-|Ibiemw#ukH9an0PWhAf=z>=Xf0~VoVMFL{ns+NXp;rHw|E&3MQAb=
z$7P7G*r8gxPg}c0%Wdq(iDYSd1j70gZhsv)K@tr(rpA1Y00d$YQXsnbnQpuv0@x&)
zE;9}_XeQcMGwzyc{u*KTu4ddc(;OYCibyp@cy9&GhZyGP>xTnl1+O)j)B&Hf&019C
zhByhpXOdJ@irLY~*}8k|!d7(%8$haSf{pXuMc(70!8!q*C(CNPWp|AaI6AVEq{~X;
z<z`bJe`)6DOUY8eA+eYs7I$E@*iC?e0gFmn+{snkXm-Bwc41M*O;LX9fyIzpk!5BP
zELd6zzwkm@Ux*B0eBpi9#P?1sDy&Frf~LHn2uHOxuV_|f=0}m%RI8SleZrOg7JNXl
zm~uf;0r@nx%^O8AI!kzQuXN-SRRUrYMSa?XLzQvjLUI*RptSC{0;HI1UOp{J$y6Q3
z-H@VpMel0SFjZAmX5zxcyn+jmK1=n5EyB4i0;XO1rxLSoL^BfoA5azX-afFEp9S-*
z{c*-gOL9w4?XCTls@7fVQ9R09dx&};D&!aP3I2nN1CiE8ajLD5kWc9771lo_2rG!1
zeQ~jA)5`n`LOzHn!eSsO`bpb;p#F%0ipI5pzKLH;vQfel2WY)sb@yqlU2S~zT&o{j
zaT>iZ8ZFZuv36pTt5r68KQm_e)#iuRD(<j#K{-%!Zc<Bgsb2qeu?cm`la;Hn(&pE)
z8wwN0;NT$Noyh$3lMl@-mF$sz3TLJ5WY0lPsMJW|emrL-g@uvoWRJHL7S<2tqxkVO
zBVfP|_9GQ%{yZ%xj^RdX&$3d%NFB>Nx;HGROpWR(CLE_1ys~cTrvpoIC3S}QAId3?
z1FAGmwd{s&jB3A^g~h5;bC#-;h@ZbZ@)gC&ORnW?gE#7OlzOKaKWfajKc^_mN79>f
zsv)c85C(3CeA6579Hd(5j@v4<=}`wcQ;O*|J6AGVd=J!I`T9x@;03J(hyD?8IxT0!
zlkFe2(q|H_k*1KB3tWkm<>+g13filSk(_mOK)vi2E2l|g5hq~4rDFQk)93V>)N=X7
z5p{K{Wr3o2Qm7(^xF5=~cHh-$1%*|9$JaSF11-&k^#+SD1zx*OA6n<Msqx7Jth^+W
z@z;<xNtL@-V&VN^2_L5ozrx4blmV1@Goa?uJZEmBv%GlfwM$89>NH<*Zke~5wb$hq
ztZ>hZ+=v{CaHRUGgtCM6;c!zOjn8pON+buNmZf<e=iK|6x);vLlAy$D!c;<SbFSIP
zrG)hP`RUJUvlea(uTPVurly7YK7>-zf-<VPFS(+*<hfWf*)sWwGzs!7Gl>V%*SUqc
z7P<Sm1G)6M)zVD4vy(?k+7>6|Mez@T2Suo=D>I-2^&;tO)o0a6K53HDC{?i;+i8RY
zY%b|YwOY%#A7y3*)vComvUiFur#+oQn^bi3%2d<~t!A7oLz@(t)WH)3Tb63&s}*xu
zwk{TMfA6cW8M6kiwN-dYJzm_X9=n9P*R(vZ-UKhY)Cn)V=sbEH1M7Y01wD_fl;Glu
zC{z<j`3I$DV)%ll(UrQTB5AlXR7eUXltyw!shuzi#d8v4wB#*u3Y~Je;}&HP6mm#u
zuGK@MnI*SBr+?P{yrS6pSvBjxt42#DJ(yCF%`&-%qZQwmkp6rjBT_<6WJI!5qV&6K
z3)+hBLu(IH#!6(9`bK5OO0c`g#*}~u{xz~?ea~jgyuZ8DhT51Oxvm5s^?3kb5@Nrl
zAX@N|7kv2;P22j}{mId^^6Jb#2QRiQ^y*#cu4`q`6<_Gs<yWZvNKE~M1+z(Qs*KYG
zwaF!_w&7|xDcdC1I&=O{rwI*P3&uJ6Z=dP+$Ee!|4{bmB(4HHO-Nf#{J)hY&L47-=
zxWOPe6vKw84@#kok9UnVkJ+a>|1j1Rv;Xc~V9Y&cpZ;8D%ssv^=FW30%;Z7J^QSpf
zKXSqy#TaZX0pmGL1`0Kn%<|5H9Xlme+kEwe$*)hIQRbTivI(xf=1y69H+Izpc!DKV
z)mqaG8LjUQsL{$}+{C7rw)ej8neH7<%w^(bm5b>6wV`{FJ`i6qUddh|U#VP~ToLRc
z>{afqWhqDiLtaoGT(2tkvd5n%ye7QH+dq&+31L4YU5V}iv#a;uODE{BUiR48*Wwps
zc97VCG50aU9ww_2uc%&74}4cMdkhmvKUpMz(HX%R{x+iTf9C(p&!qjSAPEc-!tp|U
zpt|~h*!rg6T%v93*tTu&*x9ko9ox2(9ox2T+qTUw+_8;6_n!adRNd-_UbU*LAG&JI
zt}*5qV?v+m6~+n^M)RZSMAwKA{{13<V|pMy{r*iDHd6?WpSO6Lo8OHoknox^rEbhm
zde6vwo#-LHl=(G~X@0$Nev}rT=8!g@7N54ChQ$KL0>y%)97t_Q!_>{h$F$9)!vty6
zcgTcc#0296R08@2`M`0?IG<Y}Ak<p;9qtSIN%Kbjushc|FQ1?L`&vXGz!#|--Urc>
z#S_&N)Dz#7*A&ha%@oWO%aqEL=@@GYNJc;gy@aELvV^CEwuGewwZz{c4JonTdFUc^
zC-e*9lkLsvVe}Mn?z&)Cs5itHyc_Zp?+yEb;lbz>|Mc?oeO_x`YtF5JqhK}iEmTjy
zis><}xj^@Zzj|bg;VjxQz%xKI;1<jXN(?!Q2uqA9NuR0z7Z@ni8?p-W1I4N2Ty`F<
zpjm(%7&wSH5{fYtH_Aomdgv>{J=?L<)My$a)3xEwKv#$dcq8OJ-ZAzR!<11Pe%fW)
z`!B6uT1;++>?ljfGGtidOd0xQ{q_NA`cVBu0e`{Rz(fOJ0(8OnpgNG9i8<4N0`UHl
zGl50y0R<qW5i;%S_Y8SQyh1I;yiy*+PgSO+GWiW&jPM3~fHb1sLmdlFvHt|mPN&Hh
z=-yM<5Sf#iV?3rjTVVIYgK?l%k>d$*M%k0?YYebJWkSyqclqDo6by!UAma-yrJoX!
zgx!h6P?0c;SQNyFyra4heZ=4J40H$Sq4<iu{Mru<x(vET>Jfe6-meT|M7<*R&avm%
zUkvJmBBb1se4*NR9e{*tMc$Ea3%+3(kPUJ}s-b+4cc<N-4x)uhMP?xHiYY6l(nBcR
z5kW6d^Hd|_jyN?}r0wF2IW;NZ6PZQ5r0~oz$DBV9;Rz=o-;jF%nrAQY3U5K$7HtYY
zMJRX_u?n{(??^WXpJy&87WvYR497r84r3tI{OwFU?_J;_Vk6QRHbY@ak|D>MT=v%-
zMUj3UtiVB}6eXI3JKdaf9$G{=JcjZvc`o(rl<mh~-ZSEg>f*!oWUsjD!3pP;M5QNr
zsjt`rwkf!lU+|GaEFj$Vh5SzcM0;Vj=4Y@w+7sx5`i^)pxrSLcYnVIoh5n9tQMeXb
z_iS)I{PQ5>1^(J*U1dFokzZ&xuowQ5<wf$^WF4l_?C8wkOn-}hX5C_)a$RCwsge9(
zP6Qvg7fOSGQphJkC+0i&6Y53i+H;+qk>2PR{yWK&$AzC^?ht>>C(Dz;1?ZZ9!S%>a
z@F(As>xJe8{aW&x$=Z4Ssy?P+ZJ%yHH<A~@6W#^gh0F!qh02BT1@;>BTK(Ftq5Mcr
zn7N|wcaqMJ&l|y*$5EgGeLY|++*)LX)GAJO4CYYG82ZPA4AYMH$6wn&E3%2WT7rcc
zp9{5I+%o=l49gge83a27P85Q4ln6A=R|0(j_g}cPcn3*#yqpBE!x-wA+#&LzpfRo^
zVgvSikoE5s;#LxlANOMMSo0W3QIK|ocF>ggF-c?m&lM+D1Y9mmL2?i`KPF+!i9#wI
zCph-I2!fgfU4pR)asmEd0A7^;p@<Hkx_-=7(RVS$PV|*e_lZOR;0hq<=L_2m>4a>>
zZiQ|IZbfjTy`tE1+)~<VZWC=oxl-B^ZF_BNZ(DC`bTHe;ae!~*-V)j3+%n&i*s|A-
z!VSO;!VRnJM|VJP(`_SYvu$H&3v}3X<cwtD4CVn^1#Sgx#dj01rL~2<lG_s7^4!AN
zqS=Dkif$us8*Zz#Pd&icW9Z9{v>I#%WH>B3m;ufln%i#MezhsKA-5T{<+t^>8QFu{
zf7+|I?X=~zUA5J;&9uq2fz0d+X+x|cw-PoWw!%I)4LNXKNp3Y3c&8q1I9vnxQI53O
zTGf}12zmy57%j`q-bLtdZ$Q^S$1EFCF7gXjQWGy3EUQCpjlB}8lid9=MZ>LlRpP6O
zz3A5SjYku*X)Oa|b12W)5%0%zscsc>=;K}_5HaJsvo4qwal18$&s-5F$9F_lIF5Uy
zr)-grGW#w}8??sx$<A;X36PIAM=o3&c*gmu&omixh~LrHPspzJha*u4kM~U)2;)9w
z0K(lbN&p4|e#&?F^=tC0v*Fgmi7{$LKPt-7@#1mOL&w7ptDOVkLDA3oK_*Ai@n~|6
zj4gM^9?`AiLiLD_%|Z0T8j4nxB^})t%=N>42uIrSYGSv{GM;W-=_^;q%`v{;SNx8M
ziC$4#%7;0m&nWHB<33VXu#UO$o6=W2KTY;c@t&-YuS2IpL==}m%<OSOnV!lr+-}aO
zkNiVFYRhKKZjtJ{xy+CH!_atv;16@f*0(vTJEJjq^6S>=Bi+`xTuEO94*|x>E?ZK8
z+z<3a%mh8U+j{<{un&~G*~pE9;l@KfvTMw--R>9vk5V*EDptibF$0)jNi?}qdz@fp
z>MWssG8jsQ7q;L7Dm>YJ37BOx8frYj{r{i}lN7Hw)#c>SOlhbbe*^}o6JNL8Rjy~3
z74SDfjyYBdH%MtNDQXdgpU#HG@1girDk@~Qz$nEy#U&AMFk&q6IKdz!<RoBHU_ucQ
zVSWF<=5U}6V#4WgaK@kMQXOY2&!1116<6KQ8&=mezSsgovw+f@(gXRy+yDV&KaelC
zo6-H)e!^e@6hE-9;TM}1;oHpH%$xJucYyed=m)PajzGA8c-Obg9^<GV!Z+m$<3a6+
zpXdVw?lzHUw*lYR?Coyfck!uD$}V#EXq`A9JVf|KoGi!sN$W$NJjc*g2+$KUdn^Ax
z7C*CayB2RTKqd;A6<Ln)soWh%cxgKHxGu`BX$sjtvMZ*^csS8(_Q}L32?Qdpq(l3J
z)I>b`H=lPyxN*D0u9!pk0$4gd`8(5j$Z5532G%OFSG$65>lU#G-$7}z)p&1J=a^u1
z30tyu(T6&M`j?VZVm|$b<U@pnP)T3lL<4&3fN%d+kzBbx*E*M%Xad&O<h5GD^osz#
zIz2!o9bQNw;PTgdl1lZEI;8|#A`Z!|Mq_``2DvR;rv@MrZkL2j=z+X(Qq<2fOfnk7
zE_WU4_6cVs9!K7ixqMS{nxr{xNl8gQ@hxnLSgDutk*j?1=Lpxd-8=9(P;28~`EGe{
z@os5v;kW&1``5N<uk4WMfa<`pKXOnr8a)_2?1Sq@ZcD~6q7#4{V>PG~WYrHpz_yQL
z4{MJIKma@)@DE%LU-oxLZU%ed{?r@zR`mZAvu7AvdRw+D(f_SDu@19)IRkv*S`qK+
zTZUW0ZG#0Tl=h?cqmmrqA<zqfBKIM{MOvbhrq7WW@Xrap{ttl#<gl=kj41SJ^vLjV
zk&=w$pK$+<P<SS3$>nfzD7zybTo*dYW;A_MA8Z$TNj|NZN$PWn?q$Qhussw0Mv*Rx
zvl@5=m`5A%riU9-Nb_z9L8fbocBXBUZ>%$gPVpJD$NdpEg-^#E{|K6LWIi9SBELsT
z#~iCdx-{;6!%Lqo&|~2dIVMUkEYNGcflfCv_GSEqae?&6jz@V9*`PC?!>E}{be=e!
zK%ZERsyg{8N*m(Y06MNK;!3lQZG4ijE#}J64l6QBKITHXD*d3@XeCnnD~j9=lq+);
z3-(}K77gEq{m%o8Fl77Y*fa%)xO32v$Ke%v_tFKhW6N3nx{zaRoR`W2GpzI&AF*fn
zdaMW|JFlcIcKhmhH}S^k9fsqkXr*Z{QZyXT*d<A8>=y9+S4wQy3N}Lgd(sy4{9g=y
zOdHlLvghJcq{hX=nedJBaW{%@_<42~tyF^$+e5Di1h#Yf4Z~AWe)0|D6l5DF&bz<n
zjep|3(?9GLH_t!F3k=)RK1>d4QJR^@^kl!d?+(W0iF*A%1`Af|?_$F=M<*FczSGKF
zy1Hc7Jym_FUrWaXNHgl|qPlDvlGS%Q;?VVc$zPWbV-vsi?n*^_=NN5ns!mTrSiqp?
zza^2Jk@*ZxW%eX_`>Q&K4&eEqJf*w~)8*sH>##MbA-Mt~P9+;FP920r6c{aCP+221
zx541ST-`e|nvt52*Q^B^=YFOl5U}7%+GF=qfmDXc)9F!qE-}UE^9qKZUen1Se^wiy
z^s@$RlDB9Pr-?Gf?turSimsklvNy;*?7~|?`-<IUoZ`S{LhX>bYdIHw$#AUqF$83T
zT_ay$>e#;Koi>K-BH<CgWS_$5SlqUq#=_?!fBfA;`+NC>h#J%)5sN!RdO`7)mM;E+
zSP+{Leu^TDIIt7+X8^@OV1Qy^KFA2Vmb^*2Kf{7k@&R;EWS~5Vg{(yg%1qkY1!IOR
zOW3`2D3ET7JWKwCY5yQ-QlxcbuCX8!ULKWSzD>!wG&mP!<LFMhF%^0hxrTh}cU!W3
z=4mJU8$|xJZ{|9~Kz5LqNOfwcm*_6XN5qX03^j}e%&%a@f=Lv#ngXVbfghh~<g;Ij
z9m=(Q2rjj=f`)wm%9GTjt64OwbxB?HfGrGR*haVV8YTBcUFv`@j5rk@>SxN)cfk$x
zFah9`OR&DwT@Ra~=u~+sQnMHx7A+Y-H~$ag3aL4=jWZL#JMYJu$>>?R?}dh`piPs5
zu5~MUTa^+KtE?^N06x52u-n|Fwgl7M76R~`UpK`SHN(;^e(5-sVX=Z}#cfg8lAFir
zCxPXm&MA5k4~Nuvkuv1D9acvB38tg1$KM5DOF`dWASQK$nSI-rvlQDVRW+_#6)a^Z
zC^#m8NU2JFihPfYy(=_0*@v$Gp8pd<Aw{1QqTHbZ_^HPf4jh9}Ql!+=d9309So&RA
z3x?v?B!axAv;}b#zd^A}!`48RpXf7#@M`Jg7^$sU`=Eqw_o~*Ub7~GL>(BPB-yTdy
z`6!zh$y!vcl3Ux>Z9_Tv*>}Z&Ki5>VsI#8puM88<O1dH*)JG;sxtOyA3P-WSjUhkd
zDLe#@8UgDFD%|02k<r<O3&~RQG}O0OP5W_Dgtu2u$LV_XIo;MYMrGdOhUY8Egkf&6
z9J|KI$)RPu6!k9m6R0R!r8RWLcdW@LLyaaCyuv2I?k(cUs(?SlDr!o9=yQI!nQHfz
zfMhn6l}NMqKkHOEmxf1dw-+iJjIq{wRlmft!#hw^!+%n?<hoXE%<+EU!nlZXcnOj$
zWd`|<)zdIs0nc!zr7Pw<UV+z8qh;h3>a1?i57r14i44yn@{BQ09&&{hXOyyTwSNGa
z$0=|@*_1`MA@a;Vg%7{f7tso9k+ybocz_MR%!zhIx+LNL?JV(-bQCD^#M%fF%TLTL
z_OL6Wm#5kUj32ZU${(f4^ZpHHIXko%qCO{EU^c~Gs3m%-eKtFfUvM(DBepB#R(PF%
zoky7WKG%H;{6OW2@=5xZT$atn7n~zDTVPgaRksmrX;wj?%9FsucTT#z1L!t66=f4;
zBh6|4t|-J&ppP(vti(~OR=T9zafS6MV~=>QdCqzLed~&wQP!fcE%Yc{0a-?nKMVh`
zF14$5%9GgRw(zX`#_-d@dxOv4<ymsge*&@eQpzl85xEqz+%0{ga;aX5F0iF@Ni6G3
z?%-OY&$ESo6fW~i44G&B$Ox%5=al|tc<>AOx?cPi#;Gm7?PT2%I>2XT$h$SbAuKGH
zP$tZPSXh!<gof~r1x94r!vg&d7Cgs#Aeh#%xRSdMW_>PMpT}FMVqIP2O*__s^9@U3
zrJuA|mzsQsOYe&_f_sf3F2$mOt2Q!c5sr13R}0Y@uS3Lk^*5lzdLn=7vYnpSlt0(k
z+%)e_TA?-Pli5Tx-;~>gY;r5?#=OMdh-^Zv_&5K{X`^V<beHq9B)yT_@?<7UZPCVd
zbecmxcU_TZSV(p{t$mRPj`Sk2Zq}pSiO-TdTYb?&NNZZ}`+?J~W^^}ZnXKevdu*u}
zNI@DD4DE+<h6182<kO%x^P4Gx2LjT-1p*@e*)?&rHnnkPG%>WWW&F=t&(Xxl&c?>X
z)|tW3#K6YpkDvACnh)h8Rc7ppG?sKdqXWuf{9T~p#T;_tT7BYNLUyiPLF9pxua2>1
zfekrIxrB=Eg=;nAs`eu21_bqn&}BY+&AI=eZ6C4d-_Lqr>=4{J;B%e7AoQAfZd9(I
z5O8bzAvS#>mrp)u<cSGzU8j?bz1R1j-hN%;{KtpG(uHs=adI;<*|`lTqgW7phFHfX
z=1H)VqCCp%4Qln~Y3#OAd>)O4NtaO;M{re}u3SHX)$nqy)g-ygu)*YfUY(OP|J*7d
z)Ty!m%=juW2aJ3wwGS|=PgiBPPBHkePAA(I>MM->=H2;S>{=i`gLa3`Bk^7CoEqIJ
z)^2G1v@@ewQhg#@*p;tDb9fmg-7tVzRVAkr49Ajcp^c=~Yr|?&$8w~*qe~v078PN0
z7^mYq*O<h?!q8n~Em*4-<*#~H@Q3O|=rMQ7afj;A(>yM{LvoHP<pPq}XPtebMoMF%
z3ad}PHM&nJr4T#7j|KvAiWb)~1s;I~jieUyrNo4o7VXh`eL}%YWl0*>VCmE3L27uy
zvnKl8a|Hq85mH(#FD;nPB>F?Au>Y6canyTXr@3If%w&*MvN{da04#%`rmd5-+La*E
zLZZ%5L#1bXr(EX(_{Z-}BQzQ@(vG8m;!UWCF!c&<{d3cpT4^<|IK8Wx%$9n?BreSw
zg=|0Yw?S>eV(*$t28c_`a{atcPp*sVLe&`s$9SdXnWPCZ2$aRD#I>JaerIFCvg}wo
zyoii670wa*ATkFRm70kUg!&vU`)xT<<+Im41sU&w4RU>do&l!Dba2;dSsDk&(h1w~
z16s9qv;Oaz)avM@*pm*wwN)ob1O(x)kmUWoTO&}L);m*RPcFz-1LP9@zrSQ&yoe%X
zKCii=n4@H?G*CgidC1ky5==FUDZo7urK(D1etdJDAHuBd{zHiGY)73L{R|YysL_5{
zvJ~-HvLw{;A~0{ag+Y$g>2XRw{KBV|^s?il!J|boeK70gr*HgX0Wv-EVqAr&qU=6d
z13X3OuCk(RV5F@77`ZCNhc4LiLY{_Xg_6d>(rAH_R?xY20_tF_Xt`Pdtd2~iU&vcC
z8Gxi)DNP5KIs@aV=?6^xis)S#ip}3ZZ9A180m>9^HbZcYG90Daf<)^Czk-HGG!@oB
zl0_@<eLk7>o8X6~wxC3@PmHjDR`J?*xp!cR(%_4d*V6XsAqdep5T!(j=2pugtx<<-
zBy8f^<M80S>8@sYv5!RL2RJpX9~^FXBx17l)KZSY<(o?=;n`6MDUUpJ=qT=`a{gnv
zL4yEKjbb|GL#w&f!m~rZfpFqHY+Ku)561!drjlS8_tidt1nJh3xF}`w%{-S-VFiQt
z&mhP{`fzPaI8A;dgf&3IN;<@{ZwTZ@M*lS~X|PA1&s6-$CBqr5LBNXu;R&v2_$sSO
zv{4+#H2J*Z9!`Uvf>=ogVoxlVUu3Q=yqy4MkD!v53Vc6?wH{TXK*A>HiAqdeU3|6;
zJ;Fn5t%zcA$g&S*147As1A@R&S%f*SKadrOcL|}5xjs(6tA1egI|%2w@{pVeWFmEB
zOwArsw#-=CFzZ2-nv2_S)idV&b^DUFkZdLo$T7{<VT!zZ9^H8*=Z$V=A43oa)8VWx
z)s-uIlK9Ymy&{3XC>S{mluZ{x6FIN>5}(=MR|EnhZlM-B6IDphISWoCb|CJzgnwKd
z4nbkOaR6}YJCK+7AmwF9$RcMq@aJ+^z!NrR&HJwI!E@lEuYHFwZvj)mm_)$?Cfpe&
zu;WWWQT>O0G$C*%y*_EVG1T316&ev-bfTcyE^*-JELlTd9CdV5k)(C}h4E|l421|p
z;egsKdy*814MX^X1i2#G0tT)YVpS>EGW9L6-IpO0oFQ9|tptZ4u2U0@qZ@&5Q%xuZ
zxjI#+8LJA;aY0>jq^Lrl4K4VonD9RgH}j2K_qxPUkx22m3N~Gr=8D2>2!h2}(drRG
z$BK6uXTHjKEJr@8J+9;JIwI&eAbK9;;HGXQh_Sl5=nK>q)IV#2PcVVTu|)AYbiK54
zu4cjcaSdyyHSK9BARVEf&bU02$Q`UXRjJ%txfo;&C>SABs8rmSkK4r6hkqw45C9sb
zU{R~d)z|_X^Rjd(uHADo*Z+P<*1-XwK1nkH4<Y4L3<!hBSP#pVR?>xEj0@b&2Xe^T
zMfgo01Z3-hNse*HK>tL{$f||oHvgt`jQKdA<Q6_!449rjrk`o&lKF5p1=t>t3@EHA
z=ecKH$Tt@#m6XqvEoLhQ=Z9gs_>Hp8IMck3&zJ}-ugCUY4dQQSU1>kF>~tVDE%_9=
z40Bcn?=oJHWgwAL24QhAT#$?gZ5u1C2~z}hAC?gX`VyWV7|X25$3P9*^MM=yanVub
z?aCoQ7m@)_UJ%hWq7Dc$(~yPT#o_6{f)ZOOO51DF0F2+O7Nx9atVV@v)+Ja|rQRcW
zSKHYen<7`bs2794PH3mh!+;0xuSl2g;doC^ocaeLH8;hnkSS?wu;<f%S2J>ZpO&~M
z+eTPL%POLZ<+I>8{S*FegGjN>m6n>Bwz|RO<Baf{u6Gs}booVwXG{5O)jRR7v2Dwn
zns`;q9Peh4a{+;Sm#aa&t9|=g96K`cmP-&md`23|M}v;D*|GW{3{^#*d-Stj@0Mir
zb4)yYLeHl5LxktnDmz^7I&OpSYe}vpaQhVQsUr2<R$$fWl8S?;(721L^Mh)XFZMm?
z{-gMJWVW0BHt0~bfb72=`vTG#C9^DRuNciIhibky?UOw?JA0nbe%aSqGUrC6VBy1L
zX=7bZ83tH!{it{@gDh>7m;l>=E;^ZnCi^IDw3xw1Xh*TRF$)72v4kuXrM%1#E|x>G
z3zJj>#7tzl1dFv^r8+nAU}gJn*3;QIj}&?C?xw9BY3hx(CPLz}<YSN?L3O$EdPg*k
zz8!jl4PY%B$jn>+qimI=tU%Z*-s_LVoMFdFL5FEmq?2DfM}nP~qS9}3a*NO3Z}ah*
z7+IqV<682=ySHYZV}DGQX*zPVBKgf;8y%Q4Jtyu?vdSVZ6{iQJtt}miMfD8Xg0<(y
zJW>R5WtMk!a^GUS$CJSDWaQn*j9|>^HjEjEjN#B8+3j&IEz%;D0tTRWmG3~n<x7UR
zPLA9IY_Xk|1o68M4*`Lm3>0mi!E!I2mj#qAZe8U($I?0*Mrv1a90mzia|OqYUQ@KX
zOVEU8<gw}7&@Nk{+$X<kJrzg2%Tj-4shrn8)HZsQ#yoGFzeJ4A`_vW+^NYh4kSxnr
z+dF_GAU(`^q7$S)Jmc^lpI*DT&&}=P)>)ojSF(Kp;|0zP{5mzwGLFmZpbC&OVAfeM
zqwCc;_y&ub`5Rx8Q2e&;NKGdBzzK8Wz<C8xkii7|p?j{jfTR8mc2jE4|1Eff7AWGM
z8QcvqlU{qjP%w74j`NNFTL#onjvT_pB#8Cjr>}eU>cC7Z4iNeq&~4?mQaE?M9`Q=Y
zFxzuT;Sp=|)f>u|H>mbASgr`CTx9UMoj2ktHXV#lmOU3p3RCGwFEsBSTATJkF9h%L
z-_ZyuHR{-91YUN~57HZrgI$z>Sq#IBdu)&;Ukq6NCzsG+$Ru!0zen#2az{22>*KyP
z;=5?>c<*Rnf>o@P-r~msSO9EFua3H43k(`e)50j7Ue&E#;2Q)J`)GJ@%z(lv^#i`4
zsGmqxa2d#YiMSPP%!-<dlo<9B>IZAosl(P8$~b-s<FcSF$WyjaQ4p5t41-<?;n575
z^uu$lzI70CfS^8@wnreXUBLV%Nn_1NLZtxW0SMgT1g6$QbUS0G6ZKct=qfG2CwlBx
zhq&K%p<nU@%QOC0BU6XIwv!EPjm)=gf12A#b)Q71BZ62j?X|sMwnKxZ(v%Iu3cR{q
zhr9LadaN%`W-DW7y<OY4oU4PwFUW%@sCU*OFsrH56L_ssEITEN3(LJ6^Rzdm{xOpj
z`0bjM=!t5rMzs_}-jI3W@7;k%x6<JgF7*<3GoADeTL%+pv7uz@lRDbx&RyO3N>o0!
zwbKdQt#_5<66;Lg-0j7~s4F!Yady#TN>YK3(jIwV>}6d>@1{?`nlHc#J%!7Nc1WjI
z=F|2=FXvr~M<#SkbQx)3-0Q#MWZvrK%*s=Oact>j^pioy<EztdS+VxG`BWO$KeG#r
zn_QqoS+yT%jP`bs7A7?0pE;5O%&B+ag;~_e)m4h+3S^s9nD?eVh9`|peT^QAKqy}6
zkG<D@?wK&|kOTvR?qGy{Fa*Oi{6UBZq?{pc``hk_JCU&fXx{MH{R7VM(i=GbaQS_f
z7rdO|69*i<0Vj6?z5dmk$`=aVA#U9fT6gr_5mD>?@8R#z-Xu`w1TL<y-oLveyF<GJ
zyCZ~v-qGuW-XXia&==}2gfD_G{x9G!VqeH_kng~$gWdhzgWjL{>3)NHdw!#O{XdbZ
zBLc&IF@C{*(bos!FZ3UfAJAXoAJQLq-*De-U$`H+FTFRr`+mc!AL1XlAG<H3%<&u(
z1$ZOh0eXq8<34vpzL=>;^o}w+q}Pd|M{V8;{A7eFv15sMX}sj}lPq_VuUXzOm<$3`
z*i&yA2nfE^1G+<1moEthUxfb+@%DTwDs@nRfFuZkfbjlri05QvVEe!5F8Gg^HLkel
ziKE&A-85HiQxo-T`_qI2dqZ}!<YvMJ8Ld(SU@Zk*Ivl`>AQ?{^&MeAIW-{#2G0vAY
zs*|OD&0Z=J&IoRKs8D2q_*n|R^?-2M+$QY!J5u*u-d<GUAr`|TvcUW=zb^|<k_CA;
z%*&XaY0vZXGzSZye$nhHRA_U1X>6`Me+2Y1KdvH3D8JoBx0<zaZfxnkow?G(rPg(x
z);NWxIp8e$Om|c0YN4r=-7=B@yqM^mN{#tQs$WapZYkpE&)>?Az+>7YvHGsl=4IUW
z5X>5F1v(S)QN#AMQA>4S2KC7!T;1v%3l-*K!|wSJfip{Lb-N~E&l=v%{p2q2+AX9B
z$0NsL&?5amVV*}qB`V`5IKxuu?8wdgd^@LQvmT3kHusjzQnK09DZBtx)23m^{!HqW
z?f|uW$6&ZDt0uN%%j9DF`hscCXgH3t9kogH^BjcSHaqN^)b|AsX*y<>$fHNL+IkII
zv%6$)TZ8SmgW`6>!O5k{_AYg^N@i1<=HSQau>M_G-S!;<@A6=&b!AK%Hu;krSeJC7
zlx-_Y=9i$30B#+Nsb)wgn%u~lqqFpe)*#N5ZWns?xK4;`%gk|Nw<=wF^!RlmZcS3R
ze$=ImG(8&jWA-pE$+|O*P>~MUW+^shI!xSQ?eb+=zPdtACrR#=U&<3~7>>*4dB4)&
zo*&EG#Y_Z`3~V#0RUM;a4BPjoJ=q+8sVlcr7b#c-MY7<tU6V|Jpp(DEFKWhsMC7F}
z-zO`LPjaYTD!;8bv=4Vt#f8mL%#{@(fx^rKE9t<+No-q<-C5?&pzGTi_g7AP8Y&Lg
z?NE%I!{k|lEnc$O<vY$tw#Y2=xS!HQ!cSO*c_AN#mC3{Pj6e=Mu2+H!hff4tcC>F8
zpITzGpJytEpM|Po!>!P(!E%)gC<!-!IQ!%`sN_^1DKHr3)@YTXVMr68O{uInVbdEK
zU0VWgwfixidDJ#y!V^Vn!Uh}411$^p?~40B1AC!wuMX<)xD4|Oi2<(u29^g#9OMv(
z0N#$%2$V*AD7RD>ldF8!_CHE${E(Od`R7CC9DdT}Z?<jcTsrMr4OP3^J!i3@ow_W^
zZrk<)`0#%&uTCaHec88MWYuk}KEjLzq>#5IkQb$pDdR~F4m(V=<uz6%0}_1!>Vju9
zx#WN7kgK@`qGBuScMj{UWIKNHu)~k^_ze*1WQ~#ZOC-jy^mRt&sfEqNw%GoZ-rG%J
zQj;1#{u+GaG&xn9U<%D=Tc35d8Y3BjSqy)Ljf%2@Kn~Pv$GEMn;O2qx=w=9S?;i5Q
zJUGDbxI#%r6u6k1cCnd35aM=T?fp9pdtH}9Z8$P5u_ZC=oDh+|qGeOqu|L$97U3)}
z=BbkH%5|-Edm$ctXkYu-gX~6<3Fk5dg?pXY_FgYoRa23#uq}&IlWhMpE%W!r)@&ur
zWe_TuT-=yxx8(pb2!a`NL$F_F{Im#@>)(Me>*egYv~6x`Q}|V=6eGpePXlfBZIP+w
zy+2ALH>d=I^kMrcL?L0Z9RuuG2(eg#L%*%segP`#X*&-5N-{2je1%hsByz$JxwaB6
z#Jer0Nd9s_FC6_o58<;WjnW(i$dv*U0>~Ov^KrN9kk&K10H<G=+GNI9k}d0d!_LBJ
z%8?Lvf78Q4MQ%{yZ7R@pqtg)ZZ_!t5(prZ~TFKcNBsx6MI2R6f+fu2V6a8NKy=|U)
z_X_F1D7~AOOV^O%FFS-<tLv%@gk%HNkC6i}!#d-ur=qNlHqkq_@!9I-%dp}9@n0Su
z<@0c>zx?_KV_+b@#EN{8W>v<22{?E9)shIQM9vG%&$jnaV|YQ43Eh%?U(atUi%e-)
z!(<gLFBK`DwMO&j<>JvI3fG3ldDXxbcV5<Mh-j;AQy=u<9_MOa7(?i45gvc$MX&`|
z<t>b6VFQAtuhYwaI|g50-hjFx9T%r%D@@Y6BcA&Y($>zX^&!F&>=C>1ZQAz!BInX`
zKtb&7md}`znPI8-UYxr^c;^@tbYlFN4H#kPt2m-$8$>G<z<XnRU(EzBjE1>mw3IK-
zQuu5~tsJ7LU{L@1cSV0ILJ`i(+O&XYR8SZbnDAK%!t))_rhLo*c}wndAP;_veEz$;
z&SU+jSP`O>2_nj0(Qx}Cw;Gg-KdRN=0-nSn_QUbjBj|jGi_;1{19)T&v8xJ%PD3+?
zXF)U~N=xB`lXe18NA<jWi}W|1v|Vx!^`K-8va=cey6hk&Hu{op&a`Du1yYDLbwy=L
ztEXm?q!pQ~adx0Hb_e8c*^q8tp}wkq>R=oT^eDt#r-~lQFH2zi0dPGyFMeaCJbC(r
zXn48?p=#)Oma27$wD#ioZQhh;6KD22=x0Bo*$y2&wbkpz&Acn1CHSg3!63SR)CI%`
z9OCm0ezNOZO9E$7$k%7&+$)Gz;yA+SGtato+t9Vn_#cJiYAJh2%@sRO*cxBO)Rhi@
zH|R%bzn|M={}BXas{H%N6fR8nXsOq4HXxeT+~P5$UsdQS%=&mCoIDwWf~*oU@Z=#V
z7GyS5)t7H~r<wtXC^#Jfq?&c;sN@}(d_;`XV)xRuEq_>(eQx&C_+xBnW<pIJ5Wvq+
zwS5eiGmh<<l9?9Mq!5cK7kud0`X6iYb)@eFH8=a`2#dH#p>1cgTQ^v?EMxDNpNfo`
z2YERx+J;~~u?k+E!{nbyBgB!0jXtea#2k{ukw>k0z-XM&yr175fKFoqt~hu53mKv$
zqtbJ!9{6)9>YX{BhQiAtb1W;&D?VNT@DZ&|ffa*tgQr*mZ3!2LDpSj&9tRGClFjO@
zpNThvrJ-uEmnN<eU4wFL@)y9a6Ift*iy<PrgTckAtria}gB6oA_x9TILLz>luYYKu
zNfsh!f)9|4hRBw!B3QJek%hB7OY@>3^`}Zfw>-u3OW)TAp?;I_^^Ks2m!fdv9`OAW
z42`CB=1qo*R}sqn{dFe}<wYd-7&b{kD(o-lN|7+&hO-A00u1fiD|GF)ScE@A`yk`Y
zyUDw`*j<zC9KFwHZ3wf|hFa%UC;Sb-S&)1=7A0YPu7^%;`*jfUFHDLT#W=_8Gwbgl
z@a@oX^dDPByLlT05KM|b|2}O8nOuS+IAG$pe9LeMEEZ03B{ppQT1S)D%ws5?tAXHf
zz0`*)h9|P{Xr#2{AcB0beD}R?{caw8ofoz$#0e@2r2a<En%MeKl0s{#d}T$mE!jw$
z&;`lg8+@|DBY|pcFn0Sic)E{I`Ha8XfftQrON{hPxp7@a+aE0)Mwt@=?8+?O+Ah3E
z!PL8SBXfK7ozUOx6QbkGuG-Y*bd>SAm*?eQSF5-0@EnI}&yjOW6#tC&d-voXDg5~t
z4xA#52$H43og|Q8#x<lLXQDtCOY@+(Jrz?#58H1oE=kLZ+MNa8f(qaTmL6W-plU0M
zm&zQ9-U^*&+cE$=tw%<}WdSnH!IGCo8;XcDg%2XqAOHP&Il0^6iYO?{dykcgAo%Mm
z5{1lWK_mm{!h|n|-)MxH?ilorM6ZeB;qOl6nP8;xR!$$VYE3tF*d7y=O@)Lc<1HA~
zI&h*rYLdSe)|bnJxmO%T>kN1RAfOAErs!tx>9X;0L&pxeP|?{Ub{!Azgc9@f1z%o+
zhk#Q~V|fq5>)96fIT$oEc-Nj$qnpK8YRY~O_v3FV!}9Y@%L>nQ`Kl#x(UO=A6PcAa
z>5A_}kk~bjZAJ;11q6A(WJjwp!n&RPasxq6cdj;A-K)*de8sVQyzq5@V$B@vG-^Oq
zkK<xCiGr0+<lqx!=j~!T-Xe1drL2t_JYk_%B)3Fb22|hXzQ81S<jM_nDw_i^-`2aV
zpYGd+p7f~@%U{82z`Y|8fbb6o$yVBKL}adXc^BL#0xI`G&97?jQ_<#Mr6WW-jM{!^
z8uDCzC?BJ_*11_JB|Yjn^@KMmj>qJ@+M&nfDyoGP1+52cz-g|f;xUX#zfIG{VrX7C
zM~jpIt#D$phJlH+In6<p9YSX!mf-{zGm3=_IS7oymmz1rP5NB?{oN1|VE`}wawC+r
zC5S2uuolY4mtzWUf|83cmXVYZoPo@8DdJ$7L))i@K&4b`<=;(J50?Ew+pATeIYE9I
z!)O6AZ_lfL?1`@Nas@meeFwponult#bISMsNavgcGBkbC*>19$!vd9#t)hX|8ofPp
za!Zs`ax_dM!&^5{hK|l_f~O7IdB)O&1v|rPC_0Wr3}s4x1?xWiD@5WAH)o)491WZ^
z8<FV{%#TH^i^MVs*6&*NkY*M6r2&@Q-LG0~4YMBBN1l63WChdk^IG`;7n}fgnul><
zSLnhI9KjS|YTQ*RkBL%n2`*S_dB#Swz7s(y?fhA|x>BZ$*Ppg-vr^9EKf0nUP*3bx
zAzN14zEc?Wz8%Q`w|%=8X9SU0|I>B~MQ{4~dw%+WQ{J#10{E|UB&hp;yp-^)2if~#
z1msl7shaM+`-`x9)Bewy^j!`&DJwUot9QPWr9WH52<j>8us2;@HPNnxHesVzu%H)O
zX_aH<SccPkw2W^}6WEHhjP#AE(Qa$4{egyik&K9SnEg*0i8kpzCu#w9r0p+n2xq^j
z&;}8~i|-=jt>Q96w<;$uRFky%n8uh<tKt6zeW_(e$XbmAjQ*<xy+B9e$aoxo<}pXb
z!0YK?x2t`1MwYtiDXD#K<aou8eyHa_xqf{pSfddu-FMY&Gw-gM<M8fyaLyF&tU8{`
zlzhTzNg%x%`Vjoe<oCh5g9!t;6#~fdg1!@={BHP%!Q{TUoBU==<^4B6&z>7wUtK9c
zt+6v*|7?lBmdN7OuQ_h<_4VW$+EG7L=lSf5?cYx#eG4R1mb|=6v4&kkPV)QQsYU#Z
za+y@TO?vvL93b>TOQhk!Gu|`mbQ?n$pvXcTT+^llHh!vj+S!i>=M(Go*CNqY>6DE(
zok<|{l`yY>*a66n{fjXwu&Y9XigmtB_Rf!&K(7p-)sA^;`kRLcZm(ClD)l?}(48_*
z8UR5=@sAydec~10KO2a|f-e02brZNE$xj@1hu-7%5cbk;Usmc>+s+TxH+6_>nvb46
zs%g#R8Yf-$Es_2u9YZIR{1en4k{o`N(6XP<c0b#;-%QJJ;Pz(hfFy_5Vl_(JPag1L
z2fjD%L8uUS*8@8y-B|<Th~g&+$U250BK7En=48CB1to}oaq@RU>4oE@^~i;gk<9wO
z_D}*y`@a|0aO>wD^1-dq-Uj+#qU=J1N$|qtp`7gEqu2?wXdK_=f;0hp7T54&2O_O6
zst%>npJaMw+-n_q3;A-KWHw``Jh7jg9DX1Q3EG6eCJsZi{#_lcA5Fbqw_X8N@y+S3
zwQtBHcsbId?3kWBd<ymb8kyL%3Et&l&9t|anw`n@Ik=}^6^HnGr4;blUpVn{)!D5(
z4^9<65-|4jny|Xzwf5*4YMu^Gb*|0IWbg={ib}PjTj_fH_!yVUImvzB>>jCUYkGC*
zYs>P3v)6o6296qk1@EH{*8|Fm^YuVMoYdrEIPt*WqCd(_ao1QNNOt7BL=Gneg_GDy
zZdW7QB@TD$0YxFyNK9PmYCd-D9C91S*>CZI&l`W0utEsMiN<*r9%6}dPl$YM2($Tv
z=<{|bzw>e{;N7vmtiI!I{ak+1<x#aL^h>?tAxPbdBCk<<91XLgSxWWeLD_C8la|BJ
zZz}lY<V5)2fl1Fdd-ZWm;P;zqRT5*+#@jRb^JOk#a7d|{2Yt4mZwy_107o|`t?%%-
z_Ezr_wJ&aV4aZAuIri5gjY!#%)H-Sl<6~c(CtE9-Z$%Y`G!vxSQMYHdG(eyPW0I*h
zEi_|p+z{JCr651kk1-^m8)ad}JaHrGsqQH(W%*81Fmv9tnX9^tubQv2JMVR4b0gv@
z=V@~Ta^u>(x6-HRv*(HQ60u2O;Y;IP;~n*KbR*Z&ujEtZ-RY9CDc2&`JlC>!?n~*N
z_OiBF&(g2(Q|g`P^19h?=}Yn*^HQ(bZ}m&~UH-DS>AOXky`If0yL;!V3EnFZzqRv{
zz^k!)c*pj6qjkOWa?@tBXK=@g=gIdyZ`%%WL;RxiqSI!Tpds`U*=wn1mfs?`L4Naj
z)9ga>UC?WS-zv9pb`zV&N`BL0v(fB=%WFrsj@EU#W*y#ZyvJC;Lcm18NWe-jr%UCi
zd7D>#qxCy>rZcr*Ztmq9<iBaDED+oDaZn(j7cd~8A7<*mln0I`h6au-dOu18J$pyj
z|7E6RRemHeqF6cG>su~~(%kKx2}Kf}8RnJwF0~NlLX#90GD-=aD`?G47neKJI!}(R
zoikTHXf!z?D;O5=^k{1INxpf(@9|Xh(}dJi0gv*cx4B{Yc>u^}v<La{>nock(AlZZ
z>-R1~md5L@8^9Nu(7<+l{r*3L=RUchIWvEFov1S$FR|%Von=$iekS<V?1qHzY<lbf
zlg=1(mP*S*DkqXZVr;3dU~&})0eFj!TrSalT29_G5ltTse>=jfR2i%&m{^bJvMTBW
z7E?H+mTo08{_H_Q8hJz}v#A$H{h>3|upFNwrPmQ(pHP)jVVmk|CKxD3^dV)nJfafX
zqPhsoTQLXe0J6cmg(CEevR8^i0*B2(17Fc`#D10_b%%>3<z<&+l1UI4|0;S>#xatQ
zdE<u`?W2UcODZEn=DOhxJfP|y*UgC4Bg;Zblx!47Nq`|xc=0_-3`z~3Xb4E00D8Kh
zQp~B`JE6rwAu#|$<#h(46%vwsYV8_fS+f#3dSI9+mgJVG11Y}k>zgJ>c)%!78gc8}
z`wf<hXw4vOjE2U7l!}^lx$gCA^@ic*_Q`gD9w{7*c*N#{{wmS>Dj>8kNo1=4W%OMl
zuyb7r>8hnyd`=P;tNWq>`x}UIvZa>*ya|-)H`HtkJQA=y5T{HNLSLvO-Qk;~*;qf~
zum<5y{A?^JO8&(;N6-gbI$<Rw8<oL~vH3NeiJvo2hj2I6@&173tHN<9+-j^7`i=DG
zAcq{iOE-PufxP@y3d`F>_Gcz8CG68@PdM$h^|l&+b*_Ml-)A>IM+#y+p}L<tDm`Gt
zZkkjcFJ@Qk?O|rC{-QPao6WJV@@cwqltFh==gX_W+2nC2MSTXdM(_J%D|O^rfcmkK
zg|fG{*ZHbiHdD9r@xEEBwCBsRb$yA#RkqiPQ064_8WDf>`^EiL>G5kK8kO%}xO-Oa
z@%!!c4D?gR((ySLzkB!c7SS!E1BWhlD)mEW>W)oFR+drl{4oEXCW?C)kd&PLr!&=H
z)uiqM`i1w#Vfh!RUSi%NqOI@E@cdULVY%V%!olP?$(m^PjHT*eMV-H@R_jXVFyOQ(
z9ddi*+flr7?mon1Cch<nGqj~NB2I!4OP`NdAkr$Et3n+{kfmZ-r5cx8bJ=;+L=%Gm
z(OeFSI4wmoaKqB4q?o%!jiq0$WglMut24eh=0Mz$ns)HupiK;8A&+`6Xh%#w|65$$
z{aWGzo!p_2lgJjiH9|fj5WxP6{OY&)ahU9&AMpz$do9TW<9}BH|7^12nV-`i{u5Ay
z@pCsbakjJn|N5i<tQidK?QIk~Z3mg)w(ijbOqXrBT`xfC8(dkL$1u+8;;H@?HDbL!
zS4f8Dp#w8?9c;%}GLi!h(OKHDSutI3owNpVep8G%=C7S(C6wA@#`hggD#+Z@^&PV`
zdK{fvw44agnDR+(@3=m13xmpV(IF50uu|{ea3R>De~H`jfhl8)n*UaYZPVvWF~Fwb
zU>ZIc;_^J&61_S!%M&u%K;YAMZE!3-n>5W3s6_HUeMWg|jMz?;e`omey;-??*-~wH
zwZjnng)TsaM;`S#a?7;)?=L{TilZRm1_b0E1qAdz;RFB27x*9DRg#8<v(|F<>b*}x
zE&BH1kKbV?2Q!BVcvvKyK!hDyTZ<V%i^LGJ9*s`avn6>gA?}ba4s8+3e%(?^gP`*7
zLJBo#I$8%KweqQug)&Tbe)i1a6j#<OXI2i&?upxVA|4lX7Iv;tcjw3R<=1t$=Sht$
z|L!29*Sn|fY57&mtM~Mu+*!9ekD+o5>1EMknRWo22~2zbMOotZs>;?$D(JUHk5Y9L
z9Ok4P1<zTk{<NG2oidgM&h%?#;Sm71SD68GlHSCuH&BNh5A4CcgqtiC^BDG>#prbl
zsqHW__~~^qU&f=zhgYxs5SA2P8vn7l!RbV#=VGZ}>xnBg<UUw?@<yXX(*;I${|4j&
zPBl_kXl5l`Xr{j>(dzyIn|3B%$7g0j0fJWyh%UG+Y2<F%Lwa&{n2Hm!(oniOg)+<4
zu9sPpPTdOVYu~$FNfmr8!pZGq&Lw|P0hrcI<!O)(HD=)-;Y^fj7J0hTI56DOxJ=YC
zw2Ef_cN<I3DD`>zRu(+sVP#>!(1g<pP7{|IivU7&qX)IZWR9W3)Hs^vU2p{pAc^r+
zd(WF#%XK7Mh^^6V3b_pKTR1r(5x;_fhKv3t=%pgv(xJ;kz9){F@D4E+on;vub$Nd+
zu62P~am*}|YjiBebRyjv-GEg4)P?~i2W>Hfu8Kd^IOEyaaj&he=X4+JT)E#>u!jT;
z7lof>v!fN<%E?0G*DVN=bR?4n>!8q-RZ5w>l~C9}6dBlsNYdy@vB3s3MNg-K1Z)Qk
zwTiJa8LpFJp?7bW;3?Tx!^Tv4Sn?4CSKiR*fJNS8G_i`p>UL;i-I6o9^j^K#u;CLO
z1Q?zr4<^K-kh-q^<^`L=8I2z=EJkGYg^1{0&L0~q5yA?RAWRQh6p<;+!VtJ<GlUfb
z-g#)X4a?*{VWdL|hF-t@zm6k=Nz%UQp0sEA4BF&Qf@6B+DT)vnp1L)(O=Y&98(mzC
zJznO`ZL`#e*NzWw`lmDDhRd+u!882{Wwvq#0%fU~Q1Mm=C5ECZf>Rh0sGfjU<47aa
z1BrGPrKFql;chy1qhU}vu1rC`hbOI(tU!tA2mvi%+UAV)lO|3h=06xwm`<pDlb9iq
zkwwijQ>)H7Mn%!{GxgS|F|xQEF1BYMAD>W9q}jCGC$DY?$06Ox+4qA+1pBk=4@{UY
z6L*M~gQ(y@ttk`33B0f%Vb7Y$%P0ObM9gHTb79K%6Jh-gj4`awuMA;(RrB6EyU@Av
z?Kr!a5yzIYmzZf0?Iyq08#E9zj?eKkCc^hKDm(}&&mvQc!%S_j$Z`IW^Jn9N0fpcy
zPH*o|j+xdZxGJlY075&v%DY!p613jNQuqZU&(F&C+ay)bFXmfByfcnj*e-ea@p*Mg
zJM@oAv}E*lkY4_EL#&dwCumt(GG<O3ra<#yAsZ9To1b3xp=wHTNS>gINR^|yDJ`%0
zIic)6RWJ`Ow=qv<((M#Ek!z+pi^=+CAU2CTAHD1-ylkU|cYOdlJ3I>1S0z?Ei{5n%
zVQSU{xJ>^|P`hDNB~JXqT0G#p{p%jp4F3RUOlz=`VsklEwV*ss0M7!?^6nP{F-;a*
zxy8J7P%-Y>Y<_G7v0uSoZ9#7;B5k!xgkK^xbZxp&^KZiJ!@Q+^h%VT&i$rW2#s;=z
z(fjw2L!h|uRzrKvo^hPG%QIQn&fM^Zau6)0Ka;%1mV`{^7GJU0+O+rwj(qtz`>B;f
z!M#G(=1}fO5^a+Xi;qtQ{0%3fsE5!=pdn?o!uA&@!4k=q()OZDxoW`f{g^cTb7RTV
zH!FHaTO_t8$Jey(wpqXL8#;#8`Y*45>K7g@g1NPY-?-;cO^xI*Iw%k6SsHb8c8fX{
z%_2x(*3Bc${0ky)Z$3e7P0^MXxk5Yv87Ba)n<pI3Ajk5U(?8|1AoY5nC6W@k5#L`>
z#C@x19Ziw+f!dSKs6j+Hf6XhT;s1`lx9=FH{FYFX^tvGTZHVcW8H>;;h$NTM8EV=J
z^`1O`mp;BsJ$t9kkZsY(rwta(4*?%T0QSIG{F0P+jQvNG%3x!ONY`)gf~f`m?b@hH
z22FY1J=8QXwFHW9&@uw!4CaHQgs74_eT$i5zAYuuiHM+CSWN1J!P(@Bat#@2npO>7
zGcwKJZDH$D%?>;Fg-ut5SvQdOhFt`!-GL`WPfxuBlOn}D4gp7icw07I4Ymr&HGWGc
z@(1`?JK}C`Scp2|%9PmfsiMcawnDY-7f~S-4T+1w2^S#O7&Fi~%x+)`Fi=jrzt7+r
zui}-huo<+0T;`KczNDMFut?1o?T?o69546@H=YG$7}sf!U`@coOhmLW1u-Ui6B~Be
ziwk%Ld#NedAY)$<46q6pTJ3aZL(^q1pNkAkOzbMStLldo;<ddu56}wKo^?<{4<O|Z
z23QsC8Bo7K$low+=HbQ>1WNBU;mrDDRIsr1qv0_iufu*`Zn2&)=tMqrXIGv`ZrSTx
zaKT`@qp|z<B6ThnV+`rW?6s?)@fL81Yl!6I>foT9V~H7BH|`XQ6EBsRpSOgpbtxQr
zh#Ye%nuOR1eLafOPm(tLm?B)N#B@B7!>WIG*9EftTje3CKn8%`!=vV&;fML3at{q+
zQRc&6G?Y`M)*!w#FR9>^cM&`u^)q#5fvM3vFy}1hlgl5LB-Zr}uT9#MPN-S{<C;{M
z{+;x)$=zl#DJxXAhUL)5SDX@N=mw(_rKc`#MaIf29q}NUfTY(2mr;_1JFX}=ly9E>
z9Zv66IzSgv;3t$B&)y6_%T;8%!6d^|IG0BC)iha*n|DtWB*8JO=C1G3;*nsZdWz0)
ziH2)Gu!0q-9?+P`%+tV5C~?DS=@O%*S|jh^SXGL`{Gy5di<qem4VjdsSRFzZM6eLR
zq$=8FohX?@M4a@KhlrLT^p|ii&><%h=4z|#reZiY9B+fWa?S>2!&Dtd8-LHW1p*q0
z2&7`@Cp0LzAP%R)tRb2Sd#18-57=OwI^N&g-jW+0QDg|&aR;l5X3Bjc222fhfChP|
zwN$%9vLotrQzKUB^`m=w4fnVp=7IIJ?idf>^L#(M?41aPP@mMck(Oq9Tpm5cf4xQ(
zed9z4*OX&Fwla`~N}|N_=E9@E9`rnx^ojx10aN}QN(vMn2&3z!Q!GT!FU>|iI7se(
z;O1@?e(>@hxK#pt7ScT$vz8dScJ(K7DpSPhd)B>MZRp%3`WA<qR=2auy<2YN{E^`@
z#AgNI+(SH)P!y_B6nWXyahrS5++?1183n=ZN#Dp0(}+*qU1S~~M&|XGs9~^J9q%@i
zWzBriA!R#nE_;X4qVXIWF(^ph&iS8OT?bN?>+qT^n_6eTWvf1VxFO0gnI#0*i6ZE*
z|G8`J(f<Q*K##vepJw4ymt}ujOJp|821F>@h@nA+4robVui>eu!az1y4GO!WErDTo
zLy%nxy~$=b5(G6iQ!c#{a;!t8x;dDP$Skx3D^3z9!k*i&@?!orFzQYC)X@aH1q|oB
z!i87ziJD&o+Yo6_g7__a6Jd61gZWkaEc5rk{7Hr0D$ReJaCJh+n!(zaT-poC)<d$}
zgB;xz+Sw4!FLl&rcR(~?$0cLCfw4i_IVjz+*ABCxM#g9RJpslr$dF{5c4;42T?}Vr
zWS?yaJ|2&&MJc|5uv`ZZT*9(}Fx#WhJutH*+a_6}$EMl(QefrWTCRS0wW)Q!{oo5W
zj!U<L;|2_e&*pedjpJU)F%OO-3LS~DQKQEodKVid-S{_wfCGNiQbi~0(rXcOoU{=w
zY1WP5b^mnqTw(L)5q9sn!d~YIyU(T9L)cE7k7HeI9PGy>dl5h55w=f!3og9@FqZ<n
z*u_eKIpo10;))6_L7zh%Cj%SV!9au^fL_(WCRTxN<-lfkr$X<PE#ZzG+Hr-J<#^`~
z?W960a-7_uol<BO4Qc(RLT^O(hPr{ybQkP(cbH8eI_3F0f!vtZd@dcp#yw%SU*rd}
zPIh<ud0-2$2dQ=%>Ku@ycJI(WQ|LiCzG;U>v2n=Dj=Nl%f>zyFxqAaUO!{Z#?{WEi
zQvRNjzo*0O2<Zov!#uE3U>;fEr)>n@7LzZ#^k$IR3NrU>V3SyG^FHm~NB2I4_gNff
z_u_-Lf3imG-WstEG5Ly1ZvnAwu=LR`HU&#h&sqAYLZ@Kq>5eok`~WO`KP-HoLhpk*
z%^G`Bq4#^EXB7H?H$w57uCe*5OK%0`D?$0eF7^;8KRQSGL4`g9%8$yJd<0Y<R_Md^
zPX0C+`f(v6GOljuN9vnj!sg6bn~&D2;MZJwJ2+ki!^{LVP2OPX9dn)?@;v)k-LsFu
zvwrv#;9qxX8kiiz$7Adm>ZguuIHtFDqAT-MJ?4F$aA^jRJ%D^N#-0|CWIcOIZ;jx$
zwJW7hdT>wGWO~|WPmr2LT$k<vZZB}3iLn=IxX()5=Oyko_MAeW4YTJ{`b_Jk3VqHq
z?(;QbFWAhj6MNC6SrCiEyt6!z5dGoH3Vq3?IkAc|_i}{2Vg*fck;DZZH+q*ksBo{h
zXtW*IU>M_<VpzX28R&@m=~C|~7^V@bgYqk&9Bt<8RfT@Tr6Yne%G|3F_RVO}#6dDg
zc@(|M8~+!|`5NVKf^xh$$-b@7Z@F}@po}X0?fF#qHBj}g?NH#oM%rqfb|3-bV}dxW
z`<hF~1x0kn{}AL2w|8Pox`jEqwrIt;YD{a9InwF6*rYEc$uILnFAC}~>~~yR0`=|C
z;&n9mF#H<|{YRJHDHgH+hCKOXLtc9=&_QH5D3o#Ab!p|WU!w+2V1m=Gs`@&YAv}+;
zH?^4*nN5X`lXdLP)@2y;R#TT<>O_l47rS)-5kFv50i%mHg(SEwujNr)@C(^c>qLwl
zM_`G*NEc5L5!0myRI{^7SWH~4p_VMrZwlOm&`f}F&7}tgI<n>Rx&>bH?!+=#j)VR7
zCWZc!OAkTM>!9Ze5nS^1hxbqF^7?WYI9(|86*W_Xw&DV$M8!%|T%=o)y#@b#*QIw0
zBJlWIG4?$@m`=({Ja?BRgFU*i&SAvT4_h>G*A(|*B=M2Mejhbb>Pc|>vV32$lPPja
zU&r1~>8DeJvzlr4skm+GQF%3q%Xby_7DC}|m);{W$f-74Jiok@KvX5BwWLcY#k~s_
zvYT`qVR6wF;XWuHW+XNQ{hrOftH;>)t=gj!v=$oQD-a<aLFd@;x+RbhAK&M3z<gzg
zhVc(vdK5}u5B-1G#oj?ZeCN!Q0?ukQfj^N=;E(0K<43q_^Cpq$Khh?}y8vC$@QBdY
zdYgO{__3BY`}BrAZ}}&vv+)S~IcWY&Qv0cVsz^$4rV!;zq>uaQO7E#c;>lY2)1a0V
z6+-~tCjn2-2dqEw%ojz*$j=0>?&01qaZi2`ZXNCCum%MEg%tE;gP;$5k)S6V1f7<E
zRFjaa8X&(=++Q?^`_%?jzlcB`_nj^52g1<*?9vC})E#i@FX4O~ZSN`cU6(#27UA^w
zYR_jP4N!O<MvDDfJk`SQmb{&bBkB>XzAulcM@2QjT~o&`)Ow9rvhnzu8tKF(%=9Vr
zS1z3a<(<gBU&q*Qi0ouVf89e2RW{d;A!C03nizc@qd(Q&5>P(TVXOAEiE{8bD&3#u
z>y4)O>8e$GI`%^}Nc<a{{fgACAi8L0f9uj?;F$!^_hamLL>?(d4-xV{F^`ntkx~Vz
z_d)7+Hv8>7QXjbVNszh`*7|)H`v58MLF231A7liaYJ63DO8ABMYvP?y7J>S^+8;c?
zv!2jSh1nm)D-Vxg#hP3Gqjs`k!SiYBhWXEHAG-8u$hHfz{i%z62-!XqvPB>p$6e|p
zy&L~#jD19eONm;0%Y;*17~#KA;a3PDy<)$b)P^dd5L}@jfy2ixeFhu`V3|L6v5&#w
zW3TUa>9dFZ5o%abtt4NP(cg5WqQ_JEaUHgcL@jyIkUiwTxb!&?*$r>}EADSm+#}<-
zL0U2P7wZW7BuSU1^x3ro>)0nLaym8enM<EP;!ooGNVOE9ZF+6ezDW-zlirm*Dqqxa
znBXL_bSU$;82c*`5#`bsj`)2usRY_BoJ(Huq<R~XCzBeQ*0^^vz35e9+9uxOY(WSB
zVoUh!B_hJhJ7irtiz6bU&B{z$<E2)}JC^$TDI6mn`{^exeaVw_HbX?3idTFonoD2C
z5!G3%3N->AqR7j?Xgt{$mm6{sOMit4#L4w<E`0@-OTqkq6Ggg76l`=L|Dn)-cmEdv
z0RR82ReL;C`TL*a3=U>AjBD72Q3egeD7UnSL1B^zk=tM}E<-ak(yCT!ZI+5uLv4g|
zO@;2-$|Wi-3DqV_ZKTpowYvR2XPn*j`~F_P|Gw&(^FHr+p6ByC&*%O53{oMdt{mtC
zA;Wg$QK~c5FUo{G63F%mgb@uXQkf~Af(Eh?O*J-!mg45e;h<4e1t0P-gp81Ud{7P%
zWow{xW0Y!x!mj8t#E^<|U@3BhNMo9qkRJxZ#{)HdP$IQXn??lrjw;d+T_^G*2zf|h
z5h`G9nj8^A9@&$hzz)D@E-*pE1*U)uRf-ha5Aqa5LxW18(cEBTI!a}u8XVMyin_w`
zpaf9!s15l6)sFm_L!$VgbfRqOY7hwixxqvj0Z#~djM4#J<4vJK$P-Z7au`DXlp?jD
z?;t=uWs%3IC>6NWc~cNA2pMyP$rIYBGK>67*_u2KA>)h46Ehz5z(XBEp8Z1{1H@bi
znP8Hi&kzlO(1VcY7UUOHG657$m7{{O7=f>jgWmNKN(2EyUI1SzguIj@CqNaUpvXy7
zj*iMv6<Flg5b{cjoWyt*guJ#R{{=h4Y>p$F{81ZG-%Xw>BTw~`r<7>GjL7eljLC16
z<^wYUIE4HLLf+VsKXNEEA7>8Cc7y43lnu|MeM@4o>a;0Dl&*nNjipE<k-{W`i4(Dj
zqZ(9{sF6dVNs%T+8Vh@c=_nDF2ccj}??4um&PJ(pltWcO$zLF3ibRtMfU03feovPT
zx%uzeYfzoYA0Xtt4fzutq=JwSSbzUy`v}T&V}sH-cxivxkYB+z<Y~HWh^J(GHBF+h
zP%2TD`1F5n>L)33#*+>qpQXrIFsd*VLcZ8B<$!=We&*z_93WpUlukw2bkq-D<EuIO
z8%HU`j{MD!LW^+rqjKD+Z1z9xd^2Z4Sd@~HBZmoTqe{k1g3^2@0b&qHEL1i(T<V~n
zbN|oi&SRq^Qc(>$3bRoqBUm2fra=q{tmwu8tNG2W#*hPPX6lm_#{fAmfIh-05QFFp
zQ|XRWCL*gr0n{K5G2~G>Hqa3rRzR7`5JSO^sYrLG!&GyoBCNC#+ZLrv>Wq&u?xTq1
z2UA~$%m))-g3O2%Y4L<1hLRMyh%JUf3}ri}DoDifV=z@XO3o%sl2ULW2hj$v;Gv_$
zV=&1|835`!F-Z_Z1-ycnxk@a|(;h%Qa~Y$r6b>;+|8z;8DS>RxROJLx5d$*#2K6J#
zP6L}RMSdf)n3@z81-k)=usVebF;q!36g$JP29TN*xde6`g~23YFnSF|TFSrPG~hi)
zid@E8U_lIu9g_<7oy}n|)!0}I>YxQS)`A*%$XcL+7T8z|>JUQ>yn+{53+kW+Hr4{h
z$XZbUN14=_nNe{S%2B1rmH%5cxYJre9TA`oO*^JG{qG}2)j(lmnRMG^jS!_syCMZK
zFlTDP%EmIqz&SLE6zKr1VSNH&gB~G<mO2Zh)s`Yxy=f^BLr02qg8WfHhPosIL5g%K
z5|Hl>G3UZGYfO7404aG%k!zXqlwE;vsT!<K0P%BCC9fHzCq=G<1bmQM-<CNKCQ&G|
zYHomP<~hPlLvYg>Grv>TXBt2Z0~BxTI|_~9MwDG$3qTLu2)MdHhIuR|4ZPlzU6hQO
z6ZwzR@7}-(Vi<zln8=KzNDo*z7KG7(KR5*7%IO7+0Koac*AQYXkRrDL6Au^@5`l&)
z>(dokh>?msLRW)f+4T?4w84-PfMXIEgDI*GgM7vi!)%5F3z%aQ1T+nq4>1->k;8yb
z20YV_X@Pa@4DJnZVwsc(3f7g|GQ@;Rb)&*F%~}Anlp>`dC<Ro)vSV7oBpMCup)8KZ
zWc?kdfk$Bqv;t-=MRtOybzt||c1#->?EcK<>I}ogOnDX>NIkAbt)^3}VLFjTzJn6k
zs4*2&h6Ww%J`g%k6dM~O5wFDt*di&C4zh|s1B>mLwzC>oOhGAb%eD~zt=$%wofMG(
ze=(@t-j3<;ziYS0LNti~*6jeyQ5pdPQbE8H60XiZ@awby=;3>r9+m<<I6(|2)Ou!_
zrQl}^Q@ye}5qq2j+kG3MYylO14??l+Mx{O=r35g}c1&0BlSPH?nH;JEFdr8xf$l<O
zQSF&7R3|0}Vz?{>w6ZpKwCF_8m-Flqa1;OmF<fn!Zs13f;f5bL<#e#^Bd}kpXf*-+
zc_gKPCv*ou6JYYd6oAPALx3p(gK(boANX${GLA8x3Jk`v2JVmfXwLFip2gE=#V){O
z*}!aO`7D}+7tg{fv#{MPY(EP-;`y<hZaD7_Y#F{5=HoG|FV9(Zu9%f)^(;PMR?TZ>
z@xinF*Wx$?Ukmf$0gIefLo{LL5A%t^`8Z&)v#<b<#c;x`niFTOE1b2i5a-i?t;eui
zI<~)rQhcA1W_%%Y9AmGh;3E{zF$v5Y$8Ert<N4}<aR@WosKGH2SS60Jx(?%54qs0d
z$JpL0&Z?I<YkqQnn|qoNt5Y9eJ9UPKmf$mj2;c9o;R;eQtpe@I*`^;z+THEd#-g;3
zUOjhcBr8i<S-d8wW!%5w+cuMN!-5Kh^Ii8Ut{J_1^!>{}o>c@Ss(yL>XG<4J%_T(1
z&|+zL+udv1BSM{vHq|FpYW|hh^k7Jh1naD~z63?=d-*NqV!d(g;V^;rA2;ktN4+xk
z{#duMu+sm_G-;}LWl9(M?qA`pQ96HSa%@Ag5-uUf=hX%`>Oh=J58M?87GKDhl$yp>
z9sI$pIr1tqf~2DpwEgz=l$#s&>Yx75@haxp_OM31OZu#Y$T<C*?-gGV@AW3vn>Vwa
zh(Tk*-w!1JF1l!Q{d78V;8yu9_W}NMxx#nxd*W`~zR>uhpt4=jEBA5mTNX9`H_M14
zKU%Edr((L&--;;$ij$L2_(EP}B0oAjhR;h)6Y<6I@!aGnFgLkQ{5(i-4LJYDoW(fC
z&W{N9!Oq*dnf-;ZGn9h+u)s4J_hEu(JkFc^t66CNzgmW{bI!*xw#QNUw(5e92s}Tg
zlW-hUa168pDdQN6#k3QKYv>EETTFYefd%1OdI~HM*VizPF@6Y`Kkkp+cYZiO0L&NH
zT_3PjIKBzY2lu}YY$c96@iT(Ob^znz{%3)C;p;Zx81p}gpCb$(!_NrjQw7Wgk1Yn~
zjN`q)P#hNm`yR);fGx$>-2u!A$6J9d!F@IZbHMRNU>3L!wpUD?$CR=V=dpXol<@EU
z#K7ys=4ygt?2em{`(Sf2#4&b1(g-tW8@ta82s7t<362%<TJ#7r_Xc*S&&6}Ha17x!
z>f*6jEjoBCrWq~V=R2Ik=BDbLnu_U@E7QCj&^)|eER^YANFi{JSTo4EYwt7W`{sCR
zzEz9|-z)IaQsa_EG8YLoK8+`gPe!AXllX~=Jh4TxC^kNx;~@mIkeig{gh7nrdcH_3
zNERj#<n1hMEUYjpIVBY^V$4NDq8!bSOp6T{2xF2Zy29jeaSBf&3<p_L1c`i6c#0@F
ziZ2#RC=#AX7@j6f6N59ko+lDZ=ExX+dP=e=HJq22h`Wg6c+ts{85i~0L4qXAQ=&1O
zi%AnkVYNt9Wo)D%COiuC68FC&Mf|8_QM5!y#zpf}z&kH>b~IJ?O>(3-Igy{r506db
z0e3ZVsz?x(3MxqyMDt{Rl-VWEs&Iz+yD>Exmn0C21;SV`4}KKBK$<XhL&`t(fJs8p
z5|uQeASyYU9}ZT-7(oKT*V11MhHjZ5vE(PMOP75x*DtaRk4zIJMq5VnV|Zzasg@~;
zX|V#K*pe?wj7duU`&$t|k<SzJEfWQima+U)uvL~~Q52pz;J=(%AdE^(i{|6mz5lz}
zWr`Iir-`EY353x9{!DOa0es^Lu930ez77c7>O+9Cn$i!{w<zr?YHwzchEmzT)7Um*
zy3G(`)5u^W)*SlCy1vXUeXaIMb2gEzDEgfo(t{Dgj;c0F*0hP0#Iz&UrsKZOuostm
z_~${_(NJ%xVk9>#;D?Qyqxz49rrrA%8tV1wc}+vj`wNo1^C~Sb7mXX#pZAqMzZvpu
zyJ^^Ds$Zt^dYjWW&S_pX4uORaLVbphg`O{wNM1Q`yuAEkmL;fMDRpZ4;PCv$?a|@1
z7pL|mCwkj1+Bf<3S|53E^7S{r^{wyT+|D21X0F(<BEzI<;Pf8bfzvOqMVDMZvGX9A
zxk})7ZYjBY{LS=@{5PTFdqbkUHi-SwK0b}EQ+cuBX=vFcb75zH)4<V|N2Nv$xAJPx
zgzGOu3I|W0(mdIG*1Sec9-q#L`}IJ=z4nO@rPJe1d1sGkT{->srCdXmT5)lo54t&E
z(mQbQug&k@m6>)9RH#RsK6v(sLYzlsNwH|fW$pUz<L32WgZ6*EYxq~A&bQ~c3u?V$
z*`IFpT->{}cHdHq_=cap@oUbNE$~0orI49ACt`UH*W!<bO>Ff)#(PelwrV-wGeKN&
z-uLUUfs0Pj%2q@E>x5@V=mXCP%(L5%8-HB8t^4f`N%YB{rogQhZ_k}N_56TTeMilO
zd`FRebXovBnC|8{A?`U0HHKZ~o|@lcK2-7JhYjtF{nF>hg5j24<&1+$EqbLF{o9k9
zwuf7pzy4I!zr`xcAwB4q?W)6+M`fIbJhk43%}NUt%%bd%7VGu(UmJ{C#8n=D8*uyL
z9$$U-nSf6(JsYYjn@=n?Knh+D$$fDQ$Y^#6)K9&#@5FI~iI`Pgt8@~$KXjOXOijLN
zGeU5&_gAo88k6-pv-(Zu%GD1$^w-Cn^6`xB?eX$FVnP}?ZsulDyGA#2rO&j*;&TT|
z*Ig-PXigw{@P2|9=|DD*yLx-?qN?`FNF&nf9?Lg;lajn?De+5|p;pE=Thx#6+98BY
zuF2>6?l0XO9`nOaN<*Ae@Ss-ZkJejh@g6@t8|ta>^w!-SUZmgB*X4e+P|#y8z8mU!
zy|6yh*P|lFv!Rf8v35{Y9+;hO(2#hqd1>jHj!SQr|B++hzE%_b&%S&zHM89Mrn0$$
zrnQ153HFOPQsb~MAxV&!<iT?k#Q6jtx;DMSp|s#wH*;*Xw0c2Nm%uIe!guR-Pfp%=
zX<qd5Jn`3`mlWNS%<l_0C@f+f>?Iq9?d!kzIC=S`pf@<U>Wut@n`Y$){liQS|JHj=
ztKC=+>Gq+VGj?V?;Rmlj`mFD6DD!+#M@(F&=1J#n)-F!YAQKf<-W`Z+h}D{MDmlVn
zzM8N9yRHx4CWv1)NV+4a93;ir+!JVwFM^joIXswH5jaSTfBlDQ<c_Si%c$e$qWxjt
zV(XTDwHy*n(}bp(5hvc9j@K(YXjLQM<~A(6_M?8@$(F3ga%bAi@86BDnt$1G@nYWR
zprOdU<W~;2V~f`w?ywP`Ak;TGblwYo(dV0MP+D+DwQ8g~Bi!S%O~=8iXv24>-aXtG
zH&?g%v&-11=Hq8g=k~4n;f0IIw2Io7N1fLN;dy)2f{>`XoRAoUm#Z5(ZMnfycU3nw
zQvPI}U6vDgLG`VA_d`op{vLzJF0Hp{Z4<|lVD!@_`qzWP_$u<(yP=QMT>h$gKe|J1
zO}2f}3bWh`kDg_qkqT35Vsm$G2wgSQ<yP<NP&2=^C0|7^KH%`#nyHc<K>_5csZDtv
z%2ThjJL<Ztv-Ldv`kK7so87hI@)jPqJ!z!7GAZfCtN2%|){@*jYjewTZ<&2n7F%!s
z5;?}dyvd5xcfzs<IZJd{1~aa_tIv=SS|{NkkD4mEQ^c#z)202-E_XB$GcpWPxZP$|
zzYQ*ZlIu;<b@3herR#*pj>?`;!*<`XauT$8o4x78dQ)AU-5OrJL>BEw)$65_wj))F
zM74t6<BwwYULHyB4A#3|xcExV^{&GURgH+{aVa4cwqpObf-@E_iQRSCFFn}X&xRkB
zelp749j-X!N?(~$vOD~zFZb&2JB;yc-%R+-3q6#-oK!J=HzVdW)xCa>PGx^fTjboq
z^0dX=(G30FLpH~LQscG_^y!fM&V09E4IuYNHnG~x!@3)*r{YAdTE?SipuDKv{l-ET
z_mRR_TyHj6XR9QLv%X@%fMTneaLWnhhp+Z^mnLnouJyl95I4F1c}Fj(ifmf&F0$cx
zrNA=a4&v5}M0quLonFmT`Pe#f$|5r};fQG*oS=0(@Y8&_KYnXglVyB;-?7xiL&S?$
z60<z}tCF&Iud>kH>}1BBtLbApchS@b*Y_Jw2Ih1XDoZ_MeB^K3viHxH8_JO{IT5q$
zn$5Ekake+2Kdu=gW-3c<6E0i{4>K_qFTACE(DtYDYX9l|lbScp4;>wlQuFKtqO#%?
z)6hV}IS%RVE5^4USb4>4tn7zCw<EcChU%b=83vL+S-Q0k46ZL!J{N97VESK0Yf4s_
zHe?x+%FJ};Ru_yrpNjh~S|x*$R<$-F$J%V+ltcO1gvYHzSx%|WqV1h*<{xsSQT_p2
zo@~z=SA9CS?;#CY;Y?l8`s#4~m|d5)U_~Ok<c_<$$i&ktxP05rFYCt|ZnuRqo}Moe
zh23^vIQ0iSS39oxC-)e?TDyC7b{%>>y9C0H^hNy|W>Gf&nuW2B-Awl-D%{YJy)MIL
z)$0<KSKl{WSMWN;Wex9^mWz!)acpjemw~&L(uX=no8RNl4E*vkxb<hz%V4(FVDUQe
z+SeQta%>SNpL-*z%C+;5_2b5hCOW(?_*Q;!@q6`8ue@9v*6QUn1W0zx-(1svsWX2Q
zvpv`4>uQzJXxDfTCuR=!wCd?wB=z`JF)y55m?1Zx%eiFJ%Cz<dWn~AiiE29D(RnDo
z>{`+H{i||HyAIdbq`Bw##FEvX#a;Wovv~DJU&V5b;)j+c2@RYeYxQ66Gz_Y2YH^;L
z00P<aAcre*jyXDKoIm&W!gqyNf0n;y*QhZ)V%Pe!apN1L{teO)AtAS#cvUU<sIz^s
z%9CKdCtYv$_TJ)F&L<x{knepfEdS4yX_jiI_O|}IXP^KIoh)R>k7S6t)~Q#wEgmdi
zJCI#QX#IuTbIE6FnbIbz<w~^(Qj=ea?z~rCHut-;9tyol5}VGLxfPSYu09*LJ#1Ri
za^~6MLfA&%pG}I+8vf<|(I~UkE9D)onS1WOR{dSI?gHJgtq}!-aqBkbITZ{t9xYDT
z*`Dy67goO9T)ZLA$)e%JRq3u5tEkp5YQ6Zm=M_i8(~7Kr4BV0M<HixswH%dqZda-z
z8v1*mFVgQ0t1Z7fk!rJ%nIF^8-TS=XAdgr4!Q{wUM#Qf*TA$#)y13CzwSosb$Nb)<
z^3$4?+gLiy`OwwUJ@nKS$L^k1Je$}!$D-BYVZ@i=!ijsDdy1;(d4F(7+``Q?8aZJ-
zq@(*h`?;-))uB1()Xu%ie&aq?vu)UR`rd)2-u@dJLf5pHclKN~GzhMJA1vP5RJ`?q
zSLq3>gY_QU&NC0U5V%vx*~%)sWKyedMOn=E$=Q{OBj(M&?(>AhE6E`fo6EbZ^>`ay
zQ~pF$bqdy9GSgKw?y{qKbU?)ci;1HIu5b4XXip)-YYAcB26?JUylCqau28k~{zurS
zZwS^<>P=r;yn4hp^oqJ@UbfM;f{)iH47f^zPg&K-e$U}lZm=T)FEqAao+B#Icb!Pu
z^_a%g%{E@OMZA?)Q!2l}L6PT{Z8th>xOMYSb)OxLUr+98`;BAtO?CXUW5ugU3fJnR
zB<JJcMeeuga{~`jo4tP7;in?u6e^z&@j9;B>udb<o8fKwtr0&(6y|-i6@0!L9(HKU
zx9+Ap7Aluk3<M3AMAUiom6YD77++z0A%q}wDY--(IYRLuA1WC!%O%{8L@qG{pfhgj
zTh<zbhsKt*pNoDu<EdMces0^|>!ib<$}jk@U4I7HrSP!fgSt(1O(ebTYCTQ4x~JA!
z<?re}SLBivas0~aPM)Fhl0*v!{Uhx=BmDgCzv8`_!`s&!e?kA}FTC6Du54(0YI?@t
z{pestzj{ONa6-*pQqTC?Gnr1$+Km|2+dee*gbKbiYN&dicpqEV;BDT#O}&1bdV}R{
zS25#q#>VBJT$)=1uTlT8B@3WK<UH-OcA6Rf3wdf!mZ}V<zc8su8!*3DMtRhDoP4i#
z%6IoKf{?HCl=ji@e^r$KYwz6}`dovZcgE7Q`&OBn{_JnMY8Tz7CO~?rQ%v+@aQgEj
z_Qu@VMo-z+&YQRB-Ipr=;hmn-n^xcYP#(|Fej2%~jGNPwFIBr|#ddLwagV#YCVM?M
zw<q5NFw16Ovpx7GuO~mqs3~fpi{lZuxT_V&3!U7ad$lcXYQ_884F*rzoqAjJRQ~EJ
zm&)k;kyECZM)!=a^(!3R|9DN|+0n6=kH_tQbG=cVALSi&Lt?OOl6Pp*LA6k~k79(q
z4()z=KEGAdT_sTGZRl0O#f8O_z9W*krlt4ZAM82QoJZlMN+N}Nr-V(c2XVX$R_Fc)
z00960001EW-#gJ<B(rf^!5lSp)ic4nFcTDnrlV#>?lR`;?xGxC*NRw|?=q+C?^37i
z<0eK&R1oH^?$+Wi{H2eQ4d-s?V^Pw(ljTun8t*ZXy2pXkJtk83AX5347w)0#l@{qj
zB(=H46QEdT{1Jz82_a5sOIRnuxsy~&E~O>@aqYpH?Kz=MA)cUher|hCpl|9}m)=V;
z6?5b#pfp}!RGjPyn5;V46Bx~FORlOhJn4sW$$(C3!5o&F13HPOz2nY$G;--|f?wb=
zPeNZUYd8u0>e>wonNSijp(J3!>=NzEDanvehD+W=>ezpsgc(dk?lnZ@URn@JS!Cp1
z7|LbjUKr-}$Ye26%$TBaF9rU=C<G0-k5TSEjdJ%%l)KMCx%(L9?jy?e3Wp{U>^_W6
z)X|h`9hG{WQ3Qk5n8&&gv-1e8gu3^^EJoc^26a!lsC&w!?kS{hADy}sj_P0W?GC4K
zcx=`D6gmcf9a><+{frIwYizh*V#ECoHr&tHa6hr3Q!w_D@mj@^ark?Gm@liN8mV<S
z($0?iG2aOc5bJnaUAuwfOLjwZNhAeGyVizuwndYJ`(drt@mj6pwXTl0hO7Ir5Zn(b
zCIqJqAvo<4g43oDoVE%<+~5?4nmxey`+&yZ2PFPJ;Nb5AjK2@~21-{mna&TOfl`Mx
zMeA{joz4%Ce>e2)0a(CD{h&eW2OSRYLDS(qhz_q$<nSa)KZvoi)z>|w`nrciU-yva
z>mJJE>mFjh?jg<BJtX<MhwQ%YA=%eGr2D#uT)yrM6QwhnD4mf+>5M~^&M;9rqxm|Q
zD4kJ#-5JH#sa0mN#%I;FD=3+(Rhh3LH(wj~e7iuNf#s3KQCnL>-_xO!;1^t;2<sVG
z$At9@hOmCYWf#7X*oC<IusFz8fMbKWSug|-GwwaCaqnS?dk;If_b_r#ZM>iMT|YbZ
z9;V$9VZ^GnH(p~H{;q4+zC^1rN$YWv*5f2skCh=+5{^6!bIfGnEG7%8Mg~0UpfT<&
z#H++Hcg{k0HVbhUnHgzYG{&<;m3Uj1Rxm;@h#R@oD@tt$&Vj_RDF~w@5*mvG3VkU^
zDnc3j5){K+t+b0mzb|R*$6t2(eJMJ;Rjai&MC)saD(_!{VY;}V6R391pxQa4T2YFT
z?Hp#45_Qg@tqV?PDWGu%!Ol@?Z6ny1HG+K^309_+cF{_^u+kn$FJC5p`-6#T@MY+u
z)8M>7gYyOr&Z{(tVf~}iZwXz_qqmaiavpPMPK5I?*-nH<G$K60i13I{gs`1QXj(WJ
zNQ~zr&{N0rQ320K4Llze@O)IoGlmW2Y<|?=IiO?sC`_<p_?U*_V+_N`R16<WFjQ;w
z*1qozC0gkvTInTWViA=NR$CvOoG6SdlxUxqz=VXjkHIK&O6&=3O3YlZgN}S&><Jhs
z&WjOTofqq<l?`&ti#>suSm(u_;M*10rxV51{wK&xORN1)zzlJd!xR3w4|9{l6Lc0v
zZs=-DLtCT`drv^MSp7+~Jo4n;lbERJTOyuh6M<^UI0uoQq#X_dk)EXNPQvX;nCjdT
zaRGgsT~t*4y%6ZHvfy{YI`Mx&nfO<LrRJRa1&p1IiTw*SV;OEYi$THy_61myEco%&
zw5PPyw5K$`hQGW%&5iY$mK0!IxeG02w4kFnxTh$V3Y#~V%)TKknSCQ!G7H=I2KL14
z)Hk44ly>uA>=|vv1%G+N4c-_d?vynB48}V$N1lOMCP$uuD@~3(gJG<}k!LXDWgK}1
zHk%xIhE|?*bf1BAh^|JyXN@B^&(bDC`qt#-bJ`yA=hz<d=U{+Bwdd$m5)WCQBa0?y
zK+h=wgOUL~2jfAj#WJ9v6&0gzC40eRfe2xWgZmZ^kIln;iw-2Fn1lP4GOP%TZ=r3F
zeEYZL=r5qw^V**C=gF5!t9Z}D5OXy&a7E9n3wF=bc4dA1&yx;w*?OJ?j?32bp}=Xf
z^*rTG!DdB`o-ai7RI=$8e3u)O_XUHzFA(=x{O|(0EQ7u;piO3y`T`o)PO0dOy#kJ@
zs{&{9Rd0pnFKRT$U*2F-kF)7LEs+ivCoR8dU3q&kS$R`|i%mMeNZUO)onNGLpSlje
z2wN2_H0poPJlXI)$H|75G>l)epKN%^oM3rLJlXJ)d9vXp7-OGSeu?%D#q(XY;;P{*
zT8Na#wn8WFOkY8-EyYU&SL3BlTA9nAzk(uXjh9}*0LS&|OfeLA1s2Moz$>swj9XrT
z)ndH#W7{^%AFJCeHTY#xy!2z3D}$Gat^CAT^o-d56HHh1FzP4l{Iyy#)j_+TkgN!_
z`w7gKQT_>B;S8gGieXe6#Yt7Np9V3N;=zB4W?$C+pN7jOnxg+S+%Ls|^GxmkDV-YE
zwg0E#eksj^{}k49yZBR#gA2tN>s2krdexsvNc{4v&{N^wtCT`<zx*o3LKeULDtbl1
zFTV;SK&v&u^vimn_L^|M`ZfK0by!95Bd^hDnICx#?VsUCUZZ?Sr`KyRBDtzXftH$X
z<Tdmyq8sr?{xd%u46FVOJzLbOiR8~sbB!SFf);MFU)N0b>vog<x@ods7ftr-rpbOC
zO}2BH;&n1(iP_eW`cLCDH$wb9{~VV$G+f@W1vzg>K~B^{sn$ZNH`Lhj#RBg_wc*9W
z-mf<>vD7y=y+J#;jJ;oPz&2Bh-+&rZi{F6y_+W=lt6!RXyMF1|+x4cFX}n2$yJY6S
z34J+F-=vKn2J_!ErQ}VN605&{lQsZr{+fI1cQkJ;<ZIBL+v#^u8zm1-aMeTW-wYNV
z(K|F_CT`>LORPIz-hon<1ilk5vZ!rTSZ~022WA^B%nl?;ZQx4zXvRAf{3*xnbWimz
zdMXDgRgro(nXwCp@ou<R&gU5ysrR(KEAP>sVL8QC^yWQEeYgvHFPuHlwkf;^r6w{T
zSdb|+v$GEZWR$)?pyPF^u%Bqn`2(7&VSBVcfMIp*+RszJ9K$yxe*l*vgQ}~At$@Ey
zPS-`G`ZW}5p7PhwRUsXgnx694bnr;tEB9+eq)@jgzor>QVF&1M3@ZF4VX2bx{RW1r
zRfc&T^iAi#F)8pHn5a=8!S=VBVEndCg7I5PFn&upvEOSl(%-^3wZeEl(%<@r?W=iu
z^E-nOzf%YiOWp5OI{c2hPiagJOMaiM>l!k85oOeo{Xwy*co&1gDM{f)w4`!aco732
zBP_f~i=W(~TnsaE&7oYRlV5&Vs6<B>VW}#>_>=k3i?k(B4~{O<Bq|S%F2W{^dGzS$
zB5W6;ql>W9jE*isjzve>()wT3rFHz_bq$;K*8mdv`>VgA9LXR4^14Tte8u;IwO3mj
z84s{liN-#JqS#D)2$x_2(UeBts=#^%``qJ}KBUP%pSZC=eW<OEeh9;qk>M||C!LFJ
zK<%i`v<UnAKcss;WGp{~*;-q(g=4cH(n*RSd@w`EznKxl-)KrsJ?NTr_mLJrd}P}k
z{*ir?{YTm+d;DcaTn<Wngs7Mi*GJKeux1TE!VK3?hmUCflB>f<G=C|~Mg85R&EHvc
zrHST0!U@a3M*TyL<NpCYSWx&6T1eH6=|5<B%a@$^koNxx*2+{K{4-d93J3I0nx2t(
z@K1g+D;e28VT`Kj|AeuO%>SfGfGBi{yPc$UJIU+Vl8ZG-`*@lztxCz2(WI~fTW(si
zf5JMGb^nBGOxFDqcEqOvOq2RAVRANvsb`-5rJh|58~zuPPd#82{1#?fKh~0vkL?N7
z$7ZPfv6xVOY$jA6TN5hftC@@uAEW7K_WEPGawgpTC&%AAaMa!P5ZpWiW-KZOUx`t8
zRAgCN42m5Gf`bY}tP^HI`NVt;Op>O4f}$DX>`zcOQ%VwoqJ`4@Sx|Jfqs7(s7OxRz
z%z}~{+ebanZHe<{LE$KU>MQ_`lV{I@!triG_MqiFnUFm!S3(A5(_AxYRHY|H^>$HH
z)H<xKuS*8Nesa7N6pl0uO#q)@*qQ)7#V|Jkd={Hh3!w9j$Tfg36&EYXbWnLOHA)Tv
zwo{j#w3d6>4qgU@=Gn^tZXUl3;N}U;06tGZwwHDeQyctM=p8dn#%R_hL=aft$HMwf
zMz|8zHmT9a#ri%L*7vcnzK@0VeMHvxv9P{R$a?LdXi%`4Rb0b&x&+`Vc><OS`>J!W
z0YICE4M070_Vg7dV*|KtJ~k*Fm<%tOlMRYWpnz4Lm}kY5YV|W$(G_r!)?z;jr!_AY
zKzm6v>qoZ?rt}5W06tt=Lk)_=%|bC@`>P>u2xyyz_UE(uniTYhGFE%CfM@^cTt5@h
z{<Jef5Z(S13Jap!pL~)by8U5;tjPUgo21D7p;}ngr;-8YbbAP9JRTtNcz`+Y9)NpG
zOddc2spppgSeSqh3d}k90PdKErwW6V2tN4T$46f@OM|0WGs^lxpeR(s)Sxj0ctcE~
z(w2*LXE%)PO<;wWi()e@6b}=AwJ0{j=&}GqY=)t97+F|Qkd92ADIz2IynYDeQ~Oc<
z5~Ptvv=V>!oI*4Nc-=5{4#Hw1TMVj<mxZDPDgsd!nK=>$vCJ=oS`uR_9i^uAAwW#c
zg0j(;3^^#R;7wJu;V^nobCJxOQLswSKm*`9Gjk3Kwu*u>inhTCf-(x~q!gNpMklmP
z>LW1bdjT^VV|+p;b@8{?`RcT{IyqAw3&|Lm!0JwpBv54RSSS-1JC;_TeRC&rcC3Fn
zsaC)8lT2F#pRAYpGM1KsR!1kR*>J}t!%e<GptKwo6tR&az`N8s(oD7*1BP_A1$NY@
z<#CS#kjFiaUXqE%U8@hHl&eB1om*;)&n&g=g9!@fse+&vEfeLn6k{t%UQ6jZKf|z<
z!nLwLEQOt32eQSidcBfObKXrdW{*OsZF!E0%XqX=W?iHUO8Gin02P+%f&xAT5kTz=
zc0oB?v*VbSOA&dwD<UtqMC9d`h`ihqk(Y}Rc{xVp@fwd_uq-H0?{WwV){5+?;OSWf
z9gVTr^a|)|$G9R~+TfT~(6X0+aYeXqmSbE&$IimFU^A1d#7xQ+Mp&}xN-3MJM4h#w
zQ%Tp93g}eQZXf}jN|-I8Qwa-<m52bojL9xSOp;edr>_`vwXrG@z&A^QV<o+nCB+Dp
zuuBXaE1^-giIuQ7iGPHUW=67@5d1XO69O<>QV4*2RUv@()dhA2x4bj*E-wVN%G7s;
zv<54AgO%nQLr^eFU1l(nzL}yuoEa}R_=S;p#>AM3F`hw;nb0>*tyycsU5<Pfx304+
zD;PnUZ4o0VE#XalqNR-B6Ja$YC=eDjf&z0*BY>OB8Ub8f*`T7?B0FYV*M6vU4yWH7
z2mR(a={JYd4*~ygk;)vnN~Y$VFv~TlIS00j)SN?Uj6lsf&|stHT#=e{9jirDK2KdR
ziU4Yl^Z2q+0OTu20hBKu5%h9n{fMCR)g`15VCCa{>q1gcs;(skkg+Cn=9?=@0eBK0
zh;3adD4ix->iOY)TeY<eyjb*7^TTx4gl`fVKOa4Wb(M)KTxl*eDd0jK$1Ba{rU0z1
zI3*x?UTOiKLRes3dJ0OV&~JgX02LJQHK+iZZy746HPd9>0%I{MfVO2lYPq%^C0&ST
z-2N1NHrTcxMMai7pn~Ed?q!hWv@^r8Ahq0o$|!y^jg`%ocbLV6w)LFlFekc*Pa4t!
zJ|y<>`q&l;k>d)C9PO0tzy*FqbYxvK1}pq28`Z+C@Xtf4(t!}u#;ow?ZS}*x0erZ4
zOgbo=V4KrjK~EzZXF7tC%f*mx1uT`F#|l_W=Su@?tIvL~fGyC@-1<dDR~Z+<1<+!C
zkzxSuZaI%Zr7J~Buk^KF?Q*3=*OeB!u5{3KrJb%Tt#n;!q3g=%wpj+f+AHKia%9+6
z@tg|*ZMX$9s5vO?O^F~^!Dz328LKzK@84kQDi{mxO&(k=^5ANp2T7|})8j`-1E^u(
z;Q|S+rc)(060GJVSlwn4td2>bLq~+Yan#mCsHthi8iv^#YBZ&cRvX+}%85hEB3SQD
zn)S9^L?{~YO_;k_3^)}z4EQG3&FVpg5l#cXi7uFPH&7uymlc#<p6}!N%Ey8=-i+4R
zNhu?{+ANCbX8!>u)l6&-W@B|Tv6(ht7|wY!O-%@C^k#oOB}}9Bw#!X{+>C@`2lNB*
z46n<g05u8#Sm7eknrx=S+=g&(R^od}o2s}rA)sv+Vg{9mD%(%vRDKH#)qB|jBl!aC
z7Jrwj((xABtsyMH(o;sA>(YB0(hWO;r!n+N{Vgy>xUVNDnE~xt-PtiU#3}G=phQsO
zYv>%iF)tYl(pDqP-ztUqTjMZahfcEddaE*CKGbc=P?HZ3s7!yWCEJrL$E9h?>qHf~
zPI;p&_&rFn;@8p1QA6~uqggtK=m8f!_#~nSvFPd0QT7Fc9g;cU!BE^0zT72jYNq1q
za9?wD*DE*ZyY+BfSe6R5;xlW$+a8YZX5l!0Sw5)4_JHvwF175Q+D-3&yR7kUT4T4E
z^4<JgrTOt9w<*t1VC|q0V_+uQqOQl$86)1y1Xr!<hCG8Ih^c=W;<sSPGpH}Zd}szH
z%2{@X9+wu(a>h1~m4PMZ^hGARu)SJdb+6@HTWZx?96~_8b>CVHd_^2;(R$d|ee1+&
zoH{-!rp~a`t1~RIRcX+UtOt-j<}e$euQV;vpx)mc0vyvK4a(kiR&c2_Ez%HPTB&e=
z(IF?#XXM2BjGR25ku&Era*p|oMn0d>=$y}J6z4M<ZSxt8;(SJ9o8~hbrTL6TaXzDw
z&1Z1BHi`1p<X#hO=CiH{_@q<K&GZzQq@vAqRZQYDC40Y5v-i#elA__?hY6U)@KaGf
z!@m!i<S_jEl)G+t$vn61-bcG+EQWs{tjzcED!1XMcZb?UEG8rSlS4|X6z+%NroG=!
z_h=hZxSw`^3if`#fBl(Z@AungRrk}&dxE{+4~tE+zCU`1B{3?hnf#RU+E!vFZ#4FY
z#m^V1ZPOD)f|<OLPh<P97Fo?Cy;LOPc_T(tf|<NAS>v>r$pi8}#skK)Y9UlIlLw$D
zH<JNKHj@XrF*xYlAaGFJAaKyOLExZhRS(i#sCmugL8vfkeo)C=ROk$S+E=hTx4Ny4
zYVO3zgIn!Z=T>HQ3Iz4O)opcdb=@=(RG4P9Ew|F5xBKITZrgHLvMmxxn7|%RZW>it
zcUZD5heg|R*kW4_%eLjP&9)r2*p|b|l8qQ0ewIgvpXJdZ0-Q(vf;t0}(|+Q7iur0v
z2=zMd$mQzOkQMXfqrQ5ov^@$vOtm<Q8s5R2mOY9gPY`Ib+QY0V^6la{Z>Mp_>kq;>
z|IHZZze(f#H)Wjq#KXTqe`sIJDi5{}^Yi@TuMlY4$ab8Yx#LbVcU&}c$8BcrxM=2%
z=ehDZsFU3KY%yFXG{f}?mb67PMh^~H%or6p=0H!-H96Wk6E`zdgWEW>&H}Gfq)ptA
zo!}>(%&%8lt>6iIdC&dvwQehT60P9>5Bf6EJSp46lQ7A&i6_y@nKtnxg`k2>JW1<y
zrcFFaS5-<j@gyCe5p3c~<^B-KCf>_!;=SA^-rEM7cyC^tc%Nu%?#pKrPaC%8v}9{e
z%Qo?}Y!gpAY~lmrI3KXs#F&f^v&|O|L!YP%akAix$yId<wqG<d|1V0J{}<!TUxyCz
ziWcTtvn{m@KFWMQF7EQIF*$TLSPay=Jd4?P(513Ec9vGhCbD|N!a*2T|E#}0#%f<0
z4vo|2OVWn_FBu#DV>HegXq=PKI2WVAM|Tc}@zI@ACrgbHo|nARdAnD7gnOk&oL=b>
z(JMV-^Gc71Ug?oGc%?`3d!?^xUP-qF#*I3`2mNf0hl=>UI^1}F71h@2H@->}k51P_
zHT=&B#C9@#l^%#tuDB9B!`IL=NH`ig{5A7_>Hyr+6uhrNFO+n?ko7gV#Os<;RyU+6
z^~a$o_|y==uk-760$|Uux?d(p;@A0En6J|mdZsx=5UIgYVT01>{yiR@Bsmu}$%)cy
zF<7}k+tp;5p(01Hase@RO9a(O1WK$hR1uk4-hQcegxdUgIwFoA``a@_nR*IkO2@tv
zXXaCKDDf1(AUFVa5v1uUlrc@3Sm|){NN6My-{5Oa2yo1Xe1qOCH~RkuJ(?$;@OwJJ
zP3hxlG?v9XGFfQatF`kqntAI;|0f?Q0=ym+3esZ>L2IUz{!jnHBWY;Qh(mh@ht{>V
zW#`P4FurF{Ypvt^rv5rc0P3c<{!Jn-3T$<*Ce2H_d;RDJcc^YjH#NIZ`erim#87%x
zM9IG_+5f4w@+|Eax8d>}r}cC6yj(<U*;+goo^v#Z^(}E&-%=tgt)Xwl4GANAo{tOx
zUe9P`VRPo-=q_V<aNiaO_icZ2y*>weZ2s-|K5k)XFYuuu!0R3j&2P*c*b7$G`HncS
z?<jGz*3fq}s_{L;{{ebRg1@~^D|24D>B``yxCD*=P+t)Z0bb{Ns!LI?iNb%-60L7_
zw7~egJiquZ&o2<*btUgZ<`-jiv+3`m!o|as7vEkK!}b^X;+t0bJ+fj!cEDPDNs8@W
zGGn`_{{K>M8xH_|^u7?_FFO*F{%Vcc{{Mmz`LO)o#+{uZ)Pd#qX(=pNAmYvaKy2;@
z_Dh?o_+@{ere@$?4xVsHns}KW?nDIyewO~_c#Tcy_+^T>cR&r;PQ|^#-#Q9_ouxfO
zuP_}|%YKYvA8MN!vb?H=EUI9Nq3)}saB|o}MV2chgW|rnn^|6^=eOdtScoTHqX&kB
zp)rEJCIyJEq1daGQ4+eJ$%l%5h8k*|qxl&WM+-Ue#fJgBM_oH#9Q7t9$}NwQS{`m`
zd0bt)_ATo7KPN#moBg>o;GbIt{Bs&`;ofw!-omAF!y~1JhgljPi{ss^e*ZdM8E7{9
zx-{O`E#rNi##?}rpfyk~w_75$JJizdn7Vcy(^;DGs!?0{Pib`jX&K#r(&*Yx5moD#
z`V-8mITUs4m+~vjQISKpeo1teb?cY3;lZU_Z_-P@(%6`Cy(uZzo8h4wLAl<70TPei
zlBoNZg}QGMbpzw9w=qd>dbHH^2usuSPTEfO`(Me@`YUO~zp{+@SH84nb9w_4<aPyV
z{gp*pe?`*TUQ>d%Wn=KRG~Bl>!+qN~2DzO(^%kbc4GYHLZHqB@n~XuHnoP5yUjHSH
z@4qbL`!8R;Dn#{q*HEu`larWnziU^ocZGM(dD=@?`)WzG_I-)hGn>n%8yZ{oresBY
z7b@L~_+F@p42vSJi0{dn^Lx@n@q5wi2!r-_WX|uA8rj1A_j$PgKIKU64QB7ti!R0>
z-lw;<#2nxQF$eg7W<{hN-~%)?*75$DkN4M<KjV1Amdsa;f=agh`8VR&enVrEvbx{6
z#`ar2HoE!u5*%CBKZd?5O6=q@{x-A}<`{n`j`4T&aGaUk{VvWCg%SRqkC5*1?Wc^;
zZ%-cI@1q3C7~dbHxb_eJyLN_@{DGD<Qd(fE4CjwD8yBPkf`RypW+3><ZqY{kh2}bB
z8$m_+Y{XxX-8LKX7gVc!HsUWZ%WWg*u4EYz<Jj3n*-Tsvk|3S<7ex)dNZ00B&BR3*
zXBV8ma>1e7hx4DU|0{9Z7{^~>h((e<6eayb+S(*piVtIvjD{S0rN2>*l+Ce|*MIZ(
zTq#Y{eZP6F$KR}$?IUr#AJKRv>+z9&ynh$R`*%LxzlY;>T9Ut8$NLXSQ~yB;v#F{7
zpyx=en)-j-2cQ0>sVbwe7%cyb?3S#lROASj|3z7!tbhNa-A*q3`xy1lGCD@OkEL+=
zV=YT((^UoS^yw=4ZJDmZB7M4w0IumOERUwEl2ELmJt|fd=xNQjXX;A;_oNlp=&elW
z@a9JG=0@e29>OZ+N_&#f6m&3zMiFyKXz&Z0(D+4mp}}IC&|r~UXbOr#p)p3sC%mX8
z&!Z65k3YB&fO}zNtew?F*Z_0sJLW<$XKL{$2sg0uQ0c)0D(WbRIs)yJ#s!`DP&$2*
zp>&EPA4w{@>SrkBMn&o9YCS{g7dfP(E4|GvOGj5aA>xvbZghUpHA=p>guX~<8f^(c
zsCIG*e-H9H@UvM64PS^zmP-p%Y3qi$U%}<`*f*2nmcsXT1MoDc(7&DM70jE<zMUz5
zdj-rAMWZ_xjqaaBG`icRw1-Hw9*k-|#3OA5{@u|jRkgG+_DsAR@3vRet#Zl?fdj>M
zdb{G;f_|E0i($AZ*ZnAdlI5C;9CF={PD9CZO?SaM<+?x0wPTEiRQDJ8)8D@oAz?&+
zGI0ib`bX!+<(rYPe1$NhfnZF@AzOot%jxh6LkarRz3HYP_lK#v67+|Kh7!;XwBol*
zV3z*vCSz&@fotWDuYt*;23^86=#n-kZCF)&7Ke%ki2NDA_%p!2MZsVYT{!E|pMiG$
z86@e?Ah<+qXRuR$Mris|)Y=TY#Jw4fodr-F+q$*~cMtAPaCZ&v65J;QcNjdlh2ZY)
z4#C~s-Q9z`lb>_;y>)Bv$~pDV)bv-qdi7H+Z+CUCS?hZ>t5fBHMT6~J5TPx6Tozvf
zi7I+-G%MWEk($tGe4(0nr59wB7C_%{Fl7UTiF^sm8|HyPp~~Zwg4GHtGuV1rxE#)y
z&}FGFc|uXb19MoCyk{>x-M-o`txMJVk^5LGa|J1J9a&U-zwOaO1O3%Cr-rxf!}<bS
zxluv~_JEh%fqkucvu!m4l~V!>%hQX?pFYEyn=z*(l?%ETDBBaz*TGFbi21<x4TAW+
zk!b<EkY@ZCB<kGL$MwqtMxH)FUm7{k@KI(!^!+m|a4TmF^ywpbSWpeKi}ik45$=+j
z19XGC+*Pp}t!xXk00t@nne4)K9+YL-qwHFnOdInz5Z3Sf-$(Nx@SE8I9<XbE&iCwG
z|I-s-9PXFVI*`!K11SOV=IL<7vR0CM){E*&k=kA0o3E4_*X*XLmZQN3^%QH<OUO9R
zQ}<`>h+`_jAbF~amB%VhE&I0mu}1v~p|<s7qRo<3rpXMTqmNN8Zyuc8>`jt!%y?WA
zs9-ezJ@W^f9yaG}nV7z2Z0pb}nc_UX15A0}5MwC+QthC{mZmj*>%_>iNkyUbezU(}
zMd8xeExSnt-^DinzI%#!Mcn|EKW~rxkz|$v$-Hgy>Em#gYtZaAVtPrL_@%&MmYF=!
zfCxuggb`jFGNq8Tzwz9>i(OS!|Mqx+h`Ps+1a^$MUG5mZyke^|%oM&n3cGCL{t@F?
z%Gq?;kz9@D)-Gpr$&p=t1Q|F%g#|CYZD?r;yPg`Qi&}h4X$h#QWcXV}32S6&N|)Xo
z;*8qZW`#x2oZ6UK&0i%;YDW*_c1<O?qiWUNNTVkXpH#2G)KdeB_KYg((Q_)s0v_0Z
z-^{qZE+TUOx-w$h%sU#`ms#dq$hUUX`zt7~6lvkL%?*w1DA;7|@7`$LxG_?5P3-ON
zCo3p0w94Vr5Kq3;yLF1kz|f;xU68fF==Sm(qA`u{fMM5lK`_SfZ;}<l=<eS6gi@e1
z4jzGFF9~dZiO5r*?|H*>QtIOG{v=!}+i8f=&<DyJk68JF!^FXzLFMoZ-|h3>vgIt5
zH&ze9SxYjH7GkM&J4kw4Hng|cm(thySf-{oe@#|*x$R#e$+@PRXO$SfxnmX-EZfAV
zOWV|w&*;*~p2?@1GC;_<b7q%(gq&#a(m47HIk9f(-z8c)t6Qvze7gG%!6R3VJ;tkq
zjBIOLtY^rHT5DTBIa~f+g0Th!>)9_tn2R07Hg9*pO^dgF;vFi$MhG%bUn{6I;%rO8
zKBzuAUN)RrkmmGEpDCzxT)A<IkvBM~JvwGjwW)0sY-E+QMf25P5I@@gRUmf(89Kl1
z{+!bX9h|rrH6d#i)!GZ4n7FukhmKFdR4wuzuG~Yyzo)LqT8YhAU81L=GXVt~h}2<w
zl?aci-fQk&p{MHVf5C8ri*Iw^B4|Naf*e`i{KT2c_?69tG?fzj=hEIM&I3o%)S<u|
zHNEeL(j|@5#jFC-nD-QF>WV6JCW<P30@7+a{L=9wv8qk{(rQGCDo}G}UUk{G7N-&s
z3c1ppkw%MVlq(sWv8SAGN7iny3TlVi^Z`7_SA1$0PD|%jbN4-mX&Bhe^~?7?R>sdj
zNdHE)Mh71s<loit6=E^g*Yo@fQbvLB`_o}qSnhqvx^0>B@Deuor#;cd-DPW>=1o@k
z>0I^FPn>t)ab~Xd*R4)`))M1|z!kk95Ff6JUKD$7O*&SHxVbb>zPL7<>{32uUta!X
zTtXZL!^gtfyp!peVQPktqS|?+dZb84@RE%&D#Vmr{k3Bsy%*rFsMjqu?b2%<?9yf5
zDjZvdg8~!b>0sEED{O=y>tCbJ3>fui;?|Rwa&1%qAewG3_N-VuLN0XY_hbxwqTG>l
zHZD~*E|b1~Su62JClv{6&B&)dUhk8v&wRID@{Y}xFsF8ic%{a#>NQ?Rv<Hl0q{Rys
z&Ykf9eT{8H+QXE*Qj!`rnpI2z^RC5a{ANwgq7w;eTkj_1qlt_!Src_=zl<Sp<`%=5
zG;=>d52Z~UHat$+RvuqjA?d+ldMqbl;o@`?S_ZW#i96-3te^=_AM4J@cywlqYbxhG
z$MN6|7bGH%`k{{xYTvQOp(x>(_YJnMpt~O-Vg?)z$OOBkcl((T&S?McQ#F2oy<nW;
z(7e42q=m5Dq8;zlW@q4pp6{lGaI6EB>a|${8!Fbrgq^~O9#)PqtGM)X4fT}_2-Rq&
zK5D~|Ya!%<z@`xBUY;E_g4V;z91Hc1teWA-+=~6hPhy)csmlz_y9uy}=h<q1MUO?d
zeZgb`VlvqeiVBqEh!7enw1V-LmXt|L`+Ff~+Fp<Uv^Tx3CLdXfzFo>r-k=XFdG8q$
zz@eKGiKdk_BAA@O{AnhTesrN)%tr_N#+gft@_kt0$<Oq_G&bo$mM{BOpQ5e<g{vuH
zeHdHEQRf#?ec3GNGyFpmE=trkg6J`15NotgSE6*5IKPsPTEtU1p&mLJKzV@f3%pd%
zGUZjc7OxHqI40g*Oo71l@1>aYvbj3v-y5}+`K{12=wyQFwwrzL)LWz{Zl0h&UNwV>
z5=jWQxwh*0*b0Xaw^;V<g!oFPW}FV^OEMB6?)7|riGpG4c9nnqlJnXoO`kp{$+mK=
znYkWoBZbgZCRtg0<j9j^er3p!OeGL<YnY3c?Rq1HQ(7m#d#n#*5K5+4cIi}EJ6yf6
zTWW%G*X^p_q1uW|guuvVKrC`dUrAm!wyx0Y2c>^sB^*`QRy9u-##FW2wJeC$aE6dc
z!eSzJCxWuJed?c)O&y}uHqp2SDe~lGt|}R}cQ>_unSN__KdmKFaNlL7?_IlK@HGXu
z;hcP$^1Suv!{P)@RVHhY54g%nd!{MkvmS1b*D#J>ziS7KX2-h@oSc?tc#4bG!Ego`
z!^9?qv5!%*0*;Dk%=<)SwJ&i6u#}-MaB)uR76ka!v7pNrHuuG9wSpI+A|cIM#&{u(
zbg6Dp*KmnCC@@2BNR#?X#v+Ujf|=qt&QT?nY)()_XjKIj_EQN+H{>fCd=PB*^O_%H
zqkfri72708JF$_^jlmbIVtBCWX3LC@RRx8fj7iBc#x`%Y<IaQeVcQ{uO_{$>_7e87
z8da$g=Fu3&7(hWKA3a5zi+R$cG>$AwYz}RF&ELv(;E)@lU=Wh^M`RKLUO0KYG#&7Q
z<qNZ?ubH0^*Q^MFLY`bvdc@|pDelU^{AlGSL0SbUJ$w3*ae6r@GYByW8V&Ff?`g;f
zsYCc9lA?oULdm}uy|uizNs%*SrngIEk}D0t@c566qY2qh^$Uo`rIX)m#!&I`f`>9V
z*h6B9)I&5#tJveqh)2eye`pZ-_$(0OX|VNm+uANLJw$R0syz2(nWuz&`hW)HG<i_u
zt!&^_m$vhs;+SBmA(VPLVhT=yr!PB)AAA2xI&d5VYoNAIh3#7_M33ZxSt!rQIcjCQ
z_yyoI`kAow_l;<^F7j5gopndZNZB(1jYS8TI4%8zzMSN#xdW^QZy4P@%yGKR0YRNK
zMB!ueI%n}JLqj2AoRHp5FQOkny2_crg(Gm|Rs|Gmsmwykdqb%*eeZR3@5PFvi36Zd
zcG7?`BVl4ANOynQemBNWK%jfTgHVo<u)*=jRiBYC7?Ub7f;_P|qGEg?uZ27Ij5QgA
zZ91(-6??XA4go&O>shP3A$}kHkZUpreN_O>D!2~ik0iLxaD8bL66rGXt#ze)pd~so
zrg;r1);g>e|8w;BXwo$`$TMFu2wx0VaB2!jg~>YH{s+ZQyCLngPCzk)Hw9Ss6?uRr
zvwV!mm`mDb>bxR1S9zw--p~ll5bh|qWYa>7cjnK1n!-aF{R-&9!}kOnn(3ds<0MfO
zpe)fsCe!_*bx{<6%)`IJ_E^1!GhZ}<*+tmZ3$y$h)Vipx6uUtBro7P1W#jbeY=tkd
z`l4P53*lbBTF`Dp7~yOi4#F$9AvB>9uX!!q((B}O6uaC-7Zr7QJW?28cGCpplVgf~
z3a9*bfhXqUi!)S4ijMsmoVXsmnsds>a?HnZ)yj#|&}Zxu{HUF7-gqWgylgz@iorff
z_l0h*9x3A-&F`gZpSNGlHG5#Hg0A1#tu~!Fnb$Le<e|@rL3zC>G9T?%xBSzRQBp>~
zMX_Okr8%IGv2hFw3@)6YMnyWHe9D(<f&mf{ck(MV!9YA0&o{*=pNVMFP$ZgurM8!F
zKsOb856=G%{reQ-wO!I_TMFP{`qUuwORu53vN22rrpu~6*|fUln3|aPLDiS&rq>=J
zHM(!(DOWBDBO6*XNomIV+hy-n_TIx0<+uZrFThc*#x-3_mwG&B(c**;f3R96%k2@g
zP5)DAI;3V*mc-|{SIgVMptJ_f$!~6{``8NT?ub>7r|mdSOL{<I>!|RaaR169)lpY?
zJQ>^}0%4Hnv+%gRt>gF&=Rr~f5B2+^)s-~1wlSVFYg9vI55`Ki#F0s!#!rc);LLdX
z(TYLiU9`$U@2mI&7)1}Vek>Gkvx1Q8FL_sz5YzoFk#Kp>FSHNR^^f_ne_R(Rr5${-
zU%$~lXj<T%Xq$h0_up*ovrIpD4@Y(5j+IX9@0G<XZ;L<+3%Q^<$3~Mcj--*@IE12*
z4{kwWtGS@Q>tBZ=d^In>W!2kyi;D+txzcJ+8@J<Tcjmd$UdRS0r6XtZ<0}F$2h3x0
zEq8wH3|g&J2MipUI2-SDuq59)xpzqSMpi4h3l{riC=R#S-flcnu(bKb*@j+s<YLUv
zC#h{cxzI!xeqd^Rpt1(G8y>7c^>gKNqiitZeA__^tND2fF3;Ym5UcB>5^HjE6LZTx
z1U2h2U><`oZK4h-Qz*^Y$@=<LkZ$dyvvimtLNR%p=DgZVX4&ZV1BRqJ_w4b{syf_0
zW;l(<tB0BPvJ$l0nW>+}%kwizC%4*A9<xs6@ajfc3v(M2zigk24PCSaPtTE*K;U5O
zhI@hXzj^A`xD~v;v=%XL*-uj^?dK9DGJ@u;gnDPHBA8@^j5eRc0?ygK+bRYzl`?l8
z$7GFEc~aR~z}3TEJYm$&2@0is7ld$BZLj{B@AhzkXvOl7g}#|;rIw+eiq7fOTl9@B
zNmoJXk!mfd!g_D+myji61^)=PMn)Zd1-~VI1<lG+Mqqnuq1Vf`m;U)?t1_)p@os<*
z`lDcIkZ<{tU}%A~VFRPV#22&03{TF1y4e@{eaLhp_1+A>(~sY<oU1BJ;wm+jwJ~^?
zsQD`&A%i1AR*o_XO%cArh=@m|wr3P30`!o#-Eh)f23D?_=Vm1!-8~nw4DGP0-!yjD
z;_ts@B>Gl&*G;)sFzvkcbYy2;_qWRrm5!Ku;xlqYi)4MYEL(GPLwn>bvnRi@);ty#
za}a0Bq8p}T=(kD1&LQ;C?tB49oQv}Eb^aow)1{vkPi927h`_96(x`8qZM3oAl9c|8
zoUQ@8yd1UOQ-9$ZoT-r&Jndd;!!zecoP4?ILPHzLsb7s&bubJ6axgoXllppnFblhR
zi}-ZULvsH{e1jU7e}9e_an=%(`)ng9d9Mco31IF2O6AH0l*iG(xwx?g0V;o2fMiR+
z?!<Ow?;<gAdQzB>j^V>~+?R#}BI?S_YG}BudYP^OgkYKUIBqP>*hwN#TscR5q0IiC
zEU}*x<Cz+)N+0y|Tr4`T1qz%ua)Z@%S6_+Rz$#B-C$+9)C|H>GVv`bIB>AmUN!lxI
z{ZNg_rdT{T+TpgJtuVw$nTYo5<2Qo0^b>p4WxS4_l}uv5eXTEKH-g38#vbq8kb%h6
zC1YMkFgMUYN0?p#{V9Va%#j99VDOfLVqO4^CbUN|i*xF0S*DpgjNmjJ#v|h?%C-|?
zaK#HxT#N+fQ7Wjf#zs)LUbs|y_cBa9@joOkd+3GO%dSu;37>(2??3(07g3vd@1zCV
z(y@t#>HXlrEzZS7Vtf2hAI?HyAwN>^SMPw!!j;xHSVkiQIj58b;%tlI{aehT*7k0(
zLrj8#SozAV-o>%wNXq%&+{DM;C+w9^&v7QO<O=(3GE6Ch1@S+wPMJI~p?Rpi^z#=8
z37<y}n`Bm`9{B{IDu<4JDn$$&2`@P0U~`>>#nBD?yPnQ4%dN_+O-C%1wwz?7E&VFH
ztlAI6hq%0v)AKPpg@SXMolg&baY#OJaEL$gco3%m9`~EQ6(VsV9oHl(K^LbEqU#2U
zLr=|O>h1+9i()stgkLZdunh)UCqGRuO!*E|c&6VK{-T&;e?@BdJVv6~KNhpC(i?l=
z!^<j}vlUkKC+LV8x<m*e=ujHU-h4&K3x+y3m{cvQ-hV-;#bV{~0*hC$XdNoPERYW8
zdNir$dL6T};If^*c44RYC$b&7ag}|yoBHY6n*Spho`^DPn}Me8ebP88{iA{B<2tAG
zB_~E$14ftOt^0Modk=+vp-|;aW+iJoVH%psF(T&xd)fl-_~JEZ81fRi)|<=C!HVV;
z&GM^D*+j#m_~XeN-(iTZ^KU};!5QHFM*hN5uRR{=TFcLuHvHD{f{~4uq!xs$d&Xrk
z^T?f+Hyz4s$Y0?IvdHJtd_**f_^`5Vo2-=>SXO>d^X!WK8%PZ}y{lf>`_+|92QWD6
zflyRt=2iTpP09C4-yggB?hk!oywSBvxy7y|&qeN=o%Lkv=OIxR#~7zNw2a*g?!lww
z>50HwNw@CbjMTVLSq9~y2$OfeMIxt2?S4bSD%oZ4Z-#DLbncOBV+tL5j!A0$SHNO%
zGr+{av|>{|pCOeD*RnW*K{FN8duz*}2vu%rY`ypJh<WiyppaeA|4qbZ%z?)Fd0?YQ
zEH)I@N|flu<AWKS=U2`hlt+gJA*rTg;;a1%@2b6uG)V8xoBrs`6!nwHxC~yN-hi9P
zZP{2@B15t}Nf{M}YeR1_6|McQH`qOg2r8<4?=Kkf-VVg5uNVd{kFm!-hnbVhG&r-Y
zWxombgtf7~gTAzXzcD3(HX^L#UQ<Q+)-auU1m*EHNP0|2)ON=#Lz}ldX7P$tk&A6!
z$S7dn!aX`Z+&hQ^9)GXw%t)Y=ZN9M=t|s!mSH%E*DF&m&0}gaDq?jR*z%!1KrpQFV
zexQ~CB=5Q21CI0@7A2!q@J=ml^*oh&IcP0JX)z<_GeXy6kX(t?cWCfuUN-kKk~B><
z3S>ID_>^>$L~eS$&IG;>;RDm9b*{ZIhnbZoT`+$0sadpYp!ha9=|d$=pPvQ9B@#;1
zv1H5C7_HqYqev&Yq*U>>nA&A3&`{eBN<c|(E$yzxT$`H<m+D6qyiYB3g@NSH0fwH+
zX#jncN;p3fb+_N*T_xmrzIVpFyR6O!XnwkdiPf&!>wy+!wUF>jrXy+^*|7x}xsU>k
zOA{UE!O*~#1^7}VV@^B~a;Kk@GqK&Dgt{eh@3lXIj>KF<<Y!48dGdLq^X-e(sKbiW
zVXCY9X}!gThMG}p`x{wHtJrdtOx@SxF{l#C#wRswYuIiOD#t@Y7I4`<NwkhLf1*a8
zM|+=>(d|7BBdu$10~6_vVWXBXO*)nh=e&3XWBG8>{7|cu`~F6<@IK__;}&L%xqs(I
zKX{pn8%ZhuB&q+fY3!0|tSIGtiPLRQh#9r?!)Lnl_nuIgr?KfBdY*e4miGg-X?GSh
zH8QY-6t)kYF;gecTU+<MAl-*rlJhn>Q*>~p=9>ySR}<Am`761#Nw!;=CQuPR^t{5t
zEK-5=slt78Awf8!!$W~hmBc_}syB(`>o*1$u{Fb7xMm52(tyr}D(o4{ms6(#+tHEJ
zs<MWPAlO06E01h`)|xqlI<83kV<=3eQNfgw7281mHu=C42HLN-1yOB!@JslZD$2>5
zh3bNXCr);HEfIP$FW#=F_GQQRe#1A&^&_yfGb`S63a{<DO3CZYqQFd%g23i=5}zY^
zTg@+r^2E}%PrGxef;Zqs!};8v0rcR$@r->(5TVxQkO}3tyoE`f$Bwyyp7P2^bU$Pa
zsAxU)a;6grb*KQjRt7j^dmMofx3W%7)-hDv7YHl)&0f*Z@Frzn^h;!gD>bFKs<QGJ
znh@vN?#s|nPhF(w>&^&PZml%yN9&_;MiThA(6NzoRve7MS)++4PADV{E0bV(zZv=j
z)y}lpG3)G7`h5N1#KxDjj}Xuf{amSxF{HYLi<pauz=P9&q~nRkDnc=$<V!C;-Ay*f
z9?Yvs8cKB|s@2IFr@o361AnLlOhx@P@J!c;$UQ`-on$#y&&*tI*ucpFq(|3lB|Fd(
z-Ll9qMH2T#U(v-NrF3w@IrvpoZ|9U0SlW}r)sG8O6^4NF2P*ZGF91P|B;CS^zCfjM
z8|6=v#wW+c;GctlKBLkWi?3TT?1&3_BH<K4j=#Cnh6e27P_VKQgMn0Ls@w*ZqO$UC
zxDmbRu6zU-Vh}tZ?{NEEa!`9~5ptOs&fa~G^%`a15T4!jxN>#b3to>Adl*Q@?EP~=
zU3h)SV5psRB{ntzWwVaB0|9)M%FK~z8VB0uV?}oCVQdBDaEDGCt$Z^v{raUdmJVZB
zPIySNO}ybjS|>W{t^B*+i`0xZRWh!^FPU6b4t<?^<7^RCUB$<eF6)v&c%m%+o~lO7
zCWCaRMwIXQ_>Lb`w&&x!?We}yUsEGzn0|F{?3pY)ab|a`*jUP}e6f^as4s}Kk_UNF
zEBC7~e$P+xW6_WM^pSYbEE+q%7Tl}_3|_X7Iet>s-?I3@Ea8GNL6ds6+Ah8zx;41m
zy}0WbF2?wpSX?0)+aB0OqHdpL9!iz9M5_SRFV(<`@hw|JlclSpSK$>z#^r~hWQ7>j
zSHeP=YDOR^66N&}@ay}xbQ%IdWoW@@LLm`hp_)pO)-kVyc4)q@W@It3MkBOxu?^*z
z3NcB1L;b7LVNJ0V`wA*ar9Diy?gh)8ajdZ)jnh6FV->_TRp|6g?>2LgUzK(aPSoKL
ziVeJ+u|AE~R$~^FR&-8Q&}gQs6MPSH4fHlo_d^0dae)FJ)fS0IM|^H9PWyBW8V@(r
z%vW5c8o2oh`8j`T<PfcbFqxkHbWXcDj4>6o<AE!;Wi5ZnOWrQxxPQpl^K~%rQZ?dI
z)d5+=(mAa#W?IWGgKC>UoN>_7dWnaPl0-24+fV#UbEP5tG7y;{(yI@`<x#<~oau3<
zs-#yKoNV(7v5`tJi$FBcUnM?<NHxV>DcJypwuy+O^Vn|}ZpY2hFuwMALL?Jcml^f_
zxi__DhtI#lq<)j{bGJ)D$oc5Y!}#vQcwV^Y_w(^50@$7uxS90Dan^hw7FSjcJv0al
zSLwKXMssz+${p1<hp9Y@Oy1?fuj|*d4HQ3rCKNdf|L@vDzG<x|hOLJd_FnyK`I@ZJ
zR>f?)`riB{szejI7;E%z$Y^vi5RU2=*_?E9#grO}<0g0c`3xY<hC*w>A3tswK>edr
zpAL<4YNA%1Tt)b8?Y}!+nUTg!ak|x_imIm!%5bsQpU5|vL}O*ou%nvrYf|Wj`E)W~
zW{H#PkE%Jd5C(@fvlf0j!rV@RFEOMK0z0`!wVx5&QbE8EY(o!}J+;yuUNk$4@1zCC
zPt;y&R5i|>O=;>0@v+~}QcwSC{G@Vws$89#tir|CwoRAn3@5-)^<!N{^Ax8K@4j`9
zRet;1I%pTYL5_FQU&$Jq>Fw+nW`!abtD!CME@T~n6MW71!y{y)&OT&97kwr7LR`gw
zFN@t)>(aHRWlhc$&F7twL-B&&Z|{FT-g7PO{oYzRyNa7}s9&v5W6W>jJ?(?D?>*mp
z>T7stvF*jRFEE9=L1V4Qd@3(}Xkl`}pfmJg?aTITLuZ^qT9m2f8&#{giPWLxL^}Si
z?@CGNU0=XLceK{7bfGEY7PVm)pdk)h8ieW_Q==oF+UoyRxyO`&YtV8H+KmD4>*v_{
zX*sz;Q72|gV9`<ALWp~7#L*@1?9Q2`j$_yIGp$*PQD65Gb3g<uhdW`|0(*1k<e`(<
zJYtuAa7YphK)iRM3mwPUs#C%)es=x`zqPghWlqm(=c7NM(zZ8q_IA;vIS75lkVEto
z1cB(FYzGkt4-LiD`8C!L-_Sx%#6KM$!@0zwJ-Q8J4`Nn=i_Cw_{4xB^%gRU-|7a<0
zF#H#k(dea39yyFcgl%uy%;vO2Gd?{*baz@fGjV@X*gEV;9u?NGe3tXbzFiFqM2A+2
z?*?L@KK3kg2y|++NnmPLNb#KsQ8#(#arF8O>{5y<uZJi+J~L9EiF*Y#{MHS0X(PRQ
zleIYJGW<$XDYGT>fpDoIWJ8782|RlVx%L8WZDxrRgW+rZBm0-m5%eZbNRLpn!ul!*
zRoFxL71wlqZJ`Gp)LVu_DmkcC@E&>Jb@1F+UwHK|bO)pAT&DFu)W6ZK!DC%gNSM&2
z60QD7V~bvbCqJe7k}5T1JxXGQfz-{}Ou2^hi}QoAzsyP$h>`X(F#v8eXWBVhW<{LV
z+EjI!QN_F^RAvD_I2^4A<4C)?Dz;_GGQ0A--EbPK)a6J2IOAcGy);MpKF11z&|?bv
z3L{NjY+yFTGw%`%6=!EP7y{>J#ypH*Im&*mpq(Rpg1M)i!ZCz=o-B~4x3D*#y<S_^
zC?5deg$>c*NY>)X%_rl?JvF2Xo@4H<&6}%*&_SWoY>5TGrpZs8>yi*z-)5JM&_%k|
z<8k1iPt?|7+#Q^IDWE8~Drb|d2(nh;TG=IN!gJPk{3>TdkZWdtFvyWazJhDei&;&@
z%Uc=I4E=;KD*GY3|GwVhwYmc5Cv?Gkl5FVxlw~~#4c<BrYOZm<wSKokvosfpek~Z}
zpE_%L=*iA|q%##HG}3-PddvwhU@ePy)Nfe)-Hb_OS=9(8DP|{rZVK=w+)!-R3Ye^C
zs-)xv@X0i4lau2Q_Y9?V1#o7jW)NxNlyzvbH&RUr>D5#|9dz{O^;p&^U0iM9a8GuY
zx21!Z4ZZo=yD?Gmv(rs#ADhdOm?(`pjop66XgBuDeY61P#;MG9*QuzhAhhIBIS<Ou
zF8z#gC#Ne;d=HZ9Dom!7x2xgv4U}}n4W^Vxx+nO{^mj-$)wWro#te%b0ioyL=xbaT
zCjp7qTVv=wLC`l&cQ5&12`P`V5M`iUCas~L#@Cwl^o{_nW{9E5VERW_QNo|hb8$~r
ztcmp6<pib%6=VPI31F<^_TD0e%{4rBZ&4jb(ck{<w1PMmN2fkfCLdL+;8UfO6)uIA
z1?mvzozsbIY&1P-eu@=lbdj>M)~6-Whuc-1Gva&x3Ac%ZZ-NIr2dxv1@6K5;Dz3B)
z5$o0JE+v=a=a!X~Raw6j@ribGCU;7<G3bTayn(_c*~IhA_cNcU@_*}JEOz&b)uyYA
z>}r!3Bun=T{#vV^<L#hde`7ozn&VAf&?bU33G5>AFE%wtd)(v?F8A3fkHW=>=L^Zj
z6r=WiNrtRHx{n{i4&-yjX!S7OrL*|T8}`_tWKM)Uhrw;G#WXr-PB5>*5G$AAg!2ic
z=!v_E!6tm|VQWYm%OoiOy>xFrdjdY@#GioirT{UKv0iF{@VCR#sK!v9sBy9Qs;=A7
z#O%=k@#5z~O5~2mZdp}+)~|hiU+q}(d&@G{@!5amZD@~%N^xc6B%s^e==aA}ygGg1
zXxt1z@ESG%fwfKP@ITZJSuMG)%IPK12+n^Xo3S#!a~;=}Zt7wk3HrHb7F;BDT`xUM
zonXP!wnakNyjoxVz3@o<dV;rF6j}Laf$LTSegSW7G_YZj-8y@9)cHsKWV{asr=vrR
zK_w(F=Pfc3efi~#PDii9LW#Sb?60u8XVXz<qk%9$g3g;QZ%<D%Rp4W34@UcTxW)mB
z9?@^CVWA9~S3$1cXHb5#G{y0FhB{FXn|>NAaOWAKxuf)=ugXPrZ};}v!6MOB5TAP8
zE$(WskxE}t#G8s5^j))2&{)n9hqs2?$?7qjmBra}n37~pvV!9?(4%g>Hgq@swzvbf
zxTnT?{M=X{+W?uB@rk}WyBXnV?gLlm4!?4F!)3{4jg&U;qlx=%tEs)jie)rA!%qlX
z-}Yn5j7GS~mpbm|UsFL(G{bK7m(R-Z^ixoGKcZP~$cS|3W>HozSthC_C1H&+U`ALe
zp73C<X6!i&_tSn%+p8uXBG~Tzps){%J~lO0vrI)?UK6+;4&;*$<QFufv2VMl8-<lF
zudCf+;&C;yEFO!DdssJP$?%JP%{wM_XpV=8Kp9mBRcebN&1pwMjjR_jbD<Fy&o)S^
z9jg|WUkjn<pbuWc>2pr`f(Py1nJ0^?n^a>BkLs0oFU@~aXl&f^8|Khn>4Q`?87kkR
z7(R}citkHx*?}s>(IhXGM&n{Zni|j~Z=i)v{GFHR#s1b`EgelwAi+d1YprT#Am+e>
z33a7y{4o#Z1hWninLOAIt_7m(6^UG9Lo5n}f6w*pGya0EL!?6ECVHd6PPI35v8RGH
zmHDhd#-fC)-8T~bs(nB@9#sKpu1KN9Fk#eV@>C!DvQAIYx_Ym^jlQn{N>9-Zmp7Zc
zdT%TrkIm@1mp2PT+k64VW`@E7zGPyyX*tk#Q8(zr=mFyww+&id<I>ZlO4F-r{bmu9
z5os&qI?s~RFgvr;F}L-?j;$T6`u&|2U9z7sjx@ULW;?o{+6_5E+|PDW#3B^K2<t2;
zKa27Y1oLlQcR*7?pD%RIdY+XrKImPHe<Zl$G&X@1brP`F3H#iE+4<RMCY@dh@f%D`
zB;kOzyXAboHkOOK7GHjv`8A%db5}VVY<OFxG`q@0Vy>Io;Z5vBf3==&inV^&Np$q}
z$JjT*R#D|e7$`MjX9a4^QDVZ+%(xSH9)q#7rcp&AQf+}7PoH!ymQ?PP;;^B56xrsh
z6yHZWf6XvA#5I3#lG^UwYg>@n8)w(`HpM@?|IS?zMRK5hV5xQBsApH9RWhYb^bF{D
z3yyf6&$q2itVW8rcumjl&%1u9NsqN$GV*?8+R*yZZ0Nb@WI`vH6<tUtHq$X`5nx(I
zXXrvgH_T(C;dLQ4)U_@f@#1zMCLXsIv@$+WYaQzsU0KAcGNi+Z3(er0kwxI&S-B6D
zpeHl41*v|Y>xR|~TXQyY=9W3?vJjgu|IvVDRBJXiyY$i!>s-mhJdr(6VyVSQkXP>^
zqbz-0cKH_T96^P5H@NVM1&pgfk~aNYw>IfxnclPVRn>Q%AB3FATVhBQxY?rx_@1|P
zl@(2DBjwzV8tG=d182MR4=)}d`%B6LV$Y@q9yxr7-w$!)6d0A#XI>BAJUpBa!`{p-
z6234J>(!TN1>4%$B|EhsHz>xS?s-ccZmQLHir%4VmOH?G4QEVFj4!&XDlB9Y=lS`o
zcs9c~ZGWIgbVDtvjX@sbBXjMs=mJ~G^vR{?zFTf!W|5<dh5IKN2H3rr;#}fJ>)VVr
z{v<&)sVI!z66uD@ko06MmABgQI_}0wru8sI*@=!%YB$L*)+Gtg?KahUBa!)!Fs3s7
z4^^4YS_vbT$!1CAm(XdUp+EZgqVM`_!e=mf@%mwBiq7J7-DnklG?nJHU)RnPqqi$!
zB<10@d-Q(X6E5VoUP{7N<^XbzOl|kyku@W&ejN~iV$V7I5mI|uwt#+GaB&r3_Ns=<
zcD{cT&R3eCoY5Qt-p6i7;u@?G$so_*H?^lv;4;Yi@KrZQYx=$q0w(g*GnkUAroD&P
zR16N&@(@&~-dFe2g?MhZE$KZyRuYh&YGcaWL|53osC;RId|V)Gl+tsjDeo$c`bZ9v
zPvAtv!$O3U9DJfHBJ#_9Df2VD9n@7z@92HeZgis>#si^FmGei0ouG7YO%LKDbOtt^
z5ZhMH=tiQn+rsSRUG4@lV#PG5-?H|ui{JEdrz%@=CeFYPxi*52g6&%mGtx|qbrjuK
zFPGoiMu8K;8oKwVA?nlMT@hQM#N#0hwL0#N3nCGftR|{2f(N+gtQ_)uL&o(%$$0f4
zu&v$e2$>rp4WRX}=A+sX3t0X8(+HmI-Ph^y3yucm&;c_8-FHHVG_==CXsPwvmT#u&
zRR*H3or#Lg`xc%@&`WItDKJ#n`{MnV)wl1LL(Vh9<|MM3Q(p{GF2_+KZ;5=O@h*D(
z<X}tEC4{;ASYu`7dq*|Rh=LaOAPY4qR`T-$+%k^I6O46`X#$(z@NC?96XD^<Unc`V
z4}oluiS$#+qO*f|*fi$rV4!$+MD2tEai#S)HqY{788mrn^X29nGtEd8p<xv!JN>=F
zrWmWm3R+w1<MQfitBU2sMGkx`?8yrtR0q-YS+qr>z+$?-jHt^Lzw!jUqKQMQwv2s$
zK*uuSYd87yMR&;EnfP#%MsbBrQK96LLTdJ-i)|aFwbh0e^;vCGheL-m(9VCSR24a6
zkNL*#D-eij__!e9?S8H}U`PJ+9qda$nixGQT`%UPaBCC^1x{0t7@55kYs`;4Qa35V
zn7~~UTq!V>fDhzOQUcR{wd9_IbYD^3LR&=z$#(`JStIF5LI+*m&6(a4ls738sp4RY
zQz}WT5~+#W7x9+(TI9MH!MQ`$i7DoyI*F_)li>wG=V~ai;)PJ<n49rx2PEXGnF%b1
z35pSCD=I-R`wB|pPhr&(dj?13TpzMF2iO3xe88*>`4%Apd_M^LvMWJxXF((SvM_^V
zb;4`<v30(;A8FYk3vYt!`oc8AzK8%|Aw@_a#e7Oh@OphxNwB~A%PB$22%{B2-)<6_
zfsbtpx<V59Q~Q8r_+w`gBl=7je)tB#h6>Rj;{070c@VB?Q;-G#l}+;@cv=Z-Sd_8|
zQ7s$3SH!6ZB|Mw5)-O0)fI=8BA<A`#{JJUb3Z)<T)s=8PK$;o1pi?yo&JjqI*UhSl
zOt)n%73>0JC=*p6ucxp7QTUCZ&GQ4qD<<Juo0PZE6}B4Y>BN&r!}X5?!gN?KoAw`K
zTtcRYTe*jar~A8S&pNlxAV-P^ZrbLqnjhm4?HOVQ;>72U9a-HI%dud+nOuHTFK!rR
zLWFd+T|<6A(=NL&0Zv}TNY4J^k{&x6IeCsJLW8rw8t0LIq5kgnA)uFIDj^GRM|3aM
zQv=Mt#)pkrIRcQ^i@zpU-9}CLTly=p#EnMW@~XZIhL$Z^w+WM9&;G_+PmwKaYRm5*
zUB6+JWWm5cKzw+AfQJQ8=L%>dO+_lhzMBtAfd6Gc{J!AdpS<_7znhX9J6OFNlK;z&
z_@9g;k{R!LM*zSz;x7x|zX$+89vJ^S<*)UajK7%MF#QkXUxvQ_giwGKa$&gv05jpg
z{LudoBI)!ehyl>b)cA`7@Zav}|AgsqeQB_g1psQ*0Ra5}CB4Tyu(0w!!i=oU{|L&1
zL#>_90RU(Q0RW=Efmj~@2r{vCuzqiX{nH+L$6j#ia>D{f)e!)Me`ATJf&Jky8Q1|G
z9F6~o^3Z3NDq{x#IzIsbq<=##&%*r)<zQ@NYi(_8^XDzIT~sPY5C#C!<N*MJzv24e
z;QxekGy>ZEal@)~zTcq20RY?x|2&KEGJhxi!Q=j)XHmF%JJyBr-5OfxpSsfc{CC)Y
z(G_AIPe(K|05JM)uTA{7eS>iO6Xd_@>h^OV>pl(u&`SPKT}=i55%!;S)xk6val!-u
zEUNxfR~K1-1pOCX(cZP2cG7_XMo%IBp(~uJKeGO_t{6<c$McW?0L}M{=I^?~ct!Y=
z5dOQaHa$y9_0RzTsrLi_cU|4VBmN2ZA9a-mZj(F&0RTKe{_`w`6aJm_|DmgYny&w^
vD)PW$NfG~KK>mk&-al>2|Bn$*_D9BFcLXTte^tbI|9V0J0O%=*?{ohTMauRf

literal 137271
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
Xyf>*KKQ5#r??U7ZR23`v=>Yr}((0R_


From fe46434687ddf3508ab687f8d14c4cde13d466ff Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Wed, 31 Jan 2024 18:02:29 +0300
Subject: [PATCH 116/273] fix(sessds): fix renew stream logic

---
 ...persistent_session_ds_stream_scheduler.erl | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 475f9f9fb..315fcbc78 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -238,13 +238,18 @@ remove_fully_replayed_streams(S0) ->
     Groups = emqx_persistent_session_ds_state:fold_streams(
         fun({SubId, _Stream}, StreamState = #srs{rank_x = RankX, rank_y = RankY}, Acc) ->
             Key = {SubId, RankX},
-            case is_fully_replayed(CommQos1, CommQos2, StreamState) of
-                true when is_map_key(Key, Acc) ->
+            case {is_fully_replayed(CommQos1, CommQos2, StreamState), Acc} of
+                {_, #{Key := false}} ->
+                    Acc;
+                {true, #{Key := {true, RankY}}} ->
+                    Acc;
+                {true, #{Key := {true, _RankYOther}}} ->
+                    %% assert, should never happen
+                    error(multiple_rank_y_for_rank_x);
+                {true, #{}} ->
                     Acc#{Key => {true, RankY}};
-                true ->
-                    Acc#{Key => false};
-                _ ->
-                    Acc
+                {false, #{}} ->
+                    Acc#{Key => false}
             end
         end,
         #{},
@@ -267,7 +272,7 @@ remove_fully_replayed_streams(S0) ->
             case emqx_persistent_session_ds_state:get_rank({SubId, RankX}, Acc) of
                 undefined ->
                     Acc;
-                MinRankY when RankY < MinRankY ->
+                MinRankY when RankY =< MinRankY ->
                     ?SLOG(debug, #{
                         msg => del_fully_preplayed_stream,
                         key => Key,

From 53c217c383cbc228f6aa86e4afbee7b9ce80f4c8 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Tue, 30 Jan 2024 15:38:48 +0100
Subject: [PATCH 117/273] refactor: micro optimization

---
 apps/emqx/src/emqx_broker.erl | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/apps/emqx/src/emqx_broker.erl b/apps/emqx/src/emqx_broker.erl
index b4fdd0e86..feb3acc16 100644
--- a/apps/emqx/src/emqx_broker.erl
+++ b/apps/emqx/src/emqx_broker.erl
@@ -85,13 +85,13 @@
 %% Guards
 -define(IS_SUBID(Id), (is_binary(Id) orelse is_atom(Id))).
 
--define(cast_or_eval(Pid, Msg, Expr),
-    case Pid =:= self() of
-        true ->
+-define(cast_or_eval(PICK, Msg, Expr),
+    case PICK of
+        __X_Pid when __X_Pid =:= self() ->
             _ = Expr,
             ok;
-        false ->
-            cast(Pid, Msg)
+        __X_Pid ->
+            cast(__X_Pid, Msg)
     end
 ).
 

From 3b42a7425b6043e4e377b89788b1e0541260fae5 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Tue, 30 Jan 2024 12:05:06 +0100
Subject: [PATCH 118/273] feat(kafka_producer): add partitions_limit

---
 apps/emqx_bridge_azure_event_hub/rebar.config |  2 +-
 apps/emqx_bridge_confluent/rebar.config       |  2 +-
 apps/emqx_bridge_kafka/rebar.config           |  2 +-
 .../src/emqx_bridge_kafka.erl                 |  9 +++++++
 .../src/emqx_bridge_kafka_impl_producer.erl   | 25 +++++++++++--------
 changes/ee/feat-12427.en.md                   |  1 +
 mix.exs                                       |  2 +-
 rel/i18n/emqx_bridge_azure_event_hub.hocon    |  8 ++++++
 rel/i18n/emqx_bridge_kafka.hocon              |  8 ++++++
 9 files changed, 45 insertions(+), 14 deletions(-)
 create mode 100644 changes/ee/feat-12427.en.md

diff --git a/apps/emqx_bridge_azure_event_hub/rebar.config b/apps/emqx_bridge_azure_event_hub/rebar.config
index 76e1ae0ef..f3be8f986 100644
--- a/apps/emqx_bridge_azure_event_hub/rebar.config
+++ b/apps/emqx_bridge_azure_event_hub/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.9.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/apps/emqx_bridge_confluent/rebar.config b/apps/emqx_bridge_confluent/rebar.config
index 5e4719106..21fff1a5e 100644
--- a/apps/emqx_bridge_confluent/rebar.config
+++ b/apps/emqx_bridge_confluent/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.9.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/apps/emqx_bridge_kafka/rebar.config b/apps/emqx_bridge_kafka/rebar.config
index e71ccea9f..b71efaf96 100644
--- a/apps/emqx_bridge_kafka/rebar.config
+++ b/apps/emqx_bridge_kafka/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.9.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.erl b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.erl
index b1032ff6b..be2c124e3 100644
--- a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.erl
+++ b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.erl
@@ -188,6 +188,7 @@ values(producer_values) ->
         ],
         kafka_header_value_encode_mode => none,
         max_inflight => 10,
+        partitions_limit => all_partitions,
         buffer => #{
             mode => <<"hybrid">>,
             per_partition_limit => <<"2GB">>,
@@ -414,6 +415,14 @@ fields(producer_kafka_opts) ->
                     desc => ?DESC(partition_count_refresh_interval)
                 }
             )},
+        {partitions_limit,
+            mk(
+                hoconsc:union([all_partitions, pos_integer()]),
+                #{
+                    default => <<"all_partitions">>,
+                    desc => ?DESC(partitions_limit)
+                }
+            )},
         {max_inflight,
             mk(
                 pos_integer(),
diff --git a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
index 459e259d2..9071b807c 100644
--- a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
+++ b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
@@ -135,6 +135,7 @@ create_producers_for_bridge_v2(
     KafkaHeadersTokens = preproc_kafka_headers(maps:get(kafka_headers, KafkaConfig, undefined)),
     KafkaExtHeadersTokens = preproc_ext_headers(maps:get(kafka_ext_headers, KafkaConfig, [])),
     KafkaHeadersValEncodeMode = maps:get(kafka_header_value_encode_mode, KafkaConfig, none),
+    MaxPartitions = maps:get(partitions_limit, KafkaConfig, all_partitions),
     #{name := BridgeName} = emqx_bridge_v2:parse_id(BridgeV2Id),
     TestIdStart = string:find(BridgeV2Id, ?TEST_ID_PREFIX),
     IsDryRun =
@@ -144,7 +145,7 @@ create_producers_for_bridge_v2(
             _ ->
                 string:equal(TestIdStart, InstId)
         end,
-    ok = check_topic_and_leader_connections(ClientId, KafkaTopic),
+    ok = check_topic_and_leader_connections(ClientId, KafkaTopic, MaxPartitions),
     WolffProducerConfig = producers_config(
         BridgeType, BridgeName, KafkaConfig, IsDryRun, BridgeV2Id
     ),
@@ -166,7 +167,8 @@ create_producers_for_bridge_v2(
                 kafka_config => KafkaConfig,
                 headers_tokens => KafkaHeadersTokens,
                 ext_headers_tokens => KafkaExtHeadersTokens,
-                headers_val_encode_mode => KafkaHeadersValEncodeMode
+                headers_val_encode_mode => KafkaHeadersValEncodeMode,
+                partitions_limit => MaxPartitions
             }};
         {error, Reason2} ->
             ?SLOG(error, #{
@@ -517,9 +519,9 @@ on_get_channel_status(
     %% `?status_disconnected' will make resource manager try to restart the producers /
     %% connector, thus potentially dropping data held in wolff producer's replayq.  The
     %% only exception is if the topic does not exist ("unhealthy target").
-    #{kafka_topic := KafkaTopic} = maps:get(ChannelId, Channels),
+    #{kafka_topic := KafkaTopic, partitions_limit := MaxPartitions} = maps:get(ChannelId, Channels),
     try
-        ok = check_topic_and_leader_connections(ClientId, KafkaTopic),
+        ok = check_topic_and_leader_connections(ClientId, KafkaTopic, MaxPartitions),
         ?status_connected
     catch
         throw:{unhealthy_target, Msg} ->
@@ -528,11 +530,11 @@ on_get_channel_status(
             {?status_connecting, {K, E}}
     end.
 
-check_topic_and_leader_connections(ClientId, KafkaTopic) ->
+check_topic_and_leader_connections(ClientId, KafkaTopic, MaxPartitions) ->
     case wolff_client_sup:find_client(ClientId) of
         {ok, Pid} ->
             ok = check_topic_status(ClientId, Pid, KafkaTopic),
-            ok = check_if_healthy_leaders(ClientId, Pid, KafkaTopic);
+            ok = check_if_healthy_leaders(ClientId, Pid, KafkaTopic, MaxPartitions);
         {error, no_such_client} ->
             throw(#{
                 reason => cannot_find_kafka_client,
@@ -562,9 +564,9 @@ check_client_connectivity(ClientId) ->
             {error, {find_client, Reason}}
     end.
 
-check_if_healthy_leaders(ClientId, ClientPid, KafkaTopic) when is_pid(ClientPid) ->
+check_if_healthy_leaders(ClientId, ClientPid, KafkaTopic, MaxPartitions) when is_pid(ClientPid) ->
     Leaders =
-        case wolff_client:get_leader_connections(ClientPid, KafkaTopic) of
+        case wolff_client:get_leader_connections(ClientPid, KafkaTopic, MaxPartitions) of
             {ok, LeadersToCheck} ->
                 %% Kafka is considered healthy as long as any of the partition leader is reachable.
                 lists:filtermap(
@@ -584,7 +586,8 @@ check_if_healthy_leaders(ClientId, ClientPid, KafkaTopic) when is_pid(ClientPid)
             throw(#{
                 error => no_connected_partition_leader,
                 kafka_client => ClientId,
-                kafka_topic => KafkaTopic
+                kafka_topic => KafkaTopic,
+                partitions_limit => MaxPartitions
             });
         _ ->
             ok
@@ -619,6 +622,7 @@ producers_config(BridgeType, BridgeName, Input, IsDryRun, BridgeV2Id) ->
         required_acks := RequiredAcks,
         partition_count_refresh_interval := PCntRefreshInterval,
         max_inflight := MaxInflight,
+        partitions_limit := MaxPartitions,
         buffer := #{
             mode := BufferMode0,
             per_partition_limit := PerPartitionLimit,
@@ -652,7 +656,8 @@ producers_config(BridgeType, BridgeName, Input, IsDryRun, BridgeV2Id) ->
         max_batch_bytes => MaxBatchBytes,
         max_send_ahead => MaxInflight - 1,
         compression => Compression,
-        telemetry_meta_data => #{bridge_id => BridgeV2Id}
+        telemetry_meta_data => #{bridge_id => BridgeV2Id},
+        max_partitions => MaxPartitions
     }.
 
 %% Wolff API is a batch API.
diff --git a/changes/ee/feat-12427.en.md b/changes/ee/feat-12427.en.md
new file mode 100644
index 000000000..c8f0b153c
--- /dev/null
+++ b/changes/ee/feat-12427.en.md
@@ -0,0 +1 @@
+Made possible to limit the number of Kafka partitions to utilize for Kafka data integration.
diff --git a/mix.exs b/mix.exs
index f2d288740..9f591f61e 100644
--- a/mix.exs
+++ b/mix.exs
@@ -201,7 +201,7 @@ defmodule EMQXUmbrella.MixProject do
     [
       {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.4.5+v0.16.1"},
       {:influxdb, github: "emqx/influxdb-client-erl", tag: "1.1.13", override: true},
-      {:wolff, github: "kafka4beam/wolff", tag: "1.9.1"},
+      {:wolff, github: "kafka4beam/wolff", tag: "1.10.1"},
       {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.3", override: true},
       {:brod_gssapi, github: "kafka4beam/brod_gssapi", tag: "v0.1.1"},
       {:brod, github: "kafka4beam/brod", tag: "3.16.8"},
diff --git a/rel/i18n/emqx_bridge_azure_event_hub.hocon b/rel/i18n/emqx_bridge_azure_event_hub.hocon
index 3d77a508a..6b06a480c 100644
--- a/rel/i18n/emqx_bridge_azure_event_hub.hocon
+++ b/rel/i18n/emqx_bridge_azure_event_hub.hocon
@@ -339,4 +339,12 @@ server_name_indication.desc:
 server_name_indication.label:
 """SNI"""
 
+partitions_limit.desc:
+"""Limit the number of partitions to produce data for the given topic.
+The special value `all_partitions` is to utilize all partitions for the topic.
+Setting this to a value which is greater than the total number of partitions in has no effect."""
+
+partitions_limit.label:
+"""Max Partitions"""
+
 }
diff --git a/rel/i18n/emqx_bridge_kafka.hocon b/rel/i18n/emqx_bridge_kafka.hocon
index 86e417be1..b4bf6cd37 100644
--- a/rel/i18n/emqx_bridge_kafka.hocon
+++ b/rel/i18n/emqx_bridge_kafka.hocon
@@ -386,6 +386,14 @@ consumer_kafka_opts.desc:
 consumer_kafka_opts.label:
 """Kafka Consumer"""
 
+partitions_limit.desc:
+"""Limit the number of partitions to produce data for the given topic.
+The special value `all_partitions` is to utilize all partitions for the topic.
+Setting this to a value which is greater than the total number of partitions in has no effect."""
+
+partitions_limit.label:
+"""Max Partitions"""
+
 max_inflight.desc:
 """Maximum number of batches allowed for Kafka producer (per-partition) to send before receiving acknowledgement from Kafka. Greater value typically means better throughput. However, there can be a risk of message reordering when this value is greater than 1."""
 

From 3b6fbff9a5085ab3e017605ca4f86690f3f930b6 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Wed, 31 Jan 2024 19:32:57 +0100
Subject: [PATCH 119/273] test: fix compile warnings

---
 .../emqx/integration_test/emqx_persistent_session_ds_SUITE.erl | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
index 96236c0ae..07a41f167 100644
--- a/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
+++ b/apps/emqx/integration_test/emqx_persistent_session_ds_SUITE.erl
@@ -257,7 +257,6 @@ t_session_unsubscription_idempotency(Config) ->
     ?check_trace(
         #{timetrap => 30_000},
         begin
-            #{timetrap => 20_000},
             ?force_ordering(
                 #{
                     ?snk_kind := persistent_session_ds_subscription_delete
@@ -498,9 +497,7 @@ do_t_session_expiration(_Config, Opts) ->
     ok.
 
 t_session_gc(Config) ->
-    GCInterval = ?config(gc_interval, Config),
     [Node1, Node2, _Node3] = Nodes = ?config(nodes, Config),
-    CoreNodes = [Node1, Node2],
     [
         Port1,
         Port2,

From d51deac222c7d080608d7320902a77727e0ad64f Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Wed, 31 Jan 2024 15:24:06 -0300
Subject: [PATCH 120/273] fix(ds): use configured data dir for site storage

---
 apps/emqx_durable_storage/src/emqx_ds.erl                  | 7 +++++++
 .../src/emqx_ds_replication_layer_meta.erl                 | 2 +-
 apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl    | 7 +------
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds.erl b/apps/emqx_durable_storage/src/emqx_ds.erl
index 4e408ed80..75fb444bd 100644
--- a/apps/emqx_durable_storage/src/emqx_ds.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds.erl
@@ -23,6 +23,7 @@
 
 %% Management API:
 -export([
+    base_dir/0,
     open_db/2,
     update_db_config/2,
     add_generation/1,
@@ -71,6 +72,8 @@
 %% Type declarations
 %%================================================================================
 
+-define(APP, emqx_durable_storage).
+
 -type db() :: atom().
 
 %% Parsed topic.
@@ -189,6 +192,10 @@
 %% API funcions
 %%================================================================================
 
+-spec base_dir() -> file:filename().
+base_dir() ->
+    application:get_env(?APP, db_data_dir, emqx:data_dir()).
+
 %% @doc Different DBs are completely independent from each other. They
 %% could represent something like different tenants.
 -spec open_db(db(), create_db_opts()) -> ok.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
index b49b0e8f7..0b689a116 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
@@ -417,7 +417,7 @@ ensure_tables() ->
     ok = mria:wait_for_tables([?META_TAB, ?NODE_TAB, ?SHARD_TAB]).
 
 ensure_site() ->
-    Filename = filename:join(emqx:data_dir(), "emqx_ds_builtin_site.eterm"),
+    Filename = filename:join(emqx_ds:base_dir(), "emqx_ds_builtin_site.eterm"),
     case file:consult(Filename) of
         {ok, [Site]} ->
             ok;
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index 8f4b2afc6..f22e7423c 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -52,7 +52,6 @@
 
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
--define(APP, emqx_durable_storage).
 -define(REF(ShardId), {via, gproc, {n, l, {?MODULE, ShardId}}}).
 
 %%================================================================================
@@ -608,11 +607,7 @@ rocksdb_open(Shard, Options) ->
 
 -spec db_dir(shard_id()) -> file:filename().
 db_dir({DB, ShardId}) ->
-    filename:join([base_dir(), atom_to_list(DB), binary_to_list(ShardId)]).
-
--spec base_dir() -> file:filename().
-base_dir() ->
-    application:get_env(?APP, db_data_dir, emqx:data_dir()).
+    filename:join([emqx_ds:base_dir(), atom_to_list(DB), binary_to_list(ShardId)]).
 
 -spec update_last_until(Schema, emqx_ds:time()) -> Schema when Schema :: shard_schema() | shard().
 update_last_until(Schema, Until) ->

From f7b12470dd5e5aa16366ddb25e9ff18ff6c0dae6 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Wed, 31 Jan 2024 15:25:03 -0300
Subject: [PATCH 121/273] test(ds): fix inter-suite flakiness

Attempt to mitigate this frequent source of flakiness:

```
=CRASH REPORT==== 31-Jan-2024::17:30:15.025404 ===
  crasher:
    initial call: emqx_ds_replication_layer_egress:init/1
    pid: <0.11312.0>
    registered_name: []
    exception error: no match of right hand side value {error,
                                                        no_leader_for_shard}
      in function  emqx_ds_replication_layer_egress:init/1 (/emqx/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl, line 93)
      in call from gen_server:init_it/2 (gen_server.erl, line 980)
      in call from gen_server:init_it/6 (gen_server.erl, line 935)
    ancestors: [<0.11310.0>,<0.11304.0>,emqx_ds_builtin_databases_sup,
                  emqx_ds_builtin_sup,emqx_ds_sup,<0.11236.0>]
    message_queue_len: 0
    messages: []
    links: [<0.11310.0>]
    dictionary: []
    trap_exit: true
    status: running
    heap_size: 376
    stack_size: 28
    reductions: 231
  neighbours:
```
---
 .../test/emqx_ds_storage_bitfield_lts_SUITE.erl     | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
index 03d86dd88..349eede86 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
@@ -406,11 +406,16 @@ all() -> emqx_common_test_helpers:all(?MODULE).
 suite() -> [{timetrap, {seconds, 20}}].
 
 init_per_suite(Config) ->
-    {ok, _} = application:ensure_all_started(emqx_durable_storage),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [emqx_durable_storage],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    ok = application:stop(emqx_durable_storage).
+end_per_suite(Config) ->
+    Apps = ?config(apps, Config),
+    ok = emqx_cth_suite:stop(Apps),
+    ok.
 
 init_per_testcase(TC, Config) ->
     ok = emqx_ds:open_db(TC, ?DEFAULT_CONFIG),

From b50d6bf1fd59d04b3219b98ad75229c76b66ca9b Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 1 Feb 2024 00:10:48 +0100
Subject: [PATCH 122/273] chore(ds): Change the license to Apache 2.0

Due to technicalities parts of the original code were licensed under
BSL.
In preparations for the public release of the feature, the license has
been changed to Apache 2.0
---
 apps/emqx_durable_storage/BSL.txt             | 94 -------------------
 apps/emqx_durable_storage/src/emqx_ds_app.erl | 12 +++
 .../src/emqx_ds_bitmask_keymapper.erl         | 14 ++-
 .../src/emqx_ds_builtin_db_sup.erl            | 12 +++
 .../src/emqx_ds_storage_layer_sup.erl         | 12 +++
 apps/emqx_durable_storage/src/emqx_ds_sup.erl | 12 +++
 .../emqx_ds_storage_bitfield_lts_SUITE.erl    | 12 +++
 .../emqx_ds_message_storage_bitmask_shim.erl  | 14 ++-
 .../test/props/payload_gen.erl                | 16 ++++
 9 files changed, 102 insertions(+), 96 deletions(-)
 delete mode 100644 apps/emqx_durable_storage/BSL.txt

diff --git a/apps/emqx_durable_storage/BSL.txt b/apps/emqx_durable_storage/BSL.txt
deleted file mode 100644
index f0cd31c6f..000000000
--- a/apps/emqx_durable_storage/BSL.txt
+++ /dev/null
@@ -1,94 +0,0 @@
-Business Source License 1.1
-
-Licensor:             Hangzhou EMQ Technologies Co., Ltd.
-Licensed Work:        EMQX Enterprise Edition
-                      The Licensed Work is (c) 2023
-                      Hangzhou EMQ Technologies Co., Ltd.
-Additional Use Grant: Students and educators are granted right to copy,
-                      modify, and create derivative work for research
-                      or education.
-Change Date:          2028-01-26
-Change License:       Apache License, Version 2.0
-
-For information about alternative licensing arrangements for the Software,
-please contact Licensor: https://www.emqx.com/en/contact
-
-Notice
-
-The Business Source License (this document, or the “License”) is not an Open
-Source license. However, the Licensed Work will eventually be made available
-under an Open Source License, as stated in this License.
-
-License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
-“Business Source License” is a trademark of MariaDB Corporation Ab.
-
------------------------------------------------------------------------------
-
-Business Source License 1.1
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.
-
-MariaDB hereby grants you permission to use this License’s text to license
-your works, and to refer to it using the trademark “Business Source License”,
-as long as you comply with the Covenants of Licensor below.
-
-Covenants of Licensor
-
-In consideration of the right to use this License’s text and the “Business
-Source License” name and trademark, Licensor covenants to MariaDB, and to all
-other recipients of the licensed work to be provided by Licensor:
-
-1. To specify as the Change License the GPL Version 2.0 or any later version,
-   or a license that is compatible with GPL Version 2.0 or a later version,
-   where “compatible” means that software provided under the Change License can
-   be included in a program with software provided under GPL Version 2.0 or a
-   later version. Licensor may specify additional Change Licenses without
-   limitation.
-
-2. To either: (a) specify an additional grant of rights to use that does not
-   impose any additional restriction on the right granted in this License, as
-   the Additional Use Grant; or (b) insert the text “None”.
-
-3. To specify a Change Date.
-
-4. Not to modify this License in any other way.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_app.erl b/apps/emqx_durable_storage/src/emqx_ds_app.erl
index dcf353a99..552d6e044 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_app.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_app.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
 %% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 
 -module(emqx_ds_app).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
index a3b65c7e6..11dcba3ea 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 -module(emqx_ds_bitmask_keymapper).
 
diff --git a/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
index 9df07eb18..68aa0ee90 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_builtin_db_sup.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
 %% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 
 %% @doc Supervisor that contains all the processes that belong to a
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
index 424b35133..136669ed2 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer_sup.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
 %% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 -module(emqx_ds_storage_layer_sup).
 
diff --git a/apps/emqx_durable_storage/src/emqx_ds_sup.erl b/apps/emqx_durable_storage/src/emqx_ds_sup.erl
index e863e74ce..ed2c83c62 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_sup.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_sup.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
 %% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 -module(emqx_ds_sup).
 
diff --git a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
index 03d86dd88..5878e9f7a 100644
--- a/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
+++ b/apps/emqx_durable_storage/test/emqx_ds_storage_bitfield_lts_SUITE.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
 %% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 -module(emqx_ds_storage_bitfield_lts_SUITE).
 
diff --git a/apps/emqx_durable_storage/test/props/emqx_ds_message_storage_bitmask_shim.erl b/apps/emqx_durable_storage/test/props/emqx_ds_message_storage_bitmask_shim.erl
index ddc199a44..97b90fcb7 100644
--- a/apps/emqx_durable_storage/test/props/emqx_ds_message_storage_bitmask_shim.erl
+++ b/apps/emqx_durable_storage/test/props/emqx_ds_message_storage_bitmask_shim.erl
@@ -1,5 +1,17 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
 %%--------------------------------------------------------------------
 
 -module(emqx_ds_message_storage_bitmask_shim).
diff --git a/apps/emqx_durable_storage/test/props/payload_gen.erl b/apps/emqx_durable_storage/test/props/payload_gen.erl
index b969c0043..d4d19b403 100644
--- a/apps/emqx_durable_storage/test/props/payload_gen.erl
+++ b/apps/emqx_durable_storage/test/props/payload_gen.erl
@@ -1,3 +1,19 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
 %% @doc This module provides lazy, composable producer streams that
 %% can be considered counterparts to Archiver's consumer pipes and
 %% therefore can facilitate testing

From 139f5dc3bd3c4b58d536abfe578aafce7ccee71a Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 1 Feb 2024 00:14:08 +0100
Subject: [PATCH 123/273] chore(ds): Remove an obsolete document; superceded by
 ./README.md

---
 apps/emqx_durable_storage/IMPLEMENTATION.md | 119 --------------------
 1 file changed, 119 deletions(-)
 delete mode 100644 apps/emqx_durable_storage/IMPLEMENTATION.md

diff --git a/apps/emqx_durable_storage/IMPLEMENTATION.md b/apps/emqx_durable_storage/IMPLEMENTATION.md
deleted file mode 100644
index 33f02dfc4..000000000
--- a/apps/emqx_durable_storage/IMPLEMENTATION.md
+++ /dev/null
@@ -1,119 +0,0 @@
-# General concepts
-
-In the logic layer we don't speak about replication.
-This is because we could use an external DB with its own replication logic.
-
-On the other hand, we introduce notion of shard right here at the logic layer.
-This is because shared subscription logic needs to be aware of it to some extend, as it has to split work between subscribers somehow.
-
-
-# Modus operandi
-
-1. Create a draft implementation of a milestone
-2. Test performance
-3. Test consistency
-4. Goto 1
-
-# Tables
-
-## Message storage
-
-Data is written every time a message matching certain pattern is published.
-This pattern is not part of the logic layer spec.
-
-Write throughput: very high
-
-Data size: very high
-
-Write pattern: append only
-
-Read pattern: pseudoserial
-
-Number of records: O(total write throughput * retention time)
-
-
-# Push vs. Pull model
-
-In push model we have replay agents iterating over the dataset in the shards.
-
-In pull model the client processes work with iterators directly and fetch data from the remote message storage instances via remote procedure calls.
-
-## Push pros:
-- Lower latency: message can be dispatched to the client as soon as it's persisted
-- Less worry about buffering
-
-## Push cons:
-- Needs pushback logic
-- It's not entirely justified when working with external DB that may not provide streaming API
-
-## Pull pros:
-- No need for pushback: client advances iterators at its own tempo
-
-## Pull cons:
-- 2 messages need to be sent over network for each batch being replayed.
-- RPC is generally an antipattern
-
-# Invariants
-
-- All messages written to the shard always have larger sequence number than all the iterators for the shard (to avoid missing messages during replay)
-
-
-# Parallel tracks
-
-## 0. Configuration
-
-This includes HOCON schema and an interface module that is used by the rest of the code (`emqx_ds_conf.erl`).
-
-At the early stage we need at least to implement a feature flag that can be used by developers.
-
-We should have safety measures to prevent a client from breaking down the broker by connecting with clean session = false and subscribing to `#`.
-
-## 1. Fully implement all emqx_durable_storage APIs
-
-### Message API
-
-### Session API
-
-### Iterator API
-
-## 2. Implement a filter for messages that has to be persisted
-
-We don't want to persist ALL messages.
-Only the messages that can be replayed by some client.
-
-1. Persistent sessions should signal to the emqx_broker what topic filters should be persisted.
-   Scenario:
-   - Client connects with clean session = false.
-   - Subscribes to the topic filter a/b/#
-   - Now we need to signal to the rest of the broker that messages matching `a/b/#` must be persisted.
-
-2. Replay feature (separate, optional, under BSL license): in the configuration file we have list of topic filters that specify what topics can be replayed. (Lower prio)
-   - Customers can do this: `#`
-   - Include minimum QoS of messages in the config
-
-## 3. Replace current emqx_persistent_session with the emqx_durable_storage
-
-## 4. Garbage collection
-
-## 5. Tooling for performance and consistency testing
-
-At the first stage we can just use emqttb:
-
-https://github.com/emqx/emqttb/blob/master/src/scenarios/emqttb_scenario_persistent_session.erl
-
-
-Consistency verification at the early stages can just use this test suite:
-
-`apps/emqx/test/emqx_persistent_session_SUITE.erl`
-
-## 6. Update rocksdb version in EMQX (low prio)
-
-## 9999. Alternative schema for rocksdb message table
-
-https://github.com/emqx/eip/blob/main/active/0023-rocksdb-message-persistence.md#potential-for-future-optimizations-keyspace-based-on-the-learned-topic-patterns
-
-Problem with the current bitmask-based schema:
-
-- Good: `a/b/c/#`
-
-- Bad: `+/a/b/c/d`

From f9d16340e0146a098dcd83a2f370125bb6b3e1a5 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Wed, 31 Jan 2024 22:13:04 +0800
Subject: [PATCH 124/273] fix: don't add disable bridge to connector's channel

---
 .../emqx_bridge/test/emqx_bridge_v2_SUITE.erl | 26 +++++++++++++++++++
 .../test/emqx_connector_SUITE.erl             |  2 +-
 .../src/emqx_resource_manager.erl             |  9 ++++---
 3 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/apps/emqx_bridge/test/emqx_bridge_v2_SUITE.erl b/apps/emqx_bridge/test/emqx_bridge_v2_SUITE.erl
index ba631f71a..37cb8aef3 100644
--- a/apps/emqx_bridge/test/emqx_bridge_v2_SUITE.erl
+++ b/apps/emqx_bridge/test/emqx_bridge_v2_SUITE.erl
@@ -221,6 +221,32 @@ t_create_remove(_) ->
     ok = emqx_bridge_v2:remove(bridge_type(), my_test_bridge),
     ok.
 
+t_create_disabled_bridge(_) ->
+    Config = #{<<"connector">> := Connector} = bridge_config(),
+    Disable = Config#{<<"enable">> => false},
+    BridgeType = bridge_type(),
+    {ok, _} = emqx_bridge_v2:create(BridgeType, my_enable_bridge, Config),
+    {ok, _} = emqx_bridge_v2:create(BridgeType, my_disable_bridge, Disable),
+    ConnectorId = emqx_connector_resource:resource_id(con_type(), Connector),
+    ?assertMatch(
+        [
+            {_, #{
+                enable := true,
+                connector := Connector,
+                bridge_type := _
+            }},
+            {_, #{
+                enable := false,
+                connector := Connector,
+                bridge_type := _
+            }}
+        ],
+        emqx_bridge_v2:get_channels_for_connector(ConnectorId)
+    ),
+    ok = emqx_bridge_v2:remove(bridge_type(), my_enable_bridge),
+    ok = emqx_bridge_v2:remove(bridge_type(), my_disable_bridge),
+    ok.
+
 t_list(_) ->
     [] = emqx_bridge_v2:list(),
     {ok, _} = emqx_bridge_v2:create(bridge_type(), my_test_bridge, bridge_config()),
diff --git a/apps/emqx_connector/test/emqx_connector_SUITE.erl b/apps/emqx_connector/test/emqx_connector_SUITE.erl
index f0e021490..e807c3855 100644
--- a/apps/emqx_connector/test/emqx_connector_SUITE.erl
+++ b/apps/emqx_connector/test/emqx_connector_SUITE.erl
@@ -159,7 +159,7 @@ t_remove_fail({'init', Config}) ->
     meck:new(?CONNECTOR, [non_strict]),
     meck:expect(?CONNECTOR, callback_mode, 0, async_if_possible),
     meck:expect(?CONNECTOR, on_start, 2, {ok, connector_state}),
-    meck:expect(?CONNECTOR, on_get_channels, 1, [{<<"my_channel">>, #{}}]),
+    meck:expect(?CONNECTOR, on_get_channels, 1, [{<<"my_channel">>, #{enable => true}}]),
     meck:expect(?CONNECTOR, on_add_channel, 4, {ok, connector_state}),
     meck:expect(?CONNECTOR, on_stop, 2, ok),
     meck:expect(?CONNECTOR, on_get_status, 2, connected),
diff --git a/apps/emqx_resource/src/emqx_resource_manager.erl b/apps/emqx_resource/src/emqx_resource_manager.erl
index ef81f57f7..4f56db310 100644
--- a/apps/emqx_resource/src/emqx_resource_manager.erl
+++ b/apps/emqx_resource/src/emqx_resource_manager.erl
@@ -622,13 +622,16 @@ start_resource(Data, From) ->
 
 add_channels(Data) ->
     %% Add channels to the Channels map but not to the resource state
-    %% Channels will be added to the resouce state after the initial health_check
+    %% Channels will be added to the resource state after the initial health_check
     %% if that succeeds.
     ChannelIDConfigTuples = emqx_resource:call_get_channels(Data#data.id, Data#data.mod),
     Channels = Data#data.added_channels,
     NewChannels = lists:foldl(
-        fun({ChannelID, _Conf}, Acc) ->
-            maps:put(ChannelID, channel_status(), Acc)
+        fun
+            ({ChannelID, #{enable := true}}, Acc) ->
+                maps:put(ChannelID, channel_status(), Acc);
+            ({_, #{enable := false}}, Acc) ->
+                Acc
         end,
         Channels,
         ChannelIDConfigTuples

From 8f9e6769cf32b630e01d2b4b568583021edd139b Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Thu, 1 Feb 2024 11:08:54 +0100
Subject: [PATCH 125/273] docs: add missing desc

---
 rel/i18n/emqx_bridge_confluent_producer.hocon | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/rel/i18n/emqx_bridge_confluent_producer.hocon b/rel/i18n/emqx_bridge_confluent_producer.hocon
index 730f0e371..2c1f71bd1 100644
--- a/rel/i18n/emqx_bridge_confluent_producer.hocon
+++ b/rel/i18n/emqx_bridge_confluent_producer.hocon
@@ -277,6 +277,14 @@ This value is to specify the size of each on-disk buffer file."""
 buffer_segment_bytes.label:
 """Segment File Bytes"""
 
+partitions_limit.desc:
+"""Limit the number of partitions to produce data for the given topic.
+The special value `all_partitions` is to utilize all partitions for the topic.
+Setting this to a value which is greater than the total number of partitions in has no effect."""
+
+partitions_limit.label:
+"""Max Partitions"""
+
 max_inflight.desc:
 """Maximum number of batches allowed for Confluent producer (per-partition) to send before receiving acknowledgement from Confluent. Greater value typically means better throughput. However, there can be a risk of message reordering when this value is greater than 1."""
 

From 16444b7da9960fa99a8f324a7a16d6ca97b56e05 Mon Sep 17 00:00:00 2001
From: William Yang <mscame@gmail.com>
Date: Wed, 31 Jan 2024 14:24:54 +0100
Subject: [PATCH 126/273] fix(bridge-kafka): no stacktrace when fetch topic
 partition count fail

---
 apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
index 459e259d2..c253a42b6 100644
--- a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
+++ b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka_impl_producer.erl
@@ -376,6 +376,8 @@ on_query_async(
         ),
         do_send_msg(async, KafkaMessage, Producers, AsyncReplyFn)
     catch
+        error:{invalid_partition_count, _Count, _Partitioner} ->
+            {error, invalid_partition_count};
         throw:{bad_kafka_header, _} = Error ->
             ?tp(
                 emqx_bridge_kafka_impl_producer_async_query_failed,

From 6a092aeb6953c9e302011bfaa31dfb788047d708 Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Tue, 30 Jan 2024 16:23:27 +0300
Subject: [PATCH 127/273] chore(emqx_machine): refactor injecting runtime deps

Co-authored-by: Thales Macedo Garitezi <thalesmg@gmail.com>
---
 apps/emqx_machine/src/emqx_machine_boot.erl   | 57 ++++++-------------
 .../src/emqx_machine_boot_runtime_deps.erl    | 53 +++++++++++++++++
 2 files changed, 70 insertions(+), 40 deletions(-)
 create mode 100644 apps/emqx_machine/src/emqx_machine_boot_runtime_deps.erl

diff --git a/apps/emqx_machine/src/emqx_machine_boot.erl b/apps/emqx_machine/src/emqx_machine_boot.erl
index 8783dd10a..ee6e02986 100644
--- a/apps/emqx_machine/src/emqx_machine_boot.erl
+++ b/apps/emqx_machine/src/emqx_machine_boot.erl
@@ -166,9 +166,8 @@ is_app(Name) ->
 sorted_reboot_apps() ->
     RebootApps = reboot_apps(),
     Apps0 = [{App, app_deps(App, RebootApps)} || App <- RebootApps],
-    Apps1 = inject_bridge_deps(Apps0),
-    Apps2 = inject_dashboard_deps(Apps1),
-    sorted_reboot_apps(Apps2).
+    Apps = emqx_machine_boot_runtime_deps:inject(Apps0, runtime_deps()),
+    sorted_reboot_apps(Apps).
 
 app_deps(App, RebootApps) ->
     case application:get_key(App, applications) of
@@ -176,43 +175,21 @@ app_deps(App, RebootApps) ->
         {ok, List} -> lists:filter(fun(A) -> lists:member(A, RebootApps) end, List)
     end.
 
-%% `emqx_bridge' is special in that it needs all the bridges apps to
-%% be started before it, so that, when it loads the bridges from
-%% configuration, the bridge app and its dependencies need to be up.
-%%
-%% `emqx_connector' also needs to start all connector dependencies for the same reason.
-%% Since standalone apps like `emqx_mongodb' are already dependencies of `emqx_bridge_*'
-%% apps, we may apply the same tactic for `emqx_connector' and inject individual bridges
-%% as its dependencies.
-inject_bridge_deps(RebootAppDeps) ->
-    BridgeApps = [
-        App
-     || {App, _Deps} <- RebootAppDeps,
-        lists:prefix("emqx_bridge_", atom_to_list(App))
-    ],
-    lists:map(
-        fun
-            ({emqx_bridge, Deps0}) when is_list(Deps0) ->
-                {emqx_bridge, Deps0 ++ BridgeApps};
-            ({emqx_connector, Deps0}) when is_list(Deps0) ->
-                {emqx_connector, Deps0 ++ BridgeApps};
-            (App) ->
-                App
-        end,
-        RebootAppDeps
-    ).
-inject_dashboard_deps(Reboots) ->
-    Apps = [emqx_license],
-    Deps = lists:filter(fun(App) -> lists:keymember(App, 1, Reboots) end, Apps),
-    lists:map(
-        fun
-            ({emqx_dashboard, Deps0}) when is_list(Deps0) ->
-                {emqx_dashboard, Deps0 ++ Deps};
-            (App) ->
-                App
-        end,
-        Reboots
-    ).
+runtime_deps() ->
+    [
+        %% `emqx_bridge' is special in that it needs all the bridges apps to
+        %% be started before it, so that, when it loads the bridges from
+        %% configuration, the bridge app and its dependencies need to be up.
+        {emqx_bridge, fun(App) -> lists:prefix("emqx_bridge_", atom_to_list(App)) end},
+        %% `emqx_connector' also needs to start all connector dependencies for the same reason.
+        %% Since standalone apps like `emqx_mongodb' are already dependencies of `emqx_bridge_*'
+        %% apps, we may apply the same tactic for `emqx_connector' and inject individual bridges
+        %% as its dependencies.
+        {emqx_connector, fun(App) -> lists:prefix("emqx_bridge_", atom_to_list(App)) end},
+        %% emqx_fdb is an EE app
+        {emqx_durable_storage, emqx_fdb},
+        {emqx_dashboard, emqx_license}
+    ].
 
 sorted_reboot_apps(Apps) ->
     G = digraph:new(),
diff --git a/apps/emqx_machine/src/emqx_machine_boot_runtime_deps.erl b/apps/emqx_machine/src/emqx_machine_boot_runtime_deps.erl
new file mode 100644
index 000000000..81f66839a
--- /dev/null
+++ b/apps/emqx_machine/src/emqx_machine_boot_runtime_deps.erl
@@ -0,0 +1,53 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_machine_boot_runtime_deps).
+
+-export([inject/2]).
+
+-type app_name() :: atom().
+-type app_deps() :: {app_name(), [app_name()]}.
+-type app_selector() :: app_name() | fun((app_name()) -> boolean()).
+-type runtime_dep() :: {_WhatDepends :: app_name(), _OnWhat :: app_selector()}.
+
+-spec inject([app_deps()], [runtime_dep()]) -> [app_deps()].
+inject(AppDepList, DepSpecs) ->
+    AppDep0 = maps:from_list(AppDepList),
+    AppDep1 = lists:foldl(
+        fun(DepSpec, AppDepAcc) ->
+            inject_one_dep(AppDepAcc, DepSpec)
+        end,
+        AppDep0,
+        DepSpecs
+    ),
+    maps:to_list(AppDep1).
+
+%%--------------------------------------------------------------------
+%% Internal functions
+%%--------------------------------------------------------------------
+
+inject_one_dep(AppDep, {WhatDepends, OnWhatSelector}) ->
+    OnWhat = select_apps(OnWhatSelector, maps:keys(AppDep)),
+    case AppDep of
+        #{WhatDepends := Deps} when is_list(Deps) ->
+            AppDep#{WhatDepends => lists:usort(Deps ++ OnWhat)};
+        _ ->
+            AppDep
+    end.
+
+select_apps(AppName, AppNames) when is_atom(AppName) ->
+    lists:filter(fun(App) -> App =:= AppName end, AppNames);
+select_apps(AppSelector, AppNames) when is_function(AppSelector, 1) ->
+    lists:filter(AppSelector, AppNames).

From a4272c71dc58bcc7508f71cf4c56dcc0121fbd41 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 25 Jan 2024 17:43:51 +0100
Subject: [PATCH 128/273] feat: refactor Oracle bridge to connector and action

Fixes:
https://emqx.atlassian.net/browse/EMQX-11464
---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_oracle.app.src            |   4 +-
 .../src/emqx_bridge_oracle.erl                | 128 +++++++++++-
 .../src/emqx_bridge_oracle_action_info.erl    |  22 ++
 .../test/emqx_bridge_oracle_SUITE.erl         |  96 ++++++++-
 .../src/schema/emqx_connector_ee_schema.erl   |  13 ++
 .../src/schema/emqx_connector_schema.erl      |   2 +
 apps/emqx_oracle/src/emqx_oracle.app.src      |   2 +-
 apps/emqx_oracle/src/emqx_oracle.erl          | 192 ++++++++++++++----
 rel/i18n/emqx_bridge_oracle.hocon             |  15 ++
 10 files changed, 410 insertions(+), 65 deletions(-)
 create mode 100644 apps/emqx_bridge_oracle/src/emqx_bridge_oracle_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index b495fa671..2216c3d05 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -92,6 +92,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_kinesis_action_info,
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
+        emqx_bridge_oracle_action_info,
         emqx_bridge_influxdb_action_info,
         emqx_bridge_cassandra_action_info,
         emqx_bridge_mysql_action_info,
diff --git a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.app.src b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.app.src
index d68c6ca9a..39b606d5f 100644
--- a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.app.src
+++ b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_oracle, [
     {description, "EMQX Enterprise Oracle Database Bridge"},
-    {vsn, "0.1.4"},
+    {vsn, "0.1.5"},
     {registered, []},
     {applications, [
         kernel,
@@ -8,7 +8,7 @@
         emqx_resource,
         emqx_oracle
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_oracle_action_info]}]},
     {modules, []},
 
     {links, []}
diff --git a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
index 15b2be575..532c01b78 100644
--- a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
+++ b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
@@ -9,7 +9,9 @@
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 
 -export([
-    conn_bridge_examples/1
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
 ]).
 
 -export([
@@ -20,22 +22,25 @@
     config_validator/1
 ]).
 
+-define(CONNECTOR_TYPE, oracle).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
+
 -define(DEFAULT_SQL, <<
     "insert into t_mqtt_msgs(msgid, topic, qos, payload) "
     "values (${id}, ${topic}, ${qos}, ${payload})"
 >>).
 
-conn_bridge_examples(Method) ->
+conn_bridge_examples(_Method) ->
     [
         #{
             <<"oracle">> => #{
                 summary => <<"Oracle Database Bridge">>,
-                value => values(Method)
+                value => conn_bridge_examples_values()
             }
         }
     ].
 
-values(_Method) ->
+conn_bridge_examples_values() ->
     #{
         enable => true,
         type => oracle,
@@ -58,6 +63,54 @@ values(_Method) ->
         }
     }.
 
+connector_examples(Method) ->
+    [
+        #{
+            <<"oracle">> =>
+                #{
+                    summary => <<"Oracle Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_values()
+                    )
+                }
+        }
+    ].
+
+connector_values() ->
+    #{
+        <<"username">> => <<"system">>,
+        <<"password">> => <<"oracle">>,
+        <<"server">> => <<"127.0.0.1:1521">>,
+        <<"service_name">> => <<"XE">>,
+        <<"sid">> => <<"XE">>,
+        <<"pool_size">> => 8,
+        <<"resource_opts">> =>
+            #{
+                <<"health_check_interval">> => <<"15s">>,
+                <<"start_timeout">> => <<"5s">>
+            }
+    }.
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"oracle">> =>
+                #{
+                    summary => <<"Oracle Action">>,
+                    value => emqx_bridge_v2_schema:action_values(
+                        Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                    )
+                }
+        }
+    ].
+
+action_values() ->
+    #{
+        parameters => #{
+            <<"sql">> => ?DEFAULT_SQL
+        }
+    }.
+
 %% -------------------------------------------------------------------------------------------------
 %% Hocon Schema Definitions
 
@@ -65,6 +118,55 @@ namespace() -> "bridge_oracle".
 
 roots() -> [].
 
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    emqx_connector_schema:api_fields(
+        Field,
+        ?CONNECTOR_TYPE,
+        fields("config_connector")
+    );
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(oracle_action));
+fields(action) ->
+    {?ACTION_TYPE,
+        hoconsc:mk(
+            hoconsc:map(name, hoconsc:ref(?MODULE, oracle_action)),
+            #{
+                desc => <<"Oracle Action Config">>,
+                required => false
+            }
+        )};
+fields(oracle_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        hoconsc:mk(
+            hoconsc:ref(?MODULE, action_parameters),
+            #{
+                required => true,
+                desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    [
+        {sql,
+            hoconsc:mk(
+                binary(),
+                #{desc => ?DESC("sql_template"), default => ?DEFAULT_SQL, format => <<"sql">>}
+            )}
+    ];
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        fields(connector_fields) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
 fields("config") ->
     [
         {enable,
@@ -83,8 +185,10 @@ fields("config") ->
                 #{desc => ?DESC("local_topic"), default => undefined}
             )}
     ] ++ emqx_resource_schema:fields("resource_opts") ++
-        (emqx_oracle_schema:fields(config) --
-            emqx_connector_schema_lib:prepare_statement_fields());
+        fields(connector_fields);
+fields(connector_fields) ->
+    (emqx_oracle_schema:fields(config) --
+        emqx_connector_schema_lib:prepare_statement_fields());
 fields("post") ->
     fields("post", oracle);
 fields("put") ->
@@ -97,6 +201,16 @@ fields("post", Type) ->
 
 desc("config") ->
     ?DESC("desc_config");
+desc("creation_opts") ->
+    ?DESC(emqx_resource_schema, "creation_opts");
+desc("config_connector") ->
+    ?DESC("config_connector");
+desc(oracle_action) ->
+    ?DESC("oracle_action");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(_) ->
     undefined.
 
@@ -116,5 +230,5 @@ config_validator(#{<<"server">> := Server} = Config) when
         not is_map_key(<<"service_name">>, Config)
 ->
     {error, "neither SID nor Service Name was set"};
-config_validator(_) ->
+config_validator(_Config) ->
     ok.
diff --git a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle_action_info.erl b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle_action_info.erl
new file mode 100644
index 000000000..561b798bd
--- /dev/null
+++ b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle_action_info.erl
@@ -0,0 +1,22 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_oracle_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+bridge_v1_type_name() -> oracle.
+
+action_type_name() -> oracle.
+
+connector_type_name() -> oracle.
+
+schema_module() -> emqx_bridge_oracle.
diff --git a/apps/emqx_bridge_oracle/test/emqx_bridge_oracle_SUITE.erl b/apps/emqx_bridge_oracle/test/emqx_bridge_oracle_SUITE.erl
index 878ae2e1d..608d81bec 100644
--- a/apps/emqx_bridge_oracle/test/emqx_bridge_oracle_SUITE.erl
+++ b/apps/emqx_bridge_oracle/test/emqx_bridge_oracle_SUITE.erl
@@ -267,7 +267,12 @@ parse_and_check(ConfigString, Name) ->
 resource_id(Config) ->
     Type = ?BRIDGE_TYPE_BIN,
     Name = ?config(oracle_name, Config),
-    emqx_bridge_resource:resource_id(Type, Name).
+    <<"connector:", Type/binary, ":", Name/binary>>.
+
+action_id(Config) ->
+    Type = ?BRIDGE_TYPE_BIN,
+    Name = ?config(oracle_name, Config),
+    emqx_bridge_v2:id(Type, Name).
 
 bridge_id(Config) ->
     Type = ?BRIDGE_TYPE_BIN,
@@ -378,6 +383,7 @@ create_rule_and_action_http(Config) ->
 
 t_sync_query(Config) ->
     ResourceId = resource_id(Config),
+    Name = ?config(oracle_name, Config),
     ?check_trace(
         begin
             reset_table(Config),
@@ -387,6 +393,18 @@ t_sync_query(Config) ->
                 _Attempts = 20,
                 ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
             ),
+            ?retry(
+                _Sleep1 = 1_000,
+                _Attempts1 = 30,
+                ?assertMatch(
+                    #{status := connected},
+                    emqx_bridge_v2:health_check(
+                        ?BRIDGE_TYPE_BIN,
+                        Name
+                    )
+                )
+            ),
+            ActionId = action_id(Config),
             MsgId = erlang:unique_integer(),
             Params = #{
                 topic => ?config(mqtt_topic, Config),
@@ -394,7 +412,7 @@ t_sync_query(Config) ->
                 payload => ?config(oracle_name, Config),
                 retain => true
             },
-            Message = {send_message, Params},
+            Message = {ActionId, Params},
             ?assertEqual(
                 {ok, [{affected_rows, 1}]}, emqx_resource:simple_sync_query(ResourceId, Message)
             ),
@@ -409,7 +427,7 @@ t_batch_sync_query(Config) ->
     ProxyHost = ?config(proxy_host, Config),
     ProxyName = ?config(proxy_name, Config),
     ResourceId = resource_id(Config),
-    BridgeId = bridge_id(Config),
+    Name = ?config(oracle_name, Config),
     ?check_trace(
         begin
             reset_table(Config),
@@ -419,6 +437,17 @@ t_batch_sync_query(Config) ->
                 _Attempts = 30,
                 ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
             ),
+            ?retry(
+                _Sleep = 1_000,
+                _Attempts = 30,
+                ?assertMatch(
+                    #{status := connected},
+                    emqx_bridge_v2:health_check(
+                        ?BRIDGE_TYPE_BIN,
+                        Name
+                    )
+                )
+            ),
             MsgId = erlang:unique_integer(),
             Params = #{
                 topic => ?config(mqtt_topic, Config),
@@ -431,9 +460,9 @@ t_batch_sync_query(Config) ->
             % be sent async as callback_mode is set to async_if_possible.
             emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
                 ct:sleep(1000),
-                emqx_bridge:send_message(BridgeId, Params),
-                emqx_bridge:send_message(BridgeId, Params),
-                emqx_bridge:send_message(BridgeId, Params),
+                emqx_bridge_v2:send_message(?BRIDGE_TYPE_BIN, Name, Params, #{}),
+                emqx_bridge_v2:send_message(?BRIDGE_TYPE_BIN, Name, Params, #{}),
+                emqx_bridge_v2:send_message(?BRIDGE_TYPE_BIN, Name, Params, #{}),
                 ok
             end),
             % Wait for reconnection.
@@ -442,6 +471,17 @@ t_batch_sync_query(Config) ->
                 _Attempts = 30,
                 ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
             ),
+            ?retry(
+                _Sleep = 1_000,
+                _Attempts = 30,
+                ?assertMatch(
+                    #{status := connected},
+                    emqx_bridge_v2:health_check(
+                        ?BRIDGE_TYPE_BIN,
+                        Name
+                    )
+                )
+            ),
             ?retry(
                 _Sleep = 1_000,
                 _Attempts = 30,
@@ -506,6 +546,17 @@ t_start_stop(Config) ->
                 _Attempts = 20,
                 ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
             ),
+            ?retry(
+                _Sleep = 1_000,
+                _Attempts = 20,
+                ?assertMatch(
+                    #{status := connected},
+                    emqx_bridge_v2:health_check(
+                        ?BRIDGE_TYPE_BIN,
+                        OracleName
+                    )
+                )
+            ),
 
             %% Check that the bridge probe API doesn't leak atoms.
             ProbeRes0 = probe_bridge_api(
@@ -554,6 +605,7 @@ t_probe_with_nested_tokens(Config) ->
 t_message_with_nested_tokens(Config) ->
     BridgeId = bridge_id(Config),
     ResourceId = resource_id(Config),
+    Name = ?config(oracle_name, Config),
     reset_table(Config),
     ?assertMatch(
         {ok, _},
@@ -568,6 +620,17 @@ t_message_with_nested_tokens(Config) ->
         _Attempts = 20,
         ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
     ),
+    ?retry(
+        _Sleep = 1_000,
+        _Attempts = 20,
+        ?assertMatch(
+            #{status := connected},
+            emqx_bridge_v2:health_check(
+                ?BRIDGE_TYPE_BIN,
+                Name
+            )
+        )
+    ),
     MsgId = erlang:unique_integer(),
     Data = binary_to_list(?config(oracle_name, Config)),
     Params = #{
@@ -600,6 +663,7 @@ t_on_get_status(Config) ->
     ProxyPort = ?config(proxy_port, Config),
     ProxyHost = ?config(proxy_host, Config),
     ProxyName = ?config(proxy_name, Config),
+    Name = ?config(oracle_name, Config),
     ResourceId = resource_id(Config),
     reset_table(Config),
     ?assertMatch({ok, _}, create_bridge(Config)),
@@ -612,13 +676,23 @@ t_on_get_status(Config) ->
     ),
     emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
         ct:sleep(500),
-        ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceId))
+        ?assertEqual({ok, disconnected}, emqx_resource_manager:health_check(ResourceId)),
+        ?assertMatch(
+            #{status := disconnected},
+            emqx_bridge_v2:health_check(?BRIDGE_TYPE_BIN, Name)
+        )
     end),
     %% Check that it recovers itself.
     ?retry(
         _Sleep = 1_000,
         _Attempts = 20,
-        ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId))
+        begin
+            ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceId)),
+            ?assertMatch(
+                #{status := connected},
+                emqx_bridge_v2:health_check(?BRIDGE_TYPE_BIN, Name)
+            )
+        end
     ),
     ok.
 
@@ -664,6 +738,7 @@ t_missing_table(Config) ->
         begin
             drop_table_if_exists(Config),
             ?assertMatch({ok, _}, create_bridge_api(Config)),
+            ActionId = emqx_bridge_v2:id(?BRIDGE_TYPE_BIN, ?config(oracle_name, Config)),
             ?retry(
                 _Sleep = 1_000,
                 _Attempts = 20,
@@ -679,7 +754,7 @@ t_missing_table(Config) ->
                 payload => ?config(oracle_name, Config),
                 retain => true
             },
-            Message = {send_message, Params},
+            Message = {ActionId, Params},
             ?assertMatch(
                 {error, {resource_error, #{reason := not_connected}}},
                 emqx_resource:simple_sync_query(ResourceId, Message)
@@ -698,6 +773,7 @@ t_table_removed(Config) ->
         begin
             reset_table(Config),
             ?assertMatch({ok, _}, create_bridge_api(Config)),
+            ActionId = emqx_bridge_v2:id(?BRIDGE_TYPE_BIN, ?config(oracle_name, Config)),
             ?retry(
                 _Sleep = 1_000,
                 _Attempts = 20,
@@ -711,7 +787,7 @@ t_table_removed(Config) ->
                 payload => ?config(oracle_name, Config),
                 retain => true
             },
-            Message = {send_message, Params},
+            Message = {ActionId, Params},
             ?assertEqual(
                 {error, {unrecoverable_error, {942, "ORA-00942: table or view does not exist\n"}}},
                 emqx_resource:simple_sync_query(ResourceId, Message)
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 95c9d2991..dd069e4e6 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -36,6 +36,8 @@ resource_type(matrix) ->
     emqx_postgresql;
 resource_type(mongodb) ->
     emqx_bridge_mongodb_connector;
+resource_type(oracle) ->
+    emqx_oracle;
 resource_type(influxdb) ->
     emqx_bridge_influxdb_connector;
 resource_type(cassandra) ->
@@ -140,6 +142,15 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {oracle,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_oracle, "config_connector")),
+                #{
+                    desc => <<"Oracle Connector Config">>,
+                    required => false,
+                    validator => fun emqx_bridge_oracle:config_validator/1
+                }
+            )},
         {influxdb,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_influxdb, "config_connector")),
@@ -247,6 +258,7 @@ schema_modules() ->
         emqx_bridge_kinesis,
         emqx_bridge_matrix,
         emqx_bridge_mongodb,
+        emqx_bridge_oracle,
         emqx_bridge_influxdb,
         emqx_bridge_cassandra,
         emqx_bridge_mysql,
@@ -280,6 +292,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_kinesis, <<"kinesis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_matrix, <<"matrix">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mongodb, <<"mongodb">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_oracle, <<"oracle">>, Method ++ "_connector"),
         api_ref(emqx_bridge_influxdb, <<"influxdb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_cassandra, <<"cassandra">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mysql, <<"mysql">>, Method ++ "_connector"),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index b7c4d9f74..ea589c15c 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -137,6 +137,8 @@ connector_type_to_bridge_types(matrix) ->
     [matrix];
 connector_type_to_bridge_types(mongodb) ->
     [mongodb, mongodb_rs, mongodb_sharded, mongodb_single];
+connector_type_to_bridge_types(oracle) ->
+    [oracle];
 connector_type_to_bridge_types(influxdb) ->
     [influxdb, influxdb_api_v1, influxdb_api_v2];
 connector_type_to_bridge_types(cassandra) ->
diff --git a/apps/emqx_oracle/src/emqx_oracle.app.src b/apps/emqx_oracle/src/emqx_oracle.app.src
index 7740517ca..7cd4d4d0d 100644
--- a/apps/emqx_oracle/src/emqx_oracle.app.src
+++ b/apps/emqx_oracle/src/emqx_oracle.app.src
@@ -1,6 +1,6 @@
 {application, emqx_oracle, [
     {description, "EMQX Enterprise Oracle Database Connector"},
-    {vsn, "0.1.8"},
+    {vsn, "0.1.9"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_oracle/src/emqx_oracle.erl b/apps/emqx_oracle/src/emqx_oracle.erl
index cfc67aa53..e1ac846fa 100644
--- a/apps/emqx_oracle/src/emqx_oracle.erl
+++ b/apps/emqx_oracle/src/emqx_oracle.erl
@@ -6,6 +6,7 @@
 
 -behaviour(emqx_resource).
 
+-include_lib("emqx_resource/include/emqx_resource.hrl").
 -include_lib("emqx/include/logger.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
@@ -24,7 +25,11 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
 %% callbacks for ecpool
@@ -103,12 +108,13 @@ on_start(
         {app_name, "EMQX Data To Oracle Database Action"}
     ],
     PoolName = InstId,
-    Prepares = parse_prepare_sql(Config),
-    InitState = #{pool_name => PoolName},
-    State = maps:merge(InitState, Prepares),
+    State = #{
+        pool_name => PoolName,
+        installed_channels => #{}
+    },
     case emqx_resource_pool:start(InstId, ?MODULE, Options) of
         ok ->
-            {ok, init_prepare(State)};
+            {ok, State};
         {error, Reason} ->
             ?tp(
                 oracle_connector_start_failed,
@@ -125,13 +131,105 @@ on_stop(InstId, #{pool_name := PoolName}) ->
     ?tp(oracle_bridge_stopped, #{instance_id => InstId}),
     emqx_resource_pool:stop(PoolName).
 
+on_add_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels,
+        pool_name := PoolName
+    } = OldState,
+    ChannelId,
+    ChannelConfig
+) ->
+    {ok, ChannelState} = create_channel_state(ChannelId, PoolName, ChannelConfig),
+    NewInstalledChannels = maps:put(ChannelId, ChannelState, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+create_channel_state(
+    ChannelId,
+    PoolName,
+    #{parameters := Conf} = _ChannelConfig
+) ->
+    State0 = parse_prepare_sql(ChannelId, Conf),
+    State1 = init_prepare(PoolName, State0),
+    {ok, State1}.
+
+on_remove_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels
+    } = OldState,
+    ChannelId
+) ->
+    NewInstalledChannels = maps:remove(ChannelId, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+on_get_channel_status(
+    _ResId,
+    ChannelId,
+    #{
+        pool_name := PoolName,
+        installed_channels := Channels
+    } = _State
+) ->
+    State = maps:get(ChannelId, Channels),
+    case do_check_prepares(ChannelId, PoolName, State) of
+        ok ->
+            ?status_connected;
+        {error, undefined_table} ->
+            %% return new state indicating that we are connected but the target table is not created
+            {?status_disconnected, {unhealthy_target, ?UNHEALTHY_TARGET_MSG}};
+        {error, _Reason} ->
+            %% do not log error, it is logged in prepare_sql_to_conn
+            connecting
+    end.
+% #{stream_name := StreamName} = maps:get(ChannelId, Channels),
+% case
+%     emqx_resource_pool:health_check_workers(
+%         PoolName,
+%         {emqx_bridge_kinesis_connector_client, connection_status, [StreamName]},
+%         ?HEALTH_CHECK_TIMEOUT,
+%         #{return_values => true}
+%     )
+% of
+%     {ok, Values} ->
+%         AllOk = lists:all(fun(S) -> S =:= {ok, ?status_connected} end, Values),
+%         case AllOk of
+%             true ->
+%                 ?status_connected;
+%             false ->
+%                 Unhealthy = lists:any(fun(S) -> S =:= {error, unhealthy_target} end, Values),
+%                 case Unhealthy of
+%                     true -> {?status_disconnected, {unhealthy_target, ?TOPIC_MESSAGE}};
+%                     false -> ?status_disconnected
+%                 end
+%         end;
+%     {error, Reason} ->
+%         ?SLOG(error, #{
+%             msg => "kinesis_producer_get_status_failed",
+%             state => State,
+%             reason => Reason
+%         }),
+%         ?status_disconnected
+% end.
+
+on_get_channels(ResId) ->
+    emqx_bridge_v2:get_channels_for_connector(ResId).
+
 on_query(InstId, {TypeOrKey, NameOrSQL}, #{pool_name := _PoolName} = State) ->
     on_query(InstId, {TypeOrKey, NameOrSQL, []}, State);
 on_query(
     InstId,
     {TypeOrKey, NameOrSQL, Params},
-    #{pool_name := PoolName} = State
+    #{
+        pool_name := PoolName,
+        installed_channels := Channels
+    } = _ConnectorState
 ) ->
+    State = maps:get(TypeOrKey, Channels, #{}),
     ?SLOG(debug, #{
         msg => "oracle_connector_received_sql_query",
         connector => InstId,
@@ -147,11 +245,19 @@ on_query(
 on_batch_query(
     InstId,
     BatchReq,
-    #{pool_name := PoolName, params_tokens := Tokens, prepare_sql := Sts} = State
+    #{
+        pool_name := PoolName,
+        installed_channels := Channels
+    } = ConnectorState
 ) ->
     case BatchReq of
         [{Key, _} = Request | _] ->
             BinKey = to_bin(Key),
+            State = maps:get(BinKey, Channels),
+            #{
+                params_tokens := Tokens,
+                prepare_sql := Sts
+            } = State,
             case maps:get(BinKey, Tokens, undefined) of
                 undefined ->
                     Log = #{
@@ -179,7 +285,7 @@ on_batch_query(
             Log = #{
                 connector => InstId,
                 request => BatchReq,
-                state => State,
+                state => ConnectorState,
                 msg => "invalid_request"
             },
             ?SLOG(error, Log),
@@ -232,36 +338,35 @@ on_sql_query(InstId, PoolName, Type, ApplyMode, NameOrSQL, Data) ->
             Result
     end.
 
-on_get_status(_InstId, #{pool_name := Pool} = State) ->
+on_get_status(_InstId, #{pool_name := Pool} = _State) ->
     case emqx_resource_pool:health_check_workers(Pool, fun ?MODULE:do_get_status/1) of
         true ->
-            case do_check_prepares(State) of
-                ok ->
-                    connected;
-                {ok, NState} ->
-                    %% return new state with prepared statements
-                    {connected, NState};
-                {error, {undefined_table, NState}} ->
-                    %% return new state indicating that we are connected but the target table is not created
-                    {disconnected, NState, {unhealthy_target, ?UNHEALTHY_TARGET_MSG}};
-                {error, _Reason} ->
-                    %% do not log error, it is logged in prepare_sql_to_conn
-                    connecting
-            end;
+            ?status_connected;
         false ->
-            disconnected
+            ?status_disconnected
     end.
 
 do_get_status(Conn) ->
     ok == element(1, jamdb_oracle:sql_query(Conn, "select 1 from dual")).
 
 do_check_prepares(
+    _ChannelId,
+    _PoolName,
     #{
-        pool_name := PoolName,
-        prepare_sql := #{<<"send_message">> := SQL},
-        params_tokens := #{<<"send_message">> := Tokens}
-    } = State
+        prepare_sql := {error, _Prepares}
+    } = _State
 ) ->
+    {error, undefined_table};
+do_check_prepares(
+    ChannelId,
+    PoolName,
+    State
+) ->
+    #{
+        prepare_sql := #{ChannelId := SQL},
+        params_tokens := #{ChannelId := Tokens}
+    } = State,
+
     % it's already connected. Verify if target table still exists
     Workers = [Worker || {_WorkerName, Worker} <- ecpool:workers(PoolName)],
     lists:foldl(
@@ -270,7 +375,7 @@ do_check_prepares(
                 case ecpool_worker:client(WorkerPid) of
                     {ok, Conn} ->
                         case check_if_table_exists(Conn, SQL, Tokens) of
-                            {error, undefined_table} -> {error, {undefined_table, State}};
+                            {error, undefined_table} -> {error, undefined_table};
                             _ -> ok
                         end;
                     _ ->
@@ -281,20 +386,17 @@ do_check_prepares(
         end,
         ok,
         Workers
-    );
-do_check_prepares(
-    State = #{pool_name := PoolName, prepare_sql := {error, Prepares}, params_tokens := TokensMap}
-) ->
-    case prepare_sql(Prepares, PoolName, TokensMap) of
-        %% remove the error
-        {ok, Sts} ->
-            {ok, State#{prepare_sql => Sts}};
-        {error, undefined_table} ->
-            %% indicate the error
-            {error, {undefined_table, State#{prepare_sql => {error, Prepares}}}};
-        {error, _Reason} = Error ->
-            Error
-    end.
+    ).
+% case prepare_sql(Prepares, PoolName, TokensMap) of
+%     %% remove the error
+%     {ok, Sts} ->
+%         {ok, State#{prepare_sql => Sts}};
+%     {error, undefined_table} ->
+%         %% indicate the error
+%         {error, {undefined_table, State#{prepare_sql => {error, Prepares}}}};
+%     {error, _Reason} = Error ->
+%         Error
+% end.
 
 %% ===================================================================
 
@@ -328,13 +430,13 @@ execute_batch(Conn, SQL, ParamsList) ->
     ?tp(oracle_batch_query, #{conn => Conn, sql => SQL, params => ParamsList, result => Ret}),
     handle_result(Ret).
 
-parse_prepare_sql(Config) ->
+parse_prepare_sql(ChannelId, Config) ->
     SQL =
         case maps:get(prepare_statement, Config, undefined) of
             undefined ->
                 case maps:get(sql, Config, undefined) of
                     undefined -> #{};
-                    Template -> #{<<"send_message">> => Template}
+                    Template -> #{ChannelId => Template}
                 end;
             Any ->
                 Any
@@ -352,7 +454,7 @@ parse_prepare_sql([], Prepares, Tokens) ->
         params_tokens => Tokens
     }.
 
-init_prepare(State = #{prepare_sql := Prepares, pool_name := PoolName, params_tokens := TokensMap}) ->
+init_prepare(PoolName, State = #{prepare_sql := Prepares, params_tokens := TokensMap}) ->
     case prepare_sql(Prepares, PoolName, TokensMap) of
         {ok, Sts} ->
             State#{prepare_sql := Sts};
diff --git a/rel/i18n/emqx_bridge_oracle.hocon b/rel/i18n/emqx_bridge_oracle.hocon
index bcf41ea2c..607976018 100644
--- a/rel/i18n/emqx_bridge_oracle.hocon
+++ b/rel/i18n/emqx_bridge_oracle.hocon
@@ -54,4 +54,19 @@ emqx_bridge_oracle {
     label = "Bridge Name"
   }
 
+  action_parameters {
+    desc = "Action specific configuration."
+    label = "Action"
+  }
+
+  oracle_action {
+    desc = "Configuration for Oracle Action"
+    label = "Oracle Action Configuration"
+  }
+
+  config_connector {
+    desc = "Configuration for an Oracle Client."
+    label = "Oracle Client Configuration"
+  }
+
 }

From ee35ecb04d6dbd65cffa2c06175f34b192753c27 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 1 Feb 2024 16:08:36 +0100
Subject: [PATCH 129/273] docs: add change log entry for Oracle bridge
 refactoring

---
 changes/ee/feat-12439.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12439.en.md

diff --git a/changes/ee/feat-12439.en.md b/changes/ee/feat-12439.en.md
new file mode 100644
index 000000000..edd9abe69
--- /dev/null
+++ b/changes/ee/feat-12439.en.md
@@ -0,0 +1 @@
+The Oracle bridge has been split into connector and action components. Old Oracle bridges will be upgraded automatically.

From dfad020c495b165fe026d4e45cf788f47a3e1ef6 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 1 Feb 2024 23:12:59 +0800
Subject: [PATCH 130/273] feat(tdengine): improve the TDengine bridge to v2
 style

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   3 +-
 .../src/emqx_bridge_opents_connector.erl      |   2 +-
 .../src/emqx_bridge_tdengine.erl              | 137 +++--
 .../src/emqx_bridge_tdengine_action_info.erl  |  71 +++
 .../src/emqx_bridge_tdengine_connector.erl    | 202 ++++--
 .../test/emqx_bridge_tdengine_SUITE.erl       | 573 +++++-------------
 .../src/schema/emqx_connector_ee_schema.erl   |  18 +-
 .../src/schema/emqx_connector_schema.erl      |   4 +-
 rel/i18n/emqx_bridge_tdengine.hocon           |   6 +
 rel/i18n/emqx_bridge_tdengine_connector.hocon |   6 +
 10 files changed, 492 insertions(+), 530 deletions(-)
 create mode 100644 apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index b495fa671..b83fa92bf 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -102,7 +102,8 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_iotdb_action_info,
         emqx_bridge_es_action_info,
         emqx_bridge_opents_action_info,
-        emqx_bridge_greptimedb_action_info
+        emqx_bridge_greptimedb_action_info,
+        emqx_bridge_tdengine_action_info
     ].
 -else.
 hard_coded_action_info_modules_ee() ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index faa8c769c..68bdfc9ef 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -74,7 +74,7 @@ desc(connector_resource_opts) ->
 desc("config_connector") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
-    ["Configuration for IoTDB using `", string:to_upper(Method), "` method."];
+    ["Configuration for OpenTSDB using `", string:to_upper(Method), "` method."];
 desc(_) ->
     undefined.
 
diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.erl b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.erl
index da170e943..3025ff55e 100644
--- a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.erl
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.erl
@@ -9,35 +9,21 @@
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
 
--export([
-    conn_bridge_examples/1,
-    values/1
-]).
-
--export([
-    namespace/0,
-    roots/0,
-    fields/1,
-    desc/1
-]).
+-export([conn_bridge_examples/1, values/1, bridge_v2_examples/1]).
+-export([namespace/0, roots/0, fields/1, desc/1]).
 
 -define(DEFAULT_SQL, <<
-    "insert into t_mqtt_msg(ts, msgid, mqtt_topic, qos, payload, arrived) "
-    "values (${ts}, '${id}', '${topic}', ${qos}, '${payload}', ${timestamp})"
+    "insert into t_mqtt_msg(ts, msgid, mqtt_topic, qos, payload, "
+    "arrived) values (${ts}, '${id}', '${topic}', ${qos}, '${payload}', "
+    "${timestamp})"
 >>).
+-define(CONNECTOR_TYPE, tdengine).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
 
 %% -------------------------------------------------------------------------------------------------
-%% api
-
+%% v1 examples
 conn_bridge_examples(Method) ->
-    [
-        #{
-            <<"tdengine">> => #{
-                summary => <<"TDengine Bridge">>,
-                value => values(Method)
-            }
-        }
-    ].
+    [#{<<"tdengine">> => #{summary => <<"TDengine Bridge">>, value => values(Method)}}].
 
 values(_Method) ->
     #{
@@ -51,21 +37,46 @@ values(_Method) ->
         password => <<"******">>,
         sql => ?DEFAULT_SQL,
         local_topic => <<"local/topic/#">>,
-        resource_opts => #{
-            worker_pool_size => 8,
-            health_check_interval => ?HEALTHCHECK_INTERVAL_RAW,
-            batch_size => ?DEFAULT_BATCH_SIZE,
-            batch_time => ?DEFAULT_BATCH_TIME,
-            query_mode => sync,
-            max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
+        resource_opts =>
+            #{
+                worker_pool_size => 8,
+                health_check_interval => ?HEALTHCHECK_INTERVAL_RAW,
+                batch_size => ?DEFAULT_BATCH_SIZE,
+                batch_time => ?DEFAULT_BATCH_TIME,
+                query_mode => sync,
+                max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
+            }
+    }.
+
+%% -------------------------------------------------------------------------------------------------
+%% v2 examples
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"tdengine">> => #{
+                summary => <<"TDengine Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                )
+            }
+        }
+    ].
+
+action_values() ->
+    #{
+        parameters => #{
+            database => <<"mqtt">>,
+            sql => ?DEFAULT_SQL
         }
     }.
 
 %% -------------------------------------------------------------------------------------------------
-%% Hocon Schema Definitions
-namespace() -> "bridge_tdengine".
+%% v1 Hocon Schema Definitions
+namespace() ->
+    "bridge_tdengine".
 
-roots() -> [].
+roots() ->
+    [].
 
 fields("config") ->
     [
@@ -73,24 +84,68 @@ fields("config") ->
         {sql,
             mk(
                 binary(),
-                #{desc => ?DESC("sql_template"), default => ?DEFAULT_SQL, format => <<"sql">>}
+                #{
+                    desc => ?DESC("sql_template"),
+                    default => ?DEFAULT_SQL,
+                    format => <<"sql">>
+                }
             )},
-        {local_topic,
-            mk(
-                binary(),
-                #{desc => ?DESC("local_topic"), default => undefined}
-            )}
-    ] ++ emqx_resource_schema:fields("resource_opts") ++
+        {local_topic, mk(binary(), #{desc => ?DESC("local_topic"), default => undefined})}
+    ] ++
+        emqx_resource_schema:fields("resource_opts") ++
         emqx_bridge_tdengine_connector:fields(config);
 fields("post") ->
     [type_field(), name_field() | fields("config")];
 fields("put") ->
     fields("config");
 fields("get") ->
-    emqx_bridge_schema:status_fields() ++ fields("post").
+    emqx_bridge_schema:status_fields() ++ fields("post");
+%% -------------------------------------------------------------------------------------------------
+%% v2 Hocon Schema Definitions
+fields(action) ->
+    {tdengine,
+        mk(
+            hoconsc:map(name, ref(?MODULE, action_config)),
+            #{
+                desc => <<"TDengine Action Config">>,
+                required => false
+            }
+        )};
+fields(action_config) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(
+            ref(?MODULE, action_parameters),
+            #{
+                required => true, desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    [
+        {database, fun emqx_connector_schema_lib:database/1},
+        {sql,
+            mk(
+                binary(),
+                #{
+                    desc => ?DESC("sql_template"),
+                    default => ?DEFAULT_SQL,
+                    format => <<"sql">>
+                }
+            )}
+    ];
+fields("post_bridge_v2") ->
+    emqx_bridge_schema:type_and_name_fields(enum([tdengine])) ++ fields(action_config);
+fields("put_bridge_v2") ->
+    fields(action_config);
+fields("get_bridge_v2") ->
+    emqx_bridge_schema:status_fields() ++ fields("post_bridge_v2").
 
 desc("config") ->
     ?DESC("desc_config");
+desc(action_config) ->
+    ?DESC("desc_config");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for TDengine using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl
new file mode 100644
index 000000000..11db9c52e
--- /dev/null
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl
@@ -0,0 +1,71 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_tdengine_action_info).
+
+-behaviour(emqx_action_info).
+
+-elvis([{elvis_style, invalid_dynamic_call, disable}]).
+
+%% behaviour callbacks
+-export([
+    action_type_name/0,
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_type_name/0,
+    connector_action_config_to_bridge_v1_config/2,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(ACTION_TYPE, tdengine).
+-define(SCHEMA_MODULE, emqx_bridge_tdengine).
+
+action_type_name() -> ?ACTION_TYPE.
+bridge_v1_type_name() -> ?ACTION_TYPE.
+connector_type_name() -> ?ACTION_TYPE.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
+    MergedConfig =
+        emqx_utils_maps:deep_merge(
+            maps:without(
+                [<<"description">>, <<"local_topic">>, <<"connector">>, <<"data">>],
+                emqx_utils_maps:unindent(<<"parameters">>, ActionConfig)
+            ),
+            ConnectorConfig
+        ),
+    BridgeV1Keys = schema_keys("config"),
+    maps:with(BridgeV1Keys, MergedConfig).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(action_config),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ConnectorKeys = schema_keys(emqx_bridge_tdengine_connector, "config_connector"),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        maps:with(ConnectorKeys, BridgeV1Config)
+    ).
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    schema_keys(?SCHEMA_MODULE, Name).
+
+schema_keys(Mod, Name) ->
+    [bin(Key) || Key <- proplists:get_keys(Mod:fields(Name))].
diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
index 522007cbc..d35be0f2e 100644
--- a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
@@ -11,7 +11,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([roots/0, fields/1]).
+-export([namespace/0, roots/0, fields/1, desc/1]).
 
 %% `emqx_resource' API
 -export([
@@ -20,9 +20,15 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
+-export([connector_examples/1]).
+
 -export([connect/1, do_get_status/1, execute/3, do_batch_insert/4]).
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
@@ -31,8 +37,12 @@
     default_port => 6041
 }).
 
+-define(CONNECTOR_TYPE, tdengine).
+
+namespace() -> "tdengine_connector".
+
 %%=====================================================================
-%% Hocon schema
+%% V1 Hocon schema
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
@@ -40,17 +50,45 @@ fields(config) ->
     [
         {server, server()}
         | adjust_fields(emqx_connector_schema_lib:relational_db_fields())
-    ].
+    ];
+%%=====================================================================
+%% V2 Hocon schema
+
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        fields(config) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields("post") ->
+    emqx_connector_schema:type_and_name_fields(enum([tdengine])) ++ fields("config_connector");
+fields("put") ->
+    fields("config_connector");
+fields("get") ->
+    emqx_bridge_schema:status_fields() ++ fields("post").
+
+desc(config) ->
+    ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
+    ["Configuration for TDengine using `", string:to_upper(Method), "` method."];
+desc(_) ->
+    undefined.
 
 adjust_fields(Fields) ->
-    lists:map(
+    lists:filtermap(
         fun
             ({username, OrigUsernameFn}) ->
-                {username, add_default_fn(OrigUsernameFn, <<"root">>)};
+                {true, {username, add_default_fn(OrigUsernameFn, <<"root">>)}};
             ({password, _}) ->
-                {password, emqx_connector_schema_lib:password_field(#{required => true})};
-            (Field) ->
-                Field
+                {true, {password, emqx_connector_schema_lib:password_field(#{required => true})}};
+            ({database, _}) ->
+                false;
+            (_Field) ->
+                true
         end,
         Fields
     ).
@@ -65,6 +103,32 @@ server() ->
     Meta = #{desc => ?DESC("server")},
     emqx_schema:servers_sc(Meta, ?TD_HOST_OPTIONS).
 
+%%=====================================================================
+%% V2 Hocon schema
+connector_examples(Method) ->
+    [
+        #{
+            <<"tdengine">> =>
+                #{
+                    summary => <<"TDengine Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_example_values()
+                    )
+                }
+        }
+    ].
+
+connector_example_values() ->
+    #{
+        name => <<"tdengine_connector">>,
+        type => tdengine,
+        enable => true,
+        server => <<"127.0.0.1:6041">>,
+        pool_size => 8,
+        username => <<"root">>,
+        password => <<"******">>
+    }.
+
 %%========================================================================================
 %% `emqx_resource' API
 %%========================================================================================
@@ -93,11 +157,10 @@ on_start(
         {username, Username},
         {password, Password},
         {pool_size, PoolSize},
-        {pool, binary_to_atom(InstanceId, utf8)}
+        {pool, InstanceId}
     ],
 
-    Prepares = parse_prepare_sql(Config),
-    State = Prepares#{pool_name => InstanceId, query_opts => query_opts(Config)},
+    State = #{pool_name => InstanceId, channels => #{}},
     case emqx_resource_pool:start(InstanceId, ?MODULE, Options) of
         ok ->
             {ok, State};
@@ -110,34 +173,33 @@ on_stop(InstanceId, _State) ->
         msg => "stopping_tdengine_connector",
         connector => InstanceId
     }),
+    ?tp(tdengine_connector_stop, #{instance_id => InstanceId}),
     emqx_resource_pool:stop(InstanceId).
 
-on_query(InstanceId, {query, SQL}, State) ->
-    do_query(InstanceId, SQL, State);
-on_query(InstanceId, {Key, Data}, #{insert_tokens := InsertTksMap} = State) ->
-    case maps:find(Key, InsertTksMap) of
-        {ok, Tokens} when is_map(Data) ->
-            SQL = emqx_placeholder:proc_tmpl(Tokens, Data),
-            do_query(InstanceId, SQL, State);
+on_query(InstanceId, {ChannelId, Data}, #{channels := Channels} = State) ->
+    case maps:find(ChannelId, Channels) of
+        {ok, #{insert := Tokens, opts := Opts}} ->
+            Query = emqx_placeholder:proc_tmpl(Tokens, Data),
+            do_query_job(InstanceId, {?MODULE, execute, [Query, Opts]}, State);
         _ ->
-            {error, {unrecoverable_error, invalid_request}}
+            {error, {unrecoverable_error, {invalid_channel_id, InstanceId}}}
     end.
 
 %% aggregate the batch queries to one SQL is a heavy job, we should put it in the worker process
 on_batch_query(
     InstanceId,
-    [{Key, _Data = #{}} | _] = BatchReq,
-    #{batch_tokens := BatchTksMap, query_opts := Opts} = State
+    [{ChannelId, _Data = #{}} | _] = BatchReq,
+    #{channels := Channels} = State
 ) ->
-    case maps:find(Key, BatchTksMap) of
-        {ok, Tokens} ->
+    case maps:find(ChannelId, Channels) of
+        {ok, #{batch := Tokens, opts := Opts}} ->
             do_query_job(
                 InstanceId,
                 {?MODULE, do_batch_insert, [Tokens, BatchReq, Opts]},
                 State
             );
         _ ->
-            {error, {unrecoverable_error, batch_prepare_not_implemented}}
+            {error, {unrecoverable_error, {invalid_channel_id, InstanceId}}}
     end;
 on_batch_query(InstanceId, BatchReq, State) ->
     LogMeta = #{connector => InstanceId, request => BatchReq, state => State},
@@ -157,13 +219,46 @@ do_get_status(Conn) ->
 status_result(_Status = true) -> connected;
 status_result(_Status = false) -> connecting.
 
+on_add_channel(
+    _InstanceId,
+    #{channels := Channels} = OldState,
+    ChannelId,
+    #{
+        parameters := #{database := Database, sql := SQL}
+    }
+) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            {error, already_exists};
+        _ ->
+            case parse_prepare_sql(SQL) of
+                {ok, Result} ->
+                    Opts = [{db_name, Database}],
+                    Channels2 = Channels#{ChannelId => Result#{opts => Opts}},
+                    {ok, OldState#{channels := Channels2}};
+                Error ->
+                    Error
+            end
+    end.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = OldState, ChannelId) ->
+    {ok, OldState#{channels => maps:remove(ChannelId, Channels)}}.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
+on_get_channel_status(InstanceId, ChannelId, #{channels := Channels} = State) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            on_get_status(InstanceId, State);
+        _ ->
+            {error, not_exists}
+    end.
+
 %%========================================================================================
 %% Helper fns
 %%========================================================================================
 
-do_query(InstanceId, Query, #{query_opts := Opts} = State) ->
-    do_query_job(InstanceId, {?MODULE, execute, [Query, Opts]}, State).
-
 do_query_job(InstanceId, Job, #{pool_name := PoolName} = State) ->
     ?TRACE(
         "QUERY",
@@ -171,12 +266,11 @@ do_query_job(InstanceId, Job, #{pool_name := PoolName} = State) ->
         #{connector => InstanceId, job => Job, state => State}
     ),
     Result = ecpool:pick_and_do(PoolName, Job, no_handover),
-
     case Result of
         {error, Reason} ->
             ?tp(
                 tdengine_connector_query_return,
-                #{error => Reason}
+                #{instance_id => InstanceId, error => Reason}
             ),
             ?SLOG(error, #{
                 msg => "tdengine_connector_do_query_failed",
@@ -193,7 +287,7 @@ do_query_job(InstanceId, Job, #{pool_name := PoolName} = State) ->
         _ ->
             ?tp(
                 tdengine_connector_query_return,
-                #{result => Result}
+                #{instance_id => InstanceId, result => Result}
             ),
             Result
     end.
@@ -221,49 +315,23 @@ connect(Opts) ->
     NOpts = [{password, emqx_secret:unwrap(Secret)} | OptsRest],
     tdengine:start_link(NOpts).
 
-query_opts(#{database := Database} = _Opts) ->
-    [{db_name, Database}].
-
-parse_prepare_sql(Config) ->
-    SQL =
-        case maps:get(sql, Config, undefined) of
-            undefined -> #{};
-            Template -> #{send_message => Template}
-        end,
-
-    parse_batch_prepare_sql(maps:to_list(SQL), #{}, #{}).
-
-parse_batch_prepare_sql([{Key, H} | T], InsertTksMap, BatchTksMap) ->
-    case emqx_utils_sql:get_statement_type(H) of
-        select ->
-            parse_batch_prepare_sql(T, InsertTksMap, BatchTksMap);
+parse_prepare_sql(SQL) ->
+    case emqx_utils_sql:get_statement_type(SQL) of
         insert ->
-            InsertTks = emqx_placeholder:preproc_tmpl(H),
-            H1 = string:trim(H, trailing, ";"),
-            case split_insert_sql(H1) of
+            InsertTks = emqx_placeholder:preproc_tmpl(SQL),
+            SQL1 = string:trim(SQL, trailing, ";"),
+            case split_insert_sql(SQL1) of
                 [_InsertPart, BatchDesc] ->
                     BatchTks = emqx_placeholder:preproc_tmpl(BatchDesc),
-                    parse_batch_prepare_sql(
-                        T,
-                        InsertTksMap#{Key => InsertTks},
-                        BatchTksMap#{Key => BatchTks}
-                    );
+                    {ok, #{insert => InsertTks, batch => BatchTks}};
                 Result ->
-                    ?SLOG(error, #{msg => "split_sql_failed", sql => H, result => Result}),
-                    parse_batch_prepare_sql(T, InsertTksMap, BatchTksMap)
+                    {error, #{msg => "split_sql_failed", sql => SQL, result => Result}}
             end;
         Type when is_atom(Type) ->
-            ?SLOG(error, #{msg => "detect_sql_type_unsupported", sql => H, type => Type}),
-            parse_batch_prepare_sql(T, InsertTksMap, BatchTksMap);
+            {error, #{msg => "detect_sql_type_unsupported", sql => SQL, type => Type}};
         {error, Reason} ->
-            ?SLOG(error, #{msg => "detect_sql_type_failed", sql => H, reason => Reason}),
-            parse_batch_prepare_sql(T, InsertTksMap, BatchTksMap)
-    end;
-parse_batch_prepare_sql([], InsertTksMap, BatchTksMap) ->
-    #{
-        insert_tokens => InsertTksMap,
-        batch_tokens => BatchTksMap
-    }.
+            {error, #{msg => "detect_sql_type_failed", sql => SQL, reason => Reason}}
+    end.
 
 to_bin(List) when is_list(List) ->
     unicode:characters_to_binary(List, utf8).
diff --git a/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl b/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
index 92ad3a611..610eca714 100644
--- a/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
+++ b/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
@@ -54,6 +54,11 @@
     ok = tdengine:stop(Con)
 ).
 
+-define(BRIDGE_TYPE_BIN, <<"tdengine">>).
+-define(APPS, [
+    hackney, tdengine, emqx_bridge, emqx_resource, emqx_rule_engine, emqx_bridge_tdengine
+]).
+
 %%------------------------------------------------------------------------------
 %% CT boilerplate
 %%------------------------------------------------------------------------------
@@ -66,16 +71,21 @@ all() ->
 
 groups() ->
     TCs = emqx_common_test_helpers:all(?MODULE),
-    NonBatchCases = [t_write_timeout],
     MustBatchCases = [t_batch_insert, t_auto_create_batch_insert],
     BatchingGroups = [{group, with_batch}, {group, without_batch}],
     [
         {async, BatchingGroups},
         {sync, BatchingGroups},
-        {with_batch, TCs -- NonBatchCases},
+        {with_batch, TCs},
         {without_batch, TCs -- MustBatchCases}
     ].
 
+init_per_suite(Config) ->
+    emqx_bridge_v2_testlib:init_per_suite(Config, ?APPS).
+
+end_per_suite(Config) ->
+    emqx_bridge_v2_testlib:end_per_suite(Config).
+
 init_per_group(async, Config) ->
     [{query_mode, async} | Config];
 init_per_group(sync, Config) ->
@@ -89,36 +99,37 @@ init_per_group(without_batch, Config0) ->
 init_per_group(_Group, Config) ->
     Config.
 
-end_per_group(Group, Config) when Group =:= with_batch; Group =:= without_batch ->
-    connect_and_drop_table(Config),
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
+end_per_group(default, Config) ->
+    emqx_bridge_v2_testlib:end_per_group(Config),
     ok;
 end_per_group(_Group, _Config) ->
     ok.
 
-init_per_suite(Config) ->
+init_per_testcase(TestCase, Config0) ->
+    connect_and_clear_table(Config0),
+    Type = ?config(bridge_type, Config0),
+    UniqueNum = integer_to_binary(erlang:unique_integer()),
+    Name = <<
+        (atom_to_binary(TestCase))/binary, UniqueNum/binary
+    >>,
+    {_ConfigString, ConnectorConfig} = connector_config(Name, Config0),
+    {_, ActionConfig} = action_config(TestCase, Name, Config0),
+    Config = [
+        {connector_type, Type},
+        {connector_name, Name},
+        {connector_config, ConnectorConfig},
+        {bridge_type, Type},
+        {bridge_name, Name},
+        {bridge_config, ActionConfig}
+        | Config0
+    ],
+    emqx_bridge_v2_testlib:delete_all_bridges_and_connectors(),
+    ok = snabbkaffe:start_trace(),
     Config.
 
-end_per_suite(_Config) ->
-    emqx_mgmt_api_test_util:end_suite(),
-    ok = emqx_common_test_helpers:stop_apps([emqx_bridge, emqx_conf]),
-    ok.
-
-init_per_testcase(_Testcase, Config) ->
+end_per_testcase(TestCase, Config) ->
+    emqx_bridge_v2_testlib:end_per_testcase(TestCase, Config),
     connect_and_clear_table(Config),
-    delete_bridge(Config),
-    snabbkaffe:start_trace(),
-    Config.
-
-end_per_testcase(_Testcase, Config) ->
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-    connect_and_clear_table(Config),
-    ok = snabbkaffe:stop(),
-    delete_bridge(Config),
     ok.
 
 %%------------------------------------------------------------------------------
@@ -132,34 +143,14 @@ common_init(ConfigT) ->
     Config0 = [
         {td_host, Host},
         {td_port, Port},
-        {proxy_name, "tdengine_restful"},
-        {template, ?SQL_BRIDGE}
+        {proxy_name, "tdengine_restful"}
         | ConfigT
     ],
 
-    BridgeType = proplists:get_value(bridge_type, Config0, <<"tdengine">>),
     case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
-            % Setup toxiproxy
-            ProxyHost = os:getenv("PROXY_HOST", "toxiproxy"),
-            ProxyPort = list_to_integer(os:getenv("PROXY_PORT", "8474")),
-            emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
-            % Ensure enterprise bridge module is loaded
-            ok = emqx_common_test_helpers:start_apps([emqx_conf, emqx_bridge, tdengine]),
-            _ = emqx_bridge_enterprise:module_info(),
-            emqx_mgmt_api_test_util:init_suite(),
-            % Connect to tdengine directly and create the table
-            connect_and_create_table(Config0),
-            {Name, TDConf} = tdengine_config(BridgeType, Config0),
-            Config =
-                [
-                    {tdengine_config, TDConf},
-                    {tdengine_bridge_type, BridgeType},
-                    {tdengine_name, Name},
-                    {proxy_host, ProxyHost},
-                    {proxy_port, ProxyPort}
-                    | Config0
-                ],
+            Config = emqx_bridge_v2_testlib:init_per_group(default, ?BRIDGE_TYPE_BIN, Config0),
+            connect_and_create_table(Config),
             Config;
         false ->
             case os:getenv("IS_CI") of
@@ -170,97 +161,100 @@ common_init(ConfigT) ->
             end
     end.
 
-tdengine_config(BridgeType, Config) ->
-    Port = integer_to_list(?config(td_port, Config)),
-    Server = ?config(td_host, Config) ++ ":" ++ Port,
-    Name = atom_to_binary(?MODULE),
+action_config(TestCase, Name, Config) ->
+    Type = ?config(bridge_type, Config),
     BatchSize =
         case ?config(enable_batch, Config) of
             true -> ?BATCH_SIZE;
             false -> 1
         end,
     QueryMode = ?config(query_mode, Config),
-    Template = ?config(template, Config),
     ConfigString =
         io_lib:format(
-            "bridges.~s.~s {\n"
+            "actions.~s.~s {\n"
             "  enable = true\n"
-            "  server = ~p\n"
-            "  database = ~p\n"
-            "  username = ~p\n"
-            "  password = ~p\n"
-            "  sql = ~p\n"
+            "  connector = \"~s\"\n"
+            "  parameters = {\n"
+            "    database = ~p\n"
+            "    sql = ~p\n"
+            "  }\n"
             "  resource_opts = {\n"
             "    request_ttl = 500ms\n"
             "    batch_size = ~b\n"
             "    query_mode = ~s\n"
             "  }\n"
-            "}",
+            "}\n",
             [
-                BridgeType,
+                Type,
+                Name,
                 Name,
-                Server,
                 ?TD_DATABASE,
-                ?TD_USERNAME,
-                ?TD_PASSWORD,
-                Template,
+                case TestCase of
+                    Auto when
+                        Auto =:= t_auto_create_simple_insert; Auto =:= t_auto_create_batch_insert
+                    ->
+                        ?AUTO_CREATE_BRIDGE;
+                    _ ->
+                        ?SQL_BRIDGE
+                end,
                 BatchSize,
                 QueryMode
             ]
         ),
-    {Name, parse_and_check(ConfigString, BridgeType, Name)}.
+    ct:pal("ActionConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_action_and_check(ConfigString, Type, Name)}.
 
-parse_and_check(ConfigString, BridgeType, Name) ->
+connector_config(Name, Config) ->
+    Host = ?config(td_host, Config),
+    Port = ?config(td_port, Config),
+    Type = ?config(bridge_type, Config),
+    Server = Host ++ ":" ++ integer_to_list(Port),
+    ConfigString =
+        io_lib:format(
+            "connectors.~s.~s {\n"
+            "  enable = true\n"
+            "  server = \"~s\"\n"
+            "  username = ~p\n"
+            "  password = ~p\n"
+            "}\n",
+            [
+                Type,
+                Name,
+                Server,
+                ?TD_USERNAME,
+                ?TD_PASSWORD
+            ]
+        ),
+    ct:pal("ConnectorConfig:~ts~n", [ConfigString]),
+    {ConfigString, parse_connector_and_check(ConfigString, Type, Name)}.
+
+parse_action_and_check(ConfigString, BridgeType, Name) ->
+    parse_and_check(ConfigString, emqx_bridge_schema, <<"actions">>, BridgeType, Name).
+
+parse_connector_and_check(ConfigString, ConnectorType, Name) ->
+    parse_and_check(
+        ConfigString, emqx_connector_schema, <<"connectors">>, ConnectorType, Name
+    ).
+
+parse_and_check(ConfigString, SchemaMod, RootKey, Type0, Name) ->
+    Type = to_bin(Type0),
     {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
-    hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
-    #{<<"bridges">> := #{BridgeType := #{Name := Config}}} = RawConf,
+    hocon_tconf:check_plain(SchemaMod, RawConf, #{required => false, atom_key => false}),
+    #{RootKey := #{Type := #{Name := Config}}} = RawConf,
     Config.
 
-create_bridge(Config) ->
-    create_bridge(Config, _Overrides = #{}).
-
-create_bridge(Config, Overrides) ->
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    Name = ?config(tdengine_name, Config),
-    TDConfig0 = ?config(tdengine_config, Config),
-    TDConfig = emqx_utils_maps:deep_merge(TDConfig0, Overrides),
-    emqx_bridge:create(BridgeType, Name, TDConfig).
-
-delete_bridge(Config) ->
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    Name = ?config(tdengine_name, Config),
-    emqx_bridge:remove(BridgeType, Name).
-
-create_bridge_http(Params) ->
-    Path = emqx_mgmt_api_test_util:api_path(["bridges"]),
-    AuthHeader = emqx_mgmt_api_test_util:auth_header_(),
-    case emqx_mgmt_api_test_util:request_api(post, Path, "", AuthHeader, Params) of
-        {ok, Res} -> {ok, emqx_utils_json:decode(Res, [return_maps])};
-        Error -> Error
-    end.
+to_bin(List) when is_list(List) ->
+    unicode:characters_to_binary(List, utf8);
+to_bin(Atom) when is_atom(Atom) ->
+    erlang:atom_to_binary(Atom);
+to_bin(Bin) when is_binary(Bin) ->
+    Bin.
 
 send_message(Config, Payload) ->
-    Name = ?config(tdengine_name, Config),
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    BridgeID = emqx_bridge_resource:bridge_id(BridgeType, Name),
-    emqx_bridge:send_message(BridgeID, Payload).
-
-query_resource(Config, Request) ->
-    Name = ?config(tdengine_name, Config),
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => 1_000}).
-
-query_resource_async(Config, Request) ->
-    Name = ?config(tdengine_name, Config),
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    Ref = alias([reply]),
-    AsyncReplyFun = fun(Result) -> Ref ! {result, Ref, Result} end,
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    Return = emqx_resource:query(ResourceID, Request, #{
-        timeout => 500, async_reply_fun => {AsyncReplyFun, []}
-    }),
-    {Return, Ref}.
+    BridgeType = ?config(bridge_type, Config),
+    Name = ?config(bridge_name, Config),
+    ct:print(">>> Name:~p~n BridgeType:~p~n", [Name, BridgeType]),
+    emqx_bridge_v2:send_message(BridgeType, Name, Payload, #{}).
 
 receive_result(Ref, Timeout) ->
     receive
@@ -287,17 +281,13 @@ connect_direct_tdengine(Config) ->
 % These funs connect and then stop the tdengine connection
 connect_and_create_table(Config) ->
     ?WITH_CON(begin
+        {ok, _} = directly_query(Con, ?SQL_DROP_TABLE),
+        {ok, _} = directly_query(Con, ?SQL_DROP_STABLE),
         {ok, _} = directly_query(Con, ?SQL_CREATE_DATABASE, []),
         {ok, _} = directly_query(Con, ?SQL_CREATE_TABLE),
         {ok, _} = directly_query(Con, ?SQL_CREATE_STABLE)
     end).
 
-connect_and_drop_table(Config) ->
-    ?WITH_CON(begin
-        {ok, _} = directly_query(Con, ?SQL_DROP_TABLE),
-        {ok, _} = directly_query(Con, ?SQL_DROP_STABLE)
-    end).
-
 connect_and_clear_table(Config) ->
     ?WITH_CON({ok, _} = directly_query(Con, ?SQL_DELETE)).
 
@@ -322,275 +312,53 @@ directly_query(Con, Query) ->
 directly_query(Con, Query, QueryOpts) ->
     tdengine:insert(Con, Query, QueryOpts).
 
+is_success_check(Result) ->
+    ?assertMatch({ok, #{<<"code">> := 0}}, Result).
+
+to_str(Atom) when is_atom(Atom) ->
+    erlang:atom_to_list(Atom).
+
 %%------------------------------------------------------------------------------
 %% Testcases
 %%------------------------------------------------------------------------------
 
-t_setup_via_config_and_publish(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    SentData = #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010},
-    ?check_trace(
-        begin
-            {_, {ok, #{result := Result}}} =
-                ?wait_async_action(
-                    send_message(Config, SentData),
-                    #{?snk_kind := buffer_worker_flush_ack},
-                    2_000
-                ),
-            ?assertMatch(
-                {ok, #{<<"code">> := 0, <<"rows">> := 1}}, Result
-            ),
-            ?assertMatch(
-                [[?PAYLOAD], [?PAYLOAD]],
-                connect_and_get_payload(Config)
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(tdengine_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, #{<<"code">> := 0, <<"rows">> := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
+t_create_via_http(Config) ->
+    emqx_bridge_v2_testlib:t_create_via_http(Config).
 
-t_setup_via_http_api_and_publish(Config) ->
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    Name = ?config(tdengine_name, Config),
-    QueryMode = ?config(query_mode, Config),
-    TDengineConfig0 = ?config(tdengine_config, Config),
-    TDengineConfig = TDengineConfig0#{
-        <<"name">> => Name,
-        <<"type">> => BridgeType
-    },
-    ?assertMatch(
-        {ok, _},
-        create_bridge_http(TDengineConfig)
-    ),
+t_on_get_status(Config) ->
+    emqx_bridge_v2_testlib:t_on_get_status(Config, #{failure_status => connecting}).
 
-    SentData = #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010},
-    ?check_trace(
-        begin
-            Request = {send_message, SentData},
-            Res0 =
-                case QueryMode of
-                    sync ->
-                        query_resource(Config, Request);
-                    async ->
-                        {_, Ref} = query_resource_async(Config, Request),
-                        {ok, Res} = receive_result(Ref, 2_000),
-                        Res
-                end,
+t_start_stop(Config) ->
+    emqx_bridge_v2_testlib:t_start_stop(Config, tdengine_connector_stop).
 
-            ?assertMatch(
-                {ok, #{<<"code">> := 0, <<"rows">> := 1}}, Res0
-            ),
-            ?assertMatch(
-                [[?PAYLOAD], [?PAYLOAD]],
-                connect_and_get_payload(Config)
-            ),
-            ok
-        end,
-        fun(Trace0) ->
-            Trace = ?of_kind(tdengine_connector_query_return, Trace0),
-            ?assertMatch([#{result := {ok, #{<<"code">> := 0, <<"rows">> := 1}}}], Trace),
-            ok
-        end
-    ),
-    ok.
-
-t_get_status(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    ProxyName = ?config(proxy_name, Config),
-
-    Name = ?config(tdengine_name, Config),
-    BridgeType = ?config(tdengine_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-
-    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceID)),
-    emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
+t_invalid_data(Config) ->
+    MakeMessageFun = fun() -> #{} end,
+    IsSuccessCheck = fun(Result) ->
         ?assertMatch(
-            {ok, Status} when Status =:= disconnected orelse Status =:= connecting,
-            emqx_resource_manager:health_check(ResourceID)
+            {error, #{
+                <<"code">> := 534,
+                <<"desc">> := _
+            }},
+            Result
         )
-    end),
-    ok.
-
-t_write_failure(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    {ok, _} = create_bridge(Config),
-    SentData = #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010},
-    emqx_common_test_helpers:with_failure(down, ProxyName, ProxyHost, ProxyPort, fun() ->
-        {_, {ok, #{result := Result}}} =
-            ?wait_async_action(
-                send_message(Config, SentData),
-                #{?snk_kind := buffer_worker_flush_ack},
-                2_000
-            ),
-        case Result of
-            {error, Reason} when Reason =:= econnrefused; Reason =:= closed ->
-                ok;
-            _ ->
-                throw({unexpected, Result})
-        end,
-        ok
-    end),
-    ok.
-
-% This test doesn't work with batch enabled since it is not possible
-% to set the timeout directly for batch queries
-t_write_timeout(Config) ->
-    ProxyName = ?config(proxy_name, Config),
-    ProxyPort = ?config(proxy_port, Config),
-    ProxyHost = ?config(proxy_host, Config),
-    QueryMode = ?config(query_mode, Config),
-    {ok, _} = create_bridge(
-        Config,
-        #{
-            <<"resource_opts">> => #{
-                <<"request_ttl">> => <<"500ms">>,
-                <<"resume_interval">> => <<"100ms">>,
-                <<"health_check_interval">> => <<"100ms">>
-            }
-        }
-    ),
-    SentData = #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010},
-    %% FIXME: TDengine connector hangs indefinetily during
-    %% `call_query' while the connection is unresponsive.  Should add
-    %% a timeout to `APPLY_RESOURCE' in buffer worker??
-    case QueryMode of
-        sync ->
-            emqx_common_test_helpers:with_failure(
-                timeout, ProxyName, ProxyHost, ProxyPort, fun() ->
-                    ?assertMatch(
-                        {error, {resource_error, #{reason := timeout}}},
-                        query_resource(Config, {send_message, SentData})
-                    )
-                end
-            );
-        async ->
-            ct:comment("tdengine connector hangs the buffer worker forever")
     end,
-    ok.
-
-t_simple_sql_query(Config) ->
-    EnableBatch = ?config(enable_batch, Config),
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, IsSuccessCheck, tdengine_connector_query_return
     ),
-    Request = {query, <<"SELECT 1 AS T">>},
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            query_resource(Config, Request),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-    case EnableBatch of
-        true ->
-            ?assertEqual({error, {unrecoverable_error, invalid_request}}, Result);
-        false ->
-            ?assertMatch({ok, #{<<"code">> := 0, <<"data">> := [[1]]}}, Result)
-    end,
+
     ok.
 
-t_missing_data(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            send_message(Config, #{}),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-    ?assertMatch(
-        {error, #{
-            <<"code">> := 534,
-            <<"desc">> := _
-        }},
-        Result
-    ),
-    ok.
-
-t_bad_sql_parameter(Config) ->
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
-    Request = {send_message, <<"">>},
-    {_, {ok, #{result := Result}}} =
-        ?wait_async_action(
-            query_resource(Config, Request),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
-
-    ?assertMatch({error, {unrecoverable_error, invalid_request}}, Result),
-    ok.
-
-%% TODO
-%% For supporting to generate a subtable name by mixing prefixes/suffixes with placeholders,
-%% the SQL quote(escape) is removed now,
-%% we should introduce a new syntax for placeholders to allow some vars to keep unquote.
-%% t_nasty_sql_string(Config) ->
-%%     ?assertMatch(
-%%         {ok, _},
-%%         create_bridge(Config)
-%%     ),
-%%     % NOTE
-%%     % Column `payload` has BINARY type, so we would certainly like to test it
-%%     % with `lists:seq(1, 127)`, but:
-%%     % 1. There's no way to insert zero byte in an SQL string, seems that TDengine's
-%%     %    parser[1] has no escaping sequence for it so a zero byte probably confuses
-%%     %    interpreter somewhere down the line.
-%%     % 2. Bytes > 127 come back as U+FFFDs (i.e. replacement characters) in UTF-8 for
-%%     %    some reason.
-%%     %
-%%     % [1]: https://github.com/taosdata/TDengine/blob/066cb34a/source/libs/parser/src/parUtil.c#L279-L301
-%%     Payload = list_to_binary(lists:seq(1, 127)),
-%%     Message = #{payload => Payload, timestamp => erlang:system_time(millisecond)},
-%%     {_, {ok, #{result := Result}}} =
-%%         ?wait_async_action(
-%%             send_message(Config, Message),
-%%             #{?snk_kind := buffer_worker_flush_ack},
-%%             2_000
-%%         ),
-%%     ?assertMatch(
-%%         {ok, #{<<"code">> := 0, <<"rows">> := 1}},
-%%         Result
-%%     ),
-%%     ?assertEqual(
-%%         Payload,
-%%         connect_and_get_payload(Config)
-%%     ).
-
 t_simple_insert(Config) ->
     connect_and_clear_table(Config),
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
+
+    MakeMessageFun = fun() ->
+        #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010}
+    end,
+
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_success_check/1, tdengine_connector_query_return
     ),
 
-    SentData = #{payload => ?PAYLOAD, timestamp => 1668602148000, second_ts => 1668602148010},
-    Request = {send_message, SentData},
-    {_, {ok, #{result := _Result}}} =
-        ?wait_async_action(
-            query_resource(Config, Request),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
     ?assertMatch(
         [[?PAYLOAD], [?PAYLOAD]],
         connect_and_get_payload(Config)
@@ -598,10 +366,7 @@ t_simple_insert(Config) ->
 
 t_batch_insert(Config) ->
     connect_and_clear_table(Config),
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
 
     Size = 5,
     Ts = erlang:system_time(millisecond),
@@ -612,8 +377,7 @@ t_batch_insert(Config) ->
                     SentData = #{
                         payload => ?PAYLOAD, timestamp => Ts + Idx, second_ts => Ts + Idx + 5000
                     },
-                    Request = {send_message, SentData},
-                    query_resource(Config, Request)
+                    send_message(Config, SentData)
                 end,
                 lists:seq(1, Size)
             ),
@@ -632,27 +396,22 @@ t_batch_insert(Config) ->
         )
     ).
 
-t_auto_create_simple_insert(Config0) ->
+t_auto_create_simple_insert(Config) ->
     ClientId = to_str(?FUNCTION_NAME),
-    Config = get_auto_create_config(Config0),
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
+
+    MakeMessageFun = fun() ->
+        #{
+            payload => ?PAYLOAD,
+            timestamp => 1668602148000,
+            second_ts => 1668602148000 + 100,
+            clientid => ClientId
+        }
+    end,
+
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config, MakeMessageFun, fun is_success_check/1, tdengine_connector_query_return
     ),
 
-    SentData = #{
-        payload => ?PAYLOAD,
-        timestamp => 1668602148000,
-        second_ts => 1668602148000 + 100,
-        clientid => ClientId
-    },
-    Request = {send_message, SentData},
-    {_, {ok, #{result := _Result}}} =
-        ?wait_async_action(
-            query_resource(Config, Request),
-            #{?snk_kind := buffer_worker_flush_ack},
-            2_000
-        ),
     ?assertMatch(
         [[?PAYLOAD]],
         connect_and_query(Config, "SELECT payload FROM " ++ ClientId)
@@ -673,15 +432,10 @@ t_auto_create_simple_insert(Config0) ->
         connect_and_query(Config, "DROP TABLE test_" ++ ClientId)
     ).
 
-t_auto_create_batch_insert(Config0) ->
+t_auto_create_batch_insert(Config) ->
     ClientId1 = "client1",
     ClientId2 = "client2",
-    Config = get_auto_create_config(Config0),
-
-    ?assertMatch(
-        {ok, _},
-        create_bridge(Config)
-    ),
+    ?assertMatch({ok, _}, emqx_bridge_v2_testlib:create_bridge(Config)),
 
     Size1 = 2,
     Size2 = 3,
@@ -699,8 +453,7 @@ t_auto_create_batch_insert(Config0) ->
                                 second_ts => Ts + Idx + Offset + 5000,
                                 clientid => ClientId
                             },
-                            Request = {send_message, SentData},
-                            query_resource(Config, Request)
+                            send_message(Config, SentData)
                         end,
                         lists:seq(1, Size)
                     )
@@ -738,17 +491,3 @@ t_auto_create_batch_insert(Config0) ->
         end,
         [ClientId1, ClientId2, "test_" ++ ClientId1, "test_" ++ ClientId2]
     ).
-
-to_bin(List) when is_list(List) ->
-    unicode:characters_to_binary(List, utf8);
-to_bin(Bin) when is_binary(Bin) ->
-    Bin.
-
-to_str(Atom) when is_atom(Atom) ->
-    erlang:atom_to_list(Atom).
-
-get_auto_create_config(Config0) ->
-    Config = lists:keyreplace(template, 1, Config0, {template, ?AUTO_CREATE_BRIDGE}),
-    BridgeType = proplists:get_value(bridge_type, Config, <<"tdengine">>),
-    {_Name, TDConf} = tdengine_config(BridgeType, Config),
-    lists:keyreplace(tdengine_config, 1, Config, {tdengine_config, TDConf}).
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 95c9d2991..1a66cda15 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -60,6 +60,8 @@ resource_type(opents) ->
     emqx_bridge_opents_connector;
 resource_type(greptimedb) ->
     emqx_bridge_greptimedb_connector;
+resource_type(tdengine) ->
+    emqx_bridge_tdengine_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -76,6 +78,8 @@ connector_impl_module(elasticsearch) ->
     emqx_bridge_es_connector;
 connector_impl_module(opents) ->
     emqx_bridge_opents_connector;
+connector_impl_module(tdengine) ->
+    emqx_bridge_tdengine_connector;
 connector_impl_module(_ConnectorType) ->
     undefined.
 
@@ -235,6 +239,14 @@ connector_structs() ->
                     desc => <<"GreptimeDB Connector Config">>,
                     required => false
                 }
+            )},
+        {tdengine,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_tdengine_connector, "config_connector")),
+                #{
+                    desc => <<"TDengine Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -258,7 +270,8 @@ schema_modules() ->
         emqx_bridge_iotdb_connector,
         emqx_bridge_es_connector,
         emqx_bridge_opents_connector,
-        emqx_bridge_greptimedb
+        emqx_bridge_greptimedb,
+        emqx_bridge_tdengine_connector
     ].
 
 api_schemas(Method) ->
@@ -291,7 +304,8 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
         api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
         api_ref(emqx_bridge_opents_connector, <<"opents">>, Method),
-        api_ref(emqx_bridge_greptimedb, <<"greptimedb">>, Method ++ "_connector")
+        api_ref(emqx_bridge_greptimedb, <<"greptimedb">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_tdengine_connector, <<"tdengine">>, Method)
     ].
 
 api_ref(Module, Type, Method) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index b7c4d9f74..0b139772d 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -162,7 +162,9 @@ connector_type_to_bridge_types(elasticsearch) ->
 connector_type_to_bridge_types(opents) ->
     [opents];
 connector_type_to_bridge_types(greptimedb) ->
-    [greptimedb].
+    [greptimedb];
+connector_type_to_bridge_types(tdengine) ->
+    [tdengine].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/rel/i18n/emqx_bridge_tdengine.hocon b/rel/i18n/emqx_bridge_tdengine.hocon
index ec6c10779..ac2ac3a7b 100644
--- a/rel/i18n/emqx_bridge_tdengine.hocon
+++ b/rel/i18n/emqx_bridge_tdengine.hocon
@@ -40,4 +40,10 @@ sql_template.desc:
 sql_template.label:
 """SQL Template"""
 
+action_parameters.desc:
+"""Tdengine action parameters"""
+
+action_parameters.label:
+"""Parameters"""
+
 }
diff --git a/rel/i18n/emqx_bridge_tdengine_connector.hocon b/rel/i18n/emqx_bridge_tdengine_connector.hocon
index 9c42dbaa0..ff7340cca 100644
--- a/rel/i18n/emqx_bridge_tdengine_connector.hocon
+++ b/rel/i18n/emqx_bridge_tdengine_connector.hocon
@@ -8,4 +8,10 @@ The TDengine default port 6041 is used if `[:Port]` is not specified."""
 server.label:
 """Server Host"""
 
+desc_config.desc:
+"""Configuration for TDengine Connector."""
+
+desc_config.label:
+"""TDengine Connector Configuration"""
+
 }

From 016fbd2c5ce03bdf2737de4643c0ef5ed9b7e66b Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 1 Feb 2024 16:18:37 +0100
Subject: [PATCH 131/273] chore: remove commented out code

---
 apps/emqx_oracle/src/emqx_oracle.erl | 39 ----------------------------
 1 file changed, 39 deletions(-)

diff --git a/apps/emqx_oracle/src/emqx_oracle.erl b/apps/emqx_oracle/src/emqx_oracle.erl
index e1ac846fa..ddae7ec8f 100644
--- a/apps/emqx_oracle/src/emqx_oracle.erl
+++ b/apps/emqx_oracle/src/emqx_oracle.erl
@@ -186,35 +186,6 @@ on_get_channel_status(
             %% do not log error, it is logged in prepare_sql_to_conn
             connecting
     end.
-% #{stream_name := StreamName} = maps:get(ChannelId, Channels),
-% case
-%     emqx_resource_pool:health_check_workers(
-%         PoolName,
-%         {emqx_bridge_kinesis_connector_client, connection_status, [StreamName]},
-%         ?HEALTH_CHECK_TIMEOUT,
-%         #{return_values => true}
-%     )
-% of
-%     {ok, Values} ->
-%         AllOk = lists:all(fun(S) -> S =:= {ok, ?status_connected} end, Values),
-%         case AllOk of
-%             true ->
-%                 ?status_connected;
-%             false ->
-%                 Unhealthy = lists:any(fun(S) -> S =:= {error, unhealthy_target} end, Values),
-%                 case Unhealthy of
-%                     true -> {?status_disconnected, {unhealthy_target, ?TOPIC_MESSAGE}};
-%                     false -> ?status_disconnected
-%                 end
-%         end;
-%     {error, Reason} ->
-%         ?SLOG(error, #{
-%             msg => "kinesis_producer_get_status_failed",
-%             state => State,
-%             reason => Reason
-%         }),
-%         ?status_disconnected
-% end.
 
 on_get_channels(ResId) ->
     emqx_bridge_v2:get_channels_for_connector(ResId).
@@ -387,16 +358,6 @@ do_check_prepares(
         ok,
         Workers
     ).
-% case prepare_sql(Prepares, PoolName, TokensMap) of
-%     %% remove the error
-%     {ok, Sts} ->
-%         {ok, State#{prepare_sql => Sts}};
-%     {error, undefined_table} ->
-%         %% indicate the error
-%         {error, {undefined_table, State#{prepare_sql => {error, Prepares}}}};
-%     {error, _Reason} = Error ->
-%         Error
-% end.
 
 %% ===================================================================
 

From 98d1094d7372fd8a19a46c0b2ca0a686d60709d8 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 1 Feb 2024 01:43:06 +0100
Subject: [PATCH 132/273] feat(sessds): Expose subscriptions in the REST API

---
 apps/emqx/src/emqx_channel.erl                |  4 +-
 apps/emqx/src/emqx_persistent_session_ds.erl  | 91 +++++++++++++++++--
 .../src/emqx_persistent_session_ds_state.erl  |  4 +-
 apps/emqx/test/emqx_cth_suite.erl             |  4 +-
 .../test/emqx_persistent_session_SUITE.erl    |  8 --
 apps/emqx_management/src/emqx_mgmt.erl        | 11 ++-
 apps/emqx_management/test/emqx_mgmt_SUITE.erl | 85 ++++++++++++++++-
 7 files changed, 180 insertions(+), 27 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index c2e0f3396..4d6ed37e4 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -193,7 +193,9 @@ info(alias_maximum, #channel{alias_maximum = Limits}) ->
 info(timers, #channel{timers = Timers}) ->
     Timers;
 info(session_state, #channel{session = Session}) ->
-    Session.
+    Session;
+info(impl, #channel{session = Session}) ->
+    emqx_session:info(impl, Session).
 
 set_conn_state(ConnState, Channel) ->
     Channel#channel{conn_state = ConnState}.
diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 1c1e78058..cf027bd47 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -66,6 +66,11 @@
     terminate/2
 ]).
 
+%% Managment APIs:
+-export([
+    list_client_subscriptions/1
+]).
+
 %% session table operations
 -export([create_tables/0, sync/1]).
 
@@ -243,18 +248,25 @@ info(await_rel_timeout, #{props := Conf}) ->
 stats(Session) ->
     info(?STATS_KEYS, Session).
 
-%% Debug/troubleshooting
+%% Used by management API
 -spec print_session(emqx_types:clientid()) -> map() | undefined.
 print_session(ClientId) ->
-    case emqx_cm:lookup_channels(ClientId) of
-        [Pid] ->
-            #{channel := ChanState} = emqx_connection:get_state(Pid),
-            SessionState = emqx_channel:info(session_state, ChanState),
-            maps:update_with(s, fun emqx_persistent_session_ds_state:format/1, SessionState#{
-                '_alive' => {true, Pid}
-            });
-        [] ->
-            emqx_persistent_session_ds_state:print_session(ClientId)
+    case try_get_live_session(ClientId) of
+        {Pid, SessionState} ->
+            maps:update_with(
+                s, fun emqx_persistent_session_ds_state:format/1, SessionState#{
+                    '_alive' => {true, Pid}
+                }
+            );
+        not_found ->
+            case emqx_persistent_session_ds_state:print_session(ClientId) of
+                undefined ->
+                    undefined;
+                S ->
+                    #{s => S, '_alive' => false}
+            end;
+        not_persistent ->
+            undefined
     end.
 
 %%--------------------------------------------------------------------
@@ -529,6 +541,44 @@ terminate(_Reason, _Session = #{id := Id, s := S}) ->
     ?tp(debug, persistent_session_ds_terminate, #{id => Id}),
     ok.
 
+%%--------------------------------------------------------------------
+%% Management APIs (dashboard)
+%%--------------------------------------------------------------------
+
+-spec list_client_subscriptions(emqx_types:clientid()) ->
+    {node() | undefined, [{emqx_types:topic() | emqx_types:share(), emqx_types:subopts()}]}
+    | {error, not_found}.
+list_client_subscriptions(ClientId) ->
+    case emqx_persistent_message:is_persistence_enabled() of
+        true ->
+            %% TODO: this is not the most optimal implementation, since it
+            %% should be possible to avoid reading extra data (streams, etc.)
+            case print_session(ClientId) of
+                Sess = #{s := #{subscriptions := Subs}} ->
+                    Node =
+                        case Sess of
+                            #{'_alive' := {true, Pid}} ->
+                                node(Pid);
+                            _ ->
+                                undefined
+                        end,
+                    SubList =
+                        maps:fold(
+                            fun(Topic, #{props := SubProps}, Acc) ->
+                                Elem = {Topic, SubProps},
+                                [Elem | Acc]
+                            end,
+                            [],
+                            Subs
+                        ),
+                    {Node, SubList};
+                undefined ->
+                    {error, not_found}
+            end;
+        false ->
+            {error, not_found}
+    end.
+
 %%--------------------------------------------------------------------
 %% Session tables operations
 %%--------------------------------------------------------------------
@@ -899,6 +949,27 @@ expiry_interval(ConnInfo) ->
 bump_interval() ->
     emqx_config:get([session_persistence, last_alive_update_interval]).
 
+-spec try_get_live_session(emqx_types:clientid()) ->
+    {pid(), session()} | not_found | not_persistent.
+try_get_live_session(ClientId) ->
+    case emqx_cm:lookup_channels(local, ClientId) of
+        [Pid] ->
+            try
+                #{channel := ChanState} = emqx_connection:get_state(Pid),
+                case emqx_channel:info(impl, ChanState) of
+                    ?MODULE ->
+                        {Pid, emqx_channel:info(session_state, ChanState)};
+                    _ ->
+                        not_persistent
+                end
+            catch
+                _:_ ->
+                    not_found
+            end;
+        _ ->
+            not_found
+    end.
+
 %%--------------------------------------------------------------------
 %% SeqNo tracking
 %% --------------------------------------------------------------------
diff --git a/apps/emqx/src/emqx_persistent_session_ds_state.erl b/apps/emqx/src/emqx_persistent_session_ds_state.erl
index 0f617153b..4912ebe95 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_state.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_state.erl
@@ -181,7 +181,9 @@ format(#{
     ranks := Ranks
 }) ->
     Subs = emqx_topic_gbt:fold(
-        fun(Key, Sub, Acc) -> maps:put(Key, Sub, Acc) end,
+        fun(Key, Sub, Acc) ->
+            maps:put(emqx_topic_gbt:get_topic(Key), Sub, Acc)
+        end,
         #{},
         SubsGBT
     ),
diff --git a/apps/emqx/test/emqx_cth_suite.erl b/apps/emqx/test/emqx_cth_suite.erl
index fbb9da595..373da9858 100644
--- a/apps/emqx/test/emqx_cth_suite.erl
+++ b/apps/emqx/test/emqx_cth_suite.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -48,7 +48,7 @@
 %%
 %% Most of the time, you just need to:
 %% 1. Describe the appspecs for the applications you want to test.
-%% 2. Call `emqx_cth_sutie:start/2` to start the applications before the testrun
+%% 2. Call `emqx_cth_suite:start/2` to start the applications before the testrun
 %%    (e.g. in `init_per_suite/1` / `init_per_group/2`), providing the appspecs
 %%    and unique work dir for the testrun (e.g. `work_dir/1`). Save the result
 %%    in a context.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index 72c04ff74..bdd3e367f 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -1092,14 +1092,6 @@ get_msgs_essentials(Msgs) ->
 pick_respective_msgs(MsgRefs, Msgs) ->
     [M || M <- Msgs, Ref <- MsgRefs, maps:get(packet_id, M) =:= maps:get(packet_id, Ref)].
 
-skip_ds_tc(Config) ->
-    case ?config(persistence, Config) of
-        ds ->
-            {skip, "Testcase not yet supported under 'emqx_persistent_session_ds' implementation"};
-        _ ->
-            Config
-    end.
-
 debug_info(ClientId) ->
     Info = emqx_persistent_session_ds:print_session(ClientId),
     ct:pal("*** State:~n~p", [Info]).
diff --git a/apps/emqx_management/src/emqx_mgmt.erl b/apps/emqx_management/src/emqx_mgmt.erl
index 9d4ad8521..1995ec9da 100644
--- a/apps/emqx_management/src/emqx_mgmt.erl
+++ b/apps/emqx_management/src/emqx_mgmt.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -380,6 +380,15 @@ list_authz_cache(ClientId) ->
     call_client(ClientId, list_authz_cache).
 
 list_client_subscriptions(ClientId) ->
+    case emqx_persistent_session_ds:list_client_subscriptions(ClientId) of
+        {error, not_found} ->
+            list_client_subscriptions_mem(ClientId);
+        Result ->
+            Result
+    end.
+
+%% List subscriptions of an in-memory session:
+list_client_subscriptions_mem(ClientId) ->
     case lookup_client({clientid, ClientId}, undefined) of
         [] ->
             {error, not_found};
diff --git a/apps/emqx_management/test/emqx_mgmt_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_SUITE.erl
index 3eb37060e..9ce737353 100644
--- a/apps/emqx_management/test/emqx_mgmt_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -26,14 +26,56 @@
 -define(FORMATFUN, {?MODULE, ident}).
 
 all() ->
-    emqx_common_test_helpers:all(?MODULE).
+    [
+        {group, persistence_disabled},
+        {group, persistence_enabled}
+    ].
+
+groups() ->
+    TCs = emqx_common_test_helpers:all(?MODULE),
+    [
+        {persistence_disabled, [], TCs},
+        {persistence_enabled, [], [t_persist_list_subs]}
+    ].
+
+init_per_group(persistence_disabled, Config) ->
+    Apps = emqx_cth_suite:start(
+        [
+            {emqx, "session_persistence { enable = false }"},
+            emqx_management
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [
+        {apps, Apps}
+        | Config
+    ];
+init_per_group(persistence_enabled, Config) ->
+    Apps = emqx_cth_suite:start(
+        [
+            {emqx,
+                "session_persistence {\n"
+                "  enable = true\n"
+                "  last_alive_update_interval = 100ms\n"
+                "  renew_streams_interval = 100ms\n"
+                "}"},
+            emqx_management
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [
+        {apps, Apps}
+        | Config
+    ].
+
+end_per_group(_Grp, Config) ->
+    emqx_cth_suite:stop(?config(apps, Config)).
 
 init_per_suite(Config) ->
-    emqx_mgmt_api_test_util:init_suite([emqx_conf, emqx_management]),
     Config.
 
 end_per_suite(_) ->
-    emqx_mgmt_api_test_util:end_suite([emqx_management, emqx_conf]).
+    ok.
 
 init_per_testcase(TestCase, Config) ->
     meck:expect(emqx, running_nodes, 0, [node()]),
@@ -370,6 +412,41 @@ t_banned(_) ->
         emqx_mgmt:delete_banned({clientid, <<"TestClient">>})
     ).
 
+%% This testcase verifies the behavior of various read-only functions
+%% used by REST API via `emqx_mgmt' module:
+t_persist_list_subs(_) ->
+    ClientId = <<"persistent_client">>,
+    Topics = lists:sort([<<"foo/bar">>, <<"/a/+//+/#">>, <<"foo">>]),
+    VerifySubs =
+        fun() ->
+            {Node, Ret} = emqx_mgmt:list_client_subscriptions(ClientId),
+            ?assert(Node =:= node() orelse Node =:= undefined, Node),
+            {TopicsL, SubProps} = lists:unzip(Ret),
+            ?assertEqual(Topics, lists:sort(TopicsL)),
+            [?assertMatch(#{rh := _, rap := _, nl := _, qos := _}, I) || I <- SubProps]
+        end,
+    %% 0. Verify that management functions work for missing clients:
+    ?assertMatch(
+        {error, not_found},
+        emqx_mgmt:list_client_subscriptions(ClientId)
+    ),
+    %% 1. Connect the client and subscribe to topics:
+    {ok, Client} = emqtt:start_link([
+        {clientid, ClientId},
+        {proto_ver, v5},
+        {properties, #{'Session-Expiry-Interval' => 30}}
+    ]),
+    {ok, _} = emqtt:connect(Client),
+    [{ok, _, _} = emqtt:subscribe(Client, I, qos2) || I <- Topics],
+    %% 2. Verify that management functions work for the connected
+    %% clients:
+    VerifySubs(),
+    %% 3. Disconnect the client:
+    emqtt:disconnect(Client),
+    %% 4. Verify that management functions work for the offline
+    %% clients:
+    VerifySubs().
+
 %%% helpers
 ident(Arg) ->
     Arg.

From af3f43ffd52fb594b1d572aef5b58c5782d07c03 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 1 Feb 2024 17:24:25 +0100
Subject: [PATCH 133/273] fix: use emqx_resource macro for status

Thanks for the suggestion @thalesmg

Co-authored-by: Thales Macedo Garitezi <thalesmg@gmail.com>
---
 apps/emqx_oracle/src/emqx_oracle.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx_oracle/src/emqx_oracle.erl b/apps/emqx_oracle/src/emqx_oracle.erl
index ddae7ec8f..b3a6eb4ef 100644
--- a/apps/emqx_oracle/src/emqx_oracle.erl
+++ b/apps/emqx_oracle/src/emqx_oracle.erl
@@ -184,7 +184,7 @@ on_get_channel_status(
             {?status_disconnected, {unhealthy_target, ?UNHEALTHY_TARGET_MSG}};
         {error, _Reason} ->
             %% do not log error, it is logged in prepare_sql_to_conn
-            connecting
+            ?status_connecting
     end.
 
 on_get_channels(ResId) ->

From 2241461acba7aa6621fd0cf9e16780df9ec20892 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Thu, 1 Feb 2024 23:18:20 +0800
Subject: [PATCH 134/273] chore: update change & bump version

---
 apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.app.src    | 2 +-
 apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl | 4 ++--
 changes/ee/feat-12449.en.md                                   | 1 +
 rel/i18n/emqx_bridge_tdengine.hocon                           | 2 +-
 4 files changed, 5 insertions(+), 4 deletions(-)
 create mode 100644 changes/ee/feat-12449.en.md

diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.app.src b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.app.src
index 5375a6ba9..898a3211d 100644
--- a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.app.src
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_tdengine, [
     {description, "EMQX Enterprise TDEngine Bridge"},
-    {vsn, "0.1.6"},
+    {vsn, "0.1.7"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl b/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
index 610eca714..511518bda 100644
--- a/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
+++ b/apps/emqx_bridge_tdengine/test/emqx_bridge_tdengine_SUITE.erl
@@ -281,8 +281,8 @@ connect_direct_tdengine(Config) ->
 % These funs connect and then stop the tdengine connection
 connect_and_create_table(Config) ->
     ?WITH_CON(begin
-        {ok, _} = directly_query(Con, ?SQL_DROP_TABLE),
-        {ok, _} = directly_query(Con, ?SQL_DROP_STABLE),
+        _ = directly_query(Con, ?SQL_DROP_TABLE),
+        _ = directly_query(Con, ?SQL_DROP_STABLE),
         {ok, _} = directly_query(Con, ?SQL_CREATE_DATABASE, []),
         {ok, _} = directly_query(Con, ?SQL_CREATE_TABLE),
         {ok, _} = directly_query(Con, ?SQL_CREATE_STABLE)
diff --git a/changes/ee/feat-12449.en.md b/changes/ee/feat-12449.en.md
new file mode 100644
index 000000000..b9a9115d5
--- /dev/null
+++ b/changes/ee/feat-12449.en.md
@@ -0,0 +1 @@
+The bridges for TDengine have been split so it is available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.
diff --git a/rel/i18n/emqx_bridge_tdengine.hocon b/rel/i18n/emqx_bridge_tdengine.hocon
index ac2ac3a7b..914bbae36 100644
--- a/rel/i18n/emqx_bridge_tdengine.hocon
+++ b/rel/i18n/emqx_bridge_tdengine.hocon
@@ -41,7 +41,7 @@ sql_template.label:
 """SQL Template"""
 
 action_parameters.desc:
-"""Tdengine action parameters"""
+"""TDengine action parameters"""
 
 action_parameters.label:
 """Parameters"""

From 1a372ce39a69532a57cdda1eeefeb3efde1db356 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Fri, 2 Feb 2024 10:54:49 +0800
Subject: [PATCH 135/273] fix(swagger): no-need call common_fields when
 `emqx_connector_schema:api_fields/3` used

---
 apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index 1a2d63e83..8e007a65f 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -176,8 +176,7 @@ fields("post_producer") ->
 fields("put_producer") ->
     fields("config_producer");
 fields("config_connector") ->
-    emqx_connector_schema:common_fields() ++
-        fields(connector_config) ++
+    fields(connector_config) ++
         emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
 fields(connector_resource_opts) ->
     emqx_connector_schema:resource_opts_fields();

From 5291adf2c09f2f539b88bd2d814a31c85e0a3672 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Fri, 2 Feb 2024 12:31:42 +0800
Subject: [PATCH 136/273] fix(opents): change the schema of tags to object
 style

---
 .../src/emqx_bridge_opents.erl                | 51 +++++++------------
 .../src/emqx_bridge_opents_connector.erl      |  6 +--
 .../test/emqx_bridge_opents_SUITE.erl         |  4 +-
 rel/i18n/emqx_bridge_opents.hocon             | 26 ++--------
 4 files changed, 28 insertions(+), 59 deletions(-)

diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
index 16513ac11..d38ed8eb4 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents.erl
@@ -135,6 +135,14 @@ fields(action_parameters) ->
             )}
     ];
 fields(action_parameters_data) ->
+    TagsError = fun(Data) ->
+        ?SLOG(warning, #{
+            msg => "invalid_tags_template",
+            path => "opents.parameters.data.tags",
+            data => Data
+        }),
+        false
+    end,
     [
         {timestamp,
             mk(
@@ -154,7 +162,7 @@ fields(action_parameters_data) ->
             )},
         {tags,
             mk(
-                hoconsc:union([array(ref(?MODULE, action_parameters_data_tags)), binary()]),
+                hoconsc:union([map(), binary()]),
                 #{
                     required => true,
                     desc => ?DESC("config_parameters_tags"),
@@ -164,17 +172,17 @@ fields(action_parameters_data) ->
                                 [{var, _}] ->
                                     true;
                                 _ ->
-                                    ?SLOG(warning, #{
-                                        msg => "invalid_tags_template",
-                                        path => "opents.parameters.data.tags",
-                                        data => Tmpl
-                                    }),
-                                    false
+                                    TagsError(Tmpl)
                             end;
-                        ([_ | _] = Tags) when is_list(Tags) ->
-                            true;
-                        (_) ->
-                            false
+                        (Map) when is_map(Map) ->
+                            case maps:size(Map) >= 1 of
+                                true ->
+                                    true;
+                                _ ->
+                                    TagsError(Map)
+                            end;
+                        (Any) ->
+                            TagsError(Any)
                     end
                 }
             )},
@@ -187,25 +195,6 @@ fields(action_parameters_data) ->
                 }
             )}
     ];
-fields(action_parameters_data_tags) ->
-    [
-        {tag,
-            mk(
-                binary(),
-                #{
-                    required => true,
-                    desc => ?DESC("tags_tag")
-                }
-            )},
-        {value,
-            mk(
-                binary(),
-                #{
-                    required => true,
-                    desc => ?DESC("tags_value")
-                }
-            )}
-    ];
 fields("post_bridge_v2") ->
     emqx_bridge_schema:type_and_name_fields(enum([opents])) ++ fields(action_config);
 fields("put_bridge_v2") ->
@@ -221,8 +210,6 @@ desc(action_parameters) ->
     ?DESC("action_parameters");
 desc(action_parameters_data) ->
     ?DESC("action_parameters_data");
-desc(action_parameters_data_tags) ->
-    ?DESC("action_parameters_data_tags");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for OpenTSDB using `", string:to_upper(Method), "` method."];
 desc(_) ->
diff --git a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
index faa8c769c..9912023c2 100644
--- a/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
+++ b/apps/emqx_bridge_opents/src/emqx_bridge_opents_connector.erl
@@ -358,15 +358,15 @@ preproc_data_template(DataList) ->
                 case Tags of
                     Tmpl when is_binary(Tmpl) ->
                         emqx_placeholder:preproc_tmpl(Tmpl);
-                    List ->
+                    Map when is_map(Map) ->
                         [
                             tags
                             | [
                                 {
-                                    emqx_placeholder:preproc_tmpl(TagName),
+                                    emqx_placeholder:preproc_tmpl(emqx_utils_conv:bin(TagName)),
                                     emqx_placeholder:preproc_tmpl(TagValue)
                                 }
-                             || #{tag := TagName, value := TagValue} <- List
+                             || {TagName, TagValue} <- maps:to_list(Map)
                             ]
                         ]
                 end,
diff --git a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
index 34b7901cc..23d5ee077 100644
--- a/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
+++ b/apps/emqx_bridge_opents/test/emqx_bridge_opents_SUITE.erl
@@ -311,7 +311,7 @@ t_list_tags(Config) ->
                 <<"data">> => [
                     #{
                         <<"metric">> => <<"${metric}">>,
-                        <<"tags">> => [#{<<"tag">> => <<"host">>, <<"value">> => <<"valueA">>}],
+                        <<"tags">> => #{<<"host">> => <<"valueA">>},
                         value => <<"${value}">>
                     }
                 ]
@@ -356,7 +356,7 @@ t_list_tags_with_var(Config) ->
                 <<"data">> => [
                     #{
                         <<"metric">> => <<"${metric}">>,
-                        <<"tags">> => [#{<<"tag">> => <<"host">>, <<"value">> => <<"${value}">>}],
+                        <<"tags">> => #{<<"host">> => <<"${value}">>},
                         value => <<"${value}">>
                     }
                 ]
diff --git a/rel/i18n/emqx_bridge_opents.hocon b/rel/i18n/emqx_bridge_opents.hocon
index 3a37e104c..c7ff37cda 100644
--- a/rel/i18n/emqx_bridge_opents.hocon
+++ b/rel/i18n/emqx_bridge_opents.hocon
@@ -37,45 +37,27 @@ action_parameters_data.label:
 """Parameter Data"""
 
 config_parameters_timestamp.desc:
-"""Timestamp. Placeholders in format of ${var} is supported"""
+"""Timestamp. Placeholders in the format of ${var} are supported"""
 
 config_parameters_timestamp.label:
 """Timestamp"""
 
 config_parameters_metric.desc:
-"""Metric. Placeholders in format of ${var} is supported"""
+"""Metric. Placeholders in the format of ${var} are supported"""
 
 config_parameters_metric.label:
 """Metric"""
 
 config_parameters_tags.desc:
-"""Tags. Only supports with placeholder to extract tags from a variable or a list of tags"""
+"""Tags. Only supports with placeholder to extract tags from a variable or a tags map"""
 
 config_parameters_tags.label:
 """Tags"""
 
 config_parameters_value.desc:
-"""Value. Placeholders in format of ${var} is supported"""
+"""Value. Placeholders in the format of ${var} are supported"""
 
 config_parameters_value.label:
 """Value"""
 
-action_parameters_data_tags.desc:
-"""OpenTSDB data tags"""
-
-action_parameters_data_tags.label:
-"""Tags"""
-
-tags_tag.desc:
-"""The name of this tag. Placeholders in format of ${var} is supported"""
-
-tags_tag.label:
-"""Tag"""
-
-tags_value.desc:
-"""The value of this tag. Placeholders in format of ${var} is supported"""
-
-tags_value.label:
-"""Value"""
-
 }

From 17d79026cd9aba2d988b4543b3e7dbf2ebc49afc Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Fri, 2 Feb 2024 14:25:12 +0800
Subject: [PATCH 137/273] test: fix emqx_connector_schema eunit missing fields

---
 apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
index 8e007a65f..6c273e217 100644
--- a/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
+++ b/apps/emqx_bridge_kinesis/src/emqx_bridge_kinesis.erl
@@ -39,11 +39,10 @@ fields(Field) when
     Field == "put_connector";
     Field == "post_connector"
 ->
-    emqx_connector_schema:api_fields(
-        Field,
-        ?CONNECTOR_TYPE,
-        fields("config_connector")
-    );
+    Fields =
+        fields(connector_config) ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
 fields(action) ->
     {?ACTION_TYPE,
         hoconsc:mk(
@@ -176,7 +175,8 @@ fields("post_producer") ->
 fields("put_producer") ->
     fields("config_producer");
 fields("config_connector") ->
-    fields(connector_config) ++
+    emqx_connector_schema:common_fields() ++
+        fields(connector_config) ++
         emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
 fields(connector_resource_opts) ->
     emqx_connector_schema:resource_opts_fields();

From dae3a94670f31f61bcc02383d292c96490294aee Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Tue, 30 Jan 2024 18:57:50 +0100
Subject: [PATCH 138/273] chore: 5.5.0-rc.1

---
 apps/emqx/include/emqx_release.hrl       | 4 ++--
 deploy/charts/emqx-enterprise/Chart.yaml | 4 ++--
 deploy/charts/emqx/Chart.yaml            | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/apps/emqx/include/emqx_release.hrl b/apps/emqx/include/emqx_release.hrl
index 6d9a1c22b..18b7fa24a 100644
--- a/apps/emqx/include/emqx_release.hrl
+++ b/apps/emqx/include/emqx_release.hrl
@@ -32,10 +32,10 @@
 %% `apps/emqx/src/bpapi/README.md'
 
 %% Opensource edition
--define(EMQX_RELEASE_CE, "5.5.0").
+-define(EMQX_RELEASE_CE, "5.5.0-rc.1").
 
 %% Enterprise edition
--define(EMQX_RELEASE_EE, "5.5.0-alpha.1").
+-define(EMQX_RELEASE_EE, "5.5.0-rc.1").
 
 %% The HTTP API version
 -define(EMQX_API_VERSION, "5.0").
diff --git a/deploy/charts/emqx-enterprise/Chart.yaml b/deploy/charts/emqx-enterprise/Chart.yaml
index 59d92aa02..751cf40f1 100644
--- a/deploy/charts/emqx-enterprise/Chart.yaml
+++ b/deploy/charts/emqx-enterprise/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0-alpha.1
+version: 5.5.0-rc.1
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0-alpha.1
+appVersion: 5.5.0-rc.1
diff --git a/deploy/charts/emqx/Chart.yaml b/deploy/charts/emqx/Chart.yaml
index 41f0b37b6..11fd3a645 100644
--- a/deploy/charts/emqx/Chart.yaml
+++ b/deploy/charts/emqx/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0
+version: 5.5.0-rc.1
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0
+appVersion: 5.5.0-rc.1

From 4d61975f2c2267c9546de824cbbd2f11e2e53a64 Mon Sep 17 00:00:00 2001
From: YuShifan <894402575bt@gmail.com>
Date: Tue, 30 Jan 2024 22:45:37 +0800
Subject: [PATCH 139/273] chore(dashboard): bump dashboard version to v1.7.0 &
 e1.5.0

---
 Makefile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index cc6c74b70..694cb75c0 100644
--- a/Makefile
+++ b/Makefile
@@ -20,8 +20,8 @@ endif
 
 # Dashboard version
 # from https://github.com/emqx/emqx-dashboard5
-export EMQX_DASHBOARD_VERSION ?= v1.6.1
-export EMQX_EE_DASHBOARD_VERSION ?= e1.5.0-beta.10
+export EMQX_DASHBOARD_VERSION ?= v1.7.0
+export EMQX_EE_DASHBOARD_VERSION ?= e1.5.0
 
 PROFILE ?= emqx
 REL_PROFILES := emqx emqx-enterprise

From 92ef848b306d418cf0619965d5afdbec354dcb9a Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Tue, 30 Jan 2024 20:38:46 +0100
Subject: [PATCH 140/273] ci: fix publish artifacts

---
 .github/workflows/build_packages.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index abde2672e..b48e47cd0 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -215,6 +215,7 @@ jobs:
       with:
         pattern: ${{ matrix.profile }}-*
         path: packages/${{ matrix.profile }}
+        merge-multiple: true
     - name: install dos2unix
       run: sudo apt-get update -y && sudo apt install -y dos2unix
     - name: get packages

From 9aad7997ca641b1e35742f27424a98f3f0fd67ff Mon Sep 17 00:00:00 2001
From: JianBo He <heeejianbo@gmail.com>
Date: Wed, 31 Jan 2024 17:49:46 +0800
Subject: [PATCH 141/273] chore: compatible the contet-type sytanx

---
 .../src/emqx_authn/emqx_authn_user_import_api.erl        | 4 ++--
 .../test/emqx_authn_api_mnesia_SUITE.erl                 | 9 +++++++++
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/apps/emqx_auth/src/emqx_authn/emqx_authn_user_import_api.erl b/apps/emqx_auth/src/emqx_authn/emqx_authn_user_import_api.erl
index 2b2ccecac..db6bbccda 100644
--- a/apps/emqx_auth/src/emqx_authn/emqx_authn_user_import_api.erl
+++ b/apps/emqx_auth/src/emqx_authn/emqx_authn_user_import_api.erl
@@ -126,7 +126,7 @@ authenticator_import_users(
     PasswordType = password_type(Req),
     Result =
         case maps:get(<<"content-type">>, Headers, undefined) of
-            <<"application/json">> ->
+            <<"application/json", _/binary>> ->
                 emqx_authn_chains:import_users(
                     ?GLOBAL, AuthenticatorID, {PasswordType, prepared_user_list, Body}
                 );
@@ -172,7 +172,7 @@ listener_authenticator_import_users(
         )
     end,
     case maps:get(<<"content-type">>, Headers, undefined) of
-        <<"application/json">> ->
+        <<"application/json", _/binary>> ->
             DoImport(prepared_user_list, Body);
         _ ->
             case Body of
diff --git a/apps/emqx_auth_mnesia/test/emqx_authn_api_mnesia_SUITE.erl b/apps/emqx_auth_mnesia/test/emqx_authn_api_mnesia_SUITE.erl
index 71da75c1b..660c8c1cc 100644
--- a/apps/emqx_auth_mnesia/test/emqx_authn_api_mnesia_SUITE.erl
+++ b/apps/emqx_auth_mnesia/test/emqx_authn_api_mnesia_SUITE.erl
@@ -342,6 +342,9 @@ test_authenticator_import_users(PathPrefix) ->
     {ok, 204, _} = request(post, ImportUri ++ "?type=hash", emqx_utils_json:decode(JSONData)),
     {ok, JSONData1} = file:read_file(filename:join([Dir, <<"data/user-credentials-plain.json">>])),
     {ok, 204, _} = request(post, ImportUri ++ "?type=plain", emqx_utils_json:decode(JSONData1)),
+
+    %% test application/json; charset=utf-8
+    {ok, 204, _} = request_with_charset(post, ImportUri ++ "?type=plain", JSONData1),
     ok.
 
 %%------------------------------------------------------------------------------
@@ -350,3 +353,9 @@ test_authenticator_import_users(PathPrefix) ->
 
 request(Method, Url) ->
     request(Method, Url, []).
+
+request_with_charset(Method, Url, Body) ->
+    Headers = [emqx_mgmt_api_test_util:auth_header_()],
+    Opts = #{compatible_mode => true, httpc_req_opts => [{body_format, binary}]},
+    Request = {Url, Headers, "application/json; charset=utf-8", Body},
+    emqx_mgmt_api_test_util:do_request_api(Method, Request, Opts).

From ee305f2dd05d8e4ea3833e2a6e34acd9626c4f5d Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 31 Jan 2024 16:54:50 +0100
Subject: [PATCH 142/273] ci: use OTP 25.3.2-2 for building docker

due to segfault on 26 https://github.com/erlang/otp/issues/8051
---
 .github/workflows/_push-entrypoint.yaml             | 3 ++-
 .github/workflows/build_and_push_docker_images.yaml | 8 ++++----
 build                                               | 2 +-
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index a6d0e178e..486335534 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -107,7 +107,8 @@ jobs:
       version: ${{ needs.prepare.outputs.version }}
       publish: ${{ needs.prepare.outputs.release }}
       latest: ${{ needs.prepare.outputs.latest }}
-      otp_vsn: ${{ needs.prepare.outputs.otp_vsn }}
+      # TODO: revert this back to needs.prepare.outputs.otp_vsn when OTP 26 bug is fixed
+      otp_vsn: 25.3.2
       elixir_vsn: ${{ needs.prepare.outputs.elixir_vsn }}
       builder_vsn: ${{ needs.prepare.outputs.builder_vsn }}
     secrets: inherit
diff --git a/.github/workflows/build_and_push_docker_images.yaml b/.github/workflows/build_and_push_docker_images.yaml
index 49416db92..1ab553840 100644
--- a/.github/workflows/build_and_push_docker_images.yaml
+++ b/.github/workflows/build_and_push_docker_images.yaml
@@ -58,7 +58,7 @@ on:
       otp_vsn:
         required: false
         type: string
-        default: '26.2.1-2'
+        default: '25.3.2-2'
       elixir_vsn:
         required: false
         type: string
@@ -127,8 +127,8 @@ jobs:
         EMQX_RUNNER: 'debian:11-slim'
         EMQX_DOCKERFILE: 'deploy/docker/Dockerfile'
         PKG_VSN: ${{ inputs.version }}
-        EMQX_BUILDER_VSN: ${{ inputs.builder_vsn }}
-        EMQX_OTP_VSN: ${{ inputs.otp_vsn }}
-        EMQX_ELIXIR_VSN: ${{ inputs.elixir_vsn }}
+        EMQX_BUILDER_VERSION: ${{ inputs.builder_vsn }}
+        EMQX_BUILDER_OTP: ${{ inputs.otp_vsn }}
+        EMQX_BUILDER_ELIXIR: ${{ inputs.elixir_vsn }}
       run: |
         ./build ${PROFILE} docker
diff --git a/build b/build
index eca2d734b..4a5e01f7e 100755
--- a/build
+++ b/build
@@ -389,7 +389,7 @@ docker_cleanup() {
 make_docker() {
     local EMQX_BUILDER_VERSION="${EMQX_BUILDER_VERSION:-5.3-2}"
     local EMQX_BUILDER_PLATFORM="${EMQX_BUILDER_PLATFORM:-debian11}"
-    local EMQX_BUILDER_OTP="${EMQX_BUILDER_OTP:-26.2.1-2}"
+    local EMQX_BUILDER_OTP="${EMQX_BUILDER_OTP:-25.3.2-2}"
     local EMQX_BUILDER_ELIXIR="${EMQX_BUILDER_ELIXIR:-1.15.7}"
     local EMQX_BUILDER=${EMQX_BUILDER:-ghcr.io/emqx/emqx-builder/${EMQX_BUILDER_VERSION}:${EMQX_BUILDER_ELIXIR}-${EMQX_BUILDER_OTP}-${EMQX_BUILDER_PLATFORM}}
     local EMQX_RUNNER="${EMQX_RUNNER:-${EMQX_DEFAULT_RUNNER}}"

From f1c7e716ce2b27b3f9e90b15f3832b1958d5928f Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 31 Jan 2024 17:01:16 +0100
Subject: [PATCH 143/273] chore: 5.5.0-rc.2

---
 apps/emqx/include/emqx_release.hrl       | 4 ++--
 deploy/charts/emqx-enterprise/Chart.yaml | 4 ++--
 deploy/charts/emqx/Chart.yaml            | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/apps/emqx/include/emqx_release.hrl b/apps/emqx/include/emqx_release.hrl
index 18b7fa24a..63b87f5d4 100644
--- a/apps/emqx/include/emqx_release.hrl
+++ b/apps/emqx/include/emqx_release.hrl
@@ -32,10 +32,10 @@
 %% `apps/emqx/src/bpapi/README.md'
 
 %% Opensource edition
--define(EMQX_RELEASE_CE, "5.5.0-rc.1").
+-define(EMQX_RELEASE_CE, "5.5.0-rc.2").
 
 %% Enterprise edition
--define(EMQX_RELEASE_EE, "5.5.0-rc.1").
+-define(EMQX_RELEASE_EE, "5.5.0-rc.2").
 
 %% The HTTP API version
 -define(EMQX_API_VERSION, "5.0").
diff --git a/deploy/charts/emqx-enterprise/Chart.yaml b/deploy/charts/emqx-enterprise/Chart.yaml
index 751cf40f1..3610a815a 100644
--- a/deploy/charts/emqx-enterprise/Chart.yaml
+++ b/deploy/charts/emqx-enterprise/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0-rc.1
+version: 5.5.0-rc.2
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0-rc.1
+appVersion: 5.5.0-rc.2
diff --git a/deploy/charts/emqx/Chart.yaml b/deploy/charts/emqx/Chart.yaml
index 11fd3a645..679456299 100644
--- a/deploy/charts/emqx/Chart.yaml
+++ b/deploy/charts/emqx/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0-rc.1
+version: 5.5.0-rc.2
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0-rc.1
+appVersion: 5.5.0-rc.2

From 1501f5b89d24d2e3f875add4dc26b3d48056e861 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 31 Jan 2024 18:02:31 +0100
Subject: [PATCH 144/273] ci: fix otp version

---
 .github/workflows/_push-entrypoint.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index 486335534..7b309e592 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -108,7 +108,7 @@ jobs:
       publish: ${{ needs.prepare.outputs.release }}
       latest: ${{ needs.prepare.outputs.latest }}
       # TODO: revert this back to needs.prepare.outputs.otp_vsn when OTP 26 bug is fixed
-      otp_vsn: 25.3.2
+      otp_vsn: 25.3.2-2
       elixir_vsn: ${{ needs.prepare.outputs.elixir_vsn }}
       builder_vsn: ${{ needs.prepare.outputs.builder_vsn }}
     secrets: inherit

From dd490de2e123817ff199417296f80f506f3da604 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Thu, 1 Feb 2024 10:35:17 +0100
Subject: [PATCH 145/273] chore: emqx 5.5.0

---
 apps/emqx/include/emqx_release.hrl            |   4 +-
 .../test/emqx_static_checks_data/5.5.bpapi2   |   1 +
 changes/e5.5.0.en.md                          | 125 ++++++++++++++++++
 changes/v5.5.0.en.md                          | 100 ++++++++++++++
 deploy/charts/emqx-enterprise/Chart.yaml      |   4 +-
 deploy/charts/emqx/Chart.yaml                 |   4 +-
 scripts/rel/cut.sh                            |   2 +-
 7 files changed, 233 insertions(+), 7 deletions(-)
 create mode 100644 apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
 create mode 100644 changes/e5.5.0.en.md
 create mode 100644 changes/v5.5.0.en.md

diff --git a/apps/emqx/include/emqx_release.hrl b/apps/emqx/include/emqx_release.hrl
index 63b87f5d4..7886ec786 100644
--- a/apps/emqx/include/emqx_release.hrl
+++ b/apps/emqx/include/emqx_release.hrl
@@ -32,10 +32,10 @@
 %% `apps/emqx/src/bpapi/README.md'
 
 %% Opensource edition
--define(EMQX_RELEASE_CE, "5.5.0-rc.2").
+-define(EMQX_RELEASE_CE, "5.5.0").
 
 %% Enterprise edition
--define(EMQX_RELEASE_EE, "5.5.0-rc.2").
+-define(EMQX_RELEASE_EE, "5.5.0").
 
 %% The HTTP API version
 -define(EMQX_API_VERSION, "5.0").
diff --git a/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2 b/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
new file mode 100644
index 000000000..6192442f1
--- /dev/null
+++ b/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
@@ -0,0 +1 @@
+#{api => #{{emqx_node_rebalance_api,1} => #{calls => [{{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_bridge,1} => #{calls => [{{emqx_bridge_proto_v1,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_topic_metrics,1} => #{calls => [{{emqx_topic_metrics_proto_v1,reset,['Nodes','Topic']},{emqx_topic_metrics,reset,['Topic']}},{{emqx_topic_metrics_proto_v1,reset,['Nodes']},{emqx_topic_metrics,reset,[]}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes','Topic']},{emqx_topic_metrics,metrics,['Topic']}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes']},{emqx_topic_metrics,metrics,[]}}],casts => []},{emqx_license,1} => #{calls => [{{emqx_license_proto_v1,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_persistent_session_ds,1} => #{calls => [{{emqx_persistent_session_ds_proto_v1,close_all_iterators,['Nodes','DSSessionID']},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,['DSSessionID']}},{{emqx_persistent_session_ds_proto_v1,close_iterator,['Nodes','IteratorID']},{emqx_persistent_session_ds,do_ensure_iterator_closed,['IteratorID']}},{{emqx_persistent_session_ds_proto_v1,open_iterator,['Nodes','TopicFilter','StartMS','IteratorID']},{emqx_persistent_session_ds,do_open_iterator,['TopicFilter','StartMS','IteratorID']}}],casts => []},{emqx,1} => #{calls => [{{emqx_proto_v1,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v1,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v1,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v1,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v1,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v1,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v1,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v1,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v1,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_mgmt_trace,1} => #{calls => [{{emqx_mgmt_trace_proto_v1,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v1,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v1,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_license,2} => #{calls => [{{emqx_license_proto_v2,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_management,4} => #{calls => [{{emqx_management_proto_v4,kickout_clients,['Node','ClientIds']},{emqx_mgmt,do_kickout_clients,['ClientIds']}},{{emqx_management_proto_v4,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v4,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v4,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v4,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v4,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v4,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v4,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v4,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v4,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_management,1} => #{calls => [{{emqx_management_proto_v1,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v1,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v1,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v1,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v1,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v1,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v1,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v1,node_info,['Node']},{emqx_mgmt,node_info,[]}}],casts => []},{emqx_management,2} => #{calls => [{{emqx_management_proto_v2,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v2,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v2,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v2,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v2,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v2,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v2,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v2,node_info,['Node']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v2,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_bridge,4} => #{calls => [{{emqx_bridge_proto_v4,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_cm,2} => #{calls => [{{emqx_cm_proto_v2,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v2,takeover_finish,['ConnMod','ChanPid']},{emqx_cm,takeover_finish,['ConnMod','ChanPid']}},{{emqx_cm_proto_v2,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v2,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_telemetry,1} => #{calls => [{{emqx_telemetry_proto_v1,get_cluster_uuid,['Node']},{emqx_telemetry,get_cluster_uuid,[]}},{{emqx_telemetry_proto_v1,get_node_uuid,['Node']},{emqx_telemetry,get_node_uuid,[]}}],casts => []},{emqx_dashboard,1} => #{calls => [{{emqx_dashboard_proto_v1,current_rate,['Node']},{emqx_dashboard_monitor,current_rate,['Node']}},{{emqx_dashboard_proto_v1,do_sample,['Node','Latest']},{emqx_dashboard_monitor,do_sample,['Node','Latest']}}],casts => []},{emqx_node_rebalance_status,2} => #{calls => [{{emqx_node_rebalance_status_proto_v2,purge_status,['Nodes']},{emqx_node_rebalance_status,purge_status,[]}},{{emqx_node_rebalance_status_proto_v2,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v2,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v2,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_connector,1} => #{calls => [{{emqx_connector_proto_v1,start_connectors_to_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,start_connector_to_node,['Node','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,lookup_from_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_api,lookup_from_local_node,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,list_connectors_on_nodes,['Nodes']},{emqx_connector,list,[]}}],casts => []},{emqx_broker,1} => #{calls => [{{emqx_broker_proto_v1,list_subscriptions_via_topic,['Node','Topic']},{emqx_broker,subscriptions_via_topic,['Topic']}},{{emqx_broker_proto_v1,list_client_subscriptions,['Node','ClientId']},{emqx_broker,subscriptions,['ClientId']}},{{emqx_broker_proto_v1,forward,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}],casts => [{{emqx_broker_proto_v1,forward_async,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}]},{emqx_gateway_http,1} => #{calls => [{{emqx_gateway_http_proto_v1,get_cluster_status,['Nodes','GwName']},{emqx_gateway_http,gateway_status,['GwName']}}],casts => []},{emqx_bridge,6} => #{calls => [{{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,['Node','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,['Nodes','ConfRootKey','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,['ConfRootKey','ActionType','ActionName']}},{{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,['Nodes','ConfRootKey']},{emqx_bridge_v2,list,['ConfRootKey']}},{{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node_v6,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx,2} => #{calls => [{{emqx_proto_v2,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v2,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v2,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v2,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v2,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v2,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v2,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v2,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v2,are_running,['Nodes']},{emqx,is_running,[]}},{{emqx_proto_v2,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_ft_storage_fs_reader,1} => #{calls => [{{emqx_ft_storage_fs_reader_proto_v1,read,['Node','Pid','Bytes']},{emqx_ft_storage_fs_reader,read,['Pid','Bytes']}}],casts => []},{emqx_node_rebalance,1} => #{calls => [{{emqx_node_rebalance_proto_v1,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v1,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v1,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v1,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v1,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_exhook,1} => #{calls => [{{emqx_exhook_proto_v1,server_hooks_metrics,['Nodes','Name']},{emqx_exhook_mgr,server_hooks_metrics,['Name']}},{{emqx_exhook_proto_v1,server_info,['Nodes','Name']},{emqx_exhook_mgr,server_info,['Name']}},{{emqx_exhook_proto_v1,all_servers_info,['Nodes']},{emqx_exhook_mgr,all_servers_info,[]}}],casts => []},{emqx_node_rebalance_api,2} => #{calls => [{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,['Node']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,['Node','Opts']},{emqx_node_rebalance_purge,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_plugins,1} => #{calls => [{{emqx_plugins_proto_v1,get_tar,['Node','NameVsn','Timeout']},{emqx_plugins,get_tar,['NameVsn']}}],casts => []},{emqx_node_rebalance_status,1} => #{calls => [{{emqx_node_rebalance_status_proto_v1,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v1,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v1,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_conf,1} => #{calls => [{{emqx_conf_proto_v1,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v1,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}}],casts => []},{emqx_prometheus,2} => #{calls => [{{emqx_prometheus_proto_v2,raw_prom_data,['Nodes','M','F','A']},{emqx_prometheus_api,lookup_from_local_nodes,['M','F','A']}},{{emqx_prometheus_proto_v2,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v2,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_ft_storage_exporter_fs,1} => #{calls => [{{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,['Node','Filepath','CallerPid']},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,['Filepath','CallerPid']}},{{emqx_ft_storage_exporter_fs_proto_v1,list_exports,['Nodes','Query']},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,['Query']}}],casts => []},{emqx_metrics,1} => #{calls => [{{emqx_metrics_proto_v1,get_metrics,['Nodes','HandlerName','MetricId','Timeout']},{emqx_metrics_worker,get_metrics,['HandlerName','MetricId']}}],casts => []},{emqx_conf,3} => #{calls => [{{emqx_conf_proto_v3,get_hocon_config,['Node','Key']},{emqx_conf_cli,get_config,['Key']}},{{emqx_conf_proto_v3,get_hocon_config,['Node']},{emqx_conf_cli,get_config,[]}},{{emqx_conf_proto_v3,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v3,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v3,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_mgmt_cluster,2} => #{calls => [{{emqx_mgmt_cluster_proto_v2,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v2,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_retainer,2} => #{calls => [{{emqx_retainer_proto_v2,active_mnesia_indices,['Nodes']},{emqx_retainer_mnesia,active_indices,[]}},{{emqx_retainer_proto_v2,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_node_rebalance,3} => #{calls => [{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind','Options']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind','Options']}},{{emqx_node_rebalance_proto_v3,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v3,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v3,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v3,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v3,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_delayed,3} => #{calls => [{{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,['Nodes','TopicName']},{emqx_delayed,do_delete_delayed_messages_by_topic_name,['TopicName']}},{{emqx_delayed_proto_v3,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v3,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v3,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_eviction_agent,2} => #{calls => [{{emqx_eviction_agent_proto_v2,all_channels_count,['Nodes','Timeout']},{emqx_eviction_agent,all_local_channels_count,[]}},{{emqx_eviction_agent_proto_v2,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_ds,1} => #{calls => [{{emqx_ds_proto_v1,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v1,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v1,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v1,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v1,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_node_rebalance_purge,1} => #{calls => [{{emqx_node_rebalance_purge_proto_v1,stop,['Nodes']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_purge_proto_v1,start,['Nodes','Opts']},{emqx_node_rebalance_purge,start,['Opts']}}],casts => []},{emqx_gateway_api_listeners,1} => #{calls => [{{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,['Nodes','Listeners']},{emqx_gateway_api_listeners,do_listeners_cluster_status,['Listeners']}}],casts => []},{emqx_mgmt_trace,2} => #{calls => [{{emqx_mgmt_trace_proto_v2,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v2,trace_file_detail,['Nodes','File']},{emqx_trace,trace_file_detail,['File']}},{{emqx_mgmt_trace_proto_v2,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v2,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_slow_subs,1} => #{calls => [{{emqx_slow_subs_proto_v1,get_history,['Nodes']},{emqx_slow_subs_api,get_history,[]}},{{emqx_slow_subs_proto_v1,clear_history,['Nodes']},{emqx_slow_subs,clear_history,[]}}],casts => []},{emqx_mgmt_api_plugins,1} => #{calls => [{{emqx_mgmt_api_plugins_proto_v1,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v1,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,describe_package,['Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,install_package,['Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v1,get_plugins,[]},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_conf,2} => #{calls => [{{emqx_conf_proto_v2,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v2,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v2,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_ds,2} => #{calls => [{{emqx_ds_proto_v2,add_generation,['Node','DB']},{emqx_ds_replication_layer,do_add_generation_v2,['DB']}},{{emqx_ds_proto_v2,update_iterator,['Node','DB','Shard','OldIter','DSKey']},{emqx_ds_replication_layer,do_update_iterator_v2,['DB','Shard','OldIter','DSKey']}},{{emqx_ds_proto_v2,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v2,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v2,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v2,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v2,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_shared_sub,1} => #{calls => [{{emqx_shared_sub_proto_v1,dispatch_with_ack,['Pid','Group','Topic','Msg','Timeout']},{emqx_shared_sub,do_dispatch_with_ack,['Pid','Group','Topic','Msg']}}],casts => [{{emqx_shared_sub_proto_v1,send,['Node','Pid','Topic','Msg']},{erlang,send,['Pid','Msg']}}]},{emqx_ft_storage_fs,1} => #{calls => [{{emqx_ft_storage_fs_proto_v1,list_assemblers,['Nodes','Transfer']},{emqx_ft_storage_fs_proxy,lookup_local_assembler,['Transfer']}},{{emqx_ft_storage_fs_proto_v1,pread,['Node','Transfer','Frag','Offset','Size']},{emqx_ft_storage_fs_proxy,pread_local,['Transfer','Frag','Offset','Size']}},{{emqx_ft_storage_fs_proto_v1,multilist,['Nodes','Transfer','What']},{emqx_ft_storage_fs_proxy,list_local,['Transfer','What']}}],casts => []},{emqx_cm,1} => #{calls => [{{emqx_cm_proto_v1,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v1,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v1,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_authn,1} => #{calls => [{{emqx_authn_proto_v1,lookup_from_all_nodes,['Nodes','ChainName','AuthenticatorID']},{emqx_authn_api,lookup_from_local_node,['ChainName','AuthenticatorID']}}],casts => []},{emqx_resource,1} => #{calls => [{{emqx_resource_proto_v1,reset_metrics,['ResId']},{emqx_resource,reset_metrics_local,['ResId']}},{{emqx_resource_proto_v1,remove,['ResId']},{emqx_resource,remove_local,['ResId']}},{{emqx_resource_proto_v1,recreate,['ResId','ResourceType','Config','Opts']},{emqx_resource,recreate_local,['ResId','ResourceType','Config','Opts']}},{{emqx_resource_proto_v1,create_dry_run,['ResourceType','Config']},{emqx_resource,create_dry_run_local,['ResourceType','Config']}},{{emqx_resource_proto_v1,create,['ResId','Group','ResourceType','Config','Opts']},{emqx_resource,create_local,['ResId','Group','ResourceType','Config','Opts']}}],casts => []},{emqx_bridge,5} => #{calls => [{{emqx_bridge_proto_v5,v2_start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,['Nodes','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node,['ActionType','ActionName']}},{{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,['Nodes']},{emqx_bridge_v2,list,[]}},{{emqx_bridge_proto_v5,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_eviction_agent,1} => #{calls => [{{emqx_eviction_agent_proto_v1,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_authz,1} => #{calls => [{{emqx_authz_proto_v1,lookup_from_all_nodes,['Nodes','Type']},{emqx_authz_api_sources,lookup_from_local_node,['Type']}}],casts => []},{emqx_gateway_cm,1} => #{calls => [{{emqx_gateway_cm_proto_v1,cast,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_cast,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req','Timeout']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req','Timeout']}},{{emqx_gateway_cm_proto_v1,takeover_session,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_takeover_session,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,get_chann_conn_mod,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chann_conn_mod,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,kick_session,['GwName','Action','ClientId','ChanPid']},{emqx_gateway_cm,do_kick_session,['GwName','Action','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_stats,['GwName','ClientId','ChanPid','Stats']},{emqx_gateway_cm,do_set_chan_stats,['GwName','ClientId','ChanPid','Stats']}},{{emqx_gateway_cm_proto_v1,get_chan_stats,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_stats,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_info,['GwName','ClientId','ChanPid','Infos']},{emqx_gateway_cm,do_set_chan_info,['GwName','ClientId','ChanPid','Infos']}},{{emqx_gateway_cm_proto_v1,get_chan_info,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_info,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,lookup_by_clientid,['Nodes','GwName','ClientId']},{emqx_gateway_cm,do_lookup_by_clientid,['GwName','ClientId']}}],casts => []},{emqx_bridge,3} => #{calls => [{{emqx_bridge_proto_v3,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}},{{emqx_bridge_proto_v3,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_rule_engine,1} => #{calls => [{{emqx_rule_engine_proto_v1,reset_metrics,['RuleId']},{emqx_rule_engine,reset_metrics_for_rule,['RuleId']}}],casts => []},{emqx_node_rebalance_evacuation,1} => #{calls => [{{emqx_node_rebalance_evacuation_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance_evacuation,is_node_available,[]}}],casts => []},{emqx_bridge,2} => #{calls => [{{emqx_bridge_proto_v2,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_node_rebalance,2} => #{calls => [{{emqx_node_rebalance_proto_v2,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v2,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v2,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v2,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v2,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_mgmt_data_backup,1} => #{calls => [{{emqx_mgmt_data_backup_proto_v1,delete_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,delete_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,read_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,read_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,import_file,['Node','FileNode','FileName','Timeout']},{emqx_mgmt_data_backup,maybe_copy_and_import,['FileNode','FileName']}},{{emqx_mgmt_data_backup_proto_v1,list_files,['Nodes','Timeout']},{emqx_mgmt_data_backup,list_files,[]}}],casts => []},{emqx_retainer,1} => #{calls => [{{emqx_retainer_proto_v1,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_delayed,2} => #{calls => [{{emqx_delayed_proto_v2,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v2,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v2,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_mgmt_api_plugins,2} => #{calls => [{{emqx_mgmt_api_plugins_proto_v2,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v2,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,describe_package,['Nodes','Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,install_package,['Nodes','Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v2,get_plugins,['Nodes']},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_mgmt_cluster,1} => #{calls => [{{emqx_mgmt_cluster_proto_v1,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_mgmt_cluster,3} => #{calls => [{{emqx_mgmt_cluster_proto_v3,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v3,invite_node,['Node','Self','Timeout']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_prometheus,1} => #{calls => [{{emqx_prometheus_proto_v1,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v1,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_delayed,1} => #{calls => [{{emqx_delayed_proto_v1,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v1,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_management,3} => #{calls => [{{emqx_management_proto_v3,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v3,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v3,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v3,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v3,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v3,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v3,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v3,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v3,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []}},release => "master",signatures => #{{emqx_retainer_proto_v1,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proxy,pread_local,4} => {any,[any,any,any,any]},{emqx_bridge_proto_v2,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v2,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_shared_sub_proto_v1,dispatch_with_ack,5} => {any,[{c,identifier,[pid],unknown},{c,union,[{c,atom,['_'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_monitor,current_rate,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[badrpc],unknown},any],{2,{c,atom,[badrpc],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown}]},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,1} => {any,[any]},{emqx_management_proto_v3,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,list_connectors_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_lookup_by_clientid,2} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,none],unknown},any]},{emqx_persistent_session_ds,do_open_iterator,3} => {{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_implemented],unknown}],{2,{c,atom,[error],unknown}}},[any,any,any]},{emqx_cm,do_get_chann_conn_mod,2} => {any,[any,any]},{emqx_persistent_session_ds_proto_v1,close_iterator,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup,read_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_resource,create_local,5} => {{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}},[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_authz_api_sources,lookup_from_local_node,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_management_proto_v3,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ft_storage_exporter_fs_proto_v1,list_exports,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[following],unknown},optional,any},{{c,atom,[limit],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[transfer],unknown},optional,{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}}],none,none},unknown}]},{emqx,get_config,1} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_resource_proto_v1,remove,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_management_proto_v2,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_broker_proto_v1,list_client_subscriptions,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_resource_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_delayed,clear_all_local,0} => {{c,atom,[ok],unknown},[]},{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx,reset_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any]},{emqx_mgmt_api_plugins,delete_package,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,list_files,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,import_file,4} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_retainer_mnesia,active_indices,0} => {{c,tuple,[any,any],{2,any}},[]},{emqx_cm,do_get_chan_stats,2} => {any,[any,any]},{emqx_node_rebalance_proto_v3,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_listeners,do_list_listeners,0} => {{c,map,{[],{c,binary,{40,32},unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},unknown},[]},{emqx_conf_app,get_override_config_file,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[msg],unknown},mandatory,any},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[release],unknown},mandatory,{c,list,{any,{c,nil,[],unknown}},nonempty}},{{c,atom,[wall_clock],unknown},mandatory,{c,tuple,[any,any],{2,any}}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_ds_replication_layer,do_make_iterator_v1,5} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_authz_proto_v1,lookup_from_all_nodes,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_ft_storage_fs_reader_proto_v1,read,3} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_slow_subs,clear_history,0} => {any,[]},{emqx_proto_v1,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_cm,do_kick_session,3} => {{c,atom,[ok],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,get_chann_conn_mod,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_eviction_agent_proto_v2,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_mgmt_api_plugins_proto_v1,install_package,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v1,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_v2_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v1,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,reset,1} => {any,[any]},{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v5,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed,delete_delayed_message,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v6,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_conf_proto_v2,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v1,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_mgr,server_info,1} => {any,[any]},{emqx_management_proto_v2,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_management_proto_v4,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_cm_proto_v1,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_dashboard_proto_v1,do_sample,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v2,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{ssl_pem_cache,clear,0} => {any,[]},{emqx_mgmt_api_plugins,ensure_action,2} => {{c,atom,[ok],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_conf_proto_v3,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_resource_proto_v1,recreate,4} => {any,[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_conf_proto_v3,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_api_listeners,do_listeners_cluster_status,1} => {{c,map,{[],any,any},unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node_v6,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry_proto_v1,get_cluster_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v1,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_resource,create_dry_run_local,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},any]},{emqx_gateway_cm,do_set_chan_info,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_api_cluster,connected_replicants,0} => {{c,list,{{c,tuple,[{c,atom,any,unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown}],{3,any}},{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_list_subscriptions,0} => {none,[]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_v2,list,1} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,rebalance_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,evacuation_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[current_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[migrate_to],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_mgmt_trace_proto_v2,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,set_chan_stats,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx,get_config,2} => {any,[any,any]},{emqx_proto_v2,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_topic_metrics,metrics,0} => {{c,list,{{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_node_rebalance_agent,enable,3} => {any,[any,any,any]},{emqx_ft_storage_fs_proto_v1,pread,5} => {any,[{c,atom,any,unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,map,{[{{c,atom,[fragment],unknown},mandatory,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[filemeta],unknown},{c,map,{[{{c,atom,[checksum],unknown},optional,{c,tuple,[{c,atom,any,unknown},{c,binary,{8,0},unknown}],{2,any}}},{{c,atom,[expire_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[name],unknown},mandatory,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown}},{{c,atom,[segments_ttl],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[user_data],unknown},optional,{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[filemeta],unknown}}},{c,tuple,[{c,atom,[segment],unknown},{c,map,{[{{c,atom,[offset],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[segment],unknown}}}]}],unknown}},{{c,atom,[path],unknown},mandatory,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[timestamp],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,2} => {any,[any,any]},{emqx_trace,trace_file,1} => {{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_topic_metrics,reset,0} => {any,[]},{emqx_conf_proto_v1,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm_proto_v1,takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_cm_proto_v1,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_topic_metrics_proto_v1,reset,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins,get_plugins,0} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v3,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_proto_v1,all_servers_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v1,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_management_proto_v1,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v3,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_prometheus_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry,get_cluster_uuid,0} => {any,[]},{emqx_proto_v1,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_status,purge_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[purge_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_resource_proto_v1,create_dry_run,2} => {any,[{c,atom,any,unknown},any]},{emqx_mgmt_data_backup,delete_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_rule_engine_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_mgmt_data_backup,list_files,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_proto_v1,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_topic_metrics_proto_v1,metrics,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v1,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins,describe_package,1} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_proto_v1,current_rate,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,set_chan_info,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,map,{[],{c,atom,any,unknown},any},unknown}]},{emqx_node_rebalance_proto_v2,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_set_chan_stats,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_trace_proto_v2,trace_file_detail,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v1,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,start_connector_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_v2,list,0} => {any,[]},{emqx_node_rebalance_proto_v2,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v2,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_slow_subs_proto_v1,clear_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed,get_delayed_message,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[delayed_interval],unknown},mandatory,any},{{c,atom,[delayed_remaining],unknown},mandatory,{c,number,any,integer}},{{c,atom,[expected_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[from_clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[from_username],unknown},mandatory,any},{{c,atom,[msgid],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[node],unknown},mandatory,any},{{c,atom,[payload],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[publish_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[qos],unknown},mandatory,any},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,do_unsubscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple,[any,any,any],{3,any}},none,none],unknown},{c,map,{[],any,any},unknown}],{2,any}},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_api_plugins_proto_v2,install_package,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_gateway_cm,do_call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,any]},{emqx_mgmt,do_call_client,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_cm_proto_v2,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_ds_replication_layer,do_drop_db_v1,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_eviction_agent,all_local_channels_count,0} => {any,[]},{emqx_bridge_proto_v4,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_cluster_proto_v3,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v1,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_persistent_session_ds_proto_v1,open_iterator,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},any]},{emqx_cm_proto_v2,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_evacuation_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_cluster_proto_v1,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ds_proto_v2,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_bridge_proto_v3,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,evict_sessions,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown},any]},{emqx_gateway_http,gateway_status,1} => {{c,map,{[{{c,atom,[current_connections],unknown},optional,any},{{c,atom,[max_connections],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[running,stopped,unloaded],unknown}}],none,none},unknown},[{c,atom,any,unknown}]},{emqx_bridge_proto_v4,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,read_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_cm_proto_v1,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_delayed_proto_v3,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_conf_proto_v1,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,reset,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v5,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_store_batch_v1,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],any,any},unknown},{c,map,{[],any,any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],any,any},unknown},{c,map,{[],none,none},unknown}]},{emqx_management_proto_v1,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_set,"_defknotuy"},integer},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[error],unknown}}},none,{c,map,{[],any,any},unknown}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_trace,trace_file_detail,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[file],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[reason],unknown},mandatory,{c,atom,any,unknown}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[mtime],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},{c,tuple,[{c,tuple,[any,any,any],{3,any}},{c,tuple,[any,any,any],{3,any}}],{2,any}},none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[size],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,4} => {any,[{c,atom,any,unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_trace,get_trace_size,0} => {{c,map,{[],any,any},unknown},[]},{emqx_prometheus_proto_v1,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_retainer_proto_v2,active_mnesia_indices,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_stats,getstats,0} => {{c,list,{{c,tuple,any,{any,any}},{c,nil,[],unknown}},unknown},[]},{emqx_alarm,deactivate,1} => {any,[any]},{emqx_conf_proto_v2,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_resources,local_connection_count,0} => {any,[]},{emqx_bridge_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_persistent_session_ds_proto_v1,close_all_iterators,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v2,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_management_proto_v3,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v2,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_broker_proto_v1,forward,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_node_rebalance_proto_v1,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_exhook_proto_v1,server_hooks_metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_prometheus_api,lookup_from_local_nodes,3} => {any,[{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_eviction_agent_proto_v2,all_channels_count,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_cm_proto_v1,call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_prometheus_proto_v2,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v4,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v3,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_http_proto_v1,get_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,raw_prom_data,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx,update_config,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_v2,start,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_alarm,delete_all_deactivated_alarms,0} => {any,[]},{emqx_management_proto_v3,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_api_cluster,join,1} => {{c,union,[{c,atom,[ignore,ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown}]},{emqx_cm_proto_v2,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v3,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_broker_proto_v1,forward_async,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,2} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_connector,list,0} => {any,[]},{emqx_cm_proto_v2,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_mgmt_api_plugins_proto_v1,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_prometheus,do_stop,0} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,restarting,running,simple_one_for_one],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[]},{emqx_exhook_mgr,server_hooks_metrics,1} => {any,[any]},{emqx_ds_proto_v2,update_iterator,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v1,describe_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v4,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{erlang,send,2} => {any,[any,any]},{emqx_metrics_worker,get_metrics,2} => {{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_purge_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_configs,get_full_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_fs_proxy,list_local,2} => {any,[any,any]},{emqx_ft_storage_fs_reader,read,2} => {any,[{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_node_rebalance_status_proto_v2,purge_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_delayed_proto_v1,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_proto_v1,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_gateway_cm,do_kick_session,4} => {{c,atom,[ok],unknown},[{c,atom,any,unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_get_chann_conn_mod,3} => {any,[any,any,any]},{emqx_mgmt_cluster_proto_v3,invite_node,3} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown}]},{emqx_authn_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_authz_cache,drain_cache,0} => {{c,atom,[ok],unknown},[]},{emqx_ds_proto_v1,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_proto_v2,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup_proto_v1,delete_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_gateway_cm,do_get_chan_info,3} => {{c,union,[{c,atom,[undefined],unknown},none,none,none,none,none,none,none,{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}}],any,any},unknown}],unknown},[any,any,any]},{emqx_retainer_dispatcher,wait_dispatch_complete,1} => {{c,atom,[ok],unknown},[any]},{emqx_resource,remove_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_shared_sub,do_dispatch_with_ack,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid,port],unknown},any,any,{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}]},{emqx_node_rebalance_status,local_status,0} => {{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[evacuation],unknown},any],{2,{c,atom,[evacuation],unknown}}},{c,tuple,[{c,atom,[purge],unknown},any],{2,{c,atom,[purge],unknown}}},{c,tuple,[{c,atom,[rebalance],unknown},{c,map,{[],{c,atom,[connection_eviction_rate,connection_goal,coordinator_node,disconnected_session_goal,recipients,session_eviction_rate,state,stats],unknown},any},unknown}],{2,{c,atom,[rebalance],unknown}}}]}],unknown},none,none],unknown},[]},{emqx_ds_replication_layer,do_next_v1,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,atom,[end_of_stream],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any],{10,any}}],{2,any}},{c,nil,[],unknown}},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_conf_proto_v3,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v1,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_proto_v1,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_proto_v2,are_running,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm_proto_v1,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_delayed_proto_v3,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v2,describe_package,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,purge_sessions,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_slow_subs_proto_v1,get_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed_proto_v1,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_conf,get_node_and_config,1} => {{c,tuple,[{c,atom,any,unknown},any],{2,any}},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v1,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v3,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_broker,subscriptions_via_topic,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[any]},{emqx_persistent_session_ds,do_ensure_iterator_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_bridge_resource,stop,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_trace_proto_v1,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_proto_v2,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_management_proto_v2,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_telemetry_proto_v1,get_node_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_broker,subscriptions,1} => {{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}]},{emqx_slow_subs_api,get_history,0} => {{c,list,{{c,map,{[{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[last_update_time],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[timespan],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_gateway_cm_proto_v1,lookup_by_clientid,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_get_streams_v1,4} => {{c,list,{{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,any}},{c,nil,[],unknown}},unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_plugins,get_tar,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown}]},{emqx_conf_proto_v1,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_connector_proto_v1,start_connectors_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_prometheus,do_start,0} => {{c,atom,[ok],unknown},[]},{emqx_gateway_cm_proto_v1,get_chan_stats,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_status_proto_v1,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,metrics,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[topic_not_found],unknown}],{2,{c,atom,[error],unknown}}},none,{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown}],unknown},[any]},{emqx_cm_proto_v1,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_broker_proto_v1,list_subscriptions_via_topic,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v2,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_metrics_proto_v1,get_metrics,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_management_proto_v2,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_finish,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[noproc,timeout,unexpected_exception],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,get_chan_info,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_retainer_proto_v2,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins_proto_v2,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v2,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_cm,lookup_client,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},any],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},any],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_bridge_proto_v6,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_dashboard_monitor,do_sample,2} => {any,[{c,atom,any,unknown},any]},{emqx_broker,dispatch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[no_subscribers,not_running],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,number,{int_rng,0,pos_inf},integer}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[any,any,any,any],{4,any}}]},{8,[{c,tuple,[any,any,any,any,any,any,any,any],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_gateway_cm,do_get_chan_stats,3} => {any,[any,any,any]},{emqx_bridge_proto_v4,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_cm_proto_v2,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v1,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_resource,reset_metrics_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_mgmt,do_subscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[subscribe],unknown},any],{2,{c,atom,[subscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_trace_proto_v1,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_fs_proto_v1,multilist,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,atom,[fragment,result],unknown}]},{emqx,is_running,0} => {{c,atom,[false,true],unknown},[]},{emqx_eviction_agent_proto_v1,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_resource_proto_v1,create,5} => {any,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v2,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_cm_proto_v1,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_node_rebalance_proto_v3,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_bridge_resource,restart,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_mgmt_api_plugins_proto_v1,get_plugins,0} => {any,[]},{emqx_gateway_cm,do_cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_bridge_proto_v2,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v1,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v1,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_rule_engine,reset_metrics_for_rule,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_resource,recreate_local,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,updating_to_incorrect_resource_type],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_delayed_proto_v3,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v3,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,node_info,0} => {{c,map,{[{{c,atom,[connections],unknown},mandatory,any},{{c,atom,[edition],unknown},mandatory,{c,binary,{0,80},unknown}},{{c,atom,[live_connections],unknown},mandatory,any},{{c,atom,[load1],unknown},optional,{c,number,any,float}},{{c,atom,[load15],unknown},optional,{c,number,any,float}},{{c,atom,[load5],unknown},optional,{c,number,any,float}},{{c,atom,[log_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[max_fds],unknown},mandatory,any},{{c,atom,[memory_total],unknown},mandatory,{c,number,any,unknown}},{{c,atom,[memory_used],unknown},mandatory,{c,number,any,integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[process_available],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[process_used],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[role],unknown},mandatory,{c,atom,[core,replicant],unknown}},{{c,atom,[sys_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[uptime],unknown},mandatory,any},{{c,atom,[version],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},[]},{emqx_ft_storage_fs_proxy,lookup_local_assembler,1} => {any,[any]},{emqx_cm_proto_v2,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_bridge_v1_compatible,not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,atom,[actions,sources],unknown},{c,map,{[{{c,atom,[error],unknown},mandatory,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[incomplete],unknown},{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[incomplete],unknown}}}]}],unknown},none,none],unknown}},{{c,atom,[name],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[raw_config],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[resource_data],unknown},mandatory,{c,map,{[{{c,atom,[added_channels],unknown},optional,any},{{c,atom,[callback_mode],unknown},optional,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},optional,any},{{c,atom,[error],unknown},optional,any},{{c,atom,[id],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},optional,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},optional,any},{{c,atom,[status],unknown},optional,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}},{{c,atom,[type],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_update_iterator_v2,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_evacuation,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_node_rebalance_proto_v1,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_metrics,all,0} => {{c,list,{{c,tuple,[any,{c,number,any,integer}],{2,any}},{c,nil,[],unknown}},unknown},[]},{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proto_v1,list_assemblers,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}]},{emqx_node_rebalance_agent,disable,2} => {any,[any,any]},{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authn_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v4,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v4,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v2,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_eviction_agent,evict_connections,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v3,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_purge_proto_v1,start,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_eviction_agent,evict_session_channel,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown},any],{3,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_management_proto_v1,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_agent,enable,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown},any]},{emqx_mgmt_cluster_proto_v2,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_shared_sub_proto_v1,send,4} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,binary,{8,0},unknown},any]},{emqx_mgmt,do_unsubscribe_batch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_management_proto_v4,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_purge,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_node_rebalance,disconnected_session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_bridge_proto_v2,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,takeover_finish,2} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_exhook_proto_v1,server_info,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_conf_proto_v3,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_delayed,do_delete_delayed_messages_by_topic_name,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,binary,{8,0},unknown}]},{emqx_node_rebalance_purge,stop,0} => {any,[]},{emqx_mgmt_api_trace,read_trace_file,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[eof],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}],{2,{c,atom,[eof],unknown}}},{c,tuple,[{c,atom,[error],unknown},{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,[{c,atom,[no_translation],unknown},{c,atom,[unicode],unknown},{c,atom,[latin1],unknown}],{3,{c,atom,[no_translation],unknown}}},none,none],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},any,any]},{emqx_mgmt_api_plugins_proto_v2,get_plugins,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,1} => {any,[{c,atom,any,unknown}]},{emqx_proto_v2,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_delayed_proto_v2,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,do_get_chan_info,2} => {any,[any,any]},{emqx_node_rebalance_agent,enable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_mgmt,broker_info,0} => {{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}}],any,any},unknown},[]},{emqx_telemetry,get_node_uuid,0} => {any,[]},{emqx_management_proto_v1,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v3,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup,maybe_copy_and_import,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[bardrpc],unknown},any],{2,{c,atom,[bardrpc],unknown}}},{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config_errors],unknown},mandatory,{c,map,{[],{c,list,{any,{c,nil,[],unknown}},unknown},{c,tuple,[any,any],{2,any}}},unknown}},{{c,atom,[db_errors],unknown},mandatory,{c,map,{[],{c,atom,any,unknown},{c,tuple,[any,any],{2,any}}},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v1,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,kick_session,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v5,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_replication_layer,do_add_generation_v2,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,3} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx,remove_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,add_generation,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_node_rebalance_evacuation,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_node_rebalance_agent,disable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[already_disabled,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any,{c,map,{[{{c,atom,[allow_connections],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_plugins_proto_v1,get_tar,3} => {any,[{c,atom,any,unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_api_plugins,install_package,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_bridge,list,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_kickout_clients,1} => {{c,atom,[ok],unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v6,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_cluster_proto_v2,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_conf_proto_v3,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_evacuation,stop,0} => {any,[]},{emqx_management_proto_v4,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,stop,0} => {any,[]},{emqx_bridge_proto_v4,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v1,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,kick_session,4} => {any,[{c,atom,any,unknown},{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authz_cache,drain_cache,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_session,2} => {{c,union,[{c,atom,[none,ok,undefined],unknown},none,none,none,{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown},none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[expired],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[expired],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,none,none,none,{c,list,{{c,tuple,[any,any,any],{3,any}},{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],any,any},unknown}],unknown}],{2,{c,atom,[ok],unknown}}},{c,tuple,[{c,atom,[persistent],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[persistent],unknown}}}]},{4,[{c,tuple,[{c,atom,[living],unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown},any],{4,{c,atom,[living],unknown}}}]}],unknown},none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown},[any,any]},{emqx_node_rebalance,connection_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_conf_app,sync_data_from_node,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,kickout_clients,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_alarm,get_alarms,1} => {any,[{c,atom,[activated,all,deactivated],unknown}]},{emqx_management_proto_v2,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_exhook_mgr,all_servers_info,0} => {any,[]}}}.
diff --git a/changes/e5.5.0.en.md b/changes/e5.5.0.en.md
new file mode 100644
index 000000000..1b73aea46
--- /dev/null
+++ b/changes/e5.5.0.en.md
@@ -0,0 +1,125 @@
+# e5.5.0
+
+## Enhancements
+
+- [#12085](https://github.com/emqx/emqx/pull/12085) EMQX has been upgraded to leverage the capabilities of OTP version 26.1.2-2. NOTE: Docker images are still built with OTP 25.3.2.
+
+- [#12189](https://github.com/emqx/emqx/pull/12189) Enhanced the [ACL](../access-control/authn/jwt.md#access-control-list-optional) claim format in EMQX JWT authentication for greater versatility. The updated format now supports an array structure, aligning more closely with the file-based ACL rules.
+
+  For example:
+
+  ```json
+  [
+  {
+    "permission": "allow",
+    "action": "pub",
+    "topic": "${username}/#",
+    "qos": [0, 1],
+    "retain": true
+  },
+  {
+    "permission": "allow",
+    "action": "sub",
+    "topic": "eq ${username}/#",
+    "qos": [0, 1]
+  },
+  {
+    "permission": "deny",
+    "action": "all",
+    "topics": ["#"]
+  }
+  ]
+  ```
+
+  In this new format, the absence of a matching rule does not result in an automatic denial of the action. The authorization chain can advance to other configured authorizers if a match is not found in the JWT ACL. If no match is found throughout the chain, the final decision defers to the default permission set in `authorization.no_match`.
+
+- [#12267](https://github.com/emqx/emqx/pull/12267) Added a new `timeout` parameter to the `cluster/:node/invite` interface, addressing the issue of default timeouts. 
+  The previously set 5-second default timeout often led to HTTP API call timeouts because joining an EMQX cluster usually requires more time.
+
+  In addition, EMQX added a new API `/cluster/:node/invite_async` to support an asynchronous way to invite nodes to join the cluster and introduced a new `cluster/invitation` API to inspect the join status.
+
+- [#12272](https://github.com/emqx/emqx/pull/12272) Introduced updates to the `retain` API in EMQX:
+
+  - Added a new API `DELETE /retainer/messages` to clean all retained messages.
+  - Added an optional topic filter parameter `topic` in the query string for the API `GET /retainer/messages`. For example, using a query string `topic=t/1` filters the retained messages for a specific topic, improving the efficiency of message retrieval.
+
+- [#12277](https://github.com/emqx/emqx/pull/12277) Added `mqtt/delayed/messages/:topic` API to remove delayed messages by topic name.
+
+- [#12278](https://github.com/emqx/emqx/pull/12278) Adjusted the maximum pagination size for paginated APIs in the REST API from `3000` to `10000`.
+
+- [#12289](https://github.com/emqx/emqx/pull/12289) Authorization caching now supports the exclusion of specific topics. For the specified list of topics and topic filters, EMQX will not generate an authorization cache. The list can be set through the `authorization.cache.excludes` configuration item or via the Dashboard. For these specific topics, permission checks will always be conducted in real-time rather than relying on previous cache results, thus ensuring the timeliness of authorization outcomes.
+
+- [#12329](https://github.com/emqx/emqx/pull/12329) Added `broker.routing.batch_sync` configuration item to enable a dedicated process pool that synchronizes subscriptions with the global routing table in batches, thus reducing the frequency of cross-node communication that can be slowed down by network latency. Processing multiple subscription updates collectively, not only accelerates synchronization between replica nodes and core nodes in a cluster but also reduces the load on the broker pool, minimizing the risk of overloading.
+
+- [#12333](https://github.com/emqx/emqx/pull/12333) Added a `tags` field for actions and connectors. Similar to the `description` field (which is a free text annotation), `tags` can be used to annotate actions and connectors for filtering and grouping.
+
+- [#12072](https://github.com/emqx/emqx/pull/12072) GreptimeDB data integration now supports asynchronous data write operations to provide better performance.
+
+- [#12194](https://github.com/emqx/emqx/pull/12194) Improved Kafka producer performance.
+
+- [#12247](https://github.com/emqx/emqx/pull/12247) The bridges for InfluxDB have been split so they are available via the connectors and actions APIs. They are still backward compatible with the old bridge API.
+
+- [#12299](https://github.com/emqx/emqx/pull/12299) Exposed more metrics to improve observability:
+
+  Montior API:
+  - Added `retained_msg_count` field to `/api/v5/monitor_current`.
+  - Added `license_quota` field to `/api/v5/monitor_current`
+  - Added `retained_msg_count` and `node_uptime` fields to `/api/v5/monitor_current/nodes/{node}`.
+  - Added `retained_msg_count`, `license_quota` and `node_uptime` fields to `/api/v5/monitor_current/nodes/{node}`.
+
+  Prometheus API:
+  - Added `emqx_cert_expiry_at` and `emqx_license_expiry_at` to `/api/v5/prometheus/stats` to display TLS listener certificate expiration time and license expiration time.
+  - Added `/api/v5/prometheus/auth` endpoint to provide metrics such as execution count and running status for all authenticatiors and authorizators.
+  - Added `/api/v5/prometheus/data_integration` endpoint to provide metrics such as execution count and status for all rules, actions, and connectors.
+
+  Limitations:
+  Prometheus push gateway only supports the content in `/api/v5/prometheus/stats?mode=node`.
+
+  For more API details and metric type information, please see swagger api docs.
+
+- [#12196](https://github.com/emqx/emqx/pull/12196) Improved network efficiency during routes cleanup.
+
+  Previously, when a node was down, a delete operation for each route to that node must be exchanged between all the other live nodes. After this change, only one `match and delete` operation is exchanged between all live nodes, significantly reducing the number of necessary network packets and decreasing the load on the inter-cluster network.
+  This optimization must be especially helpful for geo-distributed EMQX deployments where network latency can be significantly high.
+
+- [#12354](https://github.com/emqx/emqx/pull/12354) The concurrent creation and updates of data integrations are now supported, significantly increasing operation speeds, such as when importing backup files.
+
+- [#12396](https://github.com/emqx/emqx/pull/12396) Enhanced the user import feature in the `authentication/:id/import_users` Interface:
+
+  - Added a new parameter `?type=plain` for easier importing of users with plaintext passwords, complementing the existing functionality that supports hashed passwords.
+  - Enhanced support for `content-type: application/json`, allowing HTTP Body submissions in JSON format. This extends the current capability that exclusively supports `multipart/form-data` for CSV files.
+
+- [#11902](https://github.com/emqx/emqx/pull/11902) Enhanced EMQX's capability to facilitate MQTT message bridging through the one-way Nari SysKeeper 2000 network isolation gateway.
+
+## Bug Fixes
+
+- [#12232](https://github.com/emqx/emqx/pull/12232) Fixed an issue when cluster commit log table was not deleted after a node was forced to leave a cluster.
+
+- [#12243](https://github.com/emqx/emqx/pull/12243) Fixed a family of subtle race conditions that could lead to inconsistencies in the global routing state.
+
+- [#12269](https://github.com/emqx/emqx/pull/12269) Improved error handling in the `/clients` interface; now returns a 400 status with more detailed error messages, instead of a generic 500, for query string validation failures.
+
+- [#12285](https://github.com/emqx/emqx/pull/12285) Updated the CoAP gateway to support short parameter names for slight savings in datagram size. For example, `clientid=bar` can be written as `c=bar`.
+
+- [#12303](https://github.com/emqx/emqx/pull/12303) Fixed the message indexing in retainer. Previously, clients with wildcard subscriptions might receive irrelevant retained messages not matching their subscription topics.
+
+- [#12305](https://github.com/emqx/emqx/pull/12305) Corrected an issue with incomplete client/connection information being passed into `emqx_cm`, which could lead to internal inconsistencies and affect memory usage and operations like node evacuation.
+
+- [#12306](https://github.com/emqx/emqx/pull/12306) Fixed an issue preventing the connectivity test for the Connector from functioning correctly after updating the password parameter via the HTTP API.
+
+- [#12359](https://github.com/emqx/emqx/pull/12359) Fixed an issue causing error messages when restarting a node configured with some types of data bridges.  Additionally, these bridges were at risk of entering a failed state upon node restart, requiring a manual restart to restore functionality.
+
+- [#12404](https://github.com/emqx/emqx/pull/12404) Fixed an issue where restarting a data integration with heavy message flow could lead to a stop in the collection of data integration metrics. 
+
+- [#12282](https://github.com/emqx/emqx/pull/12282) Improved the HTTP API error response for MySQL bridge creation failures. It also resolved a problem with removing MySQL Sinks containing undefined columns in their SQL.
+
+- [#12291](https://github.com/emqx/emqx/pull/12291) Fixed inconsistencies in EMQX’s handling of configuration updates involving sensitive parameters, which previously led to stray `"******"` strings in cluster configuration files.
+
+- [#12301](https://github.com/emqx/emqx/pull/12301) Fixed an issue with the line protocol in InfluxDB, where numeric literals were being stored as string types.
+
+- [#12317](https://github.com/emqx/emqx/pull/12317) Removed the `resource_opts.batch_size` field from the MongoDB Action schema, as it is not yet supported.
+
+## Breaking Changes
+
+- [#12283](https://github.com/emqx/emqx/pull/12283) Fixed the `resource_opts` configuration schema for the GCP PubSub Producer connector so that it contains only relevant fields.
+  This affects the creation of GCP PubSub Producer connectors via HOCON configuration (`connectors.gcp_pubsub_producer.*.resource_opts`) and the HTTP APIs `POST /connectors` / `PUT /connectors/:id` for this particular connector type.
diff --git a/changes/v5.5.0.en.md b/changes/v5.5.0.en.md
new file mode 100644
index 000000000..5427c5984
--- /dev/null
+++ b/changes/v5.5.0.en.md
@@ -0,0 +1,100 @@
+# v5.5.0
+
+## Enhancements
+
+- [#12085](https://github.com/emqx/emqx/pull/12085) EMQX has been upgraded to leverage the capabilities of OTP version 26.1.2-2. NOTE: Docker images are still built with OTP 25.3.2.
+
+- [#12189](https://github.com/emqx/emqx/pull/12189) Enhanced the [ACL](../access-control/authn/jwt.md#access-control-list-optional) claim format in EMQX JWT authentication for greater versatility. The updated format now supports an array structure, aligning more closely with the file-based ACL rules.
+
+  For example:
+
+  ```json
+  [
+  {
+    "permission": "allow",
+    "action": "pub",
+    "topic": "${username}/#",
+    "qos": [0, 1],
+    "retain": true
+  },
+  {
+    "permission": "allow",
+    "action": "sub",
+    "topic": "eq ${username}/#",
+    "qos": [0, 1]
+  },
+  {
+    "permission": "deny",
+    "action": "all",
+    "topics": ["#"]
+  }
+  ]
+  ```
+
+  In this new format, the absence of a matching rule does not result in an automatic denial of the action. The authorization chain can advance to other configured authorizers if a match is not found in the JWT ACL. If no match is found throughout the chain, the final decision defers to the default permission set in `authorization.no_match`.
+
+- [#12267](https://github.com/emqx/emqx/pull/12267) Added a new `timeout` parameter to the `cluster/:node/invite` interface, addressing the issue of default timeouts. 
+  The previously set 5-second default timeout often led to HTTP API call timeouts because joining an EMQX cluster usually requires more time.
+
+  In addition, EMQX added a new API `/cluster/:node/invite_async` to support an asynchronous way to invite nodes to join the cluster and introduced a new `cluster/invitation` API to inspect the join status.
+
+- [#12272](https://github.com/emqx/emqx/pull/12272) Introduced updates to the `retain` API in EMQX:
+
+  - Added a new API `DELETE /retainer/messages` to clean all retained messages.
+  - Added an optional topic filter parameter `topic` in the query string for the API `GET /retainer/messages`. For example, using a query string `topic=t/1` filters the retained messages for a specific topic, improving the efficiency of message retrieval.
+
+- [#12277](https://github.com/emqx/emqx/pull/12277) Added `mqtt/delayed/messages/:topic` API to remove delayed messages by topic name.
+
+- [#12278](https://github.com/emqx/emqx/pull/12278) Adjusted the maximum pagination size for paginated APIs in the REST API from `3000` to `10000`.
+
+- [#12289](https://github.com/emqx/emqx/pull/12289) Authorization caching now supports the exclusion of specific topics. For the specified list of topics and topic filters, EMQX will not generate an authorization cache. The list can be set through the `authorization.cache.excludes` configuration item or via the Dashboard. For these specific topics, permission checks will always be conducted in real-time rather than relying on previous cache results, thus ensuring the timeliness of authorization outcomes.
+
+- [#12329](https://github.com/emqx/emqx/pull/12329) Added `broker.routing.batch_sync` configuration item to enable a dedicated process pool that synchronizes subscriptions with the global routing table in batches, thus reducing the frequency of cross-node communication that can be slowed down by network latency. Processing multiple subscription updates collectively, not only accelerates synchronization between replica nodes and core nodes in a cluster but also reduces the load on the broker pool, minimizing the risk of overloading.
+
+- [#12333](https://github.com/emqx/emqx/pull/12333) Added a `tags` field for actions and connectors. Similar to the `description` field (which is a free text annotation), `tags` can be used to annotate actions and connectors for filtering and grouping.
+
+- [#12299](https://github.com/emqx/emqx/pull/12299) Exposed more metrics to improve observability:
+
+  Montior API:
+  - Added `retained_msg_count` field to `/api/v5/monitor_current`.
+  - Added `license_quota` field to `/api/v5/monitor_current`
+  - Added `retained_msg_count` and `node_uptime` fields to `/api/v5/monitor_current/nodes/{node}`.
+  - Added `retained_msg_count`, `license_quota` and `node_uptime` fields to `/api/v5/monitor_current/nodes/{node}`.
+
+  Prometheus API:
+  - Added `emqx_cert_expiry_at` and `emqx_license_expiry_at` to `/api/v5/prometheus/stats` to display TLS listener certificate expiration time and license expiration time.
+  - Added `/api/v5/prometheus/auth` endpoint to provide metrics such as execution count and running status for all authenticatiors and authorizators.
+  - Added `/api/v5/prometheus/data_integration` endpoint to provide metrics such as execution count and status for all rules, actions, and connectors.
+
+  Limitations:
+  Prometheus push gateway only supports the content in `/api/v5/prometheus/stats?mode=node`.
+
+  For more API details and metric type information, please see swagger api docs.
+
+- [#12196](https://github.com/emqx/emqx/pull/12196) Improved network efficiency during routes cleanup.
+
+  Previously, when a node was down, a delete operation for each route to that node must be exchanged between all the other live nodes. After this change, only one `match and delete` operation is exchanged between all live nodes, significantly reducing the number of necessary network packets and decreasing the load on the inter-cluster network.
+  This optimization must be especially helpful for geo-distributed EMQX deployments where network latency can be significantly high.
+
+- [#12354](https://github.com/emqx/emqx/pull/12354) The concurrent creation and updates of data integrations are now supported, significantly increasing operation speeds, such as when importing backup files.
+
+
+## Bug Fixes
+
+- [#12232](https://github.com/emqx/emqx/pull/12232) Fixed an issue when cluster commit log table was not deleted after a node was forced to leave a cluster.
+
+- [#12243](https://github.com/emqx/emqx/pull/12243) Fixed a family of subtle race conditions that could lead to inconsistencies in the global routing state.
+
+- [#12269](https://github.com/emqx/emqx/pull/12269) Improved error handling in the `/clients` interface; now returns a 400 status with more detailed error messages, instead of a generic 500, for query string validation failures.
+
+- [#12285](https://github.com/emqx/emqx/pull/12285) Updated the CoAP gateway to support short parameter names for slight savings in datagram size. For example, `clientid=bar` can be written as `c=bar`.
+
+- [#12303](https://github.com/emqx/emqx/pull/12303) Fixed the message indexing in retainer. Previously, clients with wildcard subscriptions might receive irrelevant retained messages not matching their subscription topics.
+
+- [#12305](https://github.com/emqx/emqx/pull/12305) Corrected an issue with incomplete client/connection information being passed into `emqx_cm`, which could lead to internal inconsistencies and affect memory usage and operations like node evacuation.
+
+- [#12306](https://github.com/emqx/emqx/pull/12306) Fixed an issue preventing the connectivity test for the Connector from functioning correctly after updating the password parameter via the HTTP API.
+
+- [#12359](https://github.com/emqx/emqx/pull/12359) Fixed an issue causing error messages when restarting a node configured with some types of data bridges.  Additionally, these bridges were at risk of entering a failed state upon node restart, requiring a manual restart to restore functionality.
+
+- [#12404](https://github.com/emqx/emqx/pull/12404) Fixed an issue where restarting a data integration with heavy message flow could lead to a stop in the collection of data integration metrics. 
diff --git a/deploy/charts/emqx-enterprise/Chart.yaml b/deploy/charts/emqx-enterprise/Chart.yaml
index 3610a815a..b870d1123 100644
--- a/deploy/charts/emqx-enterprise/Chart.yaml
+++ b/deploy/charts/emqx-enterprise/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0-rc.2
+version: 5.5.0
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0-rc.2
+appVersion: 5.5.0
diff --git a/deploy/charts/emqx/Chart.yaml b/deploy/charts/emqx/Chart.yaml
index 679456299..41f0b37b6 100644
--- a/deploy/charts/emqx/Chart.yaml
+++ b/deploy/charts/emqx/Chart.yaml
@@ -14,8 +14,8 @@ type: application
 
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
-version: 5.5.0-rc.2
+version: 5.5.0
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application.
-appVersion: 5.5.0-rc.2
+appVersion: 5.5.0
diff --git a/scripts/rel/cut.sh b/scripts/rel/cut.sh
index 136f8c466..bb6c04da4 100755
--- a/scripts/rel/cut.sh
+++ b/scripts/rel/cut.sh
@@ -233,7 +233,7 @@ check_bpapi() {
     case "$TAG" in
         *.0)
             fname="$(echo "$TAG" | sed 's/^e//; s/\.0$//')"
-            fpath="apps/emqx/test/emqx_static_checks_data/${fname}.bpapi"
+            fpath="apps/emqx/test/emqx_static_checks_data/${fname}.bpapi2"
             logmsg "Checking $fpath"
             if [ ! -f "$fpath" ]; then
                 logerr "BPAPI file missing: $fpath"

From 54fda5869876c9a743d20f075c457a30cc23e1d7 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Thu, 1 Feb 2024 16:34:12 +0100
Subject: [PATCH 146/273] ci: use v3 artifacts actions in build packages

---
 .github/workflows/build_packages.yaml | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index b48e47cd0..31f39d551 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -95,13 +95,12 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32 # v3.1.3
       if: success()
       with:
-        name: ${{ matrix.profile }}-${{ matrix.otp }}-${{ matrix.os }}
+        name: ${{ matrix.profile }}
         path: _packages/${{ matrix.profile }}/
         retention-days: 7
-        compression-level: 0
 
   linux:
     runs-on: [self-hosted, ephemeral, linux, "${{ matrix.arch }}"]
@@ -139,7 +138,7 @@ jobs:
         with_elixir:
           - 'no'
         include:
-          - profile: emqx
+          - profile: ${{ inputs.profile }}
             otp: ${{ inputs.otp_vsn }}
             arch: x64
             os: ubuntu22.04
@@ -195,7 +194,7 @@ jobs:
         fi
     - uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32 # v3.1.3
       with:
-        name: ${{ matrix.profile }}-${{ matrix.otp }}-${{ matrix.arch }}-${{ matrix.os }}-${{ matrix.with_elixir == 'yes' && 'elixir' || 'erlang' }}
+        name: ${{ matrix.profile }}
         path: _packages/${{ matrix.profile }}/
         retention-days: 7
 
@@ -211,11 +210,10 @@ jobs:
         profile:
           - ${{ inputs.profile }}
     steps:
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@9bc31d5ccc31df68ecc42ccf4149144866c47d8a # v3.0.2
       with:
-        pattern: ${{ matrix.profile }}-*
+        name: ${{ matrix.profile }}
         path: packages/${{ matrix.profile }}
-        merge-multiple: true
     - name: install dos2unix
       run: sudo apt-get update -y && sudo apt install -y dos2unix
     - name: get packages
@@ -236,6 +234,9 @@ jobs:
     - name: upload to aws s3
       env:
         PROFILE: ${{ matrix.profile }}
+        REF_NAME: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.ref || github.ref_name }}
+        AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
+        AWS_CLOUDFRONT_ID: ${{ secrets.AWS_CLOUDFRONT_ID }}
       run: |
         set -eu
         if [ $PROFILE = 'emqx' ]; then
@@ -246,5 +247,5 @@ jobs:
             echo "unknown profile $PROFILE"
             exit 1
         fi
-        aws s3 cp --recursive packages/$PROFILE s3://${{ secrets.AWS_S3_BUCKET }}/$s3dir/${{ github.ref_name }}
-        aws cloudfront create-invalidation --distribution-id ${{ secrets.AWS_CLOUDFRONT_ID }} --paths "/$s3dir/${{ github.ref_name }}/*"
+        aws s3 cp --recursive packages/$PROFILE s3://$AWS_S3_BUCKET/$s3dir/$REF_NAME
+        aws cloudfront create-invalidation --distribution-id "$AWS_CLOUDFRONT_ID" --paths "/$s3dir/$REF_NAME/*"

From 4a4f96d4b58cc9d9ae1cb981f46e0e3ecb074de7 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Fri, 2 Feb 2024 07:23:10 +0100
Subject: [PATCH 147/273] ci: scorecard workflow can only run on master branch

---
 .github/workflows/scorecard.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/scorecard.yaml b/.github/workflows/scorecard.yaml
index aabe4e5b0..7e307b6bf 100644
--- a/.github/workflows/scorecard.yaml
+++ b/.github/workflows/scorecard.yaml
@@ -10,7 +10,6 @@ on:
   push:
     branches:
       - master
-      - 'release-5[0-9]'
   workflow_dispatch:
 
 permissions: read-all

From f0569d8ae831d97a1f5f3b80ff2a183e94d915f6 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Thu, 1 Feb 2024 20:54:03 +0100
Subject: [PATCH 148/273] refactor: use mria:async_dirty to group dirty ops

---
 apps/emqx/include/emqx_cm.hrl                 |  2 +-
 apps/emqx/src/emqx_cm_registry.erl            | 52 ++++++++++++-------
 apps/emqx/src/emqx_cm_registry_keeper.erl     |  6 +--
 .../test/emqx_cm_registry_keeper_SUITE.erl    |  2 +-
 .../src/emqx_mgmt_api_clients.erl             |  4 +-
 rel/i18n/emqx_schema.hocon                    |  4 +-
 6 files changed, 43 insertions(+), 27 deletions(-)

diff --git a/apps/emqx/include/emqx_cm.hrl b/apps/emqx/include/emqx_cm.hrl
index d1d195921..a84a06688 100644
--- a/apps/emqx/include/emqx_cm.hrl
+++ b/apps/emqx/include/emqx_cm.hrl
@@ -23,7 +23,7 @@
 -define(CHAN_INFO_TAB, emqx_channel_info).
 -define(CHAN_LIVE_TAB, emqx_channel_live).
 
-%% Mria table for session registraition.
+%% Mria table for session registration.
 -define(CHAN_REG_TAB, emqx_channel_registry).
 
 -define(T_KICK, 5_000).
diff --git a/apps/emqx/src/emqx_cm_registry.erl b/apps/emqx/src/emqx_cm_registry.erl
index 4556bce0e..683afcb86 100644
--- a/apps/emqx/src/emqx_cm_registry.erl
+++ b/apps/emqx/src/emqx_cm_registry.erl
@@ -25,7 +25,9 @@
 
 -export([
     register_channel/1,
-    unregister_channel/1
+    register_channel2/1,
+    unregister_channel/1,
+    unregister_channel2/1
 ]).
 
 -export([lookup_channels/1]).
@@ -80,14 +82,21 @@ is_hist_enabled() ->
 register_channel(ClientId) when is_binary(ClientId) ->
     register_channel({ClientId, self()});
 register_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid) ->
+    IsHistEnabled = is_hist_enabled(),
     case is_enabled() of
+        true when IsHistEnabled ->
+            mria:async_dirty(?CM_SHARD, fun ?MODULE:register_channel2/1, [record(ClientId, ChanPid)]);
         true ->
-            ok = when_hist_enabled(fun() -> delete_hist_d(ClientId) end),
             mria:dirty_write(?CHAN_REG_TAB, record(ClientId, ChanPid));
         false ->
             ok
     end.
 
+%% @private
+register_channel2(#channel{chid = ClientId} = Record) ->
+    _ = delete_hist_d(ClientId),
+    mria:dirty_write(?CHAN_REG_TAB, Record).
+
 %% @doc Unregister a global channel.
 -spec unregister_channel(
     emqx_types:clientid()
@@ -96,15 +105,23 @@ register_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid)
 unregister_channel(ClientId) when is_binary(ClientId) ->
     unregister_channel({ClientId, self()});
 unregister_channel({ClientId, ChanPid}) when is_binary(ClientId), is_pid(ChanPid) ->
+    IsHistEnabled = is_hist_enabled(),
     case is_enabled() of
+        true when IsHistEnabled ->
+            mria:async_dirty(?CM_SHARD, fun ?MODULE:unregister_channel2/1, [
+                record(ClientId, ChanPid)
+            ]);
         true ->
-            mria:dirty_delete_object(?CHAN_REG_TAB, record(ClientId, ChanPid)),
-            %% insert unregistration history after unregstration
-            ok = when_hist_enabled(fun() -> insert_hist_d(ClientId) end);
+            mria:dirty_delete_object(?CHAN_REG_TAB, record(ClientId, ChanPid));
         false ->
             ok
     end.
 
+%% @private
+unregister_channel2(#channel{chid = ClientId} = Record) ->
+    mria:dirty_delete_object(?CHAN_REG_TAB, Record),
+    ok = insert_hist_d(ClientId).
+
 %% @doc Lookup the global channels.
 -spec lookup_channels(emqx_types:clientid()) -> list(pid()).
 lookup_channels(ClientId) ->
@@ -205,24 +222,23 @@ do_cleanup_channels(Node) ->
             _Return = ['$_']
         }
     ],
-    lists:foreach(fun delete_channel/1, mnesia:select(?CHAN_REG_TAB, Pat, write)).
+    IsHistEnabled = is_hist_enabled(),
+    lists:foreach(
+        fun(Chan) -> delete_channel(IsHistEnabled, Chan) end,
+        mnesia:select(?CHAN_REG_TAB, Pat, write)
+    ).
 
-delete_channel(Chan) ->
+delete_channel(IsHistEnabled, Chan) ->
     mnesia:delete_object(?CHAN_REG_TAB, Chan, write),
-    ok = when_hist_enabled(fun() -> insert_hist_t(Chan#channel.chid) end).
+    case IsHistEnabled of
+        true ->
+            insert_hist_t(Chan#channel.chid);
+        false ->
+            ok
+    end.
 
 %%--------------------------------------------------------------------
 %% History entry operations
-%%--------------------------------------------------------------------
-
-when_hist_enabled(F) ->
-    case is_hist_enabled() of
-        true ->
-            _ = F();
-        false ->
-            ok
-    end,
-    ok.
 
 %% Insert unregistration history in a transaction when unregistering the last channel for a clientid.
 insert_hist_t(ClientId) ->
diff --git a/apps/emqx/src/emqx_cm_registry_keeper.erl b/apps/emqx/src/emqx_cm_registry_keeper.erl
index 1087932df..e96fcdd7d 100644
--- a/apps/emqx/src/emqx_cm_registry_keeper.erl
+++ b/apps/emqx/src/emqx_cm_registry_keeper.erl
@@ -113,7 +113,7 @@ handle_info(start, #{next_clientid := NextClientId} = State) ->
                 end,
             {noreply, State#{next_clientid := NewNext}};
         false ->
-            %% if not enabled, dealy and check again
+            %% if not enabled, delay and check again
             %% because it might be enabled from online config change while waiting
             ok = send_delay_start(),
             {noreply, State}
@@ -142,7 +142,7 @@ cleanup_loop('$end_of_table', _Count, _IsExpired) ->
 cleanup_loop(undefined, Count, IsExpired) ->
     cleanup_loop(mnesia:dirty_first(?CHAN_REG_TAB), Count, IsExpired);
 cleanup_loop(ClientId, Count, IsExpired) ->
-    Recods = mnesia:dirty_read(?CHAN_REG_TAB, ClientId),
+    Records = mnesia:dirty_read(?CHAN_REG_TAB, ClientId),
     Next = mnesia:dirty_next(?CHAN_REG_TAB, ClientId),
     lists:foreach(
         fun(R) ->
@@ -153,7 +153,7 @@ cleanup_loop(ClientId, Count, IsExpired) ->
                     ok
             end
         end,
-        Recods
+        Records
     ),
     cleanup_loop(Next, Count - 1, IsExpired).
 
diff --git a/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl b/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl
index 3dcded1c3..f3899fb3a 100644
--- a/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl
+++ b/apps/emqx/test/emqx_cm_registry_keeper_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2019-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
diff --git a/apps/emqx_management/src/emqx_mgmt_api_clients.erl b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
index 935c690fe..8965f4633 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_clients.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
@@ -401,7 +401,7 @@ schema("/sessions_count") ->
                         required => false,
                         default => 0,
                         desc =>
-                            <<"Include sessions expired after this time (UNIX Epoch in seconds precesion)">>,
+                            <<"Include sessions expired after this time (UNIX Epoch in seconds precision)">>,
                         example => 1705391625
                     })}
             ],
@@ -1087,6 +1087,6 @@ client_example() ->
     }.
 
 sessions_count(get, #{query_string := QString}) ->
-    Since = maps:get(<<"since">>, QString, undefined),
+    Since = maps:get(<<"since">>, QString, 0),
     Count = emqx_cm_registry_keeper:count(Since),
     {200, integer_to_binary(Count)}.
diff --git a/rel/i18n/emqx_schema.hocon b/rel/i18n/emqx_schema.hocon
index 4c9f1b83e..a53104c0c 100644
--- a/rel/i18n/emqx_schema.hocon
+++ b/rel/i18n/emqx_schema.hocon
@@ -1422,7 +1422,7 @@ force_shutdown_enable.label:
 broker_enable_session_registry.desc:
 """The Global Session Registry is a cluster-wide mechanism designed to maintain the uniqueness of client IDs within the cluster.
 Recommendations for Use<br/>
-- Default Setting: It is generally advisable to enable. This feature is crucial for session takeover to work properly. For example if a client reconneted to another node in the cluster, the new connection will need to find the old session and take it over.
+- Default Setting: It is generally advisable to enable. This feature is crucial for session takeover to work properly. For example if a client reconnected to another node in the cluster, the new connection will need to find the old session and take it over.
 - Disabling the Feature: Disabling is an option for scenarios when all sessions expire immediately after client is disconnected (i.e. session expiry interval is zero). This can be relevant in certain specialized use cases.
 
 Advantages of Disabling<br/>
@@ -1433,7 +1433,7 @@ broker_session_history_retain.desc:
 """The duration to retain the session registration history. Setting this to a value greater than `0s` will increase memory usage and impact peformance.
 This retained history can be used to monitor how many sessions were registered in the past configured duration.
 Note: This config has no effect if `enable_session_registry` is set to `false`.<br/>
-Note: If the clients are suing random client IDs, it's not recommended to enable this feature, at least not for a long retain duration.<br/>
+Note: If the clients are using random client IDs, it's not recommended to enable this feature, at least not for a long retention period.<br/>
 Note: When clustered, the lowest (but greater than `0s`) value among the nodes in the cluster will take effect."""
 
 overload_protection_backoff_delay.desc:

From 3d2ac97c61974eb8a717aebc9add4140076b62de Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 2 Feb 2024 09:50:16 +0100
Subject: [PATCH 149/273] feat(ds): Add a CLI interface to inspect status of DS
 databases

---
 .../src/emqx_ds_replication_layer_meta.erl    | 17 ++++++++++----
 apps/emqx_management/src/emqx_mgmt_cli.erl    | 23 +++++++++++++++++--
 2 files changed, 34 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
index 0b689a116..597c8bc0d 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_meta.erl
@@ -127,15 +127,24 @@ print_status() ->
         end,
         eval_qlc(mnesia:table(?NODE_TAB))
     ),
-    io:format("~nSHARDS~n", []),
+    io:format(
+        "~nSHARDS:~nId                             Leader                            Status~n", []
+    ),
     lists:foreach(
         fun(#?SHARD_TAB{shard = {DB, Shard}, leader = Leader}) ->
+            ShardStr = string:pad(io_lib:format("~p/~s", [DB, Shard]), 30),
+            LeaderStr = string:pad(atom_to_list(Leader), 33),
             Status =
                 case lists:member(Leader, Nodes) of
-                    true -> up;
-                    false -> down
+                    true ->
+                        case node() of
+                            Leader -> "up *";
+                            _ -> "up"
+                        end;
+                    false ->
+                        "down"
                 end,
-            io:format("~p/~s    ~p    ~p~n", [DB, Shard, Leader, Status])
+            io:format("~s ~s ~s~n", [ShardStr, LeaderStr, Status])
         end,
         eval_qlc(mnesia:table(?SHARD_TAB))
     ).
diff --git a/apps/emqx_management/src/emqx_mgmt_cli.erl b/apps/emqx_management/src/emqx_mgmt_cli.erl
index 856466666..ddbc60d5c 100644
--- a/apps/emqx_management/src/emqx_mgmt_cli.erl
+++ b/apps/emqx_management/src/emqx_mgmt_cli.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -43,7 +43,8 @@
     authz/1,
     pem_cache/1,
     olp/1,
-    data/1
+    data/1,
+    ds/1
 ]).
 
 -spec load() -> ok.
@@ -796,6 +797,24 @@ data(_) ->
         {"data export", "Export data"}
     ]).
 
+%%--------------------------------------------------------------------
+%% @doc Durable storage command
+
+ds(CMD) ->
+    case emqx_persistent_message:is_persistence_enabled() of
+        true ->
+            do_ds(CMD);
+        false ->
+            emqx_ctl:usage([{"ds", "Durable storage is disabled"}])
+    end.
+
+do_ds(["info"]) ->
+    emqx_ds_replication_layer_meta:print_status();
+do_ds(_) ->
+    emqx_ctl:usage([
+        {"ds info", "Show overview of the embedded durable storage state"}
+    ]).
+
 %%--------------------------------------------------------------------
 %% Dump ETS
 %%--------------------------------------------------------------------

From 84b6d7d7204073d053534ce212587aac84fe253e Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Fri, 2 Feb 2024 10:38:50 +0100
Subject: [PATCH 150/273] fix: remove 5.5.bpapi2 file

---
 apps/emqx/test/emqx_static_checks_data/5.5.bpapi2 | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 apps/emqx/test/emqx_static_checks_data/5.5.bpapi2

diff --git a/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2 b/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
deleted file mode 100644
index 6192442f1..000000000
--- a/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
+++ /dev/null
@@ -1 +0,0 @@
-#{api => #{{emqx_node_rebalance_api,1} => #{calls => [{{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_bridge,1} => #{calls => [{{emqx_bridge_proto_v1,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_topic_metrics,1} => #{calls => [{{emqx_topic_metrics_proto_v1,reset,['Nodes','Topic']},{emqx_topic_metrics,reset,['Topic']}},{{emqx_topic_metrics_proto_v1,reset,['Nodes']},{emqx_topic_metrics,reset,[]}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes','Topic']},{emqx_topic_metrics,metrics,['Topic']}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes']},{emqx_topic_metrics,metrics,[]}}],casts => []},{emqx_license,1} => #{calls => [{{emqx_license_proto_v1,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_persistent_session_ds,1} => #{calls => [{{emqx_persistent_session_ds_proto_v1,close_all_iterators,['Nodes','DSSessionID']},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,['DSSessionID']}},{{emqx_persistent_session_ds_proto_v1,close_iterator,['Nodes','IteratorID']},{emqx_persistent_session_ds,do_ensure_iterator_closed,['IteratorID']}},{{emqx_persistent_session_ds_proto_v1,open_iterator,['Nodes','TopicFilter','StartMS','IteratorID']},{emqx_persistent_session_ds,do_open_iterator,['TopicFilter','StartMS','IteratorID']}}],casts => []},{emqx,1} => #{calls => [{{emqx_proto_v1,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v1,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v1,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v1,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v1,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v1,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v1,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v1,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v1,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_mgmt_trace,1} => #{calls => [{{emqx_mgmt_trace_proto_v1,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v1,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v1,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_license,2} => #{calls => [{{emqx_license_proto_v2,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_management,4} => #{calls => [{{emqx_management_proto_v4,kickout_clients,['Node','ClientIds']},{emqx_mgmt,do_kickout_clients,['ClientIds']}},{{emqx_management_proto_v4,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v4,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v4,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v4,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v4,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v4,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v4,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v4,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v4,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_management,1} => #{calls => [{{emqx_management_proto_v1,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v1,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v1,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v1,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v1,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v1,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v1,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v1,node_info,['Node']},{emqx_mgmt,node_info,[]}}],casts => []},{emqx_management,2} => #{calls => [{{emqx_management_proto_v2,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v2,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v2,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v2,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v2,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v2,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v2,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v2,node_info,['Node']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v2,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_bridge,4} => #{calls => [{{emqx_bridge_proto_v4,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_cm,2} => #{calls => [{{emqx_cm_proto_v2,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v2,takeover_finish,['ConnMod','ChanPid']},{emqx_cm,takeover_finish,['ConnMod','ChanPid']}},{{emqx_cm_proto_v2,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v2,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_telemetry,1} => #{calls => [{{emqx_telemetry_proto_v1,get_cluster_uuid,['Node']},{emqx_telemetry,get_cluster_uuid,[]}},{{emqx_telemetry_proto_v1,get_node_uuid,['Node']},{emqx_telemetry,get_node_uuid,[]}}],casts => []},{emqx_dashboard,1} => #{calls => [{{emqx_dashboard_proto_v1,current_rate,['Node']},{emqx_dashboard_monitor,current_rate,['Node']}},{{emqx_dashboard_proto_v1,do_sample,['Node','Latest']},{emqx_dashboard_monitor,do_sample,['Node','Latest']}}],casts => []},{emqx_node_rebalance_status,2} => #{calls => [{{emqx_node_rebalance_status_proto_v2,purge_status,['Nodes']},{emqx_node_rebalance_status,purge_status,[]}},{{emqx_node_rebalance_status_proto_v2,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v2,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v2,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_connector,1} => #{calls => [{{emqx_connector_proto_v1,start_connectors_to_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,start_connector_to_node,['Node','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,lookup_from_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_api,lookup_from_local_node,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,list_connectors_on_nodes,['Nodes']},{emqx_connector,list,[]}}],casts => []},{emqx_broker,1} => #{calls => [{{emqx_broker_proto_v1,list_subscriptions_via_topic,['Node','Topic']},{emqx_broker,subscriptions_via_topic,['Topic']}},{{emqx_broker_proto_v1,list_client_subscriptions,['Node','ClientId']},{emqx_broker,subscriptions,['ClientId']}},{{emqx_broker_proto_v1,forward,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}],casts => [{{emqx_broker_proto_v1,forward_async,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}]},{emqx_gateway_http,1} => #{calls => [{{emqx_gateway_http_proto_v1,get_cluster_status,['Nodes','GwName']},{emqx_gateway_http,gateway_status,['GwName']}}],casts => []},{emqx_bridge,6} => #{calls => [{{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,['Node','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,['Nodes','ConfRootKey','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,['ConfRootKey','ActionType','ActionName']}},{{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,['Nodes','ConfRootKey']},{emqx_bridge_v2,list,['ConfRootKey']}},{{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node_v6,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx,2} => #{calls => [{{emqx_proto_v2,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v2,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v2,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v2,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v2,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v2,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v2,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v2,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v2,are_running,['Nodes']},{emqx,is_running,[]}},{{emqx_proto_v2,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_ft_storage_fs_reader,1} => #{calls => [{{emqx_ft_storage_fs_reader_proto_v1,read,['Node','Pid','Bytes']},{emqx_ft_storage_fs_reader,read,['Pid','Bytes']}}],casts => []},{emqx_node_rebalance,1} => #{calls => [{{emqx_node_rebalance_proto_v1,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v1,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v1,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v1,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v1,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_exhook,1} => #{calls => [{{emqx_exhook_proto_v1,server_hooks_metrics,['Nodes','Name']},{emqx_exhook_mgr,server_hooks_metrics,['Name']}},{{emqx_exhook_proto_v1,server_info,['Nodes','Name']},{emqx_exhook_mgr,server_info,['Name']}},{{emqx_exhook_proto_v1,all_servers_info,['Nodes']},{emqx_exhook_mgr,all_servers_info,[]}}],casts => []},{emqx_node_rebalance_api,2} => #{calls => [{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,['Node']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,['Node','Opts']},{emqx_node_rebalance_purge,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_plugins,1} => #{calls => [{{emqx_plugins_proto_v1,get_tar,['Node','NameVsn','Timeout']},{emqx_plugins,get_tar,['NameVsn']}}],casts => []},{emqx_node_rebalance_status,1} => #{calls => [{{emqx_node_rebalance_status_proto_v1,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v1,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v1,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_conf,1} => #{calls => [{{emqx_conf_proto_v1,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v1,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}}],casts => []},{emqx_prometheus,2} => #{calls => [{{emqx_prometheus_proto_v2,raw_prom_data,['Nodes','M','F','A']},{emqx_prometheus_api,lookup_from_local_nodes,['M','F','A']}},{{emqx_prometheus_proto_v2,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v2,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_ft_storage_exporter_fs,1} => #{calls => [{{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,['Node','Filepath','CallerPid']},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,['Filepath','CallerPid']}},{{emqx_ft_storage_exporter_fs_proto_v1,list_exports,['Nodes','Query']},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,['Query']}}],casts => []},{emqx_metrics,1} => #{calls => [{{emqx_metrics_proto_v1,get_metrics,['Nodes','HandlerName','MetricId','Timeout']},{emqx_metrics_worker,get_metrics,['HandlerName','MetricId']}}],casts => []},{emqx_conf,3} => #{calls => [{{emqx_conf_proto_v3,get_hocon_config,['Node','Key']},{emqx_conf_cli,get_config,['Key']}},{{emqx_conf_proto_v3,get_hocon_config,['Node']},{emqx_conf_cli,get_config,[]}},{{emqx_conf_proto_v3,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v3,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v3,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_mgmt_cluster,2} => #{calls => [{{emqx_mgmt_cluster_proto_v2,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v2,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_retainer,2} => #{calls => [{{emqx_retainer_proto_v2,active_mnesia_indices,['Nodes']},{emqx_retainer_mnesia,active_indices,[]}},{{emqx_retainer_proto_v2,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_node_rebalance,3} => #{calls => [{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind','Options']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind','Options']}},{{emqx_node_rebalance_proto_v3,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v3,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v3,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v3,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v3,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_delayed,3} => #{calls => [{{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,['Nodes','TopicName']},{emqx_delayed,do_delete_delayed_messages_by_topic_name,['TopicName']}},{{emqx_delayed_proto_v3,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v3,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v3,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_eviction_agent,2} => #{calls => [{{emqx_eviction_agent_proto_v2,all_channels_count,['Nodes','Timeout']},{emqx_eviction_agent,all_local_channels_count,[]}},{{emqx_eviction_agent_proto_v2,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_ds,1} => #{calls => [{{emqx_ds_proto_v1,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v1,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v1,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v1,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v1,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_node_rebalance_purge,1} => #{calls => [{{emqx_node_rebalance_purge_proto_v1,stop,['Nodes']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_purge_proto_v1,start,['Nodes','Opts']},{emqx_node_rebalance_purge,start,['Opts']}}],casts => []},{emqx_gateway_api_listeners,1} => #{calls => [{{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,['Nodes','Listeners']},{emqx_gateway_api_listeners,do_listeners_cluster_status,['Listeners']}}],casts => []},{emqx_mgmt_trace,2} => #{calls => [{{emqx_mgmt_trace_proto_v2,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v2,trace_file_detail,['Nodes','File']},{emqx_trace,trace_file_detail,['File']}},{{emqx_mgmt_trace_proto_v2,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v2,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_slow_subs,1} => #{calls => [{{emqx_slow_subs_proto_v1,get_history,['Nodes']},{emqx_slow_subs_api,get_history,[]}},{{emqx_slow_subs_proto_v1,clear_history,['Nodes']},{emqx_slow_subs,clear_history,[]}}],casts => []},{emqx_mgmt_api_plugins,1} => #{calls => [{{emqx_mgmt_api_plugins_proto_v1,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v1,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,describe_package,['Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,install_package,['Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v1,get_plugins,[]},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_conf,2} => #{calls => [{{emqx_conf_proto_v2,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v2,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v2,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_ds,2} => #{calls => [{{emqx_ds_proto_v2,add_generation,['Node','DB']},{emqx_ds_replication_layer,do_add_generation_v2,['DB']}},{{emqx_ds_proto_v2,update_iterator,['Node','DB','Shard','OldIter','DSKey']},{emqx_ds_replication_layer,do_update_iterator_v2,['DB','Shard','OldIter','DSKey']}},{{emqx_ds_proto_v2,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v2,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v2,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v2,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v2,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_shared_sub,1} => #{calls => [{{emqx_shared_sub_proto_v1,dispatch_with_ack,['Pid','Group','Topic','Msg','Timeout']},{emqx_shared_sub,do_dispatch_with_ack,['Pid','Group','Topic','Msg']}}],casts => [{{emqx_shared_sub_proto_v1,send,['Node','Pid','Topic','Msg']},{erlang,send,['Pid','Msg']}}]},{emqx_ft_storage_fs,1} => #{calls => [{{emqx_ft_storage_fs_proto_v1,list_assemblers,['Nodes','Transfer']},{emqx_ft_storage_fs_proxy,lookup_local_assembler,['Transfer']}},{{emqx_ft_storage_fs_proto_v1,pread,['Node','Transfer','Frag','Offset','Size']},{emqx_ft_storage_fs_proxy,pread_local,['Transfer','Frag','Offset','Size']}},{{emqx_ft_storage_fs_proto_v1,multilist,['Nodes','Transfer','What']},{emqx_ft_storage_fs_proxy,list_local,['Transfer','What']}}],casts => []},{emqx_cm,1} => #{calls => [{{emqx_cm_proto_v1,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v1,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v1,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_authn,1} => #{calls => [{{emqx_authn_proto_v1,lookup_from_all_nodes,['Nodes','ChainName','AuthenticatorID']},{emqx_authn_api,lookup_from_local_node,['ChainName','AuthenticatorID']}}],casts => []},{emqx_resource,1} => #{calls => [{{emqx_resource_proto_v1,reset_metrics,['ResId']},{emqx_resource,reset_metrics_local,['ResId']}},{{emqx_resource_proto_v1,remove,['ResId']},{emqx_resource,remove_local,['ResId']}},{{emqx_resource_proto_v1,recreate,['ResId','ResourceType','Config','Opts']},{emqx_resource,recreate_local,['ResId','ResourceType','Config','Opts']}},{{emqx_resource_proto_v1,create_dry_run,['ResourceType','Config']},{emqx_resource,create_dry_run_local,['ResourceType','Config']}},{{emqx_resource_proto_v1,create,['ResId','Group','ResourceType','Config','Opts']},{emqx_resource,create_local,['ResId','Group','ResourceType','Config','Opts']}}],casts => []},{emqx_bridge,5} => #{calls => [{{emqx_bridge_proto_v5,v2_start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,['Nodes','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node,['ActionType','ActionName']}},{{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,['Nodes']},{emqx_bridge_v2,list,[]}},{{emqx_bridge_proto_v5,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_eviction_agent,1} => #{calls => [{{emqx_eviction_agent_proto_v1,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_authz,1} => #{calls => [{{emqx_authz_proto_v1,lookup_from_all_nodes,['Nodes','Type']},{emqx_authz_api_sources,lookup_from_local_node,['Type']}}],casts => []},{emqx_gateway_cm,1} => #{calls => [{{emqx_gateway_cm_proto_v1,cast,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_cast,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req','Timeout']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req','Timeout']}},{{emqx_gateway_cm_proto_v1,takeover_session,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_takeover_session,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,get_chann_conn_mod,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chann_conn_mod,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,kick_session,['GwName','Action','ClientId','ChanPid']},{emqx_gateway_cm,do_kick_session,['GwName','Action','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_stats,['GwName','ClientId','ChanPid','Stats']},{emqx_gateway_cm,do_set_chan_stats,['GwName','ClientId','ChanPid','Stats']}},{{emqx_gateway_cm_proto_v1,get_chan_stats,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_stats,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_info,['GwName','ClientId','ChanPid','Infos']},{emqx_gateway_cm,do_set_chan_info,['GwName','ClientId','ChanPid','Infos']}},{{emqx_gateway_cm_proto_v1,get_chan_info,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_info,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,lookup_by_clientid,['Nodes','GwName','ClientId']},{emqx_gateway_cm,do_lookup_by_clientid,['GwName','ClientId']}}],casts => []},{emqx_bridge,3} => #{calls => [{{emqx_bridge_proto_v3,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}},{{emqx_bridge_proto_v3,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_rule_engine,1} => #{calls => [{{emqx_rule_engine_proto_v1,reset_metrics,['RuleId']},{emqx_rule_engine,reset_metrics_for_rule,['RuleId']}}],casts => []},{emqx_node_rebalance_evacuation,1} => #{calls => [{{emqx_node_rebalance_evacuation_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance_evacuation,is_node_available,[]}}],casts => []},{emqx_bridge,2} => #{calls => [{{emqx_bridge_proto_v2,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_node_rebalance,2} => #{calls => [{{emqx_node_rebalance_proto_v2,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v2,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v2,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v2,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v2,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_mgmt_data_backup,1} => #{calls => [{{emqx_mgmt_data_backup_proto_v1,delete_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,delete_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,read_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,read_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,import_file,['Node','FileNode','FileName','Timeout']},{emqx_mgmt_data_backup,maybe_copy_and_import,['FileNode','FileName']}},{{emqx_mgmt_data_backup_proto_v1,list_files,['Nodes','Timeout']},{emqx_mgmt_data_backup,list_files,[]}}],casts => []},{emqx_retainer,1} => #{calls => [{{emqx_retainer_proto_v1,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_delayed,2} => #{calls => [{{emqx_delayed_proto_v2,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v2,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v2,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_mgmt_api_plugins,2} => #{calls => [{{emqx_mgmt_api_plugins_proto_v2,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v2,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,describe_package,['Nodes','Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,install_package,['Nodes','Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v2,get_plugins,['Nodes']},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_mgmt_cluster,1} => #{calls => [{{emqx_mgmt_cluster_proto_v1,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_mgmt_cluster,3} => #{calls => [{{emqx_mgmt_cluster_proto_v3,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v3,invite_node,['Node','Self','Timeout']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_prometheus,1} => #{calls => [{{emqx_prometheus_proto_v1,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v1,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_delayed,1} => #{calls => [{{emqx_delayed_proto_v1,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v1,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_management,3} => #{calls => [{{emqx_management_proto_v3,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v3,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v3,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v3,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v3,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v3,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v3,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v3,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v3,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []}},release => "master",signatures => #{{emqx_retainer_proto_v1,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proxy,pread_local,4} => {any,[any,any,any,any]},{emqx_bridge_proto_v2,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v2,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_shared_sub_proto_v1,dispatch_with_ack,5} => {any,[{c,identifier,[pid],unknown},{c,union,[{c,atom,['_'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_monitor,current_rate,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[badrpc],unknown},any],{2,{c,atom,[badrpc],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown}]},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,1} => {any,[any]},{emqx_management_proto_v3,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,list_connectors_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_lookup_by_clientid,2} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,none],unknown},any]},{emqx_persistent_session_ds,do_open_iterator,3} => {{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_implemented],unknown}],{2,{c,atom,[error],unknown}}},[any,any,any]},{emqx_cm,do_get_chann_conn_mod,2} => {any,[any,any]},{emqx_persistent_session_ds_proto_v1,close_iterator,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup,read_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_resource,create_local,5} => {{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}},[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_authz_api_sources,lookup_from_local_node,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_management_proto_v3,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ft_storage_exporter_fs_proto_v1,list_exports,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[following],unknown},optional,any},{{c,atom,[limit],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[transfer],unknown},optional,{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}}],none,none},unknown}]},{emqx,get_config,1} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_resource_proto_v1,remove,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_management_proto_v2,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_broker_proto_v1,list_client_subscriptions,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_resource_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_delayed,clear_all_local,0} => {{c,atom,[ok],unknown},[]},{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx,reset_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any]},{emqx_mgmt_api_plugins,delete_package,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,list_files,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,import_file,4} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_retainer_mnesia,active_indices,0} => {{c,tuple,[any,any],{2,any}},[]},{emqx_cm,do_get_chan_stats,2} => {any,[any,any]},{emqx_node_rebalance_proto_v3,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_listeners,do_list_listeners,0} => {{c,map,{[],{c,binary,{40,32},unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},unknown},[]},{emqx_conf_app,get_override_config_file,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[msg],unknown},mandatory,any},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[release],unknown},mandatory,{c,list,{any,{c,nil,[],unknown}},nonempty}},{{c,atom,[wall_clock],unknown},mandatory,{c,tuple,[any,any],{2,any}}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_ds_replication_layer,do_make_iterator_v1,5} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_authz_proto_v1,lookup_from_all_nodes,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_ft_storage_fs_reader_proto_v1,read,3} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_slow_subs,clear_history,0} => {any,[]},{emqx_proto_v1,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_cm,do_kick_session,3} => {{c,atom,[ok],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,get_chann_conn_mod,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_eviction_agent_proto_v2,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_mgmt_api_plugins_proto_v1,install_package,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v1,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_v2_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v1,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,reset,1} => {any,[any]},{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v5,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed,delete_delayed_message,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v6,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_conf_proto_v2,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v1,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_mgr,server_info,1} => {any,[any]},{emqx_management_proto_v2,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_management_proto_v4,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_cm_proto_v1,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_dashboard_proto_v1,do_sample,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v2,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{ssl_pem_cache,clear,0} => {any,[]},{emqx_mgmt_api_plugins,ensure_action,2} => {{c,atom,[ok],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_conf_proto_v3,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_resource_proto_v1,recreate,4} => {any,[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_conf_proto_v3,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_api_listeners,do_listeners_cluster_status,1} => {{c,map,{[],any,any},unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node_v6,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry_proto_v1,get_cluster_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v1,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_resource,create_dry_run_local,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},any]},{emqx_gateway_cm,do_set_chan_info,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_api_cluster,connected_replicants,0} => {{c,list,{{c,tuple,[{c,atom,any,unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown}],{3,any}},{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_list_subscriptions,0} => {none,[]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_v2,list,1} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,rebalance_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,evacuation_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[current_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[migrate_to],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_mgmt_trace_proto_v2,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,set_chan_stats,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx,get_config,2} => {any,[any,any]},{emqx_proto_v2,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_topic_metrics,metrics,0} => {{c,list,{{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_node_rebalance_agent,enable,3} => {any,[any,any,any]},{emqx_ft_storage_fs_proto_v1,pread,5} => {any,[{c,atom,any,unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,map,{[{{c,atom,[fragment],unknown},mandatory,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[filemeta],unknown},{c,map,{[{{c,atom,[checksum],unknown},optional,{c,tuple,[{c,atom,any,unknown},{c,binary,{8,0},unknown}],{2,any}}},{{c,atom,[expire_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[name],unknown},mandatory,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown}},{{c,atom,[segments_ttl],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[user_data],unknown},optional,{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[filemeta],unknown}}},{c,tuple,[{c,atom,[segment],unknown},{c,map,{[{{c,atom,[offset],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[segment],unknown}}}]}],unknown}},{{c,atom,[path],unknown},mandatory,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[timestamp],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,2} => {any,[any,any]},{emqx_trace,trace_file,1} => {{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_topic_metrics,reset,0} => {any,[]},{emqx_conf_proto_v1,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm_proto_v1,takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_cm_proto_v1,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_topic_metrics_proto_v1,reset,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins,get_plugins,0} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v3,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_proto_v1,all_servers_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v1,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_management_proto_v1,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v3,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_prometheus_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry,get_cluster_uuid,0} => {any,[]},{emqx_proto_v1,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_status,purge_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[purge_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_resource_proto_v1,create_dry_run,2} => {any,[{c,atom,any,unknown},any]},{emqx_mgmt_data_backup,delete_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_rule_engine_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_mgmt_data_backup,list_files,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_proto_v1,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_topic_metrics_proto_v1,metrics,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v1,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins,describe_package,1} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_proto_v1,current_rate,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,set_chan_info,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,map,{[],{c,atom,any,unknown},any},unknown}]},{emqx_node_rebalance_proto_v2,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_set_chan_stats,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_trace_proto_v2,trace_file_detail,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v1,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,start_connector_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_v2,list,0} => {any,[]},{emqx_node_rebalance_proto_v2,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v2,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_slow_subs_proto_v1,clear_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed,get_delayed_message,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[delayed_interval],unknown},mandatory,any},{{c,atom,[delayed_remaining],unknown},mandatory,{c,number,any,integer}},{{c,atom,[expected_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[from_clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[from_username],unknown},mandatory,any},{{c,atom,[msgid],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[node],unknown},mandatory,any},{{c,atom,[payload],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[publish_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[qos],unknown},mandatory,any},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,do_unsubscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple,[any,any,any],{3,any}},none,none],unknown},{c,map,{[],any,any},unknown}],{2,any}},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_api_plugins_proto_v2,install_package,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_gateway_cm,do_call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,any]},{emqx_mgmt,do_call_client,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_cm_proto_v2,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_ds_replication_layer,do_drop_db_v1,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_eviction_agent,all_local_channels_count,0} => {any,[]},{emqx_bridge_proto_v4,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_cluster_proto_v3,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v1,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_persistent_session_ds_proto_v1,open_iterator,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},any]},{emqx_cm_proto_v2,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_evacuation_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_cluster_proto_v1,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ds_proto_v2,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_bridge_proto_v3,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,evict_sessions,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown},any]},{emqx_gateway_http,gateway_status,1} => {{c,map,{[{{c,atom,[current_connections],unknown},optional,any},{{c,atom,[max_connections],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[running,stopped,unloaded],unknown}}],none,none},unknown},[{c,atom,any,unknown}]},{emqx_bridge_proto_v4,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,read_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_cm_proto_v1,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_delayed_proto_v3,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_conf_proto_v1,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,reset,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v5,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_store_batch_v1,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],any,any},unknown},{c,map,{[],any,any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],any,any},unknown},{c,map,{[],none,none},unknown}]},{emqx_management_proto_v1,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_set,"_defknotuy"},integer},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[error],unknown}}},none,{c,map,{[],any,any},unknown}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_trace,trace_file_detail,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[file],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[reason],unknown},mandatory,{c,atom,any,unknown}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[mtime],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},{c,tuple,[{c,tuple,[any,any,any],{3,any}},{c,tuple,[any,any,any],{3,any}}],{2,any}},none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[size],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,4} => {any,[{c,atom,any,unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_trace,get_trace_size,0} => {{c,map,{[],any,any},unknown},[]},{emqx_prometheus_proto_v1,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_retainer_proto_v2,active_mnesia_indices,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_stats,getstats,0} => {{c,list,{{c,tuple,any,{any,any}},{c,nil,[],unknown}},unknown},[]},{emqx_alarm,deactivate,1} => {any,[any]},{emqx_conf_proto_v2,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_resources,local_connection_count,0} => {any,[]},{emqx_bridge_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_persistent_session_ds_proto_v1,close_all_iterators,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v2,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_management_proto_v3,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v2,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_broker_proto_v1,forward,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_node_rebalance_proto_v1,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_exhook_proto_v1,server_hooks_metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_prometheus_api,lookup_from_local_nodes,3} => {any,[{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_eviction_agent_proto_v2,all_channels_count,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_cm_proto_v1,call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_prometheus_proto_v2,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v4,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v3,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_http_proto_v1,get_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,raw_prom_data,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx,update_config,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_v2,start,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_alarm,delete_all_deactivated_alarms,0} => {any,[]},{emqx_management_proto_v3,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_api_cluster,join,1} => {{c,union,[{c,atom,[ignore,ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown}]},{emqx_cm_proto_v2,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v3,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_broker_proto_v1,forward_async,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,2} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_connector,list,0} => {any,[]},{emqx_cm_proto_v2,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_mgmt_api_plugins_proto_v1,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_prometheus,do_stop,0} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,restarting,running,simple_one_for_one],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[]},{emqx_exhook_mgr,server_hooks_metrics,1} => {any,[any]},{emqx_ds_proto_v2,update_iterator,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v1,describe_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v4,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{erlang,send,2} => {any,[any,any]},{emqx_metrics_worker,get_metrics,2} => {{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_purge_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_configs,get_full_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_fs_proxy,list_local,2} => {any,[any,any]},{emqx_ft_storage_fs_reader,read,2} => {any,[{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_node_rebalance_status_proto_v2,purge_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_delayed_proto_v1,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_proto_v1,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_gateway_cm,do_kick_session,4} => {{c,atom,[ok],unknown},[{c,atom,any,unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_get_chann_conn_mod,3} => {any,[any,any,any]},{emqx_mgmt_cluster_proto_v3,invite_node,3} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown}]},{emqx_authn_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_authz_cache,drain_cache,0} => {{c,atom,[ok],unknown},[]},{emqx_ds_proto_v1,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_proto_v2,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup_proto_v1,delete_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_gateway_cm,do_get_chan_info,3} => {{c,union,[{c,atom,[undefined],unknown},none,none,none,none,none,none,none,{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}}],any,any},unknown}],unknown},[any,any,any]},{emqx_retainer_dispatcher,wait_dispatch_complete,1} => {{c,atom,[ok],unknown},[any]},{emqx_resource,remove_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_shared_sub,do_dispatch_with_ack,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid,port],unknown},any,any,{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}]},{emqx_node_rebalance_status,local_status,0} => {{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[evacuation],unknown},any],{2,{c,atom,[evacuation],unknown}}},{c,tuple,[{c,atom,[purge],unknown},any],{2,{c,atom,[purge],unknown}}},{c,tuple,[{c,atom,[rebalance],unknown},{c,map,{[],{c,atom,[connection_eviction_rate,connection_goal,coordinator_node,disconnected_session_goal,recipients,session_eviction_rate,state,stats],unknown},any},unknown}],{2,{c,atom,[rebalance],unknown}}}]}],unknown},none,none],unknown},[]},{emqx_ds_replication_layer,do_next_v1,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,atom,[end_of_stream],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any],{10,any}}],{2,any}},{c,nil,[],unknown}},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_conf_proto_v3,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v1,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_proto_v1,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_proto_v2,are_running,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm_proto_v1,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_delayed_proto_v3,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v2,describe_package,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,purge_sessions,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_slow_subs_proto_v1,get_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed_proto_v1,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_conf,get_node_and_config,1} => {{c,tuple,[{c,atom,any,unknown},any],{2,any}},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v1,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v3,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_broker,subscriptions_via_topic,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[any]},{emqx_persistent_session_ds,do_ensure_iterator_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_bridge_resource,stop,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_trace_proto_v1,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_proto_v2,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_management_proto_v2,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_telemetry_proto_v1,get_node_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_broker,subscriptions,1} => {{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}]},{emqx_slow_subs_api,get_history,0} => {{c,list,{{c,map,{[{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[last_update_time],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[timespan],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_gateway_cm_proto_v1,lookup_by_clientid,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_get_streams_v1,4} => {{c,list,{{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,any}},{c,nil,[],unknown}},unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_plugins,get_tar,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown}]},{emqx_conf_proto_v1,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_connector_proto_v1,start_connectors_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_prometheus,do_start,0} => {{c,atom,[ok],unknown},[]},{emqx_gateway_cm_proto_v1,get_chan_stats,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_status_proto_v1,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,metrics,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[topic_not_found],unknown}],{2,{c,atom,[error],unknown}}},none,{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown}],unknown},[any]},{emqx_cm_proto_v1,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_broker_proto_v1,list_subscriptions_via_topic,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v2,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_metrics_proto_v1,get_metrics,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_management_proto_v2,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_finish,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[noproc,timeout,unexpected_exception],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,get_chan_info,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_retainer_proto_v2,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins_proto_v2,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v2,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_cm,lookup_client,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},any],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},any],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_bridge_proto_v6,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_dashboard_monitor,do_sample,2} => {any,[{c,atom,any,unknown},any]},{emqx_broker,dispatch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[no_subscribers,not_running],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,number,{int_rng,0,pos_inf},integer}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[any,any,any,any],{4,any}}]},{8,[{c,tuple,[any,any,any,any,any,any,any,any],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_gateway_cm,do_get_chan_stats,3} => {any,[any,any,any]},{emqx_bridge_proto_v4,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_cm_proto_v2,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v1,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_resource,reset_metrics_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_mgmt,do_subscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[subscribe],unknown},any],{2,{c,atom,[subscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_trace_proto_v1,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_fs_proto_v1,multilist,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,atom,[fragment,result],unknown}]},{emqx,is_running,0} => {{c,atom,[false,true],unknown},[]},{emqx_eviction_agent_proto_v1,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_resource_proto_v1,create,5} => {any,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v2,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_cm_proto_v1,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_node_rebalance_proto_v3,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_bridge_resource,restart,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_mgmt_api_plugins_proto_v1,get_plugins,0} => {any,[]},{emqx_gateway_cm,do_cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_bridge_proto_v2,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v1,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v1,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_rule_engine,reset_metrics_for_rule,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_resource,recreate_local,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,updating_to_incorrect_resource_type],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_delayed_proto_v3,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v3,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,node_info,0} => {{c,map,{[{{c,atom,[connections],unknown},mandatory,any},{{c,atom,[edition],unknown},mandatory,{c,binary,{0,80},unknown}},{{c,atom,[live_connections],unknown},mandatory,any},{{c,atom,[load1],unknown},optional,{c,number,any,float}},{{c,atom,[load15],unknown},optional,{c,number,any,float}},{{c,atom,[load5],unknown},optional,{c,number,any,float}},{{c,atom,[log_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[max_fds],unknown},mandatory,any},{{c,atom,[memory_total],unknown},mandatory,{c,number,any,unknown}},{{c,atom,[memory_used],unknown},mandatory,{c,number,any,integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[process_available],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[process_used],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[role],unknown},mandatory,{c,atom,[core,replicant],unknown}},{{c,atom,[sys_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[uptime],unknown},mandatory,any},{{c,atom,[version],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},[]},{emqx_ft_storage_fs_proxy,lookup_local_assembler,1} => {any,[any]},{emqx_cm_proto_v2,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_bridge_v1_compatible,not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,atom,[actions,sources],unknown},{c,map,{[{{c,atom,[error],unknown},mandatory,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[incomplete],unknown},{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[incomplete],unknown}}}]}],unknown},none,none],unknown}},{{c,atom,[name],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[raw_config],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[resource_data],unknown},mandatory,{c,map,{[{{c,atom,[added_channels],unknown},optional,any},{{c,atom,[callback_mode],unknown},optional,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},optional,any},{{c,atom,[error],unknown},optional,any},{{c,atom,[id],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},optional,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},optional,any},{{c,atom,[status],unknown},optional,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}},{{c,atom,[type],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_update_iterator_v2,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_evacuation,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_node_rebalance_proto_v1,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_metrics,all,0} => {{c,list,{{c,tuple,[any,{c,number,any,integer}],{2,any}},{c,nil,[],unknown}},unknown},[]},{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proto_v1,list_assemblers,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}]},{emqx_node_rebalance_agent,disable,2} => {any,[any,any]},{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authn_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v4,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v4,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v2,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_eviction_agent,evict_connections,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v3,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_purge_proto_v1,start,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_eviction_agent,evict_session_channel,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown},any],{3,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_management_proto_v1,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_agent,enable,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown},any]},{emqx_mgmt_cluster_proto_v2,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_shared_sub_proto_v1,send,4} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,binary,{8,0},unknown},any]},{emqx_mgmt,do_unsubscribe_batch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_management_proto_v4,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_purge,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_node_rebalance,disconnected_session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_bridge_proto_v2,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,takeover_finish,2} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_exhook_proto_v1,server_info,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_conf_proto_v3,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_delayed,do_delete_delayed_messages_by_topic_name,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,binary,{8,0},unknown}]},{emqx_node_rebalance_purge,stop,0} => {any,[]},{emqx_mgmt_api_trace,read_trace_file,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[eof],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}],{2,{c,atom,[eof],unknown}}},{c,tuple,[{c,atom,[error],unknown},{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,[{c,atom,[no_translation],unknown},{c,atom,[unicode],unknown},{c,atom,[latin1],unknown}],{3,{c,atom,[no_translation],unknown}}},none,none],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},any,any]},{emqx_mgmt_api_plugins_proto_v2,get_plugins,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,1} => {any,[{c,atom,any,unknown}]},{emqx_proto_v2,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_delayed_proto_v2,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,do_get_chan_info,2} => {any,[any,any]},{emqx_node_rebalance_agent,enable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_mgmt,broker_info,0} => {{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}}],any,any},unknown},[]},{emqx_telemetry,get_node_uuid,0} => {any,[]},{emqx_management_proto_v1,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v3,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup,maybe_copy_and_import,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[bardrpc],unknown},any],{2,{c,atom,[bardrpc],unknown}}},{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config_errors],unknown},mandatory,{c,map,{[],{c,list,{any,{c,nil,[],unknown}},unknown},{c,tuple,[any,any],{2,any}}},unknown}},{{c,atom,[db_errors],unknown},mandatory,{c,map,{[],{c,atom,any,unknown},{c,tuple,[any,any],{2,any}}},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v1,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,kick_session,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v5,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_replication_layer,do_add_generation_v2,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,3} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx,remove_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,add_generation,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_node_rebalance_evacuation,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_node_rebalance_agent,disable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[already_disabled,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any,{c,map,{[{{c,atom,[allow_connections],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_plugins_proto_v1,get_tar,3} => {any,[{c,atom,any,unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_api_plugins,install_package,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_bridge,list,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_kickout_clients,1} => {{c,atom,[ok],unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v6,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_cluster_proto_v2,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_conf_proto_v3,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_evacuation,stop,0} => {any,[]},{emqx_management_proto_v4,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,stop,0} => {any,[]},{emqx_bridge_proto_v4,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v1,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,kick_session,4} => {any,[{c,atom,any,unknown},{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authz_cache,drain_cache,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_session,2} => {{c,union,[{c,atom,[none,ok,undefined],unknown},none,none,none,{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown},none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[expired],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[expired],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,none,none,none,{c,list,{{c,tuple,[any,any,any],{3,any}},{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],any,any},unknown}],unknown}],{2,{c,atom,[ok],unknown}}},{c,tuple,[{c,atom,[persistent],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[persistent],unknown}}}]},{4,[{c,tuple,[{c,atom,[living],unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown},any],{4,{c,atom,[living],unknown}}}]}],unknown},none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown},[any,any]},{emqx_node_rebalance,connection_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_conf_app,sync_data_from_node,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,kickout_clients,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_alarm,get_alarms,1} => {any,[{c,atom,[activated,all,deactivated],unknown}]},{emqx_management_proto_v2,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_exhook_mgr,all_servers_info,0} => {any,[]}}}.

From 5e0c3d4051954dba5fa6909085e41028645317de Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Fri, 2 Feb 2024 12:06:47 +0200
Subject: [PATCH 151/273] feat(emqx_conf): support AAAA cluster dns record type

Ekka autocluster DNS already supports AAAA records, so it's only needed to update enum in schema.
---
 apps/emqx_conf/src/emqx_conf_schema.erl | 2 +-
 changes/ce/feat-12467.en.md             | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)
 create mode 100644 changes/ce/feat-12467.en.md

diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 01bba4117..914470ba4 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -259,7 +259,7 @@ fields(cluster_dns) ->
             )},
         {"record_type",
             sc(
-                hoconsc:enum([a, srv]),
+                hoconsc:enum([a, aaaa, srv]),
                 #{
                     default => a,
                     desc => ?DESC(cluster_dns_record_type),
diff --git a/changes/ce/feat-12467.en.md b/changes/ce/feat-12467.en.md
new file mode 100644
index 000000000..a0a05cc19
--- /dev/null
+++ b/changes/ce/feat-12467.en.md
@@ -0,0 +1 @@
+Support cluster discovery using AAAA DNS record type.

From 9360cb5b66f2669ba857d1cec7abbc05b54f6c3e Mon Sep 17 00:00:00 2001
From: Adrian Pauli <adrian.pauli@qumea.com>
Date: Fri, 2 Feb 2024 15:53:28 +0100
Subject: [PATCH 152/273] feat(helm): possibility to add `priorityClassName` in
 helm chart for the pods

---
 deploy/charts/emqx-enterprise/templates/StatefulSet.yaml | 3 +++
 deploy/charts/emqx-enterprise/values.yaml                | 3 +++
 deploy/charts/emqx/templates/StatefulSet.yaml            | 3 +++
 deploy/charts/emqx/values.yaml                           | 3 +++
 4 files changed, 12 insertions(+)

diff --git a/deploy/charts/emqx-enterprise/templates/StatefulSet.yaml b/deploy/charts/emqx-enterprise/templates/StatefulSet.yaml
index 1eba3d1ba..195bd698e 100644
--- a/deploy/charts/emqx-enterprise/templates/StatefulSet.yaml
+++ b/deploy/charts/emqx-enterprise/templates/StatefulSet.yaml
@@ -56,6 +56,9 @@ spec:
       {{- end }}
     spec:
       serviceAccountName: {{ include "emqx.serviceAccountName" . }}
+      {{- if .Values.priorityClassName }}
+      priorityClassName: {{ .Values.priorityClassName }}
+      {{- end }}
       volumes:
       {{- if .Values.ssl.enabled }}
       - name: ssl-cert
diff --git a/deploy/charts/emqx-enterprise/values.yaml b/deploy/charts/emqx-enterprise/values.yaml
index 9969f23cd..64970de9d 100644
--- a/deploy/charts/emqx-enterprise/values.yaml
+++ b/deploy/charts/emqx-enterprise/values.yaml
@@ -38,6 +38,9 @@ recreatePods: false
 ## Sets the minReadySeconds parameter on the stateful set. This can be used to add delay between restart / updates between the single pods.
 minReadySeconds:
 
+## Sets the priorityClassName parameter on the pods. This can be used to run the pods with increased priority.
+priorityClassName:
+
 clusterDomain: cluster.local
 
 podAnnotations: {}
diff --git a/deploy/charts/emqx/templates/StatefulSet.yaml b/deploy/charts/emqx/templates/StatefulSet.yaml
index 4f3e310c7..85caa4297 100644
--- a/deploy/charts/emqx/templates/StatefulSet.yaml
+++ b/deploy/charts/emqx/templates/StatefulSet.yaml
@@ -56,6 +56,9 @@ spec:
       {{- end }}
     spec:
       serviceAccountName: {{ include "emqx.serviceAccountName" . }}
+      {{- if .Values.priorityClassName }}
+      priorityClassName: {{ .Values.priorityClassName }}
+      {{- end }}
       volumes:
       {{- if .Values.ssl.enabled }}
       - name: ssl-cert
diff --git a/deploy/charts/emqx/values.yaml b/deploy/charts/emqx/values.yaml
index 2a2b91299..f87f426f3 100644
--- a/deploy/charts/emqx/values.yaml
+++ b/deploy/charts/emqx/values.yaml
@@ -38,6 +38,9 @@ recreatePods: false
 ## Sets the minReadySeconds parameter on the stateful set. This can be used to add delay between restart / updates between the single pods.
 minReadySeconds:
 
+## Sets the priorityClassName parameter on the pods. This can be used to run the pods with increased priority.
+priorityClassName:
+
 clusterDomain: cluster.local
 
 podAnnotations: {}

From 5629cf3219e2d605cf402ed991039c7f8c935a87 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 2 Feb 2024 16:59:47 +0100
Subject: [PATCH 153/273] test: fix env name in test script

---
 scripts/test/start-two-nodes-in-host.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/test/start-two-nodes-in-host.sh b/scripts/test/start-two-nodes-in-host.sh
index ffd4b6b19..d6e9715f0 100755
--- a/scripts/test/start-two-nodes-in-host.sh
+++ b/scripts/test/start-two-nodes-in-host.sh
@@ -82,7 +82,7 @@ env DEBUG="${DEBUG:-0}" \
 EMQX_NODE_NAME="emqx${index}@\$IP${index}" \
 EMQX_CLUSTER__STATIC__SEEDS="$SEEDS" \
 EMQX_CLUSTER__DISCOVERY_STRATEGY=static \
-EMQX_NODE__DB_ROLE="\$ROLE${index}" \
+EMQX_NODE__ROLE="\$ROLE${index}" \
 EMQX_LOG__FILE_HANDLERS__DEFAULT__LEVEL="${EMQX_LOG__FILE_HANDLERS__DEFAULT__LEVEL:-debug}" \
 EMQX_LOG__FILE_HANDLERS__DEFAULT__FILE="${nodehome}/log/emqx.log" \
 EMQX_NODE__COOKIE="${EMQX_NODE__COOKIE:-cookie1}" \

From 76401a302aa82a2c49b8471bf2296b84e56d7af4 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Fri, 2 Feb 2024 13:33:35 -0300
Subject: [PATCH 154/273] fix(config): apply config upgrade to deprecated
 configs

Fixes https://emqx.atlassian.net/browse/EMQX-11845

Fixes https://github.com/emqx/emqx/issues/12452
---
 apps/emqx/src/emqx_config.erl                 |  10 +-
 ...qx_bridge_v1_compatibility_layer_SUITE.erl | 116 +++++++++++++++++-
 changes/ce/fix-12471.en.md                    |   1 +
 3 files changed, 118 insertions(+), 9 deletions(-)
 create mode 100644 changes/ce/fix-12471.en.md

diff --git a/apps/emqx/src/emqx_config.erl b/apps/emqx/src/emqx_config.erl
index 672ecb1da..195f116b1 100644
--- a/apps/emqx/src/emqx_config.erl
+++ b/apps/emqx/src/emqx_config.erl
@@ -327,15 +327,15 @@ init_load(SchemaMod, Conf) when is_list(Conf) orelse is_binary(Conf) ->
     ok = save_schema_mod_and_names(SchemaMod),
     HasDeprecatedFile = has_deprecated_file(),
     RawConf0 = load_config_files(HasDeprecatedFile, Conf),
-    RawConf1 = upgrade_raw_conf(SchemaMod, RawConf0),
-    warning_deprecated_root_key(RawConf1),
-    RawConf2 =
+    warning_deprecated_root_key(RawConf0),
+    RawConf1 =
         case HasDeprecatedFile of
             true ->
-                overlay_v0(SchemaMod, RawConf1);
+                overlay_v0(SchemaMod, RawConf0);
             false ->
-                overlay_v1(SchemaMod, RawConf1)
+                overlay_v1(SchemaMod, RawConf0)
         end,
+    RawConf2 = upgrade_raw_conf(SchemaMod, RawConf1),
     RawConf3 = fill_defaults_for_all_roots(SchemaMod, RawConf2),
     %% check configs against the schema
     {AppEnvs, CheckedConf} = check_config(SchemaMod, RawConf3, #{}),
diff --git a/apps/emqx_bridge/test/emqx_bridge_v1_compatibility_layer_SUITE.erl b/apps/emqx_bridge/test/emqx_bridge_v1_compatibility_layer_SUITE.erl
index b67791cb3..1f222380b 100644
--- a/apps/emqx_bridge/test/emqx_bridge_v1_compatibility_layer_SUITE.erl
+++ b/apps/emqx_bridge/test/emqx_bridge_v1_compatibility_layer_SUITE.erl
@@ -37,12 +37,11 @@ init_per_suite(Config) ->
         app_specs(),
         #{work_dir => emqx_cth_suite:work_dir(Config)}
     ),
-    emqx_mgmt_api_test_util:init_suite(),
+    {ok, _} = emqx_common_test_http:create_default_app(),
     [{apps, Apps} | Config].
 
 end_per_suite(Config) ->
     Apps = ?config(apps, Config),
-    emqx_mgmt_api_test_util:end_suite(),
     emqx_cth_suite:stop(Apps),
     ok.
 
@@ -52,9 +51,19 @@ app_specs() ->
         emqx_conf,
         emqx_connector,
         emqx_bridge,
-        emqx_rule_engine
+        emqx_management,
+        emqx_rule_engine,
+        {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
     ].
 
+init_per_testcase(t_upgrade_raw_conf_with_deprecated_files = TestCase, Config) ->
+    NodeSpecs = mk_init_load_cluster_spec(TestCase, Config),
+    Nodes = emqx_cth_cluster:start(NodeSpecs),
+    erpc:multicall(Nodes, fun() ->
+        {ok, _} = emqx_common_test_http:create_default_app(),
+        ok
+    end),
+    [{nodes, Nodes} | Config];
 init_per_testcase(_TestCase, Config) ->
     %% Setting up mocks for fake connector and bridge V2
     setup_mocks(),
@@ -63,6 +72,11 @@ init_per_testcase(_TestCase, Config) ->
     {ok, _} = emqx_connector:create(con_type(), con_name(), con_config()),
     Config.
 
+end_per_testcase(t_upgrade_raw_conf_with_deprecated_files = _TestCase, Config) ->
+    Nodes = ?config(nodes, Config),
+    emqx_cth_cluster:stop(Nodes),
+    emqx_common_test_helpers:call_janitor(),
+    ok;
 end_per_testcase(_TestCase, _Config) ->
     ets:delete(fun_table_name()),
     delete_all_bridges_and_connectors(),
@@ -70,6 +84,19 @@ end_per_testcase(_TestCase, _Config) ->
     emqx_common_test_helpers:call_janitor(),
     ok.
 
+mk_init_load_cluster_spec(Name, Config) ->
+    Node1Apps =
+        proplists:delete(emqx_dashboard, app_specs()) ++
+            [
+                {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18084 }"}
+            ],
+    emqx_cth_cluster:mk_nodespecs(
+        [
+            {emqx_bridge_v1_compat_SUITE_1, #{role => core, apps => Node1Apps}}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Name, Config)}
+    ).
+
 %%------------------------------------------------------------------------------
 %% Helper fns
 %%------------------------------------------------------------------------------
@@ -322,7 +349,10 @@ request(Method, Path, Params) ->
     end.
 
 list_bridges_http_api_v1() ->
-    Path = emqx_mgmt_api_test_util:api_path(["bridges"]),
+    list_bridges_http_api_v1(_Host = "http://127.0.0.1:18083").
+
+list_bridges_http_api_v1(Host) ->
+    Path = emqx_mgmt_api_test_util:api_path(Host, ["bridges"]),
     ct:pal("list bridges (http v1)"),
     Res = request(get, Path, _Params = []),
     ct:pal("list bridges (http v1) result:\n  ~p", [Res]),
@@ -530,6 +560,43 @@ probe_action_http_api_v2(Opts) ->
     ct:pal("probe action (http v2) (~p) result:\n  ~p", [#{name => Name}, Res]),
     Res.
 
+deprecated_config() ->
+    <<
+        "\n"
+        "bridges {\n"
+        "  mqtt {\n"
+        "    test {\n"
+        "      bridge_mode = false\n"
+        "      clean_start = true\n"
+        "      egress {\n"
+        "        local {topic=\"hhhhhh\"}\n"
+        "        remote {\n"
+        "          payload = \"${payload}\"\n"
+        "          qos = 1\n"
+        "          retain = false\n"
+        "          topic = hhhhhhhhhh\n"
+        "        }\n"
+        "      }\n"
+        "      enable = true\n"
+        "      keepalive = 300s\n"
+        "      proto_ver = v4\n"
+        "      resource_opts {\n"
+        "        health_check_interval = 15s\n"
+        "        inflight_window = 100\n"
+        "        max_buffer_bytes = 1GB\n"
+        "        query_mode = async\n"
+        "        request_ttl = 45s\n"
+        "        start_timeout = 5s\n"
+        "        worker_pool_size = 4\n"
+        "      }\n"
+        "      retry_interval = 15s\n"
+        "      server = \"127.0.0.1\"\n"
+        "      ssl {enable = false, verify = verify_peer}\n"
+        "    }\n"
+        "  }\n"
+        "}\n"
+    >>.
+
 %%------------------------------------------------------------------------------
 %% Test cases
 %%------------------------------------------------------------------------------
@@ -983,3 +1050,44 @@ t_v1_api_fill_defaults(_Config) ->
     ),
 
     ok.
+
+t_upgrade_raw_conf_with_deprecated_files(Config) ->
+    %% This verifies that, when a user has a deprecated file such as
+    %% `cluster-override.conf' in their data directory and upgrades to a newer EMQX
+    %% version, its bridge contents are also upgraded.
+    ?check_trace(
+        begin
+            [Node] = ?config(nodes, Config),
+
+            SchemaMod = emqx_conf_schema,
+            erpc:call(Node, fun() ->
+                DataDir = emqx:data_dir(),
+                Path = filename:join([DataDir, "configs", "cluster-override.conf"]),
+                ok = filelib:ensure_dir(Path),
+                ok = file:write_file(Path, <<
+                    "node.cookie = cookie \n",
+                    "node.data_dir = \"/tmp/not/used/here\" \n",
+                    (deprecated_config())/binary
+                >>),
+                %% Attempt to emulate loading the config when starting the node.  The key
+                %% is starting `emqx_bridge' so that bridges are loaded.
+                ok = application:stop(emqx_bridge),
+                ok = application:stop(emqx_connector),
+                ok = emqx_config:init_load(SchemaMod),
+                ok = application:start(emqx_connector),
+                ok = application:start(emqx_bridge),
+
+                ?assertMatch(
+                    {ok, {{_, 200, _}, _, [_]}},
+                    list_bridges_http_api_v1(_Host = "http://127.0.0.1:18084")
+                ),
+
+                ok
+            end),
+
+            ok
+        end,
+        []
+    ),
+
+    ok.
diff --git a/changes/ce/fix-12471.en.md b/changes/ce/fix-12471.en.md
new file mode 100644
index 000000000..548d55312
--- /dev/null
+++ b/changes/ce/fix-12471.en.md
@@ -0,0 +1 @@
+Fixed an issue that could prevent bridges from being correctly loaded when upgrading EMQX from 5.0.2 to the latest versions.

From 76d242df9bb034ab1401b3e45652c2b577125908 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Fri, 2 Feb 2024 17:04:50 -0300
Subject: [PATCH 155/273] fix(bridge_v2_api): avoid calling nodes that do not
 support minimum bpapi

Fixes https://emqx.atlassian.net/browse/EMQX-11834
---
 apps/emqx_bridge/src/emqx_bridge_v2_api.erl   | 16 +++++--
 .../test/emqx_bridge_v2_api_SUITE.erl         | 47 ++++++++++++++++++-
 changes/ce/fix-12472.en.md                    |  1 +
 3 files changed, 59 insertions(+), 5 deletions(-)
 create mode 100644 changes/ce/fix-12472.en.md

diff --git a/apps/emqx_bridge/src/emqx_bridge_v2_api.erl b/apps/emqx_bridge/src/emqx_bridge_v2_api.erl
index 6dcd24355..8f852e391 100644
--- a/apps/emqx_bridge/src/emqx_bridge_v2_api.erl
+++ b/apps/emqx_bridge/src/emqx_bridge_v2_api.erl
@@ -747,7 +747,7 @@ schema("/source_types") ->
 %%------------------------------------------------------------------------------
 
 handle_list(ConfRootKey) ->
-    Nodes = emqx:running_nodes(),
+    Nodes = nodes_supporting_bpapi_version(6),
     NodeReplies = emqx_bridge_proto_v6:v2_list_bridges_on_nodes_v6(Nodes, ConfRootKey),
     case is_ok(NodeReplies) of
         {ok, NodeBridges} ->
@@ -942,7 +942,7 @@ is_ok(ResL) ->
 %% bridge helpers
 -spec lookup_from_all_nodes(emqx_bridge_v2:root_cfg_key(), _, _, _) -> _.
 lookup_from_all_nodes(ConfRootKey, BridgeType, BridgeName, SuccCode) ->
-    Nodes = emqx:running_nodes(),
+    Nodes = nodes_supporting_bpapi_version(6),
     case
         is_ok(
             emqx_bridge_proto_v6:v2_lookup_from_all_nodes_v6(
@@ -959,7 +959,7 @@ lookup_from_all_nodes(ConfRootKey, BridgeType, BridgeName, SuccCode) ->
     end.
 
 get_metrics_from_all_nodes(ConfRootKey, Type, Name) ->
-    Nodes = emqx:running_nodes(),
+    Nodes = nodes_supporting_bpapi_version(6),
     Result = maybe_unwrap(
         emqx_bridge_proto_v6:v2_get_metrics_from_all_nodes_v6(Nodes, ConfRootKey, Type, Name)
     ),
@@ -1058,6 +1058,16 @@ supported_versions(_Call) -> bpapi_version_range(6, 6).
 bpapi_version_range(From, To) ->
     lists:seq(From, To).
 
+nodes_supporting_bpapi_version(Vsn) ->
+    [
+        N
+     || N <- emqx:running_nodes(),
+        case emqx_bpapi:supported_version(N, ?BPAPI_NAME) of
+            undefined -> false;
+            NVsn when is_number(NVsn) -> NVsn >= Vsn
+        end
+    ].
+
 maybe_unwrap({error, not_implemented}) ->
     {error, not_implemented};
 maybe_unwrap(RpcMulticallResult) ->
diff --git a/apps/emqx_bridge/test/emqx_bridge_v2_api_SUITE.erl b/apps/emqx_bridge/test/emqx_bridge_v2_api_SUITE.erl
index 4f98baebf..d56b45a17 100644
--- a/apps/emqx_bridge/test/emqx_bridge_v2_api_SUITE.erl
+++ b/apps/emqx_bridge/test/emqx_bridge_v2_api_SUITE.erl
@@ -106,7 +106,6 @@
 -define(KAFKA_BRIDGE_UPDATE(Name, Connector),
     maps:without([<<"name">>, <<"type">>], ?KAFKA_BRIDGE(Name, Connector))
 ).
--define(KAFKA_BRIDGE_UPDATE(Name), ?KAFKA_BRIDGE_UPDATE(Name, ?ACTION_CONNECTOR_NAME)).
 
 -define(SOURCE_TYPE_STR, "mqtt").
 -define(SOURCE_TYPE, <<?SOURCE_TYPE_STR>>).
@@ -1477,7 +1476,7 @@ t_cluster_later_join_metrics(Config) ->
             ?assertMatch(
                 {ok, 200, #{
                     <<"metrics">> := #{<<"success">> := _},
-                    <<"node_metrics">> := [#{<<"metrics">> := #{}}, #{<<"metrics">> := #{}} | _]
+                    <<"node_metrics">> := [#{<<"metrics">> := #{}} | _]
                 }},
                 request_json(get, uri([?ACTIONS_ROOT, ActionID, "metrics"]), Config)
             ),
@@ -1512,3 +1511,47 @@ t_raw_config_response_defaults(Config) ->
         )
     ),
     ok.
+
+t_older_version_nodes_in_cluster(matrix) ->
+    [
+        [cluster, actions],
+        [cluster, sources]
+    ];
+t_older_version_nodes_in_cluster(Config) ->
+    [_, Kind | _] = group_path(Config),
+    PrimaryNode = ?config(node, Config),
+    OtherNode = maybe_get_other_node(Config),
+    ?assertNotEqual(OtherNode, PrimaryNode),
+    Name = atom_to_binary(?FUNCTION_NAME),
+    ?check_trace(
+        begin
+            #{api_root_key := APIRootKey} = get_common_values(Kind, Name),
+            erpc:call(PrimaryNode, fun() ->
+                meck:new(emqx_bpapi, [no_history, passthrough, no_link]),
+                meck:expect(emqx_bpapi, supported_version, fun(N, Api) ->
+                    case N =:= OtherNode of
+                        true -> 1;
+                        false -> meck:passthrough([N, Api])
+                    end
+                end)
+            end),
+            erpc:call(OtherNode, fun() ->
+                meck:new(emqx_bridge_v2, [no_history, passthrough, no_link]),
+                meck:expect(emqx_bridge_v2, list, fun(_ConfRootKey) ->
+                    error(should_not_be_called)
+                end)
+            end),
+            ?assertMatch(
+                {ok, 200, _},
+                request_json(
+                    get,
+                    uri([APIRootKey]),
+                    Config
+                )
+            ),
+            ok
+        end,
+        []
+    ),
+
+    ok.
diff --git a/changes/ce/fix-12472.en.md b/changes/ce/fix-12472.en.md
new file mode 100644
index 000000000..dd5cfe2f9
--- /dev/null
+++ b/changes/ce/fix-12472.en.md
@@ -0,0 +1 @@
+Fixed an issue that could lead to some read operations on `/api/v5/actions/` and `/api/v5/sources/` to return 500 while rolling upgrades are underway.

From 2e56810ea2e4321750b0dc9e48fe4aa596a0e23a Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sat, 3 Feb 2024 16:22:18 +0100
Subject: [PATCH 156/273] refactor(ds): Use a simple improper list to represent
 the streams

---
 apps/emqx/priv/bpapi.versions                 |   1 +
 .../src/emqx_ds_replication_layer.erl         |  71 ++++++---
 .../src/emqx_ds_storage_bitfield_lts.erl      |  13 +-
 .../src/emqx_ds_storage_layer.erl             |  20 +--
 .../src/proto/emqx_ds_proto_v1.erl            |  11 +-
 .../src/proto/emqx_ds_proto_v2.erl            |  11 +-
 .../src/proto/emqx_ds_proto_v3.erl            |  11 +-
 .../src/proto/emqx_ds_proto_v4.erl            | 147 ++++++++++++++++++
 8 files changed, 231 insertions(+), 54 deletions(-)
 create mode 100644 apps/emqx_durable_storage/src/proto/emqx_ds_proto_v4.erl

diff --git a/apps/emqx/priv/bpapi.versions b/apps/emqx/priv/bpapi.versions
index 987c19535..9497f04cd 100644
--- a/apps/emqx/priv/bpapi.versions
+++ b/apps/emqx/priv/bpapi.versions
@@ -23,6 +23,7 @@
 {emqx_ds,1}.
 {emqx_ds,2}.
 {emqx_ds,3}.
+{emqx_ds,4}.
 {emqx_eviction_agent,1}.
 {emqx_eviction_agent,2}.
 {emqx_exhook,1}.
diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
index 7432fe3c7..ed3a93212 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer.erl
@@ -43,7 +43,9 @@
     do_drop_db_v1/1,
     do_store_batch_v1/4,
     do_get_streams_v1/4,
+    do_get_streams_v2/4,
     do_make_iterator_v1/5,
+    do_make_iterator_v2/5,
     do_update_iterator_v2/4,
     do_next_v1/4,
     do_add_generation_v2/1,
@@ -51,7 +53,9 @@
     do_drop_generation_v3/3
 ]).
 
--export_type([shard_id/0, builtin_db_opts/0, stream/0, iterator/0, message_id/0, batch/0]).
+-export_type([
+    shard_id/0, builtin_db_opts/0, stream_v1/0, stream/0, iterator/0, message_id/0, batch/0
+]).
 
 -include_lib("emqx_utils/include/emqx_message.hrl").
 -include("emqx_ds_replication_layer.hrl").
@@ -72,17 +76,19 @@
 
 %% This enapsulates the stream entity from the replication level.
 %%
-%% TODO: currently the stream is hardwired to only support the
-%% internal rocksdb storage. In the future we want to add another
-%% implementations for emqx_ds, so this type has to take this into
-%% account.
--opaque stream() ::
+%% TODO: this type is obsolete and is kept only for compatibility with
+%% v3 BPAPI. Remove it when emqx_ds_proto_v4 is gone (EMQX 5.6)
+-opaque stream_v1() ::
     #{
         ?tag := ?STREAM,
         ?shard := emqx_ds_replication_layer:shard_id(),
-        ?enc := emqx_ds_storage_layer:stream()
+        ?enc := emqx_ds_storage_layer:stream_v1()
     }.
 
+-define(stream_v2(SHARD, INNER), [2, SHARD | INNER]).
+
+-opaque stream() :: nonempty_maybe_improper_list().
+
 -opaque iterator() ::
     #{
         ?tag := ?IT,
@@ -121,7 +127,7 @@ open_db(DB, CreateOpts) ->
 -spec add_generation(emqx_ds:db()) -> ok | {error, _}.
 add_generation(DB) ->
     Nodes = emqx_ds_replication_layer_meta:leader_nodes(DB),
-    _ = emqx_ds_proto_v3:add_generation(Nodes, DB),
+    _ = emqx_ds_proto_v4:add_generation(Nodes, DB),
     ok.
 
 -spec update_db_config(emqx_ds:db(), builtin_db_opts()) -> ok | {error, _}.
@@ -140,7 +146,7 @@ list_generations_with_lifetimes(DB) ->
                     AccInner#{{Shard, GenId} => Data}
                 end,
                 GensAcc,
-                emqx_ds_proto_v3:list_generations_with_lifetimes(Node, DB, Shard)
+                emqx_ds_proto_v4:list_generations_with_lifetimes(Node, DB, Shard)
             )
         end,
         #{},
@@ -152,12 +158,12 @@ drop_generation(DB, {Shard, GenId}) ->
     %% TODO: drop generation in all nodes in the replica set, not only in the leader,
     %% after we have proper replication in place.
     Node = node_of_shard(DB, Shard),
-    emqx_ds_proto_v3:drop_generation(Node, DB, Shard, GenId).
+    emqx_ds_proto_v4:drop_generation(Node, DB, Shard, GenId).
 
 -spec drop_db(emqx_ds:db()) -> ok | {error, _}.
 drop_db(DB) ->
     Nodes = list_nodes(),
-    _ = emqx_ds_proto_v3:drop_db(Nodes, DB),
+    _ = emqx_ds_proto_v4:drop_db(Nodes, DB),
     _ = emqx_ds_replication_layer_meta:drop_db(DB),
     emqx_ds_builtin_sup:stop_db(DB),
     ok.
@@ -174,16 +180,12 @@ get_streams(DB, TopicFilter, StartTime) ->
     lists:flatmap(
         fun(Shard) ->
             Node = node_of_shard(DB, Shard),
-            Streams = emqx_ds_proto_v3:get_streams(Node, DB, Shard, TopicFilter, StartTime),
+            Streams = emqx_ds_proto_v4:get_streams(Node, DB, Shard, TopicFilter, StartTime),
             lists:map(
-                fun({RankY, Stream}) ->
+                fun({RankY, StorageLayerStream}) ->
                     RankX = Shard,
                     Rank = {RankX, RankY},
-                    {Rank, #{
-                        ?tag => ?STREAM,
-                        ?shard => Shard,
-                        ?enc => Stream
-                    }}
+                    {Rank, ?stream_v2(Shard, StorageLayerStream)}
                 end,
                 Streams
             )
@@ -194,9 +196,9 @@ get_streams(DB, TopicFilter, StartTime) ->
 -spec make_iterator(emqx_ds:db(), stream(), emqx_ds:topic_filter(), emqx_ds:time()) ->
     emqx_ds:make_iterator_result(iterator()).
 make_iterator(DB, Stream, TopicFilter, StartTime) ->
-    #{?tag := ?STREAM, ?shard := Shard, ?enc := StorageStream} = Stream,
+    ?stream_v2(Shard, StorageStream) = Stream,
     Node = node_of_shard(DB, Shard),
-    case emqx_ds_proto_v3:make_iterator(Node, DB, Shard, StorageStream, TopicFilter, StartTime) of
+    case emqx_ds_proto_v4:make_iterator(Node, DB, Shard, StorageStream, TopicFilter, StartTime) of
         {ok, Iter} ->
             {ok, #{?tag => ?IT, ?shard => Shard, ?enc => Iter}};
         Err = {error, _} ->
@@ -213,7 +215,7 @@ update_iterator(DB, OldIter, DSKey) ->
     #{?tag := ?IT, ?shard := Shard, ?enc := StorageIter} = OldIter,
     Node = node_of_shard(DB, Shard),
     case
-        emqx_ds_proto_v3:update_iterator(
+        emqx_ds_proto_v4:update_iterator(
             Node,
             DB,
             Shard,
@@ -239,7 +241,7 @@ next(DB, Iter0, BatchSize) ->
     %%
     %% This kind of trickery should be probably done here in the
     %% replication layer. Or, perhaps, in the logic layer.
-    case emqx_ds_proto_v3:next(Node, DB, Shard, StorageIter0, BatchSize) of
+    case emqx_ds_proto_v4:next(Node, DB, Shard, StorageIter0, BatchSize) of
         {ok, StorageIter, Batch} ->
             Iter = Iter0#{?enc := StorageIter},
             {ok, Iter, Batch};
@@ -311,14 +313,35 @@ do_drop_db_v1(DB) ->
 do_store_batch_v1(DB, Shard, #{?tag := ?BATCH, ?batch_messages := Messages}, Options) ->
     emqx_ds_storage_layer:store_batch({DB, Shard}, Messages, Options).
 
+%% Remove me in EMQX 5.6
+-dialyzer({nowarn_function, do_get_streams_v1/4}).
 -spec do_get_streams_v1(
     emqx_ds:db(), emqx_ds_replication_layer:shard_id(), emqx_ds:topic_filter(), emqx_ds:time()
+) ->
+    [{integer(), emqx_ds_storage_layer:stream_v1()}].
+do_get_streams_v1(_DB, _Shard, _TopicFilter, _StartTime) ->
+    error(obsolete_api).
+
+-spec do_get_streams_v2(
+    emqx_ds:db(), emqx_ds_replication_layer:shard_id(), emqx_ds:topic_filter(), emqx_ds:time()
 ) ->
     [{integer(), emqx_ds_storage_layer:stream()}].
-do_get_streams_v1(DB, Shard, TopicFilter, StartTime) ->
+do_get_streams_v2(DB, Shard, TopicFilter, StartTime) ->
     emqx_ds_storage_layer:get_streams({DB, Shard}, TopicFilter, StartTime).
 
+-dialyzer({nowarn_function, do_make_iterator_v1/5}).
 -spec do_make_iterator_v1(
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:stream_v1(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+do_make_iterator_v1(_DB, _Shard, _Stream, _TopicFilter, _StartTime) ->
+    error(obsolete_api).
+
+-spec do_make_iterator_v2(
     emqx_ds:db(),
     emqx_ds_replication_layer:shard_id(),
     emqx_ds_storage_layer:stream(),
@@ -326,7 +349,7 @@ do_get_streams_v1(DB, Shard, TopicFilter, StartTime) ->
     emqx_ds:time()
 ) ->
     {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
-do_make_iterator_v1(DB, Shard, Stream, TopicFilter, StartTime) ->
+do_make_iterator_v2(DB, Shard, Stream, TopicFilter, StartTime) ->
     emqx_ds_storage_layer:make_iterator({DB, Shard}, Stream, TopicFilter, StartTime).
 
 -spec do_update_iterator_v2(
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
index d407dab41..7ffdd1e2b 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_bitfield_lts.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -89,11 +89,7 @@
 
 -type s() :: #s{}.
 
--type stream() ::
-    #{
-        ?tag := ?STREAM,
-        ?storage_key := emqx_ds_lts:msg_storage_key()
-    }.
+-type stream() :: emqx_ds_lts:msg_storage_key().
 
 -type iterator() ::
     #{
@@ -251,8 +247,7 @@ store_batch(_ShardId, S = #s{db = DB, data = Data}, Messages, _Options) ->
     emqx_ds:time()
 ) -> [stream()].
 get_streams(_Shard, #s{trie = Trie}, TopicFilter, _StartTime) ->
-    Indexes = emqx_ds_lts:match_topics(Trie, TopicFilter),
-    [#{?tag => ?STREAM, ?storage_key => I} || I <- Indexes].
+    emqx_ds_lts:match_topics(Trie, TopicFilter).
 
 -spec make_iterator(
     emqx_ds_storage_layer:shard_id(),
@@ -262,7 +257,7 @@ get_streams(_Shard, #s{trie = Trie}, TopicFilter, _StartTime) ->
     emqx_ds:time()
 ) -> {ok, iterator()}.
 make_iterator(
-    _Shard, _Data, #{?tag := ?STREAM, ?storage_key := StorageKey}, TopicFilter, StartTime
+    _Shard, _Data, StorageKey, TopicFilter, StartTime
 ) ->
     %% Note: it's a good idea to keep the iterator structure lean,
     %% since it can be stored on a remote node that could update its
diff --git a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
index f22e7423c..e0bf1fa1b 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_storage_layer.erl
@@ -43,6 +43,7 @@
     generation/0,
     cf_refs/0,
     stream/0,
+    stream_v1/0,
     iterator/0,
     shard_id/0,
     options/0,
@@ -54,6 +55,8 @@
 
 -define(REF(ShardId), {via, gproc, {n, l, {?MODULE, ShardId}}}).
 
+-define(stream_v2(GENERATION, INNER), [GENERATION | INNER]).
+
 %%================================================================================
 %% Type declarations
 %%================================================================================
@@ -80,14 +83,17 @@
 
 -type gen_id() :: 0..16#ffff.
 
-%% Note: this might be stored permanently on a remote node.
--opaque stream() ::
+%% TODO: kept for BPAPI compatibility. Remove me on EMQX v5.6
+-opaque stream_v1() ::
     #{
         ?tag := ?STREAM,
         ?generation := gen_id(),
         ?enc := term()
     }.
 
+%% Note: this might be stored permanently on a remote node.
+-opaque stream() :: nonempty_maybe_improper_list(gen_id(), term()).
+
 %% Note: this might be stred permanently on a remote node.
 -opaque iterator() ::
     #{
@@ -221,12 +227,8 @@ get_streams(Shard, TopicFilter, StartTime) ->
                 {ok, #{module := Mod, data := GenData}} ->
                     Streams = Mod:get_streams(Shard, GenData, TopicFilter, StartTime),
                     [
-                        {GenId, #{
-                            ?tag => ?STREAM,
-                            ?generation => GenId,
-                            ?enc => Stream
-                        }}
-                     || Stream <- Streams
+                        {GenId, ?stream_v2(GenId, InnerStream)}
+                     || InnerStream <- Streams
                     ];
                 {error, not_found} ->
                     %% race condition: generation was dropped before getting its streams?
@@ -239,7 +241,7 @@ get_streams(Shard, TopicFilter, StartTime) ->
 -spec make_iterator(shard_id(), stream(), emqx_ds:topic_filter(), emqx_ds:time()) ->
     emqx_ds:make_iterator_result(iterator()).
 make_iterator(
-    Shard, #{?tag := ?STREAM, ?generation := GenId, ?enc := Stream}, TopicFilter, StartTime
+    Shard, ?stream_v2(GenId, Stream), TopicFilter, StartTime
 ) ->
     case generation_get_safe(Shard, GenId) of
         {ok, #{module := Mod, data := GenData}} ->
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v1.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v1.erl
index 67ed1a3ca..e9a19c8df 100644
--- a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v1.erl
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v1.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -28,7 +28,7 @@
 ]).
 
 %% behavior callbacks:
--export([introduced_in/0]).
+-export([introduced_in/0, deprecated_since/0]).
 
 %%================================================================================
 %% API funcions
@@ -45,7 +45,7 @@ drop_db(Node, DB) ->
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
-    [{integer(), emqx_ds_storage_layer:stream()}].
+    [{integer(), emqx_ds_storage_layer:stream_v1()}].
 get_streams(Node, DB, Shard, TopicFilter, Time) ->
     erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v1, [DB, Shard, TopicFilter, Time]).
 
@@ -53,7 +53,7 @@ get_streams(Node, DB, Shard, TopicFilter, Time) ->
     node(),
     emqx_ds:db(),
     emqx_ds_replication_layer:shard_id(),
-    emqx_ds_storage_layer:stream(),
+    emqx_ds_storage_layer:stream_v1(),
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
@@ -95,3 +95,6 @@ store_batch(Node, DB, Shard, Batch, Options) ->
 
 introduced_in() ->
     "5.4.0".
+
+deprecated_since() ->
+    "5.5.0".
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v2.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v2.erl
index f771f1a8b..1ab158747 100644
--- a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v2.erl
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v2.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -32,7 +32,7 @@
 ]).
 
 %% behavior callbacks:
--export([introduced_in/0]).
+-export([introduced_in/0, deprecated_since/0]).
 
 %%================================================================================
 %% API funcions
@@ -50,7 +50,7 @@ drop_db(Node, DB) ->
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
-    [{integer(), emqx_ds_storage_layer:stream()}].
+    [{integer(), emqx_ds_storage_layer:stream_v1()}].
 get_streams(Node, DB, Shard, TopicFilter, Time) ->
     erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v1, [DB, Shard, TopicFilter, Time]).
 
@@ -58,7 +58,7 @@ get_streams(Node, DB, Shard, TopicFilter, Time) ->
     node(),
     emqx_ds:db(),
     emqx_ds_replication_layer:shard_id(),
-    emqx_ds_storage_layer:stream(),
+    emqx_ds_storage_layer:stream_v1(),
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
@@ -122,3 +122,6 @@ add_generation(Node, DB) ->
 
 introduced_in() ->
     "5.5.0".
+
+deprecated_since() ->
+    "5.5.0".
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
index 74a174c4c..40205c548 100644
--- a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v3.erl
@@ -34,7 +34,7 @@
 ]).
 
 %% behavior callbacks:
--export([introduced_in/0]).
+-export([introduced_in/0, deprecated_since/0]).
 
 %%================================================================================
 %% API funcions
@@ -52,7 +52,7 @@ drop_db(Node, DB) ->
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
-    [{integer(), emqx_ds_storage_layer:stream()}].
+    [{integer(), emqx_ds_storage_layer:stream_v1()}].
 get_streams(Node, DB, Shard, TopicFilter, Time) ->
     erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v1, [DB, Shard, TopicFilter, Time]).
 
@@ -60,7 +60,7 @@ get_streams(Node, DB, Shard, TopicFilter, Time) ->
     node(),
     emqx_ds:db(),
     emqx_ds_replication_layer:shard_id(),
-    emqx_ds_storage_layer:stream(),
+    emqx_ds_storage_layer:stream_v1(),
     emqx_ds:topic_filter(),
     emqx_ds:time()
 ) ->
@@ -144,4 +144,7 @@ drop_generation(Node, DB, Shard, GenId) ->
 %%================================================================================
 
 introduced_in() ->
-    "5.6.0".
+    "5.5.0".
+
+deprecated_since() ->
+    "5.5.1".
diff --git a/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v4.erl b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v4.erl
new file mode 100644
index 000000000..fcab12507
--- /dev/null
+++ b/apps/emqx_durable_storage/src/proto/emqx_ds_proto_v4.erl
@@ -0,0 +1,147 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_ds_proto_v4).
+
+-behavior(emqx_bpapi).
+
+-include_lib("emqx_utils/include/bpapi.hrl").
+%% API:
+-export([
+    drop_db/2,
+    store_batch/5,
+    get_streams/5,
+    make_iterator/6,
+    next/5,
+    update_iterator/5,
+    add_generation/2,
+
+    %% introduced in v3
+    list_generations_with_lifetimes/3,
+    drop_generation/4
+]).
+
+%% behavior callbacks:
+-export([introduced_in/0]).
+
+%%================================================================================
+%% API funcions
+%%================================================================================
+
+-spec drop_db([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+drop_db(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_drop_db_v1, [DB]).
+
+-spec get_streams(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    [{integer(), emqx_ds_storage_layer:stream()}].
+get_streams(Node, DB, Shard, TopicFilter, Time) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_get_streams_v2, [DB, Shard, TopicFilter, Time]).
+
+-spec make_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:stream(),
+    emqx_ds:topic_filter(),
+    emqx_ds:time()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+make_iterator(Node, DB, Shard, Stream, TopicFilter, StartTime) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_make_iterator_v2, [
+        DB, Shard, Stream, TopicFilter, StartTime
+    ]).
+
+-spec next(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    pos_integer()
+) ->
+    {ok, emqx_ds_storage_layer:iterator(), [{emqx_ds:message_key(), [emqx_types:message()]}]}
+    | {ok, end_of_stream}
+    | {error, _}.
+next(Node, DB, Shard, Iter, BatchSize) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_next_v1, [DB, Shard, Iter, BatchSize]).
+
+-spec store_batch(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_replication_layer:batch(),
+    emqx_ds:message_store_opts()
+) ->
+    emqx_ds:store_batch_result().
+store_batch(Node, DB, Shard, Batch, Options) ->
+    emqx_rpc:call(Shard, Node, emqx_ds_replication_layer, do_store_batch_v1, [
+        DB, Shard, Batch, Options
+    ]).
+
+-spec update_iterator(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:iterator(),
+    emqx_ds:message_key()
+) ->
+    {ok, emqx_ds_storage_layer:iterator()} | {error, _}.
+update_iterator(Node, DB, Shard, OldIter, DSKey) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_update_iterator_v2, [
+        DB, Shard, OldIter, DSKey
+    ]).
+
+-spec add_generation([node()], emqx_ds:db()) ->
+    [{ok, ok} | {error, _}].
+add_generation(Node, DB) ->
+    erpc:multicall(Node, emqx_ds_replication_layer, do_add_generation_v2, [DB]).
+
+%%--------------------------------------------------------------------------------
+%% Introduced in V3
+%%--------------------------------------------------------------------------------
+
+-spec list_generations_with_lifetimes(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id()
+) ->
+    #{
+        emqx_ds:ds_specific_generation_rank() => emqx_ds:generation_info()
+    }.
+list_generations_with_lifetimes(Node, DB, Shard) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_list_generations_with_lifetimes_v3, [DB, Shard]).
+
+-spec drop_generation(
+    node(),
+    emqx_ds:db(),
+    emqx_ds_replication_layer:shard_id(),
+    emqx_ds_storage_layer:gen_id()
+) ->
+    ok | {error, _}.
+drop_generation(Node, DB, Shard, GenId) ->
+    erpc:call(Node, emqx_ds_replication_layer, do_drop_generation_v3, [DB, Shard, GenId]).
+
+%%================================================================================
+%% behavior callbacks
+%%================================================================================
+
+introduced_in() ->
+    "5.5.1".

From 2e2f3cb2aadd1386e631da2e5874a3b9a85e7534 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Sat, 3 Feb 2024 19:32:17 +0100
Subject: [PATCH 157/273] fix(sessds): Avoid stream hash collisions

---
 apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 315fcbc78..45bf6ede1 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -169,7 +169,7 @@ del_subscription(SubId, S0) ->
 
 ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
     %% TODO: hash collisions
-    Key = {SubId, erlang:phash2(Stream)},
+    Key = {SubId, Stream},
     case emqx_persistent_session_ds_state:get_stream(Key, S) of
         undefined ->
             ?SLOG(debug, #{

From b1150a5f88f8b92451e5c40bd3edfca301ee6ee9 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Sun, 4 Feb 2024 10:53:13 +0800
Subject: [PATCH 158/273] fix(schema): bridge oracle connector schema

---
 apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
index 532c01b78..e4cb2c3b4 100644
--- a/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
+++ b/apps/emqx_bridge_oracle/src/emqx_bridge_oracle.erl
@@ -123,11 +123,10 @@ fields(Field) when
     Field == "put_connector";
     Field == "post_connector"
 ->
-    emqx_connector_schema:api_fields(
-        Field,
-        ?CONNECTOR_TYPE,
-        fields("config_connector")
-    );
+    Fields =
+        fields(connector_fields) ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
 fields(Field) when
     Field == "get_bridge_v2";
     Field == "post_bridge_v2";

From f7b0d1bc9d8fdc5dbc120a08dde8dcd2eab687d4 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Sun, 4 Feb 2024 11:53:37 +0800
Subject: [PATCH 159/273] chore: add duplicated key assert in swagger.json

---
 .../src/emqx_dashboard_swagger.erl            | 23 +++++++++++++++----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl b/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
index 062b35793..56ca4acb0 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
@@ -833,16 +833,29 @@ parse_object(Other, Module, Options) ->
     ).
 
 parse_object_loop(PropList0, Module, Options) ->
-    PropList = lists:filter(
-        fun({_, Hocon}) ->
+    PropList = filter_hidden_key(PropList0, Module),
+    parse_object_loop(PropList, Module, Options, _Props = [], _Required = [], _Refs = []).
+
+filter_hidden_key(PropList0, Module) ->
+    {PropList1, _} = lists:foldr(
+        fun({Key, Hocon} = Prop, {PropAcc, KeyAcc}) ->
+            NewKeyAcc = assert_no_duplicated_key(Key, KeyAcc, Module),
             case hoconsc:is_schema(Hocon) andalso is_hidden(Hocon) of
-                true -> false;
-                false -> true
+                true -> {PropAcc, NewKeyAcc};
+                false -> {[Prop | PropAcc], NewKeyAcc}
             end
         end,
+        {[], []},
         PropList0
     ),
-    parse_object_loop(PropList, Module, Options, _Props = [], _Required = [], _Refs = []).
+    PropList1.
+
+assert_no_duplicated_key(Key, Keys, Module) ->
+    KeyBin = emqx_utils_conv:bin(Key),
+    case lists:member(KeyBin, Keys) of
+        true -> throw({duplicated_key, #{module => Module, key => KeyBin, keys => Keys}});
+        false -> [KeyBin | Keys]
+    end.
 
 parse_object_loop([], _Module, _Options, Props, Required, Refs) ->
     {lists:reverse(Props), lists:usort(Required), Refs};

From e57c354a6af3fcde066f8d5f14217c462f85735f Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Fri, 2 Feb 2024 16:39:40 +0800
Subject: [PATCH 160/273] fix(bin/emqx): maxium file descriptors limit and
 Schedulers limit

- File descriptors limit 65536 for `remote_console` and `nodetool`
- Schedulers limit 2 for `remote_console` and limit 1 for `nodetool`

Refer [erl#flags](https://www.erlang.org/doc/man/erl.html#flags)

Thanks [PR Review](https://github.com/emqx/emqx/pull/12466#issuecomment-1924095754)
---
 bin/emqx     | 4 ++++
 bin/nodetool | 1 +
 2 files changed, 5 insertions(+)

diff --git a/bin/emqx b/bin/emqx
index f7ad1c04b..bd51106ca 100755
--- a/bin/emqx
+++ b/bin/emqx
@@ -408,6 +408,8 @@ remsh() {
             -setcookie "$COOKIE" \
             -hidden \
             -kernel net_ticktime "$TICKTIME" \
+            +Q 65536 \
+            +S 2 \
             $EPMD_ARGS
     else
         set -- "$REL_DIR/iex" \
@@ -418,6 +420,8 @@ remsh() {
             --erl "-kernel net_ticktime $TICKTIME" \
             --erl "$EPMD_ARGS" \
             --erl "$NAME_TYPE $id" \
+            --erl "+Q 65536" \
+            --erl "+S 2" \
             --boot "$REL_DIR/start_clean"
     fi
     exec "$@"
diff --git a/bin/nodetool b/bin/nodetool
index ed1ce7706..eedd1c3c1 100755
--- a/bin/nodetool
+++ b/bin/nodetool
@@ -1,5 +1,6 @@
 #!/usr/bin/env escript
 %% -*- mode: erlang;erlang-indent-level: 4;indent-tabs-mode: nil -*-
+%%! +Q 65536 +S 1
 %% ex: ft=erlang ts=4 sw=4 et
 %% -------------------------------------------------------------------
 %%

From 4a2c5a316148a9c0385f5f4b7f758c34528fb774 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Mon, 5 Feb 2024 10:21:06 +0800
Subject: [PATCH 161/273] fix(tdengine): keep the bridge schema still
 compatible with v1

---
 .../src/emqx_bridge_tdengine_connector.erl      | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
index d35be0f2e..ce9d84b4f 100644
--- a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_connector.erl
@@ -47,16 +47,13 @@ roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
 fields(config) ->
-    [
-        {server, server()}
-        | adjust_fields(emqx_connector_schema_lib:relational_db_fields())
-    ];
+    base_config(true);
 %%=====================================================================
 %% V2 Hocon schema
 
 fields("config_connector") ->
     emqx_connector_schema:common_fields() ++
-        fields(config) ++
+        base_config(false) ++
         emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
 fields(connector_resource_opts) ->
     emqx_connector_schema:resource_opts_fields();
@@ -67,6 +64,12 @@ fields("put") ->
 fields("get") ->
     emqx_bridge_schema:status_fields() ++ fields("post").
 
+base_config(HasDatabase) ->
+    [
+        {server, server()}
+        | adjust_fields(emqx_connector_schema_lib:relational_db_fields(), HasDatabase)
+    ].
+
 desc(config) ->
     ?DESC("desc_config");
 desc(connector_resource_opts) ->
@@ -78,7 +81,7 @@ desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
 desc(_) ->
     undefined.
 
-adjust_fields(Fields) ->
+adjust_fields(Fields, HasDatabase) ->
     lists:filtermap(
         fun
             ({username, OrigUsernameFn}) ->
@@ -86,7 +89,7 @@ adjust_fields(Fields) ->
             ({password, _}) ->
                 {true, {password, emqx_connector_schema_lib:password_field(#{required => true})}};
             ({database, _}) ->
-                false;
+                HasDatabase;
             (_Field) ->
                 true
         end,

From 8edbec5929e47a509eff8537816a67881b218d3a Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 29 Jan 2024 20:07:47 +0100
Subject: [PATCH 162/273] refactor(ds): Clarify the language used in
 ds_bitmapper

---
 .../src/emqx_ds_bitmask_keymapper.erl         | 110 +++++++++++-------
 1 file changed, 68 insertions(+), 42 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
index 11dcba3ea..99831a6df 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
@@ -16,8 +16,8 @@
 -module(emqx_ds_bitmask_keymapper).
 
 %%================================================================================
-%% @doc This module is used to map N-dimensional coordinates to a
-%% 1-dimensional space.
+%% @doc This module is used to map an N-dimensional vector to a
+%% 1-dimensional scalar.
 %%
 %% Example:
 %%
@@ -59,7 +59,10 @@
 %% The resulting index is a space-filling curve that looks like
 %% this in the topic-time 2D space:
 %%
-%% T ^ ---->------   |---->------   |---->------
+%%
+%% topic
+%%
+%%   ^ ---->------   |---->------   |---->------
 %%   |       --/     /      --/     /      --/
 %%   |   -<-/       |   -<-/       |   -<-/
 %%   | -/           | -/           | -/
@@ -73,8 +76,8 @@
 %%   | -/         |   -/         |   -/
 %%   | ---->------|   ---->------|   ---------->
 %%   |
-%%  -+------------+-----------------------------> t
-%%        epoch
+%%  -+--------------+-------------+-------------> time
+%%        epoch         epoch         epoch
 %%
 %% This structure allows to quickly seek to a the first message that
 %% was recorded in a certain epoch in a certain topic or a
@@ -89,6 +92,18 @@
 %% This property doesn't hold between different topics, but it's not deemed
 %% a problem right now.
 %%
+%% Notes on the terminology:
+%%
+%% - "Coordinates" of the original message (usually topic and the
+%% timestamp, like in the example above) will be referred as the
+%% "vector".
+%%
+%% - The 1D scalar that these coordinates are transformed to will be
+%% referred as the "scalar".
+%%
+%% - Binary representation of the scalar if fixed size will be
+%% referred as the "key".
+%%
 %%================================================================================
 
 %% API:
@@ -128,9 +143,9 @@
 %% Type declarations
 %%================================================================================
 
--type scalar() :: integer().
+-type coord() :: integer().
 
--type vector() :: [scalar()].
+-type vector() :: [coord()].
 
 %% N-th coordinate of a vector:
 -type dimension() :: pos_integer().
@@ -147,10 +162,17 @@
     %% bit from N-th element of the input vector:
     {dimension(), offset(), bitsize()}.
 
+%% This record is used during transformation of the source vector into
+%% a key.
+%%
+%% Every dimension of the source vector has a list of `scan_action's
+%% associated with it, and the key is formed by applying the scan
+%% actions to the respective coordinate of the vector using `extract'
+%% function.
 -record(scan_action, {
-    src_bitmask :: integer(),
-    src_offset :: offset(),
-    dst_offset :: offset()
+    vec_coord_bitmask :: integer(),
+    vec_coord_offset :: offset(),
+    scalar_offset :: offset()
 }).
 
 -type scan_action() :: #scan_action{}.
@@ -158,16 +180,20 @@
 -type scanner() :: [[scan_action()]].
 
 -record(keymapper, {
+    %% The original schema of the transformation:
     schema :: [bitsource()],
-    scanner :: scanner(),
-    size :: non_neg_integer(),
+    %% List of operations used to map a vector to the scalar
+    vec_scanner :: scanner(),
+    %% Total size of the resulting key, in bits:
+    key_size :: non_neg_integer(),
+    %% Bit size of each dimenstion of the vector:
     dim_sizeof :: [non_neg_integer()]
 }).
 
 -opaque keymapper() :: #keymapper{}.
 
--type scalar_range() ::
-    any | {'=', scalar() | infinity} | {'>=', scalar()} | {scalar(), '..', scalar()}.
+-type coord_range() ::
+    any | {'=', coord() | infinity} | {'>=', coord()} | {coord(), '..', coord()}.
 
 -include("emqx_ds_bitmask.hrl").
 
@@ -192,7 +218,7 @@ make_keymapper(Bitsources) ->
         fun(DestOffset, {Dim0, Offset, Size}, Acc) ->
             Dim = Dim0 - 1,
             Action = #scan_action{
-                src_bitmask = ones(Size), src_offset = Offset, dst_offset = DestOffset
+                vec_coord_bitmask = ones(Size), vec_coord_offset = Offset, scalar_offset = DestOffset
             },
             {DimSizeof, Actions} = array:get(Dim, Acc),
             array:set(Dim, {DimSizeof + Size, [Action | Actions]}, Acc)
@@ -203,27 +229,27 @@ make_keymapper(Bitsources) ->
     {DimSizeof, Scanner} = lists:unzip(array:to_list(Arr)),
     #keymapper{
         schema = Bitsources,
-        scanner = Scanner,
-        size = Size,
+        vec_scanner = Scanner,
+        key_size = Size,
         dim_sizeof = DimSizeof
     }.
 
 -spec bitsize(keymapper()) -> pos_integer().
-bitsize(#keymapper{size = Size}) ->
+bitsize(#keymapper{key_size = Size}) ->
     Size.
 
 %% @doc Map N-dimensional vector to a scalar key.
 %%
 %% Note: this function is not injective.
 -spec vector_to_key(keymapper(), vector()) -> key().
-vector_to_key(#keymapper{scanner = []}, []) ->
+vector_to_key(#keymapper{vec_scanner = []}, []) ->
     0;
-vector_to_key(#keymapper{scanner = [Actions | Scanner]}, [Coord | Vector]) ->
+vector_to_key(#keymapper{vec_scanner = [Actions | Scanner]}, [Coord | Vector]) ->
     do_vector_to_key(Actions, Scanner, Coord, Vector, 0).
 
 %% @doc Same as `vector_to_key', but it works with binaries, and outputs a binary.
 -spec bin_vector_to_key(keymapper(), [binary()]) -> binary().
-bin_vector_to_key(Keymapper = #keymapper{dim_sizeof = DimSizeof, size = Size}, Binaries) ->
+bin_vector_to_key(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size}, Binaries) ->
     Vec = lists:zipwith(
         fun(Bin, SizeOf) ->
             <<Int:SizeOf>> = Bin,
@@ -240,7 +266,7 @@ bin_vector_to_key(Keymapper = #keymapper{dim_sizeof = DimSizeof, size = Size}, B
 %% Note: `vector_to_key(key_to_vector(K)) = K' but
 %% `key_to_vector(vector_to_key(V)) = V' is not guaranteed.
 -spec key_to_vector(keymapper(), key()) -> vector().
-key_to_vector(#keymapper{scanner = Scanner}, Key) ->
+key_to_vector(#keymapper{vec_scanner = Scanner}, Key) ->
     lists:map(
         fun(Actions) ->
             lists:foldl(
@@ -256,7 +282,7 @@ key_to_vector(#keymapper{scanner = Scanner}, Key) ->
 
 %% @doc Same as `key_to_vector', but it works with binaries.
 -spec bin_key_to_vector(keymapper(), binary()) -> [binary()].
-bin_key_to_vector(Keymapper = #keymapper{dim_sizeof = DimSizeof, size = Size}, BinKey) ->
+bin_key_to_vector(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size}, BinKey) ->
     <<Key:Size>> = BinKey,
     Vector = key_to_vector(Keymapper, Key),
     lists:zipwith(
@@ -269,7 +295,7 @@ bin_key_to_vector(Keymapper = #keymapper{dim_sizeof = DimSizeof, size = Size}, B
 
 %% @doc Transform a bitstring to a key
 -spec bitstring_to_key(keymapper(), bitstring()) -> key().
-bitstring_to_key(#keymapper{size = Size}, Bin) ->
+bitstring_to_key(#keymapper{key_size = Size}, Bin) ->
     case Bin of
         <<Key:Size>> ->
             Key;
@@ -279,13 +305,13 @@ bitstring_to_key(#keymapper{size = Size}, Bin) ->
 
 %% @doc Transform key to a fixed-size bistring
 -spec key_to_bitstring(keymapper(), key()) -> bitstring().
-key_to_bitstring(#keymapper{size = Size}, Key) ->
+key_to_bitstring(#keymapper{key_size = Size}, Key) ->
     <<Key:Size>>.
 
 %% @doc Create a filter object that facilitates range scans.
--spec make_filter(keymapper(), [scalar_range()]) -> filter().
+-spec make_filter(keymapper(), [coord_range()]) -> filter().
 make_filter(
-    KeyMapper = #keymapper{schema = Schema, dim_sizeof = DimSizeof, size = TotalSize}, Filter0
+    KeyMapper = #keymapper{schema = Schema, dim_sizeof = DimSizeof, key_size = TotalSize}, Filter0
 ) ->
     NDim = length(DimSizeof),
     %% Transform "symbolic" constraints to ranges:
@@ -568,14 +594,14 @@ do_vector_to_key([Action | Actions], Scanner, Coord, Vector, Acc0) ->
     Acc = Acc0 bor extract(Coord, Action),
     do_vector_to_key(Actions, Scanner, Coord, Vector, Acc).
 
--spec extract(_Source :: scalar(), scan_action()) -> integer().
-extract(Src, #scan_action{src_bitmask = SrcBitmask, src_offset = SrcOffset, dst_offset = DstOffset}) ->
+-spec extract(_Source :: coord(), scan_action()) -> integer().
+extract(Src, #scan_action{vec_coord_bitmask = SrcBitmask, vec_coord_offset = SrcOffset, scalar_offset = DstOffset}) ->
     ((Src bsr SrcOffset) band SrcBitmask) bsl DstOffset.
 
 %% extract^-1
--spec extract_inv(_Dest :: scalar(), scan_action()) -> integer().
+-spec extract_inv(_Dest :: coord(), scan_action()) -> integer().
 extract_inv(Dest, #scan_action{
-    src_bitmask = SrcBitmask, src_offset = SrcOffset, dst_offset = DestOffset
+    vec_coord_bitmask = SrcBitmask, vec_coord_offset = SrcOffset, scalar_offset = DestOffset
 }) ->
     ((Dest bsr DestOffset) band SrcBitmask) bsl SrcOffset.
 
@@ -593,8 +619,8 @@ make_keymapper0_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
-            scanner = [],
-            size = 0,
+            vec_scanner = [],
+            key_size = 0,
             dim_sizeof = []
         },
         make_keymapper(Schema)
@@ -605,11 +631,11 @@ make_keymapper1_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
-            scanner = [
-                [#scan_action{src_bitmask = 2#111, src_offset = 0, dst_offset = 0}],
-                [#scan_action{src_bitmask = 2#11111, src_offset = 0, dst_offset = 3}]
+            vec_scanner = [
+                [#scan_action{vec_coord_bitmask = 2#111, vec_coord_offset = 0, scalar_offset = 0}],
+                [#scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 0, scalar_offset = 3}]
             ],
-            size = 8,
+            key_size = 8,
             dim_sizeof = [3, 5]
         },
         make_keymapper(Schema)
@@ -620,14 +646,14 @@ make_keymapper2_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
-            scanner = [
+            vec_scanner = [
                 [
-                    #scan_action{src_bitmask = 2#11111, src_offset = 3, dst_offset = 8},
-                    #scan_action{src_bitmask = 2#111, src_offset = 0, dst_offset = 0}
+                    #scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 3, scalar_offset = 8},
+                    #scan_action{vec_coord_bitmask = 2#111, vec_coord_offset = 0, scalar_offset = 0}
                 ],
-                [#scan_action{src_bitmask = 2#11111, src_offset = 0, dst_offset = 3}]
+                [#scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 0, scalar_offset = 3}]
             ],
-            size = 13,
+            key_size = 13,
             dim_sizeof = [8, 5]
         },
         make_keymapper(Schema)

From 698ba3f2716dbb76920ad545217e67a0c8420bc7 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 31 Jan 2024 00:17:41 +0100
Subject: [PATCH 163/273] fix(ds): Optimize
 emqx_ds_bitmask_keymapper:make_filter

This optimization makes idle polling faster
---
 .../emqx_persistent_session_ds_inflight.erl   |  12 +-
 .../src/emqx_ds_bitmask_keymapper.erl         | 292 +++++++++++-------
 2 files changed, 190 insertions(+), 114 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index a769fce64..1a603abde 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -16,7 +16,15 @@
 -module(emqx_persistent_session_ds_inflight).
 
 %% API:
--export([new/1, push/2, pop/1, n_buffered/2, n_inflight/1, inc_send_quota/1, receive_maximum/1]).
+-export([
+    new/1,
+    push/2,
+    pop/1,
+    n_buffered/2,
+    n_inflight/1,
+    inc_send_quota/1,
+    receive_maximum/1
+]).
 
 %% internal exports:
 -export([]).
@@ -107,7 +115,7 @@ pop(Rec0) ->
             undefined
     end.
 
--spec n_buffered(0..2 | all, t()) -> non_neg_integer().
+-spec n_buffered(?QOS_0..?QOS_2 | all, t()) -> non_neg_integer().
 n_buffered(?QOS_0, #inflight{n_qos0 = NQos0}) ->
     NQos0;
 n_buffered(?QOS_1, #inflight{n_qos1 = NQos1}) ->
diff --git a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
index 99831a6df..97d689ead 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
@@ -95,14 +95,14 @@
 %% Notes on the terminology:
 %%
 %% - "Coordinates" of the original message (usually topic and the
-%% timestamp, like in the example above) will be referred as the
+%% timestamp, like in the example above) will be referred to as the
 %% "vector".
 %%
 %% - The 1D scalar that these coordinates are transformed to will be
-%% referred as the "scalar".
+%% referred to as the "scalar".
 %%
-%% - Binary representation of the scalar if fixed size will be
-%% referred as the "key".
+%% - Fixed-size binary representation of the scalar is called the
+%% "key".
 %%
 %%================================================================================
 
@@ -122,13 +122,15 @@
     bitsize/1
 ]).
 
--export_type([vector/0, key/0, dimension/0, offset/0, bitsize/0, bitsource/0, keymapper/0]).
+-export_type([vector/0, scalar/0, key/0, dimension/0, offset/0, bitsize/0, bitsource/0, keymapper/0]).
 
 -compile(
     {inline, [
         ones/1,
         extract/2,
-        extract_inv/2
+        extract_inv/2,
+        constr_adjust_min/2,
+        constr_adjust_max/2
     ]}
 ).
 
@@ -150,12 +152,13 @@
 %% N-th coordinate of a vector:
 -type dimension() :: pos_integer().
 
+-type key() :: binary().
+
 -type offset() :: non_neg_integer().
 
 -type bitsize() :: pos_integer().
 
-%% The resulting 1D key:
--type key() :: non_neg_integer().
+-type scalar() :: non_neg_integer().
 
 -type bitsource() ::
     %% Consume `_Size` bits from timestamp starting at `_Offset`th
@@ -177,17 +180,21 @@
 
 -type scan_action() :: #scan_action{}.
 
--type scanner() :: [[scan_action()]].
+-type scanner() :: [_CoorScanActions :: [scan_action()]].
 
 -record(keymapper, {
     %% The original schema of the transformation:
     schema :: [bitsource()],
+    %% Number of dimensions:
+    vec_n_dim :: non_neg_integer(),
     %% List of operations used to map a vector to the scalar
     vec_scanner :: scanner(),
     %% Total size of the resulting key, in bits:
     key_size :: non_neg_integer(),
-    %% Bit size of each dimenstion of the vector:
-    dim_sizeof :: [non_neg_integer()]
+    %% Bit size of each dimension of the vector:
+    vec_coord_size :: [non_neg_integer()],
+    %% Maximum offset of the part, for each the vector element:
+    vec_max_offset :: [offset()]
 }).
 
 -opaque keymapper() :: #keymapper{}.
@@ -211,6 +218,9 @@
 %% Note: order of bitsources is important. First element of the list
 %% is mapped to the _least_ significant bits of the key, and the last
 %% element becomes most significant bits.
+%%
+%% Warning: currently the algorithm doesn't handle situations when
+%% parts of a vector element are _reordered_ in the resulting scalar.
 -spec make_keymapper([bitsource()]) -> keymapper().
 make_keymapper(Bitsources) ->
     Arr0 = array:new([{fixed, false}, {default, {0, []}}]),
@@ -218,7 +228,9 @@ make_keymapper(Bitsources) ->
         fun(DestOffset, {Dim0, Offset, Size}, Acc) ->
             Dim = Dim0 - 1,
             Action = #scan_action{
-                vec_coord_bitmask = ones(Size), vec_coord_offset = Offset, scalar_offset = DestOffset
+                vec_coord_bitmask = ones(Size),
+                vec_coord_offset = Offset,
+                scalar_offset = DestOffset
             },
             {DimSizeof, Actions} = array:get(Dim, Acc),
             array:set(Dim, {DimSizeof + Size, [Action | Actions]}, Acc)
@@ -227,11 +239,15 @@ make_keymapper(Bitsources) ->
         Bitsources
     ),
     {DimSizeof, Scanner} = lists:unzip(array:to_list(Arr)),
+    NDim = length(Scanner),
+    MaxOffsets = vec_max_offset(NDim, Bitsources),
     #keymapper{
         schema = Bitsources,
+        vec_n_dim = length(Scanner),
         vec_scanner = Scanner,
         key_size = Size,
-        dim_sizeof = DimSizeof
+        vec_coord_size = DimSizeof,
+        vec_max_offset = MaxOffsets
     }.
 
 -spec bitsize(keymapper()) -> pos_integer().
@@ -241,7 +257,7 @@ bitsize(#keymapper{key_size = Size}) ->
 %% @doc Map N-dimensional vector to a scalar key.
 %%
 %% Note: this function is not injective.
--spec vector_to_key(keymapper(), vector()) -> key().
+-spec vector_to_key(keymapper(), vector()) -> scalar().
 vector_to_key(#keymapper{vec_scanner = []}, []) ->
     0;
 vector_to_key(#keymapper{vec_scanner = [Actions | Scanner]}, [Coord | Vector]) ->
@@ -249,7 +265,7 @@ vector_to_key(#keymapper{vec_scanner = [Actions | Scanner]}, [Coord | Vector]) -
 
 %% @doc Same as `vector_to_key', but it works with binaries, and outputs a binary.
 -spec bin_vector_to_key(keymapper(), [binary()]) -> binary().
-bin_vector_to_key(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size}, Binaries) ->
+bin_vector_to_key(Keymapper = #keymapper{vec_coord_size = DimSizeof, key_size = Size}, Binaries) ->
     Vec = lists:zipwith(
         fun(Bin, SizeOf) ->
             <<Int:SizeOf>> = Bin,
@@ -265,7 +281,7 @@ bin_vector_to_key(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size
 %%
 %% Note: `vector_to_key(key_to_vector(K)) = K' but
 %% `key_to_vector(vector_to_key(V)) = V' is not guaranteed.
--spec key_to_vector(keymapper(), key()) -> vector().
+-spec key_to_vector(keymapper(), scalar()) -> vector().
 key_to_vector(#keymapper{vec_scanner = Scanner}, Key) ->
     lists:map(
         fun(Actions) ->
@@ -281,8 +297,8 @@ key_to_vector(#keymapper{vec_scanner = Scanner}, Key) ->
     ).
 
 %% @doc Same as `key_to_vector', but it works with binaries.
--spec bin_key_to_vector(keymapper(), binary()) -> [binary()].
-bin_key_to_vector(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size}, BinKey) ->
+-spec bin_key_to_vector(keymapper(), key()) -> [binary()].
+bin_key_to_vector(Keymapper = #keymapper{vec_coord_size = DimSizeof, key_size = Size}, BinKey) ->
     <<Key:Size>> = BinKey,
     Vector = key_to_vector(Keymapper, Key),
     lists:zipwith(
@@ -294,7 +310,7 @@ bin_key_to_vector(Keymapper = #keymapper{dim_sizeof = DimSizeof, key_size = Size
     ).
 
 %% @doc Transform a bitstring to a key
--spec bitstring_to_key(keymapper(), bitstring()) -> key().
+-spec bitstring_to_key(keymapper(), bitstring()) -> scalar().
 bitstring_to_key(#keymapper{key_size = Size}, Bin) ->
     case Bin of
         <<Key:Size>> ->
@@ -304,58 +320,21 @@ bitstring_to_key(#keymapper{key_size = Size}, Bin) ->
     end.
 
 %% @doc Transform key to a fixed-size bistring
--spec key_to_bitstring(keymapper(), key()) -> bitstring().
+-spec key_to_bitstring(keymapper(), scalar()) -> bitstring().
 key_to_bitstring(#keymapper{key_size = Size}, Key) ->
     <<Key:Size>>.
 
 %% @doc Create a filter object that facilitates range scans.
 -spec make_filter(keymapper(), [coord_range()]) -> filter().
 make_filter(
-    KeyMapper = #keymapper{schema = Schema, dim_sizeof = DimSizeof, key_size = TotalSize}, Filter0
+    KeyMapper = #keymapper{schema = Schema, key_size = TotalSize},
+    Filter0
 ) ->
-    NDim = length(DimSizeof),
-    %% Transform "symbolic" constraints to ranges:
-    Filter1 = constraints_to_ranges(KeyMapper, Filter0),
-    {Bitmask, Bitfilter} = make_bitfilter(KeyMapper, Filter1),
-    %% Calculate maximum source offset as per bitsource specification:
-    MaxOffset = lists:foldl(
-        fun({Dim, Offset, _Size}, Acc) ->
-            maps:update_with(
-                Dim, fun(OldVal) -> max(OldVal, Offset) end, maps:merge(#{Dim => 0}, Acc)
-            )
-        end,
-        #{},
-        Schema
-    ),
-    %% Adjust minimum and maximum values for each interval like this:
-    %%
-    %% Min: 110100|101011 -> 110100|00000
-    %% Max: 110101|001011 -> 110101|11111
-    %%            ^
-    %%            |
-    %%       max offset
-    %%
-    %% This is needed so when we increment the vector, we always scan
-    %% the full range of least significant bits.
-    Filter2 = lists:zipwith(
-        fun
-            ({Val, Val}, _Dim) ->
-                {Val, Val};
-            ({Min0, Max0}, Dim) ->
-                Offset = maps:get(Dim, MaxOffset, 0),
-                %% Set least significant bits of Min to 0:
-                Min = (Min0 bsr Offset) bsl Offset,
-                %% Set least significant bits of Max to 1:
-                Max = Max0 bor ones(Offset),
-                {Min, Max}
-        end,
-        Filter1,
-        lists:seq(1, NDim)
-    ),
-    %% Project the vector into "bitsource coordinate system":
+    {Intervals, Bitmask, Bitfilter} = transform_constraints(KeyMapper, Filter0),
+    %% Project the intervals into the "bitsource coordinate system":
     {_, Filter} = fold_bitsources(
         fun(DstOffset, {Dim, SrcOffset, Size}, Acc) ->
-            {Min0, Max0} = lists:nth(Dim, Filter2),
+            {Min0, Max0} = element(Dim, Intervals),
             Min = (Min0 bsr SrcOffset) band ones(Size),
             Max = (Max0 bsr SrcOffset) band ones(Size),
             Action = #filter_scan_action{
@@ -369,7 +348,7 @@ make_filter(
         [],
         Schema
     ),
-    Ranges = array:from_list(lists:reverse(Filter)),
+    Ranges = list_to_tuple(lists:reverse(Filter)),
     %% Compute estimated upper and lower bounds of a _continous_
     %% interval where all keys lie:
     case Filter of
@@ -377,6 +356,7 @@ make_filter(
             RangeMin = 0,
             RangeMax = 0;
         [#filter_scan_action{offset = MSBOffset, min = MSBMin, max = MSBMax} | _] ->
+            %% Hack: currently this function only considers the first bitsource:
             RangeMin = MSBMin bsl MSBOffset,
             RangeMax = MSBMax bsl MSBOffset bor ones(MSBOffset)
     end,
@@ -400,7 +380,7 @@ make_filter(
 %% If these conditions cannot be satisfied, return `overflow'.
 %%
 %% Corollary: `K' may be equal to `K0'.
--spec ratchet(filter(), key()) -> key() | overflow.
+-spec ratchet(filter(), scalar()) -> scalar() | overflow.
 ratchet(#filter{bitsource_ranges = Ranges, range_max = Max}, Key) when Key =< Max ->
     %% This function works in two steps: first, it finds the position
     %% of bitsource ("pivot point") corresponding to the part of the
@@ -419,7 +399,7 @@ ratchet(#filter{bitsource_ranges = Ranges, range_max = Max}, Key) when Key =< Ma
     %% point.
     %%
     %% 3. The rest of key stays the same
-    NDim = array:size(Ranges),
+    NDim = tuple_size(Ranges),
     case ratchet_scan(Ranges, NDim, Key, 0, {_Pivot0 = -1, _Increment0 = 0}, _Carry = 0) of
         overflow ->
             overflow;
@@ -482,7 +462,9 @@ ratchet_scan(_Ranges, NDim, _Key, NDim, _Pivot, 1) ->
     %% We've reached the end, but key is still not large enough:
     overflow;
 ratchet_scan(Ranges, NDim, Key, I, Pivot0, Carry) ->
-    #filter_scan_action{offset = Offset, size = Size, min = Min, max = Max} = array:get(I, Ranges),
+    #filter_scan_action{offset = Offset, size = Size, min = Min, max = Max} = element(
+        I + 1, Ranges
+    ),
     %% Extract I-th element of the vector from the original key:
     Elem = ((Key bsr Offset) band ones(Size)) + Carry,
     if
@@ -516,7 +498,7 @@ ratchet_scan(Ranges, NDim, Key, I, Pivot0, Carry) ->
 ratchet_do(_Ranges, _Key, I, _Pivot, _Increment) when I < 0 ->
     0;
 ratchet_do(Ranges, Key, I, Pivot, Increment) ->
-    #filter_scan_action{offset = Offset, size = Size, min = Min} = array:get(I, Ranges),
+    #filter_scan_action{offset = Offset, size = Size, min = Min} = element(I + 1, Ranges),
     Mask = ones(Offset + Size) bxor ones(Offset),
     Elem =
         if
@@ -533,46 +515,122 @@ ratchet_do(Ranges, Key, I, Pivot, Increment) ->
     %% ),
     Elem bor ratchet_do(Ranges, Key, I - 1, Pivot, Increment).
 
--spec make_bitfilter(keymapper(), [{non_neg_integer(), non_neg_integer()}]) ->
-    {non_neg_integer(), non_neg_integer()}.
-make_bitfilter(Keymapper = #keymapper{dim_sizeof = DimSizeof}, Ranges) ->
-    L = lists:zipwith(
-        fun
-            ({N, N}, Bits) ->
-                %% For strict equality we can employ bitmask:
-                {ones(Bits), N};
-            (_, _) ->
-                {0, 0}
+%% Calculate maximum offset for each dimension of the vector.
+%%
+%% These offsets are cached because during the creation of the filter
+%% we need to adjust the search interval for the presence of holes.
+-spec vec_max_offset(non_neg_integer(), [bitsource()]) -> array:array(offset()).
+vec_max_offset(NDim, Bitsources) ->
+    Arr0 = array:new([{size, NDim}, {default, 0}, {fixed, true}]),
+    Arr = lists:foldl(
+        fun({Dimension, Offset, _Size}, Acc) ->
+            OldVal = array:get(Dimension - 1, Acc),
+            array:set(Dimension - 1, max(Offset, OldVal), Acc)
         end,
-        Ranges,
-        DimSizeof
+        Arr0,
+        Bitsources
     ),
-    {Bitmask, Bitfilter} = lists:unzip(L),
-    {vector_to_key(Keymapper, Bitmask), vector_to_key(Keymapper, Bitfilter)}.
+    array:to_list(Arr).
 
 %% Transform constraints into a list of closed intervals that the
 %% vector elements should lie in.
-constraints_to_ranges(#keymapper{dim_sizeof = DimSizeof}, Filter) ->
-    lists:zipwith(
-        fun(Constraint, Bitsize) ->
-            Max = ones(Bitsize),
-            case Constraint of
-                any ->
-                    {0, Max};
-                {'=', infinity} ->
-                    {Max, Max};
-                {'=', Val} when Val =< Max ->
-                    {Val, Val};
-                {'>=', Val} when Val =< Max ->
-                    {Val, Max};
-                {A, '..', B} when A =< Max, B =< Max ->
-                    {A, B}
-            end
-        end,
-        Filter,
-        DimSizeof
+transform_constraints(
+    #keymapper{
+        vec_scanner = Scanner, vec_coord_size = DimSizeL, vec_max_offset = MaxOffsetL
+    },
+    FilterL
+) ->
+    do_transform_constraints(
+        Scanner, DimSizeL, MaxOffsetL, FilterL, [], 0, 0
     ).
 
+do_transform_constraints([], [], [], [], RangeAcc, BitmaskAcc, BitfilterAcc) ->
+    {
+        list_to_tuple(lists:reverse(RangeAcc)),
+        BitmaskAcc,
+        BitfilterAcc
+    };
+do_transform_constraints(
+    [Actions | Scanner],
+    [DimSize | DimSizeL],
+    [MaxOffset | MaxOffsetL],
+    [Filter | FilterL],
+    RangeAcc,
+    BitmaskAcc,
+    BitfilterAcc
+) ->
+    %% This function does four things:
+    %%
+    %% 1. It transforms the list of "symbolic inequations" to a list
+    %% of closed intervals for each vector element.
+    %%
+    %% 2. In addition, this function adjusts minimum and maximum
+    %% values for each interval like this:
+    %%
+    %% Min: 110100|101011 -> 110100|00000
+    %% Max: 110101|001011 -> 110101|11111
+    %%            ^
+    %%            |
+    %%       max offset
+    %%
+    %% This is needed so when we increment the vector, we always scan
+    %% the full range of the least significant bits.
+    %%
+    %% This leads to some out-of-range elements being exposed at the
+    %% beginning and the end of the range, so they should be filtered
+    %% out during post-processing.
+    %%
+    %% 3. It calculates the bitmask that can be used together with the
+    %% bitfilter (see 4) to quickly filter out keys that don't satisfy
+    %% the strict equations, using `Key && Bitmask != Bitfilter' check
+    %%
+    %% 4. It calculates the bitfilter
+    Max = ones(DimSize),
+    case Filter of
+        any ->
+            Range = {0, Max},
+            Bitmask = 0,
+            Bitfilter = 0;
+        {'=', infinity} ->
+            Range = {Max, Max},
+            Bitmask = Max,
+            Bitfilter = Max;
+        {'=', Val} when Val =< Max ->
+            Range = {Val, Val},
+            Bitmask = Max,
+            Bitfilter = Val;
+        {'>=', Val} when Val =< Max ->
+            Range = {constr_adjust_min(MaxOffset, Val), constr_adjust_max(MaxOffset, Max)},
+            Bitmask = 0,
+            Bitfilter = 0;
+        {A, '..', B} when A =< Max, B =< Max ->
+            Range = {constr_adjust_min(MaxOffset, A), constr_adjust_max(MaxOffset, B)},
+            Bitmask = 0,
+            Bitfilter = 0
+    end,
+    do_transform_constraints(
+        Scanner,
+        DimSizeL,
+        MaxOffsetL,
+        FilterL,
+        [Range | RangeAcc],
+        vec_elem_to_key(Bitmask, Actions, BitmaskAcc),
+        vec_elem_to_key(Bitfilter, Actions, BitfilterAcc)
+    ).
+
+constr_adjust_min(MaxOffset, Num) ->
+    (Num bsr MaxOffset) bsl MaxOffset.
+
+constr_adjust_max(MaxOffset, Num) ->
+    Num bor ones(MaxOffset).
+
+-spec vec_elem_to_key(non_neg_integer(), [scan_action()], Acc) -> Acc when
+    Acc :: non_neg_integer().
+vec_elem_to_key(_Elem, [], Acc) ->
+    Acc;
+vec_elem_to_key(Elem, [Action | Actions], Acc) ->
+    vec_elem_to_key(Elem, Actions, Acc bor extract(Elem, Action)).
+
 -spec fold_bitsources(fun((_DstOffset :: non_neg_integer(), bitsource(), Acc) -> Acc), Acc, [
     bitsource()
 ]) -> {bitsize(), Acc}.
@@ -595,7 +653,9 @@ do_vector_to_key([Action | Actions], Scanner, Coord, Vector, Acc0) ->
     do_vector_to_key(Actions, Scanner, Coord, Vector, Acc).
 
 -spec extract(_Source :: coord(), scan_action()) -> integer().
-extract(Src, #scan_action{vec_coord_bitmask = SrcBitmask, vec_coord_offset = SrcOffset, scalar_offset = DstOffset}) ->
+extract(Src, #scan_action{
+    vec_coord_bitmask = SrcBitmask, vec_coord_offset = SrcOffset, scalar_offset = DstOffset
+}) ->
     ((Src bsr SrcOffset) band SrcBitmask) bsl DstOffset.
 
 %% extract^-1
@@ -619,9 +679,11 @@ make_keymapper0_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
+            vec_n_dim = 0,
             vec_scanner = [],
             key_size = 0,
-            dim_sizeof = []
+            vec_coord_size = [],
+            vec_max_offset = []
         },
         make_keymapper(Schema)
     ).
@@ -631,12 +693,14 @@ make_keymapper1_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
+            vec_n_dim = 2,
             vec_scanner = [
                 [#scan_action{vec_coord_bitmask = 2#111, vec_coord_offset = 0, scalar_offset = 0}],
                 [#scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 0, scalar_offset = 3}]
             ],
             key_size = 8,
-            dim_sizeof = [3, 5]
+            vec_coord_size = [3, 5],
+            vec_max_offset = [0, 0]
         },
         make_keymapper(Schema)
     ).
@@ -646,15 +710,19 @@ make_keymapper2_test() ->
     ?assertEqual(
         #keymapper{
             schema = Schema,
+            vec_n_dim = 2,
             vec_scanner = [
                 [
-                    #scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 3, scalar_offset = 8},
+                    #scan_action{
+                        vec_coord_bitmask = 2#11111, vec_coord_offset = 3, scalar_offset = 8
+                    },
                     #scan_action{vec_coord_bitmask = 2#111, vec_coord_offset = 0, scalar_offset = 0}
                 ],
                 [#scan_action{vec_coord_bitmask = 2#11111, vec_coord_offset = 0, scalar_offset = 3}]
             ],
             key_size = 13,
-            dim_sizeof = [8, 5]
+            vec_coord_size = [8, 5],
+            vec_max_offset = [3, 0]
         },
         make_keymapper(Schema)
     ).
@@ -757,17 +825,17 @@ ratchet1_test() ->
     Bitsources = [{1, 0, 8}],
     M = make_keymapper(Bitsources),
     F = make_filter(M, [any]),
-    #filter{bitsource_ranges = Rarr} = F,
+    #filter{bitsource_ranges = Ranges} = F,
     ?assertMatch(
-        [
+        {
             #filter_scan_action{
                 offset = 0,
                 size = 8,
                 min = 0,
                 max = 16#ff
             }
-        ],
-        array:to_list(Rarr)
+        },
+        Ranges
     ),
     ?assertEqual(0, ratchet(F, 0)),
     ?assertEqual(16#fa, ratchet(F, 16#fa)),
@@ -847,9 +915,9 @@ ratchet_prop(#filter{bitfilter = Bitfilter, bitmask = Bitmask, size = Size}, Key
     end,
     CheckGaps(Key0 + 1).
 
-mkbmask(Keymapper, Filter0) ->
-    Filter = constraints_to_ranges(Keymapper, Filter0),
-    make_bitfilter(Keymapper, Filter).
+mkbmask(Keymapper, Filter) ->
+    {_Ranges, Bitmask, Bitfilter} = transform_constraints(Keymapper, Filter),
+    {Bitmask, Bitfilter}.
 
 key2vec(Schema, Vector) ->
     Keymapper = make_keymapper(Schema),

From b4a6be0e7c209e1ec89d0a1cc2e1f40c3d198200 Mon Sep 17 00:00:00 2001
From: firest <enlanubo@gmail.com>
Date: Mon, 5 Feb 2024 18:50:31 +0800
Subject: [PATCH 164/273] fix(tdengine): remove redundant codes

---
 .../src/emqx_bridge_tdengine_action_info.erl  | 61 +++----------------
 1 file changed, 9 insertions(+), 52 deletions(-)

diff --git a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl
index 11db9c52e..e545b8826 100644
--- a/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl
+++ b/apps/emqx_bridge_tdengine/src/emqx_bridge_tdengine_action_info.erl
@@ -5,67 +5,24 @@
 
 -behaviour(emqx_action_info).
 
--elvis([{elvis_style, invalid_dynamic_call, disable}]).
-
-%% behaviour callbacks
 -export([
-    action_type_name/0,
-    bridge_v1_config_to_action_config/2,
-    bridge_v1_config_to_connector_config/1,
     bridge_v1_type_name/0,
-    connector_action_config_to_bridge_v1_config/2,
+    action_type_name/0,
     connector_type_name/0,
     schema_module/0
 ]).
 
--import(emqx_utils_conv, [bin/1]).
-
 -define(ACTION_TYPE, tdengine).
 -define(SCHEMA_MODULE, emqx_bridge_tdengine).
 
-action_type_name() -> ?ACTION_TYPE.
-bridge_v1_type_name() -> ?ACTION_TYPE.
-connector_type_name() -> ?ACTION_TYPE.
+bridge_v1_type_name() ->
+    ?ACTION_TYPE.
 
-schema_module() -> ?SCHEMA_MODULE.
+action_type_name() ->
+    ?ACTION_TYPE.
 
-connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
-    MergedConfig =
-        emqx_utils_maps:deep_merge(
-            maps:without(
-                [<<"description">>, <<"local_topic">>, <<"connector">>, <<"data">>],
-                emqx_utils_maps:unindent(<<"parameters">>, ActionConfig)
-            ),
-            ConnectorConfig
-        ),
-    BridgeV1Keys = schema_keys("config"),
-    maps:with(BridgeV1Keys, MergedConfig).
+connector_type_name() ->
+    ?ACTION_TYPE.
 
-bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
-    ActionTopLevelKeys = schema_keys(action_config),
-    ActionParametersKeys = schema_keys(action_parameters),
-    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
-    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
-    emqx_utils_maps:update_if_present(
-        <<"resource_opts">>,
-        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
-        ActionConfig#{<<"connector">> => ConnectorName}
-    ).
-
-bridge_v1_config_to_connector_config(BridgeV1Config) ->
-    ConnectorKeys = schema_keys(emqx_bridge_tdengine_connector, "config_connector"),
-    emqx_utils_maps:update_if_present(
-        <<"resource_opts">>,
-        fun emqx_connector_schema:project_to_connector_resource_opts/1,
-        maps:with(ConnectorKeys, BridgeV1Config)
-    ).
-
-make_config_map(PickKeys, IndentKeys, Config) ->
-    Conf0 = maps:with(PickKeys, Config),
-    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
-
-schema_keys(Name) ->
-    schema_keys(?SCHEMA_MODULE, Name).
-
-schema_keys(Mod, Name) ->
-    [bin(Key) || Key <- proplists:get_keys(Mod:fields(Name))].
+schema_module() ->
+    ?SCHEMA_MODULE.

From ce50055138fedde4b68b72258e76b211fd9a1b51 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Mon, 5 Feb 2024 14:01:17 +0100
Subject: [PATCH 165/273] docs: fix unicode colon symbol

---
 rel/i18n/emqx_auto_subscribe_schema.hocon | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rel/i18n/emqx_auto_subscribe_schema.hocon b/rel/i18n/emqx_auto_subscribe_schema.hocon
index e26ed2546..b0c7fdf37 100644
--- a/rel/i18n/emqx_auto_subscribe_schema.hocon
+++ b/rel/i18n/emqx_auto_subscribe_schema.hocon
@@ -8,7 +8,7 @@ auto_subscribe.label:
 
 nl.desc:
 """Default value 0.
-MQTT v3.1.1： if you subscribe to the topic published by yourself, you will receive all messages that you published.
+MQTT v3.1.1: if you subscribe to the topic published by yourself, you will receive all messages that you published.
 MQTT v5: if you set this option as 1 when subscribing, the server will not forward the message you published to you."""
 
 nl.label:

From d7b0456bb08d076dce83c6915b9f7b29bb8c43ee Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Mon, 5 Feb 2024 15:49:48 +0100
Subject: [PATCH 166/273] feat: rename emqx ctl cluster_sync 'tnxid' to
 'inspect'

---
 apps/emqx_conf/src/emqx_conf_cli.erl | 18 ++++++++++++------
 changes/ce/feat-12483.en.md          |  2 ++
 2 files changed, 14 insertions(+), 6 deletions(-)
 create mode 100644 changes/ce/feat-12483.en.md

diff --git a/apps/emqx_conf/src/emqx_conf_cli.erl b/apps/emqx_conf/src/emqx_conf_cli.erl
index d519e2e05..3a1261b30 100644
--- a/apps/emqx_conf/src/emqx_conf_cli.erl
+++ b/apps/emqx_conf/src/emqx_conf_cli.erl
@@ -89,6 +89,10 @@ admins(["skip", Node0]) ->
     emqx_cluster_rpc:skip_failed_commit(Node),
     status();
 admins(["tnxid", TnxId0]) ->
+    %% changed to 'inspect' in 5.6
+    %% TODO: delete this clause in 5.7
+    admins(["inspect", TnxId0]);
+admins(["inspect", TnxId0]) ->
     TnxId = list_to_integer(TnxId0),
     print(emqx_cluster_rpc:query(TnxId));
 admins(["fast_forward"]) ->
@@ -145,12 +149,14 @@ usage_conf() ->
 
 usage_sync() ->
     [
-        {"conf cluster_sync status", "Show cluster config sync status summary"},
-        {"conf cluster_sync skip [node]", "Increase one commit on specific node"},
-        {"conf cluster_sync tnxid <TnxId>",
-            "Display detailed information of the config change transaction at TnxId"},
-        {"conf cluster_sync fast_forward [node] [tnx_id]",
-            "Fast-forward config change transaction to tnx_id on the given node."
+        {"conf cluster_sync status", "Show cluster config sync status summary for all nodes."},
+        {"conf cluster_sync inspect <ID>",
+            "Inspect detailed information of the config change transaction at the given commit ID"},
+        {"conf cluster_sync skip [node]",
+            "Increment the (currently failing) commit on the given node.\n"
+            "WARNING: This results in inconsistent configs among the clustered nodes."},
+        {"conf cluster_sync fast_forward [node] <ID>",
+            "Fast-forward config change to the given commit ID on the given node.\n"
             "WARNING: This results in inconsistent configs among the clustered nodes."}
     ].
 
diff --git a/changes/ce/feat-12483.en.md b/changes/ce/feat-12483.en.md
new file mode 100644
index 000000000..ef49dedbb
--- /dev/null
+++ b/changes/ce/feat-12483.en.md
@@ -0,0 +1,2 @@
+Renamed `emqx ctl conf cluster_sync tnxid ID` to `emqx ctl conf cluster_sync inspect ID`.
+For backward compatibility, `tnxid` is kept, but considered deprecated and will be removed in 5.7.

From 4665837cf02ee06fd6b86ffbf8dbc3df3409b83b Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 5 Feb 2024 16:52:06 +0100
Subject: [PATCH 167/273] fix(ds): Apply review remarks

---
 .../src/emqx_ds_bitmask.hrl                   |  6 ++---
 .../src/emqx_ds_bitmask_keymapper.erl         | 23 +++++++++++++++----
 2 files changed, 22 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_bitmask.hrl b/apps/emqx_durable_storage/src/emqx_ds_bitmask.hrl
index 31af0e034..943429924 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_bitmask.hrl
+++ b/apps/emqx_durable_storage/src/emqx_ds_bitmask.hrl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -27,8 +27,8 @@
     size :: non_neg_integer(),
     bitfilter :: non_neg_integer(),
     bitmask :: non_neg_integer(),
-    %% Ranges (in _bitsource_ basis):
-    bitsource_ranges :: array:array(#filter_scan_action{}),
+    %% Ranges (in _bitsource_ basis), array of `#filter_scan_action{}':
+    bitsource_ranges :: tuple(),
     range_min :: non_neg_integer(),
     range_max :: non_neg_integer()
 }).
diff --git a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
index 97d689ead..e522f2a09 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_bitmask_keymapper.erl
@@ -219,8 +219,14 @@
 %% is mapped to the _least_ significant bits of the key, and the last
 %% element becomes most significant bits.
 %%
-%% Warning: currently the algorithm doesn't handle situations when
-%% parts of a vector element are _reordered_ in the resulting scalar.
+%% Warning: currently the algorithm doesn't handle the following
+%% situations, and will produce WRONG results WITHOUT warning:
+%%
+%% - Parts of the vector elements are reordered in the resulting
+%% scalar, i.e. its LSBs are mapped to more significant bits in the
+%% scalar than its MSBs.
+%%
+%% - Overlapping bitsources.
 -spec make_keymapper([bitsource()]) -> keymapper().
 make_keymapper(Bitsources) ->
     Arr0 = array:new([{fixed, false}, {default, {0, []}}]),
@@ -243,7 +249,7 @@ make_keymapper(Bitsources) ->
     MaxOffsets = vec_max_offset(NDim, Bitsources),
     #keymapper{
         schema = Bitsources,
-        vec_n_dim = length(Scanner),
+        vec_n_dim = NDim,
         vec_scanner = Scanner,
         key_size = Size,
         vec_coord_size = DimSizeof,
@@ -257,6 +263,9 @@ bitsize(#keymapper{key_size = Size}) ->
 %% @doc Map N-dimensional vector to a scalar key.
 %%
 %% Note: this function is not injective.
+%%
+%% TODO: should be renamed to `vector_to_scalar' to make terminology
+%% consistent.
 -spec vector_to_key(keymapper(), vector()) -> scalar().
 vector_to_key(#keymapper{vec_scanner = []}, []) ->
     0;
@@ -281,6 +290,9 @@ bin_vector_to_key(Keymapper = #keymapper{vec_coord_size = DimSizeof, key_size =
 %%
 %% Note: `vector_to_key(key_to_vector(K)) = K' but
 %% `key_to_vector(vector_to_key(V)) = V' is not guaranteed.
+%%
+%% TODO: should be renamed to `scalar_to_vector' to make terminology
+%% consistent.
 -spec key_to_vector(keymapper(), scalar()) -> vector().
 key_to_vector(#keymapper{vec_scanner = Scanner}, Key) ->
     lists:map(
@@ -297,6 +309,9 @@ key_to_vector(#keymapper{vec_scanner = Scanner}, Key) ->
     ).
 
 %% @doc Same as `key_to_vector', but it works with binaries.
+%%
+%% TODO: should be renamed to `key_to_vector' to make terminology
+%% consistent.
 -spec bin_key_to_vector(keymapper(), key()) -> [binary()].
 bin_key_to_vector(Keymapper = #keymapper{vec_coord_size = DimSizeof, key_size = Size}, BinKey) ->
     <<Key:Size>> = BinKey,
@@ -519,7 +534,7 @@ ratchet_do(Ranges, Key, I, Pivot, Increment) ->
 %%
 %% These offsets are cached because during the creation of the filter
 %% we need to adjust the search interval for the presence of holes.
--spec vec_max_offset(non_neg_integer(), [bitsource()]) -> array:array(offset()).
+-spec vec_max_offset(non_neg_integer(), [bitsource()]) -> [offset()].
 vec_max_offset(NDim, Bitsources) ->
     Arr0 = array:new([{size, NDim}, {default, 0}, {fixed, true}]),
     Arr = lists:foldl(

From b444c82a42904aeddb5c7522073a85c8dd03805f Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Thu, 25 Jan 2024 10:18:35 +0800
Subject: [PATCH 168/273] feat: rabbitmq bridge v2 integration

---
 .../docker-compose-rabbitmq.yaml              |   4 +-
 apps/emqx/test/emqx_common_test_helpers.erl   |   9 +-
 apps/emqx_bridge/src/emqx_action_info.erl     |   7 +-
 apps/emqx_bridge/src/emqx_bridge_app.erl      |   1 +
 .../src/emqx_bridge_rabbitmq.app.src          |   3 +-
 .../src/emqx_bridge_rabbitmq.erl              |   4 +-
 .../src/emqx_bridge_rabbitmq_action_info.erl  |  77 ++
 .../src/emqx_bridge_rabbitmq_app.erl          |  26 +
 .../src/emqx_bridge_rabbitmq_connector.erl    | 709 ++++++++----------
 .../emqx_bridge_rabbitmq_connector_schema.erl | 139 ++++
 .../emqx_bridge_rabbitmq_pubsub_schema.erl    | 273 +++++++
 .../src/emqx_bridge_rabbitmq_source_sup.erl   |  28 +
 .../emqx_bridge_rabbitmq_source_worker.erl    |  82 ++
 .../src/emqx_bridge_rabbitmq_sup.erl          |  75 ++
 .../test/emqx_bridge_rabbitmq_SUITE.erl       | 199 +++--
 .../emqx_bridge_rabbitmq_connector_SUITE.erl  |  65 +-
 .../src/schema/emqx_connector_ee_schema.erl   |  14 +
 .../src/schema/emqx_connector_schema.erl      |   5 +-
 rebar.config                                  |   1 +
 19 files changed, 1173 insertions(+), 548 deletions(-)
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_action_info.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_app.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl

diff --git a/.ci/docker-compose-file/docker-compose-rabbitmq.yaml b/.ci/docker-compose-file/docker-compose-rabbitmq.yaml
index d362eb4e0..03ff12f6f 100644
--- a/.ci/docker-compose-file/docker-compose-rabbitmq.yaml
+++ b/.ci/docker-compose-file/docker-compose-rabbitmq.yaml
@@ -9,10 +9,12 @@ services:
     expose:
       - "15672"
       - "5672"
+      - "5671"
     # We don't want to take ports from the host
-    # ports:
+    #ports:
     #   - "15672:15672"
     #   - "5672:5672"
+    #   - "5671:5671"
     volumes:
       - ./certs/ca.crt:/opt/certs/ca.crt
       - ./certs/server.crt:/opt/certs/server.crt
diff --git a/apps/emqx/test/emqx_common_test_helpers.erl b/apps/emqx/test/emqx_common_test_helpers.erl
index 81314ce23..8a0d31fa9 100644
--- a/apps/emqx/test/emqx_common_test_helpers.erl
+++ b/apps/emqx/test/emqx_common_test_helpers.erl
@@ -584,7 +584,14 @@ is_tcp_server_available(Host, Port) ->
     Timeout :: integer()
 ) -> boolean.
 is_tcp_server_available(Host, Port, Timeout) ->
-    case gen_tcp:connect(Host, Port, [], Timeout) of
+    case
+        gen_tcp:connect(
+            emqx_utils_conv:str(Host),
+            emqx_utils_conv:int(Port),
+            [],
+            Timeout
+        )
+    of
         {ok, Socket} ->
             gen_tcp:close(Socket),
             true;
diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 9a4de69ed..e74e6aa3e 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -39,6 +39,7 @@
     transform_bridge_v1_config_to_action_config/4,
     action_convert_from_connector/3
 ]).
+-export([clean_cache/0]).
 
 -callback bridge_v1_type_name() ->
     atom()
@@ -77,7 +78,7 @@
 ]).
 
 %% ====================================================================
-%% Hadcoded list of info modules for actions
+%% HardCoded list of info modules for actions
 %% TODO: Remove this list once we have made sure that all relevants
 %% apps are loaded before this module is called.
 %% ====================================================================
@@ -103,6 +104,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_iotdb_action_info,
         emqx_bridge_es_action_info,
         emqx_bridge_opents_action_info,
+        emqx_bridge_rabbitmq_action_info,
         emqx_bridge_greptimedb_action_info,
         emqx_bridge_tdengine_action_info
     ].
@@ -313,6 +315,9 @@ build_cache() ->
     persistent_term:put(internal_emqx_action_persistent_term_info_key(), ActionInfoMap),
     ActionInfoMap.
 
+clean_cache() ->
+    persistent_term:erase(internal_emqx_action_persistent_term_info_key()).
+
 action_info_modules() ->
     ActionInfoModules = [
         action_info_modules(App)
diff --git a/apps/emqx_bridge/src/emqx_bridge_app.erl b/apps/emqx_bridge/src/emqx_bridge_app.erl
index 321f59f28..285102aa9 100644
--- a/apps/emqx_bridge/src/emqx_bridge_app.erl
+++ b/apps/emqx_bridge/src/emqx_bridge_app.erl
@@ -44,6 +44,7 @@ stop(_State) ->
     emqx_conf:remove_handler(?TOP_LELVE_HDLR_PATH),
     ok = emqx_bridge:unload(),
     ok = emqx_bridge_v2:unload(),
+    emqx_action_info:clean_cache(),
     ok.
 
 -if(?EMQX_RELEASE_EDITION == ee).
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.app.src b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.app.src
index 2e1ec3444..a885cc6bc 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.app.src
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.app.src
@@ -1,7 +1,8 @@
 {application, emqx_bridge_rabbitmq, [
     {description, "EMQX Enterprise RabbitMQ Bridge"},
-    {vsn, "0.1.7"},
+    {vsn, "0.1.8"},
     {registered, []},
+    {mod, {emqx_bridge_rabbitmq_app, []}},
     {applications, [
         kernel,
         stdlib,
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
index 608e0a669..6aa2cc038 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_bridge_rabbitmq).
 
@@ -22,7 +22,7 @@
 ]).
 
 %% -------------------------------------------------------------------------------------------------
-%% Callback used by HTTP API
+%% Callback used by HTTP API v1
 %% -------------------------------------------------------------------------------------------------
 
 conn_bridge_examples(Method) ->
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_action_info.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_action_info.erl
new file mode 100644
index 000000000..cd7d340de
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_action_info.erl
@@ -0,0 +1,77 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rabbitmq_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_config_to_action_config/2,
+    is_source/0,
+    is_action/0
+]).
+
+-define(SCHEMA_MODULE, emqx_bridge_rabbitmq_pubsub_schema).
+-import(emqx_utils_conv, [bin/1]).
+
+bridge_v1_type_name() -> rabbitmq.
+
+action_type_name() -> rabbitmq.
+
+connector_type_name() -> rabbitmq.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+is_source() -> true.
+is_action() -> true.
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ActionTopLevelKeys = schema_keys(?SCHEMA_MODULE:fields(publisher_action)),
+    ActionParametersKeys = schema_keys(?SCHEMA_MODULE:fields(action_parameters)),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ConnectorTopLevelKeys = schema_keys(
+        emqx_bridge_rabbitmq_connector_schema:fields("config_connector")
+    ),
+    ConnectorKeys = (maps:keys(BridgeV1Config) -- (ActionKeys -- ConnectorTopLevelKeys)),
+    ConnectorConfig0 = maps:with(ConnectorKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        ConnectorConfig0
+    ).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(?SCHEMA_MODULE:fields(publisher_action)),
+    ActionParametersKeys = schema_keys(?SCHEMA_MODULE:fields(action_parameters)),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig0 = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig0#{<<"connector">> => ConnectorName}
+    ).
+
+schema_keys(Schema) ->
+    [bin(Key) || {Key, _} <- Schema].
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_app.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_app.erl
new file mode 100644
index 000000000..e43a70620
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_app.erl
@@ -0,0 +1,26 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_rabbitmq_app).
+
+-behaviour(application).
+
+-export([start/2, stop/1]).
+
+start(_StartType, _StartArgs) ->
+    emqx_bridge_rabbitmq_sup:start_link().
+
+stop(_State) ->
+    ok.
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
index 2e4074f79..45d21d8d0 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
@@ -1,9 +1,9 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_rabbitmq_connector).
-
+%-feature(maybe_expr, enable).
 -include_lib("emqx_connector/include/emqx_connector.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 -include_lib("typerefl/include/types.hrl").
@@ -22,17 +22,16 @@
 %% hocon_schema callbacks
 -export([namespace/0, roots/0, fields/1]).
 
-%% HTTP API callbacks
--export([values/1]).
-
 %% emqx_resource callbacks
 -export([
-    %% Required callbacks
     on_start/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
     on_stop/2,
     callback_mode/0,
-    %% Optional callbacks
     on_get_status/2,
+    on_get_channel_status/3,
     on_query/3,
     on_batch_query/3
 ]).
@@ -41,142 +40,18 @@
 -export([connect/1]).
 
 %% Internal callbacks
--export([publish_messages/3]).
+-export([publish_messages/4]).
 
 namespace() -> "rabbitmq".
 
+%% bridge v1
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
+%% bridge v1 called by emqx_bridge_rabbitmq
 fields(config) ->
-    [
-        {server,
-            hoconsc:mk(
-                typerefl:binary(),
-                #{
-                    default => <<"localhost">>,
-                    desc => ?DESC("server")
-                }
-            )},
-        {port,
-            hoconsc:mk(
-                emqx_schema:port_number(),
-                #{
-                    default => 5672,
-                    desc => ?DESC("server")
-                }
-            )},
-        {username,
-            hoconsc:mk(
-                typerefl:binary(),
-                #{
-                    required => true,
-                    desc => ?DESC("username")
-                }
-            )},
-        {password, emqx_connector_schema_lib:password_field(#{required => true})},
-        {pool_size,
-            hoconsc:mk(
-                typerefl:pos_integer(),
-                #{
-                    default => 8,
-                    desc => ?DESC("pool_size")
-                }
-            )},
-        {timeout,
-            hoconsc:mk(
-                emqx_schema:timeout_duration_ms(),
-                #{
-                    default => <<"5s">>,
-                    desc => ?DESC("timeout")
-                }
-            )},
-        {wait_for_publish_confirmations,
-            hoconsc:mk(
-                boolean(),
-                #{
-                    default => true,
-                    desc => ?DESC("wait_for_publish_confirmations")
-                }
-            )},
-        {publish_confirmation_timeout,
-            hoconsc:mk(
-                emqx_schema:timeout_duration_ms(),
-                #{
-                    default => <<"30s">>,
-                    desc => ?DESC("timeout")
-                }
-            )},
-
-        {virtual_host,
-            hoconsc:mk(
-                typerefl:binary(),
-                #{
-                    default => <<"/">>,
-                    desc => ?DESC("virtual_host")
-                }
-            )},
-        {heartbeat,
-            hoconsc:mk(
-                emqx_schema:timeout_duration_ms(),
-                #{
-                    default => <<"30s">>,
-                    desc => ?DESC("heartbeat")
-                }
-            )},
-        %% Things related to sending messages to RabbitMQ
-        {exchange,
-            hoconsc:mk(
-                typerefl:binary(),
-                #{
-                    required => true,
-                    desc => ?DESC("exchange")
-                }
-            )},
-        {routing_key,
-            hoconsc:mk(
-                typerefl:binary(),
-                #{
-                    required => true,
-                    desc => ?DESC("routing_key")
-                }
-            )},
-        {delivery_mode,
-            hoconsc:mk(
-                hoconsc:enum([non_persistent, persistent]),
-                #{
-                    default => non_persistent,
-                    desc => ?DESC("delivery_mode")
-                }
-            )},
-        {payload_template,
-            hoconsc:mk(
-                binary(),
-                #{
-                    default => <<"${.}">>,
-                    desc => ?DESC("payload_template")
-                }
-            )}
-    ] ++ emqx_connector_schema_lib:ssl_fields().
-
-values(post) ->
-    maps:merge(values(put), #{name => <<"connector">>});
-values(get) ->
-    values(post);
-values(put) ->
-    #{
-        server => <<"localhost">>,
-        port => 5672,
-        enable => true,
-        pool_size => 8,
-        type => rabbitmq,
-        username => <<"guest">>,
-        password => <<"******">>,
-        routing_key => <<"my_routing_key">>,
-        payload_template => <<"">>
-    };
-values(_) ->
-    #{}.
+    emqx_bridge_rabbitmq_connector_schema:fields(connector) ++
+        emqx_bridge_rabbitmq_pubsub_schema:fields(action_parameters).
 
 %% ===================================================================
 %% Callbacks defined in emqx_resource
@@ -186,127 +61,84 @@ values(_) ->
 
 callback_mode() -> always_sync.
 
-%% emqx_resource callback
-
-%% emqx_resource callback called when the resource is started
-
--spec on_start(resource_id(), term()) -> {ok, resource_state()} | {error, _}.
-on_start(
-    InstanceID,
-    #{
-        pool_size := PoolSize,
-        payload_template := PayloadTemplate,
-        delivery_mode := InitialDeliveryMode
-    } = InitialConfig
-) ->
-    DeliveryMode =
-        case InitialDeliveryMode of
-            non_persistent -> 1;
-            persistent -> 2
-        end,
-    Config = InitialConfig#{
-        delivery_mode => DeliveryMode
-    },
+on_start(InstanceID, Config) ->
     ?SLOG(info, #{
         msg => "starting_rabbitmq_connector",
         connector => InstanceID,
         config => emqx_utils:redact(Config)
     }),
+    init_secret(),
     Options = [
         {config, Config},
-        %% The pool_size is read by ecpool and decides the number of workers in
-        %% the pool
-        {pool_size, PoolSize},
+        {pool_size, maps:get(pool_size, Config)},
         {pool, InstanceID}
     ],
-    ProcessedTemplate = emqx_placeholder:preproc_tmpl(PayloadTemplate),
-    State = #{
-        poolname => InstanceID,
-        processed_payload_template => ProcessedTemplate,
-        config => Config
-    },
-    %% Initialize RabbitMQ's secret library so that the password is encrypted
-    %% in the log files.
-    case credentials_obfuscation:secret() of
-        ?PENDING_SECRET ->
-            Bytes = crypto:strong_rand_bytes(128),
-            %% The password can appear in log files if we don't do this
-            credentials_obfuscation:set_secret(Bytes);
-        _ ->
-            %% Already initialized
-            ok
-    end,
     case emqx_resource_pool:start(InstanceID, ?MODULE, Options) of
         ok ->
-            {ok, State};
+            {ok, #{channels => #{}}};
         {error, Reason} ->
-            ?SLOG(info, #{
+            ?SLOG(error, #{
                 msg => "rabbitmq_connector_start_failed",
-                error_reason => Reason,
+                reason => Reason,
                 config => emqx_utils:redact(Config)
             }),
             {error, Reason}
     end.
 
-%% emqx_resource callback called when the resource is stopped
-
--spec on_stop(resource_id(), resource_state()) -> term().
-on_stop(
-    ResourceID,
-    _State
+on_add_channel(
+    InstanceId,
+    #{channels := Channels} = State,
+    ChannelId,
+    Config
 ) ->
+    case maps:is_key(ChannelId, Channels) of
+        true ->
+            {error, already_exists};
+        false ->
+            ProcParam = preproc_parameter(Config),
+            case make_channel(InstanceId, ChannelId, ProcParam) of
+                {ok, RabbitChannels} ->
+                    Channel = #{param => ProcParam, rabbitmq => RabbitChannels},
+                    NewChannels = maps:put(ChannelId, Channel, Channels),
+                    {ok, State#{channels => NewChannels}};
+                {error, Error} ->
+                    ?SLOG(error, #{
+                        msg => "failed_to_start_rabbitmq_channel",
+                        instance_id => InstanceId,
+                        params => emqx_utils:redact(Config),
+                        error => Error
+                    }),
+                    {error, Error}
+            end
+    end.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = State, ChannelId) ->
+    try_unsubscribe(ChannelId, Channels),
+    {ok, State#{channels => maps:remove(ChannelId, Channels)}}.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
+on_stop(ResourceID, _State) ->
     ?SLOG(info, #{
         msg => "stopping_rabbitmq_connector",
         connector => ResourceID
     }),
-    stop_clients_and_pool(ResourceID).
-
-stop_clients_and_pool(PoolName) ->
-    Workers = [Worker || {_WorkerName, Worker} <- ecpool:workers(PoolName)],
-    Clients = [
-        begin
-            {ok, Client} = ecpool_worker:client(Worker),
-            Client
-        end
-     || Worker <- Workers
-    ],
-    %% We need to stop the pool before stopping the workers as the pool monitors the workers
-    StopResult = emqx_resource_pool:stop(PoolName),
-    lists:foreach(fun stop_worker/1, Clients),
-    StopResult.
-
-stop_worker({Channel, Connection}) ->
-    amqp_channel:close(Channel),
-    amqp_connection:close(Connection).
-
-%% This is the callback function that is called by ecpool when the pool is
-%% started
+    lists:foreach(
+        fun({_Name, Worker}) ->
+            case ecpool_worker:client(Worker) of
+                {ok, Conn} -> amqp_connection:close(Conn);
+                _ -> ok
+            end
+        end,
+        ecpool:workers(ResourceID)
+    ),
+    emqx_resource_pool:stop(ResourceID).
 
+%% This is the callback function that is called by ecpool
 -spec connect(term()) -> {ok, {pid(), pid()}, map()} | {error, term()}.
 connect(Options) ->
     Config = proplists:get_value(config, Options),
-    try
-        create_rabbitmq_connection_and_channel(Config)
-    catch
-        _:{error, Reason} ->
-            ?SLOG(error, #{
-                msg => "rabbitmq_connector_connection_failed",
-                error_type => error,
-                error_reason => Reason,
-                config => emqx_utils:redact(Config)
-            }),
-            {error, Reason};
-        Type:Reason ->
-            ?SLOG(error, #{
-                msg => "rabbitmq_connector_connection_failed",
-                error_type => Type,
-                error_reason => Reason,
-                config => emqx_utils:redact(Config)
-            }),
-            {error, Reason}
-    end.
-
-create_rabbitmq_connection_and_channel(Config) ->
     #{
         server := Host,
         port := Port,
@@ -314,237 +146,164 @@ create_rabbitmq_connection_and_channel(Config) ->
         password := WrappedPassword,
         timeout := Timeout,
         virtual_host := VirtualHost,
-        heartbeat := Heartbeat,
-        wait_for_publish_confirmations := WaitForPublishConfirmations
+        heartbeat := Heartbeat
     } = Config,
     %% TODO: teach `amqp` to accept 0-arity closures as passwords.
     Password = emqx_secret:unwrap(WrappedPassword),
-    SSLOptions =
-        case maps:get(ssl, Config, #{}) of
-            #{enable := true} = SSLOpts ->
-                emqx_tls_lib:to_client_opts(SSLOpts);
-            _ ->
-                none
-        end,
-    RabbitMQConnectionOptions =
+    RabbitMQConnOptions =
         #amqp_params_network{
-            host = erlang:binary_to_list(Host),
+            host = Host,
             port = Port,
-            ssl_options = SSLOptions,
+            ssl_options = to_ssl_options(Config),
             username = Username,
             password = Password,
             connection_timeout = Timeout,
             virtual_host = VirtualHost,
             heartbeat = Heartbeat
         },
-    {ok, RabbitMQConnection} =
-        case amqp_connection:start(RabbitMQConnectionOptions) of
-            {ok, Connection} ->
-                {ok, Connection};
-            {error, Reason} ->
-                erlang:error({error, Reason})
-        end,
-    {ok, RabbitMQChannel} =
-        case amqp_connection:open_channel(RabbitMQConnection) of
-            {ok, Channel} ->
-                {ok, Channel};
-            {error, OpenChannelErrorReason} ->
-                erlang:error({error, OpenChannelErrorReason})
-        end,
-    %% We need to enable confirmations if we want to wait for them
-    case WaitForPublishConfirmations of
-        true ->
-            case amqp_channel:call(RabbitMQChannel, #'confirm.select'{}) of
-                #'confirm.select_ok'{} ->
-                    ok;
-                Error ->
-                    ConfirmModeErrorReason =
-                        erlang:iolist_to_binary(
-                            io_lib:format(
-                                "Could not enable RabbitMQ confirmation mode ~p",
-                                [Error]
-                            )
-                        ),
-                    erlang:error({error, ConfirmModeErrorReason})
-            end;
-        false ->
-            ok
-    end,
-    {ok, {RabbitMQConnection, RabbitMQChannel}, #{
-        supervisees => [RabbitMQConnection, RabbitMQChannel]
-    }}.
-
-%% emqx_resource callback called to check the status of the resource
+    case amqp_connection:start(RabbitMQConnOptions) of
+        {ok, RabbitMQConn} ->
+            {ok, RabbitMQConn};
+        {error, Reason} ->
+            ?SLOG(error, #{
+                msg => "rabbitmq_connector_connection_failed",
+                reason => Reason,
+                config => emqx_utils:redact(Config)
+            }),
+            {error, Reason}
+    end.
 
 -spec on_get_status(resource_id(), term()) ->
     {connected, resource_state()} | {disconnected, resource_state(), binary()}.
-on_get_status(
-    _InstId,
-    #{
-        poolname := PoolName
-    } = State
-) ->
-    Workers = [Worker || {_WorkerName, Worker} <- ecpool:workers(PoolName)],
-    Clients = [
-        begin
-            {ok, Client} = ecpool_worker:client(Worker),
-            Client
-        end
-     || Worker <- Workers
-    ],
-    CheckResults = [
-        check_worker(Client)
-     || Client <- Clients
-    ],
-    Connected = length(CheckResults) > 0 andalso lists:all(fun(R) -> R end, CheckResults),
-    case Connected of
-        true ->
-            {connected, State};
-        false ->
-            {disconnected, State, <<"not_connected">>}
-    end;
-on_get_status(
-    _InstId,
-    State
-) ->
-    {disconnect, State, <<"not_connected: no connection pool in state">>}.
+on_get_status(PoolName, #{channels := Channels} = State) ->
+    ChannelNum = maps:size(Channels),
+    Conns = get_rabbitmq_connections(PoolName),
+    Check =
+        lists:all(
+            fun(Conn) ->
+                [{num_channels, ActualNum}] = amqp_connection:info(Conn, [num_channels]),
+                ChannelNum >= ActualNum
+            end,
+            Conns
+        ),
+    case Check andalso Conns =/= [] of
+        true -> {connected, State};
+        false -> {disconnected, State, <<"not_connected">>}
+    end.
 
-check_worker({Channel, Connection}) ->
-    erlang:is_process_alive(Channel) andalso erlang:is_process_alive(Connection).
+on_get_channel_status(_InstanceId, ChannelId, #{channels := Channels}) ->
+    case emqx_utils_maps:deep_find([ChannelId, rabbitmq], Channels) of
+        {ok, RabbitMQ} ->
+            case lists:all(fun is_process_alive/1, maps:values(RabbitMQ)) of
+                true -> connected;
+                false -> {error, not_connected}
+            end;
+        _ ->
+            {error, not_exists}
+    end.
 
-%% emqx_resource callback that is called when a non-batch query is received
-
--spec on_query(resource_id(), Request, resource_state()) -> query_result() when
-    Request :: {RequestType, Data},
-    RequestType :: send_message,
-    Data :: map().
-on_query(
-    ResourceID,
-    {RequestType, Data},
-    #{
-        poolname := PoolName,
-        processed_payload_template := PayloadTemplate,
-        config := Config
-    } = State
-) ->
+on_query(ResourceID, {ChannelId, Data} = MsgReq, State) ->
     ?SLOG(debug, #{
         msg => "rabbitmq_connector_received_query",
         connector => ResourceID,
-        type => RequestType,
+        channel => ChannelId,
         data => Data,
         state => emqx_utils:redact(State)
     }),
-    MessageData = format_data(PayloadTemplate, Data),
-    Res = ecpool:pick_and_do(
-        PoolName,
-        {?MODULE, publish_messages, [Config, [MessageData]]},
-        no_handover
-    ),
-    handle_result(Res).
+    #{channels := Channels} = State,
+    case maps:find(ChannelId, Channels) of
+        {ok, #{param := ProcParam, rabbitmq := RabbitMQ}} ->
+            Res = ecpool:pick_and_do(
+                ResourceID,
+                {?MODULE, publish_messages, [RabbitMQ, ProcParam, [MsgReq]]},
+                no_handover
+            ),
+            handle_result(Res);
+        error ->
+            {error, {unrecoverable_error, {invalid_message_tag, ChannelId}}}
+    end.
 
-%% emqx_resource callback that is called when a batch query is received
-
--spec on_batch_query(resource_id(), BatchReq, resource_state()) -> query_result() when
-    BatchReq :: nonempty_list({'send_message', map()}).
-on_batch_query(
-    ResourceID,
-    BatchReq,
-    State
-) ->
+on_batch_query(ResourceID, [{ChannelId, _Data} | _] = Batch, State) ->
     ?SLOG(debug, #{
         msg => "rabbitmq_connector_received_batch_query",
         connector => ResourceID,
-        data => BatchReq,
+        data => Batch,
         state => emqx_utils:redact(State)
     }),
-    %% Currently we only support batch requests with the send_message key
-    {Keys, MessagesToInsert} = lists:unzip(BatchReq),
-    ensure_keys_are_of_type_send_message(Keys),
-    %% Pick out the payload template
-    #{
-        processed_payload_template := PayloadTemplate,
-        poolname := PoolName,
-        config := Config
-    } = State,
-    %% Create batch payload
-    FormattedMessages = [
-        format_data(PayloadTemplate, Data)
-     || Data <- MessagesToInsert
-    ],
-    %% Publish the messages
-    Res = ecpool:pick_and_do(
-        PoolName,
-        {?MODULE, publish_messages, [Config, FormattedMessages]},
-        no_handover
-    ),
-    handle_result(Res).
+    #{channels := Channels} = State,
+    case maps:find(ChannelId, Channels) of
+        {ok, #{param := ProcParam, rabbitmq := RabbitMQ}} ->
+            Res = ecpool:pick_and_do(
+                ResourceID,
+                {?MODULE, publish_messages, [RabbitMQ, ProcParam, Batch]},
+                no_handover
+            ),
+            handle_result(Res);
+        error ->
+            {error, {unrecoverable_error, {invalid_message_tag, ChannelId}}}
+    end.
 
 publish_messages(
-    {_Connection, Channel},
+    Conn,
+    RabbitMQ,
     #{
         delivery_mode := DeliveryMode,
+        payload_template := PayloadTmpl,
         routing_key := RoutingKey,
         exchange := Exchange,
         wait_for_publish_confirmations := WaitForPublishConfirmations,
         publish_confirmation_timeout := PublishConfirmationTimeout
-    } = _Config,
+    },
     Messages
 ) ->
-    MessageProperties = #'P_basic'{
-        headers = [],
-        delivery_mode = DeliveryMode
-    },
-    Method = #'basic.publish'{
-        exchange = Exchange,
-        routing_key = RoutingKey
-    },
-    _ = [
-        amqp_channel:cast(
-            Channel,
-            Method,
-            #amqp_msg{
-                payload = Message,
-                props = MessageProperties
-            }
-        )
-     || Message <- Messages
-    ],
-    case WaitForPublishConfirmations of
-        true ->
-            case amqp_channel:wait_for_confirms(Channel, PublishConfirmationTimeout) of
-                true ->
-                    ok;
-                false ->
-                    erlang:error(
-                        {recoverable_error,
-                            <<"RabbitMQ: Got NACK when waiting for message acknowledgment.">>}
-                    );
-                timeout ->
-                    erlang:error(
-                        {recoverable_error,
-                            <<"RabbitMQ: Timeout when waiting for message acknowledgment.">>}
+    case maps:find(Conn, RabbitMQ) of
+        {ok, Channel} ->
+            MessageProperties = #'P_basic'{
+                headers = [],
+                delivery_mode = DeliveryMode
+            },
+            Method = #'basic.publish'{
+                exchange = Exchange,
+                routing_key = RoutingKey
+            },
+            lists:foreach(
+                fun({_, MsgRaw}) ->
+                    amqp_channel:cast(
+                        Channel,
+                        Method,
+                        #amqp_msg{
+                            payload = format_data(PayloadTmpl, MsgRaw),
+                            props = MessageProperties
+                        }
                     )
+                end,
+                Messages
+            ),
+            case WaitForPublishConfirmations of
+                true ->
+                    case amqp_channel:wait_for_confirms(Channel, PublishConfirmationTimeout) of
+                        true ->
+                            ok;
+                        false ->
+                            erlang:error(
+                                {recoverable_error,
+                                    <<"RabbitMQ: Got NACK when waiting for message acknowledgment.">>}
+                            );
+                        timeout ->
+                            erlang:error(
+                                {recoverable_error,
+                                    <<"RabbitMQ: Timeout when waiting for message acknowledgment.">>}
+                            )
+                    end;
+                false ->
+                    ok
             end;
-        false ->
-            ok
-    end.
-
-ensure_keys_are_of_type_send_message(Keys) ->
-    case lists:all(fun is_send_message_atom/1, Keys) of
-        true ->
-            ok;
-        false ->
+        error ->
             erlang:error(
-                {unrecoverable_error,
-                    <<"Unexpected type for batch message (Expected send_message)">>}
+                {recoverable_error, {<<"RabbitMQ: channel_not_found">>, Conn, RabbitMQ}}
             )
     end.
 
-is_send_message_atom(send_message) ->
-    true;
-is_send_message_atom(_) ->
-    false.
-
 format_data([], Msg) ->
     emqx_utils_json:encode(Msg);
 format_data(Tokens, Msg) ->
@@ -554,3 +313,119 @@ handle_result({error, ecpool_empty}) ->
     {error, {recoverable_error, ecpool_empty}};
 handle_result(Res) ->
     Res.
+
+make_channel(PoolName, ChannelId, Params) ->
+    Conns = get_rabbitmq_connections(PoolName),
+    make_channel(Conns, PoolName, ChannelId, Params, #{}).
+
+make_channel([], _PoolName, _ChannelId, _Param, Acc) ->
+    {ok, Acc};
+make_channel([Conn | Conns], PoolName, ChannelId, Params, Acc) ->
+    maybe
+        {ok, RabbitMQChannel} ?= amqp_connection:open_channel(Conn),
+        ok ?= try_confirm_channel(Params, RabbitMQChannel),
+        ok ?= try_subscribe(Params, RabbitMQChannel, PoolName, ChannelId),
+        NewAcc = Acc#{Conn => RabbitMQChannel},
+        make_channel(Conns, PoolName, ChannelId, Params, NewAcc)
+    end.
+
+%% We need to enable confirmations if we want to wait for them
+try_confirm_channel(#{wait_for_publish_confirmations := true}, Channel) ->
+    case amqp_channel:call(Channel, #'confirm.select'{}) of
+        #'confirm.select_ok'{} ->
+            ok;
+        Error ->
+            Reason =
+                iolist_to_binary(
+                    io_lib:format(
+                        "Could not enable RabbitMQ confirmation mode ~p",
+                        [Error]
+                    )
+                ),
+            {error, Reason}
+    end;
+try_confirm_channel(#{wait_for_publish_confirmations := false}, _Channel) ->
+    ok.
+
+%% Initialize Rabbitmq's secret library so that the password is encrypted
+%% in the log files.
+init_secret() ->
+    case credentials_obfuscation:secret() of
+        ?PENDING_SECRET ->
+            Bytes = crypto:strong_rand_bytes(128),
+            %% The password can appear in log files if we don't do this
+            credentials_obfuscation:set_secret(Bytes);
+        _ ->
+            %% Already initialized
+            ok
+    end.
+
+preproc_parameter(#{config_root := actions, parameters := Parameter}) ->
+    #{
+        payload_template := PayloadTemplate,
+        delivery_mode := InitialDeliveryMode
+    } = Parameter,
+    Parameter#{
+        delivery_mode => delivery_mode(InitialDeliveryMode),
+        payload_template => emqx_placeholder:preproc_tmpl(PayloadTemplate),
+        config_root => actions
+    };
+preproc_parameter(#{config_root := sources, parameters := Parameter, hookpoints := Hooks}) ->
+    #{
+        payload_template := PayloadTmpl,
+        qos := QosTmpl,
+        topic := TopicTmpl
+    } = Parameter,
+    Parameter#{
+        payload_template => emqx_placeholder:preproc_tmpl(PayloadTmpl),
+        qos => preproc_qos(QosTmpl),
+        topic => emqx_placeholder:preproc_tmpl(TopicTmpl),
+        hookpoints => Hooks,
+        config_root => sources
+    }.
+
+preproc_qos(Qos) when is_integer(Qos) -> Qos;
+preproc_qos(Qos) -> emqx_placeholder:preproc_tmpl(Qos).
+
+delivery_mode(non_persistent) -> 1;
+delivery_mode(persistent) -> 2.
+
+to_ssl_options(#{ssl := #{enable := true} = SSLOpts}) ->
+    emqx_tls_lib:to_client_opts(SSLOpts);
+to_ssl_options(_) ->
+    none.
+
+get_rabbitmq_connections(PoolName) ->
+    lists:filtermap(
+        fun({_Name, Worker}) ->
+            case ecpool_worker:client(Worker) of
+                {ok, Conn} -> {true, Conn};
+                _ -> false
+            end
+        end,
+        ecpool:workers(PoolName)
+    ).
+
+try_subscribe(
+    #{queue := Queue, no_ack := NoAck, config_root := sources} = Params,
+    RabbitChan,
+    PoolName,
+    ChannelId
+) ->
+    WorkState = {RabbitChan, PoolName, Params},
+    {ok, ConsumePid} = emqx_bridge_rabbitmq_sup:ensure_started(ChannelId, WorkState),
+    BasicConsume = #'basic.consume'{queue = Queue, no_ack = NoAck},
+    #'basic.consume_ok'{consumer_tag = _} =
+        amqp_channel:subscribe(RabbitChan, BasicConsume, ConsumePid),
+    ok;
+try_subscribe(#{config_root := actions}, _RabbitChan, _PoolName, _ChannelId) ->
+    ok.
+
+try_unsubscribe(ChannelId, Channels) ->
+    case emqx_utils_maps:deep_find([ChannelId, rabbitmq], Channels) of
+        {ok, RabbitMQ} ->
+            lists:foreach(fun(Pid) -> catch amqp_channel:close(Pid) end, maps:values(RabbitMQ)),
+            emqx_bridge_rabbitmq_sup:ensure_deleted(ChannelId);
+        _ ->
+            ok
+    end.
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
new file mode 100644
index 000000000..d36eb463c
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
@@ -0,0 +1,139 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rabbitmq_connector_schema).
+
+-include_lib("typerefl/include/types.hrl").
+-include_lib("hocon/include/hoconsc.hrl").
+
+-define(TYPE, rabbitmq).
+
+-export([roots/0, fields/1, desc/1, namespace/0]).
+-export([connector_examples/1, connector_example_values/0]).
+
+%%======================================================================================
+%% Hocon Schema Definitions
+namespace() -> ?TYPE.
+
+roots() -> [].
+
+fields("config_connector") ->
+    emqx_bridge_schema:common_bridge_fields() ++
+        fields(connector) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector) ->
+    [
+        {server,
+            ?HOCON(
+                string(),
+                #{
+                    default => <<"localhost">>,
+                    desc => ?DESC("server")
+                }
+            )},
+        {port,
+            ?HOCON(
+                emqx_schema:port_number(),
+                #{
+                    default => 5672,
+                    desc => ?DESC("server")
+                }
+            )},
+        {username,
+            ?HOCON(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("username")
+                }
+            )},
+        {password, emqx_connector_schema_lib:password_field(#{required => true})},
+        {pool_size,
+            ?HOCON(
+                pos_integer(),
+                #{
+                    default => 8,
+                    desc => ?DESC("pool_size")
+                }
+            )},
+        {timeout,
+            ?HOCON(
+                emqx_schema:timeout_duration_ms(),
+                #{
+                    default => <<"5s">>,
+                    desc => ?DESC("timeout")
+                }
+            )},
+        {virtual_host,
+            ?HOCON(
+                binary(),
+                #{
+                    default => <<"/">>,
+                    desc => ?DESC("virtual_host")
+                }
+            )},
+        {heartbeat,
+            ?HOCON(
+                emqx_schema:timeout_duration_ms(),
+                #{
+                    default => <<"30s">>,
+                    desc => ?DESC("heartbeat")
+                }
+            )}
+    ] ++
+        emqx_connector_schema_lib:ssl_fields();
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields("post") ->
+    emqx_connector_schema:type_and_name_fields(?TYPE) ++ fields("config_connector");
+fields("put") ->
+    fields("config_connector");
+fields("get") ->
+    emqx_bridge_schema:status_fields() ++ fields("config_connector").
+
+desc("config_connector") ->
+    ?DESC("config_connector");
+desc(_) ->
+    undefined.
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"rabbitmq">> =>
+                #{
+                    summary => <<"Rabbitmq Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?TYPE, connector_example_values()
+                    )
+                }
+        }
+    ].
+
+connector_example_values() ->
+    #{
+        name => <<"rabbitmq_connector">>,
+        type => rabbitmq,
+        enable => true,
+        server => <<"127.0.0.1">>,
+        port => 5672,
+        username => <<"guest">>,
+        password => <<"******">>,
+        pool_size => 8,
+        timeout => <<"5s">>,
+        virtual_host => <<"/">>,
+        heartbeat => <<"30s">>,
+        ssl => #{enable => false}
+    }.
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
new file mode 100644
index 000000000..b4bb72c22
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
@@ -0,0 +1,273 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_rabbitmq_pubsub_schema).
+
+-include_lib("typerefl/include/types.hrl").
+-include_lib("hocon/include/hoconsc.hrl").
+
+-export([roots/0, fields/1, desc/1, namespace/0]).
+
+-export([
+    bridge_v2_examples/1,
+    source_examples/1
+]).
+
+-define(ACTION_TYPE, rabbitmq).
+-define(SOURCE_TYPE, rabbitmq).
+
+%%======================================================================================
+%% Hocon Schema Definitions
+namespace() -> "bridge_rabbitmq".
+
+roots() -> [].
+
+fields(action) ->
+    {rabbitmq,
+        ?HOCON(
+            ?MAP(name, ?R_REF(publisher_action)),
+            #{
+                desc => <<"RabbitMQ Action Config">>,
+                required => false
+            }
+        )};
+fields(publisher_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        ?HOCON(
+            ?R_REF(action_parameters),
+            #{
+                required => true,
+                desc => ?DESC(action_parameters)
+            }
+        ),
+        #{resource_opts_ref => ?R_REF(action_resource_opts)}
+    );
+fields(action_parameters) ->
+    [
+        {wait_for_publish_confirmations,
+            hoconsc:mk(
+                boolean(),
+                #{
+                    default => true,
+                    desc => ?DESC("wait_for_publish_confirmations")
+                }
+            )},
+        {publish_confirmation_timeout,
+            hoconsc:mk(
+                emqx_schema:timeout_duration_ms(),
+                #{
+                    default => <<"30s">>,
+                    desc => ?DESC("timeout")
+                }
+            )},
+        {exchange,
+            hoconsc:mk(
+                typerefl:binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("exchange")
+                }
+            )},
+        {routing_key,
+            hoconsc:mk(
+                typerefl:binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("routing_key")
+                }
+            )},
+        {delivery_mode,
+            hoconsc:mk(
+                hoconsc:enum([non_persistent, persistent]),
+                #{
+                    default => non_persistent,
+                    desc => ?DESC("delivery_mode")
+                }
+            )},
+        {payload_template,
+            hoconsc:mk(
+                binary(),
+                #{
+                    default => <<"${.}">>,
+                    desc => ?DESC("payload_template")
+                }
+            )}
+    ];
+fields(source) ->
+    {rabbitmq,
+        ?HOCON(
+            hoconsc:map(name, ?R_REF(subscriber_source)),
+            #{
+                desc => <<"MQTT Subscriber Source Config">>,
+                required => false
+            }
+        )};
+fields(subscriber_source) ->
+    emqx_bridge_v2_schema:make_consumer_action_schema(
+        ?HOCON(
+            ?R_REF(ingress_parameters),
+            #{
+                required => true,
+                desc => ?DESC("source_parameters")
+            }
+        )
+    );
+fields(ingress_parameters) ->
+    [
+        {wait_for_publish_confirmations,
+            hoconsc:mk(
+                boolean(),
+                #{
+                    default => true,
+                    desc => ?DESC("wait_for_publish_confirmations")
+                }
+            )},
+        {topic,
+            ?HOCON(
+                binary(),
+                #{
+                    required => true,
+                    validator => fun emqx_schema:non_empty_string/1,
+                    desc => ?DESC("ingress_topic")
+                }
+            )},
+        {qos,
+            ?HOCON(
+                ?UNION([emqx_schema:qos(), binary()]),
+                #{
+                    default => 0,
+                    desc => ?DESC("ingress_qos")
+                }
+            )},
+        {payload_template,
+            ?HOCON(
+                binary(),
+                #{
+                    required => false,
+                    desc => ?DESC("ingress_payload_template")
+                }
+            )},
+        {queue,
+            ?HOCON(
+                binary(),
+                #{
+                    required => true,
+                    desc => ?DESC("ingress_queue")
+                }
+            )},
+        {no_ack,
+            ?HOCON(
+                boolean(),
+                #{
+                    required => false,
+                    default => true,
+                    desc => ?DESC("ingress_no_ack")
+                }
+            )}
+    ];
+fields(action_resource_opts) ->
+    emqx_bridge_v2_schema:action_resource_opts_fields();
+fields(source_resource_opts) ->
+    emqx_bridge_v2_schema:source_resource_opts_fields();
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(publisher_action));
+fields(Field) when
+    Field == "get_source";
+    Field == "post_source";
+    Field == "put_source"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?SOURCE_TYPE, fields(subscriber_source));
+fields(What) ->
+    error({emqx_bridge_mqtt_pubsub_schema, missing_field_handler, What}).
+%% v2: api schema
+%% The parameter equals to
+%%   `get_bridge_v2`, `post_bridge_v2`, `put_bridge_v2` from emqx_bridge_v2_schema:api_schema/1
+%%   `get_connector`, `post_connector`, `put_connector` from emqx_connector_schema:api_schema/1
+%%--------------------------------------------------------------------
+%% v1/v2
+
+desc("config") ->
+    ?DESC("desc_config");
+desc(action_resource_opts) ->
+    ?DESC(emqx_resource_schema, "creation_opts");
+desc(source_resource_opts) ->
+    ?DESC(emqx_resource_schema, "creation_opts");
+desc(action_parameters) ->
+    ?DESC(action_parameters);
+desc(ingress_parameters) ->
+    ?DESC(ingress_parameters);
+desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
+    ["Configuration for WebHook using `", string:to_upper(Method), "` method."];
+desc("http_action") ->
+    ?DESC("desc_config");
+desc("parameters_opts") ->
+    ?DESC("config_parameters_opts");
+desc(publisher_action) ->
+    ?DESC(publisher_action);
+desc(subscriber_source) ->
+    ?DESC(subscriber_source);
+desc(_) ->
+    undefined.
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"rabbitmq">> => #{
+                summary => <<"RabbitMQ Producer Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method,
+                    _ActionType = ?ACTION_TYPE,
+                    _ConnectorType = rabbitmq,
+                    #{
+                        parameters => #{
+                            wait_for_publish_confirmations => true,
+                            publish_confirmation_timeout => <<"30s">>,
+                            exchange => <<"test_exchange">>,
+                            routing_key => <<"/">>,
+                            delivery_mode => <<"non_persistent">>,
+                            payload_template => <<"${.payload}">>
+                        }
+                    }
+                )
+            }
+        }
+    ].
+
+source_examples(Method) ->
+    [
+        #{
+            <<"rabbitmq">> => #{
+                summary => <<"RabbitMQ Subscriber Source">>,
+                value => emqx_bridge_v2_schema:source_values(
+                    Method,
+                    _SourceType = ?SOURCE_TYPE,
+                    _ConnectorType = rabbitmq,
+                    #{
+                        parameters => #{
+                            topic => <<"${payload.mqtt_topic}">>,
+                            qos => <<"${payload.mqtt_qos}">>,
+                            payload_template => <<"${payload.mqtt_payload}">>,
+                            queue => <<"test_queue">>,
+                            no_ack => true
+                        }
+                    }
+                )
+            }
+        }
+    ].
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
new file mode 100644
index 000000000..6497929f5
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
@@ -0,0 +1,28 @@
+-module(emqx_bridge_rabbitmq_source_sup).
+
+-behaviour(supervisor).
+%% API
+-export([start_link/0]).
+-export([init/1]).
+
+start_link() ->
+    supervisor:start_link(?MODULE, []).
+
+init([]) ->
+    SupFlags = #{
+        strategy => simple_one_for_one,
+        intensity => 100,
+        period => 10
+    },
+    {ok, {SupFlags, [worker_spec()]}}.
+
+worker_spec() ->
+    Mod = emqx_bridge_rabbitmq_source_worker,
+    #{
+        id => Mod,
+        start => {Mod, start_link, []},
+        restart => transient,
+        shutdown => brutal_kill,
+        type => worker,
+        modules => [Mod]
+    }.
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
new file mode 100644
index 000000000..b296887eb
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
@@ -0,0 +1,82 @@
+-module(emqx_bridge_rabbitmq_source_worker).
+
+-behaviour(gen_server).
+
+-export([start_link/1]).
+-export([
+    init/1,
+    handle_continue/2,
+    handle_call/3,
+    handle_cast/2,
+    handle_info/2,
+    terminate/2
+]).
+
+-include_lib("amqp_client/include/amqp_client.hrl").
+
+start_link(Args) ->
+    gen_server:start_link(?MODULE, Args, []).
+
+init({_RabbitChannel, _InstanceId, _Params} = State) ->
+    {ok, State, {continue, confirm_ok}}.
+
+handle_continue(confirm_ok, State) ->
+    receive
+        #'basic.consume_ok'{} -> {noreply, State}
+    end.
+
+handle_call(_Request, _From, State) ->
+    {reply, ok, State}.
+
+handle_cast(_Request, State) ->
+    {noreply, State}.
+
+handle_info(
+    {#'basic.deliver'{delivery_tag = Tag}, #amqp_msg{
+        payload = Payload,
+        props = #'P_basic'{message_id = MessageId, headers = Headers}
+    }},
+    {Channel, InstanceId, Params} = State
+) ->
+    #{
+        hookpoints := Hooks,
+        payload_template := PayloadTmpl,
+        qos := QoSTmpl,
+        topic := TopicTmpl,
+        no_ack := NoAck
+    } = Params,
+    MQTTMsg = emqx_message:make(
+        make_message_id(MessageId),
+        InstanceId,
+        render(Payload, QoSTmpl),
+        render(Payload, TopicTmpl),
+        render(Payload, PayloadTmpl),
+        #{},
+        make_headers(Headers)
+    ),
+    _ = emqx:publish(MQTTMsg),
+    lists:foreach(fun(Hook) -> emqx_hooks:run(Hook, [MQTTMsg]) end, Hooks),
+    (NoAck =:= false) andalso
+        amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = Tag}),
+    emqx_resource_metrics:received_inc(InstanceId),
+    {noreply, State};
+handle_info(#'basic.cancel_ok'{}, State) ->
+    {stop, normal, State};
+handle_info(_Info, State) ->
+    {noreply, State}.
+
+terminate(_Reason, _State) ->
+    ok.
+
+render(_Message, QoS) when is_integer(QoS) -> QoS;
+render(Message, PayloadTmpl) ->
+    Opts = #{return => full_binary},
+    emqx_placeholder:proc_tmpl(PayloadTmpl, Message, Opts).
+
+make_message_id(undefined) -> emqx_guid:gen();
+make_message_id(Id) -> Id.
+
+make_headers(undefined) ->
+    #{};
+make_headers(Headers) when is_list(Headers) ->
+    maps:from_list([{Key, Value} || {Key, _Type, Value} <- Headers]).
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl
new file mode 100644
index 000000000..8cc442ada
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl
@@ -0,0 +1,75 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+-module(emqx_bridge_rabbitmq_sup).
+
+-behaviour(supervisor).
+
+-export([ensure_started/2]).
+-export([ensure_deleted/1]).
+-export([start_link/0]).
+-export([init/1]).
+
+-define(BRIDGE_SUP, ?MODULE).
+
+ensure_started(SuperId, Config) ->
+    {ok, SuperPid} = ensure_supervisor_started(SuperId),
+    case supervisor:start_child(SuperPid, [Config]) of
+        {ok, WorkPid} ->
+            {ok, WorkPid};
+        {error, {already_started, WorkPid}} ->
+            {ok, WorkPid};
+        {error, Error} ->
+            {error, Error}
+    end.
+
+ensure_deleted(SuperId) ->
+    maybe
+        Pid = erlang:whereis(?BRIDGE_SUP),
+        true ?= Pid =/= undefined,
+        ok ?= supervisor:terminate_child(Pid, SuperId),
+        ok ?= supervisor:delete_child(Pid, SuperId)
+    else
+        false -> ok;
+        {error, not_found} -> ok;
+        Error -> Error
+    end.
+
+ensure_supervisor_started(Id) ->
+    SupervisorSpec =
+        #{
+            id => Id,
+            start => {emqx_bridge_rabbitmq_source_sup, start_link, []},
+            restart => permanent,
+            type => supervisor
+        },
+    case supervisor:start_child(?BRIDGE_SUP, SupervisorSpec) of
+        {ok, Pid} ->
+            {ok, Pid};
+        {error, {already_started, Pid}} ->
+            {ok, Pid}
+    end.
+
+start_link() ->
+    supervisor:start_link({local, ?BRIDGE_SUP}, ?MODULE, []).
+
+init([]) ->
+    SupFlags = #{
+        strategy => one_for_one,
+        intensity => 50,
+        period => 10
+    },
+    ChildSpecs = [],
+    {ok, {SupFlags, ChildSpecs}}.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
index 0ae7af9fc..7698608d3 100644
--- a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
@@ -14,7 +14,8 @@
 
 %% See comment in
 %% apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl for how to
-%% run this without bringing up the whole CI infrastucture
+%% run this without bringing up the whole CI infrastructure
+-define(TYPE, <<"rabbitmq">>).
 
 rabbit_mq_host() ->
     <<"rabbitmq">>.
@@ -34,8 +35,14 @@ rabbit_mq_routing_key() ->
 get_channel_connection(Config) ->
     proplists:get_value(channel_connection, Config).
 
+get_rabbitmq(Config) ->
+    proplists:get_value(rabbitmq, Config).
+
+get_tls(Config) ->
+    proplists:get_value(tls, Config).
+
 %%------------------------------------------------------------------------------
-%% Common Test Setup, Teardown and Testcase List
+%% Common Test Setup, Tear down and Testcase List
 %%------------------------------------------------------------------------------
 
 all() ->
@@ -101,35 +108,25 @@ common_init_per_group(Opts) ->
     {ok, _} = application:ensure_all_started(emqx_connector),
     {ok, _} = application:ensure_all_started(amqp_client),
     emqx_mgmt_api_test_util:init_suite(),
-    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Opts),
-    [{channel_connection, ChannelConnection}].
+    #{host := Host, port := Port, tls := UseTLS} = Opts,
+    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS),
+    [
+        {channel_connection, ChannelConnection},
+        {rabbitmq, #{server => Host, port => Port}},
+        {tls, UseTLS}
+    ].
 
-setup_rabbit_mq_exchange_and_queue(#{host := RabbitMQHost, port := RabbitMQPort, tls := UseTLS}) ->
+setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS) ->
     SSLOptions =
         case UseTLS of
-            false ->
-                none;
-            true ->
-                CertsDir = filename:join([
-                    emqx_common_test_helpers:proj_root(),
-                    ".ci",
-                    "docker-compose-file",
-                    "certs"
-                ]),
-                emqx_tls_lib:to_client_opts(
-                    #{
-                        enable => true,
-                        cacertfile => filename:join([CertsDir, "ca.crt"]),
-                        certfile => filename:join([CertsDir, "client.pem"]),
-                        keyfile => filename:join([CertsDir, "client.key"])
-                    }
-                )
+            false -> none;
+            true -> emqx_tls_lib:to_client_opts(ssl_options(UseTLS))
         end,
-    %% Create an exachange and a queue
+    %% Create an exchange and a queue
     {ok, Connection} =
         amqp_connection:start(#amqp_params_network{
-            host = RabbitMQHost,
-            port = RabbitMQPort,
+            host = Host,
+            port = Port,
             ssl_options = SSLOptions
         }),
     {ok, Channel} = amqp_connection:open_channel(Connection),
@@ -184,8 +181,7 @@ init_per_testcase(_, Config) ->
 end_per_testcase(_, _Config) ->
     ok.
 
-rabbitmq_config(Config) ->
-    %%SQL = maps:get(sql, Config, sql_insert_template_for_bridge()),
+rabbitmq_config(UseTLS, Config) ->
     BatchSize = maps:get(batch_size, Config, 1),
     BatchTime = maps:get(batch_time_ms, Config, 0),
     Name = atom_to_binary(?MODULE),
@@ -196,6 +192,7 @@ rabbitmq_config(Config) ->
         io_lib:format(
             "bridges.rabbitmq.~s {\n"
             "  enable = true\n"
+            "  ssl = ~s\n"
             "  server = \"~s\"\n"
             "  port = ~p\n"
             "  username = \"guest\"\n"
@@ -210,6 +207,7 @@ rabbitmq_config(Config) ->
             "}\n",
             [
                 Name,
+                hocon_pp:do(ssl_options(UseTLS), #{embedded => true}),
                 Server,
                 Port,
                 rabbit_mq_routing_key(),
@@ -222,80 +220,86 @@ rabbitmq_config(Config) ->
     ct:pal(ConfigString),
     parse_and_check(ConfigString, <<"rabbitmq">>, Name).
 
+ssl_options(true) ->
+    CertsDir = filename:join([
+        emqx_common_test_helpers:proj_root(),
+        ".ci",
+        "docker-compose-file",
+        "certs"
+    ]),
+    #{
+        enable => true,
+        cacertfile => filename:join([CertsDir, "ca.crt"]),
+        certfile => filename:join([CertsDir, "client.pem"]),
+        keyfile => filename:join([CertsDir, "client.key"])
+    };
+ssl_options(false) ->
+    #{
+        enable => false
+    }.
+
 parse_and_check(ConfigString, BridgeType, Name) ->
     {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
     hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
     #{<<"bridges">> := #{BridgeType := #{Name := RetConfig}}} = RawConf,
     RetConfig.
 
-make_bridge(Config) ->
-    Type = <<"rabbitmq">>,
-    Name = atom_to_binary(?MODULE),
-    BridgeConfig = rabbitmq_config(Config),
-    {ok, _} = emqx_bridge:create(
-        Type,
-        Name,
-        BridgeConfig
-    ),
-    emqx_bridge_resource:bridge_id(Type, Name).
+create_bridge(Name, UseTLS, Config) ->
+    BridgeConfig = rabbitmq_config(UseTLS, Config),
+    {ok, _} = emqx_bridge:create(?TYPE, Name, BridgeConfig),
+    emqx_bridge_resource:bridge_id(?TYPE, Name).
 
-delete_bridge() ->
-    Type = <<"rabbitmq">>,
-    Name = atom_to_binary(?MODULE),
-    ok = emqx_bridge:remove(Type, Name).
+delete_bridge(Name) ->
+    ok = emqx_bridge:remove(?TYPE, Name).
 
 %%------------------------------------------------------------------------------
 %% Test Cases
 %%------------------------------------------------------------------------------
 
-t_make_delete_bridge(_Config) ->
-    make_bridge(#{}),
-    %% Check that the new brige is in the list of bridges
+t_create_delete_bridge(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    UseTLS = get_tls(Config),
+    create_bridge(Name, UseTLS, RabbitMQ),
     Bridges = emqx_bridge:list(),
-    Name = atom_to_binary(?MODULE),
-    IsRightName =
-        fun
-            (#{name := BName}) when BName =:= Name ->
-                true;
-            (_) ->
-                false
-        end,
-    ?assert(lists:any(IsRightName, Bridges)),
-    delete_bridge(),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Bridges), Bridges),
+    ok = delete_bridge(Name),
     BridgesAfterDelete = emqx_bridge:list(),
-    ?assertNot(lists:any(IsRightName, BridgesAfterDelete)),
+    ?assertNot(lists:any(Any, BridgesAfterDelete), BridgesAfterDelete),
     ok.
 
-t_make_delete_bridge_non_existing_server(_Config) ->
-    make_bridge(#{server => <<"non_existing_server">>, port => 3174}),
-    %% Check that the new brige is in the list of bridges
+t_create_delete_bridge_non_existing_server(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    UseTLS = get_tls(Config),
+    create_bridge(Name, UseTLS, #{server => <<"non_existing_server">>, port => 3174}),
+    %% Check that the new bridge is in the list of bridges
     Bridges = emqx_bridge:list(),
-    Name = atom_to_binary(?MODULE),
-    IsRightName =
-        fun
-            (#{name := BName}) when BName =:= Name ->
-                true;
-            (_) ->
-                false
-        end,
-    ?assert(lists:any(IsRightName, Bridges)),
-    delete_bridge(),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Bridges)),
+    ok = delete_bridge(Name),
     BridgesAfterDelete = emqx_bridge:list(),
-    ?assertNot(lists:any(IsRightName, BridgesAfterDelete)),
+    ?assertNot(lists:any(Any, BridgesAfterDelete)),
     ok.
 
 t_send_message_query(Config) ->
-    BridgeID = make_bridge(#{batch_size => 1}),
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    UseTLS = get_tls(Config),
+    BridgeID = create_bridge(Name, UseTLS, RabbitMQ#{batch_size => 1}),
     Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
     %% This will use the SQL template included in the bridge
     emqx_bridge:send_message(BridgeID, Payload),
     %% Check that the data got to the database
     ?assertEqual(Payload, receive_simple_test_message(Config)),
-    delete_bridge(),
+    ok = delete_bridge(Name),
     ok.
 
 t_send_message_query_with_template(Config) ->
-    BridgeID = make_bridge(#{
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    UseTLS = get_tls(Config),
+    BridgeID = create_bridge(Name, UseTLS, RabbitMQ#{
         batch_size => 1,
         payload_template =>
             <<
@@ -318,24 +322,27 @@ t_send_message_query_with_template(Config) ->
         <<"secret">> => 42
     },
     ?assertEqual(ExpectedResult, receive_simple_test_message(Config)),
-    delete_bridge(),
+    ok = delete_bridge(Name),
     ok.
 
 t_send_simple_batch(Config) ->
-    BridgeConf =
-        #{
-            batch_size => 100
-        },
-    BridgeID = make_bridge(BridgeConf),
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeConf = RabbitMQ#{batch_size => 100},
+    UseTLS = get_tls(Config),
+    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
     Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
     emqx_bridge:send_message(BridgeID, Payload),
     ?assertEqual(Payload, receive_simple_test_message(Config)),
-    delete_bridge(),
+    ok = delete_bridge(Name),
     ok.
 
 t_send_simple_batch_with_template(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    UseTLS = get_tls(Config),
     BridgeConf =
-        #{
+        RabbitMQ#{
             batch_size => 100,
             payload_template =>
                 <<
@@ -347,7 +354,7 @@ t_send_simple_batch_with_template(Config) ->
                     "}"
                 >>
         },
-    BridgeID = make_bridge(BridgeConf),
+    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
     Payload = #{
         <<"key">> => 7,
         <<"data">> => <<"RabbitMQ">>,
@@ -358,20 +365,21 @@ t_send_simple_batch_with_template(Config) ->
         <<"secret">> => 42
     },
     ?assertEqual(ExpectedResult, receive_simple_test_message(Config)),
-    delete_bridge(),
+    ok = delete_bridge(Name),
     ok.
 
 t_heavy_batching(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
     NumberOfMessages = 20000,
-    BridgeConf = #{
+    RabbitMQ = get_rabbitmq(Config),
+    UseTLS = get_tls(Config),
+    BridgeConf = RabbitMQ#{
         batch_size => 10173,
         batch_time_ms => 50
     },
-    BridgeID = make_bridge(BridgeConf),
+    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
     SendMessage = fun(Key) ->
-        Payload = #{
-            <<"key">> => Key
-        },
+        Payload = #{<<"key">> => Key},
         emqx_bridge:send_message(BridgeID, Payload)
     end,
     [SendMessage(Key) || Key <- lists:seq(1, NumberOfMessages)],
@@ -385,7 +393,7 @@ t_heavy_batching(Config) ->
         lists:seq(1, NumberOfMessages)
     ),
     ?assertEqual(NumberOfMessages, maps:size(AllMessages)),
-    delete_bridge(),
+    ok = delete_bridge(Name),
     ok.
 
 receive_simple_test_message(Config) ->
@@ -410,17 +418,6 @@ receive_simple_test_message(Config) ->
             #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
                 amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
             emqx_utils_json:decode(Content#amqp_msg.payload)
+    after 5000 ->
+        ?assert(false, "Did not receive message within 5 second")
     end.
-
-rabbitmq_config() ->
-    Config =
-        #{
-            server => rabbit_mq_host(),
-            port => 5672,
-            exchange => rabbit_mq_exchange(),
-            routing_key => rabbit_mq_routing_key()
-        },
-    #{<<"config">> => Config}.
-
-test_data() ->
-    #{<<"msg_field">> => <<"Hello">>}.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
index 689c39dc5..ee5a2609b 100644
--- a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
@@ -14,18 +14,18 @@
 -include_lib("amqp_client/include/amqp_client.hrl").
 
 %% This test SUITE requires a running RabbitMQ instance. If you don't want to
-%% bring up the whole CI infrastuctucture with the `scripts/ct/run.sh` script
+%% bring up the whole CI infrastructure with the `scripts/ct/run.sh` script
 %% you can create a clickhouse instance with the following command.
 %% 5672 is the default port for AMQP 0-9-1 and 15672 is the default port for
-%% the HTTP managament interface.
+%% the HTTP management interface.
 %%
 %% docker run -it --rm --name rabbitmq -p 127.0.0.1:5672:5672 -p 127.0.0.1:15672:15672 rabbitmq:3.11-management
 
 rabbit_mq_host() ->
-    <<"rabbitmq">>.
+    list_to_binary(os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq")).
 
 rabbit_mq_port() ->
-    5672.
+    list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")).
 
 rabbit_mq_password() ->
     <<"guest">>.
@@ -43,17 +43,16 @@ all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    case
-        emqx_common_test_helpers:is_tcp_server_available(
-            erlang:binary_to_list(rabbit_mq_host()), rabbit_mq_port()
-        )
-    of
+    Host = rabbit_mq_host(),
+    Port = rabbit_mq_port(),
+    ct:pal("rabbitmq:~p~n", [{Host, Port}]),
+    case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
             Apps = emqx_cth_suite:start(
                 [emqx_conf, emqx_connector, emqx_bridge_rabbitmq],
                 #{work_dir => emqx_cth_suite:work_dir(Config)}
             ),
-            ChannelConnection = setup_rabbit_mq_exchange_and_queue(),
+            ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port),
             [{channel_connection, ChannelConnection}, {suite_apps, Apps} | Config];
         false ->
             case os:getenv("IS_CI") of
@@ -64,12 +63,12 @@ init_per_suite(Config) ->
             end
     end.
 
-setup_rabbit_mq_exchange_and_queue() ->
-    %% Create an exachange and a queue
+setup_rabbit_mq_exchange_and_queue(Host, Port) ->
+    %% Create an exchange and a queue
     {ok, Connection} =
         amqp_connection:start(#amqp_params_network{
-            host = erlang:binary_to_list(rabbit_mq_host()),
-            port = rabbit_mq_port()
+            host = binary_to_list(Host),
+            port = Port
         }),
     {ok, Channel} = amqp_connection:open_channel(Connection),
     %% Create an exchange
@@ -122,7 +121,7 @@ end_per_suite(Config) ->
 
 t_lifecycle(Config) ->
     perform_lifecycle_check(
-        erlang:atom_to_binary(?MODULE),
+        erlang:atom_to_binary(?FUNCTION_NAME),
         rabbitmq_config(),
         Config
     ).
@@ -144,12 +143,11 @@ t_start_passfile(Config) ->
     ).
 
 perform_lifecycle_check(ResourceID, InitialConfig, TestConfig) ->
-    #{
-        channel := Channel
-    } = get_channel_connection(TestConfig),
+    #{channel := Channel} = get_channel_connection(TestConfig),
     CheckedConfig = check_config(InitialConfig),
     #{
-        state := #{poolname := PoolName} = State,
+        id := PoolName,
+        state := State,
         status := InitialStatus
     } = create_local_resource(ResourceID, CheckedConfig),
     ?assertEqual(InitialStatus, connected),
@@ -211,9 +209,14 @@ create_local_resource(ResourceID, CheckedConfig) ->
 
 perform_query(PoolName, Channel) ->
     %% Send message to queue:
-    ok = emqx_resource:query(PoolName, {query, test_data()}),
+    ActionConfig = rabbitmq_action_config(),
+    ChannelId = <<"test_channel">>,
+    ?assertEqual(ok, emqx_resource_manager:add_channel(PoolName, ChannelId, ActionConfig)),
+    ok = emqx_resource:query(PoolName, {ChannelId, payload()}),
     %% Get the message from queue:
-    ok = receive_simple_test_message(Channel).
+    ok = receive_simple_test_message(Channel),
+    ?assertEqual(ok, emqx_resource_manager:remove_channel(PoolName, ChannelId)),
+    ok.
 
 receive_simple_test_message(Channel) ->
     #'basic.consume_ok'{consumer_tag = ConsumerTag} =
@@ -238,6 +241,8 @@ receive_simple_test_message(Channel) ->
             #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
                 amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
             ok
+    after 5000 ->
+        ?assert(false, "Did not receive message within 5 second")
     end.
 
 rabbitmq_config() ->
@@ -255,5 +260,21 @@ rabbitmq_config(Overrides) ->
         },
     #{<<"config">> => maps:merge(Config, Overrides)}.
 
+payload() ->
+    #{<<"payload">> => test_data()}.
+
 test_data() ->
-    #{<<"msg_field">> => <<"Hello">>}.
+    #{<<"Hello">> => <<"World">>}.
+
+rabbitmq_action_config() ->
+    #{
+        config_root => actions,
+        parameters => #{
+            delivery_mode => non_persistent,
+            exchange => rabbit_mq_exchange(),
+            payload_template => <<"${.payload}">>,
+            publish_confirmation_timeout => 30000,
+            routing_key => rabbit_mq_routing_key(),
+            wait_for_publish_confirmations => true
+        }
+    }.
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 379151639..2935233be 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -64,6 +64,8 @@ resource_type(greptimedb) ->
     emqx_bridge_greptimedb_connector;
 resource_type(tdengine) ->
     emqx_bridge_tdengine_connector;
+resource_type(rabbitmq) ->
+    emqx_bridge_rabbitmq_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -82,6 +84,8 @@ connector_impl_module(opents) ->
     emqx_bridge_opents_connector;
 connector_impl_module(tdengine) ->
     emqx_bridge_tdengine_connector;
+connector_impl_module(rabbitmq) ->
+    emqx_bridge_rabbitmq_connector;
 connector_impl_module(_ConnectorType) ->
     undefined.
 
@@ -258,6 +262,14 @@ connector_structs() ->
                     desc => <<"TDengine Connector Config">>,
                     required => false
                 }
+            )},
+        {rabbitmq,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_rabbitmq_connector_schema, "config_connector")),
+                #{
+                    desc => <<"RabbitMQ Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -281,6 +293,7 @@ schema_modules() ->
         emqx_bridge_redis_schema,
         emqx_bridge_iotdb_connector,
         emqx_bridge_es_connector,
+        emqx_bridge_rabbitmq_connector_schema,
         emqx_bridge_opents_connector,
         emqx_bridge_greptimedb,
         emqx_bridge_tdengine_connector
@@ -317,6 +330,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
         api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
         api_ref(emqx_bridge_opents_connector, <<"opents">>, Method),
+        api_ref(emqx_bridge_rabbitmq_connector_schema, <<"rabbitmq">>, Method),
         api_ref(emqx_bridge_greptimedb, <<"greptimedb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_tdengine_connector, <<"tdengine">>, Method)
     ].
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index bec452f08..53622a828 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -91,7 +91,6 @@ api_schemas(Method) ->
         %% We need to map the `type' field of a request (binary) to a
         %% connector schema module.
         api_ref(emqx_bridge_http_schema, <<"http">>, Method ++ "_connector"),
-        % api_ref(emqx_bridge_mqtt_connector_schema, <<"mqtt_subscriber">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mqtt_connector_schema, <<"mqtt">>, Method ++ "_connector")
     ].
 
@@ -166,7 +165,9 @@ connector_type_to_bridge_types(opents) ->
 connector_type_to_bridge_types(greptimedb) ->
     [greptimedb];
 connector_type_to_bridge_types(tdengine) ->
-    [tdengine].
+    [tdengine];
+connector_type_to_bridge_types(rabbitmq) ->
+    [rabbitmq].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/rebar.config b/rebar.config
index 5ebe9da15..1d9d082af 100644
--- a/rebar.config
+++ b/rebar.config
@@ -14,6 +14,7 @@
     warn_unused_import,
     warn_obsolete_guard,
     compressed,
+    {feature, maybe_expr, enable},
     nowarn_unused_import,
     {d, snk_kind, msg}
 ]}.

From 688701eedbbff5842e0885c8bda0e5274abe31fb Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Fri, 2 Feb 2024 11:45:28 +0800
Subject: [PATCH 169/273] chore: add desc for rabbitmq source

---
 .../src/emqx_bridge_rabbitmq.erl              |  2 +-
 .../src/emqx_bridge_rabbitmq_connector.erl    |  3 +-
 .../emqx_bridge_rabbitmq_connector_schema.erl |  2 +
 .../emqx_bridge_rabbitmq_pubsub_schema.erl    | 34 ++++++-------
 .../src/emqx_bridge_rabbitmq_sup.erl          |  1 +
 .../src/schema/emqx_connector_schema.erl      |  6 +--
 rebar.config                                  |  1 -
 ...qx_bridge_rabbitmq_connector_schema.hocon} | 13 ++++-
 .../emqx_bridge_rabbitmq_pubsub_schema.hocon  | 49 +++++++++++++++++++
 9 files changed, 87 insertions(+), 24 deletions(-)
 rename rel/i18n/{emqx_bridge_rabbitmq_connector.hocon => emqx_bridge_rabbitmq_connector_schema.hocon} (89%)
 create mode 100644 rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon

diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
index 6aa2cc038..d9d182aa9 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq.erl
@@ -78,7 +78,7 @@ fields("config") ->
         {local_topic,
             mk(
                 binary(),
-                #{desc => ?DESC("local_topic"), default => undefined}
+                #{desc => ?DESC("local_topic")}
             )},
         {resource_opts,
             mk(
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
index 45d21d8d0..f7a1e533f 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
@@ -3,7 +3,8 @@
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_rabbitmq_connector).
-%-feature(maybe_expr, enable).
+
+-feature(maybe_expr, enable).
 -include_lib("emqx_connector/include/emqx_connector.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 -include_lib("typerefl/include/types.hrl").
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
index d36eb463c..02b5ae61c 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector_schema.erl
@@ -106,6 +106,8 @@ fields("get") ->
 
 desc("config_connector") ->
     ?DESC("config_connector");
+desc(connector_resource_opts) ->
+    ?DESC(connector_resource_opts);
 desc(_) ->
     undefined.
 
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
index b4bb72c22..34c945937 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
@@ -27,6 +27,7 @@
 
 -define(ACTION_TYPE, rabbitmq).
 -define(SOURCE_TYPE, rabbitmq).
+-define(CONNECTOR_SCHEMA, emqx_bridge_rabbitmq_connector_schema).
 
 %%======================================================================================
 %% Hocon Schema Definitions
@@ -61,7 +62,7 @@ fields(action_parameters) ->
                 boolean(),
                 #{
                     default => true,
-                    desc => ?DESC("wait_for_publish_confirmations")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "wait_for_publish_confirmations")
                 }
             )},
         {publish_confirmation_timeout,
@@ -69,7 +70,7 @@ fields(action_parameters) ->
                 emqx_schema:timeout_duration_ms(),
                 #{
                     default => <<"30s">>,
-                    desc => ?DESC("timeout")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "timeout")
                 }
             )},
         {exchange,
@@ -77,7 +78,7 @@ fields(action_parameters) ->
                 typerefl:binary(),
                 #{
                     required => true,
-                    desc => ?DESC("exchange")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "exchange")
                 }
             )},
         {routing_key,
@@ -85,7 +86,7 @@ fields(action_parameters) ->
                 typerefl:binary(),
                 #{
                     required => true,
-                    desc => ?DESC("routing_key")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "routing_key")
                 }
             )},
         {delivery_mode,
@@ -93,15 +94,14 @@ fields(action_parameters) ->
                 hoconsc:enum([non_persistent, persistent]),
                 #{
                     default => non_persistent,
-                    desc => ?DESC("delivery_mode")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "delivery_mode")
                 }
             )},
         {payload_template,
             hoconsc:mk(
                 binary(),
                 #{
-                    default => <<"${.}">>,
-                    desc => ?DESC("payload_template")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "payload_template")
                 }
             )}
     ];
@@ -117,21 +117,21 @@ fields(source) ->
 fields(subscriber_source) ->
     emqx_bridge_v2_schema:make_consumer_action_schema(
         ?HOCON(
-            ?R_REF(ingress_parameters),
+            ?R_REF(source_parameters),
             #{
                 required => true,
                 desc => ?DESC("source_parameters")
             }
         )
     );
-fields(ingress_parameters) ->
+fields(source_parameters) ->
     [
         {wait_for_publish_confirmations,
             hoconsc:mk(
                 boolean(),
                 #{
                     default => true,
-                    desc => ?DESC("wait_for_publish_confirmations")
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "wait_for_publish_confirmations")
                 }
             )},
         {topic,
@@ -140,7 +140,7 @@ fields(ingress_parameters) ->
                 #{
                     required => true,
                     validator => fun emqx_schema:non_empty_string/1,
-                    desc => ?DESC("ingress_topic")
+                    desc => ?DESC("source_topic")
                 }
             )},
         {qos,
@@ -148,7 +148,7 @@ fields(ingress_parameters) ->
                 ?UNION([emqx_schema:qos(), binary()]),
                 #{
                     default => 0,
-                    desc => ?DESC("ingress_qos")
+                    desc => ?DESC("source_qos")
                 }
             )},
         {payload_template,
@@ -156,7 +156,7 @@ fields(ingress_parameters) ->
                 binary(),
                 #{
                     required => false,
-                    desc => ?DESC("ingress_payload_template")
+                    desc => ?DESC("source_payload_template")
                 }
             )},
         {queue,
@@ -164,7 +164,7 @@ fields(ingress_parameters) ->
                 binary(),
                 #{
                     required => true,
-                    desc => ?DESC("ingress_queue")
+                    desc => ?DESC("source_queue")
                 }
             )},
         {no_ack,
@@ -173,7 +173,7 @@ fields(ingress_parameters) ->
                 #{
                     required => false,
                     default => true,
-                    desc => ?DESC("ingress_no_ack")
+                    desc => ?DESC("source_no_ack")
                 }
             )}
     ];
@@ -210,8 +210,8 @@ desc(source_resource_opts) ->
     ?DESC(emqx_resource_schema, "creation_opts");
 desc(action_parameters) ->
     ?DESC(action_parameters);
-desc(ingress_parameters) ->
-    ?DESC(ingress_parameters);
+desc(source_parameters) ->
+    ?DESC(source_parameters);
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for WebHook using `", string:to_upper(Method), "` method."];
 desc("http_action") ->
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl
index 8cc442ada..b81052269 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_sup.erl
@@ -15,6 +15,7 @@
 %%--------------------------------------------------------------------
 -module(emqx_bridge_rabbitmq_sup).
 
+-feature(maybe_expr, enable).
 -behaviour(supervisor).
 
 -export([ensure_started/2]).
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 53622a828..b803ab9f2 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -731,17 +731,17 @@ schema_homogeneous_test() ->
 is_bad_schema(#{type := ?MAP(_, ?R_REF(Module, TypeName))}) ->
     Fields = Module:fields(TypeName),
     ExpectedFieldNames = common_field_names(),
-    MissingFileds = lists:filter(
+    MissingFields = lists:filter(
         fun(Name) -> lists:keyfind(Name, 1, Fields) =:= false end, ExpectedFieldNames
     ),
-    case MissingFileds of
+    case MissingFields of
         [] ->
             false;
         _ ->
             {true, #{
                 schema_module => Module,
                 type_name => TypeName,
-                missing_fields => MissingFileds
+                missing_fields => MissingFields
             }}
     end.
 
diff --git a/rebar.config b/rebar.config
index 1d9d082af..5ebe9da15 100644
--- a/rebar.config
+++ b/rebar.config
@@ -14,7 +14,6 @@
     warn_unused_import,
     warn_obsolete_guard,
     compressed,
-    {feature, maybe_expr, enable},
     nowarn_unused_import,
     {d, snk_kind, msg}
 ]}.
diff --git a/rel/i18n/emqx_bridge_rabbitmq_connector.hocon b/rel/i18n/emqx_bridge_rabbitmq_connector_schema.hocon
similarity index 89%
rename from rel/i18n/emqx_bridge_rabbitmq_connector.hocon
rename to rel/i18n/emqx_bridge_rabbitmq_connector_schema.hocon
index a0f6161d4..e0574eecb 100644
--- a/rel/i18n/emqx_bridge_rabbitmq_connector.hocon
+++ b/rel/i18n/emqx_bridge_rabbitmq_connector_schema.hocon
@@ -1,5 +1,5 @@
 
-emqx_bridge_rabbitmq_connector {
+emqx_bridge_rabbitmq_connector_schema {
 
 server.desc:
 """The RabbitMQ server address that you want to connect to (for example, localhost)."""
@@ -97,4 +97,15 @@ wait_for_publish_confirmations.desc:
 wait_for_publish_confirmations.label:
 """Wait for Publish Confirmations"""
 
+connector_resource_opts.desc:
+"""Connector resource options."""
+
+connector_resource_opts.label:
+"""Connector Resource Options"""
+
+config_connector.desc:
+"""The configuration for the RabbitMQ connector."""
+config_connector.label:
+"""RabbitMQ Connector Configuration"""
+
 }
diff --git a/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon b/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon
new file mode 100644
index 000000000..a73394386
--- /dev/null
+++ b/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon
@@ -0,0 +1,49 @@
+emqx_bridge_rabbitmq_pubsub_schema {
+
+publisher_action.desc:
+"""Action configs."""
+publisher_action.label:
+"""Action"""
+
+subscriber_source.desc:
+"""Source configs."""
+subscriber_source.label:
+"""Source"""
+
+
+action_parameters.desc:
+"""The action config defines how this bridge send messages to the remote RabbitMQ broker"""
+action_parameters.label:
+"""Action Parameters"""
+
+source_parameters.desc:
+"""The source config defines how this bridge receive messages from the remote RabbitMQ broker"""
+source_parameters.label:
+"""Source Parameters"""
+
+source_topic.desc:
+"""Topic used for constructing MQTT messages, supporting templates."""
+source_topic.label:
+"""Source Topic"""
+
+source_qos.desc:
+"""The QoS level of the MQTT message, supporting templates."""
+source_qos.label:
+"""QoS"""
+
+source_payload_template.desc:
+"""The template used to construct the payload of the MQTT message."""
+source_payload_template.label:
+"""Source Payload Template"""
+
+source_queue.desc:
+"""The queue name of the RabbitMQ broker."""
+source_queue.label:
+"""Source Queue"""
+
+source_no_ack.desc:
+"""Whether to use no_ack mode when consuming messages from the RabbitMQ broker."""
+source_no_ack.label:
+"""Source No Ack"""
+
+}

From e3cb49db8e3eeb9cc3c8d5c421efe044f88d58e5 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Sun, 4 Feb 2024 14:53:42 +0800
Subject: [PATCH 170/273] chore: add copyright header

---
 .../src/emqx_bridge_rabbitmq_source_sup.erl                   | 4 ++++
 .../src/emqx_bridge_rabbitmq_source_worker.erl                | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
index 6497929f5..e15e258dc 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_sup.erl
@@ -1,3 +1,7 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
 -module(emqx_bridge_rabbitmq_source_sup).
 
 -behaviour(supervisor).
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
index b296887eb..b102faf5d 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
@@ -1,3 +1,6 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
 -module(emqx_bridge_rabbitmq_source_worker).
 
 -behaviour(gen_server).

From d65e84e46bfd5f89172d96ad9b23d9d855b68cde Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Sun, 4 Feb 2024 14:56:33 +0800
Subject: [PATCH 171/273] chore: add rabbitmq v2 changelog

---
 changes/ee/feat-12423.en.md | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 changes/ee/feat-12423.en.md

diff --git a/changes/ee/feat-12423.en.md b/changes/ee/feat-12423.en.md
new file mode 100644
index 000000000..88864c2c4
--- /dev/null
+++ b/changes/ee/feat-12423.en.md
@@ -0,0 +1,2 @@
+Split RabbitMQ bridge into connector and action components.
+RabbitMQ support source api to sink RabbitMQ message to EMQX broker.

From 3e599e5d8eb4ce0ad9fe68c71684745e1ad65348 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Mon, 5 Feb 2024 11:06:38 +0800
Subject: [PATCH 172/273] chore: add maybe feature enable on rabbitmq_bridge

---
 apps/emqx_bridge_rabbitmq/rebar.config | 2 +-
 bin/emqx                               | 4 ++--
 build                                  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/apps/emqx_bridge_rabbitmq/rebar.config b/apps/emqx_bridge_rabbitmq/rebar.config
index a2f072e48..a6af22040 100644
--- a/apps/emqx_bridge_rabbitmq/rebar.config
+++ b/apps/emqx_bridge_rabbitmq/rebar.config
@@ -1,6 +1,6 @@
 %% -*- mode: erlang; -*-
 
-{erl_opts, [debug_info]}.
+{erl_opts, [debug_info, {feature, maybe_expr, enable}]}.
 {deps, [
     %% The following two are dependencies of rabbit_common
     {thoas, {git, "https://github.com/emqx/thoas.git", {tag, "v1.0.0"}}},
diff --git a/bin/emqx b/bin/emqx
index bd51106ca..3ee57288f 100755
--- a/bin/emqx
+++ b/bin/emqx
@@ -1188,10 +1188,10 @@ case "${COMMAND}" in
         esac
         case "$COMMAND" in
             foreground)
-                FOREGROUNDOPTIONS="-noshell -noinput +Bd"
+                FOREGROUNDOPTIONS="-enable-feature maybe_expr -noshell -noinput +Bd"
                 ;;
             *)
-                FOREGROUNDOPTIONS=''
+                FOREGROUNDOPTIONS='-enable-feature maybe_expr'
                 ;;
         esac
 
diff --git a/build b/build
index 4a5e01f7e..7c74e5d90 100755
--- a/build
+++ b/build
@@ -136,7 +136,7 @@ make_docs() {
     local docdir="_build/docgen/$PROFILE"
     mkdir -p "$docdir"
     # shellcheck disable=SC2086
-    erl -noshell -eval \
+    erl -enable-feature maybe_expr -noshell -eval \
         "ok = emqx_conf:dump_schema('$docdir', $SCHEMA_MODULE), \
          halt(0)."
     local desc="$docdir/desc.en.hocon"

From 45b3c2aa3c035bdb051e32123fd7be91089d922a Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Mon, 5 Feb 2024 15:19:26 +0800
Subject: [PATCH 173/273] chore: enable maybe_expr in elixir runtime

---
 mix.exs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/mix.exs b/mix.exs
index 9f591f61e..c2eaddcd9 100644
--- a/mix.exs
+++ b/mix.exs
@@ -680,7 +680,8 @@ defmodule EMQXUmbrella.MixProject do
 
     # the elixir version of escript + start.boot required the boot_var
     # RELEASE_LIB to be defined.
-    boot_var = "%%!-boot_var RELEASE_LIB $RUNNER_ROOT_DIR/lib"
+    # enable-feature is not required when 1.6.x
+    boot_var = "%%!-boot_var RELEASE_LIB $RUNNER_ROOT_DIR/lib -enable-feature maybe_expr"
 
     # Files with the version appended are expected by the release
     # upgrade script `install_upgrade.escript`

From a9c55f7568b37577928be7fbd12422cce47ab6c4 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Tue, 6 Feb 2024 01:46:11 +0100
Subject: [PATCH 174/273] feat(sessds): Consider #srs with only QoS0 messages
 fully acked

---
 .../src/emqx_persistent_session_ds_stream_scheduler.erl    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 45bf6ede1..6aa4ab005 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -168,7 +168,6 @@ del_subscription(SubId, S0) ->
 %%================================================================================
 
 ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
-    %% TODO: hash collisions
     Key = {SubId, Stream},
     case emqx_persistent_session_ds_state:get_stream(Key, S) of
         undefined ->
@@ -303,6 +302,12 @@ compare_streams(
 is_fully_replayed(Comm1, Comm2, S = #srs{it_end = It}) ->
     It =:= end_of_stream andalso is_fully_acked(Comm1, Comm2, S).
 
+is_fully_acked(_, _, #srs{
+    first_seqno_qos1 = Q1, last_seqno_qos1 = Q1, first_seqno_qos2 = Q2, last_seqno_qos2 = Q2
+}) ->
+    %% Streams where the last chunk doesn't contain any QoS1 and 2
+    %% messages are considered fully acked:
+    true;
 is_fully_acked(Comm1, Comm2, #srs{last_seqno_qos1 = S1, last_seqno_qos2 = S2}) ->
     (Comm1 >= S1) andalso (Comm2 >= S2).
 

From 30eb54e86b3a2e4233e68a46c71bb236e8684237 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 5 Feb 2024 19:30:12 +0100
Subject: [PATCH 175/273] fix(sessds): Delay unsubscribe until full ack of
 in-flight messages

---
 apps/emqx/src/emqx_persistent_session_ds.hrl  |  5 +-
 ...persistent_session_ds_stream_scheduler.erl | 70 ++++++++++++++++---
 2 files changed, 63 insertions(+), 12 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.hrl b/apps/emqx/src/emqx_persistent_session_ds.hrl
index fa4bfacf1..8a24be31e 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.hrl
+++ b/apps/emqx/src/emqx_persistent_session_ds.hrl
@@ -62,7 +62,10 @@
     first_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno(),
     %% Sequence numbers that have to be committed for the batch:
     last_seqno_qos1 = 0 :: emqx_persistent_session_ds:seqno(),
-    last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno()
+    last_seqno_qos2 = 0 :: emqx_persistent_session_ds:seqno(),
+    %% This stream belongs to an unsubscribed topic-filter, and is
+    %% marked for deletion:
+    unsubscribed = false :: boolean()
 }).
 
 %% Session metadata keys:
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 6aa4ab005..745a3f948 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -93,7 +93,7 @@ find_new_streams(S) ->
                 (_Key, #srs{it_end = end_of_stream}, Acc) ->
                     Acc;
                 (Key, Stream, Acc) ->
-                    case is_fully_acked(Comm1, Comm2, Stream) of
+                    case is_fully_acked(Comm1, Comm2, Stream) andalso not Stream#srs.unsubscribed of
                         true ->
                             [{Key, Stream} | Acc];
                         false ->
@@ -124,25 +124,26 @@ find_new_streams(S) ->
 %% This way, messages from the same topic/shard are never reordered.
 -spec renew_streams(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
 renew_streams(S0) ->
-    S1 = remove_fully_replayed_streams(S0),
+    S1 = remove_unsubscribed_streams(S0),
+    S2 = remove_fully_replayed_streams(S1),
     emqx_topic_gbt:fold(
-        fun(Key, _Subscription = #{start_time := StartTime, id := SubId}, S2) ->
+        fun(Key, _Subscription = #{start_time := StartTime, id := SubId}, Acc) ->
             TopicFilter = emqx_topic:words(emqx_trie_search:get_topic(Key)),
             Streams = select_streams(
                 SubId,
                 emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
-                S2
+                Acc
             ),
             lists:foldl(
-                fun(I, Acc) ->
-                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc)
+                fun(I, Acc1) ->
+                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc1)
                 end,
-                S2,
+                Acc,
                 Streams
             )
         end,
-        S1,
-        emqx_persistent_session_ds_state:get_subscriptions(S1)
+        S2,
+        emqx_persistent_session_ds_state:get_subscriptions(S2)
     ).
 
 -spec del_subscription(
@@ -150,11 +151,33 @@ renew_streams(S0) ->
 ) ->
     emqx_persistent_session_ds_state:t().
 del_subscription(SubId, S0) ->
+    %% NOTE: this function only marks the streams for deletion,
+    %% instead of outright deleting them.
+    %%
+    %% It's done for two reasons:
+    %%
+    %% - MQTT standard states that the broker MUST process acks for
+    %% all sent messages, and it MAY keep on sending buffered
+    %% messages:
+    %% https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901186
+    %%
+    %% - Deleting the streams may lead to gaps in the sequence number
+    %% series, and lead to problems with acknowledgement tracking, we
+    %% avoid that by delaying the deletion.
+    %%
+    %% When the stream is marked for deletion, the session won't fetch
+    %% _new_ batches from it. Actual deletion is done by
+    %% `renew_streams', when it detects that all in-flight messages
+    %% from the stream have been acked by the client.
     emqx_persistent_session_ds_state:fold_streams(
-        fun(Key, _, Acc) ->
+        fun(Key, ReplayState, Acc) ->
             case Key of
                 {SubId, _Stream} ->
-                    emqx_persistent_session_ds_state:del_stream(Key, Acc);
+                    %% This stream belongs to a deleted subscription.
+                    %% Mark for deletion:
+                    emqx_persistent_session_ds_state:put_stream(
+                        Key, ReplayState#srs{unsubscribed = true}, Acc
+                    );
                 _ ->
                     Acc
             end
@@ -184,6 +207,10 @@ ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
                 it_end = Iterator
             },
             emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
+        SRS = #srs{unsubscribed = true} ->
+            %% The session resubscribed to the stream after
+            %% unsubscribing. Spare the stream:
+            emqx_persistent_session_ds_state:put_stream(Key, SRS#srs{unsubscribed = false}, S);
         #srs{} ->
             S
     end.
@@ -222,6 +249,27 @@ select_streams(SubId, RankX, Streams0, S) ->
             lists:takewhile(fun({{_, Y}, _}) -> Y =:= MinRankY end, Streams)
     end.
 
+%% @doc Remove fully acked streams for the deleted subscriptions.
+-spec remove_unsubscribed_streams(emqx_persistent_session_ds_state:t()) ->
+    emqx_persistent_session_ds_state:t().
+remove_unsubscribed_streams(S0) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S0),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S0),
+    emqx_persistent_session_ds_state:fold_streams(
+        fun(Key, ReplayState, S1) ->
+            case
+                ReplayState#srs.unsubscribed andalso is_fully_acked(CommQos1, CommQos2, ReplayState)
+            of
+                true ->
+                    emqx_persistent_session_ds_state:del_stream(Key, S1);
+                false ->
+                    S1
+            end
+        end,
+        S0,
+        S0
+    ).
+
 %% @doc Advance RankY for each RankX that doesn't have any unreplayed
 %% streams.
 %%

From 63a2a055740713fed1dadb92dbfc4d663a569256 Mon Sep 17 00:00:00 2001
From: Hecate2 <hecate2@qq.com>
Date: Sun, 4 Feb 2024 10:02:39 +0800
Subject: [PATCH 176/273] chore: delete Windows.md

---
 Windows.md | 131 -----------------------------------------------------
 1 file changed, 131 deletions(-)
 delete mode 100644 Windows.md

diff --git a/Windows.md b/Windows.md
deleted file mode 100644
index a3e5deb11..000000000
--- a/Windows.md
+++ /dev/null
@@ -1,131 +0,0 @@
-# Build and run EMQX on Windows
-
-NOTE: The instructions and examples are based on Windows 10.
-
-## Build Environment
-
-### Visual studio for C/C++ compile and link
-
-EMQX includes Erlang NIF (Native Implemented Function) components, implemented
-in C/C++. To compile and link C/C++ libraries, the easiest way is perhaps to
-install Visual Studio.
-
-Visual Studio 2019 is used in our tests.
-If you are like me (@zmstone), do not know where to start,
-please follow this OTP guide:
-https://github.com/erlang/otp/blob/master/HOWTO/INSTALL-WIN32.md
-
-NOTE: To avoid surprises, you may need to add below two paths to `Path` environment variable
-and order them before other paths.
-
-```
-C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.28.29910\bin\Hostx64\x64
-C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build
-```
-
-Depending on your visual studio version and OS, the paths may differ.
-The first path is for rebar3 port compiler to find `cl.exe` and `link.exe`
-The second path is for CMD to setup environment variables.
-
-### Erlang/OTP
-
-Install Erlang/OTP 24 from https://www.erlang.org/downloads
-You may need to edit the `Path` environment variable to allow running
-Erlang commands such as `erl` from powershell.
-
-To validate Erlang installation in CMD or powershell:
-
-* Start (or restart) CMD or powershell
-
-* Execute `erl` command to enter Erlang shell
-
-* Evaluate Erlang expression `halt().` to exit Erlang shell.
-
-e.g.
-
-```
-PS C:\Users\zmsto> erl
-Eshell V12.2.1  (abort with ^G)
-1> halt().
-```
-
-### bash
-
-All EMQX build/run scripts are either in `bash` or `escript`.
-`escript` is installed as a part of Erlang. To install a `bash`
-environment in Windows, there are quite a few options.
-
-Cygwin is what we tested with.
-
-* Add `cygwin\bin` dir to `Path` environment variable
-  To do so, search for Edit environment variable in control panel and
-  add `C:\tools\cygwin\bin` (depending on the location where it was installed)
-  to `Path` list.
-
-* Validate installation.
-  Start (restart) CMD or powershell console and execute `which bash`, it should
-  print out `/usr/bin/bash`
-
-NOTE: Make sure cygwin's bin dir is added before `C:\Windows\system32` in `Path`,
-otherwise the build scripts may end up using binaries from wsl instead of cygwin.
-
-### Other tools
-
-Some of the unix world tools are required to build EMQX.  Including:
-
-* git
-* curl
-* make
-* cmake
-* jq
-* zip / unzip
-
-We recommend using [scoop](https://scoop.sh/), or [Chocolatey](https://chocolatey.org/install) to install the tools.
-
-When using scoop:
-
-```
-scoop install git curl make cmake jq zip unzip
-```
-
-## Build EMQX source code
-
-* Clone the repo: `git clone https://github.com/emqx/emqx.git`
-
-* Start CMD console
-
-* Execute `vcvarsall.bat x86_amd64` to load environment variables
-
-* Change to emqx directory and execute `make`
-
-### Possible errors
-
-* `'cl.exe' is not recognized as an internal or external command`
-  This error is likely due to Visual Studio executables are not set in `Path` environment variable.
-  To fix it, either add path like `C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.28.29910\bin\Hostx64\x64`
-  to `Paht`. Or make sure `vcvarsall.bat x86_amd64` is executed prior to the `make` command
-
-* `fatal error C1083: Cannot open include file: 'assert.h': No such file or directory`
-  If Visual Studio is installed correctly, this is likely `LIB` and `LIB_PATH` environment
-  variables are not set. Make sure `vcvarsall.bat x86_amd64` is executed prior to the `make` command
-
-* `link: extra operand 'some.obj'`
-  This is likely due to the usage of GNU `lnik.exe` but not the one from Visual Studio.
-  Execute `link.exe --version` to inspect which one is in use. The one installed from
-  Visual Studio should print out `Microsoft (R) Incremental Linker`.
-  To fix it, Visual Studio's bin paths should be ordered prior to Cygwin's (or similar installation's)
-  bin paths in `Path` environment variable.
-
-## Run EMQX
-
-To start EMQX broker.
-
-Execute `_build\emqx\rel\emqx>.\bin\emqx console` or `_build\emqx\rel\emqx>.\bin\emqx start` to start EMQX.
-
-Then execute `_build\emqx\rel\emqx>.\bin\emqx_ctl status` to check status.
-If everything works fine, it should print out
-
-```
-Node 'emqx@127.0.0.1' 4.3-beta.1 is started
-Application emqx 4.3.0 is running
-```

From 3000a8f286b84b4cc38fdf95ef4ee8a7e57f5eac Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Mon, 5 Feb 2024 23:48:14 +0100
Subject: [PATCH 177/273] fix(sessds): Postpone deletion of the subscription
 until fully acked

---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 69 ++++++++++++++--
 ...persistent_session_ds_stream_scheduler.erl | 53 +++++++------
 .../test/emqx_persistent_session_SUITE.erl    | 79 ++++++++++++++++++-
 3 files changed, 170 insertions(+), 31 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index cf027bd47..d92e3cc24 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -117,7 +117,7 @@
     id := subscription_id(),
     start_time := emqx_ds:time(),
     props := map(),
-    extra := map()
+    deleted := boolean()
 }.
 
 -define(TIMER_PULL, timer_pull).
@@ -313,7 +313,8 @@ subscribe(
             Subscription = #{
                 start_time => now_ms(),
                 props => SubOpts,
-                id => SubId
+                id => SubId,
+                deleted => false
             },
             IsNew = true;
         Subscription0 = #{} ->
@@ -343,12 +344,17 @@ unsubscribe(
 
 -spec do_unsubscribe(id(), topic_filter(), subscription(), emqx_persistent_session_ds_state:t()) ->
     emqx_persistent_session_ds_state:t().
-do_unsubscribe(SessionId, TopicFilter, #{id := SubId}, S0) ->
-    S1 = emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], S0),
+do_unsubscribe(SessionId, TopicFilter, SubMeta0 = #{id := SubId}, S0) ->
+    %% Note: we cannot delete the subscription immediately, since its
+    %% metadata can be used during replay (see `process_batch'). We
+    %% instead mark it as deleted, and let `subscription_gc' function
+    %% dispatch it later:
+    SubMeta = SubMeta0#{deleted => true},
+    S1 = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], SubMeta, S0),
     ?tp(persistent_session_ds_subscription_delete, #{
         session_id => SessionId, topic_filter => TopicFilter
     }),
-    S = emqx_persistent_session_ds_stream_scheduler:del_subscription(SubId, S1),
+    S = emqx_persistent_session_ds_stream_scheduler:on_unsubscribe(SubId, S1),
     ?tp_span(
         persistent_session_ds_subscription_route_delete,
         #{session_id => SessionId, topic_filter => TopicFilter},
@@ -459,7 +465,8 @@ handle_timeout(
     Session = emqx_session:ensure_timer(?TIMER_PULL, Timeout, Session1),
     {ok, Publishes, Session};
 handle_timeout(_ClientInfo, ?TIMER_GET_STREAMS, Session0 = #{s := S0}) ->
-    S = emqx_persistent_session_ds_stream_scheduler:renew_streams(S0),
+    S1 = subscription_gc(S0),
+    S = emqx_persistent_session_ds_stream_scheduler:renew_streams(S1),
     Interval = emqx_config:get([session_persistence, renew_streams_interval]),
     Session = emqx_session:ensure_timer(
         ?TIMER_GET_STREAMS,
@@ -502,6 +509,7 @@ replay(ClientInfo, [], Session0 = #{s := S0}) ->
         Session0,
         Streams
     ),
+    logger:error("Replay streams: ~p~n~p", [Streams, Session]),
     %% Note: we filled the buffer with the historical messages, and
     %% from now on we'll rely on the normal inflight/flow control
     %% mechanisms to replay them:
@@ -897,9 +905,43 @@ do_drain_buffer(Inflight0, S0, Acc) ->
 
 %%--------------------------------------------------------------------------------
 
+%% @doc Remove subscriptions that have been marked for deletion, and
+%% that don't have any unacked messages:
+subscription_gc(S0) ->
+    subs_fold_all(
+        fun(TopicFilter, #{id := SubId, deleted := Deleted}, Acc) ->
+            case Deleted andalso has_no_unacked_streams(SubId, S0) of
+                true ->
+                    emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], Acc);
+                false ->
+                    Acc
+            end
+        end,
+        S0,
+        S0
+    ).
+
+has_no_unacked_streams(SubId, S) ->
+    emqx_persistent_session_ds_state:fold_streams(
+        fun
+            ({SID, _Stream}, Srs, Acc) when SID =:= SubId ->
+                emqx_persistent_session_ds_stream_scheduler:is_fully_acked(Srs, S) andalso Acc;
+            (_StreamKey, _Srs, Acc) ->
+                Acc
+        end,
+        true,
+        S
+    ).
+
+%% @doc It only returns subscriptions that haven't been marked for deletion:
 subs_lookup(TopicFilter, S) ->
     Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
-    emqx_topic_gbt:lookup(TopicFilter, [], Subs, undefined).
+    case emqx_topic_gbt:lookup(TopicFilter, [], Subs, undefined) of
+        #{deleted := true} ->
+            undefined;
+        Sub ->
+            Sub
+    end.
 
 subs_to_map(S) ->
     subs_fold(
@@ -909,6 +951,19 @@ subs_to_map(S) ->
     ).
 
 subs_fold(Fun, AccIn, S) ->
+    subs_fold_all(
+        fun(TopicFilter, Sub = #{deleted := Deleted}, Acc) ->
+            case Deleted of
+                true -> Acc;
+                false -> Fun(TopicFilter, Sub, Acc)
+            end
+        end,
+        AccIn,
+        S
+    ).
+
+%% @doc Iterate over all subscriptions, including the deleted ones:
+subs_fold_all(Fun, AccIn, S) ->
     Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
     emqx_topic_gbt:fold(
         fun(Key, Sub, Acc) -> Fun(emqx_topic_gbt:get_topic(Key), Sub, Acc) end,
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index 745a3f948..ae15f2bd6 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -16,8 +16,8 @@
 -module(emqx_persistent_session_ds_stream_scheduler).
 
 %% API:
--export([find_new_streams/1, find_replay_streams/1]).
--export([renew_streams/1, del_subscription/2]).
+-export([find_new_streams/1, find_replay_streams/1, is_fully_acked/2]).
+-export([renew_streams/1, on_unsubscribe/2]).
 
 %% behavior callbacks:
 -export([]).
@@ -127,30 +127,33 @@ renew_streams(S0) ->
     S1 = remove_unsubscribed_streams(S0),
     S2 = remove_fully_replayed_streams(S1),
     emqx_topic_gbt:fold(
-        fun(Key, _Subscription = #{start_time := StartTime, id := SubId}, Acc) ->
-            TopicFilter = emqx_topic:words(emqx_trie_search:get_topic(Key)),
-            Streams = select_streams(
-                SubId,
-                emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
+        fun
+            (Key, _Subscription = #{start_time := StartTime, id := SubId, deleted := false}, Acc) ->
+                TopicFilter = emqx_topic:words(emqx_trie_search:get_topic(Key)),
+                Streams = select_streams(
+                    SubId,
+                    emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
+                    Acc
+                ),
+                lists:foldl(
+                    fun(I, Acc1) ->
+                        ensure_iterator(TopicFilter, StartTime, SubId, I, Acc1)
+                    end,
+                    Acc,
+                    Streams
+                );
+            (_Key, _DeletedSubscription, Acc) ->
                 Acc
-            ),
-            lists:foldl(
-                fun(I, Acc1) ->
-                    ensure_iterator(TopicFilter, StartTime, SubId, I, Acc1)
-                end,
-                Acc,
-                Streams
-            )
         end,
         S2,
         emqx_persistent_session_ds_state:get_subscriptions(S2)
     ).
 
--spec del_subscription(
+-spec on_unsubscribe(
     emqx_persistent_session_ds:subscription_id(), emqx_persistent_session_ds_state:t()
 ) ->
     emqx_persistent_session_ds_state:t().
-del_subscription(SubId, S0) ->
+on_unsubscribe(SubId, S0) ->
     %% NOTE: this function only marks the streams for deletion,
     %% instead of outright deleting them.
     %%
@@ -170,13 +173,13 @@ del_subscription(SubId, S0) ->
     %% `renew_streams', when it detects that all in-flight messages
     %% from the stream have been acked by the client.
     emqx_persistent_session_ds_state:fold_streams(
-        fun(Key, ReplayState, Acc) ->
+        fun(Key, Srs, Acc) ->
             case Key of
                 {SubId, _Stream} ->
                     %% This stream belongs to a deleted subscription.
                     %% Mark for deletion:
                     emqx_persistent_session_ds_state:put_stream(
-                        Key, ReplayState#srs{unsubscribed = true}, Acc
+                        Key, Srs#srs{unsubscribed = true}, Acc
                     );
                 _ ->
                     Acc
@@ -186,6 +189,14 @@ del_subscription(SubId, S0) ->
         S0
     ).
 
+-spec is_fully_acked(
+    emqx_persistent_session_ds:stream_state(), emqx_persistent_session_ds_state:t()
+) -> boolean().
+is_fully_acked(Srs, S) ->
+    CommQos1 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_1), S),
+    CommQos2 = emqx_persistent_session_ds_state:get_seqno(?committed(?QOS_2), S),
+    is_fully_acked(CommQos1, CommQos2, Srs).
+
 %%================================================================================
 %% Internal functions
 %%================================================================================
@@ -207,10 +218,6 @@ ensure_iterator(TopicFilter, StartTime, SubId, {{RankX, RankY}, Stream}, S) ->
                 it_end = Iterator
             },
             emqx_persistent_session_ds_state:put_stream(Key, NewStreamState, S);
-        SRS = #srs{unsubscribed = true} ->
-            %% The session resubscribed to the stream after
-            %% unsubscribing. Spare the stream:
-            emqx_persistent_session_ds_state:put_stream(Key, SRS#srs{unsubscribed = false}, S);
         #srs{} ->
             S
     end.
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index bdd3e367f..f8ee11c08 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -278,7 +278,10 @@ publish_many(Messages) ->
 
 publish_many(Messages, WaitForUnregister) ->
     Fun = fun(Client, Message) ->
-        {ok, _} = emqtt:publish(Client, Message)
+        case emqtt:publish(Client, Message) of
+            ok -> ok;
+            {ok, _} -> ok
+        end
     end,
     do_publish(Messages, Fun, WaitForUnregister).
 
@@ -1026,6 +1029,80 @@ t_unsubscribe(Config) ->
     ?assertMatch([], [Sub || {ST, _} = Sub <- emqtt:subscriptions(Client), ST =:= STopic]),
     ok = emqtt:disconnect(Client).
 
+%% This testcase verifies that un-acked messages that were once sent
+%% to the client are still retransmitted after the session
+%% unsubscribes from the topic and reconnects.
+t_unsubscribe_replay(Config) ->
+    ConnFun = ?config(conn_fun, Config),
+    TopicPrefix = ?config(topic, Config),
+    ClientId = atom_to_binary(?FUNCTION_NAME),
+    ClientOpts = [
+        {proto_ver, v5},
+        {clientid, ClientId},
+        {properties, #{'Session-Expiry-Interval' => 30, 'Receive-Maximum' => 10}},
+        {max_inflight, 10}
+        | Config
+    ],
+    {ok, Sub} = emqtt:start_link([{clean_start, true}, {auto_ack, never} | ClientOpts]),
+    {ok, _} = emqtt:ConnFun(Sub),
+    %% 1. Make two subscriptions, one is to be deleted:
+    Topic1 = iolist_to_binary([TopicPrefix, $/, <<"unsub">>]),
+    Topic2 = iolist_to_binary([TopicPrefix, $/, <<"sub">>]),
+    ?assertMatch({ok, _, _}, emqtt:subscribe(Sub, Topic1, qos2)),
+    ?assertMatch({ok, _, _}, emqtt:subscribe(Sub, Topic2, qos2)),
+    %% 2. Publish 2 messages to the first and second topics each
+    %% (client doesn't ack them):
+    ok = publish(Topic1, <<"1">>, ?QOS_1),
+    ok = publish(Topic1, <<"2">>, ?QOS_2),
+    [Msg1, Msg2] = receive_messages(2),
+    ?assertMatch(
+        [
+            #{payload := <<"1">>},
+            #{payload := <<"2">>}
+        ],
+        [Msg1, Msg2]
+    ),
+    ok = publish(Topic2, <<"3">>, ?QOS_1),
+    ok = publish(Topic2, <<"4">>, ?QOS_2),
+    [Msg3, Msg4] = receive_messages(2),
+    ?assertMatch(
+        [
+            #{payload := <<"3">>},
+            #{payload := <<"4">>}
+        ],
+        [Msg3, Msg4]
+    ),
+    %% 3. Unsubscribe from the topic and disconnect:
+    ?assertMatch({ok, _, _}, emqtt:unsubscribe(Sub, Topic1)),
+    ok = emqtt:disconnect(Sub),
+    %% 5. Publish more messages to the disconnected topic:
+    ok = publish(Topic1, <<"5">>, ?QOS_1),
+    ok = publish(Topic1, <<"6">>, ?QOS_2),
+    %% 4. Reconnect the client. It must only receive only four
+    %% messages from the time when it was subscribed:
+    {ok, Sub1} = emqtt:start_link([{clean_start, false}, {auto_ack, true} | ClientOpts]),
+    ?assertMatch({ok, _}, emqtt:ConnFun(Sub1)),
+    %% Note: we ask for 6 messages, but expect only 4, it's
+    %% intentional:
+    ?assertMatch(
+        #{
+            Topic1 := [<<"1">>, <<"2">>],
+            Topic2 := [<<"3">>, <<"4">>]
+        },
+        get_topicwise_order(receive_messages(6, 5_000)),
+        debug_info(ClientId)
+    ),
+    %% 5. Now let's resubscribe, and check that the session can receive new messages:
+    ?assertMatch({ok, _, _}, emqtt:subscribe(Sub1, Topic1, qos2)),
+    ok = publish(Topic1, <<"7">>, ?QOS_0),
+    ok = publish(Topic1, <<"8">>, ?QOS_1),
+    ok = publish(Topic1, <<"9">>, ?QOS_2),
+    ?assertMatch(
+        [<<"7">>, <<"8">>, <<"9">>],
+        lists:map(fun get_msgpub_payload/1, receive_messages(3))
+    ),
+    ok = emqtt:disconnect(Sub1).
+
 t_multiple_subscription_matches(Config) ->
     ConnFun = ?config(conn_fun, Config),
     Topic = ?config(topic, Config),

From 19c6d1127ff4e56f9cce82e08eb859dbcba6b1f1 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 7 Feb 2024 12:41:51 +0100
Subject: [PATCH 178/273] refactor(sessds): Extract subscription mgmt logic to
 separate module

---
 apps/emqx/src/emqx_persistent_session_ds.erl  |  92 +----------
 ...persistent_session_ds_stream_scheduler.erl |   8 +-
 .../src/emqx_persistent_session_ds_subs.erl   | 154 ++++++++++++++++++
 3 files changed, 167 insertions(+), 87 deletions(-)
 create mode 100644 apps/emqx/src/emqx_persistent_session_ds_subs.erl

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index d92e3cc24..16b6db8a9 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -209,7 +209,7 @@ info(created_at, #{s := S}) ->
 info(is_persistent, #{}) ->
     true;
 info(subscriptions, #{s := S}) ->
-    subs_to_map(S);
+    emqx_persistent_session_ds_subs:to_map(S);
 info(subscriptions_cnt, #{s := S}) ->
     emqx_topic_gbt:size(emqx_persistent_session_ds_state:get_subscriptions(S));
 info(subscriptions_max, #{props := Conf}) ->
@@ -280,7 +280,7 @@ subscribe(
     SubOpts,
     Session = #{id := ID, s := S0}
 ) ->
-    case subs_lookup(TopicFilter, S0) of
+    case emqx_persistent_session_ds_subs:lookup(TopicFilter, S0) of
         undefined ->
             %% TODO: max subscriptions
 
@@ -322,7 +322,7 @@ subscribe(
             IsNew = false,
             S1 = S0
     end,
-    S = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S1),
+    S = emqx_persistent_session_ds_subs:on_subscribe(TopicFilter, Subscription, S1),
     ?tp(persistent_session_ds_subscription_added, #{
         topic_filter => TopicFilter, sub => Subscription, is_new => IsNew
     }),
@@ -334,7 +334,7 @@ unsubscribe(
     TopicFilter,
     Session = #{id := ID, s := S0}
 ) ->
-    case subs_lookup(TopicFilter, S0) of
+    case emqx_persistent_session_ds_subs:lookup(TopicFilter, S0) of
         undefined ->
             {error, ?RC_NO_SUBSCRIPTION_EXISTED};
         Subscription = #{props := SubOpts} ->
@@ -344,13 +344,8 @@ unsubscribe(
 
 -spec do_unsubscribe(id(), topic_filter(), subscription(), emqx_persistent_session_ds_state:t()) ->
     emqx_persistent_session_ds_state:t().
-do_unsubscribe(SessionId, TopicFilter, SubMeta0 = #{id := SubId}, S0) ->
-    %% Note: we cannot delete the subscription immediately, since its
-    %% metadata can be used during replay (see `process_batch'). We
-    %% instead mark it as deleted, and let `subscription_gc' function
-    %% dispatch it later:
-    SubMeta = SubMeta0#{deleted => true},
-    S1 = emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], SubMeta, S0),
+do_unsubscribe(SessionId, TopicFilter, Subscription = #{id := SubId}, S0) ->
+    S1 = emqx_persistent_session_ds_subs:on_unsubscribe(TopicFilter, Subscription, S0),
     ?tp(persistent_session_ds_subscription_delete, #{
         session_id => SessionId, topic_filter => TopicFilter
     }),
@@ -365,7 +360,7 @@ do_unsubscribe(SessionId, TopicFilter, SubMeta0 = #{id := SubId}, S0) ->
 -spec get_subscription(topic_filter(), session()) ->
     emqx_types:subopts() | undefined.
 get_subscription(TopicFilter, #{s := S}) ->
-    case subs_lookup(TopicFilter, S) of
+    case emqx_persistent_session_ds_subs:lookup(TopicFilter, S) of
         _Subscription = #{props := SubOpts} ->
             SubOpts;
         undefined ->
@@ -465,7 +460,7 @@ handle_timeout(
     Session = emqx_session:ensure_timer(?TIMER_PULL, Timeout, Session1),
     {ok, Publishes, Session};
 handle_timeout(_ClientInfo, ?TIMER_GET_STREAMS, Session0 = #{s := S0}) ->
-    S1 = subscription_gc(S0),
+    S1 = emqx_persistent_session_ds_subs:gc(S0),
     S = emqx_persistent_session_ds_stream_scheduler:renew_streams(S1),
     Interval = emqx_config:get([session_persistence, renew_streams_interval]),
     Session = emqx_session:ensure_timer(
@@ -509,7 +504,6 @@ replay(ClientInfo, [], Session0 = #{s := S0}) ->
         Session0,
         Streams
     ),
-    logger:error("Replay streams: ~p~n~p", [Streams, Session]),
     %% Note: we filled the buffer with the historical messages, and
     %% from now on we'll rely on the normal inflight/flow control
     %% mechanisms to replay them:
@@ -687,7 +681,7 @@ session_drop(ID, Reason) ->
     case emqx_persistent_session_ds_state:open(ID) of
         {ok, S0} ->
             ?tp(debug, drop_persistent_session, #{client_id => ID, reason => Reason}),
-            _S = subs_fold(
+            _S = emqx_persistent_session_ds_subs:fold(
                 fun(TopicFilter, Subscription, S) ->
                     do_unsubscribe(ID, TopicFilter, Subscription, S)
                 end,
@@ -905,74 +899,6 @@ do_drain_buffer(Inflight0, S0, Acc) ->
 
 %%--------------------------------------------------------------------------------
 
-%% @doc Remove subscriptions that have been marked for deletion, and
-%% that don't have any unacked messages:
-subscription_gc(S0) ->
-    subs_fold_all(
-        fun(TopicFilter, #{id := SubId, deleted := Deleted}, Acc) ->
-            case Deleted andalso has_no_unacked_streams(SubId, S0) of
-                true ->
-                    emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], Acc);
-                false ->
-                    Acc
-            end
-        end,
-        S0,
-        S0
-    ).
-
-has_no_unacked_streams(SubId, S) ->
-    emqx_persistent_session_ds_state:fold_streams(
-        fun
-            ({SID, _Stream}, Srs, Acc) when SID =:= SubId ->
-                emqx_persistent_session_ds_stream_scheduler:is_fully_acked(Srs, S) andalso Acc;
-            (_StreamKey, _Srs, Acc) ->
-                Acc
-        end,
-        true,
-        S
-    ).
-
-%% @doc It only returns subscriptions that haven't been marked for deletion:
-subs_lookup(TopicFilter, S) ->
-    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
-    case emqx_topic_gbt:lookup(TopicFilter, [], Subs, undefined) of
-        #{deleted := true} ->
-            undefined;
-        Sub ->
-            Sub
-    end.
-
-subs_to_map(S) ->
-    subs_fold(
-        fun(TopicFilter, #{props := Props}, Acc) -> Acc#{TopicFilter => Props} end,
-        #{},
-        S
-    ).
-
-subs_fold(Fun, AccIn, S) ->
-    subs_fold_all(
-        fun(TopicFilter, Sub = #{deleted := Deleted}, Acc) ->
-            case Deleted of
-                true -> Acc;
-                false -> Fun(TopicFilter, Sub, Acc)
-            end
-        end,
-        AccIn,
-        S
-    ).
-
-%% @doc Iterate over all subscriptions, including the deleted ones:
-subs_fold_all(Fun, AccIn, S) ->
-    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
-    emqx_topic_gbt:fold(
-        fun(Key, Sub, Acc) -> Fun(emqx_topic_gbt:get_topic(Key), Sub, Acc) end,
-        AccIn,
-        Subs
-    ).
-
-%%--------------------------------------------------------------------------------
-
 %% TODO: find a more reliable way to perform actions that have side
 %% effects. Add `CBM:init' callback to the session behavior?
 -spec ensure_timers(session()) -> session().
diff --git a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
index ae15f2bd6..286d32ef4 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_stream_scheduler.erl
@@ -126,10 +126,10 @@ find_new_streams(S) ->
 renew_streams(S0) ->
     S1 = remove_unsubscribed_streams(S0),
     S2 = remove_fully_replayed_streams(S1),
-    emqx_topic_gbt:fold(
+    emqx_persistent_session_ds_subs:fold(
         fun
-            (Key, _Subscription = #{start_time := StartTime, id := SubId, deleted := false}, Acc) ->
-                TopicFilter = emqx_topic:words(emqx_trie_search:get_topic(Key)),
+            (Key, #{start_time := StartTime, id := SubId, deleted := false}, Acc) ->
+                TopicFilter = emqx_topic:words(Key),
                 Streams = select_streams(
                     SubId,
                     emqx_ds:get_streams(?PERSISTENT_MESSAGE_DB, TopicFilter, StartTime),
@@ -146,7 +146,7 @@ renew_streams(S0) ->
                 Acc
         end,
         S2,
-        emqx_persistent_session_ds_state:get_subscriptions(S2)
+        S2
     ).
 
 -spec on_unsubscribe(
diff --git a/apps/emqx/src/emqx_persistent_session_ds_subs.erl b/apps/emqx/src/emqx_persistent_session_ds_subs.erl
new file mode 100644
index 000000000..92f17b108
--- /dev/null
+++ b/apps/emqx/src/emqx_persistent_session_ds_subs.erl
@@ -0,0 +1,154 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+%% @doc This module encapsulates the data related to the client's
+%% subscriptions. It tries to reppresent the subscriptions as if they
+%% were a simple key-value map.
+%%
+%% In reality, however, the session has to retain old the
+%% subscriptions for longer to ensure the consistency of message
+%% replay.
+-module(emqx_persistent_session_ds_subs).
+
+%% API:
+-export([on_subscribe/3, on_unsubscribe/3, gc/1, lookup/2, to_map/1, fold/3, fold_all/3]).
+
+-export_type([]).
+
+%%================================================================================
+%% Type declarations
+%%================================================================================
+
+%%================================================================================
+%% API functions
+%%================================================================================
+
+%% @doc Process a new subscription
+-spec on_subscribe(
+    emqx_persistent_session_ds:topic_filter(),
+    emqx_persistent_session_ds:subscription(),
+    emqx_persistent_session_ds_state:t()
+) ->
+    emqx_persistent_session_ds_state:t().
+on_subscribe(TopicFilter, Subscription, S) ->
+    emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S).
+
+%% @doc Process UNSUBSCRIBE
+-spec on_unsubscribe(
+    emqx_persistent_session_ds:topic_filter(),
+    emqx_persistent_session_ds:subscription(),
+    emqx_persistent_session_ds_state:t()
+) ->
+    emqx_persistent_session_ds_state:t().
+on_unsubscribe(TopicFilter, Subscription0, S0) ->
+    %% Note: we cannot delete the subscription immediately, since its
+    %% metadata can be used during replay (see `process_batch'). We
+    %% instead mark it as deleted, and let `subscription_gc' function
+    %% dispatch it later:
+    Subscription = Subscription0#{deleted => true},
+    emqx_persistent_session_ds_state:put_subscription(TopicFilter, [], Subscription, S0).
+
+%% @doc Remove subscriptions that have been marked for deletion, and
+%% that don't have any unacked messages:
+-spec gc(emqx_persistent_session_ds_state:t()) -> emqx_persistent_session_ds_state:t().
+gc(S0) ->
+    fold_all(
+        fun(TopicFilter, #{id := SubId, deleted := Deleted}, Acc) ->
+            case Deleted andalso has_no_unacked_streams(SubId, S0) of
+                true ->
+                    emqx_persistent_session_ds_state:del_subscription(TopicFilter, [], Acc);
+                false ->
+                    Acc
+            end
+        end,
+        S0,
+        S0
+    ).
+
+%% @doc Fold over active subscriptions:
+-spec lookup(emqx_persistent_session_ds:topic_filter(), emqx_persistent_session_ds_state:t()) ->
+    emqx_persistent_session_ds:subscription() | undefined.
+lookup(TopicFilter, S) ->
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
+    case emqx_topic_gbt:lookup(TopicFilter, [], Subs, undefined) of
+        #{deleted := true} ->
+            undefined;
+        Sub ->
+            Sub
+    end.
+
+%% @doc Convert active subscriptions to a map, for information
+%% purpose:
+-spec to_map(emqx_persistent_session_ds_state:t()) -> map().
+to_map(S) ->
+    fold(
+        fun(TopicFilter, #{props := Props}, Acc) -> Acc#{TopicFilter => Props} end,
+        #{},
+        S
+    ).
+
+%% @doc Fold over active subscriptions:
+-spec fold(
+    fun((emqx_types:topic(), emqx_persistent_session_ds:subscription(), Acc) -> Acc),
+    Acc,
+    emqx_persistent_session_ds_state:t()
+) ->
+    Acc.
+fold(Fun, AccIn, S) ->
+    fold_all(
+        fun(TopicFilter, Sub = #{deleted := Deleted}, Acc) ->
+            case Deleted of
+                true -> Acc;
+                false -> Fun(TopicFilter, Sub, Acc)
+            end
+        end,
+        AccIn,
+        S
+    ).
+
+%% @doc Fold over all subscriptions, including inactive ones:
+-spec fold_all(
+    fun((emqx_types:topic(), emqx_persistent_session_ds:subscription(), Acc) -> Acc),
+    Acc,
+    emqx_persistent_session_ds_state:t()
+) ->
+    Acc.
+fold_all(Fun, AccIn, S) ->
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
+    emqx_topic_gbt:fold(
+        fun(Key, Sub, Acc) -> Fun(emqx_topic_gbt:get_topic(Key), Sub, Acc) end,
+        AccIn,
+        Subs
+    ).
+
+%%================================================================================
+%% Internal functions
+%%================================================================================
+
+-spec has_no_unacked_streams(
+    emqx_persistent_session_ds:subscription_id(), emqx_persistent_session_ds_state:t()
+) -> boolean().
+has_no_unacked_streams(SubId, S) ->
+    emqx_persistent_session_ds_state:fold_streams(
+        fun
+            ({SID, _Stream}, Srs, Acc) when SID =:= SubId ->
+                emqx_persistent_session_ds_stream_scheduler:is_fully_acked(Srs, S) andalso Acc;
+            (_StreamKey, _Srs, Acc) ->
+                Acc
+        end,
+        true,
+        S
+    ).

From 90ba2977fe30b307aa10f70b33dfda434828a44d Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Wed, 7 Feb 2024 21:33:11 +0800
Subject: [PATCH 179/273] feat: don't publish mqtt message in rabbitmq's source

---
 .../src/emqx_bridge_rabbitmq_connector.erl    |  16 +-
 .../emqx_bridge_rabbitmq_pubsub_schema.erl    |  44 +-
 .../emqx_bridge_rabbitmq_source_worker.erl    |  75 ++--
 .../test/emqx_bridge_rabbitmq_v2_SUITE.erl    | 382 ++++++++++++++++++
 .../emqx_bridge_rabbitmq_pubsub_schema.hocon  |  15 -
 5 files changed, 438 insertions(+), 94 deletions(-)
 create mode 100644 apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl

diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
index f7a1e533f..134ba15b6 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_connector.erl
@@ -372,21 +372,7 @@ preproc_parameter(#{config_root := actions, parameters := Parameter}) ->
         config_root => actions
     };
 preproc_parameter(#{config_root := sources, parameters := Parameter, hookpoints := Hooks}) ->
-    #{
-        payload_template := PayloadTmpl,
-        qos := QosTmpl,
-        topic := TopicTmpl
-    } = Parameter,
-    Parameter#{
-        payload_template => emqx_placeholder:preproc_tmpl(PayloadTmpl),
-        qos => preproc_qos(QosTmpl),
-        topic => emqx_placeholder:preproc_tmpl(TopicTmpl),
-        hookpoints => Hooks,
-        config_root => sources
-    }.
-
-preproc_qos(Qos) when is_integer(Qos) -> Qos;
-preproc_qos(Qos) -> emqx_placeholder:preproc_tmpl(Qos).
+    Parameter#{hookpoints => Hooks, config_root => sources}.
 
 delivery_mode(non_persistent) -> 1;
 delivery_mode(persistent) -> 2.
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
index 34c945937..81230ee3e 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
@@ -126,39 +126,6 @@ fields(subscriber_source) ->
     );
 fields(source_parameters) ->
     [
-        {wait_for_publish_confirmations,
-            hoconsc:mk(
-                boolean(),
-                #{
-                    default => true,
-                    desc => ?DESC(?CONNECTOR_SCHEMA, "wait_for_publish_confirmations")
-                }
-            )},
-        {topic,
-            ?HOCON(
-                binary(),
-                #{
-                    required => true,
-                    validator => fun emqx_schema:non_empty_string/1,
-                    desc => ?DESC("source_topic")
-                }
-            )},
-        {qos,
-            ?HOCON(
-                ?UNION([emqx_schema:qos(), binary()]),
-                #{
-                    default => 0,
-                    desc => ?DESC("source_qos")
-                }
-            )},
-        {payload_template,
-            ?HOCON(
-                binary(),
-                #{
-                    required => false,
-                    desc => ?DESC("source_payload_template")
-                }
-            )},
         {queue,
             ?HOCON(
                 binary(),
@@ -167,6 +134,14 @@ fields(source_parameters) ->
                     desc => ?DESC("source_queue")
                 }
             )},
+        {wait_for_publish_confirmations,
+            hoconsc:mk(
+                boolean(),
+                #{
+                    default => true,
+                    desc => ?DESC(?CONNECTOR_SCHEMA, "wait_for_publish_confirmations")
+                }
+            )},
         {no_ack,
             ?HOCON(
                 boolean(),
@@ -260,9 +235,6 @@ source_examples(Method) ->
                     _ConnectorType = rabbitmq,
                     #{
                         parameters => #{
-                            topic => <<"${payload.mqtt_topic}">>,
-                            qos => <<"${payload.mqtt_qos}">>,
-                            payload_template => <<"${payload.mqtt_payload}">>,
                             queue => <<"test_queue">>,
                             no_ack => true
                         }
diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
index b102faf5d..d0d43641b 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_source_worker.erl
@@ -37,28 +37,13 @@ handle_cast(_Request, State) ->
 handle_info(
     {#'basic.deliver'{delivery_tag = Tag}, #amqp_msg{
         payload = Payload,
-        props = #'P_basic'{message_id = MessageId, headers = Headers}
+        props = PBasic
     }},
     {Channel, InstanceId, Params} = State
 ) ->
-    #{
-        hookpoints := Hooks,
-        payload_template := PayloadTmpl,
-        qos := QoSTmpl,
-        topic := TopicTmpl,
-        no_ack := NoAck
-    } = Params,
-    MQTTMsg = emqx_message:make(
-        make_message_id(MessageId),
-        InstanceId,
-        render(Payload, QoSTmpl),
-        render(Payload, TopicTmpl),
-        render(Payload, PayloadTmpl),
-        #{},
-        make_headers(Headers)
-    ),
-    _ = emqx:publish(MQTTMsg),
-    lists:foreach(fun(Hook) -> emqx_hooks:run(Hook, [MQTTMsg]) end, Hooks),
+    Message = to_map(PBasic, Payload),
+    #{hookpoints := Hooks, no_ack := NoAck} = Params,
+    lists:foreach(fun(Hook) -> emqx_hooks:run(Hook, [Message]) end, Hooks),
     (NoAck =:= false) andalso
         amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = Tag}),
     emqx_resource_metrics:received_inc(InstanceId),
@@ -68,18 +53,52 @@ handle_info(#'basic.cancel_ok'{}, State) ->
 handle_info(_Info, State) ->
     {noreply, State}.
 
+to_map(PBasic, Payload) ->
+    #'P_basic'{
+        content_type = ContentType,
+        content_encoding = ContentEncoding,
+        headers = Headers,
+        delivery_mode = DeliveryMode,
+        priority = Priority,
+        correlation_id = CorrelationId,
+        reply_to = ReplyTo,
+        expiration = Expiration,
+        message_id = MessageId,
+        timestamp = Timestamp,
+        type = Type,
+        user_id = UserId,
+        app_id = AppId,
+        cluster_id = ClusterId
+    } = PBasic,
+    Message = #{
+        <<"payload">> => make_payload(Payload),
+        <<"content_type">> => ContentType,
+        <<"content_encoding">> => ContentEncoding,
+        <<"headers">> => make_headers(Headers),
+        <<"delivery_mode">> => DeliveryMode,
+        <<"priority">> => Priority,
+        <<"correlation_id">> => CorrelationId,
+        <<"reply_to">> => ReplyTo,
+        <<"expiration">> => Expiration,
+        <<"message_id">> => MessageId,
+        <<"timestamp">> => Timestamp,
+        <<"type">> => Type,
+        <<"user_id">> => UserId,
+        <<"app_id">> => AppId,
+        <<"cluster_id">> => ClusterId
+    },
+    maps:filtermap(fun(_K, V) -> V =/= undefined andalso V =/= <<"undefined">> end, Message).
+
 terminate(_Reason, _State) ->
     ok.
 
-render(_Message, QoS) when is_integer(QoS) -> QoS;
-render(Message, PayloadTmpl) ->
-    Opts = #{return => full_binary},
-    emqx_placeholder:proc_tmpl(PayloadTmpl, Message, Opts).
-
-make_message_id(undefined) -> emqx_guid:gen();
-make_message_id(Id) -> Id.
-
 make_headers(undefined) ->
-    #{};
+    undefined;
 make_headers(Headers) when is_list(Headers) ->
     maps:from_list([{Key, Value} || {Key, _Type, Value} <- Headers]).
+
+make_payload(Payload) ->
+    case emqx_utils_json:safe_decode(Payload, [return_maps]) of
+        {ok, Map} -> Map;
+        {error, _} -> Payload
+    end.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl
new file mode 100644
index 000000000..5a17c2914
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl
@@ -0,0 +1,382 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rabbitmq_v2_SUITE).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include_lib("emqx_connector/include/emqx_connector.hrl").
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("stdlib/include/assert.hrl").
+-include_lib("amqp_client/include/amqp_client.hrl").
+
+-define(TYPE, <<"rabbitmq">>).
+-import(emqx_common_test_helpers, [on_exit/1]).
+
+rabbit_mq_host() ->
+    <<"rabbitmq">>.
+
+rabbit_mq_port() ->
+    5672.
+
+rabbit_mq_exchange() ->
+    <<"messages">>.
+
+rabbit_mq_queue() ->
+    <<"test_queue">>.
+
+rabbit_mq_routing_key() ->
+    <<"test_routing_key">>.
+
+get_channel_connection(Config) ->
+    proplists:get_value(channel_connection, Config).
+
+get_rabbitmq(Config) ->
+    proplists:get_value(rabbitmq, Config).
+
+%%------------------------------------------------------------------------------
+%% Common Test Setup, Tear down and Testcase List
+%%------------------------------------------------------------------------------
+
+all() ->
+    emqx_common_test_helpers:all(?MODULE).
+
+init_per_suite(Config) ->
+    RabbitMQHost = os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq"),
+    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")),
+    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
+        true ->
+            Config1 = common_init(#{
+                host => RabbitMQHost, port => RabbitMQPort
+            }),
+            Name = atom_to_binary(?MODULE),
+            Config2 = [{connector, Name} | Config1 ++ Config],
+            create_connector(Name, get_rabbitmq(Config2)),
+            Config2;
+        false ->
+            case os:getenv("IS_CI") of
+                "yes" ->
+                    throw(no_rabbitmq);
+                _ ->
+                    {skip, no_rabbitmq}
+            end
+    end.
+
+common_init(Opts) ->
+    emqx_common_test_helpers:render_and_load_app_config(emqx_conf),
+    ok = emqx_common_test_helpers:start_apps([
+        emqx_conf, emqx_bridge, emqx_bridge_rabbitmq, emqx_rule_engine
+    ]),
+    ok = emqx_connector_test_helpers:start_apps([emqx_resource]),
+    {ok, _} = application:ensure_all_started(emqx_connector),
+    {ok, _} = application:ensure_all_started(amqp_client),
+    emqx_mgmt_api_test_util:init_suite(),
+    #{host := Host, port := Port} = Opts,
+    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port),
+    [
+        {channel_connection, ChannelConnection},
+        {rabbitmq, #{server => Host, port => Port}}
+    ].
+
+setup_rabbit_mq_exchange_and_queue(Host, Port) ->
+    %% Create an exchange and a queue
+    {ok, Connection} =
+        amqp_connection:start(#amqp_params_network{
+            host = Host,
+            port = Port,
+            ssl_options = none
+        }),
+    {ok, Channel} = amqp_connection:open_channel(Connection),
+    %% Create an exchange
+    #'exchange.declare_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'exchange.declare'{
+                exchange = rabbit_mq_exchange(),
+                type = <<"topic">>
+            }
+        ),
+    %% Create a queue
+    #'queue.declare_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'queue.declare'{queue = rabbit_mq_queue()}
+        ),
+    %% Bind the queue to the exchange
+    #'queue.bind_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'queue.bind'{
+                queue = rabbit_mq_queue(),
+                exchange = rabbit_mq_exchange(),
+                routing_key = rabbit_mq_routing_key()
+            }
+        ),
+    #{
+        connection => Connection,
+        channel => Channel
+    }.
+
+end_per_suite(Config) ->
+    delete_connector(proplists:get_value(connector, Config)),
+    #{
+        connection := Connection,
+        channel := Channel
+    } = get_channel_connection(Config),
+    emqx_mgmt_api_test_util:end_suite(),
+    ok = emqx_common_test_helpers:stop_apps([emqx_conf, emqx_bridge_rabbitmq, emqx_rule_engine]),
+    ok = emqx_connector_test_helpers:stop_apps([emqx_resource]),
+    _ = application:stop(emqx_connector),
+    _ = application:stop(emqx_bridge),
+    %% Close the channel
+    ok = amqp_channel:close(Channel),
+    %% Close the connection
+    ok = amqp_connection:close(Connection).
+
+rabbitmq_connector(Config) ->
+    Name = atom_to_binary(?MODULE),
+    Server = maps:get(server, Config, rabbit_mq_host()),
+    Port = maps:get(port, Config, rabbit_mq_port()),
+    ConfigStr =
+        io_lib:format(
+            "connectors.rabbitmq.~s {\n"
+            "  enable = true\n"
+            "  ssl = {enable = false}\n"
+            "  server = \"~s\"\n"
+            "  port = ~p\n"
+            "  username = \"guest\"\n"
+            "  password = \"guest\"\n"
+            "}\n",
+            [
+                Name,
+                Server,
+                Port
+            ]
+        ),
+    ct:pal(ConfigStr),
+    parse_and_check(<<"connectors">>, emqx_connector_schema, ConfigStr, <<"rabbitmq">>, Name).
+
+rabbitmq_source() ->
+    Name = atom_to_binary(?MODULE),
+    ConfigStr =
+        io_lib:format(
+            "sources.rabbitmq.~s {\n"
+            "connector = ~s\n"
+            "enable = true\n"
+            "parameters {\n"
+            "no_ack = true\n"
+            "queue = ~s\n"
+            "wait_for_publish_confirmations = true\n"
+            "}}\n",
+            [
+                Name,
+                Name,
+                rabbit_mq_queue()
+            ]
+        ),
+    ct:pal(ConfigStr),
+    parse_and_check(<<"sources">>, emqx_bridge_v2_schema, ConfigStr, <<"rabbitmq">>, Name).
+
+rabbitmq_action() ->
+    Name = atom_to_binary(?MODULE),
+    ConfigStr =
+        io_lib:format(
+            "actions.rabbitmq.~s {\n"
+            "connector = ~s\n"
+            "enable = true\n"
+            "parameters {\n"
+            "exchange: ~s\n"
+            "payload_template: \"${.payload}\"\n"
+            "routing_key: ~s\n"
+            "delivery_mode: non_persistent\n"
+            "publish_confirmation_timeout: 30s\n"
+            "wait_for_publish_confirmations = true\n"
+            "}}\n",
+            [
+                Name,
+                Name,
+                rabbit_mq_exchange(),
+                rabbit_mq_routing_key()
+            ]
+        ),
+    ct:pal(ConfigStr),
+    parse_and_check(<<"actions">>, emqx_bridge_v2_schema, ConfigStr, <<"rabbitmq">>, Name).
+
+parse_and_check(Key, Mod, ConfigStr, Type, Name) ->
+    {ok, RawConf} = hocon:binary(ConfigStr, #{format => map}),
+    hocon_tconf:check_plain(Mod, RawConf, #{required => false, atom_key => false}),
+    #{Key := #{Type := #{Name := RetConfig}}} = RawConf,
+    RetConfig.
+
+create_connector(Name, Config) ->
+    Connector = rabbitmq_connector(Config),
+    {ok, _} = emqx_connector:create(?TYPE, Name, Connector).
+
+delete_connector(Name) ->
+    ok = emqx_connector:remove(?TYPE, Name).
+
+create_source(Name) ->
+    Source = rabbitmq_source(),
+    {ok, _} = emqx_bridge_v2:create(sources, ?TYPE, Name, Source).
+
+delete_source(Name) ->
+    ok = emqx_bridge_v2:remove(sources, ?TYPE, Name).
+
+create_action(Name) ->
+    Action = rabbitmq_action(),
+    {ok, _} = emqx_bridge_v2:create(actions, ?TYPE, Name, Action).
+
+delete_action(Name) ->
+    ok = emqx_bridge_v2:remove(actions, ?TYPE, Name).
+
+%%------------------------------------------------------------------------------
+%% Test Cases
+%%------------------------------------------------------------------------------
+
+t_source(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    create_source(Name),
+    Sources = emqx_bridge_v2:list(sources),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Sources), Sources),
+    Topic = <<"tesldkafd">>,
+    {ok, #{id := RuleId}} = emqx_rule_engine:create_rule(
+        #{
+            sql => <<"select * from \"$bridges/rabbitmq:", Name/binary, "\"">>,
+            id => atom_to_binary(?FUNCTION_NAME),
+            actions => [
+                #{
+                    args => #{
+                        topic => Topic,
+                        mqtt_properties => #{},
+                        payload => <<"${payload}">>,
+                        qos => 0,
+                        retain => false,
+                        user_properties => []
+                    },
+                    function => republish
+                }
+            ],
+            description => <<"bridge_v2 republish rule">>
+        }
+    ),
+    on_exit(fun() -> emqx_rule_engine:delete_rule(RuleId) end),
+    {ok, C1} = emqtt:start_link([{clean_start, true}]),
+    {ok, _} = emqtt:connect(C1),
+    {ok, #{}, [0]} = emqtt:subscribe(C1, Topic, [{qos, 0}, {rh, 0}]),
+    send_test_message_to_rabbitmq(Config),
+    PayloadBin = emqx_utils_json:encode(payload()),
+    ?assertMatch(
+        [
+            #{
+                dup := false,
+                properties := undefined,
+                topic := Topic,
+                qos := 0,
+                payload := PayloadBin,
+                retain := false
+            }
+        ],
+        receive_messages(1)
+    ),
+    ok = emqtt:disconnect(C1),
+    ok = delete_source(Name),
+    SourcesAfterDelete = emqx_bridge_v2:list(sources),
+    ?assertNot(lists:any(Any, SourcesAfterDelete), SourcesAfterDelete),
+    ok.
+
+t_action(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    create_action(Name),
+    Actions = emqx_bridge_v2:list(actions),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Actions), Actions),
+    Topic = <<"lkadfdaction">>,
+    {ok, #{id := RuleId}} = emqx_rule_engine:create_rule(
+        #{
+            sql => <<"select * from \"", Topic/binary, "\"">>,
+            id => atom_to_binary(?FUNCTION_NAME),
+            actions => [<<"rabbitmq:", Name/binary>>],
+            description => <<"bridge_v2 send msg to rabbitmq action">>
+        }
+    ),
+    on_exit(fun() -> emqx_rule_engine:delete_rule(RuleId) end),
+    {ok, C1} = emqtt:start_link([{clean_start, true}]),
+    {ok, _} = emqtt:connect(C1),
+    Payload = payload(),
+    PayloadBin = emqx_utils_json:encode(Payload),
+    {ok, _} = emqtt:publish(C1, Topic, #{}, PayloadBin, [{qos, 1}, {retain, false}]),
+    Msg = receive_test_message_from_rabbitmq(Config),
+    ?assertMatch(Payload, Msg),
+    ok = emqtt:disconnect(C1),
+    ok = delete_action(Name),
+    ActionsAfterDelete = emqx_bridge_v2:list(actions),
+    ?assertNot(lists:any(Any, ActionsAfterDelete), ActionsAfterDelete),
+    ok.
+
+receive_messages(Count) ->
+    receive_messages(Count, []).
+receive_messages(0, Msgs) ->
+    Msgs;
+receive_messages(Count, Msgs) ->
+    receive
+        {publish, Msg} ->
+            ct:log("Msg: ~p ~n", [Msg]),
+            receive_messages(Count - 1, [Msg | Msgs]);
+        Other ->
+            ct:log("Other Msg: ~p~n", [Other]),
+            receive_messages(Count, Msgs)
+    after 2000 ->
+        Msgs
+    end.
+
+payload() ->
+    #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000}.
+
+send_test_message_to_rabbitmq(Config) ->
+    #{channel := Channel} = get_channel_connection(Config),
+    MessageProperties = #'P_basic'{
+        headers = [],
+        delivery_mode = 1
+    },
+    Method = #'basic.publish'{
+        exchange = rabbit_mq_exchange(),
+        routing_key = rabbit_mq_routing_key()
+    },
+    amqp_channel:cast(
+        Channel,
+        Method,
+        #amqp_msg{
+            payload = emqx_utils_json:encode(payload()),
+            props = MessageProperties
+        }
+    ),
+    ok.
+
+receive_test_message_from_rabbitmq(Config) ->
+    #{channel := Channel} = get_channel_connection(Config),
+    #'basic.consume_ok'{consumer_tag = ConsumerTag} =
+        amqp_channel:call(
+            Channel,
+            #'basic.consume'{
+                queue = rabbit_mq_queue()
+            }
+        ),
+    receive
+        %% This is the first message received
+        #'basic.consume_ok'{} ->
+            ok
+    end,
+    receive
+        {#'basic.deliver'{delivery_tag = DeliveryTag}, Content} ->
+            %% Ack the message
+            amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = DeliveryTag}),
+            %% Cancel the consumer
+            #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
+                amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
+            emqx_utils_json:decode(Content#amqp_msg.payload)
+    after 5000 ->
+        ?assert(false, "Did not receive message within 5 second")
+    end.
diff --git a/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon b/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon
index a73394386..82f1781e9 100644
--- a/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon
+++ b/rel/i18n/emqx_bridge_rabbitmq_pubsub_schema.hocon
@@ -21,21 +21,6 @@ source_parameters.desc:
 source_parameters.label:
 """Source Parameters"""
 
-source_topic.desc:
-"""Topic used for constructing MQTT messages, supporting templates."""
-source_topic.label:
-"""Source Topic"""
-
-source_qos.desc:
-"""The QoS level of the MQTT message, supporting templates."""
-source_qos.label:
-"""QoS"""
-
-source_payload_template.desc:
-"""The template used to construct the payload of the MQTT message."""
-source_payload_template.label:
-"""Source Payload Template"""
-
 source_queue.desc:
 """The queue name of the RabbitMQ broker."""
 source_queue.label:

From a0f8e4f3280dbfb6a260084e175f919824f7ee45 Mon Sep 17 00:00:00 2001
From: zhongwencool <zhongwencool@gmail.com>
Date: Thu, 8 Feb 2024 12:37:45 +0800
Subject: [PATCH 180/273] test: rafator rabbitmq test SUITE, delete redundance
 code

---
 .../emqx_bridge_rabbitmq_pubsub_schema.erl    |   1 +
 .../test/emqx_bridge_rabbitmq_SUITE.erl       | 423 ------------------
 .../emqx_bridge_rabbitmq_connector_SUITE.erl  | 156 ++-----
 .../test/emqx_bridge_rabbitmq_test_utils.erl  | 203 +++++++++
 .../test/emqx_bridge_rabbitmq_v1_SUITE.erl    | 221 +++++++++
 .../test/emqx_bridge_rabbitmq_v2_SUITE.erl    | 291 ++++--------
 6 files changed, 545 insertions(+), 750 deletions(-)
 delete mode 100644 apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_test_utils.erl
 create mode 100644 apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v1_SUITE.erl

diff --git a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
index 81230ee3e..3fb00632c 100644
--- a/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
+++ b/apps/emqx_bridge_rabbitmq/src/emqx_bridge_rabbitmq_pubsub_schema.erl
@@ -101,6 +101,7 @@ fields(action_parameters) ->
             hoconsc:mk(
                 binary(),
                 #{
+                    default => <<"">>,
                     desc => ?DESC(?CONNECTOR_SCHEMA, "payload_template")
                 }
             )}
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
deleted file mode 100644
index 7698608d3..000000000
--- a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_SUITE.erl
+++ /dev/null
@@ -1,423 +0,0 @@
-%%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
-%%--------------------------------------------------------------------
-
--module(emqx_bridge_rabbitmq_SUITE).
-
--compile(nowarn_export_all).
--compile(export_all).
-
--include_lib("emqx_connector/include/emqx_connector.hrl").
--include_lib("eunit/include/eunit.hrl").
--include_lib("stdlib/include/assert.hrl").
--include_lib("amqp_client/include/amqp_client.hrl").
-
-%% See comment in
-%% apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl for how to
-%% run this without bringing up the whole CI infrastructure
--define(TYPE, <<"rabbitmq">>).
-
-rabbit_mq_host() ->
-    <<"rabbitmq">>.
-
-rabbit_mq_port() ->
-    5672.
-
-rabbit_mq_exchange() ->
-    <<"messages">>.
-
-rabbit_mq_queue() ->
-    <<"test_queue">>.
-
-rabbit_mq_routing_key() ->
-    <<"test_routing_key">>.
-
-get_channel_connection(Config) ->
-    proplists:get_value(channel_connection, Config).
-
-get_rabbitmq(Config) ->
-    proplists:get_value(rabbitmq, Config).
-
-get_tls(Config) ->
-    proplists:get_value(tls, Config).
-
-%%------------------------------------------------------------------------------
-%% Common Test Setup, Tear down and Testcase List
-%%------------------------------------------------------------------------------
-
-all() ->
-    [
-        {group, tcp},
-        {group, tls}
-    ].
-
-groups() ->
-    AllTCs = emqx_common_test_helpers:all(?MODULE),
-    [
-        {tcp, AllTCs},
-        {tls, AllTCs}
-    ].
-
-init_per_suite(Config) ->
-    Config.
-
-end_per_suite(_Config) ->
-    ok.
-
-init_per_group(tcp, Config) ->
-    RabbitMQHost = os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq"),
-    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")),
-    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
-        true ->
-            Config1 = common_init_per_group(#{
-                host => RabbitMQHost, port => RabbitMQPort, tls => false
-            }),
-            Config1 ++ Config;
-        false ->
-            case os:getenv("IS_CI") of
-                "yes" ->
-                    throw(no_rabbitmq);
-                _ ->
-                    {skip, no_rabbitmq}
-            end
-    end;
-init_per_group(tls, Config) ->
-    RabbitMQHost = os:getenv("RABBITMQ_TLS_HOST", "rabbitmq"),
-    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_TLS_PORT", "5671")),
-    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
-        true ->
-            Config1 = common_init_per_group(#{
-                host => RabbitMQHost, port => RabbitMQPort, tls => true
-            }),
-            Config1 ++ Config;
-        false ->
-            case os:getenv("IS_CI") of
-                "yes" ->
-                    throw(no_rabbitmq);
-                _ ->
-                    {skip, no_rabbitmq}
-            end
-    end;
-init_per_group(_Group, Config) ->
-    Config.
-
-common_init_per_group(Opts) ->
-    emqx_common_test_helpers:render_and_load_app_config(emqx_conf),
-    ok = emqx_common_test_helpers:start_apps([emqx_conf, emqx_bridge]),
-    ok = emqx_connector_test_helpers:start_apps([emqx_resource]),
-    {ok, _} = application:ensure_all_started(emqx_connector),
-    {ok, _} = application:ensure_all_started(amqp_client),
-    emqx_mgmt_api_test_util:init_suite(),
-    #{host := Host, port := Port, tls := UseTLS} = Opts,
-    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS),
-    [
-        {channel_connection, ChannelConnection},
-        {rabbitmq, #{server => Host, port => Port}},
-        {tls, UseTLS}
-    ].
-
-setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS) ->
-    SSLOptions =
-        case UseTLS of
-            false -> none;
-            true -> emqx_tls_lib:to_client_opts(ssl_options(UseTLS))
-        end,
-    %% Create an exchange and a queue
-    {ok, Connection} =
-        amqp_connection:start(#amqp_params_network{
-            host = Host,
-            port = Port,
-            ssl_options = SSLOptions
-        }),
-    {ok, Channel} = amqp_connection:open_channel(Connection),
-    %% Create an exchange
-    #'exchange.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'exchange.declare'{
-                exchange = rabbit_mq_exchange(),
-                type = <<"topic">>
-            }
-        ),
-    %% Create a queue
-    #'queue.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.declare'{queue = rabbit_mq_queue()}
-        ),
-    %% Bind the queue to the exchange
-    #'queue.bind_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.bind'{
-                queue = rabbit_mq_queue(),
-                exchange = rabbit_mq_exchange(),
-                routing_key = rabbit_mq_routing_key()
-            }
-        ),
-    #{
-        connection => Connection,
-        channel => Channel
-    }.
-
-end_per_group(_Group, Config) ->
-    #{
-        connection := Connection,
-        channel := Channel
-    } = get_channel_connection(Config),
-    emqx_mgmt_api_test_util:end_suite(),
-    ok = emqx_common_test_helpers:stop_apps([emqx_conf]),
-    ok = emqx_connector_test_helpers:stop_apps([emqx_resource]),
-    _ = application:stop(emqx_connector),
-    _ = application:stop(emqx_bridge),
-    %% Close the channel
-    ok = amqp_channel:close(Channel),
-    %% Close the connection
-    ok = amqp_connection:close(Connection).
-
-init_per_testcase(_, Config) ->
-    Config.
-
-end_per_testcase(_, _Config) ->
-    ok.
-
-rabbitmq_config(UseTLS, Config) ->
-    BatchSize = maps:get(batch_size, Config, 1),
-    BatchTime = maps:get(batch_time_ms, Config, 0),
-    Name = atom_to_binary(?MODULE),
-    Server = maps:get(server, Config, rabbit_mq_host()),
-    Port = maps:get(port, Config, rabbit_mq_port()),
-    Template = maps:get(payload_template, Config, <<"">>),
-    ConfigString =
-        io_lib:format(
-            "bridges.rabbitmq.~s {\n"
-            "  enable = true\n"
-            "  ssl = ~s\n"
-            "  server = \"~s\"\n"
-            "  port = ~p\n"
-            "  username = \"guest\"\n"
-            "  password = \"guest\"\n"
-            "  routing_key = \"~s\"\n"
-            "  exchange = \"~s\"\n"
-            "  payload_template = \"~s\"\n"
-            "  resource_opts = {\n"
-            "    batch_size = ~b\n"
-            "    batch_time = ~bms\n"
-            "  }\n"
-            "}\n",
-            [
-                Name,
-                hocon_pp:do(ssl_options(UseTLS), #{embedded => true}),
-                Server,
-                Port,
-                rabbit_mq_routing_key(),
-                rabbit_mq_exchange(),
-                Template,
-                BatchSize,
-                BatchTime
-            ]
-        ),
-    ct:pal(ConfigString),
-    parse_and_check(ConfigString, <<"rabbitmq">>, Name).
-
-ssl_options(true) ->
-    CertsDir = filename:join([
-        emqx_common_test_helpers:proj_root(),
-        ".ci",
-        "docker-compose-file",
-        "certs"
-    ]),
-    #{
-        enable => true,
-        cacertfile => filename:join([CertsDir, "ca.crt"]),
-        certfile => filename:join([CertsDir, "client.pem"]),
-        keyfile => filename:join([CertsDir, "client.key"])
-    };
-ssl_options(false) ->
-    #{
-        enable => false
-    }.
-
-parse_and_check(ConfigString, BridgeType, Name) ->
-    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
-    hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
-    #{<<"bridges">> := #{BridgeType := #{Name := RetConfig}}} = RawConf,
-    RetConfig.
-
-create_bridge(Name, UseTLS, Config) ->
-    BridgeConfig = rabbitmq_config(UseTLS, Config),
-    {ok, _} = emqx_bridge:create(?TYPE, Name, BridgeConfig),
-    emqx_bridge_resource:bridge_id(?TYPE, Name).
-
-delete_bridge(Name) ->
-    ok = emqx_bridge:remove(?TYPE, Name).
-
-%%------------------------------------------------------------------------------
-%% Test Cases
-%%------------------------------------------------------------------------------
-
-t_create_delete_bridge(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    RabbitMQ = get_rabbitmq(Config),
-    UseTLS = get_tls(Config),
-    create_bridge(Name, UseTLS, RabbitMQ),
-    Bridges = emqx_bridge:list(),
-    Any = fun(#{name := BName}) -> BName =:= Name end,
-    ?assert(lists:any(Any, Bridges), Bridges),
-    ok = delete_bridge(Name),
-    BridgesAfterDelete = emqx_bridge:list(),
-    ?assertNot(lists:any(Any, BridgesAfterDelete), BridgesAfterDelete),
-    ok.
-
-t_create_delete_bridge_non_existing_server(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    UseTLS = get_tls(Config),
-    create_bridge(Name, UseTLS, #{server => <<"non_existing_server">>, port => 3174}),
-    %% Check that the new bridge is in the list of bridges
-    Bridges = emqx_bridge:list(),
-    Any = fun(#{name := BName}) -> BName =:= Name end,
-    ?assert(lists:any(Any, Bridges)),
-    ok = delete_bridge(Name),
-    BridgesAfterDelete = emqx_bridge:list(),
-    ?assertNot(lists:any(Any, BridgesAfterDelete)),
-    ok.
-
-t_send_message_query(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    RabbitMQ = get_rabbitmq(Config),
-    UseTLS = get_tls(Config),
-    BridgeID = create_bridge(Name, UseTLS, RabbitMQ#{batch_size => 1}),
-    Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
-    %% This will use the SQL template included in the bridge
-    emqx_bridge:send_message(BridgeID, Payload),
-    %% Check that the data got to the database
-    ?assertEqual(Payload, receive_simple_test_message(Config)),
-    ok = delete_bridge(Name),
-    ok.
-
-t_send_message_query_with_template(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    RabbitMQ = get_rabbitmq(Config),
-    UseTLS = get_tls(Config),
-    BridgeID = create_bridge(Name, UseTLS, RabbitMQ#{
-        batch_size => 1,
-        payload_template =>
-            <<
-                "{"
-                "      \\\"key\\\": ${key},"
-                "      \\\"data\\\": \\\"${data}\\\","
-                "      \\\"timestamp\\\": ${timestamp},"
-                "      \\\"secret\\\": 42"
-                "}"
-            >>
-    }),
-    Payload = #{
-        <<"key">> => 7,
-        <<"data">> => <<"RabbitMQ">>,
-        <<"timestamp">> => 10000
-    },
-    emqx_bridge:send_message(BridgeID, Payload),
-    %% Check that the data got to the database
-    ExpectedResult = Payload#{
-        <<"secret">> => 42
-    },
-    ?assertEqual(ExpectedResult, receive_simple_test_message(Config)),
-    ok = delete_bridge(Name),
-    ok.
-
-t_send_simple_batch(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    RabbitMQ = get_rabbitmq(Config),
-    BridgeConf = RabbitMQ#{batch_size => 100},
-    UseTLS = get_tls(Config),
-    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
-    Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
-    emqx_bridge:send_message(BridgeID, Payload),
-    ?assertEqual(Payload, receive_simple_test_message(Config)),
-    ok = delete_bridge(Name),
-    ok.
-
-t_send_simple_batch_with_template(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    RabbitMQ = get_rabbitmq(Config),
-    UseTLS = get_tls(Config),
-    BridgeConf =
-        RabbitMQ#{
-            batch_size => 100,
-            payload_template =>
-                <<
-                    "{"
-                    "      \\\"key\\\": ${key},"
-                    "      \\\"data\\\": \\\"${data}\\\","
-                    "      \\\"timestamp\\\": ${timestamp},"
-                    "      \\\"secret\\\": 42"
-                    "}"
-                >>
-        },
-    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
-    Payload = #{
-        <<"key">> => 7,
-        <<"data">> => <<"RabbitMQ">>,
-        <<"timestamp">> => 10000
-    },
-    emqx_bridge:send_message(BridgeID, Payload),
-    ExpectedResult = Payload#{
-        <<"secret">> => 42
-    },
-    ?assertEqual(ExpectedResult, receive_simple_test_message(Config)),
-    ok = delete_bridge(Name),
-    ok.
-
-t_heavy_batching(Config) ->
-    Name = atom_to_binary(?FUNCTION_NAME),
-    NumberOfMessages = 20000,
-    RabbitMQ = get_rabbitmq(Config),
-    UseTLS = get_tls(Config),
-    BridgeConf = RabbitMQ#{
-        batch_size => 10173,
-        batch_time_ms => 50
-    },
-    BridgeID = create_bridge(Name, UseTLS, BridgeConf),
-    SendMessage = fun(Key) ->
-        Payload = #{<<"key">> => Key},
-        emqx_bridge:send_message(BridgeID, Payload)
-    end,
-    [SendMessage(Key) || Key <- lists:seq(1, NumberOfMessages)],
-    AllMessages = lists:foldl(
-        fun(_, Acc) ->
-            Message = receive_simple_test_message(Config),
-            #{<<"key">> := Key} = Message,
-            Acc#{Key => true}
-        end,
-        #{},
-        lists:seq(1, NumberOfMessages)
-    ),
-    ?assertEqual(NumberOfMessages, maps:size(AllMessages)),
-    ok = delete_bridge(Name),
-    ok.
-
-receive_simple_test_message(Config) ->
-    #{channel := Channel} = get_channel_connection(Config),
-    #'basic.consume_ok'{consumer_tag = ConsumerTag} =
-        amqp_channel:call(
-            Channel,
-            #'basic.consume'{
-                queue = rabbit_mq_queue()
-            }
-        ),
-    receive
-        %% This is the first message received
-        #'basic.consume_ok'{} ->
-            ok
-    end,
-    receive
-        {#'basic.deliver'{delivery_tag = DeliveryTag}, Content} ->
-            %% Ack the message
-            amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = DeliveryTag}),
-            %% Cancel the consumer
-            #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
-                amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
-            emqx_utils_json:decode(Content#amqp_msg.payload)
-    after 5000 ->
-        ?assert(false, "Did not receive message within 5 second")
-    end.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
index ee5a2609b..56cdc8b0d 100644
--- a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_rabbitmq_connector_SUITE).
@@ -12,6 +12,18 @@
 -include_lib("stdlib/include/assert.hrl").
 -include_lib("common_test/include/ct.hrl").
 -include_lib("amqp_client/include/amqp_client.hrl").
+-import(emqx_bridge_rabbitmq_test_utils, [
+    rabbit_mq_exchange/0,
+    rabbit_mq_routing_key/0,
+    rabbit_mq_queue/0,
+    rabbit_mq_host/0,
+    rabbit_mq_port/0,
+    get_rabbitmq/1,
+    ssl_options/1,
+    get_channel_connection/1,
+    parse_and_check/4,
+    receive_message_from_rabbitmq/1
+]).
 
 %% This test SUITE requires a running RabbitMQ instance. If you don't want to
 %% bring up the whole CI infrastructure with the `scripts/ct/run.sh` script
@@ -21,99 +33,24 @@
 %%
 %% docker run -it --rm --name rabbitmq -p 127.0.0.1:5672:5672 -p 127.0.0.1:15672:15672 rabbitmq:3.11-management
 
-rabbit_mq_host() ->
-    list_to_binary(os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq")).
-
-rabbit_mq_port() ->
-    list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")).
-
-rabbit_mq_password() ->
-    <<"guest">>.
-
-rabbit_mq_exchange() ->
-    <<"test_exchange">>.
-
-rabbit_mq_queue() ->
-    <<"test_queue">>.
-
-rabbit_mq_routing_key() ->
-    <<"test_routing_key">>.
-
 all() ->
-    emqx_common_test_helpers:all(?MODULE).
+    [
+        {group, tcp},
+        {group, tls}
+    ].
 
-init_per_suite(Config) ->
-    Host = rabbit_mq_host(),
-    Port = rabbit_mq_port(),
-    ct:pal("rabbitmq:~p~n", [{Host, Port}]),
-    case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
-        true ->
-            Apps = emqx_cth_suite:start(
-                [emqx_conf, emqx_connector, emqx_bridge_rabbitmq],
-                #{work_dir => emqx_cth_suite:work_dir(Config)}
-            ),
-            ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port),
-            [{channel_connection, ChannelConnection}, {suite_apps, Apps} | Config];
-        false ->
-            case os:getenv("IS_CI") of
-                "yes" ->
-                    throw(no_rabbitmq);
-                _ ->
-                    {skip, no_rabbitmq}
-            end
-    end.
+groups() ->
+    AllTCs = emqx_common_test_helpers:all(?MODULE),
+    [
+        {tcp, AllTCs},
+        {tls, AllTCs}
+    ].
 
-setup_rabbit_mq_exchange_and_queue(Host, Port) ->
-    %% Create an exchange and a queue
-    {ok, Connection} =
-        amqp_connection:start(#amqp_params_network{
-            host = binary_to_list(Host),
-            port = Port
-        }),
-    {ok, Channel} = amqp_connection:open_channel(Connection),
-    %% Create an exchange
-    #'exchange.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'exchange.declare'{
-                exchange = rabbit_mq_exchange(),
-                type = <<"topic">>
-            }
-        ),
-    %% Create a queue
-    #'queue.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.declare'{queue = rabbit_mq_queue()}
-        ),
-    %% Bind the queue to the exchange
-    #'queue.bind_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.bind'{
-                queue = rabbit_mq_queue(),
-                exchange = rabbit_mq_exchange(),
-                routing_key = rabbit_mq_routing_key()
-            }
-        ),
-    #{
-        connection => Connection,
-        channel => Channel
-    }.
+init_per_group(Group, Config) ->
+    emqx_bridge_rabbitmq_test_utils:init_per_group(Group, Config).
 
-get_channel_connection(Config) ->
-    proplists:get_value(channel_connection, Config).
-
-end_per_suite(Config) ->
-    #{
-        connection := Connection,
-        channel := Channel
-    } = get_channel_connection(Config),
-    %% Close the channel
-    ok = amqp_channel:close(Channel),
-    %% Close the connection
-    ok = amqp_connection:close(Connection),
-    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
+end_per_group(Group, Config) ->
+    emqx_bridge_rabbitmq_test_utils:end_per_group(Group, Config).
 
 % %%------------------------------------------------------------------------------
 % %% Testcases
@@ -143,7 +80,6 @@ t_start_passfile(Config) ->
     ).
 
 perform_lifecycle_check(ResourceID, InitialConfig, TestConfig) ->
-    #{channel := Channel} = get_channel_connection(TestConfig),
     CheckedConfig = check_config(InitialConfig),
     #{
         id := PoolName,
@@ -159,7 +95,7 @@ perform_lifecycle_check(ResourceID, InitialConfig, TestConfig) ->
         emqx_resource:get_instance(ResourceID),
     ?assertEqual({ok, connected}, emqx_resource:health_check(ResourceID)),
     %% Perform query as further check that the resource is working as expected
-    perform_query(ResourceID, Channel),
+    perform_query(ResourceID, TestConfig),
     ?assertEqual(ok, emqx_resource:stop(ResourceID)),
     %% Resource will be listed still, but state will be changed and healthcheck will fail
     %% as the worker no longer exists.
@@ -181,7 +117,7 @@ perform_lifecycle_check(ResourceID, InitialConfig, TestConfig) ->
         emqx_resource:get_instance(ResourceID),
     ?assertEqual({ok, connected}, emqx_resource:health_check(ResourceID)),
     %% Check that everything is working again by performing a query
-    perform_query(ResourceID, Channel),
+    perform_query(ResourceID, TestConfig),
     % Stop and remove the resource in one go.
     ?assertEqual(ok, emqx_resource:remove_local(ResourceID)),
     ?assertEqual({error, not_found}, ecpool:stop_sup_pool(PoolName)),
@@ -214,37 +150,12 @@ perform_query(PoolName, Channel) ->
     ?assertEqual(ok, emqx_resource_manager:add_channel(PoolName, ChannelId, ActionConfig)),
     ok = emqx_resource:query(PoolName, {ChannelId, payload()}),
     %% Get the message from queue:
-    ok = receive_simple_test_message(Channel),
+    SendData = test_data(),
+    RecvData = receive_message_from_rabbitmq(Channel),
+    ?assertMatch(SendData, RecvData),
     ?assertEqual(ok, emqx_resource_manager:remove_channel(PoolName, ChannelId)),
     ok.
 
-receive_simple_test_message(Channel) ->
-    #'basic.consume_ok'{consumer_tag = ConsumerTag} =
-        amqp_channel:call(
-            Channel,
-            #'basic.consume'{
-                queue = rabbit_mq_queue()
-            }
-        ),
-    receive
-        %% This is the first message received
-        #'basic.consume_ok'{} ->
-            ok
-    end,
-    receive
-        {#'basic.deliver'{delivery_tag = DeliveryTag}, Content} ->
-            Expected = test_data(),
-            ?assertEqual(Expected, emqx_utils_json:decode(Content#amqp_msg.payload)),
-            %% Ack the message
-            amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = DeliveryTag}),
-            %% Cancel the consumer
-            #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
-                amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
-            ok
-    after 5000 ->
-        ?assert(false, "Did not receive message within 5 second")
-    end.
-
 rabbitmq_config() ->
     rabbitmq_config(#{}).
 
@@ -278,3 +189,6 @@ rabbitmq_action_config() ->
             wait_for_publish_confirmations => true
         }
     }.
+
+rabbit_mq_password() ->
+    <<"guest">>.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_test_utils.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_test_utils.erl
new file mode 100644
index 000000000..47df47976
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_test_utils.erl
@@ -0,0 +1,203 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rabbitmq_test_utils).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include_lib("emqx_connector/include/emqx_connector.hrl").
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("stdlib/include/assert.hrl").
+-include_lib("amqp_client/include/amqp_client.hrl").
+
+init_per_group(tcp, Config) ->
+    RabbitMQHost = os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq"),
+    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")),
+    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
+        true ->
+            Config1 = common_init_per_group(#{
+                host => RabbitMQHost, port => RabbitMQPort, tls => false
+            }),
+            Config1 ++ Config;
+        false ->
+            case os:getenv("IS_CI") of
+                "yes" ->
+                    throw(no_rabbitmq);
+                _ ->
+                    {skip, no_rabbitmq}
+            end
+    end;
+init_per_group(tls, Config) ->
+    RabbitMQHost = os:getenv("RABBITMQ_TLS_HOST", "rabbitmq"),
+    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_TLS_PORT", "5671")),
+    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
+        true ->
+            Config1 = common_init_per_group(#{
+                host => RabbitMQHost, port => RabbitMQPort, tls => true
+            }),
+            Config1 ++ Config;
+        false ->
+            case os:getenv("IS_CI") of
+                "yes" ->
+                    throw(no_rabbitmq);
+                _ ->
+                    {skip, no_rabbitmq}
+            end
+    end;
+init_per_group(_Group, Config) ->
+    Config.
+
+common_init_per_group(Opts) ->
+    emqx_common_test_helpers:render_and_load_app_config(emqx_conf),
+    ok = emqx_common_test_helpers:start_apps([
+        emqx_conf, emqx_bridge, emqx_bridge_rabbitmq, emqx_rule_engine
+    ]),
+    ok = emqx_connector_test_helpers:start_apps([emqx_resource]),
+    {ok, _} = application:ensure_all_started(emqx_connector),
+    {ok, _} = application:ensure_all_started(amqp_client),
+    emqx_mgmt_api_test_util:init_suite(),
+    #{host := Host, port := Port, tls := UseTLS} = Opts,
+    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS),
+    [
+        {channel_connection, ChannelConnection},
+        {rabbitmq, #{server => Host, port => Port, tls => UseTLS}}
+    ].
+
+setup_rabbit_mq_exchange_and_queue(Host, Port, UseTLS) ->
+    SSLOptions =
+        case UseTLS of
+            false -> none;
+            true -> emqx_tls_lib:to_client_opts(ssl_options(UseTLS))
+        end,
+    %% Create an exchange and a queue
+    {ok, Connection} =
+        amqp_connection:start(#amqp_params_network{
+            host = Host,
+            port = Port,
+            ssl_options = SSLOptions
+        }),
+    {ok, Channel} = amqp_connection:open_channel(Connection),
+    %% Create an exchange
+    #'exchange.declare_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'exchange.declare'{
+                exchange = rabbit_mq_exchange(),
+                type = <<"topic">>
+            }
+        ),
+    %% Create a queue
+    #'queue.declare_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'queue.declare'{queue = rabbit_mq_queue()}
+        ),
+    %% Bind the queue to the exchange
+    #'queue.bind_ok'{} =
+        amqp_channel:call(
+            Channel,
+            #'queue.bind'{
+                queue = rabbit_mq_queue(),
+                exchange = rabbit_mq_exchange(),
+                routing_key = rabbit_mq_routing_key()
+            }
+        ),
+    #{
+        connection => Connection,
+        channel => Channel
+    }.
+
+end_per_group(_Group, Config) ->
+    #{
+        connection := Connection,
+        channel := Channel
+    } = get_channel_connection(Config),
+    amqp_channel:call(Channel, #'queue.purge'{queue = rabbit_mq_queue()}),
+    emqx_mgmt_api_test_util:end_suite(),
+    ok = emqx_common_test_helpers:stop_apps([emqx_conf, emqx_bridge_rabbitmq, emqx_rule_engine]),
+    ok = emqx_connector_test_helpers:stop_apps([emqx_resource]),
+    _ = application:stop(emqx_connector),
+    _ = application:stop(emqx_bridge),
+    %% Close the channel
+    ok = amqp_channel:close(Channel),
+    %% Close the connection
+    ok = amqp_connection:close(Connection).
+
+rabbit_mq_host() ->
+    list_to_binary(os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq")).
+
+rabbit_mq_port() ->
+    list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")).
+
+rabbit_mq_exchange() ->
+    <<"messages">>.
+
+rabbit_mq_queue() ->
+    <<"test_queue">>.
+
+rabbit_mq_routing_key() ->
+    <<"test_routing_key">>.
+
+get_rabbitmq(Config) ->
+    proplists:get_value(rabbitmq, Config).
+
+get_channel_connection(Config) ->
+    proplists:get_value(channel_connection, Config).
+
+ssl_options(true) ->
+    CertsDir = filename:join([
+        emqx_common_test_helpers:proj_root(),
+        ".ci",
+        "docker-compose-file",
+        "certs"
+    ]),
+    #{
+        enable => true,
+        cacertfile => filename:join([CertsDir, "ca.crt"]),
+        certfile => filename:join([CertsDir, "client.pem"]),
+        keyfile => filename:join([CertsDir, "client.key"])
+    };
+ssl_options(false) ->
+    #{
+        enable => false
+    }.
+
+parse_and_check(Key, Mod, Conf, Name) ->
+    ConfStr = hocon_pp:do(Conf, #{}),
+    ct:pal(ConfStr),
+    {ok, RawConf} = hocon:binary(ConfStr, #{format => map}),
+    hocon_tconf:check_plain(Mod, RawConf, #{required => false, atom_key => false}),
+    #{Key := #{<<"rabbitmq">> := #{Name := RetConf}}} = RawConf,
+    RetConf.
+
+receive_message_from_rabbitmq(Config) ->
+    #{channel := Channel} = get_channel_connection(Config),
+    #'basic.consume_ok'{consumer_tag = ConsumerTag} =
+        amqp_channel:call(
+            Channel,
+            #'basic.consume'{
+                queue = rabbit_mq_queue()
+            }
+        ),
+    receive
+        %% This is the first message received
+        #'basic.consume_ok'{} ->
+            ok
+    end,
+    receive
+        {#'basic.deliver'{delivery_tag = DeliveryTag}, Content} ->
+            %% Ack the message
+            amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = DeliveryTag}),
+            %% Cancel the consumer
+            #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
+                amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
+            Payload = Content#amqp_msg.payload,
+            case emqx_utils_json:safe_decode(Payload, [return_maps]) of
+                {ok, Msg} -> Msg;
+                {error, _} -> ?assert(false, {"Failed to decode the message", Payload})
+            end
+    after 5000 ->
+        ?assert(false, "Did not receive message within 5 second")
+    end.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v1_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v1_SUITE.erl
new file mode 100644
index 000000000..48756c616
--- /dev/null
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v1_SUITE.erl
@@ -0,0 +1,221 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rabbitmq_v1_SUITE).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include_lib("emqx_connector/include/emqx_connector.hrl").
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("stdlib/include/assert.hrl").
+-include_lib("amqp_client/include/amqp_client.hrl").
+
+%% See comment in
+%% apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_connector_SUITE.erl for how to
+%% run this without bringing up the whole CI infrastructure
+-define(TYPE, <<"rabbitmq">>).
+-import(emqx_bridge_rabbitmq_test_utils, [
+    rabbit_mq_exchange/0,
+    rabbit_mq_routing_key/0,
+    rabbit_mq_queue/0,
+    rabbit_mq_host/0,
+    rabbit_mq_port/0,
+    get_rabbitmq/1,
+    ssl_options/1,
+    get_channel_connection/1,
+    parse_and_check/4,
+    receive_message_from_rabbitmq/1
+]).
+%%------------------------------------------------------------------------------
+%% Common Test Setup, Tear down and Testcase List
+%%------------------------------------------------------------------------------
+
+all() ->
+    [
+        {group, tcp},
+        {group, tls}
+    ].
+
+groups() ->
+    AllTCs = emqx_common_test_helpers:all(?MODULE),
+    [
+        {tcp, AllTCs},
+        {tls, AllTCs}
+    ].
+
+init_per_group(Group, Config) ->
+    emqx_bridge_rabbitmq_test_utils:init_per_group(Group, Config).
+
+end_per_group(Group, Config) ->
+    emqx_bridge_rabbitmq_test_utils:end_per_group(Group, Config).
+
+create_bridge(Name, Config) ->
+    BridgeConfig = rabbitmq_config(Config),
+    {ok, _} = emqx_bridge:create(?TYPE, Name, BridgeConfig),
+    emqx_bridge_resource:bridge_id(?TYPE, Name).
+
+delete_bridge(Name) ->
+    ok = emqx_bridge:remove(?TYPE, Name).
+
+%%------------------------------------------------------------------------------
+%% Test Cases
+%%------------------------------------------------------------------------------
+
+t_create_delete_bridge(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    create_bridge(Name, RabbitMQ),
+    Bridges = emqx_bridge:list(),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Bridges), Bridges),
+    ok = delete_bridge(Name),
+    BridgesAfterDelete = emqx_bridge:list(),
+    ?assertNot(lists:any(Any, BridgesAfterDelete), BridgesAfterDelete),
+    ok.
+
+t_create_delete_bridge_non_existing_server(_Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    create_bridge(Name, #{server => <<"non_existing_server">>, port => 3174}),
+    %% Check that the new bridge is in the list of bridges
+    Bridges = emqx_bridge:list(),
+    Any = fun(#{name := BName}) -> BName =:= Name end,
+    ?assert(lists:any(Any, Bridges)),
+    ok = delete_bridge(Name),
+    BridgesAfterDelete = emqx_bridge:list(),
+    ?assertNot(lists:any(Any, BridgesAfterDelete)),
+    ok.
+
+t_send_message_query(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeID = create_bridge(Name, RabbitMQ#{batch_size => 1}),
+    Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
+    %% This will use the SQL template included in the bridge
+    emqx_bridge:send_message(BridgeID, Payload),
+    %% Check that the data got to the database
+    ?assertEqual(Payload, receive_message_from_rabbitmq(Config)),
+    ok = delete_bridge(Name),
+    ok.
+
+t_send_message_query_with_template(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeID = create_bridge(Name, RabbitMQ#{
+        batch_size => 1,
+        payload_template => payload_template()
+    }),
+    Payload = #{
+        <<"key">> => 7,
+        <<"data">> => <<"RabbitMQ">>,
+        <<"timestamp">> => 10000
+    },
+    emqx_bridge:send_message(BridgeID, Payload),
+    %% Check that the data got to the database
+    ExpectedResult = Payload#{
+        <<"secret">> => 42
+    },
+    ?assertEqual(ExpectedResult, receive_message_from_rabbitmq(Config)),
+    ok = delete_bridge(Name),
+    ok.
+
+t_send_simple_batch(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeConf = RabbitMQ#{batch_size => 100},
+    BridgeID = create_bridge(Name, BridgeConf),
+    Payload = #{<<"key">> => 42, <<"data">> => <<"RabbitMQ">>, <<"timestamp">> => 10000},
+    emqx_bridge:send_message(BridgeID, Payload),
+    ?assertEqual(Payload, receive_message_from_rabbitmq(Config)),
+    ok = delete_bridge(Name),
+    ok.
+
+t_send_simple_batch_with_template(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeConf =
+        RabbitMQ#{
+            batch_size => 100,
+            payload_template => payload_template()
+        },
+    BridgeID = create_bridge(Name, BridgeConf),
+    Payload = #{
+        <<"key">> => 7,
+        <<"data">> => <<"RabbitMQ">>,
+        <<"timestamp">> => 10000
+    },
+    emqx_bridge:send_message(BridgeID, Payload),
+    ExpectedResult = Payload#{<<"secret">> => 42},
+    ?assertEqual(ExpectedResult, receive_message_from_rabbitmq(Config)),
+    ok = delete_bridge(Name),
+    ok.
+
+t_heavy_batching(Config) ->
+    Name = atom_to_binary(?FUNCTION_NAME),
+    NumberOfMessages = 20000,
+    RabbitMQ = get_rabbitmq(Config),
+    BridgeConf = RabbitMQ#{
+        batch_size => 10173,
+        batch_time_ms => 50
+    },
+    BridgeID = create_bridge(Name, BridgeConf),
+    SendMessage = fun(Key) ->
+        Payload = #{<<"key">> => Key},
+        emqx_bridge:send_message(BridgeID, Payload)
+    end,
+    [SendMessage(Key) || Key <- lists:seq(1, NumberOfMessages)],
+    AllMessages = lists:foldl(
+        fun(_, Acc) ->
+            Message = receive_message_from_rabbitmq(Config),
+            #{<<"key">> := Key} = Message,
+            Acc#{Key => true}
+        end,
+        #{},
+        lists:seq(1, NumberOfMessages)
+    ),
+    ?assertEqual(NumberOfMessages, maps:size(AllMessages)),
+    ok = delete_bridge(Name),
+    ok.
+
+rabbitmq_config(Config) ->
+    UseTLS = maps:get(tls, Config, false),
+    BatchSize = maps:get(batch_size, Config, 1),
+    BatchTime = maps:get(batch_time_ms, Config, 0),
+    Name = atom_to_binary(?MODULE),
+    Server = maps:get(server, Config, rabbit_mq_host()),
+    Port = maps:get(port, Config, rabbit_mq_port()),
+    Template = maps:get(payload_template, Config, <<"">>),
+    Bridge =
+        #{
+            <<"bridges">> => #{
+                <<"rabbitmq">> => #{
+                    Name => #{
+                        <<"enable">> => true,
+                        <<"ssl">> => ssl_options(UseTLS),
+                        <<"server">> => Server,
+                        <<"port">> => Port,
+                        <<"username">> => <<"guest">>,
+                        <<"password">> => <<"guest">>,
+                        <<"routing_key">> => rabbit_mq_routing_key(),
+                        <<"exchange">> => rabbit_mq_exchange(),
+                        <<"payload_template">> => Template,
+                        <<"resource_opts">> => #{
+                            <<"batch_size">> => BatchSize,
+                            <<"batch_time">> => BatchTime
+                        }
+                    }
+                }
+            }
+        },
+    parse_and_check(<<"bridges">>, emqx_bridge_schema, Bridge, Name).
+
+payload_template() ->
+    <<
+        "{"
+        "      \"key\": ${key},"
+        "      \"data\": \"${data}\","
+        "      \"timestamp\": ${timestamp},"
+        "      \"secret\": 42"
+        "}"
+    >>.
diff --git a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl
index 5a17c2914..8b11f732a 100644
--- a/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl
+++ b/apps/emqx_bridge_rabbitmq/test/emqx_bridge_rabbitmq_v2_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 
 -module(emqx_bridge_rabbitmq_v2_SUITE).
@@ -12,203 +12,108 @@
 -include_lib("stdlib/include/assert.hrl").
 -include_lib("amqp_client/include/amqp_client.hrl").
 
--define(TYPE, <<"rabbitmq">>).
+-import(emqx_bridge_rabbitmq_test_utils, [
+    rabbit_mq_exchange/0,
+    rabbit_mq_routing_key/0,
+    rabbit_mq_queue/0,
+    rabbit_mq_host/0,
+    rabbit_mq_port/0,
+    get_rabbitmq/1,
+    get_tls/1,
+    ssl_options/1,
+    get_channel_connection/1,
+    parse_and_check/4,
+    receive_message_from_rabbitmq/1
+]).
 -import(emqx_common_test_helpers, [on_exit/1]).
 
-rabbit_mq_host() ->
-    <<"rabbitmq">>.
-
-rabbit_mq_port() ->
-    5672.
-
-rabbit_mq_exchange() ->
-    <<"messages">>.
-
-rabbit_mq_queue() ->
-    <<"test_queue">>.
-
-rabbit_mq_routing_key() ->
-    <<"test_routing_key">>.
-
-get_channel_connection(Config) ->
-    proplists:get_value(channel_connection, Config).
-
-get_rabbitmq(Config) ->
-    proplists:get_value(rabbitmq, Config).
-
-%%------------------------------------------------------------------------------
-%% Common Test Setup, Tear down and Testcase List
-%%------------------------------------------------------------------------------
+-define(TYPE, <<"rabbitmq">>).
 
 all() ->
-    emqx_common_test_helpers:all(?MODULE).
-
-init_per_suite(Config) ->
-    RabbitMQHost = os:getenv("RABBITMQ_PLAIN_HOST", "rabbitmq"),
-    RabbitMQPort = list_to_integer(os:getenv("RABBITMQ_PLAIN_PORT", "5672")),
-    case emqx_common_test_helpers:is_tcp_server_available(RabbitMQHost, RabbitMQPort) of
-        true ->
-            Config1 = common_init(#{
-                host => RabbitMQHost, port => RabbitMQPort
-            }),
-            Name = atom_to_binary(?MODULE),
-            Config2 = [{connector, Name} | Config1 ++ Config],
-            create_connector(Name, get_rabbitmq(Config2)),
-            Config2;
-        false ->
-            case os:getenv("IS_CI") of
-                "yes" ->
-                    throw(no_rabbitmq);
-                _ ->
-                    {skip, no_rabbitmq}
-            end
-    end.
-
-common_init(Opts) ->
-    emqx_common_test_helpers:render_and_load_app_config(emqx_conf),
-    ok = emqx_common_test_helpers:start_apps([
-        emqx_conf, emqx_bridge, emqx_bridge_rabbitmq, emqx_rule_engine
-    ]),
-    ok = emqx_connector_test_helpers:start_apps([emqx_resource]),
-    {ok, _} = application:ensure_all_started(emqx_connector),
-    {ok, _} = application:ensure_all_started(amqp_client),
-    emqx_mgmt_api_test_util:init_suite(),
-    #{host := Host, port := Port} = Opts,
-    ChannelConnection = setup_rabbit_mq_exchange_and_queue(Host, Port),
     [
-        {channel_connection, ChannelConnection},
-        {rabbitmq, #{server => Host, port => Port}}
+        {group, tcp},
+        {group, tls}
     ].
 
-setup_rabbit_mq_exchange_and_queue(Host, Port) ->
-    %% Create an exchange and a queue
-    {ok, Connection} =
-        amqp_connection:start(#amqp_params_network{
-            host = Host,
-            port = Port,
-            ssl_options = none
-        }),
-    {ok, Channel} = amqp_connection:open_channel(Connection),
-    %% Create an exchange
-    #'exchange.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'exchange.declare'{
-                exchange = rabbit_mq_exchange(),
-                type = <<"topic">>
-            }
-        ),
-    %% Create a queue
-    #'queue.declare_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.declare'{queue = rabbit_mq_queue()}
-        ),
-    %% Bind the queue to the exchange
-    #'queue.bind_ok'{} =
-        amqp_channel:call(
-            Channel,
-            #'queue.bind'{
-                queue = rabbit_mq_queue(),
-                exchange = rabbit_mq_exchange(),
-                routing_key = rabbit_mq_routing_key()
-            }
-        ),
-    #{
-        connection => Connection,
-        channel => Channel
-    }.
+groups() ->
+    AllTCs = emqx_common_test_helpers:all(?MODULE),
+    [
+        {tcp, AllTCs},
+        {tls, AllTCs}
+    ].
 
-end_per_suite(Config) ->
-    delete_connector(proplists:get_value(connector, Config)),
-    #{
-        connection := Connection,
-        channel := Channel
-    } = get_channel_connection(Config),
-    emqx_mgmt_api_test_util:end_suite(),
-    ok = emqx_common_test_helpers:stop_apps([emqx_conf, emqx_bridge_rabbitmq, emqx_rule_engine]),
-    ok = emqx_connector_test_helpers:stop_apps([emqx_resource]),
-    _ = application:stop(emqx_connector),
-    _ = application:stop(emqx_bridge),
-    %% Close the channel
-    ok = amqp_channel:close(Channel),
-    %% Close the connection
-    ok = amqp_connection:close(Connection).
+init_per_group(Group, Config) ->
+    Config1 = emqx_bridge_rabbitmq_test_utils:init_per_group(Group, Config),
+    Name = atom_to_binary(?MODULE),
+    create_connector(Name, get_rabbitmq(Config1)),
+    Config1.
+
+end_per_group(Group, Config) ->
+    Name = atom_to_binary(?MODULE),
+    delete_connector(Name),
+    emqx_bridge_rabbitmq_test_utils:end_per_group(Group, Config).
 
 rabbitmq_connector(Config) ->
+    UseTLS = maps:get(tls, Config, false),
     Name = atom_to_binary(?MODULE),
     Server = maps:get(server, Config, rabbit_mq_host()),
     Port = maps:get(port, Config, rabbit_mq_port()),
-    ConfigStr =
-        io_lib:format(
-            "connectors.rabbitmq.~s {\n"
-            "  enable = true\n"
-            "  ssl = {enable = false}\n"
-            "  server = \"~s\"\n"
-            "  port = ~p\n"
-            "  username = \"guest\"\n"
-            "  password = \"guest\"\n"
-            "}\n",
-            [
-                Name,
-                Server,
-                Port
-            ]
-        ),
-    ct:pal(ConfigStr),
-    parse_and_check(<<"connectors">>, emqx_connector_schema, ConfigStr, <<"rabbitmq">>, Name).
+    Connector = #{
+        <<"connectors">> => #{
+            <<"rabbitmq">> => #{
+                Name => #{
+                    <<"enable">> => true,
+                    <<"ssl">> => ssl_options(UseTLS),
+                    <<"server">> => Server,
+                    <<"port">> => Port,
+                    <<"username">> => <<"guest">>,
+                    <<"password">> => <<"guest">>
+                }
+            }
+        }
+    },
+    parse_and_check(<<"connectors">>, emqx_connector_schema, Connector, Name).
 
 rabbitmq_source() ->
     Name = atom_to_binary(?MODULE),
-    ConfigStr =
-        io_lib:format(
-            "sources.rabbitmq.~s {\n"
-            "connector = ~s\n"
-            "enable = true\n"
-            "parameters {\n"
-            "no_ack = true\n"
-            "queue = ~s\n"
-            "wait_for_publish_confirmations = true\n"
-            "}}\n",
-            [
-                Name,
-                Name,
-                rabbit_mq_queue()
-            ]
-        ),
-    ct:pal(ConfigStr),
-    parse_and_check(<<"sources">>, emqx_bridge_v2_schema, ConfigStr, <<"rabbitmq">>, Name).
+    Source = #{
+        <<"sources">> => #{
+            <<"rabbitmq">> => #{
+                Name => #{
+                    <<"enable">> => true,
+                    <<"connector">> => Name,
+                    <<"parameters">> => #{
+                        <<"no_ack">> => true,
+                        <<"queue">> => rabbit_mq_queue(),
+                        <<"wait_for_publish_confirmations">> => true
+                    }
+                }
+            }
+        }
+    },
+    parse_and_check(<<"sources">>, emqx_bridge_v2_schema, Source, Name).
 
 rabbitmq_action() ->
     Name = atom_to_binary(?MODULE),
-    ConfigStr =
-        io_lib:format(
-            "actions.rabbitmq.~s {\n"
-            "connector = ~s\n"
-            "enable = true\n"
-            "parameters {\n"
-            "exchange: ~s\n"
-            "payload_template: \"${.payload}\"\n"
-            "routing_key: ~s\n"
-            "delivery_mode: non_persistent\n"
-            "publish_confirmation_timeout: 30s\n"
-            "wait_for_publish_confirmations = true\n"
-            "}}\n",
-            [
-                Name,
-                Name,
-                rabbit_mq_exchange(),
-                rabbit_mq_routing_key()
-            ]
-        ),
-    ct:pal(ConfigStr),
-    parse_and_check(<<"actions">>, emqx_bridge_v2_schema, ConfigStr, <<"rabbitmq">>, Name).
-
-parse_and_check(Key, Mod, ConfigStr, Type, Name) ->
-    {ok, RawConf} = hocon:binary(ConfigStr, #{format => map}),
-    hocon_tconf:check_plain(Mod, RawConf, #{required => false, atom_key => false}),
-    #{Key := #{Type := #{Name := RetConfig}}} = RawConf,
-    RetConfig.
+    Action = #{
+        <<"actions">> => #{
+            <<"rabbitmq">> => #{
+                Name => #{
+                    <<"connector">> => Name,
+                    <<"enable">> => true,
+                    <<"parameters">> => #{
+                        <<"exchange">> => rabbit_mq_exchange(),
+                        <<"payload_template">> => <<"${.payload}">>,
+                        <<"routing_key">> => rabbit_mq_routing_key(),
+                        <<"delivery_mode">> => <<"non_persistent">>,
+                        <<"publish_confirmation_timeout">> => <<"30s">>,
+                        <<"wait_for_publish_confirmations">> => true
+                    }
+                }
+            }
+        }
+    },
+    parse_and_check(<<"actions">>, emqx_bridge_v2_schema, Action, Name).
 
 create_connector(Name, Config) ->
     Connector = rabbitmq_connector(Config),
@@ -308,7 +213,7 @@ t_action(Config) ->
     Payload = payload(),
     PayloadBin = emqx_utils_json:encode(Payload),
     {ok, _} = emqtt:publish(C1, Topic, #{}, PayloadBin, [{qos, 1}, {retain, false}]),
-    Msg = receive_test_message_from_rabbitmq(Config),
+    Msg = receive_message_from_rabbitmq(Config),
     ?assertMatch(Payload, Msg),
     ok = emqtt:disconnect(C1),
     ok = delete_action(Name),
@@ -354,29 +259,3 @@ send_test_message_to_rabbitmq(Config) ->
         }
     ),
     ok.
-
-receive_test_message_from_rabbitmq(Config) ->
-    #{channel := Channel} = get_channel_connection(Config),
-    #'basic.consume_ok'{consumer_tag = ConsumerTag} =
-        amqp_channel:call(
-            Channel,
-            #'basic.consume'{
-                queue = rabbit_mq_queue()
-            }
-        ),
-    receive
-        %% This is the first message received
-        #'basic.consume_ok'{} ->
-            ok
-    end,
-    receive
-        {#'basic.deliver'{delivery_tag = DeliveryTag}, Content} ->
-            %% Ack the message
-            amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = DeliveryTag}),
-            %% Cancel the consumer
-            #'basic.cancel_ok'{consumer_tag = ConsumerTag} =
-                amqp_channel:call(Channel, #'basic.cancel'{consumer_tag = ConsumerTag}),
-            emqx_utils_json:decode(Content#amqp_msg.payload)
-    after 5000 ->
-        ?assert(false, "Did not receive message within 5 second")
-    end.

From e284a83f733f68d0463dd705a33d44aad64de2e3 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Mon, 5 Feb 2024 15:29:19 +0100
Subject: [PATCH 181/273] feat: refactor RocketMQ bridge to connector and
 action

Fixes:
https://emqx.atlassian.net/browse/EMQX-11467
---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_rocketmq.app.src          |   4 +-
 .../src/emqx_bridge_rocketmq.erl              | 166 ++++++++++++++++--
 .../src/emqx_bridge_rocketmq_action_info.erl  |  22 +++
 .../src/emqx_bridge_rocketmq_connector.erl    | 121 ++++++++++---
 .../test/emqx_bridge_rocketmq_SUITE.erl       |  15 +-
 .../src/schema/emqx_connector_ee_schema.erl   |  12 ++
 .../src/schema/emqx_connector_schema.erl      |   2 +
 rel/i18n/emqx_bridge_rocketmq.hocon           |  18 ++
 9 files changed, 317 insertions(+), 44 deletions(-)
 create mode 100644 apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_action_info.erl

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index e74e6aa3e..ea9c76d2b 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -94,6 +94,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
         emqx_bridge_oracle_action_info,
+        emqx_bridge_rocketmq_action_info,
         emqx_bridge_influxdb_action_info,
         emqx_bridge_cassandra_action_info,
         emqx_bridge_mysql_action_info,
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.app.src b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.app.src
index 38c00e7ee..564e36a88 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.app.src
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.app.src
@@ -1,9 +1,9 @@
 {application, emqx_bridge_rocketmq, [
     {description, "EMQX Enterprise RocketMQ Bridge"},
-    {vsn, "0.1.4"},
+    {vsn, "0.1.5"},
     {registered, []},
     {applications, [kernel, stdlib, emqx_resource, rocketmq]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_rocketmq_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
index b3149fa99..faac69095 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
@@ -8,12 +8,7 @@
 -include_lib("emqx_bridge/include/emqx_bridge.hrl").
 -include_lib("emqx_resource/include/emqx_resource.hrl").
 
--import(hoconsc, [mk/2, enum/1, ref/2]).
-
--export([
-    conn_bridge_examples/1,
-    values/1
-]).
+-import(hoconsc, [mk/2, enum/1]).
 
 -export([
     namespace/0,
@@ -22,6 +17,14 @@
     desc/1
 ]).
 
+-export([
+    bridge_v2_examples/1,
+    connector_examples/1,
+    conn_bridge_examples/1
+]).
+
+-define(CONNECTOR_TYPE, rocketmq).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
 -define(DEFAULT_TEMPLATE, <<>>).
 -define(DEFFAULT_REQ_TIMEOUT, <<"15s">>).
 
@@ -33,14 +36,14 @@ conn_bridge_examples(Method) ->
         #{
             <<"rocketmq">> => #{
                 summary => <<"RocketMQ Bridge">>,
-                value => values(Method)
+                value => conn_bridge_example_values(Method)
             }
         }
     ].
 
-values(get) ->
-    values(post);
-values(post) ->
+conn_bridge_example_values(get) ->
+    conn_bridge_example_values(post);
+conn_bridge_example_values(post) ->
     #{
         enable => true,
         type => rocketmq,
@@ -58,8 +61,59 @@ values(post) ->
             max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
         }
     };
-values(put) ->
-    values(post).
+conn_bridge_example_values(put) ->
+    conn_bridge_example_values(post).
+
+%% TODO fix these examples
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"rocketmq">> =>
+                #{
+                    summary => <<"RocketMQ Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_values()
+                    )
+                }
+        }
+    ].
+
+connector_values() ->
+    #{
+        <<"enable">> => true,
+        <<"servers">> => <<"127.0.0.1:9876">>,
+        <<"pool_size">> => 8,
+        <<"resource_opts">> => #{
+            <<"health_check_interval">> => <<"15s">>,
+            <<"start_after_created">> => true,
+            <<"start_timeout">> => <<"5s">>
+        }
+    }.
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"rocketmq">> =>
+                #{
+                    summary => <<"RocketMQ Action">>,
+                    value => emqx_bridge_v2_schema:action_values(
+                        Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                    )
+                }
+        }
+    ].
+
+action_values() ->
+    #{
+        <<"parameters">> => #{
+            <<"topic">> => <<"TopicTest">>,
+            <<"template">> => ?DEFAULT_TEMPLATE,
+            <<"refresh_interval">> => <<"3s">>,
+            <<"send_buffer">> => <<"1024KB">>,
+            <<"sync_timeout">> => <<"3s">>
+        }
+    }.
 
 %% -------------------------------------------------------------------------------------------------
 %% Hocon Schema Definitions
@@ -67,6 +121,84 @@ namespace() -> "bridge_rocketmq".
 
 roots() -> [].
 
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    emqx_connector_schema:api_fields(
+        Field,
+        ?CONNECTOR_TYPE,
+        fields("config_connector") -- emqx_connector_schema:common_fields()
+    );
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(rocketmq_action));
+fields(action) ->
+    {?ACTION_TYPE,
+        hoconsc:mk(
+            hoconsc:map(name, hoconsc:ref(?MODULE, rocketmq_action)),
+            #{
+                desc => <<"RocketMQ Action Config">>,
+                required => false
+            }
+        )};
+fields(rocketmq_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        hoconsc:mk(
+            hoconsc:ref(?MODULE, action_parameters),
+            #{
+                required => true,
+                desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    Parameters =
+        [
+            {template,
+                mk(
+                    binary(),
+                    #{desc => ?DESC("template"), default => ?DEFAULT_TEMPLATE}
+                )}
+        ] ++ emqx_bridge_rocketmq_connector:fields(config),
+    lists:foldl(
+        fun(Key, Acc) ->
+            proplists:delete(Key, Acc)
+        end,
+        Parameters,
+        [
+            servers,
+            pool_size,
+            auto_reconnect,
+            access_key,
+            secret_key,
+            security_token
+        ]
+    );
+fields("config_connector") ->
+    Config =
+        emqx_connector_schema:common_fields() ++
+            emqx_bridge_rocketmq_connector:fields(config) ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    lists:foldl(
+        fun(Key, Acc) ->
+            proplists:delete(Key, Acc)
+        end,
+        Config,
+        [
+            topic,
+            sync_timeout,
+            refresh_interval,
+            send_buffer,
+            auto_reconnect
+        ]
+    );
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
 fields("config") ->
     [
         {enable, mk(boolean(), #{desc => ?DESC("config_enable"), default => true})},
@@ -94,6 +226,16 @@ desc("config") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for RocketMQ using `", string:to_upper(Method), "` method."];
+desc("creation_opts") ->
+    ?DESC(emqx_resource_schema, "creation_opts");
+desc("config_connector") ->
+    ?DESC("config_connector");
+desc(rocketmq_action) ->
+    ?DESC("rocketmq_action");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(_) ->
     undefined.
 
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_action_info.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_action_info.erl
new file mode 100644
index 000000000..f3a7ab1a3
--- /dev/null
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_action_info.erl
@@ -0,0 +1,22 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_rocketmq_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+bridge_v1_type_name() -> rocketmq.
+
+action_type_name() -> rocketmq.
+
+connector_type_name() -> rocketmq.
+
+schema_module() -> emqx_bridge_rocketmq.
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
index 81045ade4..baa895a8a 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
@@ -21,10 +21,14 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
--import(hoconsc, [mk/2, enum/1, ref/2]).
+-import(hoconsc, [mk/2]).
 
 -define(ROCKETMQ_HOST_OPTIONS, #{
     default_port => 9876
@@ -82,7 +86,12 @@ callback_mode() -> always_sync.
 
 on_start(
     InstanceId,
-    #{servers := BinServers, topic := Topic, sync_timeout := SyncTimeout} = Config
+    #{
+        servers := BinServers,
+        access_key := AccessKey,
+        secret_key := SecretKey,
+        security_token := SecurityToken
+    } = Config
 ) ->
     ?SLOG(info, #{
         msg => "starting_rocketmq_connector",
@@ -94,18 +103,18 @@ on_start(
         emqx_schema:parse_servers(BinServers, ?ROCKETMQ_HOST_OPTIONS)
     ),
     ClientId = client_id(InstanceId),
-    TopicTks = emqx_placeholder:preproc_tmpl(Topic),
-    #{acl_info := AclInfo} = ProducerOpts = make_producer_opts(Config),
-    ClientCfg = #{acl_info => AclInfo},
-    Templates = parse_template(Config),
+    ACLInfo = acl_info(AccessKey, SecretKey, SecurityToken),
+    ClientCfg = #{acl_info => ACLInfo},
 
     State = #{
         client_id => ClientId,
-        topic => Topic,
-        topic_tokens => TopicTks,
-        sync_timeout => SyncTimeout,
-        templates => Templates,
-        producers_opts => ProducerOpts
+        acl_info => ACLInfo,
+        installed_channels => #{}
+        % topic => Topic,
+        % topic_tokens => TopicTks,
+        % sync_timeout => SyncTimeout,
+        % templates => Templates,
+        % producers_opts => ProducerOpts
     },
 
     ok = emqx_resource:allocate_resource(InstanceId, client_id, ClientId),
@@ -123,6 +132,64 @@ on_start(
             {error, Reason}
     end.
 
+on_add_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels,
+        acl_info := ACLInfo
+    } = OldState,
+    ChannelId,
+    ChannelConfig
+) ->
+    {ok, ChannelState} = create_channel_state(ChannelConfig, ACLInfo),
+    NewInstalledChannels = maps:put(ChannelId, ChannelState, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+create_channel_state(
+    #{parameters := Conf} = _ChannelConfig,
+    ACLInfo
+) ->
+    #{
+        topic := Topic,
+        sync_timeout := SyncTimeout
+    } = Conf,
+    TopicTks = emqx_placeholder:preproc_tmpl(Topic),
+    ProducerOpts = make_producer_opts(Conf, ACLInfo),
+    Templates = parse_template(Conf),
+    State = #{
+        topic => Topic,
+        topic_tokens => TopicTks,
+        templates => Templates,
+        sync_timeout => SyncTimeout,
+        acl_info => ACLInfo,
+        producers_opts => ProducerOpts
+    },
+    {ok, State}.
+
+on_remove_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels
+    } = OldState,
+    ChannelId
+) ->
+    NewInstalledChannels = maps:remove(ChannelId, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+on_get_channel_status(
+    _ResId,
+    _ChannelId,
+    _State
+) ->
+    ?status_connected.
+
+on_get_channels(ResId) ->
+    emqx_bridge_v2:get_channels_for_connector(ResId).
+
 on_stop(InstanceId, _State) ->
     ?SLOG(info, #{
         msg => "stopping_rocketmq_connector",
@@ -144,7 +211,7 @@ on_query(InstanceId, Query, State) ->
     do_query(InstanceId, Query, send_sync, State).
 
 %% We only support batch inserts and all messages must have the same topic
-on_batch_query(InstanceId, [{send_message, _Msg} | _] = Query, State) ->
+on_batch_query(InstanceId, [{_ChannelId, _Msg} | _] = Query, State) ->
     do_query(InstanceId, Query, batch_send_sync, State);
 on_batch_query(_InstanceId, Query, _State) ->
     {error, {unrecoverable_error, {invalid_request, Query}}}.
@@ -154,11 +221,11 @@ on_get_status(_InstanceId, #{client_id := ClientId}) ->
         {ok, Pid} ->
             status_result(rocketmq_client:get_status(Pid));
         _ ->
-            connecting
+            ?status_connecting
     end.
 
-status_result(_Status = true) -> connected;
-status_result(_Status) -> connecting.
+status_result(_Status = true) -> ?status_connected;
+status_result(_Status) -> ?status_connecting.
 
 %%========================================================================================
 %% Helper fns
@@ -169,11 +236,8 @@ do_query(
     Query,
     QueryFunc,
     #{
-        templates := Templates,
         client_id := ClientId,
-        topic_tokens := TopicTks,
-        producers_opts := ProducerOpts,
-        sync_timeout := RequestTimeout
+        installed_channels := Channels
     } = State
 ) ->
     ?TRACE(
@@ -181,6 +245,13 @@ do_query(
         "rocketmq_connector_received",
         #{connector => InstanceId, query => Query, state => State}
     ),
+    ChannelId = get_channel_id(Query),
+    #{
+        topic_tokens := TopicTks,
+        templates := Templates,
+        sync_timeout := RequestTimeout,
+        producers_opts := ProducerOpts
+    } = maps:get(ChannelId, Channels),
 
     TopicKey = get_topic_key(Query, TopicTks),
     Data = apply_template(Query, Templates),
@@ -209,6 +280,9 @@ do_query(
             Result
     end.
 
+get_channel_id({ChannelId, _}) -> ChannelId;
+get_channel_id([{ChannelId, _} | _]) -> ChannelId.
+
 safe_do_produce(InstanceId, QueryFunc, ClientId, TopicKey, Data, ProducerOpts, RequestTimeout) ->
     try
         Producers = get_producers(InstanceId, ClientId, TopicKey, ProducerOpts),
@@ -275,14 +349,11 @@ is_sensitive_key(_) ->
 
 make_producer_opts(
     #{
-        access_key := AccessKey,
-        secret_key := SecretKey,
-        security_token := SecurityToken,
         send_buffer := SendBuff,
         refresh_interval := RefreshInterval
-    }
+    },
+    ACLInfo
 ) ->
-    ACLInfo = acl_info(AccessKey, SecretKey, SecurityToken),
     #{
         tcp_opts => [{sndbuf, SendBuff}],
         ref_topic_route_interval => RefreshInterval,
diff --git a/apps/emqx_bridge_rocketmq/test/emqx_bridge_rocketmq_SUITE.erl b/apps/emqx_bridge_rocketmq/test/emqx_bridge_rocketmq_SUITE.erl
index 1a5133b84..4a0a5a862 100644
--- a/apps/emqx_bridge_rocketmq/test/emqx_bridge_rocketmq_SUITE.erl
+++ b/apps/emqx_bridge_rocketmq/test/emqx_bridge_rocketmq_SUITE.erl
@@ -196,14 +196,15 @@ create_bridge_http(Params) ->
 send_message(Config, Payload) ->
     Name = ?GET_CONFIG(rocketmq_name, Config),
     BridgeType = ?GET_CONFIG(rocketmq_bridge_type, Config),
-    BridgeID = emqx_bridge_resource:bridge_id(BridgeType, Name),
-    emqx_bridge:send_message(BridgeID, Payload).
+    ActionId = emqx_bridge_v2:id(BridgeType, Name),
+    emqx_bridge_v2:query(BridgeType, Name, {ActionId, Payload}, #{}).
 
 query_resource(Config, Request) ->
     Name = ?GET_CONFIG(rocketmq_name, Config),
     BridgeType = ?GET_CONFIG(rocketmq_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => 500}).
+    ID = emqx_bridge_v2:id(BridgeType, Name),
+    ResID = emqx_connector_resource:resource_id(BridgeType, Name),
+    emqx_resource:query(ID, Request, #{timeout => 500, connector_resource_id => ResID}).
 
 %%------------------------------------------------------------------------------
 %% Testcases
@@ -273,6 +274,7 @@ t_get_status(Config) ->
     ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
 
     ?assertEqual({ok, connected}, emqx_resource_manager:health_check(ResourceID)),
+    ?assertMatch(#{status := connected}, emqx_bridge_v2:health_check(BridgeType, Name)),
     ok.
 
 t_simple_query(Config) ->
@@ -280,7 +282,10 @@ t_simple_query(Config) ->
         {ok, _},
         create_bridge(Config)
     ),
-    Request = {send_message, #{message => <<"Hello">>}},
+    Type = ?GET_CONFIG(rocketmq_bridge_type, Config),
+    Name = ?GET_CONFIG(rocketmq_name, Config),
+    ActionId = emqx_bridge_v2:id(Type, Name),
+    Request = {ActionId, #{message => <<"Hello">>}},
     Result = query_resource(Config, Request),
     ?assertEqual(ok, Result),
     ok.
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 2935233be..019545fd6 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -54,6 +54,8 @@ resource_type(timescale) ->
     emqx_postgresql;
 resource_type(redis) ->
     emqx_bridge_redis_connector;
+resource_type(rocketmq) ->
+    emqx_bridge_rocketmq_connector;
 resource_type(iotdb) ->
     emqx_bridge_iotdb_connector;
 resource_type(elasticsearch) ->
@@ -199,6 +201,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {rocketmq,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_rocketmq, "config_connector")),
+                #{
+                    desc => <<"RocketMQ Connector Config">>,
+                    required => false
+                }
+            )},
         {syskeeper_forwarder,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_syskeeper_connector, config)),
@@ -291,6 +301,7 @@ schema_modules() ->
         emqx_bridge_timescale,
         emqx_postgresql_connector_schema,
         emqx_bridge_redis_schema,
+        emqx_bridge_rocketmq,
         emqx_bridge_iotdb_connector,
         emqx_bridge_es_connector,
         emqx_bridge_rabbitmq_connector_schema,
@@ -327,6 +338,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_timescale, <<"timescale">>, Method ++ "_connector"),
         api_ref(emqx_postgresql_connector_schema, <<"pgsql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_redis_schema, <<"redis">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_rocketmq, <<"rocketmq">>, Method ++ "_connector"),
         api_ref(emqx_bridge_iotdb_connector, <<"iotdb">>, Method),
         api_ref(emqx_bridge_es_connector, <<"elasticsearch">>, Method),
         api_ref(emqx_bridge_opents_connector, <<"opents">>, Method),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index b803ab9f2..5e0174479 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -150,6 +150,8 @@ connector_type_to_bridge_types(pgsql) ->
     [pgsql];
 connector_type_to_bridge_types(redis) ->
     [redis, redis_single, redis_sentinel, redis_cluster];
+connector_type_to_bridge_types(rocketmq) ->
+    [rocketmq];
 connector_type_to_bridge_types(syskeeper_forwarder) ->
     [syskeeper_forwarder];
 connector_type_to_bridge_types(syskeeper_proxy) ->
diff --git a/rel/i18n/emqx_bridge_rocketmq.hocon b/rel/i18n/emqx_bridge_rocketmq.hocon
index a2449c1a9..b6bb3aad6 100644
--- a/rel/i18n/emqx_bridge_rocketmq.hocon
+++ b/rel/i18n/emqx_bridge_rocketmq.hocon
@@ -41,4 +41,22 @@ template.desc:
 template.label:
 """Template"""
 
+action_parameters.desc:
+"""Action specific configuration."""
+
+action_parameters.label:
+"""Action"""
+
+rocketmq_action.desc:
+"""Configuration for RocketMQ Action"""
+
+rocketmq_action.label:
+"""RocketMQ Action Configuration"""
+
+config_connector.desc:
+"""Configuration for an RocketMQ Client."""
+
+config_connector.label:
+"""RocketMQ Client Configuration"""
+
 }

From cf22692c74753c4f09f6e5748f2dc1752717e1ca Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Thu, 8 Feb 2024 17:05:16 +0100
Subject: [PATCH 182/273] fix(emqx_channel): return Receive-Maximum in CONNACK
 when no error

---
 apps/emqx/src/emqx_channel.erl | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 4d6ed37e4..bb9c84e8c 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -2007,14 +2007,15 @@ merge_default_subopts(SubOpts) ->
 %%--------------------------------------------------------------------
 %% Enrich ConnAck Caps
 
-enrich_connack_caps(
-    AckProps,
-    ?IS_MQTT_V5 = #channel{
+enrich_connack_caps(AckProps, ?IS_MQTT_V5 = Channel) ->
+    #channel{
         clientinfo = #{
             zone := Zone
+        },
+        conninfo = #{
+            receive_maximum := ReceiveMaximum
         }
-    }
-) ->
+    } = Channel,
     #{
         max_packet_size := MaxPktSize,
         max_qos_allowed := MaxQoS,
@@ -2029,7 +2030,8 @@ enrich_connack_caps(
         'Topic-Alias-Maximum' => MaxAlias,
         'Wildcard-Subscription-Available' => flag(Wildcard),
         'Subscription-Identifier-Available' => 1,
-        'Shared-Subscription-Available' => flag(Shared)
+        'Shared-Subscription-Available' => flag(Shared),
+        'Receive-Maximum' => ReceiveMaximum
     },
     %% MQTT 5.0 - 3.2.2.3.4:
     %% It is a Protocol Error to include Maximum QoS more than once,

From 64367d834bfc90da2a2efbb187bcf25b699f7d91 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Thu, 8 Feb 2024 13:39:31 -0300
Subject: [PATCH 183/273] test(bridge_v2): actually check schema

---
 apps/emqx_bridge/test/emqx_bridge_v2_testlib.erl     | 12 +++++++-----
 .../test/emqx_bridge_azure_event_hub_v2_SUITE.erl    |  5 +----
 .../test/emqx_bridge_confluent_producer_SUITE.erl    |  5 +----
 .../test/emqx_bridge_iotdb_impl_SUITE.erl            |  3 ++-
 .../test/emqx_bridge_v2_mongodb_SUITE.erl            |  5 +----
 .../test/emqx_bridge_v2_pgsql_SUITE.erl              |  5 +----
 .../test/emqx_bridge_v2_redis_SUITE.erl              |  5 +----
 7 files changed, 14 insertions(+), 26 deletions(-)

diff --git a/apps/emqx_bridge/test/emqx_bridge_v2_testlib.erl b/apps/emqx_bridge/test/emqx_bridge_v2_testlib.erl
index 7fef33115..6e731cb80 100644
--- a/apps/emqx_bridge/test/emqx_bridge_v2_testlib.erl
+++ b/apps/emqx_bridge/test/emqx_bridge_v2_testlib.erl
@@ -119,11 +119,13 @@ delete_all_connectors() ->
     ).
 
 %% test helpers
-parse_and_check(BridgeType, BridgeName, ConfigString) ->
-    {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
-    hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
-    #{<<"bridges">> := #{BridgeType := #{BridgeName := BridgeConfig}}} = RawConf,
-    BridgeConfig.
+parse_and_check(Type, Name, InnerConfigMap0) ->
+    TypeBin = emqx_utils_conv:bin(Type),
+    RawConf = #{<<"actions">> => #{TypeBin => #{Name => InnerConfigMap0}}},
+    #{<<"actions">> := #{TypeBin := #{Name := InnerConfigMap}}} = hocon_tconf:check_plain(
+        emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}
+    ),
+    InnerConfigMap.
 
 bridge_id(Config) ->
     BridgeType = ?config(bridge_type, Config),
diff --git a/apps/emqx_bridge_azure_event_hub/test/emqx_bridge_azure_event_hub_v2_SUITE.erl b/apps/emqx_bridge_azure_event_hub/test/emqx_bridge_azure_event_hub_v2_SUITE.erl
index 9661004d0..0a3d75427 100644
--- a/apps/emqx_bridge_azure_event_hub/test/emqx_bridge_azure_event_hub_v2_SUITE.erl
+++ b/apps/emqx_bridge_azure_event_hub/test/emqx_bridge_azure_event_hub_v2_SUITE.erl
@@ -212,10 +212,7 @@ serde_roundtrip(InnerConfigMap0) ->
     InnerConfigMap.
 
 parse_and_check_bridge_config(InnerConfigMap, Name) ->
-    TypeBin = ?BRIDGE_TYPE_BIN,
-    RawConf = #{<<"bridges">> => #{TypeBin => #{Name => InnerConfigMap}}},
-    hocon_tconf:check_plain(emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}),
-    InnerConfigMap.
+    emqx_bridge_v2_testlib:parse_and_check(?BRIDGE_TYPE_BIN, Name, InnerConfigMap).
 
 shared_secret_path() ->
     os:getenv("CI_SHARED_SECRET_PATH", "/var/lib/secret").
diff --git a/apps/emqx_bridge_confluent/test/emqx_bridge_confluent_producer_SUITE.erl b/apps/emqx_bridge_confluent/test/emqx_bridge_confluent_producer_SUITE.erl
index 420da1275..f530749ac 100644
--- a/apps/emqx_bridge_confluent/test/emqx_bridge_confluent_producer_SUITE.erl
+++ b/apps/emqx_bridge_confluent/test/emqx_bridge_confluent_producer_SUITE.erl
@@ -212,10 +212,7 @@ serde_roundtrip(InnerConfigMap0) ->
     InnerConfigMap.
 
 parse_and_check_bridge_config(InnerConfigMap, Name) ->
-    TypeBin = ?ACTION_TYPE_BIN,
-    RawConf = #{<<"bridges">> => #{TypeBin => #{Name => InnerConfigMap}}},
-    hocon_tconf:check_plain(emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}),
-    InnerConfigMap.
+    emqx_bridge_v2_testlib:parse_and_check(?ACTION_TYPE_BIN, Name, InnerConfigMap).
 
 shared_secret_path() ->
     os:getenv("CI_SHARED_SECRET_PATH", "/var/lib/secret").
diff --git a/apps/emqx_bridge_iotdb/test/emqx_bridge_iotdb_impl_SUITE.erl b/apps/emqx_bridge_iotdb/test/emqx_bridge_iotdb_impl_SUITE.erl
index 1093993b2..b33370d45 100644
--- a/apps/emqx_bridge_iotdb/test/emqx_bridge_iotdb_impl_SUITE.erl
+++ b/apps/emqx_bridge_iotdb/test/emqx_bridge_iotdb_impl_SUITE.erl
@@ -165,7 +165,8 @@ bridge_config(TestCase, Config) ->
                 Version
             ]
         ),
-    {Name, ConfigString, emqx_bridge_v2_testlib:parse_and_check(Type, Name, ConfigString)}.
+    {ok, InnerConfigMap} = hocon:binary(ConfigString),
+    {Name, ConfigString, emqx_bridge_v2_testlib:parse_and_check(Type, Name, InnerConfigMap)}.
 
 make_iotdb_payload(DeviceId, Measurement, Type, Value) ->
     #{
diff --git a/apps/emqx_bridge_mongodb/test/emqx_bridge_v2_mongodb_SUITE.erl b/apps/emqx_bridge_mongodb/test/emqx_bridge_v2_mongodb_SUITE.erl
index 879b1d375..991d78ff1 100644
--- a/apps/emqx_bridge_mongodb/test/emqx_bridge_v2_mongodb_SUITE.erl
+++ b/apps/emqx_bridge_mongodb/test/emqx_bridge_v2_mongodb_SUITE.erl
@@ -197,10 +197,7 @@ serde_roundtrip(InnerConfigMap0) ->
     InnerConfigMap.
 
 parse_and_check_bridge_config(InnerConfigMap, Name) ->
-    TypeBin = ?BRIDGE_TYPE_BIN,
-    RawConf = #{<<"bridges">> => #{TypeBin => #{Name => InnerConfigMap}}},
-    hocon_tconf:check_plain(emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}),
-    InnerConfigMap.
+    emqx_bridge_v2_testlib:parse_and_check(?BRIDGE_TYPE_BIN, Name, InnerConfigMap).
 
 shared_secret_path() ->
     os:getenv("CI_SHARED_SECRET_PATH", "/var/lib/secret").
diff --git a/apps/emqx_bridge_pgsql/test/emqx_bridge_v2_pgsql_SUITE.erl b/apps/emqx_bridge_pgsql/test/emqx_bridge_v2_pgsql_SUITE.erl
index d077cece7..cf84bebab 100644
--- a/apps/emqx_bridge_pgsql/test/emqx_bridge_v2_pgsql_SUITE.erl
+++ b/apps/emqx_bridge_pgsql/test/emqx_bridge_v2_pgsql_SUITE.erl
@@ -193,10 +193,7 @@ serde_roundtrip(InnerConfigMap0) ->
     InnerConfigMap.
 
 parse_and_check_bridge_config(InnerConfigMap, Name) ->
-    TypeBin = ?BRIDGE_TYPE_BIN,
-    RawConf = #{<<"bridges">> => #{TypeBin => #{Name => InnerConfigMap}}},
-    hocon_tconf:check_plain(emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}),
-    InnerConfigMap.
+    emqx_bridge_v2_testlib:parse_and_check(?BRIDGE_TYPE_BIN, Name, InnerConfigMap).
 
 make_message() ->
     ClientId = emqx_guid:to_hexstr(emqx_guid:gen()),
diff --git a/apps/emqx_bridge_redis/test/emqx_bridge_v2_redis_SUITE.erl b/apps/emqx_bridge_redis/test/emqx_bridge_v2_redis_SUITE.erl
index 18cbc126d..cfcbc8e92 100644
--- a/apps/emqx_bridge_redis/test/emqx_bridge_v2_redis_SUITE.erl
+++ b/apps/emqx_bridge_redis/test/emqx_bridge_v2_redis_SUITE.erl
@@ -259,10 +259,7 @@ serde_roundtrip(InnerConfigMap0) ->
     InnerConfigMap.
 
 parse_and_check_bridge_config(InnerConfigMap, Name) ->
-    TypeBin = ?BRIDGE_TYPE_BIN,
-    RawConf = #{<<"bridges">> => #{TypeBin => #{Name => InnerConfigMap}}},
-    hocon_tconf:check_plain(emqx_bridge_v2_schema, RawConf, #{required => false, atom_key => false}),
-    InnerConfigMap.
+    emqx_bridge_v2_testlib:parse_and_check(?BRIDGE_TYPE_BIN, Name, InnerConfigMap).
 
 make_message() ->
     ClientId = emqx_guid:to_hexstr(emqx_guid:gen()),

From 511d1f732af21767a4066127eb9fbb246a18223b Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 8 Feb 2024 17:50:10 +0100
Subject: [PATCH 184/273] docs: add change log entry for RocketMQ bridge
 refactoring

---
 changes/ee/feat-12488.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12488.en.md

diff --git a/changes/ee/feat-12488.en.md b/changes/ee/feat-12488.en.md
new file mode 100644
index 000000000..3c2eed26f
--- /dev/null
+++ b/changes/ee/feat-12488.en.md
@@ -0,0 +1 @@
+The RocketMQ bridge has been split into connector and action components. Old RocketMQ bridges will be upgraded automatically.

From c9ee5addb4faea15ec35fb7c5a5dfc9fa3703a0c Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Thu, 8 Feb 2024 20:00:26 +0200
Subject: [PATCH 185/273] perf: upgrade mongodb-erlang to v3.0.23

Fixes: EMQX-11825
---
 apps/emqx_mongodb/rebar.config | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx_mongodb/rebar.config b/apps/emqx_mongodb/rebar.config
index 9cee51c35..b9390afc6 100644
--- a/apps/emqx_mongodb/rebar.config
+++ b/apps/emqx_mongodb/rebar.config
@@ -4,5 +4,5 @@
 {deps, [
     {emqx_connector, {path, "../../apps/emqx_connector"}},
     {emqx_resource, {path, "../../apps/emqx_resource"}},
-    {mongodb, {git, "https://github.com/emqx/mongodb-erlang", {tag, "v3.0.22"}}}
+    {mongodb, {git, "https://github.com/emqx/mongodb-erlang", {tag, "v3.0.23"}}}
 ]}.

From 1d9ce709f4eaf65b213d8279491b67bb5c7366b0 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Thu, 8 Feb 2024 20:05:24 +0200
Subject: [PATCH 186/273] perf: un-deprecate mongodb topology pool_size and set
 it to 10 by default

Benchmarks proved that it effects performance:
10 ecpool workers / 10 topology pool workers outperform
100 ecpool / 1 topology worker.

Fixes: EMQX-11825
---
 apps/emqx_mongodb/src/emqx_mongodb.erl | 22 +++-------------------
 changes/ee/perf-12494.en.md            |  3 +++
 2 files changed, 6 insertions(+), 19 deletions(-)
 create mode 100644 changes/ee/perf-12494.en.md

diff --git a/apps/emqx_mongodb/src/emqx_mongodb.erl b/apps/emqx_mongodb/src/emqx_mongodb.erl
index 2c246e506..e959804cc 100644
--- a/apps/emqx_mongodb/src/emqx_mongodb.erl
+++ b/apps/emqx_mongodb/src/emqx_mongodb.erl
@@ -131,8 +131,8 @@ fields(topology) ->
             hoconsc:mk(
                 pos_integer(),
                 #{
-                    deprecated => {since, "5.1.1"},
-                    importance => ?IMPORTANCE_HIDDEN
+                    importance => ?IMPORTANCE_HIDDEN,
+                    default => 10
                 }
             )},
         {max_overflow, fun max_overflow/1},
@@ -201,23 +201,7 @@ on_start(
             false ->
                 [{ssl, false}]
         end,
-    Topology0 = maps:get(topology, NConfig, #{}),
-    %% we fix this at 1 because we already have ecpool
-    case maps:get(pool_size, Topology0, 1) =:= 1 of
-        true ->
-            ok;
-        false ->
-            ?SLOG(
-                info,
-                #{
-                    msg => "mongodb_overriding_topology_pool_size",
-                    connector => InstId,
-                    reason => "this option is deprecated; please set `pool_size' for the connector",
-                    value => 1
-                }
-            )
-    end,
-    Topology = Topology0#{pool_size => 1},
+    Topology = maps:get(topology, NConfig, #{}),
     Opts = [
         {mongo_type, init_type(NConfig)},
         {hosts, Hosts},
diff --git a/changes/ee/perf-12494.en.md b/changes/ee/perf-12494.en.md
new file mode 100644
index 000000000..6c447caec
--- /dev/null
+++ b/changes/ee/perf-12494.en.md
@@ -0,0 +1,3 @@
+Improve MongoDB connector performance.
+
+- [mongodb-erlang PR](https://github.com/emqx/mongodb-erlang/pull/41)

From a5266f68ec8c874c57097c699fdebe559e378706 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 8 Feb 2024 22:08:30 +0100
Subject: [PATCH 187/273] feat(s3): switch schema to use secrets with loader
 support

This will make applications using `emqx_s3` follow the same
conventions as bridges and support loading secrets from files
at runtime.
---
 apps/emqx_s3/src/emqx_s3_schema.erl        | 19 ++-----------------
 apps/emqx_s3/test/emqx_s3_schema_SUITE.erl |  2 +-
 2 files changed, 3 insertions(+), 18 deletions(-)

diff --git a/apps/emqx_s3/src/emqx_s3_schema.erl b/apps/emqx_s3/src/emqx_s3_schema.erl
index 5478f6416..405212984 100644
--- a/apps/emqx_s3/src/emqx_s3_schema.erl
+++ b/apps/emqx_s3/src/emqx_s3_schema.erl
@@ -14,9 +14,6 @@
 -export([translate/1]).
 -export([translate/2]).
 
--type secret_access_key() :: string() | function().
--reflect_type([secret_access_key/0]).
-
 roots() ->
     [s3].
 
@@ -36,13 +33,9 @@ fields(s3) ->
                 }
             )},
         {secret_access_key,
-            mk(
-                typerefl:alias("string", secret_access_key()),
+            emqx_schema_secret:mk(
                 #{
-                    desc => ?DESC("secret_access_key"),
-                    required => false,
-                    sensitive => true,
-                    converter => fun secret/2
+                    desc => ?DESC("secret_access_key")
                 }
             )},
         {bucket,
@@ -148,14 +141,6 @@ desc(s3) ->
 desc(transport_options) ->
     "Options for the HTTP transport layer used by the S3 client".
 
-secret(undefined, #{}) ->
-    undefined;
-secret(Secret, #{make_serializable := true}) ->
-    unicode:characters_to_binary(emqx_secret:unwrap(Secret));
-secret(Secret, #{}) ->
-    _ = is_binary(Secret) orelse throw({expected_type, string}),
-    emqx_secret:wrap(unicode:characters_to_list(Secret)).
-
 translate(Conf) ->
     translate(Conf, #{}).
 
diff --git a/apps/emqx_s3/test/emqx_s3_schema_SUITE.erl b/apps/emqx_s3/test/emqx_s3_schema_SUITE.erl
index ad887d1a6..323dd05c2 100644
--- a/apps/emqx_s3/test/emqx_s3_schema_SUITE.erl
+++ b/apps/emqx_s3/test/emqx_s3_schema_SUITE.erl
@@ -132,7 +132,7 @@ t_sensitive_config_no_leak(_Config) ->
             Error = #{
                 kind := validation_error,
                 path := "s3.secret_access_key",
-                reason := {expected_type, string}
+                reason := invalid_type
             }
         ]} when map_size(Error) == 3,
         emqx_s3_schema:translate(

From a74c828e193060f8a9b7ffac736297be2072e92a Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 9 Feb 2024 10:42:48 +0100
Subject: [PATCH 188/273] test: add test case to cover Receive-Maximum in
 CONNACK

---
 apps/emqx/test/emqx_client_SUITE.erl | 29 +++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/apps/emqx/test/emqx_client_SUITE.erl b/apps/emqx/test/emqx_client_SUITE.erl
index bb4ef0826..3e5babd2e 100644
--- a/apps/emqx/test/emqx_client_SUITE.erl
+++ b/apps/emqx/test/emqx_client_SUITE.erl
@@ -72,7 +72,7 @@ groups() ->
             t_dollar_topics,
             t_sub_non_utf8_topic
         ]},
-        {mqttv5, [non_parallel_tests], [t_basic_with_props_v5]},
+        {mqttv5, [non_parallel_tests], [t_basic_with_props_v5, t_v5_receive_maximim_in_connack]},
         {others, [non_parallel_tests], [
             t_username_as_clientid,
             t_certcn_as_clientid_default_config_tls,
@@ -103,14 +103,14 @@ end_per_testcase(_Case, _Config) ->
 %%--------------------------------------------------------------------
 
 t_basic_v3(_) ->
-    t_basic([{proto_ver, v3}]).
+    run_basic([{proto_ver, v3}]).
 
 %%--------------------------------------------------------------------
 %% Test cases for MQTT v4
 %%--------------------------------------------------------------------
 
 t_basic_v4(_Config) ->
-    t_basic([{proto_ver, v4}]).
+    run_basic([{proto_ver, v4}]).
 
 t_cm(_) ->
     emqx_config:put_zone_conf(default, [mqtt, idle_timeout], 1000),
@@ -335,19 +335,30 @@ t_sub_non_utf8_topic(_) ->
 %% Test cases for MQTT v5
 %%--------------------------------------------------------------------
 
-t_basic_with_props_v5(_) ->
-    t_basic([
+v5_conn_props(ReceiveMaximum) ->
+    [
         {proto_ver, v5},
-        {properties, #{'Receive-Maximum' => 4}}
-    ]).
+        {properties, #{'Receive-Maximum' => ReceiveMaximum}}
+    ].
+
+t_basic_with_props_v5(_) ->
+    run_basic(v5_conn_props(4)).
+
+t_v5_receive_maximim_in_connack(_) ->
+    ReceiveMaximum = 7,
+    {ok, C} = emqtt:start_link(v5_conn_props(ReceiveMaximum)),
+    {ok, Props} = emqtt:connect(C),
+    ?assertMatch(#{'Receive-Maximum' := ReceiveMaximum}, Props),
+    ok = emqtt:disconnect(C),
+    ok.
 
 %%--------------------------------------------------------------------
 %% General test cases.
 %%--------------------------------------------------------------------
 
-t_basic(_Opts) ->
+run_basic(Opts) ->
     Topic = nth(1, ?TOPICS),
-    {ok, C} = emqtt:start_link([{proto_ver, v4}]),
+    {ok, C} = emqtt:start_link(Opts),
     {ok, _} = emqtt:connect(C),
     {ok, _, [1]} = emqtt:subscribe(C, Topic, qos1),
     {ok, _, [2]} = emqtt:subscribe(C, Topic, qos2),

From cd3cc41f9010c16d327abae9aa5bf3c5f11f852d Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 9 Feb 2024 10:49:51 +0100
Subject: [PATCH 189/273] docs: add change log for PR #12492

---
 changes/ce/fix-12492.en.md | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 changes/ce/fix-12492.en.md

diff --git a/changes/ce/fix-12492.en.md b/changes/ce/fix-12492.en.md
new file mode 100644
index 000000000..30a7b1399
--- /dev/null
+++ b/changes/ce/fix-12492.en.md
@@ -0,0 +1,4 @@
+Return `Receive-Maximum` in `CONNACK` for MQTT v5 clients.
+
+EMQX takes the min value of client's `Receive-Maximum` and server's `max_inflight` config as the max number of inflight (unacknowledged) messages allowed.
+Prior to this fix, the value was not sent back to the client in `CONNACK` message.

From 4ff04ab1f34666033f37612a3f04cbfbf54fff4f Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 8 Feb 2024 22:18:12 +0100
Subject: [PATCH 190/273] feat(s3): separate concepts to make app reusable in
 bridges

---
 .../src/emqx_ft_storage_exporter_s3.erl       | 34 +++----
 apps/emqx_s3/src/emqx_s3.erl                  | 13 +--
 apps/emqx_s3/src/emqx_s3_client.erl           | 67 ++++++++------
 apps/emqx_s3/src/emqx_s3_profile_conf.erl     | 34 +++++--
 .../src/emqx_s3_profile_uploader_sup.erl      |  8 +-
 apps/emqx_s3/src/emqx_s3_schema.erl           | 92 ++++++++++++-------
 apps/emqx_s3/src/emqx_s3_uploader.erl         | 67 +++++++-------
 apps/emqx_s3/test/emqx_s3_client_SUITE.erl    | 20 ++--
 .../test/emqx_s3_profile_conf_SUITE.erl       |  4 +-
 apps/emqx_s3/test/emqx_s3_uploader_SUITE.erl  | 34 +++----
 10 files changed, 213 insertions(+), 160 deletions(-)

diff --git a/apps/emqx_ft/src/emqx_ft_storage_exporter_s3.erl b/apps/emqx_ft/src/emqx_ft_storage_exporter_s3.erl
index 844896a2f..ad061ca0f 100644
--- a/apps/emqx_ft/src/emqx_ft_storage_exporter_s3.erl
+++ b/apps/emqx_ft/src/emqx_ft_storage_exporter_s3.erl
@@ -69,11 +69,9 @@
 -spec start_export(options(), transfer(), filemeta()) ->
     {ok, export_st()} | {error, term()}.
 start_export(_Options, Transfer, Filemeta) ->
-    Options = #{
-        key => s3_key(Transfer, Filemeta),
-        headers => s3_headers(Transfer, Filemeta)
-    },
-    case emqx_s3:start_uploader(?S3_PROFILE_ID, Options) of
+    Key = s3_key(Transfer, Filemeta),
+    UploadOpts = #{headers => s3_headers(Transfer, Filemeta)},
+    case emqx_s3:start_uploader(?S3_PROFILE_ID, Key, UploadOpts) of
         {ok, Pid} ->
             true = erlang:link(Pid),
             {ok, #{filemeta => Filemeta, pid => Pid}};
@@ -180,22 +178,24 @@ list_pages(Client, Marker, Limit, Acc) ->
     ListOptions = [{marker, Marker} || Marker =/= undefined],
     case list_key_info(Client, [{max_keys, MaxKeys} | ListOptions]) of
         {ok, {Exports, NextMarker}} ->
-            list_accumulate(Client, Limit, NextMarker, [Exports | Acc]);
+            Left = update_limit(Limit, Exports),
+            NextAcc = [Exports | Acc],
+            case NextMarker of
+                undefined ->
+                    {ok, {flatten_pages(NextAcc), undefined}};
+                _ when Left =< 0 ->
+                    {ok, {flatten_pages(NextAcc), NextMarker}};
+                _ ->
+                    list_pages(Client, NextMarker, Left, NextAcc)
+            end;
         {error, _Reason} = Error ->
             Error
     end.
 
-list_accumulate(_Client, _Limit, undefined, Acc) ->
-    {ok, {flatten_pages(Acc), undefined}};
-list_accumulate(Client, undefined, Marker, Acc) ->
-    list_pages(Client, Marker, undefined, Acc);
-list_accumulate(Client, Limit, Marker, Acc = [Exports | _]) ->
-    case Limit - length(Exports) of
-        0 ->
-            {ok, {flatten_pages(Acc), Marker}};
-        Left ->
-            list_pages(Client, Marker, Left, Acc)
-    end.
+update_limit(undefined, _Exports) ->
+    undefined;
+update_limit(Limit, Exports) ->
+    Limit - length(Exports).
 
 flatten_pages(Pages) ->
     lists:append(lists:reverse(Pages)).
diff --git a/apps/emqx_s3/src/emqx_s3.erl b/apps/emqx_s3/src/emqx_s3.erl
index 87996e2fc..b499fbfd1 100644
--- a/apps/emqx_s3/src/emqx_s3.erl
+++ b/apps/emqx_s3/src/emqx_s3.erl
@@ -10,7 +10,7 @@
     start_profile/2,
     stop_profile/1,
     update_profile/2,
-    start_uploader/2,
+    start_uploader/3,
     with_client/2
 ]).
 
@@ -22,6 +22,7 @@
 -export_type([
     profile_id/0,
     profile_config/0,
+    transport_options/0,
     acl/0
 ]).
 
@@ -81,18 +82,18 @@ stop_profile(ProfileId) when ?IS_PROFILE_ID(ProfileId) ->
 update_profile(ProfileId, ProfileConfig) when ?IS_PROFILE_ID(ProfileId) ->
     emqx_s3_profile_conf:update_config(ProfileId, ProfileConfig).
 
--spec start_uploader(profile_id(), emqx_s3_uploader:opts()) ->
+-spec start_uploader(profile_id(), emqx_s3_client:key(), emqx_s3_client:upload_options()) ->
     emqx_types:startlink_ret() | {error, profile_not_found}.
-start_uploader(ProfileId, Opts) when ?IS_PROFILE_ID(ProfileId) ->
-    emqx_s3_profile_uploader_sup:start_uploader(ProfileId, Opts).
+start_uploader(ProfileId, Key, Props) when ?IS_PROFILE_ID(ProfileId) ->
+    emqx_s3_profile_uploader_sup:start_uploader(ProfileId, Key, Props).
 
 -spec with_client(profile_id(), fun((emqx_s3_client:client()) -> Result)) ->
     {error, profile_not_found} | Result.
 with_client(ProfileId, Fun) when is_function(Fun, 1) andalso ?IS_PROFILE_ID(ProfileId) ->
     case emqx_s3_profile_conf:checkout_config(ProfileId) of
-        {ok, ClientConfig, _UploadConfig} ->
+        {Bucket, ClientConfig, _UploadOpts, _UploadConfig} ->
             try
-                Fun(emqx_s3_client:create(ClientConfig))
+                Fun(emqx_s3_client:create(Bucket, ClientConfig))
             after
                 emqx_s3_profile_conf:checkin_config(ProfileId)
             end;
diff --git a/apps/emqx_s3/src/emqx_s3_client.erl b/apps/emqx_s3/src/emqx_s3_client.erl
index fe0058433..202ff5218 100644
--- a/apps/emqx_s3/src/emqx_s3_client.erl
+++ b/apps/emqx_s3/src/emqx_s3_client.erl
@@ -9,12 +9,11 @@
 -include_lib("erlcloud/include/erlcloud_aws.hrl").
 
 -export([
-    create/1,
+    create/2,
 
     put_object/3,
     put_object/4,
 
-    start_multipart/2,
     start_multipart/3,
     upload_part/5,
     complete_multipart/4,
@@ -26,10 +25,15 @@
     format_request/1
 ]).
 
+%% For connectors
+-export([aws_config/1]).
+
 -export_type([
     client/0,
     headers/0,
+    bucket/0,
     key/0,
+    upload_options/0,
     upload_id/0,
     etag/0,
     part_number/0,
@@ -39,18 +43,17 @@
 -type headers() :: #{binary() | string() => iodata()}.
 -type erlcloud_headers() :: list({string(), iodata()}).
 
+-type bucket() :: string().
 -type key() :: string().
 -type part_number() :: non_neg_integer().
 -type upload_id() :: string().
 -type etag() :: string().
 -type http_pool() :: ehttpc:pool_name().
 -type pool_type() :: random | hash.
--type upload_options() :: list({acl, emqx_s3:acl()}).
 
 -opaque client() :: #{
     aws_config := aws_config(),
-    upload_options := upload_options(),
-    bucket := string(),
+    bucket := bucket(),
     headers := erlcloud_headers(),
     url_expire_time := non_neg_integer(),
     pool_type := pool_type()
@@ -60,9 +63,7 @@
     scheme := string(),
     host := string(),
     port := part_number(),
-    bucket := string(),
     headers := headers(),
-    acl := emqx_s3:acl() | undefined,
     url_expire_time := pos_integer(),
     access_key_id := string() | undefined,
     secret_access_key := emqx_secret:t(string()) | undefined,
@@ -72,6 +73,11 @@
     max_retries := non_neg_integer() | undefined
 }.
 
+-type upload_options() :: #{
+    acl => emqx_s3:acl() | undefined,
+    headers => headers()
+}.
+
 -type s3_options() :: proplists:proplist().
 
 -define(DEFAULT_REQUEST_TIMEOUT, 30000).
@@ -81,12 +87,11 @@
 %% API
 %%--------------------------------------------------------------------
 
--spec create(config()) -> client().
-create(Config) ->
+-spec create(bucket(), config()) -> client().
+create(Bucket, Config) ->
     #{
         aws_config => aws_config(Config),
-        upload_options => upload_options(Config),
-        bucket => maps:get(bucket, Config),
+        bucket => Bucket,
         url_expire_time => maps:get(url_expire_time, Config),
         headers => headers(Config),
         pool_type => maps:get(pool_type, Config)
@@ -94,17 +99,19 @@ create(Config) ->
 
 -spec put_object(client(), key(), iodata()) -> ok_or_error(term()).
 put_object(Client, Key, Value) ->
-    put_object(Client, #{}, Key, Value).
+    put_object(Client, Key, #{}, Value).
 
--spec put_object(client(), headers(), key(), iodata()) -> ok_or_error(term()).
+-spec put_object(client(), key(), upload_options(), iodata()) -> ok_or_error(term()).
 put_object(
-    #{bucket := Bucket, upload_options := Options, headers := Headers, aws_config := AwsConfig},
-    SpecialHeaders,
+    #{bucket := Bucket, headers := BaseHeaders, aws_config := AwsConfig},
     Key,
-    Value
+    UploadOpts,
+    Content
 ) ->
-    AllHeaders = join_headers(Headers, SpecialHeaders),
-    try erlcloud_s3:put_object(Bucket, erlcloud_key(Key), Value, Options, AllHeaders, AwsConfig) of
+    ECKey = erlcloud_key(Key),
+    ECOpts = erlcloud_upload_options(UploadOpts),
+    Headers = join_headers(BaseHeaders, maps:get(headers, UploadOpts, undefined)),
+    try erlcloud_s3:put_object(Bucket, ECKey, Content, ECOpts, Headers, AwsConfig) of
         Props when is_list(Props) ->
             ok
     catch
@@ -113,18 +120,16 @@ put_object(
             {error, Reason}
     end.
 
--spec start_multipart(client(), key()) -> ok_or_error(upload_id(), term()).
-start_multipart(Client, Key) ->
-    start_multipart(Client, #{}, Key).
-
--spec start_multipart(client(), headers(), key()) -> ok_or_error(upload_id(), term()).
+-spec start_multipart(client(), key(), upload_options()) -> ok_or_error(upload_id(), term()).
 start_multipart(
-    #{bucket := Bucket, upload_options := Options, headers := Headers, aws_config := AwsConfig},
-    SpecialHeaders,
-    Key
+    #{bucket := Bucket, headers := BaseHeaders, aws_config := AwsConfig},
+    Key,
+    UploadOpts
 ) ->
-    AllHeaders = join_headers(Headers, SpecialHeaders),
-    case erlcloud_s3:start_multipart(Bucket, erlcloud_key(Key), Options, AllHeaders, AwsConfig) of
+    ECKey = erlcloud_key(Key),
+    ECOpts = erlcloud_upload_options(UploadOpts),
+    Headers = join_headers(BaseHeaders, maps:get(headers, UploadOpts, undefined)),
+    case erlcloud_s3:start_multipart(Bucket, ECKey, ECOpts, Headers, AwsConfig) of
         {ok, Props} ->
             {ok, response_property('uploadId', Props)};
         {error, Reason} ->
@@ -204,11 +209,11 @@ format(#{aws_config := AwsConfig} = Client) ->
 %% Internal functions
 %%--------------------------------------------------------------------
 
-upload_options(#{acl := Acl}) when Acl =/= undefined ->
+erlcloud_upload_options(#{acl := Acl}) when Acl =/= undefined ->
     [
         {acl, Acl}
     ];
-upload_options(#{}) ->
+erlcloud_upload_options(#{}) ->
     [].
 
 headers(#{headers := Headers}) ->
@@ -401,6 +406,8 @@ headers_ehttpc_to_erlcloud_response(EhttpcHeaders) ->
 headers_erlcloud_request_to_ehttpc(ErlcloudHeaders) ->
     [{to_binary(K), V} || {K, V} <- ErlcloudHeaders].
 
+join_headers(ErlcloudHeaders, undefined) ->
+    ErlcloudHeaders;
 join_headers(ErlcloudHeaders, UserSpecialHeaders) ->
     ErlcloudHeaders ++ headers_user_to_erlcloud_request(UserSpecialHeaders).
 
diff --git a/apps/emqx_s3/src/emqx_s3_profile_conf.erl b/apps/emqx_s3/src/emqx_s3_profile_conf.erl
index a449640a6..49c531777 100644
--- a/apps/emqx_s3/src/emqx_s3_profile_conf.erl
+++ b/apps/emqx_s3/src/emqx_s3_profile_conf.erl
@@ -37,13 +37,25 @@
     code_change/3
 ]).
 
-%% For test purposes
+%% For connectors
 -export([
     client_config/2,
+    http_config/1
+]).
+
+%% For test purposes
+-export([
     start_http_pool/2,
     id/1
 ]).
 
+-type config_checkout() :: {
+    emqx_s3_client:bucket(),
+    emqx_s3_client:config(),
+    emqx_s3_client:upload_options(),
+    emqx_s3_uploader:config()
+}.
+
 -define(DEFAULT_CALL_TIMEOUT, 5000).
 
 -define(DEFAULT_HTTP_POOL_TIMEOUT, 60000).
@@ -78,12 +90,12 @@ update_config(ProfileId, ProfileConfig, Timeout) ->
     ?SAFE_CALL_VIA_GPROC(ProfileId, {update_config, ProfileConfig}, Timeout).
 
 -spec checkout_config(emqx_s3:profile_id()) ->
-    {ok, emqx_s3_client:config(), emqx_s3_uploader:config()} | {error, profile_not_found}.
+    config_checkout() | {error, profile_not_found}.
 checkout_config(ProfileId) ->
     checkout_config(ProfileId, ?DEFAULT_CALL_TIMEOUT).
 
 -spec checkout_config(emqx_s3:profile_id(), timeout()) ->
-    {ok, emqx_s3_client:config(), emqx_s3_uploader:config()} | {error, profile_not_found}.
+    config_checkout() | {error, profile_not_found}.
 checkout_config(ProfileId, Timeout) ->
     ?SAFE_CALL_VIA_GPROC(ProfileId, {checkout_config, self()}, Timeout).
 
@@ -108,6 +120,8 @@ init([ProfileId, ProfileConfig]) ->
             {ok, #{
                 profile_id => ProfileId,
                 profile_config => ProfileConfig,
+                bucket => bucket(ProfileConfig),
+                upload_options => upload_options(ProfileConfig),
                 client_config => client_config(ProfileConfig, PoolName),
                 uploader_config => uploader_config(ProfileConfig),
                 pool_name => PoolName,
@@ -128,12 +142,14 @@ handle_call(
     {checkout_config, Pid},
     _From,
     #{
+        bucket := Bucket,
+        upload_options := Options,
         client_config := ClientConfig,
         uploader_config := UploaderConfig
     } = State
 ) ->
     ok = register_client(Pid, State),
-    {reply, {ok, ClientConfig, UploaderConfig}, State};
+    {reply, {Bucket, ClientConfig, Options, UploaderConfig}, State};
 handle_call({checkin_config, Pid}, _From, State) ->
     ok = unregister_client(Pid, State),
     {reply, ok, State};
@@ -146,6 +162,8 @@ handle_call(
         {ok, PoolName} ->
             NewState = State#{
                 profile_config => NewProfileConfig,
+                bucket => bucket(NewProfileConfig),
+                upload_options => upload_options(NewProfileConfig),
                 client_config => client_config(NewProfileConfig, PoolName),
                 uploader_config => uploader_config(NewProfileConfig),
                 http_pool_timeout => http_pool_timeout(NewProfileConfig),
@@ -198,8 +216,6 @@ client_config(ProfileConfig, PoolName) ->
         port => maps:get(port, ProfileConfig),
         url_expire_time => maps:get(url_expire_time, ProfileConfig),
         headers => maps:get(headers, HTTPOpts, #{}),
-        acl => maps:get(acl, ProfileConfig, undefined),
-        bucket => maps:get(bucket, ProfileConfig),
         access_key_id => maps:get(access_key_id, ProfileConfig, undefined),
         secret_access_key => maps:get(secret_access_key, ProfileConfig, undefined),
         request_timeout => maps:get(request_timeout, HTTPOpts, undefined),
@@ -214,6 +230,12 @@ uploader_config(#{max_part_size := MaxPartSize, min_part_size := MinPartSize} =
         max_part_size => MaxPartSize
     }.
 
+bucket(ProfileConfig) ->
+    maps:get(bucket, ProfileConfig).
+
+upload_options(ProfileConfig) ->
+    #{acl => maps:get(acl, ProfileConfig, undefined)}.
+
 scheme(#{ssl := #{enable := true}}) -> "https://";
 scheme(_TransportOpts) -> "http://".
 
diff --git a/apps/emqx_s3/src/emqx_s3_profile_uploader_sup.erl b/apps/emqx_s3/src/emqx_s3_profile_uploader_sup.erl
index 67a36a793..aea8334e8 100644
--- a/apps/emqx_s3/src/emqx_s3_profile_uploader_sup.erl
+++ b/apps/emqx_s3/src/emqx_s3_profile_uploader_sup.erl
@@ -15,7 +15,7 @@
     start_link/1,
     child_spec/1,
     id/1,
-    start_uploader/2
+    start_uploader/3
 ]).
 
 -export([init/1]).
@@ -43,10 +43,10 @@ child_spec(ProfileId) ->
 id(ProfileId) ->
     {?MODULE, ProfileId}.
 
--spec start_uploader(emqx_s3:profile_id(), emqx_s3_uploader:opts()) ->
+-spec start_uploader(emqx_s3:profile_id(), emqx_s3_client:key(), emqx_s3_client:upload_options()) ->
     emqx_types:startlink_ret() | {error, profile_not_found}.
-start_uploader(ProfileId, Opts) ->
-    try supervisor:start_child(?VIA_GPROC(id(ProfileId)), [Opts]) of
+start_uploader(ProfileId, Key, UploadOpts) ->
+    try supervisor:start_child(?VIA_GPROC(id(ProfileId)), [Key, UploadOpts]) of
         Result -> Result
     catch
         exit:{noproc, _} -> {error, profile_not_found}
diff --git a/apps/emqx_s3/src/emqx_s3_schema.erl b/apps/emqx_s3/src/emqx_s3_schema.erl
index 405212984..ed818af69 100644
--- a/apps/emqx_s3/src/emqx_s3_schema.erl
+++ b/apps/emqx_s3/src/emqx_s3_schema.erl
@@ -23,6 +23,13 @@ tags() ->
     [<<"S3">>].
 
 fields(s3) ->
+    lists:append([
+        fields(s3_client),
+        fields(s3_uploader),
+        fields(s3_url_options),
+        props_with([bucket, acl], fields(s3_upload))
+    ]);
+fields(s3_client) ->
     [
         {access_key_id,
             mk(
@@ -38,14 +45,6 @@ fields(s3) ->
                     desc => ?DESC("secret_access_key")
                 }
             )},
-        {bucket,
-            mk(
-                string(),
-                #{
-                    desc => ?DESC("bucket"),
-                    required => true
-                }
-            )},
         {host,
             mk(
                 string(),
@@ -62,16 +61,51 @@ fields(s3) ->
                     required => true
                 }
             )},
-        {url_expire_time,
+        {transport_options,
             mk(
-                %% not used in a `receive ... after' block, just timestamp comparison
-                emqx_schema:duration_s(),
+                ref(?MODULE, transport_options),
                 #{
-                    default => <<"1h">>,
-                    desc => ?DESC("url_expire_time"),
+                    desc => ?DESC("transport_options"),
                     required => false
                 }
+            )}
+    ];
+fields(s3_upload) ->
+    [
+        {bucket,
+            mk(
+                string(),
+                #{
+                    desc => ?DESC("bucket"),
+                    required => true
+                }
             )},
+        {key,
+            mk(
+                string(),
+                #{
+                    desc => ?DESC("key"),
+                    required => true
+                }
+            )},
+        {acl,
+            mk(
+                hoconsc:enum([
+                    private,
+                    public_read,
+                    public_read_write,
+                    authenticated_read,
+                    bucket_owner_read,
+                    bucket_owner_full_control
+                ]),
+                #{
+                    desc => ?DESC("acl"),
+                    required => false
+                }
+            )}
+    ];
+fields(s3_uploader) ->
+    [
         {min_part_size,
             mk(
                 emqx_schema:bytesize(),
@@ -91,27 +125,17 @@ fields(s3) ->
                     required => true,
                     validator => fun part_size_validator/1
                 }
-            )},
-        {acl,
+            )}
+    ];
+fields(s3_url_options) ->
+    [
+        {url_expire_time,
             mk(
-                hoconsc:enum([
-                    private,
-                    public_read,
-                    public_read_write,
-                    authenticated_read,
-                    bucket_owner_read,
-                    bucket_owner_full_control
-                ]),
+                %% not used in a `receive ... after' block, just timestamp comparison
+                emqx_schema:duration_s(),
                 #{
-                    desc => ?DESC("acl"),
-                    required => false
-                }
-            )},
-        {transport_options,
-            mk(
-                ref(?MODULE, transport_options),
-                #{
-                    desc => ?DESC("transport_options"),
+                    default => <<"1h">>,
+                    desc => ?DESC("url_expire_time"),
                     required => false
                 }
             )}
@@ -138,6 +162,10 @@ fields(transport_options) ->
 
 desc(s3) ->
     "S3 connection options";
+desc(s3_client) ->
+    "S3 connection options";
+desc(s3_upload) ->
+    "S3 upload options";
 desc(transport_options) ->
     "Options for the HTTP transport layer used by the S3 client".
 
diff --git a/apps/emqx_s3/src/emqx_s3_uploader.erl b/apps/emqx_s3/src/emqx_s3_uploader.erl
index 548eaf8c6..50736fe7c 100644
--- a/apps/emqx_s3/src/emqx_s3_uploader.erl
+++ b/apps/emqx_s3/src/emqx_s3_uploader.erl
@@ -9,7 +9,7 @@
 -behaviour(gen_statem).
 
 -export([
-    start_link/2,
+    start_link/3,
 
     write/2,
     write/3,
@@ -33,30 +33,25 @@
     format_status/2
 ]).
 
--export_type([opts/0, config/0]).
+-export_type([config/0]).
 
 -type config() :: #{
     min_part_size => pos_integer(),
     max_part_size => pos_integer()
 }.
 
--type opts() :: #{
-    key := string(),
-    headers => emqx_s3_client:headers()
-}.
-
 -type data() :: #{
-    profile_id := emqx_s3:profile_id(),
+    profile_id => emqx_s3:profile_id(),
     client := emqx_s3_client:client(),
     key := emqx_s3_client:key(),
+    upload_opts := emqx_s3_client:upload_options(),
     buffer := iodata(),
     buffer_size := non_neg_integer(),
     min_part_size := pos_integer(),
     max_part_size := pos_integer(),
     upload_id := undefined | emqx_s3_client:upload_id(),
     etags := [emqx_s3_client:etag()],
-    part_number := emqx_s3_client:part_number(),
-    headers := emqx_s3_client:headers()
+    part_number := emqx_s3_client:part_number()
 }.
 
 %% 5MB
@@ -66,9 +61,10 @@
 
 -define(DEFAULT_TIMEOUT, 30000).
 
--spec start_link(emqx_s3:profile_id(), opts()) -> gen_statem:start_ret().
-start_link(ProfileId, #{key := Key} = Opts) when is_list(Key) ->
-    gen_statem:start_link(?MODULE, [ProfileId, Opts], []).
+-spec start_link(emqx_s3:profile_id(), emqx_s3_client:key(), emqx_s3_client:upload_options()) ->
+    gen_statem:start_ret().
+start_link(ProfileId, Key, UploadOpts) when is_list(Key) ->
+    gen_statem:start_link(?MODULE, {profile, ProfileId, Key, UploadOpts}, []).
 
 -spec write(pid(), iodata()) -> ok_or_error(term()).
 write(Pid, WriteData) ->
@@ -105,19 +101,23 @@ shutdown(Pid) ->
 
 callback_mode() -> handle_event_function.
 
-init([ProfileId, #{key := Key} = Opts]) ->
-    process_flag(trap_exit, true),
-    {ok, ClientConfig, UploaderConfig} = emqx_s3_profile_conf:checkout_config(ProfileId),
-    Client = client(ClientConfig),
-    {ok, upload_not_started, #{
+init({profile, ProfileId, Key, UploadOpts}) ->
+    {Bucket, ClientConfig, BaseOpts, UploaderConfig} =
+        emqx_s3_profile_conf:checkout_config(ProfileId),
+    Upload = #{
         profile_id => ProfileId,
-        client => Client,
-        headers => maps:get(headers, Opts, #{}),
+        client => client(Bucket, ClientConfig),
         key => Key,
+        upload_opts => maps:merge(BaseOpts, UploadOpts)
+    },
+    init({upload, UploaderConfig, Upload});
+init({upload, Config, Upload}) ->
+    process_flag(trap_exit, true),
+    {ok, upload_not_started, Upload#{
         buffer => [],
         buffer_size => 0,
-        min_part_size => maps:get(min_part_size, UploaderConfig, ?DEFAULT_MIN_PART_SIZE),
-        max_part_size => maps:get(max_part_size, UploaderConfig, ?DEFAULT_MAX_PART_SIZE),
+        min_part_size => maps:get(min_part_size, Config, ?DEFAULT_MIN_PART_SIZE),
+        max_part_size => maps:get(max_part_size, Config, ?DEFAULT_MAX_PART_SIZE),
         upload_id => undefined,
         etags => [],
         part_number => 1
@@ -221,8 +221,8 @@ maybe_start_upload(#{buffer_size := BufferSize, min_part_size := MinPartSize} =
     end.
 
 -spec start_upload(data()) -> {started, data()} | {error, term()}.
-start_upload(#{client := Client, key := Key, headers := Headers} = Data) ->
-    case emqx_s3_client:start_multipart(Client, Headers, Key) of
+start_upload(#{client := Client, key := Key, upload_opts := UploadOpts} = Data) ->
+    case emqx_s3_client:start_multipart(Client, Key, UploadOpts) of
         {ok, UploadId} ->
             NewData = Data#{upload_id => UploadId},
             {started, NewData};
@@ -274,12 +274,9 @@ complete_upload(
     } = Data0
 ) ->
     case upload_part(Data0) of
-        {ok, #{etags := ETags} = Data1} ->
-            case
-                emqx_s3_client:complete_multipart(
-                    Client, Key, UploadId, lists:reverse(ETags)
-                )
-            of
+        {ok, #{etags := ETagsRev} = Data1} ->
+            ETags = lists:reverse(ETagsRev),
+            case emqx_s3_client:complete_multipart(Client, Key, UploadId, ETags) of
                 ok ->
                     {ok, Data1};
                 {error, _} = Error ->
@@ -309,11 +306,11 @@ put_object(
     #{
         client := Client,
         key := Key,
-        buffer := Buffer,
-        headers := Headers
+        upload_opts := UploadOpts,
+        buffer := Buffer
     }
 ) ->
-    case emqx_s3_client:put_object(Client, Headers, Key, Buffer) of
+    case emqx_s3_client:put_object(Client, Key, UploadOpts, Buffer) of
         ok ->
             ok;
         {error, _} = Error ->
@@ -337,5 +334,5 @@ unwrap(WrappedData) ->
 is_valid_part(WriteData, #{max_part_size := MaxPartSize, buffer_size := BufferSize}) ->
     BufferSize + iolist_size(WriteData) =< MaxPartSize.
 
-client(Config) ->
-    emqx_s3_client:create(Config).
+client(Bucket, Config) ->
+    emqx_s3_client:create(Bucket, Config).
diff --git a/apps/emqx_s3/test/emqx_s3_client_SUITE.erl b/apps/emqx_s3/test/emqx_s3_client_SUITE.erl
index 4db6245eb..619a09e76 100644
--- a/apps/emqx_s3/test/emqx_s3_client_SUITE.erl
+++ b/apps/emqx_s3/test/emqx_s3_client_SUITE.erl
@@ -79,7 +79,7 @@ t_multipart_upload(Config) ->
 
     Client = client(Config),
 
-    {ok, UploadId} = emqx_s3_client:start_multipart(Client, Key),
+    {ok, UploadId} = emqx_s3_client:start_multipart(Client, Key, #{}),
 
     Data = data(6_000_000),
 
@@ -97,7 +97,7 @@ t_simple_put(Config) ->
 
     Data = data(6_000_000),
 
-    ok = emqx_s3_client:put_object(Client, Key, Data).
+    ok = emqx_s3_client:put_object(Client, Key, #{acl => private}, Data).
 
 t_list(Config) ->
     Key = ?config(key, Config),
@@ -123,7 +123,7 @@ t_url(Config) ->
     Key = ?config(key, Config),
 
     Client = client(Config),
-    ok = emqx_s3_client:put_object(Client, Key, <<"data">>),
+    ok = emqx_s3_client:put_object(Client, Key, #{acl => public_read}, <<"data">>),
 
     Url = emqx_s3_client:uri(Client, Key),
 
@@ -135,20 +135,18 @@ t_url(Config) ->
 t_no_acl(Config) ->
     Key = ?config(key, Config),
 
-    ClientConfig = emqx_s3_profile_conf:client_config(
-        profile_config(Config), ?config(ehttpc_pool_name, Config)
-    ),
-    Client = emqx_s3_client:create(maps:without([acl], ClientConfig)),
+    Client = client(Config),
 
-    ok = emqx_s3_client:put_object(Client, Key, <<"data">>).
+    ok = emqx_s3_client:put_object(Client, Key, #{}, <<"data">>).
 
 t_extra_headers(Config0) ->
     Config = [{extra_headers, #{'Content-Type' => <<"application/json">>}} | Config0],
     Key = ?config(key, Config),
 
     Client = client(Config),
+    Opts = #{acl => public_read},
     Data = #{foo => bar},
-    ok = emqx_s3_client:put_object(Client, Key, emqx_utils_json:encode(Data)),
+    ok = emqx_s3_client:put_object(Client, Key, Opts, emqx_utils_json:encode(Data)),
 
     Url = emqx_s3_client:uri(Client, Key),
 
@@ -164,10 +162,11 @@ t_extra_headers(Config0) ->
 %%--------------------------------------------------------------------
 
 client(Config) ->
+    Bucket = ?config(bucket, Config),
     ClientConfig = emqx_s3_profile_conf:client_config(
         profile_config(Config), ?config(ehttpc_pool_name, Config)
     ),
-    emqx_s3_client:create(ClientConfig).
+    emqx_s3_client:create(Bucket, ClientConfig).
 
 profile_config(Config) ->
     ProfileConfig0 = emqx_s3_test_helpers:base_config(?config(conn_type, Config)),
@@ -175,7 +174,6 @@ profile_config(Config) ->
         fun inject_config/3,
         ProfileConfig0,
         #{
-            bucket => ?config(bucket, Config),
             [transport_options, pool_type] => ?config(pool_type, Config),
             [transport_options, headers] => ?config(extra_headers, Config)
         }
diff --git a/apps/emqx_s3/test/emqx_s3_profile_conf_SUITE.erl b/apps/emqx_s3/test/emqx_s3_profile_conf_SUITE.erl
index 433cfe07b..699162bfd 100644
--- a/apps/emqx_s3/test/emqx_s3_profile_conf_SUITE.erl
+++ b/apps/emqx_s3/test/emqx_s3_profile_conf_SUITE.erl
@@ -46,7 +46,7 @@ end_per_testcase(_TestCase, _Config) ->
 t_regular_outdated_pool_cleanup(Config) ->
     _ = process_flag(trap_exit, true),
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     [OldPool] = emqx_s3_profile_http_pools:all(profile_id()),
 
@@ -94,7 +94,7 @@ t_timeout_pool_cleanup(Config) ->
 
     %% Start uploader
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
     ok = emqx_s3_uploader:write(Pid, <<"data">>),
 
     [OldPool] = emqx_s3_profile_http_pools:all(profile_id()),
diff --git a/apps/emqx_s3/test/emqx_s3_uploader_SUITE.erl b/apps/emqx_s3/test/emqx_s3_uploader_SUITE.erl
index 90a32d948..292e065cf 100644
--- a/apps/emqx_s3/test/emqx_s3_uploader_SUITE.erl
+++ b/apps/emqx_s3/test/emqx_s3_uploader_SUITE.erl
@@ -133,7 +133,7 @@ end_per_testcase(_TestCase, _Config) ->
 
 t_happy_path_simple_put(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -165,7 +165,7 @@ t_happy_path_simple_put(Config) ->
 
 t_happy_path_multi(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -233,7 +233,7 @@ t_signed_nonascii_url_download(_Config) ->
 
 t_abort_multi(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -260,7 +260,7 @@ t_abort_multi(Config) ->
 
 t_abort_simple_put(_Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -278,7 +278,7 @@ t_abort_simple_put(_Config) ->
 t_config_switch(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
     OldBucket = ?config(bucket, Config),
-    {ok, Pid0} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid0} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     [Data0, Data1] = data($a, 6 * 1024 * 1024, 2),
 
@@ -304,7 +304,7 @@ t_config_switch(Config) ->
     ),
 
     %% Now check that new uploader uses new config
-    {ok, Pid1} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid1} = emqx_s3:start_uploader(profile_id(), Key, #{}),
     ok = emqx_s3_uploader:write(Pid1, Data0),
     ok = emqx_s3_uploader:complete(Pid1),
 
@@ -318,7 +318,7 @@ t_config_switch(Config) ->
 t_config_switch_http_settings(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
     OldBucket = ?config(bucket, Config),
-    {ok, Pid0} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid0} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     [Data0, Data1] = data($a, 6 * 1024 * 1024, 2),
 
@@ -345,7 +345,7 @@ t_config_switch_http_settings(Config) ->
     ),
 
     %% Now check that new uploader uses new config
-    {ok, Pid1} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid1} = emqx_s3:start_uploader(profile_id(), Key, #{}),
     ok = emqx_s3_uploader:write(Pid1, Data0),
     ok = emqx_s3_uploader:complete(Pid1),
 
@@ -360,7 +360,7 @@ t_start_multipart_error(Config) ->
     _ = process_flag(trap_exit, true),
 
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -386,7 +386,7 @@ t_upload_part_error(Config) ->
     _ = process_flag(trap_exit, true),
 
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -414,7 +414,7 @@ t_abort_multipart_error(Config) ->
     _ = process_flag(trap_exit, true),
 
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -442,7 +442,7 @@ t_complete_multipart_error(Config) ->
     _ = process_flag(trap_exit, true),
 
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -470,7 +470,7 @@ t_put_object_error(Config) ->
     _ = process_flag(trap_exit, true),
 
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -496,7 +496,7 @@ t_put_object_error(Config) ->
 
 t_too_large(Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -533,7 +533,7 @@ t_tls_error(Config) ->
     ),
     ok = emqx_s3:update_profile(profile_id(), ProfileConfig),
     Key = emqx_s3_test_helpers:unique_key(),
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 
@@ -553,7 +553,7 @@ t_no_profile(_Config) ->
     Key = emqx_s3_test_helpers:unique_key(),
     ?assertMatch(
         {error, profile_not_found},
-        emqx_s3:start_uploader(<<"no-profile">>, #{key => Key})
+        emqx_s3:start_uploader(<<"no-profile">>, Key, #{})
     ).
 
 %%--------------------------------------------------------------------
@@ -572,7 +572,7 @@ list_objects(Config) ->
     proplists:get_value(contents, Props).
 
 upload(Key, ChunkSize, ChunkCount) ->
-    {ok, Pid} = emqx_s3:start_uploader(profile_id(), #{key => Key}),
+    {ok, Pid} = emqx_s3:start_uploader(profile_id(), Key, #{}),
 
     _ = erlang:monitor(process, Pid),
 

From 8f66bd9ddf259958a70a81ef897cfabbaf79b711 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 8 Feb 2024 22:19:33 +0100
Subject: [PATCH 191/273] fix(s3-client): make log levels saner

---
 apps/emqx_s3/src/emqx_s3_client.erl | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/apps/emqx_s3/src/emqx_s3_client.erl b/apps/emqx_s3/src/emqx_s3_client.erl
index 202ff5218..e02134dc1 100644
--- a/apps/emqx_s3/src/emqx_s3_client.erl
+++ b/apps/emqx_s3/src/emqx_s3_client.erl
@@ -278,10 +278,10 @@ request_fun(HttpPool, PoolType, MaxRetries) ->
         end)
     end.
 
-ehttpc_request(HttpPool, Method, Request, Timeout, MaxRetries) ->
-    try timer:tc(fun() -> ehttpc:request(HttpPool, Method, Request, Timeout, MaxRetries) end) of
+ehttpc_request(Worker, Method, Request, Timeout, MaxRetries) ->
+    try timer:tc(fun() -> ehttpc:request(Worker, Method, Request, Timeout, MaxRetries) end) of
         {Time, {ok, StatusCode, RespHeaders}} ->
-            ?SLOG(info, #{
+            ?SLOG(debug, #{
                 msg => "s3_ehttpc_request_ok",
                 status_code => StatusCode,
                 headers => RespHeaders,
@@ -291,7 +291,7 @@ ehttpc_request(HttpPool, Method, Request, Timeout, MaxRetries) ->
                 {StatusCode, undefined}, headers_ehttpc_to_erlcloud_response(RespHeaders), undefined
             }};
         {Time, {ok, StatusCode, RespHeaders, RespBody}} ->
-            ?SLOG(info, #{
+            ?SLOG(debug, #{
                 msg => "s3_ehttpc_request_ok",
                 status_code => StatusCode,
                 headers => RespHeaders,
@@ -302,31 +302,31 @@ ehttpc_request(HttpPool, Method, Request, Timeout, MaxRetries) ->
                 {StatusCode, undefined}, headers_ehttpc_to_erlcloud_response(RespHeaders), RespBody
             }};
         {Time, {error, Reason}} ->
-            ?SLOG(error, #{
+            ?SLOG(warning, #{
                 msg => "s3_ehttpc_request_fail",
                 reason => Reason,
                 timeout => Timeout,
-                pool => HttpPool,
+                worker => Worker,
                 method => Method,
                 time => Time
             }),
             {error, Reason}
     catch
         error:badarg ->
-            ?SLOG(error, #{
+            ?SLOG(warning, #{
                 msg => "s3_ehttpc_request_fail",
                 reason => badarg,
                 timeout => Timeout,
-                pool => HttpPool,
+                worker => Worker,
                 method => Method
             }),
             {error, no_ehttpc_pool};
         error:Reason ->
-            ?SLOG(error, #{
+            ?SLOG(warning, #{
                 msg => "s3_ehttpc_request_fail",
                 reason => Reason,
                 timeout => Timeout,
-                pool => HttpPool,
+                worker => Worker,
                 method => Method
             }),
             {error, Reason}

From 802c76040688293cd5520b5f602848ecc11badd4 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 8 Feb 2024 22:22:14 +0100
Subject: [PATCH 192/273] feat(s3): introduce S3 connector and action

This is a trivial connector based on `emqx_s3` and simple action
that maps each incoming event into an S3 object upload. Due to
current `emqx_s3` limitation this bridge is compatible with
backends providing S3 API with path-style bucket access.
---
 apps/emqx_bridge/src/emqx_action_info.erl     |   3 +-
 apps/emqx_bridge_s3/BSL.txt                   |  94 ++++++++
 apps/emqx_bridge_s3/README.md                 |  16 ++
 apps/emqx_bridge_s3/docker-ct                 |   2 +
 apps/emqx_bridge_s3/rebar.config              |   6 +
 .../emqx_bridge_s3/src/emqx_bridge_s3.app.src |  17 ++
 apps/emqx_bridge_s3/src/emqx_bridge_s3.erl    | 221 +++++++++++++++++
 apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl    |  11 +
 .../src/emqx_bridge_s3_action_info.erl        |  19 ++
 .../src/emqx_bridge_s3_connector.erl          | 222 ++++++++++++++++++
 .../test/emqx_bridge_s3_SUITE.erl             | 171 ++++++++++++++
 .../src/schema/emqx_connector_ee_schema.erl   |  16 +-
 .../src/schema/emqx_connector_schema.erl      |   4 +-
 mix.exs                                       |   1 +
 rebar.config.erl                              |   1 +
 rel/i18n/emqx_bridge_s3.hocon                 |  23 ++
 rel/i18n/emqx_s3_schema.hocon                 |   3 +
 17 files changed, 826 insertions(+), 4 deletions(-)
 create mode 100644 apps/emqx_bridge_s3/BSL.txt
 create mode 100644 apps/emqx_bridge_s3/README.md
 create mode 100644 apps/emqx_bridge_s3/docker-ct
 create mode 100644 apps/emqx_bridge_s3/rebar.config
 create mode 100644 apps/emqx_bridge_s3/src/emqx_bridge_s3.app.src
 create mode 100644 apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
 create mode 100644 apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
 create mode 100644 apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
 create mode 100644 apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
 create mode 100644 apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
 create mode 100644 rel/i18n/emqx_bridge_s3.hocon

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index e74e6aa3e..f70d58e23 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -106,7 +106,8 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_opents_action_info,
         emqx_bridge_rabbitmq_action_info,
         emqx_bridge_greptimedb_action_info,
-        emqx_bridge_tdengine_action_info
+        emqx_bridge_tdengine_action_info,
+        emqx_bridge_s3_action_info
     ].
 -else.
 hard_coded_action_info_modules_ee() ->
diff --git a/apps/emqx_bridge_s3/BSL.txt b/apps/emqx_bridge_s3/BSL.txt
new file mode 100644
index 000000000..f0cd31c6f
--- /dev/null
+++ b/apps/emqx_bridge_s3/BSL.txt
@@ -0,0 +1,94 @@
+Business Source License 1.1
+
+Licensor:             Hangzhou EMQ Technologies Co., Ltd.
+Licensed Work:        EMQX Enterprise Edition
+                      The Licensed Work is (c) 2023
+                      Hangzhou EMQ Technologies Co., Ltd.
+Additional Use Grant: Students and educators are granted right to copy,
+                      modify, and create derivative work for research
+                      or education.
+Change Date:          2028-01-26
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Software,
+please contact Licensor: https://www.emqx.com/en/contact
+
+Notice
+
+The Business Source License (this document, or the “License”) is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+“Business Source License” is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
diff --git a/apps/emqx_bridge_s3/README.md b/apps/emqx_bridge_s3/README.md
new file mode 100644
index 000000000..ac542b468
--- /dev/null
+++ b/apps/emqx_bridge_s3/README.md
@@ -0,0 +1,16 @@
+# EMQX S3 Bridge
+
+This application provides connector and action implementations for the EMQX to integrate with Amazon S3 compatible storage services as part of the EMQX data integration pipelines.
+Users can leverage [EMQX Rule Engine](https://docs.emqx.com/en/enterprise/v5.0/data-integration/rules.html) to create rules that publish message data to S3 storage service.
+
+## Documentation
+
+Refer to [Rules engine](https://docs.emqx.com/en/enterprise/v5.0/data-integration/rules.html) for the EMQX rules engine introduction.
+
+## Contributing
+
+Please see our [contributing.md](../../CONTRIBUTING.md).
+
+## License
+
+EMQ Business Source License 1.1, refer to [LICENSE](BSL.txt).
diff --git a/apps/emqx_bridge_s3/docker-ct b/apps/emqx_bridge_s3/docker-ct
new file mode 100644
index 000000000..a5a001815
--- /dev/null
+++ b/apps/emqx_bridge_s3/docker-ct
@@ -0,0 +1,2 @@
+minio
+toxiproxy
diff --git a/apps/emqx_bridge_s3/rebar.config b/apps/emqx_bridge_s3/rebar.config
new file mode 100644
index 000000000..51bf0e0b6
--- /dev/null
+++ b/apps/emqx_bridge_s3/rebar.config
@@ -0,0 +1,6 @@
+%% -*- mode: erlang; -*-
+
+{erl_opts, [debug_info]}.
+{deps, [
+    {emqx_resource, {path, "../../apps/emqx_resource"}}
+]}.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.app.src b/apps/emqx_bridge_s3/src/emqx_bridge_s3.app.src
new file mode 100644
index 000000000..0047b5e51
--- /dev/null
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.app.src
@@ -0,0 +1,17 @@
+{application, emqx_bridge_s3, [
+    {description, "EMQX Enterprise S3 Bridge"},
+    {vsn, "0.1.0"},
+    {registered, []},
+    {applications, [
+        kernel,
+        stdlib,
+        erlcloud,
+        emqx_resource,
+        emqx_s3
+    ]},
+    {env, [
+        {emqx_action_info_modules, [emqx_bridge_s3_action_info]}
+    ]},
+    {modules, []},
+    {links, []}
+]}.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
new file mode 100644
index 000000000..6a2f93b3c
--- /dev/null
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
@@ -0,0 +1,221 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_s3).
+
+-include_lib("typerefl/include/types.hrl").
+-include_lib("hocon/include/hoconsc.hrl").
+-include("emqx_bridge_s3.hrl").
+
+-behaviour(hocon_schema).
+-export([
+    namespace/0,
+    roots/0,
+    fields/1,
+    desc/1
+]).
+
+-export([
+    bridge_v2_examples/1,
+    connector_examples/1
+]).
+
+%%-------------------------------------------------------------------------------------------------
+%% `hocon_schema' API
+%%-------------------------------------------------------------------------------------------------
+
+namespace() ->
+    "bridge_s3".
+
+roots() ->
+    [].
+
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR, fields(s3_connector_config));
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "put_bridge_v2";
+    Field == "post_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION, fields(?ACTION));
+fields(action) ->
+    {?ACTION,
+        hoconsc:mk(
+            hoconsc:map(name, hoconsc:ref(?MODULE, ?ACTION)),
+            #{
+                desc => <<"S3 Action Config">>,
+                required => false
+            }
+        )};
+fields("config_connector") ->
+    lists:append([
+        emqx_connector_schema:common_fields(),
+        fields(s3_connector_config),
+        [
+            {resource_opts,
+                hoconsc:mk(
+                    ?R_REF(s3_connector_resource_opts),
+                    emqx_resource_schema:resource_opts_meta()
+                )}
+        ]
+    ]);
+fields(?ACTION) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        hoconsc:mk(
+            ?R_REF(s3_upload_parameters),
+            #{
+                required => true,
+                desc => ?DESC(s3_upload)
+            }
+        ),
+        #{
+            resource_opts_ref => ?R_REF(s3_action_resource_opts)
+        }
+    );
+fields(s3_connector_config) ->
+    emqx_s3_schema:fields(s3_client);
+fields(s3_upload_parameters) ->
+    emqx_s3_schema:fields(s3_upload) ++
+        [
+            {content,
+                hoconsc:mk(
+                    string(),
+                    #{
+                        required => false,
+                        default => <<"${.}">>,
+                        desc => ?DESC(s3_object_content)
+                    }
+                )}
+        ];
+fields(s3_action_resource_opts) ->
+    UnsupportedOpts = [batch_size, batch_time],
+    lists:filter(
+        fun({N, _}) -> not lists:member(N, UnsupportedOpts) end,
+        emqx_bridge_v2_schema:action_resource_opts_fields()
+    );
+fields(s3_connector_resource_opts) ->
+    CommonOpts = emqx_connector_schema:common_resource_opts_subfields(),
+    lists:filter(
+        fun({N, _}) -> lists:member(N, CommonOpts) end,
+        emqx_connector_schema:resource_opts_fields()
+    ).
+
+desc("config_connector") ->
+    ?DESC(config_connector);
+desc(s3_upload) ->
+    ?DESC(s3_upload);
+desc(s3_upload_parameters) ->
+    ?DESC(s3_upload_parameters);
+desc(s3_action_resource_opts) ->
+    ?DESC(emqx_resource_schema, resource_opts);
+desc(s3_connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, resource_opts);
+desc(_Name) ->
+    undefined.
+
+%% Examples
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"s3">> => #{
+                summary => <<"S3 Simple Upload">>,
+                value => action_example(Method)
+            }
+        }
+    ].
+
+action_example(post) ->
+    maps:merge(
+        action_example(put),
+        #{
+            type => atom_to_binary(?ACTION),
+            name => <<"my_s3_action">>
+        }
+    );
+action_example(get) ->
+    maps:merge(
+        action_example(put),
+        #{
+            status => <<"connected">>,
+            node_status => [
+                #{
+                    node => <<"emqx@localhost">>,
+                    status => <<"connected">>
+                }
+            ]
+        }
+    );
+action_example(put) ->
+    #{
+        enable => true,
+        connector => <<"my_s3_connector">>,
+        description => <<"My action">>,
+        parameters => #{
+            bucket => <<"${clientid}">>,
+            key => <<"${topic}">>,
+            content => <<"${payload}">>,
+            acl => <<"public_read">>
+        },
+        resource_opts => #{
+            query_mode => <<"sync">>,
+            inflight_window => 10
+        }
+    }.
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"s3_aws">> => #{
+                summary => <<"S3 Connector">>,
+                value => connector_example(Method)
+            }
+        }
+    ].
+
+connector_example(get) ->
+    maps:merge(
+        connector_example(put),
+        #{
+            status => <<"connected">>,
+            node_status => [
+                #{
+                    node => <<"emqx@localhost">>,
+                    status => <<"connected">>
+                }
+            ]
+        }
+    );
+connector_example(post) ->
+    maps:merge(
+        connector_example(put),
+        #{
+            type => atom_to_binary(?CONNECTOR),
+            name => <<"my_s3_connector">>
+        }
+    );
+connector_example(put) ->
+    #{
+        enable => true,
+        description => <<"My S3 connector">>,
+        host => <<"s3.eu-east-1.amazonaws.com">>,
+        port => 443,
+        access_key_id => <<"ACCESS">>,
+        secret_access_key => <<"SECRET">>,
+        transport_options => #{
+            ssl => #{
+                enable => true,
+                verify => <<"verify_peer">>
+            },
+            connect_timeout => <<"1s">>,
+            request_timeout => <<"60s">>,
+            pool_size => 4,
+            max_retries => 1,
+            enable_pipelining => 1
+        }
+    }.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl b/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
new file mode 100644
index 000000000..fb513c586
--- /dev/null
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
@@ -0,0 +1,11 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-ifndef(__EMQX_BRIDGE_S3_HRL__).
+-define(__EMQX_BRIDGE_S3_HRL__, true).
+
+-define(ACTION, s3_upload).
+-define(CONNECTOR, s3).
+
+-endif.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
new file mode 100644
index 000000000..6c66a8f35
--- /dev/null
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
@@ -0,0 +1,19 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_s3_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+action_type_name() -> s3_upload.
+
+connector_type_name() -> s3.
+
+schema_module() -> emqx_bridge_s3.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
new file mode 100644
index 000000000..e54a22811
--- /dev/null
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
@@ -0,0 +1,222 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_s3_connector).
+
+-include_lib("emqx/include/logger.hrl").
+-include_lib("snabbkaffe/include/trace.hrl").
+-include_lib("emqx_resource/include/emqx_resource.hrl").
+
+-behaviour(emqx_resource).
+-export([
+    callback_mode/0,
+    on_start/2,
+    on_stop/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_query/3,
+    % on_batch_query/3,
+    on_get_status/2,
+    on_get_channel_status/3
+]).
+
+-type config() :: #{
+    access_key_id => string(),
+    secret_access_key => emqx_secret:t(string()),
+    host := string(),
+    port := pos_integer(),
+    transport_options => emqx_s3:transport_options()
+}.
+
+-type channel_config() :: #{
+    parameters := #{
+        bucket := string(),
+        key := string(),
+        content := string(),
+        acl => emqx_s3:acl()
+    }
+}.
+
+-type channel_state() :: #{
+    bucket := emqx_template:str(),
+    key := emqx_template:str(),
+    upload_options => emqx_s3_client:upload_options()
+}.
+
+-type state() :: #{
+    pool_name => resource_id(),
+    pool_pid => pid(),
+    client_config := emqx_s3_client:config(),
+    channels := #{channel_id() => channel_state()}
+}.
+
+%%
+
+-spec callback_mode() -> callback_mode().
+callback_mode() ->
+    always_sync.
+
+%% Management
+
+-spec on_start(_InstanceId :: resource_id(), config()) ->
+    {ok, state()} | {error, _Reason}.
+on_start(InstId, Config) ->
+    PoolName = InstId,
+    S3Config = Config#{url_expire_time => 0},
+    State = #{
+        pool_name => PoolName,
+        client_config => emqx_s3_profile_conf:client_config(S3Config, PoolName),
+        channels => #{}
+    },
+    HttpConfig = emqx_s3_profile_conf:http_config(Config),
+    case ehttpc_sup:start_pool(PoolName, HttpConfig) of
+        {ok, Pid} ->
+            ?SLOG(info, #{msg => "s3_connector_start_http_pool_success", pool_name => PoolName}),
+            {ok, State#{pool_pid => Pid}};
+        {error, Reason} = Error ->
+            ?SLOG(error, #{
+                msg => "s3_connector_start_http_pool_fail",
+                pool_name => PoolName,
+                http_config => HttpConfig,
+                reason => Reason
+            }),
+            Error
+    end.
+
+-spec on_stop(_InstanceId :: resource_id(), state()) ->
+    ok.
+on_stop(InstId, _State = #{pool_name := PoolName}) ->
+    case ehttpc_sup:stop_pool(PoolName) of
+        ok ->
+            ?tp(s3_bridge_stopped, #{instance_id => InstId}),
+            ok;
+        {error, Reason} ->
+            ?SLOG(error, #{
+                msg => "s3_connector_http_pool_stop_fail",
+                pool_name => PoolName,
+                reason => Reason
+            }),
+            ok
+    end.
+
+-spec on_get_status(_InstanceId :: resource_id(), state()) ->
+    health_check_status().
+on_get_status(_InstId, State = #{client_config := Config}) ->
+    try erlcloud_s3:list_buckets(emqx_s3_client:aws_config(Config)) of
+        Props when is_list(Props) ->
+            ?status_connected
+    catch
+        error:{aws_error, {http_error, _Code, _, Reason}} ->
+            {?status_disconnected, State, Reason};
+        error:{aws_error, {socket_error, Reason}} ->
+            {?status_disconnected, State, Reason}
+    end.
+
+-spec on_add_channel(_InstanceId :: resource_id(), state(), channel_id(), channel_config()) ->
+    {ok, state()} | {error, _Reason}.
+on_add_channel(_InstId, State = #{channels := Channels}, ChannelId, Config) ->
+    ChannelState = init_channel_state(Config),
+    {ok, State#{channels => Channels#{ChannelId => ChannelState}}}.
+
+-spec on_remove_channel(_InstanceId :: resource_id(), state(), channel_id()) ->
+    {ok, state()}.
+on_remove_channel(_InstId, State = #{channels := Channels}, ChannelId) ->
+    {ok, State#{channels => maps:remove(ChannelId, Channels)}}.
+
+-spec on_get_channels(_InstanceId :: resource_id()) ->
+    [_ChannelConfig].
+on_get_channels(InstId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstId).
+
+-spec on_get_channel_status(_InstanceId :: resource_id(), channel_id(), state()) ->
+    channel_status().
+on_get_channel_status(_InstId, ChannelId, #{channels := Channels}) ->
+    case maps:get(ChannelId, Channels, undefined) of
+        _ChannelState = #{} ->
+            %% TODO
+            %% Since bucket name may be templated, we can't really provide any
+            %% additional information regarding the channel health.
+            ?status_connected;
+        undefined ->
+            ?status_disconnected
+    end.
+
+init_channel_state(#{parameters := Parameters}) ->
+    #{
+        bucket => emqx_template:parse(maps:get(bucket, Parameters)),
+        key => emqx_template:parse(maps:get(key, Parameters)),
+        content => emqx_template:parse(maps:get(content, Parameters)),
+        upload_options => #{
+            acl => maps:get(acl, Parameters, undefined)
+        }
+    }.
+
+%% Queries
+
+-type query() :: {_Tag :: channel_id(), _Data :: emqx_jsonish:t()}.
+
+-spec on_query(_InstanceId :: resource_id(), query(), state()) ->
+    {ok, _Result} | {error, _Reason}.
+on_query(InstId, {Tag, Data}, #{client_config := Config, channels := Channels}) ->
+    case maps:get(Tag, Channels, undefined) of
+        ChannelState = #{} ->
+            run_simple_upload(InstId, Data, ChannelState, Config);
+        undefined ->
+            {error, {unrecoverable_error, {invalid_message_tag, Tag}}}
+    end.
+
+run_simple_upload(
+    InstId,
+    Data,
+    #{
+        bucket := BucketTemplate,
+        key := KeyTemplate,
+        content := ContentTemplate,
+        upload_options := UploadOpts
+    },
+    Config
+) ->
+    Bucket = render_bucket(BucketTemplate, Data),
+    Client = emqx_s3_client:create(Bucket, Config),
+    Key = render_key(KeyTemplate, Data),
+    Content = render_content(ContentTemplate, Data),
+    case emqx_s3_client:put_object(Client, Key, UploadOpts, Content) of
+        ok ->
+            ?tp(s3_bridge_connector_upload_ok, #{
+                instance_id => InstId,
+                bucket => Bucket,
+                key => Key
+            }),
+            ok;
+        {error, Reason} ->
+            {error, map_error(Reason)}
+    end.
+
+map_error({socket_error, _} = Reason) ->
+    {recoverable_error, Reason};
+map_error(Reason) ->
+    %% TODO: Recoverable errors.
+    {unrecoverable_error, Reason}.
+
+render_bucket(Template, Data) ->
+    case emqx_template:render(Template, {emqx_jsonish, Data}) of
+        {Result, []} ->
+            iolist_to_string(Result);
+        {_, Errors} ->
+            erlang:error({unrecoverable_error, {bucket_undefined, Errors}})
+    end.
+
+render_key(Template, Data) ->
+    %% NOTE: ignoring errors here, missing variables will be rendered as `"undefined"`.
+    {Result, _Errors} = emqx_template:render(Template, {emqx_jsonish, Data}),
+    iolist_to_string(Result).
+
+render_content(Template, Data) ->
+    %% NOTE: ignoring errors here, missing variables will be rendered as `"undefined"`.
+    {Result, _Errors} = emqx_template:render(Template, {emqx_jsonish, Data}),
+    Result.
+
+iolist_to_string(IOList) ->
+    unicode:characters_to_list(IOList).
diff --git a/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
new file mode 100644
index 000000000..3d6637ebd
--- /dev/null
+++ b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
@@ -0,0 +1,171 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_s3_SUITE).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
+
+-import(emqx_utils_conv, [bin/1]).
+
+%% See `emqx_bridge_s3.hrl`.
+-define(BRIDGE_TYPE, <<"s3_upload">>).
+-define(CONNECTOR_TYPE, <<"s3">>).
+
+-define(PROXY_NAME, "minio_tcp").
+-define(CONTENT_TYPE, "application/x-emqx-payload").
+
+%% CT Setup
+
+all() ->
+    emqx_common_test_helpers:all(?MODULE).
+
+init_per_suite(Config) ->
+    % Setup toxiproxy
+    ProxyHost = os:getenv("PROXY_HOST", "toxiproxy"),
+    ProxyPort = list_to_integer(os:getenv("PROXY_PORT", "8474")),
+    _ = emqx_common_test_helpers:reset_proxy(ProxyHost, ProxyPort),
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            emqx_connector,
+            emqx_bridge_s3,
+            emqx_bridge,
+            emqx_rule_engine,
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
+    [
+        {apps, Apps},
+        {proxy_host, ProxyHost},
+        {proxy_port, ProxyPort},
+        {proxy_name, ?PROXY_NAME}
+        | Config
+    ].
+
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(apps, Config)).
+
+%% Testcases
+
+init_per_testcase(TestCase, Config) ->
+    ct:timetrap(timer:seconds(30)),
+    ok = snabbkaffe:start_trace(),
+    Name = iolist_to_binary(io_lib:format("~s~p", [TestCase, erlang:unique_integer()])),
+    ConnectorConfig = connector_config(Name, Config),
+    ActionConfig = action_config(Name, Name),
+    [
+        {connector_type, ?CONNECTOR_TYPE},
+        {connector_name, Name},
+        {connector_config, ConnectorConfig},
+        {bridge_type, ?BRIDGE_TYPE},
+        {bridge_name, Name},
+        {bridge_config, ActionConfig}
+        | Config
+    ].
+
+end_per_testcase(_TestCase, _Config) ->
+    ok = snabbkaffe:stop(),
+    ok.
+
+connector_config(Name, _Config) ->
+    BaseConf = emqx_s3_test_helpers:base_raw_config(tcp),
+    parse_and_check_config(<<"connectors">>, ?CONNECTOR_TYPE, Name, #{
+        <<"enable">> => true,
+        <<"description">> => <<"S3 Connector">>,
+        <<"host">> => maps:get(<<"host">>, BaseConf),
+        <<"port">> => maps:get(<<"port">>, BaseConf),
+        <<"access_key_id">> => maps:get(<<"access_key_id">>, BaseConf),
+        <<"secret_access_key">> => maps:get(<<"secret_access_key">>, BaseConf),
+        <<"transport_options">> => #{
+            <<"headers">> => #{
+                <<"content-type">> => <<?CONTENT_TYPE>>
+            },
+            <<"connect_timeout">> => 1000,
+            <<"request_timeout">> => 1000,
+            <<"pool_size">> => 4,
+            <<"max_retries">> => 0,
+            <<"enable_pipelining">> => 1
+        }
+    }).
+
+action_config(Name, ConnectorId) ->
+    parse_and_check_config(<<"actions">>, ?BRIDGE_TYPE, Name, #{
+        <<"enable">> => true,
+        <<"connector">> => ConnectorId,
+        <<"parameters">> => #{
+            <<"bucket">> => <<"${clientid}">>,
+            <<"key">> => <<"${topic}">>,
+            <<"content">> => <<"${payload}">>,
+            <<"acl">> => <<"public_read">>
+        },
+        <<"resource_opts">> => #{
+            <<"buffer_mode">> => <<"memory_only">>,
+            <<"buffer_seg_bytes">> => <<"10MB">>,
+            <<"health_check_interval">> => <<"5s">>,
+            <<"inflight_window">> => 40,
+            <<"max_buffer_bytes">> => <<"256MB">>,
+            <<"metrics_flush_interval">> => <<"1s">>,
+            <<"query_mode">> => <<"sync">>,
+            <<"request_ttl">> => <<"60s">>,
+            <<"resume_interval">> => <<"5s">>,
+            <<"worker_pool_size">> => <<"4">>
+        }
+    }).
+
+parse_and_check_config(Root, Type, Name, ConfigIn) ->
+    Schema =
+        case Root of
+            <<"connectors">> -> emqx_connector_schema;
+            <<"actions">> -> emqx_bridge_v2_schema
+        end,
+    #{Root := #{Type := #{Name := Config}}} =
+        hocon_tconf:check_plain(
+            Schema,
+            #{Root => #{Type => #{Name => ConfigIn}}},
+            #{required => false, atom_key => false}
+        ),
+    ct:pal("parsed config: ~p", [Config]),
+    ConfigIn.
+
+t_start_stop(Config) ->
+    emqx_bridge_v2_testlib:t_start_stop(Config, s3_bridge_stopped).
+
+t_create_via_http(Config) ->
+    emqx_bridge_v2_testlib:t_create_via_http(Config).
+
+t_on_get_status(Config) ->
+    emqx_bridge_v2_testlib:t_on_get_status(Config, #{}).
+
+t_sync_query(Config) ->
+    Bucket = emqx_s3_test_helpers:unique_bucket(),
+    Topic = "a/b/c",
+    Payload = rand:bytes(1024),
+    AwsConfig = emqx_s3_test_helpers:aws_config(tcp),
+    ok = erlcloud_s3:create_bucket(Bucket, AwsConfig),
+    ok = emqx_bridge_v2_testlib:t_sync_query(
+        Config,
+        fun() -> mk_message(Bucket, Topic, Payload) end,
+        fun(Res) -> ?assertMatch(ok, Res) end,
+        s3_bridge_connector_upload_ok
+    ),
+    ?assertMatch(
+        #{
+            content := Payload,
+            content_type := ?CONTENT_TYPE
+        },
+        maps:from_list(erlcloud_s3:get_object(Bucket, Topic, AwsConfig))
+    ).
+
+mk_message(ClientId, Topic, Payload) ->
+    Message = emqx_message:make(bin(ClientId), bin(Topic), Payload),
+    {Event, _} = emqx_rule_events:eventmsg_publish(Message),
+    Event.
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index 2935233be..40e3e0e40 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -66,6 +66,8 @@ resource_type(tdengine) ->
     emqx_bridge_tdengine_connector;
 resource_type(rabbitmq) ->
     emqx_bridge_rabbitmq_connector;
+resource_type(s3) ->
+    emqx_bridge_s3_connector;
 resource_type(Type) ->
     error({unknown_connector_type, Type}).
 
@@ -270,6 +272,14 @@ connector_structs() ->
                     desc => <<"RabbitMQ Connector Config">>,
                     required => false
                 }
+            )},
+        {s3,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_s3, "config_connector")),
+                #{
+                    desc => <<"S3 Connector Config">>,
+                    required => false
+                }
             )}
     ].
 
@@ -296,7 +306,8 @@ schema_modules() ->
         emqx_bridge_rabbitmq_connector_schema,
         emqx_bridge_opents_connector,
         emqx_bridge_greptimedb,
-        emqx_bridge_tdengine_connector
+        emqx_bridge_tdengine_connector,
+        emqx_bridge_s3
     ].
 
 api_schemas(Method) ->
@@ -332,7 +343,8 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_opents_connector, <<"opents">>, Method),
         api_ref(emqx_bridge_rabbitmq_connector_schema, <<"rabbitmq">>, Method),
         api_ref(emqx_bridge_greptimedb, <<"greptimedb">>, Method ++ "_connector"),
-        api_ref(emqx_bridge_tdengine_connector, <<"tdengine">>, Method)
+        api_ref(emqx_bridge_tdengine_connector, <<"tdengine">>, Method),
+        api_ref(emqx_bridge_s3, <<"s3">>, Method ++ "_connector")
     ].
 
 api_ref(Module, Type, Method) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index b803ab9f2..b4e299ab2 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -167,7 +167,9 @@ connector_type_to_bridge_types(greptimedb) ->
 connector_type_to_bridge_types(tdengine) ->
     [tdengine];
 connector_type_to_bridge_types(rabbitmq) ->
-    [rabbitmq].
+    [rabbitmq];
+connector_type_to_bridge_types(s3) ->
+    [s3].
 
 actions_config_name(action) -> <<"actions">>;
 actions_config_name(source) -> <<"sources">>.
diff --git a/mix.exs b/mix.exs
index c2eaddcd9..aadfe2ec9 100644
--- a/mix.exs
+++ b/mix.exs
@@ -182,6 +182,7 @@ defmodule EMQXUmbrella.MixProject do
       :emqx_ft,
       :emqx_license,
       :emqx_s3,
+      :emqx_bridge_s3,
       :emqx_schema_registry,
       :emqx_enterprise,
       :emqx_bridge_kinesis,
diff --git a/rebar.config.erl b/rebar.config.erl
index afcd305c3..4600a4a83 100644
--- a/rebar.config.erl
+++ b/rebar.config.erl
@@ -103,6 +103,7 @@ is_community_umbrella_app("apps/emqx_oracle") -> false;
 is_community_umbrella_app("apps/emqx_bridge_rabbitmq") -> false;
 is_community_umbrella_app("apps/emqx_ft") -> false;
 is_community_umbrella_app("apps/emqx_s3") -> false;
+is_community_umbrella_app("apps/emqx_bridge_s3") -> false;
 is_community_umbrella_app("apps/emqx_schema_registry") -> false;
 is_community_umbrella_app("apps/emqx_enterprise") -> false;
 is_community_umbrella_app("apps/emqx_bridge_kinesis") -> false;
diff --git a/rel/i18n/emqx_bridge_s3.hocon b/rel/i18n/emqx_bridge_s3.hocon
new file mode 100644
index 000000000..fe10313e0
--- /dev/null
+++ b/rel/i18n/emqx_bridge_s3.hocon
@@ -0,0 +1,23 @@
+emqx_bridge_s3 {
+
+config_connector.label:
+"""S3 Connector Configuration"""
+config_connector.desc:
+"""Configuration for a connector to S3 API compatible storage service."""
+
+s3_upload.label:
+"""S3 Simple Upload"""
+s3_upload.desc:
+"""Action to upload a single object to the S3 service."""
+
+s3_upload_parameters.label:
+"""S3 Upload action parameters"""
+s3_upload_parameters.desc:
+"""Set of parameters for the upload action. Action supports templates in S3 bucket name, object key and object content."""
+
+s3_object_content.label:
+"""S3 Object Content"""
+s3_object_content.desc:
+"""Content of the S3 object being uploaded. Supports templates."""
+
+}
diff --git a/rel/i18n/emqx_s3_schema.hocon b/rel/i18n/emqx_s3_schema.hocon
index df4b973fa..cfecaf47e 100644
--- a/rel/i18n/emqx_s3_schema.hocon
+++ b/rel/i18n/emqx_s3_schema.hocon
@@ -9,6 +9,9 @@ secret_access_key.desc:
 bucket.desc:
 """The name of the S3 bucket."""
 
+key.desc:
+"""Key of the S3 object being manipulated."""
+
 host.desc:
 """The host of the S3 endpoint."""
 

From 2a4e37869e4fce62ccb76d6862ff9b6836686211 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 8 Feb 2024 22:49:20 +0100
Subject: [PATCH 193/273] fix(dashboard): provide full context in startup
 errors

---
 apps/emqx_dashboard/src/emqx_dashboard_swagger.erl          | 4 ++--
 apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl | 2 +-
 apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl    | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl b/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
index 56ca4acb0..e5810dcc5 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_swagger.erl
@@ -364,8 +364,8 @@ parse_spec_ref(Module, Path, Options) ->
 
 -ifdef(TEST).
 -spec failed_to_generate_swagger_spec(_, _, _, _, _) -> no_return().
-failed_to_generate_swagger_spec(Module, Path, _Error, _Reason, _Stacktrace) ->
-    error({failed_to_generate_swagger_spec, Module, Path}).
+failed_to_generate_swagger_spec(Module, Path, Error, Reason, Stacktrace) ->
+    error({failed_to_generate_swagger_spec, Module, Path, Error, Reason, Stacktrace}).
 -else.
 -spec failed_to_generate_swagger_spec(_, _, _, _, _) -> no_return().
 failed_to_generate_swagger_spec(Module, Path, Error, Reason, Stacktrace) ->
diff --git a/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl b/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
index 1bb42f324..0e1264aeb 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
@@ -310,7 +310,7 @@ t_nest_ref(_Config) ->
 t_none_ref(_Config) ->
     Path = "/ref/none",
     ?assertError(
-        {failed_to_generate_swagger_spec, ?MODULE, Path},
+        {failed_to_generate_swagger_spec, ?MODULE, Path, error, _FunctionClause, _Stacktrace},
         emqx_dashboard_swagger:parse_spec_ref(?MODULE, Path, #{})
     ),
     ok.
diff --git a/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl b/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
index 85cc4b16b..5ccb01b3e 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
@@ -282,7 +282,7 @@ t_bad_ref(_Config) ->
 t_none_ref(_Config) ->
     Path = "/ref/none",
     ?assertError(
-        {failed_to_generate_swagger_spec, ?MODULE, Path},
+        {failed_to_generate_swagger_spec, ?MODULE, Path, error, _FunctionClause, _Stacktrace},
         validate(Path, #{}, [])
     ),
     ok.

From f476f4343b5a845393a79bad1737513573f5e67d Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Fri, 9 Feb 2024 12:14:10 +0100
Subject: [PATCH 194/273] fix(release): add `emqx_bridge_s3` to applications
 list

---
 apps/emqx_machine/priv/reboot_lists.eterm | 1 +
 1 file changed, 1 insertion(+)

diff --git a/apps/emqx_machine/priv/reboot_lists.eterm b/apps/emqx_machine/priv/reboot_lists.eterm
index f7e78c360..a6559bcab 100644
--- a/apps/emqx_machine/priv/reboot_lists.eterm
+++ b/apps/emqx_machine/priv/reboot_lists.eterm
@@ -114,6 +114,7 @@
             emqx_bridge_oracle,
             emqx_bridge_rabbitmq,
             emqx_bridge_azure_event_hub,
+            emqx_bridge_s3,
             emqx_schema_registry,
             emqx_eviction_agent,
             emqx_node_rebalance,

From c108262771caa4a903d4026d9a1bc23d2b2cbc0f Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Fri, 9 Feb 2024 16:08:33 +0100
Subject: [PATCH 195/273] chore(s3-bridge): use `emqx_connector_schema` helper
 for brewity

---
 apps/emqx_bridge_s3/src/emqx_bridge_s3.erl           | 8 +-------
 apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl | 2 +-
 2 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
index 6a2f93b3c..335b4bf11 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
@@ -56,13 +56,7 @@ fields("config_connector") ->
     lists:append([
         emqx_connector_schema:common_fields(),
         fields(s3_connector_config),
-        [
-            {resource_opts,
-                hoconsc:mk(
-                    ?R_REF(s3_connector_resource_opts),
-                    emqx_resource_schema:resource_opts_meta()
-                )}
-        ]
+        emqx_connector_schema:resource_opts_ref(?MODULE, s3_connector_resource_opts)
     ]);
 fields(?ACTION) ->
     emqx_bridge_v2_schema:make_producer_action_schema(
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
index e54a22811..9a0f110fe 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
@@ -46,7 +46,7 @@
 }.
 
 -type state() :: #{
-    pool_name => resource_id(),
+    pool_name := resource_id(),
     pool_pid => pid(),
     client_config := emqx_s3_client:config(),
     channels := #{channel_id() => channel_state()}

From 90fd2b26d3b46d0f60ea5c8466115e4dc4dccd52 Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Fri, 9 Feb 2024 20:59:34 +0300
Subject: [PATCH 196/273] feat(banned): allow ban by clientid/username regexps,
 peerhost cidrs

---
 apps/emqx/include/emqx.hrl                    |   5 +-
 apps/emqx/src/emqx_banned.erl                 | 188 +++++++++++++-----
 apps/emqx/src/emqx_flapping.erl               |   2 +-
 apps/emqx/src/emqx_types.erl                  |   9 +
 apps/emqx/test/emqx_banned_SUITE.erl          |  95 ++++++---
 .../test/emqx_authz/emqx_authz_SUITE.erl      |   2 +-
 apps/emqx_management/src/emqx_mgmt_api.erl    |  16 +-
 .../src/emqx_mgmt_api_banned.erl              |   5 +-
 .../test/emqx_mgmt_api_banned_SUITE.erl       |  85 +++++++-
 apps/emqx_modules/test/emqx_delayed_SUITE.erl |   2 +-
 .../test/emqx_retainer_SUITE.erl              |   2 +-
 changes/ce/feat-12499.en.md                   |   5 +
 rel/i18n/emqx_mgmt_api_banned.hocon           |   3 +-
 13 files changed, 323 insertions(+), 96 deletions(-)
 create mode 100644 changes/ce/feat-12499.en.md

diff --git a/apps/emqx/include/emqx.hrl b/apps/emqx/include/emqx.hrl
index 654d96d8c..13b3373f1 100644
--- a/apps/emqx/include/emqx.hrl
+++ b/apps/emqx/include/emqx.hrl
@@ -88,10 +88,7 @@
 %%--------------------------------------------------------------------
 
 -record(banned, {
-    who ::
-        {clientid, binary()}
-        | {peerhost, inet:ip_address()}
-        | {username, binary()},
+    who :: emqx_types:banned_who(),
     by :: binary(),
     reason :: binary(),
     at :: integer(),
diff --git a/apps/emqx/src/emqx_banned.erl b/apps/emqx/src/emqx_banned.erl
index 1568bf103..fcb6edc00 100644
--- a/apps/emqx/src/emqx_banned.erl
+++ b/apps/emqx/src/emqx_banned.erl
@@ -39,7 +39,9 @@
     info/1,
     format/1,
     parse/1,
-    clear/0
+    clear/0,
+    who/2,
+    tables/0
 ]).
 
 %% gen_server callbacks
@@ -61,7 +63,8 @@
 
 -elvis([{elvis_style, state_record_and_type, disable}]).
 
--define(BANNED_TAB, ?MODULE).
+-define(BANNED_INDIVIDUAL_TAB, ?MODULE).
+-define(BANNED_RULE_TAB, emqx_banned_rules).
 
 %% The default expiration time should be infinite
 %% but for compatibility, a large number (1 years) is used here to represent the 'infinite'
@@ -77,19 +80,24 @@
 %%--------------------------------------------------------------------
 
 mnesia(boot) ->
-    ok = mria:create_table(?BANNED_TAB, [
+    Options = [
         {type, set},
         {rlog_shard, ?COMMON_SHARD},
         {storage, disc_copies},
         {record_name, banned},
         {attributes, record_info(fields, banned)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ],
+    ok = mria:create_table(?BANNED_INDIVIDUAL_TAB, Options),
+    ok = mria:create_table(?BANNED_RULE_TAB, Options).
 
 %%--------------------------------------------------------------------
 %% Data backup
 %%--------------------------------------------------------------------
-backup_tables() -> [?BANNED_TAB].
+backup_tables() -> tables().
+
+-spec tables() -> [atom()].
+tables() -> [?BANNED_RULE_TAB, ?BANNED_INDIVIDUAL_TAB].
 
 %% @doc Start the banned server.
 -spec start_link() -> startlink_ret().
@@ -104,16 +112,10 @@ stop() -> gen_server:stop(?MODULE).
 check(ClientInfo) ->
     do_check({clientid, maps:get(clientid, ClientInfo, undefined)}) orelse
         do_check({username, maps:get(username, ClientInfo, undefined)}) orelse
-        do_check({peerhost, maps:get(peerhost, ClientInfo, undefined)}).
-
-do_check({_, undefined}) ->
-    false;
-do_check(Who) when is_tuple(Who) ->
-    case mnesia:dirty_read(?BANNED_TAB, Who) of
-        [] -> false;
-        [#banned{until = Until}] -> Until > erlang:system_time(second)
-    end.
+        do_check({peerhost, maps:get(peerhost, ClientInfo, undefined)}) orelse
+        do_check_rules(ClientInfo).
 
+-spec format(emqx_types:banned()) -> map().
 format(#banned{
     who = Who0,
     by = By,
@@ -121,7 +123,7 @@ format(#banned{
     at = At,
     until = Until
 }) ->
-    {As, Who} = maybe_format_host(Who0),
+    {As, Who} = format_who(Who0),
     #{
         as => As,
         who => Who,
@@ -131,6 +133,7 @@ format(#banned{
         until => to_rfc3339(Until)
     }.
 
+-spec parse(map()) -> emqx_types:banned() | {error, term()}.
 parse(Params) ->
     case parse_who(Params) of
         {error, Reason} ->
@@ -155,24 +158,6 @@ parse(Params) ->
                     {error, ErrorReason}
             end
     end.
-parse_who(#{as := As, who := Who}) ->
-    parse_who(#{<<"as">> => As, <<"who">> => Who});
-parse_who(#{<<"as">> := peerhost, <<"who">> := Peerhost0}) ->
-    case inet:parse_address(binary_to_list(Peerhost0)) of
-        {ok, Peerhost} -> {peerhost, Peerhost};
-        {error, einval} -> {error, "bad peerhost"}
-    end;
-parse_who(#{<<"as">> := As, <<"who">> := Who}) ->
-    {As, Who}.
-
-maybe_format_host({peerhost, Host}) ->
-    AddrBinary = list_to_binary(inet:ntoa(Host)),
-    {peerhost, AddrBinary};
-maybe_format_host({As, Who}) ->
-    {As, Who}.
-
-to_rfc3339(Timestamp) ->
-    emqx_utils_calendar:epoch_to_rfc3339(Timestamp, second).
 
 -spec create(emqx_types:banned() | map()) ->
     {ok, emqx_types:banned()} | {error, {already_exist, emqx_types:banned()}}.
@@ -194,7 +179,7 @@ create(#{
 create(Banned = #banned{who = Who}) ->
     case look_up(Who) of
         [] ->
-            insert_banned(Banned),
+            insert_banned(table(Who), Banned),
             {ok, Banned};
         [OldBanned = #banned{until = Until}] ->
             %% Don't support shorten or extend the until time by overwrite.
@@ -204,33 +189,52 @@ create(Banned = #banned{who = Who}) ->
                     {error, {already_exist, OldBanned}};
                 %% overwrite expired one is ok.
                 false ->
-                    insert_banned(Banned),
+                    insert_banned(table(Who), Banned),
                     {ok, Banned}
             end
     end.
 
+-spec look_up(emqx_types:banned_who() | map()) -> [emqx_types:banned()].
 look_up(Who) when is_map(Who) ->
     look_up(parse_who(Who));
 look_up(Who) ->
-    mnesia:dirty_read(?BANNED_TAB, Who).
+    mnesia:dirty_read(table(Who), Who).
 
--spec delete(
-    {clientid, emqx_types:clientid()}
-    | {username, emqx_types:username()}
-    | {peerhost, emqx_types:peerhost()}
-) -> ok.
+-spec delete(map() | emqx_types:banned_who()) -> ok.
 delete(Who) when is_map(Who) ->
     delete(parse_who(Who));
 delete(Who) ->
-    mria:dirty_delete(?BANNED_TAB, Who).
+    mria:dirty_delete(table(Who), Who).
 
-info(InfoKey) ->
-    mnesia:table_info(?BANNED_TAB, InfoKey).
+-spec info(size) -> non_neg_integer().
+info(size) ->
+    mnesia:table_info(?BANNED_INDIVIDUAL_TAB, size) + mnesia:table_info(?BANNED_RULE_TAB, size).
 
+-spec clear() -> ok.
 clear() ->
-    _ = mria:clear_table(?BANNED_TAB),
+    _ = mria:clear_table(?BANNED_INDIVIDUAL_TAB),
+    _ = mria:clear_table(?BANNED_RULE_TAB),
     ok.
 
+%% Creating banned with `#banned{}` records is exposed as a public API
+%% so we need helpers to create the `who` field of `#banned{}` records
+-spec who(atom(), binary() | inet:ip_address() | esockd_cidr:cidr()) -> emqx_types:banned_who().
+who(clientid, ClientId) when is_binary(ClientId) -> {clientid, ClientId};
+who(username, Username) when is_binary(Username) -> {username, Username};
+who(peerhost, Peerhost) when is_tuple(Peerhost) -> {peerhost, Peerhost};
+who(peerhost, Peerhost) when is_binary(Peerhost) ->
+    {ok, Addr} = inet:parse_address(binary_to_list(Peerhost)),
+    {peerhost, Addr};
+who(clientid_re, RE) when is_binary(RE) ->
+    {ok, RECompiled} = re:compile(RE),
+    {clientid_re, {RECompiled, RE}};
+who(username_re, RE) when is_binary(RE) ->
+    {ok, RECompiled} = re:compile(RE),
+    {username_re, {RECompiled, RE}};
+who(peerhost_net, CIDR) when is_tuple(CIDR) -> {peerhost_net, CIDR};
+who(peerhost_net, CIDR) when is_binary(CIDR) ->
+    {peerhost_net, esockd_cidr:parse(binary_to_list(CIDR), true)}.
+
 %%--------------------------------------------------------------------
 %% gen_server callbacks
 %%--------------------------------------------------------------------
@@ -265,6 +269,81 @@ code_change(_OldVsn, State, _Extra) ->
 %% Internal functions
 %%--------------------------------------------------------------------
 
+do_check({_, undefined}) ->
+    false;
+do_check(Who) when is_tuple(Who) ->
+    case mnesia:dirty_read(table(Who), Who) of
+        [] -> false;
+        [#banned{until = Until}] -> Until > erlang:system_time(second)
+    end.
+
+do_check_rules(ClientInfo) ->
+    Rules = all_rules(),
+    Now = erlang:system_time(second),
+    lists:any(
+        fun(Rule) -> is_rule_actual(Rule, Now) andalso do_check_rule(Rule, ClientInfo) end, Rules
+    ).
+
+is_rule_actual(#banned{until = Until}, Now) ->
+    Until > Now.
+
+do_check_rule(#banned{who = {clientid_re, {RE, _}}}, #{clientid := ClientId}) ->
+    is_binary(ClientId) andalso re:run(ClientId, RE) =/= nomatch;
+do_check_rule(#banned{who = {clientid_re, _}}, #{}) ->
+    false;
+do_check_rule(#banned{who = {username_re, {RE, _}}}, #{username := Username}) ->
+    is_binary(Username) andalso re:run(Username, RE) =/= nomatch;
+do_check_rule(#banned{who = {username_re, _}}, #{}) ->
+    false;
+do_check_rule(#banned{who = {peerhost_net, CIDR}}, #{peerhost := Peerhost}) ->
+    esockd_cidr:match(Peerhost, CIDR);
+do_check_rule(#banned{who = {peerhost_net, _}}, #{}) ->
+    false.
+
+parse_who(#{as := As, who := Who}) ->
+    parse_who(#{<<"as">> => As, <<"who">> => Who});
+parse_who(#{<<"as">> := peerhost, <<"who">> := Peerhost0}) ->
+    case inet:parse_address(binary_to_list(Peerhost0)) of
+        {ok, Peerhost} -> {peerhost, Peerhost};
+        {error, einval} -> {error, "bad peerhost"}
+    end;
+parse_who(#{<<"as">> := peerhost_net, <<"who">> := CIDRString}) ->
+    try esockd_cidr:parse(binary_to_list(CIDRString), true) of
+        CIDR -> {peerhost_net, CIDR}
+    catch
+        error:Error -> {error, Error}
+    end;
+parse_who(#{<<"as">> := AsRE, <<"who">> := Who}) when
+    AsRE =:= clientid_re orelse AsRE =:= username_re
+->
+    case re:compile(Who) of
+        {ok, RE} -> {AsRE, {RE, Who}};
+        {error, _} = Error -> Error
+    end;
+parse_who(#{<<"as">> := As, <<"who">> := Who}) when As =:= clientid orelse As =:= username ->
+    {As, Who}.
+
+format_who({peerhost, Host}) ->
+    AddrBinary = list_to_binary(inet:ntoa(Host)),
+    {peerhost, AddrBinary};
+format_who({peerhost_net, CIDR}) ->
+    CIDRBinary = list_to_binary(esockd_cidr:to_string(CIDR)),
+    {peerhost_net, CIDRBinary};
+format_who({AsRE, {_RE, REOriginal}}) when AsRE =:= clientid_re orelse AsRE =:= username_re ->
+    {AsRE, REOriginal};
+format_who({As, Who}) when As =:= clientid orelse As =:= username ->
+    {As, Who}.
+
+to_rfc3339(Timestamp) ->
+    emqx_utils_calendar:epoch_to_rfc3339(Timestamp, second).
+
+table({username, _Username}) -> ?BANNED_INDIVIDUAL_TAB;
+table({clientid, _ClientId}) -> ?BANNED_INDIVIDUAL_TAB;
+table({peerhost, _Peerhost}) -> ?BANNED_INDIVIDUAL_TAB;
+table({username_re, _UsernameRE}) -> ?BANNED_RULE_TAB;
+table({clientid_re, _ClientIdRE}) -> ?BANNED_RULE_TAB;
+table({peerhost_net, _PeerhostNet}) -> ?BANNED_RULE_TAB.
+
 -ifdef(TEST).
 ensure_expiry_timer(State) ->
     State#{expiry_timer := emqx_utils:start_timer(10, expire)}.
@@ -274,19 +353,27 @@ ensure_expiry_timer(State) ->
 -endif.
 
 expire_banned_items(Now) ->
+    lists:foreach(
+        fun(Tab) ->
+            expire_banned_items(Now, Tab)
+        end,
+        [?BANNED_INDIVIDUAL_TAB, ?BANNED_RULE_TAB]
+    ).
+
+expire_banned_items(Now, Tab) ->
     mnesia:foldl(
         fun
             (B = #banned{until = Until}, _Acc) when Until < Now ->
-                mnesia:delete_object(?BANNED_TAB, B, sticky_write);
+                mnesia:delete_object(Tab, B, sticky_write);
             (_, _Acc) ->
                 ok
         end,
         ok,
-        ?BANNED_TAB
+        Tab
     ).
 
-insert_banned(Banned) ->
-    mria:dirty_write(?BANNED_TAB, Banned),
+insert_banned(Tab, Banned) ->
+    mria:dirty_write(Tab, Banned),
     on_banned(Banned).
 
 on_banned(#banned{who = {clientid, ClientId}}) ->
@@ -302,3 +389,6 @@ on_banned(#banned{who = {clientid, ClientId}}) ->
     ok;
 on_banned(_) ->
     ok.
+
+all_rules() ->
+    ets:tab2list(?BANNED_RULE_TAB).
diff --git a/apps/emqx/src/emqx_flapping.erl b/apps/emqx/src/emqx_flapping.erl
index 7e8b8f9fc..1615c8aba 100644
--- a/apps/emqx/src/emqx_flapping.erl
+++ b/apps/emqx/src/emqx_flapping.erl
@@ -150,7 +150,7 @@ handle_cast(
             ),
             Now = erlang:system_time(second),
             Banned = #banned{
-                who = {clientid, ClientId},
+                who = emqx_banned:who(clientid, ClientId),
                 by = <<"flapping detector">>,
                 reason = <<"flapping is detected">>,
                 at = Now,
diff --git a/apps/emqx/src/emqx_types.erl b/apps/emqx/src/emqx_types.erl
index 087bcaebe..c99ddbe13 100644
--- a/apps/emqx/src/emqx_types.erl
+++ b/apps/emqx/src/emqx_types.erl
@@ -100,6 +100,7 @@
 
 -export_type([
     banned/0,
+    banned_who/0,
     command/0
 ]).
 
@@ -246,6 +247,14 @@
 }.
 
 -type banned() :: #banned{}.
+-type banned_who() ::
+    {clientid, binary()}
+    | {peerhost, inet:ip_address()}
+    | {username, binary()}
+    | {clientid_re, {_RE :: tuple(), binary()}}
+    | {username_re, {_RE :: tuple(), binary()}}
+    | {peerhost_net, esockd_cidr:cidr()}.
+
 -type deliver() :: {deliver, topic(), message()}.
 -type delivery() :: #delivery{}.
 -type deliver_result() :: ok | {ok, non_neg_integer()} | {error, term()}.
diff --git a/apps/emqx/test/emqx_banned_SUITE.erl b/apps/emqx/test/emqx_banned_SUITE.erl
index 8c86e17f6..b4bd3d444 100644
--- a/apps/emqx/test/emqx_banned_SUITE.erl
+++ b/apps/emqx/test/emqx_banned_SUITE.erl
@@ -34,7 +34,7 @@ end_per_suite(Config) ->
 
 t_add_delete(_) ->
     Banned = #banned{
-        who = {clientid, <<"TestClient">>},
+        who = emqx_banned:who(clientid, <<"TestClient">>),
         by = <<"banned suite">>,
         reason = <<"test">>,
         at = erlang:system_time(second),
@@ -47,54 +47,91 @@ t_add_delete(_) ->
         emqx_banned:create(Banned#banned{until = erlang:system_time(second) + 100}),
     ?assertEqual(1, emqx_banned:info(size)),
 
-    ok = emqx_banned:delete({clientid, <<"TestClient">>}),
+    ok = emqx_banned:delete(emqx_banned:who(clientid, <<"TestClient">>)),
     ?assertEqual(0, emqx_banned:info(size)).
 
 t_check(_) ->
-    {ok, _} = emqx_banned:create(#banned{who = {clientid, <<"BannedClient">>}}),
-    {ok, _} = emqx_banned:create(#banned{who = {username, <<"BannedUser">>}}),
-    {ok, _} = emqx_banned:create(#banned{who = {peerhost, {192, 168, 0, 1}}}),
-    ?assertEqual(3, emqx_banned:info(size)),
-    ClientInfo1 = #{
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(clientid, <<"BannedClient">>)}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(username, <<"BannedUser">>)}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(peerhost, {192, 168, 0, 1})}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(peerhost, <<"192.168.0.2">>)}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(clientid_re, <<"BannedClientRE.*">>)}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(username_re, <<"BannedUserRE.*">>)}),
+    {ok, _} = emqx_banned:create(#banned{who = emqx_banned:who(peerhost_net, <<"192.168.3.0/24">>)}),
+
+    ?assertEqual(7, emqx_banned:info(size)),
+    ClientInfoBannedClientId = #{
         clientid => <<"BannedClient">>,
         username => <<"user">>,
         peerhost => {127, 0, 0, 1}
     },
-    ClientInfo2 = #{
+    ClientInfoBannedUsername = #{
         clientid => <<"client">>,
         username => <<"BannedUser">>,
         peerhost => {127, 0, 0, 1}
     },
-    ClientInfo3 = #{
+    ClientInfoBannedAddr1 = #{
         clientid => <<"client">>,
         username => <<"user">>,
         peerhost => {192, 168, 0, 1}
     },
-    ClientInfo4 = #{
+    ClientInfoBannedAddr2 = #{
+        clientid => <<"client">>,
+        username => <<"user">>,
+        peerhost => {192, 168, 0, 2}
+    },
+    ClientInfoBannedClientIdRE = #{
+        clientid => <<"BannedClientRE1">>,
+        username => <<"user">>,
+        peerhost => {127, 0, 0, 1}
+    },
+    ClientInfoBannedUsernameRE = #{
+        clientid => <<"client">>,
+        username => <<"BannedUserRE1">>,
+        peerhost => {127, 0, 0, 1}
+    },
+    ClientInfoBannedAddrNet = #{
+        clientid => <<"client">>,
+        username => <<"user">>,
+        peerhost => {192, 168, 3, 1}
+    },
+    ClientInfoValidFull = #{
         clientid => <<"client">>,
         username => <<"user">>,
         peerhost => {127, 0, 0, 1}
     },
-    ClientInfo5 = #{},
-    ClientInfo6 = #{clientid => <<"client1">>},
-    ?assert(emqx_banned:check(ClientInfo1)),
-    ?assert(emqx_banned:check(ClientInfo2)),
-    ?assert(emqx_banned:check(ClientInfo3)),
-    ?assertNot(emqx_banned:check(ClientInfo4)),
-    ?assertNot(emqx_banned:check(ClientInfo5)),
-    ?assertNot(emqx_banned:check(ClientInfo6)),
-    ok = emqx_banned:delete({clientid, <<"BannedClient">>}),
-    ok = emqx_banned:delete({username, <<"BannedUser">>}),
-    ok = emqx_banned:delete({peerhost, {192, 168, 0, 1}}),
-    ?assertNot(emqx_banned:check(ClientInfo1)),
-    ?assertNot(emqx_banned:check(ClientInfo2)),
-    ?assertNot(emqx_banned:check(ClientInfo3)),
-    ?assertNot(emqx_banned:check(ClientInfo4)),
+    ClientInfoValidEmpty = #{},
+    ClientInfoValidOnlyClientId = #{clientid => <<"client1">>},
+    ?assert(emqx_banned:check(ClientInfoBannedClientId)),
+    ?assert(emqx_banned:check(ClientInfoBannedUsername)),
+    ?assert(emqx_banned:check(ClientInfoBannedAddr1)),
+    ?assert(emqx_banned:check(ClientInfoBannedAddr2)),
+    ?assert(emqx_banned:check(ClientInfoBannedClientIdRE)),
+    ?assert(emqx_banned:check(ClientInfoBannedUsernameRE)),
+    ?assert(emqx_banned:check(ClientInfoBannedAddrNet)),
+    ?assertNot(emqx_banned:check(ClientInfoValidFull)),
+    ?assertNot(emqx_banned:check(ClientInfoValidEmpty)),
+    ?assertNot(emqx_banned:check(ClientInfoValidOnlyClientId)),
+    ok = emqx_banned:delete(emqx_banned:who(clientid, <<"BannedClient">>)),
+    ok = emqx_banned:delete(emqx_banned:who(username, <<"BannedUser">>)),
+    ok = emqx_banned:delete(emqx_banned:who(peerhost, {192, 168, 0, 1})),
+    ok = emqx_banned:delete(emqx_banned:who(peerhost, <<"192.168.0.2">>)),
+    ok = emqx_banned:delete(emqx_banned:who(clientid_re, <<"BannedClientRE.*">>)),
+    ok = emqx_banned:delete(emqx_banned:who(username_re, <<"BannedUserRE.*">>)),
+    ok = emqx_banned:delete(emqx_banned:who(peerhost_net, <<"192.168.3.0/24">>)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedClientId)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedUsername)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedAddr1)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedAddr2)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedClientIdRE)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedUsernameRE)),
+    ?assertNot(emqx_banned:check(ClientInfoBannedAddrNet)),
+    ?assertNot(emqx_banned:check(ClientInfoValidFull)),
     ?assertEqual(0, emqx_banned:info(size)).
 
 t_unused(_) ->
-    Who1 = {clientid, <<"BannedClient1">>},
-    Who2 = {clientid, <<"BannedClient2">>},
+    Who1 = emqx_banned:who(clientid, <<"BannedClient1">>),
+    Who2 = emqx_banned:who(clientid, <<"BannedClient2">>),
 
     ?assertMatch(
         {ok, _},
@@ -123,7 +160,7 @@ t_kick(_) ->
     snabbkaffe:start_trace(),
 
     Now = erlang:system_time(second),
-    Who = {clientid, ClientId},
+    Who = emqx_banned:who(clientid, ClientId),
 
     emqx_banned:create(#{
         who => Who,
@@ -194,7 +231,7 @@ t_session_taken(_) ->
     Publish(),
 
     Now = erlang:system_time(second),
-    Who = {clientid, ClientId2},
+    Who = emqx_banned:who(clientid, ClientId2),
     emqx_banned:create(#{
         who => Who,
         by => <<"test">>,
diff --git a/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl b/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
index e0ef906ad..cee120acb 100644
--- a/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
+++ b/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
@@ -561,7 +561,7 @@ t_publish_last_will_testament_banned_client_connecting(_Config) ->
 
     %% Now we ban the client while it is connected.
     Now = erlang:system_time(second),
-    Who = {username, Username},
+    Who = emqx_banned:who(username, Username),
     emqx_banned:create(#{
         who => Who,
         by => <<"test">>,
diff --git a/apps/emqx_management/src/emqx_mgmt_api.erl b/apps/emqx_management/src/emqx_mgmt_api.erl
index 4db37a7dc..645b701f0 100644
--- a/apps/emqx_management/src/emqx_mgmt_api.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api.erl
@@ -79,17 +79,19 @@
 }.
 
 -type query_return() :: #{meta := map(), data := [term()]}.
+-type table_name() :: atom().
+-type table_names() :: [table_name()].
 
 -export([do_query/2, apply_total_query/1]).
 
--spec paginate(atom(), map(), {atom(), atom()}) ->
+-spec paginate(table_name() | table_names(), map(), {atom(), atom()}) ->
     #{
         meta => #{page => pos_integer(), limit => pos_integer(), count => pos_integer()},
         data => list(term())
     }.
-paginate(Table, Params, {Module, FormatFun}) ->
-    Qh = query_handle(Table),
-    Count = count(Table),
+paginate(Tables, Params, {Module, FormatFun}) ->
+    Qh = query_handle(Tables),
+    Count = count(Tables),
     do_paginate(Qh, Count, Params, {Module, FormatFun}).
 
 do_paginate(Qh, Count, Params, {Module, FormatFun}) ->
@@ -110,9 +112,13 @@ do_paginate(Qh, Count, Params, {Module, FormatFun}) ->
         data => [erlang:apply(Module, FormatFun, [Row]) || Row <- Rows]
     }.
 
+query_handle(Tables) when is_list(Tables) ->
+    qlc:append([query_handle(T) || T <- Tables]);
 query_handle(Table) ->
-    qlc:q([R || R <- ets:table(Table)]).
+    ets:table(Table).
 
+count(Tables) when is_list(Tables) ->
+    lists:sum([count(T) || T <- Tables]);
 count(Table) ->
     ets:info(Table, size).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_banned.erl b/apps/emqx_management/src/emqx_mgmt_api_banned.erl
index 6c1d407b5..cf1ab3c49 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_banned.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_banned.erl
@@ -38,10 +38,9 @@
     delete_banned/2
 ]).
 
--define(TAB, emqx_banned).
 -define(TAGS, [<<"Banned">>]).
 
--define(BANNED_TYPES, [clientid, username, peerhost]).
+-define(BANNED_TYPES, [clientid, username, peerhost, clientid_re, username_re, peerhost_net]).
 
 -define(FORMAT_FUN, {?MODULE, format}).
 
@@ -161,7 +160,7 @@ fields(ban) ->
     ].
 
 banned(get, #{query_string := Params}) ->
-    Response = emqx_mgmt_api:paginate(?TAB, Params, ?FORMAT_FUN),
+    Response = emqx_mgmt_api:paginate(emqx_banned:tables(), Params, ?FORMAT_FUN),
     {200, Response};
 banned(post, #{body := Body}) ->
     case emqx_banned:parse(Body) of
diff --git a/apps/emqx_management/test/emqx_mgmt_api_banned_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_banned_SUITE.erl
index 3167a5621..9ef4f1b7d 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_banned_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_banned_SUITE.erl
@@ -40,6 +40,8 @@ t_create(_Config) ->
     By = <<"banned suite测试组"/utf8>>,
     Reason = <<"test测试"/utf8>>,
     As = <<"clientid">>,
+
+    %% ban by clientid
     ClientIdBanned = #{
         as => As,
         who => ClientId,
@@ -60,6 +62,8 @@ t_create(_Config) ->
         },
         ClientIdBannedRes
     ),
+
+    %% ban by peerhost
     PeerHost = <<"192.168.2.13">>,
     PeerHostBanned = #{
         as => <<"peerhost">>,
@@ -81,9 +85,88 @@ t_create(_Config) ->
         },
         PeerHostBannedRes
     ),
+
+    %% ban by username RE
+    UsernameRE = <<"BannedUser.*">>,
+    UsernameREBanned = #{
+        as => <<"username_re">>,
+        who => UsernameRE,
+        by => By,
+        reason => Reason,
+        at => At,
+        until => Until
+    },
+    {ok, UsernameREBannedRes} = create_banned(UsernameREBanned),
+    ?assertEqual(
+        #{
+            <<"as">> => <<"username_re">>,
+            <<"at">> => At,
+            <<"by">> => By,
+            <<"reason">> => Reason,
+            <<"until">> => Until,
+            <<"who">> => UsernameRE
+        },
+        UsernameREBannedRes
+    ),
+
+    %% ban by clientid RE
+    ClientIdRE = <<"BannedClient.*">>,
+    ClientIdREBanned = #{
+        as => <<"clientid_re">>,
+        who => ClientIdRE,
+        by => By,
+        reason => Reason,
+        at => At,
+        until => Until
+    },
+    {ok, ClientIdREBannedRes} = create_banned(ClientIdREBanned),
+    ?assertEqual(
+        #{
+            <<"as">> => <<"clientid_re">>,
+            <<"at">> => At,
+            <<"by">> => By,
+            <<"reason">> => Reason,
+            <<"until">> => Until,
+            <<"who">> => ClientIdRE
+        },
+        ClientIdREBannedRes
+    ),
+
+    %% ban by CIDR
+    PeerHostNet = <<"192.168.0.0/24">>,
+    PeerHostNetBanned = #{
+        as => <<"peerhost_net">>,
+        who => PeerHostNet,
+        by => By,
+        reason => Reason,
+        at => At,
+        until => Until
+    },
+    {ok, PeerHostNetBannedRes} = create_banned(PeerHostNetBanned),
+    ?assertEqual(
+        #{
+            <<"as">> => <<"peerhost_net">>,
+            <<"at">> => At,
+            <<"by">> => By,
+            <<"reason">> => Reason,
+            <<"until">> => Until,
+            <<"who">> => PeerHostNet
+        },
+        PeerHostNetBannedRes
+    ),
+
     {ok, #{<<"data">> := List}} = list_banned(),
     Bans = lists:sort(lists:map(fun(#{<<"who">> := W, <<"as">> := A}) -> {A, W} end, List)),
-    ?assertEqual([{<<"clientid">>, ClientId}, {<<"peerhost">>, PeerHost}], Bans),
+    ?assertEqual(
+        [
+            {<<"clientid">>, ClientId},
+            {<<"clientid_re">>, ClientIdRE},
+            {<<"peerhost">>, PeerHost},
+            {<<"peerhost_net">>, PeerHostNet},
+            {<<"username_re">>, UsernameRE}
+        ],
+        Bans
+    ),
 
     ClientId2 = <<"TestClient2"/utf8>>,
     ClientIdBanned2 = #{
diff --git a/apps/emqx_modules/test/emqx_delayed_SUITE.erl b/apps/emqx_modules/test/emqx_delayed_SUITE.erl
index 5085aa2da..631e7c1aa 100644
--- a/apps/emqx_modules/test/emqx_delayed_SUITE.erl
+++ b/apps/emqx_modules/test/emqx_delayed_SUITE.erl
@@ -217,7 +217,7 @@ t_banned_delayed(_) ->
     ClientId2 = <<"bc2">>,
 
     Now = erlang:system_time(second),
-    Who = {clientid, ClientId2},
+    Who = emqx_banned:who(clientid, ClientId2),
     emqx_banned:create(#{
         who => Who,
         by => <<"test">>,
diff --git a/apps/emqx_retainer/test/emqx_retainer_SUITE.erl b/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
index c76ba90c6..71b1ef900 100644
--- a/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
+++ b/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
@@ -698,7 +698,7 @@ t_deliver_when_banned(_) ->
     ),
 
     Now = erlang:system_time(second),
-    Who = {clientid, Client2},
+    Who = emqx_banned:who(clientid, Client2),
 
     emqx_banned:create(#{
         who => Who,
diff --git a/changes/ce/feat-12499.en.md b/changes/ce/feat-12499.en.md
new file mode 100644
index 000000000..2649e3cd2
--- /dev/null
+++ b/changes/ce/feat-12499.en.md
@@ -0,0 +1,5 @@
+Added ability to ban clients by extended rules:
+* by matching `clientid`s to a regular expression;
+* by matching client's `username` to a regular expression;
+* by matching client's peer address to an CIDR range.
+
diff --git a/rel/i18n/emqx_mgmt_api_banned.hocon b/rel/i18n/emqx_mgmt_api_banned.hocon
index 4bf72103f..6d5470bc9 100644
--- a/rel/i18n/emqx_mgmt_api_banned.hocon
+++ b/rel/i18n/emqx_mgmt_api_banned.hocon
@@ -1,7 +1,8 @@
 emqx_mgmt_api_banned {
 
 as.desc:
-"""Ban method, which can be client ID, username or IP address."""
+"""Ban method, which can be exact client ID, client ID regular expression, exact username, username regular expression,
+IP address or an IP address range."""
 
 as.label:
 """Ban Method"""

From d4fb3e83f69162df46a203e1a6e8fa56ec1ccd6d Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Mon, 12 Feb 2024 08:49:37 +0100
Subject: [PATCH 197/273] chore: upgrade to wolff 1.10.2

Wolff 1.10.2 added an enhancement which makes Kafka resource health
checks more lightweight and lowers the chance of false resource alerts.
---
 apps/emqx_bridge_azure_event_hub/rebar.config | 2 +-
 apps/emqx_bridge_confluent/rebar.config       | 2 +-
 apps/emqx_bridge_kafka/rebar.config           | 2 +-
 changes/ce/fix-12505.en.md                    | 5 +++++
 mix.exs                                       | 2 +-
 5 files changed, 9 insertions(+), 4 deletions(-)
 create mode 100644 changes/ce/fix-12505.en.md

diff --git a/apps/emqx_bridge_azure_event_hub/rebar.config b/apps/emqx_bridge_azure_event_hub/rebar.config
index f3be8f986..f10ef1646 100644
--- a/apps/emqx_bridge_azure_event_hub/rebar.config
+++ b/apps/emqx_bridge_azure_event_hub/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/apps/emqx_bridge_confluent/rebar.config b/apps/emqx_bridge_confluent/rebar.config
index 21fff1a5e..93f8306f7 100644
--- a/apps/emqx_bridge_confluent/rebar.config
+++ b/apps/emqx_bridge_confluent/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/apps/emqx_bridge_kafka/rebar.config b/apps/emqx_bridge_kafka/rebar.config
index b71efaf96..6e1ef0007 100644
--- a/apps/emqx_bridge_kafka/rebar.config
+++ b/apps/emqx_bridge_kafka/rebar.config
@@ -2,7 +2,7 @@
 
 {erl_opts, [debug_info]}.
 {deps, [
-    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.1"}}},
+    {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
     {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
diff --git a/changes/ce/fix-12505.en.md b/changes/ce/fix-12505.en.md
new file mode 100644
index 000000000..ed8b0b52f
--- /dev/null
+++ b/changes/ce/fix-12505.en.md
@@ -0,0 +1,5 @@
+Upgrade Kafka producer client `wolff` from version 1.10.1 to 1.10.2
+
+The new version client keeps a long-lived metadata connection for each connector.
+This makes EMQX perform less new connection establishment for
+action and connector healchecks.
diff --git a/mix.exs b/mix.exs
index c2eaddcd9..5bb099828 100644
--- a/mix.exs
+++ b/mix.exs
@@ -201,7 +201,7 @@ defmodule EMQXUmbrella.MixProject do
     [
       {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.4.5+v0.16.1"},
       {:influxdb, github: "emqx/influxdb-client-erl", tag: "1.1.13", override: true},
-      {:wolff, github: "kafka4beam/wolff", tag: "1.10.1"},
+      {:wolff, github: "kafka4beam/wolff", tag: "1.10.2"},
       {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.3", override: true},
       {:brod_gssapi, github: "kafka4beam/brod_gssapi", tag: "v0.1.1"},
       {:brod, github: "kafka4beam/brod", tag: "3.16.8"},

From 976099f5fbb3f1894b77d9017465bef114ff4eef Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Mon, 12 Feb 2024 10:16:17 +0100
Subject: [PATCH 198/273] fix: cleanups due to problems found by @thalesmg

---
 apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl       | 4 ----
 .../src/emqx_bridge_rocketmq_connector.erl                   | 5 -----
 2 files changed, 9 deletions(-)

diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
index faac69095..22514dc5c 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
@@ -64,8 +64,6 @@ conn_bridge_example_values(post) ->
 conn_bridge_example_values(put) ->
     conn_bridge_example_values(post).
 
-%% TODO fix these examples
-
 connector_examples(Method) ->
     [
         #{
@@ -226,8 +224,6 @@ desc("config") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for RocketMQ using `", string:to_upper(Method), "` method."];
-desc("creation_opts") ->
-    ?DESC(emqx_resource_schema, "creation_opts");
 desc("config_connector") ->
     ?DESC("config_connector");
 desc(rocketmq_action) ->
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
index baa895a8a..c9a7ce177 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
@@ -110,11 +110,6 @@ on_start(
         client_id => ClientId,
         acl_info => ACLInfo,
         installed_channels => #{}
-        % topic => Topic,
-        % topic_tokens => TopicTks,
-        % sync_timeout => SyncTimeout,
-        % templates => Templates,
-        % producers_opts => ProducerOpts
     },
 
     ok = emqx_resource:allocate_resource(InstanceId, client_id, ClientId),

From 5b7bb89f37e09de3b322d5cb9d9edaf5447541ec Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Mon, 12 Feb 2024 10:39:42 +0100
Subject: [PATCH 199/273] docs(s3): add missing labels and fix wording

Co-authored-by: Zaiming (Stone) Shi <zmstone@gmail.com>
---
 rel/i18n/emqx_s3_schema.hocon | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/rel/i18n/emqx_s3_schema.hocon b/rel/i18n/emqx_s3_schema.hocon
index cfecaf47e..44f4bbc56 100644
--- a/rel/i18n/emqx_s3_schema.hocon
+++ b/rel/i18n/emqx_s3_schema.hocon
@@ -9,8 +9,14 @@ secret_access_key.desc:
 bucket.desc:
 """The name of the S3 bucket."""
 
+bucket.label:
+"""Bucket"""
+
 key.desc:
-"""Key of the S3 object being manipulated."""
+"""Key of the S3 object."""
+
+key.label:
+"""Object Key"""
 
 host.desc:
 """The host of the S3 endpoint."""

From 0edc5b5992f69f9dbba6a510bcd52babf609c7de Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Mon, 12 Feb 2024 10:44:18 +0100
Subject: [PATCH 200/273] docs(s3): fix README example

---
 apps/emqx_s3/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx_s3/README.md b/apps/emqx_s3/README.md
index 4ce1b0c0a..c2627cc08 100644
--- a/apps/emqx_s3/README.md
+++ b/apps/emqx_s3/README.md
@@ -18,7 +18,7 @@ The steps to integrate this application are:
 `ProfileName` is a unique name used to distinguish different sets of S3 settings. Each profile has its own connection pool and configuration.
 
 To use S3 from a _client_ application:
-* Create an uploader process with `{ok, Pid} = emqx_s3:start_uploader(ProfileName, #{key => MyKey})`.
+* Create an uploader process with `{ok, Pid} = emqx_s3:start_uploader(ProfileName, MyKey, _Opts = #{})`.
 * Write data with `emqx_s3_uploader:write(Pid, <<"data">>)`.
 * Finish the uploader with `emqx_s3_uploader:complete(Pid)` or `emqx_s3_uploader:abort(Pid)`.
 

From 8a4c66dc759a974ccdaa82105396ad8628247104 Mon Sep 17 00:00:00 2001
From: Ilya Averyanov <av@rubybox.dev>
Date: Mon, 12 Feb 2024 12:56:03 +0300
Subject: [PATCH 201/273] feat(banned): add warning about performance impact of
 matching rules

---
 changes/ce/feat-12499.en.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/changes/ce/feat-12499.en.md b/changes/ce/feat-12499.en.md
index 2649e3cd2..8724b66e7 100644
--- a/changes/ce/feat-12499.en.md
+++ b/changes/ce/feat-12499.en.md
@@ -3,3 +3,5 @@ Added ability to ban clients by extended rules:
 * by matching client's `username` to a regular expression;
 * by matching client's peer address to an CIDR range.
 
+Warning: large number of matching rules (not tied to a concrete clientid, username or host) will impact performance.
+

From 2b1231b980e56554ae304087a168ba958fcc61d9 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Mon, 12 Feb 2024 10:44:43 +0100
Subject: [PATCH 202/273] fix(s3-bridge): ensure bridge and connector names are
 identical

---
 apps/emqx_bridge_s3/src/emqx_bridge_s3.erl             | 2 ++
 apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl             | 2 +-
 apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl | 2 +-
 apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl      | 2 +-
 4 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
index 335b4bf11..eff5282db 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.erl
@@ -101,6 +101,8 @@ fields(s3_connector_resource_opts) ->
 
 desc("config_connector") ->
     ?DESC(config_connector);
+desc(?ACTION) ->
+    ?DESC(s3_upload);
 desc(s3_upload) ->
     ?DESC(s3_upload);
 desc(s3_upload_parameters) ->
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl b/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
index fb513c586..6d500d056 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3.hrl
@@ -5,7 +5,7 @@
 -ifndef(__EMQX_BRIDGE_S3_HRL__).
 -define(__EMQX_BRIDGE_S3_HRL__, true).
 
--define(ACTION, s3_upload).
+-define(ACTION, s3).
 -define(CONNECTOR, s3).
 
 -endif.
diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
index 6c66a8f35..646173bf4 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3_action_info.erl
@@ -12,7 +12,7 @@
     schema_module/0
 ]).
 
-action_type_name() -> s3_upload.
+action_type_name() -> s3.
 
 connector_type_name() -> s3.
 
diff --git a/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
index 3d6637ebd..5de30578b 100644
--- a/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
+++ b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
@@ -13,7 +13,7 @@
 -import(emqx_utils_conv, [bin/1]).
 
 %% See `emqx_bridge_s3.hrl`.
--define(BRIDGE_TYPE, <<"s3_upload">>).
+-define(BRIDGE_TYPE, <<"s3">>).
 -define(CONNECTOR_TYPE, <<"s3">>).
 
 -define(PROXY_NAME, "minio_tcp").

From a4eac75b25f8975dbc6a7c748f4e885181caf64f Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Mon, 12 Feb 2024 18:20:03 +0100
Subject: [PATCH 203/273] fix(s3-bridge): handle recoverable AWS errors

---
 .../src/emqx_bridge_s3_connector.erl          |  4 +-
 .../test/emqx_bridge_s3_SUITE.erl             | 39 +++++++++++++++++--
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
index 9a0f110fe..a072c0464 100644
--- a/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
+++ b/apps/emqx_bridge_s3/src/emqx_bridge_s3_connector.erl
@@ -196,8 +196,10 @@ run_simple_upload(
 
 map_error({socket_error, _} = Reason) ->
     {recoverable_error, Reason};
+map_error(Reason = {aws_error, Status, _, _Body}) when Status >= 500 ->
+    %% https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
+    {recoverable_error, Reason};
 map_error(Reason) ->
-    %% TODO: Recoverable errors.
     {unrecoverable_error, Reason}.
 
 render_bucket(Template, Data) ->
diff --git a/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
index 5de30578b..da9787911 100644
--- a/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
+++ b/apps/emqx_bridge_s3/test/emqx_bridge_s3_SUITE.erl
@@ -9,6 +9,7 @@
 
 -include_lib("eunit/include/eunit.hrl").
 -include_lib("common_test/include/ct.hrl").
+-include_lib("snabbkaffe/include/test_macros.hrl").
 
 -import(emqx_utils_conv, [bin/1]).
 
@@ -89,8 +90,8 @@ connector_config(Name, _Config) ->
             <<"headers">> => #{
                 <<"content-type">> => <<?CONTENT_TYPE>>
             },
-            <<"connect_timeout">> => 1000,
-            <<"request_timeout">> => 1000,
+            <<"connect_timeout">> => <<"500ms">>,
+            <<"request_timeout">> => <<"1s">>,
             <<"pool_size">> => 4,
             <<"max_retries">> => 0,
             <<"enable_pipelining">> => 1
@@ -110,13 +111,13 @@ action_config(Name, ConnectorId) ->
         <<"resource_opts">> => #{
             <<"buffer_mode">> => <<"memory_only">>,
             <<"buffer_seg_bytes">> => <<"10MB">>,
-            <<"health_check_interval">> => <<"5s">>,
+            <<"health_check_interval">> => <<"3s">>,
             <<"inflight_window">> => 40,
             <<"max_buffer_bytes">> => <<"256MB">>,
             <<"metrics_flush_interval">> => <<"1s">>,
             <<"query_mode">> => <<"sync">>,
             <<"request_ttl">> => <<"60s">>,
-            <<"resume_interval">> => <<"5s">>,
+            <<"resume_interval">> => <<"3s">>,
             <<"worker_pool_size">> => <<"4">>
         }
     }).
@@ -165,6 +166,36 @@ t_sync_query(Config) ->
         maps:from_list(erlcloud_s3:get_object(Bucket, Topic, AwsConfig))
     ).
 
+t_query_retry_recoverable(Config) ->
+    ProxyHost = ?config(proxy_host, Config),
+    ProxyPort = ?config(proxy_port, Config),
+    BridgeName = ?config(bridge_name, Config),
+    Bucket = emqx_s3_test_helpers:unique_bucket(),
+    Topic = "d/e/f",
+    Payload = rand:bytes(1024),
+    AwsConfig = emqx_s3_test_helpers:aws_config(tcp),
+    ok = erlcloud_s3:create_bucket(Bucket, AwsConfig),
+    %% Create a bridge with the sample configuration.
+    ?assertMatch(
+        {ok, _Bridge},
+        emqx_bridge_v2_testlib:create_bridge(Config)
+    ),
+    %% Simulate recoverable failure.
+    _ = emqx_common_test_helpers:enable_failure(timeout, ?PROXY_NAME, ProxyHost, ProxyPort),
+    _ = timer:apply_after(
+        _Timeout = 5000,
+        emqx_common_test_helpers,
+        heal_failure,
+        [timeout, ?PROXY_NAME, ProxyHost, ProxyPort]
+    ),
+    Message = mk_message(Bucket, Topic, Payload),
+    %% Verify that the message is sent eventually.
+    ok = emqx_bridge_v2:send_message(?BRIDGE_TYPE, BridgeName, Message, #{}),
+    ?assertMatch(
+        #{content := Payload},
+        maps:from_list(erlcloud_s3:get_object(Bucket, Topic, AwsConfig))
+    ).
+
 mk_message(ClientId, Topic, Payload) ->
     Message = emqx_message:make(bin(ClientId), bin(Topic), Payload),
     {Event, _} = emqx_rule_events:eventmsg_publish(Message),

From 21a57515750c2e606fa1cafe53a399b242b8dd03 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 19:07:02 +0100
Subject: [PATCH 204/273] feat(emqx): manage mria tables explicitly during
 startup

---
 apps/emqx/src/emqx_alarm.erl                  | 12 +++++-------
 apps/emqx/src/emqx_banned.erl                 |  9 ++++-----
 apps/emqx/src/emqx_broker_sup.erl             |  4 ++++
 apps/emqx/src/emqx_cm_sup.erl                 |  1 +
 apps/emqx/src/emqx_exclusive_subscription.erl | 11 ++++-------
 apps/emqx/src/emqx_router.erl                 |  9 ++++-----
 apps/emqx/src/emqx_router_helper.erl          |  9 ++++-----
 apps/emqx/src/emqx_router_sup.erl             |  5 +++++
 apps/emqx/src/emqx_shared_sub.erl             |  9 ++++-----
 apps/emqx/src/emqx_sys_sup.erl                |  1 +
 apps/emqx/src/emqx_trie.erl                   | 11 +++++------
 11 files changed, 41 insertions(+), 40 deletions(-)

diff --git a/apps/emqx/src/emqx_alarm.erl b/apps/emqx/src/emqx_alarm.erl
index 8c0c35334..330e2e917 100644
--- a/apps/emqx/src/emqx_alarm.erl
+++ b/apps/emqx/src/emqx_alarm.erl
@@ -21,12 +21,9 @@
 -include("emqx.hrl").
 -include("logger.hrl").
 
-%% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
-
+-export([create_tables/0]).
 -export([start_link/0]).
+
 %% API
 -export([
     activate/1,
@@ -86,7 +83,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(
         ?ACTIVATED_ALARM,
         [
@@ -106,7 +103,8 @@ mnesia(boot) ->
             {record_name, deactivated_alarm},
             {attributes, record_info(fields, deactivated_alarm)}
         ]
-    ).
+    ),
+    [?ACTIVATED_ALARM, ?DEACTIVATED_ALARM].
 
 %%--------------------------------------------------------------------
 %% API
diff --git a/apps/emqx/src/emqx_banned.erl b/apps/emqx/src/emqx_banned.erl
index fcb6edc00..db6d63cc7 100644
--- a/apps/emqx/src/emqx_banned.erl
+++ b/apps/emqx/src/emqx_banned.erl
@@ -25,9 +25,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 %% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
+-export([create_tables/0]).
 
 -export([start_link/0, stop/0]).
 
@@ -79,7 +77,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     Options = [
         {type, set},
         {rlog_shard, ?COMMON_SHARD},
@@ -89,7 +87,8 @@ mnesia(boot) ->
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
     ],
     ok = mria:create_table(?BANNED_INDIVIDUAL_TAB, Options),
-    ok = mria:create_table(?BANNED_RULE_TAB, Options).
+    ok = mria:create_table(?BANNED_RULE_TAB, Options),
+    [?BANNED_INDIVIDUAL_TAB, ?BANNED_RULE_TAB].
 
 %%--------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx/src/emqx_broker_sup.erl b/apps/emqx/src/emqx_broker_sup.erl
index aee8dff5d..e64ab6745 100644
--- a/apps/emqx/src/emqx_broker_sup.erl
+++ b/apps/emqx/src/emqx_broker_sup.erl
@@ -23,6 +23,10 @@
 -export([init/1]).
 
 start_link() ->
+    ok = mria:wait_for_tables(
+        emqx_shared_sub:create_tables() ++
+            emqx_exclusive_subscription:create_tables()
+    ),
     supervisor:start_link({local, ?MODULE}, ?MODULE, []).
 
 %%--------------------------------------------------------------------
diff --git a/apps/emqx/src/emqx_cm_sup.erl b/apps/emqx/src/emqx_cm_sup.erl
index 3306b7ccd..58685804b 100644
--- a/apps/emqx/src/emqx_cm_sup.erl
+++ b/apps/emqx/src/emqx_cm_sup.erl
@@ -32,6 +32,7 @@
 %%--------------------------------------------------------------------
 
 start_link() ->
+    ok = mria:wait_for_tables(emqx_banned:create_tables()),
     supervisor:start_link({local, ?MODULE}, ?MODULE, []).
 
 %%--------------------------------------------------------------------
diff --git a/apps/emqx/src/emqx_exclusive_subscription.erl b/apps/emqx/src/emqx_exclusive_subscription.erl
index 3bc08eeca..1698eec26 100644
--- a/apps/emqx/src/emqx_exclusive_subscription.erl
+++ b/apps/emqx/src/emqx_exclusive_subscription.erl
@@ -22,14 +22,11 @@
 -logger_header("[exclusive]").
 
 %% Mnesia bootstrap
--export([mnesia/1]).
+-export([create_tables/0]).
 
 %% For upgrade
 -export([on_add_module/0, on_delete_module/0]).
 
--boot_mnesia({mnesia, [boot]}).
--copy_mnesia({mnesia, [copy]}).
-
 -export([
     check_subscribe/2,
     unsubscribe/2,
@@ -53,7 +50,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     StoreProps = [
         {ets, [
             {read_concurrency, true},
@@ -68,14 +65,14 @@ mnesia(boot) ->
         {attributes, record_info(fields, exclusive_subscription)},
         {storage_properties, StoreProps}
     ]),
-    ok = mria_rlog:wait_for_shards([?EXCLUSIVE_SHARD], infinity).
+    [?TAB].
 
 %%--------------------------------------------------------------------
 %% Upgrade
 %%--------------------------------------------------------------------
 
 on_add_module() ->
-    mnesia(boot).
+    mria:wait_for_tables(create_tables()).
 
 on_delete_module() ->
     clear().
diff --git a/apps/emqx/src/emqx_router.erl b/apps/emqx/src/emqx_router.erl
index e7ab37ace..3576ad679 100644
--- a/apps/emqx/src/emqx_router.erl
+++ b/apps/emqx/src/emqx_router.erl
@@ -24,9 +24,7 @@
 -include_lib("emqx/include/emqx_router.hrl").
 
 %% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
+-export([create_tables/0]).
 
 -export([start_link/2]).
 
@@ -123,7 +121,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     mria_config:set_dirty_shard(?ROUTE_SHARD, true),
     ok = mria:create_table(?ROUTE_TAB, [
         {type, bag},
@@ -151,7 +149,8 @@ mnesia(boot) ->
                 {decentralized_counters, true}
             ]}
         ]}
-    ]).
+    ]),
+    [?ROUTE_TAB, ?ROUTE_TAB_FILTERS].
 
 %%--------------------------------------------------------------------
 %% Start a router
diff --git a/apps/emqx/src/emqx_router_helper.erl b/apps/emqx/src/emqx_router_helper.erl
index c43192d4e..48e5bfba4 100644
--- a/apps/emqx/src/emqx_router_helper.erl
+++ b/apps/emqx/src/emqx_router_helper.erl
@@ -25,9 +25,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 %% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
+-export([create_tables/0]).
 
 %% API
 -export([
@@ -63,7 +61,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(?ROUTING_NODE, [
         {type, set},
         {rlog_shard, ?ROUTE_SHARD},
@@ -71,7 +69,8 @@ mnesia(boot) ->
         {record_name, routing_node},
         {attributes, record_info(fields, routing_node)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ]),
+    [?ROUTING_NODE].
 
 %%--------------------------------------------------------------------
 %% API
diff --git a/apps/emqx/src/emqx_router_sup.erl b/apps/emqx/src/emqx_router_sup.erl
index 588b0de8e..d2bd4afc8 100644
--- a/apps/emqx/src/emqx_router_sup.erl
+++ b/apps/emqx/src/emqx_router_sup.erl
@@ -24,6 +24,11 @@
 
 start_link() ->
     %% Init and log routing table type
+    ok = mria:wait_for_tables(
+        emqx_trie:create_trie() ++
+            emqx_router:create_tables() ++
+            emqx_router_helper:create_tables()
+    ),
     ok = emqx_router:init_schema(),
     supervisor:start_link({local, ?MODULE}, ?MODULE, []).
 
diff --git a/apps/emqx/src/emqx_shared_sub.erl b/apps/emqx/src/emqx_shared_sub.erl
index 0a6538282..f35621758 100644
--- a/apps/emqx/src/emqx_shared_sub.erl
+++ b/apps/emqx/src/emqx_shared_sub.erl
@@ -25,9 +25,7 @@
 -include("types.hrl").
 
 %% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
+-export([create_tables/0]).
 
 %% APIs
 -export([start_link/0]).
@@ -107,14 +105,15 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {type, bag},
         {rlog_shard, ?SHARED_SUB_SHARD},
         {storage, ram_copies},
         {record_name, emqx_shared_subscription},
         {attributes, record_info(fields, emqx_shared_subscription)}
-    ]).
+    ]),
+    [?TAB].
 
 %%--------------------------------------------------------------------
 %% API
diff --git a/apps/emqx/src/emqx_sys_sup.erl b/apps/emqx/src/emqx_sys_sup.erl
index 25718ba76..fc1f8f320 100644
--- a/apps/emqx/src/emqx_sys_sup.erl
+++ b/apps/emqx/src/emqx_sys_sup.erl
@@ -22,6 +22,7 @@
 -export([init/1]).
 
 start_link() ->
+    _ = mria:wait_for_tables(emqx_alarm:create_tables()),
     supervisor:start_link({local, ?MODULE}, ?MODULE, []).
 
 init([]) ->
diff --git a/apps/emqx/src/emqx_trie.erl b/apps/emqx/src/emqx_trie.erl
index 76be97d3e..fbac28856 100644
--- a/apps/emqx/src/emqx_trie.erl
+++ b/apps/emqx/src/emqx_trie.erl
@@ -20,13 +20,11 @@
 
 %% Mnesia bootstrap
 -export([
-    mnesia/1,
+    create_trie/0,
     wait_for_tables/0,
     create_session_trie/1
 ]).
 
--boot_mnesia({mnesia, [boot]}).
-
 %% Trie APIs
 -export([
     insert/1,
@@ -65,8 +63,8 @@
 %%--------------------------------------------------------------------
 
 %% @doc Create or replicate topics table.
--spec mnesia(boot | copy) -> ok.
-mnesia(boot) ->
+-spec create_trie() -> [mria:table()].
+create_trie() ->
     %% Optimize storage
     StoreProps = [
         {ets, [
@@ -80,7 +78,8 @@ mnesia(boot) ->
         {attributes, record_info(fields, ?TRIE)},
         {type, ordered_set},
         {storage_properties, StoreProps}
-    ]).
+    ]),
+    [?TRIE].
 
 create_session_trie(Type) ->
     Storage =

From eff149e676b5f18aed002d586f16e236eddcdcaf Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 20:42:03 +0100
Subject: [PATCH 205/273] feat(emqx-auth-mnesia): manage mria tables explicitly
 during startup

---
 .../emqx_auth_mnesia/src/emqx_auth_mnesia_app.erl |  1 +
 apps/emqx_auth_mnesia/src/emqx_authn_mnesia.erl   | 13 ++++++-------
 .../src/emqx_authn_scram_mnesia.erl               | 15 +++++++++------
 apps/emqx_auth_mnesia/src/emqx_authz_mnesia.erl   | 12 +++++-------
 4 files changed, 21 insertions(+), 20 deletions(-)

diff --git a/apps/emqx_auth_mnesia/src/emqx_auth_mnesia_app.erl b/apps/emqx_auth_mnesia/src/emqx_auth_mnesia_app.erl
index d08d38e10..5b3d1c6c8 100644
--- a/apps/emqx_auth_mnesia/src/emqx_auth_mnesia_app.erl
+++ b/apps/emqx_auth_mnesia/src/emqx_auth_mnesia_app.erl
@@ -25,6 +25,7 @@
 start(_StartType, _StartArgs) ->
     ok = emqx_authz_mnesia:init_tables(),
     ok = emqx_authn_mnesia:init_tables(),
+    ok = emqx_authn_scram_mnesia:init_tables(),
     ok = emqx_authz:register_source(?AUTHZ_TYPE, emqx_authz_mnesia),
     ok = emqx_authn:register_provider(?AUTHN_TYPE_SIMPLE, emqx_authn_mnesia),
     ok = emqx_authn:register_provider(?AUTHN_TYPE_SCRAM, emqx_authn_scram_mnesia),
diff --git a/apps/emqx_auth_mnesia/src/emqx_authn_mnesia.erl b/apps/emqx_auth_mnesia/src/emqx_authn_mnesia.erl
index 8cbd8f35e..e5cad0005 100644
--- a/apps/emqx_auth_mnesia/src/emqx_authn_mnesia.erl
+++ b/apps/emqx_auth_mnesia/src/emqx_authn_mnesia.erl
@@ -55,7 +55,7 @@
     do_update_user/3
 ]).
 
--export([mnesia/1, init_tables/0]).
+-export([init_tables/0]).
 
 -export([backup_tables/0]).
 
@@ -69,8 +69,6 @@
     is_superuser :: boolean()
 }).
 
--boot_mnesia({mnesia, [boot]}).
-
 -define(TAB, ?MODULE).
 -define(AUTHN_QSCHEMA, [
     {<<"like_user_id">>, binary},
@@ -83,8 +81,8 @@
 %%------------------------------------------------------------------------------
 
 %% @doc Create or replicate tables.
--spec mnesia(boot | copy) -> ok.
-mnesia(boot) ->
+-spec create_tables() -> [mria:table()].
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {rlog_shard, ?AUTHN_SHARD},
         {type, ordered_set},
@@ -92,12 +90,13 @@ mnesia(boot) ->
         {record_name, user_info},
         {attributes, record_info(fields, user_info)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ]),
+    [?TAB].
 
 %% Init
 -spec init_tables() -> ok.
 init_tables() ->
-    ok = mria_rlog:wait_for_shards([?AUTHN_SHARD], infinity).
+    ok = mria:wait_for_tables(create_tables()).
 
 %%------------------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx_auth_mnesia/src/emqx_authn_scram_mnesia.erl b/apps/emqx_auth_mnesia/src/emqx_authn_scram_mnesia.erl
index a66ae5786..705924ea4 100644
--- a/apps/emqx_auth_mnesia/src/emqx_authn_scram_mnesia.erl
+++ b/apps/emqx_auth_mnesia/src/emqx_authn_scram_mnesia.erl
@@ -65,9 +65,7 @@
 
 -type user_group() :: binary().
 
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
+-export([init_tables/0]).
 
 -record(user_info, {
     user_id,
@@ -84,8 +82,8 @@
 %%------------------------------------------------------------------------------
 
 %% @doc Create or replicate tables.
--spec mnesia(boot | copy) -> ok.
-mnesia(boot) ->
+-spec create_tables() -> [mria:table()].
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {rlog_shard, ?AUTHN_SHARD},
         {type, ordered_set},
@@ -93,7 +91,12 @@ mnesia(boot) ->
         {record_name, user_info},
         {attributes, record_info(fields, user_info)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ]),
+    [?TAB].
+
+-spec init_tables() -> ok.
+init_tables() ->
+    mria:wait_for_tables(create_tables()).
 
 %%------------------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx_auth_mnesia/src/emqx_authz_mnesia.erl b/apps/emqx_auth_mnesia/src/emqx_authz_mnesia.erl
index 27000b7a3..d1a40d5cd 100644
--- a/apps/emqx_auth_mnesia/src/emqx_authz_mnesia.erl
+++ b/apps/emqx_auth_mnesia/src/emqx_authz_mnesia.erl
@@ -56,7 +56,6 @@
 
 %% Management API
 -export([
-    mnesia/1,
     init_tables/0,
     store_rules/2,
     purge_rules/0,
@@ -74,17 +73,16 @@
 -compile(nowarn_export_all).
 -endif.
 
--boot_mnesia({mnesia, [boot]}).
-
--spec mnesia(boot | copy) -> ok.
-mnesia(boot) ->
+-spec create_tables() -> [mria:table()].
+create_tables() ->
     ok = mria:create_table(?ACL_TABLE, [
         {type, ordered_set},
         {rlog_shard, ?ACL_SHARDED},
         {storage, disc_copies},
         {attributes, record_info(fields, ?ACL_TABLE)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ]),
+    [?ACL_TABLE].
 
 %%--------------------------------------------------------------------
 %% emqx_authz callbacks
@@ -138,7 +136,7 @@ backup_tables() -> [?ACL_TABLE].
 %% Init
 -spec init_tables() -> ok.
 init_tables() ->
-    ok = mria_rlog:wait_for_shards([?ACL_SHARDED], infinity).
+    ok = mria:wait_for_tables(create_tables()).
 
 %% @doc Update authz rules
 -spec store_rules(who(), rules()) -> ok.

From 0e1d27c836a760ba97140af57697076b3c7fe5d9 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 21:52:25 +0100
Subject: [PATCH 206/273] fix(gateway): avoid scanning modules of known gateway
 apps

Since the set of known gateways is already predefined in `emqx_gateway_utils`
it makes no sense to scan over all modules just to find out the same set of
modules. Cutting out this scanning saves few seconds per each `emqx_conf`
application startup, which is especially noticeable when running tests.
---
 apps/emqx_gateway/src/emqx_gateway_utils.erl  | 120 +++++-------------
 apps/emqx_gateway/test/emqx_gateway_SUITE.erl |   5 +-
 .../test/emqx_gateway_api_SUITE.erl           |  25 ++--
 .../src/emqx_jt808_schema.erl                 |   5 +-
 .../test/emqx_jt808_SUITE.erl                 |   3 +-
 5 files changed, 59 insertions(+), 99 deletions(-)

diff --git a/apps/emqx_gateway/src/emqx_gateway_utils.erl b/apps/emqx_gateway/src/emqx_gateway_utils.erl
index 47e1f7583..33f9e7de8 100644
--- a/apps/emqx_gateway/src/emqx_gateway_utils.erl
+++ b/apps/emqx_gateway/src/emqx_gateway_utils.erl
@@ -20,6 +20,17 @@
 -include("emqx_gateway.hrl").
 -include_lib("emqx/include/logger.hrl").
 
+-define(GATEWAYS, [
+    emqx_gateway_coap,
+    emqx_gateway_exproto,
+    emqx_gateway_gbt32960,
+    emqx_gateway_jt808,
+    emqx_gateway_lwm2m,
+    emqx_gateway_mqttsn,
+    emqx_gateway_ocpp,
+    emqx_gateway_stomp
+]).
+
 -export([
     childspec/2,
     childspec/3,
@@ -679,32 +690,28 @@ default_subopts() ->
 
 -spec find_gateway_definitions() -> list(gateway_def()).
 find_gateway_definitions() ->
-    ensure_gateway_loaded(),
-    lists:flatten(
-        lists:map(
-            fun(App) ->
-                gateways(find_attrs(App, gateway))
-            end,
-            ignore_lib_apps(application:loaded_applications())
-        )
+    lists:flatmap(
+        fun(App) ->
+            lists:flatmap(fun gateways/1, find_attrs(App, gateway))
+        end,
+        ?GATEWAYS
     ).
 
 -spec find_gateway_definition(atom()) -> {ok, map()} | {error, term()}.
 find_gateway_definition(Name) ->
-    ensure_gateway_loaded(),
-    find_gateway_definition(Name, ignore_lib_apps(application:loaded_applications())).
+    find_gateway_definition(Name, ?GATEWAYS).
 
 -dialyzer({no_match, [find_gateway_definition/2]}).
 find_gateway_definition(Name, [App | T]) ->
     Attrs = find_attrs(App, gateway),
-    SearchFun = fun({_App, _Mod, #{name := GwName}}) ->
+    SearchFun = fun(#{name := GwName}) ->
         GwName =:= Name
     end,
     case lists:search(SearchFun, Attrs) of
-        {value, {_App, _Mod, Defination}} ->
-            case check_gateway_edition(Defination) of
+        {value, Definition} ->
+            case check_gateway_edition(Definition) of
                 true ->
-                    {ok, Defination};
+                    {ok, Definition};
                 _ ->
                     {error, invalid_edition}
             end;
@@ -715,23 +722,18 @@ find_gateway_definition(_Name, []) ->
     {error, not_found}.
 
 -dialyzer({no_match, [gateways/1]}).
-gateways([]) ->
-    [];
-gateways([
-    {_App, _Mod,
-        Defination =
-            #{
-                name := Name,
-                callback_module := CbMod,
-                config_schema_module := SchemaMod
-            }}
-    | More
-]) when is_atom(Name), is_atom(CbMod), is_atom(SchemaMod) ->
-    case check_gateway_edition(Defination) of
+gateways(
+    Definition = #{
+        name := Name,
+        callback_module := CbMod,
+        config_schema_module := SchemaMod
+    }
+) when is_atom(Name), is_atom(CbMod), is_atom(SchemaMod) ->
+    case check_gateway_edition(Definition) of
         true ->
-            [Defination | gateways(More)];
+            [Definition];
         _ ->
-            gateways(More)
+            []
     end.
 
 -if(?EMQX_RELEASE_EDITION == ee).
@@ -742,12 +744,10 @@ check_gateway_edition(Defination) ->
     ce == maps:get(edition, Defination, ce).
 -endif.
 
-find_attrs(App, Def) ->
+find_attrs(AppMod, Def) ->
     [
-        {App, Mod, Attr}
-     || {ok, Modules} <- [application:get_key(App, modules)],
-        Mod <- Modules,
-        {Name, Attrs} <- module_attributes(Mod),
+        Attr
+     || {Name, Attrs} <- module_attributes(AppMod),
         Name =:= Def,
         Attr <- Attrs
     ].
@@ -759,43 +759,6 @@ module_attributes(Module) ->
         error:undef -> []
     end.
 
-ignore_lib_apps(Apps) ->
-    LibApps = [
-        kernel,
-        stdlib,
-        sasl,
-        appmon,
-        eldap,
-        erts,
-        syntax_tools,
-        ssl,
-        crypto,
-        mnesia,
-        os_mon,
-        inets,
-        goldrush,
-        gproc,
-        runtime_tools,
-        snmp,
-        otp_mibs,
-        public_key,
-        asn1,
-        ssh,
-        hipe,
-        common_test,
-        observer,
-        webtool,
-        xmerl,
-        tools,
-        test_server,
-        compiler,
-        debugger,
-        eunit,
-        et,
-        wx
-    ],
-    [AppName || {AppName, _, _} <- Apps, not lists:member(AppName, LibApps)].
-
 -spec plus_max_connections(non_neg_integer() | infinity, non_neg_integer() | infinity) ->
     pos_integer() | infinity.
 plus_max_connections(_, infinity) ->
@@ -805,20 +768,5 @@ plus_max_connections(infinity, _) ->
 plus_max_connections(A, B) when is_integer(A) andalso is_integer(B) ->
     A + B.
 
-%% we need to load all gateway applications before generate doc from cli
-ensure_gateway_loaded() ->
-    lists:foreach(
-        fun application:load/1,
-        [
-            emqx_gateway_exproto,
-            emqx_gateway_stomp,
-            emqx_gateway_coap,
-            emqx_gateway_lwm2m,
-            emqx_gateway_mqttsn,
-            emqx_gateway_gbt32960,
-            emqx_gateway_ocpp
-        ]
-    ).
-
 random_clientid(GwName) when is_atom(GwName) ->
     iolist_to_binary([atom_to_list(GwName), "-", emqx_utils:gen_id()]).
diff --git a/apps/emqx_gateway/test/emqx_gateway_SUITE.erl b/apps/emqx_gateway/test/emqx_gateway_SUITE.erl
index 2574db644..78993a5df 100644
--- a/apps/emqx_gateway/test/emqx_gateway_SUITE.erl
+++ b/apps/emqx_gateway/test/emqx_gateway_SUITE.erl
@@ -74,7 +74,10 @@ end_per_testcase(_TestCase, _Config) ->
 %%--------------------------------------------------------------------
 
 t_registered_gateway(_) ->
-    [{coap, #{cbkmod := emqx_gateway_coap}} | _] = emqx_gateway:registered_gateway().
+    ?assertMatch(
+        [{coap, #{cbkmod := emqx_gateway_coap}} | _],
+        lists:sort(emqx_gateway:registered_gateway())
+    ).
 
 t_load_unload_list_lookup(_) ->
     {ok, _} = emqx_gateway:load(?GWNAME, #{idle_timeout => 1000}),
diff --git a/apps/emqx_gateway/test/emqx_gateway_api_SUITE.erl b/apps/emqx_gateway/test/emqx_gateway_api_SUITE.erl
index 41409693a..a98624014 100644
--- a/apps/emqx_gateway/test/emqx_gateway_api_SUITE.erl
+++ b/apps/emqx_gateway/test/emqx_gateway_api_SUITE.erl
@@ -45,17 +45,24 @@
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Conf) ->
-    application:load(emqx),
-    emqx_gateway_test_utils:load_all_gateway_apps(),
-    emqx_config:delete_override_conf_files(),
-    emqx_config:erase(gateway),
-    emqx_common_test_helpers:load_config(emqx_gateway_schema, ?CONF_DEFAULT),
-    emqx_mgmt_api_test_util:init_suite([grpc, emqx_conf, emqx_auth, emqx_auth_mnesia, emqx_gateway]),
-    Conf.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx_conf,
+            emqx_auth,
+            emqx_auth_mnesia,
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"},
+            {emqx_gateway, ?CONF_DEFAULT}
+            | emqx_gateway_test_utils:all_gateway_apps()
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Conf)}
+    ),
+    _ = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | Conf].
 
 end_per_suite(Conf) ->
-    emqx_mgmt_api_test_util:end_suite([emqx_gateway, emqx_auth_mnesia, emqx_auth, emqx_conf, grpc]),
-    Conf.
+    _ = emqx_common_test_http:delete_default_app(),
+    ok = emqx_cth_suite:stop(proplists:get_value(suite_apps, Conf)).
 
 init_per_testcase(t_gateway_fail, Config) ->
     meck:expect(
diff --git a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
index 3e0c31f5d..427c7bdfe 100644
--- a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
+++ b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
@@ -8,10 +8,13 @@
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("typerefl/include/types.hrl").
 
--export([fields/1, desc/1]).
+-behaviour(hocon_schema).
+-export([namespace/0, fields/1, desc/1]).
 
 -define(NOT_EMPTY(MSG), emqx_resource_validator:not_empty(MSG)).
 
+namespace() -> gateway.
+
 fields(jt808) ->
     [
         {frame, sc(ref(jt808_frame))},
diff --git a/apps/emqx_gateway_jt808/test/emqx_jt808_SUITE.erl b/apps/emqx_gateway_jt808/test/emqx_jt808_SUITE.erl
index 20aae1acb..af2ffd071 100644
--- a/apps/emqx_gateway_jt808/test/emqx_jt808_SUITE.erl
+++ b/apps/emqx_gateway_jt808/test/emqx_jt808_SUITE.erl
@@ -101,10 +101,9 @@ end_per_testcase(_Case, Config) ->
     ok.
 
 boot_apps(Case, JT808Conf, Config) ->
-    application:load(emqx_gateway_jt808),
     Apps = emqx_cth_suite:start(
         [
-            cowboy,
+            emqx,
             {emqx_conf, JT808Conf},
             emqx_gateway
         ],

From 8f7b0ac49837ab740cc7507e4471b1831b6dcf13 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 16:27:41 +0100
Subject: [PATCH 207/273] docs(jt808): fix doc references

---
 .../src/emqx_jt808_schema.erl                 | 23 +++++++++++++------
 rel/i18n/emqx_jt808_schema.hocon              | 11 +++++----
 2 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
index 427c7bdfe..d4b0a0b5e 100644
--- a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
+++ b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
@@ -54,9 +54,8 @@ fields(jt808_proto) ->
     [
         {auth,
             sc(
-                hoconsc:union([
-                    ref(anonymous_true), ref(anonymous_false)
-                ])
+                hoconsc:union([ref(anonymous_true), ref(anonymous_false)]),
+                #{desc => ?DESC(jt808_auth)}
             )},
         {up_topic, fun up_topic/1},
         {dn_topic, fun dn_topic/1}
@@ -64,12 +63,18 @@ fields(jt808_proto) ->
 fields(anonymous_true) ->
     [
         {allow_anonymous,
-            sc(hoconsc:union([true]), #{desc => ?DESC(allow_anonymous), required => true})}
+            sc(
+                hoconsc:union([true]),
+                #{desc => ?DESC(jt808_allow_anonymous), required => true}
+            )}
     ] ++ fields_reg_auth_required(false);
 fields(anonymous_false) ->
     [
         {allow_anonymous,
-            sc(hoconsc:union([false]), #{desc => ?DESC(allow_anonymous), required => true})}
+            sc(
+                hoconsc:union([false]),
+                #{desc => ?DESC(jt808_allow_anonymous), required => true}
+            )}
     ] ++ fields_reg_auth_required(true).
 
 fields_reg_auth_required(Required) ->
@@ -105,14 +110,14 @@ jt808_frame_max_length(_) ->
     undefined.
 
 up_topic(type) -> binary();
-up_topic(desc) -> ?DESC(?FUNCTION_NAME);
+up_topic(desc) -> ?DESC(jt808_up_topic);
 up_topic(default) -> ?DEFAULT_UP_TOPIC;
 up_topic(validator) -> [?NOT_EMPTY("the value of the field 'up_topic' cannot be empty")];
 up_topic(required) -> true;
 up_topic(_) -> undefined.
 
 dn_topic(type) -> binary();
-dn_topic(desc) -> ?DESC(?FUNCTION_NAME);
+dn_topic(desc) -> ?DESC(jt808_dn_topic);
 dn_topic(default) -> ?DEFAULT_DN_TOPIC;
 dn_topic(validator) -> [?NOT_EMPTY("the value of the field 'dn_topic' cannot be empty")];
 dn_topic(required) -> true;
@@ -124,6 +129,10 @@ desc(jt808_frame) ->
     "Limits for the JT/T 808 frames.";
 desc(jt808_proto) ->
     "The JT/T 808 protocol options.";
+desc(anonymous_false) ->
+    ?DESC(jt808_allow_anonymous);
+desc(anonymous_true) ->
+    ?DESC(jt808_allow_anonymous);
 desc(_) ->
     undefined.
 
diff --git a/rel/i18n/emqx_jt808_schema.hocon b/rel/i18n/emqx_jt808_schema.hocon
index cd853df4d..71c76ae52 100644
--- a/rel/i18n/emqx_jt808_schema.hocon
+++ b/rel/i18n/emqx_jt808_schema.hocon
@@ -3,19 +3,22 @@ emqx_jt808_schema {
 jt808_frame_max_length.desc:
 """The maximum length of the JT/T 808 frame."""
 
+jt808_auth.desc:
+"""Authentication settings of the JT/T 808 Gateway."""
+
 jt808_allow_anonymous.desc:
 """Allow anonymous access to the JT/T 808 Gateway."""
 
-registry_url.desc
+registry_url.desc:
 """The JT/T 808 device registry central URL."""
 
-authentication_url.desc
+authentication_url.desc:
 """The JT/T 808 device authentication central URL."""
 
-jt808_up_topic.desc
+jt808_up_topic.desc:
 """The topic of the JT/T 808 protocol upstream message."""
 
-jt808_dn_topic.desc
+jt808_dn_topic.desc:
 """The topic of the JT/T 808 protocol downstream message."""
 
 retry_interval.desc:

From 21780e2126fd7e8468bcfca82ef9bca0b1546e5b Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 20:45:01 +0100
Subject: [PATCH 208/273] feat(emqx-conf): manage mria tables explicitly during
 startup

---
 apps/emqx_conf/src/emqx_cluster_rpc.erl       | 13 +++++----
 apps/emqx_conf/src/emqx_conf.app.src          |  2 +-
 apps/emqx_conf/src/emqx_conf_app.erl          |  1 +
 .../test/emqx_retainer_SUITE.erl              | 27 +++++++------------
 .../test/emqx_retainer_cli_SUITE.erl          | 14 +++++-----
 .../test/emqx_retainer_mqtt_v5_SUITE.erl      | 14 +++++-----
 6 files changed, 35 insertions(+), 36 deletions(-)

diff --git a/apps/emqx_conf/src/emqx_cluster_rpc.erl b/apps/emqx_conf/src/emqx_cluster_rpc.erl
index 8ad30dc74..21bf96806 100644
--- a/apps/emqx_conf/src/emqx_cluster_rpc.erl
+++ b/apps/emqx_conf/src/emqx_cluster_rpc.erl
@@ -17,7 +17,7 @@
 -behaviour(gen_server).
 
 %% API
--export([start_link/0, mnesia/1]).
+-export([start_link/0, create_tables/0]).
 
 %% Note: multicall functions are statically checked by
 %% `emqx_bapi_trans' and `emqx_bpapi_static_checks' modules. Don't
@@ -65,8 +65,6 @@
 
 -export_type([tnx_id/0, succeed_num/0]).
 
--boot_mnesia({mnesia, [boot]}).
-
 -include_lib("emqx/include/logger.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include("emqx_conf.hrl").
@@ -99,7 +97,8 @@
 %%%===================================================================
 %%% API
 %%%===================================================================
-mnesia(boot) ->
+
+create_tables() ->
     ok = mria:create_table(?CLUSTER_MFA, [
         {type, ordered_set},
         {rlog_shard, ?CLUSTER_RPC_SHARD},
@@ -113,7 +112,11 @@ mnesia(boot) ->
         {storage, disc_copies},
         {record_name, cluster_rpc_commit},
         {attributes, record_info(fields, cluster_rpc_commit)}
-    ]).
+    ]),
+    [
+        ?CLUSTER_MFA,
+        ?CLUSTER_COMMIT
+    ].
 
 start_link() ->
     start_link(node(), ?MODULE, get_retry_ms()).
diff --git a/apps/emqx_conf/src/emqx_conf.app.src b/apps/emqx_conf/src/emqx_conf.app.src
index 25a936a7a..7a9ddb9f7 100644
--- a/apps/emqx_conf/src/emqx_conf.app.src
+++ b/apps/emqx_conf/src/emqx_conf.app.src
@@ -3,7 +3,7 @@
     {vsn, "0.1.34"},
     {registered, []},
     {mod, {emqx_conf_app, []}},
-    {applications, [kernel, stdlib, emqx_ctl]},
+    {applications, [kernel, stdlib]},
     {env, []},
     {modules, []}
 ]}.
diff --git a/apps/emqx_conf/src/emqx_conf_app.erl b/apps/emqx_conf/src/emqx_conf_app.erl
index 74a7a8f2e..654a6bfe4 100644
--- a/apps/emqx_conf/src/emqx_conf_app.erl
+++ b/apps/emqx_conf/src/emqx_conf_app.erl
@@ -27,6 +27,7 @@
 -include("emqx_conf.hrl").
 
 start(_StartType, _StartArgs) ->
+    ok = mria:wait_for_tables(emqx_cluster_rpc:create_tables()),
     try
         ok = init_conf()
     catch
diff --git a/apps/emqx_retainer/test/emqx_retainer_SUITE.erl b/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
index 71b1ef900..5dad85a9c 100644
--- a/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
+++ b/apps/emqx_retainer/test/emqx_retainer_SUITE.erl
@@ -47,8 +47,6 @@ common_tests() ->
     emqx_common_test_helpers:all(?MODULE) -- [t_reindex].
 
 -define(BASE_CONF, <<
-    ""
-    "\n"
     "retainer {\n"
     "    enable = true\n"
     "    msg_clear_interval = 0s\n"
@@ -64,7 +62,6 @@ common_tests() ->
     "        max_retained_messages = 0\n"
     "     }\n"
     "}"
-    ""
 >>).
 
 %%--------------------------------------------------------------------
@@ -72,18 +69,14 @@ common_tests() ->
 %%--------------------------------------------------------------------
 
 init_per_suite(Config) ->
-    emqx_common_test_helpers:start_apps([emqx_conf]),
-    load_conf(),
-    emqx_limiter_sup:start_link(),
-    timer:sleep(200),
-    ok = application:ensure_started(?APP),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [emqx, emqx_conf, app_spec()],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    emqx_common_test_helpers:stop_apps([?APP, emqx_conf]).
+end_per_suite(Config) ->
+    emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_group(mnesia_without_indices, Config) ->
     mnesia:clear_table(?TAB_INDEX_META),
@@ -113,10 +106,8 @@ init_per_testcase(t_get_basic_usage_info, Config) ->
 init_per_testcase(_TestCase, Config) ->
     Config.
 
-load_conf() ->
-    ok = emqx_config:delete_override_conf_files(),
-    emqx_ratelimiter_SUITE:init_config(),
-    ok = emqx_config:init_load(emqx_retainer_schema, ?BASE_CONF).
+app_spec() ->
+    {emqx_retainer, ?BASE_CONF}.
 
 %%--------------------------------------------------------------------
 %% Test Cases
diff --git a/apps/emqx_retainer/test/emqx_retainer_cli_SUITE.erl b/apps/emqx_retainer/test/emqx_retainer_cli_SUITE.erl
index c04f7a6de..335d10d4f 100644
--- a/apps/emqx_retainer/test/emqx_retainer_cli_SUITE.erl
+++ b/apps/emqx_retainer/test/emqx_retainer_cli_SUITE.erl
@@ -22,18 +22,20 @@
 -include("emqx_retainer.hrl").
 
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    emqx_retainer_SUITE:load_conf(),
-    %% Start Apps
-    emqx_common_test_helpers:start_apps([emqx_retainer]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [emqx, emqx_conf, emqx_retainer_SUITE:app_spec()],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    emqx_common_test_helpers:stop_apps([emqx_retainer]).
+end_per_suite(Config) ->
+    emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 t_reindex_status(_Config) ->
     ok = emqx_retainer_mnesia_cli:retainer(["reindex", "status"]).
diff --git a/apps/emqx_retainer/test/emqx_retainer_mqtt_v5_SUITE.erl b/apps/emqx_retainer/test/emqx_retainer_mqtt_v5_SUITE.erl
index bfe5b6a00..9c24f587b 100644
--- a/apps/emqx_retainer/test/emqx_retainer_mqtt_v5_SUITE.erl
+++ b/apps/emqx_retainer/test/emqx_retainer_mqtt_v5_SUITE.erl
@@ -20,17 +20,19 @@
 -compile(nowarn_export_all).
 
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    emqx_retainer_SUITE:load_conf(),
-    %% Start Apps
-    emqx_common_test_helpers:start_apps([emqx_retainer]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [emqx, emqx_conf, emqx_retainer_SUITE:app_spec()],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    emqx_common_test_helpers:stop_apps([emqx_retainer]).
+end_per_suite(Config) ->
+    emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 client_info(Key, Client) ->
     maps:get(Key, maps:from_list(emqtt:info(Client)), undefined).

From b6d77c164e4ec1411eea1dcde5a3081c79d1b302 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 20:48:32 +0100
Subject: [PATCH 209/273] feat(emqx-mgmt): manage mria tables explicitly during
 startup

---
 apps/emqx/test/emqx_common_test_http.erl      | 25 ++++++++++++-------
 .../src/emqx_dashboard_admin.erl              | 10 +++-----
 .../emqx_dashboard/src/emqx_dashboard_app.erl |  7 +++++-
 .../src/emqx_dashboard_monitor.erl            | 10 +++-----
 .../src/emqx_dashboard_token.erl              | 11 ++++----
 apps/emqx_management/src/emqx_mgmt_app.erl    |  1 +
 apps/emqx_management/src/emqx_mgmt_auth.erl   |  9 ++++---
 .../test/emqx_mgmt_api_test_util.erl          |  8 +++---
 8 files changed, 45 insertions(+), 36 deletions(-)

diff --git a/apps/emqx/test/emqx_common_test_http.erl b/apps/emqx/test/emqx_common_test_http.erl
index 30ebe409f..5dbc96b26 100644
--- a/apps/emqx/test/emqx_common_test_http.erl
+++ b/apps/emqx/test/emqx_common_test_http.erl
@@ -93,15 +93,22 @@ default_auth_header() ->
 create_default_app() ->
     Now = erlang:system_time(second),
     ExpiredAt = Now + timer:minutes(10),
-    emqx_mgmt_auth:create(
-        ?DEFAULT_APP_ID,
-        ?DEFAULT_APP_KEY,
-        ?DEFAULT_APP_SECRET,
-        true,
-        ExpiredAt,
-        <<"default app key for test">>,
-        ?ROLE_API_SUPERUSER
-    ).
+    case
+        emqx_mgmt_auth:create(
+            ?DEFAULT_APP_ID,
+            ?DEFAULT_APP_KEY,
+            ?DEFAULT_APP_SECRET,
+            true,
+            ExpiredAt,
+            <<"default app key for test">>,
+            ?ROLE_API_SUPERUSER
+        )
+    of
+        {ok, App} ->
+            {ok, App};
+        {error, name_already_existed} ->
+            {ok, _} = emqx_mgmt_auth:read(?DEFAULT_APP_ID)
+    end.
 
 delete_default_app() ->
     emqx_mgmt_auth:delete(?DEFAULT_APP_ID).
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_admin.erl b/apps/emqx_dashboard/src/emqx_dashboard_admin.erl
index 6c2271aee..ba6982d50 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_admin.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_admin.erl
@@ -22,12 +22,9 @@
 -include_lib("emqx/include/logger.hrl").
 -include_lib("stdlib/include/ms_transform.hrl").
 
--boot_mnesia({mnesia, [boot]}).
-
 -behaviour(emqx_db_backup).
 
-%% Mnesia bootstrap
--export([mnesia/1]).
+-export([create_tables/0]).
 
 -export([
     add_user/4,
@@ -70,7 +67,7 @@
 %% Mnesia bootstrap
 %%--------------------------------------------------------------------
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(?ADMIN, [
         {type, set},
         {rlog_shard, ?DASHBOARD_SHARD},
@@ -83,7 +80,8 @@ mnesia(boot) ->
                 {write_concurrency, true}
             ]}
         ]}
-    ]).
+    ]),
+    [?ADMIN].
 
 %%--------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_app.erl b/apps/emqx_dashboard/src/emqx_dashboard_app.erl
index 1b6e1d710..03df9469e 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_app.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_app.erl
@@ -26,7 +26,12 @@
 -include("emqx_dashboard.hrl").
 
 start(_StartType, _StartArgs) ->
-    ok = mria_rlog:wait_for_shards([?DASHBOARD_SHARD], infinity),
+    Tables = lists:append([
+        emqx_dashboard_admin:create_tables(),
+        emqx_dashboard_token:create_tables(),
+        emqx_dashboard_monitor:create_tables()
+    ]),
+    ok = mria:wait_for_tables(Tables),
     {ok, Sup} = emqx_dashboard_sup:start_link(),
     case emqx_dashboard:start_listeners() of
         ok ->
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl b/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
index c8f92de0d..da3e56ff0 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_monitor.erl
@@ -22,8 +22,7 @@
 
 -behaviour(gen_server).
 
--boot_mnesia({mnesia, [boot]}).
-
+-export([create_tables/0]).
 -export([start_link/0]).
 
 -export([
@@ -35,8 +34,6 @@
     code_change/3
 ]).
 
--export([mnesia/1]).
-
 -export([
     samplers/0,
     samplers/2,
@@ -67,14 +64,15 @@
     data :: map()
 }).
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {type, set},
         {local_content, true},
         {storage, disc_copies},
         {record_name, emqx_monit},
         {attributes, record_info(fields, emqx_monit)}
-    ]).
+    ]),
+    [?TAB].
 
 %% -------------------------------------------------------------------------------------------------
 %% API
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_token.erl b/apps/emqx_dashboard/src/emqx_dashboard_token.erl
index 20041e393..d80169922 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_token.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_token.erl
@@ -18,6 +18,8 @@
 
 -include("emqx_dashboard.hrl").
 
+-export([create_tables/0]).
+
 -export([
     sign/2,
     verify/2,
@@ -27,10 +29,6 @@
     destroy_by_username/1
 ]).
 
--boot_mnesia({mnesia, [boot]}).
-
--export([mnesia/1]).
-
 -ifdef(TEST).
 -export([lookup_by_username/1, clean_expired_jwt/1]).
 -endif.
@@ -87,7 +85,7 @@ salt() ->
     <<X:16/big-unsigned-integer>> = crypto:strong_rand_bytes(2),
     iolist_to_binary(io_lib:format("~4.16.0b", [X])).
 
-mnesia(boot) ->
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {type, set},
         {rlog_shard, ?DASHBOARD_SHARD},
@@ -100,7 +98,8 @@ mnesia(boot) ->
                 {write_concurrency, true}
             ]}
         ]}
-    ]).
+    ]),
+    [?TAB].
 
 %%--------------------------------------------------------------------
 %% jwt apply
diff --git a/apps/emqx_management/src/emqx_mgmt_app.erl b/apps/emqx_management/src/emqx_mgmt_app.erl
index e8bd5d76e..7a91280db 100644
--- a/apps/emqx_management/src/emqx_mgmt_app.erl
+++ b/apps/emqx_management/src/emqx_mgmt_app.erl
@@ -28,6 +28,7 @@
 -include("emqx_mgmt.hrl").
 
 start(_Type, _Args) ->
+    ok = mria:wait_for_tables(emqx_mgmt_auth:create_tables()),
     case emqx_mgmt_auth:init_bootstrap_file() of
         ok ->
             emqx_conf:add_handler([api_key], emqx_mgmt_auth),
diff --git a/apps/emqx_management/src/emqx_mgmt_auth.erl b/apps/emqx_management/src/emqx_mgmt_auth.erl
index 7745207ce..7795e0bbe 100644
--- a/apps/emqx_management/src/emqx_mgmt_auth.erl
+++ b/apps/emqx_management/src/emqx_mgmt_auth.erl
@@ -22,8 +22,8 @@
 -behaviour(emqx_db_backup).
 
 %% API
--export([mnesia/1]).
--boot_mnesia({mnesia, [boot]}).
+-export([create_tables/0]).
+
 -behaviour(emqx_config_handler).
 
 -export([
@@ -70,7 +70,7 @@
 
 -define(DEFAULT_HASH_LEN, 16).
 
-mnesia(boot) ->
+create_tables() ->
     Fields = record_info(fields, ?APP),
     ok = mria:create_table(?APP, [
         {type, set},
@@ -78,7 +78,8 @@ mnesia(boot) ->
         {storage, disc_copies},
         {record_name, ?APP},
         {attributes, Fields}
-    ]).
+    ]),
+    [?APP].
 
 %%--------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx_management/test/emqx_mgmt_api_test_util.erl b/apps/emqx_management/test/emqx_mgmt_api_test_util.erl
index cd768a529..9bf6a11b6 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_test_util.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_test_util.erl
@@ -30,8 +30,9 @@ init_suite(Apps, SetConfigs) when is_function(SetConfigs) ->
     init_suite(Apps, SetConfigs, #{}).
 
 init_suite(Apps, SetConfigs, Opts) ->
-    application:load(emqx_management),
-    emqx_common_test_helpers:start_apps(Apps ++ [emqx_dashboard], SetConfigs, Opts),
+    emqx_common_test_helpers:start_apps(
+        Apps ++ [emqx_management, emqx_dashboard], SetConfigs, Opts
+    ),
     _ = emqx_common_test_http:create_default_app(),
     ok.
 
@@ -40,8 +41,7 @@ end_suite() ->
 
 end_suite(Apps) ->
     emqx_common_test_http:delete_default_app(),
-    emqx_common_test_helpers:stop_apps(Apps ++ [emqx_dashboard]),
-    application:unload(emqx_management),
+    emqx_common_test_helpers:stop_apps(Apps ++ [emqx_management, emqx_dashboard]),
     ok.
 
 set_special_configs(emqx_dashboard) ->

From b07df487f0ef1c1490183a3d7a9d5fed27c087c7 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 20:56:33 +0100
Subject: [PATCH 210/273] feat(modules): manage mria tables explicitly during
 startup

---
 apps/emqx_modules/src/emqx_delayed.erl     | 12 +++++-------
 apps/emqx_modules/src/emqx_modules_app.erl |  1 +
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_modules/src/emqx_delayed.erl b/apps/emqx_modules/src/emqx_delayed.erl
index c95cca37b..dbb05182a 100644
--- a/apps/emqx_modules/src/emqx_delayed.erl
+++ b/apps/emqx_modules/src/emqx_delayed.erl
@@ -25,12 +25,8 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("emqx/include/emqx_hooks.hrl").
 
-%% Mnesia bootstrap
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
-
 -export([
+    create_tables/0,
     start_link/0,
     on_message_publish/1
 ]).
@@ -118,14 +114,16 @@
 %%------------------------------------------------------------------------------
 %% Mnesia bootstrap
 %%------------------------------------------------------------------------------
-mnesia(boot) ->
+
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {type, ordered_set},
         {storage, disc_copies},
         {local_content, true},
         {record_name, delayed_message},
         {attributes, record_info(fields, delayed_message)}
-    ]).
+    ]),
+    [?TAB].
 
 %%------------------------------------------------------------------------------
 %% Hooks
diff --git a/apps/emqx_modules/src/emqx_modules_app.erl b/apps/emqx_modules/src/emqx_modules_app.erl
index 3be81d4cd..23e484a25 100644
--- a/apps/emqx_modules/src/emqx_modules_app.erl
+++ b/apps/emqx_modules/src/emqx_modules_app.erl
@@ -24,6 +24,7 @@
 ]).
 
 start(_Type, _Args) ->
+    ok = mria:wait_for_tables(emqx_delayed:create_tables()),
     {ok, Sup} = emqx_modules_sup:start_link(),
     maybe_enable_modules(),
     {ok, Sup}.

From 82a4e6ef68fbb9e870a224b4f6f1b2b0a35d0f00 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 20:58:35 +0100
Subject: [PATCH 211/273] feat(psk): manage mria tables explicitly during
 startup

Also switch test suite to `emqx_cth_suite` tooling.
---
 apps/emqx_psk/src/emqx_psk.app.src            |  2 +-
 apps/emqx_psk/src/emqx_psk.erl                | 12 +++---
 apps/emqx_psk/src/emqx_psk_app.erl            |  2 +-
 apps/emqx_psk/test/emqx_psk_SUITE.erl         | 41 ++++++++-----------
 .../{data => emqx_psk_SUITE_data}/init.psk    |  0
 5 files changed, 25 insertions(+), 32 deletions(-)
 rename apps/emqx_psk/test/{data => emqx_psk_SUITE_data}/init.psk (100%)

diff --git a/apps/emqx_psk/src/emqx_psk.app.src b/apps/emqx_psk/src/emqx_psk.app.src
index abd862613..14c6ba0cc 100644
--- a/apps/emqx_psk/src/emqx_psk.app.src
+++ b/apps/emqx_psk/src/emqx_psk.app.src
@@ -2,7 +2,7 @@
 {application, emqx_psk, [
     {description, "EMQX PSK"},
     % strict semver, bump manually!
-    {vsn, "5.0.5"},
+    {vsn, "5.0.6"},
     {modules, []},
     {registered, [emqx_psk_sup]},
     {applications, [kernel, stdlib]},
diff --git a/apps/emqx_psk/src/emqx_psk.erl b/apps/emqx_psk/src/emqx_psk.erl
index 7a0986fe7..2e536bec0 100644
--- a/apps/emqx_psk/src/emqx_psk.erl
+++ b/apps/emqx_psk/src/emqx_psk.erl
@@ -32,6 +32,7 @@
 ]).
 
 -export([
+    create_tables/0,
     start_link/0,
     stop/0
 ]).
@@ -63,10 +64,6 @@
     extra :: term()
 }).
 
--export([mnesia/1]).
-
--boot_mnesia({mnesia, [boot]}).
-
 -include("emqx_psk.hrl").
 
 -define(CR, 13).
@@ -81,8 +78,8 @@
 %%------------------------------------------------------------------------------
 
 %% @doc Create or replicate tables.
--spec mnesia(boot | copy) -> ok.
-mnesia(boot) ->
+-spec create_tables() -> [mria:table()].
+create_tables() ->
     ok = mria:create_table(?TAB, [
         {rlog_shard, ?PSK_SHARD},
         {type, ordered_set},
@@ -90,7 +87,8 @@ mnesia(boot) ->
         {record_name, psk_entry},
         {attributes, record_info(fields, psk_entry)},
         {storage_properties, [{ets, [{read_concurrency, true}]}]}
-    ]).
+    ]),
+    [?TAB].
 
 %%------------------------------------------------------------------------------
 %% Data backup
diff --git a/apps/emqx_psk/src/emqx_psk_app.erl b/apps/emqx_psk/src/emqx_psk_app.erl
index d4735f4c9..367831628 100644
--- a/apps/emqx_psk/src/emqx_psk_app.erl
+++ b/apps/emqx_psk/src/emqx_psk_app.erl
@@ -26,7 +26,7 @@
 -include("emqx_psk.hrl").
 
 start(_Type, _Args) ->
-    ok = mria:wait_for_tables([?TAB]),
+    ok = mria:wait_for_tables(emqx_psk:create_tables()),
     emqx_conf:add_handler([?PSK_KEY], emqx_psk),
     {ok, Sup} = emqx_psk_sup:start_link(),
     {ok, Sup}.
diff --git a/apps/emqx_psk/test/emqx_psk_SUITE.erl b/apps/emqx_psk/test/emqx_psk_SUITE.erl
index 2a28ceb2c..6bbe5103d 100644
--- a/apps/emqx_psk/test/emqx_psk_SUITE.erl
+++ b/apps/emqx_psk/test/emqx_psk_SUITE.erl
@@ -34,30 +34,25 @@ groups() ->
     ].
 
 init_per_suite(Config) ->
-    meck:new(emqx_config, [non_strict, passthrough, no_history, no_link]),
-    meck:expect(emqx_config, get, fun
-        ([psk_authentication, enable]) -> true;
-        ([psk_authentication, chunk_size]) -> 50;
-        (KeyPath) -> meck:passthrough([KeyPath])
-    end),
-    meck:expect(emqx_config, get, fun
-        ([psk_authentication, init_file], _) ->
-            filename:join([
-                code:lib_dir(emqx_psk, test),
-                "data/init.psk"
-            ]);
-        ([psk_authentication, separator], _) ->
-            <<":">>;
-        (KeyPath, Default) ->
-            meck:passthrough([KeyPath, Default])
-    end),
-    emqx_common_test_helpers:start_apps([emqx_psk]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            {emqx_psk, #{
+                config => #{
+                    psk_authentication => #{
+                        enable => true,
+                        init_file => filename:join(?config(data_dir, Config), "init.psk"),
+                        separator => <<":">>
+                    }
+                }
+            }}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    meck:unload(emqx_config),
-    emqx_common_test_helpers:stop_apps([emqx_psk]),
-    ok.
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 t_psk_lookup(_) ->
     PSKIdentity1 = <<"myclient1">>,
diff --git a/apps/emqx_psk/test/data/init.psk b/apps/emqx_psk/test/emqx_psk_SUITE_data/init.psk
similarity index 100%
rename from apps/emqx_psk/test/data/init.psk
rename to apps/emqx_psk/test/emqx_psk_SUITE_data/init.psk

From 8f2a4f7b19184faa24f46f71bcf2cab7544c7358 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 21:06:40 +0100
Subject: [PATCH 212/273] fix(cth-suite): use cheaper check for loaded
 applications

---
 apps/emqx/test/emqx_cth_suite.erl | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/apps/emqx/test/emqx_cth_suite.erl b/apps/emqx/test/emqx_cth_suite.erl
index 373da9858..93813cab9 100644
--- a/apps/emqx/test/emqx_cth_suite.erl
+++ b/apps/emqx/test/emqx_cth_suite.erl
@@ -177,10 +177,9 @@ load_appspec({App, _Opts}) ->
     load_app_deps(App).
 
 load_app_deps(App) ->
-    AlreadyLoaded = [A || {A, _, _} <- application:loaded_applications()],
     case application:get_key(App, applications) of
         {ok, Deps} ->
-            Apps = Deps -- AlreadyLoaded,
+            Apps = [D || D <- Deps, application:get_key(D, id) == undefined],
             ok = lists:foreach(fun emqx_common_test_helpers:load/1, Apps),
             ok = lists:foreach(fun load_app_deps/1, Apps);
         undefined ->

From 24dfa4172294d19c0b028efc2992bde85ce08e52 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 30 Jan 2024 21:07:40 +0100
Subject: [PATCH 213/273] feat(cth-suite): use cheaper heuristic for schema
 modules

---
 apps/emqx/test/emqx_cth_suite.erl | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/apps/emqx/test/emqx_cth_suite.erl b/apps/emqx/test/emqx_cth_suite.erl
index 93813cab9..eae12145f 100644
--- a/apps/emqx/test/emqx_cth_suite.erl
+++ b/apps/emqx/test/emqx_cth_suite.erl
@@ -470,9 +470,12 @@ clean_suite_state() ->
 
 app_schema(App) ->
     Mod = list_to_atom(atom_to_list(App) ++ "_schema"),
-    try is_list(Mod:roots()) of
-        true -> {ok, Mod};
-        false -> {error, schema_no_roots}
+    try
+        Exports = Mod:module_info(exports),
+        case lists:member({roots, 0}, Exports) of
+            true -> {ok, Mod};
+            false -> {error, schema_no_roots}
+        end
     catch
         error:undef ->
             {error, schema_not_found}

From 0a9cbe30809a7fb8511114f5f7628be8b690d4bc Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 18:47:28 +0100
Subject: [PATCH 214/273] test(license): update and simplify tests

---
 apps/emqx_license/test/emqx_license_SUITE.erl | 115 ++----------------
 .../test/emqx_license_checker_SUITE.erl       |  31 ++---
 .../test/emqx_license_cli_SUITE.erl           |  29 ++---
 .../test/emqx_license_http_api_SUITE.erl      |  56 ++++-----
 .../test/emqx_license_parser_SUITE.erl        |  32 ++---
 .../test/emqx_license_resources_SUITE.erl     |  32 ++---
 6 files changed, 92 insertions(+), 203 deletions(-)

diff --git a/apps/emqx_license/test/emqx_license_SUITE.erl b/apps/emqx_license/test/emqx_license_SUITE.erl
index fcbced33a..f0252495a 100644
--- a/apps/emqx_license/test/emqx_license_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_SUITE.erl
@@ -17,121 +17,32 @@ all() ->
 
 init_per_suite(Config) ->
     emqx_license_test_lib:mock_parser(),
-    _ = application:load(emqx_conf),
-    emqx_config:save_schema_mod_and_names(emqx_license_schema),
-    emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, "license { key = \"default\" }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
+end_per_suite(Config) ->
     emqx_license_test_lib:unmock_parser(),
-    emqx_common_test_helpers:stop_apps([emqx_license]),
-    ok.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(Case, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
-    Paths = set_override_paths(Case),
-    Config0 = setup_test(Case, Config),
-    Paths ++ Config0 ++ Config.
+    setup_test(Case, Config) ++ Config.
 
 end_per_testcase(Case, Config) ->
-    clean_overrides(Case, Config),
-    teardown_test(Case, Config),
-    ok.
+    teardown_test(Case, Config).
 
-set_override_paths(_TestCase) ->
-    [].
-
-clean_overrides(_TestCase, _Config) ->
-    ok.
-
-setup_test(TestCase, Config) when
-    TestCase =:= t_update_file_cluster_backup
-->
-    DataDir = ?config(data_dir, Config),
-    {LicenseKey, _License} = mk_license(
-        [
-            %% license format version
-            "220111",
-            %% license type
-            "0",
-            %% customer type
-            "10",
-            %% customer name
-            "Foo",
-            %% customer email
-            "contact@foo.com",
-            %% deplayment name
-            "bar-deployment",
-            %% start date
-            "20220111",
-            %% days
-            "100000",
-            %% max connections
-            "19"
-        ]
-    ),
-    Cluster = emqx_common_test_helpers:emqx_cluster(
-        [core, core],
-        [
-            {apps, [emqx_conf, emqx_license]},
-            {load_schema, false},
-            {schema_mod, emqx_enterprise_schema},
-            {env_handler, fun
-                (emqx) ->
-                    emqx_config:save_schema_mod_and_names(emqx_enterprise_schema),
-                    %% emqx_config:save_schema_mod_and_names(emqx_license_schema),
-                    application:set_env(emqx, boot_modules, []),
-                    application:set_env(
-                        emqx,
-                        data_dir,
-                        filename:join([
-                            DataDir,
-                            TestCase,
-                            node()
-                        ])
-                    ),
-                    ok;
-                (emqx_conf) ->
-                    emqx_config:save_schema_mod_and_names(emqx_enterprise_schema),
-                    %% emqx_config:save_schema_mod_and_names(emqx_license_schema),
-                    application:set_env(
-                        emqx,
-                        data_dir,
-                        filename:join([
-                            DataDir,
-                            TestCase,
-                            node()
-                        ])
-                    ),
-                    ok;
-                (emqx_license) ->
-                    set_special_configs(emqx_license),
-                    ok;
-                (_) ->
-                    ok
-            end}
-        ]
-    ),
-    Nodes = [emqx_common_test_helpers:start_peer(Name, Opts) || {Name, Opts} <- Cluster],
-    [{nodes, Nodes}, {cluster, Cluster}, {old_license, LicenseKey}];
 setup_test(_TestCase, _Config) ->
     [].
 
 teardown_test(_TestCase, _Config) ->
     ok.
 
-set_special_configs(emqx_license) ->
-    Config = #{key => default},
-    emqx_config:put([license], Config),
-    RawConfig = #{<<"key">> => <<"default">>},
-    emqx_config:put_raw([<<"license">>], RawConfig);
-set_special_configs(_) ->
-    ok.
-
-assert_on_nodes(Nodes, RunFun, CheckFun) ->
-    Res = [{N, erpc:call(N, RunFun)} || N <- Nodes],
-    lists:foreach(CheckFun, Res).
-
 %%------------------------------------------------------------------------------
 %% Tests
 %%------------------------------------------------------------------------------
diff --git a/apps/emqx_license/test/emqx_license_checker_SUITE.erl b/apps/emqx_license/test/emqx_license_checker_SUITE.erl
index 5733a09ce..9519cb0bc 100644
--- a/apps/emqx_license/test/emqx_license_checker_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_checker_SUITE.erl
@@ -14,34 +14,35 @@
 all() ->
     emqx_common_test_helpers:all(?MODULE).
 
-init_per_suite(CtConfig) ->
-    _ = application:load(emqx_conf),
+init_per_suite(Config) ->
     emqx_license_test_lib:mock_parser(),
-    ok = emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1),
-    CtConfig.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, #{
+                config => #{license => #{key => emqx_license_test_lib:default_test_license()}}
+            }}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
+end_per_suite(Config) ->
     emqx_license_test_lib:unmock_parser(),
-    ok = emqx_common_test_helpers:stop_apps([emqx_license]).
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(t_default_limits, Config) ->
-    ok = emqx_common_test_helpers:stop_apps([emqx_license]),
+    ok = application:stop(emqx_license),
     Config;
 init_per_testcase(_Case, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
     Config.
 
 end_per_testcase(t_default_limits, _Config) ->
-    ok = emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1);
+    {ok, _} = application:ensure_all_started(emqx_license);
 end_per_testcase(_Case, _Config) ->
     ok.
 
-set_special_configs(emqx_license) ->
-    Config = #{key => emqx_license_test_lib:default_test_license()},
-    emqx_config:put([license], Config);
-set_special_configs(_) ->
-    ok.
-
 %%------------------------------------------------------------------------------
 %% Tests
 %%------------------------------------------------------------------------------
diff --git a/apps/emqx_license/test/emqx_license_cli_SUITE.erl b/apps/emqx_license/test/emqx_license_cli_SUITE.erl
index ed6593aac..08d697c08 100644
--- a/apps/emqx_license/test/emqx_license_cli_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_cli_SUITE.erl
@@ -14,32 +14,29 @@ all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    _ = application:load(emqx_conf),
-    emqx_config:save_schema_mod_and_names(emqx_license_schema),
-    emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, #{
+                config => #{license => #{key => emqx_license_test_lib:default_license()}}
+            }}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    emqx_common_test_helpers:stop_apps([emqx_license]),
-    ok.
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(_Case, Config) ->
     emqx_license_test_lib:mock_parser(),
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
     Config.
 
 end_per_testcase(_Case, _Config) ->
     emqx_license_test_lib:unmock_parser(),
     ok.
 
-set_special_configs(emqx_license) ->
-    Config = #{key => emqx_license_test_lib:default_license()},
-    emqx_config:put([license], Config),
-    RawConfig = #{<<"key">> => emqx_license_test_lib:default_license()},
-    emqx_config:put_raw([<<"license">>], RawConfig);
-set_special_configs(_) ->
-    ok.
-
 %%------------------------------------------------------------------------------
 %% Tests
 %%------------------------------------------------------------------------------
diff --git a/apps/emqx_license/test/emqx_license_http_api_SUITE.erl b/apps/emqx_license/test/emqx_license_http_api_SUITE.erl
index 799e4f591..7d9cfb96f 100644
--- a/apps/emqx_license/test/emqx_license_http_api_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_http_api_SUITE.erl
@@ -7,7 +7,6 @@
 -compile(nowarn_export_all).
 -compile(export_all).
 
--include_lib("emqx/include/emqx_mqtt.hrl").
 -include_lib("eunit/include/eunit.hrl").
 -include_lib("common_test/include/ct.hrl").
 
@@ -20,41 +19,34 @@ all() ->
 
 init_per_suite(Config) ->
     emqx_license_test_lib:mock_parser(),
-    _ = application:load(emqx_conf),
-    emqx_config:save_schema_mod_and_names(emqx_license_schema),
-    emqx_common_test_helpers:start_apps([emqx_license, emqx_dashboard], fun set_special_configs/1),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, #{
+                config => #{
+                    license => #{
+                        key => emqx_license_test_lib:make_license(#{max_connections => "100"}),
+                        connection_low_watermark => <<"75%">>,
+                        connection_high_watermark => <<"80%">>
+                    }
+                }
+            }},
+            {emqx_dashboard,
+                "dashboard {"
+                "\n  listeners.http { enable = true, bind = 18083 }"
+                "\n  default_username = \"license_admin\""
+                "\n}"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    emqx_common_test_helpers:stop_apps([emqx_license, emqx_dashboard]),
-    LicenseKey = emqx_license_test_lib:make_license(#{max_connections => "100"}),
-    Config = #{key => LicenseKey},
-    emqx_config:put([license], Config),
-    RawConfig = #{<<"key">> => LicenseKey},
-    emqx_config:put_raw([<<"license">>], RawConfig),
+end_per_suite(Config) ->
     emqx_license_test_lib:unmock_parser(),
-    ok.
-
-set_special_configs(emqx_dashboard) ->
-    emqx_dashboard_api_test_helpers:set_default_config(<<"license_admin">>);
-set_special_configs(emqx_license) ->
-    LicenseKey = emqx_license_test_lib:make_license(#{max_connections => "100"}),
-    Config = #{
-        key => LicenseKey, connection_low_watermark => 0.75, connection_high_watermark => 0.8
-    },
-    emqx_config:put([license], Config),
-    RawConfig = #{
-        <<"key">> => LicenseKey,
-        <<"connection_low_watermark">> => <<"75%">>,
-        <<"connection_high_watermark">> => <<"80%">>
-    },
-    emqx_config:put_raw([<<"license">>], RawConfig),
-    ok;
-set_special_configs(_) ->
-    ok.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(_TestCase, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
     Config.
 
 end_per_testcase(_TestCase, _Config) ->
diff --git a/apps/emqx_license/test/emqx_license_parser_SUITE.erl b/apps/emqx_license/test/emqx_license_parser_SUITE.erl
index 0315a8a0b..0f06e76c3 100644
--- a/apps/emqx_license/test/emqx_license_parser_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_parser_SUITE.erl
@@ -14,26 +14,20 @@ all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    _ = application:load(emqx_conf),
-    emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, #{
+                config => #{license => #{key => emqx_license_test_lib:default_license()}}
+            }}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    emqx_common_test_helpers:stop_apps([emqx_license]),
-    ok.
-
-init_per_testcase(_Case, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
-    Config.
-
-end_per_testcase(_Case, _Config) ->
-    ok.
-
-set_special_configs(emqx_license) ->
-    Config = #{key => emqx_license_test_lib:default_license()},
-    emqx_config:put([license], Config);
-set_special_configs(_) ->
-    ok.
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 %%------------------------------------------------------------------------------
 %% Tests
diff --git a/apps/emqx_license/test/emqx_license_resources_SUITE.erl b/apps/emqx_license/test/emqx_license_resources_SUITE.erl
index 66e5d4a61..35510915f 100644
--- a/apps/emqx_license/test/emqx_license_resources_SUITE.erl
+++ b/apps/emqx_license/test/emqx_license_resources_SUITE.erl
@@ -15,26 +15,20 @@ all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    _ = application:load(emqx_conf),
-    emqx_common_test_helpers:start_apps([emqx_license], fun set_special_configs/1),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_license, #{
+                config => #{license => #{key => emqx_license_test_lib:default_license()}}
+            }}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    emqx_common_test_helpers:stop_apps([emqx_license]),
-    ok.
-
-init_per_testcase(_Case, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(node(), emqx_cluster_rpc, 1000),
-    Config.
-
-end_per_testcase(_Case, _Config) ->
-    ok.
-
-set_special_configs(emqx_license) ->
-    Config = #{key => emqx_license_test_lib:default_license()},
-    emqx_config:put([license], Config);
-set_special_configs(_) ->
-    ok.
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 %%------------------------------------------------------------------------------
 %% Tests

From 841fdea1246a9e4568a8476735e09870d300fb79 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 18:49:29 +0100
Subject: [PATCH 215/273] test(conf): update and simplify some testcases

---
 apps/emqx/test/emqx_cth_cluster.erl           |  5 +-
 .../emqx_conf/test/emqx_cluster_rpc_SUITE.erl |  8 +--
 apps/emqx_conf/test/emqx_conf_app_SUITE.erl   | 62 ++++++++-----------
 3 files changed, 32 insertions(+), 43 deletions(-)

diff --git a/apps/emqx/test/emqx_cth_cluster.erl b/apps/emqx/test/emqx_cth_cluster.erl
index 0ac597ff6..54e399795 100644
--- a/apps/emqx/test/emqx_cth_cluster.erl
+++ b/apps/emqx/test/emqx_cth_cluster.erl
@@ -38,7 +38,7 @@
 %%    in `end_per_suite/1` or `end_per_group/2`) with the result from step 2.
 -module(emqx_cth_cluster).
 
--export([start/1, start/2, restart/2]).
+-export([start/1, start/2, restart/1, restart/2]).
 -export([stop/1, stop_node/1]).
 
 -export([start_bare_nodes/1, start_bare_nodes/2]).
@@ -162,6 +162,9 @@ wait_clustered([Node | Nodes] = All, Check, Deadline) ->
             wait_clustered(All, Check, Deadline)
     end.
 
+restart(NodeSpec) ->
+    restart(maps:get(name, NodeSpec), NodeSpec).
+
 restart(Node, Spec) ->
     ct:pal("Stopping peer node ~p", [Node]),
     ok = emqx_cth_peer:stop(Node),
diff --git a/apps/emqx_conf/test/emqx_cluster_rpc_SUITE.erl b/apps/emqx_conf/test/emqx_cluster_rpc_SUITE.erl
index 99a0766ec..09e3d7517 100644
--- a/apps/emqx_conf/test/emqx_cluster_rpc_SUITE.erl
+++ b/apps/emqx_conf/test/emqx_cluster_rpc_SUITE.erl
@@ -42,10 +42,8 @@ suite() -> [{timetrap, {minutes, 5}}].
 groups() -> [].
 
 init_per_suite(Config) ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
     ok = emqx_common_test_helpers:start_apps([]),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
+    ok = mria:wait_for_tables(emqx_cluster_rpc:create_tables()),
     ok = emqx_config:put([node, cluster_call, retry_interval], 1000),
     meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
     meck:expect(emqx_alarm, activate, 3, ok),
@@ -56,10 +54,6 @@ init_per_suite(Config) ->
 
 end_per_suite(_Config) ->
     ok = emqx_common_test_helpers:stop_apps([]),
-    ekka:stop(),
-    mria:stop(),
-    meck:unload(mria),
-    mria_mnesia:delete_schema(),
     meck:unload(emqx_alarm),
     ok.
 
diff --git a/apps/emqx_conf/test/emqx_conf_app_SUITE.erl b/apps/emqx_conf/test/emqx_conf_app_SUITE.erl
index 155489af7..3ec897e08 100644
--- a/apps/emqx_conf/test/emqx_conf_app_SUITE.erl
+++ b/apps/emqx_conf/test/emqx_conf_app_SUITE.erl
@@ -27,9 +27,10 @@ all() ->
 
 t_copy_conf_override_on_restarts(Config) ->
     ct:timetrap({seconds, 120}),
-    snabbkaffe:fix_ct_logging(),
     Cluster = cluster(
-        [cluster_spec({core, 1}), cluster_spec({core, 2}), cluster_spec({core, 3})], Config
+        ?FUNCTION_NAME,
+        [cluster_spec({core, 1}), cluster_spec({core, 2}), cluster_spec({core, 3})],
+        Config
     ),
 
     %% 1. Start all nodes
@@ -42,7 +43,7 @@ t_copy_conf_override_on_restarts(Config) ->
 
         %% 3. Restart nodes in the same order.  This should not
         %% crash and eventually all nodes should be ready.
-        start_cluster_async(Cluster),
+        restart_cluster_async(Cluster),
 
         timer:sleep(15000),
 
@@ -54,11 +55,12 @@ t_copy_conf_override_on_restarts(Config) ->
     end.
 
 t_copy_new_data_dir(Config) ->
-    net_kernel:start(['master1@127.0.0.1', longnames]),
     ct:timetrap({seconds, 120}),
     snabbkaffe:fix_ct_logging(),
     Cluster = cluster(
-        [cluster_spec({core, 4}), cluster_spec({core, 5}), cluster_spec({core, 6})], Config
+        ?FUNCTION_NAME,
+        [cluster_spec({core, 4}), cluster_spec({core, 5}), cluster_spec({core, 6})],
+        Config
     ),
 
     %% 1. Start all nodes
@@ -81,11 +83,11 @@ t_copy_new_data_dir(Config) ->
     end.
 
 t_copy_deprecated_data_dir(Config) ->
-    net_kernel:start(['master2@127.0.0.1', longnames]),
     ct:timetrap({seconds, 120}),
-    snabbkaffe:fix_ct_logging(),
     Cluster = cluster(
-        [cluster_spec({core, 7}), cluster_spec({core, 8}), cluster_spec({core, 9})], Config
+        ?FUNCTION_NAME,
+        [cluster_spec({core, 7}), cluster_spec({core, 8}), cluster_spec({core, 9})],
+        Config
     ),
 
     %% 1. Start all nodes
@@ -108,11 +110,11 @@ t_copy_deprecated_data_dir(Config) ->
     end.
 
 t_no_copy_from_newer_version_node(Config) ->
-    net_kernel:start(['master2@127.0.0.1', longnames]),
     ct:timetrap({seconds, 120}),
-    snabbkaffe:fix_ct_logging(),
     Cluster = cluster(
-        [cluster_spec({core, 10}), cluster_spec({core, 11}), cluster_spec({core, 12})], Config
+        ?FUNCTION_NAME,
+        [cluster_spec({core, 10}), cluster_spec({core, 11}), cluster_spec({core, 12})],
+        Config
     ),
     OKs = [ok, ok, ok],
     [First | Rest] = Nodes = start_cluster(Cluster),
@@ -222,39 +224,29 @@ assert_config_load_done(Nodes) ->
     ).
 
 stop_cluster(Nodes) ->
-    emqx_utils:pmap(fun emqx_common_test_helpers:stop_peer/1, Nodes).
+    emqx_cth_cluster:stop(Nodes).
 
 start_cluster(Specs) ->
-    [emqx_common_test_helpers:start_peer(Name, Opts) || {Name, Opts} <- Specs].
+    emqx_cth_cluster:start(Specs).
 
-start_cluster_async(Specs) ->
+restart_cluster_async(Specs) ->
     [
         begin
-            Opts1 = maps:remove(join_to, Opts),
-            spawn_link(fun() -> emqx_common_test_helpers:start_peer(Name, Opts1) end),
-            timer:sleep(7_000)
+            _Pid = spawn_link(emqx_cth_cluster, restart, [Spec]),
+            timer:sleep(1_000)
         end
-     || {Name, Opts} <- Specs
+     || Spec <- Specs
     ].
 
-cluster(Specs, Config) ->
-    PrivDataDir = ?config(priv_dir, Config),
-    Env = [
-        {emqx, boot_modules, []}
+cluster(TC, Specs, Config) ->
+    Apps = [
+        {emqx, #{override_env => [{boot_modules, [broker]}]}},
+        {emqx_conf, #{}}
     ],
-    emqx_common_test_helpers:emqx_cluster(Specs, [
-        {env, Env},
-        {apps, [emqx_conf]},
-        {load_schema, false},
-        {priv_data_dir, PrivDataDir},
-        {env_handler, fun
-            (emqx) ->
-                application:set_env(emqx, boot_modules, []),
-                ok;
-            (_) ->
-                ok
-        end}
-    ]).
+    emqx_cth_cluster:mk_nodespecs(
+        [{Name, #{role => Role, apps => Apps}} || {Role, Name} <- Specs],
+        #{work_dir => emqx_cth_suite:work_dir(TC, Config)}
+    ).
 
 cluster_spec({Type, Num}) ->
     {Type, list_to_atom(atom_to_list(?MODULE) ++ integer_to_list(Num))}.

From d0e507eba481a48b8a82d5cd427e288756e3c65e Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 19:07:07 +0100
Subject: [PATCH 216/273] test(trie): fix testsuite setup

---
 apps/emqx/test/emqx_trie_SUITE.erl | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/apps/emqx/test/emqx_trie_SUITE.erl b/apps/emqx/test/emqx_trie_SUITE.erl
index 06696b9ed..f9b060aba 100644
--- a/apps/emqx/test/emqx_trie_SUITE.erl
+++ b/apps/emqx/test/emqx_trie_SUITE.erl
@@ -21,6 +21,7 @@
 
 -include_lib("emqx/include/emqx.hrl").
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 
 all() ->
     [
@@ -43,14 +44,14 @@ end_per_group(_, _) ->
     ok.
 
 init_per_suite(Config) ->
-    application:load(emqx),
-    ok = ekka:start(),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [{emqx, #{override_env => [{boot_modules, [broker]}]}}],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema().
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(_TestCase, Config) ->
     clear_tables(),
@@ -185,7 +186,8 @@ t_delete3(_) ->
     ?assertEqual([], ?TRIE:match(<<"sensor">>)),
     ?assertEqual([], ?TRIE:lookup_topic(<<"sensor/+">>, ?TRIE)).
 
-clear_tables() -> emqx_trie:clear_tables().
+clear_tables() ->
+    emqx_trie:clear_tables().
 
 trans(Fun) ->
     mria:transaction(?ROUTE_SHARD, Fun).

From b15e81baf2f7cec3afe66b8a61d128c126f029a0 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 19:07:51 +0100
Subject: [PATCH 217/273] test(slowsub): update and simplify testsuite setup

---
 .../test/emqx_slow_subs_SUITE.erl             | 55 +++++------------
 .../test/emqx_slow_subs_api_SUITE.erl         | 60 ++++++-------------
 2 files changed, 34 insertions(+), 81 deletions(-)

diff --git a/apps/emqx_slow_subs/test/emqx_slow_subs_SUITE.erl b/apps/emqx_slow_subs/test/emqx_slow_subs_SUITE.erl
index d93a0b4a2..49f8fcfcf 100644
--- a/apps/emqx_slow_subs/test/emqx_slow_subs_SUITE.erl
+++ b/apps/emqx_slow_subs/test/emqx_slow_subs_SUITE.erl
@@ -20,76 +20,51 @@
 -compile(nowarn_export_all).
 
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 -include_lib("emqx/include/emqx_mqtt.hrl").
 -include_lib("emqx/include/emqx.hrl").
 -include_lib("emqx_slow_subs/include/emqx_slow_subs.hrl").
 
 -define(NOW, erlang:system_time(millisecond)).
--define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
 -define(LANTENCY, 101).
 
 -define(BASE_CONF, <<
-    ""
-    "\n"
     "slow_subs {\n"
     "    enable = true\n"
     "	 top_k_num = 5\n"
     "	 threshold = 100ms\n"
     "    expire_interval = 5m\n"
     "    stats_type = whole\n"
-    "    }"
-    ""
+    "}"
 >>).
 
 all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
-    meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_alarm, activate, 3, ok),
-    meck:expect(emqx_alarm, deactivate, 3, ok),
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            {emqx_slow_subs, ?BASE_CONF}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-    ok = emqx_common_test_helpers:load_config(emqx_slow_subs_schema, ?BASE_CONF),
-    emqx_common_test_helpers:start_apps([emqx_slow_subs]),
-    Config.
-
-end_per_suite(_Config) ->
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    meck:unload(emqx_alarm),
-
-    emqx_common_test_helpers:stop_apps([emqx_slow_subs]).
-
-init_per_testcase(t_expire, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
-    update_config(<<"expire_interval">>, <<"1500ms">>),
-    Config;
-init_per_testcase(_, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
-    Config.
-
-end_per_testcase(_, _) ->
-    case erlang:whereis(node()) of
-        undefined ->
-            ok;
-        P ->
-            erlang:unlink(P),
-            erlang:exit(P, kill)
-    end,
-    ok.
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 %%--------------------------------------------------------------------
 %% Test Cases
 %%--------------------------------------------------------------------
+
 t_pub(_) ->
     _ = [stats_with_type(Type) || Type <- [whole, internal, response]],
     ok.
 
 t_expire(_) ->
+    _ = update_config(<<"expire_interval">>, <<"1500ms">>),
     Now = ?NOW,
     Each = fun(I) ->
         ClientId = erlang:list_to_binary(io_lib:format("test_~p", [I])),
diff --git a/apps/emqx_slow_subs/test/emqx_slow_subs_api_SUITE.erl b/apps/emqx_slow_subs/test/emqx_slow_subs_api_SUITE.erl
index 66ab745d1..e193b305a 100644
--- a/apps/emqx_slow_subs/test/emqx_slow_subs_api_SUITE.erl
+++ b/apps/emqx_slow_subs/test/emqx_slow_subs_api_SUITE.erl
@@ -20,10 +20,8 @@
 -compile(nowarn_export_all).
 
 -include_lib("eunit/include/eunit.hrl").
-
+-include_lib("common_test/include/ct.hrl").
 -include_lib("emqx/include/emqx.hrl").
--include_lib("emqx/include/emqx_mqtt.hrl").
--include_lib("emqx_management/include/emqx_mgmt.hrl").
 -include_lib("emqx_slow_subs/include/emqx_slow_subs.hrl").
 
 -define(HOST, "http://127.0.0.1:18083/").
@@ -32,63 +30,43 @@
 
 -define(BASE_PATH, "api").
 -define(NOW, erlang:system_time(millisecond)).
--define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
 
 -define(CONF_DEFAULT, <<
-    ""
-    "\n"
-    "slow_subs\n"
-    "{\n"
+    "slow_subs {\n"
     " enable = true\n"
     " top_k_num = 5,\n"
     " expire_interval = 60s\n"
     " stats_type = whole\n"
     "}"
-    ""
 >>).
 
 all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
-    meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_alarm, activate, 3, ok),
-    meck:expect(emqx_alarm, deactivate, 3, ok),
-
-    ok = emqx_common_test_helpers:load_config(emqx_slow_subs_schema, ?CONF_DEFAULT),
-    emqx_mgmt_api_test_util:init_suite([emqx_slow_subs]),
-    {ok, _} = application:ensure_all_started(emqx_auth),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_auth,
+            emqx_conf,
+            emqx_management,
+            {emqx_slow_subs, ?CONF_DEFAULT},
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    _ = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | Config].
 
 end_per_suite(Config) ->
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    meck:unload(emqx_alarm),
-
-    application:stop(emqx_auth),
-    emqx_mgmt_api_test_util:end_suite([emqx_slow_subs]),
-    Config.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(_, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
-    application:ensure_all_started(emqx_slow_subs),
-    timer:sleep(500),
+    {ok, _} = application:ensure_all_started(emqx_slow_subs),
     Config.
 
-end_per_testcase(_, Config) ->
-    application:stop(emqx_slow_subs),
-    case erlang:whereis(node()) of
-        undefined ->
-            ok;
-        P ->
-            erlang:unlink(P),
-            erlang:exit(P, kill)
-    end,
-    Config.
+end_per_testcase(_, _Config) ->
+    ok = application:stop(emqx_slow_subs).
 
 t_get_history(_) ->
     Now = ?NOW,

From a64850a84bfa30142ccbdc57f4ea3573cea90c2e Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 19:18:15 +0100
Subject: [PATCH 218/273] test(sso): update and simplify testsuites setup

---
 .../test/emqx_dashboard_sso_cli_SUITE.erl     | 21 +++++++-----
 .../test/emqx_dashboard_sso_ldap_SUITE.erl    | 33 +++++++++----------
 2 files changed, 28 insertions(+), 26 deletions(-)

diff --git a/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_cli_SUITE.erl b/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_cli_SUITE.erl
index d04206924..7df4a1798 100644
--- a/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_cli_SUITE.erl
+++ b/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_cli_SUITE.erl
@@ -9,6 +9,7 @@
 
 -include_lib("emqx_dashboard/include/emqx_dashboard.hrl").
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 -import(emqx_dashboard_sso_cli, [admins/1]).
@@ -24,15 +25,19 @@
 all() -> [t_add, t_passwd, t_del].
 
 init_per_suite(Config) ->
-    _ = application:load(emqx_conf),
-    emqx_config:save_schema_mod_and_names(emqx_dashboard_schema),
-    emqx_mgmt_api_test_util:init_suite([emqx_dashboard, emqx_dashboard_sso]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            emqx_dashboard,
+            emqx_dashboard_sso
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    All = emqx_dashboard_admin:all_users(),
-    [emqx_dashboard_admin:remove_user(Name) || #{username := Name} <- All],
-    emqx_mgmt_api_test_util:end_suite([emqx_conf, emqx_dashboard_sso]).
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 t_add(_) ->
     admins(["add", "user1", "password1"]),
diff --git a/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_ldap_SUITE.erl b/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_ldap_SUITE.erl
index 9e831b4d2..770969f5c 100644
--- a/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_ldap_SUITE.erl
+++ b/apps/emqx_dashboard_sso/test/emqx_dashboard_sso_ldap_SUITE.erl
@@ -44,31 +44,28 @@ all() ->
     ].
 
 init_per_suite(Config) ->
-    _ = application:load(emqx_conf),
-    emqx_config:save_schema_mod_and_names(emqx_dashboard_schema),
-    emqx_mgmt_api_test_util:init_suite([emqx_dashboard, emqx_dashboard_sso]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"},
+            emqx_dashboard_sso
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    _ = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_Config) ->
-    All = emqx_dashboard_admin:all_users(),
-    [emqx_dashboard_admin:remove_user(Name) || #{username := Name} <- All],
-    emqx_mgmt_api_test_util:end_suite([emqx_conf, emqx_dashboard_sso]).
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(Case, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
     ?MODULE:Case({init, Config}),
     Config.
 
 end_per_testcase(Case, Config) ->
-    ?MODULE:Case({'end', Config}),
-    case erlang:whereis(node()) of
-        undefined ->
-            ok;
-        P ->
-            erlang:unlink(P),
-            erlang:exit(P, kill)
-    end,
-    ok.
+    ?MODULE:Case({'end', Config}).
 
 t_bad_create({init, Config}) ->
     Config;

From ece1c6c6dccb731b8e2831a043b32dd7105c839e Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 20:13:54 +0100
Subject: [PATCH 219/273] test(prometheus): update and simplify testsuites
 setup

---
 .../test/emqx_prometheus_SUITE.erl            | 64 ++++++++-----------
 .../test/emqx_prometheus_api_SUITE.erl        | 54 +++++++---------
 2 files changed, 50 insertions(+), 68 deletions(-)

diff --git a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
index 11ca49f89..2d85f2a05 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
@@ -17,13 +17,12 @@
 -module(emqx_prometheus_SUITE).
 
 -include_lib("stdlib/include/assert.hrl").
+-include_lib("common_test/include/ct.hrl").
 
 -compile(nowarn_export_all).
 -compile(export_all).
 
--define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
 -define(LEGACY_CONF_DEFAULT, <<
-    "\n"
     "prometheus {\n"
     "  push_gateway_server = \"http://127.0.0.1:9091\"\n"
     "  interval = \"1s\"\n"
@@ -38,6 +37,7 @@
     "  vm_msacc_collector = disabled\n"
     "}\n"
 >>).
+
 -define(CONF_DEFAULT, #{
     <<"prometheus">> =>
         #{
@@ -84,40 +84,29 @@ common_tests() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_group(new_config, Config) ->
-    init_group(),
-    load_config(),
-    emqx_common_test_helpers:start_apps([emqx_prometheus]),
-    %% coverage olp metrics
-    {ok, _} = emqx:update_config([overload_protection, enable], true),
-    Config;
+    Apps = emqx_cth_suite:start(
+        [
+            %% coverage olp metrics
+            {emqx, "overload_protection.enable = true"},
+            {emqx_license, "license.key = default"},
+            {emqx_prometheus, #{config => config(default)}}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config];
 init_per_group(legacy_config, Config) ->
-    init_group(),
-    load_legacy_config(),
-    emqx_common_test_helpers:start_apps([emqx_prometheus]),
-    {ok, _} = emqx:update_config([overload_protection, enable], false),
-    Config.
-
-init_group() ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
-    meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_alarm, activate, 3, ok),
-    meck:expect(emqx_alarm, deactivate, 3, ok),
-    meck:new(emqx_license_checker, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_license_checker, expiry_epoch, fun() -> 1859673600 end).
-
-end_group() ->
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    meck:unload(emqx_alarm),
-    meck:unload(emqx_license_checker),
-    emqx_common_test_helpers:stop_apps([emqx_prometheus]).
+    Apps = emqx_cth_suite:start(
+        [
+            {emqx, "overload_protection.enable = false"},
+            {emqx_license, "license.key = default"},
+            {emqx_prometheus, #{config => config(legacy)}}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    [{suite_apps, Apps} | Config].
 
 end_per_group(_Group, Config) ->
-    end_group(),
-    Config.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(t_assert_push, Config) ->
     meck:new(httpc, [passthrough]),
@@ -137,11 +126,10 @@ end_per_testcase(t_assert_push, _Config) ->
 end_per_testcase(_Testcase, _Config) ->
     ok.
 
-load_config() ->
-    ok = emqx_common_test_helpers:load_config(emqx_prometheus_schema, ?CONF_DEFAULT).
-
-load_legacy_config() ->
-    ok = emqx_common_test_helpers:load_config(emqx_prometheus_schema, ?LEGACY_CONF_DEFAULT).
+config(default) ->
+    ?CONF_DEFAULT;
+config(legacy) ->
+    ?LEGACY_CONF_DEFAULT.
 
 %%--------------------------------------------------------------------
 %% Test cases
diff --git a/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
index 6092a5d54..79fd0ef91 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
@@ -21,9 +21,6 @@
 
 -include_lib("eunit/include/eunit.hrl").
 -include_lib("common_test/include/ct.hrl").
--define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
-
--define(LOGT(Format, Args), ct:pal("TEST_SUITE: " ++ Format, Args)).
 
 %%--------------------------------------------------------------------
 %% Setups
@@ -41,41 +38,38 @@ groups() ->
     ].
 
 init_per_suite(Config) ->
-    emqx_prometheus_SUITE:init_group(),
-    emqx_mgmt_api_test_util:init_suite([emqx_conf]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            emqx_management,
+            {emqx_prometheus, #{start => false}},
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"},
+            {emqx_license, "license.key = default"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | Config].
+
 end_per_suite(Config) ->
-    emqx_prometheus_SUITE:end_group(),
-    emqx_mgmt_api_test_util:end_suite([emqx_conf]),
-    Config.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_group(new_config, Config) ->
-    emqx_common_test_helpers:start_apps(
-        [emqx_prometheus],
-        fun(App) -> set_special_configs(App, new_config) end
+    Apps = emqx_cth_suite:start_app(
+        emqx_prometheus,
+        #{config => emqx_prometheus_SUITE:config(default)}
     ),
-    Config;
+    [{group_apps, Apps} | Config];
 init_per_group(legacy_config, Config) ->
-    emqx_common_test_helpers:start_apps(
-        [emqx_prometheus],
-        fun(App) -> set_special_configs(App, legacy_config) end
+    Apps = emqx_cth_suite:start_app(
+        emqx_prometheus,
+        #{config => emqx_prometheus_SUITE:config(legacy)}
     ),
-    Config.
+    [{group_apps, Apps} | Config].
 
 end_per_group(_Group, Config) ->
-    _ = application:stop(emqx_prometheus),
-    Config.
-
-set_special_configs(emqx_dashboard, _) ->
-    emqx_dashboard_api_test_helpers:set_default_config();
-set_special_configs(emqx_prometheus, new_config) ->
-    emqx_prometheus_SUITE:load_config(),
-    ok;
-set_special_configs(emqx_prometheus, legacy_config) ->
-    emqx_prometheus_SUITE:load_legacy_config(),
-    ok;
-set_special_configs(_App, _) ->
-    ok.
+    ok = emqx_cth_suite:stop_apps(?config(group_apps, Config)).
 
 %%--------------------------------------------------------------------
 %% Cases

From 35bf805504ddd6cc5367f7eea319f95f8544b360 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Tue, 13 Feb 2024 21:02:39 +0100
Subject: [PATCH 220/273] test(exhook): update and simplify testsuites setup

---
 apps/emqx_exhook/test/emqx_exhook_SUITE.erl   | 81 +++++--------------
 .../test/emqx_exhook_api_SUITE.erl            | 55 ++++---------
 .../test/emqx_exhook_metrics_SUITE.erl        | 15 ++--
 3 files changed, 41 insertions(+), 110 deletions(-)

diff --git a/apps/emqx_exhook/test/emqx_exhook_SUITE.erl b/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
index 2d53886e3..ea30f9ff3 100644
--- a/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
+++ b/apps/emqx_exhook/test/emqx_exhook_SUITE.erl
@@ -24,16 +24,11 @@
 -include_lib("eunit/include/eunit.hrl").
 -include_lib("common_test/include/ct.hrl").
 -include_lib("emqx/include/emqx_hooks.hrl").
--include_lib("emqx_conf/include/emqx_conf.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
--define(DEFAULT_CLUSTER_NAME_ATOM, emqxcl).
-
--define(OTHER_CLUSTER_NAME_ATOM, test_emqx_cluster).
 -define(OTHER_CLUSTER_NAME_STRING, "test_emqx_cluster").
 
 -define(CONF_DEFAULT, <<
-    "\n"
     "exhook {\n"
     "  servers = [\n"
     "    { name = default,\n"
@@ -54,8 +49,6 @@
     "}\n"
 >>).
 
--import(emqx_common_test_helpers, [on_exit/1]).
-
 %%--------------------------------------------------------------------
 %% Setups
 %%--------------------------------------------------------------------
@@ -63,47 +56,30 @@
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Cfg) ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
-    application:set_env(ekka, cluster_name, ?DEFAULT_CLUSTER_NAME_ATOM),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
-    meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_alarm, activate, 3, ok),
-    meck:expect(emqx_alarm, deactivate, 3, ok),
-
     _ = emqx_exhook_demo_svr:start(),
-    load_cfg(?CONF_DEFAULT),
-    emqx_common_test_helpers:start_apps([emqx_exhook]),
     Cfg.
 
 end_per_suite(_Cfg) ->
-    application:set_env(ekka, cluster_name, ?DEFAULT_CLUSTER_NAME_ATOM),
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    meck:unload(emqx_alarm),
-
-    emqx_common_test_helpers:stop_apps([emqx_exhook]),
     emqx_exhook_demo_svr:stop().
 
-init_per_testcase(_, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
-    timer:sleep(200),
-    Config.
+init_per_testcase(TC, Config) ->
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            {emqx_conf, emqx_conf(TC)},
+            {emqx_exhook, ?CONF_DEFAULT}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(TC, Config)}
+    ),
+    [{tc_apps, Apps} | Config].
 
-end_per_testcase(_, _Config) ->
-    case erlang:whereis(node()) of
-        undefined ->
-            ok;
-        P ->
-            erlang:unlink(P),
-            erlang:exit(P, kill)
-    end,
-    emqx_common_test_helpers:call_janitor(),
-    ok.
+end_per_testcase(_, Config) ->
+    ok = emqx_cth_suite:stop(?config(tc_apps, Config)).
 
-load_cfg(Cfg) ->
-    ok = emqx_common_test_helpers:load_config(emqx_exhook_schema, Cfg).
+emqx_conf(t_cluster_name) ->
+    io_lib:format("cluster.name = ~p", [?OTHER_CLUSTER_NAME_STRING]);
+emqx_conf(_) ->
+    #{}.
 
 %%--------------------------------------------------------------------
 %% Test cases
@@ -320,23 +296,6 @@ t_misc_test(_) ->
     ok.
 
 t_cluster_name(_) ->
-    SetEnvFun =
-        fun
-            (emqx) ->
-                application:set_env(ekka, cluster_name, ?OTHER_CLUSTER_NAME_ATOM);
-            (emqx_exhook) ->
-                ok
-        end,
-
-    stop_apps([emqx, emqx_exhook]),
-    emqx_common_test_helpers:start_apps([emqx, emqx_exhook], SetEnvFun),
-    on_exit(fun() ->
-        stop_apps([emqx, emqx_exhook]),
-        load_cfg(?CONF_DEFAULT),
-        emqx_common_test_helpers:start_apps([emqx_exhook]),
-        mria:wait_for_tables([?CLUSTER_MFA, ?CLUSTER_COMMIT])
-    end),
-
     ?assertEqual(?OTHER_CLUSTER_NAME_STRING, emqx_sys:cluster_name()),
 
     emqx_exhook_mgr:disable(<<"default">>),
@@ -364,7 +323,7 @@ t_stop_timeout(_) ->
     ),
 
     %% stop application
-    application:stop(emqx_exhook),
+    ok = application:stop(emqx_exhook),
     ?block_until(#{?snk_kind := exhook_mgr_terminated}, 20000),
 
     %% all exhook hooked point should be unloaded
@@ -379,7 +338,7 @@ t_stop_timeout(_) ->
     ?assertEqual(false, lists:any(fun(M) -> M == emqx_exhook_handler end, Mods)),
 
     %% ensure started for other tests
-    emqx_common_test_helpers:start_apps([emqx_exhook]),
+    {ok, _} = application:ensure_all_started(emqx_exhook),
 
     snabbkaffe:stop(),
     meck:unload(emqx_exhook_demo_svr).
@@ -510,10 +469,6 @@ data_file(Name) ->
 cert_file(Name) ->
     data_file(filename:join(["certs", Name])).
 
-%% FIXME: this creates inter-test dependency
-stop_apps(Apps) ->
-    emqx_common_test_helpers:stop_apps(Apps, #{erase_all_configs => false}).
-
 shuffle(List) ->
     Sorted = lists:sort(lists:map(fun(L) -> {rand:uniform(), L} end, List)),
     lists:map(fun({_, L}) -> L end, Sorted).
diff --git a/apps/emqx_exhook/test/emqx_exhook_api_SUITE.erl b/apps/emqx_exhook/test/emqx_exhook_api_SUITE.erl
index 1178f244b..a0e9aad45 100644
--- a/apps/emqx_exhook/test/emqx_exhook_api_SUITE.erl
+++ b/apps/emqx_exhook/test/emqx_exhook_api_SUITE.erl
@@ -20,16 +20,13 @@
 -compile(nowarn_export_all).
 
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 
 -define(HOST, "http://127.0.0.1:18083/").
 -define(API_VERSION, "v5").
 -define(BASE_PATH, "api").
--define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
-
--define(DEFAULT_CLUSTER_NAME_ATOM, emqxcl).
 
 -define(CONF_DEFAULT, <<
-    "\n"
     "exhook {\n"
     "  servers =\n"
     "    [ { name = default,\n"
@@ -56,54 +53,34 @@ all() ->
     ].
 
 init_per_suite(Config) ->
-    application:load(emqx_conf),
-    ok = ekka:start(),
-    application:set_env(ekka, cluster_name, ?DEFAULT_CLUSTER_NAME_ATOM),
-    ok = mria_rlog:wait_for_shards([?CLUSTER_RPC_SHARD], infinity),
-    meck:new(emqx_alarm, [non_strict, passthrough, no_link]),
-    meck:expect(emqx_alarm, activate, 3, ok),
-    meck:expect(emqx_alarm, deactivate, 3, ok),
-
     _ = emqx_exhook_demo_svr:start(),
-    load_cfg(?CONF_DEFAULT),
-    emqx_mgmt_api_test_util:init_suite([emqx_exhook]),
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_conf,
+            emqx_management,
+            {emqx_exhook, ?CONF_DEFAULT},
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
     [Conf] = emqx:get_raw_config([exhook, servers]),
-    [{template, Conf} | Config].
+    [{suite_apps, Apps}, {template, Conf} | Config].
 
 end_per_suite(Config) ->
-    application:set_env(ekka, cluster_name, ?DEFAULT_CLUSTER_NAME_ATOM),
-    ekka:stop(),
-    mria:stop(),
-    mria_mnesia:delete_schema(),
-    meck:unload(emqx_alarm),
-
-    emqx_mgmt_api_test_util:end_suite([emqx_exhook]),
     emqx_exhook_demo_svr:stop(),
     emqx_exhook_demo_svr:stop(<<"test1">>),
-    Config.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(t_add, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
     _ = emqx_exhook_demo_svr:start(<<"test1">>, 9001),
-    timer:sleep(200),
     Config;
 init_per_testcase(_, Config) ->
-    {ok, _} = emqx_cluster_rpc:start_link(),
-    timer:sleep(200),
     Config.
 
-end_per_testcase(_, Config) ->
-    case erlang:whereis(node()) of
-        undefined ->
-            ok;
-        P ->
-            erlang:unlink(P),
-            erlang:exit(P, kill)
-    end,
-    Config.
-
-load_cfg(Cfg) ->
-    ok = emqx_common_test_helpers:load_config(emqx_exhook_schema, Cfg).
+end_per_testcase(_, _Config) ->
+    ok.
 
 %%--------------------------------------------------------------------
 %% Test cases
diff --git a/apps/emqx_exhook/test/emqx_exhook_metrics_SUITE.erl b/apps/emqx_exhook/test/emqx_exhook_metrics_SUITE.erl
index 8ccee7f5d..c5b44b388 100644
--- a/apps/emqx_exhook/test/emqx_exhook_metrics_SUITE.erl
+++ b/apps/emqx_exhook/test/emqx_exhook_metrics_SUITE.erl
@@ -27,7 +27,6 @@
 -define(TARGET_HOOK, 'message.publish').
 
 -define(CONF, <<
-    "\n"
     "exhook {\n"
     "  servers = [\n"
     "              { name = succed,\n"
@@ -48,24 +47,24 @@
 all() -> emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Cfg) ->
-    application:load(emqx_conf),
     meck:new(emqx_exhook_mgr, [non_strict, passthrough, no_link]),
     meck:new(emqx_exhook_demo_svr, [non_strict, passthrough, no_link]),
     meck:expect(emqx_exhook_mgr, refresh_tick, fun() -> ok end),
     init_injections(hook_injects()),
-
-    emqx_exhook_SUITE:load_cfg(?CONF),
     _ = emqx_exhook_demo_svr:start(),
     _ = emqx_exhook_demo_svr:start(failed, 9001),
-    emqx_common_test_helpers:start_apps([emqx_exhook]),
-    Cfg.
+    Apps = emqx_cth_suite:start(
+        [emqx, {emqx_exhook, ?CONF}],
+        #{work_dir => emqx_cth_suite:work_dir(Cfg)}
+    ),
+    [{suite_apps, Apps} | Cfg].
 
-end_per_suite(_Cfg) ->
+end_per_suite(Cfg) ->
     meck:unload(emqx_exhook_demo_svr),
     meck:unload(emqx_exhook_mgr),
     emqx_exhook_demo_svr:stop(),
     emqx_exhook_demo_svr:stop(failed),
-    emqx_common_test_helpers:stop_apps([emqx_exhook]).
+    ok = emqx_cth_suite:stop(?config(suite_apps, Cfg)).
 
 init_per_testcase(_, Config) ->
     clear_metrics(),

From a68cc8fde2b873a5be8ce294e175c35ac7ebdd0f Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Tue, 13 Feb 2024 10:42:05 +0100
Subject: [PATCH 221/273] ci: build binaries for each arch of docker image
 separately

to speed up the build process, we build the binaries for multi-arch
docker image on the instances with corresponding architecture first,
then assemble the final docker image
---
 .github/workflows/_pr_entrypoint.yaml         |   2 +-
 .github/workflows/_push-entrypoint.yaml       |  10 +-
 .../build_and_push_docker_images.yaml         | 180 ++++++++++++------
 .github/workflows/build_docker_for_test.yaml  |   6 +-
 .github/workflows/build_packages.yaml         |   4 +-
 .github/workflows/run_docker_tests.yaml       |   8 +-
 build                                         |  40 +++-
 deploy/docker/Dockerfile                      |  66 ++++---
 deploy/docker/docker-entrypoint.sh            |   2 +-
 scripts/ui-tests/docker-compose.yaml          |   2 +-
 10 files changed, 209 insertions(+), 111 deletions(-)

diff --git a/.github/workflows/_pr_entrypoint.yaml b/.github/workflows/_pr_entrypoint.yaml
index 1f7e8e466..f795976f4 100644
--- a/.github/workflows/_pr_entrypoint.yaml
+++ b/.github/workflows/_pr_entrypoint.yaml
@@ -148,7 +148,7 @@ jobs:
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
-          retention-days: 1
+          retention-days: 7
 
   run_emqx_app_tests:
     needs:
diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index 7b309e592..048c931a5 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -28,7 +28,6 @@ jobs:
       profile: ${{ steps.parse-git-ref.outputs.profile }}
       release: ${{ steps.parse-git-ref.outputs.release }}
       latest: ${{ steps.parse-git-ref.outputs.latest }}
-      version: ${{ steps.parse-git-ref.outputs.version }}
       ct-matrix: ${{ steps.matrix.outputs.ct-matrix }}
       ct-host: ${{ steps.matrix.outputs.ct-host }}
       ct-docker: ${{ steps.matrix.outputs.ct-docker }}
@@ -46,18 +45,16 @@ jobs:
         shell: bash
         run: |
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
-      - name: Detect emqx profile and version
+      - name: Detect emqx profile
         id: parse-git-ref
         run: |
           JSON="$(./scripts/parse-git-ref.sh $GITHUB_REF)"
           PROFILE=$(echo "$JSON" | jq -cr '.profile')
           RELEASE=$(echo "$JSON" | jq -cr '.release')
           LATEST=$(echo "$JSON"  | jq -cr '.latest')
-          VERSION="$(./pkg-vsn.sh "$PROFILE")"
           echo "profile=$PROFILE" | tee -a $GITHUB_OUTPUT
           echo "release=$RELEASE" | tee -a $GITHUB_OUTPUT
           echo "latest=$LATEST"   | tee -a $GITHUB_OUTPUT
-          echo "version=$VERSION" | tee -a $GITHUB_OUTPUT
       - name: Build matrix
         id: matrix
         run: |
@@ -91,7 +88,7 @@ jobs:
     uses: ./.github/workflows/build_packages.yaml
     with:
       profile: ${{ needs.prepare.outputs.profile }}
-      publish: ${{ needs.prepare.outputs.release }}
+      publish: true
       otp_vsn: ${{ needs.prepare.outputs.otp_vsn }}
       elixir_vsn: ${{ needs.prepare.outputs.elixir_vsn }}
       builder_vsn: ${{ needs.prepare.outputs.builder_vsn }}
@@ -104,8 +101,7 @@ jobs:
     uses: ./.github/workflows/build_and_push_docker_images.yaml
     with:
       profile: ${{ needs.prepare.outputs.profile }}
-      version: ${{ needs.prepare.outputs.version }}
-      publish: ${{ needs.prepare.outputs.release }}
+      publish: true
       latest: ${{ needs.prepare.outputs.latest }}
       # TODO: revert this back to needs.prepare.outputs.otp_vsn when OTP 26 bug is fixed
       otp_vsn: 25.3.2-2
diff --git a/.github/workflows/build_and_push_docker_images.yaml b/.github/workflows/build_and_push_docker_images.yaml
index 1ab553840..166c5bc74 100644
--- a/.github/workflows/build_and_push_docker_images.yaml
+++ b/.github/workflows/build_and_push_docker_images.yaml
@@ -10,15 +10,12 @@ on:
       profile:
         required: true
         type: string
-      version:
-        required: true
-        type: string
       latest:
         required: true
         type: string
       publish:
         required: true
-        type: string
+        type: boolean
       otp_vsn:
         required: true
         type: string
@@ -45,8 +42,6 @@ on:
         required: false
         type: string
         default: 'emqx'
-      version:
-        required: true
       latest:
         required: false
         type: boolean
@@ -72,8 +67,11 @@ permissions:
   contents: read
 
 jobs:
-  docker:
-    runs-on: ${{ endsWith(github.repository, '/emqx') && 'ubuntu-22.04' || fromJSON('["self-hosted","ephemeral","linux","x64"]') }}
+  build:
+    runs-on: ${{ github.repository_owner == 'emqx' && fromJSON(format('["self-hosted","ephemeral","linux","{0}"]', matrix.arch)) || 'ubuntu-22.04' }}
+    container: "ghcr.io/emqx/emqx-builder/${{ inputs.builder_vsn }}:${{ inputs.elixir_vsn }}-${{ inputs.otp_vsn }}-debian11"
+    outputs:
+      PKG_VSN: ${{ steps.build.outputs.PKG_VSN }}
 
     strategy:
       fail-fast: false
@@ -81,54 +79,130 @@ jobs:
         profile:
           - ${{ inputs.profile }}
           - ${{ inputs.profile }}-elixir
-        registry:
-          - 'docker.io'
-          - 'public.ecr.aws'
-        exclude:
-          - profile: emqx-enterprise
-            registry: 'public.ecr.aws'
-          - profile: emqx-enterprise-elixir
-            registry: 'public.ecr.aws'
+        arch:
+          - x64
+          - arm64
 
     steps:
-    - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
-      with:
-        ref: ${{ github.event.inputs.ref }}
-        fetch-depth: 0
+      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        with:
+          ref: ${{ github.event.inputs.ref }}
+      - run: git config --global --add safe.directory "$PWD"
+      - name: build release tarball
+        id: build
+        run: |
+          make ${{ matrix.profile }}-tgz
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
+        with:
+          name: "${{ matrix.profile }}-${{ matrix.arch }}.tar.gz"
+          path: "_packages/emqx*/emqx-*.tar.gz"
+          retention-days: 7
+          overwrite: true
+          if-no-files-found: error
 
-    - uses: docker/setup-qemu-action@68827325e0b33c7199eb31dd4e31fbe9023e06e3 # v3.0.0
-    - uses: docker/setup-buildx-action@f95db51fddba0c2d1ec667646a06c2ce06100226 # v3.0.0
+  docker:
+    runs-on: ${{ endsWith(github.repository, '/emqx') && 'ubuntu-22.04' || fromJSON('["self-hosted","ephemeral","linux","x64"]') }}
+    needs:
+      - build
+    defaults:
+      run:
+        shell: bash
 
-    - name: Login to hub.docker.com
-      uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
-      if: matrix.registry == 'docker.io'
-      with:
-        username: ${{ secrets.DOCKER_HUB_USER }}
-        password: ${{ secrets.DOCKER_HUB_TOKEN }}
+    strategy:
+      fail-fast: false
+      matrix:
+        profile:
+          - ${{ inputs.profile }}
+          - ${{ inputs.profile }}-elixir
 
-    - name: Login to AWS ECR
-      uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
-      if: matrix.registry == 'public.ecr.aws'
-      with:
-        registry: public.ecr.aws
-        username: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        password: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-        ecr: true
+    steps:
+      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        with:
+          ref: ${{ github.event.inputs.ref }}
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
+        with:
+          pattern: "${{ matrix.profile }}-*.tar.gz"
+          path: _packages
+          merge-multiple: true
 
-    - name: Build docker image
-      env:
-        PROFILE: ${{ matrix.profile }}
-        DOCKER_REGISTRY: ${{ matrix.registry }}
-        DOCKER_ORG: ${{ github.repository_owner }}
-        DOCKER_LATEST: ${{ inputs.latest }}
-        DOCKER_PUSH: ${{ inputs.publish == 'true' || inputs.publish || github.repository_owner != 'emqx' }}
-        DOCKER_BUILD_NOCACHE: true
-        DOCKER_PLATFORMS: linux/amd64,linux/arm64
-        EMQX_RUNNER: 'debian:11-slim'
-        EMQX_DOCKERFILE: 'deploy/docker/Dockerfile'
-        PKG_VSN: ${{ inputs.version }}
-        EMQX_BUILDER_VERSION: ${{ inputs.builder_vsn }}
-        EMQX_BUILDER_OTP: ${{ inputs.otp_vsn }}
-        EMQX_BUILDER_ELIXIR: ${{ inputs.elixir_vsn }}
-      run: |
-        ./build ${PROFILE} docker
+      - name: Move artifacts to root directory
+        env:
+          PROFILE: ${{ inputs.profile }}
+        run: |
+          ls -lR _packages/$PROFILE
+          mv _packages/$PROFILE/*.tar.gz ./
+      - name: Enable containerd image store on Docker Engine
+        run: |
+          echo "$(jq '. += {"features": {"containerd-snapshotter": true}}' /etc/docker/daemon.json)" > daemon.json
+          sudo mv daemon.json /etc/docker/daemon.json
+          sudo systemctl restart docker
+
+      - uses: docker/setup-qemu-action@68827325e0b33c7199eb31dd4e31fbe9023e06e3 # v3.0.0
+      - uses: docker/setup-buildx-action@f95db51fddba0c2d1ec667646a06c2ce06100226 # v3.0.0
+
+      - name: Login to hub.docker.com
+        uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
+        if: inputs.publish || github.repository_owner != 'emqx'
+        with:
+          username: ${{ secrets.DOCKER_HUB_USER }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Login to AWS ECR
+        uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
+        if: inputs.publish || github.repository_owner != 'emqx'
+        with:
+          registry: public.ecr.aws
+          username: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          password: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          ecr: true
+
+      - name: Build docker image
+        env:
+          PROFILE: ${{ matrix.profile }}
+          DOCKER_REGISTRY: 'docker.io,public.ecr.aws'
+          DOCKER_ORG: ${{ github.repository_owner }}
+          DOCKER_LATEST: ${{ inputs.latest }}
+          DOCKER_PUSH: false
+          DOCKER_BUILD_NOCACHE: true
+          DOCKER_PLATFORMS: linux/amd64,linux/arm64
+          DOCKER_LOAD: true
+          EMQX_RUNNER: 'public.ecr.aws/debian/debian:11-slim@sha256:22cfb3c06a7dd5e18d86123a73405664475b9d9fa209cbedcf4c50a25649cc74'
+          EMQX_DOCKERFILE: 'deploy/docker/Dockerfile'
+          PKG_VSN: ${{ needs.build.outputs.PKG_VSN }}
+          EMQX_BUILDER_VERSION: ${{ inputs.builder_vsn }}
+          EMQX_BUILDER_OTP: ${{ inputs.otp_vsn }}
+          EMQX_BUILDER_ELIXIR: ${{ inputs.elixir_vsn }}
+          EMQX_SOURCE_TYPE: tgz
+        run: |
+          ./build ${PROFILE} docker
+          cat .emqx_docker_image_tags
+          echo "_EMQX_DOCKER_IMAGE_TAG=$(head -n 1 .emqx_docker_image_tags)" >> $GITHUB_ENV
+
+      - name: smoke test
+        timeout-minutes: 1
+        run: |
+          for tag in $(cat .emqx_docker_image_tags); do
+            CID=$(docker run -d -P $_EMQX_DOCKER_IMAGE_TAG)
+            HTTP_PORT=$(docker inspect --format='{{(index (index .NetworkSettings.Ports "18083/tcp") 0).HostPort}}' $CID)
+            ./scripts/test/emqx-smoke-test.sh localhost $HTTP_PORT
+            docker rm -f $CID
+          done
+      - name: dashboard tests
+        working-directory: ./scripts/ui-tests
+        timeout-minutes: 5
+        run: |
+          set -eu
+          docker compose up --abort-on-container-exit --exit-code-from selenium
+          docker compose rm -fsv
+      - name: test node_dump
+        run: |
+          CID=$(docker run -d -P $_EMQX_DOCKER_IMAGE_TAG)
+          docker exec -t -u root -w /root $CID bash -c 'apt-get -y update && apt-get -y install net-tools'
+          docker exec -t -u root $CID node_dump
+          docker rm -f $CID
+      - name: push images
+        if: inputs.publish || github.repository_owner != 'emqx'
+        run: |
+          for tag in $(cat .emqx_docker_image_tags); do
+            docker push $tag
+          done
diff --git a/.github/workflows/build_docker_for_test.yaml b/.github/workflows/build_docker_for_test.yaml
index 25adea083..91e5d64fa 100644
--- a/.github/workflows/build_docker_for_test.yaml
+++ b/.github/workflows/build_docker_for_test.yaml
@@ -47,16 +47,16 @@ jobs:
         id: build
         run: |
           make ${EMQX_NAME}-docker
-          echo "EMQX_IMAGE_TAG=$(cat .docker_image_tag)" >> $GITHUB_ENV
+          echo "_EMQX_DOCKER_IMAGE_TAG=$(head -n 1 .emqx_docker_image_tags)" >> $GITHUB_ENV
       - name: smoke test
         run: |
-          CID=$(docker run -d --rm -P $EMQX_IMAGE_TAG)
+          CID=$(docker run -d --rm -P $_EMQX_DOCKER_IMAGE_TAG)
           HTTP_PORT=$(docker inspect --format='{{(index (index .NetworkSettings.Ports "18083/tcp") 0).HostPort}}' $CID)
           ./scripts/test/emqx-smoke-test.sh localhost $HTTP_PORT
           docker stop $CID
       - name: export docker image
         run: |
-          docker save $EMQX_IMAGE_TAG | gzip > $EMQX_NAME-docker-$PKG_VSN.tar.gz
+          docker save $_EMQX_DOCKER_IMAGE_TAG | gzip > $EMQX_NAME-docker-$PKG_VSN.tar.gz
       - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
         with:
           name: "${{ env.EMQX_NAME }}-docker"
diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index 31f39d551..ce07af0ba 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -12,7 +12,7 @@ on:
         type: string
       publish:
         required: true
-        type: string
+        type: boolean
       otp_vsn:
         required: true
         type: string
@@ -203,7 +203,7 @@ jobs:
     needs:
       - mac
       - linux
-    if: inputs.publish == 'true' || inputs.publish
+    if: inputs.publish
     strategy:
       fail-fast: false
       matrix:
diff --git a/.github/workflows/run_docker_tests.yaml b/.github/workflows/run_docker_tests.yaml
index 9315ac815..7f73d48e8 100644
--- a/.github/workflows/run_docker_tests.yaml
+++ b/.github/workflows/run_docker_tests.yaml
@@ -43,8 +43,8 @@ jobs:
           path: /tmp
       - name: load docker image
         run: |
-          EMQX_IMAGE_TAG=$(docker load < /tmp/${EMQX_NAME}-docker-${PKG_VSN}.tar.gz 2>/dev/null | sed 's/Loaded image: //g')
-          echo "EMQX_IMAGE_TAG=$EMQX_IMAGE_TAG" >> $GITHUB_ENV
+          _EMQX_DOCKER_IMAGE_TAG=$(docker load < /tmp/${EMQX_NAME}-docker-${PKG_VSN}.tar.gz 2>/dev/null | sed 's/Loaded image: //g')
+          echo "_EMQX_DOCKER_IMAGE_TAG=$_EMQX_DOCKER_IMAGE_TAG" >> $GITHUB_ENV
       - name: dashboard tests
         working-directory: ./scripts/ui-tests
         run: |
@@ -52,7 +52,7 @@ jobs:
           docker compose up --abort-on-container-exit --exit-code-from selenium
       - name: test two nodes cluster with proto_dist=inet_tls in docker
         run: |
-          ./scripts/test/start-two-nodes-in-docker.sh -P $EMQX_IMAGE_TAG $EMQX_IMAGE_OLD_VERSION_TAG
+          ./scripts/test/start-two-nodes-in-docker.sh -P $_EMQX_DOCKER_IMAGE_TAG $EMQX_IMAGE_OLD_VERSION_TAG
           HTTP_PORT=$(docker inspect --format='{{(index (index .NetworkSettings.Ports "18083/tcp") 0).HostPort}}' haproxy)
           ./scripts/test/emqx-smoke-test.sh localhost $HTTP_PORT
           ./scripts/test/start-two-nodes-in-docker.sh -c
@@ -113,4 +113,4 @@ jobs:
       - name: test node_dump
         run: |
           docker exec -t -u root node1.emqx.io bash -c 'apt-get -y update && apt-get -y install net-tools'
-          docker exec node1.emqx.io node_dump
+          docker exec -t -u root node1.emqx.io node_dump
diff --git a/build b/build
index 7c74e5d90..af5f49c00 100755
--- a/build
+++ b/build
@@ -394,7 +394,7 @@ make_docker() {
     local EMQX_BUILDER=${EMQX_BUILDER:-ghcr.io/emqx/emqx-builder/${EMQX_BUILDER_VERSION}:${EMQX_BUILDER_ELIXIR}-${EMQX_BUILDER_OTP}-${EMQX_BUILDER_PLATFORM}}
     local EMQX_RUNNER="${EMQX_RUNNER:-${EMQX_DEFAULT_RUNNER}}"
     local EMQX_DOCKERFILE="${EMQX_DOCKERFILE:-deploy/docker/Dockerfile}"
-    local PKG_VSN="${PKG_VSN:-$(./pkg-vsn.sh)}"
+    local EMQX_SOURCE_TYPE="${EMQX_SOURCE_TYPE:-src}"
     # shellcheck disable=SC2155
     local VSN_MAJOR="$(scripts/semver.sh "$PKG_VSN" --major)"
     # shellcheck disable=SC2155
@@ -406,8 +406,14 @@ make_docker() {
         SUFFIX="-elixir"
     fi
     local DOCKER_REGISTRY="${DOCKER_REGISTRY:-docker.io}"
+    local DOCKER_REGISTRIES=( )
+    IFS=',' read -ra DOCKER_REGISTRY_ARR <<< "$DOCKER_REGISTRY"
+    for r in "${DOCKER_REGISTRY_ARR[@]}"; do
+        # append to DOCKER_REGISTRIES
+        DOCKER_REGISTRIES+=("$r")
+    done
     local DOCKER_ORG="${DOCKER_ORG:-emqx}"
-    local EMQX_BASE_DOCKER_TAG="${DOCKER_REGISTRY}/${DOCKER_ORG}/${PROFILE%%-elixir}"
+    local EMQX_BASE_DOCKER_TAG="${DOCKER_ORG}/${PROFILE%%-elixir}"
     local default_tag="${EMQX_BASE_DOCKER_TAG}:${PKG_VSN}${SUFFIX}"
     local EMQX_IMAGE_TAG="${EMQX_IMAGE_TAG:-$default_tag}"
     local EDITION=Opensource
@@ -432,11 +438,14 @@ make_docker() {
     local DOCKER_BUILDX_ARGS=(
        --build-arg BUILD_FROM="${EMQX_BUILDER}" \
        --build-arg RUN_FROM="${EMQX_RUNNER}" \
-       --build-arg EMQX_NAME="${PROFILE}" \
+       --build-arg SOURCE_TYPE="${EMQX_SOURCE_TYPE}" \
+       --build-arg PROFILE="${PROFILE%%-elixir}" \
+       --build-arg IS_ELIXIR="$([[ "$PROFILE" = *-elixir ]] && echo yes || echo no)" \
+       --build-arg SUFFIX="${SUFFIX}" \
        --build-arg EXTRA_DEPS="${EXTRA_DEPS}" \
        --build-arg PKG_VSN="${PKG_VSN}" \
        --file "${EMQX_DOCKERFILE}" \
-       --label org.opencontainers.image.title="${PROFILE}" \
+       --label org.opencontainers.image.title="${PROFILE%%-elixir}" \
        --label org.opencontainers.image.edition="${EDITION}" \
        --label org.opencontainers.image.version="${PKG_VSN}" \
        --label org.opencontainers.image.revision="${GIT_REVISION}" \
@@ -447,9 +456,13 @@ make_docker() {
        --label org.opencontainers.image.documentation="${DOCUMENTATION_URL}" \
        --label org.opencontainers.image.licenses="${LICENSE}" \
        --label org.opencontainers.image.otp.version="${EMQX_BUILDER_OTP}" \
-       --tag "${EMQX_IMAGE_TAG}" \
        --pull
     )
+    :> ./.emqx_docker_image_tags
+    for r in "${DOCKER_REGISTRIES[@]}"; do
+        DOCKER_BUILDX_ARGS+=(--tag "$r/${EMQX_IMAGE_TAG}")
+        echo "$r/${EMQX_IMAGE_TAG}" >> ./.emqx_docker_image_tags
+    done
     if [ "${DOCKER_BUILD_NOCACHE:-false}" = true ]; then
         DOCKER_BUILDX_ARGS+=(--no-cache)
     fi
@@ -457,9 +470,14 @@ make_docker() {
         DOCKER_BUILDX_ARGS+=(--label org.opencontainers.image.elixir.version="${EMQX_BUILDER_ELIXIR}")
     fi
     if [ "${DOCKER_LATEST:-false}" = true ]; then
-        DOCKER_BUILDX_ARGS+=(--tag "${EMQX_BASE_DOCKER_TAG}:latest${SUFFIX}")
-        DOCKER_BUILDX_ARGS+=(--tag "${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}${SUFFIX}")
-        DOCKER_BUILDX_ARGS+=(--tag "${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}.${VSN_PATCH}${SUFFIX}")
+        for r in "${DOCKER_REGISTRIES[@]}"; do
+          DOCKER_BUILDX_ARGS+=(--tag "$r/${EMQX_BASE_DOCKER_TAG}:latest${SUFFIX}")
+          echo "$r/${EMQX_BASE_DOCKER_TAG}:latest${SUFFIX}" >> ./.emqx_docker_image_tags
+          DOCKER_BUILDX_ARGS+=(--tag "$r/${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}${SUFFIX}")
+          echo "$r/${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}${SUFFIX}" >> ./.emqx_docker_image_tags
+          DOCKER_BUILDX_ARGS+=(--tag "$r/${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}.${VSN_PATCH}${SUFFIX}")
+          echo "$r/${EMQX_BASE_DOCKER_TAG}:${VSN_MAJOR}.${VSN_MINOR}.${VSN_PATCH}${SUFFIX}" >> ./.emqx_docker_image_tags
+        done
     fi
     if [ "${DOCKER_PLATFORMS:-default}" != 'default' ]; then
         DOCKER_BUILDX_ARGS+=(--platform "${DOCKER_PLATFORMS}")
@@ -467,6 +485,9 @@ make_docker() {
     if [ "${DOCKER_PUSH:-false}" = true ]; then
         DOCKER_BUILDX_ARGS+=(--push)
     fi
+    if [ "${DOCKER_LOAD:-false}" = true ]; then
+        DOCKER_BUILDX_ARGS+=(--load)
+    fi
     if [ -d "${REBAR_GIT_CACHE_DIR:-}" ]; then
         cache_tar="$(pwd)/rebar-git-cache.tar"
         if [ ! -f "${cache_tar}" ]; then
@@ -492,9 +513,8 @@ make_docker() {
         echo 'lux_logs/'
         echo '_upgrade_base/'
     } >> ./.dockerignore
-    echo "Docker build args: ${DOCKER_BUILDX_ARGS[*]}"
+    echo "Docker buildx args: ${DOCKER_BUILDX_ARGS[*]}"
     docker buildx build "${DOCKER_BUILDX_ARGS[@]}" .
-    echo "${EMQX_IMAGE_TAG}" > ./.docker_image_tag
 }
 
 function join {
diff --git a/deploy/docker/Dockerfile b/deploy/docker/Dockerfile
index b86220334..47e815215 100644
--- a/deploy/docker/Dockerfile
+++ b/deploy/docker/Dockerfile
@@ -1,35 +1,43 @@
 ARG BUILD_FROM=ghcr.io/emqx/emqx-builder/5.3-2:1.15.7-26.2.1-2-debian11@sha256:48b62a5636bd6bc59688fc98a498401fccf456fa63d843aa0b7279f3bc20b22e
 ARG RUN_FROM=public.ecr.aws/debian/debian:11-slim@sha256:22cfb3c06a7dd5e18d86123a73405664475b9d9fa209cbedcf4c50a25649cc74
-FROM ${BUILD_FROM} AS builder
+ARG SOURCE_TYPE=src # tgz
+
+FROM ${BUILD_FROM} as builder_src
+ONBUILD COPY . /emqx
+
+FROM ${BUILD_FROM} as builder_tgz
+ARG PROFILE=emqx
+ARG PKG_VSN
+ARG SUFFIX
+ARG TARGETARCH
+ONBUILD COPY ${PROFILE}-${PKG_VSN}${SUFFIX}-debian11-$TARGETARCH.tar.gz /${PROFILE}.tar.gz
+
+FROM builder_${SOURCE_TYPE} as builder
+
+ARG PROFILE=emqx
+ARG IS_ELIXIR=no
 ARG DEBUG=0
 
-COPY . /emqx
-
-ARG EMQX_NAME=emqx
-ARG PKG_VSN
-
 ENV EMQX_RELUP=false
-ENV DEBUG=${DEBUG}
 ENV EMQX_REL_FORM='docker'
 
 WORKDIR /emqx/
 
-RUN git config --global --add safe.directory '*'
-
-RUN if [ -f rebar-git-cache.tar ]; then \
+RUN mkdir -p /emqx-rel/emqx && \
+    if [ -f "/${PROFILE}.tar.gz" ]; then \
+      tar zxf "/${PROFILE}.tar.gz" -C /emqx-rel/emqx; \
+    else \
+      if [ -f rebar-git-cache.tar ]; then \
         mkdir .cache && \
         tar -xf rebar-git-cache.tar -C .cache && \
         export REBAR_GIT_CACHE_DIR='/emqx/.cache' && \
-        export REBAR_GIT_CACHE_REF_AUTOFILL=0 ;\
-    fi \
-    && export PROFILE=${EMQX_NAME%%-elixir} \
-    && export EMQX_NAME1="${EMQX_NAME}" \
-    && export EMQX_NAME=${PROFILE} \
-    && export EMQX_REL_PATH="/emqx/_build/${EMQX_NAME}/rel/emqx" \
-    && make ${EMQX_NAME1} \
-    && rm -f ${EMQX_REL_PATH}/*.tar.gz \
-    && mkdir -p /emqx-rel \
-    && mv ${EMQX_REL_PATH} /emqx-rel
+        export REBAR_GIT_CACHE_REF_AUTOFILL=0; \
+      fi && \
+      export EMQX_REL_PATH="/emqx/_build/${PROFILE}/rel/emqx" && \
+      git config --global --add safe.directory '*' && \
+      make ${PROFILE}-tgz && \
+      tar zxf _packages/${PROFILE}/*.tar.gz -C /emqx-rel/emqx; \
+    fi
 
 FROM $RUN_FROM
 ARG EXTRA_DEPS=''
@@ -39,21 +47,21 @@ ENV LC_ALL=C.UTF-8
 ENV LANG=C.UTF-8
 
 COPY deploy/docker/docker-entrypoint.sh /usr/bin/
-COPY --from=builder /emqx-rel/emqx /opt/emqx
-
-RUN ln -s /opt/emqx/bin/* /usr/local/bin/
-
-RUN apt-get update; \
-    apt-get install -y --no-install-recommends ca-certificates procps $(echo "${EXTRA_DEPS}" | tr ',' ' '); \
-    rm -rf /var/lib/apt/lists/*
+COPY --from=builder /emqx-rel /opt/
 
 WORKDIR /opt/emqx
 
-RUN groupadd -r -g 1000 emqx; \
+RUN set -eu; \
+    apt-get update; \
+    apt-get install -y --no-install-recommends ca-certificates procps $(echo "${EXTRA_DEPS}" | tr ',' ' '); \
+    find /opt/emqx -name 'swagger*.js.map' -exec rm {} +; \
+    groupadd -r -g 1000 emqx; \
     useradd -r -m -u 1000 -g emqx emqx; \
     chgrp -Rf emqx /opt/emqx; \
     chmod -Rf g+w /opt/emqx; \
-    chown -Rf emqx /opt/emqx
+    chown -Rf emqx /opt/emqx; \
+    ln -s /opt/emqx/bin/* /usr/local/bin/; \
+    rm -rf /var/lib/apt/lists/*
 
 USER emqx
 
diff --git a/deploy/docker/docker-entrypoint.sh b/deploy/docker/docker-entrypoint.sh
index 056f0675f..348880d7e 100755
--- a/deploy/docker/docker-entrypoint.sh
+++ b/deploy/docker/docker-entrypoint.sh
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-## EMQ docker image start script
+## EMQX docker image start script
 
 if [[ -n "$DEBUG" ]]; then
     set -ex
diff --git a/scripts/ui-tests/docker-compose.yaml b/scripts/ui-tests/docker-compose.yaml
index 538db5ca8..f5a66ab33 100644
--- a/scripts/ui-tests/docker-compose.yaml
+++ b/scripts/ui-tests/docker-compose.yaml
@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   emqx:
-    image: ${EMQX_IMAGE_TAG:-emqx/emqx:latest}
+    image: ${_EMQX_DOCKER_IMAGE_TAG:-emqx/emqx:latest}
     environment:
       EMQX_DASHBOARD__DEFAULT_PASSWORD: admin
 

From 7272ef25d48a35b9fb7c88bb94a5a1c3944fadeb Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Tue, 13 Feb 2024 22:07:33 +0200
Subject: [PATCH 222/273] feat(emqx_auth): implement API to re-order all
 authenticators/authz sources

Fixes: EMQX-11770
---
 apps/emqx_auth/include/emqx_authz.hrl         |   1 +
 .../src/emqx_authn/emqx_authn_api.erl         |  66 ++++++++-
 .../src/emqx_authn/emqx_authn_config.erl      |  29 ++++
 apps/emqx_auth/src/emqx_authz/emqx_authz.erl  |  41 ++++++
 .../src/emqx_authz/emqx_authz_api_sources.erl |  59 +++++++-
 .../test/emqx_authn/emqx_authn_api_SUITE.erl  | 105 ++++++++++++++
 .../emqx_authz_api_sources_SUITE.erl          | 131 +++++++++++++++++-
 changes/ce/feat-12509.en.md                   |   1 +
 rel/i18n/emqx_authn_api.hocon                 |   5 +
 rel/i18n/emqx_authz_api_sources.hocon         |   5 +
 10 files changed, 429 insertions(+), 14 deletions(-)
 create mode 100644 changes/ce/feat-12509.en.md

diff --git a/apps/emqx_auth/include/emqx_authz.hrl b/apps/emqx_auth/include/emqx_authz.hrl
index 9af795a82..4d3fc75dc 100644
--- a/apps/emqx_auth/include/emqx_authz.hrl
+++ b/apps/emqx_auth/include/emqx_authz.hrl
@@ -28,6 +28,7 @@
 -define(CMD_APPEND, append).
 -define(CMD_MOVE, move).
 -define(CMD_MERGE, merge).
+-define(CMD_REORDER, reorder).
 
 -define(CMD_MOVE_FRONT, front).
 -define(CMD_MOVE_REAR, rear).
diff --git a/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl b/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
index 1b299fa64..7f0413fbb 100644
--- a/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
+++ b/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
@@ -32,6 +32,8 @@
 -define(INTERNAL_ERROR, 'INTERNAL_ERROR').
 -define(CONFIG, emqx_authn_config).
 
+-define(join(List), lists:join(", ", List)).
+
 % Swagger
 
 -define(API_TAGS_GLOBAL, [<<"Authentication">>]).
@@ -56,6 +58,7 @@
     listener_authenticator/2,
     listener_authenticator_status/2,
     authenticator_position/2,
+    authenticators_order/2,
     listener_authenticator_position/2,
     authenticator_users/2,
     authenticator_user/2,
@@ -102,7 +105,8 @@ paths() ->
         "/authentication/:id/status",
         "/authentication/:id/position/:position",
         "/authentication/:id/users",
-        "/authentication/:id/users/:user_id"
+        "/authentication/:id/users/:user_id",
+        "/authentication/order"
 
         %% hide listener authn api since 5.1.0
         %% "/listeners/:listener_id/authentication",
@@ -118,7 +122,8 @@ roots() ->
         request_user_create,
         request_user_update,
         response_user,
-        response_users
+        response_users,
+        request_authn_order
     ].
 
 fields(request_user_create) ->
@@ -137,7 +142,16 @@ fields(response_user) ->
         {is_superuser, mk(boolean(), #{default => false, required => false})}
     ];
 fields(response_users) ->
-    paginated_list_type(ref(response_user)).
+    paginated_list_type(ref(response_user));
+fields(request_authn_order) ->
+    [
+        {id,
+            mk(binary(), #{
+                desc => ?DESC(param_auth_id),
+                required => true,
+                example => "password_based:built_in_database"
+            })}
+    ].
 
 schema("/authentication") ->
     #{
@@ -218,7 +232,7 @@ schema("/authentication/:id/status") ->
             parameters => [param_auth_id()],
             responses => #{
                 200 => emqx_dashboard_swagger:schema_with_examples(
-                    hoconsc:ref(emqx_authn_schema, "metrics_status_fields"),
+                    ref(emqx_authn_schema, "metrics_status_fields"),
                     status_metrics_example()
                 ),
                 404 => error_codes([?NOT_FOUND], <<"Not Found">>),
@@ -313,7 +327,7 @@ schema("/listeners/:listener_id/authentication/:id/status") ->
             parameters => [param_listener_id(), param_auth_id()],
             responses => #{
                 200 => emqx_dashboard_swagger:schema_with_examples(
-                    hoconsc:ref(emqx_authn_schema, "metrics_status_fields"),
+                    ref(emqx_authn_schema, "metrics_status_fields"),
                     status_metrics_example()
                 ),
                 400 => error_codes([?BAD_REQUEST], <<"Bad Request">>)
@@ -530,6 +544,22 @@ schema("/listeners/:listener_id/authentication/:id/users/:user_id") ->
                 404 => error_codes([?NOT_FOUND], <<"Not Found">>)
             }
         }
+    };
+schema("/authentication/order") ->
+    #{
+        'operationId' => authenticators_order,
+        put => #{
+            tags => ?API_TAGS_GLOBAL,
+            description => ?DESC(authentication_order_put),
+            'requestBody' => mk(
+                hoconsc:array(ref(?MODULE, request_authn_order)),
+                #{}
+            ),
+            responses => #{
+                204 => <<"Authenticators order updated">>,
+                400 => error_codes([?BAD_REQUEST], <<"Bad Request">>)
+            }
+        }
     }.
 
 param_auth_id() ->
@@ -670,6 +700,17 @@ listener_authenticator_status(
         end
     ).
 
+authenticators_order(put, #{body := AuthnOrder}) ->
+    AuthnIdsOrder = [Id || #{<<"id">> := Id} <- AuthnOrder],
+    case update_config([authentication], {reorder_authenticators, AuthnIdsOrder}) of
+        {ok, _} ->
+            {204};
+        {error, {_PrePostConfigUpdate, ?CONFIG, Reason}} ->
+            serialize_error(Reason);
+        {error, Reason} ->
+            serialize_error(Reason)
+    end.
+
 authenticator_position(
     put,
     #{bindings := #{id := AuthenticatorID, position := Position}}
@@ -1253,6 +1294,21 @@ serialize_error({unknown_authn_type, Type}) ->
         code => <<"BAD_REQUEST">>,
         message => binfmt("Unknown type '~p'", [Type])
     }};
+serialize_error(#{not_found := NotFound, not_reordered := NotReordered}) ->
+    NotFoundFmt = "Authenticators: ~ts are not found",
+    NotReorderedFmt = "No positions are specified for authenticators: ~ts",
+    Msg =
+        case {NotFound, NotReordered} of
+            {[_ | _], []} ->
+                binfmt(NotFoundFmt, [?join(NotFound)]);
+            {[], [_ | _]} ->
+                binfmt(NotReorderedFmt, [?join(NotReordered)]);
+            _ ->
+                binfmt(NotFoundFmt ++ ", " ++ NotReorderedFmt, [
+                    ?join(NotFound), ?join(NotReordered)
+                ])
+        end,
+    {400, #{code => <<"BAD_REQUEST">>, message => Msg}};
 serialize_error(Reason) ->
     {400, #{
         code => <<"BAD_REQUEST">>,
diff --git a/apps/emqx_auth/src/emqx_authn/emqx_authn_config.erl b/apps/emqx_auth/src/emqx_authn/emqx_authn_config.erl
index 70f0f31a4..cb55428b2 100644
--- a/apps/emqx_auth/src/emqx_authn/emqx_authn_config.erl
+++ b/apps/emqx_auth/src/emqx_authn/emqx_authn_config.erl
@@ -135,6 +135,8 @@ do_pre_config_update(_, {move_authenticator, _ChainName, AuthenticatorID, Positi
 do_pre_config_update(ConfPath, {merge_authenticators, NewConfig}, OldConfig) ->
     MergeConfig = merge_authenticators(OldConfig, NewConfig),
     do_pre_config_update(ConfPath, MergeConfig, OldConfig);
+do_pre_config_update(_ConfPath, {reorder_authenticators, NewOrder}, OldConfig) ->
+    reorder_authenticators(NewOrder, OldConfig);
 do_pre_config_update(_, OldConfig, OldConfig) ->
     {ok, OldConfig};
 do_pre_config_update(ConfPath, NewConfig, _OldConfig) ->
@@ -194,6 +196,15 @@ do_post_config_update(
     _AppEnvs
 ) ->
     emqx_authn_chains:move_authenticator(ChainName, AuthenticatorID, Position);
+do_post_config_update(
+    ConfPath,
+    {reorder_authenticators, NewOrder},
+    _NewConfig,
+    _OldConfig,
+    _AppEnvs
+) ->
+    ChainName = chain_name(ConfPath),
+    ok = emqx_authn_chains:reorder_authenticator(ChainName, NewOrder);
 do_post_config_update(_, _UpdateReq, OldConfig, OldConfig, _AppEnvs) ->
     ok;
 do_post_config_update(ConfPath, _UpdateReq, NewConfig0, OldConfig0, _AppEnvs) ->
@@ -389,6 +400,24 @@ merge_authenticators(OriginConf0, NewConf0) ->
         ),
     lists:reverse(OriginConf1) ++ NewConf1.
 
+reorder_authenticators(NewOrder, OldConfig) ->
+    OldConfigWithIds = [{authenticator_id(Auth), Auth} || Auth <- OldConfig],
+    reorder_authenticators(NewOrder, OldConfigWithIds, [], []).
+
+reorder_authenticators([], [] = _RemConfigWithIds, ReorderedConfig, [] = _NotFoundIds) ->
+    {ok, lists:reverse(ReorderedConfig)};
+reorder_authenticators([], RemConfigWithIds, _ReorderedConfig, NotFoundIds) ->
+    {error, #{not_found => NotFoundIds, not_reordered => [Id || {Id, _} <- RemConfigWithIds]}};
+reorder_authenticators([Id | RemOrder], RemConfigWithIds, ReorderedConfig, NotFoundIds) ->
+    case lists:keytake(Id, 1, RemConfigWithIds) of
+        {value, {_Id, Auth}, RemConfigWithIds1} ->
+            reorder_authenticators(
+                RemOrder, RemConfigWithIds1, [Auth | ReorderedConfig], NotFoundIds
+            );
+        false ->
+            reorder_authenticators(RemOrder, RemConfigWithIds, ReorderedConfig, [Id | NotFoundIds])
+    end.
+
 -ifdef(TEST).
 -include_lib("eunit/include/eunit.hrl").
 -compile(nowarn_export_all).
diff --git a/apps/emqx_auth/src/emqx_authz/emqx_authz.erl b/apps/emqx_auth/src/emqx_authz/emqx_authz.erl
index 5bc5e88df..d1253b516 100644
--- a/apps/emqx_auth/src/emqx_authz/emqx_authz.erl
+++ b/apps/emqx_auth/src/emqx_authz/emqx_authz.erl
@@ -36,6 +36,7 @@
     lookup/0,
     lookup/1,
     move/2,
+    reorder/1,
     update/2,
     merge/1,
     merge_local/2,
@@ -64,6 +65,8 @@
     maybe_write_files/1
 ]).
 
+-import(emqx_utils_conv, [bin/1]).
+
 -type default_result() :: allow | deny.
 
 -type authz_result_value() :: #{result := allow | deny, from => _}.
@@ -181,6 +184,9 @@ move(Type, Position) ->
         ?CONF_KEY_PATH, {?CMD_MOVE, type(Type), Position}
     ).
 
+reorder(SourcesOrder) ->
+    emqx_authz_utils:update_config(?CONF_KEY_PATH, {?CMD_REORDER, SourcesOrder}).
+
 update({?CMD_REPLACE, Type}, Sources) ->
     emqx_authz_utils:update_config(?CONF_KEY_PATH, {{?CMD_REPLACE, type(Type)}, Sources});
 update({?CMD_DELETE, Type}, Sources) ->
@@ -258,6 +264,8 @@ do_pre_config_update({?CMD_REPLACE, Sources}, _OldSources) ->
     NSources = lists:map(fun maybe_write_source_files/1, Sources),
     ok = check_dup_types(NSources),
     NSources;
+do_pre_config_update({?CMD_REORDER, NewSourcesOrder}, OldSources) ->
+    reorder_sources(NewSourcesOrder, OldSources);
 do_pre_config_update({Op, Source}, Sources) ->
     throw({bad_request, #{op => Op, source => Source, sources => Sources}}).
 
@@ -290,6 +298,16 @@ do_post_config_update(?CONF_KEY_PATH, {{?CMD_DELETE, Type}, _RawNewSource}, _Sou
     Front ++ Rear;
 do_post_config_update(?CONF_KEY_PATH, {?CMD_REPLACE, _RawNewSources}, Sources) ->
     overwrite_entire_sources(Sources);
+do_post_config_update(?CONF_KEY_PATH, {?CMD_REORDER, NewSourcesOrder}, _Sources) ->
+    OldSources = lookup(),
+    lists:map(
+        fun(Type) ->
+            Type1 = type(Type),
+            {value, Val} = lists:search(fun(S) -> type(S) =:= Type1 end, OldSources),
+            Val
+        end,
+        NewSourcesOrder
+    );
 do_post_config_update(?ROOT_KEY, Conf, Conf) ->
     #{sources := Sources} = Conf,
     Sources;
@@ -729,6 +747,29 @@ type_take(Type, Sources) ->
         throw:{not_found_source, Type} -> not_found
     end.
 
+reorder_sources(NewOrder, OldSources) ->
+    NewOrder1 = lists:map(fun type/1, NewOrder),
+    OldSourcesWithTypes = [{type(Source), Source} || Source <- OldSources],
+    reorder_sources(NewOrder1, OldSourcesWithTypes, [], []).
+
+reorder_sources([], [] = _RemSourcesWithTypes, ReorderedSources, [] = _NotFoundTypes) ->
+    lists:reverse(ReorderedSources);
+reorder_sources([], RemSourcesWithTypes, _ReorderedSources, NotFoundTypes) ->
+    {error, #{
+        not_found => NotFoundTypes, not_reordered => [bin(Type) || {Type, _} <- RemSourcesWithTypes]
+    }};
+reorder_sources([Type | RemOrder], RemSourcesWithTypes, ReorderedSources, NotFoundTypes) ->
+    case lists:keytake(Type, 1, RemSourcesWithTypes) of
+        {value, {_Type, Source}, RemSourcesWithTypes1} ->
+            reorder_sources(
+                RemOrder, RemSourcesWithTypes1, [Source | ReorderedSources], NotFoundTypes
+            );
+        false ->
+            reorder_sources(RemOrder, RemSourcesWithTypes, ReorderedSources, [
+                bin(Type) | NotFoundTypes
+            ])
+    end.
+
 -ifdef(TEST).
 -include_lib("eunit/include/eunit.hrl").
 -compile(nowarn_export_all).
diff --git a/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl b/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
index 00345a108..c2296f129 100644
--- a/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
+++ b/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
@@ -27,6 +27,8 @@
 -define(BAD_REQUEST, 'BAD_REQUEST').
 -define(NOT_FOUND, 'NOT_FOUND').
 
+-define(join(List), lists:join(", ", List)).
+
 -export([
     get_raw_sources/0,
     get_raw_source/1,
@@ -46,6 +48,7 @@
     sources/2,
     source/2,
     source_move/2,
+    sources_order/2,
     aggregate_metrics/1
 ]).
 
@@ -61,7 +64,8 @@ paths() ->
         "/authorization/sources",
         "/authorization/sources/:type",
         "/authorization/sources/:type/status",
-        "/authorization/sources/:type/move"
+        "/authorization/sources/:type/move",
+        "/authorization/sources/order"
     ].
 
 fields(sources) ->
@@ -77,6 +81,15 @@ fields(position) ->
                     in => body
                 }
             )}
+    ];
+fields(request_sources_order) ->
+    [
+        {type,
+            mk(enum(emqx_authz_schema:source_types()), #{
+                desc => ?DESC(source_type),
+                required => true,
+                example => "file"
+            })}
     ].
 
 %%--------------------------------------------------------------------
@@ -196,6 +209,22 @@ schema("/authorization/sources/:type/move") ->
                         404 => emqx_dashboard_swagger:error_codes([?NOT_FOUND], <<"Not Found">>)
                     }
             }
+    };
+schema("/authorization/sources/order") ->
+    #{
+        'operationId' => sources_order,
+        put => #{
+            tags => ?TAGS,
+            description => ?DESC(authorization_sources_order_put),
+            'requestBody' => mk(
+                hoconsc:array(ref(?MODULE, request_sources_order)),
+                #{}
+            ),
+            responses => #{
+                204 => <<"Authorization sources order updated">>,
+                400 => emqx_dashboard_swagger:error_codes([?BAD_REQUEST], <<"Bad Request">>)
+            }
+        }
     }.
 
 %%--------------------------------------------------------------------
@@ -317,6 +346,30 @@ source_move(post, #{bindings := #{type := Type}, body := #{<<"position">> := Pos
         end
     ).
 
+sources_order(put, #{body := AuthzOrder}) ->
+    SourcesOrder = [Type || #{<<"type">> := Type} <- AuthzOrder],
+    case emqx_authz:reorder(SourcesOrder) of
+        {ok, _} ->
+            {204};
+        {error, {_PrePostConfUpd, _, #{not_found := NotFound, not_reordered := NotReordered}}} ->
+            NotFoundFmt = "Authorization sources: ~ts are not found",
+            NotReorderedFmt = "No positions are specified for authorization sources: ~ts",
+            Msg =
+                case {NotFound, NotReordered} of
+                    {[_ | _], []} ->
+                        binfmt(NotFoundFmt, [?join(NotFound)]);
+                    {[], [_ | _]} ->
+                        binfmt(NotReorderedFmt, [?join(NotReordered)]);
+                    _ ->
+                        binfmt(NotFoundFmt ++ ", " ++ NotReorderedFmt, [
+                            ?join(NotFound), ?join(NotReordered)
+                        ])
+                end,
+            {400, #{code => <<"BAD_REQUEST">>, message => Msg}};
+        {error, Reason} ->
+            {400, #{code => <<"BAD_REQUEST">>, message => bin(Reason)}}
+    end.
+
 %%--------------------------------------------------------------------
 %% Internal functions
 %%--------------------------------------------------------------------
@@ -556,7 +609,9 @@ position_example() ->
             }
     }.
 
-bin(Term) -> erlang:iolist_to_binary(io_lib:format("~p", [Term])).
+bin(Term) -> binfmt("~p", [Term]).
+
+binfmt(Fmt, Args) -> iolist_to_binary(io_lib:format(Fmt, Args)).
 
 status_metrics_example() ->
     #{
diff --git a/apps/emqx_auth/test/emqx_authn/emqx_authn_api_SUITE.erl b/apps/emqx_auth/test/emqx_authn/emqx_authn_api_SUITE.erl
index cceab0d54..fbd0bb9e4 100644
--- a/apps/emqx_auth/test/emqx_authn/emqx_authn_api_SUITE.erl
+++ b/apps/emqx_auth/test/emqx_authn/emqx_authn_api_SUITE.erl
@@ -124,6 +124,111 @@ t_authenticator_fail(_) ->
 t_authenticator_position(_) ->
     test_authenticator_position([]).
 
+t_authenticators_reorder(_) ->
+    AuthenticatorConfs = [
+        emqx_authn_test_lib:http_example(),
+        %% Disabling an authenticator must not affect the requested order
+        (emqx_authn_test_lib:jwt_example())#{enable => false},
+        emqx_authn_test_lib:built_in_database_example()
+    ],
+    lists:foreach(
+        fun(Conf) ->
+            {ok, 200, _} = request(
+                post,
+                uri([?CONF_NS]),
+                Conf
+            )
+        end,
+        AuthenticatorConfs
+    ),
+    ?assertAuthenticatorsMatch(
+        [
+            #{<<"mechanism">> := <<"password_based">>, <<"backend">> := <<"http">>},
+            #{<<"mechanism">> := <<"jwt">>, <<"enable">> := false},
+            #{<<"mechanism">> := <<"password_based">>, <<"backend">> := <<"built_in_database">>}
+        ],
+        [?CONF_NS]
+    ),
+
+    OrderUri = uri([?CONF_NS, "order"]),
+
+    %% Invalid moves
+
+    %% Bad schema
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"not-id">> => <<"password_based:http">>},
+            #{<<"not-id">> => <<"jwt">>}
+        ]
+    ),
+
+    %% Partial order
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"id">> => <<"password_based:http">>},
+            #{<<"id">> => <<"jwt">>}
+        ]
+    ),
+
+    %% Not found authenticators
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"id">> => <<"password_based:http">>},
+            #{<<"id">> => <<"jwt">>},
+            #{<<"id">> => <<"password_based:built_in_database">>},
+            #{<<"id">> => <<"password_based:mongodb">>}
+        ]
+    ),
+
+    %% Both partial and not found errors
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"id">> => <<"password_based:http">>},
+            #{<<"id">> => <<"password_based:built_in_database">>},
+            #{<<"id">> => <<"password_based:mongodb">>}
+        ]
+    ),
+
+    %% Duplicates
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"id">> => <<"password_based:http">>},
+            #{<<"id">> => <<"password_based:built_in_database">>},
+            #{<<"id">> => <<"jwt">>},
+            #{<<"id">> => <<"password_based:http">>}
+        ]
+    ),
+
+    %% Valid moves
+    {ok, 204, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"id">> => <<"password_based:built_in_database">>},
+            #{<<"id">> => <<"jwt">>},
+            #{<<"id">> => <<"password_based:http">>}
+        ]
+    ),
+
+    ?assertAuthenticatorsMatch(
+        [
+            #{<<"mechanism">> := <<"password_based">>, <<"backend">> := <<"built_in_database">>},
+            #{<<"mechanism">> := <<"jwt">>, <<"enable">> := false},
+            #{<<"mechanism">> := <<"password_based">>, <<"backend">> := <<"http">>}
+        ],
+        [?CONF_NS]
+    ).
+
 %t_listener_authenticators(_) ->
 %    test_authenticators(["listeners", ?TCP_DEFAULT]).
 
diff --git a/apps/emqx_auth/test/emqx_authz/emqx_authz_api_sources_SUITE.erl b/apps/emqx_auth/test/emqx_authz/emqx_authz_api_sources_SUITE.erl
index e9dfa6a7b..246594777 100644
--- a/apps/emqx_auth/test/emqx_authz/emqx_authz_api_sources_SUITE.erl
+++ b/apps/emqx_auth/test/emqx_authz/emqx_authz_api_sources_SUITE.erl
@@ -29,7 +29,7 @@
 -define(PGSQL_HOST, "pgsql").
 -define(REDIS_SINGLE_HOST, "redis").
 
--define(SOURCE_REDIS1, #{
+-define(SOURCE_HTTP, #{
     <<"type">> => <<"http">>,
     <<"enable">> => true,
     <<"url">> => <<"https://fake.com:443/acl?username=", ?PH_USERNAME/binary>>,
@@ -74,7 +74,7 @@
     <<"ssl">> => #{<<"enable">> => false},
     <<"query">> => <<"abcb">>
 }).
--define(SOURCE_REDIS2, #{
+-define(SOURCE_REDIS, #{
     <<"type">> => <<"redis">>,
     <<"enable">> => true,
     <<"servers">> => <<?REDIS_SINGLE_HOST, ",127.0.0.1:6380">>,
@@ -188,10 +188,10 @@ t_api(_) ->
             {ok, 204, _} = request(post, uri(["authorization", "sources"]), Source)
         end
      || Source <- lists:reverse([
-            ?SOURCE_MONGODB, ?SOURCE_MYSQL, ?SOURCE_POSTGRESQL, ?SOURCE_REDIS2, ?SOURCE_FILE
+            ?SOURCE_MONGODB, ?SOURCE_MYSQL, ?SOURCE_POSTGRESQL, ?SOURCE_REDIS, ?SOURCE_FILE
         ])
     ],
-    {ok, 204, _} = request(post, uri(["authorization", "sources"]), ?SOURCE_REDIS1),
+    {ok, 204, _} = request(post, uri(["authorization", "sources"]), ?SOURCE_HTTP),
 
     {ok, 200, Result2} = request(get, uri(["authorization", "sources"]), []),
     Sources = get_sources(Result2),
@@ -211,7 +211,7 @@ t_api(_) ->
     {ok, 204, _} = request(
         put,
         uri(["authorization", "sources", "http"]),
-        ?SOURCE_REDIS1#{<<"enable">> := false}
+        ?SOURCE_HTTP#{<<"enable">> := false}
     ),
     {ok, 200, Result3} = request(get, uri(["authorization", "sources", "http"]), []),
     ?assertMatch(
@@ -338,7 +338,7 @@ t_api(_) ->
     {ok, 204, _} = request(
         put,
         uri(["authorization", "sources", "redis"]),
-        ?SOURCE_REDIS2#{
+        ?SOURCE_REDIS#{
             <<"servers">> := [
                 <<"192.168.1.100:6379">>,
                 <<"192.168.1.100:6380">>
@@ -503,7 +503,7 @@ t_api(_) ->
 
 t_source_move(_) ->
     {ok, _} = emqx_authz:update(replace, [
-        ?SOURCE_REDIS1, ?SOURCE_MONGODB, ?SOURCE_MYSQL, ?SOURCE_POSTGRESQL, ?SOURCE_REDIS2
+        ?SOURCE_HTTP, ?SOURCE_MONGODB, ?SOURCE_MYSQL, ?SOURCE_POSTGRESQL, ?SOURCE_REDIS
     ]),
     ?assertMatch(
         [
@@ -582,6 +582,123 @@ t_source_move(_) ->
 
     ok.
 
+t_sources_reorder(_) ->
+    %% Disabling an auth source must not affect the requested order
+    MongoDbDisabled = (?SOURCE_MONGODB)#{<<"enable">> => false},
+    {ok, _} = emqx_authz:update(replace, [
+        ?SOURCE_HTTP, MongoDbDisabled, ?SOURCE_MYSQL, ?SOURCE_POSTGRESQL, ?SOURCE_REDIS
+    ]),
+    ?assertMatch(
+        [
+            #{type := http},
+            #{type := mongodb},
+            #{type := mysql},
+            #{type := postgresql},
+            #{type := redis}
+        ],
+        emqx_authz:lookup()
+    ),
+
+    OrderUri = uri(["authorization", "sources", "order"]),
+
+    %% Valid moves
+    {ok, 204, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>},
+            #{<<"type">> => <<"mongodb">>}
+        ]
+    ),
+    ?assertMatch(
+        [
+            #{type := redis},
+            #{type := http},
+            #{type := postgresql},
+            #{type := mysql},
+            #{type := mongodb, enable := false}
+        ],
+        emqx_authz:lookup()
+    ),
+
+    %% Invalid moves
+
+    %% Bad schema
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [#{<<"not-type">> => <<"redis">>}]
+    ),
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"unkonw">>},
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>},
+            #{<<"type">> => <<"mongodb">>}
+        ]
+    ),
+
+    %% Partial order
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>}
+        ]
+    ),
+
+    %% Not found authenticators
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>},
+            #{<<"type">> => <<"mongodb">>},
+            #{<<"type">> => <<"built_in_database">>},
+            #{<<"type">> => <<"file">>}
+        ]
+    ),
+
+    %% Both partial and not found errors
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>},
+            #{<<"type">> => <<"built_in_database">>}
+        ]
+    ),
+
+    %% Duplicates
+    {ok, 400, _} = request(
+        put,
+        OrderUri,
+        [
+            #{<<"type">> => <<"redis">>},
+            #{<<"type">> => <<"http">>},
+            #{<<"type">> => <<"postgresql">>},
+            #{<<"type">> => <<"mysql">>},
+            #{<<"type">> => <<"mongodb">>},
+            #{<<"type">> => <<"http">>}
+        ]
+    ).
+
 t_aggregate_metrics(_) ->
     Metrics = #{
         'emqx@node1.emqx.io' => #{
diff --git a/changes/ce/feat-12509.en.md b/changes/ce/feat-12509.en.md
new file mode 100644
index 000000000..c7e2a5e5b
--- /dev/null
+++ b/changes/ce/feat-12509.en.md
@@ -0,0 +1 @@
+Implement API to re-order all authenticators / authorization sources.
diff --git a/rel/i18n/emqx_authn_api.hocon b/rel/i18n/emqx_authn_api.hocon
index 90240c4f4..9ab689723 100644
--- a/rel/i18n/emqx_authn_api.hocon
+++ b/rel/i18n/emqx_authn_api.hocon
@@ -60,6 +60,11 @@ authentication_post.desc:
 authentication_post.label:
 """Create authenticator"""
 
+authentication_order_put.desc:
+"""Reorder all authenticators in global authentication chain."""
+authentication_order_put.label:
+"""Reorder Authenticators"""
+
 is_superuser.desc:
 """Is superuser"""
 is_superuser.label:
diff --git a/rel/i18n/emqx_authz_api_sources.hocon b/rel/i18n/emqx_authz_api_sources.hocon
index 1257d9eb8..fdb13e6f5 100644
--- a/rel/i18n/emqx_authz_api_sources.hocon
+++ b/rel/i18n/emqx_authz_api_sources.hocon
@@ -35,6 +35,11 @@ authorization_sources_type_status_get.desc:
 authorization_sources_type_status_get.label:
 """Get a authorization source"""
 
+authorization_sources_order_put.desc:
+"""Reorder all authorization sources."""
+authorization_sources_order_put.label:
+"""Reorder Authorization Sources"""
+
 source.desc:
 """Authorization source"""
 source.label:

From 28a10b166428f1a441886d361e561e81768a5811 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 14 Feb 2024 15:25:08 +0100
Subject: [PATCH 223/273] ci(docker): use lightweight image when building from
 tar.gz

---
 deploy/docker/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deploy/docker/Dockerfile b/deploy/docker/Dockerfile
index 47e815215..88e05dcad 100644
--- a/deploy/docker/Dockerfile
+++ b/deploy/docker/Dockerfile
@@ -5,7 +5,7 @@ ARG SOURCE_TYPE=src # tgz
 FROM ${BUILD_FROM} as builder_src
 ONBUILD COPY . /emqx
 
-FROM ${BUILD_FROM} as builder_tgz
+FROM ${RUN_FROM} as builder_tgz
 ARG PROFILE=emqx
 ARG PKG_VSN
 ARG SUFFIX

From dbd8173635db76565912ef8847c7dd07a5fcae52 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Wed, 14 Feb 2024 16:54:03 +0100
Subject: [PATCH 224/273] ci(docker): use correct tag for smoke test

---
 .github/workflows/build_and_push_docker_images.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/build_and_push_docker_images.yaml b/.github/workflows/build_and_push_docker_images.yaml
index 166c5bc74..0c123b0c1 100644
--- a/.github/workflows/build_and_push_docker_images.yaml
+++ b/.github/workflows/build_and_push_docker_images.yaml
@@ -182,7 +182,7 @@ jobs:
         timeout-minutes: 1
         run: |
           for tag in $(cat .emqx_docker_image_tags); do
-            CID=$(docker run -d -P $_EMQX_DOCKER_IMAGE_TAG)
+            CID=$(docker run -d -P $tag)
             HTTP_PORT=$(docker inspect --format='{{(index (index .NetworkSettings.Ports "18083/tcp") 0).HostPort}}' $CID)
             ./scripts/test/emqx-smoke-test.sh localhost $HTTP_PORT
             docker rm -f $CID

From a153d758c3a8c7130727563440f089df32d97959 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Mon, 12 Feb 2024 12:42:16 +0100
Subject: [PATCH 225/273] feat: refactor HStreamDB bridge to connector and
 action

This commit also upgrades the hstreamdb_erl driver library and change
the action/bridge to use the new hstreamdb_erl.

Much of the code for the new API is copied from:
https://github.com/emqx/emqx-enterprise/blob/be1a1604dd5c4c06ea6be15b702f35d9bdec48a7/lib-ee/emqx_rule_actions/src/emqx_backend_hstreamdb_actions.erl

Fixes:
https://emqx.atlassian.net/browse/EMQX-11458
---
 .ci/docker-compose-file/.env                  |   2 +-
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 apps/emqx_bridge_hstreamdb/rebar.config       |   2 +-
 .../src/emqx_bridge_hstreamdb.app.src         |   4 +-
 .../src/emqx_bridge_hstreamdb.erl             | 157 ++++++-
 .../src/emqx_bridge_hstreamdb_action_info.erl |  88 ++++
 .../src/emqx_bridge_hstreamdb_connector.erl   | 412 +++++++++++-------
 .../test/emqx_bridge_hstreamdb_SUITE.erl      | 153 ++++++-
 .../src/schema/emqx_connector_ee_schema.erl   |  12 +
 .../src/schema/emqx_connector_schema.erl      |   2 +
 mix.exs                                       |   2 +-
 11 files changed, 629 insertions(+), 206 deletions(-)
 create mode 100644 apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl

diff --git a/.ci/docker-compose-file/.env b/.ci/docker-compose-file/.env
index 73ec47d00..1b837aea3 100644
--- a/.ci/docker-compose-file/.env
+++ b/.ci/docker-compose-file/.env
@@ -10,7 +10,7 @@ CASSANDRA_TAG=3.11
 MINIO_TAG=RELEASE.2023-03-20T20-16-18Z
 OPENTS_TAG=9aa7f88
 KINESIS_TAG=2.1
-HSTREAMDB_TAG=v0.16.1
+HSTREAMDB_TAG=v0.19.3
 HSTREAMDB_ZK_TAG=3.8.1
 
 MS_IMAGE_ADDR=mcr.microsoft.com/mssql/server
diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 3a9e13f94..a57b7eed0 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -91,6 +91,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_gcp_pubsub_producer_action_info,
         emqx_bridge_kafka_action_info,
         emqx_bridge_kinesis_action_info,
+        emqx_bridge_hstreamdb_action_info,
         emqx_bridge_matrix_action_info,
         emqx_bridge_mongodb_action_info,
         emqx_bridge_oracle_action_info,
diff --git a/apps/emqx_bridge_hstreamdb/rebar.config b/apps/emqx_bridge_hstreamdb/rebar.config
index eab7bcb3f..c2e3194ac 100644
--- a/apps/emqx_bridge_hstreamdb/rebar.config
+++ b/apps/emqx_bridge_hstreamdb/rebar.config
@@ -3,7 +3,7 @@
 {erl_opts, [debug_info]}.
 {deps, [
     {hstreamdb_erl,
-        {git, "https://github.com/hstreamdb/hstreamdb_erl.git", {tag, "0.4.5+v0.16.1"}}},
+        {git, "https://github.com/hstreamdb/hstreamdb_erl.git", {tag, "0.5.18+v0.18.1"}}},
     {emqx, {path, "../../apps/emqx"}},
     {emqx_utils, {path, "../../apps/emqx_utils"}}
 ]}.
diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.app.src b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.app.src
index f9825e3dd..84c09fe3a 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.app.src
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_hstreamdb, [
     {description, "EMQX Enterprise HStreamDB Bridge"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {applications, [
         kernel,
@@ -8,7 +8,7 @@
         emqx_resource,
         hstreamdb_erl
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_hstreamdb_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
index 7052e0120..ee0baaa4c 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
@@ -6,10 +6,12 @@
 -include_lib("typerefl/include/types.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--import(hoconsc, [mk/2, enum/1, ref/2]).
+-import(hoconsc, [mk/2, enum/1]).
 
 -export([
-    conn_bridge_examples/1
+    conn_bridge_examples/1,
+    bridge_v2_examples/1,
+    connector_examples/1
 ]).
 
 -export([
@@ -19,6 +21,11 @@
     desc/1
 ]).
 
+-define(CONNECTOR_TYPE, hstreamdb).
+-define(ACTION_TYPE, ?CONNECTOR_TYPE).
+-define(DEFAULT_GRPC_TIMEOUT_RAW, <<"30s">>).
+-define(DEFAULT_GRPC_FLUSH_TIMEOUT_RAW, <<"10s">>).
+
 %% -------------------------------------------------------------------------------------------------
 %% api
 
@@ -27,16 +34,16 @@ conn_bridge_examples(Method) ->
         #{
             <<"hstreamdb">> => #{
                 summary => <<"HStreamDB Bridge">>,
-                value => values(Method)
+                value => conn_bridge_example_values(Method)
             }
         }
     ].
 
-values(get) ->
-    values(post);
-values(put) ->
-    values(post);
-values(post) ->
+conn_bridge_example_values(get) ->
+    conn_bridge_example_values(post);
+conn_bridge_example_values(put) ->
+    conn_bridge_example_values(post);
+conn_bridge_example_values(post) ->
     #{
         type => <<"hstreamdb">>,
         name => <<"demo">>,
@@ -55,15 +62,135 @@ values(post) ->
         },
         ssl => #{enable => false}
     };
-values(_) ->
+conn_bridge_example_values(_) ->
     #{}.
 
+connector_examples(Method) ->
+    [
+        #{
+            <<"hstreamdb">> =>
+                #{
+                    summary => <<"HStreamDB Connector">>,
+                    value => emqx_connector_schema:connector_values(
+                        Method, ?CONNECTOR_TYPE, connector_values()
+                    )
+                }
+        }
+    ].
+
+connector_values() ->
+    #{
+        <<"url">> => <<"http://127.0.0.1:6570">>,
+        <<"grpc_timeout">> => <<"30s">>,
+        <<"ssl">> =>
+            #{
+                <<"enable">> => false,
+                <<"verify">> => <<"verify_peer">>
+            },
+        <<"resource_opts">> =>
+            #{
+                <<"health_check_interval">> => <<"15s">>,
+                <<"start_timeout">> => <<"5s">>
+            }
+    }.
+
+bridge_v2_examples(Method) ->
+    [
+        #{
+            <<"hstreamdb">> =>
+                #{
+                    summary => <<"HStreamDB Action">>,
+                    value => emqx_bridge_v2_schema:action_values(
+                        Method, ?ACTION_TYPE, ?CONNECTOR_TYPE, action_values()
+                    )
+                }
+        }
+    ].
+
+action_values() ->
+    #{
+        <<"parameters">> => #{
+            <<"aggregation_pool_size">> => 8,
+            <<"partition_key">> => <<"hej">>,
+            <<"record_template">> => <<"${payload}">>,
+            <<"stream">> => <<"mqtt_message">>,
+            <<"writer_pool_size">> => 8
+        }
+    }.
+
 %% -------------------------------------------------------------------------------------------------
 %% Hocon Schema Definitions
 namespace() -> "bridge_hstreamdb".
 
 roots() -> [].
 
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    Fields =
+        fields(connector_fields) ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(hstreamdb_action));
+fields(action) ->
+    {?ACTION_TYPE,
+        hoconsc:mk(
+            hoconsc:map(name, hoconsc:ref(?MODULE, hstreamdb_action)),
+            #{
+                desc => <<"HStreamDB Action Config">>,
+                required => false
+            }
+        )};
+fields(hstreamdb_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        hoconsc:mk(
+            hoconsc:ref(?MODULE, action_parameters),
+            #{
+                required => true,
+                desc => ?DESC("action_parameters")
+            }
+        )
+    );
+fields(action_parameters) ->
+    [
+        {stream, mk(binary(), #{required => true, desc => ?DESC("stream_name")})},
+
+        {partition_key, mk(binary(), #{required => false, desc => ?DESC("partition_key")})},
+
+        {grpc_flush_timeout, fun grpc_flush_timeout/1},
+        {record_template,
+            mk(binary(), #{default => <<"${payload}">>, desc => ?DESC("record_template")})},
+        {aggregation_pool_size,
+            mk(integer(), #{default => 8, desc => ?DESC("aggregation_pool_size")})},
+        {max_batches, mk(integer(), #{default => 500, desc => ?DESC("max_batches")})},
+        {writer_pool_size, mk(integer(), #{default => 8, desc => ?DESC("writer_pool_size")})},
+        {batch_size, mk(integer(), #{default => 100, desc => ?DESC("batch_size")})},
+        {batch_interval,
+            mk(emqx_schema:timeout_duration_ms(), #{
+                default => <<"500ms">>, desc => ?DESC("batch_interval")
+            })}
+    ];
+fields(connector_fields) ->
+    [
+        {url,
+            mk(binary(), #{
+                required => true, desc => ?DESC("url"), default => <<"http://127.0.0.1:6570">>
+            })},
+        {grpc_timeout, fun grpc_timeout/1}
+    ] ++ emqx_connector_schema_lib:ssl_fields();
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        fields(connector_fields) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
 fields("config") ->
     hstream_bridge_common_fields() ++
         connector_fields();
@@ -80,6 +207,18 @@ fields("put") ->
     hstream_bridge_common_fields() ++
         connector_fields().
 
+grpc_timeout(type) -> emqx_schema:timeout_duration_ms();
+grpc_timeout(desc) -> ?DESC("grpc_timeout");
+grpc_timeout(default) -> ?DEFAULT_GRPC_TIMEOUT_RAW;
+grpc_timeout(required) -> false;
+grpc_timeout(_) -> undefined.
+
+grpc_flush_timeout(type) -> emqx_schema:timeout_duration_ms();
+grpc_flush_timeout(desc) -> ?DESC("grpc_timeout");
+grpc_flush_timeout(default) -> ?DEFAULT_GRPC_FLUSH_TIMEOUT_RAW;
+grpc_flush_timeout(required) -> false;
+grpc_flush_timeout(_) -> undefined.
+
 hstream_bridge_common_fields() ->
     emqx_bridge_schema:common_bridge_fields() ++
         [
diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl
new file mode 100644
index 000000000..66188110f
--- /dev/null
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl
@@ -0,0 +1,88 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2022-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%--------------------------------------------------------------------
+
+-module(emqx_bridge_hstreamdb_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0,
+    bridge_v1_config_to_connector_config/1,
+    bridge_v1_config_to_action_config/2,
+    connector_action_config_to_bridge_v1_config/2
+]).
+
+bridge_v1_type_name() -> hstreamdb.
+
+action_type_name() -> hstreamdb.
+
+connector_type_name() -> hstreamdb.
+
+schema_module() -> emqx_bridge_hstreamdb.
+
+bridge_v1_config_to_connector_config(BridgeV1Conf) ->
+    ConnectorSchema = emqx_bridge_hstreamdb:fields(connector_fields),
+    ConnectorAtomKeys = lists:foldl(fun({K, _}, Acc) -> [K | Acc] end, [], ConnectorSchema),
+    ConnectorBinKeys = [atom_to_binary(K) || K <- ConnectorAtomKeys] ++ [<<"resource_opts">>],
+    ConnectorConfig0 = maps:with(ConnectorBinKeys, BridgeV1Conf),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        ConnectorConfig0
+    ).
+
+bridge_v1_config_to_action_config(BridgeV1Conf, ConnectorName) ->
+    Config0 = emqx_action_info:transform_bridge_v1_config_to_action_config(
+        BridgeV1Conf, ConnectorName, emqx_bridge_hstreamdb, "config_connector"
+    ),
+    %% Remove fields no longer relevant for the action
+    Config1 = lists:foldl(
+        fun(Field, Acc) ->
+            emqx_utils_maps:deep_remove(Field, Acc)
+        end,
+        Config0,
+        [
+            [<<"parameters">>, <<"pool_size">>],
+            [<<"parameters">>, <<"direction">>]
+        ]
+    ),
+    %% Move pool_size to aggregation_pool_size and writer_pool_size
+    PoolSize = maps:get(<<"pool_size">>, BridgeV1Conf, 8),
+    Config2 = emqx_utils_maps:deep_put(
+        [<<"parameters">>, <<"aggregation_pool_size">>],
+        Config1,
+        PoolSize
+    ),
+    Config3 = emqx_utils_maps:deep_put(
+        [<<"parameters">>, <<"writer_pool_size">>],
+        Config2,
+        PoolSize
+    ),
+    Config3.
+
+connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
+    BridgeV1Config1 = maps:remove(<<"connector">>, ActionConfig),
+    BridgeV1Config2 = emqx_utils_maps:deep_merge(ConnectorConfig, BridgeV1Config1),
+    BridgeV1Config3 = maps:remove(<<"parameters">>, BridgeV1Config2),
+    %% Pick out pool_size from aggregation_pool_size
+    PoolSize = emqx_utils_maps:deep_get(
+        [<<"parameters">>, <<"aggregation_pool_size">>], ActionConfig, 8
+    ),
+    BridgeV1Config4 = maps:put(<<"pool_size">>, PoolSize, BridgeV1Config3),
+
+    %% Move the fields stream, partition_key and record_template from parameters in ActionConfig to the top level in BridgeV1Config
+    lists:foldl(
+        fun(Field, Acc) ->
+            emqx_utils_maps:deep_put(
+                [Field],
+                Acc,
+                emqx_utils_maps:deep_get([<<"parameters">>, Field], ActionConfig, <<>>)
+            )
+        end,
+        BridgeV1Config4,
+        [<<"stream">>, <<"partition_key">>, <<"record_template">>]
+    ).
diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
index fdb80b1e1..bb65089d7 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
@@ -7,8 +7,9 @@
 -include_lib("typerefl/include/types.hrl").
 -include_lib("emqx/include/logger.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
+-include_lib("emqx_resource/include/emqx_resource.hrl").
 
--import(hoconsc, [mk/2, enum/1]).
+-import(hoconsc, [mk/2]).
 
 -behaviour(emqx_resource).
 
@@ -19,7 +20,11 @@
     on_stop/2,
     on_query/3,
     on_batch_query/3,
-    on_get_status/2
+    on_get_status/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channels/1,
+    on_get_channel_status/3
 ]).
 
 -export([
@@ -38,67 +43,132 @@
 
 -define(DEFAULT_GRPC_TIMEOUT, timer:seconds(30)).
 -define(DEFAULT_GRPC_TIMEOUT_RAW, <<"30s">>).
+-define(DEFAULT_GRPC_FLUSH_TIMEOUT, 10000).
+-define(DEFAULT_MAX_BATCHES, 500).
+-define(DEFAULT_BATCH_INTERVAL, 500).
+-define(DEFAULT_AGG_POOL_SIZE, 8).
+-define(DEFAULT_WRITER_POOL_SIZE, 8).
 
 %% -------------------------------------------------------------------------------------------------
 %% resource callback
 callback_mode() -> always_sync.
 
 on_start(InstId, Config) ->
-    start_client(InstId, Config).
+    try
+        do_on_start(InstId, Config)
+    catch
+        E:R:S ->
+            Error = #{
+                msg => "start_hstreamdb_connector_error",
+                connector => InstId,
+                error => E,
+                reason => R,
+                stack => S
+            },
+            ?SLOG(error, Error),
+            {error, Error}
+    end.
+
+on_add_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels,
+        client_options := ClientOptions
+    } = OldState,
+    ChannelId,
+    ChannelConfig
+) ->
+    %{ok, ChannelState} = create_channel_state(ChannelId, PoolName, ChannelConfig),
+    Parameters0 = maps:get(parameters, ChannelConfig),
+    Parameters = Parameters0#{client_options => ClientOptions},
+    PartitionKey = emqx_placeholder:preproc_tmpl(maps:get(partition_key, Parameters, <<"">>)),
+    try
+        ChannelState = #{
+            producer => start_producer(ChannelId, Parameters),
+            record_template => record_template(Parameters),
+            partition_key => PartitionKey
+        },
+        NewInstalledChannels = maps:put(ChannelId, ChannelState, InstalledChannels),
+        %% Update state
+        NewState = OldState#{installed_channels => NewInstalledChannels},
+        {ok, NewState}
+    catch
+        Error:Reason:Stack ->
+            {error, {Error, Reason, Stack}}
+    end.
+
+on_remove_channel(
+    _InstId,
+    #{
+        installed_channels := InstalledChannels
+    } = OldState,
+    ChannelId
+) ->
+    #{
+        producer := Producer
+    } = maps:get(ChannelId, InstalledChannels),
+    _ = hstreamdb:stop_producer(Producer),
+    NewInstalledChannels = maps:remove(ChannelId, InstalledChannels),
+    %% Update state
+    NewState = OldState#{installed_channels => NewInstalledChannels},
+    {ok, NewState}.
+
+on_get_channel_status(
+    _ResId,
+    _ChannelId,
+    _State
+) ->
+    ?status_connected.
+
+on_get_channels(ResId) ->
+    emqx_bridge_v2:get_channels_for_connector(ResId).
 
 on_stop(InstId, _State) ->
-    case emqx_resource:get_allocated_resources(InstId) of
-        #{?hstreamdb_client := #{client := Client, producer := Producer}} ->
-            StopClientRes = hstreamdb:stop_client(Client),
-            StopProducerRes = hstreamdb:stop_producer(Producer),
-            ?SLOG(info, #{
-                msg => "stop_hstreamdb_connector",
-                connector => InstId,
-                client => Client,
-                producer => Producer,
-                stop_client => StopClientRes,
-                stop_producer => StopProducerRes
-            });
-        _ ->
-            ok
-    end.
+    ?tp(
+        hstreamdb_connector_on_stop,
+        #{instance_id => InstId}
+    ).
 
 -define(FAILED_TO_APPLY_HRECORD_TEMPLATE,
     {error, {unrecoverable_error, failed_to_apply_hrecord_template}}
 ).
 
 on_query(
-    _InstId,
-    {send_message, Data},
-    _State = #{
-        producer := Producer, partition_key := PartitionKey, record_template := HRecordTemplate
-    }
+    InstId,
+    {ChannelID, Data},
+    #{installed_channels := Channels} = _State
 ) ->
+    #{
+        producer := Producer, partition_key := PartitionKey, record_template := HRecordTemplate
+    } = maps:get(ChannelID, Channels),
     try to_record(PartitionKey, HRecordTemplate, Data) of
-        Record -> append_record(Producer, Record, false)
+        Record -> append_record(InstId, Producer, Record, false)
     catch
         _:_ -> ?FAILED_TO_APPLY_HRECORD_TEMPLATE
     end.
 
 on_batch_query(
-    _InstId,
-    BatchList,
-    _State = #{
-        producer := Producer, partition_key := PartitionKey, record_template := HRecordTemplate
-    }
+    InstId,
+    [{ChannelID, _Data} | _] = BatchList,
+    #{installed_channels := Channels} = _State
 ) ->
+    #{
+        producer := Producer, partition_key := PartitionKey, record_template := HRecordTemplate
+    } = maps:get(ChannelID, Channels),
     try to_multi_part_records(PartitionKey, HRecordTemplate, BatchList) of
-        Records -> append_record(Producer, Records, true)
+        Records -> append_record(InstId, Producer, Records, true)
     catch
         _:_ -> ?FAILED_TO_APPLY_HRECORD_TEMPLATE
     end.
 
-on_get_status(_InstId, #{client := Client}) ->
-    case is_alive(Client) of
-        true ->
-            connected;
-        false ->
-            disconnected
+on_get_status(_InstId, State) ->
+    case check_status(State) of
+        ok ->
+            ?status_connected;
+        Error ->
+            %% We set it to ?status_connecting so that the channels are not deleted.
+            %% The producers in the channels contains buffers so we don't want to delete them.
+            {?status_connecting, State, Error}
     end.
 
 %% -------------------------------------------------------------------------------------------------
@@ -140,142 +210,149 @@ desc(config) ->
 
 %% -------------------------------------------------------------------------------------------------
 %% internal functions
-start_client(InstId, Config) ->
-    try
-        do_start_client(InstId, Config)
-    catch
-        E:R:S ->
-            Error = #{
-                msg => "start_hstreamdb_connector_error",
-                connector => InstId,
-                error => E,
-                reason => R,
-                stack => S
-            },
-            ?SLOG(error, Error),
-            {error, Error}
-    end.
 
-do_start_client(InstId, Config = #{url := Server, pool_size := PoolSize, ssl := SSL}) ->
+do_on_start(InstId, Config) ->
     ?SLOG(info, #{
         msg => "starting_hstreamdb_connector_client",
         connector => InstId,
         config => Config
     }),
-    ClientName = client_name(InstId),
+    {ok, _} = application:ensure_all_started(hstreamdb_erl),
+    ClientOptions = client_options(Config),
+    State = #{
+        client_options => ClientOptions,
+        installed_channels => #{}
+    },
+    case check_status(State) of
+        ok ->
+            ?SLOG(info, #{
+                msg => "hstreamdb_connector_client_started",
+                connector => InstId
+            }),
+            {ok, State};
+        Error ->
+            ?tp(
+                hstreamdb_connector_start_failed,
+                #{error => client_not_alive}
+            ),
+            ?SLOG(error, #{
+                msg => "hstreamdb_connector_client_not_alive",
+                connector => InstId,
+                error => Error
+            }),
+            {error, {connect_failed, Error}}
+    end.
+
+client_options(Config = #{url := ServerURL, ssl := SSL}) ->
+    GRPCTimeout = maps:get(<<"grpc_timeout">>, Config, ?DEFAULT_GRPC_TIMEOUT),
+    EnableSSL = maps:get(enable, SSL),
     RpcOpts =
-        case maps:get(enable, SSL) of
+        case EnableSSL of
             false ->
-                #{pool_size => PoolSize};
+                #{pool_size => 1};
             true ->
                 #{
-                    pool_size => PoolSize,
+                    pool_size => 1,
                     gun_opts => #{
                         transport => tls,
-                        transport_opts => emqx_tls_lib:to_client_opts(SSL)
+                        transport_opts =>
+                            emqx_tls_lib:to_client_opts(SSL)
                     }
                 }
         end,
-    ClientOptions = [
-        {url, binary_to_list(Server)},
-        {rpc_options, RpcOpts}
-    ],
-    case hstreamdb:start_client(ClientName, ClientOptions) of
+    ClientOptions = #{
+        url => to_string(ServerURL),
+        grpc_timeout => GRPCTimeout,
+        rpc_options => RpcOpts
+    },
+    ClientOptions.
+
+check_status(ConnectorState) ->
+    try start_client(ConnectorState) of
         {ok, Client} ->
-            case is_alive(Client) of
-                true ->
-                    ?SLOG(info, #{
-                        msg => "hstreamdb_connector_client_started",
-                        connector => InstId,
-                        client => Client
-                    }),
-                    start_producer(InstId, Client, Config);
-                _ ->
-                    ?tp(
-                        hstreamdb_connector_start_failed,
-                        #{error => client_not_alive}
-                    ),
-                    ?SLOG(error, #{
-                        msg => "hstreamdb_connector_client_not_alive",
-                        connector => InstId
-                    }),
-                    {error, connect_failed}
+            try hstreamdb_client:echo(Client) of
+                ok -> ok;
+                {error, _} = ErrorEcho -> ErrorEcho
+            after
+                _ = hstreamdb:stop_client(Client)
             end;
-        {error, {already_started, Pid}} ->
-            ?SLOG(info, #{
-                msg => "starting_hstreamdb_connector_client_find_old_client_restart_client",
-                old_client_pid => Pid,
-                old_client_name => ClientName
-            }),
-            _ = hstreamdb:stop_client(ClientName),
-            start_client(InstId, Config);
+        {error, _} = StartClientError ->
+            StartClientError
+    catch
+        ErrorType:Reason:_ST ->
+            {error, {ErrorType, Reason}}
+    end.
+
+start_client(Opts) ->
+    ClientOptions = maps:get(client_options, Opts),
+    case hstreamdb:start_client(ClientOptions) of
+        {ok, Client} ->
+            {ok, Client};
         {error, Error} ->
-            ?SLOG(error, #{
-                msg => "hstreamdb_connector_client_failed",
-                connector => InstId,
-                reason => Error
-            }),
             {error, Error}
     end.
 
-is_alive(Client) ->
-    hstreamdb_client:echo(Client) =:= ok.
-
 start_producer(
-    InstId,
-    Client,
-    Options = #{stream := Stream, pool_size := PoolSize}
+    ActionId,
+    #{
+        stream := Stream,
+        batch_size := BatchSize,
+        batch_interval := Interval
+    } = Opts
 ) ->
-    %% TODO: change these batch options after we have better disk cache.
-    BatchSize = maps:get(batch_size, Options, 100),
-    Interval = maps:get(batch_interval, Options, 1000),
-    ProducerOptions = [
-        {stream, Stream},
-        {callback, {?MODULE, on_flush_result, []}},
-        {max_records, BatchSize},
-        {interval, Interval},
-        {pool_size, PoolSize},
-        {grpc_timeout, maps:get(grpc_timeout, Options, ?DEFAULT_GRPC_TIMEOUT)}
-    ],
-    Name = produce_name(InstId),
-    ?SLOG(info, #{
-        msg => "starting_hstreamdb_connector_producer",
-        connector => InstId
-    }),
-    case hstreamdb:start_producer(Client, Name, ProducerOptions) of
-        {ok, Producer} ->
-            ?SLOG(info, #{
-                msg => "hstreamdb_connector_producer_started"
-            }),
-            State = #{
-                client => Client,
-                producer => Producer,
-                enable_batch => maps:get(enable_batch, Options, false),
-                partition_key => emqx_placeholder:preproc_tmpl(
-                    maps:get(partition_key, Options, <<"">>)
-                ),
-                record_template => record_template(Options)
-            },
-            ok = emqx_resource:allocate_resource(InstId, ?hstreamdb_client, #{
-                client => Client, producer => Producer
-            }),
-            {ok, State};
-        {error, {already_started, Pid}} ->
-            ?SLOG(info, #{
-                msg =>
-                    "starting_hstreamdb_connector_producer_find_old_producer_restart_producer",
-                old_producer_pid => Pid,
-                old_producer_name => Name
-            }),
-            _ = hstreamdb:stop_producer(Name),
-            start_producer(InstId, Client, Options);
+    MaxBatches = maps:get(max_batches, Opts, ?DEFAULT_MAX_BATCHES),
+    AggPoolSize = maps:get(aggregation_pool_size, Opts, ?DEFAULT_AGG_POOL_SIZE),
+    WriterPoolSize = maps:get(writer_pool_size, Opts, ?DEFAULT_WRITER_POOL_SIZE),
+    GRPCTimeout = maps:get(grpc_flush_timeout, Opts, ?DEFAULT_GRPC_FLUSH_TIMEOUT),
+    ClientOptions = maps:get(client_options, Opts),
+    ProducerOptions = #{
+        stream => to_string(Stream),
+        buffer_options => #{
+            interval => Interval,
+            callback => {?MODULE, on_flush_result, [ActionId]},
+            max_records => BatchSize,
+            max_batches => MaxBatches
+        },
+        buffer_pool_size => AggPoolSize,
+        writer_options => #{
+            grpc_timeout => GRPCTimeout
+        },
+        writer_pool_size => WriterPoolSize,
+        client_options => ClientOptions
+    },
+    Name = produce_name(ActionId),
+    ensure_start_producer(Name, ProducerOptions).
+
+ensure_start_producer(ProducerName, ProducerOptions) ->
+    case hstreamdb:start_producer(ProducerName, ProducerOptions) of
+        ok ->
+            ok;
+        {error, {already_started, _Pid}} ->
+            %% HStreamDB producer already started, restart it
+            _ = hstreamdb:stop_producer(ProducerName),
+            %% the pool might have been leaked after relup
+            _ = ecpool:stop_sup_pool(ProducerName),
+            ok = hstreamdb:start_producer(ProducerName, ProducerOptions);
+        {error, {
+            {shutdown,
+                {failed_to_start_child, {pool_sup, Pool},
+                    {shutdown,
+                        {failed_to_start_child, worker_sup,
+                            {shutdown, {failed_to_start_child, _, {badarg, _}}}}}}},
+            _
+        }} ->
+            %% HStreamDB producer was not properly cleared, restart it
+            %% the badarg error in gproc maybe caused by the pool is leaked after relup
+            _ = ecpool:stop_sup_pool(Pool),
+            ok = hstreamdb:start_producer(ProducerName, ProducerOptions);
         {error, Reason} ->
-            ?SLOG(error, #{
-                msg => "starting_hstreamdb_connector_producer_failed",
-                reason => Reason
-            }),
-            {error, Reason}
-    end.
+            %% HStreamDB start producer failed
+            throw({start_producer_failed, Reason})
+    end,
+    ProducerName.
+
+produce_name(ActionId) ->
+    list_to_binary("backend_hstream_producer:" ++ to_string(ActionId)).
 
 to_record(PartitionKeyTmpl, HRecordTmpl, Data) ->
     PartitionKey = emqx_placeholder:proc_tmpl(PartitionKeyTmpl, Data),
@@ -289,43 +366,46 @@ to_record(PartitionKey, RawRecord) ->
 
 to_multi_part_records(PartitionKeyTmpl, HRecordTmpl, BatchList) ->
     lists:map(
-        fun({send_message, Data}) ->
+        fun({_, Data}) ->
             to_record(PartitionKeyTmpl, HRecordTmpl, Data)
         end,
         BatchList
     ).
 
-append_record(Producer, MultiPartsRecords, MaybeBatch) when is_list(MultiPartsRecords) ->
+append_record(ResourceId, Producer, MultiPartsRecords, MaybeBatch) when
+    is_list(MultiPartsRecords)
+->
     lists:foreach(
-        fun(Record) -> append_record(Producer, Record, MaybeBatch) end, MultiPartsRecords
+        fun(Record) -> append_record(ResourceId, Producer, Record, MaybeBatch) end,
+        MultiPartsRecords
     );
-append_record(Producer, Record, MaybeBatch) when is_tuple(Record) ->
-    do_append_records(Producer, Record, MaybeBatch).
+append_record(ResourceId, Producer, Record, MaybeBatch) when is_tuple(Record) ->
+    do_append_records(ResourceId, Producer, Record, MaybeBatch).
 
 %% TODO: only sync request supported. implement async request later.
-do_append_records(Producer, Record, true = IsBatch) ->
+do_append_records(ResourceId, Producer, Record, true = IsBatch) ->
     Result = hstreamdb:append(Producer, Record),
-    handle_result(Result, Record, IsBatch);
-do_append_records(Producer, Record, false = IsBatch) ->
+    handle_result(ResourceId, Result, Record, IsBatch);
+do_append_records(ResourceId, Producer, Record, false = IsBatch) ->
     Result = hstreamdb:append_flush(Producer, Record),
-    handle_result(Result, Record, IsBatch).
+    handle_result(ResourceId, Result, Record, IsBatch).
 
-handle_result(ok = Result, Record, IsBatch) ->
-    handle_result({ok, Result}, Record, IsBatch);
-handle_result({ok, Result}, Record, IsBatch) ->
+handle_result(ResourceId, ok = Result, Record, IsBatch) ->
+    handle_result(ResourceId, {ok, Result}, Record, IsBatch);
+handle_result(ResourceId, {ok, Result}, Record, IsBatch) ->
     ?tp(
         hstreamdb_connector_query_append_return,
-        #{result => Result, is_batch => IsBatch}
+        #{result => Result, is_batch => IsBatch, instance_id => ResourceId}
     ),
     ?SLOG(debug, #{
         msg => "hstreamdb_producer_sync_append_success",
         record => Record,
         is_batch => IsBatch
     });
-handle_result({error, Reason} = Err, Record, IsBatch) ->
+handle_result(ResourceId, {error, Reason} = Err, Record, IsBatch) ->
     ?tp(
         hstreamdb_connector_query_append_return,
-        #{error => Reason, is_batch => IsBatch}
+        #{error => Reason, is_batch => IsBatch, instance_id => ResourceId}
     ),
     ?SLOG(error, #{
         msg => "hstreamdb_producer_sync_append_failed",
@@ -335,12 +415,6 @@ handle_result({error, Reason} = Err, Record, IsBatch) ->
     }),
     Err.
 
-client_name(InstId) ->
-    "client:" ++ to_string(InstId).
-
-produce_name(ActionId) ->
-    list_to_atom("producer:" ++ to_string(ActionId)).
-
 record_template(#{record_template := RawHRecordTemplate}) ->
     emqx_placeholder:preproc_tmpl(RawHRecordTemplate);
 record_template(_) ->
diff --git a/apps/emqx_bridge_hstreamdb/test/emqx_bridge_hstreamdb_SUITE.erl b/apps/emqx_bridge_hstreamdb/test/emqx_bridge_hstreamdb_SUITE.erl
index 4d165c03d..1ac489334 100644
--- a/apps/emqx_bridge_hstreamdb/test/emqx_bridge_hstreamdb_SUITE.erl
+++ b/apps/emqx_bridge_hstreamdb/test/emqx_bridge_hstreamdb_SUITE.erl
@@ -117,16 +117,21 @@ end_per_suite(_Config) ->
     ok.
 
 init_per_testcase(t_to_hrecord_failed, Config) ->
+    init_per_testcase_common(),
     meck:new([hstreamdb], [passthrough, no_history, no_link]),
     meck:expect(hstreamdb, to_record, fun(_, _, _) -> error(trans_to_hrecord_failed) end),
     Config;
 init_per_testcase(_Testcase, Config) ->
+    init_per_testcase_common(),
     %% drop stream and will create a new one in common_init/1
     %% TODO: create a new stream for each test case
     delete_bridge(Config),
     snabbkaffe:start_trace(),
     Config.
 
+init_per_testcase_common() ->
+    emqx_bridge_v2_testlib:delete_all_bridges_and_connectors().
+
 end_per_testcase(t_to_hrecord_failed, _Config) ->
     meck:unload([hstreamdb]);
 end_per_testcase(_Testcase, Config) ->
@@ -301,7 +306,10 @@ t_simple_query(Config) ->
         {ok, _},
         create_bridge(Config)
     ),
-    Requests = gen_batch_req(BatchSize),
+    Type = ?config(hstreamdb_bridge_type, Config),
+    Name = ?config(hstreamdb_name, Config),
+    ActionId = emqx_bridge_v2:id(Type, Name),
+    Requests = gen_batch_req(BatchSize, ActionId),
     ?check_trace(
         begin
             ?wait_async_action(
@@ -351,6 +359,24 @@ t_to_hrecord_failed(Config) ->
     end,
     ok.
 
+%% Connector Action Tests
+
+t_action_on_get_status(Config) ->
+    emqx_bridge_v2_testlib:t_on_get_status(Config, #{failure_status => connecting}).
+
+t_action_create_via_http(Config) ->
+    emqx_bridge_v2_testlib:t_create_via_http(Config).
+
+t_action_sync_query(Config) ->
+    MakeMessageFun = fun() -> rand_data() end,
+    IsSuccessCheck = fun(Result) -> ?assertEqual(ok, Result) end,
+    TracePoint = hstreamdb_connector_query_append_return,
+    emqx_bridge_v2_testlib:t_sync_query(Config, MakeMessageFun, IsSuccessCheck, TracePoint).
+
+t_action_start_stop(Config) ->
+    StopTracePoint = hstreamdb_connector_on_stop,
+    emqx_bridge_v2_testlib:t_start_stop(Config, StopTracePoint).
+
 %%------------------------------------------------------------------------------
 %% Helper fns
 %%------------------------------------------------------------------------------
@@ -362,6 +388,10 @@ common_init(ConfigT) ->
     URL = "http://" ++ Host ++ ":" ++ RawPort,
 
     Config0 = [
+        {bridge_type, <<"hstreamdb">>},
+        {bridge_name, <<"my_hstreamdb_action">>},
+        {connector_type, <<"hstreamdb">>},
+        {connector_name, <<"my_hstreamdb_connector">>},
         {hstreamdb_host, Host},
         {hstreamdb_port, Port},
         {hstreamdb_url, URL},
@@ -393,6 +423,8 @@ common_init(ConfigT) ->
                     {hstreamdb_config, HStreamDBConf},
                     {hstreamdb_bridge_type, BridgeType},
                     {hstreamdb_name, Name},
+                    {bridge_config, action_config(Config0)},
+                    {connector_config, connector_config(Config0)},
                     {proxy_host, ProxyHost},
                     {proxy_port, ProxyPort}
                     | Config0
@@ -424,7 +456,7 @@ hstreamdb_config(BridgeType, Config) ->
             "  resource_opts = {\n"
             %% always sync
             "    query_mode = sync\n"
-            "    request_ttl = 500ms\n"
+            "    request_ttl = 10000ms\n"
             "    batch_size = ~b\n"
             "    worker_pool_size = ~b\n"
             "  }\n"
@@ -443,6 +475,45 @@ hstreamdb_config(BridgeType, Config) ->
         ),
     {Name, parse_and_check(ConfigString, BridgeType, Name)}.
 
+action_config(Config) ->
+    ConnectorName = ?config(connector_name, Config),
+    BatchSize = batch_size(Config),
+    #{
+        <<"connector">> => ConnectorName,
+        <<"enable">> => true,
+        <<"parameters">> =>
+            #{
+                <<"aggregation_pool_size">> => ?POOL_SIZE,
+                <<"record_template">> => ?RECORD_TEMPLATE,
+                <<"stream">> => ?STREAM,
+                <<"writer_pool_size">> => ?POOL_SIZE
+            },
+        <<"resource_opts">> =>
+            #{
+                <<"batch_size">> => BatchSize,
+                <<"health_check_interval">> => <<"15s">>,
+                <<"inflight_window">> => 100,
+                <<"max_buffer_bytes">> => <<"256MB">>,
+                <<"query_mode">> => <<"sync">>,
+                <<"request_ttl">> => <<"45s">>,
+                <<"worker_pool_size">> => ?POOL_SIZE
+            }
+    }.
+
+connector_config(Config) ->
+    Port = integer_to_list(?config(hstreamdb_port, Config)),
+    URL = "http://" ++ ?config(hstreamdb_host, Config) ++ ":" ++ Port,
+    #{
+        <<"url">> => URL,
+        <<"ssl">> =>
+            #{<<"enable">> => false, <<"verify">> => <<"verify_peer">>},
+        <<"grpc_timeout">> => <<"30s">>,
+        <<"resource_opts">> => #{
+            <<"health_check_interval">> => <<"15s">>,
+            <<"start_timeout">> => <<"5s">>
+        }
+    }.
+
 parse_and_check(ConfigString, BridgeType, Name) ->
     {ok, RawConf} = hocon:binary(ConfigString, #{format => map}),
     hocon_tconf:check_plain(emqx_bridge_schema, RawConf, #{required => false, atom_key => false}),
@@ -454,10 +525,10 @@ parse_and_check(ConfigString, BridgeType, Name) ->
 -define(CONN_ATTEMPTS, 10).
 
 default_options(Config) ->
-    [
-        {url, ?config(hstreamdb_url, Config)},
-        {rpc_options, ?RPC_OPTIONS}
-    ].
+    #{
+        url => ?config(hstreamdb_url, Config),
+        rpc_options => ?RPC_OPTIONS
+    }.
 
 connect_direct_hstream(Name, Config) ->
     client(Name, Config, ?CONN_ATTEMPTS).
@@ -511,8 +582,9 @@ send_message(Config, Data) ->
 query_resource(Config, Request) ->
     Name = ?config(hstreamdb_name, Config),
     BridgeType = ?config(hstreamdb_bridge_type, Config),
-    ResourceID = emqx_bridge_resource:resource_id(BridgeType, Name),
-    emqx_resource:query(ResourceID, Request, #{timeout => 1_000}).
+    ID = emqx_bridge_v2:id(BridgeType, Name),
+    ResID = emqx_connector_resource:resource_id(BridgeType, Name),
+    emqx_resource:query(ID, Request, #{timeout => 1_000, connector_resource_id => ResID}).
 
 restart_resource(Config) ->
     BridgeName = ?config(hstreamdb_name, Config),
@@ -526,8 +598,16 @@ resource_id(Config) ->
     BridgeType = ?config(hstreamdb_bridge_type, Config),
     _ResourceID = emqx_bridge_resource:resource_id(BridgeType, BridgeName).
 
+action_id(Config) ->
+    ActionName = ?config(hstreamdb_name, Config),
+    ActionType = ?config(hstreamdb_bridge_type, Config),
+    _ActionID = emqx_bridge_v2:id(ActionType, ActionName).
+
 health_check_resource_ok(Config) ->
-    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(resource_id(Config))).
+    ?assertEqual({ok, connected}, emqx_resource_manager:health_check(resource_id(Config))),
+    ActionName = ?config(hstreamdb_name, Config),
+    ActionType = ?config(hstreamdb_bridge_type, Config),
+    ?assertMatch(#{status := connected}, emqx_bridge_v2:health_check(ActionType, ActionName)).
 
 health_check_resource_down(Config) ->
     case emqx_resource_manager:health_check(resource_id(Config)) of
@@ -539,6 +619,19 @@ health_check_resource_down(Config) ->
             ?assert(
                 false, lists:flatten(io_lib:format("invalid health check result:~p~n", [Other]))
             )
+    end,
+    ActionName = ?config(hstreamdb_name, Config),
+    ActionType = ?config(hstreamdb_bridge_type, Config),
+    #{status := StatusV2} = emqx_bridge_v2:health_check(ActionType, ActionName),
+    case StatusV2 of
+        disconnected ->
+            ok;
+        connecting ->
+            ok;
+        OtherV2 ->
+            ?assert(
+                false, lists:flatten(io_lib:format("invalid health check result:~p~n", [OtherV2]))
+            )
     end.
 
 % These funs start and then stop the hstreamdb connection
@@ -548,22 +641,36 @@ connect_and_create_stream(Config) ->
             Client, ?STREAM, ?REPLICATION_FACTOR, ?BACKLOG_RETENTION_SECOND, ?SHARD_COUNT
         )
     ),
-    %% force write to stream to make it created and ready to be written data for rest cases
-    ProducerOptions = [
-        {pool_size, 4},
-        {stream, ?STREAM},
-        {callback, fun(_) -> ok end},
-        {max_records, 10},
-        {interval, 1000}
-    ],
+    %% force write to stream to make it created and ready to be written data for test cases
+    ProducerOptions = #{
+        stream => ?STREAM,
+        buffer_options => #{
+            interval => 1000,
+            callback => {?MODULE, on_flush_result, [<<"WHAT">>]},
+            max_records => 1,
+            max_batches => 1
+        },
+        buffer_pool_size => 1,
+        writer_options => #{
+            grpc_timeout => 100
+        },
+        writer_pool_size => 1,
+        client_options => default_options(Config)
+    },
+
     ?WITH_CLIENT(
         begin
-            {ok, Producer} = hstreamdb:start_producer(Client, test_producer, ProducerOptions),
-            _ = hstreamdb:append_flush(Producer, hstreamdb:to_record([], raw, rand_payload())),
-            _ = hstreamdb:stop_producer(Producer)
+            ok = hstreamdb:start_producer(test_producer, ProducerOptions),
+            _ = hstreamdb:append_flush(test_producer, hstreamdb:to_record([], raw, rand_payload())),
+            _ = hstreamdb:stop_producer(test_producer)
         end
     ).
 
+on_flush_result({{flush, _Stream, _Records}, {ok, _Resp}}) ->
+    ok;
+on_flush_result({{flush, _Stream, _Records}, {error, _Reason}}) ->
+    ok.
+
 connect_and_delete_stream(Config) ->
     ?WITH_CLIENT(
         _ = hstreamdb_client:delete_stream(Client, ?STREAM)
@@ -593,11 +700,11 @@ rand_payload() ->
         temperature => rand:uniform(40), humidity => rand:uniform(100)
     }).
 
-gen_batch_req(Count) when
+gen_batch_req(Count, ActionId) when
     is_integer(Count) andalso Count > 0
 ->
-    [{send_message, rand_data()} || _Val <- lists:seq(1, Count)];
-gen_batch_req(Count) ->
+    [{ActionId, rand_data()} || _Val <- lists:seq(1, Count)];
+gen_batch_req(Count, _ActionId) ->
     ct:pal("Gen batch requests failed with unexpected Count: ~p", [Count]).
 
 str(List) when is_list(List) ->
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index f8800cc10..4ccdc193b 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -28,6 +28,8 @@ resource_type(confluent_producer) ->
     emqx_bridge_kafka_impl_producer;
 resource_type(gcp_pubsub_producer) ->
     emqx_bridge_gcp_pubsub_impl_producer;
+resource_type(hstreamdb) ->
+    emqx_bridge_hstreamdb_connector;
 resource_type(kafka_producer) ->
     emqx_bridge_kafka_impl_producer;
 resource_type(kinesis) ->
@@ -122,6 +124,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {hstreamdb,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_hstreamdb, "config_connector")),
+                #{
+                    desc => <<"HStreamDB Connector Config">>,
+                    required => false
+                }
+            )},
         {kafka_producer,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_kafka, "config_connector")),
@@ -298,6 +308,7 @@ schema_modules() ->
         emqx_bridge_azure_event_hub,
         emqx_bridge_confluent_producer,
         emqx_bridge_gcp_pubsub_producer_schema,
+        emqx_bridge_hstreamdb,
         emqx_bridge_kafka,
         emqx_bridge_kinesis,
         emqx_bridge_matrix,
@@ -336,6 +347,7 @@ api_schemas(Method) ->
             <<"gcp_pubsub_producer">>,
             Method ++ "_connector"
         ),
+        api_ref(emqx_bridge_hstreamdb, <<"hstreamdb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_kafka, <<"kafka_producer">>, Method ++ "_connector"),
         api_ref(emqx_bridge_kinesis, <<"kinesis">>, Method ++ "_connector"),
         api_ref(emqx_bridge_matrix, <<"matrix">>, Method ++ "_connector"),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 751efa3d9..189b9e2cf 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -128,6 +128,8 @@ connector_type_to_bridge_types(confluent_producer) ->
     [confluent_producer];
 connector_type_to_bridge_types(gcp_pubsub_producer) ->
     [gcp_pubsub, gcp_pubsub_producer];
+connector_type_to_bridge_types(hstreamdb) ->
+    [hstreamdb];
 connector_type_to_bridge_types(kafka_producer) ->
     [kafka, kafka_producer];
 connector_type_to_bridge_types(kinesis) ->
diff --git a/mix.exs b/mix.exs
index c2ef491e9..113fb8e2c 100644
--- a/mix.exs
+++ b/mix.exs
@@ -200,7 +200,7 @@ defmodule EMQXUmbrella.MixProject do
 
   defp enterprise_deps(_profile_info = %{edition_type: :enterprise}) do
     [
-      {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.4.5+v0.16.1"},
+      {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.5.18+v0.18.1"},
       {:influxdb, github: "emqx/influxdb-client-erl", tag: "1.1.13", override: true},
       {:wolff, github: "kafka4beam/wolff", tag: "1.10.2"},
       {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.3", override: true},

From 4e8dfb48b730b93ee44fdc036062b98b051a117b Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Wed, 14 Feb 2024 17:43:48 +0100
Subject: [PATCH 226/273] fix: elvis problems

---
 .../src/emqx_bridge_hstreamdb_action_info.erl     |  3 ++-
 .../src/emqx_bridge_hstreamdb_connector.erl       | 15 +++++++++------
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl
index 66188110f..7aa6565fa 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_action_info.erl
@@ -74,7 +74,8 @@ connector_action_config_to_bridge_v1_config(ConnectorConfig, ActionConfig) ->
     ),
     BridgeV1Config4 = maps:put(<<"pool_size">>, PoolSize, BridgeV1Config3),
 
-    %% Move the fields stream, partition_key and record_template from parameters in ActionConfig to the top level in BridgeV1Config
+    %% Move the fields stream, partition_key and record_template from
+    %% parameters in ActionConfig to the top level in BridgeV1Config
     lists:foldl(
         fun(Field, Acc) ->
             emqx_utils_maps:deep_put(
diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
index bb65089d7..8413e5ecd 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb_connector.erl
@@ -270,12 +270,7 @@ client_options(Config = #{url := ServerURL, ssl := SSL}) ->
 check_status(ConnectorState) ->
     try start_client(ConnectorState) of
         {ok, Client} ->
-            try hstreamdb_client:echo(Client) of
-                ok -> ok;
-                {error, _} = ErrorEcho -> ErrorEcho
-            after
-                _ = hstreamdb:stop_client(Client)
-            end;
+            check_status_with_client(Client);
         {error, _} = StartClientError ->
             StartClientError
     catch
@@ -283,6 +278,14 @@ check_status(ConnectorState) ->
             {error, {ErrorType, Reason}}
     end.
 
+check_status_with_client(Client) ->
+    try hstreamdb_client:echo(Client) of
+        ok -> ok;
+        {error, _} = ErrorEcho -> ErrorEcho
+    after
+        _ = hstreamdb:stop_client(Client)
+    end.
+
 start_client(Opts) ->
     ClientOptions = maps:get(client_options, Opts),
     case hstreamdb:start_client(ClientOptions) of

From cffb52ab28b0809347ef3588df368c6919c79d64 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Wed, 14 Feb 2024 19:00:04 +0100
Subject: [PATCH 227/273] test(plugins): update and simplify test suite

---
 apps/emqx_plugins/test/emqx_plugins_SUITE.erl | 197 ++++++++----------
 1 file changed, 83 insertions(+), 114 deletions(-)

diff --git a/apps/emqx_plugins/test/emqx_plugins_SUITE.erl b/apps/emqx_plugins/test/emqx_plugins_SUITE.erl
index b83597279..e06d4ee73 100644
--- a/apps/emqx_plugins/test/emqx_plugins_SUITE.erl
+++ b/apps/emqx_plugins/test/emqx_plugins_SUITE.erl
@@ -73,23 +73,21 @@ end_per_group(_Group, _Config) ->
     ok.
 
 init_per_suite(Config) ->
-    WorkDir = proplists:get_value(data_dir, Config),
-    filelib:ensure_path(WorkDir),
-    OrigInstallDir = emqx_plugins:get_config(install_dir, undefined),
-    emqx_common_test_helpers:start_apps([emqx_conf, emqx_plugins]),
-    emqx_plugins:put_config(install_dir, WorkDir),
-    [{orig_install_dir, OrigInstallDir} | Config].
+    WorkDir = emqx_cth_suite:work_dir(Config),
+    InstallDir = filename:join([WorkDir, "plugins"]),
+    Apps = emqx_cth_suite:start(
+        [
+            emqx_conf,
+            emqx_ctl,
+            {emqx_plugins, #{config => #{plugins => #{install_dir => InstallDir}}}}
+        ],
+        #{work_dir => WorkDir}
+    ),
+    ok = filelib:ensure_path(InstallDir),
+    [{suite_apps, Apps}, {install_dir, InstallDir} | Config].
 
 end_per_suite(Config) ->
-    emqx_common_test_helpers:boot_modules(all),
-    emqx_config:erase(plugins),
-    %% restore config
-    case proplists:get_value(orig_install_dir, Config) of
-        undefined -> ok;
-        OrigInstallDir -> emqx_plugins:put_config(install_dir, OrigInstallDir)
-    end,
-    emqx_common_test_helpers:stop_apps([emqx_plugins, emqx_conf]),
-    ok.
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(TestCase, Config) ->
     emqx_plugins:put_configured([]),
@@ -206,7 +204,7 @@ t_demo_install_start_stop_uninstall(Config) ->
 %% but since we are using hocon:load to load it
 %% ad-hoc test files can be in hocon format
 write_info_file(Config, NameVsn, Content) ->
-    WorkDir = proplists:get_value(data_dir, Config),
+    WorkDir = proplists:get_value(install_dir, Config),
     InfoFile = filename:join([WorkDir, NameVsn, "release.json"]),
     ok = filelib:ensure_dir(InfoFile),
     ok = file:write_file(InfoFile, Content).
@@ -371,7 +369,7 @@ t_bad_tar_gz({init, Config}) ->
 t_bad_tar_gz({'end', _Config}) ->
     ok;
 t_bad_tar_gz(Config) ->
-    WorkDir = proplists:get_value(data_dir, Config),
+    WorkDir = proplists:get_value(install_dir, Config),
     FakeTarTz = filename:join([WorkDir, "fake-vsn.tar.gz"]),
     ok = file:write_file(FakeTarTz, "a\n"),
     ?assertMatch(
@@ -396,7 +394,7 @@ t_bad_tar_gz(Config) ->
 %% create with incomplete info file
 %% failed install attempts should not leave behind extracted dir
 t_bad_tar_gz2({init, Config}) ->
-    WorkDir = proplists:get_value(data_dir, Config),
+    WorkDir = proplists:get_value(install_dir, Config),
     NameVsn = "foo-0.2",
     %% this an invalid info file content (description missing)
     BadInfo = "name=foo, rel_vsn=\"0.2\", rel_apps=[foo]",
@@ -422,7 +420,7 @@ t_bad_tar_gz2(Config) ->
 %% test that we even cleanup content that doesn't match the expected name-vsn
 %% pattern
 t_tar_vsn_content_mismatch({init, Config}) ->
-    WorkDir = proplists:get_value(data_dir, Config),
+    WorkDir = proplists:get_value(install_dir, Config),
     NameVsn = "bad_tar-0.2",
     %% this an invalid info file content
     BadInfo = "name=foo, rel_vsn=\"0.2\", rel_apps=[\"foo-0.2\"], description=\"lorem ipsum\"",
@@ -606,7 +604,7 @@ t_load_config_from_cli(Config) when is_list(Config) ->
     ok.
 
 group_t_copy_plugin_to_a_new_node({init, Config}) ->
-    WorkDir = proplists:get_value(data_dir, Config),
+    WorkDir = proplists:get_value(install_dir, Config),
     FromInstallDir = filename:join(WorkDir, atom_to_list(plugins_copy_from)),
     file:del_dir_r(FromInstallDir),
     ok = filelib:ensure_path(FromInstallDir),
@@ -614,25 +612,25 @@ group_t_copy_plugin_to_a_new_node({init, Config}) ->
     file:del_dir_r(ToInstallDir),
     ok = filelib:ensure_path(ToInstallDir),
     #{package := Package, release_name := PluginName} = get_demo_plugin_package(FromInstallDir),
-    [{CopyFrom, CopyFromOpts}, {CopyTo, CopyToOpts}] =
-        emqx_common_test_helpers:emqx_cluster(
+    Apps = [
+        emqx,
+        emqx_conf,
+        emqx_ctl,
+        emqx_plugins
+    ],
+    [SpecCopyFrom, SpecCopyTo] =
+        emqx_cth_cluster:mk_nodespecs(
             [
-                {core, plugins_copy_from},
-                {core, plugins_copy_to}
+                {plugins_copy_from, #{role => core, apps => Apps}},
+                {plugins_copy_to, #{role => core, apps => Apps}}
             ],
             #{
-                apps => [emqx_conf, emqx_plugins],
-                env => [
-                    {emqx, boot_modules, []}
-                ],
-                load_schema => false
+                work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)
             }
         ),
-    CopyFromNode = emqx_common_test_helpers:start_peer(
-        CopyFrom, maps:remove(join_to, CopyFromOpts)
-    ),
+    [CopyFromNode] = emqx_cth_cluster:start([SpecCopyFrom#{join_to => undefined}]),
     ok = rpc:call(CopyFromNode, emqx_plugins, put_config, [install_dir, FromInstallDir]),
-    CopyToNode = emqx_common_test_helpers:start_peer(CopyTo, maps:remove(join_to, CopyToOpts)),
+    [CopyToNode] = emqx_cth_cluster:start([SpecCopyTo#{join_to => undefined}]),
     ok = rpc:call(CopyToNode, emqx_plugins, put_config, [install_dir, ToInstallDir]),
     NameVsn = filename:basename(Package, ?PACKAGE_SUFFIX),
     ok = rpc:call(CopyFromNode, emqx_plugins, ensure_installed, [NameVsn]),
@@ -656,16 +654,9 @@ group_t_copy_plugin_to_a_new_node({init, Config}) ->
         | Config
     ];
 group_t_copy_plugin_to_a_new_node({'end', Config}) ->
-    CopyFromNode = proplists:get_value(copy_from_node, Config),
-    CopyToNode = proplists:get_value(copy_to_node, Config),
-    ok = rpc:call(CopyFromNode, emqx_config, delete_override_conf_files, []),
-    ok = rpc:call(CopyToNode, emqx_config, delete_override_conf_files, []),
-    rpc:call(CopyToNode, ekka, leave, []),
-    rpc:call(CopyFromNode, ekka, leave, []),
-    ok = emqx_common_test_helpers:stop_peer(CopyToNode),
-    ok = emqx_common_test_helpers:stop_peer(CopyFromNode),
-    ok = file:del_dir_r(proplists:get_value(to_install_dir, Config)),
-    ok = file:del_dir_r(proplists:get_value(from_install_dir, Config));
+    CopyFromNode = ?config(copy_from_node, Config),
+    CopyToNode = ?config(copy_to_node, Config),
+    ok = emqx_cth_cluster:stop([CopyFromNode, CopyToNode]);
 group_t_copy_plugin_to_a_new_node(Config) ->
     CopyFromNode = proplists:get_value(copy_from_node, Config),
     CopyToNode = proplists:get_value(copy_to_node, Config),
@@ -706,62 +697,48 @@ group_t_copy_plugin_to_a_new_node(Config) ->
 
 %% checks that we can start a cluster with a lone node.
 group_t_copy_plugin_to_a_new_node_single_node({init, Config}) ->
-    PrivDataDir = ?config(priv_dir, Config),
-    ToInstallDir = filename:join(PrivDataDir, "plugins_copy_to"),
+    WorkDir = ?config(install_dir, Config),
+    ToInstallDir = filename:join(WorkDir, "plugins_copy_to"),
     file:del_dir_r(ToInstallDir),
     ok = filelib:ensure_path(ToInstallDir),
     #{package := Package, release_name := PluginName} = get_demo_plugin_package(ToInstallDir),
     NameVsn = filename:basename(Package, ?PACKAGE_SUFFIX),
-    [{CopyTo, CopyToOpts}] =
-        emqx_common_test_helpers:emqx_cluster(
-            [
-                {core, plugins_copy_to}
-            ],
-            #{
-                apps => [emqx_conf, emqx_plugins],
-                env => [
-                    {emqx, boot_modules, []}
-                ],
-                env_handler => fun
-                    (emqx_plugins) ->
-                        ok = emqx_plugins:put_config(install_dir, ToInstallDir),
-                        %% this is to simulate an user setting the state
-                        %% via environment variables before starting the node
-                        ok = emqx_plugins:put_config(
-                            states,
-                            [#{name_vsn => NameVsn, enable => true}]
-                        ),
-                        ok;
-                    (_) ->
-                        ok
-                end,
-                priv_data_dir => PrivDataDir,
-                schema_mod => emqx_conf_schema,
-                load_schema => true
+    Apps = [
+        emqx,
+        emqx_conf,
+        emqx_ctl,
+        {emqx_plugins, #{
+            config => #{
+                plugins => #{
+                    install_dir => ToInstallDir,
+                    states => [#{name_vsn => NameVsn, enable => true}]
+                }
             }
-        ),
+        }}
+    ],
+    [CopyToNode] = emqx_cth_cluster:start(
+        [{plugins_copy_to, #{role => core, apps => Apps}}],
+        #{
+            work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)
+        }
+    ),
     [
         {to_install_dir, ToInstallDir},
-        {copy_to_node_name, CopyTo},
-        {copy_to_opts, CopyToOpts},
+        {copy_to_node, CopyToNode},
         {name_vsn, NameVsn},
         {plugin_name, PluginName}
         | Config
     ];
 group_t_copy_plugin_to_a_new_node_single_node({'end', Config}) ->
-    CopyToNode = proplists:get_value(copy_to_node_name, Config),
-    ok = emqx_common_test_helpers:stop_peer(CopyToNode),
-    ok = file:del_dir_r(proplists:get_value(to_install_dir, Config)),
-    ok;
+    CopyToNode = proplists:get_value(copy_to_node, Config),
+    ok = emqx_cth_cluster:stop([CopyToNode]);
 group_t_copy_plugin_to_a_new_node_single_node(Config) ->
-    CopyTo = ?config(copy_to_node_name, Config),
-    CopyToOpts = ?config(copy_to_opts, Config),
+    CopyToNode = ?config(copy_to_node, Config),
     ToInstallDir = ?config(to_install_dir, Config),
     NameVsn = proplists:get_value(name_vsn, Config),
     %% Start the node for the first time. The plugin should start
     %% successfully even if it's not extracted yet.  Simply starting
     %% the node would crash if not working properly.
-    CopyToNode = emqx_common_test_helpers:start_peer(CopyTo, CopyToOpts),
     ct:pal("~p config:\n  ~p", [
         CopyToNode, erpc:call(CopyToNode, emqx_plugins, get_config, [[], #{}])
     ]),
@@ -775,52 +752,44 @@ group_t_copy_plugin_to_a_new_node_single_node(Config) ->
     ok.
 
 group_t_cluster_leave({init, Config}) ->
-    PrivDataDir = ?config(priv_dir, Config),
-    ToInstallDir = filename:join(PrivDataDir, "plugins_copy_to"),
+    WorkDir = ?config(install_dir, Config),
+    ToInstallDir = filename:join(WorkDir, "plugins_copy_to"),
     file:del_dir_r(ToInstallDir),
     ok = filelib:ensure_path(ToInstallDir),
     #{package := Package, release_name := PluginName} = get_demo_plugin_package(ToInstallDir),
     NameVsn = filename:basename(Package, ?PACKAGE_SUFFIX),
-    Cluster =
-        emqx_common_test_helpers:emqx_cluster(
-            [core, core],
-            #{
-                apps => [emqx_conf, emqx_plugins],
-                env => [
-                    {emqx, boot_modules, []}
-                ],
-                env_handler => fun
-                    (emqx_plugins) ->
-                        ok = emqx_plugins:put_config(install_dir, ToInstallDir),
-                        %% this is to simulate an user setting the state
-                        %% via environment variables before starting the node
-                        ok = emqx_plugins:put_config(
-                            states,
-                            [#{name_vsn => NameVsn, enable => true}]
-                        ),
-                        ok;
-                    (_) ->
-                        ok
-                end,
-                priv_data_dir => PrivDataDir,
-                schema_mod => emqx_conf_schema,
-                load_schema => true
+    Apps = [
+        emqx,
+        emqx_conf,
+        emqx_ctl,
+        {emqx_plugins, #{
+            config => #{
+                plugins => #{
+                    install_dir => ToInstallDir,
+                    states => [#{name_vsn => NameVsn, enable => true}]
+                }
             }
-        ),
-    Nodes = [emqx_common_test_helpers:start_peer(Name, Opts) || {Name, Opts} <- Cluster],
+        }}
+    ],
+    Nodes = emqx_cth_cluster:start(
+        [
+            {group_t_cluster_leave1, #{role => core, apps => Apps}},
+            {group_t_cluster_leave2, #{role => core, apps => Apps}}
+        ],
+        #{
+            work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)
+        }
+    ),
     [
         {to_install_dir, ToInstallDir},
-        {cluster, Cluster},
         {nodes, Nodes},
         {name_vsn, NameVsn},
         {plugin_name, PluginName}
         | Config
     ];
 group_t_cluster_leave({'end', Config}) ->
-    Nodes = proplists:get_value(nodes, Config),
-    [ok = emqx_common_test_helpers:stop_peer(N) || N <- Nodes],
-    ok = file:del_dir_r(proplists:get_value(to_install_dir, Config)),
-    ok;
+    Nodes = ?config(nodes, Config),
+    ok = emqx_cth_cluster:stop(Nodes);
 group_t_cluster_leave(Config) ->
     [N1, N2] = ?config(nodes, Config),
     NameVsn = proplists:get_value(name_vsn, Config),

From 0d0e26d6af4faeff23aded35b22ad6ba3bab16fa Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Wed, 14 Feb 2024 20:07:56 +0200
Subject: [PATCH 228/273] fix: set `info` level for potentially flooding log
 events

---
 apps/emqx/src/emqx_access_control.erl  | 2 +-
 apps/emqx/src/emqx_channel.erl         | 4 ++--
 apps/emqx/src/emqx_session_events.erl  | 2 +-
 apps/emqx_license/src/emqx_license.erl | 2 +-
 changes/ce/fix-12513.en.md             | 1 +
 5 files changed, 6 insertions(+), 5 deletions(-)
 create mode 100644 changes/ce/fix-12513.en.md

diff --git a/apps/emqx/src/emqx_access_control.erl b/apps/emqx/src/emqx_access_control.erl
index b786e2c18..13b02bb4d 100644
--- a/apps/emqx/src/emqx_access_control.erl
+++ b/apps/emqx/src/emqx_access_control.erl
@@ -184,7 +184,7 @@ log_result(#{username := Username}, Topic, Action, From, Result) ->
     end,
     case Result of
         allow -> ?SLOG(info, (LogMeta())#{msg => "authorization_permission_allowed"});
-        deny -> ?SLOG(warning, (LogMeta())#{msg => "authorization_permission_denied"})
+        deny -> ?SLOG(info, (LogMeta())#{msg => "authorization_permission_denied"})
     end.
 
 %% @private Format authorization rules source.
diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index bb9c84e8c..2ffe880f3 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -613,7 +613,7 @@ process_publish(Packet = ?PUBLISH_PACKET(QoS, Topic, PacketId), Channel) ->
             do_publish(PacketId, Msg, NChannel);
         {error, Rc = ?RC_NOT_AUTHORIZED, NChannel} ->
             ?SLOG(
-                warning,
+                info,
                 #{
                     msg => "cannot_publish_to_topic",
                     reason => emqx_reason_codes:name(Rc)
@@ -632,7 +632,7 @@ process_publish(Packet = ?PUBLISH_PACKET(QoS, Topic, PacketId), Channel) ->
             end;
         {error, Rc = ?RC_QUOTA_EXCEEDED, NChannel} ->
             ?SLOG(
-                warning,
+                info,
                 #{
                     msg => "cannot_publish_to_topic",
                     reason => emqx_reason_codes:name(Rc)
diff --git a/apps/emqx/src/emqx_session_events.erl b/apps/emqx/src/emqx_session_events.erl
index f46144020..856efac74 100644
--- a/apps/emqx/src/emqx_session_events.erl
+++ b/apps/emqx/src/emqx_session_events.erl
@@ -63,7 +63,7 @@ handle_event(ClientInfo, {dropped, Msg, #{reason := queue_full, logctx := Ctx}})
     ok = inc_pd('send_msg.dropped', 1),
     ok = inc_pd('send_msg.dropped.queue_full', 1),
     ?SLOG(
-        warning,
+        info,
         Ctx#{
             msg => "dropped_msg_due_to_mqueue_is_full",
             payload => Msg#message.payload
diff --git a/apps/emqx_license/src/emqx_license.erl b/apps/emqx_license/src/emqx_license.erl
index eaa9661e3..c0fc10b91 100644
--- a/apps/emqx_license/src/emqx_license.erl
+++ b/apps/emqx_license/src/emqx_license.erl
@@ -85,7 +85,7 @@ check(_ConnInfo, AckProps) ->
         {ok, #{max_connections := MaxClients}} ->
             case check_max_clients_exceeded(MaxClients) of
                 true ->
-                    ?SLOG(error, #{msg => "connection_rejected_due_to_license_limit_reached"}),
+                    ?SLOG(info, #{msg => "connection_rejected_due_to_license_limit_reached"}),
                     {stop, {error, ?RC_QUOTA_EXCEEDED}};
                 false ->
                     {ok, AckProps}
diff --git a/changes/ce/fix-12513.en.md b/changes/ce/fix-12513.en.md
new file mode 100644
index 000000000..00c1e8537
--- /dev/null
+++ b/changes/ce/fix-12513.en.md
@@ -0,0 +1 @@
+Change level of several flooding log events from warning to info.

From 94254ec05b83f9fdce439cd1226b00c7403b3bf2 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Wed, 7 Feb 2024 23:55:44 +0100
Subject: [PATCH 229/273] feat(sessds): Correct handling of gaps in the seqno
 series

---
 apps/emqx/src/emqx_persistent_session_ds.erl  |  35 ++-
 .../emqx_persistent_session_ds_inflight.erl   | 236 ++++++++++++++++--
 2 files changed, 238 insertions(+), 33 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 16b6db8a9..84f55e762 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -389,7 +389,7 @@ publish(_PacketId, Msg, Session) ->
 puback(_ClientInfo, PacketId, Session0) ->
     case update_seqno(puback, PacketId, Session0) of
         {ok, Msg, Session} ->
-            {ok, Msg, [], inc_send_quota(Session)};
+            {ok, Msg, [], pull_now(Session)};
         Error ->
             Error
     end.
@@ -429,7 +429,7 @@ pubrel(_PacketId, Session = #{}) ->
 pubcomp(_ClientInfo, PacketId, Session0) ->
     case update_seqno(pubcomp, PacketId, Session0) of
         {ok, Msg, Session} ->
-            {ok, Msg, [], inc_send_quota(Session)};
+            {ok, Msg, [], pull_now(Session)};
         Error = {error, _} ->
             Error
     end.
@@ -907,11 +907,6 @@ ensure_timers(Session0) ->
     Session2 = emqx_session:ensure_timer(?TIMER_GET_STREAMS, 100, Session1),
     emqx_session:ensure_timer(?TIMER_BUMP_LAST_ALIVE_AT, 100, Session2).
 
--spec inc_send_quota(session()) -> session().
-inc_send_quota(Session = #{inflight := Inflight0}) ->
-    Inflight = emqx_persistent_session_ds_inflight:inc_send_quota(Inflight0),
-    pull_now(Session#{inflight => Inflight}).
-
 -spec pull_now(session()) -> session().
 pull_now(Session) ->
     emqx_session:reset_timer(?TIMER_PULL, 0, Session).
@@ -957,26 +952,28 @@ try_get_live_session(ClientId) ->
 
 -spec update_seqno(puback | pubrec | pubcomp, emqx_types:packet_id(), session()) ->
     {ok, emqx_types:message(), session()} | {error, _}.
-update_seqno(Track, PacketId, Session = #{id := SessionId, s := S}) ->
+update_seqno(Track, PacketId, Session = #{id := SessionId, s := S, inflight := Inflight0}) ->
     SeqNo = packet_id_to_seqno(PacketId, S),
     case Track of
         puback ->
-            QoS = ?QOS_1,
-            SeqNoKey = ?committed(?QOS_1);
+            SeqNoKey = ?committed(?QOS_1),
+            Result = emqx_persistent_session_ds_inflight:puback(SeqNo, Inflight0);
         pubrec ->
-            QoS = ?QOS_2,
-            SeqNoKey = ?rec;
+            SeqNoKey = ?rec,
+            Result = emqx_persistent_session_ds_inflight:pubrec(SeqNo, Inflight0);
         pubcomp ->
-            QoS = ?QOS_2,
-            SeqNoKey = ?committed(?QOS_2)
+            SeqNoKey = ?committed(?QOS_2),
+            Result = emqx_persistent_session_ds_inflight:pubcomp(SeqNo, Inflight0)
     end,
-    Current = emqx_persistent_session_ds_state:get_seqno(SeqNoKey, S),
-    case inc_seqno(QoS, Current) of
-        SeqNo ->
+    case Result of
+        {ok, Inflight} ->
             %% TODO: we pass a bogus message into the hook:
             Msg = emqx_message:make(SessionId, <<>>, <<>>),
-            {ok, Msg, Session#{s => emqx_persistent_session_ds_state:put_seqno(SeqNoKey, SeqNo, S)}};
-        Expected ->
+            {ok, Msg, Session#{
+                s => emqx_persistent_session_ds_state:put_seqno(SeqNoKey, SeqNo, S),
+                inflight => Inflight
+            }};
+        {error, Expected} ->
             ?SLOG(warning, #{
                 msg => "out-of-order_commit",
                 track => Track,
diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index 1a603abde..349713bf6 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -22,7 +22,9 @@
     pop/1,
     n_buffered/2,
     n_inflight/1,
-    inc_send_quota/1,
+    puback/2,
+    pubrec/2,
+    pubcomp/2,
     receive_maximum/1
 ]).
 
@@ -34,13 +36,28 @@
 -include("emqx.hrl").
 -include("emqx_mqtt.hrl").
 
+-ifdef(TEST).
+-include_lib("proper/include/proper.hrl").
+-include_lib("eunit/include/eunit.hrl").
+-endif.
+
 %%================================================================================
 %% Type declarations
 %%================================================================================
 
+-type payload() ::
+    {emqx_persistent_session_ds:seqno() | undefined, emqx_types:message()}
+    | {pubrel, emqx_persistent_session_ds:seqno()}.
+
 -record(inflight, {
-    queue :: queue:queue(),
     receive_maximum :: pos_integer(),
+    %% Main queue:
+    queue :: queue:queue(payload()),
+    %% Queues that are used to track sequence numbers of ack tracks:
+    puback_queue :: iqueue(),
+    pubrec_queue :: iqueue(),
+    pubcomp_queue :: iqueue(),
+    %% Counters:
     n_inflight = 0 :: non_neg_integer(),
     n_qos0 = 0 :: non_neg_integer(),
     n_qos1 = 0 :: non_neg_integer(),
@@ -49,17 +66,19 @@
 
 -type t() :: #inflight{}.
 
--type payload() ::
-    {emqx_persistent_session_ds:seqno() | undefined, emqx_types:message()}
-    | {pubrel, emqx_persistent_session_ds:seqno()}.
-
 %%================================================================================
 %% API funcions
 %%================================================================================
 
 -spec new(non_neg_integer()) -> t().
 new(ReceiveMaximum) when ReceiveMaximum > 0 ->
-    #inflight{queue = queue:new(), receive_maximum = ReceiveMaximum}.
+    #inflight{
+        receive_maximum = ReceiveMaximum,
+        queue = queue:new(),
+        puback_queue = iqueue_new(),
+        pubrec_queue = iqueue_new(),
+        pubcomp_queue = iqueue_new()
+    }.
 
 -spec receive_maximum(t()) -> pos_integer().
 receive_maximum(#inflight{receive_maximum = ReceiveMaximum}) ->
@@ -86,6 +105,9 @@ pop(Rec0) ->
         receive_maximum = ReceiveMaximum,
         n_inflight = NInflight,
         queue = Q0,
+        puback_queue = QAck,
+        pubrec_queue = QRec,
+        pubcomp_queue = QComp,
         n_qos0 = NQos0,
         n_qos1 = NQos1,
         n_qos2 = NQos2
@@ -96,17 +118,24 @@ pop(Rec0) ->
                 case Payload of
                     {pubrel, _} ->
                         Rec0#inflight{queue = Q};
-                    {_, #message{qos = Qos}} ->
+                    {SeqNo, #message{qos = Qos}} ->
                         case Qos of
                             ?QOS_0 ->
                                 Rec0#inflight{queue = Q, n_qos0 = NQos0 - 1};
                             ?QOS_1 ->
                                 Rec0#inflight{
-                                    queue = Q, n_qos1 = NQos1 - 1, n_inflight = NInflight + 1
+                                    queue = Q,
+                                    n_qos1 = NQos1 - 1,
+                                    n_inflight = NInflight + 1,
+                                    puback_queue = ipush(SeqNo, QAck)
                                 };
                             ?QOS_2 ->
                                 Rec0#inflight{
-                                    queue = Q, n_qos2 = NQos2 - 1, n_inflight = NInflight + 1
+                                    queue = Q,
+                                    n_qos2 = NQos2 - 1,
+                                    n_inflight = NInflight + 1,
+                                    pubrec_queue = ipush(SeqNo, QRec),
+                                    pubcomp_queue = ipush(SeqNo, QComp)
                                 }
                         end
                 end,
@@ -129,12 +158,191 @@ n_buffered(all, #inflight{n_qos0 = NQos0, n_qos1 = NQos1, n_qos2 = NQos2}) ->
 n_inflight(#inflight{n_inflight = NInflight}) ->
     NInflight.
 
+-spec puback(emqx_persistent_session_ds:seqno(), t()) -> {ok, t()} | {error, Expected} when
+    Expected :: emqx_persistent_session_ds:seqno() | undefined.
+puback(SeqNo, Rec = #inflight{puback_queue = Q0, n_inflight = N}) ->
+    case ipop(Q0) of
+        {{value, SeqNo}, Q} ->
+            {ok, Rec#inflight{
+                puback_queue = Q,
+                n_inflight = max(0, N - 1)
+            }};
+        {{value, Expected}, _} ->
+            {error, Expected};
+        _ ->
+            {error, undefined}
+    end.
+
+-spec pubcomp(emqx_persistent_session_ds:seqno(), t()) -> {ok, t()} | {error, Expected} when
+    Expected :: emqx_persistent_session_ds:seqno() | undefined.
+pubcomp(SeqNo, Rec = #inflight{pubcomp_queue = Q0, n_inflight = N}) ->
+    case ipop(Q0) of
+        {{value, SeqNo}, Q} ->
+            {ok, Rec#inflight{
+                pubcomp_queue = Q,
+                n_inflight = max(0, N - 1)
+            }};
+        {{value, Expected}, _} ->
+            {error, Expected};
+        _ ->
+            {error, undefined}
+    end.
+
+%% PUBREC doesn't affect inflight window:
 %% https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Flow_Control
--spec inc_send_quota(t()) -> t().
-inc_send_quota(Rec = #inflight{n_inflight = NInflight0}) ->
-    NInflight = max(NInflight0 - 1, 0),
-    Rec#inflight{n_inflight = NInflight}.
+-spec pubrec(emqx_persistent_session_ds:seqno(), t()) -> {ok, t()} | {error, Expected} when
+    Expected :: emqx_persistent_session_ds:seqno() | undefined.
+pubrec(SeqNo, Rec = #inflight{pubrec_queue = Q0}) ->
+    case ipop(Q0) of
+        {{value, SeqNo}, Q} ->
+            {ok, Rec#inflight{
+                pubrec_queue = Q
+            }};
+        {{value, Expected}, _} ->
+            {error, Expected};
+        _ ->
+            {error, undefined}
+    end.
 
 %%================================================================================
 %% Internal functions
 %%================================================================================
+
+%%%% Interval queue:
+
+%% "Interval queue": a data structure that represents a queue of
+%% monotonically increasing integers in a compact manner. It is
+%% functionally equivalent to a `queue:queue(integer())'.
+-record(iqueue, {
+    %% Head interval:
+    head :: integer() | undefined,
+    head_end :: integer() | undefined,
+    %% Intermediate ranges:
+    queue :: queue:queue({integer(), integer()}),
+    %% End interval:
+    tail :: integer() | undefined,
+    tail_end :: integer() | undefined
+}).
+
+-type iqueue() :: #iqueue{}.
+
+iqueue_new() ->
+    #iqueue{
+        queue = queue:new()
+    }.
+
+%% @doc Push a value into the interval queue:
+-spec ipush(integer(), iqueue()) -> iqueue().
+ipush(Val, Q = #iqueue{tail = undefined, tail_end = undefined}) ->
+    Q#iqueue{
+        tail = Val,
+        tail_end = Val + 1
+    };
+ipush(Val, Q = #iqueue{tail_end = Val}) ->
+    %% Extend tail interval:
+    Q#iqueue{
+        tail_end = Val + 1
+    };
+ipush(Val, Q = #iqueue{tail = Tl, tail_end = End, queue = IQ0}) when Val > End ->
+    IQ = queue:in({Tl, End}, IQ0),
+    %% Begin a new interval:
+    Q#iqueue{
+        queue = IQ,
+        tail = Val,
+        tail_end = Val + 1
+    }.
+
+-spec ipop(iqueue()) -> {{value, integer()}, iqueue()} | {empty, iqueue()}.
+ipop(Q = #iqueue{head = Hd, head_end = HdEnd}) when is_number(HdEnd), Hd < HdEnd ->
+    {{value, Hd}, Q#iqueue{head = Hd + 1}};
+ipop(Q = #iqueue{head = Hd0, tail = Tl, tail_end = TlEnd, queue = IQ0}) ->
+    case queue:out(IQ0) of
+        {{value, {Hd, HdEnd}}, IQ} ->
+            ipop(Q#iqueue{head = nmax(Hd0, Hd), head_end = HdEnd, queue = IQ});
+        {empty, _} ->
+            do_ipop(Q#iqueue{head = nmax(Hd0, Tl), head_end = TlEnd})
+    end.
+
+do_ipop(Q = #iqueue{head = Hd, head_end = HdEnd}) when is_number(HdEnd), Hd < HdEnd ->
+    {{value, Hd}, Q#iqueue{head = Hd + 1}};
+do_ipop(Q) ->
+    {empty, Q}.
+
+nmax(undefined, N) ->
+    N;
+nmax(N, undefined) ->
+    N;
+nmax(N, M) ->
+    max(N, M).
+
+-ifdef(TEST).
+
+%% Test that behavior of iqueue is identical to that of a regular queue of integers:
+iqueue_compat_test_() ->
+    Props = [iqueue_compat()],
+    Opts = [{numtests, 1000}, {to_file, user}, {max_size, 100}],
+    {timeout, 30, [?_assert(proper:quickcheck(Prop, Opts)) || Prop <- Props]}.
+
+%% Generate a sequence of pops and pushes with monotonically
+%% increasing arguments, and verify replaying produces equivalent
+%% results for the optimized and the reference implementation:
+iqueue_compat() ->
+    ?FORALL(
+        Cmds,
+        iqueue_commands(),
+        begin
+            lists:foldl(
+                fun
+                    ({push, N}, {IQ, Q, Acc}) ->
+                        {ipush(N, IQ), queue:in(N, Q), [N | Acc]};
+                    (pop, {IQ0, Q0, Acc}) ->
+                        {Ret, IQ} = ipop(IQ0),
+                        {Expected, Q} = queue:out(Q0),
+                        ?assertEqual(
+                            Expected,
+                            Ret,
+                            #{
+                                sequence => lists:reverse(Acc),
+                                q => queue:to_list(Q0),
+                                iq0 => iqueue_print(IQ0),
+                                iq => iqueue_print(IQ)
+                            }
+                        ),
+                        {IQ, Q, [pop | Acc]}
+                end,
+                {iqueue_new(), queue:new(), []},
+                Cmds
+            ),
+            true
+        end
+    ).
+
+iqueue_cmd() ->
+    oneof([
+        pop,
+        {push, range(1, 3)}
+    ]).
+
+iqueue_commands() ->
+    ?LET(
+        Cmds,
+        list(iqueue_cmd()),
+        process_test_cmds(Cmds, 0)
+    ).
+
+process_test_cmds([], _) ->
+    [];
+process_test_cmds([pop | Tl], Cnt) ->
+    [pop | process_test_cmds(Tl, Cnt)];
+process_test_cmds([{push, N} | Tl], Cnt0) ->
+    Cnt = Cnt0 + N,
+    [{push, Cnt} | process_test_cmds(Tl, Cnt)].
+
+iqueue_print(I = #iqueue{head = Hd, head_end = HdEnd, queue = Q, tail = Tl, tail_end = TlEnd}) ->
+    #{
+        hd => {Hd, HdEnd},
+        tl => {Tl, TlEnd},
+        q => queue:to_list(Q)
+    }.
+
+-endif.

From 6514659733f563f5feea7ac143db10b9cdf97193 Mon Sep 17 00:00:00 2001
From: Andrew Mayorov <encube.ul@gmail.com>
Date: Thu, 15 Feb 2024 11:04:58 +0100
Subject: [PATCH 230/273] test(mgmt): update and simplify testsuites setup

---
 .../test/emqx_mgmt_api_SUITE.erl              |  64 +++++-----
 .../test/emqx_mgmt_api_listeners_SUITE.erl    | 117 +++++++-----------
 .../test/emqx_mgmt_api_nodes_SUITE.erl        |  52 ++++----
 3 files changed, 102 insertions(+), 131 deletions(-)

diff --git a/apps/emqx_management/test/emqx_mgmt_api_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_SUITE.erl
index ade8d3171..5c9d7269b 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_SUITE.erl
@@ -37,13 +37,27 @@ end_per_suite(_) ->
 %% cases
 %%--------------------------------------------------------------------
 
-t_cluster_query(_Config) ->
+t_cluster_query(Config) ->
     net_kernel:start(['master@127.0.0.1', longnames]),
     ct:timetrap({seconds, 120}),
     snabbkaffe:fix_ct_logging(),
-    [{Name, Opts}, {Name1, Opts1}] = cluster_specs(),
-    Node1 = emqx_common_test_helpers:start_peer(Name, Opts),
-    Node2 = emqx_common_test_helpers:start_peer(Name1, Opts1),
+    ListenerConf = fun(Port) ->
+        io_lib:format(
+            "\n listeners.tcp.default.bind = ~p"
+            "\n listeners.ssl.default.enable = false"
+            "\n listeners.ws.default.enable = false"
+            "\n listeners.wss.default.enable = false",
+            [Port]
+        )
+    end,
+    Nodes =
+        [Node1, Node2] = emqx_cth_cluster:start(
+            [
+                {corenode1, #{role => core, apps => [{emqx, ListenerConf(2883)}, emqx_management]}},
+                {corenode2, #{role => core, apps => [{emqx, ListenerConf(3883)}, emqx_management]}}
+            ],
+            #{work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)}
+        ),
     try
         process_flag(trap_exit, true),
         ClientLs1 = [start_emqtt_client(Node1, I, 2883) || I <- lists:seq(1, 10)],
@@ -168,13 +182,19 @@ t_cluster_query(_Config) ->
         _ = lists:foreach(fun(C) -> emqtt:disconnect(C) end, ClientLs1),
         _ = lists:foreach(fun(C) -> emqtt:disconnect(C) end, ClientLs2)
     after
-        emqx_common_test_helpers:stop_peer(Node1),
-        emqx_common_test_helpers:stop_peer(Node2)
-    end,
-    ok.
+        emqx_cth_cluster:stop(Nodes)
+    end.
 
-t_bad_rpc(_) ->
-    emqx_mgmt_api_test_util:init_suite(),
+t_bad_rpc(Config) ->
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)}
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
     process_flag(trap_exit, true),
     ClientLs1 = [start_emqtt_client(node(), I, 1883) || I <- lists:seq(1, 10)],
     Path = emqx_mgmt_api_test_util:api_path(["clients?limit=2&page=2"]),
@@ -187,35 +207,13 @@ t_bad_rpc(_) ->
     after
         _ = lists:foreach(fun(C) -> emqtt:disconnect(C) end, ClientLs1),
         meck:unload(emqx),
-        emqx_mgmt_api_test_util:end_suite()
+        emqx_cth_suite:stop(Apps)
     end.
 
 %%--------------------------------------------------------------------
 %% helpers
 %%--------------------------------------------------------------------
 
-cluster_specs() ->
-    Specs =
-        %% default listeners port
-        [
-            {core, corenode1, #{listener_ports => [{tcp, 2883}]}},
-            {core, corenode2, #{listener_ports => [{tcp, 3883}]}}
-        ],
-    CommOpts =
-        [
-            {env, [{emqx, boot_modules, all}]},
-            {apps, []},
-            {conf, [
-                {[listeners, ssl, default, enable], false},
-                {[listeners, ws, default, enable], false},
-                {[listeners, wss, default, enable], false}
-            ]}
-        ],
-    emqx_common_test_helpers:emqx_cluster(
-        Specs,
-        CommOpts
-    ).
-
 start_emqtt_client(Node0, N, Port) ->
     Node = atom_to_binary(Node0),
     ClientId = iolist_to_binary([Node, "-", integer_to_binary(N)]),
diff --git a/apps/emqx_management/test/emqx_mgmt_api_listeners_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_listeners_SUITE.erl
index cbcbfdd3f..244961283 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_listeners_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_listeners_SUITE.erl
@@ -27,14 +27,19 @@
 all() ->
     [
         {group, with_defaults_in_file},
-        {group, without_defaults_in_file}
+        {group, without_defaults_in_file},
+        {group, max_connections}
     ].
 
 groups() ->
     AllTests = emqx_common_test_helpers:all(?MODULE),
+    MaxConnTests = [
+        t_max_connection_default
+    ],
     [
-        {with_defaults_in_file, AllTests},
-        {without_defaults_in_file, AllTests}
+        {with_defaults_in_file, AllTests -- MaxConnTests},
+        {without_defaults_in_file, AllTests -- MaxConnTests},
+        {max_connections, MaxConnTests}
     ].
 
 init_per_suite(Config) ->
@@ -44,29 +49,39 @@ end_per_suite(_Config) ->
     ok.
 
 init_per_group(without_defaults_in_file, Config) ->
-    emqx_mgmt_api_test_util:init_suite([emqx_conf]),
-    Config;
+    init_group_apps(#{}, Config);
 init_per_group(with_defaults_in_file, Config) ->
     %% we have to materialize the config file with default values for this test group
     %% because we want to test the deletion of non-existing listener
     %% if there is no config file, the such deletion would result in a deletion
     %% of the default listener.
-    Name = atom_to_list(?MODULE) ++ "-default-listeners",
-    TmpConfFullPath = inject_tmp_config_content(Name, default_listeners_hocon_text()),
-    emqx_mgmt_api_test_util:init_suite([emqx_conf]),
-    [{injected_conf_file, TmpConfFullPath} | Config].
+    PrivDir = ?config(priv_dir, Config),
+    FileName = filename:join([PrivDir, "etc", atom_to_list(?MODULE) ++ "-default-listeners"]),
+    ok = filelib:ensure_dir(FileName),
+    ok = file:write_file(FileName, default_listeners_hocon_text()),
+    init_group_apps("include \"" ++ FileName ++ "\"", Config);
+init_per_group(max_connections, Config) ->
+    init_group_apps(
+        io_lib:format("listeners.tcp.max_connection_test {bind = \"0.0.0.0:~p\"}", [?PORT]),
+        Config
+    ).
 
-end_per_group(Group, Config) ->
-    emqx_conf:tombstone([listeners, tcp, new], #{override_to => cluster}),
-    emqx_conf:tombstone([listeners, tcp, new1], #{override_to => local}),
-    case Group =:= with_defaults_in_file of
-        true ->
-            {_, File} = lists:keyfind(injected_conf_file, 1, Config),
-            ok = file:delete(File);
-        false ->
-            ok
-    end,
-    emqx_mgmt_api_test_util:end_suite([emqx_conf]).
+init_group_apps(Config, CTConfig) ->
+    Apps = emqx_cth_suite:start(
+        [
+            {emqx_conf, Config},
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{
+            work_dir => emqx_cth_suite:work_dir(CTConfig)
+        }
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | CTConfig].
+
+end_per_group(_Group, Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(Case, Config) ->
     try
@@ -84,16 +99,6 @@ end_per_testcase(Case, Config) ->
             ok
     end.
 
-t_max_connection_default({init, Config}) ->
-    emqx_mgmt_api_test_util:end_suite([emqx_conf]),
-    Port = integer_to_binary(?PORT),
-    Bin = <<"listeners.tcp.max_connection_test {bind = \"0.0.0.0:", Port/binary, "\"}">>,
-    TmpConfName = atom_to_list(?FUNCTION_NAME) ++ ".conf",
-    TmpConfFullPath = inject_tmp_config_content(TmpConfName, Bin),
-    emqx_mgmt_api_test_util:init_suite([emqx_conf]),
-    [{tmp_config_file, TmpConfFullPath} | Config];
-t_max_connection_default({'end', Config}) ->
-    ok = file:delete(proplists:get_value(tmp_config_file, Config));
 t_max_connection_default(Config) when is_list(Config) ->
     #{<<"listeners">> := Listeners} = emqx_mgmt_api_listeners:do_list_listeners(),
     Target = lists:filter(
@@ -189,13 +194,19 @@ t_wss_crud_listeners_by_id(Config) when is_list(Config) ->
     crud_listeners_by_id(ListenerId, NewListenerId, MinListenerId, BadId, Type, 34000).
 
 t_api_listeners_list_not_ready(Config) when is_list(Config) ->
-    net_kernel:start(['listeners@127.0.0.1', longnames]),
     ct:timetrap({seconds, 120}),
-    snabbkaffe:fix_ct_logging(),
-    Cluster = [{Name, Opts}, {Name1, Opts1}] = cluster([core, core]),
-    ct:pal("Starting ~p", [Cluster]),
-    Node1 = emqx_common_test_helpers:start_peer(Name, Opts),
-    Node2 = emqx_common_test_helpers:start_peer(Name1, Opts1),
+    Apps = [
+        {emqx, #{after_start => fun() -> emqx_app:set_config_loader(emqx) end}},
+        {emqx_conf, #{}}
+    ],
+    Nodes =
+        [Node1, Node2] = emqx_cth_cluster:start(
+            [
+                {t_api_listeners_list_not_ready1, #{role => core, apps => Apps}},
+                {t_api_listeners_list_not_ready2, #{role => core, apps => Apps}}
+            ],
+            #{work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)}
+        ),
     try
         L1 = get_tcp_listeners(Node1),
 
@@ -214,8 +225,7 @@ t_api_listeners_list_not_ready(Config) when is_list(Config) ->
         ?assert(length(L1) > length(L2), Comment),
         ?assertEqual(length(L2), length(L3), Comment)
     after
-        emqx_common_test_helpers:stop_peer(Node1),
-        emqx_common_test_helpers:stop_peer(Node2)
+        emqx_cth_cluster:stop(Nodes)
     end.
 
 t_clear_certs(Config) when is_list(Config) ->
@@ -296,25 +306,6 @@ assert_config_load_not_done(Node) ->
     Prio = rpc:call(Node, emqx_app, get_config_loader, []),
     ?assertEqual(emqx, Prio, #{node => Node}).
 
-cluster(Specs) ->
-    Env = [
-        {emqx, boot_modules, []}
-    ],
-    emqx_common_test_helpers:emqx_cluster(Specs, [
-        {env, Env},
-        {apps, [emqx_conf]},
-        {load_schema, false},
-        {env_handler, fun
-            (emqx) ->
-                application:set_env(emqx, boot_modules, []),
-                %% test init_config not ready.
-                emqx_app:set_config_loader(emqx),
-                ok;
-            (_) ->
-                ok
-        end}
-    ]).
-
 crud_listeners_by_id(ListenerId, NewListenerId, MinListenerId, BadId, Type, PortBase) ->
     OriginPath = emqx_mgmt_api_test_util:api_path(["listeners", ListenerId]),
     NewPath = emqx_mgmt_api_test_util:api_path(["listeners", NewListenerId]),
@@ -529,15 +520,3 @@ default_listeners_hocon_text() ->
     Listeners = hocon_tconf:make_serializable(Sc, #{}, #{}),
     Config = #{<<"listeners">> => Listeners},
     hocon_pp:do(Config, #{}).
-
-%% inject a 'include' at the end of emqx.conf.all
-%% the 'include' can be kept after test,
-%% as long as the file has been deleted it is a no-op
-inject_tmp_config_content(TmpFile, Content) ->
-    Etc = filename:join(["etc", "emqx.conf.all"]),
-    Inc = filename:join(["etc", TmpFile]),
-    ConfFile = emqx_common_test_helpers:app_path(emqx_conf, Etc),
-    TmpFileFullPath = emqx_common_test_helpers:app_path(emqx_conf, Inc),
-    ok = file:write_file(TmpFileFullPath, Content),
-    ok = file:write_file(ConfFile, ["\ninclude \"", TmpFileFullPath, "\"\n"], [append]),
-    TmpFileFullPath.
diff --git a/apps/emqx_management/test/emqx_mgmt_api_nodes_SUITE.erl b/apps/emqx_management/test/emqx_mgmt_api_nodes_SUITE.erl
index 63754d437..20f2be676 100644
--- a/apps/emqx_management/test/emqx_mgmt_api_nodes_SUITE.erl
+++ b/apps/emqx_management/test/emqx_mgmt_api_nodes_SUITE.erl
@@ -19,16 +19,25 @@
 -compile(nowarn_export_all).
 
 -include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
 
 all() ->
     emqx_common_test_helpers:all(?MODULE).
 
 init_per_suite(Config) ->
-    emqx_mgmt_api_test_util:init_suite([emqx_conf, emqx_management]),
-    Config.
+    Apps = emqx_cth_suite:start(
+        [
+            emqx_conf,
+            emqx_management,
+            {emqx_dashboard, "dashboard.listeners.http { enable = true, bind = 18083 }"}
+        ],
+        #{work_dir => emqx_cth_suite:work_dir(Config)}
+    ),
+    {ok, _} = emqx_common_test_http:create_default_app(),
+    [{suite_apps, Apps} | Config].
 
-end_per_suite(_) ->
-    emqx_mgmt_api_test_util:end_suite([emqx_management, emqx_conf]).
+end_per_suite(Config) ->
+    ok = emqx_cth_suite:stop(?config(suite_apps, Config)).
 
 init_per_testcase(t_log_path, Config) ->
     emqx_config_logger:add_handler(),
@@ -121,16 +130,17 @@ t_node_metrics_api(_) ->
         emqx_mgmt_api_test_util:request_api(get, BadNodePath)
     ).
 
-t_multiple_nodes_api(_) ->
-    net_kernel:start(['node_api@127.0.0.1', longnames]),
+t_multiple_nodes_api(Config) ->
     ct:timetrap({seconds, 120}),
     snabbkaffe:fix_ct_logging(),
-    Seq1 = list_to_atom(atom_to_list(?MODULE) ++ "1"),
-    Seq2 = list_to_atom(atom_to_list(?MODULE) ++ "2"),
-    Cluster = [{Name, Opts}, {Name1, Opts1}] = cluster([{core, Seq1}, {core, Seq2}]),
-    ct:pal("Starting ~p", [Cluster]),
-    Node1 = emqx_common_test_helpers:start_peer(Name, Opts),
-    Node2 = emqx_common_test_helpers:start_peer(Name1, Opts1),
+    Nodes =
+        [Node1, Node2] = emqx_cth_cluster:start(
+            [
+                {t_multiple_nodes_api1, #{role => core, apps => [emqx_conf, emqx_management]}},
+                {t_multiple_nodes_api2, #{role => core, apps => [emqx_conf, emqx_management]}}
+            ],
+            #{work_dir => emqx_cth_suite:work_dir(?FUNCTION_NAME, Config)}
+        ),
     try
         {200, NodesList} = rpc:call(Node1, emqx_mgmt_api_nodes, nodes, [get, #{}]),
         All = [Node1, Node2],
@@ -148,22 +158,6 @@ t_multiple_nodes_api(_) ->
         ]),
         ?assertMatch(#{node := Node1}, Node11)
     after
-        emqx_common_test_helpers:stop_peer(Node1),
-        emqx_common_test_helpers:stop_peer(Node2)
+        emqx_cth_cluster:stop(Nodes)
     end,
     ok.
-
-cluster(Specs) ->
-    Env = [{emqx, boot_modules, []}],
-    emqx_common_test_helpers:emqx_cluster(Specs, [
-        {env, Env},
-        {apps, [emqx_conf, emqx_management]},
-        {load_schema, false},
-        {env_handler, fun
-            (emqx) ->
-                application:set_env(emqx, boot_modules, []),
-                ok;
-            (_) ->
-                ok
-        end}
-    ]).

From 5e442fcbca4286d4eddacf0c0b5790afae1a9a43 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 15 Feb 2024 11:08:08 +0100
Subject: [PATCH 231/273] fix: labels and descriptions

---
 .../src/emqx_bridge_hstreamdb.erl             | 30 ++++++++---
 rel/i18n/emqx_bridge_hstreamdb.hocon          | 54 +++++++++++++++++++
 2 files changed, 78 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
index ee0baaa4c..0556a731d 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
@@ -1,4 +1,4 @@
-%%--------------------------------------------------------------------
+%--------------------------------------------------------------------
 %% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%--------------------------------------------------------------------
 -module(emqx_bridge_hstreamdb).
@@ -160,9 +160,15 @@ fields(hstreamdb_action) ->
     );
 fields(action_parameters) ->
     [
-        {stream, mk(binary(), #{required => true, desc => ?DESC("stream_name")})},
+        {stream,
+            mk(binary(), #{
+                required => true, desc => ?DESC(emqx_bridge_hstreamdb_connector, "stream_name")
+            })},
 
-        {partition_key, mk(binary(), #{required => false, desc => ?DESC("partition_key")})},
+        {partition_key,
+            mk(binary(), #{
+                required => false, desc => ?DESC(emqx_bridge_hstreamdb_connector, "partition_key")
+            })},
 
         {grpc_flush_timeout, fun grpc_flush_timeout/1},
         {record_template,
@@ -181,7 +187,9 @@ fields(connector_fields) ->
     [
         {url,
             mk(binary(), #{
-                required => true, desc => ?DESC("url"), default => <<"http://127.0.0.1:6570">>
+                required => true,
+                desc => ?DESC(emqx_bridge_hstreamdb_connector, "url"),
+                default => <<"http://127.0.0.1:6570">>
             })},
         {grpc_timeout, fun grpc_timeout/1}
     ] ++ emqx_connector_schema_lib:ssl_fields();
@@ -208,13 +216,13 @@ fields("put") ->
         connector_fields().
 
 grpc_timeout(type) -> emqx_schema:timeout_duration_ms();
-grpc_timeout(desc) -> ?DESC("grpc_timeout");
+grpc_timeout(desc) -> ?DESC(emqx_bridge_hstreamdb_connector, "grpc_timeout");
 grpc_timeout(default) -> ?DEFAULT_GRPC_TIMEOUT_RAW;
 grpc_timeout(required) -> false;
 grpc_timeout(_) -> undefined.
 
 grpc_flush_timeout(type) -> emqx_schema:timeout_duration_ms();
-grpc_flush_timeout(desc) -> ?DESC("grpc_timeout");
+grpc_flush_timeout(desc) -> ?DESC("grpc_flush_timeout");
 grpc_flush_timeout(default) -> ?DEFAULT_GRPC_FLUSH_TIMEOUT_RAW;
 grpc_flush_timeout(required) -> false;
 grpc_flush_timeout(_) -> undefined.
@@ -236,6 +244,16 @@ desc("config") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
     ["Configuration for HStreamDB bridge using `", string:to_upper(Method), "` method."];
+desc("creation_opts") ->
+    ?DESC(emqx_resource_schema, "creation_opts");
+desc("config_connector") ->
+    ?DESC("config_connector");
+desc(hstreamdb_action) ->
+    ?DESC("hstreamdb_action");
+desc(action_parameters) ->
+    ?DESC("action_parameters");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc(_) ->
     undefined.
 
diff --git a/rel/i18n/emqx_bridge_hstreamdb.hocon b/rel/i18n/emqx_bridge_hstreamdb.hocon
index de9989953..70375dfbf 100644
--- a/rel/i18n/emqx_bridge_hstreamdb.hocon
+++ b/rel/i18n/emqx_bridge_hstreamdb.hocon
@@ -47,4 +47,58 @@ NOTE: When you use `raw record` template (which means the data is not a valid JS
 record_template.label:
 """HStream Record"""
 
+action_parameters.desc:
+"""Action specific configuration."""
+
+action_parameters.label:
+"""Action"""
+
+grpc_flush_timeout.desc:
+"""Period for flushing gRPC calls to the HStreamDB server"""
+
+grpc_flush_timeout.label:
+"""gRPC Flush Period"""
+
+aggregation_pool_size.desc:
+"""Size of Record Aggregation Pool"""
+
+aggregation_pool_size.label:
+"""Aggregation Pool Size"""
+
+max_batches.desc:
+"""Maximum number of unconfirmed batches in the flush queue"""
+
+max_batches.label:
+"""Max Batches"""
+
+writer_pool_size.desc:
+"""Writer Pool Size"""
+
+writer_pool_size.label:
+"""Writer Pool Size"""
+
+batch_size.desc:
+"""Maximum number of insert data clauses that can be sent in a single request"""
+
+batch_size.label:
+"""Max Batch Append Count"""
+
+batch_interval.desc:
+"""Maximum interval in milliseconds that is allowed between two successive (batch) request"""
+
+batch_interval.label:
+"""Max Batch Interval"""
+
+hstreamdb_action.desc:
+"""Configuration for HStreamDB Action"""
+
+hstreamdb_action.label:
+"""HStreamDB Action Configuration"""
+
+config_connector.desc:
+"""Configuration for an HStreamDB connector."""
+
+config_connector.label:
+"""HStreamDB Connector Configuration"""
+
 }

From c781240459cc1a6fdaa58b03a2d07ddb5b8639d6 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 8 Feb 2024 00:53:53 +0100
Subject: [PATCH 232/273] feat(sessds): Add support for the retainer

Note: this is currently not ideal. Retained messages won't be
redelivered.
---
 apps/emqx/src/emqx_persistent_session_ds.erl  | 68 +++++++++++--
 .../test/emqx_persistent_session_SUITE.erl    | 99 ++++++++++++++++++-
 2 files changed, 158 insertions(+), 9 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 84f55e762..856210331 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -241,8 +241,10 @@ info(mqueue_dropped, _Session) ->
 %%     seqno_diff(?QOS_2, ?rec, ?committed(?QOS_2), S);
 info(awaiting_rel_max, #{props := Conf}) ->
     maps:get(max_awaiting_rel, Conf);
-info(await_rel_timeout, #{props := Conf}) ->
-    maps:get(await_rel_timeout, Conf).
+info(await_rel_timeout, #{props := _Conf}) ->
+    %% TODO: currently this setting is ignored:
+    %% maps:get(await_rel_timeout, Conf).
+    0.
 
 -spec stats(session()) -> emqx_types:stats().
 stats(Session) ->
@@ -438,9 +440,13 @@ pubcomp(_ClientInfo, PacketId, Session0) ->
 
 -spec deliver(clientinfo(), [emqx_types:deliver()], session()) ->
     {ok, replies(), session()}.
-deliver(_ClientInfo, _Delivers, Session) ->
-    %% TODO: system messages end up here.
-    {ok, [], Session}.
+deliver(ClientInfo, Delivers, Session0) ->
+    %% Durable sessions still have to handle some transient messages.
+    %% For example, retainer sends messages to the session directly.
+    Session = lists:foldl(
+        fun(Msg, Acc) -> enqueue_transient(ClientInfo, Msg, Acc) end, Session0, Delivers
+    ),
+    {ok, [], pull_now(Session)}.
 
 -spec handle_timeout(clientinfo(), _Timeout, session()) ->
     {ok, replies(), session()} | {ok, replies(), timeout(), session()}.
@@ -481,8 +487,8 @@ handle_timeout(_ClientInfo, #req_sync{from = From, ref = Ref}, Session = #{s :=
     S = emqx_persistent_session_ds_state:commit(S0),
     From ! Ref,
     {ok, [], Session#{s => S}};
-handle_timeout(_ClientInfo, expire_awaiting_rel, Session) ->
-    %% TODO: stub
+handle_timeout(_ClientInfo, Timeout, Session) ->
+    ?SLOG(warning, #{msg => "unknown_ds_timeout", timeout => Timeout}),
     {ok, [], Session}.
 
 bump_last_alive(S0) ->
@@ -871,6 +877,54 @@ process_batch(
         IsReplay, Session, ClientInfo, LastSeqNoQos1, LastSeqNoQos2, Messages, Inflight
     ).
 
+%%--------------------------------------------------------------------
+%% Transient messages
+%%--------------------------------------------------------------------
+
+enqueue_transient(ClientInfo, Msg0, Session = #{s := S, props := #{upgrade_qos := UpgradeQoS}}) ->
+    %% TODO: Such messages won't be retransmitted, should the session
+    %% reconnect before transient messages are acked.
+    %%
+    %% Proper solution could look like this: session publishes
+    %% transient messages to a separate DS DB that serves as a queue,
+    %% then subscribes to a special system topic that contains the
+    %% queued messages. Since streams in this DB are exclusive to the
+    %% session, messages from the queue can be dropped as soon as they
+    %% are acked.
+    Subs = emqx_persistent_session_ds_state:get_subscriptions(S),
+    Msgs = [
+        Msg
+     || SubMatch <- emqx_topic_gbt:matches(Msg0#message.topic, Subs, []),
+        Msg <- begin
+            #{props := SubOpts} = emqx_topic_gbt:get_record(SubMatch, Subs),
+            emqx_session:enrich_message(ClientInfo, Msg0, SubOpts, UpgradeQoS)
+        end
+    ],
+    lists:foldl(fun do_enqueue_transient/2, Session, Msgs).
+
+do_enqueue_transient(Msg = #message{qos = Qos}, Session = #{inflight := Inflight0, s := S0}) ->
+    case Qos of
+        ?QOS_0 ->
+            S = S0,
+            Inflight = emqx_persistent_session_ds_inflight:push({undefined, Msg}, Inflight0);
+        ?QOS_1 ->
+            SeqNo = inc_seqno(
+                ?QOS_1, emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0)
+            ),
+            S = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), SeqNo, S0),
+            Inflight = emqx_persistent_session_ds_inflight:push({SeqNo, Msg}, Inflight0);
+        ?QOS_2 ->
+            SeqNo = inc_seqno(
+                ?QOS_2, emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0)
+            ),
+            S = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), SeqNo, S0),
+            Inflight = emqx_persistent_session_ds_inflight:push({SeqNo, Msg}, Inflight0)
+    end,
+    Session#{
+        inflight => Inflight,
+        s => S
+    }.
+
 %%--------------------------------------------------------------------
 %% Buffer drain
 %%--------------------------------------------------------------------
diff --git a/apps/emqx/test/emqx_persistent_session_SUITE.erl b/apps/emqx/test/emqx_persistent_session_SUITE.erl
index f8ee11c08..a5c171f67 100644
--- a/apps/emqx/test/emqx_persistent_session_SUITE.erl
+++ b/apps/emqx/test/emqx_persistent_session_SUITE.erl
@@ -53,7 +53,7 @@ all() ->
 
 groups() ->
     TCs = emqx_common_test_helpers:all(?MODULE),
-    TCsNonGeneric = [t_choose_impl],
+    TCsNonGeneric = [t_choose_impl, t_transient],
     TCGroups = [{group, tcp}, {group, quic}, {group, ws}],
     [
         {persistence_disabled, TCGroups},
@@ -265,7 +265,15 @@ messages(Topic, Payloads) ->
     messages(Topic, Payloads, ?QOS_2).
 
 messages(Topic, Payloads, QoS) ->
-    [#mqtt_msg{topic = Topic, payload = P, qos = QoS} || P <- Payloads].
+    lists:map(
+        fun
+            (Bin) when is_binary(Bin) ->
+                #mqtt_msg{topic = Topic, payload = Bin, qos = QoS};
+            (Msg = #mqtt_msg{}) ->
+                Msg#mqtt_msg{topic = Topic}
+        end,
+        Payloads
+    ).
 
 publish(Topic, Payload) ->
     publish(Topic, Payload, ?QOS_2).
@@ -1103,6 +1111,93 @@ t_unsubscribe_replay(Config) ->
     ),
     ok = emqtt:disconnect(Sub1).
 
+%% This testcase verifies that persistent sessions handle "transient"
+%% mesages correctly.
+%%
+%% Transient messages are delivered to the channel directly, bypassing
+%% the broker code that decides whether the messages should be
+%% persisted or not, and therefore they are not persisted.
+%%
+%% `emqx_retainer' is an example of application that uses this
+%% mechanism.
+%%
+%% This testcase creates the conditions when the transient messages
+%% appear in the middle of the replay, to make sure the durable
+%% session doesn't get confused and/or stuck if retained messages are
+%% changed while the session was down.
+t_transient(Config) ->
+    ConnFun = ?config(conn_fun, Config),
+    TopicPrefix = ?config(topic, Config),
+    ClientId = atom_to_binary(?FUNCTION_NAME),
+    ClientOpts = [
+        {proto_ver, v5},
+        {clientid, ClientId},
+        {properties, #{'Session-Expiry-Interval' => 30, 'Receive-Maximum' => 100}},
+        {max_inflight, 100}
+        | Config
+    ],
+    Deliver = fun(Topic, Payload, QoS) ->
+        [Pid] = emqx_cm:lookup_channels(ClientId),
+        Msg = emqx_message:make(_From = <<"test">>, QoS, Topic, Payload),
+        Pid ! {deliver, Topic, Msg}
+    end,
+    Topic1 = <<TopicPrefix/binary, "/1">>,
+    Topic2 = <<TopicPrefix/binary, "/2">>,
+    Topic3 = <<TopicPrefix/binary, "/3">>,
+    %% 1. Start the client and subscribe to the topic:
+    {ok, Sub} = emqtt:start_link([{clean_start, true}, {auto_ack, never} | ClientOpts]),
+    ?assertMatch({ok, _}, emqtt:ConnFun(Sub)),
+    ?assertMatch({ok, _, _}, emqtt:subscribe(Sub, <<TopicPrefix/binary, "/#">>, qos2)),
+    %% 2. Publish regular messages:
+    publish(Topic1, <<"1">>, ?QOS_1),
+    publish(Topic1, <<"2">>, ?QOS_2),
+    Msgs1 = receive_messages(2),
+    [#{payload := <<"1">>, packet_id := PI1}, #{payload := <<"2">>, packet_id := PI2}] = Msgs1,
+    %% 3. Publish and recieve transient messages:
+    Deliver(Topic2, <<"3">>, ?QOS_0),
+    Deliver(Topic2, <<"4">>, ?QOS_1),
+    Deliver(Topic2, <<"5">>, ?QOS_2),
+    Msgs2 = receive_messages(3),
+    ?assertMatch(
+        [
+            #{payload := <<"3">>, qos := ?QOS_0},
+            #{payload := <<"4">>, qos := ?QOS_1},
+            #{payload := <<"5">>, qos := ?QOS_2}
+        ],
+        Msgs2
+    ),
+    %% 4. Publish more regular messages:
+    publish(Topic3, <<"6">>, ?QOS_1),
+    publish(Topic3, <<"7">>, ?QOS_2),
+    Msgs3 = receive_messages(2),
+    [#{payload := <<"6">>, packet_id := PI6}, #{payload := <<"7">>, packet_id := PI7}] = Msgs3,
+    %% 5. Reconnect the client:
+    ok = emqtt:disconnect(Sub),
+    {ok, Sub1} = emqtt:start_link([{clean_start, false}, {auto_ack, true} | ClientOpts]),
+    ?assertMatch({ok, _}, emqtt:ConnFun(Sub1)),
+    %% 6. Recieve the historic messages and check that their packet IDs didn't change:
+    %% Note: durable session currenty WON'T replay transient messages.
+    ProcessMessage = fun(#{payload := P, packet_id := ID}) -> {ID, P} end,
+    ?assertMatch(
+        #{
+            Topic1 := [{PI1, <<"1">>}, {PI2, <<"2">>}],
+            Topic3 := [{PI6, <<"6">>}, {PI7, <<"7">>}]
+        },
+        maps:groups_from_list(fun get_msgpub_topic/1, ProcessMessage, receive_messages(7, 5_000))
+    ),
+    %% 7. Finish off by sending messages to all the topics to make
+    %% sure none of the streams are blocked:
+    [publish(T, <<"fin">>, ?QOS_2) || T <- [Topic1, Topic2, Topic3]],
+    ?assertMatch(
+        #{
+            Topic1 := [<<"fin">>],
+            Topic2 := [<<"fin">>],
+            Topic3 := [<<"fin">>]
+        },
+        get_topicwise_order(receive_messages(3))
+    ),
+    ok = emqtt:disconnect(Sub1).
+
 t_multiple_subscription_matches(Config) ->
     ConnFun = ?config(conn_fun, Config),
     Topic = ?config(topic, Config),

From 3adbe65a5846e5f241757db39a139e1b05dfea3d Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 8 Feb 2024 17:41:06 +0100
Subject: [PATCH 233/273] refactor(sessds): Unify logic for QoS 1 and 2

---
 apps/emqx/src/emqx_persistent_session_ds.erl | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds.erl b/apps/emqx/src/emqx_persistent_session_ds.erl
index 856210331..7494aca95 100644
--- a/apps/emqx/src/emqx_persistent_session_ds.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds.erl
@@ -907,17 +907,11 @@ do_enqueue_transient(Msg = #message{qos = Qos}, Session = #{inflight := Inflight
         ?QOS_0 ->
             S = S0,
             Inflight = emqx_persistent_session_ds_inflight:push({undefined, Msg}, Inflight0);
-        ?QOS_1 ->
+        QoS when QoS =:= ?QOS_1; QoS =:= ?QOS_2 ->
             SeqNo = inc_seqno(
-                ?QOS_1, emqx_persistent_session_ds_state:get_seqno(?next(?QOS_1), S0)
+                QoS, emqx_persistent_session_ds_state:get_seqno(?next(QoS), S0)
             ),
-            S = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_1), SeqNo, S0),
-            Inflight = emqx_persistent_session_ds_inflight:push({SeqNo, Msg}, Inflight0);
-        ?QOS_2 ->
-            SeqNo = inc_seqno(
-                ?QOS_2, emqx_persistent_session_ds_state:get_seqno(?next(?QOS_2), S0)
-            ),
-            S = emqx_persistent_session_ds_state:put_seqno(?next(?QOS_2), SeqNo, S0),
+            S = emqx_persistent_session_ds_state:put_seqno(?next(QoS), SeqNo, S0),
             Inflight = emqx_persistent_session_ds_inflight:push({SeqNo, Msg}, Inflight0)
     end,
     Session#{

From 0bf7a121e79cc6f355cd75f61e80bcb112c4407f Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Thu, 15 Feb 2024 12:26:45 +0100
Subject: [PATCH 234/273] docs: add change log entry for HStreamDB bridge
 refactoring

---
 changes/ee/feat-12512.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ee/feat-12512.en.md

diff --git a/changes/ee/feat-12512.en.md b/changes/ee/feat-12512.en.md
new file mode 100644
index 000000000..77ea4d2dd
--- /dev/null
+++ b/changes/ee/feat-12512.en.md
@@ -0,0 +1 @@
+The HStreamDB bridge has been split into connector and action components. Old HStreamDB bridges will be upgraded automatically but it is recommended to do the upgrade manually as new fields has been added to the configuration.

From 56d0de8453bbd846d12bf5d16159e945e7fe0718 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Thu, 15 Feb 2024 08:41:38 +0100
Subject: [PATCH 235/273] ci: bump actions versions

---
 .github/actions/prepare-jmeter/action.yaml   |  4 +-
 .github/workflows/_pr_entrypoint.yaml        |  2 +-
 .github/workflows/_push-entrypoint.yaml      |  2 +-
 .github/workflows/build_docker_for_test.yaml |  2 +-
 .github/workflows/build_packages.yaml        | 10 ++---
 .github/workflows/build_packages_cron.yaml   |  8 ++--
 .github/workflows/build_slim_packages.yaml   |  6 +--
 .github/workflows/check_deps_integrity.yaml  |  2 +-
 .github/workflows/performance_test.yaml      | 42 ++++++++++----------
 .github/workflows/release.yaml               |  2 +-
 .github/workflows/run_conf_tests.yaml        |  4 +-
 .github/workflows/run_docker_tests.yaml      |  4 +-
 .github/workflows/run_emqx_app_tests.yaml    |  2 +-
 .github/workflows/run_helm_tests.yaml        |  2 +-
 .github/workflows/run_jmeter_tests.yaml      | 14 +++----
 .github/workflows/run_relup_tests.yaml       | 10 ++---
 .github/workflows/run_test_cases.yaml        | 20 +++++-----
 .github/workflows/scorecard.yaml             |  2 +-
 .github/workflows/spellcheck.yaml            |  2 +-
 .github/workflows/static_checks.yaml         |  4 +-
 .github/workflows/upload-helm-charts.yaml    |  2 +-
 21 files changed, 73 insertions(+), 73 deletions(-)

diff --git a/.github/actions/prepare-jmeter/action.yaml b/.github/actions/prepare-jmeter/action.yaml
index 0d12b1e36..e0c279120 100644
--- a/.github/actions/prepare-jmeter/action.yaml
+++ b/.github/actions/prepare-jmeter/action.yaml
@@ -8,7 +8,7 @@ inputs:
 runs:
   using: composite
   steps:
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-docker
         path: /tmp
@@ -31,7 +31,7 @@ runs:
         architecture: x64 # (x64 or x86) - defaults to x64
         # https://github.com/actions/setup-java/blob/main/docs/switching-to-v2.md
         distribution: 'zulu'
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: apache-jmeter.tgz
     - name: install jmeter
diff --git a/.github/workflows/_pr_entrypoint.yaml b/.github/workflows/_pr_entrypoint.yaml
index f795976f4..b37a31eac 100644
--- a/.github/workflows/_pr_entrypoint.yaml
+++ b/.github/workflows/_pr_entrypoint.yaml
@@ -144,7 +144,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/_push-entrypoint.yaml b/.github/workflows/_push-entrypoint.yaml
index 048c931a5..6c6745eef 100644
--- a/.github/workflows/_push-entrypoint.yaml
+++ b/.github/workflows/_push-entrypoint.yaml
@@ -149,7 +149,7 @@ jobs:
           echo "PROFILE=${PROFILE}" | tee -a .env
           echo "PKG_VSN=$(./pkg-vsn.sh ${PROFILE})" | tee -a .env
           zip -ryq -x@.github/workflows/.zipignore $PROFILE.zip .
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: ${{ matrix.profile }}
           path: ${{ matrix.profile }}.zip
diff --git a/.github/workflows/build_docker_for_test.yaml b/.github/workflows/build_docker_for_test.yaml
index 91e5d64fa..3ac122575 100644
--- a/.github/workflows/build_docker_for_test.yaml
+++ b/.github/workflows/build_docker_for_test.yaml
@@ -57,7 +57,7 @@ jobs:
       - name: export docker image
         run: |
           docker save $_EMQX_DOCKER_IMAGE_TAG | gzip > $EMQX_NAME-docker-$PKG_VSN.tar.gz
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: "${{ env.EMQX_NAME }}-docker"
           path: "${{ env.EMQX_NAME }}-docker-${{ env.PKG_VSN }}.tar.gz"
diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index ce07af0ba..6ed5eafe9 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -95,7 +95,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32 # v3.1.3
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
         name: ${{ matrix.profile }}
@@ -151,7 +151,7 @@ jobs:
         shell: bash
 
     steps:
-    - uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744 # v3.6.0
+    - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
         ref: ${{ github.event.inputs.ref }}
         fetch-depth: 0
@@ -192,7 +192,7 @@ jobs:
           ./scripts/pkg-tests.sh "${PROFILE}-tgz"
           ./scripts/pkg-tests.sh "${PROFILE}-pkg"
         fi
-    - uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32 # v3.1.3
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: ${{ matrix.profile }}
         path: _packages/${{ matrix.profile }}/
@@ -210,7 +210,7 @@ jobs:
         profile:
           - ${{ inputs.profile }}
     steps:
-    - uses: actions/download-artifact@9bc31d5ccc31df68ecc42ccf4149144866c47d8a # v3.0.2
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: ${{ matrix.profile }}
         path: packages/${{ matrix.profile }}
@@ -226,7 +226,7 @@ jobs:
           echo "$(cat $var.sha256) $var" | sha256sum -c || exit 1
         done
         cd -
-    - uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+    - uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
diff --git a/.github/workflows/build_packages_cron.yaml b/.github/workflows/build_packages_cron.yaml
index 5e90be8c4..af969e8f7 100644
--- a/.github/workflows/build_packages_cron.yaml
+++ b/.github/workflows/build_packages_cron.yaml
@@ -66,14 +66,14 @@ jobs:
           set -eu
           ./scripts/pkg-tests.sh "${PROFILE}-tgz"
           ./scripts/pkg-tests.sh "${PROFILE}-pkg"
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: success()
         with:
           name: ${{ matrix.profile[0] }}-${{ matrix.os }}
           path: _packages/${{ matrix.profile[0] }}/
           retention-days: 7
       - name: Send notification to Slack
-        uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+        uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
         if: failure()
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
@@ -111,14 +111,14 @@ jobs:
           apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
           apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
           apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: success()
         with:
           name: ${{ matrix.profile }}-${{ matrix.os }}
           path: _packages/${{ matrix.profile }}/
           retention-days: 7
       - name: Send notification to Slack
-        uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+        uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
         if: failure()
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
diff --git a/.github/workflows/build_slim_packages.yaml b/.github/workflows/build_slim_packages.yaml
index 45dee2b3d..b3b556ba7 100644
--- a/.github/workflows/build_slim_packages.yaml
+++ b/.github/workflows/build_slim_packages.yaml
@@ -88,13 +88,13 @@ jobs:
       run: |
         make ${EMQX_NAME}-elixir-pkg
         ./scripts/pkg-tests.sh ${EMQX_NAME}-elixir-pkg
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: "${{ matrix.profile[0] }}-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: _packages/${{ matrix.profile[0] }}/*
         retention-days: 7
         compression-level: 0
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: "${{ matrix.profile[0] }}-schema-dump-${{ matrix.profile[1] }}-${{ matrix.profile[2] }}-${{ matrix.profile[3] }}-${{ matrix.profile[4] }}"
         path: |
@@ -128,7 +128,7 @@ jobs:
         apple_developer_identity: ${{ secrets.APPLE_DEVELOPER_IDENTITY }}
         apple_developer_id_bundle: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE }}
         apple_developer_id_bundle_password: ${{ secrets.APPLE_DEVELOPER_ID_BUNDLE_PASSWORD }}
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: ${{ matrix.os }}
         path: _packages/**/*
diff --git a/.github/workflows/check_deps_integrity.yaml b/.github/workflows/check_deps_integrity.yaml
index cfe6cfbae..bbbcabf61 100644
--- a/.github/workflows/check_deps_integrity.yaml
+++ b/.github/workflows/check_deps_integrity.yaml
@@ -36,7 +36,7 @@ jobs:
           MIX_ENV: emqx-enterprise
           PROFILE: emqx-enterprise
       - name: Upload produced lock files
-        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+        uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: failure()
         with:
           name: produced_lock_files
diff --git a/.github/workflows/performance_test.yaml b/.github/workflows/performance_test.yaml
index 629e8fcdb..537705697 100644
--- a/.github/workflows/performance_test.yaml
+++ b/.github/workflows/performance_test.yaml
@@ -52,7 +52,7 @@ jobs:
       id: package_file
       run: |
         echo "PACKAGE_FILE=$(find _packages/emqx -name 'emqx-*.deb' | head -n 1 | xargs basename)" >> $GITHUB_OUTPUT
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: emqx-ubuntu20.04
         path: _packages/emqx/${{ steps.package_file.outputs.PACKAGE_FILE }}
@@ -66,7 +66,7 @@ jobs:
 
     steps:
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_PERF_TEST }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_PERF_TEST }}
@@ -77,7 +77,7 @@ jobs:
         repository: emqx/tf-emqx-performance-test
         path: tf-emqx-performance-test
         ref: v0.2.3
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-ubuntu20.04
         path: tf-emqx-performance-test/
@@ -105,7 +105,7 @@ jobs:
         terraform destroy -auto-approve
         aws s3 sync --exclude '*' --include '*.tar.gz' s3://$TF_VAR_s3_bucket_name/$TF_VAR_bench_id .
     - name: Send notification to Slack
-      uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+      uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
       with:
         payload-file-path: "./tf-emqx-performance-test/slack-payload.json"
     - name: terraform destroy
@@ -113,13 +113,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: failure()
       with:
         name: terraform
@@ -137,7 +137,7 @@ jobs:
 
     steps:
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_PERF_TEST }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_PERF_TEST }}
@@ -148,7 +148,7 @@ jobs:
         repository: emqx/tf-emqx-performance-test
         path: tf-emqx-performance-test
         ref: v0.2.3
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-ubuntu20.04
         path: tf-emqx-performance-test/
@@ -176,7 +176,7 @@ jobs:
         terraform destroy -auto-approve
         aws s3 sync --exclude '*' --include '*.tar.gz' s3://$TF_VAR_s3_bucket_name/$TF_VAR_bench_id .
     - name: Send notification to Slack
-      uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+      uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
       with:
         payload-file-path: "./tf-emqx-performance-test/slack-payload.json"
     - name: terraform destroy
@@ -184,13 +184,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: failure()
       with:
         name: terraform
@@ -209,7 +209,7 @@ jobs:
 
     steps:
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_PERF_TEST }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_PERF_TEST }}
@@ -220,7 +220,7 @@ jobs:
         repository: emqx/tf-emqx-performance-test
         path: tf-emqx-performance-test
         ref: v0.2.3
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-ubuntu20.04
         path: tf-emqx-performance-test/
@@ -249,7 +249,7 @@ jobs:
         terraform destroy -auto-approve
         aws s3 sync --exclude '*' --include '*.tar.gz' s3://$TF_VAR_s3_bucket_name/$TF_VAR_bench_id .
     - name: Send notification to Slack
-      uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+      uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
       with:
         payload-file-path: "./tf-emqx-performance-test/slack-payload.json"
     - name: terraform destroy
@@ -257,13 +257,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: failure()
       with:
         name: terraform
@@ -283,7 +283,7 @@ jobs:
 
     steps:
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_PERF_TEST }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_PERF_TEST }}
@@ -294,7 +294,7 @@ jobs:
         repository: emqx/tf-emqx-performance-test
         path: tf-emqx-performance-test
         ref: v0.2.3
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-ubuntu20.04
         path: tf-emqx-performance-test/
@@ -322,7 +322,7 @@ jobs:
         terraform destroy -auto-approve
         aws s3 sync --exclude '*' --include '*.tar.gz' s3://$TF_VAR_s3_bucket_name/$TF_VAR_bench_id .
     - name: Send notification to Slack
-      uses: slackapi/slack-github-action@e28cf165c92ffef168d23c5c9000cffc8a25e117 # v1.24.0
+      uses: slackapi/slack-github-action@6c661ce58804a1a20f6dc5fbee7f0381b469e001 # v1.25.0
       with:
         payload-file-path: "./tf-emqx-performance-test/slack-payload.json"
     - name: terraform destroy
@@ -330,13 +330,13 @@ jobs:
       working-directory: ./tf-emqx-performance-test
       run: |
         terraform destroy -auto-approve
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
         name: metrics
         path: |
           "./tf-emqx-performance-test/*.tar.gz"
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: failure()
       with:
         name: terraform
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 2f441af88..1bed80376 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -31,7 +31,7 @@ jobs:
     strategy:
       fail-fast: false
     steps:
-      - uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      - uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
         with:
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
diff --git a/.github/workflows/run_conf_tests.yaml b/.github/workflows/run_conf_tests.yaml
index 913f4e5a4..e82b29d3d 100644
--- a/.github/workflows/run_conf_tests.yaml
+++ b/.github/workflows/run_conf_tests.yaml
@@ -25,7 +25,7 @@ jobs:
           - emqx
           - emqx-enterprise
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
@@ -40,7 +40,7 @@ jobs:
         if: failure()
         run: |
           cat _build/${{ matrix.profile }}/rel/emqx/logs/erlang.log.*
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: failure()
         with:
           name: conftest-logs-${{ matrix.profile }}
diff --git a/.github/workflows/run_docker_tests.yaml b/.github/workflows/run_docker_tests.yaml
index 7f73d48e8..3e7b7f9f3 100644
--- a/.github/workflows/run_docker_tests.yaml
+++ b/.github/workflows/run_docker_tests.yaml
@@ -37,7 +37,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ env.EMQX_NAME }}-docker
           path: /tmp
@@ -84,7 +84,7 @@ jobs:
           - rlog
     steps:
       - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ env.EMQX_NAME }}-docker
           path: /tmp
diff --git a/.github/workflows/run_emqx_app_tests.yaml b/.github/workflows/run_emqx_app_tests.yaml
index e6326b96c..a1eaca14f 100644
--- a/.github/workflows/run_emqx_app_tests.yaml
+++ b/.github/workflows/run_emqx_app_tests.yaml
@@ -58,7 +58,7 @@ jobs:
         ./rebar3 eunit -v --name 'eunit@127.0.0.1'
         ./rebar3 as standalone_test ct --name 'test@127.0.0.1' -v --readable=true
         ./rebar3 proper -d test/props
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: failure()
       with:
         name: logs-emqx-app-tests
diff --git a/.github/workflows/run_helm_tests.yaml b/.github/workflows/run_helm_tests.yaml
index da4ff0a68..1f6bdb521 100644
--- a/.github/workflows/run_helm_tests.yaml
+++ b/.github/workflows/run_helm_tests.yaml
@@ -45,7 +45,7 @@ jobs:
     - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
         path: source
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: "${{ env.EMQX_NAME }}-docker"
         path: /tmp
diff --git a/.github/workflows/run_jmeter_tests.yaml b/.github/workflows/run_jmeter_tests.yaml
index 14ee999ef..5919cb72d 100644
--- a/.github/workflows/run_jmeter_tests.yaml
+++ b/.github/workflows/run_jmeter_tests.yaml
@@ -16,7 +16,7 @@ jobs:
     steps:
     - name: Cache Jmeter
       id: cache-jmeter
-      uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
+      uses: actions/cache@13aacd865c20de90d75de3b17ebe84f7a17d57d2 # v4.0.0
       with:
         path: /tmp/apache-jmeter.tgz
         key: apache-jmeter-5.4.3.tgz
@@ -35,7 +35,7 @@ jobs:
         else
           wget --no-verbose --no-check-certificate -O /tmp/apache-jmeter.tgz $ARCHIVE_URL
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
         name: apache-jmeter.tgz
         path: /tmp/apache-jmeter.tgz
@@ -86,7 +86,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: always()
       with:
         name: jmeter_logs-advanced_feat-${{ matrix.scripts_type }}
@@ -153,7 +153,7 @@ jobs:
       if: failure()
       run: |
         docker compose -f .ci/docker-compose-file/docker-compose-emqx-cluster.yaml logs --no-color > ./jmeter_logs/emqx.log
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: always()
       with:
         name: jmeter_logs-pgsql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.pgsql_tag }}
@@ -213,7 +213,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: always()
       with:
         name: jmeter_logs-mysql_authn_authz-${{ matrix.scripts_type }}_${{ matrix.mysql_tag }}
@@ -265,7 +265,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: always()
       with:
         name: jmeter_logs-JWT_authn-${{ matrix.scripts_type }}
@@ -309,7 +309,7 @@ jobs:
           echo "check logs failed"
           exit 1
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: always()
       with:
         name: jmeter_logs-built_in_database_authn_authz-${{ matrix.scripts_type }}
diff --git a/.github/workflows/run_relup_tests.yaml b/.github/workflows/run_relup_tests.yaml
index b5016d71c..f626f2c67 100644
--- a/.github/workflows/run_relup_tests.yaml
+++ b/.github/workflows/run_relup_tests.yaml
@@ -25,7 +25,7 @@ jobs:
       run:
         shell: bash
     steps:
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
         name: emqx-enterprise
     - name: extract artifact
@@ -45,7 +45,7 @@ jobs:
       run: |
         export PROFILE='emqx-enterprise'
         make emqx-enterprise-tgz
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       name: Upload built emqx and test scenario
       with:
         name: relup_tests_emqx_built
@@ -72,7 +72,7 @@ jobs:
       run:
         shell: bash
     steps:
-    - uses: erlef/setup-beam@a34c98fd51e370b4d4981854aba1eb817ce4e483 # v1.17.0
+    - uses: erlef/setup-beam@8b9cac4c04dbcd7bf8fd673e16f988225d89b09b # v1.17.2
       with:
         otp-version: 26.2.1
     - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
@@ -88,7 +88,7 @@ jobs:
         ./configure
         make
         echo "$(pwd)/bin" >> $GITHUB_PATH
-    - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+    - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       name: Download built emqx and test scenario
       with:
         name: relup_tests_emqx_built
@@ -111,7 +111,7 @@ jobs:
           docker logs node2.emqx.io | tee lux_logs/emqx2.log
           exit 1
         fi
-    - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+    - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       name: Save debug data
       if: failure()
       with:
diff --git a/.github/workflows/run_test_cases.yaml b/.github/workflows/run_test_cases.yaml
index ca478a381..8480d698c 100644
--- a/.github/workflows/run_test_cases.yaml
+++ b/.github/workflows/run_test_cases.yaml
@@ -41,7 +41,7 @@ jobs:
     container: "ghcr.io/emqx/emqx-builder/${{ matrix.builder }}:${{ matrix.elixir }}-${{ matrix.otp }}-ubuntu22.04"
 
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
@@ -64,7 +64,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}
         run: make proper
 
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.otp }}
           path: _build/test/cover
@@ -83,7 +83,7 @@ jobs:
         shell: bash
 
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
@@ -108,7 +108,7 @@ jobs:
           ENABLE_COVER_COMPILE: 1
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: ./scripts/ct/run.sh --ci --app ${{ matrix.app }}
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -116,7 +116,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
@@ -138,7 +138,7 @@ jobs:
         shell: bash
 
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
@@ -155,7 +155,7 @@ jobs:
           CT_COVER_EXPORT_PREFIX: ${{ matrix.profile }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
         run: |
           make "${{ matrix.app }}-ct"
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: coverdata-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
           path: _build/test/cover
@@ -164,7 +164,7 @@ jobs:
       - name: compress logs
         if: failure()
         run: tar -czf logs.tar.gz _build/test/logs
-      - uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+      - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         if: failure()
         with:
           name: logs-${{ matrix.profile }}-${{ matrix.prefix }}-${{ matrix.otp }}-sg${{ matrix.suitegroup }}
@@ -196,7 +196,7 @@ jobs:
         profile:
           - emqx-enterprise
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
@@ -204,7 +204,7 @@ jobs:
           unzip -o -q ${{ matrix.profile }}.zip
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
 
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         name: download coverdata
         with:
           pattern: coverdata-${{ matrix.profile }}-*
diff --git a/.github/workflows/scorecard.yaml b/.github/workflows/scorecard.yaml
index 7e307b6bf..33311d2ac 100644
--- a/.github/workflows/scorecard.yaml
+++ b/.github/workflows/scorecard.yaml
@@ -39,7 +39,7 @@ jobs:
           publish_results: true
 
       - name: "Upload artifact"
-        uses: actions/upload-artifact@1eb3cb2b3e0f29609092a73eb033bb759a334595 # v4.1.0
+        uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           name: SARIF file
           path: results.sarif
diff --git a/.github/workflows/spellcheck.yaml b/.github/workflows/spellcheck.yaml
index 0517cad41..118ceb2dc 100644
--- a/.github/workflows/spellcheck.yaml
+++ b/.github/workflows/spellcheck.yaml
@@ -19,7 +19,7 @@ jobs:
         - emqx-enterprise
     runs-on: ${{ endsWith(github.repository, '/emqx') && 'ubuntu-22.04' || fromJSON('["self-hosted","ephemeral","linux","x64"]') }}
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           pattern: "${{ matrix.profile }}-schema-dump-*-x64"
           merge-multiple: true
diff --git a/.github/workflows/static_checks.yaml b/.github/workflows/static_checks.yaml
index 96d3e31e9..6168a393b 100644
--- a/.github/workflows/static_checks.yaml
+++ b/.github/workflows/static_checks.yaml
@@ -30,14 +30,14 @@ jobs:
         include: ${{ fromJson(inputs.ct-matrix) }}
     container: "ghcr.io/emqx/emqx-builder/${{ matrix.builder }}:${{ matrix.elixir }}-${{ matrix.otp }}-ubuntu22.04"
     steps:
-      - uses: actions/download-artifact@6b208ae046db98c579e8a3aa621ab581ff575935 # v4.1.1
+      - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
         with:
           name: ${{ matrix.profile }}
       - name: extract artifact
         run: |
           unzip -o -q ${{ matrix.profile }}.zip
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
-      - uses: actions/cache@e12d46a63a90f2fae62d114769bbf2a179198b5c # v3.3.3
+      - uses: actions/cache@13aacd865c20de90d75de3b17ebe84f7a17d57d2 # v4.0.0
         with:
           path: "emqx_dialyzer_${{ matrix.otp }}_plt"
           key: rebar3-dialyzer-plt-${{ matrix.profile }}-${{ matrix.otp }}-${{ hashFiles('rebar.*', 'apps/*/rebar.*') }}
diff --git a/.github/workflows/upload-helm-charts.yaml b/.github/workflows/upload-helm-charts.yaml
index 1125be3a4..378eaca15 100644
--- a/.github/workflows/upload-helm-charts.yaml
+++ b/.github/workflows/upload-helm-charts.yaml
@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
     steps:
-      - uses: aws-actions/configure-aws-credentials@010d0da01d0b5a38af31e9c3470dbfdabdecca3a # v4.0.1
+      - uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
         with:
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

From 9017d6afc3c442e2795487d17a3b55dea3b88fc3 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Thu, 15 Feb 2024 08:42:36 +0100
Subject: [PATCH 236/273] ci: use buildx in build_packages

---
 .github/workflows/build_packages.yaml | 80 +++++++++------------------
 scripts/buildx.sh                     | 12 ++--
 2 files changed, 34 insertions(+), 58 deletions(-)

diff --git a/.github/workflows/build_packages.yaml b/.github/workflows/build_packages.yaml
index 6ed5eafe9..0298acedf 100644
--- a/.github/workflows/build_packages.yaml
+++ b/.github/workflows/build_packages.yaml
@@ -74,12 +74,12 @@ jobs:
       matrix:
         profile:
           - ${{ inputs.profile }}
-        otp:
-          - ${{ inputs.otp_vsn }}
         os:
           - macos-12
           - macos-12-arm64
           - macos-13
+        otp:
+          - ${{ inputs.otp_vsn }}
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
@@ -98,27 +98,17 @@ jobs:
     - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       if: success()
       with:
-        name: ${{ matrix.profile }}
+        name: ${{ matrix.profile }}-${{ matrix.os }}-${{ matrix.otp }}
         path: _packages/${{ matrix.profile }}/
         retention-days: 7
 
   linux:
-    runs-on: [self-hosted, ephemeral, linux, "${{ matrix.arch }}"]
-    # always run in builder container because the host might have the wrong OTP version etc.
-    # otherwise buildx.sh does not run docker if arch and os matches the target arch and os.
-    container:
-      image: "ghcr.io/emqx/emqx-builder/${{ matrix.builder }}:${{ matrix.elixir }}-${{ matrix.otp }}-${{ matrix.os }}"
-
+    runs-on: [self-hosted, ephemeral, linux, "${{ matrix.arch == 'arm64' && 'arm64' || 'x64' }}"]
     strategy:
       fail-fast: false
       matrix:
         profile:
           - ${{ inputs.profile }}
-        otp:
-          - ${{ inputs.otp_vsn }}
-        arch:
-          - x64
-          - arm64
         os:
           - ubuntu22.04
           - ubuntu20.04
@@ -131,20 +121,25 @@ jobs:
           - el7
           - amzn2
           - amzn2023
+        arch:
+          - amd64
+          - arm64
+        with_elixir:
+          - 'no'
+        otp:
+          - ${{ inputs.otp_vsn }}
         builder:
           - ${{ inputs.builder_vsn }}
         elixir:
           - ${{ inputs.elixir_vsn }}
-        with_elixir:
-          - 'no'
         include:
           - profile: ${{ inputs.profile }}
-            otp: ${{ inputs.otp_vsn }}
-            arch: x64
             os: ubuntu22.04
+            arch: amd64
+            with_elixir: 'yes'
+            otp: ${{ inputs.otp_vsn }}
             builder: ${{ inputs.builder_vsn }}
             elixir: ${{ inputs.elixir_vsn }}
-            with_elixir: 'yes'
 
     defaults:
       run:
@@ -155,46 +150,24 @@ jobs:
       with:
         ref: ${{ github.event.inputs.ref }}
         fetch-depth: 0
-
-    - name: fix workdir
-      run: |
-        set -eu
-        git config --global --add safe.directory "$GITHUB_WORKSPACE"
-        # Align path for CMake caches
-        if [ ! "$PWD" = "/emqx" ]; then
-          ln -s $PWD /emqx
-          cd /emqx
-        fi
-        echo "pwd is $PWD"
-
     - name: build emqx packages
       env:
         PROFILE: ${{ matrix.profile }}
+        ARCH: ${{ matrix.arch }}
+        OS: ${{ matrix.os }}
         IS_ELIXIR: ${{ matrix.with_elixir }}
-        ACLOCAL_PATH: "/usr/share/aclocal:/usr/local/share/aclocal"
+        BUILDER: "ghcr.io/emqx/emqx-builder/${{ matrix.builder }}:${{ matrix.elixir }}-${{ matrix.otp }}-${{ matrix.os }}"
+        BUILDER_SYSTEM: force_docker
       run: |
-        set -eu
-        if [ "${IS_ELIXIR:-}" == 'yes' ]; then
-          make "${PROFILE}-elixir-tgz"
-        else
-          make "${PROFILE}-tgz"
-          make "${PROFILE}-pkg"
-        fi
-    - name: test emqx packages
-      env:
-        PROFILE: ${{ matrix.profile }}
-        IS_ELIXIR: ${{ matrix.with_elixir }}
-      run: |
-        set -eu
-        if [ "${IS_ELIXIR:-}" == 'yes' ]; then
-          ./scripts/pkg-tests.sh "${PROFILE}-elixir-tgz"
-        else
-          ./scripts/pkg-tests.sh "${PROFILE}-tgz"
-          ./scripts/pkg-tests.sh "${PROFILE}-pkg"
-        fi
+        ./scripts/buildx.sh \
+          --profile $PROFILE \
+          --arch $ARCH \
+          --builder $BUILDER \
+          --elixir $IS_ELIXIR \
+          --pkgtype pkg
     - uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
       with:
-        name: ${{ matrix.profile }}
+        name: ${{ matrix.profile }}-${{ matrix.os }}-${{ matrix.arch }}${{ matrix.with_elixir == 'yes' && '-elixir' || '' }}-${{ matrix.builder }}-${{ matrix.otp }}-${{ matrix.elixir }}
         path: _packages/${{ matrix.profile }}/
         retention-days: 7
 
@@ -212,8 +185,9 @@ jobs:
     steps:
     - uses: actions/download-artifact@eaceaf801fd36c7dee90939fad912460b18a1ffe # v4.1.2
       with:
-        name: ${{ matrix.profile }}
+        pattern: "${{ matrix.profile }}-*"
         path: packages/${{ matrix.profile }}
+        merge-multiple: true
     - name: install dos2unix
       run: sudo apt-get update -y && sudo apt install -y dos2unix
     - name: get packages
diff --git a/scripts/buildx.sh b/scripts/buildx.sh
index 02afc423b..f0c11ae89 100755
--- a/scripts/buildx.sh
+++ b/scripts/buildx.sh
@@ -101,8 +101,8 @@ elif [[ $(uname -m) == "armv7l" ]]; then
 fi
 ARCH="${ARCH:-${NATIVE_ARCH:-}}"
 
-[ -z "${PROFILE:-}" ] && die "missing --prifile"
-[ -z "${PKGTYPE:-}" ] && die "missing --pkgtyp"
+[ -z "${PROFILE:-}" ] && die "missing --profile"
+[ -z "${PKGTYPE:-}" ] && die "missing --pkgtype"
 [ -z "${BUILDER:-}" ] && die "missing --builder"
 [ -z "${ARCH:-}" ] && die "missing --arch"
 
@@ -135,13 +135,15 @@ else
 fi
 
 HOST_SYSTEM="$(./scripts/get-distro.sh)"
-BUILDER_SYSTEM="$(echo "$BUILDER" | awk -F'-' '{print $NF}')"
+BUILDER_SYSTEM="${BUILDER_SYSTEM:-$(echo "$BUILDER" | awk -F'-' '{print $NF}')}"
 
 CMD_RUN="make ${MAKE_TARGET} && ./scripts/pkg-tests.sh ${MAKE_TARGET}"
 
 IS_NATIVE_SYSTEM='no'
-if [[ "$BUILDER_SYSTEM" == "force_host" ]] || [[ "$BUILDER_SYSTEM" == "$HOST_SYSTEM" ]]; then
-    IS_NATIVE_SYSTEM='yes'
+if [[ "$BUILDER_SYSTEM" != "force_docker" ]]; then
+    if [[ "$BUILDER_SYSTEM" == "force_host" ]] || [[ "$BUILDER_SYSTEM" == "$HOST_SYSTEM" ]]; then
+        IS_NATIVE_SYSTEM='yes'
+    fi
 fi
 
 IS_NATIVE_ARCH='no'

From 5f851058015e7b783e49f4978f1146ab63e2436d Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Thu, 15 Feb 2024 11:54:35 +0100
Subject: [PATCH 237/273] feat(sessds): Specialize the interval queue for
 positive numbers

---
 .../emqx_persistent_session_ds_inflight.erl   | 49 +++++++++----------
 1 file changed, 24 insertions(+), 25 deletions(-)

diff --git a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
index 349713bf6..21194c8c2 100644
--- a/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
+++ b/apps/emqx/src/emqx_persistent_session_ds_inflight.erl
@@ -211,17 +211,17 @@ pubrec(SeqNo, Rec = #inflight{pubrec_queue = Q0}) ->
 %%%% Interval queue:
 
 %% "Interval queue": a data structure that represents a queue of
-%% monotonically increasing integers in a compact manner. It is
-%% functionally equivalent to a `queue:queue(integer())'.
+%% monotonically increasing non-negative integers in a compact manner.
+%% It is functionally equivalent to a `queue:queue(integer())'.
 -record(iqueue, {
     %% Head interval:
-    head :: integer() | undefined,
-    head_end :: integer() | undefined,
+    head = 0 :: integer(),
+    head_end = 0 :: integer(),
     %% Intermediate ranges:
     queue :: queue:queue({integer(), integer()}),
     %% End interval:
-    tail :: integer() | undefined,
-    tail_end :: integer() | undefined
+    tail = 0 :: integer(),
+    tail_end = 0 :: integer()
 }).
 
 -type iqueue() :: #iqueue{}.
@@ -233,17 +233,20 @@ iqueue_new() ->
 
 %% @doc Push a value into the interval queue:
 -spec ipush(integer(), iqueue()) -> iqueue().
-ipush(Val, Q = #iqueue{tail = undefined, tail_end = undefined}) ->
+ipush(Val, Q = #iqueue{tail_end = Val, head_end = Val}) ->
+    %% Optimization: head and tail intervals overlap, and the newly
+    %% inserted value extends both. Attach it to both intervals, to
+    %% avoid `queue:out' in `ipop':
     Q#iqueue{
-        tail = Val,
-        tail_end = Val + 1
+        tail_end = Val + 1,
+        head_end = Val + 1
     };
 ipush(Val, Q = #iqueue{tail_end = Val}) ->
     %% Extend tail interval:
     Q#iqueue{
         tail_end = Val + 1
     };
-ipush(Val, Q = #iqueue{tail = Tl, tail_end = End, queue = IQ0}) when Val > End ->
+ipush(Val, Q = #iqueue{tail = Tl, tail_end = End, queue = IQ0}) when is_number(Val), Val > End ->
     IQ = queue:in({Tl, End}, IQ0),
     %% Begin a new interval:
     Q#iqueue{
@@ -253,28 +256,24 @@ ipush(Val, Q = #iqueue{tail = Tl, tail_end = End, queue = IQ0}) when Val > End -
     }.
 
 -spec ipop(iqueue()) -> {{value, integer()}, iqueue()} | {empty, iqueue()}.
-ipop(Q = #iqueue{head = Hd, head_end = HdEnd}) when is_number(HdEnd), Hd < HdEnd ->
+ipop(Q = #iqueue{head = Hd, head_end = HdEnd}) when Hd < HdEnd ->
+    %% Head interval is not empty. Consume a value from it:
     {{value, Hd}, Q#iqueue{head = Hd + 1}};
+ipop(Q = #iqueue{head_end = End, tail_end = End}) ->
+    %% Head interval is fully consumed, and it's overlaps with the
+    %% tail interval. It means the queue is empty:
+    {empty, Q};
 ipop(Q = #iqueue{head = Hd0, tail = Tl, tail_end = TlEnd, queue = IQ0}) ->
+    %% Head interval is fully consumed, and it doesn't overlap with
+    %% the tail interval. Replace the head interval with the next
+    %% interval from the queue or with the tail interval:
     case queue:out(IQ0) of
         {{value, {Hd, HdEnd}}, IQ} ->
-            ipop(Q#iqueue{head = nmax(Hd0, Hd), head_end = HdEnd, queue = IQ});
+            ipop(Q#iqueue{head = max(Hd0, Hd), head_end = HdEnd, queue = IQ});
         {empty, _} ->
-            do_ipop(Q#iqueue{head = nmax(Hd0, Tl), head_end = TlEnd})
+            ipop(Q#iqueue{head = max(Hd0, Tl), head_end = TlEnd})
     end.
 
-do_ipop(Q = #iqueue{head = Hd, head_end = HdEnd}) when is_number(HdEnd), Hd < HdEnd ->
-    {{value, Hd}, Q#iqueue{head = Hd + 1}};
-do_ipop(Q) ->
-    {empty, Q}.
-
-nmax(undefined, N) ->
-    N;
-nmax(N, undefined) ->
-    N;
-nmax(N, M) ->
-    max(N, M).
-
 -ifdef(TEST).
 
 %% Test that behavior of iqueue is identical to that of a regular queue of integers:

From 342784b237bb3f0617b31338064b379144b5bc0c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 15 Feb 2024 16:33:50 +0000
Subject: [PATCH 238/273] chore(deps): bump the actions group with 1 update

Updates the requirements on [github/codeql-action](https://github.com/github/codeql-action) to permit the latest version.

Updates `github/codeql-action` to 7e187e1c529d80bac7b87a16e7a792427f65cf02
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/commits/7e187e1c529d80bac7b87a16e7a792427f65cf02)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/scorecard.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/scorecard.yaml b/.github/workflows/scorecard.yaml
index 33311d2ac..ee69835b5 100644
--- a/.github/workflows/scorecard.yaml
+++ b/.github/workflows/scorecard.yaml
@@ -47,6 +47,6 @@ jobs:
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@8e0b1c74b1d5a0077b04d064c76ee714d3da7637 # v2.22.1
+        uses: github/codeql-action/upload-sarif@7e187e1c529d80bac7b87a16e7a792427f65cf02 # v2.22.1
         with:
           sarif_file: results.sarif

From 1488b0118ca2bd4771362259dd14cee0c500b7c8 Mon Sep 17 00:00:00 2001
From: Ivan Dyachkov <dev@dyachkov.org>
Date: Thu, 15 Feb 2024 17:55:20 +0100
Subject: [PATCH 239/273] chore: add OpenSSF Scorecard badge to README

---
 README-CN.md | 1 +
 README-RU.md | 1 +
 README.md    | 1 +
 3 files changed, 3 insertions(+)

diff --git a/README-CN.md b/README-CN.md
index 84a72912d..c2c5e80f4 100644
--- a/README-CN.md
+++ b/README-CN.md
@@ -4,6 +4,7 @@
 [![Build Status](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml/badge.svg)](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml)
 [![Coverage Status](https://img.shields.io/coveralls/github/emqx/emqx/master?label=Coverage)](https://coveralls.io/github/emqx/emqx?branch=master)
 [![Docker Pulls](https://img.shields.io/docker/pulls/emqx/emqx?label=Docker%20Pulls)](https://hub.docker.com/r/emqx/emqx)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/emqx/emqx/badge)](https://securityscorecards.dev/viewer/?uri=github.com/emqx/emqx)
 [![Slack](https://img.shields.io/badge/Slack-EMQ-39AE85?logo=slack)](https://slack-invite.emqx.io/)
 [![Discord](https://img.shields.io/discord/931086341838622751?label=Discord&logo=discord)](https://discord.gg/xYGf3fQnES)
 [![Twitter](https://img.shields.io/badge/Twitter-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)
diff --git a/README-RU.md b/README-RU.md
index 9f8347e2b..45bf08102 100644
--- a/README-RU.md
+++ b/README-RU.md
@@ -4,6 +4,7 @@
 [![Build Status](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml/badge.svg)](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml)
 [![Coverage Status](https://img.shields.io/coveralls/github/emqx/emqx/master?label=Coverage)](https://coveralls.io/github/emqx/emqx?branch=master)
 [![Docker Pulls](https://img.shields.io/docker/pulls/emqx/emqx?label=Docker%20Pulls)](https://hub.docker.com/r/emqx/emqx)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/emqx/emqx/badge)](https://securityscorecards.dev/viewer/?uri=github.com/emqx/emqx)
 [![Slack](https://img.shields.io/badge/Slack-EMQ-39AE85?logo=slack)](https://slack-invite.emqx.io/)
 [![Discord](https://img.shields.io/discord/931086341838622751?label=Discord&logo=discord)](https://discord.gg/xYGf3fQnES)
 [![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)
diff --git a/README.md b/README.md
index 622cbfc99..ad710b5e6 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,7 @@
 [![Build Status](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml/badge.svg)](https://github.com/emqx/emqx/actions/workflows/_push-entrypoint.yaml)
 [![Coverage Status](https://img.shields.io/coveralls/github/emqx/emqx/master?label=Coverage)](https://coveralls.io/github/emqx/emqx?branch=master)
 [![Docker Pulls](https://img.shields.io/docker/pulls/emqx/emqx?label=Docker%20Pulls)](https://hub.docker.com/r/emqx/emqx)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/emqx/emqx/badge)](https://securityscorecards.dev/viewer/?uri=github.com/emqx/emqx)
 [![Slack](https://img.shields.io/badge/Slack-EMQ-39AE85?logo=slack)](https://slack-invite.emqx.io/)
 [![Discord](https://img.shields.io/discord/931086341838622751?label=Discord&logo=discord)](https://discord.gg/xYGf3fQnES)
 [![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)

From b24321a8fc447526c200f5190269fb0e0e6480b5 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Wed, 14 Feb 2024 19:54:06 +0100
Subject: [PATCH 240/273] feat: upgrade to hocon-0.41.0

hocon 0.41.0 added support for multiline string indentation.
now there is no need to escape (unless there is backslash)
quotes and line feeds etc.
---
 apps/emqx/rebar.config      |  2 +-
 changes/ce/feat-12517.en.md | 15 +++++++++++++++
 mix.exs                     |  2 +-
 rebar.config                |  2 +-
 4 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 changes/ce/feat-12517.en.md

diff --git a/apps/emqx/rebar.config b/apps/emqx/rebar.config
index 3626d0858..9953dd3fc 100644
--- a/apps/emqx/rebar.config
+++ b/apps/emqx/rebar.config
@@ -30,7 +30,7 @@
     {esockd, {git, "https://github.com/emqx/esockd", {tag, "5.11.1"}}},
     {ekka, {git, "https://github.com/emqx/ekka", {tag, "0.18.4"}}},
     {gen_rpc, {git, "https://github.com/emqx/gen_rpc", {tag, "3.3.1"}}},
-    {hocon, {git, "https://github.com/emqx/hocon.git", {tag, "0.40.4"}}},
+    {hocon, {git, "https://github.com/emqx/hocon.git", {tag, "0.41.0"}}},
     {emqx_http_lib, {git, "https://github.com/emqx/emqx_http_lib.git", {tag, "0.5.3"}}},
     {pbkdf2, {git, "https://github.com/emqx/erlang-pbkdf2.git", {tag, "2.0.4"}}},
     {recon, {git, "https://github.com/ferd/recon", {tag, "2.5.1"}}},
diff --git a/changes/ce/feat-12517.en.md b/changes/ce/feat-12517.en.md
new file mode 100644
index 000000000..b26e3edc8
--- /dev/null
+++ b/changes/ce/feat-12517.en.md
@@ -0,0 +1,15 @@
+Congifuration files now support multi-line string values with indentation.
+
+Introduced the `"""~` and `~"""` to quote indented lines. For example:
+
+```
+rule_xlu4 {
+  sql = """~
+    SELECT
+      *
+    FROM
+      "t/#"
+  ~"""
+}
+```
+See [HOCON 0.41.0](https://github.com/emqx/hocon/releases/tag/0.41.0) release note for more dtails.
diff --git a/mix.exs b/mix.exs
index c2ef491e9..3cfd1326d 100644
--- a/mix.exs
+++ b/mix.exs
@@ -72,7 +72,7 @@ defmodule EMQXUmbrella.MixProject do
       # in conflict by emqtt and hocon
       {:getopt, "1.0.2", override: true},
       {:snabbkaffe, github: "kafka4beam/snabbkaffe", tag: "1.0.8", override: true},
-      {:hocon, github: "emqx/hocon", tag: "0.40.4", override: true},
+      {:hocon, github: "emqx/hocon", tag: "0.41.0", override: true},
       {:emqx_http_lib, github: "emqx/emqx_http_lib", tag: "0.5.3", override: true},
       {:esasl, github: "emqx/esasl", tag: "0.2.0"},
       {:jose, github: "potatosalad/erlang-jose", tag: "1.11.2"},
diff --git a/rebar.config b/rebar.config
index 5ebe9da15..88b32483e 100644
--- a/rebar.config
+++ b/rebar.config
@@ -97,7 +97,7 @@
     {system_monitor, {git, "https://github.com/ieQu1/system_monitor", {tag, "3.0.3"}}},
     {getopt, "1.0.2"},
     {snabbkaffe, {git, "https://github.com/kafka4beam/snabbkaffe.git", {tag, "1.0.8"}}},
-    {hocon, {git, "https://github.com/emqx/hocon.git", {tag, "0.40.4"}}},
+    {hocon, {git, "https://github.com/emqx/hocon.git", {tag, "0.41.0"}}},
     {emqx_http_lib, {git, "https://github.com/emqx/emqx_http_lib.git", {tag, "0.5.3"}}},
     {esasl, {git, "https://github.com/emqx/esasl", {tag, "0.2.0"}}},
     {jose, {git, "https://github.com/potatosalad/erlang-jose", {tag, "1.11.2"}}},

From a389d78b421474c6d685711a968048904f9c698a Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Wed, 14 Feb 2024 20:32:42 +0100
Subject: [PATCH 241/273] chore: delete stale code

---
 apps/emqx_conf/src/emqx_conf.erl |  22 ---
 rel/emqx_conf.template.en.md     | 329 -------------------------------
 rel/emqx_conf.template.zh.md     | 306 ----------------------------
 3 files changed, 657 deletions(-)
 delete mode 100644 rel/emqx_conf.template.en.md
 delete mode 100644 rel/emqx_conf.template.zh.md

diff --git a/apps/emqx_conf/src/emqx_conf.erl b/apps/emqx_conf/src/emqx_conf.erl
index 0a8339ddd..0df5711e0 100644
--- a/apps/emqx_conf/src/emqx_conf.erl
+++ b/apps/emqx_conf/src/emqx_conf.erl
@@ -158,7 +158,6 @@ dump_schema(Dir, SchemaModule) ->
     ok = emqx_dashboard_desc_cache:init(),
     lists:foreach(
         fun(Lang) ->
-            ok = gen_config_md(Dir, SchemaModule, Lang),
             ok = gen_schema_json(Dir, SchemaModule, Lang)
         end,
         ["en", "zh"]
@@ -468,14 +467,6 @@ bridge_schema_json() ->
     SchemaInfo = #{title => <<"EMQX Data Bridge API Schema">>, version => Version},
     gen_api_schema_json_iodata(emqx_bridge_api, SchemaInfo).
 
-%% TODO: remove it and also remove hocon_md.erl and friends.
-%% markdown generation from schema is a failure and we are moving to an interactive
-%% viewer like swagger UI.
-gen_config_md(Dir, SchemaModule, Lang) ->
-    SchemaMdFile = filename:join([Dir, "config-" ++ Lang ++ ".md"]),
-    io:format(user, "===< Generating: ~s~n", [SchemaMdFile]),
-    ok = gen_doc(SchemaMdFile, SchemaModule, Lang).
-
 %% @doc return the root schema module.
 -spec schema_module() -> module().
 schema_module() ->
@@ -515,19 +506,6 @@ make_desc_resolver(Lang) ->
             unicode:characters_to_binary(Desc)
     end.
 
--spec gen_doc(file:name_all(), module(), string()) -> ok.
-gen_doc(File, SchemaModule, Lang) ->
-    Version = emqx_release:version(),
-    Title =
-        "# " ++ emqx_release:description() ++ " Configuration\n\n" ++
-            "<!--" ++ Version ++ "-->",
-    BodyFile = filename:join([rel, "emqx_conf.template." ++ Lang ++ ".md"]),
-    {ok, Body} = file:read_file(BodyFile),
-    Resolver = make_desc_resolver(Lang),
-    Opts = #{title => Title, body => Body, desc_resolver => Resolver},
-    Doc = hocon_schema_md:gen(SchemaModule, Opts),
-    file:write_file(File, Doc).
-
 gen_api_schema_json_iodata(SchemaMod, SchemaInfo) ->
     emqx_dashboard_swagger:gen_api_schema_json_iodata(
         SchemaMod,
diff --git a/rel/emqx_conf.template.en.md b/rel/emqx_conf.template.en.md
deleted file mode 100644
index 2dcb83896..000000000
--- a/rel/emqx_conf.template.en.md
+++ /dev/null
@@ -1,329 +0,0 @@
-EMQX configuration files are in [HOCON](https://github.com/emqx/hocon) format.
-HOCON, or Human-Optimized Config Object Notation is a format for human-readable data,
-and a superset of JSON.
-
-## Layered
-
-EMQX configuration consists of two layers.
-From bottom up:
-
-1. Cluster-synced configs: `$EMQX_NODE__DATA_DIR/configs/cluster.hocon`.
-2. Local node configs: `emqx.conf` + `EMQX_` prefixed environment variables.
-
-:::tip Tip
-Prior to v5.0.23 and e5.0.3, the cluster-synced configs are stored in
-`cluster-override.conf` which is applied on top of the local configs.
-
-If upgraded from an earlier version, as long as `cluster-override.conf` exists,
-`cluster.hocon` will not be created, and `cluster-override.conf` will stay on
-top of the overriding layers.
-:::
-
-When environment variable `$EMQX_NODE__DATA_DIR` is not set, config `node.data_dir`
-is used.
-
-The `cluster.hocon` file is overwritten at runtime when changes
-are made from Dashboard, management HTTP API, or CLI. When clustered,
-after EMQX restarts, it copies the file from the node which has the greatest `uptime`.
-
-:::tip Tip
-To avoid confusion, don't add the same keys in both `cluster.hocon` and `emqx.conf`.
-:::
-
-For detailed override rules, see [Config Overlay Rules](#config-overlay-rules).
-
-## Syntax
-
-In config file the values can be notated as JSON like objects, such as
-```
-node {
-    name = "emqx@127.0.0.1"
-    cookie = "mysecret"
-}
-```
-
-Another equivalent representation is flat, such as
-
-```
-node.name = "127.0.0.1"
-node.cookie = "mysecret"
-```
-
-This flat format is almost backward compatible with EMQX's config file format
-in 4.x series (the so called 'cuttlefish' format).
-
-It is not fully compatible because the often HOCON requires strings to be quoted,
-while cuttlefish treats all characters to the right of the `=` mark as the value.
-
-e.g. cuttlefish: `node.name = emqx@127.0.0.1`, HOCON: `node.name = "emqx@127.0.0.1"`.
-
-Strings without special characters in them can be unquoted in HOCON too,
-e.g. `foo`, `foo_bar` and `foo_bar_1`.
-
-For more HOCON syntax, please refer to the [specification](https://github.com/lightbend/config/blob/main/HOCON.md)
-
-## Schema
-
-To make the HOCON objects type-safe, EMQX introduced a schema for it.
-The schema defines data types, and data fields' names and metadata for config value validation
-and more.
-
-::: tip Tip
-The configuration document you are reading now is generated from schema metadata.
-:::
-
-### Complex Data Types
-
-There are 4 complex data types in EMQX's HOCON config:
-
-1. Struct: Named using an unquoted string, followed by a predefined list of fields.
-   Only lowercase letters and digits are allowed in struct and field names.
-   Alos, only underscore can be used as word separator.
-1. Map: Map is like Struct, however the fields are not predefined.
-1. Union: `MemberType1 | MemberType2 | ...`
-1. Array: `[ElementType]`
-
-::: tip Tip
-If map field name is a positive integer number, it is interpreted as an alternative representation of an `Array`.
-For example:
-```
-myarray.1 = 74
-myarray.2 = 75
-```
-will be interpreated as `myarray = [74, 75]`, which is handy when trying to override array elements.
-:::
-
-### Primitive Data Types
-
-Complex types define data 'boxes' which may contain other complex data
-or primitive values.
-There are quite some different primitive types, to name a few:
-
-* `atom()`.
-* `boolean()`.
-* `string()`.
-* `integer()`.
-* `float()`.
-* `number()`.
-* `binary()`, another format of string().
-* `emqx_schema:duration()`, time duration, another format of integer()
-* ...
-
-::: tip Tip
-The primitive types are mostly self-describing, so there is usually not a lot to document.
-For types that are not so clear by their names, the field description is to be used to find the details.
-:::
-
-### Config Paths
-
-If we consider the whole EMQX config as a tree,
-to reference a primitive value, we can use a dot-separated names form string for
-the path from the tree-root (always a Struct) down to the primitive values at tree-leaves.
-
-Each segment of the dotted string is a Struct field name or Map key.
-For Array elements, 1-based index is used.
-
-below are some examples
-
-```
-node.name = "emqx.127.0.0.1"
-zone.zone1.max_packet_size = "10M"
-authentication.1.enable = true
-```
-
-### Environment variables
-
-Environment variables can be used to define or override config values.
-
-Due to the fact that dots (`.`) are not allowed in environment variables, dots are
-replaced with double-underscores (`__`).
-
-And the `EMQX_` prefix is used as the namespace.
-
-For example `node.name` can be represented as `EMQX_NODE__NAME`
-
-Environment variable values are parsed as HOCON values, this allows users
-to even set complex values from environment variables.
-
-For example, this environment variable sets an array value.
-
-```
-export EMQX_LISTENERS__SSL__L1__AUTHENTICATION__SSL__CIPHERS='["TLS_AES_256_GCM_SHA384"]'
-```
-However, this also means a string value should be quoted if it happens to contain special
-characters such as `=` and `:`.
-
-For example, a string value `"localhost:1883"` would be
-parsed into object (struct): `{"localhost": 1883}`.
-
-To keep it as a string, one should quote the value like below:
-
-```
-EMQX_BRIDGES__MQTT__MYBRIDGE__CONNECTOR_SERVER='"localhost:1883"'
-```
-
-::: tip Tip
-Unknown root paths are silently discarded by EMQX, for example `EMQX_UNKNOWN_ROOT__FOOBAR` is
-silently discarded because `unknown_root` is not a predefined root path.
-
-Unknown field names in environment variables are logged as a `warning` level log, for example:
-
-```
-[warning] unknown_env_vars: ["EMQX_AUTHENTICATION__ENABLED"]
-```
-
-because the field name is `enable`, not `enabled`.
-:::
-
-
-### Config Overlay Rules
-
-HOCON objects are overlaid, in general:
-
-- Within one file, objects defined 'later' recursively override objects defined 'earlier'
-- When layered, 'later' (higher layer) objects override objects defined 'earlier' (lower layer)
-
-Below are more detailed rules.
-
-#### Struct Fields
-
-Later config values overwrites earlier values.
-For example, in below config, the last line `debug` overwrites `error` for
-console log handler's `level` config, but leaving `enable` unchanged.
-```
-log {
-    console_handler{
-        enable=true,
-        level=error
-    }
-}
-
-## ... more configs ...
-
-log.console_handler.level=debug
-```
-
-#### Map Values
-
-Maps are like structs, only the files are user-defined rather than
-the config schema. For instance, `zone1` in the example below.
-
-```
-zone {
-    zone1 {
-        mqtt.max_packet_size = 1M
-    }
-}
-
-## The maximum packet size can be defined as above,
-## then overridden as below
-
-zone.zone1.mqtt.max_packet_size = 10M
-```
-
-#### Array Elements
-
-Arrays in EMQX config have two different representations
-
-* list, such as: `[1, 2, 3]`
-* indexed-map, such as: `{"1"=1, "2"=2, "3"=3}`
-
-Dot-separated paths with number in it are parsed to indexed-maps
-e.g. `authentication.1={...}` is parsed as `authentication={"1": {...}}`
-
-This feature makes it easy to override array element values. For example:
-
-```
-authentication=[{enable=true, backend="built_in_database", mechanism="password_based"}]
-# we can disable this authentication provider with:
-authentication.1.enable=false
-```
-
-::: warning Warning
-List arrays is a full-array override, but not a recursive merge, into indexed-map arrays.
-e.g.
-
-```
-authentication=[{enable=true, backend="built_in_database", mechanism="password_based"}]
-## below value will replace the whole array, but not to override just one field.
-authentication=[{enable=true}]
-```
-:::
-
-#### TLS/SSL ciphers
-
-Starting from v5.0.6, EMQX no longer pre-populates the ciphers list with a default
-set of cipher suite names.
-Instead, the default ciphers are applied at runtime when starting the listener
-for servers, or when establishing a TLS connection as a client.
-
-Below are the default ciphers selected by EMQX.
-
-For tlsv1.3:
-```
-ciphers =
-  [ "TLS_AES_256_GCM_SHA384", "TLS_AES_128_GCM_SHA256",
-    "TLS_CHACHA20_POLY1305_SHA256", "TLS_AES_128_CCM_SHA256",
-    "TLS_AES_128_CCM_8_SHA256"
-  ]
-```
-
-For tlsv1.2 or earlier
-
-```
-ciphers =
-  [ "ECDHE-ECDSA-AES256-GCM-SHA384",
-    "ECDHE-RSA-AES256-GCM-SHA384",
-    "ECDHE-ECDSA-AES256-SHA384",
-    "ECDHE-RSA-AES256-SHA384",
-    "ECDH-ECDSA-AES256-GCM-SHA384",
-    "ECDH-RSA-AES256-GCM-SHA384",
-    "ECDH-ECDSA-AES256-SHA384",
-    "ECDH-RSA-AES256-SHA384",
-    "DHE-DSS-AES256-GCM-SHA384",
-    "DHE-DSS-AES256-SHA256",
-    "AES256-GCM-SHA384",
-    "AES256-SHA256",
-    "ECDHE-ECDSA-AES128-GCM-SHA256",
-    "ECDHE-RSA-AES128-GCM-SHA256",
-    "ECDHE-ECDSA-AES128-SHA256",
-    "ECDHE-RSA-AES128-SHA256",
-    "ECDH-ECDSA-AES128-GCM-SHA256",
-    "ECDH-RSA-AES128-GCM-SHA256",
-    "ECDH-ECDSA-AES128-SHA256",
-    "ECDH-RSA-AES128-SHA256",
-    "DHE-DSS-AES128-GCM-SHA256",
-    "DHE-DSS-AES128-SHA256",
-    "AES128-GCM-SHA256",
-    "AES128-SHA256",
-    "ECDHE-ECDSA-AES256-SHA",
-    "ECDHE-RSA-AES256-SHA",
-    "DHE-DSS-AES256-SHA",
-    "ECDH-ECDSA-AES256-SHA",
-    "ECDH-RSA-AES256-SHA",
-    "ECDHE-ECDSA-AES128-SHA",
-    "ECDHE-RSA-AES128-SHA",
-    "DHE-DSS-AES128-SHA",
-    "ECDH-ECDSA-AES128-SHA",
-    "ECDH-RSA-AES128-SHA"
-  ]
-```
-
-For PSK enabled listeners
-
-```
-ciphers =
-  [ "RSA-PSK-AES256-GCM-SHA384",
-    "RSA-PSK-AES256-CBC-SHA384",
-    "RSA-PSK-AES128-GCM-SHA256",
-    "RSA-PSK-AES128-CBC-SHA256",
-    "RSA-PSK-AES256-CBC-SHA",
-    "RSA-PSK-AES128-CBC-SHA",
-    "PSK-AES256-GCM-SHA384",
-    "PSK-AES128-GCM-SHA256",
-    "PSK-AES256-CBC-SHA384",
-    "PSK-AES256-CBC-SHA",
-    "PSK-AES128-CBC-SHA256",
-    "PSK-AES128-CBC-SHA"
-  ]
-```
diff --git a/rel/emqx_conf.template.zh.md b/rel/emqx_conf.template.zh.md
deleted file mode 100644
index a9df27f63..000000000
--- a/rel/emqx_conf.template.zh.md
+++ /dev/null
@@ -1,306 +0,0 @@
-EMQX的配置文件格式是 [HOCON](https://github.com/emqx/hocon) 。
-HOCON（Human-Optimized Config Object Notation）是一个JSON的超集，非常适用于易于人类读写的配置数据存储。
-
-## 分层结构
-
-EMQX的配置文件可分为二层，自底向上依次是：
-
-1. 集群同步配置：`$EMQX_NODE__DATA_DIR/configs/cluster.hocon`。
-2. 本地节点配置：`emqx.conf` 加上 `EMQX_` 前缀的环境变量。
-
-:::tip Tip
-在 v5.0.23 或 e5.0.3 之前，集群同步配置保存在文件 `cluster-override.conf` 中，并且它覆盖在配置的最上层。
-
-如果从之前的版本升级上来，只要 `cluster-override.conf` 文件存在，
-EMQX 就不会创建 `cluster.hocon`，并且 `cluster-override.conf` 会继续覆盖在配置的最上层。
-:::
-
-如果环境变量 `$EMQX_NODE__DATA_DIR` 没有设置，那么该目录会从 `emqx.conf` 的 `node.data_dir` 配置中读取。
-
-配置文件 `cluster.hocon` 的内容会在运行时被EMQX重写。
-这些重写发生在 dashboard UI，管理HTTP API，或者CLI对集群配置进行修改时。
-当EMQX运行在集群中时，一个EMQX节点重启之后，会从集群中其他节点复制该文件内容到本地。
-
-:::tip Tip
-为避免歧义，应尽量避免让 `cluster.hocon` 和 `emqx.conf` 出现配置交集。
-:::
-
-更多的重载规则，请参考下文 [配置重载规则](#配置重载规则)。
-
-## 配置文件语法
-
-在配置文件中，值可以被记为类似JSON的对象，例如
-
-```
-node {
-    name = "emqx@127.0.0.1"
-    cookie = "mysecret"
-}
-```
-
-另一种等价的表示方法是扁平的，例如
-
-```
-node.name = "127.0.0.1"
-node.cookie = "mysecret"
-```
-
-这种扁平格式几乎与EMQX的配置文件格式向后兼容
-在4.x系列中（所谓的'cuttlefish'格式）。
-
-它并不是完全兼容，因为HOCON经常要求字符串两端加上引号。
-而cuttlefish把`=`符右边的所有字符都视为值。
-
-例如，cuttlefish：`node.name = emqx@127.0.0.1`，HOCON：`node.name = "emqx@127.0.0.1"`。
-
-没有特殊字符的字符串在HOCON中也可以不加引号。
-例如：`foo`，`foo_bar`和`foo_bar_1`。
-
-关于更多的HOCON语法，请参考[规范](https://github.com/lightbend/config/blob/main/HOCON.md)
-
-## Schema
-
-为了使HOCON对象类型安全，EMQX为它引入了一个schema。
-该schema定义了数据类型，以及数据字段的名称和元数据，用于配置值的类型检查等等。
-
-::: tip Tip
-当前阅读到配置文件的文档本身就是由模式元数据生成的。
-:::
-
-### 复杂数据类型
-
-EMQX的配置文件中，有4中复杂数据结构类型，它们分别是：
-
-1. Struct：结构体都是有类型名称的，结构体中可以有任意多个字段。
-   结构体和字段的名称由不带特殊字符的全小些字母组成，名称中可以带数字，但不得以数字开头，多个单词可用下划线分隔。
-1. Map: Map 与 Struct（结构体）类似，但是内部的字段不是预先定义好的。
-1. Union: 联合 `MemberType1 | MemberType2 | ...`，可以理解为：“不是这个，就是那个”
-1. Array: 数组 `[ElementType]`
-
-::: tip Tip
-如果Map的字段名称是纯数字，它会被解释成一个数组。
-例如
-```
-myarray.1 = 74
-myarray.2 = 75
-```
-会被解析成 `myarray = [74, 75]`。这个用法在重载数组元素的值时候非常有用。
-:::
-
-### 原始数据类型
-
-复杂类型定义了数据 "盒子"，其中可能包含其他复杂数据或原始值。
-有很多不同的原始类型，仅举几个例子。
-
-* 原子 `atom()`。
-* 布尔 `boolean()`。
-* 字符串 `string()`。
-* 整形 `integer()`。
-* 浮点数 `float()`。
-* 数值 `number()`。
-* 二进制编码的字符串 `binary()` 是 `string()` 的另一种格式。
-* 时间间隔 `emqx_schema:duration()` 是 `integer()` 的另一种格式。
-* ...
-
-::: tip Tip
-原始类型的名称大多是自我描述的，所以不需要过多的注释。
-但是有一些不是那么直观的数据类型，则需要配合字段的描述文档进行理解。
-:::
-
-
-### 配置路径
-
-如果我们把EMQX的配置值理解成一个类似目录树的结构，那么类似于文件系统中使用斜杠或反斜杠进行层级分割，
-EMQX使用的配置路径的层级分割符是 `'.'`
-
-被 `'.'` 号分割的每一段，则是 Struct（结构体）的字段，或 Map 的 key。
-
-下面有几个例子：
-
-```
-node.name = "emqx.127.0.0.1"
-zone.zone1.max_packet_size = "10M"
-authentication.1.enable = true
-```
-
-### 环境变量重载
-
-因为 `'.'`  分隔符不能使用于环境变量，所以我们需要使用另一个分割符。EMQX选用的是双下划线 `__`。
-为了与其他的环境变量有所区分，EMQX还增加了一个前缀 `EMQX_` 来用作环境变量命名空间。
-
-例如 `node.name` 的重载变量名是 `EMQX_NODE__NAME`。
-
-环境变量的值，是按 HOCON 值解析的，这也使得环境变量可以用来传递复杂数据类型的值。
-
-例如，下面这个环境变量传入一个数组类型的值。
-
-```
-export EMQX_LISTENERS__SSL__L1__AUTHENTICATION__SSL__CIPHERS='["TLS_AES_256_GCM_SHA384"]'
-```
-
-这也意味着有些带特殊字符（例如`:` 和 `=`），则需要用双引号对这个值包起来。
-
-例如`localhost:1883` 会被解析成一个结构体 `{"localhost": 1883}`。
-想要把它当字符串使用时，就必需使用引号，如下：
-
-```
-EMQX_BRIDGES__MQTT__MYBRIDGE__CONNECTOR_SERVER='"localhost:1883"'
-```
-
-
-::: tip Tip
-未定义的根路径会被EMQX忽略，例如 `EMQX_UNKNOWN_ROOT__FOOBAR` 这个环境变量会被EMQX忽略，
-因为 `UNKNOWN_ROOT` 不是预先定义好的根路径。
-对于已知的根路径，未知的字段名称将被记录为warning日志，比如下面这个例子。
-
-```
-[warning] unknown_env_vars: ["EMQX_AUTHENTICATION__ENABLED"]
-```
-
-这是因为正确的字段名称是 `enable`，而不是 `enabled`。
-:::
-
-### 配置重载规则
-
-HOCON的值是分层覆盖的，普遍规则如下：
-
-- 在同一个文件中，后（在文件底部）定义的值，覆盖前（在文件顶部）到值。
-- 当按层级覆盖时，高层级的值覆盖低层级的值。
-
-结下来的文档将解释更详细的规则。
-
-#### 结构体
-
-合并覆盖规则。在如下配置中，最后一行的 `debug` 值会覆盖覆盖原先`level`字段的 `error` 值，但是 `enable` 字段保持不变。
-```
-log {
-    console_handler{
-        enable=true,
-        level=error
-    }
-}
-
-## 控制台日志打印先定义为 `error` 级，后被覆写成 `debug` 级
-
-log.console_handler.level=debug
-```
-
-#### Map
-
-Map与结构体类似，也是合并覆盖规则。
-如下例子中，`zone1` 的 `max_packet_size` 可以在文件后面覆写。
-
-```
-zone {
-    zone1 {
-        mqtt.max_packet_size = 1M
-    }
-}
-
-## 报文大小限制最先被设置成1MB，后被覆写为10MB
-
-zone.zone1.mqtt.max_packet_size = 10M
-```
-
-#### 数组元素
-
-如上面介绍过，EMQX配置中的数组有两种表达方式。
-
-* 列表格式，例如： `[1, 2, 3]`
-* 带下标的Map格式，例如： `{"1"=1, "2"=2, "3"=3}`
-
-点好（`'.'`）分隔到路径中的纯数字会被解析成数组下标。
-例如，`authentication.1={...}`  会被解析成 `authentication={"1": {...}}`，进而进一步解析成 `authentication=[{...}]`
-有了这个特性，我们就可以轻松覆写数组某个元素的值，例如：
-
-```
-authentication=[{enable=true, backend="built_in_database", mechanism="password_based"}]
-# 可以用下面的方式将第一个元素的 `enable` 字段覆写
-authentication.1.enable=false
-```
-
-::: warning Warning
-使用列表格式是的数组将全量覆写原值，如下例：
-
-```
-authentication=[{enable=true, backend="built_in_database", mechanism="password_based"}]
-## 下面这中方式会导致数组第一个元素的除了 `enable` 以外的其他字段全部丢失
-authentication=[{enable=true}]
-```
-:::
-
-#### TLS/SSL ciphers
-
-从 v5.0.6 开始 EMQX 不在配置文件中详细列出所有默认的密码套件名称。
-而是在配置文件中使用一个空列表，然后在运行时替换成默认的密码套件。
-
-下面这些密码套件是 EMQX 默认支持的：
-
-tlsv1.3:
-```
-ciphers =
-  [ "TLS_AES_256_GCM_SHA384", "TLS_AES_128_GCM_SHA256",
-    "TLS_CHACHA20_POLY1305_SHA256", "TLS_AES_128_CCM_SHA256",
-    "TLS_AES_128_CCM_8_SHA256"
-  ]
-```
-
-tlsv1.2 或更早
-
-```
-ciphers =
-  [ "ECDHE-ECDSA-AES256-GCM-SHA384",
-    "ECDHE-RSA-AES256-GCM-SHA384",
-    "ECDHE-ECDSA-AES256-SHA384",
-    "ECDHE-RSA-AES256-SHA384",
-    "ECDH-ECDSA-AES256-GCM-SHA384",
-    "ECDH-RSA-AES256-GCM-SHA384",
-    "ECDH-ECDSA-AES256-SHA384",
-    "ECDH-RSA-AES256-SHA384",
-    "DHE-DSS-AES256-GCM-SHA384",
-    "DHE-DSS-AES256-SHA256",
-    "AES256-GCM-SHA384",
-    "AES256-SHA256",
-    "ECDHE-ECDSA-AES128-GCM-SHA256",
-    "ECDHE-RSA-AES128-GCM-SHA256",
-    "ECDHE-ECDSA-AES128-SHA256",
-    "ECDHE-RSA-AES128-SHA256",
-    "ECDH-ECDSA-AES128-GCM-SHA256",
-    "ECDH-RSA-AES128-GCM-SHA256",
-    "ECDH-ECDSA-AES128-SHA256",
-    "ECDH-RSA-AES128-SHA256",
-    "DHE-DSS-AES128-GCM-SHA256",
-    "DHE-DSS-AES128-SHA256",
-    "AES128-GCM-SHA256",
-    "AES128-SHA256",
-    "ECDHE-ECDSA-AES256-SHA",
-    "ECDHE-RSA-AES256-SHA",
-    "DHE-DSS-AES256-SHA",
-    "ECDH-ECDSA-AES256-SHA",
-    "ECDH-RSA-AES256-SHA",
-    "ECDHE-ECDSA-AES128-SHA",
-    "ECDHE-RSA-AES128-SHA",
-    "DHE-DSS-AES128-SHA",
-    "ECDH-ECDSA-AES128-SHA",
-    "ECDH-RSA-AES128-SHA"
-  ]
-```
-
-配置 PSK 认证的监听器
-
-```
-ciphers = [
-  [ "RSA-PSK-AES256-GCM-SHA384",
-    "RSA-PSK-AES256-CBC-SHA384",
-    "RSA-PSK-AES128-GCM-SHA256",
-    "RSA-PSK-AES128-CBC-SHA256",
-    "RSA-PSK-AES256-CBC-SHA",
-    "RSA-PSK-AES128-CBC-SHA",
-    "PSK-AES256-GCM-SHA384",
-    "PSK-AES128-GCM-SHA256",
-    "PSK-AES256-CBC-SHA384",
-    "PSK-AES256-CBC-SHA",
-    "PSK-AES128-CBC-SHA256",
-    "PSK-AES128-CBC-SHA"
-  ]
-```

From 242df0ffe9d63f450423039aea67dded4e1d30c5 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 16 Feb 2024 09:26:56 +0100
Subject: [PATCH 242/273] chore: upgrade kafka_protocol from 4.1.3 to 4.1.5

---
 apps/emqx_bridge_azure_event_hub/rebar.config | 2 +-
 apps/emqx_bridge_confluent/rebar.config       | 2 +-
 apps/emqx_bridge_kafka/rebar.config           | 2 +-
 changes/ee/fix-12522.en.md                    | 4 ++++
 mix.exs                                       | 2 +-
 5 files changed, 8 insertions(+), 4 deletions(-)
 create mode 100644 changes/ee/fix-12522.en.md

diff --git a/apps/emqx_bridge_azure_event_hub/rebar.config b/apps/emqx_bridge_azure_event_hub/rebar.config
index f10ef1646..269239620 100644
--- a/apps/emqx_bridge_azure_event_hub/rebar.config
+++ b/apps/emqx_bridge_azure_event_hub/rebar.config
@@ -3,7 +3,7 @@
 {erl_opts, [debug_info]}.
 {deps, [
     {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
-    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
+    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.5"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
     {snappyer, "1.2.9"},
diff --git a/apps/emqx_bridge_confluent/rebar.config b/apps/emqx_bridge_confluent/rebar.config
index 93f8306f7..0519e39c9 100644
--- a/apps/emqx_bridge_confluent/rebar.config
+++ b/apps/emqx_bridge_confluent/rebar.config
@@ -3,7 +3,7 @@
 {erl_opts, [debug_info]}.
 {deps, [
     {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
-    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
+    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.5"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
     {snappyer, "1.2.9"},
diff --git a/apps/emqx_bridge_kafka/rebar.config b/apps/emqx_bridge_kafka/rebar.config
index 6e1ef0007..7c98bf571 100644
--- a/apps/emqx_bridge_kafka/rebar.config
+++ b/apps/emqx_bridge_kafka/rebar.config
@@ -3,7 +3,7 @@
 {erl_opts, [debug_info]}.
 {deps, [
     {wolff, {git, "https://github.com/kafka4beam/wolff.git", {tag, "1.10.2"}}},
-    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.3"}}},
+    {kafka_protocol, {git, "https://github.com/kafka4beam/kafka_protocol.git", {tag, "4.1.5"}}},
     {brod_gssapi, {git, "https://github.com/kafka4beam/brod_gssapi.git", {tag, "v0.1.1"}}},
     {brod, {git, "https://github.com/kafka4beam/brod.git", {tag, "3.16.8"}}},
     {snappyer, "1.2.9"},
diff --git a/changes/ee/fix-12522.en.md b/changes/ee/fix-12522.en.md
new file mode 100644
index 000000000..aa8bb76ad
--- /dev/null
+++ b/changes/ee/fix-12522.en.md
@@ -0,0 +1,4 @@
+Improved parsing for Kafka bootstrap hosts.
+
+Previously, spaces following commas in the Kafka bootstrap hosts list were included in the parsing result.
+This inclusion led to connection timeouts or DNS resolution failures due to the malformed host entries.
diff --git a/mix.exs b/mix.exs
index c2ef491e9..b40ca2168 100644
--- a/mix.exs
+++ b/mix.exs
@@ -203,7 +203,7 @@ defmodule EMQXUmbrella.MixProject do
       {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.4.5+v0.16.1"},
       {:influxdb, github: "emqx/influxdb-client-erl", tag: "1.1.13", override: true},
       {:wolff, github: "kafka4beam/wolff", tag: "1.10.2"},
-      {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.3", override: true},
+      {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.5", override: true},
       {:brod_gssapi, github: "kafka4beam/brod_gssapi", tag: "v0.1.1"},
       {:brod, github: "kafka4beam/brod", tag: "3.16.8"},
       {:snappyer, "1.2.9", override: true},

From f57f617ba3c317cc22622f2a5e91e1850ca457f4 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Thu, 15 Feb 2024 22:57:34 +0100
Subject: [PATCH 243/273] refactor(schema): ensure roots/0 and namespace/0 for
 all schema modules

---
 apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl            | 5 ++++-
 apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl    | 6 +++++-
 apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl         | 5 ++++-
 apps/emqx_auth_mnesia/src/emqx_authz_api_mnesia.erl         | 5 ++++-
 apps/emqx_bridge/src/schema/emqx_bridge_enterprise.erl      | 5 ++++-
 .../src/emqx_bridge_cassandra_connector.erl                 | 4 +++-
 .../src/emqx_bridge_clickhouse.app.src                      | 2 +-
 .../src/emqx_bridge_clickhouse_connector.erl                | 5 ++++-
 apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo.app.src      | 2 +-
 .../emqx_bridge_dynamo/src/emqx_bridge_dynamo_connector.erl | 5 ++++-
 apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl      | 3 ++-
 .../src/emqx_bridge_rocketmq_connector.erl                  | 5 ++++-
 .../emqx_bridge_sqlserver/src/emqx_bridge_sqlserver.app.src | 2 +-
 .../src/emqx_bridge_sqlserver_connector.erl                 | 5 ++++-
 apps/emqx_connector/src/emqx_connector_schema_lib.erl       | 6 ------
 apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl | 6 ++++--
 apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl      | 5 ++++-
 apps/emqx_dashboard/test/emqx_swagger_parameter_SUITE.erl   | 3 ++-
 apps/emqx_dashboard/test/emqx_swagger_remote_schema.erl     | 3 ++-
 apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl | 3 ++-
 apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl    | 1 +
 apps/emqx_gateway/src/emqx_gateway_api.erl                  | 5 ++++-
 apps/emqx_gateway/src/emqx_gateway_api_clients.erl          | 5 ++++-
 apps/emqx_gateway/src/emqx_gateway_api_listeners.erl        | 6 +++++-
 apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl           | 4 +++-
 apps/emqx_gcp_device/src/emqx_gcp_device.app.src            | 2 +-
 apps/emqx_gcp_device/src/emqx_gcp_device_api.erl            | 6 +++++-
 apps/emqx_management/src/emqx_mgmt_api_alarms.erl           | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_banned.erl           | 6 +++++-
 apps/emqx_management/src/emqx_mgmt_api_clients.erl          | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_data_backup.erl      | 4 +++-
 apps/emqx_management/src/emqx_mgmt_api_metrics.erl          | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_nodes.erl            | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_publish.erl          | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_stats.erl            | 5 ++++-
 apps/emqx_management/src/emqx_mgmt_api_subscriptions.erl    | 6 +++++-
 apps/emqx_management/src/emqx_mgmt_api_topics.erl           | 5 ++++-
 apps/emqx_modules/src/emqx_delayed_api.erl                  | 5 ++++-
 apps/emqx_modules/src/emqx_topic_metrics_api.erl            | 5 ++++-
 apps/emqx_mysql/src/emqx_mysql.erl                          | 5 ++++-
 apps/emqx_oracle/src/emqx_oracle_schema.erl                 | 5 ++++-
 apps/emqx_postgresql/src/emqx_postgresql.erl                | 4 +++-
 apps/emqx_prometheus/src/emqx_prometheus_api.erl            | 5 ++++-
 apps/emqx_telemetry/src/emqx_telemetry_api.erl              | 5 ++++-
 44 files changed, 150 insertions(+), 49 deletions(-)

diff --git a/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl b/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
index 7f0413fbb..07584c76e 100644
--- a/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
+++ b/apps/emqx_auth/src/emqx_authn/emqx_authn_api.erl
@@ -42,7 +42,8 @@
 -export([
     api_spec/0,
     paths/0,
-    schema/1
+    schema/1,
+    namespace/0
 ]).
 
 -export([
@@ -95,6 +96,8 @@
 
 -elvis([{elvis_style, god_modules, disable}]).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl b/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
index c2296f129..0af910d18 100644
--- a/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
+++ b/apps/emqx_auth/src/emqx_authz/emqx_authz_api_sources.erl
@@ -41,7 +41,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -56,6 +57,9 @@
 
 -define(TAGS, [<<"Authorization">>]).
 
+namespace() ->
+    undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl b/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
index 426c7a9f6..5a73f5991 100644
--- a/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
+++ b/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
@@ -22,7 +22,8 @@
 -export([
     roots/0,
     fields/1,
-    desc/1
+    desc/1,
+    namespace/0
 ]).
 
 -export([
@@ -65,6 +66,8 @@
 
 roots() -> [].
 
+namespace() -> undefined.
+
 fields(?CONF_NS) ->
     emqx_schema:authz_fields() ++ authz_fields();
 fields("metrics_status_fields") ->
diff --git a/apps/emqx_auth_mnesia/src/emqx_authz_api_mnesia.erl b/apps/emqx_auth_mnesia/src/emqx_authz_api_mnesia.erl
index 5fc1ec280..cab596da3 100644
--- a/apps/emqx_auth_mnesia/src/emqx_authz_api_mnesia.erl
+++ b/apps/emqx_auth_mnesia/src/emqx_authz_api_mnesia.erl
@@ -35,7 +35,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 %% operation funs
@@ -69,6 +70,8 @@
 -define(PUT_MAP_EXAMPLE, in_put_requestBody).
 -define(POST_ARRAY_EXAMPLE, in_post_requestBody).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_bridge/src/schema/emqx_bridge_enterprise.erl b/apps/emqx_bridge/src/schema/emqx_bridge_enterprise.erl
index cc4c6eb01..3822c7a34 100644
--- a/apps/emqx_bridge/src/schema/emqx_bridge_enterprise.erl
+++ b/apps/emqx_bridge/src/schema/emqx_bridge_enterprise.erl
@@ -13,7 +13,8 @@
     examples/1,
     resource_type/1,
     bridge_impl_module/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 api_schemas(Method) ->
@@ -139,6 +140,8 @@ bridge_impl_module(azure_event_hub_producer) ->
 bridge_impl_module(_BridgeType) ->
     undefined.
 
+namespace() -> undefined.
+
 fields(bridges) ->
     [
         {hstreamdb,
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index 872ccb532..a84d3912b 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -14,7 +14,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
 %% schema
--export([roots/0, fields/1, desc/1]).
+-export([roots/0, fields/1, desc/1, namespace/0]).
 
 %% callbacks of behaviour emqx_resource
 -export([
@@ -56,6 +56,8 @@
 %%--------------------------------------------------------------------
 %% schema
 
+namespace() -> cassandra.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
index 85c035be1..3288b83fd 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_clickhouse, [
     {description, "EMQX Enterprise ClickHouse Bridge"},
-    {vsn, "0.2.4"},
+    {vsn, "0.2.5"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
index 8f575dd8d..0a6c504c7 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
@@ -23,7 +23,8 @@
 -export([
     roots/0,
     fields/1,
-    values/1
+    values/1,
+    namespace/0
 ]).
 
 %% callbacks for behaviour emqx_resource
@@ -72,6 +73,8 @@
 %% Configuration and default values
 %%=====================================================================
 
+namespace() -> clickhouse.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo.app.src b/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo.app.src
index a4b372056..a0e8e2f19 100644
--- a/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo.app.src
+++ b/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_dynamo, [
     {description, "EMQX Enterprise Dynamo Bridge"},
-    {vsn, "0.1.4"},
+    {vsn, "0.1.5"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo_connector.erl b/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo_connector.erl
index 9cdb8886c..0739df747 100644
--- a/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo_connector.erl
+++ b/apps/emqx_bridge_dynamo/src/emqx_bridge_dynamo_connector.erl
@@ -12,7 +12,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, namespace/0]).
 
 %% `emqx_resource' API
 -export([
@@ -32,6 +32,9 @@
 
 %%=====================================================================
 %% Hocon schema
+
+namespace() -> dynamodka.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
index 22514dc5c..c40473ee5 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq.erl
@@ -115,7 +115,8 @@ action_values() ->
 
 %% -------------------------------------------------------------------------------------------------
 %% Hocon Schema Definitions
-namespace() -> "bridge_rocketmq".
+
+namespace() -> "rocketmq".
 
 roots() -> [].
 
diff --git a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
index c9a7ce177..a5bfa6437 100644
--- a/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
+++ b/apps/emqx_bridge_rocketmq/src/emqx_bridge_rocketmq_connector.erl
@@ -12,7 +12,7 @@
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, namespace/0]).
 
 %% `emqx_resource' API
 -export([
@@ -36,6 +36,9 @@
 
 %%=====================================================================
 %% Hocon schema
+
+namespace() -> rocketmq.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver.app.src b/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver.app.src
index 331f9c29f..bddf212e3 100644
--- a/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver.app.src
+++ b/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_sqlserver, [
     {description, "EMQX Enterprise SQL Server Bridge"},
-    {vsn, "0.1.5"},
+    {vsn, "0.1.6"},
     {registered, []},
     {applications, [kernel, stdlib, emqx_resource, odbc]},
     {env, []},
diff --git a/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver_connector.erl b/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver_connector.erl
index a87e71e31..e9e77ba6b 100644
--- a/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver_connector.erl
+++ b/apps/emqx_bridge_sqlserver/src/emqx_bridge_sqlserver_connector.erl
@@ -24,7 +24,8 @@
 %% Hocon config schema exports
 -export([
     roots/0,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 %% callbacks for behaviour emqx_resource
@@ -132,6 +133,8 @@
 %% Configuration and default values
 %%====================================================================
 
+namespace() -> sqlserver.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_connector/src/emqx_connector_schema_lib.erl b/apps/emqx_connector/src/emqx_connector_schema_lib.erl
index 76a06cb5a..609ba892d 100644
--- a/apps/emqx_connector/src/emqx_connector_schema_lib.erl
+++ b/apps/emqx_connector/src/emqx_connector_schema_lib.erl
@@ -44,12 +44,6 @@
     password/0
 ]).
 
--export([roots/0, fields/1]).
-
-roots() -> [].
-
-fields(_) -> [].
-
 ssl_fields() ->
     [
         {ssl, #{
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index f8800cc10..c0b0c365a 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -15,8 +15,8 @@
 -export([
     api_schemas/1,
     fields/1,
-    %%examples/1
-    schema_modules/0
+    schema_modules/0,
+    namespace/0
 ]).
 
 resource_type(Type) when is_binary(Type) ->
@@ -93,6 +93,8 @@ connector_impl_module(rabbitmq) ->
 connector_impl_module(_ConnectorType) ->
     undefined.
 
+namespace() -> undefined.
+
 fields(connectors) ->
     connector_structs().
 
diff --git a/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl b/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
index c36c6d0f3..97397056d 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
+++ b/apps/emqx_dashboard/src/emqx_dashboard_monitor_api.erl
@@ -27,7 +27,8 @@
 -export([
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -35,6 +36,8 @@
     monitor_current/2
 ]).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true, translate_body => true}).
 
diff --git a/apps/emqx_dashboard/test/emqx_swagger_parameter_SUITE.erl b/apps/emqx_dashboard/test/emqx_swagger_parameter_SUITE.erl
index 1e9e24755..d09490cc9 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_parameter_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_parameter_SUITE.erl
@@ -19,7 +19,7 @@
 -behaviour(hocon_schema).
 
 %% API
--export([paths/0, api_spec/0, schema/1, namespace/0, fields/1]).
+-export([paths/0, api_spec/0, schema/1, roots/0, namespace/0, fields/1]).
 -export([init_per_suite/1, end_per_suite/1]).
 -export([t_in_path/1, t_in_query/1, t_in_mix/1, t_without_in/1, t_ref/1, t_public_ref/1]).
 -export([t_require/1, t_query_enum/1, t_nullable/1, t_method/1, t_api_spec/1]).
@@ -563,6 +563,7 @@ schema("/method/error") ->
     #{operationId => test, bar => #{200 => <<"ok">>}}.
 
 namespace() -> undefined.
+roots() -> [].
 
 fields(page) ->
     [
diff --git a/apps/emqx_dashboard/test/emqx_swagger_remote_schema.erl b/apps/emqx_dashboard/test/emqx_swagger_remote_schema.erl
index dc9d54260..23573d612 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_remote_schema.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_remote_schema.erl
@@ -17,9 +17,10 @@
 
 -include_lib("typerefl/include/types.hrl").
 
--export([roots/0, fields/1]).
+-export([namespace/0, roots/0, fields/1]).
 -import(hoconsc, [mk/2]).
 roots() -> ["root"].
+namespace() -> undefined.
 
 fields("root") ->
     [
diff --git a/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl b/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
index 0e1264aeb..13754579e 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_requestBody_SUITE.erl
@@ -813,7 +813,8 @@ to_schema(Body) ->
         post => #{requestBody => Body, responses => #{200 => <<"ok">>}}
     }.
 
-%% Don't warning hocon callback namespace/0 undef.
+roots() -> [].
+
 namespace() -> atom_to_list(?MODULE).
 
 fields(good_ref) ->
diff --git a/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl b/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
index 5ccb01b3e..b9d7bf2e4 100644
--- a/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
+++ b/apps/emqx_dashboard/test/emqx_swagger_response_SUITE.erl
@@ -680,6 +680,7 @@ to_schema(Object) ->
         post => #{responses => #{200 => Object, 201 => Object}}
     }.
 
+rotos() -> [].
 namespace() -> undefined.
 
 fields(good_ref) ->
diff --git a/apps/emqx_gateway/src/emqx_gateway_api.erl b/apps/emqx_gateway/src/emqx_gateway_api.erl
index bd0bcff8a..6c125cf22 100644
--- a/apps/emqx_gateway/src/emqx_gateway_api.erl
+++ b/apps/emqx_gateway/src/emqx_gateway_api.erl
@@ -36,7 +36,8 @@
 -export([
     api_spec/0,
     paths/0,
-    schema/1
+    schema/1,
+    namespace/0
 ]).
 
 -export([
@@ -59,6 +60,8 @@
 %% minirest behaviour callbacks
 %%--------------------------------------------------------------------
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_gateway/src/emqx_gateway_api_clients.erl b/apps/emqx_gateway/src/emqx_gateway_api_clients.erl
index 121cb4064..88c53d230 100644
--- a/apps/emqx_gateway/src/emqx_gateway_api_clients.erl
+++ b/apps/emqx_gateway/src/emqx_gateway_api_clients.erl
@@ -42,7 +42,8 @@
 
 -export([
     roots/0,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 %% http handlers
@@ -775,6 +776,8 @@ schema_client() ->
         examples_client()
     ).
 
+namespace() -> undefined.
+
 roots() ->
     [
         stomp_client,
diff --git a/apps/emqx_gateway/src/emqx_gateway_api_listeners.erl b/apps/emqx_gateway/src/emqx_gateway_api_listeners.erl
index 284576983..3072d8903 100644
--- a/apps/emqx_gateway/src/emqx_gateway_api_listeners.erl
+++ b/apps/emqx_gateway/src/emqx_gateway_api_listeners.erl
@@ -45,7 +45,8 @@
 
 -export([
     roots/0,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 %% http handlers
@@ -651,6 +652,9 @@ params_paging_in_qs() ->
 %%--------------------------------------------------------------------
 %% schemas
 
+namespace() ->
+    undefined.
+
 roots() ->
     [listener].
 
diff --git a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
index d4b0a0b5e..97b01e5e8 100644
--- a/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
+++ b/apps/emqx_gateway_jt808/src/emqx_jt808_schema.erl
@@ -9,10 +9,12 @@
 -include_lib("typerefl/include/types.hrl").
 
 -behaviour(hocon_schema).
--export([namespace/0, fields/1, desc/1]).
+-export([roots/0, namespace/0, fields/1, desc/1]).
 
 -define(NOT_EMPTY(MSG), emqx_resource_validator:not_empty(MSG)).
 
+roots() -> [].
+
 namespace() -> gateway.
 
 fields(jt808) ->
diff --git a/apps/emqx_gcp_device/src/emqx_gcp_device.app.src b/apps/emqx_gcp_device/src/emqx_gcp_device.app.src
index 7f1d81f14..b3a4407c0 100644
--- a/apps/emqx_gcp_device/src/emqx_gcp_device.app.src
+++ b/apps/emqx_gcp_device/src/emqx_gcp_device.app.src
@@ -1,6 +1,6 @@
 {application, emqx_gcp_device, [
     {description, "Application simplifying migration from GCP IoT Core"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {mod, {emqx_gcp_device_app, []}},
     {applications, [
diff --git a/apps/emqx_gcp_device/src/emqx_gcp_device_api.erl b/apps/emqx_gcp_device/src/emqx_gcp_device_api.erl
index a08e0af24..4e10092b8 100644
--- a/apps/emqx_gcp_device/src/emqx_gcp_device_api.erl
+++ b/apps/emqx_gcp_device/src/emqx_gcp_device_api.erl
@@ -22,7 +22,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -62,6 +63,9 @@
 %% `minirest' and `minirest_trails' API
 %%-------------------------------------------------------------------------------------------------
 
+namespace() ->
+    undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_alarms.erl b/apps/emqx_management/src/emqx_mgmt_api_alarms.erl
index d5965f019..ea88ba082 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_alarms.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_alarms.erl
@@ -22,7 +22,7 @@
 -include_lib("emqx/include/emqx.hrl").
 -include_lib("typerefl/include/types.hrl").
 
--export([api_spec/0, paths/0, schema/1, fields/1]).
+-export([api_spec/0, paths/0, schema/1, fields/1, namespace/0]).
 
 -export([alarms/2, format_alarm/2]).
 
@@ -31,6 +31,9 @@
 %% internal export (for query)
 -export([qs2ms/2]).
 
+namespace() ->
+    undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_banned.erl b/apps/emqx_management/src/emqx_mgmt_api_banned.erl
index cf1ab3c49..4f2ba6c00 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_banned.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_banned.erl
@@ -28,7 +28,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([format/1]).
@@ -44,6 +45,9 @@
 
 -define(FORMAT_FUN, {?MODULE, format}).
 
+namespace() ->
+    undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true, translate_body => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_clients.erl b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
index 8965f4633..f5c799dd9 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_clients.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_clients.erl
@@ -32,7 +32,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -83,6 +84,8 @@
     message => <<"Client ID not found">>
 }).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true, translate_body => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_data_backup.erl b/apps/emqx_management/src/emqx_mgmt_api_data_backup.erl
index ef0b095cb..86fc8131d 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_data_backup.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_data_backup.erl
@@ -21,7 +21,7 @@
 -include_lib("emqx/include/logger.hrl").
 -include_lib("hocon/include/hoconsc.hrl").
 
--export([api_spec/0, paths/0, schema/1, fields/1]).
+-export([api_spec/0, paths/0, schema/1, fields/1, namespace/0]).
 
 -export([
     data_export/2,
@@ -48,6 +48,8 @@
         })}
 ).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_metrics.erl b/apps/emqx_management/src/emqx_mgmt_api_metrics.erl
index 7ad0777c7..a4a27c0f4 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_metrics.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_metrics.erl
@@ -27,7 +27,8 @@
 -export([
     api_spec/0,
     paths/0,
-    schema/1
+    schema/1,
+    namespace/0
 ]).
 
 -export([
@@ -42,6 +43,8 @@
 %% minirest behaviour callbacks
 %%--------------------------------------------------------------------
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_nodes.erl b/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
index 07d775f6e..9e9fad784 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_nodes.erl
@@ -30,7 +30,8 @@
     api_spec/0,
     schema/1,
     paths/0,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 %% API callbacks
@@ -45,6 +46,8 @@
 %% API spec funcs
 %%--------------------------------------------------------------------
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_publish.erl b/apps/emqx_management/src/emqx_mgmt_api_publish.erl
index f0834af96..c8c1a6e10 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_publish.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_publish.erl
@@ -32,7 +32,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -40,6 +41,8 @@
     publish_batch/2
 ]).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true, translate_body => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_stats.erl b/apps/emqx_management/src/emqx_mgmt_api_stats.erl
index cddc2a7c3..cb07be6d2 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_stats.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_stats.erl
@@ -34,11 +34,14 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([list/2]).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_subscriptions.erl b/apps/emqx_management/src/emqx_mgmt_api_subscriptions.erl
index ca0a7a625..39dc639d5 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_subscriptions.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_subscriptions.erl
@@ -28,7 +28,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([subscriptions/2]).
@@ -48,6 +49,9 @@
     {<<"match_topic">>, binary}
 ]).
 
+namespace() ->
+    undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_management/src/emqx_mgmt_api_topics.erl b/apps/emqx_management/src/emqx_mgmt_api_topics.erl
index 02d4461e9..bffcc2f0c 100644
--- a/apps/emqx_management/src/emqx_mgmt_api_topics.erl
+++ b/apps/emqx_management/src/emqx_mgmt_api_topics.erl
@@ -28,7 +28,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -41,6 +42,8 @@
 -define(TOPICS_QUERY_SCHEMA, [{<<"topic">>, binary}, {<<"node">>, atom}]).
 -define(TAGS, [<<"Topics">>]).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true, translate_body => true}).
 
diff --git a/apps/emqx_modules/src/emqx_delayed_api.erl b/apps/emqx_modules/src/emqx_delayed_api.erl
index f6ea99c12..37a79d8e0 100644
--- a/apps/emqx_modules/src/emqx_delayed_api.erl
+++ b/apps/emqx_modules/src/emqx_delayed_api.erl
@@ -34,7 +34,8 @@
 -export([
     paths/0,
     fields/1,
-    schema/1
+    schema/1,
+    namespace/0
 ]).
 
 %% for rpc
@@ -55,6 +56,8 @@
 -define(INVALID_TOPIC, 'INVALID_TOPIC_NAME').
 -define(MESSAGE_NOT_FOUND, 'MESSAGE_NOT_FOUND').
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_modules/src/emqx_topic_metrics_api.erl b/apps/emqx_modules/src/emqx_topic_metrics_api.erl
index 49b3071e0..982a4e710 100644
--- a/apps/emqx_modules/src/emqx_topic_metrics_api.erl
+++ b/apps/emqx_modules/src/emqx_topic_metrics_api.erl
@@ -47,7 +47,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -define(EXCEED_LIMIT, 'EXCEED_LIMIT').
@@ -55,6 +56,8 @@
 -define(TOPIC_NOT_FOUND, 'TOPIC_NOT_FOUND').
 -define(BAD_REQUEST, 'BAD_REQUEST').
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_mysql/src/emqx_mysql.erl b/apps/emqx_mysql/src/emqx_mysql.erl
index d33f313bc..cf937aeba 100644
--- a/apps/emqx_mysql/src/emqx_mysql.erl
+++ b/apps/emqx_mysql/src/emqx_mysql.erl
@@ -44,7 +44,7 @@
     unprepare_sql/1
 ]).
 
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, namespace/0]).
 
 -export([do_get_status/1]).
 
@@ -63,6 +63,9 @@
 -export_type([state/0]).
 %%=====================================================================
 %% Hocon schema
+
+namespace() -> mysql.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_oracle/src/emqx_oracle_schema.erl b/apps/emqx_oracle/src/emqx_oracle_schema.erl
index ba9904f19..a30ffca92 100644
--- a/apps/emqx_oracle/src/emqx_oracle_schema.erl
+++ b/apps/emqx_oracle/src/emqx_oracle_schema.erl
@@ -12,9 +12,12 @@
 %% Hocon config schema exports
 -export([
     roots/0,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
+namespace() -> oracle.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?REF_MODULE, config)}}].
 
diff --git a/apps/emqx_postgresql/src/emqx_postgresql.erl b/apps/emqx_postgresql/src/emqx_postgresql.erl
index e77a88c57..c8f354df0 100644
--- a/apps/emqx_postgresql/src/emqx_postgresql.erl
+++ b/apps/emqx_postgresql/src/emqx_postgresql.erl
@@ -23,7 +23,7 @@
 -include_lib("epgsql/include/epgsql.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
--export([roots/0, fields/1]).
+-export([roots/0, fields/1, namespace/0]).
 
 -behaviour(emqx_resource).
 
@@ -71,6 +71,8 @@
 
 %%=====================================================================
 
+namespace() -> postgres.
+
 roots() ->
     [{config, #{type => hoconsc:ref(?MODULE, config)}}].
 
diff --git a/apps/emqx_prometheus/src/emqx_prometheus_api.erl b/apps/emqx_prometheus/src/emqx_prometheus_api.erl
index 89bfa6e6a..432142775 100644
--- a/apps/emqx_prometheus/src/emqx_prometheus_api.erl
+++ b/apps/emqx_prometheus/src/emqx_prometheus_api.erl
@@ -34,7 +34,8 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -export([
@@ -50,6 +51,8 @@
 -define(IS_TRUE(Val), ((Val =:= true) orelse (Val =:= <<"true">>))).
 -define(IS_FALSE(Val), ((Val =:= false) orelse (Val =:= <<"false">>))).
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 
diff --git a/apps/emqx_telemetry/src/emqx_telemetry_api.erl b/apps/emqx_telemetry/src/emqx_telemetry_api.erl
index c90ad6b38..da18f761a 100644
--- a/apps/emqx_telemetry/src/emqx_telemetry_api.erl
+++ b/apps/emqx_telemetry/src/emqx_telemetry_api.erl
@@ -32,12 +32,15 @@
     api_spec/0,
     paths/0,
     schema/1,
-    fields/1
+    fields/1,
+    namespace/0
 ]).
 
 -define(BAD_REQUEST, 'BAD_REQUEST').
 -define(NOT_FOUND, 'NOT_FOUND').
 
+namespace() -> undefined.
+
 api_spec() ->
     emqx_dashboard_swagger:spec(?MODULE, #{check_schema => true}).
 

From 0cb28f5f4019edb49f0d12fd98d7287efbe36770 Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Fri, 16 Feb 2024 11:50:51 +0100
Subject: [PATCH 244/273] docs: better descriptions and labels for
 configuration parameters

Thanks @zmstone for the suggestions

Co-authored-by: Zaiming (Stone) Shi <zmstone@gmail.com>
---
 rel/i18n/emqx_bridge_hstreamdb.hocon | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/rel/i18n/emqx_bridge_hstreamdb.hocon b/rel/i18n/emqx_bridge_hstreamdb.hocon
index 70375dfbf..af2768c4b 100644
--- a/rel/i18n/emqx_bridge_hstreamdb.hocon
+++ b/rel/i18n/emqx_bridge_hstreamdb.hocon
@@ -54,43 +54,43 @@ action_parameters.label:
 """Action"""
 
 grpc_flush_timeout.desc:
-"""Period for flushing gRPC calls to the HStreamDB server"""
+"""Time interval for flushing gRPC calls to the HStreamDB server."""
 
 grpc_flush_timeout.label:
-"""gRPC Flush Period"""
+"""gRPC Flush Interval"""
 
 aggregation_pool_size.desc:
-"""Size of Record Aggregation Pool"""
+"""Size of record aggregation pool."""
 
 aggregation_pool_size.label:
 """Aggregation Pool Size"""
 
 max_batches.desc:
-"""Maximum number of unconfirmed batches in the flush queue"""
+"""Maximum number of unconfirmed batches in the flush queue."""
 
 max_batches.label:
 """Max Batches"""
 
 writer_pool_size.desc:
-"""Writer Pool Size"""
+"""The size of the writer pool."""
 
 writer_pool_size.label:
 """Writer Pool Size"""
 
 batch_size.desc:
-"""Maximum number of insert data clauses that can be sent in a single request"""
+"""Maximum number of insert data clauses that can be sent in a single request."""
 
 batch_size.label:
 """Max Batch Append Count"""
 
 batch_interval.desc:
-"""Maximum interval in milliseconds that is allowed between two successive (batch) request"""
+"""Maximum interval that is allowed between two successive (batch) request."""
 
 batch_interval.label:
 """Max Batch Interval"""
 
 hstreamdb_action.desc:
-"""Configuration for HStreamDB Action"""
+"""Configuration for HStreamDB action."""
 
 hstreamdb_action.label:
 """HStreamDB Action Configuration"""

From 59e4db98f7ff118a1b551d8f7b86b551943dd8b5 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 16 Feb 2024 12:11:45 +0100
Subject: [PATCH 245/273] test(bridge_mqtt): Stop snabbkaffe servers

---
 .../test/emqx_bridge_mqtt_v2_subscriber_SUITE.erl              | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_v2_subscriber_SUITE.erl b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_v2_subscriber_SUITE.erl
index 62e0e4f51..b9097b9c3 100644
--- a/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_v2_subscriber_SUITE.erl
+++ b/apps/emqx_bridge_mqtt/test/emqx_bridge_mqtt_v2_subscriber_SUITE.erl
@@ -1,5 +1,5 @@
 %%--------------------------------------------------------------------
-%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%% Copyright (c) 2023-2024 EMQ Technologies Co., Ltd. All Rights Reserved.
 %%
 %% Licensed under the Apache License, Version 2.0 (the "License");
 %% you may not use this file except in compliance with the License.
@@ -77,6 +77,7 @@ init_per_testcase(TestCase, Config) ->
     ].
 
 end_per_testcase(_TestCase, _Config) ->
+    snabbkaffe:stop(),
     emqx_common_test_helpers:call_janitor(),
     emqx_bridge_v2_testlib:delete_all_bridges_and_connectors(),
     ok.

From 17a0513962beb47757d9e27c1d8779281bfa1cbd Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 16 Feb 2024 12:24:57 +0100
Subject: [PATCH 246/273] docs: add a reference to the origin of is_bridge and
 bridge_mode

---
 apps/emqx/src/emqx_channel.erl | 2 ++
 apps/emqx/src/emqx_frame.erl   | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 2ffe880f3..130ec99c8 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -1551,6 +1551,8 @@ set_username(
 set_username(_ConnPkt, ClientInfo) ->
     {ok, ClientInfo}.
 
+%% The `is_bridge` bit flag in CONNECT packet (parsed as `bridge_mode`)
+%% is invented by mosquitto, named 'try_private': https://mosquitto.org/man/mosquitto-conf-5.html
 set_bridge_mode(#mqtt_packet_connect{is_bridge = true}, ClientInfo) ->
     {ok, ClientInfo#{is_bridge => true}};
 set_bridge_mode(_ConnPkt, _ClientInfo) ->
diff --git a/apps/emqx/src/emqx_frame.erl b/apps/emqx/src/emqx_frame.erl
index 0799a24ee..22170b6de 100644
--- a/apps/emqx/src/emqx_frame.erl
+++ b/apps/emqx/src/emqx_frame.erl
@@ -301,6 +301,7 @@ parse_connect2(
         proto_name = ProtoName,
         proto_ver = ProtoVer,
         %% For bridge mode, non-standard implementation
+        %% Invented by mosquitto, named 'try_private': https://mosquitto.org/man/mosquitto-conf-5.html
         is_bridge = (BridgeTag =:= 8),
         clean_start = bool(CleanStart),
         will_flag = bool(WillFlag),
@@ -772,6 +773,7 @@ serialize_variable(
         proto_name = ProtoName,
         proto_ver = ProtoVer,
         %% For bridge mode, non-standard implementation
+        %% Invented by mosquitto, named 'try_private': https://mosquitto.org/man/mosquitto-conf-5.html
         is_bridge = IsBridge,
         clean_start = CleanStart,
         will_flag = WillFlag,

From 8cfb22f0b89d74442b0c3a669f618e912b1b81e6 Mon Sep 17 00:00:00 2001
From: ieQu1 <99872536+ieQu1@users.noreply.github.com>
Date: Fri, 16 Feb 2024 12:42:48 +0100
Subject: [PATCH 247/273] fix(ds): Retry getting the shard leader

---
 .../src/emqx_ds_replication_layer_egress.erl         | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
index 8b37b29cb..6c1499620 100644
--- a/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
+++ b/apps/emqx_durable_storage/src/emqx_ds_replication_layer_egress.erl
@@ -90,7 +90,7 @@ init([DB, Shard]) ->
     process_flag(trap_exit, true),
     process_flag(message_queue_data, off_heap),
     %% TODO: adjust leader dynamically
-    {ok, Leader} = emqx_ds_replication_layer_meta:shard_leader(DB, Shard),
+    Leader = shard_leader(DB, Shard),
     S = #s{
         db = DB,
         shard = Shard,
@@ -173,3 +173,13 @@ do_enqueue(From, Sync, Msg, S0 = #s{n = N, batch = Batch, pending_replies = Repl
 start_timer() ->
     Interval = application:get_env(emqx_durable_storage, egress_flush_interval, 100),
     erlang:send_after(Interval, self(), ?flush).
+
+shard_leader(DB, Shard) ->
+    %% TODO: use optvar
+    case emqx_ds_replication_layer_meta:shard_leader(DB, Shard) of
+        {ok, Leader} ->
+            Leader;
+        {error, no_leader_for_shard} ->
+            timer:sleep(500),
+            shard_leader(DB, Shard)
+    end.

From 3fa262f9ca881e5c8be60c08eff7146bab8db64a Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 16 Feb 2024 14:33:15 +0100
Subject: [PATCH 248/273] test(listeners): try to stop all listeners after each
 test

- Reduce the `eaddrinuse` flakiness
- Use ?FUNCTION_NAME as listener name to avoid name clashing between
  tests
- Call emqx:remove_config for adhoc listeners created for testing
  tombestone is designed for default listeners
---
 apps/emqx/test/emqx_listeners_SUITE.erl | 33 ++++++++++++++-----------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/apps/emqx/test/emqx_listeners_SUITE.erl b/apps/emqx/test/emqx_listeners_SUITE.erl
index e934e6903..0dcd27612 100644
--- a/apps/emqx/test/emqx_listeners_SUITE.erl
+++ b/apps/emqx/test/emqx_listeners_SUITE.erl
@@ -206,7 +206,8 @@ t_ssl_update_opts(Config) ->
         {verify, verify_peer},
         {customize_hostname_check, [{match_fun, fun(_, _) -> true end}]}
     ],
-    with_listener(ssl, updated, Conf, fun() ->
+    Name = ?FUNCTION_NAME,
+    with_listener(ssl, Name, Conf, fun() ->
         %% Client connects successfully.
         C1 = emqtt_connect_ssl(Host, Port, [
             {cacertfile, filename:join(PrivDir, "ca.pem")} | ClientSSLOpts
@@ -214,7 +215,7 @@ t_ssl_update_opts(Config) ->
 
         %% Change the listener SSL configuration: another set of cert/key files.
         {ok, _} = emqx:update_config(
-            [listeners, ssl, updated],
+            [listeners, ssl, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"cacertfile">> => filename:join(PrivDir, "ca-next.pem"),
@@ -238,7 +239,7 @@ t_ssl_update_opts(Config) ->
 
         %% Change the listener SSL configuration: require peer certificate.
         {ok, _} = emqx:update_config(
-            [listeners, ssl, updated],
+            [listeners, ssl, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"verify">> => verify_peer,
@@ -292,7 +293,8 @@ t_wss_update_opts(Config) ->
         {verify, verify_peer},
         {customize_hostname_check, [{match_fun, fun(_, _) -> true end}]}
     ],
-    with_listener(wss, updated, Conf, fun() ->
+    Name = ?FUNCTION_NAME,
+    with_listener(wss, Name, Conf, fun() ->
         %% Start a client.
         C1 = emqtt_connect_wss(Host, Port, [
             {cacertfile, filename:join(PrivDir, "ca.pem")}
@@ -303,7 +305,7 @@ t_wss_update_opts(Config) ->
         %% 1. Another set of (password protected) cert/key files.
         %% 2. Require peer certificate.
         {ok, _} = emqx:update_config(
-            [listeners, wss, updated],
+            [listeners, wss, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"cacertfile">> => filename:join(PrivDir, "ca-next.pem"),
@@ -327,7 +329,7 @@ t_wss_update_opts(Config) ->
 
         %% Change the listener SSL configuration: require peer certificate.
         {ok, _} = emqx:update_config(
-            [listeners, wss, updated],
+            [listeners, wss, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"verify">> => verify_peer,
@@ -384,7 +386,8 @@ t_quic_update_opts(Config) ->
         {verify, verify_peer},
         {customize_hostname_check, [{match_fun, fun(_, _) -> true end}]}
     ],
-    with_listener(ListenerType, updated, Conf, fun() ->
+    Name = ?FUNCTION_NAME,
+    with_listener(ListenerType, Name, Conf, fun() ->
         %% Client connects successfully.
         C1 = ConnectFun(Host, Port, [
             {cacertfile, filename:join(PrivDir, "ca.pem")} | ClientSSLOpts
@@ -392,7 +395,7 @@ t_quic_update_opts(Config) ->
 
         %% Change the listener SSL configuration: another set of cert/key files.
         {ok, _} = emqx:update_config(
-            [listeners, ListenerType, updated],
+            [listeners, ListenerType, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"cacertfile">> => filename:join(PrivDir, "ca-next.pem"),
@@ -419,7 +422,7 @@ t_quic_update_opts(Config) ->
 
         %% Change the listener SSL configuration: require peer certificate.
         {ok, _} = emqx:update_config(
-            [listeners, ListenerType, updated],
+            [listeners, ListenerType, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"verify">> => verify_peer,
@@ -447,7 +450,7 @@ t_quic_update_opts(Config) ->
         %% Change the listener port
         NewPort = emqx_common_test_helpers:select_free_port(ListenerType),
         {ok, _} = emqx:update_config(
-            [listeners, ListenerType, updated],
+            [listeners, ListenerType, Name],
             {update, #{
                 <<"bind">> => format_bind({Host, NewPort})
             }}
@@ -506,7 +509,8 @@ t_quic_update_opts_fail(Config) ->
         {verify, verify_peer},
         {customize_hostname_check, [{match_fun, fun(_, _) -> true end}]}
     ],
-    with_listener(ListenerType, updated, Conf, fun() ->
+    Name = ?FUNCTION_NAME,
+    with_listener(ListenerType, Name, Conf, fun() ->
         %% GIVEN: an working Listener that client could connect to.
         C1 = ConnectFun(Host, Port, [
             {cacertfile, filename:join(PrivDir, "ca.pem")} | ClientSSLOpts
@@ -514,7 +518,7 @@ t_quic_update_opts_fail(Config) ->
 
         %% WHEN: reload the listener with invalid SSL options (certfile and keyfile missmatch).
         UpdateResult1 = emqx:update_config(
-            [listeners, ListenerType, updated],
+            [listeners, ListenerType, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"cacertfile">> => filename:join(PrivDir, "ca-next.pem"),
@@ -537,7 +541,7 @@ t_quic_update_opts_fail(Config) ->
 
         %% WHEN: Change the listener SSL configuration again
         UpdateResult2 = emqx:update_config(
-            [listeners, ListenerType, updated],
+            [listeners, ListenerType, Name],
             {update, #{
                 <<"ssl_options">> => #{
                     <<"cacertfile">> => filename:join(PrivDir, "ca-next.pem"),
@@ -581,7 +585,8 @@ with_listener(Type, Name, Config, Then) ->
     try
         Then()
     after
-        emqx:update_config([listeners, Type, Name], ?TOMBSTONE_CONFIG_CHANGE_REQ)
+        ok = emqx_listeners:stop(),
+        emqx:remove_config([listeners, Type, Name])
     end.
 
 emqtt_connect_ssl(Host, Port, SSLOpts) ->

From f78c30c9ff26414a63962cf52b529dec65e24309 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Fri, 16 Feb 2024 13:49:05 +0100
Subject: [PATCH 249/273] test: reduce false warning messages in test logs

---
 apps/emqx/src/emqx_config_handler.erl | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/apps/emqx/src/emqx_config_handler.erl b/apps/emqx/src/emqx_config_handler.erl
index 4cc5b2908..c20a74a5b 100644
--- a/apps/emqx/src/emqx_config_handler.erl
+++ b/apps/emqx/src/emqx_config_handler.erl
@@ -675,9 +675,19 @@ merge_to_override_config(RawConf, Opts) ->
     maps:merge(UpgradedOldConf, RawConf).
 
 upgrade_conf(Conf) ->
+    ConfigLoader = emqx_app:get_config_loader(),
+    %% ensure module loaded
+    _ = ConfigLoader:module_info(),
+    case erlang:function_exported(ConfigLoader, schema_module, 0) of
+        true ->
+            try_upgrade_conf(apply(ConfigLoader, schema_module, []), Conf);
+        false ->
+            %% this happens during emqx app standalone test
+            Conf
+    end.
+
+try_upgrade_conf(SchemaModule, Conf) ->
     try
-        ConfLoader = emqx_app:get_config_loader(),
-        SchemaModule = apply(ConfLoader, schema_module, []),
         apply(SchemaModule, upgrade_raw_conf, [Conf])
     catch
         ErrorType:Reason:Stack ->

From e57e19c9f1575bbb14ad08f8ddc2a905a717b882 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Wed, 31 Jan 2024 15:52:46 +0800
Subject: [PATCH 250/273] build: i18n file download time with millisecond
 precision

---
 scripts/pre-compile.sh | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/scripts/pre-compile.sh b/scripts/pre-compile.sh
index 12506162c..cd340338f 100755
--- a/scripts/pre-compile.sh
+++ b/scripts/pre-compile.sh
@@ -29,17 +29,20 @@ I18N_REPO_BRANCH="v$(./pkg-vsn.sh "${PROFILE_STR}" | tr -d '.' | cut -c 1-2)"
 
 DOWNLOAD_I18N_TRANSLATIONS=${DOWNLOAD_I18N_TRANSLATIONS:-true}
 # download desc (i18n) translations
+beginfmt='\033[1m'
+endfmt='\033[0m'
 if [ "$DOWNLOAD_I18N_TRANSLATIONS" = "true" ]; then
-  echo "downloading i18n translation from emqx/emqx-i18n"
-  start=$(date +%s)
+  echo "Downloading i18n translation from emqx/emqx-i18n..."
+  start=$(date +%s%N)
   curl -L --fail --silent --show-error \
        --output "apps/emqx_dashboard/priv/desc.zh.hocon" \
        "https://raw.githubusercontent.com/emqx/emqx-i18n/${I18N_REPO_BRANCH}/desc.zh.hocon"
-  end=$(date +%s)
-  duration=$(echo "$end $start" | awk '{print $1 - $2}')
-  echo "downloaded i18n translation in $duration seconds, set DOWNLOAD_I18N_TRANSLATIONS=false to skip"
+  end=$(date +%s%N)
+  duration=$(echo "$end $start" | awk '{printf "%.f\n", (($1 - $2)/ 1000000)}')
+  if [ "$duration" -gt 1000 ]; then beginfmt='\033[1;33m'; fi
+  echo -e "Downloaded i18n translation in $duration milliseconds.\nSet ${beginfmt}DOWNLOAD_I18N_TRANSLATIONS=false${endfmt} to skip"
 else
-  echo "skipping to download i18n translation from emqx/emqx-i18n, set DOWNLOAD_I18N_TRANSLATIONS=true to update"
+  echo -e "Skipping to download i18n translation from emqx/emqx-i18n.\nSet ${beginfmt}DOWNLOAD_I18N_TRANSLATIONS=true${endfmt} to update"
 fi
 
 # TODO

From 9e16f33c315a33d540e53bebc277a548ffaa3847 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Tue, 30 Jan 2024 18:15:29 +0800
Subject: [PATCH 251/273] test: `/prometheus/stats` endpoint format in json

---
 .../test/emqx_prometheus_SUITE.erl            | 32 ++++++++++---------
 .../test/emqx_prometheus_api_SUITE.erl        | 15 +++++----
 2 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
index 2d85f2a05..0e5e9c31e 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
@@ -22,21 +22,23 @@
 -compile(nowarn_export_all).
 -compile(export_all).
 
--define(LEGACY_CONF_DEFAULT, <<
-    "prometheus {\n"
-    "  push_gateway_server = \"http://127.0.0.1:9091\"\n"
-    "  interval = \"1s\"\n"
-    "  headers = { Authorization = \"some-authz-tokens\"}\n"
-    "  job_name = \"${name}~${host}\"\n"
-    "  enable = true\n"
-    "  vm_dist_collector = disabled\n"
-    "  mnesia_collector = disabled\n"
-    "  vm_statistics_collector = disabled\n"
-    "  vm_system_info_collector = disabled\n"
-    "  vm_memory_collector = disabled\n"
-    "  vm_msacc_collector = disabled\n"
-    "}\n"
->>).
+-define(CLUSTER_RPC_SHARD, emqx_cluster_rpc_shard).
+%% erlfmt-ignore
+-define(LEGACY_CONF_DEFAULT, <<"
+prometheus {
+    push_gateway_server = \"http://127.0.0.1:9091\"
+    interval = \"1s\"
+    headers = { Authorization = \"some-authz-tokens\"}
+    job_name = \"${name}~${host}\"
+    enable = true
+    vm_dist_collector = disabled
+    mnesia_collector = disabled
+    vm_statistics_collector = disabled
+    vm_system_info_collector = disabled
+    vm_memory_collector = disabled
+    vm_msacc_collector = disabled
+}
+">>).
 
 -define(CONF_DEFAULT, #{
     <<"prometheus">> =>
diff --git a/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
index 79fd0ef91..134aa82a6 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_api_SUITE.erl
@@ -279,20 +279,23 @@ t_stats_no_auth_api(_) ->
             ok
     end,
     emqx_dashboard_listener:regenerate_minirest_dispatch(),
-    Json = [{"accept", "application/json"}],
-    request_stats(Json, []).
+    Headers = accept_josn_header(),
+    request_stats(Headers, []).
 
 t_stats_auth_api(_) ->
     {ok, _} = emqx:update_config([prometheus, enable_basic_auth], true),
     emqx_dashboard_listener:regenerate_minirest_dispatch(),
     Auth = emqx_mgmt_api_test_util:auth_header_(),
-    JsonAuth = [{"accept", "application/json"}, Auth],
-    request_stats(JsonAuth, Auth),
+    Headers = [Auth | accept_josn_header()],
+    request_stats(Headers, Auth),
     ok.
 
-request_stats(JsonAuth, Auth) ->
+accept_josn_header() ->
+    [{"accept", "application/json"}].
+
+request_stats(Headers, Auth) ->
     Path = emqx_mgmt_api_test_util:api_path(["prometheus", "stats"]),
-    {ok, Response} = emqx_mgmt_api_test_util:request_api(get, Path, "", JsonAuth),
+    {ok, Response} = emqx_mgmt_api_test_util:request_api(get, Path, "", Headers),
     Data = emqx_utils_json:decode(Response, [return_maps]),
     ?assertMatch(#{<<"client">> := _, <<"delivery">> := _}, Data),
     {ok, _} = emqx_mgmt_api_test_util:request_api(get, Path, "", Auth),

From d45d925529f25f45457e63125c420630dd11ee49 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Fri, 26 Jan 2024 17:12:54 +0800
Subject: [PATCH 252/273] test(prom_api): `/prometheus/stats` in prom/json
 format

---
 .../src/emqx_prometheus_api.erl               |   5 +
 .../test/emqx_prometheus_data_SUITE.erl       | 522 ++++++++++++++++++
 2 files changed, 527 insertions(+)
 create mode 100644 apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl

diff --git a/apps/emqx_prometheus/src/emqx_prometheus_api.erl b/apps/emqx_prometheus/src/emqx_prometheus_api.erl
index 432142775..f92d0ff58 100644
--- a/apps/emqx_prometheus/src/emqx_prometheus_api.erl
+++ b/apps/emqx_prometheus/src/emqx_prometheus_api.erl
@@ -22,6 +22,11 @@
 -include_lib("hocon/include/hoconsc.hrl").
 -include_lib("emqx/include/logger.hrl").
 
+-ifdef(TEST).
+-compile(export_all).
+-compile(nowarn_export_all).
+-endif.
+
 -import(
     hoconsc,
     [
diff --git a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
new file mode 100644
index 000000000..22a888f28
--- /dev/null
+++ b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
@@ -0,0 +1,522 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2020-2023 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_prometheus_data_SUITE).
+
+-compile(nowarn_export_all).
+-compile(export_all).
+
+-include("emqx_prometheus.hrl").
+
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
+
+-define(LOGT(Format, Args), ct:pal("TEST_SUITE: " ++ Format, Args)).
+
+all() ->
+    [
+        {group, stats},
+        {group, auth},
+        {group, data_integration}
+    ].
+
+groups() ->
+    TCs = emqx_common_test_helpers:all(?MODULE),
+    AcceptGroups = [
+        {group, 'text/plain'},
+        {group, 'application/json'}
+    ],
+    ModeGroups = [
+        {group, ?PROM_DATA_MODE__NODE},
+        {group, ?PROM_DATA_MODE__ALL_NODES_AGGREGATED},
+        {group, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED}
+    ],
+    [
+        {stats, ModeGroups},
+        {auth, ModeGroups},
+        {data_integration, ModeGroups},
+        {?PROM_DATA_MODE__NODE, AcceptGroups},
+        {?PROM_DATA_MODE__ALL_NODES_AGGREGATED, AcceptGroups},
+        {?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED, AcceptGroups},
+        {'text/plain', TCs},
+        {'application/json', TCs}
+    ].
+
+init_per_suite(Config) ->
+    meck:new(emqx_retainer, [non_strict, passthrough, no_history, no_link]),
+    meck:expect(emqx_retainer, retained_count, fun() -> 0 end),
+    emqx_prometheus_SUITE:init_group(),
+    ok = emqx_common_test_helpers:start_apps(
+        [emqx, emqx_conf, emqx_auth, emqx_rule_engine, emqx_prometheus],
+        fun set_special_configs/1
+    ),
+    Config.
+end_per_suite(Config) ->
+    meck:unload([emqx_retainer]),
+    emqx_prometheus_SUITE:end_group(),
+    emqx_common_test_helpers:stop_apps(
+        [emqx, emqx_conf, emqx_auth, emqx_rule_engine, emqx_prometheus]
+    ),
+
+    Config.
+
+init_per_group(stats, Config) ->
+    [{module, emqx_prometheus} | Config];
+init_per_group(auth, Config) ->
+    [{module, emqx_prometheus_auth} | Config];
+init_per_group(data_integration, Config) ->
+    [{module, emqx_prometheus_data_integration} | Config];
+init_per_group(?PROM_DATA_MODE__NODE, Config) ->
+    [{mode, ?PROM_DATA_MODE__NODE} | Config];
+init_per_group(?PROM_DATA_MODE__ALL_NODES_AGGREGATED, Config) ->
+    [{mode, ?PROM_DATA_MODE__ALL_NODES_AGGREGATED} | Config];
+init_per_group(?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED, Config) ->
+    [{mode, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED} | Config];
+init_per_group('text/plain', Config) ->
+    [{accept, 'text/plain'} | Config];
+init_per_group('application/json', Config) ->
+    [{accept, 'application/json'} | Config];
+init_per_group(_Group, Config) ->
+    Config.
+
+end_per_group(_Group, _Config) ->
+    ok.
+
+set_special_configs(emqx_dashboard) ->
+    emqx_dashboard_api_test_helpers:set_default_config();
+set_special_configs(emqx_auth) ->
+    {ok, _} = emqx:update_config([authorization, cache, enable], true),
+    {ok, _} = emqx:update_config([authorization, no_match], deny),
+    {ok, _} = emqx:update_config([authorization, sources], []),
+    ok;
+set_special_configs(emqx_prometheus) ->
+    emqx_prometheus_SUITE:load_config(),
+    ok;
+set_special_configs(_App) ->
+    ok.
+
+%%--------------------------------------------------------------------
+%% Cases
+%%--------------------------------------------------------------------
+
+t_collect_prom_data(Config) ->
+    CollectOpts = collect_opts(Config),
+    Module = ?config(module, Config),
+    Response = emqx_prometheus_api:collect(Module, CollectOpts),
+    assert_data(Module, Response, CollectOpts).
+
+%%--------------------------------------------------------------------
+%% Helper fns
+%%--------------------------------------------------------------------
+
+assert_data(_Module, {Code, Header, RawDataBinary}, #{type := <<"prometheus">>, mode := Mode}) ->
+    ?assertEqual(Code, 200),
+    ?assertMatch(#{<<"content-type">> := <<"text/plain">>}, Header),
+    DataL = lists:filter(
+        fun(B) ->
+            case re:run(B, <<"^[^#]">>, [global]) of
+                {match, _} ->
+                    true;
+                nomatch ->
+                    false
+            end
+        end,
+        binary:split(RawDataBinary, [<<"\n">>], [global])
+    ),
+    assert_prom_data(DataL, Mode);
+assert_data(Module, {Code, JsonData}, #{type := <<"json">>, mode := Mode}) ->
+    ?assertEqual(Code, 200),
+    ?assert(is_map(JsonData), true),
+    assert_json_data(Module, JsonData, Mode).
+
+%%%%%%%%%%%%%%%%%%%%
+%% assert text/plain format
+assert_prom_data(DataL, Mode) ->
+    NDataL = lists:map(
+        fun(Line) ->
+            binary:split(Line, [<<"{">>, <<",">>, <<"} ">>, <<" ">>], [global])
+        end,
+        DataL
+    ),
+    do_assert_prom_data_stats(NDataL, Mode).
+
+-define(MGU(K, MAP), maps:get(K, MAP, undefined)).
+
+assert_json_data(emqx_prometheus, Data, Mode) ->
+    lists:foreach(
+        fun(FunSeed) ->
+            erlang:apply(?MODULE, fun_name(FunSeed), [?MGU(FunSeed, Data), Mode]),
+            ok
+        end,
+        maps:keys(Data)
+    ),
+    ok;
+%% TOOD auth/data_integration
+assert_json_data(_, _, _) ->
+    ok.
+
+fun_name(Seed) ->
+    binary_to_atom(<<"assert_json_data_", (atom_to_binary(Seed))/binary>>).
+
+%%--------------------------------------------------------------------
+%% Internal Functions
+%%--------------------------------------------------------------------
+
+collect_opts(Config) ->
+    #{
+        type => accept(?config(accept, Config)),
+        mode => ?config(mode, Config)
+    }.
+
+accept('text/plain') ->
+    <<"prometheus">>;
+accept('application/json') ->
+    <<"json">>.
+
+do_assert_prom_data_stats([], _Mode) ->
+    ok;
+do_assert_prom_data_stats([Metric | RestDataL], Mode) ->
+    [_MetricNamme | _] = Metric,
+    assert_stats_metric_labels(Metric, Mode),
+    do_assert_prom_data_stats(RestDataL, Mode).
+
+assert_stats_metric_labels([MetricName | R] = _Metric, Mode) ->
+    case maps:get(Mode, metric_meta(MetricName), undefined) of
+        %% for uncatched metrics (by prometheus.erl)
+        undefined ->
+            ok;
+        N when is_integer(N) ->
+            ?assertEqual(N, length(lists:droplast(R)))
+    end.
+
+-define(meta(NODE, AGGRE, UNAGGRE), #{
+    ?PROM_DATA_MODE__NODE => NODE,
+    ?PROM_DATA_MODE__ALL_NODES_AGGREGATED => AGGRE,
+    ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED => UNAGGRE
+}).
+
+%% TODO: auth/data_integration
+%% BEGIN always no label
+metric_meta(<<"emqx_topics_max">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_topics_count">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_retained_count">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_retained_max">>) -> ?meta(0, 0, 0);
+%% END
+%% BEGIN no label in mode `node`
+metric_meta(<<"emqx_vm_cpu_use">>) -> ?meta(0, 1, 1);
+metric_meta(<<"emqx_vm_cpu_idle">>) -> ?meta(0, 1, 1);
+metric_meta(<<"emqx_vm_run_queue">>) -> ?meta(0, 1, 1);
+metric_meta(<<"emqx_vm_process_messages_in_queues">>) -> ?meta(0, 1, 1);
+metric_meta(<<"emqx_vm_total_memory">>) -> ?meta(0, 1, 1);
+metric_meta(<<"emqx_vm_used_memory">>) -> ?meta(0, 1, 1);
+%% END
+metric_meta(<<"emqx_cert_expiry_at">>) -> ?meta(2, 2, 2);
+metric_meta(<<"emqx_license_expiry_at">>) -> ?meta(0, 0, 0);
+%% mria metric with label `shard` and `node` when not in mode `node`
+metric_meta(<<"emqx_mria_", _Tail/binary>>) -> ?meta(1, 2, 2);
+metric_meta(_) -> #{}.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%% Assert Json Data Structure
+
+assert_json_data_messages(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_messages_received := _,
+            emqx_messages_sent := _,
+            emqx_messages_qos0_received := _,
+            emqx_messages_qos0_sent := _,
+            emqx_messages_qos1_received := _,
+            emqx_messages_qos1_sent := _,
+            emqx_messages_qos2_received := _,
+            emqx_messages_qos2_sent := _,
+            emqx_messages_publish := _,
+            emqx_messages_dropped := _,
+            emqx_messages_dropped_expired := _,
+            emqx_messages_dropped_no_subscribers := _,
+            emqx_messages_forward := _,
+            emqx_messages_retained := _,
+            emqx_messages_delayed := _,
+            emqx_messages_delivered := _,
+            emqx_messages_acked := _
+        },
+        M
+    ),
+    ok;
+assert_json_data_messages(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_stats(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_connections_count := _,
+            emqx_connections_max := _,
+            emqx_live_connections_count := _,
+            emqx_live_connections_max := _,
+            emqx_sessions_count := _,
+            emqx_sessions_max := _,
+            emqx_channels_count := _,
+            emqx_channels_max := _,
+            emqx_topics_count := _,
+            emqx_topics_max := _,
+            emqx_suboptions_count := _,
+            emqx_suboptions_max := _,
+            emqx_subscribers_count := _,
+            emqx_subscribers_max := _,
+            emqx_subscriptions_count := _,
+            emqx_subscriptions_max := _,
+            emqx_subscriptions_shared_count := _,
+            emqx_subscriptions_shared_max := _,
+            emqx_retained_count := _,
+            emqx_retained_max := _,
+            emqx_delayed_count := _,
+            emqx_delayed_max := _
+        },
+        M
+    );
+assert_json_data_stats(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_olp(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(#{}, M);
+assert_json_data_olp(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+    ok.
+
+assert_json_data_client(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_client_connect := _,
+            emqx_client_connack := _,
+            emqx_client_connected := _,
+            emqx_client_authenticate := _,
+            emqx_client_auth_anonymous := _,
+            emqx_client_authorize := _,
+            emqx_client_subscribe := _,
+            emqx_client_unsubscribe := _,
+            emqx_client_disconnected := _
+        },
+        M
+    );
+assert_json_data_client(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_session(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_session_created := _,
+            emqx_session_resumed := _,
+            emqx_session_takenover := _,
+            emqx_session_discarded := _,
+            emqx_session_terminated := _
+        },
+        M
+    );
+assert_json_data_session(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_metrics(M, ?PROM_DATA_MODE__NODE) ->
+    ?assertMatch(
+        #{
+            emqx_vm_cpu_use := _,
+            emqx_vm_cpu_idle := _,
+            emqx_vm_run_queue := _,
+            emqx_vm_process_messages_in_queues := _,
+            emqx_vm_total_memory := _,
+            emqx_vm_used_memory := _
+        },
+        M
+    );
+assert_json_data_metrics(Ms, Mode) when
+    is_list(Ms) andalso
+        (Mode =:= ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED orelse
+            Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_delivery(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_delivery_dropped := _,
+            emqx_delivery_dropped_no_local := _,
+            emqx_delivery_dropped_too_large := _,
+            emqx_delivery_dropped_qos0_msg := _,
+            emqx_delivery_dropped_queue_full := _,
+            emqx_delivery_dropped_expired := _
+        },
+        M
+    );
+assert_json_data_delivery(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_cluster(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{emqx_cluster_nodes_running := _, emqx_cluster_nodes_stopped := _},
+        M
+    );
+assert_json_data_cluster(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_acl(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_authorization_allow := _,
+            emqx_authorization_deny := _,
+            emqx_authorization_cache_hit := _,
+            emqx_authorization_cache_miss := _,
+            emqx_authorization_superuser := _,
+            emqx_authorization_nomatch := _,
+            emqx_authorization_matched_allow := _,
+            emqx_authorization_matched_deny := _
+        },
+        M
+    );
+assert_json_data_acl(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_authn(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_authentication_success := _,
+            emqx_authentication_success_anonymous := _,
+            emqx_authentication_failure := _
+        },
+        M
+    );
+assert_json_data_authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+assert_json_data_packets(M, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    ?assertMatch(
+        #{
+            emqx_packets_publish_auth_error := _,
+            emqx_packets_puback_received := _,
+            emqx_packets_pubcomp_inuse := _,
+            emqx_packets_pubcomp_sent := _,
+            emqx_packets_suback_sent := _,
+            emqx_packets_pubrel_missed := _,
+            emqx_packets_publish_inuse := _,
+            emqx_packets_pingresp_sent := _,
+            emqx_packets_subscribe_received := _,
+            emqx_bytes_received := _,
+            emqx_packets_publish_dropped := _,
+            emqx_packets_publish_received := _,
+            emqx_packets_connack_sent := _,
+            emqx_packets_connack_auth_error := _,
+            emqx_packets_pubrec_inuse := _,
+            emqx_packets_sent := _,
+            emqx_packets_puback_sent := _,
+            emqx_packets_received := _,
+            emqx_packets_pubrec_missed := _,
+            emqx_packets_unsubscribe_received := _,
+            emqx_packets_puback_inuse := _,
+            emqx_packets_publish_sent := _,
+            emqx_packets_pubrec_sent := _,
+            emqx_packets_pubcomp_received := _,
+            emqx_packets_disconnect_sent := _,
+            emqx_packets_unsuback_sent := _,
+            emqx_bytes_sent := _,
+            emqx_packets_unsubscribe_error := _,
+            emqx_packets_auth_received := _,
+            emqx_packets_subscribe_auth_error := _,
+            emqx_packets_puback_missed := _,
+            emqx_packets_publish_error := _,
+            emqx_packets_subscribe_error := _,
+            emqx_packets_disconnect_received := _,
+            emqx_packets_pingreq_received := _,
+            emqx_packets_pubrel_received := _,
+            emqx_packets_pubcomp_missed := _,
+            emqx_packets_pubrec_received := _,
+            emqx_packets_connack_error := _,
+            emqx_packets_auth_sent := _,
+            emqx_packets_pubrel_sent := _,
+            emqx_packets_connect := _
+        },
+        M
+    );
+assert_json_data_packets(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    eval_foreach_assert(?FUNCTION_NAME, Ms).
+
+%% certs always return json list
+assert_json_data_certs(Ms, _) ->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    emqx_cert_expiry_at := _,
+                    listener_type := _,
+                    listener_name := _
+                },
+                M
+            )
+        end,
+        Ms
+    ).
+
+-if(?EMQX_RELEASE_EDITION == ee).
+%% license always map
+assert_json_data_license(M, _) ->
+    ?assertMatch(#{emqx_license_expiry_at := _}, M).
+-else.
+-endif.
+
+eval_foreach_assert(FunctionName, Ms) ->
+    Fun = fun() ->
+        ok = lists:foreach(
+            fun(M) -> erlang:apply(?MODULE, FunctionName, [M, ?PROM_DATA_MODE__NODE]) end, Ms
+        ),
+        ok = lists:foreach(fun(M) -> ?assertMatch(#{node := _}, M) end, Ms)
+    end,
+    Fun().

From 7bfabd7865d36aab72e2b8937670a0e83ccf2824 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Sun, 4 Feb 2024 18:13:39 +0800
Subject: [PATCH 253/273] refactor: meck license checker for prom cases

---
 .../test/emqx_prometheus_SUITE.erl               | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
index 0e5e9c31e..4b3cb576d 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_SUITE.erl
@@ -133,6 +133,22 @@ config(default) ->
 config(legacy) ->
     ?LEGACY_CONF_DEFAULT.
 
+conf_default() ->
+    ?CONF_DEFAULT.
+
+legacy_conf_default() ->
+    ?LEGACY_CONF_DEFAULT.
+
+-if(?EMQX_RELEASE_EDITION == ee).
+maybe_meck_license() ->
+    meck:new(emqx_license_checker, [non_strict, passthrough, no_link]),
+    meck:expect(emqx_license_checker, expiry_epoch, fun() -> 1859673600 end).
+maybe_unmeck_license() ->
+    meck:unload(emqx_license_checker).
+-else.
+maybe_meck_license() -> ok.
+maybe_unmeck_license() -> ok.
+-endif.
 %%--------------------------------------------------------------------
 %% Test cases
 %%--------------------------------------------------------------------

From ba1d24d054092d3a31fcedf7e73b60b92ee5fb8d Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Fri, 2 Feb 2024 16:19:26 +0800
Subject: [PATCH 254/273] test(prom_api): '/prometheus/auth' and
 '/prometheus/data_integration'

---
 .../src/emqx_authz/emqx_authz_schema.erl      |   4 +
 .../test/emqx_authz/emqx_authz_SUITE.erl      |  23 +-
 .../test/emqx_prometheus_data_SUITE.erl       | 353 +++++++++++++++---
 3 files changed, 325 insertions(+), 55 deletions(-)

diff --git a/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl b/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
index 5a73f5991..8e82ea061 100644
--- a/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
+++ b/apps/emqx_auth/src/emqx_authz/emqx_authz_schema.erl
@@ -42,6 +42,10 @@
     authz_common_fields/1
 ]).
 
+-ifdef(TEST).
+-export([source_schema_mods/0]).
+-endif.
+
 -define(AUTHZ_MODS_PT_KEY, {?MODULE, authz_schema_mods}).
 
 %%--------------------------------------------------------------------
diff --git a/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl b/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
index cee120acb..746f3daad 100644
--- a/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
+++ b/apps/emqx_auth/test/emqx_authz/emqx_authz_SUITE.erl
@@ -292,16 +292,19 @@ t_update_source(_) ->
 t_replace_all(_) ->
     RootKey = [<<"authorization">>],
     Conf = emqx:get_raw_config(RootKey),
-    emqx_authz_utils:update_config(RootKey, Conf#{
-        <<"sources">> => [
-            ?SOURCE_FILE1,
-            ?SOURCE_REDIS,
-            ?SOURCE_POSTGRESQL,
-            ?SOURCE_MYSQL,
-            ?SOURCE_MONGODB,
-            ?SOURCE_HTTP
-        ]
-    }),
+    ?assertMatch(
+        {ok, _},
+        emqx_authz_utils:update_config(RootKey, Conf#{
+            <<"sources">> => [
+                ?SOURCE_FILE1,
+                ?SOURCE_REDIS,
+                ?SOURCE_POSTGRESQL,
+                ?SOURCE_MYSQL,
+                ?SOURCE_MONGODB,
+                ?SOURCE_HTTP
+            ]
+        })
+    ),
     %% config
     ?assertMatch(
         [
diff --git a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
index 22a888f28..b0a0a2c18 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
@@ -26,11 +26,62 @@
 
 -define(LOGT(Format, Args), ct:pal("TEST_SUITE: " ++ Format, Args)).
 
+%% erlfmt-ignore
+-define(EMQX_CONF, <<"
+authentication = [
+  {
+    backend = built_in_database
+    enable = true
+    mechanism = password_based
+    password_hash_algorithm {name = sha256, salt_position = suffix}
+    user_id_type = username
+  },
+  {
+    algorithm = sha256
+    backend = built_in_database
+    enable = true
+    iteration_count = 4096
+    mechanism = scram
+  }
+]
+authorization {
+  cache {
+    enable = true
+  }
+  deny_action = ignore
+  no_match = allow
+  sources = [
+    {path = \"${EMQX_ETC_DIR}/acl.conf\", type = file}
+  ]
+}
+connectors {
+  http {
+    test_http_connector {
+      ssl {enable = false, verify = verify_peer}
+      url = \"http://127.0.0.1:3000\"
+    }
+  }
+}
+rule_engine {
+  ignore_sys_message = true
+  jq_function_default_timeout = 10s
+  rules {
+    rule_xbmw {
+      actions = [\"mqtt:action1\"]
+      description = \"\"
+      enable = true
+      metadata {created_at = 1707244896918}
+      sql = \"SELECT * FROM \\\"t/#\\\"\"
+    }
+  }
+}
+">>).
+
 all() ->
     [
-        {group, stats},
-        {group, auth},
-        {group, data_integration}
+        {group, '/prometheus/stats'},
+        {group, '/prometheus/auth'},
+        {group, '/prometheus/data_integration'}
     ].
 
 groups() ->
@@ -45,9 +96,9 @@ groups() ->
         {group, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED}
     ],
     [
-        {stats, ModeGroups},
-        {auth, ModeGroups},
-        {data_integration, ModeGroups},
+        {'/prometheus/stats', ModeGroups},
+        {'/prometheus/auth', ModeGroups},
+        {'/prometheus/data_integration', ModeGroups},
         {?PROM_DATA_MODE__NODE, AcceptGroups},
         {?PROM_DATA_MODE__ALL_NODES_AGGREGATED, AcceptGroups},
         {?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED, AcceptGroups},
@@ -58,26 +109,53 @@ groups() ->
 init_per_suite(Config) ->
     meck:new(emqx_retainer, [non_strict, passthrough, no_history, no_link]),
     meck:expect(emqx_retainer, retained_count, fun() -> 0 end),
-    emqx_prometheus_SUITE:init_group(),
-    ok = emqx_common_test_helpers:start_apps(
-        [emqx, emqx_conf, emqx_auth, emqx_rule_engine, emqx_prometheus],
-        fun set_special_configs/1
+    meck:expect(
+        emqx_authz_file,
+        acl_conf_file,
+        fun() ->
+            emqx_common_test_helpers:deps_path(emqx_auth, "etc/acl.conf")
+        end
     ),
-    Config.
+    ok = emqx_prometheus_SUITE:maybe_meck_license(),
+
+    application:load(emqx_auth),
+    Apps = emqx_cth_suite:start(
+        [
+            emqx,
+            {emqx_conf, ?EMQX_CONF},
+            emqx_auth,
+            emqx_auth_mnesia,
+            emqx_rule_engine,
+            emqx_bridge_http,
+            emqx_connector,
+            {emqx_prometheus, emqx_prometheus_SUITE:legacy_conf_default()}
+        ],
+        #{
+            work_dir => filename:join(?config(priv_dir, Config), ?MODULE)
+        }
+    ),
+
+    [{apps, Apps} | Config].
+
 end_per_suite(Config) ->
     meck:unload([emqx_retainer]),
-    emqx_prometheus_SUITE:end_group(),
-    emqx_common_test_helpers:stop_apps(
-        [emqx, emqx_conf, emqx_auth, emqx_rule_engine, emqx_prometheus]
+    emqx_prometheus_SUITE:maybe_unmeck_license(),
+    {ok, _} = emqx:update_config(
+        [authorization],
+        #{
+            <<"no_match">> => <<"allow">>,
+            <<"cache">> => #{<<"enable">> => <<"true">>},
+            <<"sources">> => []
+        }
     ),
+    emqx_cth_suite:stop(?config(apps, Config)),
+    ok.
 
-    Config.
-
-init_per_group(stats, Config) ->
+init_per_group('/prometheus/stats', Config) ->
     [{module, emqx_prometheus} | Config];
-init_per_group(auth, Config) ->
+init_per_group('/prometheus/auth', Config) ->
     [{module, emqx_prometheus_auth} | Config];
-init_per_group(data_integration, Config) ->
+init_per_group('/prometheus/data_integration', Config) ->
     [{module, emqx_prometheus_data_integration} | Config];
 init_per_group(?PROM_DATA_MODE__NODE, Config) ->
     [{mode, ?PROM_DATA_MODE__NODE} | Config];
@@ -95,17 +173,28 @@ init_per_group(_Group, Config) ->
 end_per_group(_Group, _Config) ->
     ok.
 
-set_special_configs(emqx_dashboard) ->
-    emqx_dashboard_api_test_helpers:set_default_config();
-set_special_configs(emqx_auth) ->
-    {ok, _} = emqx:update_config([authorization, cache, enable], true),
-    {ok, _} = emqx:update_config([authorization, no_match], deny),
-    {ok, _} = emqx:update_config([authorization, sources], []),
+init_per_testcase(t_collect_prom_data, Config) ->
+    meck:new(emqx_utils, [non_strict, passthrough, no_history, no_link]),
+    meck:expect(emqx_utils, gen_id, fun() -> "fake" end),
+
+    meck:new(emqx, [non_strict, passthrough, no_history, no_link]),
+    meck:expect(
+        emqx,
+        data_dir,
+        fun() ->
+            {data_dir, Data} = lists:keyfind(data_dir, 1, Config),
+            Data
+        end
+    ),
+    Config;
+init_per_testcase(_, Config) ->
+    Config.
+
+end_per_testcase(t_collect_prom_data, _Config) ->
+    meck:unload(emqx_utils),
+    meck:unload(emqx),
     ok;
-set_special_configs(emqx_prometheus) ->
-    emqx_prometheus_SUITE:load_config(),
-    ok;
-set_special_configs(_App) ->
+end_per_testcase(_, _Config) ->
     ok.
 
 %%--------------------------------------------------------------------
@@ -151,11 +240,11 @@ assert_prom_data(DataL, Mode) ->
         end,
         DataL
     ),
-    do_assert_prom_data_stats(NDataL, Mode).
+    do_assert_prom_data(NDataL, Mode).
 
 -define(MGU(K, MAP), maps:get(K, MAP, undefined)).
 
-assert_json_data(emqx_prometheus, Data, Mode) ->
+assert_json_data(_, Data, Mode) ->
     lists:foreach(
         fun(FunSeed) ->
             erlang:apply(?MODULE, fun_name(FunSeed), [?MGU(FunSeed, Data), Mode]),
@@ -163,9 +252,6 @@ assert_json_data(emqx_prometheus, Data, Mode) ->
         end,
         maps:keys(Data)
     ),
-    ok;
-%% TOOD auth/data_integration
-assert_json_data(_, _, _) ->
     ok.
 
 fun_name(Seed) ->
@@ -186,12 +272,12 @@ accept('text/plain') ->
 accept('application/json') ->
     <<"json">>.
 
-do_assert_prom_data_stats([], _Mode) ->
+do_assert_prom_data([], _Mode) ->
     ok;
-do_assert_prom_data_stats([Metric | RestDataL], Mode) ->
+do_assert_prom_data([Metric | RestDataL], Mode) ->
     [_MetricNamme | _] = Metric,
     assert_stats_metric_labels(Metric, Mode),
-    do_assert_prom_data_stats(RestDataL, Mode).
+    do_assert_prom_data(RestDataL, Mode).
 
 assert_stats_metric_labels([MetricName | R] = _Metric, Mode) ->
     case maps:get(Mode, metric_meta(MetricName), undefined) of
@@ -199,6 +285,12 @@ assert_stats_metric_labels([MetricName | R] = _Metric, Mode) ->
         undefined ->
             ok;
         N when is_integer(N) ->
+            %% ct:print(
+            %%     "====================~n"
+            %%     "%% Metric: ~p~n"
+            %%     "%% Expect labels count: ~p in Mode: ~p~n",
+            %%     [_Metric, N, Mode]
+            %% ),
             ?assertEqual(N, length(lists:droplast(R)))
     end.
 
@@ -208,7 +300,7 @@ assert_stats_metric_labels([MetricName | R] = _Metric, Mode) ->
     ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED => UNAGGRE
 }).
 
-%% TODO: auth/data_integration
+%% `/prometheus/stats`
 %% BEGIN always no label
 metric_meta(<<"emqx_topics_max">>) -> ?meta(0, 0, 0);
 metric_meta(<<"emqx_topics_count">>) -> ?meta(0, 0, 0);
@@ -227,6 +319,21 @@ metric_meta(<<"emqx_cert_expiry_at">>) -> ?meta(2, 2, 2);
 metric_meta(<<"emqx_license_expiry_at">>) -> ?meta(0, 0, 0);
 %% mria metric with label `shard` and `node` when not in mode `node`
 metric_meta(<<"emqx_mria_", _Tail/binary>>) -> ?meta(1, 2, 2);
+%% `/prometheus/auth`
+metric_meta(<<"emqx_authn_users_count">>) -> ?meta(1, 1, 1);
+metric_meta(<<"emqx_authn_", _Tail/binary>>) -> ?meta(1, 1, 2);
+metric_meta(<<"emqx_authz_rules_count">>) -> ?meta(1, 1, 1);
+metric_meta(<<"emqx_authz_", _Tail/binary>>) -> ?meta(1, 1, 2);
+metric_meta(<<"emqx_banned_count">>) -> ?meta(0, 0, 0);
+%% `/prometheus/data_integration`
+metric_meta(<<"emqx_rules_count">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_connectors_count">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_schema_registrys_count">>) -> ?meta(0, 0, 0);
+metric_meta(<<"emqx_rule_", _Tail/binary>>) -> ?meta(1, 1, 2);
+metric_meta(<<"emqx_action_", _Tail/binary>>) -> ?meta(1, 1, 2);
+metric_meta(<<"emqx_connector_", _Tail/binary>>) -> ?meta(1, 1, 2);
+%% normal emqx metrics
+metric_meta(<<"emqx_", _Tail/binary>>) -> ?meta(0, 0, 1);
 metric_meta(_) -> #{}.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -505,13 +612,6 @@ assert_json_data_certs(Ms, _) ->
         Ms
     ).
 
--if(?EMQX_RELEASE_EDITION == ee).
-%% license always map
-assert_json_data_license(M, _) ->
-    ?assertMatch(#{emqx_license_expiry_at := _}, M).
--else.
--endif.
-
 eval_foreach_assert(FunctionName, Ms) ->
     Fun = fun() ->
         ok = lists:foreach(
@@ -520,3 +620,166 @@ eval_foreach_assert(FunctionName, Ms) ->
         ok = lists:foreach(fun(M) -> ?assertMatch(#{node := _}, M) end, Ms)
     end,
     Fun().
+
+-if(?EMQX_RELEASE_EDITION == ee).
+%% license always map
+assert_json_data_license(M, _) ->
+    ?assertMatch(#{emqx_license_expiry_at := _}, M).
+-else.
+-endif.
+
+-define(assert_node_foreach(Ms), lists:foreach(fun(M) -> ?assertMatch(#{node := _}, M) end, Ms)).
+
+assert_json_data_emqx_banned(M, _) ->
+    ?assertMatch(#{emqx_banned_count := _}, M).
+
+assert_json_data_emqx_authn(Ms, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    id := _,
+                    emqx_authn_enable := _,
+                    emqx_authn_failed := _,
+                    emqx_authn_nomatch := _,
+                    emqx_authn_status := _,
+                    emqx_authn_success := _,
+                    emqx_authn_total := _,
+                    emqx_authn_users_count := _
+                },
+                M
+            )
+        end,
+        Ms
+    );
+assert_json_data_emqx_authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
+    ?assert_node_foreach(Ms).
+
+assert_json_data_emqx_authz(Ms, _) ->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    type := _,
+                    emqx_authz_allow := _,
+                    emqx_authz_deny := _,
+                    emqx_authz_enable := _,
+                    emqx_authz_nomatch := _,
+                    emqx_authz_rules_count := _,
+                    emqx_authz_status := _,
+                    emqx_authz_total := _
+                },
+                M
+            )
+        end,
+        Ms
+    );
+assert_json_data_emqx_authz(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
+    ?assert_node_foreach(Ms).
+
+assert_json_data_rules(Ms, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    id := _,
+                    emqx_rule_actions_failed := _,
+                    emqx_rule_actions_failed_out_of_service := _,
+                    emqx_rule_actions_failed_unknown := _,
+                    emqx_rule_actions_success := _,
+                    emqx_rule_actions_total := _,
+                    emqx_rule_enable := _,
+                    emqx_rule_failed := _,
+                    emqx_rule_failed_exception := _,
+                    emqx_rule_failed_no_result := _,
+                    emqx_rule_matched := _,
+                    emqx_rule_passed := _
+                },
+                M
+            )
+        end,
+        Ms
+    );
+assert_json_data_rules(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    ?assert_node_foreach(Ms).
+
+assert_json_data_actions(Ms, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    id := _,
+                    emqx_action_dropped := _,
+                    emqx_action_dropped_expired := _,
+                    emqx_action_dropped_other := _,
+                    emqx_action_dropped_queue_full := _,
+                    emqx_action_dropped_resource_not_found := _,
+                    emqx_action_dropped_resource_stopped := _,
+                    emqx_action_enable := _,
+                    emqx_action_failed := _,
+                    emqx_action_inflight := _,
+                    emqx_action_late_reply := _,
+                    emqx_action_matched := _,
+                    emqx_action_queuing := _,
+                    emqx_action_received := _,
+                    emqx_action_retried := _,
+                    emqx_action_retried_failed := _,
+                    emqx_action_retried_success := _,
+                    emqx_action_status := _,
+                    emqx_action_success := _
+                },
+                M
+            )
+        end,
+        Ms
+    );
+assert_json_data_actions(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    ?assert_node_foreach(Ms).
+
+assert_json_data_connectors(Ms, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
+    lists:foreach(
+        fun(M) ->
+            ?assertMatch(
+                #{
+                    id := _,
+                    emqx_connector_enable := _,
+                    emqx_connector_status := _
+                },
+                M
+            )
+        end,
+        Ms
+    );
+assert_json_data_connectors(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+    is_list(Ms)
+->
+    ?assert_node_foreach(Ms).
+
+assert_json_data_data_integration_overview(M, _) ->
+    ?assertMatch(
+        #{
+            emqx_connectors_count := _,
+            emqx_rules_count := _,
+            emqx_schema_registrys_count := _
+        },
+        M
+    ).
+
+stop_apps(Apps) ->
+    lists:foreach(fun application:stop/1, Apps).

From c61b5584236f4b7a7c1465631fd05c85c7874519 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Sun, 18 Feb 2024 03:39:18 +0800
Subject: [PATCH 255/273] test(prom): start mock pushgateway

---
 apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
index b0a0a2c18..95f303b82 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
@@ -117,6 +117,7 @@ init_per_suite(Config) ->
         end
     ),
     ok = emqx_prometheus_SUITE:maybe_meck_license(),
+    emqx_prometheus_SUITE:start_mock_pushgateway(9091),
 
     application:load(emqx_auth),
     Apps = emqx_cth_suite:start(
@@ -140,6 +141,7 @@ init_per_suite(Config) ->
 end_per_suite(Config) ->
     meck:unload([emqx_retainer]),
     emqx_prometheus_SUITE:maybe_unmeck_license(),
+    emqx_prometheus_SUITE:stop_mock_pushgateway(),
     {ok, _} = emqx:update_config(
         [authorization],
         #{

From 451c8ecaf53f828d504daae1a64e2013ffa430b3 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Tue, 30 Jan 2024 18:07:36 +0800
Subject: [PATCH 256/273] ci: add env vars to run clickhouse tests locally

---
 .../test/emqx_bridge_clickhouse_SUITE.erl     | 21 ++++++++-------
 ...emqx_bridge_clickhouse_connector_SUITE.erl | 27 ++++---------------
 2 files changed, 17 insertions(+), 31 deletions(-)

diff --git a/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_SUITE.erl b/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_SUITE.erl
index 8cfc24882..d83321d27 100644
--- a/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_SUITE.erl
+++ b/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_SUITE.erl
@@ -9,6 +9,7 @@
 
 -define(APP, emqx_bridge_clickhouse).
 -define(CLICKHOUSE_HOST, "clickhouse").
+-define(CLICKHOUSE_PORT, "8123").
 -include_lib("emqx_connector/include/emqx_connector.hrl").
 
 %% See comment in
@@ -20,9 +21,9 @@
 %%------------------------------------------------------------------------------
 
 init_per_suite(Config) ->
-    case
-        emqx_common_test_helpers:is_tcp_server_available(?CLICKHOUSE_HOST, ?CLICKHOUSE_DEFAULT_PORT)
-    of
+    Host = clickhouse_host(),
+    Port = list_to_integer(clickhouse_port()),
+    case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
             emqx_common_test_helpers:render_and_load_app_config(emqx_conf),
             ok = emqx_common_test_helpers:start_apps([emqx_conf, emqx_bridge]),
@@ -114,13 +115,15 @@ sql_drop_table() ->
 sql_create_database() ->
     "CREATE DATABASE IF NOT EXISTS mqtt".
 
+clickhouse_host() ->
+    os:getenv("CLICKHOUSE_HOST", ?CLICKHOUSE_HOST).
+clickhouse_port() ->
+    os:getenv("CLICKHOUSE_PORT", ?CLICKHOUSE_PORT).
+
 clickhouse_url() ->
-    erlang:iolist_to_binary([
-        <<"http://">>,
-        ?CLICKHOUSE_HOST,
-        ":",
-        erlang:integer_to_list(?CLICKHOUSE_DEFAULT_PORT)
-    ]).
+    Host = clickhouse_host(),
+    Port = clickhouse_port(),
+    erlang:iolist_to_binary(["http://", Host, ":", Port]).
 
 clickhouse_config(Config) ->
     SQL = maps:get(sql, Config, sql_insert_template_for_bridge()),
diff --git a/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_connector_SUITE.erl b/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_connector_SUITE.erl
index e1d3149db..e9eb6c7a2 100644
--- a/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_connector_SUITE.erl
+++ b/apps/emqx_bridge_clickhouse/test/emqx_bridge_clickhouse_connector_SUITE.erl
@@ -13,7 +13,6 @@
 -include_lib("common_test/include/ct.hrl").
 
 -define(APP, emqx_bridge_clickhouse).
--define(CLICKHOUSE_HOST, "clickhouse").
 -define(CLICKHOUSE_RESOURCE_MOD, emqx_bridge_clickhouse_connector).
 -define(CLICKHOUSE_PASSWORD, "public").
 
@@ -39,25 +38,17 @@ all() ->
 groups() ->
     [].
 
-clickhouse_url() ->
-    erlang:iolist_to_binary([
-        <<"http://">>,
-        ?CLICKHOUSE_HOST,
-        ":",
-        erlang:integer_to_list(?CLICKHOUSE_DEFAULT_PORT)
-    ]).
-
 init_per_suite(Config) ->
-    case
-        emqx_common_test_helpers:is_tcp_server_available(?CLICKHOUSE_HOST, ?CLICKHOUSE_DEFAULT_PORT)
-    of
+    Host = emqx_bridge_clickhouse_SUITE:clickhouse_host(),
+    Port = list_to_integer(emqx_bridge_clickhouse_SUITE:clickhouse_port()),
+    case emqx_common_test_helpers:is_tcp_server_available(Host, Port) of
         true ->
             ok = emqx_common_test_helpers:start_apps([emqx_conf]),
             ok = emqx_connector_test_helpers:start_apps([emqx_resource, ?APP]),
             %% Create the db table
             {ok, Conn} =
                 clickhouse:start_link([
-                    {url, clickhouse_url()},
+                    {url, emqx_bridge_clickhouse_SUITE:clickhouse_url()},
                     {user, <<"default">>},
                     {key, ?CLICKHOUSE_PASSWORD},
                     {pool, tmp_pool}
@@ -205,15 +196,7 @@ clickhouse_config(Overrides) ->
             username => <<"default">>,
             password => <<?CLICKHOUSE_PASSWORD>>,
             pool_size => 8,
-            url => iolist_to_binary(
-                io_lib:format(
-                    "http://~s:~b",
-                    [
-                        ?CLICKHOUSE_HOST,
-                        ?CLICKHOUSE_DEFAULT_PORT
-                    ]
-                )
-            ),
+            url => emqx_bridge_clickhouse_SUITE:clickhouse_url(),
             connect_timeout => <<"10s">>
         },
     #{<<"config">> => maps:merge(Config, Overrides)}.

From 8ae0e787863bd37f32f00225f1407af52c490f4f Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Fri, 2 Feb 2024 17:58:18 +0800
Subject: [PATCH 257/273] refactor: split clickhouse bridges to actions and
 connectors

---
 apps/emqx_bridge/src/emqx_action_info.erl     |   1 +
 .../src/emqx_bridge_cassandra_connector.erl   |   5 -
 .../src/emqx_bridge_clickhouse.app.src        |   4 +-
 .../src/emqx_bridge_clickhouse.erl            | 121 +++++++++++++++---
 .../emqx_bridge_clickhouse_action_info.erl    |  62 +++++++++
 .../src/emqx_bridge_clickhouse_connector.erl  |  82 +++++++-----
 .../src/schema/emqx_connector_ee_schema.erl   |  12 ++
 .../src/schema/emqx_connector_schema.erl      |   2 +
 changes/ee/feat-19999.en.md                   |   1 +
 rel/i18n/emqx_bridge_clickhouse.hocon         |  10 ++
 10 files changed, 247 insertions(+), 53 deletions(-)
 create mode 100644 apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_action_info.erl
 create mode 100644 changes/ee/feat-19999.en.md

diff --git a/apps/emqx_bridge/src/emqx_action_info.erl b/apps/emqx_bridge/src/emqx_action_info.erl
index 3a9e13f94..e54ef6124 100644
--- a/apps/emqx_bridge/src/emqx_action_info.erl
+++ b/apps/emqx_bridge/src/emqx_action_info.erl
@@ -97,6 +97,7 @@ hard_coded_action_info_modules_ee() ->
         emqx_bridge_rocketmq_action_info,
         emqx_bridge_influxdb_action_info,
         emqx_bridge_cassandra_action_info,
+        emqx_bridge_clickhouse_action_info,
         emqx_bridge_mysql_action_info,
         emqx_bridge_pgsql_action_info,
         emqx_bridge_syskeeper_action_info,
diff --git a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
index a84d3912b..c9d3246d3 100644
--- a/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
+++ b/apps/emqx_bridge_cassandra/src/emqx_bridge_cassandra_connector.erl
@@ -32,8 +32,6 @@
     on_get_status/2
 ]).
 
--export([transform_bridge_v1_config_to_connector_config/1]).
-
 %% callbacks of ecpool
 -export([
     connect/1,
@@ -448,9 +446,6 @@ handle_result({error, Error}) ->
 handle_result(Res) ->
     Res.
 
-transform_bridge_v1_config_to_connector_config(_) ->
-    ok.
-
 %%--------------------------------------------------------------------
 %% utils
 
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
index 3288b83fd..d96d06375 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_clickhouse, [
     {description, "EMQX Enterprise ClickHouse Bridge"},
-    {vsn, "0.2.5"},
+    {vsn, "0.3.0"},
     {registered, []},
     {applications, [
         kernel,
@@ -8,7 +8,7 @@
         emqx_resource,
         clickhouse
     ]},
-    {env, []},
+    {env, [{emqx_action_info_modules, [emqx_bridge_clickhouse_action_info]}]},
     {modules, []},
     {links, []}
 ]}.
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
index deca42154..11f5fff5a 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
@@ -9,8 +9,11 @@
 
 -import(hoconsc, [mk/2, enum/1, ref/2]).
 
+%% Examples
 -export([
-    conn_bridge_examples/1
+    bridge_v2_examples/1,
+    conn_bridge_examples/1,
+    connector_examples/1
 ]).
 
 -export([
@@ -20,12 +23,10 @@
     desc/1
 ]).
 
--define(DEFAULT_SQL,
-    <<"INSERT INTO mqtt_test(payload, arrived) VALUES ('${payload}', ${timestamp})">>
-).
-
+-define(DEFAULT_SQL, <<"INSERT INTO messages(data, arrived) VALUES ('${payload}', ${timestamp})">>).
 -define(DEFAULT_BATCH_VALUE_SEPARATOR, <<", ">>).
-
+-define(CONNECTOR_TYPE, clickhouse).
+-define(ACTION_TYPE, clickhouse).
 %% -------------------------------------------------------------------------------------------------
 %% Callback used by HTTP API
 %% -------------------------------------------------------------------------------------------------
@@ -40,6 +41,42 @@ conn_bridge_examples(Method) ->
         }
     ].
 
+bridge_v2_examples(Method) ->
+    ParamsExample = #{
+        parameters => #{
+            batch_value_separator => ?DEFAULT_BATCH_VALUE_SEPARATOR,
+            sql => ?DEFAULT_SQL
+        }
+    },
+    [
+        #{
+            <<"clickhouse">> => #{
+                summary => <<"ClickHouse Action">>,
+                value => emqx_bridge_v2_schema:action_values(
+                    Method, clickhouse, clickhouse, ParamsExample
+                )
+            }
+        }
+    ].
+
+connector_examples(Method) ->
+    [
+        #{
+            <<"clickhouse">> => #{
+                summary => <<"ClickHouse Connector">>,
+                value => emqx_connector_schema:connector_values(
+                    Method, clickhouse, #{
+                        server => <<"127.0.0.1:8123">>,
+                        database => <<"mqtt">>,
+                        pool_size => 8,
+                        username => <<"default">>,
+                        password => <<"******">>
+                    }
+                )
+            }
+        }
+    ].
+
 values(_Method, Type) ->
     #{
         enable => true,
@@ -71,19 +108,49 @@ namespace() -> "bridge_clickhouse".
 
 roots() -> [].
 
+fields("config_connector") ->
+    emqx_connector_schema:common_fields() ++
+        emqx_bridge_clickhouse_connector:fields(config) ++
+        emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts);
+fields(action) ->
+    {clickhouse,
+        mk(
+            hoconsc:map(name, ref(?MODULE, clickhouse_action)),
+            #{desc => <<"ClickHouse Action Config">>, required => false}
+        )};
+fields(clickhouse_action) ->
+    emqx_bridge_v2_schema:make_producer_action_schema(
+        mk(ref(?MODULE, action_parameters), #{
+            required => true, desc => ?DESC(action_parameters)
+        })
+    );
+fields(action_parameters) ->
+    [
+        sql_field(),
+        batch_value_separator_field()
+    ];
+fields(connector_resource_opts) ->
+    emqx_connector_schema:resource_opts_fields();
+fields(Field) when
+    Field == "get_connector";
+    Field == "put_connector";
+    Field == "post_connector"
+->
+    Fields =
+        emqx_bridge_clickhouse_connector:fields(config) ++
+            emqx_connector_schema:resource_opts_ref(?MODULE, connector_resource_opts),
+    emqx_connector_schema:api_fields(Field, ?CONNECTOR_TYPE, Fields);
+fields(Field) when
+    Field == "get_bridge_v2";
+    Field == "post_bridge_v2";
+    Field == "put_bridge_v2"
+->
+    emqx_bridge_v2_schema:api_fields(Field, ?ACTION_TYPE, fields(clickhouse_action));
 fields("config") ->
     [
         {enable, mk(boolean(), #{desc => ?DESC("config_enable"), default => true})},
-        {sql,
-            mk(
-                binary(),
-                #{desc => ?DESC("sql_template"), default => ?DEFAULT_SQL, format => <<"sql">>}
-            )},
-        {batch_value_separator,
-            mk(
-                binary(),
-                #{desc => ?DESC("batch_value_separator"), default => ?DEFAULT_BATCH_VALUE_SEPARATOR}
-            )},
+        sql_field(),
+        batch_value_separator_field(),
         {local_topic,
             mk(
                 binary(),
@@ -112,6 +179,28 @@ fields("get") ->
 fields("post", Type) ->
     [type_field(Type), name_field() | fields("config")].
 
+sql_field() ->
+    {sql,
+        mk(
+            binary(),
+            #{desc => ?DESC("sql_template"), default => ?DEFAULT_SQL, format => <<"sql">>}
+        )}.
+
+batch_value_separator_field() ->
+    {batch_value_separator,
+        mk(
+            binary(),
+            #{desc => ?DESC("batch_value_separator"), default => ?DEFAULT_BATCH_VALUE_SEPARATOR}
+        )}.
+
+desc(clickhouse_action) ->
+    ?DESC(clickhouse_action);
+desc(action_parameters) ->
+    ?DESC(action_parameters);
+desc("config_connector") ->
+    ?DESC("desc_config");
+desc(connector_resource_opts) ->
+    ?DESC(emqx_resource_schema, "resource_opts");
 desc("config") ->
     ?DESC("desc_config");
 desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_action_info.erl b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_action_info.erl
new file mode 100644
index 000000000..066569f7e
--- /dev/null
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_action_info.erl
@@ -0,0 +1,62 @@
+-module(emqx_bridge_clickhouse_action_info).
+
+-behaviour(emqx_action_info).
+
+-export([
+    bridge_v1_config_to_action_config/2,
+    bridge_v1_config_to_connector_config/1,
+    connector_action_config_to_bridge_v1_config/2,
+    bridge_v1_type_name/0,
+    action_type_name/0,
+    connector_type_name/0,
+    schema_module/0
+]).
+
+-import(emqx_utils_conv, [bin/1]).
+
+-define(SCHEMA_MODULE, emqx_bridge_clickhouse).
+
+bridge_v1_config_to_action_config(BridgeV1Config, ConnectorName) ->
+    ActionTopLevelKeys = schema_keys(clickhouse_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ActionConfig = make_config_map(ActionKeys, ActionParametersKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_bridge_v2_schema:project_to_actions_resource_opts/1,
+        ActionConfig#{<<"connector">> => ConnectorName}
+    ).
+
+bridge_v1_config_to_connector_config(BridgeV1Config) ->
+    ActionTopLevelKeys = schema_keys(clickhouse_action),
+    ActionParametersKeys = schema_keys(action_parameters),
+    ActionKeys = ActionTopLevelKeys ++ ActionParametersKeys,
+    ConnectorTopLevelKeys = schema_keys("config_connector"),
+    ConnectorKeys = maps:keys(BridgeV1Config) -- (ActionKeys -- ConnectorTopLevelKeys),
+    ConnConfig0 = maps:with(ConnectorKeys, BridgeV1Config),
+    emqx_utils_maps:update_if_present(
+        <<"resource_opts">>,
+        fun emqx_connector_schema:project_to_connector_resource_opts/1,
+        ConnConfig0
+    ).
+
+connector_action_config_to_bridge_v1_config(ConnectorRawConf, ActionRawConf) ->
+    RawConf = emqx_action_info:connector_action_config_to_bridge_v1_config(
+        ConnectorRawConf, ActionRawConf
+    ),
+    maps:without([<<"clickhouse_type">>], RawConf).
+
+bridge_v1_type_name() -> clickhouse.
+
+action_type_name() -> clickhouse.
+
+connector_type_name() -> clickhouse.
+
+schema_module() -> ?SCHEMA_MODULE.
+
+make_config_map(PickKeys, IndentKeys, Config) ->
+    Conf0 = maps:with(PickKeys, Config),
+    emqx_utils_maps:indent(<<"parameters">>, IndentKeys, Conf0).
+
+schema_keys(Name) ->
+    [bin(Key) || Key <- proplists:get_keys(?SCHEMA_MODULE:fields(Name))].
diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
index 0a6c504c7..e7327b56c 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse_connector.erl
@@ -32,6 +32,10 @@
     callback_mode/0,
     on_start/2,
     on_stop/2,
+    on_add_channel/4,
+    on_remove_channel/3,
+    on_get_channel_status/3,
+    on_get_channels/1,
     on_query/3,
     on_batch_query/3,
     on_get_status/2
@@ -62,6 +66,7 @@
 
 -type state() ::
     #{
+        channels => #{binary() => templates()},
         templates := templates(),
         pool_name := binary(),
         connect_timeout := pos_integer()
@@ -155,10 +160,9 @@ on_start(
         {pool, InstanceID}
     ],
     try
-        Templates = prepare_sql_templates(Config),
         State = #{
+            channels => #{},
             pool_name => InstanceID,
-            templates => Templates,
             connect_timeout => ConnectTimeout
         },
         case emqx_resource_pool:start(InstanceID, ?MODULE, Options) of
@@ -195,10 +199,8 @@ prepare_sql_templates(#{
     sql := Template,
     batch_value_separator := Separator
 }) ->
-    InsertTemplate =
-        emqx_placeholder:preproc_tmpl(Template),
-    BulkExtendInsertTemplate =
-        prepare_sql_bulk_extend_template(Template, Separator),
+    InsertTemplate = emqx_placeholder:preproc_tmpl(Template),
+    BulkExtendInsertTemplate = prepare_sql_bulk_extend_template(Template, Separator),
     #{
         send_message_template => InsertTemplate,
         extend_send_message_template => BulkExtendInsertTemplate
@@ -285,6 +287,27 @@ on_stop(InstanceID, _State) ->
     }),
     emqx_resource_pool:stop(InstanceID).
 
+%% -------------------------------------------------------------------
+%% channel related emqx_resouce callbacks
+%% -------------------------------------------------------------------
+on_add_channel(_InstId, #{channels := Channs} = OldState, ChannId, ChannConf0) ->
+    #{parameters := ParamConf} = ChannConf0,
+    NewChanns = Channs#{ChannId => #{templates => prepare_sql_templates(ParamConf)}},
+    {ok, OldState#{channels => NewChanns}}.
+
+on_remove_channel(_InstanceId, #{channels := Channels} = State, ChannId) ->
+    NewState = State#{channels => maps:remove(ChannId, Channels)},
+    {ok, NewState}.
+
+on_get_channel_status(InstanceId, _ChannId, State) ->
+    case on_get_status(InstanceId, State) of
+        {connected, _} -> connected;
+        {disconnected, _, _} -> disconnected
+    end.
+
+on_get_channels(InstanceId) ->
+    emqx_bridge_v2:get_channels_for_connector(InstanceId).
+
 %% -------------------------------------------------------------------
 %% on_get_status emqx_resouce callback and related functions
 %% -------------------------------------------------------------------
@@ -339,8 +362,8 @@ do_get_status(PoolName, Timeout) ->
 
 -spec on_query
     (resource_id(), Request, resource_state()) -> query_result() when
-        Request :: {RequestType, Data},
-        RequestType :: send_message,
+        Request :: {ChannId, Data},
+        ChannId :: binary(),
         Data :: map();
     (resource_id(), Request, resource_state()) -> query_result() when
         Request :: {RequestType, SQL},
@@ -361,12 +384,20 @@ on_query(
     }),
     %% Have we got a query or data to fit into an SQL template?
     SimplifiedRequestType = query_type(RequestType),
-    #{templates := Templates} = State,
+    Templates = get_templates(RequestType, State),
     SQL = get_sql(SimplifiedRequestType, Templates, DataOrSQL),
     ClickhouseResult = execute_sql_in_clickhouse_server(PoolName, SQL),
     transform_and_log_clickhouse_result(ClickhouseResult, ResourceID, SQL).
 
-get_sql(send_message, #{send_message_template := PreparedSQL}, Data) ->
+get_templates(ChannId, State) ->
+    case maps:find(channels, State) of
+        {ok, Channels} ->
+            maps:get(templates, maps:get(ChannId, Channels, #{}), #{});
+        error ->
+            #{}
+    end.
+
+get_sql(channel_message, #{send_message_template := PreparedSQL}, Data) ->
     emqx_placeholder:proc_tmpl(PreparedSQL, Data);
 get_sql(_, _, SQL) ->
     SQL.
@@ -376,24 +407,21 @@ query_type(sql) ->
 query_type(query) ->
     query;
 %% Data that goes to bridges use the prepared template
-query_type(send_message) ->
-    send_message.
+query_type(ChannId) when is_binary(ChannId) ->
+    channel_message.
 
 %% -------------------------------------------------------------------
 %% on_batch_query emqx_resouce callback and related functions
 %% -------------------------------------------------------------------
 
 -spec on_batch_query(resource_id(), BatchReq, resource_state()) -> query_result() when
-    BatchReq :: nonempty_list({'send_message', map()}).
+    BatchReq :: nonempty_list({binary(), map()}).
 
-on_batch_query(
-    ResourceID,
-    BatchReq,
-    #{pool_name := PoolName, templates := Templates} = _State
-) ->
-    %% Currently we only support batch requests with the send_message key
-    {Keys, ObjectsToInsert} = lists:unzip(BatchReq),
-    ensure_keys_are_of_type_send_message(Keys),
+on_batch_query(ResourceID, BatchReq, #{pool_name := PoolName} = State) ->
+    %% Currently we only support batch requests with a binary ChannId
+    {[ChannId | _] = Keys, ObjectsToInsert} = lists:unzip(BatchReq),
+    ensure_channel_messages(Keys),
+    Templates = get_templates(ChannId, State),
     %% Create batch insert SQL statement
     SQL = objects_to_sql(ObjectsToInsert, Templates),
     %% Do the actual query in the database
@@ -401,22 +429,16 @@ on_batch_query(
     %% Transform the result to a better format
     transform_and_log_clickhouse_result(ResultFromClickhouse, ResourceID, SQL).
 
-ensure_keys_are_of_type_send_message(Keys) ->
-    case lists:all(fun is_send_message_atom/1, Keys) of
+ensure_channel_messages(Keys) ->
+    case lists:all(fun is_binary/1, Keys) of
         true ->
             ok;
         false ->
             erlang:error(
-                {unrecoverable_error,
-                    <<"Unexpected type for batch message (Expected send_message)">>}
+                {unrecoverable_error, <<"Unexpected type for batch message (Expected channel-id)">>}
             )
     end.
 
-is_send_message_atom(send_message) ->
-    true;
-is_send_message_atom(_) ->
-    false.
-
 objects_to_sql(
     [FirstObject | RemainingObjects] = _ObjectsToInsert,
     #{
diff --git a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
index c0b0c365a..4679e1bc4 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_ee_schema.erl
@@ -42,6 +42,8 @@ resource_type(influxdb) ->
     emqx_bridge_influxdb_connector;
 resource_type(cassandra) ->
     emqx_bridge_cassandra_connector;
+resource_type(clickhouse) ->
+    emqx_bridge_clickhouse_connector;
 resource_type(mysql) ->
     emqx_bridge_mysql_connector;
 resource_type(pgsql) ->
@@ -181,6 +183,14 @@ connector_structs() ->
                     required => false
                 }
             )},
+        {clickhouse,
+            mk(
+                hoconsc:map(name, ref(emqx_bridge_clickhouse, "config_connector")),
+                #{
+                    desc => <<"ClickHouse Connector Config">>,
+                    required => false
+                }
+            )},
         {mysql,
             mk(
                 hoconsc:map(name, ref(emqx_bridge_mysql, "config_connector")),
@@ -307,6 +317,7 @@ schema_modules() ->
         emqx_bridge_oracle,
         emqx_bridge_influxdb,
         emqx_bridge_cassandra,
+        emqx_bridge_clickhouse,
         emqx_bridge_mysql,
         emqx_bridge_syskeeper_connector,
         emqx_bridge_syskeeper_proxy,
@@ -345,6 +356,7 @@ api_schemas(Method) ->
         api_ref(emqx_bridge_oracle, <<"oracle">>, Method ++ "_connector"),
         api_ref(emqx_bridge_influxdb, <<"influxdb">>, Method ++ "_connector"),
         api_ref(emqx_bridge_cassandra, <<"cassandra">>, Method ++ "_connector"),
+        api_ref(emqx_bridge_clickhouse, <<"clickhouse">>, Method ++ "_connector"),
         api_ref(emqx_bridge_mysql, <<"mysql">>, Method ++ "_connector"),
         api_ref(emqx_bridge_syskeeper_connector, <<"syskeeper_forwarder">>, Method),
         api_ref(emqx_bridge_syskeeper_proxy, <<"syskeeper_proxy">>, Method),
diff --git a/apps/emqx_connector/src/schema/emqx_connector_schema.erl b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
index 751efa3d9..27d7f6379 100644
--- a/apps/emqx_connector/src/schema/emqx_connector_schema.erl
+++ b/apps/emqx_connector/src/schema/emqx_connector_schema.erl
@@ -142,6 +142,8 @@ connector_type_to_bridge_types(influxdb) ->
     [influxdb, influxdb_api_v1, influxdb_api_v2];
 connector_type_to_bridge_types(cassandra) ->
     [cassandra];
+connector_type_to_bridge_types(clickhouse) ->
+    [clickhouse];
 connector_type_to_bridge_types(mysql) ->
     [mysql];
 connector_type_to_bridge_types(mqtt) ->
diff --git a/changes/ee/feat-19999.en.md b/changes/ee/feat-19999.en.md
new file mode 100644
index 000000000..943bf8442
--- /dev/null
+++ b/changes/ee/feat-19999.en.md
@@ -0,0 +1 @@
+The bridges for ClickHouse have been split so they are available via the connectors and actions APIs. They are still backwards compatible with the old bridge API.
diff --git a/rel/i18n/emqx_bridge_clickhouse.hocon b/rel/i18n/emqx_bridge_clickhouse.hocon
index 7d1961f98..929780fbe 100644
--- a/rel/i18n/emqx_bridge_clickhouse.hocon
+++ b/rel/i18n/emqx_bridge_clickhouse.hocon
@@ -6,6 +6,16 @@ batch_value_separator.desc:
 batch_value_separator.label:
 """Batch Value Separator"""
 
+action_parameters.desc:
+"""Action specific configs."""
+action_parameters.label:
+"""Action"""
+
+cassandra_action.desc:
+"""Action configs."""
+cassandra_action.label:
+"""Action"""
+
 config_enable.desc:
 """Enable or disable this bridge"""
 

From ec888bc87f65a76dbc616613aed90a5e752af239 Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Sun, 18 Feb 2024 09:41:43 +0800
Subject: [PATCH 258/273] ci: fix test cases for clickhouse

---
 changes/ee/{feat-19999.en.md => feat-12425.en.md} | 0
 rel/i18n/emqx_bridge_clickhouse.hocon             | 4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename changes/ee/{feat-19999.en.md => feat-12425.en.md} (100%)

diff --git a/changes/ee/feat-19999.en.md b/changes/ee/feat-12425.en.md
similarity index 100%
rename from changes/ee/feat-19999.en.md
rename to changes/ee/feat-12425.en.md
diff --git a/rel/i18n/emqx_bridge_clickhouse.hocon b/rel/i18n/emqx_bridge_clickhouse.hocon
index 929780fbe..2a77bba3e 100644
--- a/rel/i18n/emqx_bridge_clickhouse.hocon
+++ b/rel/i18n/emqx_bridge_clickhouse.hocon
@@ -11,9 +11,9 @@ action_parameters.desc:
 action_parameters.label:
 """Action"""
 
-cassandra_action.desc:
+clickhouse_action.desc:
 """Action configs."""
-cassandra_action.label:
+clickhouse_action.label:
 """Action"""
 
 config_enable.desc:

From 6aae3ba2edf0c2870870e132c9e8b6633d0e3d64 Mon Sep 17 00:00:00 2001
From: JimMoen <LnJimMoen@outlook.com>
Date: Sun, 18 Feb 2024 10:42:40 +0800
Subject: [PATCH 259/273] refactor(prom_test): assert fun prefix

---
 .../test/emqx_prometheus_data_SUITE.erl       | 89 +++++++++++--------
 1 file changed, 52 insertions(+), 37 deletions(-)

diff --git a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
index 95f303b82..ccb27e245 100644
--- a/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
+++ b/apps/emqx_prometheus/test/emqx_prometheus_data_SUITE.erl
@@ -257,7 +257,7 @@ assert_json_data(_, Data, Mode) ->
     ok.
 
 fun_name(Seed) ->
-    binary_to_atom(<<"assert_json_data_", (atom_to_binary(Seed))/binary>>).
+    binary_to_atom(<<"assert_json_data__", (atom_to_binary(Seed))/binary>>).
 
 %%--------------------------------------------------------------------
 %% Internal Functions
@@ -341,7 +341,7 @@ metric_meta(_) -> #{}.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%% Assert Json Data Structure
 
-assert_json_data_messages(M, Mode) when
+assert_json_data__messages(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -368,10 +368,10 @@ assert_json_data_messages(M, Mode) when
         M
     ),
     ok;
-assert_json_data_messages(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+assert_json_data__messages(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_stats(M, Mode) when
+assert_json_data__stats(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -402,18 +402,18 @@ assert_json_data_stats(M, Mode) when
         },
         M
     );
-assert_json_data_stats(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+assert_json_data__stats(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_olp(M, Mode) when
+assert_json_data__olp(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
     ?assertMatch(#{}, M);
-assert_json_data_olp(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+assert_json_data__olp(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
     ok.
 
-assert_json_data_client(M, Mode) when
+assert_json_data__client(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -431,10 +431,10 @@ assert_json_data_client(M, Mode) when
         },
         M
     );
-assert_json_data_client(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+assert_json_data__client(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_session(M, Mode) when
+assert_json_data__session(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -448,10 +448,10 @@ assert_json_data_session(M, Mode) when
         },
         M
     );
-assert_json_data_session(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
+assert_json_data__session(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when is_list(Ms) ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_metrics(M, ?PROM_DATA_MODE__NODE) ->
+assert_json_data__metrics(M, ?PROM_DATA_MODE__NODE) ->
     ?assertMatch(
         #{
             emqx_vm_cpu_use := _,
@@ -463,14 +463,14 @@ assert_json_data_metrics(M, ?PROM_DATA_MODE__NODE) ->
         },
         M
     );
-assert_json_data_metrics(Ms, Mode) when
+assert_json_data__metrics(Ms, Mode) when
     is_list(Ms) andalso
         (Mode =:= ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED orelse
             Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_delivery(M, Mode) when
+assert_json_data__delivery(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -485,12 +485,12 @@ assert_json_data_delivery(M, Mode) when
         },
         M
     );
-assert_json_data_delivery(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__delivery(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_cluster(M, Mode) when
+assert_json_data__cluster(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -498,12 +498,12 @@ assert_json_data_cluster(M, Mode) when
         #{emqx_cluster_nodes_running := _, emqx_cluster_nodes_stopped := _},
         M
     );
-assert_json_data_cluster(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__cluster(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_acl(M, Mode) when
+assert_json_data__acl(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -520,12 +520,12 @@ assert_json_data_acl(M, Mode) when
         },
         M
     );
-assert_json_data_acl(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__acl(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_authn(M, Mode) when
+assert_json_data__authn(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -537,12 +537,12 @@ assert_json_data_authn(M, Mode) when
         },
         M
     );
-assert_json_data_authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
-assert_json_data_packets(M, Mode) when
+assert_json_data__packets(M, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -593,13 +593,13 @@ assert_json_data_packets(M, Mode) when
         },
         M
     );
-assert_json_data_packets(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__packets(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     eval_foreach_assert(?FUNCTION_NAME, Ms).
 
 %% certs always return json list
-assert_json_data_certs(Ms, _) ->
+assert_json_data__certs(Ms, _) ->
     lists:foreach(
         fun(M) ->
             ?assertMatch(
@@ -625,17 +625,17 @@ eval_foreach_assert(FunctionName, Ms) ->
 
 -if(?EMQX_RELEASE_EDITION == ee).
 %% license always map
-assert_json_data_license(M, _) ->
+assert_json_data__license(M, _) ->
     ?assertMatch(#{emqx_license_expiry_at := _}, M).
 -else.
 -endif.
 
 -define(assert_node_foreach(Ms), lists:foreach(fun(M) -> ?assertMatch(#{node := _}, M) end, Ms)).
 
-assert_json_data_emqx_banned(M, _) ->
+assert_json_data__emqx_banned(M, _) ->
     ?assertMatch(#{emqx_banned_count := _}, M).
 
-assert_json_data_emqx_authn(Ms, Mode) when
+assert_json_data__emqx_authn(Ms, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -657,10 +657,13 @@ assert_json_data_emqx_authn(Ms, Mode) when
         end,
         Ms
     );
-assert_json_data_emqx_authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
+assert_json_data__emqx_authn(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
     ?assert_node_foreach(Ms).
 
-assert_json_data_emqx_authz(Ms, _) ->
+assert_json_data__emqx_authz(Ms, Mode) when
+    (Mode =:= ?PROM_DATA_MODE__NODE orelse
+        Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
+->
     lists:foreach(
         fun(M) ->
             ?assertMatch(
@@ -679,10 +682,10 @@ assert_json_data_emqx_authz(Ms, _) ->
         end,
         Ms
     );
-assert_json_data_emqx_authz(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
+assert_json_data__emqx_authz(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) ->
     ?assert_node_foreach(Ms).
 
-assert_json_data_rules(Ms, Mode) when
+assert_json_data__rules(Ms, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -708,12 +711,12 @@ assert_json_data_rules(Ms, Mode) when
         end,
         Ms
     );
-assert_json_data_rules(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__rules(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     ?assert_node_foreach(Ms).
 
-assert_json_data_actions(Ms, Mode) when
+assert_json_data__actions(Ms, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -746,12 +749,12 @@ assert_json_data_actions(Ms, Mode) when
         end,
         Ms
     );
-assert_json_data_actions(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__actions(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     ?assert_node_foreach(Ms).
 
-assert_json_data_connectors(Ms, Mode) when
+assert_json_data__connectors(Ms, Mode) when
     (Mode =:= ?PROM_DATA_MODE__NODE orelse
         Mode =:= ?PROM_DATA_MODE__ALL_NODES_AGGREGATED)
 ->
@@ -768,12 +771,13 @@ assert_json_data_connectors(Ms, Mode) when
         end,
         Ms
     );
-assert_json_data_connectors(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
+assert_json_data__connectors(Ms, ?PROM_DATA_MODE__ALL_NODES_UNAGGREGATED) when
     is_list(Ms)
 ->
     ?assert_node_foreach(Ms).
 
-assert_json_data_data_integration_overview(M, _) ->
+-if(?EMQX_RELEASE_EDITION == ee).
+assert_json_data__data_integration_overview(M, _) ->
     ?assertMatch(
         #{
             emqx_connectors_count := _,
@@ -783,5 +787,16 @@ assert_json_data_data_integration_overview(M, _) ->
         M
     ).
 
+-else.
+assert_json_data__data_integration_overview(M, _) ->
+    ?assertMatch(
+        #{
+            emqx_connectors_count := _,
+            emqx_rules_count := _
+        },
+        M
+    ).
+-endif.
+
 stop_apps(Apps) ->
     lists:foreach(fun application:stop/1, Apps).

From ce0c27e80276d0c4dde12f4e28473b69b9eefcea Mon Sep 17 00:00:00 2001
From: Shawn <506895667@qq.com>
Date: Sun, 18 Feb 2024 14:49:58 +0800
Subject: [PATCH 260/273] fix: correct the swagger example for clickhouse
 connectors

---
 apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
index 11f5fff5a..1c7e786d8 100644
--- a/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
+++ b/apps/emqx_bridge_clickhouse/src/emqx_bridge_clickhouse.erl
@@ -66,7 +66,7 @@ connector_examples(Method) ->
                 summary => <<"ClickHouse Connector">>,
                 value => emqx_connector_schema:connector_values(
                     Method, clickhouse, #{
-                        server => <<"127.0.0.1:8123">>,
+                        url => <<"http://localhost:8123">>,
                         database => <<"mqtt">>,
                         pool_size => 8,
                         username => <<"default">>,

From 22dabcb3eabc7afc95afd4989654ab01666ba90f Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Sat, 17 Feb 2024 11:08:30 +0100
Subject: [PATCH 261/273] feat(mqtt): add more logging context for
 frame_too_large error

---
 apps/emqx/src/emqx_channel.erl        | 12 +++++++++---
 apps/emqx/src/emqx_frame.erl          |  4 ++--
 apps/emqx/src/emqx_packet.erl         |  2 +-
 apps/emqx/test/emqx_channel_SUITE.erl | 23 +++++++++++++++++------
 apps/emqx/test/emqx_frame_SUITE.erl   |  4 ++--
 5 files changed, 31 insertions(+), 14 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 130ec99c8..9b57f25cd 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -540,13 +540,17 @@ handle_in(?AUTH_PACKET(), Channel) ->
     handle_out(disconnect, ?RC_IMPLEMENTATION_SPECIFIC_ERROR, Channel);
 handle_in({frame_error, Reason}, Channel = #channel{conn_state = idle}) ->
     shutdown(shutdown_count(frame_error, Reason), Channel);
-handle_in({frame_error, frame_too_large}, Channel = #channel{conn_state = connecting}) ->
+handle_in(
+    {frame_error, #{hint := frame_too_large} = R}, Channel = #channel{conn_state = connecting}
+) ->
     shutdown(
-        shutdown_count(frame_error, frame_too_large), ?CONNACK_PACKET(?RC_PACKET_TOO_LARGE), Channel
+        shutdown_count(frame_error, R), ?CONNACK_PACKET(?RC_PACKET_TOO_LARGE), Channel
     );
 handle_in({frame_error, Reason}, Channel = #channel{conn_state = connecting}) ->
     shutdown(shutdown_count(frame_error, Reason), ?CONNACK_PACKET(?RC_MALFORMED_PACKET), Channel);
-handle_in({frame_error, frame_too_large}, Channel = #channel{conn_state = ConnState}) when
+handle_in(
+    {frame_error, #{hint := frame_too_large}}, Channel = #channel{conn_state = ConnState}
+) when
     ConnState =:= connected orelse ConnState =:= reauthenticating
 ->
     handle_out(disconnect, {?RC_PACKET_TOO_LARGE, frame_too_large}, Channel);
@@ -2327,6 +2331,8 @@ shutdown(Reason, Reply, Packet, Channel) ->
 
 %% process exits with {shutdown, #{shutdown_count := Kind}} will trigger
 %% the connection supervisor (esockd) to keep a shutdown-counter grouped by Kind
+shutdown_count(_Kind, #{hint := Hint} = Reason) when is_atom(Hint) ->
+    Reason#{shutdown_count => Hint};
 shutdown_count(Kind, Reason) when is_map(Reason) ->
     Reason#{shutdown_count => Kind};
 shutdown_count(Kind, Reason) ->
diff --git a/apps/emqx/src/emqx_frame.erl b/apps/emqx/src/emqx_frame.erl
index 22170b6de..c5ce7dc8f 100644
--- a/apps/emqx/src/emqx_frame.erl
+++ b/apps/emqx/src/emqx_frame.erl
@@ -168,7 +168,7 @@ parse_remaining_len(Rest, Header, Options) ->
 parse_remaining_len(_Bin, _Header, _Multiplier, Length, #{max_size := MaxSize}) when
     Length > MaxSize
 ->
-    ?PARSE_ERR(frame_too_large);
+    ?PARSE_ERR(#{hint => frame_too_large, limit => MaxSize, received => Length});
 parse_remaining_len(<<>>, Header, Multiplier, Length, Options) ->
     {more, {{len, #{hdr => Header, len => {Multiplier, Length}}}, Options}};
 %% Match DISCONNECT without payload
@@ -213,7 +213,7 @@ parse_remaining_len(
 ) ->
     FrameLen = Value + Len * Multiplier,
     case FrameLen > MaxSize of
-        true -> ?PARSE_ERR(frame_too_large);
+        true -> ?PARSE_ERR(#{hint => frame_too_large, limit => MaxSize, received => FrameLen});
         false -> parse_frame(Rest, Header, FrameLen, Options)
     end.
 
diff --git a/apps/emqx/src/emqx_packet.erl b/apps/emqx/src/emqx_packet.erl
index 542dc8b3b..29c13d99e 100644
--- a/apps/emqx/src/emqx_packet.erl
+++ b/apps/emqx/src/emqx_packet.erl
@@ -493,7 +493,7 @@ format(#mqtt_packet{header = Header, variable = Variable, payload = Payload}, Pa
         "" -> [HeaderIO, ")"];
         VarIO -> [HeaderIO, ", ", VarIO, ")"]
     end;
-%% receive a frame error packet, such as {frame_error,frame_too_large} or
+%% receive a frame error packet, such as {frame_error,#{hint := frame_too_large}} or
 %% {frame_error,#{expected => <<"'MQTT' or 'MQIsdp'">>,hint => invalid_proto_name,received => <<"bad_name">>}}
 format(FrameError, _PayloadEncode) ->
     lists:flatten(io_lib:format("~tp", [FrameError])).
diff --git a/apps/emqx/test/emqx_channel_SUITE.erl b/apps/emqx/test/emqx_channel_SUITE.erl
index ca038ac85..dfee02dc1 100644
--- a/apps/emqx/test/emqx_channel_SUITE.erl
+++ b/apps/emqx/test/emqx_channel_SUITE.erl
@@ -427,19 +427,30 @@ t_handle_in_auth(_) ->
 
 t_handle_in_frame_error(_) ->
     IdleChannel = channel(#{conn_state => idle}),
-    {shutdown, #{shutdown_count := frame_error, reason := frame_too_large}, _Chan} =
-        emqx_channel:handle_in({frame_error, frame_too_large}, IdleChannel),
+    {shutdown, #{shutdown_count := frame_too_large, hint := frame_too_large}, _Chan} =
+        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, IdleChannel),
     ConnectingChan = channel(#{conn_state => connecting}),
     ConnackPacket = ?CONNACK_PACKET(?RC_PACKET_TOO_LARGE),
-    {shutdown, #{shutdown_count := frame_error, reason := frame_too_large}, ConnackPacket, _} =
-        emqx_channel:handle_in({frame_error, frame_too_large}, ConnectingChan),
+    {shutdown,
+        #{
+            shutdown_count := frame_too_large,
+            hint := frame_too_large,
+            limit := 100,
+            received := 101
+        },
+        ConnackPacket,
+        _} =
+        emqx_channel:handle_in(
+            {frame_error, #{reason => frame_too_large, received => 101, limit => 100}},
+            ConnectingChan
+        ),
     DisconnectPacket = ?DISCONNECT_PACKET(?RC_PACKET_TOO_LARGE),
     ConnectedChan = channel(#{conn_state => connected}),
     {ok, [{outgoing, DisconnectPacket}, {close, frame_too_large}], _} =
-        emqx_channel:handle_in({frame_error, frame_too_large}, ConnectedChan),
+        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, ConnectedChan),
     DisconnectedChan = channel(#{conn_state => disconnected}),
     {ok, DisconnectedChan} =
-        emqx_channel:handle_in({frame_error, frame_too_large}, DisconnectedChan).
+        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, DisconnectedChan).
 
 t_handle_in_expected_packet(_) ->
     Packet = ?DISCONNECT_PACKET(?RC_PROTOCOL_ERROR),
diff --git a/apps/emqx/test/emqx_frame_SUITE.erl b/apps/emqx/test/emqx_frame_SUITE.erl
index 23e8972e9..935a0d8ec 100644
--- a/apps/emqx/test/emqx_frame_SUITE.erl
+++ b/apps/emqx/test/emqx_frame_SUITE.erl
@@ -138,8 +138,8 @@ t_parse_cont(_) ->
 
 t_parse_frame_too_large(_) ->
     Packet = ?PUBLISH_PACKET(?QOS_1, <<"t">>, 1, payload(1000)),
-    ?ASSERT_FRAME_THROW(frame_too_large, parse_serialize(Packet, #{max_size => 256})),
-    ?ASSERT_FRAME_THROW(frame_too_large, parse_serialize(Packet, #{max_size => 512})),
+    ?ASSERT_FRAME_THROW(#{hint := frame_too_large}, parse_serialize(Packet, #{max_size => 256})),
+    ?ASSERT_FRAME_THROW(#{hint := frame_too_large}, parse_serialize(Packet, #{max_size => 512})),
     ?assertEqual(Packet, parse_serialize(Packet, #{max_size => 2048, version => ?MQTT_PROTO_V4})).
 
 t_parse_frame_malformed_variable_byte_integer(_) ->

From 668d3be39032af1c67406983f3928f5309521a4d Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Sun, 18 Feb 2024 19:23:35 +0100
Subject: [PATCH 262/273] test: for better test coverage

---
 apps/emqx/src/emqx_frame.erl        | 28 +++++++++++-------
 apps/emqx/test/emqx_frame_SUITE.erl | 46 ++++++++++++++++++++++++-----
 2 files changed, 56 insertions(+), 18 deletions(-)

diff --git a/apps/emqx/src/emqx_frame.erl b/apps/emqx/src/emqx_frame.erl
index c5ce7dc8f..c8283f594 100644
--- a/apps/emqx/src/emqx_frame.erl
+++ b/apps/emqx/src/emqx_frame.erl
@@ -330,10 +330,14 @@ parse_connect2(
         <<>> ->
             ConnPacket1#mqtt_packet_connect{username = Username, password = Password};
         _ ->
-            ?PARSE_ERR(malformed_connect_data)
+            ?PARSE_ERR(#{
+                hint => malformed_connect,
+                unexpected_trailing_bytes => size(Rest7)
+            })
     end;
-parse_connect2(_ProtoName, _, _) ->
-    ?PARSE_ERR(malformed_connect_header).
+parse_connect2(_ProtoName, Bin, _StrictMode) ->
+    %% sent less than 32 bytes
+    ?PARSE_ERR(#{hint => malformed_connect, header_bytes => Bin}).
 
 parse_packet(
     #mqtt_packet_header{type = ?CONNECT},
@@ -486,7 +490,7 @@ parse_will_message(
 ) ->
     {Props, Rest} = parse_properties(Bin, Ver, StrictMode),
     {Topic, Rest1} = parse_utf8_string_with_hint(Rest, StrictMode, invalid_topic),
-    {Payload, Rest2} = parse_binary_data(Rest1),
+    {Payload, Rest2} = parse_will_payload(Rest1),
     {
         Packet#mqtt_packet_connect{
             will_props = Props,
@@ -687,20 +691,24 @@ parse_utf8_string(Bin, _) when
 ->
     ?PARSE_ERR(#{reason => malformed_utf8_string_length}).
 
-parse_binary_data(<<Len:16/big, Data:Len/binary, Rest/binary>>) ->
+parse_will_payload(<<Len:16/big, Data:Len/binary, Rest/binary>>) ->
     {Data, Rest};
-parse_binary_data(<<Len:16/big, Rest/binary>>) when
+parse_will_payload(<<Len:16/big, Rest/binary>>) when
     Len > byte_size(Rest)
 ->
     ?PARSE_ERR(#{
-        hint => malformed_binary_data,
+        hint => malformed_will_payload,
         parsed_length => Len,
-        remaining_bytes_length => byte_size(Rest)
+        remaining_bytes => byte_size(Rest)
     });
-parse_binary_data(Bin) when
+parse_will_payload(Bin) when
     2 > byte_size(Bin)
 ->
-    ?PARSE_ERR(malformed_binary_data_length).
+    ?PARSE_ERR(#{
+        hint => malformed_will_payload,
+        length_bytes => size(Bin),
+        expected_bytes => 2
+    }).
 
 %%--------------------------------------------------------------------
 %% Serialize MQTT Packet
diff --git a/apps/emqx/test/emqx_frame_SUITE.erl b/apps/emqx/test/emqx_frame_SUITE.erl
index 935a0d8ec..52c513985 100644
--- a/apps/emqx/test/emqx_frame_SUITE.erl
+++ b/apps/emqx/test/emqx_frame_SUITE.erl
@@ -57,11 +57,12 @@ groups() ->
             t_serialize_parse_v5_connect,
             t_serialize_parse_connect_without_clientid,
             t_serialize_parse_connect_with_will,
+            t_serialize_parse_connect_with_malformed_will,
             t_serialize_parse_bridge_connect,
             t_parse_invalid_remaining_len,
             t_parse_malformed_properties,
             t_malformed_connect_header,
-            t_malformed_connect_payload,
+            t_malformed_connect_data,
             t_reserved_connect_flag,
             t_invalid_clientid
         ]},
@@ -277,6 +278,37 @@ t_serialize_parse_connect_with_will(_) ->
     ?assertEqual(Bin, serialize_to_binary(Packet)),
     ?assertMatch({ok, Packet, <<>>, _}, emqx_frame:parse(Bin)).
 
+t_serialize_parse_connect_with_malformed_will(_) ->
+    Packet2 = #mqtt_packet{
+        header = #mqtt_packet_header{type = ?CONNECT},
+        variable = #mqtt_packet_connect{
+            proto_ver = ?MQTT_PROTO_V3,
+            proto_name = <<"MQIsdp">>,
+            clientid = <<"mosqpub/10452-iMac.loca">>,
+            clean_start = true,
+            keepalive = 60,
+            will_retain = false,
+            will_qos = ?QOS_1,
+            will_flag = true,
+            will_topic = <<"/will">>,
+            will_payload = <<>>
+        }
+    },
+    <<16, 46, Body:44/binary, 0, 0>> = serialize_to_binary(Packet2),
+    %% too short
+    BadBin1 = <<16, 45, Body/binary, 0>>,
+    ?ASSERT_FRAME_THROW(
+        #{hint := malformed_will_payload, length_bytes := 1, expected_bytes := 2},
+        emqx_frame:parse(BadBin1)
+    ),
+    %% too long
+    BadBin2 = <<16, 47, Body/binary, 0, 2, 0>>,
+    ?ASSERT_FRAME_THROW(
+        #{hint := malformed_will_payload, parsed_length := 2, remaining_bytes := 1},
+        emqx_frame:parse(BadBin2)
+    ),
+    ok.
+
 t_serialize_parse_bridge_connect(_) ->
     Bin =
         <<16, 86, 0, 6, 77, 81, 73, 115, 100, 112, 131, 44, 0, 60, 0, 19, 67, 95, 48, 48, 58, 48,
@@ -643,16 +675,14 @@ t_parse_malformed_properties(_) ->
     ).
 
 t_malformed_connect_header(_) ->
-    ?assertException(
-        throw,
-        {frame_parse_error, malformed_connect_header},
+    ?ASSERT_FRAME_THROW(
+        #{hint := malformed_connect, header_bytes := _},
         emqx_frame:parse(<<16, 11, 0, 6, 77, 81, 73, 115, 100, 112, 3, 130, 1, 6>>)
     ).
 
-t_malformed_connect_payload(_) ->
-    ?assertException(
-        throw,
-        {frame_parse_error, malformed_connect_data},
+t_malformed_connect_data(_) ->
+    ?ASSERT_FRAME_THROW(
+        #{hint := malformed_connect, unexpected_trailing_bytes := _},
         emqx_frame:parse(<<16, 15, 0, 6, 77, 81, 73, 115, 100, 112, 3, 0, 0, 0, 0, 0, 0>>)
     ).
 

From 29c5c37f82e59737ff96a567d964fd41e20431a9 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Sun, 18 Feb 2024 19:30:35 +0100
Subject: [PATCH 263/273] docs: add changelog for PR 12530

---
 changes/ce/fix-12530.en.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changes/ce/fix-12530.en.md

diff --git a/changes/ce/fix-12530.en.md b/changes/ce/fix-12530.en.md
new file mode 100644
index 000000000..cbf294f84
--- /dev/null
+++ b/changes/ce/fix-12530.en.md
@@ -0,0 +1 @@
+Enhanced `frame_too_large` and malformed CONNECT packet parse failures to include more information to help troubleshooting.

From 8b0e15e4020760cff017a74e8431c608ac8643f2 Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Sun, 18 Feb 2024 19:46:45 +0100
Subject: [PATCH 264/273] refactor: rename 'hint' to 'cause' for MQTT fram
 parse failure reason

'reason' is maybe the wrapping field's name, so it was not used.
'hint' however, per our logging convention, is usually a free text
description for human to read.
change to 'cause' here because the field is always an atom and
it's use as shutdown counter in esockd_connection_sup
---
 apps/emqx/src/emqx_channel.erl              |  8 +--
 apps/emqx/src/emqx_frame.erl                | 60 ++++++++++-----------
 apps/emqx/src/emqx_packet.erl               |  4 +-
 apps/emqx/test/emqx_channel_SUITE.erl       | 16 +++---
 apps/emqx/test/emqx_frame_SUITE.erl         | 20 +++----
 apps/emqx/test/emqx_ws_connection_SUITE.erl |  2 +-
 6 files changed, 57 insertions(+), 53 deletions(-)

diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 9b57f25cd..658bc7bbb 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -541,7 +541,7 @@ handle_in(?AUTH_PACKET(), Channel) ->
 handle_in({frame_error, Reason}, Channel = #channel{conn_state = idle}) ->
     shutdown(shutdown_count(frame_error, Reason), Channel);
 handle_in(
-    {frame_error, #{hint := frame_too_large} = R}, Channel = #channel{conn_state = connecting}
+    {frame_error, #{cause := frame_too_large} = R}, Channel = #channel{conn_state = connecting}
 ) ->
     shutdown(
         shutdown_count(frame_error, R), ?CONNACK_PACKET(?RC_PACKET_TOO_LARGE), Channel
@@ -549,7 +549,7 @@ handle_in(
 handle_in({frame_error, Reason}, Channel = #channel{conn_state = connecting}) ->
     shutdown(shutdown_count(frame_error, Reason), ?CONNACK_PACKET(?RC_MALFORMED_PACKET), Channel);
 handle_in(
-    {frame_error, #{hint := frame_too_large}}, Channel = #channel{conn_state = ConnState}
+    {frame_error, #{cause := frame_too_large}}, Channel = #channel{conn_state = ConnState}
 ) when
     ConnState =:= connected orelse ConnState =:= reauthenticating
 ->
@@ -2331,8 +2331,8 @@ shutdown(Reason, Reply, Packet, Channel) ->
 
 %% process exits with {shutdown, #{shutdown_count := Kind}} will trigger
 %% the connection supervisor (esockd) to keep a shutdown-counter grouped by Kind
-shutdown_count(_Kind, #{hint := Hint} = Reason) when is_atom(Hint) ->
-    Reason#{shutdown_count => Hint};
+shutdown_count(_Kind, #{cause := Cause} = Reason) when is_atom(Cause) ->
+    Reason#{shutdown_count => Cause};
 shutdown_count(Kind, Reason) when is_map(Reason) ->
     Reason#{shutdown_count => Kind};
 shutdown_count(Kind, Reason) ->
diff --git a/apps/emqx/src/emqx_frame.erl b/apps/emqx/src/emqx_frame.erl
index c8283f594..b912abcd1 100644
--- a/apps/emqx/src/emqx_frame.erl
+++ b/apps/emqx/src/emqx_frame.erl
@@ -168,7 +168,7 @@ parse_remaining_len(Rest, Header, Options) ->
 parse_remaining_len(_Bin, _Header, _Multiplier, Length, #{max_size := MaxSize}) when
     Length > MaxSize
 ->
-    ?PARSE_ERR(#{hint => frame_too_large, limit => MaxSize, received => Length});
+    ?PARSE_ERR(#{cause => frame_too_large, limit => MaxSize, received => Length});
 parse_remaining_len(<<>>, Header, Multiplier, Length, Options) ->
     {more, {{len, #{hdr => Header, len => {Multiplier, Length}}}, Options}};
 %% Match DISCONNECT without payload
@@ -189,12 +189,12 @@ parse_remaining_len(
 parse_remaining_len(
     <<0:8, _Rest/binary>>, _Header = #mqtt_packet_header{type = ?PINGRESP}, 1, 0, _Options
 ) ->
-    ?PARSE_ERR(#{hint => unexpected_packet, header_type => 'PINGRESP'});
+    ?PARSE_ERR(#{cause => unexpected_packet, header_type => 'PINGRESP'});
 %% All other types of messages should not have a zero remaining length.
 parse_remaining_len(
     <<0:8, _Rest/binary>>, Header, 1, 0, _Options
 ) ->
-    ?PARSE_ERR(#{hint => zero_remaining_len, header_type => Header#mqtt_packet_header.type});
+    ?PARSE_ERR(#{cause => zero_remaining_len, header_type => Header#mqtt_packet_header.type});
 %% Match PUBACK, PUBREC, PUBREL, PUBCOMP, UNSUBACK...
 parse_remaining_len(<<0:1, 2:7, Rest/binary>>, Header, 1, 0, Options) ->
     parse_frame(Rest, Header, 2, Options);
@@ -213,7 +213,7 @@ parse_remaining_len(
 ) ->
     FrameLen = Value + Len * Multiplier,
     case FrameLen > MaxSize of
-        true -> ?PARSE_ERR(#{hint => frame_too_large, limit => MaxSize, received => FrameLen});
+        true -> ?PARSE_ERR(#{cause => frame_too_large, limit => MaxSize, received => FrameLen});
         false -> parse_frame(Rest, Header, FrameLen, Options)
     end.
 
@@ -267,7 +267,7 @@ packet(Header, Variable, Payload) ->
     #mqtt_packet{header = Header, variable = Variable, payload = Payload}.
 
 parse_connect(FrameBin, StrictMode) ->
-    {ProtoName, Rest} = parse_utf8_string_with_hint(FrameBin, StrictMode, invalid_proto_name),
+    {ProtoName, Rest} = parse_utf8_string_with_cause(FrameBin, StrictMode, invalid_proto_name),
     case ProtoName of
         <<"MQTT">> ->
             ok;
@@ -277,7 +277,7 @@ parse_connect(FrameBin, StrictMode) ->
             %% from spec: the server MAY send disconnect with reason code 0x84
             %% we chose to close socket because the client is likely not talking MQTT anyway
             ?PARSE_ERR(#{
-                hint => invalid_proto_name,
+                cause => invalid_proto_name,
                 expected => <<"'MQTT' or 'MQIsdp'">>,
                 received => ProtoName
             })
@@ -296,7 +296,7 @@ parse_connect2(
         1 -> ?PARSE_ERR(reserved_connect_flag)
     end,
     {Properties, Rest3} = parse_properties(Rest2, ProtoVer, StrictMode),
-    {ClientId, Rest4} = parse_utf8_string_with_hint(Rest3, StrictMode, invalid_clientid),
+    {ClientId, Rest4} = parse_utf8_string_with_cause(Rest3, StrictMode, invalid_clientid),
     ConnPacket = #mqtt_packet_connect{
         proto_name = ProtoName,
         proto_ver = ProtoVer,
@@ -315,14 +315,14 @@ parse_connect2(
     {Username, Rest6} = parse_optional(
         Rest5,
         fun(Bin) ->
-            parse_utf8_string_with_hint(Bin, StrictMode, invalid_username)
+            parse_utf8_string_with_cause(Bin, StrictMode, invalid_username)
         end,
         bool(UsernameFlag)
     ),
     {Password, Rest7} = parse_optional(
         Rest6,
         fun(Bin) ->
-            parse_utf8_string_with_hint(Bin, StrictMode, invalid_password)
+            parse_utf8_string_with_cause(Bin, StrictMode, invalid_password)
         end,
         bool(PasswordFlag)
     ),
@@ -331,13 +331,13 @@ parse_connect2(
             ConnPacket1#mqtt_packet_connect{username = Username, password = Password};
         _ ->
             ?PARSE_ERR(#{
-                hint => malformed_connect,
+                cause => malformed_connect,
                 unexpected_trailing_bytes => size(Rest7)
             })
     end;
 parse_connect2(_ProtoName, Bin, _StrictMode) ->
     %% sent less than 32 bytes
-    ?PARSE_ERR(#{hint => malformed_connect, header_bytes => Bin}).
+    ?PARSE_ERR(#{cause => malformed_connect, header_bytes => Bin}).
 
 parse_packet(
     #mqtt_packet_header{type = ?CONNECT},
@@ -366,7 +366,7 @@ parse_packet(
     Bin,
     #{strict_mode := StrictMode, version := Ver}
 ) ->
-    {TopicName, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_topic),
+    {TopicName, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_topic),
     {PacketId, Rest1} =
         case QoS of
             ?QOS_0 -> {undefined, Rest};
@@ -478,7 +478,7 @@ parse_packet(
     {Properties, <<>>} = parse_properties(Rest, ?MQTT_PROTO_V5, StrictMode),
     #mqtt_packet_auth{reason_code = ReasonCode, properties = Properties};
 parse_packet(Header, _FrameBin, _Options) ->
-    ?PARSE_ERR(#{hint => malformed_packet, header_type => Header#mqtt_packet_header.type}).
+    ?PARSE_ERR(#{cause => malformed_packet, header_type => Header#mqtt_packet_header.type}).
 
 parse_will_message(
     Packet = #mqtt_packet_connect{
@@ -489,7 +489,7 @@ parse_will_message(
     StrictMode
 ) ->
     {Props, Rest} = parse_properties(Bin, Ver, StrictMode),
-    {Topic, Rest1} = parse_utf8_string_with_hint(Rest, StrictMode, invalid_topic),
+    {Topic, Rest1} = parse_utf8_string_with_cause(Rest, StrictMode, invalid_topic),
     {Payload, Rest2} = parse_will_payload(Rest1),
     {
         Packet#mqtt_packet_connect{
@@ -522,7 +522,7 @@ parse_properties(Bin, ?MQTT_PROTO_V5, StrictMode) ->
             {parse_property(PropsBin, #{}, StrictMode), Rest1};
         _ ->
             ?PARSE_ERR(#{
-                hint => user_property_not_enough_bytes,
+                cause => user_property_not_enough_bytes,
                 parsed_key_length => Len,
                 remaining_bytes_length => byte_size(Rest)
             })
@@ -535,10 +535,10 @@ parse_property(<<16#01, Val, Bin/binary>>, Props, StrictMode) ->
 parse_property(<<16#02, Val:32/big, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Message-Expiry-Interval' => Val}, StrictMode);
 parse_property(<<16#03, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_content_type),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_content_type),
     parse_property(Rest, Props#{'Content-Type' => Val}, StrictMode);
 parse_property(<<16#08, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_response_topic),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_response_topic),
     parse_property(Rest, Props#{'Response-Topic' => Val}, StrictMode);
 parse_property(<<16#09, Len:16/big, Val:Len/binary, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Correlation-Data' => Val}, StrictMode);
@@ -548,12 +548,12 @@ parse_property(<<16#0B, Bin/binary>>, Props, StrictMode) ->
 parse_property(<<16#11, Val:32/big, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Session-Expiry-Interval' => Val}, StrictMode);
 parse_property(<<16#12, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_assigned_client_id),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_assigned_client_id),
     parse_property(Rest, Props#{'Assigned-Client-Identifier' => Val}, StrictMode);
 parse_property(<<16#13, Val:16, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Server-Keep-Alive' => Val}, StrictMode);
 parse_property(<<16#15, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_authn_method),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_authn_method),
     parse_property(Rest, Props#{'Authentication-Method' => Val}, StrictMode);
 parse_property(<<16#16, Len:16/big, Val:Len/binary, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Authentication-Data' => Val}, StrictMode);
@@ -564,13 +564,13 @@ parse_property(<<16#18, Val:32, Bin/binary>>, Props, StrictMode) ->
 parse_property(<<16#19, Val, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Request-Response-Information' => Val}, StrictMode);
 parse_property(<<16#1A, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_response_info),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_response_info),
     parse_property(Rest, Props#{'Response-Information' => Val}, StrictMode);
 parse_property(<<16#1C, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_server_reference),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_server_reference),
     parse_property(Rest, Props#{'Server-Reference' => Val}, StrictMode);
 parse_property(<<16#1F, Bin/binary>>, Props, StrictMode) ->
-    {Val, Rest} = parse_utf8_string_with_hint(Bin, StrictMode, invalid_reason_string),
+    {Val, Rest} = parse_utf8_string_with_cause(Bin, StrictMode, invalid_reason_string),
     parse_property(Rest, Props#{'Reason-String' => Val}, StrictMode);
 parse_property(<<16#21, Val:16/big, Bin/binary>>, Props, StrictMode) ->
     parse_property(Bin, Props#{'Receive-Maximum' => Val}, StrictMode);
@@ -639,7 +639,7 @@ parse_utf8_pair(<<LenK:16/big, Rest/binary>>, _StrictMode) when
     LenK > byte_size(Rest)
 ->
     ?PARSE_ERR(#{
-        hint => user_property_not_enough_bytes,
+        cause => user_property_not_enough_bytes,
         parsed_key_length => LenK,
         remaining_bytes_length => byte_size(Rest)
     });
@@ -648,7 +648,7 @@ parse_utf8_pair(<<LenK:16/big, _Key:LenK/binary, LenV:16/big, Rest/binary>>, _St
     LenV > byte_size(Rest)
 ->
     ?PARSE_ERR(#{
-        hint => malformed_user_property_value,
+        cause => malformed_user_property_value,
         parsed_key_length => LenK,
         parsed_value_length => LenV,
         remaining_bytes_length => byte_size(Rest)
@@ -657,16 +657,16 @@ parse_utf8_pair(Bin, _StrictMode) when
     4 > byte_size(Bin)
 ->
     ?PARSE_ERR(#{
-        hint => user_property_not_enough_bytes,
+        cause => user_property_not_enough_bytes,
         total_bytes => byte_size(Bin)
     }).
 
-parse_utf8_string_with_hint(Bin, StrictMode, Hint) ->
+parse_utf8_string_with_cause(Bin, StrictMode, Cause) ->
     try
         parse_utf8_string(Bin, StrictMode)
     catch
         throw:{?FRAME_PARSE_ERROR, Reason} when is_map(Reason) ->
-            ?PARSE_ERR(Reason#{hint => Hint})
+            ?PARSE_ERR(Reason#{cause => Cause})
     end.
 
 parse_optional(Bin, F, true) ->
@@ -682,7 +682,7 @@ parse_utf8_string(<<Len:16/big, Rest/binary>>, _) when
     Len > byte_size(Rest)
 ->
     ?PARSE_ERR(#{
-        hint => malformed_utf8_string,
+        cause => malformed_utf8_string,
         parsed_length => Len,
         remaining_bytes_length => byte_size(Rest)
     });
@@ -697,7 +697,7 @@ parse_will_payload(<<Len:16/big, Rest/binary>>) when
     Len > byte_size(Rest)
 ->
     ?PARSE_ERR(#{
-        hint => malformed_will_payload,
+        cause => malformed_will_payload,
         parsed_length => Len,
         remaining_bytes => byte_size(Rest)
     });
@@ -705,7 +705,7 @@ parse_will_payload(Bin) when
     2 > byte_size(Bin)
 ->
     ?PARSE_ERR(#{
-        hint => malformed_will_payload,
+        cause => malformed_will_payload,
         length_bytes => size(Bin),
         expected_bytes => 2
     }).
diff --git a/apps/emqx/src/emqx_packet.erl b/apps/emqx/src/emqx_packet.erl
index 29c13d99e..2f45fb37e 100644
--- a/apps/emqx/src/emqx_packet.erl
+++ b/apps/emqx/src/emqx_packet.erl
@@ -493,8 +493,8 @@ format(#mqtt_packet{header = Header, variable = Variable, payload = Payload}, Pa
         "" -> [HeaderIO, ")"];
         VarIO -> [HeaderIO, ", ", VarIO, ")"]
     end;
-%% receive a frame error packet, such as {frame_error,#{hint := frame_too_large}} or
-%% {frame_error,#{expected => <<"'MQTT' or 'MQIsdp'">>,hint => invalid_proto_name,received => <<"bad_name">>}}
+%% receive a frame error packet, such as {frame_error,#{cause := frame_too_large}} or
+%% {frame_error,#{expected => <<"'MQTT' or 'MQIsdp'">>,cause => invalid_proto_name,received => <<"bad_name">>}}
 format(FrameError, _PayloadEncode) ->
     lists:flatten(io_lib:format("~tp", [FrameError])).
 
diff --git a/apps/emqx/test/emqx_channel_SUITE.erl b/apps/emqx/test/emqx_channel_SUITE.erl
index dfee02dc1..5b21b4aca 100644
--- a/apps/emqx/test/emqx_channel_SUITE.erl
+++ b/apps/emqx/test/emqx_channel_SUITE.erl
@@ -427,30 +427,32 @@ t_handle_in_auth(_) ->
 
 t_handle_in_frame_error(_) ->
     IdleChannel = channel(#{conn_state => idle}),
-    {shutdown, #{shutdown_count := frame_too_large, hint := frame_too_large}, _Chan} =
-        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, IdleChannel),
+    {shutdown, #{shutdown_count := frame_too_large, cause := frame_too_large}, _Chan} =
+        emqx_channel:handle_in({frame_error, #{cause => frame_too_large}}, IdleChannel),
     ConnectingChan = channel(#{conn_state => connecting}),
     ConnackPacket = ?CONNACK_PACKET(?RC_PACKET_TOO_LARGE),
     {shutdown,
         #{
             shutdown_count := frame_too_large,
-            hint := frame_too_large,
+            cause := frame_too_large,
             limit := 100,
             received := 101
         },
         ConnackPacket,
         _} =
         emqx_channel:handle_in(
-            {frame_error, #{reason => frame_too_large, received => 101, limit => 100}},
+            {frame_error, #{cause => frame_too_large, received => 101, limit => 100}},
             ConnectingChan
         ),
     DisconnectPacket = ?DISCONNECT_PACKET(?RC_PACKET_TOO_LARGE),
     ConnectedChan = channel(#{conn_state => connected}),
-    {ok, [{outgoing, DisconnectPacket}, {close, frame_too_large}], _} =
-        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, ConnectedChan),
+    ?assertMatch(
+        {ok, [{outgoing, DisconnectPacket}, {close, frame_too_large}], _},
+        emqx_channel:handle_in({frame_error, #{cause => frame_too_large}}, ConnectedChan)
+    ),
     DisconnectedChan = channel(#{conn_state => disconnected}),
     {ok, DisconnectedChan} =
-        emqx_channel:handle_in({frame_error, #{reason => frame_too_large}}, DisconnectedChan).
+        emqx_channel:handle_in({frame_error, #{cause => frame_too_large}}, DisconnectedChan).
 
 t_handle_in_expected_packet(_) ->
     Packet = ?DISCONNECT_PACKET(?RC_PROTOCOL_ERROR),
diff --git a/apps/emqx/test/emqx_frame_SUITE.erl b/apps/emqx/test/emqx_frame_SUITE.erl
index 52c513985..bdafa4eed 100644
--- a/apps/emqx/test/emqx_frame_SUITE.erl
+++ b/apps/emqx/test/emqx_frame_SUITE.erl
@@ -139,8 +139,8 @@ t_parse_cont(_) ->
 
 t_parse_frame_too_large(_) ->
     Packet = ?PUBLISH_PACKET(?QOS_1, <<"t">>, 1, payload(1000)),
-    ?ASSERT_FRAME_THROW(#{hint := frame_too_large}, parse_serialize(Packet, #{max_size => 256})),
-    ?ASSERT_FRAME_THROW(#{hint := frame_too_large}, parse_serialize(Packet, #{max_size => 512})),
+    ?ASSERT_FRAME_THROW(#{cause := frame_too_large}, parse_serialize(Packet, #{max_size => 256})),
+    ?ASSERT_FRAME_THROW(#{cause := frame_too_large}, parse_serialize(Packet, #{max_size => 512})),
     ?assertEqual(Packet, parse_serialize(Packet, #{max_size => 2048, version => ?MQTT_PROTO_V4})).
 
 t_parse_frame_malformed_variable_byte_integer(_) ->
@@ -298,13 +298,13 @@ t_serialize_parse_connect_with_malformed_will(_) ->
     %% too short
     BadBin1 = <<16, 45, Body/binary, 0>>,
     ?ASSERT_FRAME_THROW(
-        #{hint := malformed_will_payload, length_bytes := 1, expected_bytes := 2},
+        #{cause := malformed_will_payload, length_bytes := 1, expected_bytes := 2},
         emqx_frame:parse(BadBin1)
     ),
     %% too long
     BadBin2 = <<16, 47, Body/binary, 0, 2, 0>>,
     ?ASSERT_FRAME_THROW(
-        #{hint := malformed_will_payload, parsed_length := 2, remaining_bytes := 1},
+        #{cause := malformed_will_payload, parsed_length := 2, remaining_bytes := 1},
         emqx_frame:parse(BadBin2)
     ),
     ok.
@@ -617,7 +617,7 @@ t_serialize_parse_pingresp(_) ->
     Packet = serialize_to_binary(PingResp),
     ?assertException(
         throw,
-        {frame_parse_error, #{hint := unexpected_packet, header_type := 'PINGRESP'}},
+        {frame_parse_error, #{cause := unexpected_packet, header_type := 'PINGRESP'}},
         emqx_frame:parse(Packet)
     ).
 
@@ -664,7 +664,9 @@ t_serialize_parse_auth_v5(_) ->
 
 t_parse_invalid_remaining_len(_) ->
     ?assertException(
-        throw, {frame_parse_error, #{hint := zero_remaining_len}}, emqx_frame:parse(<<?CONNECT, 0>>)
+        throw,
+        {frame_parse_error, #{cause := zero_remaining_len}},
+        emqx_frame:parse(<<?CONNECT, 0>>)
     ).
 
 t_parse_malformed_properties(_) ->
@@ -676,13 +678,13 @@ t_parse_malformed_properties(_) ->
 
 t_malformed_connect_header(_) ->
     ?ASSERT_FRAME_THROW(
-        #{hint := malformed_connect, header_bytes := _},
+        #{cause := malformed_connect, header_bytes := _},
         emqx_frame:parse(<<16, 11, 0, 6, 77, 81, 73, 115, 100, 112, 3, 130, 1, 6>>)
     ).
 
 t_malformed_connect_data(_) ->
     ?ASSERT_FRAME_THROW(
-        #{hint := malformed_connect, unexpected_trailing_bytes := _},
+        #{cause := malformed_connect, unexpected_trailing_bytes := _},
         emqx_frame:parse(<<16, 15, 0, 6, 77, 81, 73, 115, 100, 112, 3, 0, 0, 0, 0, 0, 0>>)
     ).
 
@@ -696,7 +698,7 @@ t_reserved_connect_flag(_) ->
 t_invalid_clientid(_) ->
     ?assertException(
         throw,
-        {frame_parse_error, #{hint := invalid_clientid}},
+        {frame_parse_error, #{cause := invalid_clientid}},
         emqx_frame:parse(<<16, 15, 0, 6, 77, 81, 73, 115, 100, 112, 3, 0, 0, 0, 1, 0, 0>>)
     ).
 
diff --git a/apps/emqx/test/emqx_ws_connection_SUITE.erl b/apps/emqx/test/emqx_ws_connection_SUITE.erl
index 83224958e..97a1ca672 100644
--- a/apps/emqx/test/emqx_ws_connection_SUITE.erl
+++ b/apps/emqx/test/emqx_ws_connection_SUITE.erl
@@ -532,7 +532,7 @@ t_parse_incoming_frame_error(_) ->
             {incoming,
                 {frame_error, #{
                     header_type := _,
-                    hint := malformed_packet
+                    cause := malformed_packet
                 }}}
         ],
         Packets

From def95aa22bf44ffc2b1292ca7c1d472bddfd4dca Mon Sep 17 00:00:00 2001
From: Kjell Winblad <kjellwinblad@gmail.com>
Date: Mon, 19 Feb 2024 11:33:37 +0100
Subject: [PATCH 265/273] docs(HStreamDB bridge): make pool size descriptions
 better

---
 apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl | 2 +-
 rel/i18n/emqx_bridge_hstreamdb.hocon                     | 4 ++--
 rel/i18n/emqx_bridge_hstreamdb_connector.hocon           | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
index 0556a731d..694f459e0 100644
--- a/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
+++ b/apps/emqx_bridge_hstreamdb/src/emqx_bridge_hstreamdb.erl
@@ -110,10 +110,10 @@ bridge_v2_examples(Method) ->
 action_values() ->
     #{
         <<"parameters">> => #{
-            <<"aggregation_pool_size">> => 8,
             <<"partition_key">> => <<"hej">>,
             <<"record_template">> => <<"${payload}">>,
             <<"stream">> => <<"mqtt_message">>,
+            <<"aggregation_pool_size">> => 8,
             <<"writer_pool_size">> => 8
         }
     }.
diff --git a/rel/i18n/emqx_bridge_hstreamdb.hocon b/rel/i18n/emqx_bridge_hstreamdb.hocon
index af2768c4b..d9eb6cc22 100644
--- a/rel/i18n/emqx_bridge_hstreamdb.hocon
+++ b/rel/i18n/emqx_bridge_hstreamdb.hocon
@@ -60,7 +60,7 @@ grpc_flush_timeout.label:
 """gRPC Flush Interval"""
 
 aggregation_pool_size.desc:
-"""Size of record aggregation pool."""
+"""The size of the record aggregation pool. A larger aggregation pool size can lead to enhanced parallelization but may also result in reduced efficiency due to smaller batch sizes."""
 
 aggregation_pool_size.label:
 """Aggregation Pool Size"""
@@ -72,7 +72,7 @@ max_batches.label:
 """Max Batches"""
 
 writer_pool_size.desc:
-"""The size of the writer pool."""
+"""The size of the writer pool. A larger pool may increase parallelization and concurrent write operations, potentially boosting throughput. Trade-offs include greater memory consumption and possible resource contention."""
 
 writer_pool_size.label:
 """Writer Pool Size"""
diff --git a/rel/i18n/emqx_bridge_hstreamdb_connector.hocon b/rel/i18n/emqx_bridge_hstreamdb_connector.hocon
index 8f7ac2edb..3122d59da 100644
--- a/rel/i18n/emqx_bridge_hstreamdb_connector.hocon
+++ b/rel/i18n/emqx_bridge_hstreamdb_connector.hocon
@@ -19,7 +19,7 @@ name.label:
 """Connector Name"""
 
 url.desc:
-"""HStreamDB Server URL. Using gRPC http server address."""
+"""HStreamDB Server URL. This URL will be used as the gRPC HTTP server address."""
 
 url.label:
 """HStreamDB Server URL"""
@@ -37,13 +37,13 @@ partition_key.label:
 """HStreamDB Partition Key"""
 
 pool_size.desc:
-"""HStreamDB Pool Size."""
+"""The size of the aggregation pool and the writer pool (see the description of the HStreamDB action for more information about these pools). Larger pool sizes can enhance parallelization but may also reduce efficiency due to smaller batch sizes."""
 
 pool_size.label:
 """HStreamDB Pool Size"""
 
 grpc_timeout.desc:
-"""HStreamDB gRPC Timeout."""
+"""The timeout for HStreamDB gRPC requests."""
 
 grpc_timeout.label:
 """HStreamDB gRPC Timeout"""

From ad53523e6b98df0b6bc2fc8d39bfa56c82c20d5a Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Mon, 19 Feb 2024 14:36:12 +0100
Subject: [PATCH 266/273] refactor: delete non-prod code

So far the retainer backend type is always `built_in_database`.
The slightly over-engineered pre-implementation to support
another backend is likely not going to fly as the EMQX
resource frame work is mostly for auth and data integration.
i.e. not generic enough for retained messages.
---
 apps/emqx_retainer/src/emqx_retainer.erl | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/apps/emqx_retainer/src/emqx_retainer.erl b/apps/emqx_retainer/src/emqx_retainer.erl
index fbf5e8e24..15f74353c 100644
--- a/apps/emqx_retainer/src/emqx_retainer.erl
+++ b/apps/emqx_retainer/src/emqx_retainer.erl
@@ -425,17 +425,7 @@ get_backend_module() ->
 
 create_resource(Context, #{type := built_in_database} = Cfg) ->
     emqx_retainer_mnesia:create_resource(Cfg),
-    Context;
-create_resource(Context, #{type := DB} = Config) ->
-    ResourceID = erlang:iolist_to_binary([io_lib:format("~ts_~ts", [?APP, DB])]),
-    _ = emqx_resource:create(
-        ResourceID,
-        <<"emqx_retainer">>,
-        list_to_existing_atom(io_lib:format("~ts_~ts", [emqx_connector, DB])),
-        Config,
-        #{}
-    ),
-    Context#{resource_id => ResourceID}.
+    Context.
 
 -spec close_resource(context()) -> ok | {error, term()}.
 close_resource(#{resource_id := ResourceId}) ->

From 98ba300f7c78dd3ae8954300cdb5a3e7ba60ea01 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Thu, 15 Feb 2024 17:34:54 +0200
Subject: [PATCH 267/273] feat: implement log throttling

---
 apps/emqx/include/logger.hrl                  |  15 ++
 apps/emqx/src/emqx_kernel_sup.erl             |   3 +-
 apps/emqx/src/emqx_log_throttler.erl          | 146 +++++++++++++++++
 apps/emqx/test/emqx_log_throttler_SUITE.erl   | 150 ++++++++++++++++++
 apps/emqx_conf/src/emqx_conf_schema.erl       |  31 +++-
 .../emqx_conf/test/emqx_conf_logger_SUITE.erl |   8 +-
 .../test/emqx_enterprise_schema_SUITE.erl     |   5 +-
 changes/ce/feat-12520.en.md                   |   2 +
 rel/i18n/emqx_conf_schema.hocon               |  13 ++
 9 files changed, 369 insertions(+), 4 deletions(-)
 create mode 100644 apps/emqx/src/emqx_log_throttler.erl
 create mode 100644 apps/emqx/test/emqx_log_throttler_SUITE.erl
 create mode 100644 changes/ce/feat-12520.en.md

diff --git a/apps/emqx/include/logger.hrl b/apps/emqx/include/logger.hrl
index a40f9dc9c..227af26b3 100644
--- a/apps/emqx/include/logger.hrl
+++ b/apps/emqx/include/logger.hrl
@@ -40,6 +40,21 @@
     end
 ).
 
+%% NOTE: do not forget to add every used msg to the default value of
+%% `log.thorttling.msgs` list.
+-define(SLOG_THROTTLE(Level, Data),
+    ?SLOG_THROTTLE(Level, Data, #{})
+).
+
+-define(SLOG_THROTTLE(Level, Data, Meta),
+    case emqx_log_throttler:allow(Level, maps:get(msg, Data)) of
+        true ->
+            ?SLOG(Level, Data, Meta);
+        false ->
+            ok
+    end
+).
+
 -define(AUDIT_HANDLER, emqx_audit).
 -define(TRACE_FILTER, emqx_trace_filter).
 -define(OWN_KEYS, [level, filters, filter_default, handlers]).
diff --git a/apps/emqx/src/emqx_kernel_sup.erl b/apps/emqx/src/emqx_kernel_sup.erl
index 85724b9b4..5f1bd6ad1 100644
--- a/apps/emqx/src/emqx_kernel_sup.erl
+++ b/apps/emqx/src/emqx_kernel_sup.erl
@@ -40,7 +40,8 @@ init([]) ->
             child_spec(emqx_authn_authz_metrics_sup, supervisor),
             child_spec(emqx_ocsp_cache, worker),
             child_spec(emqx_crl_cache, worker),
-            child_spec(emqx_tls_lib_sup, supervisor)
+            child_spec(emqx_tls_lib_sup, supervisor),
+            child_spec(emqx_log_throttler, worker)
         ]
     }}.
 
diff --git a/apps/emqx/src/emqx_log_throttler.erl b/apps/emqx/src/emqx_log_throttler.erl
new file mode 100644
index 000000000..93666da1b
--- /dev/null
+++ b/apps/emqx/src/emqx_log_throttler.erl
@@ -0,0 +1,146 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_log_throttler).
+
+-behaviour(gen_server).
+
+-include("logger.hrl").
+-include("types.hrl").
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
+
+-export([start_link/0]).
+
+%% throttler API
+-export([allow/2]).
+
+%% gen_server callbacks
+-export([
+    init/1,
+    handle_call/3,
+    handle_cast/2,
+    handle_info/2,
+    terminate/2,
+    code_change/3
+]).
+
+-define(SEQ_ID(Msg), {?MODULE, Msg}).
+-define(NEW_SEQ, atomics:new(1, [{signed, false}])).
+-define(GET_SEQ(Msg), persistent_term:get(?SEQ_ID(Msg), undefined)).
+-define(RESET_SEQ(SeqRef), atomics:put(SeqRef, 1, 0)).
+-define(INC_SEQ(SeqRef), atomics:add(SeqRef, 1, 1)).
+-define(GET_DROPPED(SeqRef), atomics:get(SeqRef, 1) - 1).
+-define(IS_ALLOWED(SeqRef), atomics:add_get(SeqRef, 1, 1) =:= 1).
+
+-define(NEW_THROTTLE(Msg, SeqRef), persistent_term:put(?SEQ_ID(Msg), SeqRef)).
+
+-define(MSGS_LIST, emqx:get_config([log, throttling, msgs], [])).
+-define(TIME_WINDOW_MS, timer:seconds(emqx:get_config([log, throttling, time_window], 60))).
+
+-spec allow(logger:level(), string()) -> boolean().
+allow(debug, _Msg) ->
+    true;
+allow(_Level, Msg) ->
+    Seq = persistent_term:get(?SEQ_ID(Msg), undefined),
+    case Seq of
+        undefined ->
+            %% This is either a race condition (emqx_log_throttler is not started yet)
+            %% or a developer mistake (msg used in ?SLOG_THROTTLE/2,3 macro is
+            %% not added to the default value of `log.throttling.msgs`.
+            ?SLOG(info, #{
+                msg => "missing_log_throttle_sequence",
+                throttled_msg => Msg
+            }),
+            true;
+        SeqRef ->
+            ?IS_ALLOWED(SeqRef)
+    end.
+
+-spec start_link() -> startlink_ret().
+start_link() ->
+    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).
+
+%%--------------------------------------------------------------------
+%% gen_server callbacks
+%%--------------------------------------------------------------------
+
+init([]) ->
+    ok = lists:foreach(fun(Msg) -> ?NEW_THROTTLE(Msg, ?NEW_SEQ) end, ?MSGS_LIST),
+    TimerRef = schedule_refresh(?TIME_WINDOW_MS),
+    {ok, #{timer_ref => TimerRef}}.
+
+handle_call(Req, _From, State) ->
+    ?SLOG(error, #{msg => "unexpected_call", call => Req}),
+    {reply, ignored, State}.
+
+handle_cast(Msg, State) ->
+    ?SLOG(error, #{msg => "unexpected_cast", cast => Msg}),
+    {noreply, State}.
+
+handle_info(refresh, State) ->
+    PeriodMs = ?TIME_WINDOW_MS,
+    Msgs = ?MSGS_LIST,
+    DroppedStats = lists:foldl(
+        fun(Msg, Acc) ->
+            case ?GET_SEQ(Msg) of
+                %% Should not happen, unless the static ids list is updated at run-time.
+                undefined ->
+                    ?NEW_THROTTLE(Msg, ?NEW_SEQ),
+                    ?tp(log_throttler_new_msg, #{throttled_msg => Msg}),
+                    Acc;
+                SeqRef ->
+                    Dropped = ?GET_DROPPED(SeqRef),
+                    ok = ?RESET_SEQ(SeqRef),
+                    ?tp(log_throttler_dropped, #{dropped_count => Dropped, throttled_msg => Msg}),
+                    maybe_add_dropped(Msg, Dropped, Acc)
+            end
+        end,
+        #{},
+        Msgs
+    ),
+    maybe_log_dropped(DroppedStats, PeriodMs),
+    State1 = State#{timer_ref => schedule_refresh(PeriodMs)},
+    {noreply, State1};
+handle_info(Info, State) ->
+    ?SLOG(error, #{msg => "unxpected_info", info => Info}),
+    {noreply, State}.
+
+terminate(_Reason, _State) ->
+    ok.
+
+code_change(_OldVsn, State, _Extra) ->
+    {ok, State}.
+
+%%--------------------------------------------------------------------
+%% internal functions
+%%--------------------------------------------------------------------
+
+maybe_add_dropped(Msg, Dropped, DroppedAcc) when Dropped > 0 ->
+    DroppedAcc#{Msg => Dropped};
+maybe_add_dropped(_Msg, _Dropped, DroppedAcc) ->
+    DroppedAcc.
+
+maybe_log_dropped(DroppedStats, PeriodMs) when map_size(DroppedStats) > 0 ->
+    ?SLOG(warning, #{
+        msg => "log_events_throttled_during_last_period",
+        dropped => DroppedStats,
+        period => emqx_utils_calendar:human_readable_duration_string(PeriodMs)
+    });
+maybe_log_dropped(_DroppedStats, _PeriodMs) ->
+    ok.
+
+schedule_refresh(PeriodMs) ->
+    erlang:send_after(PeriodMs, ?MODULE, refresh).
diff --git a/apps/emqx/test/emqx_log_throttler_SUITE.erl b/apps/emqx/test/emqx_log_throttler_SUITE.erl
new file mode 100644
index 000000000..c5689ea24
--- /dev/null
+++ b/apps/emqx/test/emqx_log_throttler_SUITE.erl
@@ -0,0 +1,150 @@
+%%--------------------------------------------------------------------
+%% Copyright (c) 2024 EMQ Technologies Co., Ltd. All Rights Reserved.
+%%
+%% Licensed under the Apache License, Version 2.0 (the "License");
+%% you may not use this file except in compliance with the License.
+%% You may obtain a copy of the License at
+%%
+%%     http://www.apache.org/licenses/LICENSE-2.0
+%%
+%% Unless required by applicable law or agreed to in writing, software
+%% distributed under the License is distributed on an "AS IS" BASIS,
+%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+%% See the License for the specific language governing permissions and
+%% limitations under the License.
+%%--------------------------------------------------------------------
+
+-module(emqx_log_throttler_SUITE).
+
+-compile(export_all).
+-compile(nowarn_export_all).
+
+-include_lib("eunit/include/eunit.hrl").
+-include_lib("common_test/include/ct.hrl").
+-include_lib("snabbkaffe/include/snabbkaffe.hrl").
+
+-define(THROTTLE_MSG, "test_throttle_msg").
+-define(THROTTLE_MSG1, "test_throttle_msg1").
+
+all() -> emqx_common_test_helpers:all(?MODULE).
+
+init_per_suite(Config) ->
+    %% This test suite can't be run in standalone tests (without emqx_conf)
+    case module_exists(emqx_conf) of
+        true ->
+            Apps = emqx_cth_suite:start(
+                [
+                    {emqx_conf, #{
+                        config =>
+                            #{
+                                log => #{
+                                    throttling => #{
+                                        time_window => <<"1s">>, msgs => [?THROTTLE_MSG]
+                                    }
+                                }
+                            }
+                    }},
+                    emqx
+                ],
+                #{work_dir => emqx_cth_suite:work_dir(Config)}
+            ),
+            [{suite_apps, Apps} | Config];
+        false ->
+            {skip, standalone_not_supported}
+    end.
+
+end_per_suite(Config) ->
+    emqx_cth_suite:stop(?config(suite_apps, Config)),
+    emqx_config:delete_override_conf_files().
+
+init_per_testcase(t_throttle_add_new_msg, Config) ->
+    ok = snabbkaffe:start_trace(),
+    [?THROTTLE_MSG] = Conf = emqx:get_config([log, throttling, msgs]),
+    {ok, _} = emqx_conf:update([log, throttling, msgs], [?THROTTLE_MSG1 | Conf], #{}),
+    Config;
+init_per_testcase(_TC, Config) ->
+    ok = snabbkaffe:start_trace(),
+    Config.
+
+end_per_testcase(t_throttle_add_new_msg, _Config) ->
+    ok = snabbkaffe:stop(),
+    {ok, _} = emqx_conf:update([log, throttling, msgs], [?THROTTLE_MSG], #{}),
+    ok;
+end_per_testcase(_TC, _Config) ->
+    ok = snabbkaffe:stop().
+
+%%--------------------------------------------------------------------
+%% Test cases
+%%--------------------------------------------------------------------
+
+t_throttle(_Config) ->
+    ?check_trace(
+        begin
+            %% Warm-up and block to increase the probability that next events
+            %% will be in the same throttling time window.
+            lists:foreach(
+                fun(_) -> emqx_log_throttler:allow(warning, ?THROTTLE_MSG) end,
+                lists:seq(1, 100)
+            ),
+            {ok, _} = ?block_until(
+                #{?snk_kind := log_throttler_dropped, throttled_msg := ?THROTTLE_MSG}, 3000
+            ),
+
+            ?assert(emqx_log_throttler:allow(warning, ?THROTTLE_MSG)),
+            ?assertNot(emqx_log_throttler:allow(warning, ?THROTTLE_MSG)),
+            %% Debug is always allowed
+            ?assert(emqx_log_throttler:allow(debug, ?THROTTLE_MSG)),
+            {ok, _} = ?block_until(
+                #{
+                    ?snk_kind := log_throttler_dropped,
+                    throttled_msg := ?THROTTLE_MSG,
+                    dropped_count := 1
+                },
+                3000
+            )
+        end,
+        []
+    ).
+
+t_throttle_add_new_msg(_Config) ->
+    ?check_trace(
+        begin
+            ?block_until(
+                #{?snk_kind := log_throttler_new_msg, throttled_msg := ?THROTTLE_MSG1}, 3000
+            ),
+            ?assert(emqx_log_throttler:allow(warning, ?THROTTLE_MSG1)),
+            ?assertNot(emqx_log_throttler:allow(warning, ?THROTTLE_MSG1)),
+            {ok, _} = ?block_until(
+                #{
+                    ?snk_kind := log_throttler_dropped,
+                    throttled_msg := ?THROTTLE_MSG1,
+                    dropped_count := 1
+                },
+                3000
+            )
+        end,
+        []
+    ).
+
+t_throttle_no_msg(_Config) ->
+    %% Must simply pass with no crashes
+    ?assert(emqx_log_throttler:allow(warning, "no_test_throttle_msg")),
+    ?assert(emqx_log_throttler:allow(warning, "no_test_throttle_msg")),
+    timer:sleep(10),
+    ?assert(erlang:is_process_alive(erlang:whereis(emqx_log_throttler))).
+
+%%--------------------------------------------------------------------
+%% internal functions
+%%--------------------------------------------------------------------
+
+module_exists(Mod) ->
+    case erlang:module_loaded(Mod) of
+        true ->
+            true;
+        false ->
+            case code:ensure_loaded(Mod) of
+                ok -> true;
+                {module, Mod} -> true;
+                _ -> false
+            end
+    end.
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 914470ba4..f0b0b4a12 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -909,7 +909,12 @@ fields("log") ->
                     aliases => [file_handlers],
                     importance => ?IMPORTANCE_HIGH
                 }
-            )}
+            )},
+        {"throttling",
+            sc(?R_REF("log_throttling"), #{
+                desc => ?DESC("log_throttling"),
+                importance => ?IMPORTANCE_MEDIUM
+            })}
     ];
 fields("console_handler") ->
     log_handler_common_confs(console, #{});
@@ -1012,6 +1017,28 @@ fields("log_burst_limit") ->
                 }
             )}
     ];
+fields("log_throttling") ->
+    [
+        {"window_time",
+            sc(
+                emqx_schema:duration_s(),
+                #{
+                    default => <<"1m">>,
+                    desc => ?DESC("log_throttling_window_time"),
+                    importance => ?IMPORTANCE_MEDIUM
+                }
+            )},
+        %% A static list of event ids used in ?SLOG_THROTTLE/3,4 macro.
+        %% For internal (developer) use only.
+        {"event_ids",
+            sc(
+                hoconsc:array(atom()),
+                #{
+                    default => [],
+                    importance => ?IMPORTANCE_HIDDEN
+                }
+            )}
+    ];
 fields("authorization") ->
     emqx_schema:authz_fields() ++
         emqx_authz_schema:authz_fields().
@@ -1046,6 +1073,8 @@ desc("log_burst_limit") ->
     ?DESC("desc_log_burst_limit");
 desc("authorization") ->
     ?DESC("desc_authorization");
+desc("log_throttling") ->
+    ?DESC("desc_log_throttling");
 desc(_) ->
     undefined.
 
diff --git a/apps/emqx_conf/test/emqx_conf_logger_SUITE.erl b/apps/emqx_conf/test/emqx_conf_logger_SUITE.erl
index 2cb699036..b83d933fa 100644
--- a/apps/emqx_conf/test/emqx_conf_logger_SUITE.erl
+++ b/apps/emqx_conf/test/emqx_conf_logger_SUITE.erl
@@ -35,6 +35,10 @@
          level = info
          path = \"log/emqx.log\"
        }
+      throttling {
+         msgs = []
+         time_window = 1m
+      }
     }
     ").
 
@@ -84,7 +88,9 @@ t_log_conf(_Conf) ->
                 <<"time_offset">> => <<"system">>
             },
         <<"file">> =>
-            #{<<"default">> => FileExpect}
+            #{<<"default">> => FileExpect},
+        <<"throttling">> =>
+            #{<<"time_window">> => <<"1m">>, <<"msgs">> => []}
     },
     ?assertEqual(ExpectLog1, emqx_conf:get_raw([<<"log">>])),
     UpdateLog0 = emqx_utils_maps:deep_remove([<<"file">>, <<"default">>], ExpectLog1),
diff --git a/apps/emqx_enterprise/test/emqx_enterprise_schema_SUITE.erl b/apps/emqx_enterprise/test/emqx_enterprise_schema_SUITE.erl
index bf1f358ea..ec9ae6c02 100644
--- a/apps/emqx_enterprise/test/emqx_enterprise_schema_SUITE.erl
+++ b/apps/emqx_enterprise/test/emqx_enterprise_schema_SUITE.erl
@@ -102,5 +102,8 @@ t_audit_log_conf(_Config) ->
                 <<"time_offset">> => <<"system">>
             }
     },
-    ?assertEqual(ExpectLog1, emqx_conf:get_raw([<<"log">>])),
+    %% The default value of throttling.msgs can be frequently updated,
+    %% remove it here, otherwise this test needs to be updated each time
+    %% a new throttle event is added.
+    ?assertEqual(ExpectLog1, maps:remove(<<"throttling">>, emqx_conf:get_raw([<<"log">>]))),
     ok.
diff --git a/changes/ce/feat-12520.en.md b/changes/ce/feat-12520.en.md
new file mode 100644
index 000000000..593b66ec4
--- /dev/null
+++ b/changes/ce/feat-12520.en.md
@@ -0,0 +1,2 @@
+Implement log throttling. The feature reduces the number of potentially flooding logged events by
+dropping all but the first event within a configured time window.
diff --git a/rel/i18n/emqx_conf_schema.hocon b/rel/i18n/emqx_conf_schema.hocon
index 32828b377..ff975a7c2 100644
--- a/rel/i18n/emqx_conf_schema.hocon
+++ b/rel/i18n/emqx_conf_schema.hocon
@@ -475,6 +475,19 @@ log_burst_limit_window_time.desc:
 log_burst_limit_window_time.label:
 """Window Time"""
 
+desc_log_throttling.label:
+"""Log Throttling"""
+
+desc_log_throttling.desc:
+"""Log throttling feature reduces the number of potentially flooding logged events by
+dropping all but the first event within a configured time window."""
+
+log_throttling_window_time.desc:
+"""A time interval at which log throttling is applied. Defaults to 1 minute."""
+
+log_throttling_window_time.label:
+"""Log Throttling Window Time"""
+
 cluster_dns_record_type.desc:
 """DNS record type."""
 

From 9bd0d1ba1b0f4d7bf29a1582a2c9f52c381ba320 Mon Sep 17 00:00:00 2001
From: Serge Tupchii <serge.tupchii@protonmail.com>
Date: Mon, 19 Feb 2024 21:30:25 +0200
Subject: [PATCH 268/273] feat: enable log throttling for potentially flooding
 log events

---
 apps/emqx/include/logger.hrl                |  4 +--
 apps/emqx/src/emqx_access_control.erl       |  9 ++++--
 apps/emqx/src/emqx_channel.erl              | 12 ++++----
 apps/emqx/src/emqx_log_throttler.erl        | 19 +++++++-----
 apps/emqx/src/emqx_session_events.erl       |  6 ++--
 apps/emqx/test/emqx_log_throttler_SUITE.erl | 34 ++++++++++++++++-----
 apps/emqx_conf/src/emqx_conf_schema.erl     | 22 ++++++++-----
 apps/emqx_license/src/emqx_license.erl      |  5 ++-
 rel/i18n/emqx_conf_schema.hocon             |  8 ++---
 9 files changed, 80 insertions(+), 39 deletions(-)

diff --git a/apps/emqx/include/logger.hrl b/apps/emqx/include/logger.hrl
index 227af26b3..f39c88441 100644
--- a/apps/emqx/include/logger.hrl
+++ b/apps/emqx/include/logger.hrl
@@ -40,8 +40,8 @@
     end
 ).
 
-%% NOTE: do not forget to add every used msg to the default value of
-%% `log.thorttling.msgs` list.
+%% NOTE: do not forget to use atom for msg and add every used msg to
+%% the default value of `log.thorttling.msgs` list.
 -define(SLOG_THROTTLE(Level, Data),
     ?SLOG_THROTTLE(Level, Data, #{})
 ).
diff --git a/apps/emqx/src/emqx_access_control.erl b/apps/emqx/src/emqx_access_control.erl
index 13b02bb4d..d97dbd167 100644
--- a/apps/emqx/src/emqx_access_control.erl
+++ b/apps/emqx/src/emqx_access_control.erl
@@ -183,8 +183,13 @@ log_result(#{username := Username}, Topic, Action, From, Result) ->
         }
     end,
     case Result of
-        allow -> ?SLOG(info, (LogMeta())#{msg => "authorization_permission_allowed"});
-        deny -> ?SLOG(info, (LogMeta())#{msg => "authorization_permission_denied"})
+        allow ->
+            ?SLOG(info, (LogMeta())#{msg => "authorization_permission_allowed"});
+        deny ->
+            ?SLOG_THROTTLE(
+                warning,
+                (LogMeta())#{msg => authorization_permission_denied}
+            )
     end.
 
 %% @private Format authorization rules source.
diff --git a/apps/emqx/src/emqx_channel.erl b/apps/emqx/src/emqx_channel.erl
index 658bc7bbb..192335a25 100644
--- a/apps/emqx/src/emqx_channel.erl
+++ b/apps/emqx/src/emqx_channel.erl
@@ -616,10 +616,10 @@ process_publish(Packet = ?PUBLISH_PACKET(QoS, Topic, PacketId), Channel) ->
             Msg = packet_to_message(NPacket, NChannel),
             do_publish(PacketId, Msg, NChannel);
         {error, Rc = ?RC_NOT_AUTHORIZED, NChannel} ->
-            ?SLOG(
-                info,
+            ?SLOG_THROTTLE(
+                warning,
                 #{
-                    msg => "cannot_publish_to_topic",
+                    msg => cannot_publish_to_topic_due_to_not_authorized,
                     reason => emqx_reason_codes:name(Rc)
                 },
                 #{topic => Topic}
@@ -635,10 +635,10 @@ process_publish(Packet = ?PUBLISH_PACKET(QoS, Topic, PacketId), Channel) ->
                     handle_out(disconnect, Rc, NChannel)
             end;
         {error, Rc = ?RC_QUOTA_EXCEEDED, NChannel} ->
-            ?SLOG(
-                info,
+            ?SLOG_THROTTLE(
+                warning,
                 #{
-                    msg => "cannot_publish_to_topic",
+                    msg => cannot_publish_to_topic_due_to_quota_exceeded,
                     reason => emqx_reason_codes:name(Rc)
                 },
                 #{topic => Topic}
diff --git a/apps/emqx/src/emqx_log_throttler.erl b/apps/emqx/src/emqx_log_throttler.erl
index 93666da1b..ef29d5a79 100644
--- a/apps/emqx/src/emqx_log_throttler.erl
+++ b/apps/emqx/src/emqx_log_throttler.erl
@@ -50,10 +50,10 @@
 -define(MSGS_LIST, emqx:get_config([log, throttling, msgs], [])).
 -define(TIME_WINDOW_MS, timer:seconds(emqx:get_config([log, throttling, time_window], 60))).
 
--spec allow(logger:level(), string()) -> boolean().
+-spec allow(logger:level(), atom()) -> boolean().
 allow(debug, _Msg) ->
     true;
-allow(_Level, Msg) ->
+allow(_Level, Msg) when is_atom(Msg) ->
     Seq = persistent_term:get(?SEQ_ID(Msg), undefined),
     case Seq of
         undefined ->
@@ -79,8 +79,9 @@ start_link() ->
 
 init([]) ->
     ok = lists:foreach(fun(Msg) -> ?NEW_THROTTLE(Msg, ?NEW_SEQ) end, ?MSGS_LIST),
-    TimerRef = schedule_refresh(?TIME_WINDOW_MS),
-    {ok, #{timer_ref => TimerRef}}.
+    CurrentPeriodMs = ?TIME_WINDOW_MS,
+    TimerRef = schedule_refresh(CurrentPeriodMs),
+    {ok, #{timer_ref => TimerRef, current_period_ms => CurrentPeriodMs}}.
 
 handle_call(Req, _From, State) ->
     ?SLOG(error, #{msg => "unexpected_call", call => Req}),
@@ -90,8 +91,7 @@ handle_cast(Msg, State) ->
     ?SLOG(error, #{msg => "unexpected_cast", cast => Msg}),
     {noreply, State}.
 
-handle_info(refresh, State) ->
-    PeriodMs = ?TIME_WINDOW_MS,
+handle_info(refresh, #{current_period_ms := PeriodMs} = State) ->
     Msgs = ?MSGS_LIST,
     DroppedStats = lists:foldl(
         fun(Msg, Acc) ->
@@ -112,7 +112,11 @@ handle_info(refresh, State) ->
         Msgs
     ),
     maybe_log_dropped(DroppedStats, PeriodMs),
-    State1 = State#{timer_ref => schedule_refresh(PeriodMs)},
+    NewPeriodMs = ?TIME_WINDOW_MS,
+    State1 = State#{
+        timer_ref => schedule_refresh(NewPeriodMs),
+        current_period_ms => NewPeriodMs
+    },
     {noreply, State1};
 handle_info(Info, State) ->
     ?SLOG(error, #{msg => "unxpected_info", info => Info}),
@@ -143,4 +147,5 @@ maybe_log_dropped(_DroppedStats, _PeriodMs) ->
     ok.
 
 schedule_refresh(PeriodMs) ->
+    ?tp(log_throttler_sched_refresh, #{new_period_ms => PeriodMs}),
     erlang:send_after(PeriodMs, ?MODULE, refresh).
diff --git a/apps/emqx/src/emqx_session_events.erl b/apps/emqx/src/emqx_session_events.erl
index 856efac74..ac8dee262 100644
--- a/apps/emqx/src/emqx_session_events.erl
+++ b/apps/emqx/src/emqx_session_events.erl
@@ -62,10 +62,10 @@ handle_event(ClientInfo, {dropped, Msg, #{reason := queue_full, logctx := Ctx}})
     ok = emqx_metrics:inc('delivery.dropped.queue_full'),
     ok = inc_pd('send_msg.dropped', 1),
     ok = inc_pd('send_msg.dropped.queue_full', 1),
-    ?SLOG(
-        info,
+    ?SLOG_THROTTLE(
+        warning,
         Ctx#{
-            msg => "dropped_msg_due_to_mqueue_is_full",
+            msg => dropped_msg_due_to_mqueue_is_full,
             payload => Msg#message.payload
         },
         #{topic => Msg#message.topic}
diff --git a/apps/emqx/test/emqx_log_throttler_SUITE.erl b/apps/emqx/test/emqx_log_throttler_SUITE.erl
index c5689ea24..441ef2d95 100644
--- a/apps/emqx/test/emqx_log_throttler_SUITE.erl
+++ b/apps/emqx/test/emqx_log_throttler_SUITE.erl
@@ -23,8 +23,10 @@
 -include_lib("common_test/include/ct.hrl").
 -include_lib("snabbkaffe/include/snabbkaffe.hrl").
 
--define(THROTTLE_MSG, "test_throttle_msg").
--define(THROTTLE_MSG1, "test_throttle_msg1").
+%% Have to use real msgs, as the schema is guarded by enum.
+-define(THROTTLE_MSG, authorization_permission_denied).
+-define(THROTTLE_MSG1, cannot_publish_to_topic_due_to_not_authorized).
+-define(TIME_WINDOW, <<"1s">>).
 
 all() -> emqx_common_test_helpers:all(?MODULE).
 
@@ -39,7 +41,7 @@ init_per_suite(Config) ->
                             #{
                                 log => #{
                                     throttling => #{
-                                        time_window => <<"1s">>, msgs => [?THROTTLE_MSG]
+                                        time_window => ?TIME_WINDOW, msgs => [?THROTTLE_MSG]
                                     }
                                 }
                             }
@@ -70,6 +72,10 @@ end_per_testcase(t_throttle_add_new_msg, _Config) ->
     ok = snabbkaffe:stop(),
     {ok, _} = emqx_conf:update([log, throttling, msgs], [?THROTTLE_MSG], #{}),
     ok;
+end_per_testcase(t_update_time_window, _Config) ->
+    ok = snabbkaffe:stop(),
+    {ok, _} = emqx_conf:update([log, throttling, time_window], ?TIME_WINDOW, #{}),
+    ok;
 end_per_testcase(_TC, _Config) ->
     ok = snabbkaffe:stop().
 
@@ -87,7 +93,7 @@ t_throttle(_Config) ->
                 lists:seq(1, 100)
             ),
             {ok, _} = ?block_until(
-                #{?snk_kind := log_throttler_dropped, throttled_msg := ?THROTTLE_MSG}, 3000
+                #{?snk_kind := log_throttler_dropped, throttled_msg := ?THROTTLE_MSG}, 5000
             ),
 
             ?assert(emqx_log_throttler:allow(warning, ?THROTTLE_MSG)),
@@ -110,7 +116,7 @@ t_throttle_add_new_msg(_Config) ->
     ?check_trace(
         begin
             ?block_until(
-                #{?snk_kind := log_throttler_new_msg, throttled_msg := ?THROTTLE_MSG1}, 3000
+                #{?snk_kind := log_throttler_new_msg, throttled_msg := ?THROTTLE_MSG1}, 5000
             ),
             ?assert(emqx_log_throttler:allow(warning, ?THROTTLE_MSG1)),
             ?assertNot(emqx_log_throttler:allow(warning, ?THROTTLE_MSG1)),
@@ -128,11 +134,25 @@ t_throttle_add_new_msg(_Config) ->
 
 t_throttle_no_msg(_Config) ->
     %% Must simply pass with no crashes
-    ?assert(emqx_log_throttler:allow(warning, "no_test_throttle_msg")),
-    ?assert(emqx_log_throttler:allow(warning, "no_test_throttle_msg")),
+    ?assert(emqx_log_throttler:allow(warning, no_test_throttle_msg)),
+    ?assert(emqx_log_throttler:allow(warning, no_test_throttle_msg)),
     timer:sleep(10),
     ?assert(erlang:is_process_alive(erlang:whereis(emqx_log_throttler))).
 
+t_update_time_window(_Config) ->
+    ?check_trace(
+        begin
+            ?wait_async_action(
+                emqx_conf:update([log, throttling, time_window], <<"2s">>, #{}),
+                #{?snk_kind := log_throttler_sched_refresh, new_period_ms := 2000},
+                5000
+            ),
+            timer:sleep(10),
+            ?assert(erlang:is_process_alive(erlang:whereis(emqx_log_throttler)))
+        end,
+        []
+    ).
+
 %%--------------------------------------------------------------------
 %% internal functions
 %%--------------------------------------------------------------------
diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index f0b0b4a12..19ca74f4e 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -75,6 +75,14 @@
 %% 1 million default ports counter
 -define(DEFAULT_MAX_PORTS, 1024 * 1024).
 
+-define(LOG_THROTTLING_MSGS, [
+    authorization_permission_denied,
+    cannot_publish_to_topic_due_to_not_authorized,
+    cannot_publish_to_topic_due_to_quota_exceeded,
+    connection_rejected_due_to_license_limit_reached,
+    dropped_msg_due_to_mqueue_is_full
+]).
+
 %% Callback to upgrade config after loaded from config file but before validation.
 upgrade_raw_conf(Raw0) ->
     Raw1 = emqx_connector_schema:transform_bridges_v1_to_connectors_and_bridges_v2(Raw0),
@@ -910,7 +918,7 @@ fields("log") ->
                     importance => ?IMPORTANCE_HIGH
                 }
             )},
-        {"throttling",
+        {throttling,
             sc(?R_REF("log_throttling"), #{
                 desc => ?DESC("log_throttling"),
                 importance => ?IMPORTANCE_MEDIUM
@@ -1019,22 +1027,22 @@ fields("log_burst_limit") ->
     ];
 fields("log_throttling") ->
     [
-        {"window_time",
+        {time_window,
             sc(
                 emqx_schema:duration_s(),
                 #{
                     default => <<"1m">>,
-                    desc => ?DESC("log_throttling_window_time"),
+                    desc => ?DESC("log_throttling_time_window"),
                     importance => ?IMPORTANCE_MEDIUM
                 }
             )},
-        %% A static list of event ids used in ?SLOG_THROTTLE/3,4 macro.
+        %% A static list of msgs used in ?SLOG_THROTTLE/2,3 macro.
         %% For internal (developer) use only.
-        {"event_ids",
+        {msgs,
             sc(
-                hoconsc:array(atom()),
+                hoconsc:array(hoconsc:enum(?LOG_THROTTLING_MSGS)),
                 #{
-                    default => [],
+                    default => ?LOG_THROTTLING_MSGS,
                     importance => ?IMPORTANCE_HIDDEN
                 }
             )}
diff --git a/apps/emqx_license/src/emqx_license.erl b/apps/emqx_license/src/emqx_license.erl
index c0fc10b91..fd80cd2c7 100644
--- a/apps/emqx_license/src/emqx_license.erl
+++ b/apps/emqx_license/src/emqx_license.erl
@@ -85,7 +85,10 @@ check(_ConnInfo, AckProps) ->
         {ok, #{max_connections := MaxClients}} ->
             case check_max_clients_exceeded(MaxClients) of
                 true ->
-                    ?SLOG(info, #{msg => "connection_rejected_due_to_license_limit_reached"}),
+                    ?SLOG_THROTTLE(
+                        error,
+                        #{msg => connection_rejected_due_to_license_limit_reached}
+                    ),
                     {stop, {error, ?RC_QUOTA_EXCEEDED}};
                 false ->
                     {ok, AckProps}
diff --git a/rel/i18n/emqx_conf_schema.hocon b/rel/i18n/emqx_conf_schema.hocon
index ff975a7c2..889bfafa5 100644
--- a/rel/i18n/emqx_conf_schema.hocon
+++ b/rel/i18n/emqx_conf_schema.hocon
@@ -482,11 +482,11 @@ desc_log_throttling.desc:
 """Log throttling feature reduces the number of potentially flooding logged events by
 dropping all but the first event within a configured time window."""
 
-log_throttling_window_time.desc:
-"""A time interval at which log throttling is applied. Defaults to 1 minute."""
+log_throttling_time_window.desc:
+"""For throttled messages, only log 1 in each time window."""
 
-log_throttling_window_time.label:
-"""Log Throttling Window Time"""
+log_throttling_time_window.label:
+"""Log Throttling Time Window"""
 
 cluster_dns_record_type.desc:
 """DNS record type."""

From 6f6dbc24c26b939f2a6cdb54f6dd113345e842bd Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Tue, 20 Feb 2024 14:20:15 +0100
Subject: [PATCH 269/273] chore: ensure EMQX_NODE__NAME is set as
 EMQX_NODE_NAME

---
 dev | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/dev b/dev
index 7c224e504..479e013b3 100755
--- a/dev
+++ b/dev
@@ -66,7 +66,10 @@ export HOCON_ENV_OVERRIDE_PREFIX='EMQX_'
 export EMQX_LOG__FILE__DEFAULT__ENABLE='false'
 export EMQX_LOG__CONSOLE__ENABLE='true'
 SYSTEM="$(./scripts/get-distro.sh)"
-EMQX_NODE_NAME="${EMQX_NODE__NAME:-${EMQX_NODE_NAME:-emqx@127.0.0.1}}"
+if [ -n "${EMQX_NODE_NAME:-}" ]; then
+    export EMQX_NODE__NAME="${EMQX_NODE_NAME}"
+fi
+EMQX_NODE_NAME="${EMQX_NODE__NAME:-emqx@127.0.0.1}"
 PROFILE="${PROFILE:-emqx}"
 FORCE_COMPILE=0
 # Do not start using ekka epmd by default, so your IDE can connect to it

From dc015e7a6fbd59e4a37d5d00f95867bc061d0d9f Mon Sep 17 00:00:00 2001
From: "Zaiming (Stone) Shi" <zmstone@gmail.com>
Date: Tue, 20 Feb 2024 14:58:52 +0100
Subject: [PATCH 270/273] fix(schema): validate cluster strategy and node name

If cluster strategy is configured as `dns`, the node name
must be IP address
---
 apps/emqx_conf/src/emqx_conf_schema.erl       | 59 +++++++++++++++-
 .../emqx_conf/test/emqx_conf_schema_tests.erl | 69 +++++++++++++++++++
 changes/ce/fix-12541.en.md                    |  3 +
 3 files changed, 129 insertions(+), 2 deletions(-)
 create mode 100644 changes/ce/fix-12541.en.md

diff --git a/apps/emqx_conf/src/emqx_conf_schema.erl b/apps/emqx_conf/src/emqx_conf_schema.erl
index 914470ba4..2feb507fe 100644
--- a/apps/emqx_conf/src/emqx_conf_schema.erl
+++ b/apps/emqx_conf/src/emqx_conf_schema.erl
@@ -42,6 +42,8 @@
 %% internal exports for `emqx_enterprise_schema' only.
 -export([ensure_unicode_path/2, convert_rotation/2, log_handler_common_confs/2]).
 
+-define(DEFAULT_NODE_NAME, <<"emqx@127.0.0.1">>).
+
 %% Static apps which merge their configs into the merged emqx.conf
 %% The list can not be made a dynamic read at run-time as it is used
 %% by nodetool to generate app.<time>.config before EMQX is started
@@ -123,7 +125,8 @@ roots() ->
         lists:flatmap(fun roots/1, common_apps()).
 
 validations() ->
-    hocon_schema:validations(emqx_schema) ++
+    [{check_node_name_and_discovery_strategy, fun validate_cluster_strategy/1}] ++
+        hocon_schema:validations(emqx_schema) ++
         lists:flatmap(fun hocon_schema:validations/1, common_apps()).
 
 common_apps() ->
@@ -359,7 +362,7 @@ fields("node") ->
             sc(
                 string(),
                 #{
-                    default => <<"emqx@127.0.0.1">>,
+                    default => ?DEFAULT_NODE_NAME,
                     'readOnly' => true,
                     importance => ?IMPORTANCE_HIGH,
                     desc => ?DESC(node_name)
@@ -1436,3 +1439,55 @@ ensure_unicode_path(Path, Opts) ->
 
 log_level() ->
     hoconsc:enum([debug, info, notice, warning, error, critical, alert, emergency, all]).
+
+validate_cluster_strategy(#{<<"node">> := _, <<"cluster">> := _} = Conf) ->
+    Name = hocon_maps:get("node.name", Conf),
+    [_Prefix, Host] = re:split(Name, "@", [{return, list}, unicode]),
+    Strategy = hocon_maps:get("cluster.discovery_strategy", Conf),
+    Type = hocon_maps:get("cluster.dns.record_type", Conf),
+    validate_dns_cluster_strategy(Strategy, Type, Host);
+validate_cluster_strategy(_) ->
+    true.
+
+validate_dns_cluster_strategy(dns, srv, _Host) ->
+    ok;
+validate_dns_cluster_strategy(dns, Type, Host) ->
+    case is_ip_addr(unicode:characters_to_list(Host), Type) of
+        true ->
+            ok;
+        false ->
+            throw(#{
+                explain =>
+                    "Node name must be of name@IP format "
+                    "for DNS cluster discovery strategy with '" ++ atom_to_list(Type) ++
+                    "' record type.",
+                domain => unicode:characters_to_list(Host)
+            })
+    end;
+validate_dns_cluster_strategy(_Other, _Type, _Name) ->
+    true.
+
+is_ip_addr(Host, Type) ->
+    case inet:parse_address(Host) of
+        {ok, Ip} ->
+            AddrType = address_type(Ip),
+            case
+                (AddrType =:= ipv4 andalso Type =:= a) orelse
+                    (AddrType =:= ipv6 andalso Type =:= aaaa)
+            of
+                true ->
+                    true;
+                false ->
+                    throw(#{
+                        explain => "Node name address " ++ atom_to_list(AddrType) ++
+                            " is incompatible with DNS record type " ++ atom_to_list(Type),
+                        record_type => Type,
+                        address_type => address_type(Ip)
+                    })
+            end;
+        _ ->
+            false
+    end.
+
+address_type(IP) when tuple_size(IP) =:= 4 -> ipv4;
+address_type(IP) when tuple_size(IP) =:= 8 -> ipv6.
diff --git a/apps/emqx_conf/test/emqx_conf_schema_tests.erl b/apps/emqx_conf/test/emqx_conf_schema_tests.erl
index 6aafd99fc..977109cae 100644
--- a/apps/emqx_conf/test/emqx_conf_schema_tests.erl
+++ b/apps/emqx_conf/test/emqx_conf_schema_tests.erl
@@ -619,3 +619,72 @@ load_and_check_test_() ->
             end)
         end}
     ].
+
+%% erlfmt-ignore
+dns_record_conf(NodeName, DnsRecordType) ->
+    "
+             node {
+                name = \"" ++ NodeName ++ "\"
+                data_dir = \"data\"
+                cookie = cookie
+                max_ports = 2048
+                process_limit = 10240
+             }
+             cluster {
+                name = emqxcl
+                discovery_strategy = dns
+                dns.record_type = " ++ atom_to_list(DnsRecordType) ++"
+             }
+    ".
+
+a_record_with_non_ip_node_name_test_() ->
+    Test = fun(DnsRecordType) ->
+        {ok, ConfMap} = hocon:binary(dns_record_conf("emqx@local.host", DnsRecordType), #{
+            format => map
+        }),
+        ?assertThrow(
+            {emqx_conf_schema, [
+                #{
+                    reason := integrity_validation_failure,
+                    result := #{domain := "local.host"},
+                    kind := validation_error,
+                    validation_name := check_node_name_and_discovery_strategy
+                }
+            ]},
+            hocon_tconf:check_plain(emqx_conf_schema, ConfMap, #{required => false}, [node, cluster])
+        )
+    end,
+    [
+        {"a record", fun() -> Test(a) end},
+        {"aaaa record", fun() -> Test(aaaa) end}
+    ].
+
+dns_record_type_incompatiblie_with_node_host_ip_format_test_() ->
+    Test = fun(Ip, DnsRecordType) ->
+        {ok, ConfMap} = hocon:binary(dns_record_conf("emqx@" ++ Ip, DnsRecordType), #{format => map}),
+        ?assertThrow(
+            {emqx_conf_schema, [
+                #{
+                    reason := integrity_validation_failure,
+                    result := #{
+                        record_type := DnsRecordType,
+                        address_type := _
+                    },
+                    kind := validation_error,
+                    validation_name := check_node_name_and_discovery_strategy
+                }
+            ]},
+            hocon_tconf:check_plain(emqx_conf_schema, ConfMap, #{required => false}, [node, cluster])
+        )
+    end,
+    [
+        {"ipv4 address", fun() -> Test("::1", a) end},
+        {"ipv6 address", fun() -> Test("127.0.0.1", aaaa) end}
+    ].
+
+dns_srv_record_is_ok_test() ->
+    {ok, ConfMap} = hocon:binary(dns_record_conf("emqx@local.host", srv), #{format => map}),
+    ?assertMatch(
+        Value when is_map(Value),
+        hocon_tconf:check_plain(emqx_conf_schema, ConfMap, #{required => false}, [node, cluster])
+    ).
diff --git a/changes/ce/fix-12541.en.md b/changes/ce/fix-12541.en.md
new file mode 100644
index 000000000..93749185e
--- /dev/null
+++ b/changes/ce/fix-12541.en.md
@@ -0,0 +1,3 @@
+Added a config validation to check if `node.name` is compatible with `cluster.discover_strategy`.
+
+For `dns` strategy with `a` or `aaaa` record types, all nodes must use (static) IP address as host name.

From d469f4158eb138455d69fb76c5b322b180342683 Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 20 Feb 2024 16:53:57 -0300
Subject: [PATCH 271/273] chore: bump app vsns

---
 apps/emqx_auth/src/emqx_auth.app.src                           | 2 +-
 apps/emqx_auth_mnesia/src/emqx_auth_mnesia.app.src             | 2 +-
 apps/emqx_bridge/src/emqx_bridge.app.src                       | 2 +-
 apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src | 2 +-
 apps/emqx_bridge_kafka/src/emqx_bridge_kafka.app.src           | 2 +-
 apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src             | 2 +-
 apps/emqx_conf/src/emqx_conf.app.src                           | 2 +-
 apps/emqx_connector/src/emqx_connector.app.src                 | 2 +-
 apps/emqx_dashboard/src/emqx_dashboard.app.src                 | 2 +-
 apps/emqx_durable_storage/src/emqx_durable_storage.app.src     | 2 +-
 apps/emqx_ft/src/emqx_ft.app.src                               | 2 +-
 apps/emqx_gateway/src/emqx_gateway.app.src                     | 2 +-
 apps/emqx_gateway_exproto/src/emqx_gateway_exproto.app.src     | 2 +-
 apps/emqx_gateway_ocpp/src/emqx_gateway_ocpp.app.src           | 2 +-
 apps/emqx_license/src/emqx_license.app.src                     | 2 +-
 apps/emqx_machine/src/emqx_machine.app.src                     | 2 +-
 apps/emqx_management/src/emqx_management.app.src               | 2 +-
 apps/emqx_modules/src/emqx_modules.app.src                     | 2 +-
 apps/emqx_mysql/src/emqx_mysql.app.src                         | 2 +-
 apps/emqx_postgresql/src/emqx_postgresql.app.src               | 2 +-
 apps/emqx_prometheus/src/emqx_prometheus.app.src               | 2 +-
 apps/emqx_resource/src/emqx_resource.app.src                   | 2 +-
 apps/emqx_retainer/src/emqx_retainer.app.src                   | 2 +-
 apps/emqx_rule_engine/src/emqx_rule_engine.app.src             | 2 +-
 apps/emqx_utils/src/emqx_utils.app.src                         | 2 +-
 25 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/apps/emqx_auth/src/emqx_auth.app.src b/apps/emqx_auth/src/emqx_auth.app.src
index 769929cc9..548af740e 100644
--- a/apps/emqx_auth/src/emqx_auth.app.src
+++ b/apps/emqx_auth/src/emqx_auth.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_auth, [
     {description, "EMQX Authentication and authorization"},
-    {vsn, "0.2.1"},
+    {vsn, "0.2.2"},
     {modules, []},
     {registered, [emqx_auth_sup]},
     {applications, [
diff --git a/apps/emqx_auth_mnesia/src/emqx_auth_mnesia.app.src b/apps/emqx_auth_mnesia/src/emqx_auth_mnesia.app.src
index 28b8d7535..a91849d24 100644
--- a/apps/emqx_auth_mnesia/src/emqx_auth_mnesia.app.src
+++ b/apps/emqx_auth_mnesia/src/emqx_auth_mnesia.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_auth_mnesia, [
     {description, "EMQX Buitl-in Database Authentication and Authorization"},
-    {vsn, "0.1.3"},
+    {vsn, "0.1.4"},
     {registered, []},
     {mod, {emqx_auth_mnesia_app, []}},
     {applications, [
diff --git a/apps/emqx_bridge/src/emqx_bridge.app.src b/apps/emqx_bridge/src/emqx_bridge.app.src
index cadbf35a0..9ef567f23 100644
--- a/apps/emqx_bridge/src/emqx_bridge.app.src
+++ b/apps/emqx_bridge/src/emqx_bridge.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_bridge, [
     {description, "EMQX bridges"},
-    {vsn, "0.1.33"},
+    {vsn, "0.1.34"},
     {registered, [emqx_bridge_sup]},
     {mod, {emqx_bridge_app, []}},
     {applications, [
diff --git a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
index b3ac508ad..357db5c96 100644
--- a/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
+++ b/apps/emqx_bridge_greptimedb/src/emqx_bridge_greptimedb.app.src
@@ -1,6 +1,6 @@
 {application, emqx_bridge_greptimedb, [
     {description, "EMQX GreptimeDB Bridge"},
-    {vsn, "0.1.7"},
+    {vsn, "0.1.8"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.app.src b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.app.src
index ffdb7eb20..a504a42d8 100644
--- a/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.app.src
+++ b/apps/emqx_bridge_kafka/src/emqx_bridge_kafka.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_bridge_kafka, [
     {description, "EMQX Enterprise Kafka Bridge"},
-    {vsn, "0.2.1"},
+    {vsn, "0.2.2"},
     {registered, [emqx_bridge_kafka_consumer_sup]},
     {applications, [
         kernel,
diff --git a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
index 0c00a0d59..6fbc0edde 100644
--- a/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
+++ b/apps/emqx_bridge_mqtt/src/emqx_bridge_mqtt.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_bridge_mqtt, [
     {description, "EMQX MQTT Broker Bridge"},
-    {vsn, "0.1.8"},
+    {vsn, "0.1.9"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_conf/src/emqx_conf.app.src b/apps/emqx_conf/src/emqx_conf.app.src
index 7a9ddb9f7..dedb0c3c6 100644
--- a/apps/emqx_conf/src/emqx_conf.app.src
+++ b/apps/emqx_conf/src/emqx_conf.app.src
@@ -1,6 +1,6 @@
 {application, emqx_conf, [
     {description, "EMQX configuration management"},
-    {vsn, "0.1.34"},
+    {vsn, "0.1.35"},
     {registered, []},
     {mod, {emqx_conf_app, []}},
     {applications, [kernel, stdlib]},
diff --git a/apps/emqx_connector/src/emqx_connector.app.src b/apps/emqx_connector/src/emqx_connector.app.src
index 09adf9977..4622e41bb 100644
--- a/apps/emqx_connector/src/emqx_connector.app.src
+++ b/apps/emqx_connector/src/emqx_connector.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_connector, [
     {description, "EMQX Data Integration Connectors"},
-    {vsn, "0.1.38"},
+    {vsn, "0.1.39"},
     {registered, []},
     {mod, {emqx_connector_app, []}},
     {applications, [
diff --git a/apps/emqx_dashboard/src/emqx_dashboard.app.src b/apps/emqx_dashboard/src/emqx_dashboard.app.src
index f2a1dbe8f..05e0be932 100644
--- a/apps/emqx_dashboard/src/emqx_dashboard.app.src
+++ b/apps/emqx_dashboard/src/emqx_dashboard.app.src
@@ -2,7 +2,7 @@
 {application, emqx_dashboard, [
     {description, "EMQX Web Dashboard"},
     % strict semver, bump manually!
-    {vsn, "5.0.32"},
+    {vsn, "5.0.33"},
     {modules, []},
     {registered, [emqx_dashboard_sup]},
     {applications, [
diff --git a/apps/emqx_durable_storage/src/emqx_durable_storage.app.src b/apps/emqx_durable_storage/src/emqx_durable_storage.app.src
index 314c9c587..2d9d932c0 100644
--- a/apps/emqx_durable_storage/src/emqx_durable_storage.app.src
+++ b/apps/emqx_durable_storage/src/emqx_durable_storage.app.src
@@ -2,7 +2,7 @@
 {application, emqx_durable_storage, [
     {description, "Message persistence and subscription replays for EMQX"},
     % strict semver, bump manually!
-    {vsn, "0.1.11"},
+    {vsn, "0.1.12"},
     {modules, []},
     {registered, []},
     {applications, [kernel, stdlib, rocksdb, gproc, mria, emqx_utils]},
diff --git a/apps/emqx_ft/src/emqx_ft.app.src b/apps/emqx_ft/src/emqx_ft.app.src
index ccc27c36c..1b1ee05ec 100644
--- a/apps/emqx_ft/src/emqx_ft.app.src
+++ b/apps/emqx_ft/src/emqx_ft.app.src
@@ -1,6 +1,6 @@
 {application, emqx_ft, [
     {description, "EMQX file transfer over MQTT"},
-    {vsn, "0.1.13"},
+    {vsn, "0.1.14"},
     {registered, []},
     {mod, {emqx_ft_app, []}},
     {applications, [
diff --git a/apps/emqx_gateway/src/emqx_gateway.app.src b/apps/emqx_gateway/src/emqx_gateway.app.src
index 143468275..731a1807c 100644
--- a/apps/emqx_gateway/src/emqx_gateway.app.src
+++ b/apps/emqx_gateway/src/emqx_gateway.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_gateway, [
     {description, "The Gateway management application"},
-    {vsn, "0.1.30"},
+    {vsn, "0.1.31"},
     {registered, []},
     {mod, {emqx_gateway_app, []}},
     {applications, [kernel, stdlib, emqx, emqx_auth, emqx_ctl]},
diff --git a/apps/emqx_gateway_exproto/src/emqx_gateway_exproto.app.src b/apps/emqx_gateway_exproto/src/emqx_gateway_exproto.app.src
index 63620c930..3d11acf12 100644
--- a/apps/emqx_gateway_exproto/src/emqx_gateway_exproto.app.src
+++ b/apps/emqx_gateway_exproto/src/emqx_gateway_exproto.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_gateway_exproto, [
     {description, "ExProto Gateway"},
-    {vsn, "0.1.8"},
+    {vsn, "0.1.9"},
     {registered, []},
     {applications, [kernel, stdlib, grpc, emqx, emqx_gateway]},
     {env, []},
diff --git a/apps/emqx_gateway_ocpp/src/emqx_gateway_ocpp.app.src b/apps/emqx_gateway_ocpp/src/emqx_gateway_ocpp.app.src
index e882d7710..c7981a033 100644
--- a/apps/emqx_gateway_ocpp/src/emqx_gateway_ocpp.app.src
+++ b/apps/emqx_gateway_ocpp/src/emqx_gateway_ocpp.app.src
@@ -1,6 +1,6 @@
 {application, emqx_gateway_ocpp, [
     {description, "OCPP-J 1.6 Gateway for EMQX"},
-    {vsn, "0.1.2"},
+    {vsn, "0.1.3"},
     {registered, []},
     {applications, [kernel, stdlib, jesse, emqx, emqx_gateway]},
     {env, []},
diff --git a/apps/emqx_license/src/emqx_license.app.src b/apps/emqx_license/src/emqx_license.app.src
index 7b80af601..18545cbed 100644
--- a/apps/emqx_license/src/emqx_license.app.src
+++ b/apps/emqx_license/src/emqx_license.app.src
@@ -1,6 +1,6 @@
 {application, emqx_license, [
     {description, "EMQX License"},
-    {vsn, "5.0.15"},
+    {vsn, "5.0.16"},
     {modules, []},
     {registered, [emqx_license_sup]},
     {applications, [kernel, stdlib, emqx_ctl]},
diff --git a/apps/emqx_machine/src/emqx_machine.app.src b/apps/emqx_machine/src/emqx_machine.app.src
index 320ddea02..151668141 100644
--- a/apps/emqx_machine/src/emqx_machine.app.src
+++ b/apps/emqx_machine/src/emqx_machine.app.src
@@ -3,7 +3,7 @@
     {id, "emqx_machine"},
     {description, "The EMQX Machine"},
     % strict semver, bump manually!
-    {vsn, "0.2.18"},
+    {vsn, "0.2.19"},
     {modules, []},
     {registered, []},
     {applications, [kernel, stdlib, emqx_ctl]},
diff --git a/apps/emqx_management/src/emqx_management.app.src b/apps/emqx_management/src/emqx_management.app.src
index a44983596..ad9e12b90 100644
--- a/apps/emqx_management/src/emqx_management.app.src
+++ b/apps/emqx_management/src/emqx_management.app.src
@@ -2,7 +2,7 @@
 {application, emqx_management, [
     {description, "EMQX Management API and CLI"},
     % strict semver, bump manually!
-    {vsn, "5.0.37"},
+    {vsn, "5.0.38"},
     {modules, []},
     {registered, [emqx_management_sup]},
     {applications, [
diff --git a/apps/emqx_modules/src/emqx_modules.app.src b/apps/emqx_modules/src/emqx_modules.app.src
index 3bf284d50..233adf7ad 100644
--- a/apps/emqx_modules/src/emqx_modules.app.src
+++ b/apps/emqx_modules/src/emqx_modules.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_modules, [
     {description, "EMQX Modules"},
-    {vsn, "5.0.25"},
+    {vsn, "5.0.26"},
     {modules, []},
     {applications, [kernel, stdlib, emqx, emqx_ctl, observer_cli]},
     {mod, {emqx_modules_app, []}},
diff --git a/apps/emqx_mysql/src/emqx_mysql.app.src b/apps/emqx_mysql/src/emqx_mysql.app.src
index bc6f6f6fb..f23d7b092 100644
--- a/apps/emqx_mysql/src/emqx_mysql.app.src
+++ b/apps/emqx_mysql/src/emqx_mysql.app.src
@@ -1,6 +1,6 @@
 {application, emqx_mysql, [
     {description, "EMQX MySQL Database Connector"},
-    {vsn, "0.1.7"},
+    {vsn, "0.1.8"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_postgresql/src/emqx_postgresql.app.src b/apps/emqx_postgresql/src/emqx_postgresql.app.src
index 14877af68..0552f8015 100644
--- a/apps/emqx_postgresql/src/emqx_postgresql.app.src
+++ b/apps/emqx_postgresql/src/emqx_postgresql.app.src
@@ -1,6 +1,6 @@
 {application, emqx_postgresql, [
     {description, "EMQX PostgreSQL Database Connector"},
-    {vsn, "0.1.2"},
+    {vsn, "0.1.3"},
     {registered, []},
     {applications, [
         kernel,
diff --git a/apps/emqx_prometheus/src/emqx_prometheus.app.src b/apps/emqx_prometheus/src/emqx_prometheus.app.src
index 9e9952d6c..b8c3d8790 100644
--- a/apps/emqx_prometheus/src/emqx_prometheus.app.src
+++ b/apps/emqx_prometheus/src/emqx_prometheus.app.src
@@ -2,7 +2,7 @@
 {application, emqx_prometheus, [
     {description, "Prometheus for EMQX"},
     % strict semver, bump manually!
-    {vsn, "5.0.19"},
+    {vsn, "5.0.20"},
     {modules, []},
     {registered, [emqx_prometheus_sup]},
     {applications, [kernel, stdlib, prometheus, emqx, emqx_auth, emqx_resource, emqx_management]},
diff --git a/apps/emqx_resource/src/emqx_resource.app.src b/apps/emqx_resource/src/emqx_resource.app.src
index 8ee5d7a04..272dd4e08 100644
--- a/apps/emqx_resource/src/emqx_resource.app.src
+++ b/apps/emqx_resource/src/emqx_resource.app.src
@@ -1,7 +1,7 @@
 %% -*- mode: erlang -*-
 {application, emqx_resource, [
     {description, "Manager for all external resources"},
-    {vsn, "0.1.27"},
+    {vsn, "0.1.28"},
     {registered, []},
     {mod, {emqx_resource_app, []}},
     {applications, [
diff --git a/apps/emqx_retainer/src/emqx_retainer.app.src b/apps/emqx_retainer/src/emqx_retainer.app.src
index 5d6fe95f7..248cc9310 100644
--- a/apps/emqx_retainer/src/emqx_retainer.app.src
+++ b/apps/emqx_retainer/src/emqx_retainer.app.src
@@ -2,7 +2,7 @@
 {application, emqx_retainer, [
     {description, "EMQX Retainer"},
     % strict semver, bump manually!
-    {vsn, "5.0.20"},
+    {vsn, "5.0.21"},
     {modules, []},
     {registered, [emqx_retainer_sup]},
     {applications, [kernel, stdlib, emqx, emqx_ctl]},
diff --git a/apps/emqx_rule_engine/src/emqx_rule_engine.app.src b/apps/emqx_rule_engine/src/emqx_rule_engine.app.src
index a0b8e8ca2..45488212f 100644
--- a/apps/emqx_rule_engine/src/emqx_rule_engine.app.src
+++ b/apps/emqx_rule_engine/src/emqx_rule_engine.app.src
@@ -2,7 +2,7 @@
 {application, emqx_rule_engine, [
     {description, "EMQX Rule Engine"},
     % strict semver, bump manually!
-    {vsn, "5.0.32"},
+    {vsn, "5.0.33"},
     {modules, []},
     {registered, [emqx_rule_engine_sup, emqx_rule_engine]},
     {applications, [
diff --git a/apps/emqx_utils/src/emqx_utils.app.src b/apps/emqx_utils/src/emqx_utils.app.src
index 766b25da6..8fdade473 100644
--- a/apps/emqx_utils/src/emqx_utils.app.src
+++ b/apps/emqx_utils/src/emqx_utils.app.src
@@ -2,7 +2,7 @@
 {application, emqx_utils, [
     {description, "Miscellaneous utilities for EMQX apps"},
     % strict semver, bump manually!
-    {vsn, "5.0.15"},
+    {vsn, "5.0.16"},
     {modules, [
         emqx_utils,
         emqx_utils_api,

From 65cfece0a35062eded78ba900c52cc49dd23555a Mon Sep 17 00:00:00 2001
From: Thales Macedo Garitezi <thalesmg@gmail.com>
Date: Tue, 20 Feb 2024 17:35:28 -0300
Subject: [PATCH 272/273] chore: delete 5.5.bpapi2

> This particular warning won't be seen in the real life. Also, we need to start storing
bpapi files for each minor release, since the plan to use hot upgrade has been abandoned.

> ...The original procedure for BPAPI life cycle was designed under the assumption that
we'll support hot upgrade between minor releases, so we'll only ever need to keep one
BPAPI file per major release, and rewrite it whenever a new minor version is
released. We'll need to revisit it.

https://emqxio.slack.com/archives/C04H4RHKKEY/p1706862980546309
---
 apps/emqx/test/emqx_static_checks_data/5.5.bpapi2 | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 apps/emqx/test/emqx_static_checks_data/5.5.bpapi2

diff --git a/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2 b/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
deleted file mode 100644
index 6192442f1..000000000
--- a/apps/emqx/test/emqx_static_checks_data/5.5.bpapi2
+++ /dev/null
@@ -1 +0,0 @@
-#{api => #{{emqx_node_rebalance_api,1} => #{calls => [{{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_bridge,1} => #{calls => [{{emqx_bridge_proto_v1,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v1,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_topic_metrics,1} => #{calls => [{{emqx_topic_metrics_proto_v1,reset,['Nodes','Topic']},{emqx_topic_metrics,reset,['Topic']}},{{emqx_topic_metrics_proto_v1,reset,['Nodes']},{emqx_topic_metrics,reset,[]}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes','Topic']},{emqx_topic_metrics,metrics,['Topic']}},{{emqx_topic_metrics_proto_v1,metrics,['Nodes']},{emqx_topic_metrics,metrics,[]}}],casts => []},{emqx_license,1} => #{calls => [{{emqx_license_proto_v1,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_persistent_session_ds,1} => #{calls => [{{emqx_persistent_session_ds_proto_v1,close_all_iterators,['Nodes','DSSessionID']},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,['DSSessionID']}},{{emqx_persistent_session_ds_proto_v1,close_iterator,['Nodes','IteratorID']},{emqx_persistent_session_ds,do_ensure_iterator_closed,['IteratorID']}},{{emqx_persistent_session_ds_proto_v1,open_iterator,['Nodes','TopicFilter','StartMS','IteratorID']},{emqx_persistent_session_ds,do_open_iterator,['TopicFilter','StartMS','IteratorID']}}],casts => []},{emqx,1} => #{calls => [{{emqx_proto_v1,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v1,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v1,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v1,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v1,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v1,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v1,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v1,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v1,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_mgmt_trace,1} => #{calls => [{{emqx_mgmt_trace_proto_v1,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v1,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v1,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_license,2} => #{calls => [{{emqx_license_proto_v2,remote_connection_counts,['Nodes']},{emqx_license_resources,local_connection_count,[]}}],casts => []},{emqx_management,4} => #{calls => [{{emqx_management_proto_v4,kickout_clients,['Node','ClientIds']},{emqx_mgmt,do_kickout_clients,['ClientIds']}},{{emqx_management_proto_v4,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v4,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v4,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v4,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v4,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v4,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v4,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v4,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v4,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_management,1} => #{calls => [{{emqx_management_proto_v1,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v1,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v1,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v1,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v1,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v1,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v1,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v1,node_info,['Node']},{emqx_mgmt,node_info,[]}}],casts => []},{emqx_management,2} => #{calls => [{{emqx_management_proto_v2,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v2,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v2,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v2,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v2,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v2,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v2,broker_info,['Node']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v2,node_info,['Node']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v2,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []},{emqx_bridge,4} => #{calls => [{{emqx_bridge_proto_v4,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v4,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_cm,2} => #{calls => [{{emqx_cm_proto_v2,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v2,takeover_finish,['ConnMod','ChanPid']},{emqx_cm,takeover_finish,['ConnMod','ChanPid']}},{{emqx_cm_proto_v2,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v2,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v2,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_telemetry,1} => #{calls => [{{emqx_telemetry_proto_v1,get_cluster_uuid,['Node']},{emqx_telemetry,get_cluster_uuid,[]}},{{emqx_telemetry_proto_v1,get_node_uuid,['Node']},{emqx_telemetry,get_node_uuid,[]}}],casts => []},{emqx_dashboard,1} => #{calls => [{{emqx_dashboard_proto_v1,current_rate,['Node']},{emqx_dashboard_monitor,current_rate,['Node']}},{{emqx_dashboard_proto_v1,do_sample,['Node','Latest']},{emqx_dashboard_monitor,do_sample,['Node','Latest']}}],casts => []},{emqx_node_rebalance_status,2} => #{calls => [{{emqx_node_rebalance_status_proto_v2,purge_status,['Nodes']},{emqx_node_rebalance_status,purge_status,[]}},{{emqx_node_rebalance_status_proto_v2,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v2,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v2,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_connector,1} => #{calls => [{{emqx_connector_proto_v1,start_connectors_to_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,start_connector_to_node,['Node','ConnectorType','ConnectorName']},{emqx_connector_resource,start,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,lookup_from_all_nodes,['Nodes','ConnectorType','ConnectorName']},{emqx_connector_api,lookup_from_local_node,['ConnectorType','ConnectorName']}},{{emqx_connector_proto_v1,list_connectors_on_nodes,['Nodes']},{emqx_connector,list,[]}}],casts => []},{emqx_broker,1} => #{calls => [{{emqx_broker_proto_v1,list_subscriptions_via_topic,['Node','Topic']},{emqx_broker,subscriptions_via_topic,['Topic']}},{{emqx_broker_proto_v1,list_client_subscriptions,['Node','ClientId']},{emqx_broker,subscriptions,['ClientId']}},{{emqx_broker_proto_v1,forward,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}],casts => [{{emqx_broker_proto_v1,forward_async,['Node','Topic','Delivery']},{emqx_broker,dispatch,['Topic','Delivery']}}]},{emqx_gateway_http,1} => #{calls => [{{emqx_gateway_http_proto_v1,get_cluster_status,['Nodes','GwName']},{emqx_gateway_http,gateway_status,['GwName']}}],casts => []},{emqx_bridge,6} => #{calls => [{{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,['Node','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2,start,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,['Nodes','ConfRootKey','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,['ConfRootKey','ActionType','ActionName']}},{{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,['Nodes','ConfRootKey']},{emqx_bridge_v2,list,['ConfRootKey']}},{{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,['Nodes','ConfRootKey','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node_v6,['ConfRootKey','BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v6,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx,2} => #{calls => [{{emqx_proto_v2,delete_all_deactivated_alarms,['Node']},{emqx_alarm,delete_all_deactivated_alarms,[]}},{{emqx_proto_v2,deactivate_alarm,['Node','Name']},{emqx_alarm,deactivate,['Name']}},{{emqx_proto_v2,clean_pem_cache,['Node']},{ssl_pem_cache,clear,[]}},{{emqx_proto_v2,clean_authz_cache,['Node']},{emqx_authz_cache,drain_cache,[]}},{{emqx_proto_v2,clean_authz_cache,['Node','ClientId']},{emqx_authz_cache,drain_cache,['ClientId']}},{{emqx_proto_v2,get_metrics,['Node']},{emqx_metrics,all,[]}},{{emqx_proto_v2,get_stats,['Node']},{emqx_stats,getstats,[]}},{{emqx_proto_v2,get_alarms,['Node','Type']},{emqx_alarm,get_alarms,['Type']}},{{emqx_proto_v2,are_running,['Nodes']},{emqx,is_running,[]}},{{emqx_proto_v2,is_running,['Node']},{emqx,is_running,[]}}],casts => []},{emqx_ft_storage_fs_reader,1} => #{calls => [{{emqx_ft_storage_fs_reader_proto_v1,read,['Node','Pid','Bytes']},{emqx_ft_storage_fs_reader,read,['Pid','Bytes']}}],casts => []},{emqx_node_rebalance,1} => #{calls => [{{emqx_node_rebalance_proto_v1,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v1,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v1,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v1,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v1,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v1,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_exhook,1} => #{calls => [{{emqx_exhook_proto_v1,server_hooks_metrics,['Nodes','Name']},{emqx_exhook_mgr,server_hooks_metrics,['Name']}},{{emqx_exhook_proto_v1,server_info,['Nodes','Name']},{emqx_exhook_mgr,server_info,['Name']}},{{emqx_exhook_proto_v1,all_servers_info,['Nodes']},{emqx_exhook_mgr,all_servers_info,[]}}],casts => []},{emqx_node_rebalance_api,2} => #{calls => [{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,['Node']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,['Node','Opts']},{emqx_node_rebalance_purge,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,['Node']},{emqx_node_rebalance,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_start,['Node','Opts']},{emqx_node_rebalance,start,['Opts']}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,['Node']},{emqx_node_rebalance_evacuation,stop,[]}},{{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,['Node','Opts']},{emqx_node_rebalance_evacuation,start,['Opts']}}],casts => []},{emqx_plugins,1} => #{calls => [{{emqx_plugins_proto_v1,get_tar,['Node','NameVsn','Timeout']},{emqx_plugins,get_tar,['NameVsn']}}],casts => []},{emqx_node_rebalance_status,1} => #{calls => [{{emqx_node_rebalance_status_proto_v1,evacuation_status,['Nodes']},{emqx_node_rebalance_status,evacuation_status,[]}},{{emqx_node_rebalance_status_proto_v1,rebalance_status,['Nodes']},{emqx_node_rebalance_status,rebalance_status,[]}},{{emqx_node_rebalance_status_proto_v1,local_status,['Node']},{emqx_node_rebalance_status,local_status,[]}}],casts => []},{emqx_conf,1} => #{calls => [{{emqx_conf_proto_v1,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v1,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v1,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v1,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v1,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}}],casts => []},{emqx_prometheus,2} => #{calls => [{{emqx_prometheus_proto_v2,raw_prom_data,['Nodes','M','F','A']},{emqx_prometheus_api,lookup_from_local_nodes,['M','F','A']}},{{emqx_prometheus_proto_v2,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v2,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_ft_storage_exporter_fs,1} => #{calls => [{{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,['Node','Filepath','CallerPid']},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,['Filepath','CallerPid']}},{{emqx_ft_storage_exporter_fs_proto_v1,list_exports,['Nodes','Query']},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,['Query']}}],casts => []},{emqx_metrics,1} => #{calls => [{{emqx_metrics_proto_v1,get_metrics,['Nodes','HandlerName','MetricId','Timeout']},{emqx_metrics_worker,get_metrics,['HandlerName','MetricId']}}],casts => []},{emqx_conf,3} => #{calls => [{{emqx_conf_proto_v3,get_hocon_config,['Node','Key']},{emqx_conf_cli,get_config,['Key']}},{{emqx_conf_proto_v3,get_hocon_config,['Node']},{emqx_conf_cli,get_config,[]}},{{emqx_conf_proto_v3,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v3,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v3,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v3,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v3,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v3,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_mgmt_cluster,2} => #{calls => [{{emqx_mgmt_cluster_proto_v2,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v2,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_retainer,2} => #{calls => [{{emqx_retainer_proto_v2,active_mnesia_indices,['Nodes']},{emqx_retainer_mnesia,active_indices,[]}},{{emqx_retainer_proto_v2,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_node_rebalance,3} => #{calls => [{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind','Options']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind','Options']}},{{emqx_node_rebalance_proto_v3,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v3,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v3,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v3,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v3,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v3,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v3,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v3,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_delayed,3} => #{calls => [{{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,['Nodes','TopicName']},{emqx_delayed,do_delete_delayed_messages_by_topic_name,['TopicName']}},{{emqx_delayed_proto_v3,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v3,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v3,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_eviction_agent,2} => #{calls => [{{emqx_eviction_agent_proto_v2,all_channels_count,['Nodes','Timeout']},{emqx_eviction_agent,all_local_channels_count,[]}},{{emqx_eviction_agent_proto_v2,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_ds,1} => #{calls => [{{emqx_ds_proto_v1,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v1,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v1,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v1,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v1,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_node_rebalance_purge,1} => #{calls => [{{emqx_node_rebalance_purge_proto_v1,stop,['Nodes']},{emqx_node_rebalance_purge,stop,[]}},{{emqx_node_rebalance_purge_proto_v1,start,['Nodes','Opts']},{emqx_node_rebalance_purge,start,['Opts']}}],casts => []},{emqx_gateway_api_listeners,1} => #{calls => [{{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,['Nodes','Listeners']},{emqx_gateway_api_listeners,do_listeners_cluster_status,['Listeners']}}],casts => []},{emqx_mgmt_trace,2} => #{calls => [{{emqx_mgmt_trace_proto_v2,read_trace_file,['Node','Name','Position','Limit']},{emqx_mgmt_api_trace,read_trace_file,['Name','Position','Limit']}},{{emqx_mgmt_trace_proto_v2,trace_file_detail,['Nodes','File']},{emqx_trace,trace_file_detail,['File']}},{{emqx_mgmt_trace_proto_v2,trace_file,['Nodes','File']},{emqx_trace,trace_file,['File']}},{{emqx_mgmt_trace_proto_v2,get_trace_size,['Nodes']},{emqx_mgmt_api_trace,get_trace_size,[]}}],casts => []},{emqx_slow_subs,1} => #{calls => [{{emqx_slow_subs_proto_v1,get_history,['Nodes']},{emqx_slow_subs_api,get_history,[]}},{{emqx_slow_subs_proto_v1,clear_history,['Nodes']},{emqx_slow_subs,clear_history,[]}}],casts => []},{emqx_mgmt_api_plugins,1} => #{calls => [{{emqx_mgmt_api_plugins_proto_v1,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v1,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,describe_package,['Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v1,install_package,['Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v1,get_plugins,[]},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_conf,2} => #{calls => [{{emqx_conf_proto_v2,get_override_config_file,['Nodes']},{emqx_conf_app,get_override_config_file,[]}},{{emqx_conf_proto_v2,reset,['Node','KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,reset,['KeyPath','Opts']},{emqx,reset_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['Node','KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,remove_config,['KeyPath','Opts']},{emqx,remove_config,['KeyPath','Opts']}},{{emqx_conf_proto_v2,update,['Node','KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,update,['KeyPath','UpdateReq','Opts']},{emqx,update_config,['KeyPath','UpdateReq','Opts']}},{{emqx_conf_proto_v2,get_all,['KeyPath']},{emqx_conf,get_node_and_config,['KeyPath']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath','Default']},{emqx,get_config,['KeyPath','Default']}},{{emqx_conf_proto_v2,get_config,['Node','KeyPath']},{emqx,get_config,['KeyPath']}},{{emqx_conf_proto_v2,sync_data_from_node,['Node']},{emqx_conf_app,sync_data_from_node,[]}}],casts => []},{emqx_ds,2} => #{calls => [{{emqx_ds_proto_v2,add_generation,['Node','DB']},{emqx_ds_replication_layer,do_add_generation_v2,['DB']}},{{emqx_ds_proto_v2,update_iterator,['Node','DB','Shard','OldIter','DSKey']},{emqx_ds_replication_layer,do_update_iterator_v2,['DB','Shard','OldIter','DSKey']}},{{emqx_ds_proto_v2,store_batch,['Node','DB','Shard','Batch','Options']},{emqx_ds_replication_layer,do_store_batch_v1,['DB','Shard','Batch','Options']}},{{emqx_ds_proto_v2,next,['Node','DB','Shard','Iter','BatchSize']},{emqx_ds_replication_layer,do_next_v1,['DB','Shard','Iter','BatchSize']}},{{emqx_ds_proto_v2,make_iterator,['Node','DB','Shard','Stream','TopicFilter','StartTime']},{emqx_ds_replication_layer,do_make_iterator_v1,['DB','Shard','Stream','TopicFilter','StartTime']}},{{emqx_ds_proto_v2,get_streams,['Node','DB','Shard','TopicFilter','Time']},{emqx_ds_replication_layer,do_get_streams_v1,['DB','Shard','TopicFilter','Time']}},{{emqx_ds_proto_v2,drop_db,['Node','DB']},{emqx_ds_replication_layer,do_drop_db_v1,['DB']}}],casts => []},{emqx_shared_sub,1} => #{calls => [{{emqx_shared_sub_proto_v1,dispatch_with_ack,['Pid','Group','Topic','Msg','Timeout']},{emqx_shared_sub,do_dispatch_with_ack,['Pid','Group','Topic','Msg']}}],casts => [{{emqx_shared_sub_proto_v1,send,['Node','Pid','Topic','Msg']},{erlang,send,['Pid','Msg']}}]},{emqx_ft_storage_fs,1} => #{calls => [{{emqx_ft_storage_fs_proto_v1,list_assemblers,['Nodes','Transfer']},{emqx_ft_storage_fs_proxy,lookup_local_assembler,['Transfer']}},{{emqx_ft_storage_fs_proto_v1,pread,['Node','Transfer','Frag','Offset','Size']},{emqx_ft_storage_fs_proxy,pread_local,['Transfer','Frag','Offset','Size']}},{{emqx_ft_storage_fs_proto_v1,multilist,['Nodes','Transfer','What']},{emqx_ft_storage_fs_proxy,list_local,['Transfer','What']}}],casts => []},{emqx_cm,1} => #{calls => [{{emqx_cm_proto_v1,kick_session,['Action','ClientId','ChanPid']},{emqx_cm,do_kick_session,['Action','ClientId','ChanPid']}},{{emqx_cm_proto_v1,takeover_session,['ClientId','ChanPid']},{emqx_cm,takeover_session,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chann_conn_mod,['ClientId','ChanPid']},{emqx_cm,do_get_chann_conn_mod,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_info,['ClientId','ChanPid']},{emqx_cm,do_get_chan_info,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,get_chan_stats,['ClientId','ChanPid']},{emqx_cm,do_get_chan_stats,['ClientId','ChanPid']}},{{emqx_cm_proto_v1,lookup_client,['Node','Key']},{emqx_cm,lookup_client,['Key']}},{{emqx_cm_proto_v1,kickout_client,['Node','ClientId']},{emqx_cm,kick_session,['ClientId']}}],casts => []},{emqx_authn,1} => #{calls => [{{emqx_authn_proto_v1,lookup_from_all_nodes,['Nodes','ChainName','AuthenticatorID']},{emqx_authn_api,lookup_from_local_node,['ChainName','AuthenticatorID']}}],casts => []},{emqx_resource,1} => #{calls => [{{emqx_resource_proto_v1,reset_metrics,['ResId']},{emqx_resource,reset_metrics_local,['ResId']}},{{emqx_resource_proto_v1,remove,['ResId']},{emqx_resource,remove_local,['ResId']}},{{emqx_resource_proto_v1,recreate,['ResId','ResourceType','Config','Opts']},{emqx_resource,recreate_local,['ResId','ResourceType','Config','Opts']}},{{emqx_resource_proto_v1,create_dry_run,['ResourceType','Config']},{emqx_resource,create_dry_run_local,['ResourceType','Config']}},{{emqx_resource_proto_v1,create,['ResId','Group','ResourceType','Config','Opts']},{emqx_resource,create_local,['ResId','Group','ResourceType','Config','Opts']}}],casts => []},{emqx_bridge,5} => #{calls => [{{emqx_bridge_proto_v5,v2_start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,['Nodes','ActionType','ActionName']},{emqx_bridge_v2_api,get_metrics_from_local_node,['ActionType','ActionName']}},{{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_v2_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,['Nodes']},{emqx_bridge_v2,list,[]}},{{emqx_bridge_proto_v5,get_metrics_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,get_metrics_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v5,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}}],casts => []},{emqx_eviction_agent,1} => #{calls => [{{emqx_eviction_agent_proto_v1,evict_session_channel,['Node','ClientId','ConnInfo','ClientInfo']},{emqx_eviction_agent,evict_session_channel,['ClientId','ConnInfo','ClientInfo']}}],casts => []},{emqx_authz,1} => #{calls => [{{emqx_authz_proto_v1,lookup_from_all_nodes,['Nodes','Type']},{emqx_authz_api_sources,lookup_from_local_node,['Type']}}],casts => []},{emqx_gateway_cm,1} => #{calls => [{{emqx_gateway_cm_proto_v1,cast,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_cast,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req']}},{{emqx_gateway_cm_proto_v1,call,['GwName','ClientId','ChanPid','Req','Timeout']},{emqx_gateway_cm,do_call,['GwName','ClientId','ChanPid','Req','Timeout']}},{{emqx_gateway_cm_proto_v1,takeover_session,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_takeover_session,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,get_chann_conn_mod,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chann_conn_mod,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,kick_session,['GwName','Action','ClientId','ChanPid']},{emqx_gateway_cm,do_kick_session,['GwName','Action','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_stats,['GwName','ClientId','ChanPid','Stats']},{emqx_gateway_cm,do_set_chan_stats,['GwName','ClientId','ChanPid','Stats']}},{{emqx_gateway_cm_proto_v1,get_chan_stats,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_stats,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,set_chan_info,['GwName','ClientId','ChanPid','Infos']},{emqx_gateway_cm,do_set_chan_info,['GwName','ClientId','ChanPid','Infos']}},{{emqx_gateway_cm_proto_v1,get_chan_info,['GwName','ClientId','ChanPid']},{emqx_gateway_cm,do_get_chan_info,['GwName','ClientId','ChanPid']}},{{emqx_gateway_cm_proto_v1,lookup_by_clientid,['Nodes','GwName','ClientId']},{emqx_gateway_cm,do_lookup_by_clientid,['GwName','ClientId']}}],casts => []},{emqx_bridge,3} => #{calls => [{{emqx_bridge_proto_v3,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v3,list_bridges_on_nodes,['Nodes']},{emqx_bridge,list,[]}},{{emqx_bridge_proto_v3,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_rule_engine,1} => #{calls => [{{emqx_rule_engine_proto_v1,reset_metrics,['RuleId']},{emqx_rule_engine,reset_metrics_for_rule,['RuleId']}}],casts => []},{emqx_node_rebalance_evacuation,1} => #{calls => [{{emqx_node_rebalance_evacuation_proto_v1,available_nodes,['Nodes']},{emqx_node_rebalance_evacuation,is_node_available,[]}}],casts => []},{emqx_bridge,2} => #{calls => [{{emqx_bridge_proto_v2,lookup_from_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_api,lookup_from_local_node,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,['Nodes','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,stop_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,stop,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,start_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,start,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,restart_bridge_to_node,['Node','BridgeType','BridgeName']},{emqx_bridge_resource,restart,['BridgeType','BridgeName']}},{{emqx_bridge_proto_v2,list_bridges,['Node']},{emqx_bridge,list,[]}}],casts => []},{emqx_node_rebalance,2} => #{calls => [{{emqx_node_rebalance_proto_v2,purge_sessions,['Nodes','Count']},{emqx_eviction_agent,purge_sessions,['Count']}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,disable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid','Kind']},{emqx_node_rebalance_agent,enable,['OwnerPid','Kind']}},{{emqx_node_rebalance_proto_v2,disconnected_session_counts,['Nodes']},{emqx_node_rebalance,disconnected_session_count,[]}},{{emqx_node_rebalance_proto_v2,disable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,disable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,enable_rebalance_agent,['Nodes','OwnerPid']},{emqx_node_rebalance_agent,enable,['OwnerPid']}},{{emqx_node_rebalance_proto_v2,session_counts,['Nodes']},{emqx_node_rebalance,session_count,[]}},{{emqx_node_rebalance_proto_v2,connection_counts,['Nodes']},{emqx_node_rebalance,connection_count,[]}},{{emqx_node_rebalance_proto_v2,evict_sessions,['Nodes','Count','RecipientNodes','ConnState']},{emqx_eviction_agent,evict_sessions,['Count','RecipientNodes','ConnState']}},{{emqx_node_rebalance_proto_v2,evict_connections,['Nodes','Count']},{emqx_eviction_agent,evict_connections,['Count']}},{{emqx_node_rebalance_proto_v2,available_nodes,['Nodes']},{emqx_node_rebalance,is_node_available,[]}}],casts => []},{emqx_mgmt_data_backup,1} => #{calls => [{{emqx_mgmt_data_backup_proto_v1,delete_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,delete_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,read_file,['Node','FileName','Timeout']},{emqx_mgmt_data_backup,read_file,['FileName']}},{{emqx_mgmt_data_backup_proto_v1,import_file,['Node','FileNode','FileName','Timeout']},{emqx_mgmt_data_backup,maybe_copy_and_import,['FileNode','FileName']}},{{emqx_mgmt_data_backup_proto_v1,list_files,['Nodes','Timeout']},{emqx_mgmt_data_backup,list_files,[]}}],casts => []},{emqx_retainer,1} => #{calls => [{{emqx_retainer_proto_v1,wait_dispatch_complete,['Nodes','Timeout']},{emqx_retainer_dispatcher,wait_dispatch_complete,['Timeout']}}],casts => []},{emqx_delayed,2} => #{calls => [{{emqx_delayed_proto_v2,clear_all,['Nodes']},{emqx_delayed,clear_all_local,[]}},{{emqx_delayed_proto_v2,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v2,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_mgmt_api_plugins,2} => #{calls => [{{emqx_mgmt_api_plugins_proto_v2,ensure_action,['Name','Action']},{emqx_mgmt_api_plugins,ensure_action,['Name','Action']}},{{emqx_mgmt_api_plugins_proto_v2,delete_package,['Name']},{emqx_mgmt_api_plugins,delete_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,describe_package,['Nodes','Name']},{emqx_mgmt_api_plugins,describe_package,['Name']}},{{emqx_mgmt_api_plugins_proto_v2,install_package,['Nodes','Filename','Bin']},{emqx_mgmt_api_plugins,install_package,['Filename','Bin']}},{{emqx_mgmt_api_plugins_proto_v2,get_plugins,['Nodes']},{emqx_mgmt_api_plugins,get_plugins,[]}}],casts => []},{emqx_mgmt_cluster,1} => #{calls => [{{emqx_mgmt_cluster_proto_v1,invite_node,['Node','Self']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_mgmt_cluster,3} => #{calls => [{{emqx_mgmt_cluster_proto_v3,connected_replicants,['Nodes']},{emqx_mgmt_api_cluster,connected_replicants,[]}},{{emqx_mgmt_cluster_proto_v3,invite_node,['Node','Self','Timeout']},{emqx_mgmt_api_cluster,join,['Self']}}],casts => []},{emqx_prometheus,1} => #{calls => [{{emqx_prometheus_proto_v1,stop,['Nodes']},{emqx_prometheus,do_stop,[]}},{{emqx_prometheus_proto_v1,start,['Nodes']},{emqx_prometheus,do_start,[]}}],casts => []},{emqx_delayed,1} => #{calls => [{{emqx_delayed_proto_v1,delete_delayed_message,['Node','Id']},{emqx_delayed,delete_delayed_message,['Id']}},{{emqx_delayed_proto_v1,get_delayed_message,['Node','Id']},{emqx_delayed,get_delayed_message,['Id']}}],casts => []},{emqx_management,3} => #{calls => [{{emqx_management_proto_v3,get_full_config,['Node']},{emqx_mgmt_api_configs,get_full_config,[]}},{{emqx_management_proto_v3,call_client,['Node','ClientId','Req']},{emqx_mgmt,do_call_client,['ClientId','Req']}},{{emqx_management_proto_v3,unsubscribe,['Node','ClientId','Topic']},{emqx_mgmt,do_unsubscribe,['ClientId','Topic']}},{{emqx_management_proto_v3,subscribe,['Node','ClientId','TopicTables']},{emqx_mgmt,do_subscribe,['ClientId','TopicTables']}},{{emqx_management_proto_v3,list_listeners,['Node']},{emqx_mgmt_api_listeners,do_list_listeners,[]}},{{emqx_management_proto_v3,list_subscriptions,['Node']},{emqx_mgmt,do_list_subscriptions,[]}},{{emqx_management_proto_v3,broker_info,['Nodes']},{emqx_mgmt,broker_info,[]}},{{emqx_management_proto_v3,node_info,['Nodes']},{emqx_mgmt,node_info,[]}},{{emqx_management_proto_v3,unsubscribe_batch,['Node','ClientId','Topics']},{emqx_mgmt,do_unsubscribe_batch,['ClientId','Topics']}}],casts => []}},release => "master",signatures => #{{emqx_retainer_proto_v1,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v6,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proxy,pread_local,4} => {any,[any,any,any,any]},{emqx_bridge_proto_v2,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v2,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_shared_sub_proto_v1,dispatch_with_ack,5} => {any,[{c,identifier,[pid],unknown},{c,union,[{c,atom,['_'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_monitor,current_rate,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[badrpc],unknown},any],{2,{c,atom,[badrpc],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown}]},{emqx_ft_storage_exporter_fs_proxy,list_exports_local,1} => {any,[any]},{emqx_management_proto_v3,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,list_connectors_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_lookup_by_clientid,2} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,none],unknown},any]},{emqx_persistent_session_ds,do_open_iterator,3} => {{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_implemented],unknown}],{2,{c,atom,[error],unknown}}},[any,any,any]},{emqx_cm,do_get_chann_conn_mod,2} => {any,[any,any]},{emqx_persistent_session_ds_proto_v1,close_iterator,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup,read_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v2,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_resource,create_local,5} => {{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}},[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_authz_api_sources,lookup_from_local_node,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_management_proto_v3,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ft_storage_exporter_fs_proto_v1,list_exports,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[following],unknown},optional,any},{{c,atom,[limit],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[transfer],unknown},optional,{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}}],none,none},unknown}]},{emqx,get_config,1} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_resource_proto_v1,remove,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_management_proto_v2,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_broker_proto_v1,list_client_subscriptions,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v4,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_resource_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_delayed,clear_all_local,0} => {{c,atom,[ok],unknown},[]},{emqx_bridge_proto_v5,v2_list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx,reset_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any]},{emqx_mgmt_api_plugins,delete_package,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,list_files,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,import_file,4} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_retainer_mnesia,active_indices,0} => {{c,tuple,[any,any],{2,any}},[]},{emqx_cm,do_get_chan_stats,2} => {any,[any,any]},{emqx_node_rebalance_proto_v3,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_listeners,do_list_listeners,0} => {{c,map,{[],{c,binary,{40,32},unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},unknown},[]},{emqx_conf_app,get_override_config_file,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[msg],unknown},mandatory,any},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[release],unknown},mandatory,{c,list,{any,{c,nil,[],unknown}},nonempty}},{{c,atom,[wall_clock],unknown},mandatory,{c,tuple,[any,any],{2,any}}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_persistent_session_ds,do_ensure_all_iterators_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_ds_replication_layer,do_make_iterator_v1,5} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_authz_proto_v1,lookup_from_all_nodes,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_ft_storage_fs_reader_proto_v1,read,3} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_slow_subs,clear_history,0} => {any,[]},{emqx_proto_v1,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_cm,do_kick_session,3} => {{c,atom,[ok],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,get_chann_conn_mod,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_eviction_agent_proto_v2,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_mgmt_api_plugins_proto_v1,install_package,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v1,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_v2_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v1,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,reset,1} => {any,[any]},{emqx_bridge_proto_v1,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v5,v2_get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v5,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed,delete_delayed_message,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v6,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_conf_proto_v2,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v1,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_api_listeners_proto_v1,listeners_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_mgr,server_info,1} => {any,[any]},{emqx_management_proto_v2,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_management_proto_v4,node_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_cm_proto_v1,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_dashboard_proto_v1,do_sample,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v2,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{ssl_pem_cache,clear,0} => {any,[]},{emqx_mgmt_api_plugins,ensure_action,2} => {{c,atom,[ok],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_conf_proto_v3,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_resource_proto_v1,recreate,4} => {any,[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_conf_proto_v3,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_api_listeners,do_listeners_cluster_status,1} => {{c,map,{[],any,any},unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node_v6,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry_proto_v1,get_cluster_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v1,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_resource,create_dry_run_local,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},any]},{emqx_gateway_cm,do_set_chan_info,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_api_cluster,connected_replicants,0} => {{c,list,{{c,tuple,[{c,atom,any,unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown}],{3,any}},{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_list_subscriptions,0} => {none,[]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_v2,list,1} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,rebalance_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_bridge_proto_v5,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status,evacuation_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[current_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_conns],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[migrate_to],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_mgmt_trace_proto_v2,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm,do_takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_gateway_cm_proto_v1,set_chan_stats,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx,get_config,2} => {any,[any,any]},{emqx_proto_v2,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_topic_metrics,metrics,0} => {{c,list,{{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_node_rebalance_agent,enable,3} => {any,[any,any,any]},{emqx_ft_storage_fs_proto_v1,pread,5} => {any,[{c,atom,any,unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,map,{[{{c,atom,[fragment],unknown},mandatory,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[filemeta],unknown},{c,map,{[{{c,atom,[checksum],unknown},optional,{c,tuple,[{c,atom,any,unknown},{c,binary,{8,0},unknown}],{2,any}}},{{c,atom,[expire_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[name],unknown},mandatory,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown}},{{c,atom,[segments_ttl],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[user_data],unknown},optional,{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown},{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},{c,union,[{c,atom,[false,null,true],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,any,unknown},none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[filemeta],unknown}}},{c,tuple,[{c,atom,[segment],unknown},{c,map,{[{{c,atom,[offset],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[segment],unknown}}}]}],unknown}},{{c,atom,[path],unknown},mandatory,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[size],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[timestamp],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_exporter_fs_proxy,read_export_file_local,2} => {any,[any,any]},{emqx_trace,trace_file,1} => {{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_topic_metrics,reset,0} => {any,[]},{emqx_conf_proto_v1,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm_proto_v1,takeover_session,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_cm_proto_v1,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_topic_metrics_proto_v1,reset,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins,get_plugins,0} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v3,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v2,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_exhook_proto_v1,all_servers_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v1,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_management_proto_v1,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v3,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,disconnected_session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_prometheus_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_telemetry,get_cluster_uuid,0} => {any,[]},{emqx_proto_v1,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_status,purge_status,0} => {{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[enabled],unknown},{c,map,{[{{c,atom,[current_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[initial_sessions],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[purge_rate],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}],{2,{c,atom,[enabled],unknown}}},none,none],unknown}],{2,any}},[]},{emqx_resource_proto_v1,create_dry_run,2} => {any,[{c,atom,any,unknown},any]},{emqx_mgmt_data_backup,delete_file,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,any,unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_rule_engine_proto_v1,reset_metrics,1} => {any,[{c,binary,{8,0},unknown}]},{emqx_mgmt_data_backup,list_files,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_proto_v1,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_topic_metrics_proto_v1,metrics,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_v2,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v1,broker_info,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins,describe_package,1} => {{c,tuple,[{c,atom,any,unknown},{c,list,{{c,map,{[],any,any},unknown},{c,nil,[],unknown}},unknown}],{2,any}},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_delayed_proto_v2,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v6,v2_get_metrics_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_dashboard_proto_v1,current_rate,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,set_chan_info,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},{c,map,{[],{c,atom,any,unknown},any},unknown}]},{emqx_node_rebalance_proto_v2,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_set_chan_stats,4} => {{c,atom,[false,true],unknown},[any,any,any,any]},{emqx_mgmt_trace_proto_v2,trace_file_detail,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v1,delete_all_deactivated_alarms,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_proto_v1,start_connector_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_v2,list,0} => {any,[]},{emqx_node_rebalance_proto_v2,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v2,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_slow_subs_proto_v1,clear_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed,get_delayed_message,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[delayed_interval],unknown},mandatory,any},{{c,atom,[delayed_remaining],unknown},mandatory,{c,number,any,integer}},{{c,atom,[expected_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[from_clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[from_username],unknown},mandatory,any},{{c,atom,[msgid],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[node],unknown},mandatory,any},{{c,atom,[payload],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[publish_at],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[qos],unknown},mandatory,any},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any]},{emqx_node_rebalance_proto_v2,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,do_unsubscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple,[any,any,any],{3,any}},none,none],unknown},{c,map,{[],any,any},unknown}],{2,any}},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_api_plugins_proto_v2,install_package,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_gateway_cm,do_call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,any]},{emqx_mgmt,do_call_client,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_cm_proto_v2,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_ds_replication_layer,do_drop_db_v1,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_eviction_agent,all_local_channels_count,0} => {any,[]},{emqx_bridge_proto_v4,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_cluster_proto_v3,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v1,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_persistent_session_ds_proto_v1,open_iterator,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},any]},{emqx_cm_proto_v2,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_evacuation_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_cluster_proto_v1,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_ds_proto_v2,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_bridge_proto_v3,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,evict_sessions,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown},any]},{emqx_gateway_http,gateway_status,1} => {{c,map,{[{{c,atom,[current_connections],unknown},optional,any},{{c,atom,[max_connections],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[running,stopped,unloaded],unknown}}],none,none},unknown},[{c,atom,any,unknown}]},{emqx_bridge_proto_v4,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_data_backup_proto_v1,read_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_cm_proto_v1,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_delayed_proto_v3,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_conf_proto_v1,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,reset,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v5,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,get_all,1} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v3,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_store_batch_v1,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],any,any},unknown},{c,map,{[],any,any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],any,any},unknown},{c,map,{[],none,none},unknown}]},{emqx_management_proto_v1,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,list,{{c,number,{int_set,"_defknotuy"},integer},{c,nil,[],unknown}},nonempty}],{2,{c,atom,[error],unknown}}},none,{c,map,{[],any,any},unknown}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_trace,trace_file_detail,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,map,{[{{c,atom,[file],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[reason],unknown},mandatory,{c,atom,any,unknown}}],none,none},unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[mtime],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},{c,tuple,[{c,tuple,[any,any,any],{3,any}},{c,tuple,[any,any,any],{3,any}}],{2,any}},none,none],unknown}},{{c,atom,[node],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[size],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_node_v6,4} => {any,[{c,atom,any,unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v6,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_trace,get_trace_size,0} => {{c,map,{[],any,any},unknown},[]},{emqx_prometheus_proto_v1,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics_proto_v1,metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_retainer_proto_v2,active_mnesia_indices,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,evict_connections,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_stats,getstats,0} => {{c,list,{{c,tuple,any,{any,any}},{c,nil,[],unknown}},unknown},[]},{emqx_alarm,deactivate,1} => {any,[any]},{emqx_conf_proto_v2,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v3,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_resources,local_connection_count,0} => {any,[]},{emqx_bridge_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_persistent_session_ds_proto_v1,close_all_iterators,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v2,list_bridges,1} => {any,[{c,atom,any,unknown}]},{emqx_ds_proto_v1,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_management_proto_v3,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v2,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_broker_proto_v1,forward,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_node_rebalance_proto_v1,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_exhook_proto_v1,server_hooks_metrics,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_prometheus_api,lookup_from_local_nodes,3} => {any,[{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_proto_v2,get_metrics,1} => {any,[{c,atom,any,unknown}]},{emqx_eviction_agent_proto_v2,all_channels_count,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_authz_cache,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v3,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_gateway_cm_proto_v1,call,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_prometheus_proto_v2,start,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v1,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_management_proto_v4,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_bridge_proto_v5,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_management_proto_v3,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,rebalance_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_gateway_http_proto_v1,get_cluster_status,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_prometheus_proto_v2,raw_prom_data,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,atom,any,unknown},{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx,update_config,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_v2,start,3} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v4,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_alarm,delete_all_deactivated_alarms,0} => {any,[]},{emqx_management_proto_v3,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_api_cluster,join,1} => {{c,union,[{c,atom,[ignore,ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,atom,any,unknown}]},{emqx_cm_proto_v2,takeover_session,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v3,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_broker_proto_v1,forward_async,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_delayed_proto_v3,delete_delayed_messages_by_topic_name,2} => {any,[{c,list,{any,{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_connector,list,0} => {any,[]},{emqx_cm_proto_v2,get_chann_conn_mod,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_mgmt_api_plugins_proto_v1,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_prometheus,do_stop,0} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,restarting,running,simple_one_for_one],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[]},{emqx_exhook_mgr,server_hooks_metrics,1} => {any,[any]},{emqx_ds_proto_v2,update_iterator,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v1,describe_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v4,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{erlang,send,2} => {any,[any,any]},{emqx_metrics_worker,get_metrics,2} => {{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_purge_proto_v1,stop,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_configs,get_full_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_fs_proxy,list_local,2} => {any,[any,any]},{emqx_ft_storage_fs_reader,read,2} => {any,[{c,identifier,[pid],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_node_rebalance_status_proto_v2,purge_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_delayed_proto_v1,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_proto_v1,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_gateway_cm,do_kick_session,4} => {{c,atom,[ok],unknown},[{c,atom,any,unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_management_proto_v2,subscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,map,{[{{c,atom,[nl],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[qos],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}},{{c,atom,[rap],unknown},mandatory,{c,number,{int_set,[0,1]},integer}},{{c,atom,[rh],unknown},mandatory,{c,number,{int_set,[0,1,2]},integer}}],{c,atom,any,unknown},any},unknown}],{2,any}},{c,nil,[],unknown}},unknown}]},{emqx_gateway_cm,do_get_chann_conn_mod,3} => {any,[any,any,any]},{emqx_mgmt_cluster_proto_v3,invite_node,3} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_proto_v1,clean_authz_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_list_bridges_on_nodes_v6,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown}]},{emqx_authn_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_authz_cache,drain_cache,0} => {{c,atom,[ok],unknown},[]},{emqx_ds_proto_v1,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_proto_v2,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_proto_v2,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_mgmt_data_backup_proto_v1,delete_file,3} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_gateway_cm,do_get_chan_info,3} => {{c,union,[{c,atom,[undefined],unknown},none,none,none,none,none,none,none,{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}}],any,any},unknown}],unknown},[any,any,any]},{emqx_retainer_dispatcher,wait_dispatch_complete,1} => {{c,atom,[ok],unknown},[any]},{emqx_resource,remove_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_shared_sub,do_dispatch_with_ack,4} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid,port],unknown},any,any,{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}]},{emqx_node_rebalance_status,local_status,0} => {{c,union,[{c,atom,[disabled],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[evacuation],unknown},any],{2,{c,atom,[evacuation],unknown}}},{c,tuple,[{c,atom,[purge],unknown},any],{2,{c,atom,[purge],unknown}}},{c,tuple,[{c,atom,[rebalance],unknown},{c,map,{[],{c,atom,[connection_eviction_rate,connection_goal,coordinator_node,disconnected_session_goal,recipients,session_eviction_rate,state,stats],unknown},any},unknown}],{2,{c,atom,[rebalance],unknown}}}]}],unknown},none,none],unknown},[]},{emqx_ds_replication_layer,do_next_v1,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,atom,[end_of_stream],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,tuple,[{c,binary,{8,0},unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any],{10,any}}],{2,any}},{c,nil,[],unknown}},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_conf_proto_v3,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_purge_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v1,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_proto_v1,get_alarms,2} => {any,[{c,atom,any,unknown},{c,atom,[activated,all,deactivated],unknown}]},{emqx_proto_v2,are_running,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v1,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm_proto_v1,kickout_client,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_delayed_proto_v3,delete_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_api_plugins_proto_v2,describe_package,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_eviction_agent,purge_sessions,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_slow_subs_proto_v1,get_history,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_delayed_proto_v1,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_conf,get_node_and_config,1} => {{c,tuple,[{c,atom,any,unknown},any],{2,any}},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_proto_v1,is_running,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v3,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_broker,subscriptions_via_topic,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[any]},{emqx_persistent_session_ds,do_ensure_iterator_closed,1} => {{c,atom,[ok],unknown},[any]},{emqx_bridge_resource,stop,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,unsubscribe,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,binary,{8,0},unknown}]},{emqx_mgmt_trace_proto_v1,trace_file,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_proto_v2,get_stats,1} => {any,[{c,atom,any,unknown}]},{emqx_conf_cli,get_config,0} => {{c,map,{[],any,any},unknown},[]},{emqx_ft_storage_exporter_fs_proto_v1,read_export_file,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,purge_sessions,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_management_proto_v2,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_telemetry_proto_v1,get_node_uuid,1} => {any,[{c,atom,any,unknown}]},{emqx_broker,subscriptions,1} => {{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}]},{emqx_slow_subs_api,get_history,0} => {{c,list,{{c,map,{[{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[last_update_time],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[timespan],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[topic],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},{c,nil,[],unknown}},unknown},[]},{emqx_gateway_cm_proto_v1,lookup_by_clientid,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_get_streams_v1,4} => {{c,list,{{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,any}},{c,nil,[],unknown}},unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_plugins,get_tar,1} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown}]},{emqx_conf_proto_v1,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_connector_proto_v1,start_connectors_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,get_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown},any]},{emqx_prometheus,do_start,0} => {{c,atom,[ok],unknown},[]},{emqx_gateway_cm_proto_v1,get_chan_stats,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_status_proto_v1,evacuation_status,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_topic_metrics,metrics,1} => {{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[topic_not_found],unknown}],{2,{c,atom,[error],unknown}}},none,{c,map,{[{{c,atom,[create_time],unknown},mandatory,any},{{c,atom,[metrics],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[reset_time],unknown},optional,any},{{c,atom,[topic],unknown},mandatory,any}],none,none},unknown}],unknown},[any]},{emqx_cm_proto_v1,kick_session,3} => {any,[{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_broker_proto_v1,list_subscriptions_via_topic,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v2,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_metrics_proto_v1,get_metrics,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_management_proto_v2,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_connector_resource,start,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_finish,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[noproc,timeout,unexpected_exception],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},none,none],unknown},[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_proto_v6,v2_lookup_from_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,get_chan_info,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_retainer_proto_v2,wait_dispatch_complete,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_bridge_proto_v4,stop_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_api_plugins_proto_v2,delete_package,1} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,available_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_mgmt_api_plugins_proto_v2,ensure_action,2} => {any,[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,atom,[restart,start,stop],unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_evacuation_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[migrate_to],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[server_reference],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_cm,lookup_client,1} => {{c,list,{any,{c,nil,[],unknown}},unknown},[{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},any],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},any],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_bridge_proto_v6,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_proto_v2,clean_pem_cache,1} => {any,[{c,atom,any,unknown}]},{emqx_dashboard_monitor,do_sample,2} => {any,[{c,atom,any,unknown},any]},{emqx_broker,dispatch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[no_subscribers,not_running],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,number,{int_rng,0,pos_inf},integer}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,tuple,[{c,atom,[delivery],unknown},{c,identifier,[pid],unknown},{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[any,any,any,any],{4,any}}]},{8,[{c,tuple,[any,any,any,any,any,any,any,any],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}}],{3,{c,atom,[delivery],unknown}}}]},{emqx_gateway_cm,do_get_chan_stats,3} => {any,[any,any,any]},{emqx_bridge_proto_v4,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_cm_proto_v2,get_chan_info,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v1,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_resource,reset_metrics_local,1} => {{c,atom,[ok],unknown},[{c,binary,{8,0},unknown}]},{emqx_mgmt,do_subscribe,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[subscribe],unknown},any],{2,{c,atom,[subscribe],unknown}}}]}],unknown},[any,any]},{emqx_mgmt_trace_proto_v1,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_ft_storage_fs_proto_v1,multilist,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}},{c,atom,[fragment,result],unknown}]},{emqx,is_running,0} => {{c,atom,[false,true],unknown},[]},{emqx_eviction_agent_proto_v1,evict_session_channel,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_resource_proto_v1,create,5} => {any,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_ds_proto_v2,next,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,number,{int_rng,1,pos_inf},integer}]},{emqx_cm_proto_v1,lookup_client,2} => {any,[{c,atom,any,unknown},{c,tuple_set,[{2,[{c,tuple,[{c,atom,[clientid],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[clientid],unknown}}},{c,tuple,[{c,atom,[username],unknown},{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,{c,atom,[username],unknown}}}]}],unknown}]},{emqx_node_rebalance_proto_v3,evict_sessions,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[connected,connecting,disconnected,idle,reauthenticating],unknown}]},{emqx_bridge_resource,restart,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},none,none],unknown},[any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,read_trace_file,4} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,number,{int_rng,0,pos_inf},integer},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_mgmt_api_plugins_proto_v1,get_plugins,0} => {any,[]},{emqx_gateway_cm,do_cast,4} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any]},{emqx_bridge_proto_v2,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v1,get_streams,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_conf_proto_v1,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v5,v2_start_bridge_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_rule_engine,reset_metrics_for_rule,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_resource,recreate_local,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found,updating_to_incorrect_resource_type],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[added_channels],unknown},mandatory,any},{{c,atom,[callback_mode],unknown},mandatory,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},mandatory,any},{{c,atom,[error],unknown},mandatory,any},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},mandatory,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},mandatory,any},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},{c,atom,any,unknown},any,{c,map,{[{{c,atom,[auto_restart_interval],unknown},optional,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,1,pos_inf},integer},none,none,none],unknown}},{{c,atom,[auto_retry_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[batch_size],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[batch_time],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[health_check_interval],unknown},optional,{c,number,any,integer}},{{c,atom,[health_check_timeout],unknown},optional,{c,number,any,integer}},{{c,atom,[inflight_window],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[max_buffer_bytes],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[resume_interval],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[spawn_buffer_workers],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_after_created],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[start_timeout],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_for_resource_ready],unknown},optional,{c,number,any,integer}},{{c,atom,[worker_pool_size],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}}],none,none},unknown}]},{emqx_delayed_proto_v3,get_delayed_message,2} => {any,[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_proto_v3,connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v2,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,disable_rebalance_agent,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any]},{emqx_mgmt,node_info,0} => {{c,map,{[{{c,atom,[connections],unknown},mandatory,any},{{c,atom,[edition],unknown},mandatory,{c,binary,{0,80},unknown}},{{c,atom,[live_connections],unknown},mandatory,any},{{c,atom,[load1],unknown},optional,{c,number,any,float}},{{c,atom,[load15],unknown},optional,{c,number,any,float}},{{c,atom,[load5],unknown},optional,{c,number,any,float}},{{c,atom,[log_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[max_fds],unknown},mandatory,any},{{c,atom,[memory_total],unknown},mandatory,{c,number,any,unknown}},{{c,atom,[memory_used],unknown},mandatory,{c,number,any,integer}},{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[process_available],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[process_used],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[role],unknown},mandatory,{c,atom,[core,replicant],unknown}},{{c,atom,[sys_path],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[uptime],unknown},mandatory,any},{{c,atom,[version],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown},[]},{emqx_ft_storage_fs_proxy,lookup_local_assembler,1} => {any,[any]},{emqx_cm_proto_v2,get_chan_stats,2} => {any,[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_bridge_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_bridge_v1_compatible,not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,atom,[actions,sources],unknown},{c,map,{[{{c,atom,[error],unknown},mandatory,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,none,{c,tuple_set,[{3,[{c,tuple,[{c,atom,[error],unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}],{3,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[incomplete],unknown},{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{3,{c,atom,[incomplete],unknown}}}]}],unknown},none,none],unknown}},{{c,atom,[name],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[raw_config],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[resource_data],unknown},mandatory,{c,map,{[{{c,atom,[added_channels],unknown},optional,any},{{c,atom,[callback_mode],unknown},optional,{c,atom,[always_sync,async_if_possible],unknown}},{{c,atom,[config],unknown},optional,any},{{c,atom,[error],unknown},optional,any},{{c,atom,[id],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[mod],unknown},optional,{c,atom,any,unknown}},{{c,atom,[query_mode],unknown},optional,{c,atom,[async,no_queries,simple_async,simple_async_internal_buffer,simple_sync,simple_sync_internal_buffer,sync],unknown}},{{c,atom,[state],unknown},optional,any},{{c,atom,[status],unknown},optional,{c,atom,[connected,connecting,disconnected,stopped],unknown}}],none,none},unknown}},{{c,atom,[status],unknown},mandatory,{c,atom,[connected,connecting,disconnected,stopped],unknown}},{{c,atom,[type],unknown},mandatory,{c,binary,{8,0},unknown}}],none,none},unknown}],{3,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_replication_layer,do_update_iterator_v2,4} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,iterator,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[2]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,binary,{8,0},unknown}]},{emqx_node_rebalance_evacuation,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_node_rebalance_proto_v1,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_metrics,all,0} => {{c,list,{{c,tuple,[any,{c,number,any,integer}],{2,any}},{c,nil,[],unknown}},unknown},[]},{emqx_bridge_proto_v5,v2_lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ft_storage_fs_proto_v1,list_assemblers,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,tuple,[{c,binary,{8,0},unknown},{c,binary,{8,0},unknown}],{2,any}}]},{emqx_node_rebalance_agent,disable,2} => {any,[any,any]},{emqx_bridge_proto_v2,restart_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authn_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,tuple,[{c,atom,any,unknown},{c,union,[{c,atom,[not_found_resource],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}],{2,any}}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,tuple,[{c,atom,any,unknown},{c,atom,[connected,connecting,disconnected,stopped],unknown},{c,map,{[{{c,atom,[counters],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},mandatory,{c,map,{[],any,any},unknown}}],none,none},unknown},{c,map,{[{{c,atom,[counters],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[gauges],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[rate],unknown},optional,{c,map,{[],any,any},unknown}},{{c,atom,[slides],unknown},optional,{c,map,{[],any,any},unknown}}],none,none},unknown}],{4,any}}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,atom,any,unknown},{c,binary,{8,0},unknown}]},{emqx_bridge_proto_v4,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,remove_config,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_management_proto_v4,broker_info,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v2,reset,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_eviction_agent,evict_connections,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[disabled],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[any]},{emqx_bridge_proto_v3,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v2,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_purge_proto_v1,start,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,map,{[{{c,atom,[purge_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}}],none,none},unknown}]},{emqx_eviction_agent,evict_session_channel,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]},{3,[{c,tuple,[{c,atom,[ok],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,{c,identifier,[pid],unknown},none,none,none,none,none],unknown},any],{3,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,map,{[{{c,atom,[clean_start],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[clientid],unknown},optional,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[conn_mod],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[conn_props],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[connected],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[connected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[disconnected_at],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[expiry_interval],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[keepalive],unknown},optional,{c,number,{int_rng,0,1114111},integer}},{{c,atom,[peercert],unknown},optional,{c,union,[{c,atom,[nossl,undefined],unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,any,{any,any}},none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[peername],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[proto_name],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[receive_maximum],unknown},optional,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[sockname],unknown},mandatory,{c,tuple,[{c,union,[{c,atom,[local,undefined,unspec],unknown},none,none,none,none,none,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown},none,none],unknown},any],{2,any}}},{{c,atom,[socktype],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,map,{[{{c,atom,[anonymous],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[auth_result],unknown},optional,{c,atom,[bad_authentication_method,bad_clientid_or_password,bad_username_or_password,banned,client_identifier_not_valid,not_authorized,server_busy,server_unavailable,success],unknown}},{{c,atom,[clientid],unknown},mandatory,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[cn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[dn],unknown},optional,{c,binary,{8,0},unknown}},{{c,atom,[is_bridge],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[is_superuser],unknown},mandatory,{c,atom,[false,true],unknown}},{{c,atom,[mountpoint],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[password],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[peerhost],unknown},mandatory,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[protocol],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[sockport],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[username],unknown},mandatory,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}},{{c,atom,[ws_cookie],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,none],unknown}},{{c,atom,[zone],unknown},mandatory,{c,atom,any,unknown}}],{c,atom,any,unknown},any},unknown}]},{emqx_management_proto_v1,list_listeners,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_agent,enable,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown},any]},{emqx_mgmt_cluster_proto_v2,connected_replicants,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v2,start_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_shared_sub_proto_v1,send,4} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown},{c,binary,{8,0},unknown},any]},{emqx_mgmt,do_unsubscribe_batch,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[channel_not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[unsubscribe],unknown},{c,list,{{c,tuple,[any,any],{2,any}},{c,nil,[],unknown}},unknown}],{2,{c,atom,[unsubscribe],unknown}}}]}],unknown},[any,any]},{emqx_management_proto_v4,unsubscribe_batch,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,list,{{c,binary,{8,0},unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v1,node_rebalance_start,2} => {any,[{c,atom,any,unknown},{c,map,{[{{c,atom,[abs_conn_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[abs_sess_threshold],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[conn_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[nodes],unknown},optional,{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}},{{c,atom,[rel_conn_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[rel_sess_threshold],unknown},optional,{c,number,any,unknown}},{{c,atom,[sess_evict_rate],unknown},optional,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[wait_health_check],unknown},optional,{c,number,any,unknown}},{{c,atom,[wait_takeover],unknown},optional,{c,number,any,unknown}}],none,none},unknown}]},{emqx_bridge_v2_api,lookup_from_local_node,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_purge,start,1} => {any,[{c,map,{[],any,any},unknown}]},{emqx_bridge_proto_v6,get_metrics_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_management_proto_v3,call_client,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any]},{emqx_node_rebalance,disconnected_session_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_bridge_proto_v2,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_mgmt_trace_proto_v2,get_trace_size,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm_proto_v2,takeover_finish,2} => {any,[{c,atom,any,unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v1,get_override_config_file,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,update,4} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,make_iterator,6} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,opaque,[{opaque,emqx_ds_storage_layer,stream,0,{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[1]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,number,{int_rng,0,1114111},integer}},{{c,number,{int_set,[3]},integer},mandatory,any}],none,none},unknown}}],unknown},{c,list,{{c,union,[{c,atom,['','#','+'],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,pos_inf},integer}]},{emqx_exhook_proto_v1,server_info,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,binary,{8,0},unknown}]},{emqx_conf_proto_v3,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_delayed,do_delete_delayed_messages_by_topic_name,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,binary,{8,0},unknown}]},{emqx_node_rebalance_purge,stop,0} => {any,[]},{emqx_mgmt_api_trace,read_trace_file,3} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[eof],unknown},{c,union,[{c,atom,[undefined],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}],{2,{c,atom,[eof],unknown}}},{c,tuple,[{c,atom,[error],unknown},{c,union,[{c,atom,any,unknown},none,none,none,none,none,{c,tuple,[{c,atom,[no_translation],unknown},{c,atom,[unicode],unknown},{c,atom,[latin1],unknown}],{3,{c,atom,[no_translation],unknown}}},none,none],unknown}],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,binary,{8,0},unknown},any,any]},{emqx_mgmt_api_plugins_proto_v2,get_plugins,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_conf_proto_v3,get_hocon_config,1} => {any,[{c,atom,any,unknown}]},{emqx_proto_v2,deactivate_alarm,2} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_delayed_proto_v2,clear_all,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,do_get_chan_info,2} => {any,[any,any]},{emqx_node_rebalance_agent,enable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[eviction_agent_busy,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_mgmt,broker_info,0} => {{c,map,{[{{c,atom,[node],unknown},mandatory,{c,atom,any,unknown}},{{c,atom,[node_status],unknown},mandatory,{c,atom,[running],unknown}},{{c,atom,[otp_release],unknown},mandatory,{c,binary,{8,0},unknown}}],any,any},unknown},[]},{emqx_telemetry,get_node_uuid,0} => {any,[]},{emqx_management_proto_v1,get_full_config,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v3,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_api_proto_v2,node_rebalance_evacuation_stop,1} => {any,[{c,atom,any,unknown}]},{emqx_gateway_cm_proto_v1,call,5} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown},any,{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_data_backup,maybe_copy_and_import,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[bardrpc],unknown},any],{2,{c,atom,[bardrpc],unknown}}},{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config_errors],unknown},mandatory,{c,map,{[],{c,list,{any,{c,nil,[],unknown}},unknown},{c,tuple,[any,any],{2,any}}},unknown}},{{c,atom,[db_errors],unknown},mandatory,{c,map,{[],{c,atom,any,unknown},{c,tuple,[any,any],{2,any}}},unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_license_proto_v1,remote_connection_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_cm,kick_session,1} => {{c,atom,[ok],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_bridge_proto_v5,start_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v1,update,3} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},any,{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_replication_layer,do_add_generation_v2,1} => {{c,atom,[ok],unknown},[{c,atom,any,unknown}]},{emqx_bridge_v2_api,get_metrics_from_local_node_v6,3} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,drop_db,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx,remove_config,2} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,map,{[{{c,atom,[config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown}},{{c,atom,[post_config_update],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[raw_config],unknown},optional,{c,union,[{c,atom,[undefined],unknown},none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],{c,binary,{8,0},unknown},any},unknown}],unknown}}],none,none},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_ds_proto_v2,add_generation,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,any,unknown}]},{emqx_node_rebalance_evacuation,is_node_available,0} => {{c,atom,any,unknown},[]},{emqx_node_rebalance_agent,disable,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[already_disabled,invalid_coordinator],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,identifier,[pid],unknown}]},{emqx_node_rebalance_proto_v3,enable_rebalance_agent,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown},any,{c,map,{[{{c,atom,[allow_connections],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_plugins_proto_v1,get_tar,3} => {any,[{c,atom,any,unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,1114111},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}]},{emqx_mgmt_api_plugins,install_package,2} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,map,{[],any,any},unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,none,none,none,{c,list,{any,{c,nil,[],unknown}},unknown},{c,number,{int_rng,0,1114111},integer},none,none,none],unknown},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_ds_proto_v2,store_batch,5} => {any,[{c,atom,any,unknown},{c,atom,any,unknown},{c,binary,{8,0},unknown},{c,map,{[{{c,number,{int_set,[1]},integer},mandatory,{c,number,{int_set,[3]},integer}},{{c,number,{int_set,[2]},integer},mandatory,{c,list,{{c,tuple,[{c,atom,[message],unknown},{c,binary,{8,0},unknown},any,{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,map,{[],{c,atom,any,unknown},{c,atom,[false,true],unknown}},unknown},{c,map,{[{{c,atom,[allow_publish],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[peerhost],unknown},optional,{c,tuple_set,[{4,[{c,tuple,[{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer},{c,number,{int_rng,0,255},integer}],{4,any}}]},{8,[{c,tuple,[{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer},{c,number,{int_rng,0,1114111},integer}],{8,any}}]}],unknown}},{{c,atom,[properties],unknown},optional,{c,map,{[],{c,atom,any,unknown},any},unknown}},{{c,atom,[proto_ver],unknown},optional,{c,union,[none,{c,binary,{8,0},unknown},none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown}},{{c,atom,[protocol],unknown},optional,{c,atom,any,unknown}},{{c,atom,[username],unknown},optional,{c,union,[{c,atom,[undefined],unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}}],{c,atom,any,unknown},any},unknown},{c,binary,{8,0},unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,number,any,integer},any],{10,{c,atom,[message],unknown}}},{c,nil,[],unknown}},unknown}}],none,none},unknown},{c,map,{[],none,none},unknown}]},{emqx_bridge,list,0} => {{c,list,{any,{c,nil,[],unknown}},unknown},[]},{emqx_mgmt,do_kickout_clients,1} => {{c,atom,[ok],unknown},[{c,list,{any,{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v5,list_bridges_on_nodes,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_bridge_proto_v6,restart_bridge_to_node,3} => {any,[{c,atom,any,unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_conf_proto_v3,sync_data_from_node,1} => {any,[{c,atom,any,unknown}]},{emqx_mgmt_cluster_proto_v2,invite_node,2} => {any,[{c,atom,any,unknown},{c,atom,any,unknown}]},{emqx_conf_proto_v3,get_config,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_evacuation,stop,0} => {any,[]},{emqx_management_proto_v4,list_subscriptions,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance,stop,0} => {any,[]},{emqx_bridge_proto_v4,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_node_rebalance_status_proto_v1,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_node_rebalance_proto_v2,session_counts,1} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown}]},{emqx_node_rebalance_status_proto_v2,local_status,1} => {any,[{c,atom,any,unknown}]},{emqx_bridge_proto_v6,v2_start_bridge_on_all_nodes_v6,4} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,atom,[actions,sources],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_bridge_proto_v1,lookup_from_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_gateway_cm_proto_v1,kick_session,4} => {any,[{c,atom,any,unknown},{c,atom,[discard,kick],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,remove_config,2} => {any,[{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_api,get_metrics_from_local_node,2} => {{c,map,{[{{c,atom,[dropped],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.expired'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.other'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.queue_full'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_not_found'],unknown},mandatory,{c,number,any,integer}},{{c,atom,['dropped.resource_stopped'],unknown},mandatory,{c,number,any,integer}},{{c,atom,[failed],unknown},mandatory,{c,number,any,integer}},{{c,atom,[inflight],unknown},mandatory,any},{{c,atom,[late_reply],unknown},mandatory,{c,number,any,integer}},{{c,atom,[matched],unknown},mandatory,{c,number,any,integer}},{{c,atom,[queuing],unknown},mandatory,any},{{c,atom,[rate],unknown},mandatory,any},{{c,atom,[rate_last5m],unknown},mandatory,any},{{c,atom,[rate_max],unknown},mandatory,any},{{c,atom,[received],unknown},mandatory,{c,number,any,integer}},{{c,atom,[retried],unknown},mandatory,{c,number,any,integer}},{{c,atom,[success],unknown},mandatory,{c,number,any,integer}}],none,none},unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,list,{any,{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},{c,number,{int_rng,0,255},integer},none,none,none],unknown},{c,union,[none,{c,binary,{8,0},unknown},none,none,{c,nil,[],unknown},none,none,none,none],unknown}},unknown},none,none,none,none],unknown}]},{emqx_authz_cache,drain_cache,1} => {{c,union,[{c,atom,[ok],unknown},none,none,none,none,none,{c,tuple,[{c,atom,[error],unknown},{c,atom,[not_found],unknown}],{2,{c,atom,[error],unknown}}},none,none],unknown},[{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown}]},{emqx_node_rebalance_proto_v1,disable_rebalance_agent,2} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,identifier,[pid],unknown}]},{emqx_conf_proto_v2,reset,3} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,nil,[],unknown}},nonempty},{c,map,{[{{c,atom,[lazy_evaluator],unknown},optional,{c,function,{{c,product,[{c,function,{any,any},unknown}],unknown},any},unknown}},{{c,atom,[override_to],unknown},optional,{c,atom,[cluster,local],unknown}},{{c,atom,[persistent],unknown},optional,{c,atom,[false,true],unknown}},{{c,atom,[rawconf_with_defaults],unknown},optional,{c,atom,[false,true],unknown}}],none,none},unknown}]},{emqx_bridge_proto_v6,stop_bridges_to_all_nodes,3} => {any,[{c,list,{{c,atom,any,unknown},{c,nil,[],unknown}},unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,{c,list,{{c,number,{int_rng,0,255},integer},{c,nil,[],unknown}},unknown},none,none,none,none],unknown}]},{emqx_cm,takeover_session,2} => {{c,union,[{c,atom,[none,ok,undefined],unknown},none,none,none,{c,list,{{c,tuple,[{c,atom,any,unknown},any],{2,any}},{c,nil,[],unknown}},unknown},none,{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[expired],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[expired],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,union,[none,none,none,none,{c,list,{{c,tuple,[any,any,any],{3,any}},{c,nil,[],unknown}},unknown},none,none,none,{c,map,{[],any,any},unknown}],unknown}],{2,{c,atom,[ok],unknown}}},{c,tuple,[{c,atom,[persistent],unknown},{c,union,[none,none,none,none,none,none,{c,tuple,[{c,atom,[session],unknown},{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},any,{c,atom,[false,true],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,atom,[false,true],unknown},{c,opaque,[{opaque,emqx_inflight,inflight,0,{c,tuple,[any,any,any],{3,any}}}],unknown},{c,tuple,[any,any,any,any,any,any,any,any,any,any,any],{11,any}},{c,number,{int_rng,1,1114111},integer},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,map,{[],any,any},unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,union,[{c,atom,[infinity],unknown},none,none,none,none,{c,number,{int_rng,0,pos_inf},integer},none,none,none],unknown},{c,number,{int_rng,1,pos_inf},integer}],{15,{c,atom,[session],unknown}}},none,{c,map,{[{{c,atom,[conninfo],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[created_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[id],unknown},mandatory,{c,binary,{8,0},unknown}},{{c,atom,[inflight],unknown},mandatory,{c,opaque,[{opaque,emqx_persistent_message_ds_replayer,inflight,0,{c,tuple,[any,any,any,any],{4,any}}}],unknown}},{{c,atom,[last_alive_at],unknown},mandatory,{c,number,{int_rng,0,pos_inf},integer}},{{c,atom,[props],unknown},mandatory,{c,map,{[],any,any},unknown}},{{c,atom,[receive_maximum],unknown},mandatory,{c,number,{int_rng,1,pos_inf},integer}},{{c,atom,[subscriptions],unknown},mandatory,{c,opaque,[{opaque,emqx_topic_gbt,t,2,{c,opaque,[{opaque,gb_trees,tree,2,{c,tuple,[any,any],{2,any}}}],unknown}}],unknown}},{{c,atom,[timer_bump_last_alive_at],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_get_streams],unknown},optional,{c,identifier,[reference],unknown}},{{c,atom,[timer_pull],unknown},optional,{c,identifier,[reference],unknown}}],none,none},unknown}],unknown}],{2,{c,atom,[persistent],unknown}}}]},{4,[{c,tuple,[{c,atom,[living],unknown},{c,atom,any,unknown},{c,identifier,[pid],unknown},any],{4,{c,atom,[living],unknown}}}]}],unknown},none,{c,map,{[],{c,atom,any,unknown},any},unknown}],unknown},[any,any]},{emqx_node_rebalance,connection_count,0} => {{c,tuple,[{c,atom,[ok],unknown},any],{2,{c,atom,[ok],unknown}}},[]},{emqx_conf_app,sync_data_from_node,0} => {{c,tuple_set,[{2,[{c,tuple,[{c,atom,[error],unknown},any],{2,{c,atom,[error],unknown}}},{c,tuple,[{c,atom,[ok],unknown},{c,binary,{8,0},unknown}],{2,{c,atom,[ok],unknown}}}]}],unknown},[]},{emqx_management_proto_v4,kickout_clients,2} => {any,[{c,atom,any,unknown},{c,list,{{c,union,[{c,atom,any,unknown},{c,binary,{8,0},unknown},none,none,none,none,none,none,none],unknown},{c,nil,[],unknown}},unknown}]},{emqx_alarm,get_alarms,1} => {any,[{c,atom,[activated,all,deactivated],unknown}]},{emqx_management_proto_v2,node_info,1} => {any,[{c,atom,any,unknown}]},{emqx_exhook_mgr,all_servers_info,0} => {any,[]}}}.

From 393e48288957284958319ab2f12692fb1ff5c2ef Mon Sep 17 00:00:00 2001
From: Kinplemelon <wujiu529@gmail.com>
Date: Wed, 21 Feb 2024 13:56:05 +0800
Subject: [PATCH 273/273] chore: upgrade dashboard to e1.5.1-s3-beta.1 for ee

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index 694cb75c0..fbf68519e 100644
--- a/Makefile
+++ b/Makefile
@@ -21,7 +21,7 @@ endif
 # Dashboard version
 # from https://github.com/emqx/emqx-dashboard5
 export EMQX_DASHBOARD_VERSION ?= v1.7.0
-export EMQX_EE_DASHBOARD_VERSION ?= e1.5.0
+export EMQX_EE_DASHBOARD_VERSION ?= e1.5.1-s3-beta.1
 
 PROFILE ?= emqx
 REL_PROFILES := emqx emqx-enterprise