@plyaz/core 1.2.0 → 1.2.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 (238) hide show
  1. package/dist/adapters/index.d.ts +16 -0
  2. package/dist/adapters/index.d.ts.map +1 -0
  3. package/dist/adapters/nestjs.d.ts +79 -0
  4. package/dist/adapters/nestjs.d.ts.map +1 -0
  5. package/dist/adapters/nextjs.d.ts +28 -0
  6. package/dist/adapters/nextjs.d.ts.map +1 -0
  7. package/dist/backend/example/example.controller.d.ts +121 -0
  8. package/dist/backend/example/example.controller.d.ts.map +1 -0
  9. package/dist/backend/example/example.module.d.ts +29 -0
  10. package/dist/backend/example/example.module.d.ts.map +1 -0
  11. package/dist/backend/example/index.d.ts +8 -0
  12. package/dist/backend/example/index.d.ts.map +1 -0
  13. package/dist/backend/featureFlags/FeatureFlagDomainService.d.ts +150 -0
  14. package/dist/backend/featureFlags/FeatureFlagDomainService.d.ts.map +1 -0
  15. package/dist/backend/featureFlags/config/feature-flag.config.d.ts +28 -50
  16. package/dist/backend/featureFlags/config/feature-flag.config.d.ts.map +1 -1
  17. package/dist/backend/featureFlags/config/validation.d.ts +6 -6
  18. package/dist/backend/featureFlags/config/validation.d.ts.map +1 -1
  19. package/dist/backend/featureFlags/feature-flag.controller.d.ts +14 -55
  20. package/dist/backend/featureFlags/feature-flag.controller.d.ts.map +1 -1
  21. package/dist/backend/featureFlags/feature-flag.module.d.ts +36 -43
  22. package/dist/backend/featureFlags/feature-flag.module.d.ts.map +1 -1
  23. package/dist/backend/featureFlags/guards/feature-flag.guard.d.ts +16 -2
  24. package/dist/backend/featureFlags/guards/feature-flag.guard.d.ts.map +1 -1
  25. package/dist/backend/featureFlags/index.d.ts +6 -7
  26. package/dist/backend/featureFlags/index.d.ts.map +1 -1
  27. package/dist/backend/featureFlags/interceptors/error-handling-interceptor.d.ts.map +1 -1
  28. package/dist/backend/featureFlags/interceptors/feature-flag-logging-interceptor.d.ts.map +1 -1
  29. package/dist/backend/featureFlags/middleware/feature-flag-middleware.d.ts +6 -11
  30. package/dist/backend/featureFlags/middleware/feature-flag-middleware.d.ts.map +1 -1
  31. package/dist/backend/index.d.ts +5 -0
  32. package/dist/backend/index.d.ts.map +1 -1
  33. package/dist/base/cache/CacheKeyBuilder.d.ts +115 -0
  34. package/dist/base/cache/CacheKeyBuilder.d.ts.map +1 -0
  35. package/dist/base/cache/index.d.ts +1 -0
  36. package/dist/base/cache/index.d.ts.map +1 -1
  37. package/dist/base/cache/strategies/redis.d.ts.map +1 -1
  38. package/dist/base/observability/BaseAdapter.d.ts +79 -0
  39. package/dist/base/observability/BaseAdapter.d.ts.map +1 -0
  40. package/dist/base/observability/CompositeAdapter.d.ts +72 -0
  41. package/dist/base/observability/CompositeAdapter.d.ts.map +1 -0
  42. package/dist/base/observability/DatadogAdapter.d.ts +117 -0
  43. package/dist/base/observability/DatadogAdapter.d.ts.map +1 -0
  44. package/dist/base/observability/LoggerAdapter.d.ts +54 -0
  45. package/dist/base/observability/LoggerAdapter.d.ts.map +1 -0
  46. package/dist/base/observability/ObservabilityService.d.ts +160 -0
  47. package/dist/base/observability/ObservabilityService.d.ts.map +1 -0
  48. package/dist/base/observability/index.d.ts +17 -0
  49. package/dist/base/observability/index.d.ts.map +1 -0
  50. package/dist/domain/base/BaseBackendDomainService.d.ts +528 -0
  51. package/dist/domain/base/BaseBackendDomainService.d.ts.map +1 -0
  52. package/dist/domain/base/BaseDomainService.d.ts +284 -0
  53. package/dist/domain/base/BaseDomainService.d.ts.map +1 -0
  54. package/dist/domain/base/BaseFrontendDomainService.d.ts +493 -0
  55. package/dist/domain/base/BaseFrontendDomainService.d.ts.map +1 -0
  56. package/dist/domain/base/BaseMapper.d.ts +100 -0
  57. package/dist/domain/base/BaseMapper.d.ts.map +1 -0
  58. package/dist/domain/base/BaseValidator.d.ts +105 -0
  59. package/dist/domain/base/BaseValidator.d.ts.map +1 -0
  60. package/dist/domain/base/index.d.ts +10 -0
  61. package/dist/domain/base/index.d.ts.map +1 -0
  62. package/dist/domain/example/BackendExampleDomainService.d.ts +257 -0
  63. package/dist/domain/example/BackendExampleDomainService.d.ts.map +1 -0
  64. package/dist/domain/example/FrontendExampleDomainService.d.ts +164 -0
  65. package/dist/domain/example/FrontendExampleDomainService.d.ts.map +1 -0
  66. package/dist/domain/example/index.d.ts +10 -0
  67. package/dist/domain/example/index.d.ts.map +1 -0
  68. package/dist/domain/example/mappers/ExampleMapper.d.ts +67 -0
  69. package/dist/domain/example/mappers/ExampleMapper.d.ts.map +1 -0
  70. package/dist/domain/example/validators/ExampleValidator.d.ts +33 -0
  71. package/dist/domain/example/validators/ExampleValidator.d.ts.map +1 -0
  72. package/dist/domain/featureFlags/FrontendFeatureFlagDomainService.d.ts +86 -0
  73. package/dist/domain/featureFlags/FrontendFeatureFlagDomainService.d.ts.map +1 -0
  74. package/dist/domain/featureFlags/index.d.ts +10 -5
  75. package/dist/domain/featureFlags/index.d.ts.map +1 -1
  76. package/dist/domain/featureFlags/mappers/FeatureFlagMapper.d.ts +72 -0
  77. package/dist/domain/featureFlags/mappers/FeatureFlagMapper.d.ts.map +1 -0
  78. package/dist/domain/featureFlags/mappers/index.d.ts +8 -0
  79. package/dist/domain/featureFlags/mappers/index.d.ts.map +1 -0
  80. package/dist/domain/featureFlags/module.d.ts +20 -0
  81. package/dist/domain/featureFlags/module.d.ts.map +1 -0
  82. package/dist/domain/featureFlags/provider.d.ts +40 -1
  83. package/dist/domain/featureFlags/provider.d.ts.map +1 -1
  84. package/dist/domain/featureFlags/providers/api.d.ts +59 -34
  85. package/dist/domain/featureFlags/providers/api.d.ts.map +1 -1
  86. package/dist/domain/featureFlags/providers/database.d.ts +48 -46
  87. package/dist/domain/featureFlags/providers/database.d.ts.map +1 -1
  88. package/dist/domain/featureFlags/providers/factory.d.ts +50 -33
  89. package/dist/domain/featureFlags/providers/factory.d.ts.map +1 -1
  90. package/dist/domain/featureFlags/providers/file.d.ts +48 -1
  91. package/dist/domain/featureFlags/providers/file.d.ts.map +1 -1
  92. package/dist/domain/featureFlags/providers/memory.d.ts +32 -6
  93. package/dist/domain/featureFlags/providers/memory.d.ts.map +1 -1
  94. package/dist/domain/featureFlags/providers/redis.d.ts +6 -1
  95. package/dist/domain/featureFlags/providers/redis.d.ts.map +1 -1
  96. package/dist/domain/featureFlags/service.d.ts +112 -0
  97. package/dist/domain/featureFlags/service.d.ts.map +1 -0
  98. package/dist/domain/index.d.ts +2 -0
  99. package/dist/domain/index.d.ts.map +1 -1
  100. package/dist/engine/featureFlags/engine.d.ts +8 -0
  101. package/dist/engine/featureFlags/engine.d.ts.map +1 -1
  102. package/dist/entry-backend.d.ts +24 -0
  103. package/dist/entry-backend.d.ts.map +1 -0
  104. package/dist/entry-backend.js +15635 -0
  105. package/dist/entry-backend.js.map +1 -0
  106. package/dist/entry-backend.mjs +15506 -0
  107. package/dist/entry-backend.mjs.map +1 -0
  108. package/dist/entry-frontend.d.ts +23 -0
  109. package/dist/entry-frontend.d.ts.map +1 -0
  110. package/dist/entry-frontend.js +11152 -0
  111. package/dist/entry-frontend.js.map +1 -0
  112. package/dist/entry-frontend.mjs +11089 -0
  113. package/dist/entry-frontend.mjs.map +1 -0
  114. package/dist/events/CoreEventManager.d.ts +116 -0
  115. package/dist/events/CoreEventManager.d.ts.map +1 -0
  116. package/dist/events/index.d.ts +27 -0
  117. package/dist/events/index.d.ts.map +1 -0
  118. package/dist/frontend/base/index.d.ts +8 -0
  119. package/dist/frontend/base/index.d.ts.map +1 -0
  120. package/dist/frontend/components/InitializationError.d.ts +25 -0
  121. package/dist/frontend/components/InitializationError.d.ts.map +1 -0
  122. package/dist/frontend/components/InitializationLoading.d.ts +22 -0
  123. package/dist/frontend/components/InitializationLoading.d.ts.map +1 -0
  124. package/dist/frontend/components/index.d.ts +9 -0
  125. package/dist/frontend/components/index.d.ts.map +1 -0
  126. package/dist/frontend/example/index.d.ts +9 -0
  127. package/dist/frontend/example/index.d.ts.map +1 -0
  128. package/dist/frontend/featureFlags/index.d.ts +28 -7
  129. package/dist/frontend/featureFlags/index.d.ts.map +1 -1
  130. package/dist/frontend/index.d.ts +4 -0
  131. package/dist/frontend/index.d.ts.map +1 -1
  132. package/dist/frontend/providers/ApiProvider.d.ts +2 -2
  133. package/dist/frontend/providers/ApiProvider.d.ts.map +1 -1
  134. package/dist/frontend/providers/PlyazProvider.d.ts +305 -0
  135. package/dist/frontend/providers/PlyazProvider.d.ts.map +1 -0
  136. package/dist/frontend/providers/index.d.ts +1 -0
  137. package/dist/frontend/providers/index.d.ts.map +1 -1
  138. package/dist/frontend/store/feature-flags.d.ts +63 -0
  139. package/dist/frontend/store/feature-flags.d.ts.map +1 -0
  140. package/dist/frontend/store/index.d.ts +14 -0
  141. package/dist/frontend/store/index.d.ts.map +1 -0
  142. package/dist/frontend/store/integrations.d.ts +36 -0
  143. package/dist/frontend/store/integrations.d.ts.map +1 -0
  144. package/dist/frontend/store/service-accessors.d.ts +78 -0
  145. package/dist/frontend/store/service-accessors.d.ts.map +1 -0
  146. package/dist/index.d.ts +5 -2
  147. package/dist/index.d.ts.map +1 -1
  148. package/dist/index.js +15450 -0
  149. package/dist/index.js.map +1 -0
  150. package/dist/index.mjs +13678 -4697
  151. package/dist/index.mjs.map +1 -1
  152. package/dist/init/CoreInitializer.d.ts +582 -0
  153. package/dist/init/CoreInitializer.d.ts.map +1 -0
  154. package/dist/init/ServiceRegistry.d.ts +256 -0
  155. package/dist/init/ServiceRegistry.d.ts.map +1 -0
  156. package/dist/init/index.d.ts +14 -0
  157. package/dist/init/index.d.ts.map +1 -0
  158. package/dist/init/nestjs/CoreModule.d.ts +63 -0
  159. package/dist/init/nestjs/CoreModule.d.ts.map +1 -0
  160. package/dist/init/nestjs/index.d.ts +5 -0
  161. package/dist/init/nestjs/index.d.ts.map +1 -0
  162. package/dist/init/nestjs/index.js +9059 -0
  163. package/dist/init/nestjs/index.js.map +1 -0
  164. package/dist/init/nestjs/index.mjs +9055 -0
  165. package/dist/init/nestjs/index.mjs.map +1 -0
  166. package/dist/init/react.d.ts +33 -0
  167. package/dist/init/react.d.ts.map +1 -0
  168. package/dist/models/example/ExampleRepository.d.ts +124 -0
  169. package/dist/models/example/ExampleRepository.d.ts.map +1 -0
  170. package/dist/models/example/index.d.ts +7 -0
  171. package/dist/models/example/index.d.ts.map +1 -0
  172. package/dist/{backend/featureFlags/database/repository.d.ts → models/featureFlags/FeatureFlagRepository.d.ts} +47 -5
  173. package/dist/models/featureFlags/FeatureFlagRepository.d.ts.map +1 -0
  174. package/dist/models/featureFlags/index.d.ts +7 -0
  175. package/dist/models/featureFlags/index.d.ts.map +1 -0
  176. package/dist/models/index.d.ts +9 -0
  177. package/dist/models/index.d.ts.map +1 -0
  178. package/dist/services/ApiClientService.d.ts +92 -4
  179. package/dist/services/ApiClientService.d.ts.map +1 -1
  180. package/dist/services/CacheService.d.ts +176 -0
  181. package/dist/services/CacheService.d.ts.map +1 -0
  182. package/dist/services/DbService.d.ts +391 -0
  183. package/dist/services/DbService.d.ts.map +1 -0
  184. package/dist/services/NotificationService.d.ts +151 -0
  185. package/dist/services/NotificationService.d.ts.map +1 -0
  186. package/dist/services/StorageService.d.ts +144 -0
  187. package/dist/services/StorageService.d.ts.map +1 -0
  188. package/dist/services/index.d.ts +4 -0
  189. package/dist/services/index.d.ts.map +1 -1
  190. package/dist/utils/common/id.d.ts +83 -0
  191. package/dist/utils/common/id.d.ts.map +1 -0
  192. package/dist/utils/common/index.d.ts +2 -0
  193. package/dist/utils/common/index.d.ts.map +1 -1
  194. package/dist/utils/common/object.d.ts +70 -0
  195. package/dist/utils/common/object.d.ts.map +1 -0
  196. package/dist/utils/featureFlags/conditions.d.ts.map +1 -1
  197. package/dist/utils/featureFlags/context.d.ts +0 -1
  198. package/dist/utils/featureFlags/context.d.ts.map +1 -1
  199. package/dist/utils/index.d.ts +1 -0
  200. package/dist/utils/index.d.ts.map +1 -1
  201. package/dist/utils/mapperUtils.d.ts +38 -0
  202. package/dist/utils/mapperUtils.d.ts.map +1 -0
  203. package/dist/utils/runtime.d.ts +15 -0
  204. package/dist/utils/runtime.d.ts.map +1 -0
  205. package/dist/version.d.ts +24 -0
  206. package/dist/version.d.ts.map +1 -0
  207. package/dist/web_app/auth/add_user.d.ts +2 -2
  208. package/dist/web_app/auth/add_user.d.ts.map +1 -1
  209. package/dist/web_app/auth/update_user.d.ts +1 -1
  210. package/dist/web_app/auth/update_user.d.ts.map +1 -1
  211. package/package.json +89 -15
  212. package/dist/backend/featureFlags/database/connection.d.ts +0 -321
  213. package/dist/backend/featureFlags/database/connection.d.ts.map +0 -1
  214. package/dist/backend/featureFlags/database/repository.d.ts.map +0 -1
  215. package/dist/backend/featureFlags/feature-flag.repository.d.ts +0 -85
  216. package/dist/backend/featureFlags/feature-flag.repository.d.ts.map +0 -1
  217. package/dist/backend/featureFlags/feature-flag.service.d.ts +0 -264
  218. package/dist/backend/featureFlags/feature-flag.service.d.ts.map +0 -1
  219. package/dist/frontend/featureFlags/hooks/useFeatureFlag.d.ts +0 -103
  220. package/dist/frontend/featureFlags/hooks/useFeatureFlag.d.ts.map +0 -1
  221. package/dist/frontend/featureFlags/hooks/useFeatureFlagActions.d.ts +0 -35
  222. package/dist/frontend/featureFlags/hooks/useFeatureFlagActions.d.ts.map +0 -1
  223. package/dist/frontend/featureFlags/hooks/useFeatureFlagHelpers.d.ts +0 -55
  224. package/dist/frontend/featureFlags/hooks/useFeatureFlagHelpers.d.ts.map +0 -1
  225. package/dist/frontend/featureFlags/hooks/useFeatureFlagProvider.d.ts +0 -57
  226. package/dist/frontend/featureFlags/hooks/useFeatureFlagProvider.d.ts.map +0 -1
  227. package/dist/frontend/featureFlags/providers/FeatureFlagProvider.d.ts +0 -99
  228. package/dist/frontend/featureFlags/providers/FeatureFlagProvider.d.ts.map +0 -1
  229. package/dist/frontend/featureFlags/providers/FeatureFlagProviderHelpers.d.ts +0 -31
  230. package/dist/frontend/featureFlags/providers/FeatureFlagProviderHelpers.d.ts.map +0 -1
  231. package/dist/frontend/featureFlags/providers/types.d.ts +0 -21
  232. package/dist/frontend/featureFlags/providers/types.d.ts.map +0 -1
  233. package/dist/index.cjs +0 -6435
  234. package/dist/index.cjs.map +0 -1
  235. package/dist/utils/db/databaseService.d.ts +0 -6
  236. package/dist/utils/db/databaseService.d.ts.map +0 -1
  237. package/dist/utils/db/index.d.ts +0 -2
  238. package/dist/utils/db/index.d.ts.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../src/services/StorageService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAY3D;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAMP;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAKpC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;OAKG;WACU,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB3E;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;;;;;;;;;;OAaG;IACH,UAAU,IAAI,kBAAkB;IA6ChC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkC3F;;OAEG;IACH,SAAS,IAAI,iBAAiB,GAAG,IAAI;IAIrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;;;;OAOG;WACU,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CAShF"}
