ts-packages 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (752) hide show
  1. package/biome.json +53 -0
  2. package/organize-imports.sh +87 -0
  3. package/package.json +25 -8
  4. package/packages/cache/README.md +695 -0
  5. package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.d.ts +71 -0
  6. package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.js +379 -0
  7. package/packages/cache/dist/cjs/adapters/memcache/index.d.ts +1 -0
  8. package/packages/cache/dist/cjs/adapters/memcache/index.js +5 -0
  9. package/packages/cache/dist/cjs/adapters/memory/MemoryCache.d.ts +63 -0
  10. package/packages/cache/dist/cjs/adapters/memory/MemoryCache.js +277 -0
  11. package/packages/cache/dist/cjs/adapters/memory/index.d.ts +1 -0
  12. package/packages/cache/dist/cjs/adapters/memory/index.js +5 -0
  13. package/packages/cache/dist/cjs/adapters/redis/RedisCache.d.ts +67 -0
  14. package/packages/cache/dist/cjs/adapters/redis/RedisCache.js +325 -0
  15. package/packages/cache/dist/cjs/adapters/redis/index.d.ts +1 -0
  16. package/packages/cache/dist/cjs/adapters/redis/index.js +5 -0
  17. package/packages/cache/dist/cjs/core/BaseCache.d.ts +78 -0
  18. package/packages/cache/dist/cjs/core/BaseCache.js +138 -0
  19. package/packages/cache/dist/cjs/core/factory.d.ts +16 -0
  20. package/packages/cache/dist/cjs/core/factory.js +60 -0
  21. package/packages/cache/dist/cjs/core/interfaces/ICache.d.ts +58 -0
  22. package/packages/cache/dist/cjs/core/interfaces/ICache.js +2 -0
  23. package/packages/cache/dist/cjs/core/interfaces/ISession.d.ts +30 -0
  24. package/packages/cache/dist/cjs/core/interfaces/ISession.js +2 -0
  25. package/packages/cache/dist/cjs/core/interfaces/index.d.ts +2 -0
  26. package/packages/cache/dist/cjs/core/interfaces/index.js +2 -0
  27. package/packages/cache/dist/cjs/errors/CacheError.d.ts +9 -0
  28. package/packages/cache/dist/cjs/errors/CacheError.js +17 -0
  29. package/packages/cache/dist/cjs/errors/index.d.ts +1 -0
  30. package/packages/cache/dist/cjs/errors/index.js +5 -0
  31. package/packages/cache/dist/cjs/index.d.ts +10 -0
  32. package/packages/cache/dist/cjs/index.js +27 -0
  33. package/packages/cache/dist/cjs/middleware/express/cacheMiddleware.d.ts +22 -0
  34. package/packages/cache/dist/cjs/middleware/express/cacheMiddleware.js +116 -0
  35. package/packages/cache/dist/cjs/middleware/express/index.d.ts +1 -0
  36. package/packages/cache/dist/cjs/middleware/express/index.js +7 -0
  37. package/packages/cache/dist/cjs/session/SessionStore.d.ts +57 -0
  38. package/packages/cache/dist/cjs/session/SessionStore.js +161 -0
  39. package/packages/cache/dist/cjs/session/index.d.ts +2 -0
  40. package/packages/cache/dist/cjs/session/index.js +5 -0
  41. package/packages/cache/dist/cjs/types.d.ts +102 -0
  42. package/packages/cache/dist/cjs/types.js +2 -0
  43. package/packages/cache/dist/esm/adapters/memcache/MemcacheCache.d.ts +71 -0
  44. package/packages/cache/dist/esm/adapters/memcache/MemcacheCache.js +372 -0
  45. package/packages/cache/dist/esm/adapters/memcache/index.d.ts +1 -0
  46. package/packages/cache/dist/esm/adapters/memcache/index.js +1 -0
  47. package/packages/cache/dist/esm/adapters/memory/MemoryCache.d.ts +63 -0
  48. package/packages/cache/dist/esm/adapters/memory/MemoryCache.js +273 -0
  49. package/packages/cache/dist/esm/adapters/memory/index.d.ts +1 -0
  50. package/packages/cache/dist/esm/adapters/memory/index.js +1 -0
  51. package/packages/cache/dist/esm/adapters/redis/RedisCache.d.ts +67 -0
  52. package/packages/cache/dist/esm/adapters/redis/RedisCache.js +321 -0
  53. package/packages/cache/dist/esm/adapters/redis/index.d.ts +1 -0
  54. package/packages/cache/dist/esm/adapters/redis/index.js +1 -0
  55. package/packages/cache/dist/esm/core/BaseCache.d.ts +78 -0
  56. package/packages/cache/dist/esm/core/BaseCache.js +134 -0
  57. package/packages/cache/dist/esm/core/factory.d.ts +16 -0
  58. package/packages/cache/dist/esm/core/factory.js +56 -0
  59. package/packages/cache/dist/esm/core/interfaces/ICache.d.ts +58 -0
  60. package/packages/cache/dist/esm/core/interfaces/ICache.js +1 -0
  61. package/packages/cache/dist/esm/core/interfaces/ISession.d.ts +30 -0
  62. package/packages/cache/dist/esm/core/interfaces/ISession.js +1 -0
  63. package/packages/cache/dist/esm/core/interfaces/index.d.ts +2 -0
  64. package/packages/cache/dist/esm/core/interfaces/index.js +1 -0
  65. package/packages/cache/dist/esm/errors/CacheError.d.ts +9 -0
  66. package/packages/cache/dist/esm/errors/CacheError.js +13 -0
  67. package/packages/cache/dist/esm/errors/index.d.ts +1 -0
  68. package/packages/cache/dist/esm/errors/index.js +1 -0
  69. package/packages/cache/dist/esm/index.d.ts +10 -0
  70. package/packages/cache/dist/esm/index.js +14 -0
  71. package/packages/cache/dist/esm/middleware/express/cacheMiddleware.d.ts +22 -0
  72. package/packages/cache/dist/esm/middleware/express/cacheMiddleware.js +111 -0
  73. package/packages/cache/dist/esm/middleware/express/index.d.ts +1 -0
  74. package/packages/cache/dist/esm/middleware/express/index.js +1 -0
  75. package/packages/cache/dist/esm/session/SessionStore.d.ts +57 -0
  76. package/packages/cache/dist/esm/session/SessionStore.js +157 -0
  77. package/packages/cache/dist/esm/session/index.d.ts +2 -0
  78. package/packages/cache/dist/esm/session/index.js +1 -0
  79. package/packages/cache/dist/esm/types.d.ts +102 -0
  80. package/packages/cache/dist/esm/types.js +1 -0
  81. package/packages/cache/dist/types/adapters/memcache/MemcacheCache.d.ts +71 -0
  82. package/packages/cache/dist/types/adapters/memcache/index.d.ts +1 -0
  83. package/packages/cache/dist/types/adapters/memory/MemoryCache.d.ts +63 -0
  84. package/packages/cache/dist/types/adapters/memory/index.d.ts +1 -0
  85. package/packages/cache/dist/types/adapters/redis/RedisCache.d.ts +67 -0
  86. package/packages/cache/dist/types/adapters/redis/index.d.ts +1 -0
  87. package/packages/cache/dist/types/core/BaseCache.d.ts +78 -0
  88. package/packages/cache/dist/types/core/factory.d.ts +16 -0
  89. package/packages/cache/dist/types/core/interfaces/ICache.d.ts +58 -0
  90. package/packages/cache/dist/types/core/interfaces/ISession.d.ts +30 -0
  91. package/packages/cache/dist/types/core/interfaces/index.d.ts +2 -0
  92. package/packages/cache/dist/types/errors/CacheError.d.ts +9 -0
  93. package/packages/cache/dist/types/errors/index.d.ts +1 -0
  94. package/packages/cache/dist/types/index.d.ts +10 -0
  95. package/packages/cache/dist/types/middleware/express/cacheMiddleware.d.ts +22 -0
  96. package/packages/cache/dist/types/middleware/express/index.d.ts +1 -0
  97. package/packages/cache/dist/types/session/SessionStore.d.ts +57 -0
  98. package/packages/cache/dist/types/session/index.d.ts +2 -0
  99. package/packages/cache/dist/types/types.d.ts +102 -0
  100. package/packages/cache/node_modules/.bin/rimraf +21 -0
  101. package/packages/cache/node_modules/.bin/tsc +21 -0
  102. package/packages/cache/node_modules/.bin/tsserver +21 -0
  103. package/packages/cache/package.json +50 -0
  104. package/packages/cache/src/adapters/memcache/MemcacheCache.ts +452 -0
  105. package/packages/cache/src/adapters/memcache/index.ts +1 -0
  106. package/packages/cache/src/adapters/memory/MemoryCache.ts +355 -0
  107. package/packages/cache/src/adapters/memory/index.ts +1 -0
  108. package/packages/cache/src/adapters/redis/RedisCache.ts +406 -0
  109. package/packages/cache/src/adapters/redis/index.ts +1 -0
  110. package/packages/cache/src/core/BaseCache.ts +177 -0
  111. package/packages/cache/src/core/factory.ts +92 -0
  112. package/packages/cache/src/core/interfaces/ICache.ts +71 -0
  113. package/packages/cache/src/core/interfaces/ISession.ts +36 -0
  114. package/packages/cache/src/core/interfaces/index.ts +2 -0
  115. package/packages/cache/src/errors/CacheError.ts +22 -0
  116. package/packages/cache/src/errors/index.ts +1 -0
  117. package/packages/cache/src/index.ts +40 -0
  118. package/packages/cache/src/middleware/express/cacheMiddleware.ts +145 -0
  119. package/packages/cache/src/middleware/express/index.ts +5 -0
  120. package/packages/cache/src/session/SessionStore.ts +236 -0
  121. package/packages/cache/src/session/index.ts +2 -0
  122. package/packages/cache/src/types.ts +111 -0
  123. package/packages/cache/tsconfig.base.json +17 -0
  124. package/packages/cache/tsconfig.cjs.json +10 -0
  125. package/packages/cache/tsconfig.esm.json +10 -0
  126. package/packages/errors-utils/README.md +200 -0
  127. package/packages/errors-utils/dist/cjs/constants/errorCodes.d.ts +32 -0
  128. package/packages/errors-utils/dist/cjs/constants/errorCodes.js +34 -0
  129. package/packages/errors-utils/dist/cjs/constants/errorMessages.d.ts +2 -0
  130. package/packages/errors-utils/dist/cjs/constants/errorMessages.js +34 -0
  131. package/packages/errors-utils/dist/cjs/constants/index.d.ts +2 -0
  132. package/packages/errors-utils/dist/cjs/constants/index.js +18 -0
  133. package/packages/errors-utils/dist/cjs/error/AppError.d.ts +15 -0
  134. package/packages/errors-utils/dist/cjs/error/AppError.js +26 -0
  135. package/packages/errors-utils/dist/cjs/error/BadRequestError.d.ts +4 -0
  136. package/packages/errors-utils/dist/cjs/error/BadRequestError.js +12 -0
  137. package/packages/errors-utils/dist/cjs/error/ConflictError.d.ts +4 -0
  138. package/packages/errors-utils/dist/cjs/error/ConflictError.js +12 -0
  139. package/packages/errors-utils/dist/cjs/error/CryptoIntegrityError.d.ts +4 -0
  140. package/packages/errors-utils/dist/cjs/error/CryptoIntegrityError.js +11 -0
  141. package/packages/errors-utils/dist/cjs/error/ForbiddenError.d.ts +4 -0
  142. package/packages/errors-utils/dist/cjs/error/ForbiddenError.js +12 -0
  143. package/packages/errors-utils/dist/cjs/error/HTTPError.d.ts +6 -0
  144. package/packages/errors-utils/dist/cjs/error/HTTPError.js +11 -0
  145. package/packages/errors-utils/dist/cjs/error/InternalServerError.d.ts +5 -0
  146. package/packages/errors-utils/dist/cjs/error/InternalServerError.js +12 -0
  147. package/packages/errors-utils/dist/cjs/error/NotFoundError.d.ts +4 -0
  148. package/packages/errors-utils/dist/cjs/error/NotFoundError.js +12 -0
  149. package/packages/errors-utils/dist/cjs/error/RateLimitError.d.ts +4 -0
  150. package/packages/errors-utils/dist/cjs/error/RateLimitError.js +11 -0
  151. package/packages/errors-utils/dist/cjs/error/TokenExpiredError.d.ts +4 -0
  152. package/packages/errors-utils/dist/cjs/error/TokenExpiredError.js +12 -0
  153. package/packages/errors-utils/dist/cjs/error/TokenMalformedError.d.ts +4 -0
  154. package/packages/errors-utils/dist/cjs/error/TokenMalformedError.js +12 -0
  155. package/packages/errors-utils/dist/cjs/error/TooManyRequestsError.d.ts +5 -0
  156. package/packages/errors-utils/dist/cjs/error/TooManyRequestsError.js +12 -0
  157. package/packages/errors-utils/dist/cjs/error/UnauthorizedError.d.ts +5 -0
  158. package/packages/errors-utils/dist/cjs/error/UnauthorizedError.js +12 -0
  159. package/packages/errors-utils/dist/cjs/error/ValidationError.d.ts +4 -0
  160. package/packages/errors-utils/dist/cjs/error/ValidationError.js +12 -0
  161. package/packages/errors-utils/dist/cjs/index.d.ts +10 -0
  162. package/packages/errors-utils/dist/cjs/index.js +26 -0
  163. package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.d.ts +2 -0
  164. package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.js +39 -0
  165. package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.d.ts +2 -0
  166. package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.js +19 -0
  167. package/packages/errors-utils/dist/cjs/middleware/express/index.d.ts +2 -0
  168. package/packages/errors-utils/dist/cjs/middleware/express/index.js +18 -0
  169. package/packages/errors-utils/dist/cjs/utils/mapAppErrorToResponder.d.ts +3 -0
  170. package/packages/errors-utils/dist/cjs/utils/mapAppErrorToResponder.js +27 -0
  171. package/packages/errors-utils/dist/esm/constants/errorCodes.d.ts +32 -0
  172. package/packages/errors-utils/dist/esm/constants/errorCodes.js +31 -0
  173. package/packages/errors-utils/dist/esm/constants/errorMessages.d.ts +2 -0
  174. package/packages/errors-utils/dist/esm/constants/errorMessages.js +31 -0
  175. package/packages/errors-utils/dist/esm/constants/index.d.ts +2 -0
  176. package/packages/errors-utils/dist/esm/constants/index.js +2 -0
  177. package/packages/errors-utils/dist/esm/error/AppError.d.ts +15 -0
  178. package/packages/errors-utils/dist/esm/error/AppError.js +22 -0
  179. package/packages/errors-utils/dist/esm/error/BadRequestError.d.ts +4 -0
  180. package/packages/errors-utils/dist/esm/error/BadRequestError.js +8 -0
  181. package/packages/errors-utils/dist/esm/error/ConflictError.d.ts +4 -0
  182. package/packages/errors-utils/dist/esm/error/ConflictError.js +8 -0
  183. package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.d.ts +4 -0
  184. package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.js +7 -0
  185. package/packages/errors-utils/dist/esm/error/ForbiddenError.d.ts +4 -0
  186. package/packages/errors-utils/dist/esm/error/ForbiddenError.js +8 -0
  187. package/packages/errors-utils/dist/esm/error/HTTPError.d.ts +6 -0
  188. package/packages/errors-utils/dist/esm/error/HTTPError.js +7 -0
  189. package/packages/errors-utils/dist/esm/error/InternalServerError.d.ts +5 -0
  190. package/packages/errors-utils/dist/esm/error/InternalServerError.js +8 -0
  191. package/packages/errors-utils/dist/esm/error/NotFoundError.d.ts +4 -0
  192. package/packages/errors-utils/dist/esm/error/NotFoundError.js +8 -0
  193. package/packages/errors-utils/dist/esm/error/RateLimitError.d.ts +4 -0
  194. package/packages/errors-utils/dist/esm/error/RateLimitError.js +7 -0
  195. package/packages/errors-utils/dist/esm/error/TokenExpiredError.d.ts +4 -0
  196. package/packages/errors-utils/dist/esm/error/TokenExpiredError.js +8 -0
  197. package/packages/errors-utils/dist/esm/error/TokenMalformedError.d.ts +4 -0
  198. package/packages/errors-utils/dist/esm/error/TokenMalformedError.js +8 -0
  199. package/packages/errors-utils/dist/esm/error/TooManyRequestsError.d.ts +5 -0
  200. package/packages/errors-utils/dist/esm/error/TooManyRequestsError.js +8 -0
  201. package/packages/errors-utils/dist/esm/error/UnauthorizedError.d.ts +5 -0
  202. package/packages/errors-utils/dist/esm/error/UnauthorizedError.js +8 -0
  203. package/packages/errors-utils/dist/esm/error/ValidationError.d.ts +4 -0
  204. package/packages/errors-utils/dist/esm/error/ValidationError.js +8 -0
  205. package/packages/errors-utils/dist/esm/index.d.ts +10 -0
  206. package/packages/errors-utils/dist/esm/index.js +10 -0
  207. package/packages/errors-utils/dist/esm/middleware/express/errorConverter.d.ts +2 -0
  208. package/packages/errors-utils/dist/esm/middleware/express/errorConverter.js +36 -0
  209. package/packages/errors-utils/dist/esm/middleware/express/errorHandler.d.ts +2 -0
  210. package/packages/errors-utils/dist/esm/middleware/express/errorHandler.js +16 -0
  211. package/packages/errors-utils/dist/esm/middleware/express/index.d.ts +2 -0
  212. package/packages/errors-utils/dist/esm/middleware/express/index.js +2 -0
  213. package/packages/errors-utils/dist/esm/utils/mapAppErrorToResponder.d.ts +3 -0
  214. package/packages/errors-utils/dist/esm/utils/mapAppErrorToResponder.js +24 -0
  215. package/packages/errors-utils/dist/types/constants/errorCodes.d.ts +32 -0
  216. package/packages/errors-utils/dist/types/constants/errorMessages.d.ts +2 -0
  217. package/packages/errors-utils/dist/types/constants/index.d.ts +2 -0
  218. package/packages/errors-utils/dist/types/error/AppError.d.ts +15 -0
  219. package/packages/errors-utils/dist/types/error/BadRequestError.d.ts +4 -0
  220. package/packages/errors-utils/dist/types/error/ConflictError.d.ts +4 -0
  221. package/packages/errors-utils/dist/types/error/CryptoIntegrityError.d.ts +4 -0
  222. package/packages/errors-utils/dist/types/error/ForbiddenError.d.ts +4 -0
  223. package/packages/errors-utils/dist/types/error/HTTPError.d.ts +6 -0
  224. package/packages/errors-utils/dist/types/error/InternalServerError.d.ts +5 -0
  225. package/packages/errors-utils/dist/types/error/NotFoundError.d.ts +4 -0
  226. package/packages/errors-utils/dist/types/error/RateLimitError.d.ts +4 -0
  227. package/packages/errors-utils/dist/types/error/TokenExpiredError.d.ts +4 -0
  228. package/packages/errors-utils/dist/types/error/TokenMalformedError.d.ts +4 -0
  229. package/packages/errors-utils/dist/types/error/TooManyRequestsError.d.ts +5 -0
  230. package/packages/errors-utils/dist/types/error/UnauthorizedError.d.ts +5 -0
  231. package/packages/errors-utils/dist/types/error/ValidationError.d.ts +4 -0
  232. package/packages/errors-utils/dist/types/index.d.ts +10 -0
  233. package/packages/errors-utils/dist/types/middleware/express/errorConverter.d.ts +2 -0
  234. package/packages/errors-utils/dist/types/middleware/express/errorHandler.d.ts +2 -0
  235. package/packages/errors-utils/dist/types/middleware/express/index.d.ts +2 -0
  236. package/packages/errors-utils/dist/types/utils/mapAppErrorToResponder.d.ts +3 -0
  237. package/packages/errors-utils/node_modules/.bin/rimraf +21 -0
  238. package/packages/errors-utils/node_modules/.bin/tsc +21 -0
  239. package/packages/errors-utils/node_modules/.bin/tsserver +21 -0
  240. package/packages/errors-utils/package.json +42 -0
  241. package/packages/errors-utils/src/constants/errorCodes.ts +37 -0
  242. package/packages/errors-utils/src/constants/errorMessages.ts +37 -0
  243. package/packages/errors-utils/src/constants/index.ts +2 -0
  244. package/packages/errors-utils/src/error/AppError.ts +35 -0
  245. package/packages/errors-utils/src/error/BadRequestError.ts +14 -0
  246. package/packages/errors-utils/src/error/ConflictError.ts +14 -0
  247. package/packages/errors-utils/src/error/CryptoIntegrityError.ts +8 -0
  248. package/packages/errors-utils/src/error/ForbiddenError.ts +14 -0
  249. package/packages/errors-utils/src/error/HTTPError.ts +17 -0
  250. package/packages/errors-utils/src/error/InternalServerError.ts +18 -0
  251. package/packages/errors-utils/src/error/NotFoundError.ts +14 -0
  252. package/packages/errors-utils/src/error/RateLimitError.ts +8 -0
  253. package/packages/errors-utils/src/error/TokenExpiredError.ts +14 -0
  254. package/packages/errors-utils/src/error/TokenMalformedError.ts +14 -0
  255. package/packages/errors-utils/src/error/TooManyRequestsError.ts +13 -0
  256. package/packages/errors-utils/src/error/UnauthorizedError.ts +14 -0
  257. package/packages/errors-utils/src/error/ValidationError.ts +14 -0
  258. package/packages/errors-utils/src/index.ts +11 -0
  259. package/packages/errors-utils/src/middleware/express/errorConverter.ts +52 -0
  260. package/packages/errors-utils/src/middleware/express/errorHandler.ts +32 -0
  261. package/packages/errors-utils/src/middleware/express/index.ts +2 -0
  262. package/packages/errors-utils/src/utils/mapAppErrorToResponder.ts +38 -0
  263. package/packages/errors-utils/tsconfig.base.json +17 -0
  264. package/packages/errors-utils/tsconfig.cjs.json +9 -0
  265. package/packages/errors-utils/tsconfig.esm.json +9 -0
  266. package/packages/errors-utils/tsconfig.json +21 -0
  267. package/packages/js-extensions/README.md +469 -0
  268. package/packages/js-extensions/dist/cjs/array/array-extensions.d.ts +1 -0
  269. package/packages/js-extensions/dist/cjs/array/array-extensions.js +120 -0
  270. package/packages/js-extensions/dist/cjs/array/index.d.ts +1 -0
  271. package/packages/js-extensions/dist/cjs/array/index.js +5 -0
  272. package/packages/js-extensions/dist/cjs/core/index.d.ts +2 -0
  273. package/packages/js-extensions/dist/cjs/core/index.js +19 -0
  274. package/packages/js-extensions/dist/cjs/core/performance.d.ts +16 -0
  275. package/packages/js-extensions/dist/cjs/core/performance.js +76 -0
  276. package/packages/js-extensions/dist/cjs/core/validation.d.ts +4 -0
  277. package/packages/js-extensions/dist/cjs/core/validation.js +31 -0
  278. package/packages/js-extensions/dist/cjs/extensions/index.d.ts +4 -0
  279. package/packages/js-extensions/dist/cjs/extensions/index.js +21 -0
  280. package/packages/js-extensions/dist/cjs/index.d.ts +60 -0
  281. package/packages/js-extensions/dist/cjs/index.js +76 -0
  282. package/packages/js-extensions/dist/cjs/init/index.d.ts +2 -0
  283. package/packages/js-extensions/dist/cjs/init/index.js +19 -0
  284. package/packages/js-extensions/dist/cjs/init/initializer.d.ts +3 -0
  285. package/packages/js-extensions/dist/cjs/init/initializer.js +28 -0
  286. package/packages/js-extensions/dist/cjs/init/options.d.ts +3 -0
  287. package/packages/js-extensions/dist/cjs/init/options.js +23 -0
  288. package/packages/js-extensions/dist/cjs/number/index.d.ts +1 -0
  289. package/packages/js-extensions/dist/cjs/number/index.js +5 -0
  290. package/packages/js-extensions/dist/cjs/number/number-extensions.d.ts +1 -0
  291. package/packages/js-extensions/dist/cjs/number/number-extensions.js +137 -0
  292. package/packages/js-extensions/dist/cjs/object/index.d.ts +1 -0
  293. package/packages/js-extensions/dist/cjs/object/index.js +5 -0
  294. package/packages/js-extensions/dist/cjs/object/object-extensions.d.ts +1 -0
  295. package/packages/js-extensions/dist/cjs/object/object-extensions.js +147 -0
  296. package/packages/js-extensions/dist/cjs/string/index.d.ts +1 -0
  297. package/packages/js-extensions/dist/cjs/string/index.js +5 -0
  298. package/packages/js-extensions/dist/cjs/string/string-extensions.d.ts +1 -0
  299. package/packages/js-extensions/dist/cjs/string/string-extensions.js +100 -0
  300. package/packages/js-extensions/dist/cjs/types/extension-types.d.ts +9 -0
  301. package/packages/js-extensions/dist/cjs/types/extension-types.js +2 -0
  302. package/packages/js-extensions/dist/cjs/types/global-augmentations.d.ts +71 -0
  303. package/packages/js-extensions/dist/cjs/types/global-augmentations.js +2 -0
  304. package/packages/js-extensions/dist/cjs/types/index.d.ts +2 -0
  305. package/packages/js-extensions/dist/cjs/types/index.js +19 -0
  306. package/packages/js-extensions/dist/cjs/utils/config.d.ts +4 -0
  307. package/packages/js-extensions/dist/cjs/utils/config.js +25 -0
  308. package/packages/js-extensions/dist/cjs/utils/helpers.d.ts +5 -0
  309. package/packages/js-extensions/dist/cjs/utils/helpers.js +37 -0
  310. package/packages/js-extensions/dist/cjs/utils/index.d.ts +2 -0
  311. package/packages/js-extensions/dist/cjs/utils/index.js +19 -0
  312. package/packages/js-extensions/dist/esm/array/array-extensions.d.ts +1 -0
  313. package/packages/js-extensions/dist/esm/array/array-extensions.js +117 -0
  314. package/packages/js-extensions/dist/esm/array/index.d.ts +1 -0
  315. package/packages/js-extensions/dist/esm/array/index.js +1 -0
  316. package/packages/js-extensions/dist/esm/core/index.d.ts +2 -0
  317. package/packages/js-extensions/dist/esm/core/index.js +3 -0
  318. package/packages/js-extensions/dist/esm/core/performance.d.ts +16 -0
  319. package/packages/js-extensions/dist/esm/core/performance.js +69 -0
  320. package/packages/js-extensions/dist/esm/core/validation.d.ts +4 -0
  321. package/packages/js-extensions/dist/esm/core/validation.js +25 -0
  322. package/packages/js-extensions/dist/esm/extensions/index.d.ts +4 -0
  323. package/packages/js-extensions/dist/esm/extensions/index.js +5 -0
  324. package/packages/js-extensions/dist/esm/index.d.ts +60 -0
  325. package/packages/js-extensions/dist/esm/index.js +67 -0
  326. package/packages/js-extensions/dist/esm/init/index.d.ts +2 -0
  327. package/packages/js-extensions/dist/esm/init/index.js +3 -0
  328. package/packages/js-extensions/dist/esm/init/initializer.d.ts +3 -0
  329. package/packages/js-extensions/dist/esm/init/initializer.js +24 -0
  330. package/packages/js-extensions/dist/esm/init/options.d.ts +3 -0
  331. package/packages/js-extensions/dist/esm/init/options.js +19 -0
  332. package/packages/js-extensions/dist/esm/number/index.d.ts +1 -0
  333. package/packages/js-extensions/dist/esm/number/index.js +1 -0
  334. package/packages/js-extensions/dist/esm/number/number-extensions.d.ts +1 -0
  335. package/packages/js-extensions/dist/esm/number/number-extensions.js +134 -0
  336. package/packages/js-extensions/dist/esm/object/index.d.ts +1 -0
  337. package/packages/js-extensions/dist/esm/object/index.js +1 -0
  338. package/packages/js-extensions/dist/esm/object/object-extensions.d.ts +1 -0
  339. package/packages/js-extensions/dist/esm/object/object-extensions.js +144 -0
  340. package/packages/js-extensions/dist/esm/string/index.d.ts +1 -0
  341. package/packages/js-extensions/dist/esm/string/index.js +1 -0
  342. package/packages/js-extensions/dist/esm/string/string-extensions.d.ts +1 -0
  343. package/packages/js-extensions/dist/esm/string/string-extensions.js +97 -0
  344. package/packages/js-extensions/dist/esm/types/extension-types.d.ts +9 -0
  345. package/packages/js-extensions/dist/esm/types/extension-types.js +1 -0
  346. package/packages/js-extensions/dist/esm/types/global-augmentations.d.ts +71 -0
  347. package/packages/js-extensions/dist/esm/types/global-augmentations.js +1 -0
  348. package/packages/js-extensions/dist/esm/types/index.d.ts +2 -0
  349. package/packages/js-extensions/dist/esm/types/index.js +3 -0
  350. package/packages/js-extensions/dist/esm/utils/config.d.ts +4 -0
  351. package/packages/js-extensions/dist/esm/utils/config.js +20 -0
  352. package/packages/js-extensions/dist/esm/utils/helpers.d.ts +5 -0
  353. package/packages/js-extensions/dist/esm/utils/helpers.js +30 -0
  354. package/packages/js-extensions/dist/esm/utils/index.d.ts +2 -0
  355. package/packages/js-extensions/dist/esm/utils/index.js +3 -0
  356. package/packages/js-extensions/dist/types/array/array-extensions.d.ts +1 -0
  357. package/packages/js-extensions/dist/types/array/index.d.ts +1 -0
  358. package/packages/js-extensions/dist/types/core/index.d.ts +2 -0
  359. package/packages/js-extensions/dist/types/core/performance.d.ts +16 -0
  360. package/packages/js-extensions/dist/types/core/validation.d.ts +4 -0
  361. package/packages/js-extensions/dist/types/extensions/index.d.ts +4 -0
  362. package/packages/js-extensions/dist/types/index.d.ts +60 -0
  363. package/packages/js-extensions/dist/types/init/index.d.ts +2 -0
  364. package/packages/js-extensions/dist/types/init/initializer.d.ts +3 -0
  365. package/packages/js-extensions/dist/types/init/options.d.ts +3 -0
  366. package/packages/js-extensions/dist/types/number/index.d.ts +1 -0
  367. package/packages/js-extensions/dist/types/number/number-extensions.d.ts +1 -0
  368. package/packages/js-extensions/dist/types/object/index.d.ts +1 -0
  369. package/packages/js-extensions/dist/types/object/object-extensions.d.ts +1 -0
  370. package/packages/js-extensions/dist/types/string/index.d.ts +1 -0
  371. package/packages/js-extensions/dist/types/string/string-extensions.d.ts +1 -0
  372. package/packages/js-extensions/dist/types/types/extension-types.d.ts +9 -0
  373. package/packages/js-extensions/dist/types/types/global-augmentations.d.ts +71 -0
  374. package/packages/js-extensions/dist/types/types/index.d.ts +2 -0
  375. package/packages/js-extensions/dist/types/utils/config.d.ts +4 -0
  376. package/packages/js-extensions/dist/types/utils/helpers.d.ts +5 -0
  377. package/packages/js-extensions/dist/types/utils/index.d.ts +2 -0
  378. package/packages/js-extensions/node_modules/.bin/rimraf +21 -0
  379. package/packages/js-extensions/node_modules/.bin/tsc +21 -0
  380. package/packages/js-extensions/node_modules/.bin/tsserver +21 -0
  381. package/packages/js-extensions/package.json +44 -0
  382. package/packages/js-extensions/src/array/array-extensions.ts +174 -0
  383. package/packages/js-extensions/src/array/index.ts +1 -0
  384. package/packages/js-extensions/src/core/index.ts +3 -0
  385. package/packages/js-extensions/src/core/performance.ts +92 -0
  386. package/packages/js-extensions/src/core/validation.ts +42 -0
  387. package/packages/js-extensions/src/extensions/index.ts +5 -0
  388. package/packages/js-extensions/src/index.ts +120 -0
  389. package/packages/js-extensions/src/init/index.ts +3 -0
  390. package/packages/js-extensions/src/init/initializer.ts +32 -0
  391. package/packages/js-extensions/src/init/options.ts +32 -0
  392. package/packages/js-extensions/src/number/index.ts +1 -0
  393. package/packages/js-extensions/src/number/number-extensions.ts +162 -0
  394. package/packages/js-extensions/src/object/index.ts +1 -0
  395. package/packages/js-extensions/src/object/object-extensions.ts +171 -0
  396. package/packages/js-extensions/src/string/index.ts +1 -0
  397. package/packages/js-extensions/src/string/string-extensions.ts +138 -0
  398. package/packages/js-extensions/src/types/extension-types.ts +12 -0
  399. package/packages/js-extensions/src/types/global-augmentations.ts +80 -0
  400. package/packages/js-extensions/src/types/index.ts +3 -0
  401. package/packages/js-extensions/src/utils/config.ts +33 -0
  402. package/packages/js-extensions/src/utils/helpers.ts +35 -0
  403. package/packages/js-extensions/src/utils/index.ts +3 -0
  404. package/packages/js-extensions/tsconfig.base.json +18 -0
  405. package/packages/js-extensions/tsconfig.cjs.json +9 -0
  406. package/packages/js-extensions/tsconfig.esm.json +9 -0
  407. package/packages/js-extensions/tsconfig.json +22 -0
  408. package/packages/response-utils/README.md +211 -75
  409. package/packages/response-utils/dist/cjs/adapters/express/ExpressResponder.d.ts +18 -0
  410. package/packages/response-utils/dist/cjs/adapters/express/ExpressResponder.js +46 -0
  411. package/packages/response-utils/dist/cjs/constants/httpStatus.d.ts +54 -0
  412. package/packages/response-utils/dist/cjs/constants/httpStatus.js +34 -0
  413. package/packages/response-utils/dist/cjs/core/BaseResponder.d.ts +31 -0
  414. package/packages/response-utils/dist/cjs/core/BaseResponder.js +100 -0
  415. package/packages/response-utils/dist/cjs/core/config.d.ts +15 -0
  416. package/packages/response-utils/dist/cjs/core/config.js +15 -0
  417. package/packages/response-utils/dist/cjs/core/factory.d.ts +3 -0
  418. package/packages/response-utils/dist/cjs/core/factory.js +10 -0
  419. package/packages/response-utils/dist/cjs/core/types.d.ts +32 -0
  420. package/packages/response-utils/dist/cjs/core/types.js +2 -0
  421. package/packages/response-utils/dist/cjs/index.d.ts +9 -0
  422. package/packages/response-utils/dist/cjs/index.js +56 -0
  423. package/packages/response-utils/dist/cjs/legacy.d.ts +19 -0
  424. package/packages/response-utils/dist/cjs/legacy.js +23 -0
  425. package/packages/response-utils/dist/cjs/middleware/express/expressMiddleware.d.ts +3 -0
  426. package/packages/response-utils/dist/cjs/middleware/express/expressMiddleware.js +13 -0
  427. package/packages/response-utils/dist/esm/adapters/express/ExpressResponder.d.ts +18 -0
  428. package/packages/response-utils/dist/esm/adapters/express/ExpressResponder.js +42 -0
  429. package/packages/response-utils/dist/esm/constants/httpStatus.d.ts +54 -0
  430. package/packages/response-utils/dist/esm/constants/httpStatus.js +31 -0
  431. package/packages/response-utils/dist/esm/core/BaseResponder.d.ts +31 -0
  432. package/packages/response-utils/dist/esm/core/BaseResponder.js +96 -0
  433. package/packages/response-utils/dist/esm/core/config.d.ts +15 -0
  434. package/packages/response-utils/dist/esm/core/config.js +12 -0
  435. package/packages/response-utils/dist/esm/core/factory.d.ts +3 -0
  436. package/packages/response-utils/dist/esm/core/factory.js +6 -0
  437. package/packages/response-utils/dist/esm/core/types.d.ts +32 -0
  438. package/packages/response-utils/dist/esm/core/types.js +1 -0
  439. package/packages/response-utils/dist/esm/index.d.ts +9 -0
  440. package/packages/response-utils/dist/esm/index.js +12 -0
  441. package/packages/response-utils/dist/esm/legacy.d.ts +19 -0
  442. package/packages/response-utils/dist/esm/legacy.js +18 -0
  443. package/packages/response-utils/dist/esm/middleware/express/expressMiddleware.d.ts +3 -0
  444. package/packages/response-utils/dist/esm/middleware/express/expressMiddleware.js +9 -0
  445. package/packages/response-utils/dist/types/adapters/express/ExpressResponder.d.ts +18 -0
  446. package/packages/response-utils/dist/types/constants/httpStatus.d.ts +54 -0
  447. package/packages/response-utils/dist/types/core/BaseResponder.d.ts +31 -0
  448. package/packages/response-utils/dist/types/core/config.d.ts +15 -0
  449. package/packages/response-utils/dist/types/core/factory.d.ts +3 -0
  450. package/packages/response-utils/dist/types/core/types.d.ts +32 -0
  451. package/packages/response-utils/dist/types/index.d.ts +9 -0
  452. package/packages/response-utils/dist/types/legacy.d.ts +19 -0
  453. package/packages/response-utils/dist/types/middleware/express/expressMiddleware.d.ts +3 -0
  454. package/packages/response-utils/node_modules/.bin/rimraf +21 -0
  455. package/packages/response-utils/node_modules/.bin/tsc +21 -0
  456. package/packages/response-utils/node_modules/.bin/tsserver +21 -0
  457. package/packages/response-utils/package.json +38 -10
  458. package/packages/response-utils/src/adapters/express/ExpressResponder.ts +64 -0
  459. package/packages/response-utils/src/constants/httpStatus.ts +42 -0
  460. package/packages/response-utils/src/core/BaseResponder.ts +177 -0
  461. package/packages/response-utils/src/core/config.ts +29 -0
  462. package/packages/response-utils/src/core/factory.ts +11 -0
  463. package/packages/response-utils/src/core/types.ts +34 -0
  464. package/packages/response-utils/src/index.ts +16 -168
  465. package/packages/response-utils/src/legacy.ts +30 -0
  466. package/packages/response-utils/src/middleware/express/expressMiddleware.ts +14 -0
  467. package/packages/response-utils/tsconfig.base.json +11 -0
  468. package/packages/response-utils/tsconfig.cjs.json +9 -0
  469. package/packages/response-utils/tsconfig.esm.json +9 -0
  470. package/packages/security/README.md +485 -71
  471. package/packages/security/dist/cjs/core/crypto/cryptoManager.d.ts +111 -0
  472. package/packages/security/dist/cjs/core/crypto/cryptoManager.js +191 -0
  473. package/packages/security/dist/cjs/core/crypto/decrypt.d.ts +1 -0
  474. package/packages/security/dist/cjs/core/crypto/decrypt.js +21 -0
  475. package/packages/security/dist/cjs/core/crypto/encrypt.d.ts +1 -0
  476. package/packages/security/dist/cjs/core/crypto/encrypt.js +16 -0
  477. package/packages/security/dist/cjs/core/crypto/hmac.d.ts +8 -0
  478. package/packages/security/dist/cjs/core/crypto/hmac.js +24 -0
  479. package/packages/security/dist/cjs/core/crypto/index.d.ts +5 -0
  480. package/packages/security/dist/cjs/core/crypto/index.js +28 -0
  481. package/packages/security/dist/cjs/core/crypto/random.d.ts +8 -0
  482. package/packages/security/dist/cjs/core/crypto/random.js +21 -0
  483. package/packages/security/dist/cjs/core/jwt/decode.d.ts +12 -0
  484. package/packages/security/dist/cjs/core/jwt/decode.js +25 -0
  485. package/packages/security/dist/cjs/core/jwt/extractToken.d.ts +11 -0
  486. package/packages/security/dist/cjs/core/jwt/extractToken.js +54 -0
  487. package/packages/security/dist/cjs/core/jwt/generateTokens.d.ts +4 -0
  488. package/packages/security/dist/cjs/core/jwt/generateTokens.js +34 -0
  489. package/packages/security/dist/cjs/core/jwt/index.d.ts +8 -0
  490. package/packages/security/dist/cjs/core/jwt/index.js +24 -0
  491. package/packages/security/dist/cjs/core/jwt/jwtManager.d.ts +67 -0
  492. package/packages/security/dist/cjs/core/jwt/jwtManager.js +303 -0
  493. package/packages/security/dist/cjs/core/jwt/parseDuration.d.ts +1 -0
  494. package/packages/security/dist/cjs/core/jwt/parseDuration.js +29 -0
  495. package/packages/security/dist/cjs/core/jwt/signToken.d.ts +2 -0
  496. package/packages/security/dist/cjs/core/jwt/signToken.js +26 -0
  497. package/packages/security/dist/cjs/core/jwt/types.d.ts +22 -0
  498. package/packages/security/dist/cjs/core/jwt/types.js +2 -0
  499. package/packages/security/dist/cjs/core/jwt/validateToken.d.ts +13 -0
  500. package/packages/security/dist/cjs/core/jwt/validateToken.js +37 -0
  501. package/packages/security/dist/cjs/core/jwt/verify.d.ts +19 -0
  502. package/packages/security/dist/cjs/core/jwt/verify.js +44 -0
  503. package/packages/security/dist/cjs/core/password/hash.d.ts +10 -0
  504. package/packages/security/dist/cjs/core/password/hash.js +45 -0
  505. package/packages/security/dist/cjs/core/password/index.d.ts +3 -0
  506. package/packages/security/dist/cjs/core/password/index.js +19 -0
  507. package/packages/security/dist/cjs/core/password/passwordManager.d.ts +29 -0
  508. package/packages/security/dist/cjs/core/password/passwordManager.js +256 -0
  509. package/packages/security/dist/cjs/core/password/strength.d.ts +2 -0
  510. package/packages/security/dist/cjs/core/password/strength.js +21 -0
  511. package/packages/security/dist/cjs/core/password/types.d.ts +7 -0
  512. package/packages/security/dist/cjs/core/password/types.js +2 -0
  513. package/packages/security/dist/cjs/core/password/utils.d.ts +4 -0
  514. package/packages/security/dist/cjs/core/password/utils.js +38 -0
  515. package/packages/security/dist/cjs/core/password/verify.d.ts +10 -0
  516. package/packages/security/dist/cjs/core/password/verify.js +46 -0
  517. package/packages/security/dist/cjs/index.d.ts +45 -0
  518. package/packages/security/dist/cjs/index.js +56 -0
  519. package/packages/security/dist/cjs/interfaces/jwt.interface.d.ts +47 -0
  520. package/packages/security/dist/cjs/interfaces/jwt.interface.js +2 -0
  521. package/packages/security/dist/cjs/interfaces/password.interface.d.ts +60 -0
  522. package/packages/security/dist/cjs/interfaces/password.interface.js +2 -0
  523. package/packages/security/dist/esm/core/crypto/cryptoManager.d.ts +111 -0
  524. package/packages/security/dist/esm/core/crypto/cryptoManager.js +186 -0
  525. package/packages/security/dist/esm/core/crypto/decrypt.d.ts +1 -0
  526. package/packages/security/dist/esm/core/crypto/decrypt.js +14 -0
  527. package/packages/security/dist/esm/core/crypto/encrypt.d.ts +1 -0
  528. package/packages/security/dist/esm/core/crypto/encrypt.js +9 -0
  529. package/packages/security/dist/esm/core/crypto/hmac.d.ts +8 -0
  530. package/packages/security/dist/esm/core/crypto/hmac.js +16 -0
  531. package/packages/security/dist/esm/core/crypto/index.d.ts +5 -0
  532. package/packages/security/dist/esm/core/crypto/index.js +5 -0
  533. package/packages/security/dist/esm/core/crypto/random.d.ts +8 -0
  534. package/packages/security/dist/esm/core/crypto/random.js +13 -0
  535. package/packages/security/dist/esm/core/jwt/decode.d.ts +12 -0
  536. package/packages/security/dist/esm/core/jwt/decode.js +21 -0
  537. package/packages/security/dist/esm/core/jwt/extractToken.d.ts +11 -0
  538. package/packages/security/dist/esm/core/jwt/extractToken.js +51 -0
  539. package/packages/security/dist/esm/core/jwt/generateTokens.d.ts +4 -0
  540. package/packages/security/dist/esm/core/jwt/generateTokens.js +29 -0
  541. package/packages/security/dist/esm/core/jwt/index.d.ts +8 -0
  542. package/packages/security/dist/esm/core/jwt/index.js +8 -0
  543. package/packages/security/dist/esm/core/jwt/jwtManager.d.ts +67 -0
  544. package/packages/security/dist/esm/core/jwt/jwtManager.js +296 -0
  545. package/packages/security/dist/esm/core/jwt/parseDuration.d.ts +1 -0
  546. package/packages/security/dist/esm/core/jwt/parseDuration.js +26 -0
  547. package/packages/security/dist/esm/core/jwt/signToken.d.ts +2 -0
  548. package/packages/security/dist/esm/core/jwt/signToken.js +22 -0
  549. package/packages/security/dist/esm/core/jwt/types.d.ts +22 -0
  550. package/packages/security/dist/esm/core/jwt/types.js +1 -0
  551. package/packages/security/dist/esm/core/jwt/validateToken.d.ts +13 -0
  552. package/packages/security/dist/esm/core/jwt/validateToken.js +33 -0
  553. package/packages/security/dist/esm/core/jwt/verify.d.ts +19 -0
  554. package/packages/security/dist/esm/core/jwt/verify.js +37 -0
  555. package/packages/security/dist/esm/core/password/hash.d.ts +10 -0
  556. package/packages/security/dist/esm/core/password/hash.js +35 -0
  557. package/packages/security/dist/esm/core/password/index.d.ts +3 -0
  558. package/packages/security/dist/esm/core/password/index.js +3 -0
  559. package/packages/security/dist/esm/core/password/passwordManager.d.ts +29 -0
  560. package/packages/security/dist/esm/core/password/passwordManager.js +249 -0
  561. package/packages/security/dist/esm/core/password/strength.d.ts +2 -0
  562. package/packages/security/dist/esm/core/password/strength.js +17 -0
  563. package/packages/security/dist/esm/core/password/types.d.ts +7 -0
  564. package/packages/security/dist/esm/core/password/types.js +1 -0
  565. package/packages/security/dist/esm/core/password/utils.d.ts +4 -0
  566. package/packages/security/dist/esm/core/password/utils.js +29 -0
  567. package/packages/security/dist/esm/core/password/verify.d.ts +10 -0
  568. package/packages/security/dist/esm/core/password/verify.js +36 -0
  569. package/packages/security/dist/esm/index.d.ts +45 -0
  570. package/packages/security/dist/esm/index.js +13 -0
  571. package/packages/security/dist/esm/interfaces/jwt.interface.d.ts +47 -0
  572. package/packages/security/dist/esm/interfaces/jwt.interface.js +1 -0
  573. package/packages/security/dist/esm/interfaces/password.interface.d.ts +60 -0
  574. package/packages/security/dist/esm/interfaces/password.interface.js +1 -0
  575. package/packages/security/dist/types/core/crypto/cryptoManager.d.ts +111 -0
  576. package/packages/security/dist/types/core/crypto/decrypt.d.ts +1 -0
  577. package/packages/security/dist/types/core/crypto/encrypt.d.ts +1 -0
  578. package/packages/security/dist/types/core/crypto/hmac.d.ts +8 -0
  579. package/packages/security/dist/types/core/crypto/index.d.ts +5 -0
  580. package/packages/security/dist/types/core/crypto/random.d.ts +8 -0
  581. package/packages/security/dist/types/core/jwt/decode.d.ts +12 -0
  582. package/packages/security/dist/types/core/jwt/extractToken.d.ts +11 -0
  583. package/packages/security/dist/types/core/jwt/generateTokens.d.ts +4 -0
  584. package/packages/security/dist/types/core/jwt/index.d.ts +8 -0
  585. package/packages/security/dist/types/core/jwt/jwtManager.d.ts +67 -0
  586. package/packages/security/dist/types/core/jwt/parseDuration.d.ts +1 -0
  587. package/packages/security/dist/types/core/jwt/signToken.d.ts +2 -0
  588. package/packages/security/dist/types/core/jwt/types.d.ts +22 -0
  589. package/packages/security/dist/types/core/jwt/validateToken.d.ts +13 -0
  590. package/packages/security/dist/types/core/jwt/verify.d.ts +19 -0
  591. package/packages/security/dist/types/core/password/hash.d.ts +10 -0
  592. package/packages/security/dist/types/core/password/index.d.ts +3 -0
  593. package/packages/security/dist/types/core/password/passwordManager.d.ts +29 -0
  594. package/packages/security/dist/types/core/password/strength.d.ts +2 -0
  595. package/packages/security/dist/types/core/password/types.d.ts +7 -0
  596. package/packages/security/dist/types/core/password/utils.d.ts +4 -0
  597. package/packages/security/dist/types/core/password/verify.d.ts +10 -0
  598. package/packages/security/dist/types/index.d.ts +45 -0
  599. package/packages/security/dist/types/interfaces/jwt.interface.d.ts +47 -0
  600. package/packages/security/dist/types/interfaces/password.interface.d.ts +60 -0
  601. package/packages/security/node_modules/.bin/bcrypt +21 -0
  602. package/packages/security/node_modules/.bin/rimraf +21 -0
  603. package/packages/security/node_modules/.bin/tsc +21 -0
  604. package/packages/security/node_modules/.bin/tsserver +21 -0
  605. package/packages/security/package.json +23 -4
  606. package/packages/security/src/core/crypto/cryptoManager.ts +292 -0
  607. package/packages/security/src/core/crypto/decrypt.ts +20 -0
  608. package/packages/security/src/core/crypto/encrypt.ts +14 -0
  609. package/packages/security/src/core/crypto/hmac.ts +23 -0
  610. package/packages/security/src/core/crypto/index.ts +5 -0
  611. package/packages/security/src/core/crypto/random.ts +15 -0
  612. package/packages/security/src/core/jwt/decode.ts +25 -0
  613. package/packages/security/src/core/jwt/extractToken.ts +59 -0
  614. package/packages/security/src/core/jwt/generateTokens.ts +48 -0
  615. package/packages/security/src/core/jwt/index.ts +8 -0
  616. package/packages/security/src/core/jwt/jwtManager.ts +385 -0
  617. package/packages/security/src/core/jwt/parseDuration.ts +32 -0
  618. package/packages/security/src/core/jwt/signToken.ts +31 -0
  619. package/packages/security/src/core/jwt/types.ts +29 -0
  620. package/packages/security/src/core/jwt/validateToken.ts +52 -0
  621. package/packages/security/src/core/jwt/verify.ts +55 -0
  622. package/packages/security/src/core/password/hash.ts +40 -0
  623. package/packages/security/src/core/password/index.ts +3 -0
  624. package/packages/security/src/core/password/passwordManager.ts +314 -0
  625. package/packages/security/src/core/password/strength.ts +35 -0
  626. package/packages/security/src/core/password/types.ts +7 -0
  627. package/packages/security/src/core/password/utils.ts +31 -0
  628. package/packages/security/src/core/password/verify.ts +47 -0
  629. package/packages/security/src/index.ts +21 -39
  630. package/packages/security/src/interfaces/jwt.interface.ts +58 -0
  631. package/packages/security/src/interfaces/password.interface.ts +54 -0
  632. package/packages/security/tsconfig.base.json +17 -0
  633. package/packages/security/tsconfig.cjs.json +9 -0
  634. package/packages/security/tsconfig.esm.json +9 -0
  635. package/packages/server-utils/README.md +412 -49
  636. package/packages/server-utils/dist/cjs/core/health.d.ts +5 -0
  637. package/packages/server-utils/dist/cjs/core/health.js +45 -0
  638. package/packages/server-utils/dist/cjs/core/periodic-health.d.ts +11 -0
  639. package/packages/server-utils/dist/cjs/core/periodic-health.js +68 -0
  640. package/packages/server-utils/dist/cjs/core/server.d.ts +73 -0
  641. package/packages/server-utils/dist/cjs/core/server.js +437 -0
  642. package/packages/server-utils/dist/cjs/core/shutdown.d.ts +5 -0
  643. package/packages/server-utils/dist/cjs/core/shutdown.js +58 -0
  644. package/packages/server-utils/dist/cjs/index.d.ts +46 -0
  645. package/packages/server-utils/dist/cjs/index.js +91 -0
  646. package/packages/server-utils/dist/cjs/middleware/auth.middleware.d.ts +7 -0
  647. package/packages/server-utils/dist/cjs/middleware/auth.middleware.js +41 -0
  648. package/packages/server-utils/dist/cjs/middleware/cache.middleware.d.ts +2 -0
  649. package/packages/server-utils/dist/cjs/middleware/cache.middleware.js +58 -0
  650. package/packages/server-utils/dist/cjs/middleware/errorHandler.middleware.d.ts +2 -0
  651. package/packages/server-utils/dist/cjs/middleware/errorHandler.middleware.js +30 -0
  652. package/packages/server-utils/dist/cjs/middleware/index.d.ts +10 -0
  653. package/packages/server-utils/dist/cjs/middleware/index.js +40 -0
  654. package/packages/server-utils/dist/cjs/middleware/logging.middleware.d.ts +2 -0
  655. package/packages/server-utils/dist/cjs/middleware/logging.middleware.js +19 -0
  656. package/packages/server-utils/dist/cjs/middleware/plugins.middleware.d.ts +14 -0
  657. package/packages/server-utils/dist/cjs/middleware/plugins.middleware.js +58 -0
  658. package/packages/server-utils/dist/cjs/middleware/rateLimiter.middleware.d.ts +8 -0
  659. package/packages/server-utils/dist/cjs/middleware/rateLimiter.middleware.js +35 -0
  660. package/packages/server-utils/dist/cjs/middleware/requestId.middleware.d.ts +2 -0
  661. package/packages/server-utils/dist/cjs/middleware/requestId.middleware.js +12 -0
  662. package/packages/server-utils/dist/cjs/middleware/session.middleware.d.ts +2 -0
  663. package/packages/server-utils/dist/cjs/middleware/session.middleware.js +53 -0
  664. package/packages/server-utils/dist/cjs/middleware/validation.middleware.d.ts +11 -0
  665. package/packages/server-utils/dist/cjs/middleware/validation.middleware.js +67 -0
  666. package/packages/server-utils/dist/cjs/types/index.d.ts +87 -0
  667. package/packages/server-utils/dist/cjs/types/index.js +2 -0
  668. package/packages/server-utils/dist/cjs/utils/utils.d.ts +3 -0
  669. package/packages/server-utils/dist/cjs/utils/utils.js +43 -0
  670. package/packages/server-utils/dist/esm/core/health.d.ts +5 -0
  671. package/packages/server-utils/dist/esm/core/health.js +40 -0
  672. package/packages/server-utils/dist/esm/core/periodic-health.d.ts +11 -0
  673. package/packages/server-utils/dist/esm/core/periodic-health.js +64 -0
  674. package/packages/server-utils/dist/esm/core/server.d.ts +73 -0
  675. package/packages/server-utils/dist/esm/core/server.js +396 -0
  676. package/packages/server-utils/dist/esm/core/shutdown.d.ts +5 -0
  677. package/packages/server-utils/dist/esm/core/shutdown.js +53 -0
  678. package/packages/server-utils/dist/esm/index.d.ts +46 -0
  679. package/packages/server-utils/dist/esm/index.js +58 -0
  680. package/packages/server-utils/dist/esm/middleware/auth.middleware.d.ts +7 -0
  681. package/packages/server-utils/dist/esm/middleware/auth.middleware.js +38 -0
  682. package/packages/server-utils/dist/esm/middleware/cache.middleware.d.ts +2 -0
  683. package/packages/server-utils/dist/esm/middleware/cache.middleware.js +55 -0
  684. package/packages/server-utils/dist/esm/middleware/errorHandler.middleware.d.ts +2 -0
  685. package/packages/server-utils/dist/esm/middleware/errorHandler.middleware.js +27 -0
  686. package/packages/server-utils/dist/esm/middleware/index.d.ts +10 -0
  687. package/packages/server-utils/dist/esm/middleware/index.js +20 -0
  688. package/packages/server-utils/dist/esm/middleware/logging.middleware.d.ts +2 -0
  689. package/packages/server-utils/dist/esm/middleware/logging.middleware.js +16 -0
  690. package/packages/server-utils/dist/esm/middleware/plugins.middleware.d.ts +14 -0
  691. package/packages/server-utils/dist/esm/middleware/plugins.middleware.js +47 -0
  692. package/packages/server-utils/dist/esm/middleware/rateLimiter.middleware.d.ts +8 -0
  693. package/packages/server-utils/dist/esm/middleware/rateLimiter.middleware.js +32 -0
  694. package/packages/server-utils/dist/esm/middleware/requestId.middleware.d.ts +2 -0
  695. package/packages/server-utils/dist/esm/middleware/requestId.middleware.js +9 -0
  696. package/packages/server-utils/dist/esm/middleware/session.middleware.d.ts +2 -0
  697. package/packages/server-utils/dist/esm/middleware/session.middleware.js +50 -0
  698. package/packages/server-utils/dist/esm/middleware/validation.middleware.d.ts +11 -0
  699. package/packages/server-utils/dist/esm/middleware/validation.middleware.js +64 -0
  700. package/packages/server-utils/dist/esm/types/index.d.ts +87 -0
  701. package/packages/server-utils/dist/esm/types/index.js +1 -0
  702. package/packages/server-utils/dist/esm/utils/utils.d.ts +3 -0
  703. package/packages/server-utils/dist/esm/utils/utils.js +38 -0
  704. package/packages/server-utils/dist/types/core/health.d.ts +5 -0
  705. package/packages/server-utils/dist/types/core/periodic-health.d.ts +11 -0
  706. package/packages/server-utils/dist/types/core/server.d.ts +73 -0
  707. package/packages/server-utils/dist/types/core/shutdown.d.ts +5 -0
  708. package/packages/server-utils/dist/types/index.d.ts +46 -0
  709. package/packages/server-utils/dist/types/middleware/auth.middleware.d.ts +7 -0
  710. package/packages/server-utils/dist/types/middleware/cache.middleware.d.ts +2 -0
  711. package/packages/server-utils/dist/types/middleware/errorHandler.middleware.d.ts +2 -0
  712. package/packages/server-utils/dist/types/middleware/index.d.ts +10 -0
  713. package/packages/server-utils/dist/types/middleware/logging.middleware.d.ts +2 -0
  714. package/packages/server-utils/dist/types/middleware/plugins.middleware.d.ts +14 -0
  715. package/packages/server-utils/dist/types/middleware/rateLimiter.middleware.d.ts +8 -0
  716. package/packages/server-utils/dist/types/middleware/requestId.middleware.d.ts +2 -0
  717. package/packages/server-utils/dist/types/middleware/session.middleware.d.ts +2 -0
  718. package/packages/server-utils/dist/types/middleware/validation.middleware.d.ts +11 -0
  719. package/packages/server-utils/dist/types/types/index.d.ts +87 -0
  720. package/packages/server-utils/dist/types/utils/utils.d.ts +3 -0
  721. package/packages/server-utils/node_modules/.bin/rimraf +21 -0
  722. package/packages/server-utils/node_modules/.bin/tsc +21 -0
  723. package/packages/server-utils/node_modules/.bin/tsserver +21 -0
  724. package/packages/server-utils/package.json +30 -6
  725. package/packages/server-utils/src/core/health.ts +58 -0
  726. package/packages/server-utils/src/core/periodic-health.ts +88 -0
  727. package/packages/server-utils/src/core/server.ts +650 -0
  728. package/packages/server-utils/src/core/shutdown.ts +78 -0
  729. package/packages/server-utils/src/express-augment.d.ts +35 -0
  730. package/packages/server-utils/src/index.ts +132 -95
  731. package/packages/server-utils/src/middleware/auth.middleware.ts +66 -0
  732. package/packages/server-utils/src/middleware/cache.middleware.ts +68 -0
  733. package/packages/server-utils/src/middleware/errorHandler.middleware.ts +44 -0
  734. package/packages/server-utils/src/middleware/index.ts +46 -0
  735. package/packages/server-utils/src/middleware/logging.middleware.ts +29 -0
  736. package/packages/server-utils/src/middleware/plugins.middleware.ts +64 -0
  737. package/packages/server-utils/src/middleware/rateLimiter.middleware.ts +59 -0
  738. package/packages/server-utils/src/middleware/requestId.middleware.ts +16 -0
  739. package/packages/server-utils/src/middleware/session.middleware.ts +66 -0
  740. package/packages/server-utils/src/middleware/validation.middleware.ts +101 -0
  741. package/packages/server-utils/src/types/index.ts +114 -0
  742. package/packages/server-utils/src/utils/utils.ts +43 -0
  743. package/packages/server-utils/tsconfig.base.json +17 -0
  744. package/packages/server-utils/tsconfig.cjs.json +9 -0
  745. package/packages/server-utils/tsconfig.esm.json +9 -0
  746. package/packages/server-utils/src/health.ts +0 -47
  747. package/packages/server-utils/src/middleware.ts +0 -275
  748. package/packages/server-utils/src/server.ts +0 -320
  749. package/packages/server-utils/src/shutdown.ts +0 -60
  750. package/packages/server-utils/src/types.ts +0 -64
  751. package/packages/server-utils/src/utils.ts +0 -34
  752. /package/packages/{response-utils → cache}/tsconfig.json +0 -0
