@catbee/utils 0.0.8-rc.3 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/README.md +3 -2
  2. package/build/index.cjs +6912 -0
  3. package/build/index.d.ts +5284 -0
  4. package/build/index.mjs +6635 -0
  5. package/package.json +13 -292
  6. package/build/cjs/config.d.ts +0 -121
  7. package/build/cjs/config.js +0 -137
  8. package/build/cjs/index.d.ts +0 -26
  9. package/build/cjs/index.js +0 -68
  10. package/build/cjs/servers/server.builder.d.ts +0 -507
  11. package/build/cjs/servers/server.builder.js +0 -658
  12. package/build/cjs/servers/server.d.ts +0 -255
  13. package/build/cjs/servers/server.js +0 -970
  14. package/build/cjs/types/api-response.d.ts +0 -151
  15. package/build/cjs/types/api-response.js +0 -36
  16. package/build/cjs/types/index.d.ts +0 -124
  17. package/build/cjs/types/index.js +0 -25
  18. package/build/cjs/types/server.d.ts +0 -267
  19. package/build/cjs/types/server.js +0 -25
  20. package/build/cjs/utils/array.utils.d.ts +0 -167
  21. package/build/cjs/utils/array.utils.js +0 -363
  22. package/build/cjs/utils/async.utils.d.ts +0 -264
  23. package/build/cjs/utils/async.utils.js +0 -640
  24. package/build/cjs/utils/cache.utils.d.ts +0 -152
  25. package/build/cjs/utils/cache.utils.js +0 -298
  26. package/build/cjs/utils/context-store.utils.d.ts +0 -188
  27. package/build/cjs/utils/context-store.utils.js +0 -297
  28. package/build/cjs/utils/crypto.utils.d.ts +0 -159
  29. package/build/cjs/utils/crypto.utils.js +0 -295
  30. package/build/cjs/utils/date.utils.d.ts +0 -158
  31. package/build/cjs/utils/date.utils.js +0 -395
  32. package/build/cjs/utils/decorators.utils.d.ts +0 -511
  33. package/build/cjs/utils/decorators.utils.js +0 -1035
  34. package/build/cjs/utils/dir.utils.d.ts +0 -195
  35. package/build/cjs/utils/dir.utils.js +0 -500
  36. package/build/cjs/utils/env.utils.d.ts +0 -376
  37. package/build/cjs/utils/env.utils.js +0 -786
  38. package/build/cjs/utils/exception.utils.d.ts +0 -229
  39. package/build/cjs/utils/exception.utils.js +0 -408
  40. package/build/cjs/utils/fs.utils.d.ts +0 -163
  41. package/build/cjs/utils/fs.utils.js +0 -371
  42. package/build/cjs/utils/http-status-codes.d.ts +0 -265
  43. package/build/cjs/utils/http-status-codes.js +0 -297
  44. package/build/cjs/utils/id.utils.d.ts +0 -35
  45. package/build/cjs/utils/id.utils.js +0 -90
  46. package/build/cjs/utils/logger.utils.d.ts +0 -159
  47. package/build/cjs/utils/logger.utils.js +0 -350
  48. package/build/cjs/utils/middleware.utils.d.ts +0 -99
  49. package/build/cjs/utils/middleware.utils.js +0 -243
  50. package/build/cjs/utils/obj.utils.d.ts +0 -123
  51. package/build/cjs/utils/obj.utils.js +0 -428
  52. package/build/cjs/utils/performance.utils.d.ts +0 -135
  53. package/build/cjs/utils/performance.utils.js +0 -280
  54. package/build/cjs/utils/request.utils.d.ts +0 -85
  55. package/build/cjs/utils/request.utils.js +0 -199
  56. package/build/cjs/utils/response.utils.d.ts +0 -162
  57. package/build/cjs/utils/response.utils.js +0 -274
  58. package/build/cjs/utils/stream.utils.d.ts +0 -87
  59. package/build/cjs/utils/stream.utils.js +0 -217
  60. package/build/cjs/utils/string.utils.d.ts +0 -92
  61. package/build/cjs/utils/string.utils.js +0 -178
  62. package/build/cjs/utils/type.utils.d.ts +0 -89
  63. package/build/cjs/utils/type.utils.js +0 -195
  64. package/build/cjs/utils/url.utils.d.ts +0 -140
  65. package/build/cjs/utils/url.utils.js +0 -316
  66. package/build/cjs/utils/validate.utils.d.ts +0 -176
  67. package/build/cjs/utils/validate.utils.js +0 -344
  68. package/build/esm/config.d.ts +0 -121
  69. package/build/esm/config.js +0 -132
  70. package/build/esm/index.d.ts +0 -26
  71. package/build/esm/index.js +0 -49
  72. package/build/esm/servers/server.builder.d.ts +0 -507
  73. package/build/esm/servers/server.builder.js +0 -654
  74. package/build/esm/servers/server.d.ts +0 -255
  75. package/build/esm/servers/server.js +0 -963
  76. package/build/esm/types/api-response.d.ts +0 -151
  77. package/build/esm/types/api-response.js +0 -33
  78. package/build/esm/types/index.d.ts +0 -124
  79. package/build/esm/types/index.js +0 -24
  80. package/build/esm/types/server.d.ts +0 -267
  81. package/build/esm/types/server.js +0 -24
  82. package/build/esm/utils/array.utils.d.ts +0 -167
  83. package/build/esm/utils/array.utils.js +0 -344
  84. package/build/esm/utils/async.utils.d.ts +0 -264
  85. package/build/esm/utils/async.utils.js +0 -619
  86. package/build/esm/utils/cache.utils.d.ts +0 -152
  87. package/build/esm/utils/cache.utils.js +0 -294
  88. package/build/esm/utils/context-store.utils.d.ts +0 -188
  89. package/build/esm/utils/context-store.utils.js +0 -290
  90. package/build/esm/utils/crypto.utils.d.ts +0 -159
  91. package/build/esm/utils/crypto.utils.js +0 -278
  92. package/build/esm/utils/date.utils.d.ts +0 -158
  93. package/build/esm/utils/date.utils.js +0 -383
  94. package/build/esm/utils/decorators.utils.d.ts +0 -511
  95. package/build/esm/utils/decorators.utils.js +0 -1013
  96. package/build/esm/utils/dir.utils.d.ts +0 -195
  97. package/build/esm/utils/dir.utils.js +0 -476
  98. package/build/esm/utils/env.utils.d.ts +0 -376
  99. package/build/esm/utils/env.utils.js +0 -782
  100. package/build/esm/utils/exception.utils.d.ts +0 -229
  101. package/build/esm/utils/exception.utils.js +0 -382
  102. package/build/esm/utils/fs.utils.d.ts +0 -163
  103. package/build/esm/utils/fs.utils.js +0 -348
  104. package/build/esm/utils/http-status-codes.d.ts +0 -265
  105. package/build/esm/utils/http-status-codes.js +0 -294
  106. package/build/esm/utils/id.utils.d.ts +0 -35
  107. package/build/esm/utils/id.utils.js +0 -83
  108. package/build/esm/utils/logger.utils.d.ts +0 -159
  109. package/build/esm/utils/logger.utils.js +0 -304
  110. package/build/esm/utils/middleware.utils.d.ts +0 -99
  111. package/build/esm/utils/middleware.utils.js +0 -235
  112. package/build/esm/utils/obj.utils.d.ts +0 -123
  113. package/build/esm/utils/obj.utils.js +0 -412
  114. package/build/esm/utils/performance.utils.d.ts +0 -135
  115. package/build/esm/utils/performance.utils.js +0 -273
  116. package/build/esm/utils/request.utils.d.ts +0 -85
  117. package/build/esm/utils/request.utils.js +0 -190
  118. package/build/esm/utils/response.utils.d.ts +0 -162
  119. package/build/esm/utils/response.utils.js +0 -261
  120. package/build/esm/utils/stream.utils.d.ts +0 -87
  121. package/build/esm/utils/stream.utils.js +0 -209
  122. package/build/esm/utils/string.utils.d.ts +0 -92
  123. package/build/esm/utils/string.utils.js +0 -164
  124. package/build/esm/utils/type.utils.d.ts +0 -89
  125. package/build/esm/utils/type.utils.js +0 -186
  126. package/build/esm/utils/url.utils.d.ts +0 -140
  127. package/build/esm/utils/url.utils.js +0 -303
  128. package/build/esm/utils/validate.utils.d.ts +0 -176
  129. package/build/esm/utils/validate.utils.js +0 -319