@@ -5,4 +5,8 @@
5
5
  * @module services
6
6
  */
7
7
  export * from './ApiClientService';
8
+ export * from './CacheService';
9
+ export * from './DbService';
10
+ export * from './StorageService';
11
+ export * from './NotificationService';
8
12
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * ID Generation Utilities
3
+ *
4
+ * Provides consistent ID generation across the application.
5
+ * Uses globalThis.crypto when available, with a fallback for environments without it.
6
+ *
7
+ * @fileoverview ID generation utility functions
8
+ */
9
+ /**
10
+ * Generate a UUID v4 string.
11
+ * Uses crypto.randomUUID when available, otherwise falls back to a timestamp-based ID.
12
+ *
13
+ * @returns A UUID v4 string or fallback ID
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * const id = generateId();
18
+ * // => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' (crypto available)
19
+ * // => '1701475200000-x7k9m2' (fallback)
20
+ * ```
21
+ */
22
+ export declare function generateId(): string;
23
+ /**
24
+ * Generate a short random ID (8 characters).
25
+ * Useful for correlation IDs, short references, etc.
26
+ *
27
+ * @returns A short random string
28
+ *
29
+ * @example
30
+ * ```typescript
31
+ * const shortId = generateShortId();
32
+ * // => 'x7k9m2ab'
33
+ * ```
34
+ */
35
+ export declare function generateShortId(): string;
36
+ /**
37
+ * Generate a correlation ID for tracing.
38
+ * Format: timestamp-randomString
39
+ *
40
+ * @returns A correlation ID string
41
+ *
42
+ * @example
43
+ * ```typescript
44
+ * const correlationId = generateCorrelationId();
45
+ * // => '1701475200000-x7k9m2'
46
+ * ```
47
+ */
48
+ export declare function generateCorrelationId(): string;
49
+ /**
50
+ * Generate a trace ID for distributed tracing (32 hex characters / 128 bits).
51
+ *
52
+ * @returns A 32-character hex string
53
+ *
54
+ * @example
55
+ * ```typescript
56
+ * const traceId = generateTraceId();
57
+ * // => 'a1b2c3d4e5f67890abcdef1234567890'
58
+ * ```
59
+ */
60
+ export declare function generateTraceId(): string;
61
+ /**
62
+ * Generate a span ID for distributed tracing (16 hex characters / 64 bits).
63
+ *
64
+ * @returns A 16-character hex string
65
+ *
66
+ * @example
67
+ * ```typescript
68
+ * const spanId = generateSpanId();
69
+ * // => 'a1b2c3d4e5f67890'
70
+ * ```
71
+ */
72
+ export declare function generateSpanId(): string;
73
+ /**
74
+ * ID generation utilities object for convenient access.
75
+ */
76
+ export declare const IdUtils: {
77
+ readonly generate: typeof generateId;
78
+ readonly generateShort: typeof generateShortId;
79
+ readonly generateCorrelation: typeof generateCorrelationId;
80
+ readonly generateTraceId: typeof generateTraceId;
81
+ readonly generateSpanId: typeof generateSpanId;
82
+ };
83
+ //# sourceMappingURL=id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/utils/common/id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CASxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAYxC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;CAMV,CAAC"}
@@ -6,6 +6,8 @@
6
6
  * @fileoverview Common utilities export