@@ -0,0 +1,22 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2020",
4
+ "module": "CommonJS",
5
+ "moduleResolution": "node",
6
+ "rootDir": "./src",
7
+ "outDir": "./dist",
8
+ "strict": true,
9
+ "esModuleInterop": true,
10
+ "allowSyntheticDefaultImports": true,
11
+ "skipLibCheck": true,
12
+ "forceConsistentCasingInFileNames": true,
13
+ "declaration": true,
14
+ "baseUrl": ".",
15
+ "paths": {
16
+ "*": ["*", "*.ts", "*.js"]
17
+ },
18
+ "lib": ["ES2020", "DOM"]
19
+ },
20
+ "include": ["src/**/*"],
21
+ "exclude": ["node_modules", "dist"]
22
+ }
@@ -1,110 +1,246 @@
1
1
  # @naman_deep_singh/response-utils
2
2
 
3
- TypeScript utilities for standardized HTTP API responses with common status codes and error handling. Supports both standalone usage and Express.js integration.
3
+ **Version:** 2.1.2
4
4
 
5
- ## Installation
5
+ A flexible, framework-agnostic **TypeScript** response utility library for building consistent and configurable API responses.
6
+ Supports **Express.js**, pagination, typed payloads, and expandable response adapters.
6
7
 
