@adaptivestone/framework 5.0.0 → 5.1.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 (81) hide show
  1. package/CHANGELOG.md +68 -176
  2. package/dist/commands/OpenApi.d.ts +26 -0
  3. package/dist/commands/OpenApi.js +101 -0
  4. package/dist/commands/OpenApi.js.map +1 -0
  5. package/dist/commands/Routes.d.ts +17 -0
  6. package/dist/commands/Routes.js +35 -0
  7. package/dist/commands/Routes.js.map +1 -0
  8. package/dist/config/cache.d.ts +14 -0
  9. package/dist/config/cache.js +14 -0
  10. package/dist/config/cache.js.map +1 -0
  11. package/dist/controllers/index.js +28 -4
  12. package/dist/controllers/index.js.map +1 -1
  13. package/dist/helpers/appInstance.d.ts +6 -0
  14. package/dist/helpers/appInstance.js +13 -0
  15. package/dist/helpers/appInstance.js.map +1 -1
  16. package/dist/modules/BaseModel.d.ts +10 -0
  17. package/dist/modules/BaseModel.js +25 -0
  18. package/dist/modules/BaseModel.js.map +1 -1
  19. package/dist/server.d.ts +20 -1
  20. package/dist/server.js +24 -1
  21. package/dist/server.js.map +1 -1
  22. package/dist/services/cache/Cache.d.ts +3 -4
  23. package/dist/services/cache/Cache.js +43 -34
  24. package/dist/services/cache/Cache.js.map +1 -1
  25. package/dist/services/cache/CacheDriver.d.ts +19 -0
  26. package/dist/services/cache/CacheDriver.js +2 -0
  27. package/dist/services/cache/CacheDriver.js.map +1 -0
  28. package/dist/services/cache/drivers/MemoryDriver.d.ts +14 -0
  29. package/dist/services/cache/drivers/MemoryDriver.js +40 -0
  30. package/dist/services/cache/drivers/MemoryDriver.js.map +1 -0
  31. package/dist/services/cache/drivers/RedisDriver.d.ts +22 -0
  32. package/dist/services/cache/drivers/RedisDriver.js +44 -0
  33. package/dist/services/cache/drivers/RedisDriver.js.map +1 -0
  34. package/dist/services/documentation/OpenApiGenerator.d.ts +39 -0
  35. package/dist/services/documentation/OpenApiGenerator.js +296 -0
  36. package/dist/services/documentation/OpenApiGenerator.js.map +1 -0
  37. package/dist/services/http/HttpServer.d.ts +23 -0
  38. package/dist/services/http/HttpServer.js +57 -0
  39. package/dist/services/http/HttpServer.js.map +1 -1
  40. package/dist/services/http/builtinErrorHandlers.d.ts +36 -0
  41. package/dist/services/http/builtinErrorHandlers.js +71 -0
  42. package/dist/services/http/builtinErrorHandlers.js.map +1 -0
  43. package/dist/services/http/httpErrors.d.ts +30 -0
  44. package/dist/services/http/httpErrors.js +46 -0
  45. package/dist/services/http/httpErrors.js.map +1 -0
  46. package/dist/services/http/middleware/AbstractMiddleware.d.ts +25 -7
  47. package/dist/services/http/middleware/AbstractMiddleware.js +14 -0
  48. package/dist/services/http/middleware/AbstractMiddleware.js.map +1 -1
  49. package/dist/services/http/middleware/GetUserByToken.d.ts +13 -0
  50. package/dist/services/http/middleware/GetUserByToken.js +5 -1
  51. package/dist/services/http/middleware/GetUserByToken.js.map +1 -1
  52. package/dist/services/http/middleware/RateLimiter.d.ts +8 -2
  53. package/dist/services/http/middleware/RateLimiter.js +38 -13
  54. package/dist/services/http/middleware/RateLimiter.js.map +1 -1
  55. package/dist/services/http/routing/RouteNode.d.ts +2 -0
  56. package/dist/services/validate/drivers/StandardSchemaDriver.d.ts +5 -2
  57. package/dist/services/validate/drivers/StandardSchemaDriver.js +24 -3
  58. package/dist/services/validate/drivers/StandardSchemaDriver.js.map +1 -1
  59. package/dist/services/validate/drivers/YupDriver.js +91 -2
  60. package/dist/services/validate/drivers/YupDriver.js.map +1 -1
  61. package/dist/services/validate/types.d.ts +7 -4
  62. package/dist/tests/globalSetupNodeTest.d.ts +2 -0
  63. package/dist/tests/globalSetupNodeTest.js +23 -0
  64. package/dist/tests/globalSetupNodeTest.js.map +1 -0
  65. package/dist/tests/globalSetupVitest.js +6 -13
  66. package/dist/tests/globalSetupVitest.js.map +1 -1
  67. package/dist/tests/nodeRunner.node-test.d.ts +14 -0
  68. package/dist/tests/nodeRunner.node-test.js +41 -0
  69. package/dist/tests/nodeRunner.node-test.js.map +1 -0
  70. package/dist/tests/nodeRunnerShared.node-test.d.ts +14 -0
  71. package/dist/tests/nodeRunnerShared.node-test.js +39 -0
  72. package/dist/tests/nodeRunnerShared.node-test.js.map +1 -0
  73. package/dist/tests/setupFramework.d.ts +33 -0
  74. package/dist/tests/setupFramework.js +134 -0
  75. package/dist/tests/setupFramework.js.map +1 -0
  76. package/dist/tests/setupNodeTest.d.ts +1 -0
  77. package/dist/tests/setupNodeTest.js +16 -0
  78. package/dist/tests/setupNodeTest.js.map +1 -0
  79. package/dist/tests/setupVitest.js +8 -99
  80. package/dist/tests/setupVitest.js.map +1 -1
  81. package/package.json +12 -5
