@bitspacerlabs/rabbit-relay 0.5.0

package/.github/workflows/deploy.yml

@@ -0,0 +1,66 @@
+# Sample workflow for building and deploying a VitePress site to GitHub Pages
+#
+name: Deploy VitePress site to Pages
+
+on:
+  # Runs on pushes targeting the `main` branch. Change this to `master` if you're
+  # using the `master` branch as the default branch.
+  push:
+    branches: [main]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0 # Not needed if lastUpdated is not enabled
+      # - uses: pnpm/action-setup@v4 # Uncomment this block if you're using pnpm
+      #   with:
+      #     version: 9 # Not needed if you've set "packageManager" in package.json
+      # - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm # or pnpm / yarn
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Install dependencies
+        run: npm ci # or pnpm install / yarn install / bun install
+      - name: Build with VitePress
+        run: npm run docs:build # or pnpm docs:build / yarn docs:build / bun run docs:build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "typescript.tsdk": "node_modules/typescript/lib"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BitSpacer Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+<p align="center">
+  <img src="assets/logo.svg" alt="Rabbit Relay" width="260">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/rabbit-relay">
+    <img src="https://img.shields.io/npm/v/rabbit-relay.svg?style=flat-square" alt="NPM Version">
+  </a>
+  <a href="https://github.com/bitspacerlabs/rabbit-relay">
+    <img src="https://img.shields.io/github/stars/bitspacerlabs/rabbit-relay.svg?style=flat-square" alt="GitHub Stars">
+  </a>
+  <a href="https://github.com/bitspacerlabs/rabbit-relay/issues">
+    <img src="https://img.shields.io/github/issues/bitspacerlabs/rabbit-relay.svg?style=flat-square" alt="Issues">
+  </a>
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="License">
+  </a>
+</p>
+
+---
+
+## Rabbit Relay
+
+**Rabbit Relay** is a type-safe RabbitMQ framework for Node.js.
+
+It helps you publish and consume events using real RabbitMQ concepts, with TypeScript types and reliable defaults.
+
+---
+
+## Start Here
+
+**Documentation & Guides**  
+https://bitspacerlabs.github.io/rabbit-relay/
+
+
+---
+
+## Installation
+
+```bash
+npm install rabbit-relay
+```
+
+---
+
+## Minimal Examples
+
+```ts
+import { RabbitMQBroker, event } from "rabbit-relay";
+
+const broker = new RabbitMQBroker("example.service");
+
+const pub = await broker.queue("example.q").exchange("example.exchange", { exchangeType: "topic" });
+
+const send = event("send", "v1").of<{ message: string }>();
+
+const api = pub.with({ send });
+
+await api.send({ message: "hello world" });
+```
+
+---
+
+
+```ts
+import { RabbitMQBroker, event } from "rabbit-relay";
+
+const broker = new RabbitMQBroker("example.publisher");
+
+const pub = await broker.queue("example.q").exchange("example.direct", { exchangeType: "direct" });
+
+const hello = event("hello", "v1").of<{ msg: string }>();
+
+await pub.produce(hello({ msg: "world" }));
+```
+
+---
+
+## When to Use Rabbit Relay
+
+- You already use RabbitMQ
+- You want type-safe events
+- You prefer explicit topology and ownership
+- You don’t want hidden abstractions
+
+---
+
+## License
+
+MIT © BitSpacerLabs

package/assets/logo.svg