7
- ```bash
8
+ ---
9
+
10
+ ## 🚀 Features
11
+
12
+ | Feature | Status |
13
+ | ---------------------------------------------- | :----: |
14
+ | Fully Typesafe Response Envelopes | ✅ |
15
+ | Framework-Agnostic Core | ✅ |
16
+ | Express.js Adapter + Middleware | ✅ |
17
+ | Automatic HTTP Status Handling | ✅ |
18
+ | Pagination Responses | ✅ |
19
+ | Centralized Response Config | ✅ |
20
+ | Status Code Constants | ✅ |
21
+ | Legacy API (`success`, `error`, etc.) | ⚠️ Deprecated |
22
+
23
+ ---
24
+
25
+ ## 📦 Installation
26
+
27
+ ```sh
8
28
  npm install @naman_deep_singh/response-utils
9
29
  ```
10
30
 
11
- ## Features
31
+ ## 🧠 Architecture Overview
12
32
 
13
- - ✅ **Standardized API responses** with consistent format
14
- - ✅ **Express.js integration** - automatically sets HTTP status codes
15
- - **TypeScript support** with full type safety
16
- - ✅ **Hybrid exports** - use named imports or namespace imports
17
- - **Pagination support** with metadata
18
- - **Common HTTP status codes** (200, 201, 400, 401, 403, 404, 408, 409, 422, 429, 500)
33
+ ```
34
+ response-utils
35
+ ├─ core/ → BaseResponder + config + factory (framework-independent)
36
+ ├─ adapters/
37
+ │ └─ express/ → ExpressResponder + middleware
38
+ ├─ constants/ → HTTP status constants
39
+ └─ legacy/ → success(), error(), etc. (optional migration layer)
40
+ ```
19
41
 
20
- ## Usage
42
+ ## 📄 Response Format (Default Envelope)
21
43
 
22
- ### Named Imports (Tree-shakable)
23
44
  ```typescript
