odac 1.1.0 → 1.3.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.
Files changed (117) hide show
  1. package/.agent/rules/coding.md +27 -0
  2. package/.agent/rules/memory.md +42 -0
  3. package/.agent/rules/project.md +30 -0
  4. package/.agent/rules/workflow.md +16 -0
  5. package/.github/workflows/release.yml +68 -1
  6. package/.github/workflows/test-coverage.yml +6 -5
  7. package/.husky/pre-commit +10 -0
  8. package/.husky/pre-push +13 -0
  9. package/.releaserc.js +1 -1
  10. package/CHANGELOG.md +99 -0
  11. package/README.md +16 -0
  12. package/bin/odac.js +196 -38
  13. package/client/odac.js +238 -171
  14. package/docs/backend/01-overview/03-development-server.md +38 -45
  15. package/docs/backend/02-structure/01-typical-project-layout.md +59 -26
  16. package/docs/backend/03-config/00-configuration-overview.md +6 -6
  17. package/docs/backend/03-config/01-database-connection.md +2 -2
  18. package/docs/backend/03-config/02-static-route-mapping-optional.md +1 -1
  19. package/docs/backend/03-config/03-request-timeout.md +1 -1
  20. package/docs/backend/03-config/04-environment-variables.md +4 -4
  21. package/docs/backend/03-config/05-early-hints.md +2 -2
  22. package/docs/backend/04-routing/03-api-and-data-routes.md +18 -0
  23. package/docs/backend/04-routing/07-cron-jobs.md +17 -1
  24. package/docs/backend/04-routing/09-websocket.md +14 -1
  25. package/docs/backend/05-controllers/01-how-to-build-a-controller.md +48 -3
  26. package/docs/backend/05-controllers/03-controller-classes.md +40 -20
  27. package/docs/backend/06-request-and-response/01-the-request-object-what-is-the-user-asking-for.md +17 -0
  28. package/docs/backend/07-views/10-styling-and-tailwind.md +93 -0
  29. package/docs/backend/08-database/01-getting-started.md +2 -2
  30. package/docs/backend/10-authentication/03-register.md +1 -1
  31. package/docs/backend/10-authentication/04-odac-register-forms.md +2 -2
  32. package/docs/backend/10-authentication/05-session-management.md +15 -1
  33. package/docs/backend/10-authentication/06-odac-login-forms.md +2 -2
  34. package/docs/backend/10-authentication/07-magic-links.md +1 -1
  35. package/docs/index.json +5 -1
  36. package/jest.config.js +1 -1
  37. package/package.json +18 -14
  38. package/src/Auth.js +58 -23
  39. package/src/Config.js +7 -7
  40. package/src/Database.js +1 -1
  41. package/src/Env.js +3 -1
  42. package/src/Ipc.js +7 -0
  43. package/src/Lang.js +9 -2
  44. package/src/Mail.js +19 -9
  45. package/src/Odac.js +56 -44
  46. package/src/Request.js +6 -2
  47. package/src/Route/Cron.js +58 -17
  48. package/src/Route/Internal.js +1 -1
  49. package/src/Route.js +375 -125
  50. package/src/Server.js +40 -3
  51. package/src/Storage.js +4 -0
  52. package/src/Token.js +6 -4
  53. package/src/Validator.js +24 -15
  54. package/src/Var.js +22 -6
  55. package/src/View/EarlyHints.js +43 -33
  56. package/src/View/Form.js +17 -11
  57. package/src/View.js +68 -12
  58. package/src/WebSocket.js +45 -12
  59. package/template/package.json +3 -1
  60. package/template/view/content/home.html +3 -3
  61. package/template/view/head/main.html +2 -2
  62. package/test/Client.test.js +168 -0
  63. package/test/Config.test.js +112 -0
  64. package/test/Lang.test.js +92 -0
  65. package/test/Odac.test.js +88 -0
  66. package/test/{framework/middleware.test.js → Route/Middleware.test.js} +2 -2
  67. package/test/{framework/Route.test.js → Route.test.js} +105 -1
  68. package/test/{framework/View → View}/EarlyHints.test.js +1 -1
  69. package/test/WebSocket.test.js +238 -0
  70. package/test/scripts/check-coverage.js +4 -4
  71. package/test/cli/Cli.test.js +0 -36
  72. package/test/core/Commands.test.js +0 -538
  73. package/test/core/Config.test.js +0 -1432
  74. package/test/core/Lang.test.js +0 -250
  75. package/test/core/Odac.test.js +0 -234
  76. package/test/core/Process.test.js +0 -156
  77. package/test/framework/WebSocket.test.js +0 -100
  78. package/test/server/Api.test.js +0 -647
  79. package/test/server/DNS.test.js +0 -2050
  80. package/test/server/DNS.test.js.bak +0 -2084
  81. package/test/server/Hub.test.js +0 -497
  82. package/test/server/Log.test.js +0 -73
  83. package/test/server/Mail.account.test_.js +0 -460
  84. package/test/server/Mail.init.test_.js +0 -411
  85. package/test/server/Mail.test_.js +0 -1340
  86. package/test/server/SSL.test_.js +0 -1491
  87. package/test/server/Server.test.js +0 -765
  88. package/test/server/Service.test_.js +0 -1127
  89. package/test/server/Subdomain.test.js +0 -440
  90. package/test/server/Web/Firewall.test.js +0 -175
  91. package/test/server/Web/Proxy.test.js +0 -397
  92. package/test/server/Web.test.js +0 -1494
  93. package/test/server/__mocks__/acme-client.js +0 -17
  94. package/test/server/__mocks__/bcrypt.js +0 -50
  95. package/test/server/__mocks__/child_process.js +0 -389
  96. package/test/server/__mocks__/crypto.js +0 -432
  97. package/test/server/__mocks__/fs.js +0 -450
  98. package/test/server/__mocks__/globalOdac.js +0 -227
  99. package/test/server/__mocks__/http.js +0 -575
  100. package/test/server/__mocks__/https.js +0 -272
  101. package/test/server/__mocks__/index.js +0 -249
  102. package/test/server/__mocks__/mail/server.js +0 -100
  103. package/test/server/__mocks__/mail/smtp.js +0 -31
  104. package/test/server/__mocks__/mailparser.js +0 -81
  105. package/test/server/__mocks__/net.js +0 -369
  106. package/test/server/__mocks__/node-forge.js +0 -328
  107. package/test/server/__mocks__/os.js +0 -320
  108. package/test/server/__mocks__/path.js +0 -291
  109. package/test/server/__mocks__/selfsigned.js +0 -8
  110. package/test/server/__mocks__/server/src/mail/server.js +0 -100
  111. package/test/server/__mocks__/server/src/mail/smtp.js +0 -31
  112. package/test/server/__mocks__/smtp-server.js +0 -106
  113. package/test/server/__mocks__/sqlite3.js +0 -394
  114. package/test/server/__mocks__/testFactories.js +0 -299
  115. package/test/server/__mocks__/testHelpers.js +0 -363
  116. package/test/server/__mocks__/tls.js +0 -229
  117. /package/template/{config.json → odac.json} +0 -0