7
7
  */
8
8
  export { hashString, isInRollout, createRolloutIdentifier, HashUtils } from './hash';
9
+ export { generateId, generateShortId, generateCorrelationId, generateTraceId, generateSpanId, IdUtils, } from './id';
9
10
  export { isTruthy, toBoolean, ValueUtils } from './values';
11
+ export { setNestedProperty, getNestedProperty, hasNestedProperty, ObjectUtils } from './object';
10
12
  export * from './validation';
11
13
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGrF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D,cAAc,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGrF,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,OAAO,GACR,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEhG,cAAc,cAAc,CAAC"}
@@ -0,0 +1,70 @@
1
+ /**
2
+ * Object Utilities
3
+ *
4
+ * Provides utilities for working with nested object paths and property access.
5
+ *
6
+ * @fileoverview Object manipulation utilities
7
+ */
8
+ /**
9
+ * Sets a value at a nested path in an object, creating intermediate objects as needed.
10
+ *
11
+ * @param obj - The target object to modify
12
+ * @param path - Dot-separated path to the property (e.g., 'user.profile.name')
13
+ * @param value - The value to set at the path
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * const obj = { user: { id: 1 } };
18
+ * setNestedProperty(obj, 'user.profile.name', 'John');
19
+ * // Result: { user: { id: 1, profile: { name: 'John' } } }
20
+ * ```
21
+ */
22
+ export declare function setNestedProperty(obj: Record<string, unknown>, path: string, value: unknown): void;
23
+ /**
24
+ * Gets a value at a nested path in an object.
25
+ *
26
+ * @param obj - The source object to read from
27
+ * @param path - Dot-separated path to the property (e.g., 'user.profile.name')
28
+ * @param defaultValue - Optional default value if the path doesn't exist
29
+ * @returns The value at the path, or defaultValue if not found
30
+ *
31
+ * @example
32
+ * ```typescript
33
+ * const obj = { user: { profile: { name: 'John' } } };
34
+ * getNestedProperty(obj, 'user.profile.name'); // 'John'
35
+ * getNestedProperty(obj, 'user.settings.theme', 'dark'); // 'dark' (default)
36
+ * ```
37
+ */
38
+ export declare function getNestedProperty<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T | undefined;
39
+ /**
40
+ * Checks if a nested path exists in an object.
41
+ *
42
+ * @param obj - The object to check
43
+ * @param path - Dot-separated path to check (e.g., 'user.profile.name')
44
+ * @returns True if the path exists and is not undefined
45
+ *
46
+ * @example
47
+ * ```typescript
48
+ * const obj = { user: { profile: { name: 'John' } } };
49
+ * hasNestedProperty(obj, 'user.profile.name'); // true
50
+ * hasNestedProperty(obj, 'user.settings.theme'); // false
51
+ * ```
52
+ */
53
+ export declare function hasNestedProperty(obj: Record<string, unknown>, path: string): boolean;
54
+ /**
55
+ * Object utilities namespace for convenient grouped access.
56
+ *
57
+ * @example
58
+ * ```typescript
59
+ * import { ObjectUtils } from '@plyaz/core/utils';
60
+ *
61
+ * ObjectUtils.setNestedProperty(obj, 'user.name', 'John');
62
+ * const name = ObjectUtils.getNestedProperty(obj, 'user.name');
63
+ * ```
64
+ */
65
+ export declare const ObjectUtils: {
66
+ readonly setNestedProperty: typeof setNestedProperty;
67
+ readonly getNestedProperty: typeof getNestedProperty;
68
+ readonly hasNestedProperty: typeof hasNestedProperty;
69
+ };
70
+ //# sourceMappingURL=object.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/utils/common/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAgBN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS,CAaf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAerF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,OAAO,GACpB,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,GACpB,OAAO,CAQT;AAqBD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;iDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;;OAMG;gDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;OAKG;4CAEU,OAAO,CAAC,oBAAoB,CAAC,KACvC;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAmCD;;;;;;;OAOG;sCAEM,MAAM,YACH,oBAAoB,CAAC,UAAU,CAAC,SACnC,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB;CAUf,CAAC"}
1
+ {"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,OAAO,GACpB,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,GACpB,OAAO,CAQT;AAqBD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;iDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;;OAMG;gDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;OAKG;4CAEU,OAAO,CAAC,oBAAoB,CAAC,KACvC;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAmCD;;;;;;;OAOG;sCAEM,MAAM,YACH,oBAAoB,CAAC,UAAU,CAAC,SACnC,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB;CAaf,CAAC"}
@@ -2,7 +2,6 @@
2
2
  * Feature Flag Context Utilities