24
- import { success, error, created, notFound, paginated } from '@naman_deep_singh/response-utils';
45
+ interface ResponseEnvelope<P = unknown, M = Record<string, unknown>> {
46
+ success: boolean;
47
+ message?: string;
48
+ data?: P;
49
+ error: { message: string; code?: string; details?: unknown } | null;
50
+ meta: M | null;
51
+ }
52
+ ```
25
53
 
26
- // Success responses
27
- const userResponse = success({ id: 1, name: 'John' }, 'User found');
28
- const createdResponse = created({ id: 2, name: 'Jane' });
54
+ ## 🛠️ Usage Examples
29
55
 
30
- // Error responses
31
- const errorResponse = notFound('User not found');
32
- const validationResponse = validationError('Invalid input', ['Name is required']);
56
+ ### Framework-Agnostic (no Express)
57
+ ```typescript
58
+ import { BaseResponder } from '@naman_deep_singh/response-utils';
33
59
 
34
- // Paginated responses
35
- const paginatedUsers = paginated([{id: 1}, {id: 2}], 1, 10, 25);
60
+ const r = new BaseResponder();
61
+ const result = r.ok({ user: "John" }, "Loaded");
62
+ console.log(result);
36
63
  ```
37
64
 
38
- ### Namespace Import
65
+ ### 🌐 Express Integration
66
+
67
+ #### 1️⃣ Add Middleware
68
+
39
69
  ```typescript
