servcraft 0.1.0 → 0.1.3

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 (217) hide show
  1. package/.claude/settings.local.json +30 -0
  2. package/.github/CODEOWNERS +18 -0
  3. package/.github/PULL_REQUEST_TEMPLATE.md +46 -0
  4. package/.github/dependabot.yml +59 -0
  5. package/.github/workflows/ci.yml +188 -0
  6. package/.github/workflows/release.yml +195 -0
  7. package/AUDIT.md +602 -0
  8. package/LICENSE +21 -0
  9. package/README.md +1102 -1
  10. package/dist/cli/index.cjs +2026 -2168
  11. package/dist/cli/index.cjs.map +1 -1
  12. package/dist/cli/index.js +2026 -2168
  13. package/dist/cli/index.js.map +1 -1
  14. package/dist/index.cjs +595 -616
  15. package/dist/index.cjs.map +1 -1
  16. package/dist/index.d.cts +114 -52
  17. package/dist/index.d.ts +114 -52
  18. package/dist/index.js +595 -616
  19. package/dist/index.js.map +1 -1
  20. package/docs/CLI-001_MULTI_DB_PLAN.md +546 -0
  21. package/docs/DATABASE_MULTI_ORM.md +399 -0
  22. package/docs/PHASE1_BREAKDOWN.md +346 -0
  23. package/docs/PROGRESS.md +550 -0
  24. package/docs/modules/ANALYTICS.md +226 -0
  25. package/docs/modules/API-VERSIONING.md +252 -0
  26. package/docs/modules/AUDIT.md +192 -0
  27. package/docs/modules/AUTH.md +431 -0
  28. package/docs/modules/CACHE.md +346 -0
  29. package/docs/modules/EMAIL.md +254 -0
  30. package/docs/modules/FEATURE-FLAG.md +291 -0
  31. package/docs/modules/I18N.md +294 -0
  32. package/docs/modules/MEDIA-PROCESSING.md +281 -0
  33. package/docs/modules/MFA.md +266 -0
  34. package/docs/modules/NOTIFICATION.md +311 -0
  35. package/docs/modules/OAUTH.md +237 -0
  36. package/docs/modules/PAYMENT.md +804 -0
  37. package/docs/modules/QUEUE.md +540 -0
  38. package/docs/modules/RATE-LIMIT.md +339 -0
  39. package/docs/modules/SEARCH.md +288 -0
  40. package/docs/modules/SECURITY.md +327 -0
  41. package/docs/modules/SESSION.md +382 -0
  42. package/docs/modules/SWAGGER.md +305 -0
  43. package/docs/modules/UPLOAD.md +296 -0
  44. package/docs/modules/USER.md +505 -0
  45. package/docs/modules/VALIDATION.md +294 -0
  46. package/docs/modules/WEBHOOK.md +270 -0
  47. package/docs/modules/WEBSOCKET.md +691 -0
  48. package/package.json +53 -38
  49. package/prisma/schema.prisma +395 -1
  50. package/src/cli/commands/add-module.ts +520 -87
  51. package/src/cli/commands/db.ts +3 -4
  52. package/src/cli/commands/docs.ts +256 -6
  53. package/src/cli/commands/generate.ts +12 -19
  54. package/src/cli/commands/init.ts +384 -214
  55. package/src/cli/index.ts +0 -4
  56. package/src/cli/templates/repository.ts +6 -1
  57. package/src/cli/templates/routes.ts +6 -21
  58. package/src/cli/utils/docs-generator.ts +6 -7
  59. package/src/cli/utils/env-manager.ts +717 -0
  60. package/src/cli/utils/field-parser.ts +16 -7
  61. package/src/cli/utils/interactive-prompt.ts +223 -0
  62. package/src/cli/utils/template-manager.ts +346 -0
  63. package/src/config/database.config.ts +183 -0
  64. package/src/config/env.ts +0 -10
  65. package/src/config/index.ts +0 -14
  66. package/src/core/server.ts +1 -1
  67. package/src/database/adapters/mongoose.adapter.ts +132 -0
  68. package/src/database/adapters/prisma.adapter.ts +118 -0
  69. package/src/database/connection.ts +190 -0
  70. package/src/database/interfaces/database.interface.ts +85 -0
  71. package/src/database/interfaces/index.ts +7 -0
  72. package/src/database/interfaces/repository.interface.ts +129 -0
  73. package/src/database/models/mongoose/index.ts +7 -0
  74. package/src/database/models/mongoose/payment.schema.ts +347 -0
  75. package/src/database/models/mongoose/user.schema.ts +154 -0
  76. package/src/database/prisma.ts +1 -4
  77. package/src/database/redis.ts +101 -0
  78. package/src/database/repositories/mongoose/index.ts +7 -0
  79. package/src/database/repositories/mongoose/payment.repository.ts +380 -0
  80. package/src/database/repositories/mongoose/user.repository.ts +255 -0
  81. package/src/database/seed.ts +6 -1
  82. package/src/index.ts +9 -20
  83. package/src/middleware/security.ts +2 -6
  84. package/src/modules/analytics/analytics.routes.ts +80 -0
  85. package/src/modules/analytics/analytics.service.ts +364 -0
  86. package/src/modules/analytics/index.ts +18 -0
  87. package/src/modules/analytics/types.ts +180 -0
  88. package/src/modules/api-versioning/index.ts +15 -0
  89. package/src/modules/api-versioning/types.ts +86 -0
  90. package/src/modules/api-versioning/versioning.middleware.ts +120 -0
  91. package/src/modules/api-versioning/versioning.routes.ts +54 -0
  92. package/src/modules/api-versioning/versioning.service.ts +189 -0
  93. package/src/modules/audit/audit.repository.ts +206 -0
  94. package/src/modules/audit/audit.service.ts +27 -59
  95. package/src/modules/auth/auth.controller.ts +2 -2
  96. package/src/modules/auth/auth.middleware.ts +3 -9
  97. package/src/modules/auth/auth.routes.ts +10 -107
  98. package/src/modules/auth/auth.service.ts +126 -23
  99. package/src/modules/auth/index.ts +3 -4
  100. package/src/modules/cache/cache.service.ts +367 -0
  101. package/src/modules/cache/index.ts +10 -0
  102. package/src/modules/cache/types.ts +44 -0
  103. package/src/modules/email/email.service.ts +3 -10
  104. package/src/modules/email/templates.ts +2 -8
  105. package/src/modules/feature-flag/feature-flag.repository.ts +303 -0
  106. package/src/modules/feature-flag/feature-flag.routes.ts +247 -0
  107. package/src/modules/feature-flag/feature-flag.service.ts +566 -0
  108. package/src/modules/feature-flag/index.ts +20 -0
  109. package/src/modules/feature-flag/types.ts +192 -0
  110. package/src/modules/i18n/i18n.middleware.ts +186 -0
  111. package/src/modules/i18n/i18n.routes.ts +191 -0
  112. package/src/modules/i18n/i18n.service.ts +456 -0
  113. package/src/modules/i18n/index.ts +18 -0
  114. package/src/modules/i18n/types.ts +118 -0
  115. package/src/modules/media-processing/index.ts +17 -0
  116. package/src/modules/media-processing/media-processing.routes.ts +111 -0
  117. package/src/modules/media-processing/media-processing.service.ts +245 -0
  118. package/src/modules/media-processing/types.ts +156 -0
  119. package/src/modules/mfa/index.ts +20 -0
  120. package/src/modules/mfa/mfa.repository.ts +206 -0
  121. package/src/modules/mfa/mfa.routes.ts +595 -0
  122. package/src/modules/mfa/mfa.service.ts +572 -0
  123. package/src/modules/mfa/totp.ts +150 -0
  124. package/src/modules/mfa/types.ts +57 -0
  125. package/src/modules/notification/index.ts +20 -0
  126. package/src/modules/notification/notification.repository.ts +356 -0
  127. package/src/modules/notification/notification.service.ts +483 -0
  128. package/src/modules/notification/types.ts +119 -0
  129. package/src/modules/oauth/index.ts +20 -0
  130. package/src/modules/oauth/oauth.repository.ts +219 -0
  131. package/src/modules/oauth/oauth.routes.ts +446 -0
  132. package/src/modules/oauth/oauth.service.ts +293 -0
  133. package/src/modules/oauth/providers/apple.provider.ts +250 -0
  134. package/src/modules/oauth/providers/facebook.provider.ts +181 -0
  135. package/src/modules/oauth/providers/github.provider.ts +248 -0
  136. package/src/modules/oauth/providers/google.provider.ts +189 -0
  137. package/src/modules/oauth/providers/twitter.provider.ts +214 -0
  138. package/src/modules/oauth/types.ts +94 -0
  139. package/src/modules/payment/index.ts +19 -0
  140. package/src/modules/payment/payment.repository.ts +733 -0
  141. package/src/modules/payment/payment.routes.ts +390 -0
  142. package/src/modules/payment/payment.service.ts +354 -0
  143. package/src/modules/payment/providers/mobile-money.provider.ts +274 -0
  144. package/src/modules/payment/providers/paypal.provider.ts +190 -0
  145. package/src/modules/payment/providers/stripe.provider.ts +215 -0
  146. package/src/modules/payment/types.ts +140 -0
  147. package/src/modules/queue/cron.ts +438 -0
  148. package/src/modules/queue/index.ts +87 -0
  149. package/src/modules/queue/queue.routes.ts +600 -0
  150. package/src/modules/queue/queue.service.ts +842 -0
  151. package/src/modules/queue/types.ts +222 -0
  152. package/src/modules/queue/workers.ts +366 -0
  153. package/src/modules/rate-limit/index.ts +59 -0
  154. package/src/modules/rate-limit/rate-limit.middleware.ts +134 -0
  155. package/src/modules/rate-limit/rate-limit.routes.ts +269 -0
  156. package/src/modules/rate-limit/rate-limit.service.ts +348 -0
  157. package/src/modules/rate-limit/stores/memory.store.ts +165 -0
  158. package/src/modules/rate-limit/stores/redis.store.ts +322 -0
  159. package/src/modules/rate-limit/types.ts +153 -0
  160. package/src/modules/search/adapters/elasticsearch.adapter.ts +326 -0
  161. package/src/modules/search/adapters/meilisearch.adapter.ts +261 -0
  162. package/src/modules/search/adapters/memory.adapter.ts +278 -0
  163. package/src/modules/search/index.ts +21 -0
  164. package/src/modules/search/search.service.ts +234 -0
  165. package/src/modules/search/types.ts +214 -0
  166. package/src/modules/security/index.ts +40 -0
  167. package/src/modules/security/sanitize.ts +223 -0
  168. package/src/modules/security/security-audit.service.ts +388 -0
  169. package/src/modules/security/security.middleware.ts +398 -0
  170. package/src/modules/session/index.ts +3 -0
  171. package/src/modules/session/session.repository.ts +159 -0
  172. package/src/modules/session/session.service.ts +340 -0
  173. package/src/modules/session/types.ts +38 -0
  174. package/src/modules/swagger/index.ts +7 -1
  175. package/src/modules/swagger/schema-builder.ts +16 -4
  176. package/src/modules/swagger/swagger.service.ts +9 -10
  177. package/src/modules/swagger/types.ts +0 -2
  178. package/src/modules/upload/index.ts +14 -0
  179. package/src/modules/upload/types.ts +83 -0
  180. package/src/modules/upload/upload.repository.ts +199 -0
  181. package/src/modules/upload/upload.routes.ts +311 -0
  182. package/src/modules/upload/upload.service.ts +448 -0
  183. package/src/modules/user/index.ts +3 -3
  184. package/src/modules/user/user.controller.ts +15 -9
  185. package/src/modules/user/user.repository.ts +237 -113
  186. package/src/modules/user/user.routes.ts +39 -164
  187. package/src/modules/user/user.service.ts +4 -3
  188. package/src/modules/validation/validator.ts +12 -17
  189. package/src/modules/webhook/index.ts +91 -0
  190. package/src/modules/webhook/retry.ts +196 -0
  191. package/src/modules/webhook/signature.ts +135 -0
  192. package/src/modules/webhook/types.ts +181 -0
  193. package/src/modules/webhook/webhook.repository.ts +358 -0
  194. package/src/modules/webhook/webhook.routes.ts +442 -0
  195. package/src/modules/webhook/webhook.service.ts +457 -0
  196. package/src/modules/websocket/features.ts +504 -0
  197. package/src/modules/websocket/index.ts +106 -0
  198. package/src/modules/websocket/middlewares.ts +298 -0
  199. package/src/modules/websocket/types.ts +181 -0
  200. package/src/modules/websocket/websocket.service.ts +692 -0
  201. package/src/utils/errors.ts +7 -0
  202. package/src/utils/pagination.ts +4 -1
  203. package/tests/helpers/db-check.ts +79 -0
  204. package/tests/integration/auth-redis.test.ts +94 -0
  205. package/tests/integration/cache-redis.test.ts +387 -0
  206. package/tests/integration/mongoose-repositories.test.ts +410 -0
  207. package/tests/integration/payment-prisma.test.ts +637 -0
  208. package/tests/integration/queue-bullmq.test.ts +417 -0
  209. package/tests/integration/user-prisma.test.ts +441 -0
  210. package/tests/integration/websocket-socketio.test.ts +552 -0
  211. package/tests/setup.ts +11 -9
  212. package/vitest.config.ts +3 -8
  213. package/npm-cache/_cacache/content-v2/sha512/1c/d0/03440d500a0487621aad1d6402978340698976602046db8e24fa03c01ee6c022c69b0582f969042d9442ee876ac35c038e960dd427d1e622fa24b8eb7dba +0 -0
  214. package/npm-cache/_cacache/content-v2/sha512/42/55/28b493ca491833e5aab0e9c3108d29ab3f36c248ca88f45d4630674fce9130959e56ae308797ac2b6328fa7f09a610b9550ed09cb971d039876d293fc69d +0 -0
  215. package/npm-cache/_cacache/content-v2/sha512/e0/12/f360dc9315ee5f17844a0c8c233ee6bf7c30837c4a02ea0d56c61c7f7ab21c0e958e50ed2c57c59f983c762b93056778c9009b2398ffc26def0183999b13 +0 -0
  216. package/npm-cache/_cacache/content-v2/sha512/ed/b0/fae1161902898f4c913c67d7f6cdf6be0665aec3b389b9c4f4f0a101ca1da59badf1b59c4e0030f5223023b8d63cfe501c46a32c20c895d4fb3f11ca2232 +0 -0
  217. package/npm-cache/_cacache/index-v5/58/94/c2cba79e0f16b4c10e95a87e32255741149e8222cc314a476aab67c39cc0 +0 -5