@@ -0,0 +1,23 @@
1
+ /**
2
+ * node:test global setup/teardown — the `--test-global-setup` entry module.
3
+ *
4
+ * Runs ONCE before/after the entire test run: node:test's equivalent of vitest's
5
+ * `globalSetup` (see `globalSetupVitest.ts`). It boots the in-memory Mongo and
6
+ * publishes `TEST_MONGO_URI`; the child test processes inherit it. This is the
7
+ * single entry point for the node:test suite — no per-file Mongo init, no manual
8
+ * process spawning.
9
+ *
10
+ * Wire it up (see the `test:node` script):
11
+ * node --test --test-global-setup=./src/tests/globalSetupNodeTest.ts 'glob'
12
+ *
13
+ * `--test-global-setup` is Stability 1 (experimental, added in Node v24) — the
14
+ * only API surface used here is env-var hand-off, which is the stable subset.
15
+ */
16
+ import { startTestMongo, stopTestMongo } from "./setupFramework.js";
17
+ export async function globalSetup() {
18
+ await startTestMongo(); // publishes process.env.TEST_MONGO_URI for child processes
19
+ }
20
+ export async function globalTeardown() {
21
+ await stopTestMongo();
22
+ }
23
+ //# sourceMappingURL=globalSetupNodeTest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalSetupNodeTest.js","sourceRoot":"","sources":["../../src/tests/globalSetupNodeTest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,cAAc,EAAE,CAAC,CAAC,2DAA2D;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}
@@ -1,29 +1,22 @@
1
- import { MongoMemoryReplSet } from 'mongodb-memory-server';
1
+ // vitest globalSetup: runs once per test run. Delegates the in-memory Mongo
2
+ // lifecycle to the runner-agnostic `setupFramework.ts`.
3
+ import { startTestMongo, stopTestMongo } from "./setupFramework.js";
2
4
  let isTeardown = false;
3
- let mongoMemoryServerInstance;
4
5
  const setup = async () => {
5
6
  console.log('GLOBAL SETUP PREPARE RUNNING...');
6
7
  console.time('GLOBAL TEST PREPARE. DONE');
7
- mongoMemoryServerInstance = await MongoMemoryReplSet.create({
8
- // binary: { version: '4.4.6' },
9
- replSet: { count: 1, storageEngine: 'wiredTiger' },
10
- });
11
- await mongoMemoryServerInstance.waitUntilRunning();
12
- const connectionStringMongo = await mongoMemoryServerInstance.getUri('__DB_TO_REPLACE__');
13
- process.env.TEST_MONGO_URI = connectionStringMongo;
14
- // console.info('MONGO_URI: ', connectionStringMongo);
8
+ await startTestMongo();
15
9
  console.timeEnd('GLOBAL TEST PREPARE. DONE');
16
10
  };
17
11
  const teardown = async () => {
18
12
  if (isTeardown) {
19
13
  throw new Error('teardown called twice');
20
14
  }
21
- console.time('GLOBAL TEARDOWN RUNNING. DONE');
22
15
  isTeardown = true;
23
16
  console.log('GLOBAL TEARDOWN RUNNING...');
24
- await mongoMemoryServerInstance.stop();
17
+ console.time('GLOBAL TEARDOWN RUNNING. DONE');
18
+ await stopTestMongo();
25
19
  console.timeEnd('GLOBAL TEARDOWN RUNNING. DONE');
26
- return Promise.resolve();
27
20
  };
28
21
  export { setup, teardown };