3
3
  *
4
4
  * Utilities for building, validating, and manipulating feature flag contexts.
5
- * Re-exports the context builder and utilities from domain layer for convenience.
6
5
  *
7
6
  * @fileoverview Feature flag context utilities
8
7
  * @version 1.0.0
@@ -1 +1 @@
1
- {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/context.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/context.ts"],"names":[],"mappings":"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"}
@@ -3,4 +3,5 @@
3
3
  */
4
4
  export * from './common';
5
5
  export * from './featureFlags';
6
+ export * from './runtime';
6
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Mapper Utility Functions
3
+ *
4
+ * Common utilities for data transformation in mappers.
5
+ */
6
+ /**
7
+ * Convert snake_case to camelCase
8
+ */
9
+ export declare function snakeToCamel(str: string): string;
10
+ /**
11
+ * Convert camelCase to snake_case
12
+ */
13
+ export declare function camelToSnake(str: string): string;
14
+ /**
15
+ * Parse ISO date string to Date object
16
+ */
17
+ export declare function parseDate(dateString: string | null | undefined): Date | null;
18
+ /**
19
+ * Format Date to ISO string for API
20
+ */
21
+ export declare function formatDate(date: Date | null | undefined): string | null;
22
+ /**
23
+ * Trim string if defined
24
+ */
25
+ export declare function trimString(str: string | undefined): string | undefined;
26
+ /**
27
+ * Pick only defined values from object (for PATCH requests)
28
+ */
29
+ export declare function pickDefined<T extends Record<string, unknown>>(obj: T): Partial<T>;
30
+ /**
31
+ * Convert object keys from snake_case to camelCase
32
+ */
33
+ export declare function keysToCamel<T extends Record<string, unknown>>(obj: T): Record<string, unknown>;
34
+ /**
35
+ * Convert object keys from camelCase to snake_case
36
+ */
37
+ export declare function keysToSnake<T extends Record<string, unknown>>(obj: T): Record<string, unknown>;
38
+ //# sourceMappingURL=mapperUtils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mapperUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mapperUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAI5E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9F"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Runtime Detection Utilities
3
+ *
4
+ * Utilities for detecting the current JavaScript runtime environment.
5
+ */
6
+ import type { CoreRuntimeEnvironment } from '@plyaz/types/core';
7
+ /**
8
+ * Detect the current runtime environment
9
+ */
10
+ export declare function detectRuntime(): CoreRuntimeEnvironment;
11
+ /**
12
+ * Load environment variables from a .env file
13
+ */
14
+ export declare function loadEnvFile(envPath: string, verbose?: boolean): Promise<void>;
15
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/utils/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA6DhE;;GAEG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAmBtD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAanF"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Package version - single source of truth
3
+ *
4
+ * Reads version from package.json to ensure consistency across:
5
+ * - Health check endpoints
6
+ * - API headers (X-Version)
7
+ * - Observability tags
8
+ * - Logging metadata
9
+ */
10
+ /**
11
+ * Get the package version from package.json
12
+ * Caches the result for subsequent calls
13
+ */
14
+ export declare function getPackageVersion(): string;
15
+ /**
16
+ * Package version constant
17
+ * Use this for static contexts where async/dynamic loading isn't needed
18
+ */
19
+ export declare const VERSION: string;
20
+ /**
21
+ * Package name
22
+ */
23
+ export declare const PACKAGE_NAME = "@plyaz/core";
24
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAsB,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAgB,CAAC"}
@@ -1,3 +1,3 @@
1
- import { type DBUser } from '@plyaz/types';
2
- export declare const userData: DBUser;
1
+ import type { CoreDBUser } from '@plyaz/types/core';
2
+ export declare const userData: CoreDBUser;
3
3
  //# sourceMappingURL=add_user.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"add_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/add_user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,QAAQ,EAAE,MAiBtB,CAAC"}
1
+ {"version":3,"file":"add_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/add_user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,UAiBtB,CAAC"}
@@ -1,2 +1,2 @@
1
- export declare const UpdateUser: <T extends Object>(table: string, id: string, input: T) => Promise<unknown>;
1
+ export declare const UpdateUser: <T extends Record<string, unknown>>(table: string, id: string, input: T) => Promise<unknown>;
2
2
  //# sourceMappingURL=update_user.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"update_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/update_user.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,GAAU,CAAC,SAAS,MAAM,EAC/C,OAAO,MAAM,EACb,IAAI,MAAM,EACV,OAAO,CAAC,KACP,OAAO,CAAC,OAAO,CAIjB,CAAC"}
1
+ {"version":3,"file":"update_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/update_user.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,GAAU,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,MAAM,EACb,IAAI,MAAM,EACV,OAAO,CAAC,KACP,OAAO,CAAC,OAAO,CAIjB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plyaz/core",
3
- "version": "1.2.0",
3
+ "version": "1.2.1",
4
4
  "description": "Shared core logic and utilities for Plyaz apps, services, and future SDKs – centralized, reusable, and scalable.",
5
5
  "type": "module",
6
6
  "keywords": [],
@@ -15,11 +15,29 @@
15
15
  "require": "./dist/index.js",
16
16
  "default": "./dist/index.mjs"
17
17
  },
18
+ "./frontend": {
19
+ "types": "./dist/entry-frontend.d.ts",
20
+ "import": "./dist/entry-frontend.mjs",
21
+ "require": "./dist/entry-frontend.js",
22
+ "default": "./dist/entry-frontend.mjs"
23
+ },
24
+ "./backend": {
25
+ "types": "./dist/entry-backend.d.ts",
26
+ "import": "./dist/entry-backend.mjs",
27
+ "require": "./dist/entry-backend.js",
28
+ "default": "./dist/entry-backend.mjs"
29
+ },
30
+ "./nestjs": {
31
+ "types": "./dist/init/nestjs/index.d.ts",
32
+ "import": "./dist/init/nestjs/index.mjs",
33
+ "require": "./dist/init/nestjs/index.js",
34
+ "default": "./dist/init/nestjs/index.mjs"
35
+ },
18
36
  "./package.json": "./package.json"
19
37
  },
