@catbee/utils 0.0.8-rc.3 → 0.0.8-rc.4

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 (128) hide show
  1. package/build/index.cjs +6591 -0
  2. package/build/index.d.ts +5131 -0
  3. package/build/index.mjs +6321 -0
  4. package/package.json +13 -292
  5. package/build/cjs/config.d.ts +0 -121
  6. package/build/cjs/config.js +0 -137
  7. package/build/cjs/index.d.ts +0 -26
  8. package/build/cjs/index.js +0 -68
  9. package/build/cjs/servers/server.builder.d.ts +0 -507
  10. package/build/cjs/servers/server.builder.js +0 -658
  11. package/build/cjs/servers/server.d.ts +0 -255
  12. package/build/cjs/servers/server.js +0 -970
  13. package/build/cjs/types/api-response.d.ts +0 -151
  14. package/build/cjs/types/api-response.js +0 -36
  15. package/build/cjs/types/index.d.ts +0 -124
  16. package/build/cjs/types/index.js +0 -25
  17. package/build/cjs/types/server.d.ts +0 -267
  18. package/build/cjs/types/server.js +0 -25
  19. package/build/cjs/utils/array.utils.d.ts +0 -167
  20. package/build/cjs/utils/array.utils.js +0 -363
  21. package/build/cjs/utils/async.utils.d.ts +0 -264
  22. package/build/cjs/utils/async.utils.js +0 -640
  23. package/build/cjs/utils/cache.utils.d.ts +0 -152
  24. package/build/cjs/utils/cache.utils.js +0 -298
  25. package/build/cjs/utils/context-store.utils.d.ts +0 -188
  26. package/build/cjs/utils/context-store.utils.js +0 -297
  27. package/build/cjs/utils/crypto.utils.d.ts +0 -159
  28. package/build/cjs/utils/crypto.utils.js +0 -295
  29. package/build/cjs/utils/date.utils.d.ts +0 -158
  30. package/build/cjs/utils/date.utils.js +0 -395
  31. package/build/cjs/utils/decorators.utils.d.ts +0 -511
  32. package/build/cjs/utils/decorators.utils.js +0 -1035
  33. package/build/cjs/utils/dir.utils.d.ts +0 -195
  34. package/build/cjs/utils/dir.utils.js +0 -500
  35. package/build/cjs/utils/env.utils.d.ts +0 -376
  36. package/build/cjs/utils/env.utils.js +0 -786
  37. package/build/cjs/utils/exception.utils.d.ts +0 -229
  38. package/build/cjs/utils/exception.utils.js +0 -408
  39. package/build/cjs/utils/fs.utils.d.ts +0 -163
  40. package/build/cjs/utils/fs.utils.js +0 -371
  41. package/build/cjs/utils/http-status-codes.d.ts +0 -265
  42. package/build/cjs/utils/http-status-codes.js +0 -297
  43. package/build/cjs/utils/id.utils.d.ts +0 -35
  44. package/build/cjs/utils/id.utils.js +0 -90
  45. package/build/cjs/utils/logger.utils.d.ts +0 -159
  46. package/build/cjs/utils/logger.utils.js +0 -350
  47. package/build/cjs/utils/middleware.utils.d.ts +0 -99
  48. package/build/cjs/utils/middleware.utils.js +0 -243
  49. package/build/cjs/utils/obj.utils.d.ts +0 -123
  50. package/build/cjs/utils/obj.utils.js +0 -428
  51. package/build/cjs/utils/performance.utils.d.ts +0 -135
  52. package/build/cjs/utils/performance.utils.js +0 -280
  53. package/build/cjs/utils/request.utils.d.ts +0 -85
  54. package/build/cjs/utils/request.utils.js +0 -199
  55. package/build/cjs/utils/response.utils.d.ts +0 -162
  56. package/build/cjs/utils/response.utils.js +0 -274
  57. package/build/cjs/utils/stream.utils.d.ts +0 -87
  58. package/build/cjs/utils/stream.utils.js +0 -217
  59. package/build/cjs/utils/string.utils.d.ts +0 -92
  60. package/build/cjs/utils/string.utils.js +0 -178
  61. package/build/cjs/utils/type.utils.d.ts +0 -89
  62. package/build/cjs/utils/type.utils.js +0 -195
  63. package/build/cjs/utils/url.utils.d.ts +0 -140
  64. package/build/cjs/utils/url.utils.js +0 -316
  65. package/build/cjs/utils/validate.utils.d.ts +0 -176
  66. package/build/cjs/utils/validate.utils.js +0 -344
  67. package/build/esm/config.d.ts +0 -121
  68. package/build/esm/config.js +0 -132
  69. package/build/esm/index.d.ts +0 -26
  70. package/build/esm/index.js +0 -49
  71. package/build/esm/servers/server.builder.d.ts +0 -507
  72. package/build/esm/servers/server.builder.js +0 -654
  73. package/build/esm/servers/server.d.ts +0 -255
  74. package/build/esm/servers/server.js +0 -963
  75. package/build/esm/types/api-response.d.ts +0 -151
  76. package/build/esm/types/api-response.js +0 -33
  77. package/build/esm/types/index.d.ts +0 -124
  78. package/build/esm/types/index.js +0 -24
  79. package/build/esm/types/server.d.ts +0 -267
  80. package/build/esm/types/server.js +0 -24
  81. package/build/esm/utils/array.utils.d.ts +0 -167
  82. package/build/esm/utils/array.utils.js +0 -344
  83. package/build/esm/utils/async.utils.d.ts +0 -264
  84. package/build/esm/utils/async.utils.js +0 -619
  85. package/build/esm/utils/cache.utils.d.ts +0 -152
  86. package/build/esm/utils/cache.utils.js +0 -294
  87. package/build/esm/utils/context-store.utils.d.ts +0 -188
  88. package/build/esm/utils/context-store.utils.js +0 -290
  89. package/build/esm/utils/crypto.utils.d.ts +0 -159
  90. package/build/esm/utils/crypto.utils.js +0 -278
  91. package/build/esm/utils/date.utils.d.ts +0 -158
  92. package/build/esm/utils/date.utils.js +0 -383
  93. package/build/esm/utils/decorators.utils.d.ts +0 -511
  94. package/build/esm/utils/decorators.utils.js +0 -1013
  95. package/build/esm/utils/dir.utils.d.ts +0 -195
  96. package/build/esm/utils/dir.utils.js +0 -476
  97. package/build/esm/utils/env.utils.d.ts +0 -376
  98. package/build/esm/utils/env.utils.js +0 -782
  99. package/build/esm/utils/exception.utils.d.ts +0 -229
  100. package/build/esm/utils/exception.utils.js +0 -382
  101. package/build/esm/utils/fs.utils.d.ts +0 -163
  102. package/build/esm/utils/fs.utils.js +0 -348
  103. package/build/esm/utils/http-status-codes.d.ts +0 -265
  104. package/build/esm/utils/http-status-codes.js +0 -294
  105. package/build/esm/utils/id.utils.d.ts +0 -35
  106. package/build/esm/utils/id.utils.js +0 -83
  107. package/build/esm/utils/logger.utils.d.ts +0 -159
  108. package/build/esm/utils/logger.utils.js +0 -304
  109. package/build/esm/utils/middleware.utils.d.ts +0 -99
  110. package/build/esm/utils/middleware.utils.js +0 -235
  111. package/build/esm/utils/obj.utils.d.ts +0 -123
  112. package/build/esm/utils/obj.utils.js +0 -412
  113. package/build/esm/utils/performance.utils.d.ts +0 -135
  114. package/build/esm/utils/performance.utils.js +0 -273
  115. package/build/esm/utils/request.utils.d.ts +0 -85
  116. package/build/esm/utils/request.utils.js +0 -190
  117. package/build/esm/utils/response.utils.d.ts +0 -162
  118. package/build/esm/utils/response.utils.js +0 -261
  119. package/build/esm/utils/stream.utils.d.ts +0 -87
  120. package/build/esm/utils/stream.utils.js +0 -209
  121. package/build/esm/utils/string.utils.d.ts +0 -92
  122. package/build/esm/utils/string.utils.js +0 -164
  123. package/build/esm/utils/type.utils.d.ts +0 -89
  124. package/build/esm/utils/type.utils.js +0 -186
  125. package/build/esm/utils/url.utils.d.ts +0 -140
  126. package/build/esm/utils/url.utils.js +0 -303
  127. package/build/esm/utils/validate.utils.d.ts +0 -176
  128. 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';