vintasend 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vintasend",
-  "version": "0.1.0",
+  "version": "0.1.1",
 	"scripts": {
 		"lint": "biome check .",
 		"format": "biome format .",

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/Dockerfile.notifications-worker

@@ -9,20 +9,6 @@ COPY package*.json ./
 # Install dependencies
 RUN npm install
 
-RUN mkdir -p src/vintasend-ts/services
-RUN mkdir -p src/vintasend-ts/types
-RUN mkdir -p src/vintasend-nodemailer
-RUN mkdir -p src/vintasend-prisma
-RUN mkdir -p src/vintasend-pug
-RUN mkdir -p src/vintasend-winston
-
-COPY ../../services ./src/vintasend-ts/services
-COPY ../../types ./src/vintasend-ts/types
-COPY ../../implementations/vintasend-nodemailer ./src/vintasend-nodemailer
-COPY ../../implementations/vintasend-prisma ./src/vintasend-prisma
-COPY ../../implementations/vintasend-pug ./src/vintasend-pug
-COPY ../../implementations/vintasend-winston ./src/vintasend-winston
-
 # Copy the rest of the application code
 COPY . .
 

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/package-lock.json

@@ -29,6 +29,11 @@
         "react-hook-form": "^7.54.2",
         "tailwind-merge": "^3.0.1",
         "tailwindcss-animate": "^1.0.7",
+        "vintasend": "^0.1.0",
+        "vintasend-nodemailer": "^0.1.0",
+        "vintasend-prisma": "^0.1.0",
+        "vintasend-pug": "^0.1.0",
+        "vintasend-winston": "^0.1.0",
         "zod": "^3.24.1"
       },
       "devDependencies": {
@@ -101,6 +106,24 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@colors/colors": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.6.0.tgz",
+      "integrity": "sha512-Ir+AOibqzrIsL6ajt3Rz3LskB7OiMVHqltZmspbW/TJuTVuyOMirVqAkjfY6JISiLHgyNqicAC8AyHHGzNd/dA==",
+      "engines": {
+        "node": ">=0.1.90"
+      }
+    },
+    "node_modules/@dabh/diagnostics": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@dabh/diagnostics/-/diagnostics-2.0.3.tgz",
+      "integrity": "sha512-hrlQOIi7hAfzsMqlGSFyVucrx38O+j6wiGOf//H2ecvIEqYN4ADBSS2iLMh5UFyDunCNniUIPk/q3riFv45xRA==",
+      "dependencies": {
+        "colorspace": "1.1.x",
+        "enabled": "2.0.x",
+        "kuler": "^2.0.0"
+      }
+    },
     "node_modules/@emnapi/runtime": {
       "version": "1.3.1",
       "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.3.1.tgz",
@@ -1423,14 +1446,12 @@
     "node_modules/@prisma/debug": {
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-6.3.1.tgz",
-      "integrity": "sha512-RrEBkd+HLZx+ydfmYT0jUj7wjLiS95wfTOSQ+8FQbvb6vHh5AeKfEPt/XUQ5+Buljj8hltEfOslEW57/wQIVeA==",
-      "devOptional": true
+      "integrity": "sha512-RrEBkd+HLZx+ydfmYT0jUj7wjLiS95wfTOSQ+8FQbvb6vHh5AeKfEPt/XUQ5+Buljj8hltEfOslEW57/wQIVeA=="
     },
     "node_modules/@prisma/engines": {
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/@prisma/engines/-/engines-6.3.1.tgz",
       "integrity": "sha512-sXdqEVLyGAJ5/iUoG/Ea5AdHMN71m6PzMBWRQnLmhhOejzqAaEr8rUd623ql6OJpED4s/U4vIn4dg1qkF7vGag==",
-      "devOptional": true,
       "hasInstallScript": true,
       "dependencies": {
         "@prisma/debug": "6.3.1",
@@ -1442,14 +1463,12 @@
     "node_modules/@prisma/engines-version": {
       "version": "6.3.0-17.acc0b9dd43eb689cbd20c9470515d719db10d0b0",
       "resolved": "https://registry.npmjs.org/@prisma/engines-version/-/engines-version-6.3.0-17.acc0b9dd43eb689cbd20c9470515d719db10d0b0.tgz",
-      "integrity": "sha512-R/ZcMuaWZT2UBmgX3Ko6PAV3f8//ZzsjRIG1eKqp3f2rqEqVtCv+mtzuH2rBPUC9ujJ5kCb9wwpxeyCkLcHVyA==",
-      "devOptional": true
+      "integrity": "sha512-R/ZcMuaWZT2UBmgX3Ko6PAV3f8//ZzsjRIG1eKqp3f2rqEqVtCv+mtzuH2rBPUC9ujJ5kCb9wwpxeyCkLcHVyA=="
     },
     "node_modules/@prisma/fetch-engine": {
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/@prisma/fetch-engine/-/fetch-engine-6.3.1.tgz",
       "integrity": "sha512-HOf/0umOgt+/S2xtZze+FHKoxpVg4YpVxROr6g2YG09VsI3Ipyb+rGvD6QGbCqkq5NTWAAZoOGNL+oy7t+IhaQ==",
-      "devOptional": true,
       "dependencies": {
         "@prisma/debug": "6.3.1",
         "@prisma/engines-version": "6.3.0-17.acc0b9dd43eb689cbd20c9470515d719db10d0b0",
@@ -1460,7 +1479,6 @@
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-6.3.1.tgz",
       "integrity": "sha512-AYLq6Hk9xG73JdLWJ3Ip9Wg/vlP7xPvftGBalsPzKDOHr/ImhwJ09eS8xC2vNT12DlzGxhfk8BkL0ve2OriNhQ==",
-      "devOptional": true,
       "dependencies": {
         "@prisma/debug": "6.3.1"
       }
@@ -3334,6 +3352,11 @@
         "@types/react": "^19.0.0"
       }
     },
+    "node_modules/@types/triple-beam": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/@types/triple-beam/-/triple-beam-1.3.5.tgz",
+      "integrity": "sha512-6WaYesThRMCl19iryMYP7/x2OVgCtbIVflDGFpWnb9irXI3UjYE4AzmYuiUKY1AJstGijoY+MgUszMgRxIYTYw=="
+    },
     "node_modules/@typescript-eslint/eslint-plugin": {
       "version": "8.23.0",
       "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.23.0.tgz",
@@ -4027,6 +4050,11 @@
       "integrity": "sha512-OH/2E5Fg20h2aPrbe+QL8JZQFko0YZaF+j4mnQ7BGhfavO7OpSLa8a0y9sBwomHdSbkhTS8TQNayBfnW5DwbvQ==",
       "dev": true
     },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA=="
+    },
     "node_modules/async-function": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
@@ -4457,12 +4485,42 @@
       "version": "1.9.1",
       "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",
       "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",
-      "optional": true,
       "dependencies": {
         "color-name": "^1.0.0",
         "simple-swizzle": "^0.2.2"
       }
     },