20
38
  "engines": {
21
- "node": ">=22.4.0",
22
- "pnpm": ">=8.0.0"
39
+ "node": ">=23.0.0",
40
+ "pnpm": ">=8.10.0"
23
41
  },
24
42
  "author": "Redeemer Pace",
25
43
  "license": "ISC",
@@ -29,24 +47,33 @@
29
47
  "dependencies": {
30
48
  "@nestjs/common": "^11.1.3",
31
49
  "@nestjs/core": "^11.1.6",
32
- "@plyaz/api": "^1.2.2",
33
- "@plyaz/config": "^1.7.18",
34
- "@plyaz/db": "^0.1.0",
35
- "@plyaz/errors": "^1.3.7",
36
- "@plyaz/logger": "^1.3.2",
50
+ "@nestjs/platform-express": "^11.1.9",
51
+ "@plyaz/api": "^1.5.4",
52
+ "@plyaz/config": "^1.9.0",
53
+ "@plyaz/db": "^0.4.0",
54
+ "@plyaz/errors": "^1.5.1",
55
+ "@plyaz/logger": "^1.4.1",
56
+ "@plyaz/notifications": "^1.0.1",
57
+ "@plyaz/storage": "^1.0.1",
58
+ "@plyaz/store": "^1.1.3",
37
59
  "@plyaz/translations": "^1.4.5",
38
- "@plyaz/types": "^1.15.19",
60
+ "@plyaz/types": "^1.24.0",
39
61
  "@supabase/supabase-js": "^2.79.0",
62
+ "dd-trace": "^5.80.0",
40
63
  "dotenv": "^17.2.3",
41
64
  "drizzle-orm": "^0.36.4",
65
+ "fetchff": "^4.1.0",
66
+ "hot-shots": "^11.4.0",
42
67
  "ioredis": "^5.6.1",
43
68
  "next": "15.4.7",
44
69
  "postgres": "^3.4.7",
45
- "react": "^19.1.0",
46
- "react-dom": "^19.1.0",
70
+ "react": "^19.2.0",
71
+ "react-dom": "^19.2.0",
47
72
  "rxjs": "^7.8.2",
48
73
  "viem": "^2.31.7",
49
- "yaml": "^2.8.0"
74
+ "yaml": "^2.8.0",
75
+ "zod": "4.1.5",
76
+ "zustand": "^5.0.9"
50
77
  },