@@ -1,132 +0,0 @@
1
- /*
2
- * The MIT License
3
- *
4
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
5
- *
6
- * Permission is hereby granted, free of charge, to any person obtaining a copy
7
- * of this software and associated documentation files (the "Software"), to deal
8
- * in the Software without restriction, including without limitation the rights
9
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- * copies of the Software, and to permit persons to whom the Software is
11
- * furnished to do so, subject to the following conditions:
12
- *
13
- * The above copyright notice and this permission notice shall be included in all
14
- * copies or substantial portions of the Software.
15
- *
16
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- * SOFTWARE.
23
- */
24
- import { Env } from './utils/env.utils';
25
- import { uuid } from './utils/id.utils';
26
- import { deepObjMerge } from './utils/obj.utils';
27
- /**
28
- * Application runtime configuration loaded from environment variables.
29
- */
30
- export let config = {
31
- logger: {
32
- /**
33
- * Logging level (e.g., 'info', 'debug', 'warn', 'error').
34
- */
35
- level: Env.get('LOGGER_LEVEL', 'info'),
36
- /**
37
- * Name of the logger instance (defaults to npm package name).
38
- */
39
- name: Env.get('LOGGER_NAME', Env.get('npm_package_name', '@catbee/utils')),
40
- /**
41
- * Enables pretty-print logging in development.
42
- * Has no effect in production.
43
- */
44
- pretty: Env.getBoolean('LOGGER_PRETTY', true),
45
- /**
46
- * Single line output for pretty-print (default: false)
47
- */
48
- singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)
49
- },
50
- cache: {
51
- /**
52
- * Default TTL (time to live) for cache entries in seconds
53
- */
54
- defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000
55
- }
56
- };
57
- export const defaultServerConfig = {
58
- port: 3000,
59
- host: '0.0.0.0',
60
- cors: false,
61
- helmet: false,
62
- compression: false,
63
- bodyParser: {
64
- json: { limit: '1mb' },
65
- urlencoded: { extended: true, limit: '1mb' }
66
- },
67
- cookieParser: false,
68
- isMicroservice: false,
69
- appName: 'express_app',
70
- globalHeaders: {},
71
- rateLimit: {
72
- enable: false,
73
- windowMs: 15 * 60 * 1000,
74
- max: 100,
75
- message: 'Too many requests',
76
- standardHeaders: true,
77
- legacyHeaders: false
78
- },
79
- requestLogging: {
80
- enable: Env.isDev(),
81
- ignorePaths: (req, _res) => {
82
- const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];
83
- return skipPaths.some(path => req.path.startsWith(path));
84
- },
85
- skipNotFoundRoutes: false
86
- },
87
- openApi: {
88
- enable: false,
89
- mountPath: '/docs',
90
- verbose: false,
91
- withGlobalPrefix: false
92
- },
93
- healthCheck: {
94
- path: '/healthz',
95
- detailed: true
96
- },
97
- requestTimeout: 30000,
98
- responseTime: {
99
- enable: false,
100
- addHeader: true,
101
- logOnComplete: false
102
- },
103
- requestId: {
104
- headerName: 'x-request-id',
105
- exposeHeader: true,
106
- generator: () => uuid()
107
- },
108
- metrics: {
109
- enable: false,
110
- path: '/metrics',
111
- withGlobalPrefix: false
112
- },
113
- serviceVersion: {
114
- enable: false,
115
- headerName: 'x-service-version',
116
- version: '0.0.0'
117
- }
118
- };
119
- /**
120
- * Update the @catbee/utils configuration.
121
- * @param value Partial configuration object.
122
- */
123
- export function setConfig(value) {
124
- deepObjMerge(config, value);
125
- }
126
- /**
127
- * Get the current @catbee/utils configuration.
128
- * @returns The current configuration object.
129
- */
130
- export function getConfig() {
131
- return config;
132
- }
@@ -1,26 +0,0 @@
1
- export { setConfig, getConfig } from './config';
2
- export * from './utils/array.utils';
3
- export * from './utils/async.utils';
4
- export * from './utils/cache.utils';
5
- export * from './utils/context-store.utils';
6
- export * from './utils/crypto.utils';
7
- export * from './utils/decorators.utils';
8
- export * from './utils/dir.utils';
9
- export * from './utils/env.utils';
10
- export * from './utils/exception.utils';
11
- export * from './utils/fs.utils';
12
- export * from './utils/http-status-codes';
13
- export * from './utils/id.utils';
14
- export * from './utils/logger.utils';
15
- export * from './utils/middleware.utils';
16
- export * from './utils/obj.utils';
17
- export * from './utils/request.utils';
18
- export * from './utils/response.utils';
19
- export * from './utils/string.utils';
20
- export * from './utils/url.utils';
21
- export * from './utils/validate.utils';
22
- export * from './types/index';
23
- export * from './types/server';
24
- export * from './types/api-response';
25
- export * from './servers/server';
26
- export * from './servers/server.builder';
@@ -1,49 +0,0 @@
1
- /*
2
- * The MIT License
3
- *
4
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
5
- *
6
- * Permission is hereby granted, free of charge, to any person obtaining a copy
7
- * of this software and associated documentation files (the "Software"), to deal
8
- * in the Software without restriction, including without limitation the rights
9
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- * copies of the Software, and to permit persons to whom the Software is
11
- * furnished to do so, subject to the following conditions:
12
- *
13
- * The above copyright notice and this permission notice shall be included in all
14
- * copies or substantial portions of the Software.
15
- *
16
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- * SOFTWARE.
23
- */
24
- export { setConfig, getConfig } from './config';
25
- export * from './utils/array.utils';
26
- export * from './utils/async.utils';
27
- export * from './utils/cache.utils';
28
- export * from './utils/context-store.utils';
29
- export * from './utils/crypto.utils';
30
- export * from './utils/decorators.utils';
31
- export * from './utils/dir.utils';
32
- export * from './utils/env.utils';
33
- export * from './utils/exception.utils';
34
- export * from './utils/fs.utils';
35
- export * from './utils/http-status-codes';
36
- export * from './utils/id.utils';
37
- export * from './utils/logger.utils';
38
- export * from './utils/middleware.utils';
39
- export * from './utils/obj.utils';
40
- export * from './utils/request.utils';
41
- export * from './utils/response.utils';
42
- export * from './utils/string.utils';
43
- export * from './utils/url.utils';
44
- export * from './utils/validate.utils';
45
- export * from './types/index';
46
- export * from './types/server';
47
- export * from './types/api-response';
48
- export * from './servers/server';
49
- export * from './servers/server.builder';