40
- import ResponseUtils from '@naman_deep_singh/response-utils';
70
+ import express from 'express';
71
+ import { responderMiddleware } from '@naman_deep_singh/response-utils';
41
72
 
42
- const response = ResponseUtils.success({ id: 1 }, 'Success');
73
+ const app = express();
74
+ app.use(responderMiddleware());
43
75
  ```
44
76
 
45
- ### Express.js Integration
77
+ #### 2️⃣ Controller Usage
78
+
46
79
  ```typescript
47
- import { success, notFound } from '@naman_deep_singh/response-utils';
48
- import { Request, Response } from 'express';
49
-
50
- app.get('/users/:id', (req: Request, res: Response) => {
51
- const user = findUser(req.params.id);
52
-
53
- if (!user) {
54
- return notFound('User not found', res); // Sets status 404 and sends response
55
- }
56
-
57
- return success(user, 'User found', 200, res); // Sets status 200 and sends response
80
+ app.get('/user', (req, res) => {
81
+ const responder = (res as any).responder();
82
+ return responder.okAndSend({ id: 1, name: "John Doe" }, "User found");
58
83
  });
59
84
  ```
60
85
 
61
- ## API Reference
86
+ `okAndSend()` automatically applies HTTP status + JSON response.
62
87
 
63
- ### Success Responses
64
- - `success<T>(data: T, message?, statusCode?, res?)` - Generic success response (200)
65
- - `created<T>(data: T, message?, res?)` - 201 Created response
66
- - `noContent(message?, res?)` - 204 No Content response
67
- - `paginated<T>(data: T[], page, limit, total, message?, res?)` - Paginated response with metadata
88
+ #### ⚙️ Config Options
68
89
 
69
- ### Error Responses
70
- - `error(message, statusCode?, error?, res?)` - Generic error response
71
- - `badRequest(message?, validationError?, res?)` - 400 Bad Request
72
- - `unauthorized(message?, res?)` - 401 Unauthorized
73
- - `forbidden(message?, res?)` - 403 Forbidden
74
- - `notFound(message?, res?)` - 404 Not Found
75
- - `timeout(message?, res?)` - 408 Request Timeout
76
- - `conflict(message?, res?)` - 409 Conflict
77
- - `validationError(message?, errors[], res?)` - 422 Validation Error
78
- - `tooManyRequests(message?, res?)` - 429 Too Many Requests
79
- - `serverError(message?, res?)` - 500 Internal Server Error
90
+ ```typescript
91
+ app.use(responderMiddleware({
92
+ timestamp: true,
93
+ extra: { service: "user-service" }
94
+ }));
95
+ ```
80
96
 
81
- ### Utility Functions
82
- - `logError(context: string, error: unknown)` - Structured error logging
83
- - `getErrorMessage(error: unknown)` - Extract error message safely
97
+ Example output:
84
98
 
85
- ## Response Format
99
+ ```json
100
+ {
101
+ "success": true,
102
+ "data": { ... },
103
+ "error": null,
104
+ "meta": {
105
+ "timestamp": "2025-11-22T12:00:00Z",
106
+ "service": "user-service"
107
+ }
108
+ }
109
+ ```
86
110
 
87
- All responses follow the `ApiResponse<T>` interface:
111
+ ### 🔢 Pagination Support
88
112
 
89
113
  ```typescript
90
- interface ApiResponse<T = any> {
91
- success: boolean;
92
- message: string;
93
- data?: T;
94
- error?: string;
95
- statusCode: number;
96
- }
114
+ responder.paginateAndSend(
115
+ [{ id: 1 }],
116
+ 1, // page
117
+ 10, // limit
118
+ 42, // total
119
+ "Loaded"
120
+ );
97
121
  ```
98
122
 
99
- ## Paginated Response Format
123
+ ## 📚 Supported Methods
124
+
125
+ ### Success Methods
126
+ | Method | Status |
127
+ |--------|--------|
128
+ | `ok()` | 200 |
129
+ | `created()` | 201 |
130
+ | `noContent()` | 204 |
131
+ | `paginated()` | 200 |
132
+
133
+ ### Error Methods
134
+ | Method | Status |
135
+ |--------|--------|
136
+ | `badRequest()` | 400 |
137
+ | `unauthorized()` | 401 |
138
+ | `forbidden()` | 403 |
139
+ | `notFound()` | 404 |
140
+ | `conflict()` | 409 |
141
+ | `unprocessableEntity()` | 422 |
142
+ | `tooManyRequests()` | 429 |
143
+ | `serverError()` | 500 |
144
+
145
+ **Each has an Express `*AndSend()` variant**
146
+ Example → `notFoundAndSend()`, `createdAndSend()`
147
+
148
+ ### 🧩 Status Constants
100
149
 
101
150
  ```typescript
102
- interface PaginatedResponse<T> extends ApiResponse<T[]> {
103
- pagination: {
104
- page: number;
105
- limit: number;
106
- total: number;
107
- totalPages: number;
108
- };
109
- }
110
- ```
151
+ import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
152
+
153
+ console.log(HTTP_STATUS.CLIENT_ERROR.NOT_FOUND); // 404
154
+ console.log(HTTP_STATUS.SUCCESS.CREATED); // 201
155
+ ```
156
+
157
+ **Categories:**
158
+ - `SUCCESS`
159
+ - `REDIRECTION`
160
+ - `CLIENT_ERROR`
161
+ - `SERVER_ERROR`
162
+
163
+ **All fully readonly + literal typed** ✔
164
+
165
+
166
+ ### 🧩 Status Constants
167
+
168
+ ```typescript
169
+ import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
170
+
171
+ console.log(HTTP_STATUS.CLIENT_ERROR.NOT_FOUND); // 404
172
+ console.log(HTTP_STATUS.SUCCESS.CREATED); // 201
173
+ ```
174
+
175
+ **Categories available:**
176
+
177
+ - `SUCCESS`
178
+ - `REDIRECTION`
179
+ - `CLIENT_ERROR`
180
+ - `SERVER_ERROR`
181
+
182
+ All values are:
183
+
184
+ ✔ Object.freeze() protected
185
+ ✔ Strongly typed using as const
186
+ ✔ Auto-complete supported in IDEs
187
+ ✔ Works with any HTTP framework
188
+
189
+ ### 🕘 Legacy API (Migration-friendly)
190
+
191
+ ```typescript
192
+ import { success, error } from '@naman_deep_singh/response-utils/legacy';
193
+
194
+ // Success response
195
+ const result = success({ id: 1, name: 'John' }, 'User found', 200);
196
+ // Returns: { success: true, message: 'User found', data: {...}, statusCode: 200 }
197
+
198
+ // Error response
199
+ const errorResult = error('User not found', 404, 'NOT_FOUND');
200
+ // Returns: { success: false, message: 'User not found', error: 'NOT_FOUND', statusCode: 404 }
201
+
202
+ // With Express response object
203
+ success({ users: [] }, 'Success', 200, res); // Automatically sends response
204
+ error('Server error', 500, undefined, res); // Automatically sends error
205
+ ```
206
+
207
+ **Legacy Functions:**
208
+ - `success(data, message?, status?, res?)` - Create success response
209
+ - `error(message, status?, error?, res?)` - Create error response
210
+
211
+ ⚠ **Recommended only for old codebases.** Use BaseResponder/ExpressResponder for new projects.
212
+
213
+ ## 🔜 Roadmap
214
+
215
+ | Feature | Status |
216
+ |---------|--------|
217
+ | Fastify Adapter | Planned |
218
+ | Hono Adapter | Planned |
219
+ | Custom Error Classes | Planned |
220
+
221
+ ## Integration with Other Packages
222
+
223
+ ### With @naman_deep_singh/server-utils
224
+
225
+ ```typescript
226
+ import { createServer } from '@naman_deep_singh/server-utils';
227
+ import { responderMiddleware } from '@naman_deep_singh/response-utils';
228
+
229
+ const server = createServer('My API', '1.0.0');
230
+ server.app.use(responderMiddleware());
231
+
232
+ // All server-utils middleware now uses consistent response format
233
+ ```
234
+
235
+ ### With @naman_deep_singh/errors-utils
236
+
237
+ ```typescript
238
+ import { expressErrorHandler } from '@naman_deep_singh/errors-utils';
239
+
240
+ // Advanced error handling with consistent responses
241
+ server.app.use(expressErrorHandler);
242
+ ```
243
+
244
+ ## 📄 License
245
+
246
+ MIT © Naman Deep Singh
@@ -0,0 +1,18 @@
1
+ import type { Response } from 'express';
2
+ import { BaseResponder } from '../../core/BaseResponder';
3
+ import type { ResponderConfig } from '../../core/config';
4
+ export declare class ExpressResponder<P = unknown> extends BaseResponder<P> {
5
+ private readonly res;
6
+ constructor(cfg: Partial<ResponderConfig> | undefined, res: Response);
7
+ okAndSend(data?: P, message?: string): void;
8
+ createdAndSend(data?: P, message?: string): void;
9
+ badRequestAndSend(message?: string, error?: unknown): void;
10
+ unauthorizedAndSend(message?: string): void;
11
+ forbiddenAndSend(message?: string): void;
12
+ notFoundAndSend(message?: string): void;
13
+ conflictAndSend(message?: string): void;
14
+ unprocessableEntityAndSend(message?: string, error?: unknown): void;
15
+ tooManyRequestsAndSend(message?: string): void;
16
+ serverErrorAndSend(message?: string, error?: unknown): void;
17
+ paginateAndSend(data: P[], page: number, limit: number, total: number, message?: string): void;
18
+ }
@@ -0,0 +1,46 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ExpressResponder = void 0;
4
+ const BaseResponder_1 = require("../../core/BaseResponder");
5
+ class ExpressResponder extends BaseResponder_1.BaseResponder {
6
+ constructor(cfg, res) {
7
+ // attach sender which calls res.status().json()
8
+ super(cfg, (status, body) => res.status(status).json(body));
9
+ this.res = res;
10
+ }
11
+ // convenience methods that return void for middleware/controller ergonomics
12
+ okAndSend(data, message) {
13
+ void this.ok(data, message);
14
+ }
15
+ createdAndSend(data, message) {
16
+ void this.created(data, message);
17
+ }
18
+ badRequestAndSend(message, error) {
19
+ void this.badRequest(message, error);
20
+ }
21
+ unauthorizedAndSend(message) {
22
+ void this.unauthorized(message);
23
+ }
24
+ forbiddenAndSend(message) {
25
+ void this.forbidden(message);
26
+ }
27
+ notFoundAndSend(message) {
28
+ void this.notFound(message);
29
+ }
30
+ conflictAndSend(message) {
31
+ void this.conflict(message);
32
+ }
33
+ unprocessableEntityAndSend(message, error) {
34
+ void this.unprocessableEntity(message, error);
35
+ }
36
+ tooManyRequestsAndSend(message) {
37
+ void this.tooManyRequests(message);
38
+ }
39
+ serverErrorAndSend(message, error) {
40
+ void this.serverError(message, error);
41
+ }
42
+ paginateAndSend(data, page, limit, total, message) {
43
+ void this.paginate(data, page, limit, total, message);
44
+ }
45
+ }
46
+ exports.ExpressResponder = ExpressResponder;
@@ -0,0 +1,54 @@
1
+ declare const SUCCESS: Readonly<{
2
+ readonly OK: 200;
3
+ readonly CREATED: 201;
4
+ readonly ACCEPTED: 202;
5
+ readonly NO_CONTENT: 204;
6
+ }>;
7
+ declare const REDIRECTION: Readonly<{
8
+ readonly NOT_MODIFIED: 304;
9
+ }>;
10
+ declare const CLIENT_ERROR: Readonly<{
11
+ readonly BAD_REQUEST: 400;
12
+ readonly UNAUTHORIZED: 401;
13
+ readonly FORBIDDEN: 403;
14
+ readonly NOT_FOUND: 404;
15
+ readonly METHOD_NOT_ALLOWED: 405;
16
+ readonly CONFLICT: 409;
17
+ readonly UNPROCESSABLE_ENTITY: 422;
18
+ readonly TOO_MANY_REQUESTS: 429;
19
+ }>;
20
+ declare const SERVER_ERROR: Readonly<{
21
+ readonly INTERNAL_SERVER_ERROR: 500;
22
+ readonly NOT_IMPLEMENTED: 501;
23
+ readonly BAD_GATEWAY: 502;
24
+ readonly SERVICE_UNAVAILABLE: 503;
25
+ }>;
26
+ export declare const HTTP_STATUS: Readonly<{
27
+ readonly SUCCESS: Readonly<{
28
+ readonly OK: 200;
29
+ readonly CREATED: 201;
30
+ readonly ACCEPTED: 202;
31
+ readonly NO_CONTENT: 204;
32
+ }>;
33
+ readonly REDIRECTION: Readonly<{
34
+ readonly NOT_MODIFIED: 304;
35
+ }>;
36
+ readonly CLIENT_ERROR: Readonly<{
37
+ readonly BAD_REQUEST: 400;
38
+ readonly UNAUTHORIZED: 401;
39
+ readonly FORBIDDEN: 403;
40
+ readonly NOT_FOUND: 404;
41
+ readonly METHOD_NOT_ALLOWED: 405;
42
+ readonly CONFLICT: 409;
43
+ readonly UNPROCESSABLE_ENTITY: 422;
44
+ readonly TOO_MANY_REQUESTS: 429;
45
+ }>;
46
+ readonly SERVER_ERROR: Readonly<{
47
+ readonly INTERNAL_SERVER_ERROR: 500;
48
+ readonly NOT_IMPLEMENTED: 501;
49
+ readonly BAD_GATEWAY: 502;
50
+ readonly SERVICE_UNAVAILABLE: 503;
51
+ }>;
52
+ }>;
53
+ export type HttpStatusCode = (typeof SUCCESS)[keyof typeof SUCCESS] | (typeof REDIRECTION)[keyof typeof REDIRECTION] | (typeof CLIENT_ERROR)[keyof typeof CLIENT_ERROR] | (typeof SERVER_ERROR)[keyof typeof SERVER_ERROR];
54
+ export {};
@@ -0,0 +1,34 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.HTTP_STATUS = void 0;
4
+ const SUCCESS = Object.freeze({
5
+ OK: 200,
6
+ CREATED: 201,
7
+ ACCEPTED: 202,
8
+ NO_CONTENT: 204,
9
+ });
10
+ const REDIRECTION = Object.freeze({
11
+ NOT_MODIFIED: 304,
12
+ });
13
+ const CLIENT_ERROR = Object.freeze({
14
+ BAD_REQUEST: 400,
15
+ UNAUTHORIZED: 401,
16
+ FORBIDDEN: 403,
17
+ NOT_FOUND: 404,
18
+ METHOD_NOT_ALLOWED: 405,
19
+ CONFLICT: 409,
20
+ UNPROCESSABLE_ENTITY: 422,
21
+ TOO_MANY_REQUESTS: 429,
22
+ });
23
+ const SERVER_ERROR = Object.freeze({
24
+ INTERNAL_SERVER_ERROR: 500,
25
+ NOT_IMPLEMENTED: 501,
26
+ BAD_GATEWAY: 502,
27
+ SERVICE_UNAVAILABLE: 503,
28
+ });
29
+ exports.HTTP_STATUS = Object.freeze({
30
+ SUCCESS,
31
+ REDIRECTION,
32
+ CLIENT_ERROR,
33
+ SERVER_ERROR,
34
+ });
@@ -0,0 +1,31 @@
1
+ import { type ResponderConfig } from './config';
2
+ import type { PaginationMeta, ResponseEnvelope, Sender } from './types';
3
+ export declare class BaseResponder<P = unknown, M = PaginationMeta> {
4
+ protected readonly cfg: ResponderConfig;
5
+ protected sender?: Sender;
6
+ constructor(cfg?: Partial<ResponderConfig>, sender?: Sender);
7
+ attachSender(sender: Sender): void;
8
+ protected normalizeError(err: unknown): {
9
+ message: string;
10
+ code?: string;
11
+ details?: unknown;
12
+ };
13
+ protected buildEnvelope(data?: P, message?: string, error?: unknown, meta?: M): ResponseEnvelope<P, M>;
14
+ protected send(status: number, envelope: ResponseEnvelope<P, M>): any;
15
+ /** -----------------------------
16
+ * Standard REST Response Helpers
17
+ * ----------------------------- */
18
+ ok(data?: P, message?: string): any;
19
+ created(data?: P, message?: string): any;
20
+ noContent(message?: string): any;
21
+ badRequest(message?: string, error?: unknown): any;
22
+ unauthorized(message?: string): any;
23
+ forbidden(message?: string): any;
24
+ notFound(message?: string): any;
25
+ conflict(message?: string): any;
26
+ unprocessableEntity(message?: string, error?: unknown): any;
27
+ tooManyRequests(message?: string): any;
28
+ serverError(message?: string, error?: unknown): any;
29
+ paginate(data: P[], page: number, limit: number, total: number, message?: string): any;
30
+ paginateOffset(data: P[], offset: number, limit: number, total: number, message?: string): any;
31
+ }
@@ -0,0 +1,100 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BaseResponder = void 0;
4
+ const httpStatus_1 = require("../constants/httpStatus");
5
+ const config_1 = require("./config");
6
+ class BaseResponder {
7
+ constructor(cfg, sender) {
8
+ this.cfg = { ...config_1.defaultConfig, ...(cfg ?? {}) };
9
+ this.sender = sender;
10
+ }
11
+ attachSender(sender) {
12
+ this.sender = sender;
13
+ }
14
+ normalizeError(err) {
15
+ if (err instanceof Error)
16
+ return { message: err.message, code: err.code };
17
+ if (typeof err === 'string')
18
+ return { message: err };
19
+ return { message: 'Unknown error', details: err };
20
+ }
21
+ buildEnvelope(data, message, error, meta) {
22
+ const env = {
23
+ success: !error,
24
+ message: message ?? (error ? 'Error' : undefined),
25
+ data: error ? undefined : data,
26
+ error: error ? this.normalizeError(error) : null,
27
+ meta: meta ?? null,
28
+ };
29
+ if (this.cfg.timestamp) {
30
+ env.meta = {
31
+ ...(env.meta ?? {}),
32
+ timestamp: new Date().toISOString(),
33
+ };
34
+ }
35
+ if (this.cfg.extra) {
36
+ Object.assign(env, this.cfg.extra);
37
+ }
38
+ return env;
39
+ }
40
+ send(status, envelope) {
41
+ if (!this.sender)
42
+ return { status, body: envelope };
43
+ return this.sender(status, envelope);
44
+ }
45
+ /** -----------------------------
46
+ * Standard REST Response Helpers
47
+ * ----------------------------- */
48
+ ok(data, message = 'Success') {
49
+ return this.send(httpStatus_1.HTTP_STATUS.SUCCESS.OK, this.buildEnvelope(data, message));
50
+ }
51
+ created(data, message = 'Created successfully') {
52
+ return this.send(httpStatus_1.HTTP_STATUS.SUCCESS.CREATED, this.buildEnvelope(data, message));
53
+ }
54
+ noContent(message = 'No Content') {
55
+ return this.send(httpStatus_1.HTTP_STATUS.SUCCESS.NO_CONTENT, this.buildEnvelope(undefined, message));
56
+ }
57
+ badRequest(message = 'Bad request', error) {
58
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST, this.buildEnvelope(undefined, message, error));
59
+ }
60
+ unauthorized(message = 'Unauthorized') {
61
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED, this.buildEnvelope(undefined, message));
62
+ }
63
+ forbidden(message = 'Forbidden') {
64
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.FORBIDDEN, this.buildEnvelope(undefined, message));
65
+ }
66
+ notFound(message = 'Not found') {
67
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.NOT_FOUND, this.buildEnvelope(undefined, message));
68
+ }
69
+ conflict(message = 'Conflict') {
70
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.CONFLICT, this.buildEnvelope(undefined, message));
71
+ }
72
+ unprocessableEntity(message = 'Unprocessable Entity', error) {
73
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY, this.buildEnvelope(undefined, message, error));
74
+ }
75
+ tooManyRequests(message = 'Too Many Requests') {
76
+ return this.send(httpStatus_1.HTTP_STATUS.CLIENT_ERROR.TOO_MANY_REQUESTS, this.buildEnvelope(undefined, message));
77
+ }
78
+ serverError(message = 'Internal server error', error) {
79
+ return this.send(httpStatus_1.HTTP_STATUS.SERVER_ERROR.INTERNAL_SERVER_ERROR, this.buildEnvelope(undefined, message, error));
80
+ }
81
+ paginate(data, page, limit, total, message = 'Success') {
82
+ const totalPages = Math.max(1, Math.ceil(total / limit));
83
+ const offset = (page - 1) * limit;
84
+ const pagination = {
85
+ page,
86
+ limit,
87
+ total,
88
+ totalPages,
89
+ offset,
90
+ hasNext: page < totalPages,
91
+ hasPrev: page > 1,
92
+ };
93
+ return this.send(httpStatus_1.HTTP_STATUS.SUCCESS.OK, this.buildEnvelope(data, message, undefined, pagination));
94
+ }
95
+ paginateOffset(data, offset, limit, total, message = 'Success') {
96
+ const page = Math.floor(offset / limit) + 1;
97
+ return this.paginate(data, page, limit, total, message);
98
+ }
99
+ }
100
+ exports.BaseResponder = BaseResponder;
@@ -0,0 +1,15 @@
1
+ import type { PlainObject } from './types';
2
+ export type EnvelopeKeys = {
3
+ success?: string;
4
+ message?: string;
5
+ data?: string;
6
+ error?: string;
7
+ meta?: string;
8
+ };
9
+ export type ResponderConfig = {
10
+ envelopeKeys?: EnvelopeKeys;
11
+ defaultStatus?: number;
12
+ timestamp?: boolean;
13
+ extra?: PlainObject | null;
14
+ };
15
+ export declare const defaultConfig: ResponderConfig;
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.defaultConfig = void 0;
4
+ exports.defaultConfig = {
5
+ envelopeKeys: {
6
+ success: 'success',
7
+ message: 'message',
8
+ data: 'data',
9
+ error: 'error',
10
+ meta: 'meta',
11
+ },
12
+ defaultStatus: 200,
13
+ timestamp: false,
14
+ extra: null,
15
+ };
@@ -0,0 +1,3 @@
1
+ import { ExpressResponder } from '../adapters/express/ExpressResponder';
2
+ import type { ResponderConfig } from './config';
3
+ export declare const createResponderFactory: (cfg?: Partial<ResponderConfig>) => <P = unknown, _M = Record<string, unknown>>(res: import("express").Response) => ExpressResponder<P>;
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createResponderFactory = void 0;
4
+ const ExpressResponder_1 = require("../adapters/express/ExpressResponder");
5
+ const createResponderFactory = (cfg) => {
6
+ return (res) => {
7
+ return new ExpressResponder_1.ExpressResponder(cfg, res);
8
+ };
9
+ };
10
+ exports.createResponderFactory = createResponderFactory;