@@ -0,0 +1,154 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="512.000000pt" height="512.000000pt" viewBox="0 0 512.000000 512.000000"
+ preserveAspectRatio="xMidYMid meet">
+<metadata>
+Created by potrace 1.16, written by Peter Selinger 2001-2019
+</metadata>
+<g transform="translate(0.000000,512.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M2940 4706 c-165 -36 -364 -210 -502 -438 l-33 -55 -2 93 c-4 160
+-38 267 -106 332 -99 95 -223 22 -327 -192 -55 -113 -75 -180 -90 -304 -11
+-88 -9 -133 17 -325 16 -126 13 -175 -15 -200 -9 -9 -58 -36 -109 -62 -96 -48
+-187 -121 -224 -181 l-21 -35 -24 67 c-19 56 -67 144 -77 144 -2 0 11 -30 29
+-67 18 -38 40 -93 48 -123 l16 -55 -23 30 c-12 16 -35 43 -50 60 -19 21 -16
+12 13 -29 35 -53 51 -96 34 -96 -3 0 -19 9 -35 21 -47 33 -144 68 -201 73 -29
+2 -42 2 -28 -1 66 -11 141 -38 198 -71 52 -30 62 -40 58 -58 -3 -11 -9 -54
+-12 -95 -7 -70 -10 -77 -67 -154 -32 -44 -61 -82 -64 -85 -3 -3 -27 20 -55 50
+-36 39 -42 44 -21 15 52 -70 64 -92 57 -108 -5 -14 -13 -12 -58 13 -63 36
+-146 65 -207 74 -38 5 -35 3 20 -13 75 -22 211 -89 218 -108 3 -7 3 -19 0 -27
+-5 -12 -15 -12 -69 -1 -82 17 -230 28 -203 16 11 -5 38 -10 60 -11 38 0 87
+-10 168 -31 48 -13 50 -39 4 -39 -84 0 -264 -65 -300 -108 -6 -9 6 -4 29 10
+65 41 196 77 287 78 38 0 15 -29 -35 -45 -52 -17 -173 -79 -182 -93 -2 -4 26
+7 62 25 37 17 91 38 120 47 70 20 68 2 -4 -44 -31 -19 -75 -57 -98 -85 -71
+-86 -73 -92 -6 -24 63 65 155 128 167 115 4 -3 -5 -19 -20 -34 -36 -38 -79
+-136 -83 -191 l-3 -46 8 46 c5 25 18 63 29 85 23 44 98 130 86 99 -22 -62 -34
+-126 -33 -175 l2 -55 7 70 c4 39 14 88 24 109 l16 40 33 -47 c17 -26 46 -54
+62 -63 17 -9 46 -25 65 -35 24 -13 55 -19 99 -19 48 0 62 -3 58 -13 -3 -7 -17
+-51 -33 -98 -28 -85 -29 -114 -24 -379 2 -79 -8 -220 -20 -290 -37 -223 28
+-393 235 -609 l98 -101 -6 -65 c-3 -35 -13 -78 -22 -95 -14 -28 -18 -29 -59
+-24 -88 12 -176 -68 -176 -161 l0 -42 -72 -6 c-91 -8 -138 -17 -138 -27 0 -4
+15 -11 33 -14 45 -8 391 -26 515 -26 106 0 131 -11 65 -30 -48 -13 -68 -26
+-55 -34 38 -23 383 -40 553 -27 139 11 163 17 155 37 -4 12 32 14 212 14 258
+0 483 14 566 35 34 9 96 19 139 24 43 5 81 12 84 15 9 9 -39 24 -103 31 -144
+16 -187 62 -89 94 149 49 239 161 353 441 55 133 65 186 60 295 -6 110 -33
+177 -80 201 -77 40 -152 -37 -188 -191 l-16 -70 -8 93 c-19 237 -109 471 -280
+731 -84 127 -173 223 -269 289 -131 90 -221 127 -350 143 -78 10 -81 11 -150
+72 -137 120 -139 123 -130 154 16 57 6 156 -25 253 -41 129 -43 147 -31 242
+23 184 70 257 234 358 304 189 439 357 499 623 38 166 52 207 101 282 73 112
+58 149 -67 166 -40 6 -82 14 -93 19 -38 16 -70 18 -125 6z m6 -51 c-235 -96
+-424 -356 -511 -704 -21 -83 -86 -426 -85 -448 2 -28 140 411 140 443 0 4 2 5
+6 2 3 -3 -8 -64 -25 -134 -16 -71 -32 -144 -36 -163 l-7 -34 48 28 c62 35 113
+73 142 105 45 51 102 183 132 310 51 213 70 273 103 328 32 54 103 130 112
+121 3 -3 8 -39 11 -80 8 -92 -17 -200 -74 -322 -68 -145 -146 -250 -318 -427
+-169 -175 -197 -212 -240 -325 -38 -100 -36 -190 5 -310 42 -120 49 -187 26
+-259 -32 -101 -120 -178 -261 -226 l-56 -20 -31 24 c-72 54 -249 121 -299 114
+-15 -2 1 -9 44 -20 79 -20 203 -71 238 -98 l25 -19 -26 -9 c-14 -6 -46 -13
+-70 -17 -40 -6 -49 -3 -89 28 -58 43 -139 91 -146 84 -3 -2 14 -16 38 -30 24
+-14 63 -40 88 -58 39 -29 42 -33 25 -40 -45 -18 -80 -9 -139 36 -33 25 -62 42
+-65 39 -3 -4 0 -9 7 -11 25 -9 11 -33 -28 -43 -86 -23 -180 34 -180 108 0 34
+5 44 38 68 95 73 94 101 -3 61 l-75 -31 -27 21 c-53 39 -46 67 48 198 88 122
+97 145 115 263 8 51 23 110 34 131 33 67 113 127 266 203 132 65 148 71 207
+71 35 0 74 -4 86 -8 21 -6 22 -8 6 -26 -10 -10 -15 -25 -12 -34 7 -18 27 -20
+27 -3 0 19 31 47 46 41 8 -3 14 1 14 10 0 8 12 40 26 71 14 31 46 122 70 204
+50 163 107 290 178 399 138 213 280 343 431 395 74 26 89 21 21 -7z m-819 -88
+c-49 -72 -95 -175 -129 -292 -21 -75 -23 -98 -23 -347 0 -200 -3 -270 -12
+-279 -11 -10 -13 0 -13 50 0 34 -7 117 -16 184 -19 144 -14 265 16 382 28 111
+102 255 161 316 26 27 50 49 53 49 3 0 -14 -28 -37 -63z m161 6 c28 -40 49
+-108 62 -204 15 -108 6 -210 -30 -324 -16 -49 -45 -146 -65 -214 -49 -164 -63
+-193 -89 -185 -44 14 -47 57 -11 170 43 136 68 274 90 494 7 72 -11 18 -60
+-185 -24 -99 -59 -230 -78 -290 -19 -61 -38 -125 -42 -142 -4 -22 -12 -33 -24
+-33 -16 0 -19 14 -24 122 -14 249 -2 395 43 543 29 92 93 215 136 259 39 41
+57 38 92 -11z m922 38 c0 -5 -11 -23 -25 -39 -40 -48 -63 -111 -100 -274 -54
+-240 -128 -368 -292 -510 -37 -32 -94 -75 -128 -97 l-62 -38 112 111 c95 95
+119 124 158 201 59 116 78 170 122 335 20 74 48 155 62 180 47 80 153 171 153
+131z m-475 -333 c-29 -57 -70 -147 -90 -200 -21 -54 -40 -96 -43 -94 -9 9 41
+152 80 231 34 67 95 165 104 165 1 0 -22 -46 -51 -102z m-1205 -1048 c0 -11
+-4 -20 -9 -20 -5 0 -7 9 -4 20 3 11 7 20 9 20 2 0 4 -9 4 -20z m-150 -525 c5
+3 12 0 16 -6 4 -8 3 -9 -4 -5 -18 11 -14 -5 7 -28 28 -32 47 -112 31 -131 -12
+-14 -16 -13 -36 6 -28 27 -60 100 -69 161 -10 64 3 81 27 34 10 -20 23 -34 28
+-31z m1127 -107 c30 -22 74 -64 99 -92 25 -28 43 -43 40 -33 -14 42 87 -48
+125 -112 22 -36 39 -59 39 -52 0 17 -48 110 -76 147 l-23 31 51 -9 c125 -23
+306 -126 406 -231 70 -75 202 -278 267 -412 66 -137 101 -242 120 -359 22
+-137 17 -164 -10 -57 -25 96 -43 136 -31 68 61 -337 41 -553 -66 -718 -34 -54
+-39 -68 -34 -100 13 -83 -32 -189 -81 -189 -34 0 -48 18 -47 60 1 22 -2 40 -6
+40 -10 0 -30 -48 -30 -73 0 -35 -19 -47 -77 -47 -43 0 -54 4 -64 21 -11 21 -9
+60 7 109 6 22 5 23 -8 13 -16 -14 -43 -73 -52 -115 -12 -56 -56 -26 -56 38 0
+51 32 102 80 127 48 25 176 19 243 -11 70 -31 62 -1 -9 34 -42 20 -76 29 -134
+32 -71 4 -82 2 -130 -24 -58 -32 -87 -67 -105 -127 l-12 -42 -112 -3 c-107 -3
+-111 -2 -111 18 0 37 29 78 72 104 26 16 36 26 25 26 -48 0 -120 -65 -132
+-120 -6 -26 -11 -30 -41 -30 -45 0 -54 32 -24 90 28 55 81 79 172 80 37 0 69
+-4 73 -10 3 -5 21 2 41 15 42 28 135 65 167 65 12 0 29 5 37 11 11 8 0 9 -40
+5 -174 -19 -176 -19 -208 -2 -38 19 -56 49 -46 78 3 11 32 67 64 125 32 57 68
+131 80 164 13 33 25 57 29 54 3 -4 11 -41 17 -83 16 -110 47 -183 103 -244 48
+-52 131 -109 131 -89 0 5 -4 13 -10 16 -27 17 -5 22 36 8 64 -22 64 -11 1 25
+-138 78 -229 274 -230 497 -2 153 40 283 117 372 44 50 126 93 179 93 49 0 40
+16 -14 25 -89 15 -197 -50 -258 -157 l-28 -49 -7 62 c-6 62 -56 188 -82 210
+-9 8 -9 -1 2 -37 22 -73 34 -233 23 -316 -20 -163 -80 -276 -244 -463 -183
+-208 -212 -271 -234 -505 -8 -82 -12 -97 -34 -116 -14 -12 -42 -25 -62 -28
+-53 -10 -69 9 -69 79 0 49 -2 53 -12 33 -7 -13 -16 -45 -19 -71 -7 -47 -8 -48
+-38 -45 -44 4 -63 44 -48 101 5 23 8 43 6 46 -7 7 -45 -82 -45 -107 0 -17 -5
+-22 -17 -20 -14 3 -18 14 -17 51 0 54 22 90 77 126 21 14 42 39 51 61 18 45
+37 183 35 255 -1 33 -3 40 -6 20 -17 -121 -71 -301 -73 -240 0 11 9 43 19 70
+23 60 29 108 41 330 11 194 31 288 85 397 l37 73 -30 -28 c-37 -35 -87 -133
+-106 -207 -12 -47 -15 -51 -20 -30 -4 14 -15 59 -26 100 l-19 75 4 -145 c2
+-80 7 -162 11 -184 l7 -38 -25 23 c-83 79 -198 179 -198 172 0 -14 50 -85 89
+-127 35 -38 34 -37 -39 15 -208 147 -365 376 -395 574 -6 38 -5 37 32 -29 43
+-80 171 -220 242 -265 26 -17 51 -31 56 -31 4 0 -22 31 -59 68 -94 96 -142
+163 -192 267 -88 181 -107 361 -54 515 30 85 43 100 94 100 45 0 45 0 98 -95
+39 -70 35 -44 -6 38 -28 55 -31 67 -18 67 10 0 24 -6 32 -13 25 -20 85 -99
+110 -144 13 -24 25 -41 27 -39 7 6 -36 86 -74 140 -36 51 -34 74 6 61 29 -9
+114 -116 153 -192 18 -34 34 -60 36 -58 7 7 -67 142 -107 195 -26 35 -37 58
+-31 64 25 25 170 -141 215 -249 14 -33 23 -46 20 -30 -13 60 -70 158 -133 226
+-54 58 -60 69 -42 69 35 0 200 58 256 91 28 16 69 49 90 73 22 24 43 45 48 45
+5 1 33 -18 63 -41z m-762 -108 c9 -14 -86 -40 -150 -40 -65 0 -115 24 -115 55
+0 12 6 12 35 -1 19 -7 51 -14 71 -14 36 0 94 26 94 43 0 9 55 -28 65 -43z
+m-16 -1063 c43 -71 55 -105 90 -242 l40 -160 -68 71 c-76 79 -134 174 -162
+266 -19 60 -25 175 -12 238 l6 33 28 -62 c15 -34 50 -99 78 -144z m2100 47
+c47 -59 52 -227 11 -336 -12 -32 -25 -60 -30 -63 -5 -3 -17 14 -28 37 -26 60
+-46 75 -83 61 -36 -14 -36 -15 -9 119 22 105 38 148 73 186 26 29 41 28 66 -4z
+m-1887 -345 c74 -88 108 -148 139 -243 l26 -80 17 77 c17 77 23 86 43 66 7 -7
+5 -28 -8 -70 -29 -92 -35 -183 -15 -213 16 -25 15 -27 -18 -71 -19 -24 -37
+-54 -41 -65 -6 -18 -15 -20 -76 -20 -72 0 -75 2 -59 44 14 37 -1 32 -29 -10
+-23 -34 -26 -35 -80 -32 -53 3 -56 4 -59 31 -2 16 5 46 16 68 11 23 15 38 8
+36 -22 -7 -56 -70 -56 -103 0 -29 -3 -34 -25 -34 -56 0 -53 79 5 135 25 24 37
+28 97 29 l68 1 20 40 c16 32 20 60 20 140 0 86 -5 118 -38 227 -20 70 -37 131
+-37 135 0 9 12 -3 82 -88z m1778 -47 c0 -39 -7 -58 -35 -97 -19 -27 -33 -51
+-31 -53 6 -5 75 26 107 48 l29 21 -35 -77 c-71 -155 -159 -237 -185 -170 -11
+31 13 153 46 226 27 61 85 150 97 150 4 0 7 -22 7 -48z"/>
+<path d="M1916 3536 c-67 -29 -117 -66 -155 -116 -23 -31 -20 -30 25 12 83 76
+145 102 236 103 86 0 90 14 7 21 -43 4 -67 -1 -113 -20z"/>
+<path d="M1924 3325 c-10 -8 -14 -14 -9 -14 6 0 19 6 29 14 11 8 15 15 10 15
+-6 0 -19 -7 -30 -15z"/>
+<path d="M1791 3285 c-41 -47 -61 -120 -68 -243 l-6 -104 -54 -40 c-80 -61
+-58 -56 38 8 136 92 176 107 306 114 91 5 117 9 131 24 16 18 16 18 -3 8 -11
+-5 -66 -12 -123 -16 -57 -4 -130 -15 -163 -25 -32 -11 -59 -15 -59 -9 0 5 -5
+52 -11 103 -12 103 -4 151 34 193 11 12 18 22 15 22 -3 0 -20 -16 -37 -35z"/>
+<path d="M2138 3304 c-16 -16 -41 -18 -166 -11 -39 2 -70 2 -68 -1 3 -2 -6
+-16 -20 -30 -35 -38 -54 -84 -65 -155 -5 -34 -12 -70 -15 -80 -5 -17 -4 -17
+33 -2 21 9 69 20 106 25 97 12 137 57 137 153 0 20 5 27 19 27 10 0 29 9 42
+21 l24 20 -25 -7 -25 -6 24 26 c26 28 25 46 -1 20z m-134 -57 c11 -8 17 -23
+14 -38 -2 -20 -8 -23 -33 -20 -16 1 -38 7 -47 12 -12 6 -25 6 -39 -1 -19 -11
+-20 -10 -10 9 25 46 80 64 115 38z"/>
+<path d="M2088 3163 c-3 -41 -10 -69 -23 -83 -10 -11 -13 -20 -7 -20 29 0 59
+102 43 145 -6 14 -10 1 -13 -42z"/>
+<path d="M1715 2800 c-87 -23 -52 -26 42 -4 44 10 93 14 138 11 41 -3 60 -1
+45 3 -44 14 -153 9 -225 -10z"/>
+<path d="M1660 2763 c0 -24 32 -33 126 -37 90 -4 144 -16 228 -51 13 -6 17 -5
+12 3 -17 28 -122 55 -231 59 -85 4 -113 9 -122 21 -7 9 -13 11 -13 5z"/>
+<path d="M1625 2640 c-3 -5 -2 -10 4 -10 5 0 13 5 16 10 3 6 2 10 -4 10 -5 0
+-13 -4 -16 -10z"/>
+<path d="M1585 2620 c-3 -5 -1 -10 4 -10 6 0 11 5 11 10 0 6 -2 10 -4 10 -3 0
+-8 -4 -11 -10z"/>
+<path d="M1605 2590 c-8 -13 9 -20 24 -11 10 6 9 10 -3 14 -8 3 -18 2 -21 -3z"/>
+<path d="M2515 2510 c10 -11 20 -20 23 -20 3 0 -3 9 -13 20 -10 11 -20 20 -23
+20 -3 0 3 -9 13 -20z"/>
+<path d="M2623 2377 c81 -113 135 -253 137 -362 l1 -30 11 25 c5 14 8 55 5 91
+-5 82 -52 175 -138 278 -33 39 -62 71 -64 71 -2 0 19 -33 48 -73z"/>
+<path d="M1390 3585 c13 -14 26 -25 28 -25 3 0 -5 11 -18 25 -13 14 -26 25
+-28 25 -3 0 5 -11 18 -25z"/>
+<path d="M938 2803 c6 -2 18 -2 25 0 6 3 1 5 -13 5 -14 0 -19 -2 -12 -5z"/>
+</g>
+</svg>

