@adaptivestone/framework 5.0.0-beta.9 → 5.0.0-rc.2
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.
- package/LICENCE +1 -1
- package/README.md +69 -2
- package/dist/Cli.d.ts +7 -0
- package/dist/Cli.js +19 -0
- package/dist/Cli.js.map +1 -0
- package/dist/cluster.d.ts +1 -0
- package/dist/cluster.js +67 -0
- package/dist/cluster.js.map +1 -0
- package/dist/codegen/appTypes.d.ts +19 -0
- package/dist/codegen/appTypes.js +126 -0
- package/dist/codegen/appTypes.js.map +1 -0
- package/dist/codegen/astEmit.d.ts +53 -0
- package/dist/codegen/astEmit.js +242 -0
- package/dist/codegen/astEmit.js.map +1 -0
- package/dist/codegen/astExtract.d.ts +78 -0
- package/dist/codegen/astExtract.js +539 -0
- package/dist/codegen/astExtract.js.map +1 -0
- package/dist/codegen/astModel.d.ts +14 -0
- package/dist/codegen/astModel.js +73 -0
- package/dist/codegen/astModel.js.map +1 -0
- package/dist/codegen/astResolve.d.ts +53 -0
- package/dist/codegen/astResolve.js +276 -0
- package/dist/codegen/astResolve.js.map +1 -0
- package/dist/codegen/astSpec.d.ts +25 -0
- package/dist/codegen/astSpec.js +63 -0
- package/dist/codegen/astSpec.js.map +1 -0
- package/dist/codegen/collectMetadata.d.ts +39 -0
- package/dist/codegen/collectMetadata.js +7 -0
- package/dist/codegen/collectMetadata.js.map +1 -0
- package/dist/codegen/emit.d.ts +30 -0
- package/dist/codegen/emit.js +213 -0
- package/dist/codegen/emit.js.map +1 -0
- package/dist/codegen/index.d.ts +30 -0
- package/dist/codegen/index.js +76 -0
- package/dist/codegen/index.js.map +1 -0
- package/dist/codegen/paths.d.ts +9 -0
- package/dist/codegen/paths.js +25 -0
- package/dist/codegen/paths.js.map +1 -0
- package/dist/commands/CreateUser.d.ts +32 -0
- package/dist/commands/CreateUser.js +85 -0
- package/dist/commands/CreateUser.js.map +1 -0
- package/dist/commands/DropIndex.d.ts +16 -0
- package/dist/commands/DropIndex.js +30 -0
- package/dist/commands/DropIndex.js.map +1 -0
- package/dist/commands/GenerateRandomBytes.d.ts +7 -0
- package/dist/commands/GenerateRandomBytes.js +18 -0
- package/dist/commands/GenerateRandomBytes.js.map +1 -0
- package/dist/commands/GenerateTypes.d.ts +13 -0
- package/dist/commands/GenerateTypes.js +34 -0
- package/dist/commands/GenerateTypes.js.map +1 -0
- package/dist/commands/SyncIndexes.d.ts +6 -0
- package/dist/commands/SyncIndexes.js +31 -0
- package/dist/commands/SyncIndexes.js.map +1 -0
- package/dist/commands/migration/Create.d.ts +18 -0
- package/dist/commands/migration/Create.js +57 -0
- package/dist/commands/migration/Create.js.map +1 -0
- package/dist/commands/migration/Migrate.d.ts +6 -0
- package/dist/commands/migration/Migrate.js +73 -0
- package/dist/commands/migration/Migrate.js.map +1 -0
- package/dist/config/auth.d.ts +11 -0
- package/dist/config/auth.js +18 -0
- package/dist/config/auth.js.map +1 -0
- package/dist/config/http.d.ts +22 -0
- package/dist/config/http.js +40 -0
- package/dist/config/http.js.map +1 -0
- package/dist/config/i18n.d.ts +13 -0
- package/dist/config/i18n.js +13 -0
- package/dist/config/i18n.js.map +1 -0
- package/dist/config/ipDetector.d.ts +5 -0
- package/dist/config/ipDetector.js +15 -0
- package/dist/config/ipDetector.js.map +1 -0
- package/dist/config/log.d.ts +11 -0
- package/dist/config/log.js +21 -0
- package/dist/config/log.js.map +1 -0
- package/dist/config/mongo.d.ts +4 -0
- package/dist/config/mongo.js +4 -0
- package/dist/config/mongo.js.map +1 -0
- package/dist/config/rateLimiter.d.ts +13 -0
- package/dist/config/rateLimiter.js +17 -0
- package/dist/config/rateLimiter.js.map +1 -0
- package/dist/config/redis.d.ts +5 -0
- package/dist/config/redis.js +5 -0
- package/dist/config/redis.js.map +1 -0
- package/dist/controllers/Auth.d.ts +59 -0
- package/dist/controllers/Auth.js +356 -0
- package/dist/controllers/Auth.js.map +1 -0
- package/dist/controllers/Auth.routes.gen.d.ts +57 -0
- package/dist/controllers/Auth.routes.gen.js +10 -0
- package/dist/controllers/Auth.routes.gen.js.map +1 -0
- package/dist/controllers/Home.d.ts +14 -0
- package/dist/controllers/Home.js +26 -0
- package/dist/controllers/Home.js.map +1 -0
- package/dist/controllers/Home.routes.gen.d.ts +13 -0
- package/dist/controllers/Home.routes.gen.js +10 -0
- package/dist/controllers/Home.routes.gen.js.map +1 -0
- package/dist/controllers/index.d.ts +107 -0
- package/dist/controllers/index.js +548 -0
- package/dist/controllers/index.js.map +1 -0
- package/dist/folderConfig.d.ts +34 -0
- package/dist/folderConfig.js +14 -0
- package/dist/folderConfig.js.map +1 -0
- package/dist/helpers/appInstance.d.ts +10 -0
- package/dist/helpers/appInstance.js +19 -0
- package/dist/helpers/appInstance.js.map +1 -0
- package/dist/helpers/crypto.d.ts +26 -0
- package/dist/helpers/crypto.js +160 -0
- package/dist/helpers/crypto.js.map +1 -0
- package/dist/helpers/deprecation.d.ts +8 -0
- package/dist/helpers/deprecation.js +19 -0
- package/dist/helpers/deprecation.js.map +1 -0
- package/dist/helpers/env.d.ts +8 -0
- package/dist/helpers/env.js +15 -0
- package/dist/helpers/env.js.map +1 -0
- package/dist/helpers/files.d.ts +16 -0
- package/dist/helpers/files.js +83 -0
- package/dist/helpers/files.js.map +1 -0
- package/dist/helpers/logger.d.ts +6 -0
- package/dist/helpers/logger.js +34 -0
- package/dist/helpers/logger.js.map +1 -0
- package/dist/helpers/redis/clearNamespace.d.ts +10 -0
- package/dist/helpers/redis/clearNamespace.js +31 -0
- package/dist/helpers/redis/clearNamespace.js.map +1 -0
- package/dist/helpers/redis/redisConnection.d.ts +8 -0
- package/dist/helpers/redis/redisConnection.js +63 -0
- package/dist/helpers/redis/redisConnection.js.map +1 -0
- package/dist/helpers/yup.d.ts +22 -0
- package/dist/helpers/yup.js +39 -0
- package/dist/helpers/yup.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/{locales → dist/locales}/en/translation.json +5 -0
- package/{locales → dist/locales}/ru/translation.json +5 -0
- package/dist/models/KeyValue.d.ts +22 -0
- package/dist/models/KeyValue.js +17 -0
- package/dist/models/KeyValue.js.map +1 -0
- package/dist/models/Lock.d.ts +99 -0
- package/dist/models/Lock.js +123 -0
- package/dist/models/Lock.js.map +1 -0
- package/dist/models/Migration.d.ts +13 -0
- package/dist/models/Migration.js +14 -0
- package/dist/models/Migration.js.map +1 -0
- package/dist/models/Sequence.d.ts +28 -0
- package/dist/models/Sequence.js +31 -0
- package/dist/models/Sequence.js.map +1 -0
- package/dist/models/User.d.ts +769 -0
- package/dist/models/User.js +336 -0
- package/dist/models/User.js.map +1 -0
- package/dist/models/UserOld.d.ts +191 -0
- package/dist/models/UserOld.js +231 -0
- package/dist/models/UserOld.js.map +1 -0
- package/dist/modules/AbstractCommand.d.ts +51 -0
- package/dist/modules/AbstractCommand.js +60 -0
- package/dist/modules/AbstractCommand.js.map +1 -0
- package/dist/modules/AbstractConnector.d.ts +5 -0
- package/dist/modules/AbstractConnector.js +8 -0
- package/dist/modules/AbstractConnector.js.map +1 -0
- package/dist/modules/AbstractController.d.ts +99 -0
- package/dist/modules/AbstractController.js +83 -0
- package/dist/modules/AbstractController.js.map +1 -0
- package/dist/modules/AbstractModel.d.ts +29 -0
- package/dist/modules/AbstractModel.js +42 -0
- package/dist/modules/AbstractModel.js.map +1 -0
- package/dist/modules/Base.d.ts +29 -0
- package/dist/modules/Base.js +62 -0
- package/dist/modules/Base.js.map +1 -0
- package/dist/modules/BaseCli.d.ts +25 -0
- package/dist/modules/BaseCli.js +159 -0
- package/dist/modules/BaseCli.js.map +1 -0
- package/dist/modules/BaseModel.d.ts +57 -0
- package/dist/modules/BaseModel.js +37 -0
- package/dist/modules/BaseModel.js.map +1 -0
- package/dist/server.d.ts +130 -0
- package/dist/server.js +603 -0
- package/dist/server.js.map +1 -0
- package/dist/services/cache/Cache.d.ts +31 -0
- package/dist/services/cache/Cache.js +146 -0
- package/dist/services/cache/Cache.js.map +1 -0
- package/dist/services/http/HttpServer.d.ts +46 -0
- package/dist/services/http/HttpServer.js +114 -0
- package/dist/services/http/HttpServer.js.map +1 -0
- package/dist/services/http/files.d.ts +18 -0
- package/dist/services/http/files.js +19 -0
- package/dist/services/http/files.js.map +1 -0
- package/dist/services/http/middleware/AbstractMiddleware.d.ts +58 -0
- package/dist/services/http/middleware/AbstractMiddleware.js +73 -0
- package/dist/services/http/middleware/AbstractMiddleware.js.map +1 -0
- package/dist/services/http/middleware/Auth.d.ts +22 -0
- package/dist/services/http/middleware/Auth.js +30 -0
- package/dist/services/http/middleware/Auth.js.map +1 -0
- package/dist/services/http/middleware/Cors.d.ts +12 -0
- package/dist/services/http/middleware/Cors.js +45 -0
- package/dist/services/http/middleware/Cors.js.map +1 -0
- package/dist/services/http/middleware/GetUserByToken.d.ts +36 -0
- package/dist/services/http/middleware/GetUserByToken.js +59 -0
- package/dist/services/http/middleware/GetUserByToken.js.map +1 -0
- package/dist/services/http/middleware/I18n.d.ts +23 -0
- package/dist/services/http/middleware/I18n.js +61 -0
- package/dist/services/http/middleware/I18n.js.map +1 -0
- package/dist/services/http/middleware/IpDetector.d.ts +14 -0
- package/dist/services/http/middleware/IpDetector.js +80 -0
- package/dist/services/http/middleware/IpDetector.js.map +1 -0
- package/dist/services/http/middleware/Pagination.d.ts +26 -0
- package/dist/services/http/middleware/Pagination.js +70 -0
- package/dist/services/http/middleware/Pagination.js.map +1 -0
- package/dist/services/http/middleware/PrepareAppInfo.d.ts +8 -0
- package/dist/services/http/middleware/PrepareAppInfo.js +17 -0
- package/dist/services/http/middleware/PrepareAppInfo.js.map +1 -0
- package/dist/services/http/middleware/RateLimiter.d.ts +31 -0
- package/dist/services/http/middleware/RateLimiter.js +118 -0
- package/dist/services/http/middleware/RateLimiter.js.map +1 -0
- package/dist/services/http/middleware/RequestLogger.d.ts +8 -0
- package/dist/services/http/middleware/RequestLogger.js +20 -0
- package/dist/services/http/middleware/RequestLogger.js.map +1 -0
- package/dist/services/http/middleware/RequestParser.d.ts +15 -0
- package/dist/services/http/middleware/RequestParser.js +112 -0
- package/dist/services/http/middleware/RequestParser.js.map +1 -0
- package/dist/services/http/middleware/Role.d.ts +12 -0
- package/dist/services/http/middleware/Role.js +27 -0
- package/dist/services/http/middleware/Role.js.map +1 -0
- package/dist/services/http/routing/ExpressAdapter.d.ts +12 -0
- package/dist/services/http/routing/ExpressAdapter.js +95 -0
- package/dist/services/http/routing/ExpressAdapter.js.map +1 -0
- package/dist/services/http/routing/RouteNode.d.ts +105 -0
- package/dist/services/http/routing/RouteNode.js +21 -0
- package/dist/services/http/routing/RouteNode.js.map +1 -0
- package/dist/services/http/routing/RouteRegistry.d.ts +37 -0
- package/dist/services/http/routing/RouteRegistry.js +244 -0
- package/dist/services/http/routing/RouteRegistry.js.map +1 -0
- package/dist/services/http/routing/formatTree.d.ts +23 -0
- package/dist/services/http/routing/formatTree.js +159 -0
- package/dist/services/http/routing/formatTree.js.map +1 -0
- package/dist/services/http/routing/match.d.ts +31 -0
- package/dist/services/http/routing/match.js +164 -0
- package/dist/services/http/routing/match.js.map +1 -0
- package/dist/services/http/routing/middlewareNormalization.d.ts +11 -0
- package/dist/services/http/routing/middlewareNormalization.js +23 -0
- package/dist/services/http/routing/middlewareNormalization.js.map +1 -0
- package/dist/services/http/types.d.ts +74 -0
- package/dist/services/http/types.js +8 -0
- package/dist/services/http/types.js.map +1 -0
- package/dist/services/i18n/I18n.d.ts +15 -0
- package/dist/services/i18n/I18n.js +58 -0
- package/dist/services/i18n/I18n.js.map +1 -0
- package/dist/services/logging/SentryTransport.d.ts +13 -0
- package/dist/services/logging/SentryTransport.js +134 -0
- package/dist/services/logging/SentryTransport.js.map +1 -0
- package/dist/services/validate/ValidateService.d.ts +54 -0
- package/dist/services/validate/ValidateService.js +144 -0
- package/dist/services/validate/ValidateService.js.map +1 -0
- package/dist/services/validate/ValidationError.d.ts +35 -0
- package/dist/services/validate/ValidationError.js +90 -0
- package/dist/services/validate/ValidationError.js.map +1 -0
- package/dist/services/validate/contentType.d.ts +18 -0
- package/dist/services/validate/contentType.js +30 -0
- package/dist/services/validate/contentType.js.map +1 -0
- package/dist/services/validate/defineSchema.d.ts +23 -0
- package/dist/services/validate/defineSchema.js +25 -0
- package/dist/services/validate/defineSchema.js.map +1 -0
- package/dist/services/validate/drivers/StandardSchemaDriver.d.ts +15 -0
- package/dist/services/validate/drivers/StandardSchemaDriver.js +38 -0
- package/dist/services/validate/drivers/StandardSchemaDriver.js.map +1 -0
- package/dist/services/validate/drivers/YupDriver.d.ts +21 -0
- package/dist/services/validate/drivers/YupDriver.js +81 -0
- package/dist/services/validate/drivers/YupDriver.js.map +1 -0
- package/dist/services/validate/types.d.ts +104 -0
- package/dist/services/validate/types.js +11 -0
- package/dist/services/validate/types.js.map +1 -0
- package/dist/tests/frameworkVitestSetup.d.ts +1 -0
- package/dist/tests/frameworkVitestSetup.js +9 -0
- package/dist/tests/frameworkVitestSetup.js.map +1 -0
- package/dist/tests/globalSetupVitest.d.ts +3 -0
- package/dist/tests/globalSetupVitest.js +29 -0
- package/dist/tests/globalSetupVitest.js.map +1 -0
- package/dist/tests/setupVitest.d.ts +1 -0
- package/dist/tests/setupVitest.js +101 -0
- package/dist/tests/setupVitest.js.map +1 -0
- package/dist/tests/testHelpers.d.ts +361 -0
- package/dist/tests/testHelpers.js +48 -0
- package/dist/tests/testHelpers.js.map +1 -0
- package/dist/types.d.ts +4 -0
- package/dist/types.js +5 -0
- package/dist/types.js.map +1 -0
- package/package.json +84 -39
- package/.env.example +0 -18
- package/CHANGELOG.md +0 -956
- package/Cli.js +0 -21
- package/cluster.js +0 -25
- package/commands/CreateUser.js +0 -106
- package/commands/Documentation.js +0 -17
- package/commands/DropIndex.js +0 -38
- package/commands/GenerateRandomBytes.js +0 -21
- package/commands/GetOpenApiJson.js +0 -336
- package/commands/SyncIndexes.js +0 -40
- package/commands/migration/Create.js +0 -72
- package/commands/migration/Migrate.js +0 -56
- package/config/auth.js +0 -9
- package/config/http.js +0 -9
- package/config/i18n.js +0 -12
- package/config/ipDetector.js +0 -14
- package/config/log.js +0 -22
- package/config/mongo.js +0 -3
- package/config/rateLimiter.js +0 -16
- package/config/redis.js +0 -4
- package/config/validate.js +0 -3
- package/controllers/Auth.js +0 -201
- package/controllers/Home.js +0 -28
- package/controllers/index.js +0 -60
- package/eslint.config.js +0 -68
- package/folderConfig.js +0 -13
- package/helpers/files.js +0 -76
- package/helpers/logger.js +0 -16
- package/helpers/redis/clearNamespace.js +0 -14
- package/helpers/yup.js +0 -22
- package/index.js +0 -8
- package/jsconfig.json +0 -9
- package/models/Lock.js +0 -107
- package/models/Migration.js +0 -15
- package/models/Sequence.js +0 -22
- package/models/User.js +0 -280
- package/modules/AbstractCommand.js +0 -52
- package/modules/AbstractConnector.js +0 -9
- package/modules/AbstractController.js +0 -406
- package/modules/AbstractModel.d.ts +0 -48
- package/modules/AbstractModel.js +0 -92
- package/modules/Base.d.ts +0 -37
- package/modules/Base.js +0 -64
- package/modules/BaseCli.js +0 -157
- package/server.d.ts +0 -100
- package/server.js +0 -439
- package/services/cache/Cache.d.ts +0 -35
- package/services/cache/Cache.js +0 -124
- package/services/documentation/DocumentationGenerator.js +0 -169
- package/services/http/HttpServer.js +0 -89
- package/services/http/middleware/AbstractMiddleware.js +0 -51
- package/services/http/middleware/Auth.js +0 -20
- package/services/http/middleware/Cors.js +0 -46
- package/services/http/middleware/GetUserByToken.js +0 -47
- package/services/http/middleware/I18n.js +0 -117
- package/services/http/middleware/IpDetector.js +0 -59
- package/services/http/middleware/Pagination.js +0 -57
- package/services/http/middleware/PrepareAppInfo.js +0 -18
- package/services/http/middleware/RateLimiter.js +0 -134
- package/services/http/middleware/RequestLogger.js +0 -22
- package/services/http/middleware/RequestParser.js +0 -40
- package/services/http/middleware/Role.js +0 -29
- package/services/messaging/email/templates/.gitkeep +0 -0
- package/services/validate/ValidateService.js +0 -157
- package/services/validate/drivers/AbstractValidator.js +0 -37
- package/services/validate/drivers/CustomValidator.js +0 -51
- package/services/validate/drivers/YupValidator.js +0 -103
- package/tests/globalSetupVitest.js +0 -35
- package/tests/setup.js +0 -120
- package/tests/setupVitest.js +0 -111
- package/types/Expand.d.ts +0 -11
- package/types/ICommandArguments.d.ts +0 -41
- package/types/TFoldersConfig.d.ts +0 -20
- package/views/404.pug +0 -3
- package/views/home.pug +0 -3
- package/views/layouts/base.pug +0 -39
- package/vitest.config.js +0 -17
- /package/{commands → dist/migrations}/.gitkeep +0 -0
- /package/{services → dist/services}/messaging/email/resources/.gitkeep +0 -0
- /package/{migrations → dist/services/messaging/email/templates}/.gitkeep +0 -0
- /package/{services → dist/services}/messaging/email/templates/recovery/html.pug +0 -0
- /package/{services → dist/services}/messaging/email/templates/recovery/subject.pug +0 -0
- /package/{services → dist/services}/messaging/email/templates/recovery/text.pug +0 -0
- /package/{services → dist/services}/messaging/email/templates/verification/html.pug +0 -0
- /package/{services → dist/services}/messaging/email/templates/verification/subject.pug +0 -0
- /package/{services → dist/services}/messaging/email/templates/verification/text.pug +0 -0
package/LICENCE
CHANGED
package/README.md
CHANGED
|
@@ -1,3 +1,70 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @adaptivestone/framework
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A TypeScript-first, ESM Node.js framework: convention-based controllers and
|
|
4
|
+
Mongoose models, a tree-based router with per-controller generated route/handler
|
|
5
|
+
types, and batteries-included auth, rate limiting, i18n, and caching.
|
|
6
|
+
|
|
7
|
+
📖 **Full documentation → https://framework.adaptivestone.com/**
|
|
8
|
+
🤖 **LLM-ready docs (whole site as one file) → https://framework.adaptivestone.com/llm-context.md**
|
|
9
|
+
|
|
10
|
+
## Requirements
|
|
11
|
+
|
|
12
|
+
- **Node ≥ 24** (ESM-only, runs `.ts` sources natively)
|
|
13
|
+
- **MongoDB** — required; boot fails fast without `MONGO_DSN`
|
|
14
|
+
- **`AUTH_SALT`** — required; generate one with `node src/cli.ts generateRandomBytes`
|
|
15
|
+
|
|
16
|
+
## Quickstart
|
|
17
|
+
|
|
18
|
+
The fastest way to start is to clone the example project and use it as a
|
|
19
|
+
template — it ships a working `Server`, controllers, config, tests, and a Docker
|
|
20
|
+
dev stack (MongoDB + Redis included):
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
git clone https://github.com/adaptivestone/framework-example-project.git my-app
|
|
24
|
+
cd my-app
|
|
25
|
+
docker compose up
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Your app starts at `http://localhost:3300`. Provide an `AUTH_SALT` before first
|
|
29
|
+
boot (see Requirements and `.env.example`). Edit a controller under
|
|
30
|
+
`src/controllers/` and the dev server reloads automatically. Full walkthrough in
|
|
31
|
+
the [Getting Started guide](https://framework.adaptivestone.com/).
|
|
32
|
+
|
|
33
|
+
To add the framework to an existing project instead:
|
|
34
|
+
|
|
35
|
+
```sh
|
|
36
|
+
npm install @adaptivestone/framework
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Generated types
|
|
40
|
+
|
|
41
|
+
The framework generates `genTypes.d.ts` (typed `getConfig`/`getModel`) and
|
|
42
|
+
per-controller `*.routes.gen.ts` files (typed handler signatures). Regenerate
|
|
43
|
+
them with:
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
node src/cli.ts generatetypes
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
They are gitignored — regenerate after pulling (a fresh checkout is red in the
|
|
50
|
+
editor until the first run). In CI, guard against stale types with
|
|
51
|
+
`node src/cli.ts generatetypes --check`, which writes nothing and exits non-zero
|
|
52
|
+
if anything is out of date. The template wires this into its `check:types` script.
|
|
53
|
+
|
|
54
|
+
## Public API & stability
|
|
55
|
+
|
|
56
|
+
Only the subpaths listed under `exports` in `package.json` are importable as
|
|
57
|
+
`@adaptivestone/framework/<path>`; internal modules are intentionally not
|
|
58
|
+
exported. Exported paths follow semver in two tiers:
|
|
59
|
+
|
|
60
|
+
- **Tier 1 — stable:** `server.js`, `Cli.js`, `types.js`, `folderConfig.js`,
|
|
61
|
+
`modules/*`, `models/*`, `controllers/*`, `tests/*`, `migrations/*`.
|
|
62
|
+
- **Tier 2 — extension surface:** `config/*`, `helpers/*`, and `services/*` — may
|
|
63
|
+
change in a minor (with a deprecation cycle); pin to a minor if you import them
|
|
64
|
+
directly. `config/*` is what you import to extend the framework's default
|
|
65
|
+
config (e.g. `import http from '@adaptivestone/framework/config/http.js'`, then
|
|
66
|
+
re-export an edited copy from your own `src/config/http.ts`).
|
|
67
|
+
|
|
68
|
+
## License
|
|
69
|
+
|
|
70
|
+
MIT
|
package/dist/Cli.d.ts
ADDED
package/dist/Cli.js
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import mongoose from 'mongoose';
|
|
2
|
+
import BaseCli from "./modules/BaseCli.js";
|
|
3
|
+
import Server from "./server.js";
|
|
4
|
+
class Cli extends BaseCli {
|
|
5
|
+
constructor(serverConfig) {
|
|
6
|
+
mongoose.set('autoIndex', false); // we do not need create indexes on CLI.
|
|
7
|
+
const server = new Server(serverConfig);
|
|
8
|
+
super(server);
|
|
9
|
+
}
|
|
10
|
+
async run() {
|
|
11
|
+
await this.server.init({ isSkipModelInit: true, isSkipModelLoading: true });
|
|
12
|
+
const command = process.argv[2]?.toLowerCase();
|
|
13
|
+
await super.run(command);
|
|
14
|
+
this.app.events.emit('shutdown');
|
|
15
|
+
return true;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
export default Cli;
|
|
19
|
+
//# sourceMappingURL=Cli.js.map
|
package/dist/Cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Cli.js","sourceRoot":"","sources":["../src/Cli.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,GAAI,SAAQ,OAAO;IACvB,YAAY,YAA2B;QACrC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,wCAAwC;QAC1E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QACxC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QAC/C,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,eAAe,GAAG,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/dist/cluster.js
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import cluster from 'node:cluster';
|
|
2
|
+
import { cpus } from 'node:os';
|
|
3
|
+
const numCPUs = cpus().length;
|
|
4
|
+
if (cluster.isPrimary) {
|
|
5
|
+
console.log(`Master ${process.pid} is running`);
|
|
6
|
+
// Fork workers.
|
|
7
|
+
for (let i = 0; i < numCPUs; i += 1) {
|
|
8
|
+
cluster.fork();
|
|
9
|
+
}
|
|
10
|
+
// An orchestrator sends SIGTERM/SIGINT to PID 1 (the primary). Forward it to
|
|
11
|
+
// every worker so each drains gracefully via its own signal handler (workers
|
|
12
|
+
// run index.ts → startServer); the primary exits once the last worker is gone.
|
|
13
|
+
let shuttingDown = false;
|
|
14
|
+
for (const signal of ['SIGTERM', 'SIGINT']) {
|
|
15
|
+
process.on(signal, () => {
|
|
16
|
+
shuttingDown = true;
|
|
17
|
+
for (const worker of Object.values(cluster.workers ?? {})) {
|
|
18
|
+
worker?.kill(signal);
|
|
19
|
+
}
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
// Bound crash-loop restarts. A worker that keeps dying on boot (bad config,
|
|
23
|
+
// port in use, missing Mongo/AUTH_SALT, unhandled rejection) must NOT be
|
|
24
|
+
// re-forked in a tight loop — that pegs every core and floods logs. Track
|
|
25
|
+
// restarts in a rolling window; if they arrive too fast, stop forking and
|
|
26
|
+
// exit so the orchestrator surfaces the crash-loop instead of the primary
|
|
27
|
+
// masking it forever. Healthy single crashes still recover (after a short
|
|
28
|
+
// backoff).
|
|
29
|
+
const RESTART_WINDOW_MS = 60_000;
|
|
30
|
+
const MAX_RESTARTS_PER_WINDOW = numCPUs * 5;
|
|
31
|
+
const RESTART_BACKOFF_MS = 1_000;
|
|
32
|
+
let restartTimes = [];
|
|
33
|
+
cluster.on('exit', (worker, code, signal) => {
|
|
34
|
+
if (shuttingDown) {
|
|
35
|
+
// Tearing down: don't resurrect; exit when the last worker has gone.
|
|
36
|
+
if (Object.keys(cluster.workers ?? {}).length === 0) {
|
|
37
|
+
process.exit(0);
|
|
38
|
+
}
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
// Deliberate shutdown (clean exit, no kill signal) — do not resurrect,
|
|
42
|
+
// otherwise the primary fights a graceful shutdown forever.
|
|
43
|
+
if (code === 0 && !signal) {
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
const now = Date.now();
|
|
47
|
+
restartTimes = restartTimes.filter((t) => now - t < RESTART_WINDOW_MS);
|
|
48
|
+
restartTimes.push(now);
|
|
49
|
+
if (restartTimes.length > MAX_RESTARTS_PER_WINDOW) {
|
|
50
|
+
console.error(`Too many worker crashes (${restartTimes.length} in ${RESTART_WINDOW_MS / 1000}s). Refusing to keep forking — check the boot error above (config, DB, port). Exiting.`);
|
|
51
|
+
process.exit(1);
|
|
52
|
+
}
|
|
53
|
+
console.log(`Worker \x1B[45m ${worker.process.pid} \x1B[49m \x1B[41m †††† died †††† \x1B[49m. Code: ${signal || code}. Restarting in ${RESTART_BACKOFF_MS}ms...`);
|
|
54
|
+
setTimeout(() => {
|
|
55
|
+
if (!shuttingDown) {
|
|
56
|
+
cluster.fork();
|
|
57
|
+
}
|
|
58
|
+
}, RESTART_BACKOFF_MS).unref();
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
else {
|
|
62
|
+
// index.ts is the entry that actually constructs the Server and starts
|
|
63
|
+
// listening. server.ts only DEFINES the class, so importing it here would
|
|
64
|
+
// let the worker's event loop drain and exit → infinite fork storm.
|
|
65
|
+
import("./index.js");
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=cluster.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* App-level type generation. Emits a single `genTypes.d.ts` at
|
|
3
|
+
* `process.cwd()` that augments `IApp` so `getConfig('foo')` and
|
|
4
|
+
* `getModel('Bar')` are typed against the project's actual config /
|
|
5
|
+
* model files.
|
|
6
|
+
*/
|
|
7
|
+
import type { IApp } from '../server.ts';
|
|
8
|
+
/** Subset of the framework logger we use here. */
|
|
9
|
+
export interface CodegenLogger {
|
|
10
|
+
info?(msg: string): void;
|
|
11
|
+
warn?(msg: string): void;
|
|
12
|
+
}
|
|
13
|
+
/** Generate the app-level `genTypes.d.ts` file. */
|
|
14
|
+
export declare function generateAppTypes(app: IApp, logger?: CodegenLogger | null): Promise<void>;
|
|
15
|
+
/** Render the `genTypes.d.ts` template text from config values + model paths. */
|
|
16
|
+
export declare function getTemplate(configs: Map<string, unknown>, modelPaths: {
|
|
17
|
+
file: string;
|
|
18
|
+
path: string;
|
|
19
|
+
}[]): Promise<string>;
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* App-level type generation. Emits a single `genTypes.d.ts` at
|
|
3
|
+
* `process.cwd()` that augments `IApp` so `getConfig('foo')` and
|
|
4
|
+
* `getModel('Bar')` are typed against the project's actual config /
|
|
5
|
+
* model files.
|
|
6
|
+
*/
|
|
7
|
+
import fs from 'node:fs/promises';
|
|
8
|
+
import path from 'node:path';
|
|
9
|
+
import { isBaseModelSource } from "./astModel.js";
|
|
10
|
+
/** A `./`-rooted, forward-slash specifier from `dir` to `target` for the emitted
|
|
11
|
+
* `import('…')`. Throws if `target` is outside `dir` (can't be a relative import)
|
|
12
|
+
* — better a clear error than an accidental absolute path baked into the file. */
|
|
13
|
+
function toRelativeSpecifier(dir, target) {
|
|
14
|
+
const rel = path.relative(dir, target);
|
|
15
|
+
if (rel.startsWith('..') || path.isAbsolute(rel)) {
|
|
16
|
+
throw new Error(`Model path "${target}" is outside the project root "${dir}"; cannot emit a relative import into genTypes.d.ts`);
|
|
17
|
+
}
|
|
18
|
+
return `./${rel.split(path.sep).join('/')}`;
|
|
19
|
+
}
|
|
20
|
+
/** Generate the app-level `genTypes.d.ts` file. */
|
|
21
|
+
export async function generateAppTypes(app, logger) {
|
|
22
|
+
const template = await getTemplate(app.internalFilesCache.configs, app.internalFilesCache.modelPaths);
|
|
23
|
+
await fs.writeFile(`${process.cwd()}/genTypes.d.ts`, template);
|
|
24
|
+
logger?.info?.('TypeScript types generated successfully at genTypes.d.ts');
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Render a TypeScript type from a runtime config value's **shape** — value
|
|
28
|
+
* *types* (`string`, `number`), never the literal values. This is emitted
|
|
29
|
+
* inline (no `import()` to resolve, so output is robust across compilers and
|
|
30
|
+
* module settings) and structure-preserving (arrays stay tuples, so patterns
|
|
31
|
+
* like `Object.values(config.list[0])` keep precise per-element types) — while
|
|
32
|
+
* never serializing a secret value into the generated file.
|
|
33
|
+
*
|
|
34
|
+
* `undefined`-valued object keys are dropped (a field whose value is absent at
|
|
35
|
+
* gen time has no knowable type; same as the historical `JSON.stringify` form).
|
|
36
|
+
*/
|
|
37
|
+
function valueToTypeString(value) {
|
|
38
|
+
if (value === null) {
|
|
39
|
+
return 'null';
|
|
40
|
+
}
|
|
41
|
+
switch (typeof value) {
|
|
42
|
+
case 'string':
|
|
43
|
+
return 'string';
|
|
44
|
+
case 'number':
|
|
45
|
+
return 'number';
|
|
46
|
+
case 'boolean':
|
|
47
|
+
return 'boolean';
|
|
48
|
+
case 'bigint':
|
|
49
|
+
return 'bigint';
|
|
50
|
+
case 'undefined':
|
|
51
|
+
return 'undefined';
|
|
52
|
+
case 'function':
|
|
53
|
+
return '((...args: any[]) => any)';
|
|
54
|
+
case 'object': {
|
|
55
|
+
if (Array.isArray(value)) {
|
|
56
|
+
return value.length === 0
|
|
57
|
+
? 'unknown[]'
|
|
58
|
+
: `[${value.map(valueToTypeString).join(', ')}]`;
|
|
59
|
+
}
|
|
60
|
+
// Only walk plain objects; anything exotic (Date, RegExp, Map, …) is opaque.
|
|
61
|
+
const proto = Object.getPrototypeOf(value);
|
|
62
|
+
if (proto !== Object.prototype && proto !== null) {
|
|
63
|
+
return 'unknown';
|
|
64
|
+
}
|
|
65
|
+
const entries = Object.entries(value).filter(([, v]) => v !== undefined);
|
|
66
|
+
if (entries.length === 0) {
|
|
67
|
+
return '{}';
|
|
68
|
+
}
|
|
69
|
+
const body = entries
|
|
70
|
+
.map(([k, v]) => `${JSON.stringify(k)}: ${valueToTypeString(v)}`)
|
|
71
|
+
.join('; ');
|
|
72
|
+
return `{ ${body} }`;
|
|
73
|
+
}
|
|
74
|
+
default:
|
|
75
|
+
return 'unknown';
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/** Render the `genTypes.d.ts` template text from config values + model paths. */
|
|
79
|
+
export async function getTemplate(configs, modelPaths) {
|
|
80
|
+
const dir = process.cwd();
|
|
81
|
+
const configTypes = Array.from(configs)
|
|
82
|
+
.map(([name, value]) => ` getConfig(configName: '${name}'): ${valueToTypeString(value)};`)
|
|
83
|
+
.join('\n');
|
|
84
|
+
// Detect `BaseModel` subclasses by parsing each model's source (no runtime
|
|
85
|
+
// import — codegen never loads the model graph / Mongoose). Result drives both
|
|
86
|
+
// the `getModel` emission and the `appInfo.user` augmentation below.
|
|
87
|
+
// One probe cache for the whole run — a shared base model parses once.
|
|
88
|
+
const modelCache = new Map();
|
|
89
|
+
const models = await Promise.all(modelPaths.map(async (modelPath) => ({
|
|
90
|
+
file: modelPath.file,
|
|
91
|
+
relPath: toRelativeSpecifier(dir, modelPath.path),
|
|
92
|
+
isBaseModel: await isBaseModelSource(modelPath.path, 0, modelCache),
|
|
93
|
+
})));
|
|
94
|
+
const modelTypes = models
|
|
95
|
+
.map((m) => m.isBaseModel
|
|
96
|
+
? ` getModel(modelName: '${m.file}'): GetModelTypeFromClass<typeof import('${m.relPath}').default>`
|
|
97
|
+
: ` getModel(modelName: '${m.file}'): import('${m.relPath}').default['mongooseModel']`)
|
|
98
|
+
.join('\n');
|
|
99
|
+
// Bind `req.appInfo.user` to the project's `User` model (if it's a BaseModel),
|
|
100
|
+
// so it follows a replaced model exactly like `getModel('User')` does. The
|
|
101
|
+
// augmentation feeds `AppUser`, which is the hydrated DOCUMENT — so wrap the
|
|
102
|
+
// model class in `InstanceType<…>` (unlike `getModel('User')` above, which
|
|
103
|
+
// returns the Model class itself).
|
|
104
|
+
const userModel = models.find((m) => m.file === 'User' && m.isBaseModel);
|
|
105
|
+
const userAppInfo = userModel
|
|
106
|
+
? `
|
|
107
|
+
declare module '@adaptivestone/framework/models/User.js' {
|
|
108
|
+
export interface AppModels {
|
|
109
|
+
User: InstanceType<GetModelTypeFromClass<typeof import('${userModel.relPath}').default>>;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
`
|
|
113
|
+
: '';
|
|
114
|
+
return `
|
|
115
|
+
import type {} from '@adaptivestone/framework/server.js';
|
|
116
|
+
import type { GetModelTypeFromClass } from '@adaptivestone/framework/modules/BaseModel.js';
|
|
117
|
+
|
|
118
|
+
declare module '@adaptivestone/framework/server.js' {
|
|
119
|
+
export interface IApp {
|
|
120
|
+
${configTypes}
|
|
121
|
+
${modelTypes}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
${userAppInfo}`;
|
|
125
|
+
}
|
|
126
|
+
//# sourceMappingURL=appTypes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"appTypes.js","sourceRoot":"","sources":["../../src/codegen/appTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;kFAEkF;AAClF,SAAS,mBAAmB,CAAC,GAAW,EAAE,MAAc;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,kCAAkC,GAAG,qDAAqD,CAChH,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC;AAQD,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAS,EACT,MAA6B;IAE7B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAChC,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAC9B,GAAG,CAAC,kBAAkB,CAAC,UAAU,CAClC,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,EAAE,IAAI,EAAE,CAAC,0DAA0D,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,2BAA2B,CAAC;QACrC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;oBACvB,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACrD,CAAC;YACD,6EAA6E;YAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,MAAM,CACrE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAC3B,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,GAAG,OAAO;iBACjB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,KAAK,IAAI,IAAI,CAAC;QACvB,CAAC;QACD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA6B,EAC7B,UAA4C;IAE5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SACpC,GAAG,CACF,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAChB,8BAA8B,IAAI,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,CACvE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,2EAA2E;IAC3E,+EAA+E;IAC/E,qEAAqE;IACrE,uEAAuE;IACvE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC;QACjD,WAAW,EAAE,MAAM,iBAAiB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC;KACpE,CAAC,CAAC,CACJ,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,CAAC,WAAW;QACX,CAAC,CAAC,4BAA4B,CAAC,CAAC,IAAI,4CAA4C,CAAC,CAAC,OAAO,aAAa;QACtG,CAAC,CAAC,4BAA4B,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,OAAO,6BAA6B,CAC5F;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,mCAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC;;;8DAGwD,SAAS,CAAC,OAAO;;;CAG9E;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;QAMD,WAAW;QACX,UAAU;;;EAGhB,WAAW,EAAE,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AST codegen emit (plan: `.plans/refactor/queued/codegen-ast.md`). Produces a
|
|
3
|
+
* controller's `.routes.gen.ts` text WITHOUT booting the app or running
|
|
4
|
+
* `importResolution`: parse → resolve (extends-walk) → build the shared
|
|
5
|
+
* `ControllerSubtreeSpec` → flatten via the real `RouteRegistry` → feed the
|
|
6
|
+
* shared `renderGenFile`. This is the project's sole codegen front-end (the old
|
|
7
|
+
* boot/`importResolution` path was removed once this was proven byte-identical).
|
|
8
|
+
*
|
|
9
|
+
* `generateRouteTypesViaAst` registers ALL controllers into ONE registry (so
|
|
10
|
+
* cross-controller bleed resolves exactly as runtime) and reports any controller
|
|
11
|
+
* whose source isn't statically analyzable (`needsBoot`) so the caller
|
|
12
|
+
* (`generateAll`) throws and names it — there is no boot fallback.
|
|
13
|
+
*/
|
|
14
|
+
import type { IApp } from '../server.ts';
|
|
15
|
+
import type { CodegenLogger } from './appTypes.ts';
|
|
16
|
+
/** A planned gen-file write: its target path and rendered text. */
|
|
17
|
+
export interface PlannedOutput {
|
|
18
|
+
outPath: string;
|
|
19
|
+
text: string;
|
|
20
|
+
}
|
|
21
|
+
/** Result of analyzing (but not writing) the route types. */
|
|
22
|
+
export interface RoutePlan {
|
|
23
|
+
/** Gen files to write (user controllers only; framework-internal skipped). */
|
|
24
|
+
outputs: PlannedOutput[];
|
|
25
|
+
/** Controllers that aren't statically analyzable (caller throws). */
|
|
26
|
+
needsBoot: string[];
|
|
27
|
+
/** Existing `*.routes.gen.ts` in the user folder with no sibling source. */
|
|
28
|
+
orphans: string[];
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Analyze the project's controller sources (no import, no boot) and return the
|
|
32
|
+
* gen files to write — WITHOUT writing anything. Registers all controllers
|
|
33
|
+
* (framework-internal + user) into one registry so cross-controller bleed
|
|
34
|
+
* resolves exactly like runtime, then renders each user controller's gen text.
|
|
35
|
+
*
|
|
36
|
+
* Pure analysis so the caller can fail before any write (atomicity) and so a
|
|
37
|
+
* `--check` run can compare against disk using the exact same rendering path.
|
|
38
|
+
*/
|
|
39
|
+
export declare function planRouteTypes(app: IApp, logger?: CodegenLogger | null): Promise<RoutePlan>;
|
|
40
|
+
/**
|
|
41
|
+
* AST-primary route-type generation: plan, then write each user controller's
|
|
42
|
+
* `<File>.routes.gen.ts` and delete orphaned gen files. If ANY controller isn't
|
|
43
|
+
* statically analyzable nothing is written and the paths are returned so the
|
|
44
|
+
* caller throws and names them. There is no boot fallback.
|
|
45
|
+
*/
|
|
46
|
+
export declare function generateRouteTypesViaAst(app: IApp, logger?: CodegenLogger | null): Promise<{
|
|
47
|
+
written: number;
|
|
48
|
+
needsBoot: string[];
|
|
49
|
+
}>;
|
|
50
|
+
/** Write the planned gen files to disk. */
|
|
51
|
+
export declare function writePlanned(outputs: PlannedOutput[], logger?: CodegenLogger | null): Promise<void>;
|
|
52
|
+
/** Delete orphaned gen files (those with no sibling controller source). */
|
|
53
|
+
export declare function deleteOrphans(orphans: string[], logger?: CodegenLogger | null): Promise<void>;
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AST codegen emit (plan: `.plans/refactor/queued/codegen-ast.md`). Produces a
|
|
3
|
+
* controller's `.routes.gen.ts` text WITHOUT booting the app or running
|
|
4
|
+
* `importResolution`: parse → resolve (extends-walk) → build the shared
|
|
5
|
+
* `ControllerSubtreeSpec` → flatten via the real `RouteRegistry` → feed the
|
|
6
|
+
* shared `renderGenFile`. This is the project's sole codegen front-end (the old
|
|
7
|
+
* boot/`importResolution` path was removed once this was proven byte-identical).
|
|
8
|
+
*
|
|
9
|
+
* `generateRouteTypesViaAst` registers ALL controllers into ONE registry (so
|
|
10
|
+
* cross-controller bleed resolves exactly as runtime) and reports any controller
|
|
11
|
+
* whose source isn't statically analyzable (`needsBoot`) so the caller
|
|
12
|
+
* (`generateAll`) throws and names it — there is no boot fallback.
|
|
13
|
+
*/
|
|
14
|
+
import { existsSync, promises as fs } from 'node:fs';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import { fileURLToPath } from 'node:url';
|
|
17
|
+
import { buildSubtreeFromSpec, convertPathSyntax, } from "../controllers/index.js";
|
|
18
|
+
import { getFilesPathWithInheritance } from "../helpers/files.js";
|
|
19
|
+
import { RouteRegistry } from "../services/http/routing/RouteRegistry.js";
|
|
20
|
+
import { specFromExtracted } from "./astSpec.js";
|
|
21
|
+
import { renderGenFile } from "./emit.js";
|
|
22
|
+
/**
|
|
23
|
+
* Analyze the project's controller sources (no import, no boot) and return the
|
|
24
|
+
* gen files to write — WITHOUT writing anything. Registers all controllers
|
|
25
|
+
* (framework-internal + user) into one registry so cross-controller bleed
|
|
26
|
+
* resolves exactly like runtime, then renders each user controller's gen text.
|
|
27
|
+
*
|
|
28
|
+
* Pure analysis so the caller can fail before any write (atomicity) and so a
|
|
29
|
+
* `--check` run can compare against disk using the exact same rendering path.
|
|
30
|
+
*/
|
|
31
|
+
export async function planRouteTypes(app, logger) {
|
|
32
|
+
const discovered = await discoverControllers(app.foldersConfig.controllers, logger);
|
|
33
|
+
logger?.info?.(`Found ${discovered.length} controller source(s) for route types`);
|
|
34
|
+
// One parse cache for the whole run — shared ancestors parse once.
|
|
35
|
+
const cache = new Map();
|
|
36
|
+
const resolvedAll = await Promise.all(discovered.map(async (d) => ({
|
|
37
|
+
...d,
|
|
38
|
+
...(await specFromExtracted(d.srcPath, d.prefix, cache)),
|
|
39
|
+
})));
|
|
40
|
+
const orphans = await findOrphanGenFiles(app.foldersConfig.controllers);
|
|
41
|
+
const needsBoot = resolvedAll
|
|
42
|
+
.filter((r) => r.resolved.needsBoot)
|
|
43
|
+
.map((r) => r.srcPath);
|
|
44
|
+
if (needsBoot.length > 0) {
|
|
45
|
+
logger?.info?.(`${needsBoot.length} controller(s) aren't statically analyzable — no route types written (caller will throw)`);
|
|
46
|
+
return { outputs: [], needsBoot, orphans };
|
|
47
|
+
}
|
|
48
|
+
// One registry resolves cross-controller bleed exactly like runtime. Register
|
|
49
|
+
// BOTH framework-internal and user controllers so bleed/conflict sees the full
|
|
50
|
+
// picture. A per-controller collision pre-check names BOTH offending files —
|
|
51
|
+
// the raw registry error only carries the segment.
|
|
52
|
+
//
|
|
53
|
+
// Note: the runtime sorts `index` controllers first; codegen registers in
|
|
54
|
+
// discovery order. That divergence is harmless — the emitted types are
|
|
55
|
+
// order-insensitive (the middleware chain at each leaf is the same set, and
|
|
56
|
+
// type intersections commute). Do not "fix" the order into a real difference.
|
|
57
|
+
const registry = new RouteRegistry();
|
|
58
|
+
const owner = new Map();
|
|
59
|
+
for (const r of resolvedAll) {
|
|
60
|
+
const check = new RouteRegistry();
|
|
61
|
+
check.registerSubtree(r.resolved.urlPrefix, buildSubtreeFromSpec(r.spec));
|
|
62
|
+
for (const fr of check.flatten()) {
|
|
63
|
+
const key = `${fr.method} ${fr.path}`;
|
|
64
|
+
const prev = owner.get(key);
|
|
65
|
+
if (prev && prev !== r.srcPath) {
|
|
66
|
+
throw new Error(`Route-type codegen: conflicting route ${key} is declared by both ${prev} and ${r.srcPath}`);
|
|
67
|
+
}
|
|
68
|
+
owner.set(key, r.srcPath);
|
|
69
|
+
}
|
|
70
|
+
registry.registerSubtree(r.resolved.urlPrefix, buildSubtreeFromSpec(r.spec));
|
|
71
|
+
}
|
|
72
|
+
const flatByKey = indexFlat(registry.flatten());
|
|
73
|
+
const outputs = [];
|
|
74
|
+
for (const r of resolvedAll) {
|
|
75
|
+
// Framework-internal controllers ship pre-generated gen files — registered
|
|
76
|
+
// above for bleed, but never written into the installed package.
|
|
77
|
+
if (r.isInternal) {
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
const text = renderResolved(r.srcPath, r.resolved, flatByKey, r.resolved.urlPrefix);
|
|
81
|
+
const outPath = path.join(path.dirname(r.srcPath),
|
|
82
|
+
// Strip whichever source extension (.ts or .js); the gen file is always .ts.
|
|
83
|
+
`${path.basename(r.srcPath, path.extname(r.srcPath))}.routes.gen.ts`);
|
|
84
|
+
outputs.push({ outPath, text });
|
|
85
|
+
}
|
|
86
|
+
return { outputs, needsBoot: [], orphans };
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* AST-primary route-type generation: plan, then write each user controller's
|
|
90
|
+
* `<File>.routes.gen.ts` and delete orphaned gen files. If ANY controller isn't
|
|
91
|
+
* statically analyzable nothing is written and the paths are returned so the
|
|
92
|
+
* caller throws and names them. There is no boot fallback.
|
|
93
|
+
*/
|
|
94
|
+
export async function generateRouteTypesViaAst(app, logger) {
|
|
95
|
+
const plan = await planRouteTypes(app, logger);
|
|
96
|
+
if (plan.needsBoot.length > 0) {
|
|
97
|
+
return { written: 0, needsBoot: plan.needsBoot };
|
|
98
|
+
}
|
|
99
|
+
await writePlanned(plan.outputs, logger);
|
|
100
|
+
await deleteOrphans(plan.orphans, logger);
|
|
101
|
+
logger?.info?.(`Wrote ${plan.outputs.length} route-type file(s) via AST`);
|
|
102
|
+
return { written: plan.outputs.length, needsBoot: [] };
|
|
103
|
+
}
|
|
104
|
+
/** Write the planned gen files to disk. */
|
|
105
|
+
export async function writePlanned(outputs, logger) {
|
|
106
|
+
for (const { outPath, text } of outputs) {
|
|
107
|
+
await fs.writeFile(outPath, text, 'utf8');
|
|
108
|
+
logger?.info?.(` → ${outPath}`);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
/** Delete orphaned gen files (those with no sibling controller source). */
|
|
112
|
+
export async function deleteOrphans(orphans, logger) {
|
|
113
|
+
for (const orphan of orphans) {
|
|
114
|
+
await fs.rm(orphan, { force: true });
|
|
115
|
+
logger?.info?.(` ✗ removed orphan gen file ${orphan}`);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Find `*.routes.gen.ts` files under `userDir` that have no sibling controller
|
|
120
|
+
* source (`<base>.ts`/`.js`) — left behind when a controller is renamed/deleted,
|
|
121
|
+
* and a `tsc`-breaker for consumers. Scoped to the user folder; never touches the
|
|
122
|
+
* installed framework package.
|
|
123
|
+
*/
|
|
124
|
+
async function findOrphanGenFiles(userDir) {
|
|
125
|
+
let entries;
|
|
126
|
+
try {
|
|
127
|
+
entries = await fs.readdir(userDir, {
|
|
128
|
+
recursive: true,
|
|
129
|
+
withFileTypes: true,
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
return [];
|
|
134
|
+
}
|
|
135
|
+
const out = [];
|
|
136
|
+
for (const e of entries) {
|
|
137
|
+
if (!e.isFile() || !e.name.endsWith('.routes.gen.ts')) {
|
|
138
|
+
continue;
|
|
139
|
+
}
|
|
140
|
+
const parent = e.parentPath ?? userDir;
|
|
141
|
+
const base = e.name.slice(0, -'.routes.gen.ts'.length);
|
|
142
|
+
const hasSource = existsSync(path.join(parent, `${base}.ts`)) ||
|
|
143
|
+
existsSync(path.join(parent, `${base}.js`));
|
|
144
|
+
if (!hasSource) {
|
|
145
|
+
out.push(path.join(parent, e.name));
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
return out;
|
|
149
|
+
}
|
|
150
|
+
// ─── helpers ─────────────────────────────────────────────────────────────────
|
|
151
|
+
/** Render a resolved controller's gen text using the chains in `flatByKey`. */
|
|
152
|
+
function renderResolved(srcPath, resolved, flatByKey, urlPrefix) {
|
|
153
|
+
const routes = resolved.routes.map((r) => ({
|
|
154
|
+
method: r.method,
|
|
155
|
+
path: r.path,
|
|
156
|
+
handlerName: r.handler,
|
|
157
|
+
hasSchema: r.hasRequest,
|
|
158
|
+
hasQuerySchema: r.hasQuery,
|
|
159
|
+
...(r.requestContentTypes
|
|
160
|
+
? { requestContentTypes: r.requestContentTypes }
|
|
161
|
+
: {}),
|
|
162
|
+
}));
|
|
163
|
+
const importMap = new Map(resolved.imports.map((i) => [i.binding, i.specifier]));
|
|
164
|
+
// Only bindings this controller actually imports are emittable. A middleware
|
|
165
|
+
// that bleeds in from another controller (a root-mounted splat) but isn't in
|
|
166
|
+
// this file's import map is dropped — it can't be referenced by name here, so
|
|
167
|
+
// there's no `import type` to emit for it.
|
|
168
|
+
const importable = new Set(importMap.keys());
|
|
169
|
+
const filteredChains = routes.map((route) => chainAt(flatByKey, route.method.toUpperCase(), joinPath(urlPrefix, convertPathSyntax(route.path)), importable));
|
|
170
|
+
const controller = {
|
|
171
|
+
className: resolved.className ?? 'Unknown',
|
|
172
|
+
prefix: '',
|
|
173
|
+
urlPrefix,
|
|
174
|
+
routes,
|
|
175
|
+
};
|
|
176
|
+
return renderGenFile({ controller, srcPath, filteredChains, importMap });
|
|
177
|
+
}
|
|
178
|
+
/** The deduped, importable middleware chain (binding names) for one flat route. */
|
|
179
|
+
function chainAt(flatByKey, method, absPath, importable) {
|
|
180
|
+
const fr = flatByKey.get(`${method} ${absPath}`);
|
|
181
|
+
if (!fr) {
|
|
182
|
+
return [];
|
|
183
|
+
}
|
|
184
|
+
const seen = new Set();
|
|
185
|
+
const out = [];
|
|
186
|
+
for (const entry of fr.middlewares) {
|
|
187
|
+
const name = entry.Class.name;
|
|
188
|
+
if (importable.has(name) && !seen.has(name)) {
|
|
189
|
+
seen.add(name);
|
|
190
|
+
out.push({ className: name });
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
return out;
|
|
194
|
+
}
|
|
195
|
+
function indexFlat(flat) {
|
|
196
|
+
const out = new Map();
|
|
197
|
+
for (const fr of flat) {
|
|
198
|
+
out.set(`${fr.method} ${fr.path}`, fr);
|
|
199
|
+
}
|
|
200
|
+
return out;
|
|
201
|
+
}
|
|
202
|
+
/** Join a controller's URL prefix with a route sub-path the way the registry
|
|
203
|
+
* builds flat-route paths (segment join, no trailing slash). */
|
|
204
|
+
function joinPath(prefix, sub) {
|
|
205
|
+
const segments = [...prefix.split('/'), ...sub.split('/')].filter((s) => s.length > 0);
|
|
206
|
+
return segments.length === 0 ? '/' : `/${segments.join('/')}`;
|
|
207
|
+
}
|
|
208
|
+
/** The framework's own controllers dir (a sibling of this codegen module). */
|
|
209
|
+
function frameworkControllersDir() {
|
|
210
|
+
return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../controllers');
|
|
211
|
+
}
|
|
212
|
+
function isUnder(parent, child) {
|
|
213
|
+
const rel = path.relative(parent, child);
|
|
214
|
+
return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* Discover controller sources exactly like the runtime loader
|
|
218
|
+
* (`getFilesPathWithInheritance`): merge the framework's internal controllers
|
|
219
|
+
* with the user folder (user filename wins on collision), applying the same
|
|
220
|
+
* capital-first / not-test / not-gen / not-`.d.ts` filter. Each file carries its
|
|
221
|
+
* folder `prefix` (drives the default mount path) and an `isInternal` flag.
|
|
222
|
+
*/
|
|
223
|
+
async function discoverControllers(userDir, logger) {
|
|
224
|
+
const internalDir = frameworkControllersDir();
|
|
225
|
+
// When codegen runs inside the framework repo itself, the user dir IS the
|
|
226
|
+
// internal dir — there's nothing external to skip, so emit everything.
|
|
227
|
+
const sameTree = path.resolve(internalDir) === path.resolve(userDir);
|
|
228
|
+
const files = await getFilesPathWithInheritance({
|
|
229
|
+
internalFolder: internalDir,
|
|
230
|
+
externalFolder: userDir,
|
|
231
|
+
logger: (m) => logger?.info?.(m),
|
|
232
|
+
});
|
|
233
|
+
return files.map(({ path: srcPath, file }) => {
|
|
234
|
+
const dir = path.dirname(file);
|
|
235
|
+
return {
|
|
236
|
+
srcPath,
|
|
237
|
+
prefix: dir === '.' ? '' : dir,
|
|
238
|
+
isInternal: !sameTree && isUnder(internalDir, srcPath),
|
|
239
|
+
};
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
//# sourceMappingURL=astEmit.js.map
|