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