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.
- package/biome.json +53 -0
- package/organize-imports.sh +87 -0
- package/package.json +25 -8
- package/packages/cache/README.md +695 -0
- package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.d.ts +71 -0
- package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.js +379 -0
- package/packages/cache/dist/cjs/adapters/memcache/index.d.ts +1 -0
- package/packages/cache/dist/cjs/adapters/memcache/index.js +5 -0
- package/packages/cache/dist/cjs/adapters/memory/MemoryCache.d.ts +63 -0
- package/packages/cache/dist/cjs/adapters/memory/MemoryCache.js +277 -0
- package/packages/cache/dist/cjs/adapters/memory/index.d.ts +1 -0
- package/packages/cache/dist/cjs/adapters/memory/index.js +5 -0
- package/packages/cache/dist/cjs/adapters/redis/RedisCache.d.ts +67 -0
- package/packages/cache/dist/cjs/adapters/redis/RedisCache.js +325 -0
- package/packages/cache/dist/cjs/adapters/redis/index.d.ts +1 -0
- package/packages/cache/dist/cjs/adapters/redis/index.js +5 -0
- package/packages/cache/dist/cjs/core/BaseCache.d.ts +78 -0
- package/packages/cache/dist/cjs/core/BaseCache.js +138 -0
- package/packages/cache/dist/cjs/core/factory.d.ts +16 -0
- package/packages/cache/dist/cjs/core/factory.js +60 -0
- package/packages/cache/dist/cjs/core/interfaces/ICache.d.ts +58 -0
- package/packages/cache/dist/cjs/core/interfaces/ICache.js +2 -0
- package/packages/cache/dist/cjs/core/interfaces/ISession.d.ts +30 -0
- package/packages/cache/dist/cjs/core/interfaces/ISession.js +2 -0
- package/packages/cache/dist/cjs/core/interfaces/index.d.ts +2 -0
- package/packages/cache/dist/cjs/core/interfaces/index.js +2 -0
- package/packages/cache/dist/cjs/errors/CacheError.d.ts +9 -0
- package/packages/cache/dist/cjs/errors/CacheError.js +17 -0
- package/packages/cache/dist/cjs/errors/index.d.ts +1 -0
- package/packages/cache/dist/cjs/errors/index.js +5 -0
- package/packages/cache/dist/cjs/index.d.ts +10 -0
- package/packages/cache/dist/cjs/index.js +27 -0
- package/packages/cache/dist/cjs/middleware/express/cacheMiddleware.d.ts +22 -0
- package/packages/cache/dist/cjs/middleware/express/cacheMiddleware.js +116 -0
- package/packages/cache/dist/cjs/middleware/express/index.d.ts +1 -0
- package/packages/cache/dist/cjs/middleware/express/index.js +7 -0
- package/packages/cache/dist/cjs/session/SessionStore.d.ts +57 -0
- package/packages/cache/dist/cjs/session/SessionStore.js +161 -0
- package/packages/cache/dist/cjs/session/index.d.ts +2 -0
- package/packages/cache/dist/cjs/session/index.js +5 -0
- package/packages/cache/dist/cjs/types.d.ts +102 -0
- package/packages/cache/dist/cjs/types.js +2 -0
- package/packages/cache/dist/esm/adapters/memcache/MemcacheCache.d.ts +71 -0
- package/packages/cache/dist/esm/adapters/memcache/MemcacheCache.js +372 -0
- package/packages/cache/dist/esm/adapters/memcache/index.d.ts +1 -0
- package/packages/cache/dist/esm/adapters/memcache/index.js +1 -0
- package/packages/cache/dist/esm/adapters/memory/MemoryCache.d.ts +63 -0
- package/packages/cache/dist/esm/adapters/memory/MemoryCache.js +273 -0
- package/packages/cache/dist/esm/adapters/memory/index.d.ts +1 -0
- package/packages/cache/dist/esm/adapters/memory/index.js +1 -0
- package/packages/cache/dist/esm/adapters/redis/RedisCache.d.ts +67 -0
- package/packages/cache/dist/esm/adapters/redis/RedisCache.js +321 -0
- package/packages/cache/dist/esm/adapters/redis/index.d.ts +1 -0
- package/packages/cache/dist/esm/adapters/redis/index.js +1 -0
- package/packages/cache/dist/esm/core/BaseCache.d.ts +78 -0
- package/packages/cache/dist/esm/core/BaseCache.js +134 -0
- package/packages/cache/dist/esm/core/factory.d.ts +16 -0
- package/packages/cache/dist/esm/core/factory.js +56 -0
- package/packages/cache/dist/esm/core/interfaces/ICache.d.ts +58 -0
- package/packages/cache/dist/esm/core/interfaces/ICache.js +1 -0
- package/packages/cache/dist/esm/core/interfaces/ISession.d.ts +30 -0
- package/packages/cache/dist/esm/core/interfaces/ISession.js +1 -0
- package/packages/cache/dist/esm/core/interfaces/index.d.ts +2 -0
- package/packages/cache/dist/esm/core/interfaces/index.js +1 -0
- package/packages/cache/dist/esm/errors/CacheError.d.ts +9 -0
- package/packages/cache/dist/esm/errors/CacheError.js +13 -0
- package/packages/cache/dist/esm/errors/index.d.ts +1 -0
- package/packages/cache/dist/esm/errors/index.js +1 -0
- package/packages/cache/dist/esm/index.d.ts +10 -0
- package/packages/cache/dist/esm/index.js +14 -0
- package/packages/cache/dist/esm/middleware/express/cacheMiddleware.d.ts +22 -0
- package/packages/cache/dist/esm/middleware/express/cacheMiddleware.js +111 -0
- package/packages/cache/dist/esm/middleware/express/index.d.ts +1 -0
- package/packages/cache/dist/esm/middleware/express/index.js +1 -0
- package/packages/cache/dist/esm/session/SessionStore.d.ts +57 -0
- package/packages/cache/dist/esm/session/SessionStore.js +157 -0
- package/packages/cache/dist/esm/session/index.d.ts +2 -0
- package/packages/cache/dist/esm/session/index.js +1 -0
- package/packages/cache/dist/esm/types.d.ts +102 -0
- package/packages/cache/dist/esm/types.js +1 -0
- package/packages/cache/dist/types/adapters/memcache/MemcacheCache.d.ts +71 -0
- package/packages/cache/dist/types/adapters/memcache/index.d.ts +1 -0
- package/packages/cache/dist/types/adapters/memory/MemoryCache.d.ts +63 -0
- package/packages/cache/dist/types/adapters/memory/index.d.ts +1 -0
- package/packages/cache/dist/types/adapters/redis/RedisCache.d.ts +67 -0
- package/packages/cache/dist/types/adapters/redis/index.d.ts +1 -0
- package/packages/cache/dist/types/core/BaseCache.d.ts +78 -0
- package/packages/cache/dist/types/core/factory.d.ts +16 -0
- package/packages/cache/dist/types/core/interfaces/ICache.d.ts +58 -0
- package/packages/cache/dist/types/core/interfaces/ISession.d.ts +30 -0
- package/packages/cache/dist/types/core/interfaces/index.d.ts +2 -0
- package/packages/cache/dist/types/errors/CacheError.d.ts +9 -0
- package/packages/cache/dist/types/errors/index.d.ts +1 -0
- package/packages/cache/dist/types/index.d.ts +10 -0
- package/packages/cache/dist/types/middleware/express/cacheMiddleware.d.ts +22 -0
- package/packages/cache/dist/types/middleware/express/index.d.ts +1 -0
- package/packages/cache/dist/types/session/SessionStore.d.ts +57 -0
- package/packages/cache/dist/types/session/index.d.ts +2 -0
- package/packages/cache/dist/types/types.d.ts +102 -0
- package/packages/cache/node_modules/.bin/rimraf +21 -0
- package/packages/cache/node_modules/.bin/tsc +21 -0
- package/packages/cache/node_modules/.bin/tsserver +21 -0
- package/packages/cache/package.json +50 -0
- package/packages/cache/src/adapters/memcache/MemcacheCache.ts +452 -0
- package/packages/cache/src/adapters/memcache/index.ts +1 -0
- package/packages/cache/src/adapters/memory/MemoryCache.ts +355 -0
- package/packages/cache/src/adapters/memory/index.ts +1 -0
- package/packages/cache/src/adapters/redis/RedisCache.ts +406 -0
- package/packages/cache/src/adapters/redis/index.ts +1 -0
- package/packages/cache/src/core/BaseCache.ts +177 -0
- package/packages/cache/src/core/factory.ts +92 -0
- package/packages/cache/src/core/interfaces/ICache.ts +71 -0
- package/packages/cache/src/core/interfaces/ISession.ts +36 -0
- package/packages/cache/src/core/interfaces/index.ts +2 -0
- package/packages/cache/src/errors/CacheError.ts +22 -0
- package/packages/cache/src/errors/index.ts +1 -0
- package/packages/cache/src/index.ts +40 -0
- package/packages/cache/src/middleware/express/cacheMiddleware.ts +145 -0
- package/packages/cache/src/middleware/express/index.ts +5 -0
- package/packages/cache/src/session/SessionStore.ts +236 -0
- package/packages/cache/src/session/index.ts +2 -0
- package/packages/cache/src/types.ts +111 -0
- package/packages/cache/tsconfig.base.json +17 -0
- package/packages/cache/tsconfig.cjs.json +10 -0
- package/packages/cache/tsconfig.esm.json +10 -0
- package/packages/errors-utils/README.md +200 -0
- package/packages/errors-utils/dist/cjs/constants/errorCodes.d.ts +32 -0
- package/packages/errors-utils/dist/cjs/constants/errorCodes.js +34 -0
- package/packages/errors-utils/dist/cjs/constants/errorMessages.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/constants/errorMessages.js +34 -0
- package/packages/errors-utils/dist/cjs/constants/index.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/constants/index.js +18 -0
- package/packages/errors-utils/dist/cjs/error/AppError.d.ts +15 -0
- package/packages/errors-utils/dist/cjs/error/AppError.js +26 -0
- package/packages/errors-utils/dist/cjs/error/BadRequestError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/BadRequestError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/ConflictError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/ConflictError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/CryptoIntegrityError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/CryptoIntegrityError.js +11 -0
- package/packages/errors-utils/dist/cjs/error/ForbiddenError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/ForbiddenError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/HTTPError.d.ts +6 -0
- package/packages/errors-utils/dist/cjs/error/HTTPError.js +11 -0
- package/packages/errors-utils/dist/cjs/error/InternalServerError.d.ts +5 -0
- package/packages/errors-utils/dist/cjs/error/InternalServerError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/NotFoundError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/NotFoundError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/RateLimitError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/RateLimitError.js +11 -0
- package/packages/errors-utils/dist/cjs/error/TokenExpiredError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/TokenExpiredError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/TokenMalformedError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/TokenMalformedError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/TooManyRequestsError.d.ts +5 -0
- package/packages/errors-utils/dist/cjs/error/TooManyRequestsError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/UnauthorizedError.d.ts +5 -0
- package/packages/errors-utils/dist/cjs/error/UnauthorizedError.js +12 -0
- package/packages/errors-utils/dist/cjs/error/ValidationError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/ValidationError.js +12 -0
- package/packages/errors-utils/dist/cjs/index.d.ts +10 -0
- package/packages/errors-utils/dist/cjs/index.js +26 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.js +39 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.js +19 -0
- package/packages/errors-utils/dist/cjs/middleware/express/index.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/middleware/express/index.js +18 -0
- package/packages/errors-utils/dist/cjs/utils/mapAppErrorToResponder.d.ts +3 -0
- package/packages/errors-utils/dist/cjs/utils/mapAppErrorToResponder.js +27 -0
- package/packages/errors-utils/dist/esm/constants/errorCodes.d.ts +32 -0
- package/packages/errors-utils/dist/esm/constants/errorCodes.js +31 -0
- package/packages/errors-utils/dist/esm/constants/errorMessages.d.ts +2 -0
- package/packages/errors-utils/dist/esm/constants/errorMessages.js +31 -0
- package/packages/errors-utils/dist/esm/constants/index.d.ts +2 -0
- package/packages/errors-utils/dist/esm/constants/index.js +2 -0
- package/packages/errors-utils/dist/esm/error/AppError.d.ts +15 -0
- package/packages/errors-utils/dist/esm/error/AppError.js +22 -0
- package/packages/errors-utils/dist/esm/error/BadRequestError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/BadRequestError.js +8 -0
- package/packages/errors-utils/dist/esm/error/ConflictError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/ConflictError.js +8 -0
- package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.js +7 -0
- package/packages/errors-utils/dist/esm/error/ForbiddenError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/ForbiddenError.js +8 -0
- package/packages/errors-utils/dist/esm/error/HTTPError.d.ts +6 -0
- package/packages/errors-utils/dist/esm/error/HTTPError.js +7 -0
- package/packages/errors-utils/dist/esm/error/InternalServerError.d.ts +5 -0
- package/packages/errors-utils/dist/esm/error/InternalServerError.js +8 -0
- package/packages/errors-utils/dist/esm/error/NotFoundError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/NotFoundError.js +8 -0
- package/packages/errors-utils/dist/esm/error/RateLimitError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/RateLimitError.js +7 -0
- package/packages/errors-utils/dist/esm/error/TokenExpiredError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/TokenExpiredError.js +8 -0
- package/packages/errors-utils/dist/esm/error/TokenMalformedError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/TokenMalformedError.js +8 -0
- package/packages/errors-utils/dist/esm/error/TooManyRequestsError.d.ts +5 -0
- package/packages/errors-utils/dist/esm/error/TooManyRequestsError.js +8 -0
- package/packages/errors-utils/dist/esm/error/UnauthorizedError.d.ts +5 -0
- package/packages/errors-utils/dist/esm/error/UnauthorizedError.js +8 -0
- package/packages/errors-utils/dist/esm/error/ValidationError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/ValidationError.js +8 -0
- package/packages/errors-utils/dist/esm/index.d.ts +10 -0
- package/packages/errors-utils/dist/esm/index.js +10 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorConverter.d.ts +2 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorConverter.js +36 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorHandler.d.ts +2 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorHandler.js +16 -0
- package/packages/errors-utils/dist/esm/middleware/express/index.d.ts +2 -0
- package/packages/errors-utils/dist/esm/middleware/express/index.js +2 -0
- package/packages/errors-utils/dist/esm/utils/mapAppErrorToResponder.d.ts +3 -0
- package/packages/errors-utils/dist/esm/utils/mapAppErrorToResponder.js +24 -0
- package/packages/errors-utils/dist/types/constants/errorCodes.d.ts +32 -0
- package/packages/errors-utils/dist/types/constants/errorMessages.d.ts +2 -0
- package/packages/errors-utils/dist/types/constants/index.d.ts +2 -0
- package/packages/errors-utils/dist/types/error/AppError.d.ts +15 -0
- package/packages/errors-utils/dist/types/error/BadRequestError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/ConflictError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/CryptoIntegrityError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/ForbiddenError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/HTTPError.d.ts +6 -0
- package/packages/errors-utils/dist/types/error/InternalServerError.d.ts +5 -0
- package/packages/errors-utils/dist/types/error/NotFoundError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/RateLimitError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/TokenExpiredError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/TokenMalformedError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/TooManyRequestsError.d.ts +5 -0
- package/packages/errors-utils/dist/types/error/UnauthorizedError.d.ts +5 -0
- package/packages/errors-utils/dist/types/error/ValidationError.d.ts +4 -0
- package/packages/errors-utils/dist/types/index.d.ts +10 -0
- package/packages/errors-utils/dist/types/middleware/express/errorConverter.d.ts +2 -0
- package/packages/errors-utils/dist/types/middleware/express/errorHandler.d.ts +2 -0
- package/packages/errors-utils/dist/types/middleware/express/index.d.ts +2 -0
- package/packages/errors-utils/dist/types/utils/mapAppErrorToResponder.d.ts +3 -0
- package/packages/errors-utils/node_modules/.bin/rimraf +21 -0
- package/packages/errors-utils/node_modules/.bin/tsc +21 -0
- package/packages/errors-utils/node_modules/.bin/tsserver +21 -0
- package/packages/errors-utils/package.json +42 -0
- package/packages/errors-utils/src/constants/errorCodes.ts +37 -0
- package/packages/errors-utils/src/constants/errorMessages.ts +37 -0
- package/packages/errors-utils/src/constants/index.ts +2 -0
- package/packages/errors-utils/src/error/AppError.ts +35 -0
- package/packages/errors-utils/src/error/BadRequestError.ts +14 -0
- package/packages/errors-utils/src/error/ConflictError.ts +14 -0
- package/packages/errors-utils/src/error/CryptoIntegrityError.ts +8 -0
- package/packages/errors-utils/src/error/ForbiddenError.ts +14 -0
- package/packages/errors-utils/src/error/HTTPError.ts +17 -0
- package/packages/errors-utils/src/error/InternalServerError.ts +18 -0
- package/packages/errors-utils/src/error/NotFoundError.ts +14 -0
- package/packages/errors-utils/src/error/RateLimitError.ts +8 -0
- package/packages/errors-utils/src/error/TokenExpiredError.ts +14 -0
- package/packages/errors-utils/src/error/TokenMalformedError.ts +14 -0
- package/packages/errors-utils/src/error/TooManyRequestsError.ts +13 -0
- package/packages/errors-utils/src/error/UnauthorizedError.ts +14 -0
- package/packages/errors-utils/src/error/ValidationError.ts +14 -0
- package/packages/errors-utils/src/index.ts +11 -0
- package/packages/errors-utils/src/middleware/express/errorConverter.ts +52 -0
- package/packages/errors-utils/src/middleware/express/errorHandler.ts +32 -0
- package/packages/errors-utils/src/middleware/express/index.ts +2 -0
- package/packages/errors-utils/src/utils/mapAppErrorToResponder.ts +38 -0
- package/packages/errors-utils/tsconfig.base.json +17 -0
- package/packages/errors-utils/tsconfig.cjs.json +9 -0
- package/packages/errors-utils/tsconfig.esm.json +9 -0
- package/packages/errors-utils/tsconfig.json +21 -0
- package/packages/js-extensions/README.md +469 -0
- package/packages/js-extensions/dist/cjs/array/array-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/array/array-extensions.js +120 -0
- package/packages/js-extensions/dist/cjs/array/index.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/array/index.js +5 -0
- package/packages/js-extensions/dist/cjs/core/index.d.ts +2 -0
- package/packages/js-extensions/dist/cjs/core/index.js +19 -0
- package/packages/js-extensions/dist/cjs/core/performance.d.ts +16 -0
- package/packages/js-extensions/dist/cjs/core/performance.js +76 -0
- package/packages/js-extensions/dist/cjs/core/validation.d.ts +4 -0
- package/packages/js-extensions/dist/cjs/core/validation.js +31 -0
- package/packages/js-extensions/dist/cjs/extensions/index.d.ts +4 -0
- package/packages/js-extensions/dist/cjs/extensions/index.js +21 -0
- package/packages/js-extensions/dist/cjs/index.d.ts +60 -0
- package/packages/js-extensions/dist/cjs/index.js +76 -0
- package/packages/js-extensions/dist/cjs/init/index.d.ts +2 -0
- package/packages/js-extensions/dist/cjs/init/index.js +19 -0
- package/packages/js-extensions/dist/cjs/init/initializer.d.ts +3 -0
- package/packages/js-extensions/dist/cjs/init/initializer.js +28 -0
- package/packages/js-extensions/dist/cjs/init/options.d.ts +3 -0
- package/packages/js-extensions/dist/cjs/init/options.js +23 -0
- package/packages/js-extensions/dist/cjs/number/index.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/number/index.js +5 -0
- package/packages/js-extensions/dist/cjs/number/number-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/number/number-extensions.js +137 -0
- package/packages/js-extensions/dist/cjs/object/index.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/object/index.js +5 -0
- package/packages/js-extensions/dist/cjs/object/object-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/object/object-extensions.js +147 -0
- package/packages/js-extensions/dist/cjs/string/index.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/string/index.js +5 -0
- package/packages/js-extensions/dist/cjs/string/string-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/string/string-extensions.js +100 -0
- package/packages/js-extensions/dist/cjs/types/extension-types.d.ts +9 -0
- package/packages/js-extensions/dist/cjs/types/extension-types.js +2 -0
- package/packages/js-extensions/dist/cjs/types/global-augmentations.d.ts +71 -0
- package/packages/js-extensions/dist/cjs/types/global-augmentations.js +2 -0
- package/packages/js-extensions/dist/cjs/types/index.d.ts +2 -0
- package/packages/js-extensions/dist/cjs/types/index.js +19 -0
- package/packages/js-extensions/dist/cjs/utils/config.d.ts +4 -0
- package/packages/js-extensions/dist/cjs/utils/config.js +25 -0
- package/packages/js-extensions/dist/cjs/utils/helpers.d.ts +5 -0
- package/packages/js-extensions/dist/cjs/utils/helpers.js +37 -0
- package/packages/js-extensions/dist/cjs/utils/index.d.ts +2 -0
- package/packages/js-extensions/dist/cjs/utils/index.js +19 -0
- package/packages/js-extensions/dist/esm/array/array-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/esm/array/array-extensions.js +117 -0
- package/packages/js-extensions/dist/esm/array/index.d.ts +1 -0
- package/packages/js-extensions/dist/esm/array/index.js +1 -0
- package/packages/js-extensions/dist/esm/core/index.d.ts +2 -0
- package/packages/js-extensions/dist/esm/core/index.js +3 -0
- package/packages/js-extensions/dist/esm/core/performance.d.ts +16 -0
- package/packages/js-extensions/dist/esm/core/performance.js +69 -0
- package/packages/js-extensions/dist/esm/core/validation.d.ts +4 -0
- package/packages/js-extensions/dist/esm/core/validation.js +25 -0
- package/packages/js-extensions/dist/esm/extensions/index.d.ts +4 -0
- package/packages/js-extensions/dist/esm/extensions/index.js +5 -0
- package/packages/js-extensions/dist/esm/index.d.ts +60 -0
- package/packages/js-extensions/dist/esm/index.js +67 -0
- package/packages/js-extensions/dist/esm/init/index.d.ts +2 -0
- package/packages/js-extensions/dist/esm/init/index.js +3 -0
- package/packages/js-extensions/dist/esm/init/initializer.d.ts +3 -0
- package/packages/js-extensions/dist/esm/init/initializer.js +24 -0
- package/packages/js-extensions/dist/esm/init/options.d.ts +3 -0
- package/packages/js-extensions/dist/esm/init/options.js +19 -0
- package/packages/js-extensions/dist/esm/number/index.d.ts +1 -0
- package/packages/js-extensions/dist/esm/number/index.js +1 -0
- package/packages/js-extensions/dist/esm/number/number-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/esm/number/number-extensions.js +134 -0
- package/packages/js-extensions/dist/esm/object/index.d.ts +1 -0
- package/packages/js-extensions/dist/esm/object/index.js +1 -0
- package/packages/js-extensions/dist/esm/object/object-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/esm/object/object-extensions.js +144 -0
- package/packages/js-extensions/dist/esm/string/index.d.ts +1 -0
- package/packages/js-extensions/dist/esm/string/index.js +1 -0
- package/packages/js-extensions/dist/esm/string/string-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/esm/string/string-extensions.js +97 -0
- package/packages/js-extensions/dist/esm/types/extension-types.d.ts +9 -0
- package/packages/js-extensions/dist/esm/types/extension-types.js +1 -0
- package/packages/js-extensions/dist/esm/types/global-augmentations.d.ts +71 -0
- package/packages/js-extensions/dist/esm/types/global-augmentations.js +1 -0
- package/packages/js-extensions/dist/esm/types/index.d.ts +2 -0
- package/packages/js-extensions/dist/esm/types/index.js +3 -0
- package/packages/js-extensions/dist/esm/utils/config.d.ts +4 -0
- package/packages/js-extensions/dist/esm/utils/config.js +20 -0
- package/packages/js-extensions/dist/esm/utils/helpers.d.ts +5 -0
- package/packages/js-extensions/dist/esm/utils/helpers.js +30 -0
- package/packages/js-extensions/dist/esm/utils/index.d.ts +2 -0
- package/packages/js-extensions/dist/esm/utils/index.js +3 -0
- package/packages/js-extensions/dist/types/array/array-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/types/array/index.d.ts +1 -0
- package/packages/js-extensions/dist/types/core/index.d.ts +2 -0
- package/packages/js-extensions/dist/types/core/performance.d.ts +16 -0
- package/packages/js-extensions/dist/types/core/validation.d.ts +4 -0
- package/packages/js-extensions/dist/types/extensions/index.d.ts +4 -0
- package/packages/js-extensions/dist/types/index.d.ts +60 -0
- package/packages/js-extensions/dist/types/init/index.d.ts +2 -0
- package/packages/js-extensions/dist/types/init/initializer.d.ts +3 -0
- package/packages/js-extensions/dist/types/init/options.d.ts +3 -0
- package/packages/js-extensions/dist/types/number/index.d.ts +1 -0
- package/packages/js-extensions/dist/types/number/number-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/types/object/index.d.ts +1 -0
- package/packages/js-extensions/dist/types/object/object-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/types/string/index.d.ts +1 -0
- package/packages/js-extensions/dist/types/string/string-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/types/types/extension-types.d.ts +9 -0
- package/packages/js-extensions/dist/types/types/global-augmentations.d.ts +71 -0
- package/packages/js-extensions/dist/types/types/index.d.ts +2 -0
- package/packages/js-extensions/dist/types/utils/config.d.ts +4 -0
- package/packages/js-extensions/dist/types/utils/helpers.d.ts +5 -0
- package/packages/js-extensions/dist/types/utils/index.d.ts +2 -0
- package/packages/js-extensions/node_modules/.bin/rimraf +21 -0
- package/packages/js-extensions/node_modules/.bin/tsc +21 -0
- package/packages/js-extensions/node_modules/.bin/tsserver +21 -0
- package/packages/js-extensions/package.json +44 -0
- package/packages/js-extensions/src/array/array-extensions.ts +174 -0
- package/packages/js-extensions/src/array/index.ts +1 -0
- package/packages/js-extensions/src/core/index.ts +3 -0
- package/packages/js-extensions/src/core/performance.ts +92 -0
- package/packages/js-extensions/src/core/validation.ts +42 -0
- package/packages/js-extensions/src/extensions/index.ts +5 -0
- package/packages/js-extensions/src/index.ts +120 -0
- package/packages/js-extensions/src/init/index.ts +3 -0
- package/packages/js-extensions/src/init/initializer.ts +32 -0
- package/packages/js-extensions/src/init/options.ts +32 -0
- package/packages/js-extensions/src/number/index.ts +1 -0
- package/packages/js-extensions/src/number/number-extensions.ts +162 -0
- package/packages/js-extensions/src/object/index.ts +1 -0
- package/packages/js-extensions/src/object/object-extensions.ts +171 -0
- package/packages/js-extensions/src/string/index.ts +1 -0
- package/packages/js-extensions/src/string/string-extensions.ts +138 -0
- package/packages/js-extensions/src/types/extension-types.ts +12 -0
- package/packages/js-extensions/src/types/global-augmentations.ts +80 -0
- package/packages/js-extensions/src/types/index.ts +3 -0
- package/packages/js-extensions/src/utils/config.ts +33 -0
- package/packages/js-extensions/src/utils/helpers.ts +35 -0
- package/packages/js-extensions/src/utils/index.ts +3 -0
- package/packages/js-extensions/tsconfig.base.json +18 -0
- package/packages/js-extensions/tsconfig.cjs.json +9 -0
- package/packages/js-extensions/tsconfig.esm.json +9 -0
- package/packages/js-extensions/tsconfig.json +22 -0
- package/packages/response-utils/README.md +211 -75
- package/packages/response-utils/dist/cjs/adapters/express/ExpressResponder.d.ts +18 -0
- package/packages/response-utils/dist/cjs/adapters/express/ExpressResponder.js +46 -0
- package/packages/response-utils/dist/cjs/constants/httpStatus.d.ts +54 -0
- package/packages/response-utils/dist/cjs/constants/httpStatus.js +34 -0
- package/packages/response-utils/dist/cjs/core/BaseResponder.d.ts +31 -0
- package/packages/response-utils/dist/cjs/core/BaseResponder.js +100 -0
- package/packages/response-utils/dist/cjs/core/config.d.ts +15 -0
- package/packages/response-utils/dist/cjs/core/config.js +15 -0
- package/packages/response-utils/dist/cjs/core/factory.d.ts +3 -0
- package/packages/response-utils/dist/cjs/core/factory.js +10 -0
- package/packages/response-utils/dist/cjs/core/types.d.ts +32 -0
- package/packages/response-utils/dist/cjs/core/types.js +2 -0
- package/packages/response-utils/dist/cjs/index.d.ts +9 -0
- package/packages/response-utils/dist/cjs/index.js +56 -0
- package/packages/response-utils/dist/cjs/legacy.d.ts +19 -0
- package/packages/response-utils/dist/cjs/legacy.js +23 -0
- package/packages/response-utils/dist/cjs/middleware/express/expressMiddleware.d.ts +3 -0
- package/packages/response-utils/dist/cjs/middleware/express/expressMiddleware.js +13 -0
- package/packages/response-utils/dist/esm/adapters/express/ExpressResponder.d.ts +18 -0
- package/packages/response-utils/dist/esm/adapters/express/ExpressResponder.js +42 -0
- package/packages/response-utils/dist/esm/constants/httpStatus.d.ts +54 -0
- package/packages/response-utils/dist/esm/constants/httpStatus.js +31 -0
- package/packages/response-utils/dist/esm/core/BaseResponder.d.ts +31 -0
- package/packages/response-utils/dist/esm/core/BaseResponder.js +96 -0
- package/packages/response-utils/dist/esm/core/config.d.ts +15 -0
- package/packages/response-utils/dist/esm/core/config.js +12 -0
- package/packages/response-utils/dist/esm/core/factory.d.ts +3 -0
- package/packages/response-utils/dist/esm/core/factory.js +6 -0
- package/packages/response-utils/dist/esm/core/types.d.ts +32 -0
- package/packages/response-utils/dist/esm/core/types.js +1 -0
- package/packages/response-utils/dist/esm/index.d.ts +9 -0
- package/packages/response-utils/dist/esm/index.js +12 -0
- package/packages/response-utils/dist/esm/legacy.d.ts +19 -0
- package/packages/response-utils/dist/esm/legacy.js +18 -0
- package/packages/response-utils/dist/esm/middleware/express/expressMiddleware.d.ts +3 -0
- package/packages/response-utils/dist/esm/middleware/express/expressMiddleware.js +9 -0
- package/packages/response-utils/dist/types/adapters/express/ExpressResponder.d.ts +18 -0
- package/packages/response-utils/dist/types/constants/httpStatus.d.ts +54 -0
- package/packages/response-utils/dist/types/core/BaseResponder.d.ts +31 -0
- package/packages/response-utils/dist/types/core/config.d.ts +15 -0
- package/packages/response-utils/dist/types/core/factory.d.ts +3 -0
- package/packages/response-utils/dist/types/core/types.d.ts +32 -0
- package/packages/response-utils/dist/types/index.d.ts +9 -0
- package/packages/response-utils/dist/types/legacy.d.ts +19 -0
- package/packages/response-utils/dist/types/middleware/express/expressMiddleware.d.ts +3 -0
- package/packages/response-utils/node_modules/.bin/rimraf +21 -0
- package/packages/response-utils/node_modules/.bin/tsc +21 -0
- package/packages/response-utils/node_modules/.bin/tsserver +21 -0
- package/packages/response-utils/package.json +38 -10
- package/packages/response-utils/src/adapters/express/ExpressResponder.ts +64 -0
- package/packages/response-utils/src/constants/httpStatus.ts +42 -0
- package/packages/response-utils/src/core/BaseResponder.ts +177 -0
- package/packages/response-utils/src/core/config.ts +29 -0
- package/packages/response-utils/src/core/factory.ts +11 -0
- package/packages/response-utils/src/core/types.ts +34 -0
- package/packages/response-utils/src/index.ts +16 -168
- package/packages/response-utils/src/legacy.ts +30 -0
- package/packages/response-utils/src/middleware/express/expressMiddleware.ts +14 -0
- package/packages/response-utils/tsconfig.base.json +11 -0
- package/packages/response-utils/tsconfig.cjs.json +9 -0
- package/packages/response-utils/tsconfig.esm.json +9 -0
- package/packages/security/README.md +485 -71
- package/packages/security/dist/cjs/core/crypto/cryptoManager.d.ts +111 -0
- package/packages/security/dist/cjs/core/crypto/cryptoManager.js +191 -0
- package/packages/security/dist/cjs/core/crypto/decrypt.d.ts +1 -0
- package/packages/security/dist/cjs/core/crypto/decrypt.js +21 -0
- package/packages/security/dist/cjs/core/crypto/encrypt.d.ts +1 -0
- package/packages/security/dist/cjs/core/crypto/encrypt.js +16 -0
- package/packages/security/dist/cjs/core/crypto/hmac.d.ts +8 -0
- package/packages/security/dist/cjs/core/crypto/hmac.js +24 -0
- package/packages/security/dist/cjs/core/crypto/index.d.ts +5 -0
- package/packages/security/dist/cjs/core/crypto/index.js +28 -0
- package/packages/security/dist/cjs/core/crypto/random.d.ts +8 -0
- package/packages/security/dist/cjs/core/crypto/random.js +21 -0
- package/packages/security/dist/cjs/core/jwt/decode.d.ts +12 -0
- package/packages/security/dist/cjs/core/jwt/decode.js +25 -0
- package/packages/security/dist/cjs/core/jwt/extractToken.d.ts +11 -0
- package/packages/security/dist/cjs/core/jwt/extractToken.js +54 -0
- package/packages/security/dist/cjs/core/jwt/generateTokens.d.ts +4 -0
- package/packages/security/dist/cjs/core/jwt/generateTokens.js +34 -0
- package/packages/security/dist/cjs/core/jwt/index.d.ts +8 -0
- package/packages/security/dist/cjs/core/jwt/index.js +24 -0
- package/packages/security/dist/cjs/core/jwt/jwtManager.d.ts +67 -0
- package/packages/security/dist/cjs/core/jwt/jwtManager.js +303 -0
- package/packages/security/dist/cjs/core/jwt/parseDuration.d.ts +1 -0
- package/packages/security/dist/cjs/core/jwt/parseDuration.js +29 -0
- package/packages/security/dist/cjs/core/jwt/signToken.d.ts +2 -0
- package/packages/security/dist/cjs/core/jwt/signToken.js +26 -0
- package/packages/security/dist/cjs/core/jwt/types.d.ts +22 -0
- package/packages/security/dist/cjs/core/jwt/types.js +2 -0
- package/packages/security/dist/cjs/core/jwt/validateToken.d.ts +13 -0
- package/packages/security/dist/cjs/core/jwt/validateToken.js +37 -0
- package/packages/security/dist/cjs/core/jwt/verify.d.ts +19 -0
- package/packages/security/dist/cjs/core/jwt/verify.js +44 -0
- package/packages/security/dist/cjs/core/password/hash.d.ts +10 -0
- package/packages/security/dist/cjs/core/password/hash.js +45 -0
- package/packages/security/dist/cjs/core/password/index.d.ts +3 -0
- package/packages/security/dist/cjs/core/password/index.js +19 -0
- package/packages/security/dist/cjs/core/password/passwordManager.d.ts +29 -0
- package/packages/security/dist/cjs/core/password/passwordManager.js +256 -0
- package/packages/security/dist/cjs/core/password/strength.d.ts +2 -0
- package/packages/security/dist/cjs/core/password/strength.js +21 -0
- package/packages/security/dist/cjs/core/password/types.d.ts +7 -0
- package/packages/security/dist/cjs/core/password/types.js +2 -0
- package/packages/security/dist/cjs/core/password/utils.d.ts +4 -0
- package/packages/security/dist/cjs/core/password/utils.js +38 -0
- package/packages/security/dist/cjs/core/password/verify.d.ts +10 -0
- package/packages/security/dist/cjs/core/password/verify.js +46 -0
- package/packages/security/dist/cjs/index.d.ts +45 -0
- package/packages/security/dist/cjs/index.js +56 -0
- package/packages/security/dist/cjs/interfaces/jwt.interface.d.ts +47 -0
- package/packages/security/dist/cjs/interfaces/jwt.interface.js +2 -0
- package/packages/security/dist/cjs/interfaces/password.interface.d.ts +60 -0
- package/packages/security/dist/cjs/interfaces/password.interface.js +2 -0
- package/packages/security/dist/esm/core/crypto/cryptoManager.d.ts +111 -0
- package/packages/security/dist/esm/core/crypto/cryptoManager.js +186 -0
- package/packages/security/dist/esm/core/crypto/decrypt.d.ts +1 -0
- package/packages/security/dist/esm/core/crypto/decrypt.js +14 -0
- package/packages/security/dist/esm/core/crypto/encrypt.d.ts +1 -0
- package/packages/security/dist/esm/core/crypto/encrypt.js +9 -0
- package/packages/security/dist/esm/core/crypto/hmac.d.ts +8 -0
- package/packages/security/dist/esm/core/crypto/hmac.js +16 -0
- package/packages/security/dist/esm/core/crypto/index.d.ts +5 -0
- package/packages/security/dist/esm/core/crypto/index.js +5 -0
- package/packages/security/dist/esm/core/crypto/random.d.ts +8 -0
- package/packages/security/dist/esm/core/crypto/random.js +13 -0
- package/packages/security/dist/esm/core/jwt/decode.d.ts +12 -0
- package/packages/security/dist/esm/core/jwt/decode.js +21 -0
- package/packages/security/dist/esm/core/jwt/extractToken.d.ts +11 -0
- package/packages/security/dist/esm/core/jwt/extractToken.js +51 -0
- package/packages/security/dist/esm/core/jwt/generateTokens.d.ts +4 -0
- package/packages/security/dist/esm/core/jwt/generateTokens.js +29 -0
- package/packages/security/dist/esm/core/jwt/index.d.ts +8 -0
- package/packages/security/dist/esm/core/jwt/index.js +8 -0
- package/packages/security/dist/esm/core/jwt/jwtManager.d.ts +67 -0
- package/packages/security/dist/esm/core/jwt/jwtManager.js +296 -0
- package/packages/security/dist/esm/core/jwt/parseDuration.d.ts +1 -0
- package/packages/security/dist/esm/core/jwt/parseDuration.js +26 -0
- package/packages/security/dist/esm/core/jwt/signToken.d.ts +2 -0
- package/packages/security/dist/esm/core/jwt/signToken.js +22 -0
- package/packages/security/dist/esm/core/jwt/types.d.ts +22 -0
- package/packages/security/dist/esm/core/jwt/types.js +1 -0
- package/packages/security/dist/esm/core/jwt/validateToken.d.ts +13 -0
- package/packages/security/dist/esm/core/jwt/validateToken.js +33 -0
- package/packages/security/dist/esm/core/jwt/verify.d.ts +19 -0
- package/packages/security/dist/esm/core/jwt/verify.js +37 -0
- package/packages/security/dist/esm/core/password/hash.d.ts +10 -0
- package/packages/security/dist/esm/core/password/hash.js +35 -0
- package/packages/security/dist/esm/core/password/index.d.ts +3 -0
- package/packages/security/dist/esm/core/password/index.js +3 -0
- package/packages/security/dist/esm/core/password/passwordManager.d.ts +29 -0
- package/packages/security/dist/esm/core/password/passwordManager.js +249 -0
- package/packages/security/dist/esm/core/password/strength.d.ts +2 -0
- package/packages/security/dist/esm/core/password/strength.js +17 -0
- package/packages/security/dist/esm/core/password/types.d.ts +7 -0
- package/packages/security/dist/esm/core/password/types.js +1 -0
- package/packages/security/dist/esm/core/password/utils.d.ts +4 -0
- package/packages/security/dist/esm/core/password/utils.js +29 -0
- package/packages/security/dist/esm/core/password/verify.d.ts +10 -0
- package/packages/security/dist/esm/core/password/verify.js +36 -0
- package/packages/security/dist/esm/index.d.ts +45 -0
- package/packages/security/dist/esm/index.js +13 -0
- package/packages/security/dist/esm/interfaces/jwt.interface.d.ts +47 -0
- package/packages/security/dist/esm/interfaces/jwt.interface.js +1 -0
- package/packages/security/dist/esm/interfaces/password.interface.d.ts +60 -0
- package/packages/security/dist/esm/interfaces/password.interface.js +1 -0
- package/packages/security/dist/types/core/crypto/cryptoManager.d.ts +111 -0
- package/packages/security/dist/types/core/crypto/decrypt.d.ts +1 -0
- package/packages/security/dist/types/core/crypto/encrypt.d.ts +1 -0
- package/packages/security/dist/types/core/crypto/hmac.d.ts +8 -0
- package/packages/security/dist/types/core/crypto/index.d.ts +5 -0
- package/packages/security/dist/types/core/crypto/random.d.ts +8 -0
- package/packages/security/dist/types/core/jwt/decode.d.ts +12 -0
- package/packages/security/dist/types/core/jwt/extractToken.d.ts +11 -0
- package/packages/security/dist/types/core/jwt/generateTokens.d.ts +4 -0
- package/packages/security/dist/types/core/jwt/index.d.ts +8 -0
- package/packages/security/dist/types/core/jwt/jwtManager.d.ts +67 -0
- package/packages/security/dist/types/core/jwt/parseDuration.d.ts +1 -0
- package/packages/security/dist/types/core/jwt/signToken.d.ts +2 -0
- package/packages/security/dist/types/core/jwt/types.d.ts +22 -0
- package/packages/security/dist/types/core/jwt/validateToken.d.ts +13 -0
- package/packages/security/dist/types/core/jwt/verify.d.ts +19 -0
- package/packages/security/dist/types/core/password/hash.d.ts +10 -0
- package/packages/security/dist/types/core/password/index.d.ts +3 -0
- package/packages/security/dist/types/core/password/passwordManager.d.ts +29 -0
- package/packages/security/dist/types/core/password/strength.d.ts +2 -0
- package/packages/security/dist/types/core/password/types.d.ts +7 -0
- package/packages/security/dist/types/core/password/utils.d.ts +4 -0
- package/packages/security/dist/types/core/password/verify.d.ts +10 -0
- package/packages/security/dist/types/index.d.ts +45 -0
- package/packages/security/dist/types/interfaces/jwt.interface.d.ts +47 -0
- package/packages/security/dist/types/interfaces/password.interface.d.ts +60 -0
- package/packages/security/node_modules/.bin/bcrypt +21 -0
- package/packages/security/node_modules/.bin/rimraf +21 -0
- package/packages/security/node_modules/.bin/tsc +21 -0
- package/packages/security/node_modules/.bin/tsserver +21 -0
- package/packages/security/package.json +23 -4
- package/packages/security/src/core/crypto/cryptoManager.ts +292 -0
- package/packages/security/src/core/crypto/decrypt.ts +20 -0
- package/packages/security/src/core/crypto/encrypt.ts +14 -0
- package/packages/security/src/core/crypto/hmac.ts +23 -0
- package/packages/security/src/core/crypto/index.ts +5 -0
- package/packages/security/src/core/crypto/random.ts +15 -0
- package/packages/security/src/core/jwt/decode.ts +25 -0
- package/packages/security/src/core/jwt/extractToken.ts +59 -0
- package/packages/security/src/core/jwt/generateTokens.ts +48 -0
- package/packages/security/src/core/jwt/index.ts +8 -0
- package/packages/security/src/core/jwt/jwtManager.ts +385 -0
- package/packages/security/src/core/jwt/parseDuration.ts +32 -0
- package/packages/security/src/core/jwt/signToken.ts +31 -0
- package/packages/security/src/core/jwt/types.ts +29 -0
- package/packages/security/src/core/jwt/validateToken.ts +52 -0
- package/packages/security/src/core/jwt/verify.ts +55 -0
- package/packages/security/src/core/password/hash.ts +40 -0
- package/packages/security/src/core/password/index.ts +3 -0
- package/packages/security/src/core/password/passwordManager.ts +314 -0
- package/packages/security/src/core/password/strength.ts +35 -0
- package/packages/security/src/core/password/types.ts +7 -0
- package/packages/security/src/core/password/utils.ts +31 -0
- package/packages/security/src/core/password/verify.ts +47 -0
- package/packages/security/src/index.ts +21 -39
- package/packages/security/src/interfaces/jwt.interface.ts +58 -0
- package/packages/security/src/interfaces/password.interface.ts +54 -0
- package/packages/security/tsconfig.base.json +17 -0
- package/packages/security/tsconfig.cjs.json +9 -0
- package/packages/security/tsconfig.esm.json +9 -0
- package/packages/server-utils/README.md +412 -49
- package/packages/server-utils/dist/cjs/core/health.d.ts +5 -0
- package/packages/server-utils/dist/cjs/core/health.js +45 -0
- package/packages/server-utils/dist/cjs/core/periodic-health.d.ts +11 -0
- package/packages/server-utils/dist/cjs/core/periodic-health.js +68 -0
- package/packages/server-utils/dist/cjs/core/server.d.ts +73 -0
- package/packages/server-utils/dist/cjs/core/server.js +437 -0
- package/packages/server-utils/dist/cjs/core/shutdown.d.ts +5 -0
- package/packages/server-utils/dist/cjs/core/shutdown.js +58 -0
- package/packages/server-utils/dist/cjs/index.d.ts +46 -0
- package/packages/server-utils/dist/cjs/index.js +91 -0
- package/packages/server-utils/dist/cjs/middleware/auth.middleware.d.ts +7 -0
- package/packages/server-utils/dist/cjs/middleware/auth.middleware.js +41 -0
- package/packages/server-utils/dist/cjs/middleware/cache.middleware.d.ts +2 -0
- package/packages/server-utils/dist/cjs/middleware/cache.middleware.js +58 -0
- package/packages/server-utils/dist/cjs/middleware/errorHandler.middleware.d.ts +2 -0
- package/packages/server-utils/dist/cjs/middleware/errorHandler.middleware.js +30 -0
- package/packages/server-utils/dist/cjs/middleware/index.d.ts +10 -0
- package/packages/server-utils/dist/cjs/middleware/index.js +40 -0
- package/packages/server-utils/dist/cjs/middleware/logging.middleware.d.ts +2 -0
- package/packages/server-utils/dist/cjs/middleware/logging.middleware.js +19 -0
- package/packages/server-utils/dist/cjs/middleware/plugins.middleware.d.ts +14 -0
- package/packages/server-utils/dist/cjs/middleware/plugins.middleware.js +58 -0
- package/packages/server-utils/dist/cjs/middleware/rateLimiter.middleware.d.ts +8 -0
- package/packages/server-utils/dist/cjs/middleware/rateLimiter.middleware.js +35 -0
- package/packages/server-utils/dist/cjs/middleware/requestId.middleware.d.ts +2 -0
- package/packages/server-utils/dist/cjs/middleware/requestId.middleware.js +12 -0
- package/packages/server-utils/dist/cjs/middleware/session.middleware.d.ts +2 -0
- package/packages/server-utils/dist/cjs/middleware/session.middleware.js +53 -0
- package/packages/server-utils/dist/cjs/middleware/validation.middleware.d.ts +11 -0
- package/packages/server-utils/dist/cjs/middleware/validation.middleware.js +67 -0
- package/packages/server-utils/dist/cjs/types/index.d.ts +87 -0
- package/packages/server-utils/dist/cjs/types/index.js +2 -0
- package/packages/server-utils/dist/cjs/utils/utils.d.ts +3 -0
- package/packages/server-utils/dist/cjs/utils/utils.js +43 -0
- package/packages/server-utils/dist/esm/core/health.d.ts +5 -0
- package/packages/server-utils/dist/esm/core/health.js +40 -0
- package/packages/server-utils/dist/esm/core/periodic-health.d.ts +11 -0
- package/packages/server-utils/dist/esm/core/periodic-health.js +64 -0
- package/packages/server-utils/dist/esm/core/server.d.ts +73 -0
- package/packages/server-utils/dist/esm/core/server.js +396 -0
- package/packages/server-utils/dist/esm/core/shutdown.d.ts +5 -0
- package/packages/server-utils/dist/esm/core/shutdown.js +53 -0
- package/packages/server-utils/dist/esm/index.d.ts +46 -0
- package/packages/server-utils/dist/esm/index.js +58 -0
- package/packages/server-utils/dist/esm/middleware/auth.middleware.d.ts +7 -0
- package/packages/server-utils/dist/esm/middleware/auth.middleware.js +38 -0
- package/packages/server-utils/dist/esm/middleware/cache.middleware.d.ts +2 -0
- package/packages/server-utils/dist/esm/middleware/cache.middleware.js +55 -0
- package/packages/server-utils/dist/esm/middleware/errorHandler.middleware.d.ts +2 -0
- package/packages/server-utils/dist/esm/middleware/errorHandler.middleware.js +27 -0
- package/packages/server-utils/dist/esm/middleware/index.d.ts +10 -0
- package/packages/server-utils/dist/esm/middleware/index.js +20 -0
- package/packages/server-utils/dist/esm/middleware/logging.middleware.d.ts +2 -0
- package/packages/server-utils/dist/esm/middleware/logging.middleware.js +16 -0
- package/packages/server-utils/dist/esm/middleware/plugins.middleware.d.ts +14 -0
- package/packages/server-utils/dist/esm/middleware/plugins.middleware.js +47 -0
- package/packages/server-utils/dist/esm/middleware/rateLimiter.middleware.d.ts +8 -0
- package/packages/server-utils/dist/esm/middleware/rateLimiter.middleware.js +32 -0
- package/packages/server-utils/dist/esm/middleware/requestId.middleware.d.ts +2 -0
- package/packages/server-utils/dist/esm/middleware/requestId.middleware.js +9 -0
- package/packages/server-utils/dist/esm/middleware/session.middleware.d.ts +2 -0
- package/packages/server-utils/dist/esm/middleware/session.middleware.js +50 -0
- package/packages/server-utils/dist/esm/middleware/validation.middleware.d.ts +11 -0
- package/packages/server-utils/dist/esm/middleware/validation.middleware.js +64 -0
- package/packages/server-utils/dist/esm/types/index.d.ts +87 -0
- package/packages/server-utils/dist/esm/types/index.js +1 -0
- package/packages/server-utils/dist/esm/utils/utils.d.ts +3 -0
- package/packages/server-utils/dist/esm/utils/utils.js +38 -0
- package/packages/server-utils/dist/types/core/health.d.ts +5 -0
- package/packages/server-utils/dist/types/core/periodic-health.d.ts +11 -0
- package/packages/server-utils/dist/types/core/server.d.ts +73 -0
- package/packages/server-utils/dist/types/core/shutdown.d.ts +5 -0
- package/packages/server-utils/dist/types/index.d.ts +46 -0
- package/packages/server-utils/dist/types/middleware/auth.middleware.d.ts +7 -0
- package/packages/server-utils/dist/types/middleware/cache.middleware.d.ts +2 -0
- package/packages/server-utils/dist/types/middleware/errorHandler.middleware.d.ts +2 -0
- package/packages/server-utils/dist/types/middleware/index.d.ts +10 -0
- package/packages/server-utils/dist/types/middleware/logging.middleware.d.ts +2 -0
- package/packages/server-utils/dist/types/middleware/plugins.middleware.d.ts +14 -0
- package/packages/server-utils/dist/types/middleware/rateLimiter.middleware.d.ts +8 -0
- package/packages/server-utils/dist/types/middleware/requestId.middleware.d.ts +2 -0
- package/packages/server-utils/dist/types/middleware/session.middleware.d.ts +2 -0
- package/packages/server-utils/dist/types/middleware/validation.middleware.d.ts +11 -0
- package/packages/server-utils/dist/types/types/index.d.ts +87 -0
- package/packages/server-utils/dist/types/utils/utils.d.ts +3 -0
- package/packages/server-utils/node_modules/.bin/rimraf +21 -0
- package/packages/server-utils/node_modules/.bin/tsc +21 -0
- package/packages/server-utils/node_modules/.bin/tsserver +21 -0
- package/packages/server-utils/package.json +30 -6
- package/packages/server-utils/src/core/health.ts +58 -0
- package/packages/server-utils/src/core/periodic-health.ts +88 -0
- package/packages/server-utils/src/core/server.ts +650 -0
- package/packages/server-utils/src/core/shutdown.ts +78 -0
- package/packages/server-utils/src/express-augment.d.ts +35 -0
- package/packages/server-utils/src/index.ts +132 -95
- package/packages/server-utils/src/middleware/auth.middleware.ts +66 -0
- package/packages/server-utils/src/middleware/cache.middleware.ts +68 -0
- package/packages/server-utils/src/middleware/errorHandler.middleware.ts +44 -0
- package/packages/server-utils/src/middleware/index.ts +46 -0
- package/packages/server-utils/src/middleware/logging.middleware.ts +29 -0
- package/packages/server-utils/src/middleware/plugins.middleware.ts +64 -0
- package/packages/server-utils/src/middleware/rateLimiter.middleware.ts +59 -0
- package/packages/server-utils/src/middleware/requestId.middleware.ts +16 -0
- package/packages/server-utils/src/middleware/session.middleware.ts +66 -0
- package/packages/server-utils/src/middleware/validation.middleware.ts +101 -0
- package/packages/server-utils/src/types/index.ts +114 -0
- package/packages/server-utils/src/utils/utils.ts +43 -0
- package/packages/server-utils/tsconfig.base.json +17 -0
- package/packages/server-utils/tsconfig.cjs.json +9 -0
- package/packages/server-utils/tsconfig.esm.json +9 -0
- package/packages/server-utils/src/health.ts +0 -47
- package/packages/server-utils/src/middleware.ts +0 -275
- package/packages/server-utils/src/server.ts +0 -320
- package/packages/server-utils/src/shutdown.ts +0 -60
- package/packages/server-utils/src/types.ts +0 -64
- package/packages/server-utils/src/utils.ts +0 -34
- /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
|
-
|
|
3
|
+
**Version:** 2.1.2
|
|
4
4
|
|
|
5
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
31
|
+
## 🧠 Architecture Overview
|
|
12
32
|
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
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
|
-
##
|
|
42
|
+
## 📄 Response Format (Default Envelope)
|
|
21
43
|
|
|
22
|
-
### Named Imports (Tree-shakable)
|
|
23
44
|
```typescript
|
|
24
|
-
|
|
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
|
-
|
|
27
|
-
const userResponse = success({ id: 1, name: 'John' }, 'User found');
|
|
28
|
-
const createdResponse = created({ id: 2, name: 'Jane' });
|
|
54
|
+
## 🛠️ Usage Examples
|
|
29
55
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
56
|
+
### ✔ Framework-Agnostic (no Express)
|
|
57
|
+
```typescript
|
|
58
|
+
import { BaseResponder } from '@naman_deep_singh/response-utils';
|
|
33
59
|
|
|
34
|
-
|
|
35
|
-
const
|
|
60
|
+
const r = new BaseResponder();
|
|
61
|
+
const result = r.ok({ user: "John" }, "Loaded");
|
|
62
|
+
console.log(result);
|
|
36
63
|
```
|
|
37
64
|
|
|
38
|
-
###
|
|
65
|
+
### 🌐 Express Integration
|
|
66
|
+
|
|
67
|
+
#### 1️⃣ Add Middleware
|
|
68
|
+
|
|
39
69
|
```typescript
|
|
40
|
-
import
|
|
70
|
+
import express from 'express';
|
|
71
|
+
import { responderMiddleware } from '@naman_deep_singh/response-utils';
|
|
41
72
|
|
|
42
|
-
const
|
|
73
|
+
const app = express();
|
|
74
|
+
app.use(responderMiddleware());
|
|
43
75
|
```
|
|
44
76
|
|
|
45
|
-
|
|
77
|
+
#### 2️⃣ Controller Usage
|
|
78
|
+
|
|
46
79
|
```typescript
|
|
47
|
-
|
|
48
|
-
|
|
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
|
-
|
|
86
|
+
`okAndSend()` automatically applies HTTP status + JSON response.
|
|
62
87
|
|
|
63
|
-
|
|
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
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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
|
-
|
|
82
|
-
- `logError(context: string, error: unknown)` - Structured error logging
|
|
83
|
-
- `getErrorMessage(error: unknown)` - Extract error message safely
|
|
97
|
+
Example output:
|
|
84
98
|
|
|
85
|
-
|
|
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
|
-
|
|
111
|
+
### 🔢 Pagination Support
|
|
88
112
|
|
|
89
113
|
```typescript
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
114
|
+
responder.paginateAndSend(
|
|
115
|
+
[{ id: 1 }],
|
|
116
|
+
1, // page
|
|
117
|
+
10, // limit
|
|
118
|
+
42, // total
|
|
119
|
+
"Loaded"
|
|
120
|
+
);
|
|
97
121
|
```
|
|
98
122
|
|
|
99
|
-
##
|
|
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
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
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;
|