package/dist/cjs/config.d.ts

@@ -0,0 +1,5 @@
+import { Channel, ConfirmChannel, ChannelModel } from "amqplib";
+export declare const rabbitMQUrl: string;
+export declare function getRabbitMQConnection(): Promise<ChannelModel>;
+export declare function getRabbitMQChannel(): Promise<Channel>;
+export declare function getRabbitMQConfirmChannel(): Promise<ConfirmChannel>;

package/dist/cjs/config.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rabbitMQUrl = void 0;
+exports.getRabbitMQConnection = getRabbitMQConnection;
+exports.getRabbitMQChannel = getRabbitMQChannel;
+exports.getRabbitMQConfirmChannel = getRabbitMQConfirmChannel;
+const amqplib_1 = require("amqplib");
+const node_os_1 = __importDefault(require("node:os"));
+exports.rabbitMQUrl = (_a = process.env.RABBITMQ_URL) !== null && _a !== void 0 ? _a : "amqp://user:password@localhost";
+let conn = null;
+let ch = null;
+let opening = null;
+let cch = null;
+let cOpening = null;
+function attachConnHandlers(c) {
+    c.on("blocked", (reason) => console.warn("[amqp] connection blocked:", reason));
+    c.on("unblocked", () => console.log("[amqp] connection unblocked"));
+    c.on("close", () => {
+        console.error("[amqp] connection closed");
+        conn = null;
+        ch = null;
+        opening = null;
+        cch = null;
+        cOpening = null;
+    });
+    c.on("error", (err) => {
+        console.error("[amqp] connection error:", err);
+        // 'close' will clear caches
+    });
+}
+function attachChannelHandlers(channel, kind) {
+    channel.on("close", () => {
+        console.error(`[amqp] ${kind === "confirm" ? "confirm channel" : "channel"} closed`);
+        if (kind === "ch") {
+            ch = null;
+            opening = null;
+        }
+        else {
+            cch = null;
+            cOpening = null;
+        }
+    });
+    channel.on("error", (err) => {
+        console.error(`[amqp] ${kind === "confirm" ? "confirm channel" : "channel"} error:`, err);
+    });
+}
+async function getConn() {
+    if (conn)
+        return conn;
+    const c = await (0, amqplib_1.connect)(exports.rabbitMQUrl, {
+        clientProperties: {
+            connection_name: process.env.AMQP_CONN_NAME ||
+                `app:${process.title || "node"}@${node_os_1.default.hostname()}#${process.pid}`,
+        },
+    });
+    attachConnHandlers(c);
+    conn = c;
+    return c;
+}
+/** Always return a live channel */
+async function openChannelFresh() {
+    if (ch)
+        return ch;
+    if (opening)
+        return opening;
+    opening = (async () => {
+        try {
+            const c = await getConn();
+            const channel = await c.createChannel();
+            attachChannelHandlers(channel, "ch");
+            ch = channel;
+            return channel;
+        }
+        catch (err) {
+            opening = null;
+            ch = null;
+            conn = null;
+            throw err;
+        }
+    })();
+    return opening;
+}
+async function openConfirmChannelFresh() {
+    if (cch)
+        return cch;
+    if (cOpening)
+        return cOpening;
+    cOpening = (async () => {
+        try {
+            const c = await getConn();
+            const channel = await c.createConfirmChannel();
+            attachChannelHandlers(channel, "confirm");
+            cch = channel;
+            return channel;
+        }
+        catch (err) {
+            cOpening = null;
+            cch = null;
+            conn = null;
+            throw err;
+        }
+    })();
+    return cOpening;
+}
+async function getRabbitMQConnection() {
+    if (conn)
+        return conn;
+    await openChannelFresh();
+    return conn;
+}
+async function getRabbitMQChannel() {
+    return openChannelFresh();
+}
+async function getRabbitMQConfirmChannel() {
+    return openConfirmChannelFresh();
+}