+    "node_modules/colorspace": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/colorspace/-/colorspace-1.1.4.tgz",
+      "integrity": "sha512-BgvKJiuVu1igBUF2kEjRCZXol6wiiGbY5ipL/oVPwm0BL9sIpMIzM8IK7vwuxIIzOXMV3Ey5w+vxhm0rR/TN8w==",
+      "dependencies": {
+        "color": "^3.1.3",
+        "text-hex": "1.0.x"
+      }
+    },
+    "node_modules/colorspace/node_modules/color": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/color/-/color-3.2.1.tgz",
+      "integrity": "sha512-aBl7dZI9ENN6fUGC7mWpMTPNHmWUSNan9tuWN6ahh5ZLNk9baLJOnSMlrQkHcrfFgz2/RigjUVAjdx36VcemKA==",
+      "dependencies": {
+        "color-convert": "^1.9.3",
+        "color-string": "^1.6.0"
+      }
+    },
+    "node_modules/colorspace/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/colorspace/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw=="
+    },
     "node_modules/commander": {
       "version": "4.1.1",
       "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
@@ -4707,6 +4765,11 @@
       "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
       "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg=="
     },
+    "node_modules/enabled": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/enabled/-/enabled-2.0.0.tgz",
+      "integrity": "sha512-AKrN98kuwOzMIdAizXGI86UFBoo26CL21UM763y1h/GMSJ4/OHU9k2YlsmBpyScFo/wbLzWQJBMCW4+IO3/+OQ=="
+    },
     "node_modules/enhanced-resolve": {
       "version": "5.18.1",
       "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.1.tgz",
@@ -5456,6 +5519,11 @@
         "reusify": "^1.0.4"
       }
     },
+    "node_modules/fecha": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/fecha/-/fecha-4.2.3.tgz",
+      "integrity": "sha512-OP2IUU6HeYKJi3i0z4A19kHMQoLVs4Hc+DPqqxI2h/DPZHTm/vjsfC6P0b4jCMy14XizLBqvndQ+UilD7707Jw=="
+    },
     "node_modules/file-entry-cache": {
       "version": "8.0.0",
       "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
@@ -5514,6 +5582,11 @@
       "integrity": "sha512-AiwGJM8YcNOaobumgtng+6NHuOqC3A7MixFeDafM3X9cIUM+xUXoS5Vfgf+OihAYe20fxqNM9yPBXJzRtZ/4eA==",
       "dev": true
     },
+    "node_modules/fn.name": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/fn.name/-/fn.name-1.1.0.tgz",
+      "integrity": "sha512-GRnmB5gPyJpAhTQdSZTSp9uaPSvl09KoYcMQtsB9rQoOmzs9dH6ffeccH+Z+cv6P68Hu5bC6JjRh4Ah/mHSNRw=="
+    },
     "node_modules/for-each": {
       "version": "0.3.4",
       "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.4.tgz",
@@ -5930,6 +6003,11 @@
         "node": ">=0.8.19"
       }
     },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
+    },
     "node_modules/internal-slot": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz",
@@ -5964,8 +6042,7 @@
     "node_modules/is-arrayish": {
       "version": "0.3.2",
       "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",
-      "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==",
-      "optional": true
+      "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ=="
     },
     "node_modules/is-async-function": {
       "version": "2.1.1",
@@ -6261,6 +6338,17 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-string": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",
@@ -6559,6 +6647,11 @@
         "json-buffer": "3.0.1"
       }
     },
+    "node_modules/kuler": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/kuler/-/kuler-2.0.0.tgz",
+      "integrity": "sha512-Xq9nH7KlWZmXAtodXDDRE7vs6DU1gTU8zYDHDiWLSip45Egwq3plLHzPn27NgvzL2r1LMPC1vdqh98sQxtqj4A=="
+    },
     "node_modules/language-subtag-registry": {
       "version": "0.3.23",
       "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz",
@@ -6675,6 +6768,22 @@
       "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz",
       "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg=="
     },