@@ -1,432 +0,0 @@
1
- /**
2
- * Mock implementation of the crypto module for server tests
3
- * Provides comprehensive mocking of cryptographic operations
4
- */
5
-
6
- const {createMockEventEmitter} = require('./testHelpers')
7
-
8
- // Mock random data generation
9
- const generateMockRandomBytes = size => {
10
- const bytes = Buffer.alloc(size)
11
- for (let i = 0; i < size; i++) {
12
- bytes[i] = Math.floor(Math.random() * 256)
13
- }
14
- return bytes
15
- }
16
-
17
- // Mock hash generation
18
- const generateMockHash = (algorithm, data) => {
19
- // Simple mock hash based on algorithm and data
20
- const hashMap = {
21
- md5: '5d41402abc4b2a76b9719d911017c592',
22
- sha1: 'aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d',
23
- sha256: '2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae',
24
- sha512:
25
- 'f7fbba6e0636f890e56fbbf3283e524c6fa3204ae298382d624741d0dc6638326e282c41be5e4254d8820772c5518a2c5a8c0c7f7eda19594a7eb539453e1ed7'
26
- }
27
-
28
- const baseHash = hashMap[algorithm] || hashMap['sha256']
29
-
30
- // Modify hash based on data to make it somewhat unique
31
- if (data) {
32
- const dataStr = Buffer.isBuffer(data) ? data.toString() : String(data)
33
- const modifier = dataStr.length % 16
34
- return baseHash.substring(modifier) + baseHash.substring(0, modifier)
35
- }
36
-
37
- return baseHash
38
- }
39
-
40
- const createMockHash = algorithm => {
41
- const hash = createMockEventEmitter()
42
- let data = ''
43
-
44
- Object.assign(hash, {
45
- update: jest.fn((chunk, encoding = 'utf8') => {
46
- data += Buffer.isBuffer(chunk) ? chunk.toString() : String(chunk)
47
- return hash
48
- }),
49
-
50
- digest: jest.fn(encoding => {
51
- const hashValue = generateMockHash(algorithm, data)
52
-
53
- if (encoding === 'hex') {
54
- return hashValue
55
- } else if (encoding === 'base64') {
56
- return Buffer.from(hashValue, 'hex').toString('base64')
57
- } else if (encoding) {
58
- return Buffer.from(hashValue, 'hex').toString(encoding)
59
- } else {
60
- return Buffer.from(hashValue, 'hex')
61
- }
62
- })
63
- })
64
-
65
- return hash
66
- }
67
-
68
- const createMockHmac = (algorithm, key) => {
69
- const hmac = createMockEventEmitter()
70
- let data = ''
71
-
72
- Object.assign(hmac, {
73
- update: jest.fn((chunk, encoding = 'utf8') => {
74
- data += Buffer.isBuffer(chunk) ? chunk.toString() : String(chunk)
75
- return hmac
76
- }),
77
-
78
- digest: jest.fn(encoding => {
79
- // Create a mock HMAC by combining key and data
80
- const keyStr = Buffer.isBuffer(key) ? key.toString() : String(key)
81
- const combinedData = keyStr + data
82
- const hashValue = generateMockHash(algorithm, combinedData)
83
-
84
- if (encoding === 'hex') {
85
- return hashValue
86
- } else if (encoding === 'base64') {
87
- return Buffer.from(hashValue, 'hex').toString('base64')
88
- } else if (encoding) {
89
- return Buffer.from(hashValue, 'hex').toString(encoding)
90
- } else {
91
- return Buffer.from(hashValue, 'hex')
92
- }
93
- })
94
- })
95
-
96
- return hmac
97
- }
98
-
99
- const createMockCipher = (algorithm, password) => {
100
- const cipher = createMockEventEmitter()
101
- let data = Buffer.alloc(0)
102
-
103
- Object.assign(cipher, {
104
- update: jest.fn((chunk, inputEncoding, outputEncoding) => {
105
- const input = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, inputEncoding || 'utf8')
106
- data = Buffer.concat([data, input])
107
-
108
- // Mock encryption by XORing with a simple key
109
- const encrypted = Buffer.alloc(input.length)
110
- const key = Buffer.from(password || 'mockkey')
111
- for (let i = 0; i < input.length; i++) {
112
- encrypted[i] = input[i] ^ key[i % key.length]
113
- }
114
-
115
- return outputEncoding ? encrypted.toString(outputEncoding) : encrypted
116
- }),
117
-
118
- final: jest.fn(outputEncoding => {
119
- const final = Buffer.from('mockfinal')
120
- return outputEncoding ? final.toString(outputEncoding) : final
121
- }),
122
-
123
- setAutoPadding: jest.fn((autoPadding = true) => {
124
- cipher._autoPadding = autoPadding
125
- return cipher
126
- })
127
- })
128
-
129
- return cipher
130
- }
131
-
132
- const createMockDecipher = (algorithm, password) => {
133
- const decipher = createMockEventEmitter()
134
- let data = Buffer.alloc(0)
135
-
136
- Object.assign(decipher, {
137
- update: jest.fn((chunk, inputEncoding, outputEncoding) => {
138
- const input = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, inputEncoding || 'hex')
139
- data = Buffer.concat([data, input])
140
-
141
- // Mock decryption by XORing with the same key (reverse of encryption)
142
- const decrypted = Buffer.alloc(input.length)
143
- const key = Buffer.from(password || 'mockkey')
144
- for (let i = 0; i < input.length; i++) {
145
- decrypted[i] = input[i] ^ key[i % key.length]
146
- }
147
-
148
- return outputEncoding ? decrypted.toString(outputEncoding) : decrypted
149
- }),
150
-
151
- final: jest.fn(outputEncoding => {
152
- const final = Buffer.from('mockfinal')
153
- return outputEncoding ? final.toString(outputEncoding) : final
154
- }),
155
-
156
- setAutoPadding: jest.fn((autoPadding = true) => {
157
- decipher._autoPadding = autoPadding
158
- return decipher
159
- })
160
- })
161
-
162
- return decipher
163
- }
164
-
165
- const crypto = {
166
- // Hash functions
167
- createHash: jest.fn(algorithm => {
168
- return createMockHash(algorithm)
169
- }),
170
-
171
- createHmac: jest.fn((algorithm, key) => {
172
- return createMockHmac(algorithm, key)
173
- }),
174
-
175
- // Cipher functions
176
- createCipher: jest.fn((algorithm, password) => {
177
- return createMockCipher(algorithm, password)
178
- }),
179
-
180
- createDecipher: jest.fn((algorithm, password) => {
181
- return createMockDecipher(algorithm, password)
182
- }),
183
-
184
- createCipheriv: jest.fn((algorithm, key, iv) => {
185
- return createMockCipher(algorithm, key)
186
- }),
187
-
188
- createDecipheriv: jest.fn((algorithm, key, iv) => {
189
- return createMockDecipher(algorithm, key)
190
- }),
191
-
192
- // Random functions
193
- randomBytes: jest.fn((size, callback) => {
194
- const bytes = generateMockRandomBytes(size)
195
-
196
- if (callback) {
197
- setTimeout(() => callback(null, bytes), 0)
198
- return
199
- }
200
-
201
- return bytes
202
- }),
203
-
204
- randomFillSync: jest.fn((buffer, offset, size) => {
205
- if (!Buffer.isBuffer(buffer)) {
206
- throw new TypeError('buffer must be a Buffer')
207
- }
208
-
209
- offset = offset || 0
210
- size = size || buffer.length - offset
211
-
212
- const randomData = generateMockRandomBytes(size)
213
- randomData.copy(buffer, offset)
214
-
215
- return buffer
216
- }),
217
-
218
- randomFill: jest.fn((buffer, offset, size, callback) => {
219
- if (typeof offset === 'function') {
220
- callback = offset
221
- offset = 0
222
- size = buffer.length
223
- } else if (typeof size === 'function') {
224
- callback = size
225
- size = buffer.length - offset
226
- }
227
-
228
- setTimeout(() => {
229
- try {
230
- crypto.randomFillSync(buffer, offset, size)
231
- callback(null, buffer)
232
- } catch (error) {
233
- callback(error)
234
- }
235
- }, 0)
236
- }),
237
-
238
- randomInt: jest.fn((min, max, callback) => {
239
- if (typeof min === 'function') {
240
- callback = min
241
- min = 0
242
- max = 2147483647
243
- } else if (typeof max === 'function') {
244
- callback = max
245
- max = min
246
- min = 0
247
- }
248
-
249
- const randomValue = Math.floor(Math.random() * (max - min)) + min
250
-
251
- if (callback) {
252
- setTimeout(() => callback(null, randomValue), 0)
253
- return
254
- }
255
-
256
- return randomValue
257
- }),
258
-
259
- randomUUID: jest.fn(() => {
260
- // Generate a mock UUID v4
261
- const hex = '0123456789abcdef'
262
- let uuid = ''
263
-
264
- for (let i = 0; i < 36; i++) {
265
- if (i === 8 || i === 13 || i === 18 || i === 23) {
266
- uuid += '-'
267
- } else if (i === 14) {
268
- uuid += '4' // Version 4
269
- } else if (i === 19) {
270
- uuid += hex[Math.floor(Math.random() * 4) + 8] // Variant bits
271
- } else {
272
- uuid += hex[Math.floor(Math.random() * 16)]
273
- }
274
- }
275
-
276
- return uuid
277
- }),
278
-
279
- // Key generation
280
- generateKeyPairSync: jest.fn((type, options = {}) => {
281
- const mockPrivateKey = {
282
- asymmetricKeyType: type,
283
- asymmetricKeySize: options.modulusLength || 2048,
284
- export: jest.fn((options = {}) => {
285
- if (options.format === 'pem') {
286
- return '-----BEGIN PRIVATE KEY-----\nMockPrivateKeyData\n-----END PRIVATE KEY-----'
287
- }
288
- return Buffer.from('mockprivatekeydata')
289
- })
290
- }
291
-
292
- const mockPublicKey = {
293
- asymmetricKeyType: type,
294
- asymmetricKeySize: options.modulusLength || 2048,
295
- export: jest.fn((options = {}) => {
296
- if (options.format === 'pem') {
297
- return '-----BEGIN PUBLIC KEY-----\nMockPublicKeyData\n-----END PUBLIC KEY-----'
298
- }
299
- return Buffer.from('mockpublickeydata')
300
- })
301
- }
302
-
303
- return {
304
- privateKey: mockPrivateKey,
305
- publicKey: mockPublicKey
306
- }
307
- }),
308
-
309
- generateKeyPair: jest.fn((type, options, callback) => {
310
- if (typeof options === 'function') {
311
- callback = options
312
- options = {}
313
- }
314
-
315
- setTimeout(() => {
316
- try {
317
- const keyPair = crypto.generateKeyPairSync(type, options)
318
- callback(null, keyPair.publicKey, keyPair.privateKey)
319
- } catch (error) {
320
- callback(error)
321
- }
322
- }, 0)
323
- }),
324
-
325
- // Signing and verification
326
- createSign: jest.fn(algorithm => {
327
- const sign = createMockEventEmitter()
328
- let data = ''
329
-
330
- Object.assign(sign, {
331
- update: jest.fn((chunk, encoding = 'utf8') => {
332
- data += Buffer.isBuffer(chunk) ? chunk.toString() : String(chunk)
333
- return sign
334
- }),
335
-
336
- sign: jest.fn((privateKey, outputEncoding) => {
337
- const signature = generateMockHash('sha256', data + 'signature')
338
-
339
- if (outputEncoding === 'hex') {
340
- return signature
341
- } else if (outputEncoding === 'base64') {
342
- return Buffer.from(signature, 'hex').toString('base64')
343
- } else if (outputEncoding) {
344
- return Buffer.from(signature, 'hex').toString(outputEncoding)
345
- } else {
346
- return Buffer.from(signature, 'hex')
347
- }
348
- })
349
- })
350
-
351
- return sign
352
- }),
353
-
354
- createVerify: jest.fn(algorithm => {
355
- const verify = createMockEventEmitter()
356
- let data = ''
357
-
358
- Object.assign(verify, {
359
- update: jest.fn((chunk, encoding = 'utf8') => {
360
- data += Buffer.isBuffer(chunk) ? chunk.toString() : String(chunk)
361
- return verify
362
- }),
363
-
364
- verify: jest.fn((publicKey, signature, signatureEncoding) => {
365
- // Mock verification - always return true for testing
366
- return true
367
- })
368
- })
369
-
370
- return verify
371
- }),
372
-
373
- // Constants
374
- constants: {
375
- // OpenSSL constants
376
- OPENSSL_VERSION_NUMBER: 0x1010100f,
377
- SSL_OP_ALL: 0x80000bff,
378
- SSL_OP_NO_SSLv2: 0x01000000,
379
- SSL_OP_NO_SSLv3: 0x02000000,
380
- SSL_OP_NO_TLSv1: 0x04000000,
381
- SSL_OP_NO_TLSv1_1: 0x10000000,
382
- SSL_OP_NO_TLSv1_2: 0x08000000,
383
-
384
- // RSA padding
385
- RSA_PKCS1_PADDING: 1,
386
- RSA_SSLV23_PADDING: 2,
387
- RSA_NO_PADDING: 3,
388
- RSA_PKCS1_OAEP_PADDING: 4,
389
- RSA_X931_PADDING: 5,
390
- RSA_PKCS1_PSS_PADDING: 6
391
- },
392
-
393
- // Utility functions
394
- timingSafeEqual: jest.fn((a, b) => {
395
- if (!Buffer.isBuffer(a) || !Buffer.isBuffer(b)) {
396
- throw new TypeError('Arguments must be Buffers')
397
- }
398
-
399
- if (a.length !== b.length) {
400
- return false
401
- }
402
-
403
- return a.equals(b)
404
- }),
405
-
406
- // Test helpers
407
- __setMockRandomBytes: mockFn => {
408
- crypto.randomBytes.mockImplementation(mockFn)
409
- },
410
-
411
- __setMockHash: (algorithm, mockHash) => {
412
- const originalCreateHash = crypto.createHash
413
- crypto.createHash.mockImplementation(alg => {
414
- if (alg === algorithm) {
415
- const hash = originalCreateHash(alg)
416
- hash.digest.mockReturnValue(mockHash)
417
- return hash
418
- }
419
- return originalCreateHash(alg)
420
- })
421
- },
422
-
423
- __resetMocks: () => {
424
- Object.values(crypto).forEach(fn => {
425
- if (jest.isMockFunction(fn)) {
426
- fn.mockClear()
427
- }
428
- })
429
- }
430
- }
431
-
432
- module.exports = crypto