package/dist/cjs/eventFactories.d.ts

@@ -0,0 +1,31 @@
+/** Optional metadata carried alongside the event payload. */
+export interface EventMeta {
+    corrId?: string;
+    causationId?: string;
+    /** Optional application headers. */
+    headers?: Record<string, string>;
+    expectsReply?: boolean;
+    timeoutMs?: number;
+}
+export interface EventEnvelope<T = unknown> {
+    id: string;
+    name: string;
+    v: string;
+    time: number;
+    data: T;
+    meta?: EventMeta;
+}
+export type EnvelopeFactory<T> = (data: T, meta?: EventMeta) => EventEnvelope<T>;
+export declare function expectReply(meta?: EventMeta, timeoutMs?: number): EventMeta;
+export declare function event(name: string, v?: string): {
+    of: <T = unknown>() => EnvelopeFactory<T>;
+};
+export declare function eventWithReply(name: string, v?: string): {
+    of: <T = unknown, R = unknown>() => EnvelopeFactory<T>;
+};
+/**
+ * Augment an events map so calling a factory publishes via broker.produce().
+ */
+export declare function augmentEvents<T extends object>(events: Record<string, (...args: any[]) => EventEnvelope>, broker: {
+    produce: (...evts: EventEnvelope[]) => Promise<unknown>;
+}): T & Record<string, (...args: any[]) => Promise<unknown>>;