+    "node_modules/logform": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/logform/-/logform-2.7.0.tgz",
+      "integrity": "sha512-TFYA4jnP7PVbmlBIfhlSe+WKxs9dklXMTEGcBCIvLhE/Tn3H6Gk1norupVW7m5Cnd4bLcr08AytbyV/xj7f/kQ==",
+      "dependencies": {
+        "@colors/colors": "1.6.0",
+        "@types/triple-beam": "^1.3.2",
+        "fecha": "^4.2.0",
+        "ms": "^2.1.1",
+        "safe-stable-stringify": "^2.3.1",
+        "triple-beam": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 12.0.0"
+      }
+    },
     "node_modules/long": {
       "version": "5.2.4",
       "resolved": "https://registry.npmjs.org/long/-/long-5.2.4.tgz",
@@ -7069,6 +7178,14 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/one-time": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/one-time/-/one-time-1.0.0.tgz",
+      "integrity": "sha512-5DXOiRKwuSEcQ/l0kGCF6Q3jcADFv5tSmRaJck/OqkVFcOzutB134KRSfF0xDrL39MNnqxbHBbUUcjZIhTgb2g==",
+      "dependencies": {
+        "fn.name": "1.x.x"
+      }
+    },
     "node_modules/optionator": {
       "version": "0.9.4",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -7396,7 +7513,6 @@
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/prisma/-/prisma-6.3.1.tgz",
       "integrity": "sha512-JKCZWvBC3enxk51tY4TWzS4b5iRt4sSU1uHn2I183giZTvonXaQonzVtjLzpOHE7qu9MxY510kAtFGJwryKe3Q==",
-      "devOptional": true,
       "hasInstallScript": true,
       "dependencies": {
         "@prisma/engines": "6.3.1"
@@ -7804,6 +7920,19 @@
         "pify": "^2.3.0"
       }
     },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/readdirp": {
       "version": "3.6.0",
       "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
@@ -8020,6 +8149,14 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/safe-stable-stringify": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",
+      "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -8257,7 +8394,6 @@
       "version": "0.2.2",
       "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",
       "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",
-      "optional": true,
       "dependencies": {
         "is-arrayish": "^0.3.1"
       }
@@ -8320,6 +8456,14 @@
       "integrity": "sha512-LjdcbuBeLcdETCrPn9i8AYAZ1eCtu4ECAWtP7UleOiZ9LzVxRzzUZEoZ8zB24nhkQnDWyET0I+3sWokSDS3E7g==",
       "dev": true
     },
+    "node_modules/stack-trace": {
+      "version": "0.0.10",
+      "resolved": "https://registry.npmjs.org/stack-trace/-/stack-trace-0.0.10.tgz",
+      "integrity": "sha512-KGzahc7puUKkzyMt+IqAep+TVNbKP+k2Lmwhub39m1AsTSkaDutx56aDCo+HLDzf/D26BIHTJWNiTG1KAJiQCg==",
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/streamsearch": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz",
@@ -8328,6 +8472,14 @@
         "node": ">=10.0.0"
       }
     },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
     "node_modules/string-width": {
       "version": "5.1.2",
       "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
@@ -8813,6 +8965,11 @@
       "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
       "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ=="
     },
+    "node_modules/text-hex": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/text-hex/-/text-hex-1.0.0.tgz",
+      "integrity": "sha512-uuVGNWzgJ4yhRaNSiubPY7OjISw4sw4E5Uv0wbjp+OzcbmVU/rsT8ujgcXJhn9ypzsgr5vlzpPqP+MBBKcGvbg=="
+    },
     "node_modules/thenify": {
       "version": "3.3.1",
       "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
@@ -8874,6 +9031,14 @@
         "tslib": "2"
       }
     },
+    "node_modules/triple-beam": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/triple-beam/-/triple-beam-1.4.1.tgz",
+      "integrity": "sha512-aZbgViZrg1QNcG+LULa7nhZpJTZSLm/mXnHXnbAbjmN5aSa0y7V+wvv6+4WaBtpISJzThKy+PIPxc1Nq1EJ9mg==",
+      "engines": {
+        "node": ">= 14.0.0"
+      }
+    },
     "node_modules/ts-api-utils": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.0.1.tgz",
@@ -9152,6 +9317,49 @@
         "uuid": "dist/bin/uuid"
       }
     },
+    "node_modules/vintasend": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vintasend/-/vintasend-0.1.0.tgz",
+      "integrity": "sha512-36Mkkf6yv/Y5zpuBc0TCIitOuUjsbQzVPqu56bbv3KLmoeT59UDE7OWTJkzrlRdA5iYwTB/sUk7VsYDzLF2wuQ=="
+    },
+    "node_modules/vintasend-nodemailer": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vintasend-nodemailer/-/vintasend-nodemailer-0.1.0.tgz",
+      "integrity": "sha512-VNKJTDnLzGDZncgy4t/3iHUZ1cwQ+7Db4BNMwn7Gd1zsiL03l9iyB4zzeiu1MdLiSEiMtDrpmPaFx9ZkfPWGww==",
+      "dependencies": {
+        "nodemailer": "^6.10.0",
+        "vintasend": "^0.1.0"
+      }
+    },
+    "node_modules/vintasend-prisma": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vintasend-prisma/-/vintasend-prisma-0.1.0.tgz",
+      "integrity": "sha512-eHakQHyUeHe95NucnX/ZovfWZcHil/1zswf0pg8wnc8dytOk8s3sR2kqP9MrQk6SbYRxe06tf1uZrHm0SxzaaA==",
+      "dependencies": {
+        "@prisma/client": "^6.3.1",
+        "prisma": "^6.3.1",
+        "vintasend": "^0.1.0"
+      }
+    },
+    "node_modules/vintasend-pug": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vintasend-pug/-/vintasend-pug-0.1.0.tgz",
+      "integrity": "sha512-SNgUUHJK/3ejydcgkF0AGwVINIrgt3NkPPO21P6RkBIRcF5PCJ6KrINJtr0kYhTHDLpRaZk2Ma2NPh9kNLUUgA==",
+      "dependencies": {
+        "pug": "^3.0.3",
+        "vintasend": "^0.1.0"
+      }
+    },
+    "node_modules/vintasend-winston": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vintasend-winston/-/vintasend-winston-0.1.0.tgz",
+      "integrity": "sha512-pbirMH+n1uH3Aa7N32AC7kAjvb8u2A59gT8lSLvjA2qRa1cATBFci+FawsB5Jyxfhxm0iAPtbPsLrLBANAyeaw==",
+      "dependencies": {
+        "jsonwebtoken": "^9.0.2",
+        "vintasend": "^0.1.0",
+        "winston": "^3.17.0"
+      }
+    },
     "node_modules/void-elements": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/void-elements/-/void-elements-3.1.0.tgz",
