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.
- package/biome.json +53 -0
- package/organize-imports.sh +87 -0
- package/package.json +25 -8
- package/packages/cache/README.md +791 -0
- package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.d.ts +18 -0
- package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.js +173 -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 +331 -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 +383 -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 +147 -0
- package/packages/cache/dist/cjs/core/factory.d.ts +16 -0
- package/packages/cache/dist/cjs/core/factory.js +82 -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 +12 -0
- package/packages/cache/dist/cjs/errors/CacheError.js +12 -0
- package/packages/cache/dist/cjs/errors/cacheErrorCodes.d.ts +22 -0
- package/packages/cache/dist/cjs/errors/cacheErrorCodes.js +24 -0
- package/packages/cache/dist/cjs/errors/index.d.ts +1 -0
- package/packages/cache/dist/cjs/errors/index.js +8 -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 +217 -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 +18 -0
- package/packages/cache/dist/esm/adapters/memcache/MemcacheCache.js +166 -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 +327 -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 +379 -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 +143 -0
- package/packages/cache/dist/esm/core/factory.d.ts +16 -0
- package/packages/cache/dist/esm/core/factory.js +78 -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 +12 -0
- package/packages/cache/dist/esm/errors/CacheError.js +8 -0
- package/packages/cache/dist/esm/errors/cacheErrorCodes.d.ts +22 -0
- package/packages/cache/dist/esm/errors/cacheErrorCodes.js +21 -0
- package/packages/cache/dist/esm/errors/index.d.ts +1 -0
- package/packages/cache/dist/esm/errors/index.js +4 -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 +213 -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 +18 -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 +12 -0
- package/packages/cache/dist/types/errors/cacheErrorCodes.d.ts +22 -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 +52 -0
- package/packages/cache/src/adapters/memcache/MemcacheCache.ts +179 -0
- package/packages/cache/src/adapters/memcache/index.ts +1 -0
- package/packages/cache/src/adapters/memory/MemoryCache.ts +354 -0
- package/packages/cache/src/adapters/memory/index.ts +1 -0
- package/packages/cache/src/adapters/redis/RedisCache.ts +404 -0
- package/packages/cache/src/adapters/redis/index.ts +1 -0
- package/packages/cache/src/core/BaseCache.ts +176 -0
- package/packages/cache/src/core/factory.ts +103 -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 +21 -0
- package/packages/cache/src/errors/cacheErrorCodes.ts +24 -0
- package/packages/cache/src/errors/index.ts +6 -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 +197 -0
- package/packages/errors-utils/dist/cjs/constants/errorCodes.d.ts +37 -0
- package/packages/errors-utils/dist/cjs/constants/errorCodes.js +69 -0
- package/packages/errors-utils/dist/cjs/constants/errorMessages.d.ts +9 -0
- package/packages/errors-utils/dist/cjs/constants/errorMessages.js +77 -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/ServiceUnavailableError.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/error/ServiceUnavailableError.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 +4 -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/error/index.d.ts +14 -0
- package/packages/errors-utils/dist/cjs/error/index.js +39 -0
- package/packages/errors-utils/dist/cjs/errorRegistry/errorRegistry.d.ts +19 -0
- package/packages/errors-utils/dist/cjs/errorRegistry/errorRegistry.js +63 -0
- package/packages/errors-utils/dist/cjs/errorRegistry/index.d.ts +3 -0
- package/packages/errors-utils/dist/cjs/errorRegistry/index.js +6 -0
- package/packages/errors-utils/dist/cjs/index.d.ts +4 -0
- package/packages/errors-utils/dist/cjs/index.js +29 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorConverter.middleware.js +39 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/cjs/middleware/express/errorHandler.middleware.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/esm/constants/errorCodes.d.ts +37 -0
- package/packages/errors-utils/dist/esm/constants/errorCodes.js +66 -0
- package/packages/errors-utils/dist/esm/constants/errorMessages.d.ts +9 -0
- package/packages/errors-utils/dist/esm/constants/errorMessages.js +74 -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/ServiceUnavailableError.d.ts +4 -0
- package/packages/errors-utils/dist/esm/error/ServiceUnavailableError.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 +4 -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/error/index.d.ts +14 -0
- package/packages/errors-utils/dist/esm/error/index.js +23 -0
- package/packages/errors-utils/dist/esm/errorRegistry/errorRegistry.d.ts +19 -0
- package/packages/errors-utils/dist/esm/errorRegistry/errorRegistry.js +59 -0
- package/packages/errors-utils/dist/esm/errorRegistry/index.d.ts +3 -0
- package/packages/errors-utils/dist/esm/errorRegistry/index.js +3 -0
- package/packages/errors-utils/dist/esm/index.d.ts +4 -0
- package/packages/errors-utils/dist/esm/index.js +13 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorConverter.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorConverter.middleware.js +36 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorHandler.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/esm/middleware/express/errorHandler.middleware.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/types/constants/errorCodes.d.ts +37 -0
- package/packages/errors-utils/dist/types/constants/errorMessages.d.ts +9 -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/ServiceUnavailableError.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 +4 -0
- package/packages/errors-utils/dist/types/error/ValidationError.d.ts +4 -0
- package/packages/errors-utils/dist/types/error/index.d.ts +14 -0
- package/packages/errors-utils/dist/types/errorRegistry/errorRegistry.d.ts +19 -0
- package/packages/errors-utils/dist/types/errorRegistry/index.d.ts +3 -0
- package/packages/errors-utils/dist/types/index.d.ts +4 -0
- package/packages/errors-utils/dist/types/middleware/express/errorConverter.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/types/middleware/express/errorHandler.middleware.d.ts +2 -0
- package/packages/errors-utils/dist/types/middleware/express/index.d.ts +2 -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 +78 -0
- package/packages/errors-utils/src/constants/errorMessages.ts +94 -0
- package/packages/errors-utils/src/constants/index.ts +2 -0
- package/packages/errors-utils/src/error/AppError.ts +36 -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/ServiceUnavailableError.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/error/index.ts +26 -0
- package/packages/errors-utils/src/errorRegistry/errorRegistry.ts +74 -0
- package/packages/errors-utils/src/errorRegistry/index.ts +4 -0
- package/packages/errors-utils/src/index.ts +13 -0
- package/packages/errors-utils/src/middleware/express/errorConverter.middleware.ts +52 -0
- package/packages/errors-utils/src/middleware/express/errorHandler.middleware.ts +32 -0
- package/packages/errors-utils/src/middleware/express/index.ts +2 -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 +218 -0
- package/packages/js-extensions/dist/cjs/array/array-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/array/array-extensions.js +154 -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 +17 -0
- package/packages/js-extensions/dist/cjs/core/performance.js +82 -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/core/version.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/core/version.js +9 -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 +61 -0
- package/packages/js-extensions/dist/cjs/index.js +77 -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 +125 -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 +146 -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 +123 -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 +72 -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/defineExtension.d.ts +1 -0
- package/packages/js-extensions/dist/cjs/utils/defineExtension.js +13 -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 +3 -0
- package/packages/js-extensions/dist/cjs/utils/index.js +20 -0
- package/packages/js-extensions/dist/esm/array/array-extensions.d.ts +1 -0
- package/packages/js-extensions/dist/esm/array/array-extensions.js +151 -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 +17 -0
- package/packages/js-extensions/dist/esm/core/performance.js +74 -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/core/version.d.ts +1 -0
- package/packages/js-extensions/dist/esm/core/version.js +5 -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 +61 -0
- package/packages/js-extensions/dist/esm/index.js +68 -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 +122 -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 +143 -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 +120 -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 +72 -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/defineExtension.d.ts +1 -0
- package/packages/js-extensions/dist/esm/utils/defineExtension.js +10 -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 +3 -0
- package/packages/js-extensions/dist/esm/utils/index.js +4 -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 +17 -0
- package/packages/js-extensions/dist/types/core/validation.d.ts +4 -0
- package/packages/js-extensions/dist/types/core/version.d.ts +1 -0
- package/packages/js-extensions/dist/types/extensions/index.d.ts +4 -0
- package/packages/js-extensions/dist/types/index.d.ts +61 -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 +72 -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/defineExtension.d.ts +1 -0
- package/packages/js-extensions/dist/types/utils/helpers.d.ts +5 -0
- package/packages/js-extensions/dist/types/utils/index.d.ts +3 -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 +48 -0
- package/packages/js-extensions/src/array/array-extensions.ts +292 -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 +103 -0
- package/packages/js-extensions/src/core/validation.ts +42 -0
- package/packages/js-extensions/src/core/version.ts +7 -0
- package/packages/js-extensions/src/extensions/index.ts +5 -0
- package/packages/js-extensions/src/index.ts +122 -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 +129 -0
- package/packages/js-extensions/src/object/index.ts +1 -0
- package/packages/js-extensions/src/object/object-extensions.ts +143 -0
- package/packages/js-extensions/src/string/index.ts +1 -0
- package/packages/js-extensions/src/string/string-extensions.ts +142 -0
- package/packages/js-extensions/src/types/extension-types.ts +12 -0
- package/packages/js-extensions/src/types/global-augmentations.ts +81 -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/defineExtension.ts +14 -0
- package/packages/js-extensions/src/utils/helpers.ts +35 -0
- package/packages/js-extensions/src/utils/index.ts +4 -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 +189 -95
- 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 +116 -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 +8 -0
- package/packages/response-utils/dist/cjs/index.js +32 -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 +112 -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 +8 -0
- package/packages/response-utils/dist/esm/index.js +10 -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 +8 -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 +198 -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 +13 -168
- 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 +298 -86
- package/packages/security/dist/cjs/core/crypto/cryptoManager.d.ts +111 -0
- package/packages/security/dist/cjs/core/crypto/cryptoManager.js +208 -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 +28 -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 +37 -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 +43 -0
- package/packages/security/dist/cjs/core/jwt/jwtManager.js +188 -0
- package/packages/security/dist/cjs/core/jwt/parseDuration.d.ts +1 -0
- package/packages/security/dist/cjs/core/jwt/parseDuration.js +30 -0
- package/packages/security/dist/cjs/core/jwt/signToken.d.ts +2 -0
- package/packages/security/dist/cjs/core/jwt/signToken.js +27 -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 +16 -0
- package/packages/security/dist/cjs/core/jwt/validateToken.js +46 -0
- package/packages/security/dist/cjs/core/jwt/verify.d.ts +18 -0
- package/packages/security/dist/cjs/core/jwt/verify.js +89 -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 +212 -0
- package/packages/security/dist/cjs/core/password/strength.d.ts +2 -0
- package/packages/security/dist/cjs/core/password/strength.js +27 -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 +16 -0
- package/packages/security/dist/cjs/core/password/utils.js +53 -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 +40 -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 +203 -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 +24 -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 +32 -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 +43 -0
- package/packages/security/dist/esm/core/jwt/jwtManager.js +181 -0
- package/packages/security/dist/esm/core/jwt/parseDuration.d.ts +1 -0
- package/packages/security/dist/esm/core/jwt/parseDuration.js +27 -0
- package/packages/security/dist/esm/core/jwt/signToken.d.ts +2 -0
- package/packages/security/dist/esm/core/jwt/signToken.js +23 -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 +16 -0
- package/packages/security/dist/esm/core/jwt/validateToken.js +42 -0
- package/packages/security/dist/esm/core/jwt/verify.d.ts +18 -0
- package/packages/security/dist/esm/core/jwt/verify.js +82 -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 +205 -0
- package/packages/security/dist/esm/core/password/strength.d.ts +2 -0
- package/packages/security/dist/esm/core/password/strength.js +23 -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 +16 -0
- package/packages/security/dist/esm/core/password/utils.js +44 -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 +40 -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 +43 -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 +16 -0
- package/packages/security/dist/types/core/jwt/verify.d.ts +18 -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 +16 -0
- package/packages/security/dist/types/core/password/verify.d.ts +10 -0
- package/packages/security/dist/types/index.d.ts +40 -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 +324 -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 +28 -0
- package/packages/security/src/core/jwt/extractToken.ts +59 -0
- package/packages/security/src/core/jwt/generateTokens.ts +51 -0
- package/packages/security/src/core/jwt/index.ts +8 -0
- package/packages/security/src/core/jwt/jwtManager.ts +233 -0
- package/packages/security/src/core/jwt/parseDuration.ts +34 -0
- package/packages/security/src/core/jwt/signToken.ts +32 -0
- package/packages/security/src/core/jwt/types.ts +29 -0
- package/packages/security/src/core/jwt/validateToken.ts +60 -0
- package/packages/security/src/core/jwt/verify.ts +117 -0
- package/packages/security/src/core/password/hash.ts +46 -0
- package/packages/security/src/core/password/index.ts +3 -0
- package/packages/security/src/core/password/passwordManager.ts +244 -0
- package/packages/security/src/core/password/strength.ts +40 -0
- package/packages/security/src/core/password/types.ts +7 -0
- package/packages/security/src/core/password/utils.ts +47 -0
- package/packages/security/src/core/password/verify.ts +49 -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 +6 -0
- package/packages/server-utils/dist/cjs/middleware/auth.middleware.js +44 -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 +47 -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 +6 -0
- package/packages/server-utils/dist/esm/middleware/auth.middleware.js +41 -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 +44 -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 +6 -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 +79 -0
- package/packages/server-utils/src/middleware/cache.middleware.ts +68 -0
- package/packages/server-utils/src/middleware/errorHandler.middleware.ts +59 -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 +69 -0
- package/packages/server-utils/src/middleware/validation.middleware.ts +100 -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
|
@@ -1,110 +1,204 @@
|
|
|
1
1
|
# @naman_deep_singh/response-utils
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Version:** 2.1.4
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
A flexible, framework-agnostic **TypeScript response utility library** for building consistent, typed, and configurable API responses.
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
27
|
-
|
|
28
|
-
|
|
185
|
+
🔗 Integration with Other Packages
|
|
186
|
+
With @naman_deep_singh/server-utils
|
|
187
|
+
import { responderMiddleware } from '@naman_deep_singh/response-utils'
|
|
29
188
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
189
|
+
server.app.use(responderMiddleware())
|
|
190
|
+
With @naman_deep_singh/errors-utils
|
|
191
|
+
import { expressErrorHandler } from '@naman_deep_singh/errors-utils'
|
|
33
192
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
```
|
|
193
|
+
server.app.use(expressErrorHandler)
|
|
194
|
+
Provides consistent error responses across services.
|
|
37
195
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
import ResponseUtils from '@naman_deep_singh/response-utils';
|
|
196
|
+
🔜 Roadmap
|
|
197
|
+
Fastify adapter
|
|
41
198
|
|
|
42
|
-
|
|
43
|
-
```
|
|
199
|
+
Hono adapter
|
|
44
200
|
|
|
45
|
-
|
|
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
|
-
|
|
51
|
-
|
|
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
|
+
}
|