package/dist/cjs/eventFactories.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectReply = expectReply;
+exports.event = event;
+exports.eventWithReply = eventWithReply;
+exports.augmentEvents = augmentEvents;
+const crypto_1 = require("crypto");
+function expectReply(meta, timeoutMs) {
+    return { ...(meta !== null && meta !== void 0 ? meta : {}), expectsReply: true, ...(timeoutMs != null ? { timeoutMs } : {}) };
+}
+function randomId() {
+    var _a;
+    try {
+        return (_a = crypto_1.randomUUID === null || crypto_1.randomUUID === void 0 ? void 0 : (0, crypto_1.randomUUID)()) !== null && _a !== void 0 ? _a : `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+    }
+    catch {
+        return `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+    }
+}
+function event(name, v = "1.0.0") {
+    return {
+        of: () => (data, meta) => ({
+            id: randomId(),
+            name,
+            v,
+            time: Date.now(),
+            data,
+            meta,
+        }),
+    };
+}
+function eventWithReply(name, v = "1.0.0") {
+    return {
+        of: () => (data, meta) => ({
+            id: randomId(),
+            name,
+            v,
+            time: Date.now(),
+            data,
+            meta: { expectsReply: false, ...(meta !== null && meta !== void 0 ? meta : {}) },
+        }),
+    };
+}
+/**
+ * Augment an events map so calling a factory publishes via broker.produce().
+ */
+function augmentEvents(events, broker) {
+    const augmented = { ...events, ...broker };
+    for (const key of Object.keys(events)) {
+        const factory = events[key];
+        augmented[key] = async (...args) => broker.produce(factory(...args));
+    }
+    return augmented;
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./rabbitmqBroker";
+export * from "./eventFactories";
+export * from "./pluginManager";
+export * from "./utils/dedupe";

package/dist/cjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./rabbitmqBroker"), exports);
+__exportStar(require("./eventFactories"), exports);
+__exportStar(require("./pluginManager"), exports);
+__exportStar(require("./utils/dedupe"), exports);

package/dist/cjs/pluginManager.d.ts

@@ -0,0 +1,13 @@
+import { EventEnvelope } from "./eventFactories";
+export interface Plugin {
+    beforeProduce?(event: EventEnvelope): Promise<void>;
+    afterProduce?(event: EventEnvelope, result: unknown): Promise<void>;
+    beforeProcess?(id: string | number, event: EventEnvelope): Promise<void>;
+    afterProcess?(id: string | number, event: EventEnvelope, result: unknown): Promise<void>;
+}
+export declare class PluginManager {
+    private plugins;
+    register(plugin: Plugin): void;
+    executeHook<K extends keyof Plugin>(hookName: K, ...args: Parameters<NonNullable<Plugin[K]>>): Promise<void>;
+}
+export declare const pluginManager: PluginManager;

package/dist/cjs/pluginManager.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginManager = exports.PluginManager = void 0;
+class PluginManager {
+    constructor() {
+        this.plugins = [];
+    }
+    register(plugin) {
+        this.plugins.push(plugin);
+    }
+    async executeHook(hookName, ...args) {
+        for (const plugin of this.plugins) {
+            const fn = plugin[hookName];
+            if (typeof fn === "function") {
+                try {
+                    await fn
+                        .call(plugin, ...args);
+                }
+                catch (err) {
+                    console.error(`Error executing hook ${String(hookName)}:`, err);
+                }
+            }
+        }
+    }
+}
+exports.PluginManager = PluginManager;
+exports.pluginManager = new PluginManager();