@@ -9343,6 +9551,40 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/winston": {
+      "version": "3.17.0",
+      "resolved": "https://registry.npmjs.org/winston/-/winston-3.17.0.tgz",
+      "integrity": "sha512-DLiFIXYC5fMPxaRg832S6F5mJYvePtmO5G9v9IgUFPhXm9/GkXarH/TUrBAVzhTCzAj9anE/+GjrgXp/54nOgw==",
+      "dependencies": {
+        "@colors/colors": "^1.6.0",
+        "@dabh/diagnostics": "^2.0.2",
+        "async": "^3.2.3",
+        "is-stream": "^2.0.0",
+        "logform": "^2.7.0",
+        "one-time": "^1.0.0",
+        "readable-stream": "^3.4.0",
+        "safe-stable-stringify": "^2.3.1",
+        "stack-trace": "0.0.x",
+        "triple-beam": "^1.3.0",
+        "winston-transport": "^4.9.0"
+      },
+      "engines": {
+        "node": ">= 12.0.0"
+      }
+    },
+    "node_modules/winston-transport": {
+      "version": "4.9.0",
+      "resolved": "https://registry.npmjs.org/winston-transport/-/winston-transport-4.9.0.tgz",
+      "integrity": "sha512-8drMJ4rkgaPo1Me4zD/3WLfI/zPdA9o2IipKODunnGDcuqbHwjsbB79ylv04LCGGzU0xQ6vTznOMpQGaLhhm6A==",
+      "dependencies": {
+        "logform": "^2.7.0",
+        "readable-stream": "^3.6.2",
+        "triple-beam": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 12.0.0"
+      }
+    },
     "node_modules/with": {
       "version": "7.0.2",
       "resolved": "https://registry.npmjs.org/with/-/with-7.0.2.tgz",

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/package.json

@@ -34,6 +34,11 @@
     "react-hook-form": "^7.54.2",
     "tailwind-merge": "^3.0.1",
     "tailwindcss-animate": "^1.0.7",
+    "vintasend": "^0.1.0",
+    "vintasend-nodemailer": "^0.1.0",
+    "vintasend-prisma": "^0.1.0",
+    "vintasend-pug": "^0.1.0",
+    "vintasend-winston": "^0.1.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/src/app/api/auth/forgot-password/forgot-password-notification-context.ts

@@ -1,21 +1,21 @@
-import { PrismaClient } from '@prisma/client';
-import type { ContextGenerator } from 'vintasend/services/notification-context-registry';
-
-export class ForgotPasswordContextGenerator implements ContextGenerator {
-  async generate(params: { token: string }): Promise<{ firstName: string | null }> {
-    const prisma = new PrismaClient();
-
-    const token = await prisma.token.findUnique({
-      where: { token: params.token },
-      select: { user: true },
-    });
-
-    if (!token || !token.user) {
-      throw new Error('Token not found');
-    }
-
-    return {
-      firstName: token.user.firstName,
-    };
-  }
-}
+import { PrismaClient } from '@prisma/client';
+import type { ContextGenerator } from 'vintasend/src/services/notification-context-registry';
+
+export class ForgotPasswordContextGenerator implements ContextGenerator {
+  async generate(params: { token: string }): Promise<{ firstName: string | null }> {
+    const prisma = new PrismaClient();
+
+    const token = await prisma.token.findUnique({
+      where: { token: params.token },
+      select: { user: true },
+    });
+
+    if (!token || !token.user) {
+      throw new Error('Token not found');
+    }
+
+    return {
+      firstName: token.user.firstName,
+    };
+  }
+}

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/src/lib/services/notifications.ts

@@ -1,6 +1,6 @@
 import { PrismaClient } from '@prisma/client';
-import { NotificationService } from 'vintasend/services/notification-service';
-import { NotificationContextRegistry } from 'vintasend/services/notification-context-registry';
+import { NotificationService } from 'vintasend/src/services/notification-service';
+import { NotificationContextRegistry } from 'vintasend/src/services/notification-context-registry';
 import { PrismaNotificationBackend } from 'vintasend-prisma/prisma-notification-backend';
 import { PugEmailTemplateRenderer } from 'vintasend-pug/pug-email-template-renderer';
 import { NodemailerNotificationAdapter } from 'vintasend-nodemailer/nodemailer-notification-adapter';
@@ -21,7 +21,7 @@ export function getNotificationService() {
     number,
     number
   >(prisma);
-  return new NotificationService<ContextMap>(
+  return new NotificationService<ContextMap, number, number>(
     [new NodemailerNotificationAdapter<
       PugEmailTemplateRenderer<ContextMap>,
       PrismaNotificationBackend<

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/src/lib/services/temporal-queue-service.ts

@@ -1,8 +1,8 @@
 import type { Client } from '@temporalio/client';
 import { sendNotificationWorkflow } from "@/workers/notifications/workflows";
-import type { BaseNotificationQueueService } from "vintasend/services/notification-queue-service/base-notification-queue-service";
+import type { BaseNotificationQueueService } from "vintasend/src/services/notification-queue-service/base-notification-queue-service";
 
-export class TemporalQueueService<NotificationIdType> implements BaseNotificationQueueService {
+export class TemporalQueueService<NotificationIdType> implements BaseNotificationQueueService<NotificationIdType> {
   constructor(private client: Client, private taskQueue: string, ) {}
 
   async enqueueNotification(notificationId: NotificationIdType): Promise<void> {

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/src/workers/notifications/activities.ts

@@ -1,19 +1,20 @@
-import type { Notification } from 'vintasend/types/notification'
+import type { Notification } from 'vintasend/src/types/notification'
 
 import { type ContextMap, getNotificationService } from '@/lib/services/notifications';
 
+type NotificationIdType = Parameters<ReturnType<typeof getNotificationService>['getNotification']>[0];
 
-export async function sendNotification<NotificationIdType> (notificationId: NotificationIdType): Promise<void> {
-  const notificationServices = getNotificationService();
+export async function sendNotification(notificationId: NotificationIdType): Promise<void> {
+  const notificationService = getNotificationService();
 
   if (!notificationId) {
     throw new Error("Notification ID is required");
   }
 
-  await notificationServices.delayedSend(notificationId);
+  await notificationService.delayedSend(notificationId);
 };
 
-export const getAllPendingNotifications = async (): Promise<Notification<ContextMap>["id"][]> => {
+export const getAllPendingNotifications = async (): Promise<NotificationIdType[]> => {
   const notificationServices = getNotificationService();
   const pendingNotifications = await notificationServices.getPendingNotifications();
   return pendingNotifications.map((notification) => notification.id);

package/src/examples/nextjs-prisma-nodemailer-pug-temporal/src/workers/notifications/workflows.ts

@@ -1,13 +1,16 @@
 import { proxyActivities } from '@temporalio/workflow';
 import type { EmailActivities } from './activities';
+import type { getNotificationService } from '@/lib/services/notifications';
 
 // Configure activities with a timeout (adjust as needed)
 const { sendNotification, getAllPendingNotifications } = proxyActivities<EmailActivities>({
   startToCloseTimeout: '1 minute',
 });
 
-export async function sendNotificationWorkflow<NotificationIdType>(notificationId: NotificationIdType): Promise<void> {
-  await sendNotification<NotificationIdType>(notificationId);
+type NotificationIdType = Parameters<ReturnType<typeof getNotificationService>['getNotification']>[0];
+
+export async function sendNotificationWorkflow(notificationId: NotificationIdType): Promise<void> {
+  await sendNotification(notificationId);
 }
 
 export async function sendAllPendingNotificationsWorkflow(): Promise<void> {

package/src/implementations/vintasend-nodemailer/nodemailer-notification-adapter.ts

@@ -1,18 +1,29 @@
 import nodemailer from 'nodemailer';
 
-import type { BaseNotificationAdapter } from 'vintasend/services/notification-adapters/base-notification-adapter';
-import type { BaseEmailTemplateRenderer } from 'vintasend/services/notification-template-renderers/base-email-template-renderer';
-import type { BaseNotificationBackend } from 'vintasend/services/notification-backends/base-notification-backend';
-import type { Notification } from 'vintasend/types/notification';
-import type { JsonObject } from 'vintasend/types/json-values';
-import type { NotificationType } from 'vintasend/types/notification-type';
-import type { ContextGenerator } from 'vintasend/services/notification-context-registry';
+import type { BaseNotificationAdapter } from 'vintasend/src/services/notification-adapters/base-notification-adapter';
+import type { BaseEmailTemplateRenderer } from 'vintasend/src/services/notification-template-renderers/base-email-template-renderer';
+import type { BaseNotificationBackend } from 'vintasend/src/services/notification-backends/base-notification-backend';
+import type { Notification } from 'vintasend/src/types/notification';
+import type { JsonObject } from 'vintasend/src/types/json-values';
+import type { NotificationType } from 'vintasend/src/types/notification-type';
+import type { ContextGenerator } from 'vintasend/src/services/notification-context-registry';
+import type { Identifier } from 'vintasend/src/types/identifier';
 
 export class NodemailerNotificationAdapter<
   TemplateRenderer extends BaseEmailTemplateRenderer<AvailableContexts>,
   Backend extends BaseNotificationBackend<AvailableContexts>,
-  AvailableContexts extends Record<string, ContextGenerator>
-> implements BaseNotificationAdapter<TemplateRenderer, Backend, AvailableContexts> {
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+> implements
+    BaseNotificationAdapter<
+      TemplateRenderer,
+      Backend,
+      AvailableContexts,
+      NotificationIdType,
+      UserIdType
+    >
+{
   private transporter: nodemailer.Transporter;
   public readonly notificationType: NotificationType = 'EMAIL';
   public readonly key = 'nodemailer';
@@ -21,19 +32,22 @@ export class NodemailerNotificationAdapter<
     public templateRenderer: TemplateRenderer,
     public backend: Backend,
     public readonly enqueueNotifications: boolean,
-    transportOptions: nodemailer.SendMailOptions
+    transportOptions: nodemailer.SendMailOptions,
   ) {
     this.transporter = nodemailer.createTransport(transportOptions);
   }
 
-  async send(notification: Notification<AvailableContexts>, context: JsonObject): Promise<void> {
+  async send(
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
+    context: JsonObject,
+  ): Promise<void> {
     const template = await this.templateRenderer.render(notification, context);
 
     if (!notification.id) {
       throw new Error('Notification ID is required');
     }
 
-    const userEmail = await this.backend.getUserEmailFromNotification(notification.id)
+    const userEmail = await this.backend.getUserEmailFromNotification(notification.id);
 
     if (!userEmail) {
       throw new Error('User email not found');

package/src/implementations/vintasend-nodemailer/package.json

@@ -9,7 +9,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "nodemailer": "^6.10.0"
+    "nodemailer": "^6.10.0",
+    "vintasend": "^0.1.0"
   },
   "devDependencies": {
     "@types/nodemailer": "^6.4.17"

package/src/implementations/vintasend-prisma/package.json

@@ -11,6 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "@prisma/client": "^6.3.1",
-    "prisma": "^6.3.1"
+    "prisma": "^6.3.1",
+    "vintasend": "^0.1.0"
   }
 }

package/src/implementations/vintasend-prisma/prisma-notification-backend.ts

@@ -1,9 +1,10 @@
-import type { BaseNotificationBackend } from 'vintasend/services/notification-backends/base-notification-backend';
-import type { ContextGenerator } from 'vintasend/services/notification-context-registry';
-import type { InputJsonValue, JsonValue } from 'vintasend/types/json-values';
-import type { Notification, NotificationInput } from 'vintasend/types/notification';
-import type { NotificationStatus } from 'vintasend/types/notification-status';
-import type { NotificationType } from 'vintasend/types/notification-type';
+import type { BaseNotificationBackend } from 'vintasend/src/services/notification-backends/base-notification-backend';
+import type { ContextGenerator } from 'vintasend/src/services/notification-context-registry';
+import type { InputJsonValue, JsonValue } from 'vintasend/src/types/json-values';
+import type { Notification, NotificationInput } from 'vintasend/src/types/notification';
+import type { NotificationStatus } from 'vintasend/src/types/notification-status';
+import type { NotificationType } from 'vintasend/src/types/notification-type';
+import type { Identifier } from 'vintasend/src/types/identifier';
 
 export const NotificationStatusEnum = {
   PENDING_SEND: 'PENDING_SEND',
@@ -145,8 +146,8 @@ function convertJsonValueToRecord(jsonValue: JsonValue): Record<string, string |
 export class PrismaNotificationBackend<
   Client extends NotificationPrismaClientInterface<NotificationIdType, UserIdType>,
   AvailableContexts extends Record<string, ContextGenerator>,
-  NotificationIdType extends string | number,
-  UserIdType extends string | number,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
 > implements BaseNotificationBackend<AvailableContexts>
 {
   constructor(private prismaClient: Client) {}

package/src/implementations/vintasend-pug/package.json

@@ -9,7 +9,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "pug": "^3.0.3"
+    "pug": "^3.0.3",
+    "vintasend": "^0.1.0"
   },
   "devDependencies": {
     "@types/pug": "^2.0.10"

package/src/implementations/vintasend-pug/pug-email-template-renderer.ts

@@ -1,20 +1,24 @@
-import type { ContextGenerator } from 'vintasend/services/notification-context-registry';
+import type { ContextGenerator } from 'vintasend/src/services/notification-context-registry';
 import type {
   BaseEmailTemplateRenderer,
   EmailTemplate,
-} from 'vintasend/services/notification-template-renderers/base-email-template-renderer';
-import type { JsonObject } from 'vintasend/types/json-values';
-import type { Notification } from 'vintasend/types/notification';
+} from 'vintasend/src/services/notification-template-renderers/base-email-template-renderer';
+import type { JsonObject } from 'vintasend/src/types/json-values';
+import type { Notification } from 'vintasend/src/types/notification';
+import type { Identifier } from 'vintasend/src/types/identifier';
 
 import pug from 'pug';
 
-export class PugEmailTemplateRenderer<AvailableContexts extends Record<string, ContextGenerator>>
-  implements BaseEmailTemplateRenderer<AvailableContexts>
+export class PugEmailTemplateRenderer<
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+> implements BaseEmailTemplateRenderer<AvailableContexts, NotificationIdType, UserIdType>
 {
   constructor(private options: pug.Options = {}) {}
 
   render(
-    notification: Notification<AvailableContexts>,
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
     context: JsonObject,
   ): Promise<EmailTemplate> {
     const bodyTemplate = pug.compileFile(notification.bodyTemplate, this.options);

package/src/implementations/vintasend-winston/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "vintasend-winton",
+  "name": "vintasend-winston",
   "version": "0.1.0",
   "description": "",
   "main": "index.js",
@@ -10,6 +10,7 @@
   "license": "ISC",
   "dependencies": {
     "jsonwebtoken": "^9.0.2",
+    "vintasend": "^0.1.0",
     "winston": "^3.17.0"
   }
 }

package/src/implementations/vintasend-winston/winston-logger.ts

@@ -1,4 +1,4 @@
-import type { BaseLogger } from 'vintasend/services/loggers/base-logger';
+import type { BaseLogger } from 'vintasend/src/services/loggers/base-logger';
 
 import * as winston from 'winston';
 

package/src/services/notification-adapters/base-notification-adapter.ts

@@ -4,11 +4,14 @@ import type { BaseNotificationBackend } from '../notification-backends/base-noti
 import type { BaseNotificationTemplateRenderer } from '../notification-template-renderers/base-notification-template-renderer';
 import type { ContextGenerator } from '../notification-context-registry';
 import type { JsonValue } from '../../types/json-values';
+import type { Identifier } from '../../types/identifier';
 
 export interface BaseNotificationAdapter<
   TemplateRenderer extends BaseNotificationTemplateRenderer<AvailableContexts>,
   Backend extends BaseNotificationBackend<AvailableContexts>,
-  AvailableContexts extends Record<string, ContextGenerator>
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
 > {
   notificationType: NotificationType;
   key: string;
@@ -16,5 +19,8 @@ export interface BaseNotificationAdapter<
   backend: Backend;
   enqueueNotifications: boolean;
 
-  send(notification: Notification<AvailableContexts>, context: JsonValue): Promise<void>;
+  send(
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
+    context: JsonValue,
+  ): Promise<void>;
 }

package/src/services/notification-backends/base-notification-backend.ts

@@ -3,38 +3,42 @@ import type { Identifier } from '../../types/identifier';
 import type { Notification } from '../../types/notification';
 import type { ContextGenerator } from '../notification-context-registry';
 
-export interface BaseNotificationBackend<AvailableContexts extends Record<string, ContextGenerator>> {
-  getAllPendingNotifications(): Promise<Notification<AvailableContexts>[]>;
-  getPendingNotifications(): Promise<Notification<AvailableContexts>[]>;
-  getAllFutureNotifications(): Promise<Notification<AvailableContexts>[]>;
-  getFutureNotifications(): Promise<Notification<AvailableContexts>[]>;
+export interface BaseNotificationBackend<
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+> {
+  getAllPendingNotifications(): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
+  getPendingNotifications(): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
+  getAllFutureNotifications(): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
+  getFutureNotifications(): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
   getAllFutureNotificationsFromUser(
     userId: Identifier,
-  ): Promise<Notification<AvailableContexts>[]>;
-  getFutureNotificationsFromUser(userId: Identifier): Promise<Notification<AvailableContexts>[]>;
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
+  getFutureNotificationsFromUser(userId: Identifier): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
   persistNotification(
-    notification: Omit<Notification<AvailableContexts>, 'id'>,
-  ): Promise<Notification<AvailableContexts>>;
+    notification: Omit<Notification<AvailableContexts, NotificationIdType, UserIdType>, 'id'>,
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>>;
   persistNotificationUpdate(
     notificationId: Identifier,
-    notification: Partial<Omit<Notification<AvailableContexts>, 'id'>>,
-  ): Promise<Notification<AvailableContexts>>;
-  markPendingAsSent(notificationId: Identifier): Promise<Notification<AvailableContexts>>;
-  markPendingAsFailed(notificationId: Identifier): Promise<Notification<AvailableContexts>>;
-  markSentAsRead(notificationId: Identifier): Promise<Notification<AvailableContexts>>;
+    notification: Partial<Omit<Notification<AvailableContexts, NotificationIdType, UserIdType>, 'id'>>,
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>>;
+  markPendingAsSent(notificationId: Identifier): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>>;
+  markPendingAsFailed(notificationId: Identifier): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>>;
+  markSentAsRead(notificationId: Identifier): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>>;
   cancelNotification(notificationId: Identifier): Promise<void>;
   getNotification(
     notificationId: Identifier,
     forUpdate: boolean,
-  ): Promise<Notification<AvailableContexts> | null>;
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType> | null>;
   filterAllInAppUnreadNotifications(
     userId: Identifier,
-  ): Promise<Notification<AvailableContexts>[]>;
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
   filterInAppUnreadNotifications(
     userId: Identifier,
     page: number,
     pageSize: number,
-  ): Promise<Notification<AvailableContexts>[]>;
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>[]>;
   getUserEmailFromNotification(notificationId: Identifier): Promise<string | undefined>;
   storeContextUsed(
     notificationId: Identifier,

package/src/services/notification-queue-service/base-notification-queue-service.ts

@@ -1,5 +1,5 @@
-import type { Identifier } from "../../types/identifier";
+import type { Identifier } from '../../types/identifier';
 
-export interface BaseNotificationQueueService {
-  enqueueNotification(notificationId: Identifier): Promise<void>;
+export interface BaseNotificationQueueService<NotificationIdType extends Identifier = Identifier> {
+  enqueueNotification(notificationId: NotificationIdType): Promise<void>;
 }

package/src/services/notification-service.ts

@@ -9,25 +9,33 @@ import {
   type ContextGenerator,
   NotificationContextRegistry,
 } from './notification-context-registry';
-import type { JsonObject, JsonValue } from '../types/json-values';
+import type { JsonObject } from '../types/json-values';
 
-export class NotificationService<AvailableContexts extends Record<string, ContextGenerator>> {
+export class NotificationService<
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+> {
   constructor(
     private adapters: BaseNotificationAdapter<
-      BaseNotificationTemplateRenderer<AvailableContexts>,
-      BaseNotificationBackend<AvailableContexts>,
-      AvailableContexts
+      BaseNotificationTemplateRenderer<AvailableContexts, NotificationIdType, UserIdType>,
+      BaseNotificationBackend<AvailableContexts, NotificationIdType, UserIdType>,
+      AvailableContexts,
+      NotificationIdType,
+      UserIdType
     >[],
     private backend: BaseNotificationBackend<AvailableContexts>,
     private logger: BaseLogger,
-    private queueService?: BaseNotificationQueueService,
+    private queueService?: BaseNotificationQueueService<NotificationIdType>,
   ) {}
 
-  registerQueueService(queueService: BaseNotificationQueueService): void {
+  registerQueueService(queueService: BaseNotificationQueueService<NotificationIdType>): void {
     this.queueService = queueService;
   }
 
-  async send(notification: Notification<AvailableContexts>): Promise<void> {
+  async send(
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
+  ): Promise<void> {
     const adaptersOfType = this.adapters.filter(
       (adapter) => adapter.notificationType === notification.notificationType,
     );
@@ -85,9 +93,9 @@ export class NotificationService<AvailableContexts extends Record<string, Contex
   }
 
   async createNotification(
-    notification: Omit<Notification<AvailableContexts>, 'id'>,
-  ): Promise<Notification<AvailableContexts>> {
-    const createdNotification = await this.backend.persistNotification(notification);
+    notification: Omit<Notification<AvailableContexts, NotificationIdType, UserIdType>, 'id'>,
+  ): Promise<Notification<AvailableContexts, NotificationIdType, UserIdType>> {
+    const createdNotification = await this.backend.persistNotification(notification) as Notification<AvailableContexts, NotificationIdType, UserIdType>;
 
     if (notification.sendAfter && notification.sendAfter > new Date()) {
       this.send(createdNotification);
@@ -98,28 +106,26 @@ export class NotificationService<AvailableContexts extends Record<string, Contex
 
   async updateNotification(
     notificationId: Identifier,
-    notification: Partial<Omit<Notification<AvailableContexts>, 'id'>>,
-  ): Promise<Notification<AvailableContexts>> {
+    notification: Partial<
+      Omit<Notification<AvailableContexts, NotificationIdType, UserIdType>, 'id'>
+    >,
+  ) {
     return this.backend.persistNotificationUpdate(notificationId, notification);
   }
 
-  async getAllFutureNotifications(): Promise<Notification<AvailableContexts>[]> {
+  async getAllFutureNotifications() {
     return this.backend.getAllFutureNotifications();
   }
 
-  async getAllFutureNotificationsFromUser(
-    userId: Identifier,
-  ): Promise<Notification<AvailableContexts>[]> {
+  async getAllFutureNotificationsFromUser(userId: NotificationIdType) {
     return this.backend.getAllFutureNotificationsFromUser(userId);
   }
 
-  async getFutureNotificationsFromUser(
-    userId: Identifier,
-  ): Promise<Notification<AvailableContexts>[]> {
+  async getFutureNotificationsFromUser(userId: NotificationIdType) {
     return this.backend.getFutureNotificationsFromUser(userId);
   }
 
-  async getFutureNotifications(): Promise<Notification<AvailableContexts>[]> {
+  async getFutureNotifications() {
     return this.backend.getFutureNotifications();
   }
 
@@ -132,33 +138,34 @@ export class NotificationService<AvailableContexts extends Record<string, Contex
 
   async sendPendingNotifications(): Promise<void> {
     const pendingNotifications = await this.backend.getAllPendingNotifications();
-    await Promise.all(pendingNotifications.map((notification) => this.send(notification)));
+    await Promise.all(
+      pendingNotifications.map((notification) =>
+        this.send(notification as Notification<AvailableContexts, NotificationIdType, UserIdType>),
+      ),
+    );
   }
 
-  async getPendingNotifications(): Promise<Notification<AvailableContexts>[]> {
+  async getPendingNotifications() {
     return this.backend.getPendingNotifications();
   }
 
-  async getNotification(
-    notificationId: Identifier,
-    forUpdate: boolean,
-  ): Promise<Notification<AvailableContexts> | null> {
+  async getNotification(notificationId: NotificationIdType, forUpdate: boolean) {
     return this.backend.getNotification(notificationId, forUpdate);
   }
 
-  async markRead(notificationId: Identifier): Promise<Notification<AvailableContexts>> {
+  async markRead(notificationId: NotificationIdType) {
     return this.backend.markSentAsRead(notificationId);
   }
 
-  async getInAppUnread(userId: Identifier): Promise<Notification<AvailableContexts>[]> {
+  async getInAppUnread(userId: NotificationIdType) {
     return this.backend.filterAllInAppUnreadNotifications(userId);
   }
 
-  async cancelNotification(notificationId: Identifier): Promise<void> {
+  async cancelNotification(notificationId: NotificationIdType): Promise<void> {
     return this.backend.cancelNotification(notificationId);
   }
 
-  async delayedSend(notificationId: Identifier): Promise<void> {
+  async delayedSend(notificationId: NotificationIdType): Promise<void> {
     const notification = await this.getNotification(notificationId, false);
 
     if (!notification) {
@@ -189,7 +196,7 @@ export class NotificationService<AvailableContexts extends Record<string, Contex
 
     for (const adapter of enqueueNotificationsAdapters) {
       try {
-        await adapter.send(notification, context);
+        await adapter.send(notification as Notification<AvailableContexts, NotificationIdType, UserIdType>, context);
       } catch (sendError) {
         this.logger.error(
           `Error sending notification ${notification.id} with adapter ${adapter.constructor.name}: ${sendError}`,

package/src/services/notification-template-renderers/base-email-template-renderer.ts

@@ -3,6 +3,7 @@ import type { Notification } from '../../types/notification';
 import type { Buffer } from 'node:buffer';
 import type { ContextGenerator } from '../notification-context-registry';
 import type { JsonObject } from '../../types/json-values';
+import type { Identifier } from '../../types/identifier';
 
 export type Attachment = File | Buffer | string;
 
@@ -11,10 +12,18 @@ export type EmailTemplate = {
   body: string;
 };
 
-export interface BaseEmailTemplateRenderer<AvailableContexts extends Record<string, ContextGenerator>>
-  extends BaseNotificationTemplateRenderer<AvailableContexts, EmailTemplate> {
+export interface BaseEmailTemplateRenderer<
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+> extends BaseNotificationTemplateRenderer<
+    AvailableContexts,
+    NotificationIdType,
+    UserIdType,
+    EmailTemplate
+  > {
   render(
-    notification: Notification<AvailableContexts>,
-    context: JsonObject
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
+    context: JsonObject,
   ): Promise<EmailTemplate>;
 }

package/src/services/notification-template-renderers/base-notification-template-renderer.ts

@@ -1,7 +1,16 @@
+import type { Identifier } from '../../types/identifier';
 import type { JsonObject } from '../../types/json-values';
 import type { Notification } from '../../types/notification';
 import type { ContextGenerator } from '../notification-context-registry';
 
-export interface BaseNotificationTemplateRenderer<AvailableContexts extends Record<string, ContextGenerator>, T = unknown> {
-  render(notification: Notification<AvailableContexts>, context: JsonObject): Promise<T>;
+export interface BaseNotificationTemplateRenderer<
+  AvailableContexts extends Record<string, ContextGenerator>,
+  NotificationIdType extends Identifier = Identifier,
+  UserIdType extends Identifier = Identifier,
+  T = unknown,
+> {
+  render(
+    notification: Notification<AvailableContexts, NotificationIdType, UserIdType>,
+    context: JsonObject,
+  ): Promise<T>;
 }