51
78
  "devDependencies": {
52
79
  "@changesets/cli": "^2.29.5",
@@ -54,6 +81,8 @@
54
81
  "@eslint/eslintrc": "^3.2.0",
55
82
  "@eslint/js": "^9.15.0",
56
83
  "@eslint/markdown": "^6.5.0",
84
+ "@nestjs/cli": "^11.0.7",
85
+ "@nestjs/schematics": "^11.0.5",
57
86
  "@next/eslint-plugin-next": "^15.0.3",
58
87
  "@plyaz/devtools": "^1.9.4",
59
88
  "@plyaz/testing": "^1.5.1",
@@ -62,13 +91,15 @@
62
91
  "@testing-library/user-event": "^14.6.1",
63
92
  "@types/express": "^5.0.5",
64
93
  "@types/node": "^22.14.0",
65
- "@types/react": "^19.1.8",
66
- "@types/react-dom": "^19.1.6",
94
+ "@types/react": "^19.2.2",
95
+ "@types/react-dom": "^19.2.2",
67
96
  "@typescript-eslint/eslint-plugin": "^8.15.0",
68
97
  "@typescript-eslint/parser": "^8.15.0",
69
98
  "@vitest/coverage-istanbul": "3.2.4",
70
99
  "@vitest/coverage-v8": "^3.1.3",
71
100
  "chalk": "^5.4.1",
101
+ "commander": "^12.1.0",
102
+ "cross-env": "^10.1.0",
72
103
  "eslint": "^9.29.0",
73
104
  "eslint-config-next": "^15.3.3",
74
105
  "eslint-config-prettier": "^9.1.0",
@@ -108,6 +139,8 @@
108
139
  "standard-version": "^9.5.0",
109
140
  "tailwindcss": "^4.1.8",
110
141
  "ts-morph": "^26.0.0",
142
+ "ts-node": "^10.9.2",
143
+ "tsconfig-paths": "^4.2.0",
111
144
  "tsup": "8.5.0",
112
145
  "typescript": "^5",
113
146
  "typescript-eslint": "^8.34.0",
@@ -135,13 +168,54 @@
135
168
  "lint:fix": "eslint ./src ./tests --fix",
136
169
  "format": "prettier --write './**/*.{ts,tsx,js,jsx}'",
137
170
  "format:check": "prettier --check './**/*.{ts,tsx,js,jsx}'",
138
- "type:check": "tsc --noEmit",
171
+ "type:check": "node --max-old-space-size=8192 node_modules/typescript/bin/tsc --noEmit",
139
172
  "test": "vitest run --no-watch",
140
173
  "test:ci": "vitest run --no-watch",
141
174
  "test:watch": "vitest --watch",
142
175
  "test:coverage": "vitest run --coverage",
143
176
  "test:ui": "vitest --ui",
144
177
  "clean": "rm -rf dist",
178
+ "example:db": "npx tsx examples/db-service.ts",
179
+ "nest:dev": "npx tsx --watch server/main.ts",
180
+ "nest:start": "npx tsx server/main.ts",
181
+ "nest:start:debug": "npx tsx --inspect server/main.ts",
182
+ "nest:start:prod": "node dist/server/main.js",
183
+ "nest:generate": "nest generate",
184
+ "generate": "npx tsx bin/generate.ts",
185
+ "generate:feature": "npx tsx bin/generate.ts feature",
186
+ "generate:list": "npx tsx bin/generate.ts list --files",
187
+ "generate:info": "npx tsx bin/generate.ts info",
188
+ "generate:init": "npx tsx bin/generate.ts init",
189
+ "generate:undo": "npx tsx bin/generate.ts undo",
190
+ "generate:history": "npx tsx bin/generate.ts history",
191
+ "generate:no-author": "npx tsx bin/generate.ts feature --no-author",
192
+ "g": "npx tsx bin/generate.ts",
193
+ "g:f": "npx tsx bin/generate.ts feature",
194
+ "g:f:na": "npx tsx bin/generate.ts feature --no-author",
195
+ "g:u": "npx tsx bin/generate.ts undo",
196
+ "db:init": "plyaz-db init",
197
+ "db:version": "plyaz-db version",
198
+ "db:migrate": "plyaz-db migrate up",
199
+ "db:migrate:down": "plyaz-db migrate down",
200
+ "db:migrate:down:all": "plyaz-db migrate reset --confirm",
201
+ "db:migrate:status": "plyaz-db migrate status",
202
+ "db:migrate:verify": "plyaz-db migrate verify",
203
+ "db:migrate:generate-down": "plyaz-db migrate generate-down",
204
+ "db:migrate:generate-down:write": "plyaz-db migrate generate-down --write",
205
+ "db:seed": "plyaz-db seed run",
206
+ "db:seed:status": "plyaz-db seed status",
207
+ "db:seed:reset": "plyaz-db seed reset --confirm",
208
+ "db:health": "plyaz-db health",
209
+ "db:create:migration": "plyaz-db create migration",
210
+ "db:create:migration:ts": "plyaz-db create migration -t ts",
211
+ "db:create:migration:i": "plyaz-db create migration -i",
212
+ "db:create:seed": "plyaz-db create seed",
213
+ "db:create:seed:sql": "plyaz-db create seed -t sql",
214
+ "db:create:seed:csv": "plyaz-db create seed -t csv",
215
+ "db:create:seed:i": "plyaz-db create seed -i",
216
+ "db:reset": "plyaz-db reset --confirm --drop-schemas --migrate --schemas public,backoffice ",
217
+ "db:clear": "plyaz-db clear --confirm --schemas public,backoffice,audit",
218
+ "db:drop": "plyaz-db drop --confirm --all --schemas public,backoffice,audit",
145
219
  "audit": "pnpm audit",
146
220
  "audit:moderate": "pnpm audit --audit-level moderate",
147
221
  "audit:high": "pnpm audit --audit-level high",