29
22
  //# sourceMappingURL=globalSetupVitest.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"globalSetupVitest.js","sourceRoot":"","sources":["../../src/tests/globalSetupVitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,IAAI,UAAU,GAAG,KAAK,CAAC;AACvB,IAAI,yBAA6C,CAAC;AAElD,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,yBAAyB,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC;QAC1D,gCAAgC;QAChC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE;KACnD,CAAC,CAAC;IACH,MAAM,yBAAyB,CAAC,gBAAgB,EAAE,CAAC;IACnD,MAAM,qBAAqB,GACzB,MAAM,yBAAyB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,qBAAqB,CAAC;IACnD,sDAAsD;IACtD,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE9C,UAAU,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,MAAM,yBAAyB,CAAC,IAAI,EAAE,CAAC;IACvC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAEjD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC"}
1
+ {"version":3,"file":"globalSetupVitest.js","sourceRoot":"","sources":["../../src/tests/globalSetupVitest.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wDAAwD;AACxD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpE,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,MAAM,cAAc,EAAE,CAAC;IACvB,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,UAAU,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,MAAM,aAAa,EAAE,CAAC;IACtB,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * node:test suite — full per-file lifecycle against the shared Mongo.
3
+ *
4
+ * Mongo is started ONCE by the global-setup entry module
5
+ * (`globalSetupNodeTest.ts`, wired via `--test-global-setup` — see the
6
+ * `test:node` script). This file never touches Mongo init; it only boots a
7
+ * per-suite `Server` against the shared instance (via the shipped
8
+ * `setupNodeTest.ts` glue) and exercises the full stack: a live HTTP request and
9
+ * a Mongo write/read round-trip.
10
+ *
11
+ * Runs as part of `npm run test:node` (it shares one Mongo with the other
12
+ * `*.node-test.ts` files). The `.node-test.ts` suffix keeps vitest's glob away.
13
+ */
14
+ import './setupNodeTest.ts';
@@ -0,0 +1,41 @@
1
+ /**
2
+ * node:test suite — full per-file lifecycle against the shared Mongo.
3
+ *
4
+ * Mongo is started ONCE by the global-setup entry module
5
+ * (`globalSetupNodeTest.ts`, wired via `--test-global-setup` — see the
6
+ * `test:node` script). This file never touches Mongo init; it only boots a
7
+ * per-suite `Server` against the shared instance (via the shipped
8
+ * `setupNodeTest.ts` glue) and exercises the full stack: a live HTTP request and
9
+ * a Mongo write/read round-trip.
10
+ *
11
+ * Runs as part of `npm run test:node` (it shares one Mongo with the other
12
+ * `*.node-test.ts` files). The `.node-test.ts` suffix keeps vitest's glob away.
13
+ */
14
+ import "./setupNodeTest.js";
15
+ import assert from 'node:assert/strict';
16
+ import { describe, it } from 'node:test';
17
+ import mongoose from 'mongoose';
18
+ import { appInstance } from "../helpers/appInstance.js";
19
+ import { createDefaultTestUser, getTestServerURL } from "./testHelpers.js";
20
+ describe('node:test: server boot + Mongo round-trip', () => {
21
+ it('booted a Server connected to the shared Mongo', async () => {
22
+ await mongoose.connection.asPromise(); // resolves once the connection is open
23
+ assert.equal(mongoose.connection.readyState, 1); // 1 === connected
24
+ assert.ok(appInstance, 'app instance should be set');
25
+ });
26
+ it('serves HTTP from the booted server', async () => {
27
+ const { status } = await fetch(getTestServerURL('/')).catch(() => ({
28
+ status: 500,
29
+ }));
30
+ assert.equal(status, 200);
31
+ });
32
+ it('round-trips through Mongo (create + read a user via the model)', async () => {
33
+ const result = await createDefaultTestUser();
34
+ assert.ok(result, 'default user should be created');
35
+ assert.ok(result.token, 'an auth token should be generated');
36
+ const User = appInstance.getModel('User');
37
+ const found = await User.findOne({ email: 'test@test.com' });
38
+ assert.ok(found, 'created user should be readable back from Mongo');
39
+ });
40
+ });
41
+ //# sourceMappingURL=nodeRunner.node-test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nodeRunner.node-test.js","sourceRoot":"","sources":["../../src/tests/nodeRunner.node-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,uCAAuC;QAC9E,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;QACnE,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACjE,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QAE7D,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAqB,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,iDAAiD,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Smoke test for the **extracted / shared** Mongo-init pattern under `node:test`.
3
+ *
4
+ * This is a SECOND suite file in the same run: it proves the global-setup entry
5
+ * (`globalSetupNodeTest.ts`, wired via `--test-global-setup`) starts Mongo ONCE
6
+ * and shares it across every `*.node-test.ts` file via `TEST_MONGO_URI`. This
7
+ * file starts nothing itself — it asserts the URI arrived from the entry module
8
+ * and that it got its own fresh per-suite DB off the shared instance.
9
+ *
10
+ * The per-file server lifecycle comes from the shipped `setupNodeTest.ts` glue
11
+ * (it wires `before(startTestServer)` etc. but never touches Mongo init). Runs as
12
+ * part of `npm run test:node`.
13
+ */
14
+ import './setupNodeTest.ts';
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Smoke test for the **extracted / shared** Mongo-init pattern under `node:test`.
3
+ *
4
+ * This is a SECOND suite file in the same run: it proves the global-setup entry
5
+ * (`globalSetupNodeTest.ts`, wired via `--test-global-setup`) starts Mongo ONCE
6
+ * and shares it across every `*.node-test.ts` file via `TEST_MONGO_URI`. This
7
+ * file starts nothing itself — it asserts the URI arrived from the entry module
8
+ * and that it got its own fresh per-suite DB off the shared instance.
9
+ *
10
+ * The per-file server lifecycle comes from the shipped `setupNodeTest.ts` glue
11
+ * (it wires `before(startTestServer)` etc. but never touches Mongo init). Runs as
12
+ * part of `npm run test:node`.
13
+ */
14
+ import "./setupNodeTest.js";
15
+ import assert from 'node:assert/strict';
16
+ import { describe, it } from 'node:test';
17
+ import mongoose from 'mongoose';
18
+ import { getTestServerURL } from "./testHelpers.js";
19
+ describe('node:test: second suite sharing the global Mongo', () => {
20
+ it('consumes a TEST_MONGO_URI provided by the global-setup entry', () => {
21
+ // This file never calls startTestMongo — the URI must come from the runner.
22
+ assert.ok(process.env.TEST_MONGO_URI, 'TEST_MONGO_URI must be published before the test process starts');
23
+ assert.match(process.env.TEST_MONGO_URI, /^mongodb:\/\//);
24
+ });
25
+ it('boots the per-suite Server against the shared Mongo', async () => {
26
+ await mongoose.connection.asPromise(); // resolves once the connection is open
27
+ assert.equal(mongoose.connection.readyState, 1);
28
+ // startTestServer derives a fresh per-suite DB (TEST_<uuid>) from the shared
29
+ // URI — proof the extracted init flowed through to this process correctly.
30
+ assert.match(mongoose.connection.name, /^TEST_/);
31
+ });
32
+ it('serves HTTP from the booted server', async () => {
33
+ const { status } = await fetch(getTestServerURL('/')).catch(() => ({
34
+ status: 500,
35
+ }));
36
+ assert.equal(status, 200);
37
+ });
38
+ });
39
+ //# sourceMappingURL=nodeRunnerShared.node-test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nodeRunnerShared.node-test.js","sourceRoot":"","sources":["../../src/tests/nodeRunnerShared.node-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,4EAA4E;QAC5E,MAAM,CAAC,EAAE,CACP,OAAO,CAAC,GAAG,CAAC,cAAc,EAC1B,iEAAiE,CAClE,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,uCAAuC;QAC9E,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAChD,6EAA6E;QAC7E,2EAA2E;QAC3E,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACjE,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Runner-agnostic test setup. Plain async functions with **no test-runner
3
+ * import** (no vitest, no `node:test`) so the framework's test lifecycle can be
4
+ * driven from either runner — or programmatically.
5
+ *
6
+ * - vitest glue: `setupVitest.ts` (per-file) + `globalSetupVitest.ts` (once).
7
+ * - node:test glue: `setupNodeTest.ts`.
8
+ *
9
+ * Lifecycle pieces:
10
+ * - `startTestMongo` / `stopTestMongo` — once per run; spins up an in-memory
11
+ * Mongo replica set and publishes `process.env.TEST_MONGO_URI`.
12
+ * - `startTestServer` / `stopTestServer` — once per test file/suite; boots a
13
+ * framework `Server` against a fresh DB and tears it down.
14
+ * - `setTestRedisNamespace` / `clearTestRedisNamespace` — per test; isolate the
15
+ * cache/rate-limiter keyspace.
16
+ */
17
+ import Server from '../server.ts';
18
+ /** Start an in-memory Mongo replica set and publish `TEST_MONGO_URI`. */
19
+ export declare function startTestMongo(): Promise<string>;
20
+ /** Stop the in-memory Mongo replica set. */
21
+ export declare function stopTestMongo(): Promise<void>;
22
+ /**
23
+ * Boot a framework `Server` against a fresh per-suite database (derived from
24
+ * `TEST_MONGO_URI`) and start its HTTP server on a random port. Registers the
25
+ * instance via `setServerInstance` so `testHelpers` can reach it.
26
+ */
27
+ export declare function startTestServer(): Promise<Server>;
28
+ /** Shut down the server, drop its database, and disconnect mongoose. */
29
+ export declare function stopTestServer(): Promise<void>;
30
+ /** Point the cache/rate-limiter keyspace at a fresh random namespace. */
31
+ export declare function setTestRedisNamespace(): void;
32
+ /** Best-effort clear of the current test's redis namespace (no-op without redis). */
33
+ export declare function clearTestRedisNamespace(): Promise<void>;
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Runner-agnostic test setup. Plain async functions with **no test-runner
3
+ * import** (no vitest, no `node:test`) so the framework's test lifecycle can be
4
+ * driven from either runner — or programmatically.
5
+ *
6
+ * - vitest glue: `setupVitest.ts` (per-file) + `globalSetupVitest.ts` (once).
7
+ * - node:test glue: `setupNodeTest.ts`.
8
+ *
9
+ * Lifecycle pieces:
10
+ * - `startTestMongo` / `stopTestMongo` — once per run; spins up an in-memory
11
+ * Mongo replica set and publishes `process.env.TEST_MONGO_URI`.
12
+ * - `startTestServer` / `stopTestServer` — once per test file/suite; boots a
13
+ * framework `Server` against a fresh DB and tears it down.
14
+ * - `setTestRedisNamespace` / `clearTestRedisNamespace` — per test; isolate the
15
+ * cache/rate-limiter keyspace.
16
+ */
17
+ import crypto from 'node:crypto';
18
+ import path from 'node:path';
19
+ import mongoose from 'mongoose'; // we do not need create indexes on tests
20
+ import { clearNamespace } from "../helpers/redis/clearNamespace.js";
21
+ import Server from "../server.js";
22
+ import { serverInstance, setServerInstance } from "./testHelpers.js";
23
+ mongoose.set('autoIndex', false);
24
+ const basePath = new URL('.', import.meta.url).pathname;
25
+ // ── Global Mongo lifecycle (once per test run) ──────────────────────────────
26
+ // Only `.stop()` is needed at module scope; the full type comes from the lazy
27
+ // import inside `startTestMongo` so merely importing this module doesn't pull in
28
+ // `mongodb-memory-server` (an optional peer — a node:test consumer may supply
29
+ // `TEST_MONGO_URI` from an external Mongo instead).
30
+ let mongoServer = null;
31
+ /** Start an in-memory Mongo replica set and publish `TEST_MONGO_URI`. */
32
+ export async function startTestMongo() {
33
+ const { MongoMemoryReplSet } = await import('mongodb-memory-server');
34
+ const instance = await MongoMemoryReplSet.create({
35
+ replSet: { count: 1, storageEngine: 'wiredTiger' },
36
+ });
37
+ await instance.waitUntilRunning();
38
+ mongoServer = instance;
39
+ const uri = await instance.getUri('__DB_TO_REPLACE__');
40
+ process.env.TEST_MONGO_URI = uri;
41
+ return uri;
42
+ }
43
+ /** Stop the in-memory Mongo replica set. */
44
+ export async function stopTestMongo() {
45
+ await mongoServer?.stop();
46
+ mongoServer = null;
47
+ }
48
+ // ── Per-suite server lifecycle ──────────────────────────────────────────────
49
+ /**
50
+ * Boot a framework `Server` against a fresh per-suite database (derived from
51
+ * `TEST_MONGO_URI`) and start its HTTP server on a random port. Registers the
52
+ * instance via `setServerInstance` so `testHelpers` can reach it.
53
+ */
54
+ export async function startTestServer() {
55
+ process.env.LOGGER_CONSOLE_LEVEL = 'error';
56
+ process.env.AUTH_SALT = crypto.randomBytes(16).toString('hex');
57
+ const server = new Server({
58
+ folders: {
59
+ config: process.env.TEST_FOLDER_CONFIG || path.resolve(basePath, '../config'),
60
+ controllers: process.env.TEST_FOLDER_CONTROLLERS ||
61
+ path.resolve(basePath, '../controllers'),
62
+ models: process.env.TEST_FOLDER_MODELS || path.resolve(basePath, '../models'),
63
+ emails: process.env.TEST_FOLDER_EMAIL ||
64
+ process.env.TEST_FOLDER_EMAILS ||
65
+ path.resolve(basePath, '../services/messaging/email/templates'),
66
+ locales: process.env.TEST_FOLDER_LOCALES || path.resolve(basePath, '../locales'),
67
+ commands: process.env.TEST_FOLDER_COMMANDS ||
68
+ path.resolve(basePath, '../commands'),
69
+ migrations: process.env.TEST_FOLDER_MIGRATIONS ||
70
+ path.resolve(basePath, '../migrations'),
71
+ },
72
+ });
73
+ setServerInstance(server);
74
+ await server.init({ isSkipModelInit: true });
75
+ const connectionString = process.env.TEST_MONGO_URI.replace('__DB_TO_REPLACE__', `TEST_${crypto.randomUUID()}`);
76
+ server.updateConfig('mongo', { connectionString });
77
+ server.updateConfig('http', { port: 0 }); // allow to use random
78
+ server.updateConfig('mail', { transport: 'stub' });
79
+ // Use the in-memory rate limiter for the default (controller-mounted) limiter:
80
+ // it's synchronous, so it can't time out and fail-open under the CPU load of
81
+ // parallel workers (which made the Auth 429 test flaky). The Mongo/Redis
82
+ // drivers are still covered explicitly in RateLimiter.test.ts.
83
+ server.updateConfig('rateLimiter', { driver: 'memory' });
84
+ // scrypt is memory-hard: the production ln=17 (~0.5s/hash) run across parallel
85
+ // workers starves each other and trips hook timeouts. Lower the cost for tests
86
+ // (~15ms/hash). The verify/rehash paths read this same config, so the v2
87
+ // round-trip and upgrade logic are still exercised.
88
+ server.updateConfig('auth', { scrypt: { ln: 12, r: 8, p: 1 } });
89
+ await server.initAllModels();
90
+ await server.startServer();
91
+ return server;
92
+ }
93
+ /** Shut down the server, drop its database, and disconnect mongoose. */
94
+ export async function stopTestServer() {
95
+ if (serverInstance) {
96
+ serverInstance.app.httpServer?.shutdown();
97
+ serverInstance.app.events.emit('shutdown');
98
+ }
99
+ try {
100
+ await mongoose.connection.db?.dropDatabase(); // clean database after test
101
+ }
102
+ catch {
103
+ // that ok. No mongoose connection
104
+ }
105
+ await mongoose.disconnect();
106
+ }
107
+ // ── Per-test redis namespace isolation ──────────────────────────────────────
108
+ /** Point the cache/rate-limiter keyspace at a fresh random namespace. */
109
+ export function setTestRedisNamespace() {
110
+ if (serverInstance) {
111
+ const key = `test-${Math.random().toString(36).substring(7)}`;
112
+ serverInstance.app.updateConfig('redis', { namespace: key });
113
+ }
114
+ }
115
+ /** Best-effort clear of the current test's redis namespace (no-op without redis). */
116
+ export async function clearTestRedisNamespace() {
117
+ if (!serverInstance) {
118
+ return;
119
+ }
120
+ const { url, namespace } = serverInstance.getConfig('redis');
121
+ try {
122
+ // Lazy-import `@redis/client` so a memory-only consumer that uses this test
123
+ // setup never loads the (optional) redis package.
124
+ const { createClient } = await import('@redis/client');
125
+ const redisClient = createClient({ url });
126
+ await redisClient.connect();
127
+ await clearNamespace(redisClient, namespace);
128
+ await redisClient.destroy();
129
+ }
130
+ catch {
131
+ // that ok. No redis connection
132
+ }
133
+ }
134
+ //# sourceMappingURL=setupFramework.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setupFramework.js","sourceRoot":"","sources":["../../src/tests/setupFramework.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,16 @@
1
+ // node:test glue for the framework test lifecycle, mirroring `setupVitest.ts`.
2
+ // The setup logic is runner-agnostic in `setupFramework.ts`; this file only
3
+ // wires it to node:test's hooks.
4
+ //
5
+ // node:test runs each file in its own process, so there is no built-in
6
+ // run-once-globally hook like vitest's globalSetup. Ensure `TEST_MONGO_URI` is
7
+ // set before these hooks run — either start one shared Mongo outside the test
8
+ // processes (a preload that calls `startTestMongo`, see the testing docs) or
9
+ // point `TEST_MONGO_URI` at an external instance.
10
+ import { after, afterEach, before, beforeEach } from 'node:test';
11
+ import { clearTestRedisNamespace, setTestRedisNamespace, startTestServer, stopTestServer, } from "./setupFramework.js";
12
+ before(startTestServer);
13
+ beforeEach(setTestRedisNamespace);
14
+ afterEach(clearTestRedisNamespace);
15
+ after(stopTestServer);
16
+ //# sourceMappingURL=setupNodeTest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setupNodeTest.js","sourceRoot":"","sources":["../../src/tests/setupNodeTest.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,iCAAiC;AACjC,EAAE;AACF,uEAAuE;AACvE,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,kDAAkD;AAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,eAAe,CAAC,CAAC;AACxB,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAClC,SAAS,CAAC,uBAAuB,CAAC,CAAC;AACnC,KAAK,CAAC,cAAc,CAAC,CAAC"}
@@ -1,101 +1,10 @@
1
- import crypto from 'node:crypto';
2
- import path from 'node:path';
3
- import { createClient } from '@redis/client';
4
- import mongoose from 'mongoose'; // we do not need create indexes on tests
1
+ // vitest glue for the framework test lifecycle. The actual setup logic is
2
+ // runner-agnostic in `setupFramework.ts`; this file only wires it to vitest's
3
+ // per-file hooks. (Global Mongo lifecycle is in `globalSetupVitest.ts`.)
5
4
  import { afterAll, afterEach, beforeAll, beforeEach } from 'vitest';
6
- import { clearNamespace } from "../helpers/redis/clearNamespace.js";
7
- import Server from "../server.js";
8
- import { serverInstance, setServerInstance } from "./testHelpers.js";
9
- mongoose.set('autoIndex', false);
10
- const basePath = new URL('.', import.meta.url).pathname;
11
- beforeAll(async () => {
12
- process.env.LOGGER_CONSOLE_LEVEL = 'error';
13
- process.env.AUTH_SALT = crypto.randomBytes(16).toString('hex');
14
- const server = new Server({
15
- folders: {
16
- config: process.env.TEST_FOLDER_CONFIG || path.resolve(basePath, '../config'),
17
- controllers: process.env.TEST_FOLDER_CONTROLLERS ||
18
- path.resolve(basePath, '../controllers'),
19
- models: process.env.TEST_FOLDER_MODELS || path.resolve(basePath, '../models'),
20
- emails: process.env.TEST_FOLDER_EMAIL ||
21
- process.env.TEST_FOLDER_EMAILS ||
22
- path.resolve(basePath, '../services/messaging/email/templates'),
23
- locales: process.env.TEST_FOLDER_LOCALES || path.resolve(basePath, '../locales'),
24
- commands: process.env.TEST_FOLDER_COMMANDS ||
25
- path.resolve(basePath, '../commands'),
26
- migrations: process.env.TEST_FOLDER_MIGRATIONS ||
27
- path.resolve(basePath, '../migrations'),
28
- },
29
- });
30
- setServerInstance(server);
31
- await server.init({ isSkipModelInit: true });
32
- const connectionString = process.env.TEST_MONGO_URI.replace('__DB_TO_REPLACE__', `TEST_${crypto.randomUUID()}`);
33
- server.updateConfig('mongo', {
34
- connectionString,
35
- });
36
- server.updateConfig('http', { port: 0 }); // allow to use random
37
- server.updateConfig('mail', { transport: 'stub' });
38
- // Use the in-memory rate limiter for the default (controller-mounted) limiter:
39
- // it's synchronous, so it can't time out and fail-open under the CPU load of
40
- // parallel workers (which made the Auth 429 test flaky). The Mongo/Redis
41
- // drivers are still covered explicitly in RateLimiter.test.ts.
42
- server.updateConfig('rateLimiter', { driver: 'memory' });
43
- // scrypt is memory-hard: the production ln=17 (~0.5s/hash) run across vitest's
44
- // parallel workers starves each other and trips hook timeouts. Lower the cost
45
- // for tests (~15ms/hash). The verify/rehash paths read this same config, so
46
- // the v2 round-trip and upgrade logic are still exercised.
47
- server.updateConfig('auth', { scrypt: { ln: 12, r: 8, p: 1 } });
48
- await server.initAllModels();
49
- // if (!global.testSetup) {
50
- // global.testSetup = {};
51
- // }
52
- // server.testingGetUrl = (urlPart) => {
53
- // console.error(
54
- // 'global.server.testingGetUrl is deprcated. Please use testHelper.getServerBaseURL()',
55
- // );
56
- // return `http://127.0.0.1:${global.server.getConfig('http').port}${urlPart}`;
57
- // };
58
- // if (typeof global.testSetup.beforeAll === 'function') {
59
- // await global.testSetup.beforeAll();
60
- // }
61
- await server.startServer();
62
- });
63
- beforeEach(() => {
64
- if (serverInstance) {
65
- const key = `test-${Math.random().toString(36).substring(7)}`;
66
- serverInstance.app.updateConfig('redis', {
67
- namespace: key,
68
- });
69
- }
70
- });
71
- afterEach(async () => {
72
- if (serverInstance) {
73
- const { url, namespace } = serverInstance.getConfig('redis');
74
- const redisClient = createClient({ url });
75
- try {
76
- await redisClient.connect();
77
- await clearNamespace(redisClient, namespace);
78
- await redisClient.destroy();
79
- }
80
- catch {
81
- // that ok. No redis connection
82
- }
83
- }
84
- });
85
- afterAll(async () => {
86
- if (serverInstance) {
87
- serverInstance.app.httpServer?.shutdown();
88
- serverInstance.app.events.emit('shutdown');
89
- }
90
- // if (typeof global.testSetup.afterAll === 'function') {
91
- // await global.testSetup.afterAll();
92
- // }
93
- try {
94
- await mongoose.connection.db?.dropDatabase(); // clean database after test
95
- }
96
- catch {
97
- // that ok. No mongoose connection
98
- }
99
- await mongoose.disconnect();
100
- });
5
+ import { clearTestRedisNamespace, setTestRedisNamespace, startTestServer, stopTestServer, } from "./setupFramework.js";
6
+ beforeAll(startTestServer);
7
+ beforeEach(setTestRedisNamespace);
8
+ afterEach(clearTestRedisNamespace);
9
+ afterAll(stopTestServer);
101
10
  //# sourceMappingURL=setupVitest.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"setupVitest.js","sourceRoot":"","sources":["../../src/tests/setupVitest.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"setupVitest.js","sourceRoot":"","sources":["../../src/tests/setupVitest.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,SAAS,CAAC,eAAe,CAAC,CAAC;AAC3B,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAClC,SAAS,CAAC,uBAAuB,CAAC,CAAC;AACnC,QAAQ,CAAC,cAAc,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptivestone/framework",
3
- "version": "5.0.0",
3
+ "version": "5.1.0",
4
4
  "description": "Adaptive stone node js framework",
5
5
  "type": "module",
6
6
  "engines": {
@@ -36,6 +36,7 @@
36
36
  "prod": "node --watch ./src/cluster.ts",
37
37
  "test": "vitest run",
38
38
  "t": "vitest --coverage=false --reporter=default",
39
+ "test:node": "node --test --test-global-setup=./src/tests/globalSetupNodeTest.ts 'src/tests/**/*.node-test.ts'",
39
40
  "format": "biome format",
40
41
  "format:fix": "biome format --write",
41
42
  "lint": "biome lint",
@@ -46,6 +47,8 @@
46
47
  "smoke": "./scripts/packaging-smoke-test.sh",
47
48
  "cli": "node cliCommand.ts",
48
49
  "gen": "node cliCommand.ts generatetypes",
50
+ "openapi": "node cliCommand.ts openapi",
51
+ "routes": "node cliCommand.ts routes",
49
52
  "dev:bench:realistic": "node ./benchmark/fixtures/realistic.ts",
50
53
  "benchmark": "h2load -n 10000 -c 50 -p 'http/1.1' http://localhost:3300/",
51
54
  "benchmark2": "h2load -n 10000 -c 50 https://localhost:3300/",
@@ -56,25 +59,25 @@
56
59
  "author": "Andrei Lahunou",
57
60
  "license": "MIT",
58
61
  "dependencies": {
59
- "@redis/client": "^6.0.0",
60
62
  "deepmerge": "^4.2.2",
61
63
  "express": "^5.0.1",
62
64
  "formidable": "^3.5.1",
63
65
  "i18next": "^26.0.1",
64
66
  "i18next-fs-backend": "^2.0.0",
65
67
  "mongoose": "^9.0.0",
66
- "oxc-parser": "^0.135.0",
68
+ "oxc-parser": "^0.138.0",
67
69
  "rate-limiter-flexible": "^11.0.0",
68
70
  "winston": "^3.3.3",
69
71
  "winston-transport": "^4.9.0"
70
72
  },
71
73
  "devDependencies": {
72
74
  "@biomejs/biome": "^2.0.6",
75
+ "@redis/client": "^6.0.0",
73
76
  "@sentry/core": "^10.34.0",
74
77
  "@sentry/node": "^10.34.0",
75
78
  "@types/express": "^5.0.1",
76
79
  "@types/formidable": "^3.4.5",
77
- "@types/node": "^25.0.0",
80
+ "@types/node": "^26.0.0",
78
81
  "@typescript/native-preview": "^7.0.0-dev.20260604.1",
79
82
  "@vitest/coverage-v8": "^4.0.0",
80
83
  "lefthook": "^2.0.0",
@@ -85,7 +88,8 @@
85
88
  "zod": "^4.0.0"
86
89
  },
87
90
  "peerDependencies": {
88
- "@adaptivestone/framework-module-email": "^1.0.0",
91
+ "@adaptivestone/framework-module-email": "^1.0.0 || ^2.0.0",
92
+ "@redis/client": "^6.0.0",
89
93
  "@sentry/core": "^10.34.0",
90
94
  "@sentry/node": "^10.34.0",
91
95
  "mongodb-memory-server": "^11.0.0",
@@ -97,6 +101,9 @@
97
101
  "@adaptivestone/framework-module-email": {
98
102
  "optional": true
99
103
  },
104
+ "@redis/client": {
105
+ "optional": true
106
+ },
100
107
  "@sentry/core": {
101
108
  "optional": true
102
109
  },