@@ -0,0 +1,206 @@
1
+ /**
2
+ * MFA Repository
3
+ * Prisma-based persistence for user MFA settings
4
+ */
5
+ import { Prisma } from '@prisma/client';
6
+ import type {
7
+ UserMFA as PrismaUserMFA,
8
+ MFAMethod as PrismaMFAMethod,
9
+ PrismaClient,
10
+ } from '@prisma/client';
11
+ import type { UserMFA, MFAMethod } from './types.js';
12
+
13
+ // Enum mappings (Prisma UPPERCASE ↔ Application lowercase)
14
+ const methodToPrisma: Record<MFAMethod, PrismaMFAMethod> = {
15
+ totp: 'TOTP',
16
+ sms: 'SMS',
17
+ email: 'EMAIL',
18
+ backup_codes: 'BACKUP_CODES',
19
+ };
20
+
21
+ const methodFromPrisma: Record<PrismaMFAMethod, MFAMethod> = {
22
+ TOTP: 'totp',
23
+ SMS: 'sms',
24
+ EMAIL: 'email',
25
+ BACKUP_CODES: 'backup_codes',
26
+ };
27
+
28
+ export class MFARepository {
29
+ constructor(private prisma: PrismaClient) {}
30
+
31
+ /**
32
+ * Create MFA settings for a user
33
+ */
34
+ async create(data: Omit<UserMFA, 'createdAt' | 'updatedAt'>): Promise<UserMFA> {
35
+ const mfa = await this.prisma.userMFA.create({
36
+ data: {
37
+ userId: data.userId,
38
+ enabled: data.enabled,
39
+ methods: data.methods.map((m) => methodToPrisma[m]),
40
+ totpSecret: data.totpSecret,
41
+ totpVerified: data.totpVerified,
42
+ backupCodes: data.backupCodes as Prisma.InputJsonValue,
43
+ backupCodesUsed: data.backupCodesUsed as Prisma.InputJsonValue,
44
+ phoneNumber: data.phoneNumber,
45
+ phoneVerified: data.phoneVerified,
46
+ email: data.email,
47
+ emailVerified: data.emailVerified,
48
+ lastUsed: data.lastUsed,
49
+ },
50
+ });
51
+
52
+ return this.mapFromPrisma(mfa);
53
+ }
54
+
55
+ /**
56
+ * Get MFA settings by user ID
57
+ */
58
+ async getByUserId(userId: string): Promise<UserMFA | null> {
59
+ const mfa = await this.prisma.userMFA.findUnique({
60
+ where: { userId },
61
+ });
62
+
63
+ return mfa ? this.mapFromPrisma(mfa) : null;
64
+ }
65
+
66
+ /**
67
+ * Update MFA settings
68
+ */
69
+ async update(
70
+ userId: string,
71
+ data: Partial<Omit<UserMFA, 'userId' | 'createdAt' | 'updatedAt'>>
72
+ ): Promise<UserMFA | null> {
73
+ try {
74
+ const updateData: Prisma.UserMFAUpdateInput = {};
75
+
76
+ if (data.enabled !== undefined) updateData.enabled = data.enabled;
77
+ if (data.methods !== undefined) {
78
+ updateData.methods = data.methods.map((m) => methodToPrisma[m]);
79
+ }
80
+ if (data.totpSecret !== undefined) updateData.totpSecret = data.totpSecret;
81
+ if (data.totpVerified !== undefined) updateData.totpVerified = data.totpVerified;
82
+ if (data.backupCodes !== undefined) {
83
+ updateData.backupCodes = data.backupCodes as Prisma.InputJsonValue;
84
+ }
85
+ if (data.backupCodesUsed !== undefined) {
86
+ updateData.backupCodesUsed = data.backupCodesUsed as Prisma.InputJsonValue;
87
+ }
88
+ if (data.phoneNumber !== undefined) updateData.phoneNumber = data.phoneNumber;
89
+ if (data.phoneVerified !== undefined) updateData.phoneVerified = data.phoneVerified;
90
+ if (data.email !== undefined) updateData.email = data.email;
91
+ if (data.emailVerified !== undefined) updateData.emailVerified = data.emailVerified;
92
+ if (data.lastUsed !== undefined) updateData.lastUsed = data.lastUsed;
93
+
94
+ const mfa = await this.prisma.userMFA.update({
95
+ where: { userId },
96
+ data: updateData,
97
+ });
98
+
99
+ return this.mapFromPrisma(mfa);
100
+ } catch (error) {
101
+ if (error instanceof Prisma.PrismaClientKnownRequestError && error.code === 'P2025') {
102
+ return null;
103
+ }
104
+ throw error;
105
+ }
106
+ }
107
+
108
+ /**
109
+ * Upsert MFA settings (create or update)
110
+ */
111
+ async upsert(data: Omit<UserMFA, 'createdAt' | 'updatedAt'>): Promise<UserMFA> {
112
+ const mfa = await this.prisma.userMFA.upsert({
113
+ where: { userId: data.userId },
114
+ create: {
115
+ userId: data.userId,
116
+ enabled: data.enabled,
117
+ methods: data.methods.map((m) => methodToPrisma[m]),
118
+ totpSecret: data.totpSecret,
119
+ totpVerified: data.totpVerified,
120
+ backupCodes: data.backupCodes as Prisma.InputJsonValue,
121
+ backupCodesUsed: data.backupCodesUsed as Prisma.InputJsonValue,
122
+ phoneNumber: data.phoneNumber,
123
+ phoneVerified: data.phoneVerified,
124
+ email: data.email,
125
+ emailVerified: data.emailVerified,
126
+ lastUsed: data.lastUsed,
127
+ },
128
+ update: {
129
+ enabled: data.enabled,
130
+ methods: data.methods.map((m) => methodToPrisma[m]),
131
+ totpSecret: data.totpSecret,
132
+ totpVerified: data.totpVerified,
133
+ backupCodes: data.backupCodes as Prisma.InputJsonValue,
134
+ backupCodesUsed: data.backupCodesUsed as Prisma.InputJsonValue,
135
+ phoneNumber: data.phoneNumber,
136
+ phoneVerified: data.phoneVerified,
137
+ email: data.email,
138
+ emailVerified: data.emailVerified,
139
+ lastUsed: data.lastUsed,
140
+ },
141
+ });
142
+
143
+ return this.mapFromPrisma(mfa);
144
+ }
145
+
146
+ /**
147
+ * Delete MFA settings for a user
148
+ */
149
+ async delete(userId: string): Promise<boolean> {
150
+ try {
151
+ await this.prisma.userMFA.delete({ where: { userId } });
152
+ return true;
153
+ } catch (error) {
154
+ if (error instanceof Prisma.PrismaClientKnownRequestError && error.code === 'P2025') {
155
+ return false;
156
+ }
157
+ throw error;
158
+ }
159
+ }
160
+
161
+ /**
162
+ * Check if MFA is enabled for a user
163
+ */
164
+ async isEnabled(userId: string): Promise<boolean> {
165
+ const mfa = await this.prisma.userMFA.findUnique({
166
+ where: { userId },
167
+ select: { enabled: true },
168
+ });
169
+
170
+ return mfa?.enabled ?? false;
171
+ }
172
+
173
+ /**
174
+ * Get enabled methods for a user
175
+ */
176
+ async getEnabledMethods(userId: string): Promise<MFAMethod[]> {
177
+ const mfa = await this.prisma.userMFA.findUnique({
178
+ where: { userId },
179
+ select: { methods: true },
180
+ });
181
+
182
+ return mfa?.methods.map((m) => methodFromPrisma[m]) ?? [];
183
+ }
184
+
185
+ /**
186
+ * Map Prisma model to application type
187
+ */
188
+ private mapFromPrisma(prismaMfa: PrismaUserMFA): UserMFA {
189
+ return {
190
+ userId: prismaMfa.userId,
191
+ enabled: prismaMfa.enabled,
192
+ methods: prismaMfa.methods.map((m) => methodFromPrisma[m]),
193
+ totpSecret: prismaMfa.totpSecret || undefined,
194
+ totpVerified: prismaMfa.totpVerified,
195
+ backupCodes: (prismaMfa.backupCodes as string[]) || undefined,
196
+ backupCodesUsed: (prismaMfa.backupCodesUsed as string[]) || undefined,
197
+ phoneNumber: prismaMfa.phoneNumber || undefined,
198
+ phoneVerified: prismaMfa.phoneVerified,
199
+ email: prismaMfa.email || undefined,
200
+ emailVerified: prismaMfa.emailVerified,
201
+ lastUsed: prismaMfa.lastUsed || undefined,
202
+ createdAt: prismaMfa.createdAt,
203
+ updatedAt: prismaMfa.updatedAt,
204
+ };
205
+ }
206
+ }