@adaptivestone/framework 5.0.0-beta.9 → 5.0.0-rc.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENCE +1 -1
- package/README.md +66 -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 +83 -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
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Codegen model detection via AST (plan: `.plans/refactor/queued/codegen-ast.md`
|
|
3
|
+
* Phase 5 / P1j Phase 3). Decides whether a model is a `BaseModel` subclass by
|
|
4
|
+
* walking its `extends` chain in SOURCE — so `appTypes` no longer `import()`s
|
|
5
|
+
* every model file (which drags in Mongoose and the whole model graph) just to
|
|
6
|
+
* run an `instanceof` check.
|
|
7
|
+
*/
|
|
8
|
+
import { promises as fs } from 'node:fs';
|
|
9
|
+
import { createRequire } from 'node:module';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { extractController } from "./astExtract.js";
|
|
12
|
+
import { resolveRelativeFile } from "./paths.js";
|
|
13
|
+
/**
|
|
14
|
+
* Is the model at `srcPath` a `BaseModel` subclass? Walks the `extends` chain in
|
|
15
|
+
* source (relative AND bare-package ancestors), matching the framework's
|
|
16
|
+
* `BaseModel` module by its specifier basename — so an aliased import
|
|
17
|
+
* (`import { BaseModel as BM }`) is handled too. No runtime import.
|
|
18
|
+
*/
|
|
19
|
+
export async function isBaseModelSource(srcPath, depth = 0, cache) {
|
|
20
|
+
const cached = cache?.get(srcPath);
|
|
21
|
+
if (cached !== undefined) {
|
|
22
|
+
return cached;
|
|
23
|
+
}
|
|
24
|
+
const result = await computeIsBaseModelSource(srcPath, depth, cache);
|
|
25
|
+
cache?.set(srcPath, result);
|
|
26
|
+
return result;
|
|
27
|
+
}
|
|
28
|
+
async function computeIsBaseModelSource(srcPath, depth, cache) {
|
|
29
|
+
if (depth > 5) {
|
|
30
|
+
return false;
|
|
31
|
+
}
|
|
32
|
+
let source;
|
|
33
|
+
try {
|
|
34
|
+
source = await fs.readFile(srcPath, 'utf8');
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
const ex = extractController(source, srcPath);
|
|
40
|
+
if (!ex.extendsName) {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
const info = ex.imports[ex.extendsName];
|
|
44
|
+
if (!info) {
|
|
45
|
+
// Unresolved import — fall back to the binding name (`extends BaseModel`).
|
|
46
|
+
return ex.extendsName === 'BaseModel';
|
|
47
|
+
}
|
|
48
|
+
// Direct: extends a class imported from the framework's `BaseModel` module.
|
|
49
|
+
if (moduleBaseName(info.specifier) === 'BaseModel') {
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
// Indirect: `class User extends MyBase` where `MyBase extends BaseModel`.
|
|
53
|
+
const parent = resolveRelativeOrBare(info.specifier, srcPath);
|
|
54
|
+
return parent ? isBaseModelSource(parent, depth + 1, cache) : false;
|
|
55
|
+
}
|
|
56
|
+
/** A specifier's module name without directory or extension (`…/BaseModel.js` → `BaseModel`). */
|
|
57
|
+
function moduleBaseName(spec) {
|
|
58
|
+
return (spec.split('/').pop() ?? '').replace(/\.[jt]s$/, '');
|
|
59
|
+
}
|
|
60
|
+
/** Resolve an extends specifier to a source file: relative (probe `.ts`/`.js`/
|
|
61
|
+
* `index.*`) or bare-package (through the importing file's module resolution). */
|
|
62
|
+
function resolveRelativeOrBare(spec, fromFile) {
|
|
63
|
+
if (spec.startsWith('.')) {
|
|
64
|
+
return resolveRelativeFile(path.dirname(fromFile), spec);
|
|
65
|
+
}
|
|
66
|
+
try {
|
|
67
|
+
return createRequire(fromFile).resolve(spec);
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
return null;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=astModel.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"astModel.js","sourceRoot":"","sources":["../../src/codegen/astModel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,KAAK,GAAG,CAAC,EACT,KAA4B;IAE5B,MAAM,MAAM,GAAG,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACrE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,OAAe,EACf,KAAa,EACb,KAA4B;IAE5B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,2EAA2E;QAC3E,OAAO,EAAE,CAAC,WAAW,KAAK,WAAW,CAAC;IACxC,CAAC;IACD,4EAA4E;IAC5E,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,0EAA0E;IAC1E,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAED,iGAAiG;AACjG,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;kFACkF;AAClF,SAAS,qBAAqB,CAAC,IAAY,EAAE,QAAgB;IAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Codegen extends-walk + inheritance merge (plan:
|
|
3
|
+
* `.plans/refactor/queued/codegen-ast.md` · design: `docs/codegen-ast-approach.md`).
|
|
4
|
+
*
|
|
5
|
+
* Bridges the per-file `astExtract` reader to what the codegen front-end needs:
|
|
6
|
+
* a controller's EFFECTIVE middleware (own map, or — matching JS static-getter
|
|
7
|
+
* inheritance — the nearest ancestor that defines `static get middleware()`) plus
|
|
8
|
+
* an emittable `binding → specifier` import map for those middlewares, resolved
|
|
9
|
+
* across relative AND bare-package ancestors.
|
|
10
|
+
*
|
|
11
|
+
* This replaced `importResolution.ts` (since deleted). The hard part the regex
|
|
12
|
+
* version paid for — recovering a binding from a live class by identity matching,
|
|
13
|
+
* because the registry handed it class objects with no source path — is gone:
|
|
14
|
+
* the binding IS the import-node name, read directly. What remains is pure path
|
|
15
|
+
* math (was shared with the old emit):
|
|
16
|
+
* - a relative ancestor's middleware imports are rebased to the child gen-file
|
|
17
|
+
* directory (the gen file sits next to the controller);
|
|
18
|
+
* - a bare-package ancestor's relative imports are rewritten into bare specifiers
|
|
19
|
+
* rooted at that ancestor's package subpath (the public subpath tree mirrors
|
|
20
|
+
* `src/`).
|
|
21
|
+
*
|
|
22
|
+
* When the controller's `routes` getter isn't a literal, `needsBoot` is set; the
|
|
23
|
+
* controller can't be statically analyzed and `generateAll` throws (no fallback).
|
|
24
|
+
*/
|
|
25
|
+
import { type ExtractResult, type ImportInfo, type MiddlewareScope, type RouteInfo } from './astExtract.ts';
|
|
26
|
+
export interface ResolvedImport extends ImportInfo {
|
|
27
|
+
/** The local binding the gen file emits (`import type <binding> from …`). */
|
|
28
|
+
binding: string;
|
|
29
|
+
}
|
|
30
|
+
/** Per-run cache of parsed sources by absolute path, so a shared ancestor
|
|
31
|
+
* (e.g. `AbstractController`) is read + parsed once per generation run, not once
|
|
32
|
+
* per controller. No mtime/persistence — content is stable within a run. */
|
|
33
|
+
export type ExtractCache = Map<string, ExtractResult>;
|
|
34
|
+
export interface ResolvedController {
|
|
35
|
+
className?: string;
|
|
36
|
+
/** Mount path: the literal `getHttpPath()` return, else `/<classname>`. */
|
|
37
|
+
urlPrefix: string;
|
|
38
|
+
routes: RouteInfo[];
|
|
39
|
+
/** Effective middleware (own, or inherited from the nearest defining ancestor). */
|
|
40
|
+
middleware: MiddlewareScope[];
|
|
41
|
+
/** Emittable import for each middleware binding in `middleware`. */
|
|
42
|
+
imports: ResolvedImport[];
|
|
43
|
+
/** True when a getter / `getHttpPath` wasn't a literal — not analyzable (throws). */
|
|
44
|
+
needsBoot: boolean;
|
|
45
|
+
reason?: string;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Resolve a controller's routes + effective middleware + emittable imports.
|
|
49
|
+
* `prefix` is the controller's folder relative to the controllers root (e.g.
|
|
50
|
+
* `admin` for `controllers/admin/Users.ts`); it feeds the default mount path
|
|
51
|
+
* exactly as the runtime loader does, so nested controllers mount correctly.
|
|
52
|
+
*/
|
|
53
|
+
export declare function resolveController(srcPath: string, prefix?: string, cache?: ExtractCache): Promise<ResolvedController>;
|
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Codegen extends-walk + inheritance merge (plan:
|
|
3
|
+
* `.plans/refactor/queued/codegen-ast.md` · design: `docs/codegen-ast-approach.md`).
|
|
4
|
+
*
|
|
5
|
+
* Bridges the per-file `astExtract` reader to what the codegen front-end needs:
|
|
6
|
+
* a controller's EFFECTIVE middleware (own map, or — matching JS static-getter
|
|
7
|
+
* inheritance — the nearest ancestor that defines `static get middleware()`) plus
|
|
8
|
+
* an emittable `binding → specifier` import map for those middlewares, resolved
|
|
9
|
+
* across relative AND bare-package ancestors.
|
|
10
|
+
*
|
|
11
|
+
* This replaced `importResolution.ts` (since deleted). The hard part the regex
|
|
12
|
+
* version paid for — recovering a binding from a live class by identity matching,
|
|
13
|
+
* because the registry handed it class objects with no source path — is gone:
|
|
14
|
+
* the binding IS the import-node name, read directly. What remains is pure path
|
|
15
|
+
* math (was shared with the old emit):
|
|
16
|
+
* - a relative ancestor's middleware imports are rebased to the child gen-file
|
|
17
|
+
* directory (the gen file sits next to the controller);
|
|
18
|
+
* - a bare-package ancestor's relative imports are rewritten into bare specifiers
|
|
19
|
+
* rooted at that ancestor's package subpath (the public subpath tree mirrors
|
|
20
|
+
* `src/`).
|
|
21
|
+
*
|
|
22
|
+
* When the controller's `routes` getter isn't a literal, `needsBoot` is set; the
|
|
23
|
+
* controller can't be statically analyzed and `generateAll` throws (no fallback).
|
|
24
|
+
*/
|
|
25
|
+
import { promises as fs } from 'node:fs';
|
|
26
|
+
import { createRequire } from 'node:module';
|
|
27
|
+
import path from 'node:path';
|
|
28
|
+
import { defaultControllerHttpPath } from "../modules/AbstractController.js";
|
|
29
|
+
import { extractController, } from "./astExtract.js";
|
|
30
|
+
import { relativeImport, resolveRelativeFile } from "./paths.js";
|
|
31
|
+
async function readAndExtract(absPath, cache) {
|
|
32
|
+
const cached = cache?.get(absPath);
|
|
33
|
+
if (cached) {
|
|
34
|
+
return cached;
|
|
35
|
+
}
|
|
36
|
+
let source;
|
|
37
|
+
try {
|
|
38
|
+
source = await fs.readFile(absPath, 'utf8');
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return null; // source unreachable
|
|
42
|
+
}
|
|
43
|
+
const ex = extractController(source, absPath);
|
|
44
|
+
cache?.set(absPath, ex);
|
|
45
|
+
return ex;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Resolve a controller's routes + effective middleware + emittable imports.
|
|
49
|
+
* `prefix` is the controller's folder relative to the controllers root (e.g.
|
|
50
|
+
* `admin` for `controllers/admin/Users.ts`); it feeds the default mount path
|
|
51
|
+
* exactly as the runtime loader does, so nested controllers mount correctly.
|
|
52
|
+
*/
|
|
53
|
+
export async function resolveController(srcPath, prefix = '', cache) {
|
|
54
|
+
const childDir = path.dirname(srcPath);
|
|
55
|
+
const source = await fs.readFile(srcPath, 'utf8');
|
|
56
|
+
const self = extractController(source, srcPath);
|
|
57
|
+
cache?.set(srcPath, self);
|
|
58
|
+
// The controller's own routes + needsBoot come from itself. Middleware may be
|
|
59
|
+
// inherited, so it's resolved by walking `extends`.
|
|
60
|
+
const found = self.middleware
|
|
61
|
+
? { file: srcPath, ex: self, rewriteBase: null }
|
|
62
|
+
: await findMiddlewareDefiner(srcPath, self, cache);
|
|
63
|
+
// A non-literal `static get middleware()` reached UP the chain (the child's own
|
|
64
|
+
// is already covered by `self.ok`): treat it like the child case — not
|
|
65
|
+
// statically analyzable, so the run throws instead of dropping real middleware.
|
|
66
|
+
const ancestorMiddlewareDynamic = found === 'dynamic';
|
|
67
|
+
// An `extends` import that couldn't be followed → unknown inherited middleware.
|
|
68
|
+
const unresolvableAncestor = found !== null && found !== 'dynamic' && 'unresolvable' in found
|
|
69
|
+
? found.unresolvable
|
|
70
|
+
: null;
|
|
71
|
+
const definer = found !== null && found !== 'dynamic' && !('unresolvable' in found)
|
|
72
|
+
? found
|
|
73
|
+
: null;
|
|
74
|
+
const middleware = definer?.ex.middleware ?? [];
|
|
75
|
+
// Emittable imports cover BOTH the effective (Map) middleware — from the
|
|
76
|
+
// defining file (an ancestor, rebased) — and route-level middleware, which is
|
|
77
|
+
// always declared in (and imported by) the controller itself. A binding in
|
|
78
|
+
// both resolves to the controller's own import (child wins), so route-level is
|
|
79
|
+
// merged last.
|
|
80
|
+
const mapBindings = new Set();
|
|
81
|
+
for (const scope of middleware) {
|
|
82
|
+
for (const b of scope.bindings) {
|
|
83
|
+
mapBindings.add(b);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
const routeBindings = new Set();
|
|
87
|
+
for (const r of self.routes) {
|
|
88
|
+
for (const b of r.middleware ?? []) {
|
|
89
|
+
routeBindings.add(b);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
const byBinding = new Map();
|
|
93
|
+
if (definer) {
|
|
94
|
+
for (const i of resolveBindingImports(mapBindings, definer, srcPath, childDir)) {
|
|
95
|
+
byBinding.set(i.binding, i);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
const selfDefiner = { file: srcPath, ex: self, rewriteBase: null };
|
|
99
|
+
for (const i of resolveBindingImports(routeBindings, selfDefiner, srcPath, childDir)) {
|
|
100
|
+
byBinding.set(i.binding, i);
|
|
101
|
+
}
|
|
102
|
+
// A middleware the controller references in its OWN map/routes but doesn't
|
|
103
|
+
// import is either a class declared in this same file — keep it, importing from
|
|
104
|
+
// the controller's own module if exported, fail loud if not — or a genuinely
|
|
105
|
+
// foreign bleed-in, left to the importable filter at emit. (Inherited-map
|
|
106
|
+
// bindings come from the ancestor file, so only the self case is checked.)
|
|
107
|
+
const ownBindings = new Set(routeBindings);
|
|
108
|
+
if (definer?.file === srcPath) {
|
|
109
|
+
for (const b of mapBindings) {
|
|
110
|
+
ownBindings.add(b);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
const unexportedLocalMw = [];
|
|
114
|
+
for (const binding of ownBindings) {
|
|
115
|
+
if (byBinding.has(binding)) {
|
|
116
|
+
continue; // resolved via an import
|
|
117
|
+
}
|
|
118
|
+
const localExported = self.localClasses[binding];
|
|
119
|
+
if (localExported === undefined) {
|
|
120
|
+
continue; // not declared in this file — foreign/global, handled by the filter
|
|
121
|
+
}
|
|
122
|
+
if (!localExported) {
|
|
123
|
+
unexportedLocalMw.push(binding);
|
|
124
|
+
continue;
|
|
125
|
+
}
|
|
126
|
+
byBinding.set(binding, {
|
|
127
|
+
binding,
|
|
128
|
+
kind: 'named',
|
|
129
|
+
specifier: relativeImport(childDir, srcPath),
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
const imports = [...byBinding.values()];
|
|
133
|
+
// `self.ok` is false when routes / own-middleware / getHttpPath weren't
|
|
134
|
+
// literals; that (or no exported class, a dynamic ancestor middleware Map, an
|
|
135
|
+
// unresolvable ancestor import, or a locally-declared-but-unexported
|
|
136
|
+
// middleware) → not statically analyzable (the run throws; the `needsBoot`
|
|
137
|
+
// name is kept for the flag's history).
|
|
138
|
+
const needsBoot = !self.ok ||
|
|
139
|
+
!self.className ||
|
|
140
|
+
ancestorMiddlewareDynamic ||
|
|
141
|
+
unresolvableAncestor !== null ||
|
|
142
|
+
unexportedLocalMw.length > 0;
|
|
143
|
+
// An explicit literal `getHttpPath()` wins; otherwise the mount path is the
|
|
144
|
+
// folder prefix + class name, computed identically to the runtime loader.
|
|
145
|
+
const urlPrefix = self.httpPath ?? defaultControllerHttpPath(prefix, self.className ?? '');
|
|
146
|
+
return {
|
|
147
|
+
className: self.className,
|
|
148
|
+
urlPrefix,
|
|
149
|
+
routes: self.routes,
|
|
150
|
+
middleware,
|
|
151
|
+
imports,
|
|
152
|
+
needsBoot,
|
|
153
|
+
reason: needsBoot
|
|
154
|
+
? (self.reason ??
|
|
155
|
+
(ancestorMiddlewareDynamic
|
|
156
|
+
? "an ancestor's `static get middleware()` is not a literal Map"
|
|
157
|
+
: unresolvableAncestor !== null
|
|
158
|
+
? `could not resolve the \`extends\` ancestor '${unresolvableAncestor.specifier}' imported by ${unresolvableAncestor.file}`
|
|
159
|
+
: unexportedLocalMw.length > 0
|
|
160
|
+
? `middleware ${unexportedLocalMw
|
|
161
|
+
.map((b) => `\`${b}\``)
|
|
162
|
+
.join(', ')} declared in this file but not exported — export it or move it to its own module`
|
|
163
|
+
: 'no exported controller class found'))
|
|
164
|
+
: undefined,
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
/** Walk `extends` from `srcPath` to the nearest ancestor that declares a
|
|
168
|
+
* `static get middleware()`. Returns the `Definer`, `'dynamic'` if an ancestor
|
|
169
|
+
* defines middleware but not as a literal Map, an `Unresolvable` if an ancestor
|
|
170
|
+
* import couldn't be followed, or `null` if the chain genuinely ends with no
|
|
171
|
+
* middleware declared. */
|
|
172
|
+
async function findMiddlewareDefiner(srcPath, selfEx, cache) {
|
|
173
|
+
const visited = new Set([srcPath]);
|
|
174
|
+
async function visit(fromFile, ex, rewriteBase) {
|
|
175
|
+
// A `static get middleware()` that exists here but isn't a literal Map: the
|
|
176
|
+
// chain stops being analyzable. Distinct from "no getter here" (keep walking)
|
|
177
|
+
// — conflating them would silently drop this ancestor's real middleware.
|
|
178
|
+
if (ex.middlewareDynamic) {
|
|
179
|
+
return 'dynamic';
|
|
180
|
+
}
|
|
181
|
+
if (ex.middleware !== undefined) {
|
|
182
|
+
return { file: fromFile, ex, rewriteBase };
|
|
183
|
+
}
|
|
184
|
+
if (!ex.extendsName) {
|
|
185
|
+
return null; // genuine chain end — no walkable parent
|
|
186
|
+
}
|
|
187
|
+
const spec = ex.imports[ex.extendsName]?.specifier;
|
|
188
|
+
if (!spec) {
|
|
189
|
+
return null; // parent isn't an imported binding (local/global) — can't walk
|
|
190
|
+
}
|
|
191
|
+
const next = resolveAncestor(spec, fromFile, rewriteBase);
|
|
192
|
+
if (!next) {
|
|
193
|
+
// The `extends` import exists but doesn't resolve to a file — fail loud
|
|
194
|
+
// rather than emit an empty chain that drops real inherited middleware.
|
|
195
|
+
return { unresolvable: { specifier: spec, file: fromFile } };
|
|
196
|
+
}
|
|
197
|
+
if (visited.has(next.file)) {
|
|
198
|
+
return null; // cycle stop — a legitimate end, not an unresolved import
|
|
199
|
+
}
|
|
200
|
+
visited.add(next.file);
|
|
201
|
+
const nextEx = await readAndExtract(next.file, cache);
|
|
202
|
+
if (!nextEx) {
|
|
203
|
+
return { unresolvable: { specifier: spec, file: fromFile } };
|
|
204
|
+
}
|
|
205
|
+
return visit(next.file, nextEx, next.rewriteBase);
|
|
206
|
+
}
|
|
207
|
+
return visit(srcPath, selfEx, null);
|
|
208
|
+
}
|
|
209
|
+
/** Resolve an `extends` specifier to an on-disk source + its bare context. */
|
|
210
|
+
function resolveAncestor(spec, fromFile, rewriteBase) {
|
|
211
|
+
if (spec.startsWith('.')) {
|
|
212
|
+
const file = resolveRelativeFile(path.dirname(fromFile), spec);
|
|
213
|
+
if (!file) {
|
|
214
|
+
return null;
|
|
215
|
+
}
|
|
216
|
+
// A relative parent of a bare-package file stays inside that package — carry
|
|
217
|
+
// the bare context forward, advanced to the parent's subpath.
|
|
218
|
+
return {
|
|
219
|
+
file,
|
|
220
|
+
rewriteBase: rewriteBase === null ? null : rewriteRelativeToBare(spec, rewriteBase),
|
|
221
|
+
};
|
|
222
|
+
}
|
|
223
|
+
// Bare specifier → resolve through the importing file (honors `exports`); the
|
|
224
|
+
// resolved file's bare context becomes the specifier itself.
|
|
225
|
+
try {
|
|
226
|
+
return { file: createRequire(fromFile).resolve(spec), rewriteBase: spec };
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
return null;
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
// ─── import resolution ───────────────────────────────────────────────────────
|
|
233
|
+
/** Build the emittable import for each `binding` declared in `from`'s file. */
|
|
234
|
+
function resolveBindingImports(bindings, from, srcPath, childDir) {
|
|
235
|
+
const out = [];
|
|
236
|
+
for (const binding of bindings) {
|
|
237
|
+
const info = from.ex.imports[binding];
|
|
238
|
+
if (!info) {
|
|
239
|
+
continue; // not imported in that file — dropped (can't emit)
|
|
240
|
+
}
|
|
241
|
+
out.push({
|
|
242
|
+
binding,
|
|
243
|
+
kind: info.kind,
|
|
244
|
+
...(info.orig ? { orig: info.orig } : {}),
|
|
245
|
+
specifier: emitSpecifier(info.specifier, from, srcPath, childDir),
|
|
246
|
+
});
|
|
247
|
+
}
|
|
248
|
+
return out;
|
|
249
|
+
}
|
|
250
|
+
/** Transform a defining file's import specifier into the form the child's gen
|
|
251
|
+
* file should emit (resolvable from the gen file's own directory). */
|
|
252
|
+
function emitSpecifier(spec, definer, srcPath, childDir) {
|
|
253
|
+
if (!spec.startsWith('.')) {
|
|
254
|
+
return spec; // bare specifier — resolvable from anywhere
|
|
255
|
+
}
|
|
256
|
+
if (definer.rewriteBase !== null) {
|
|
257
|
+
return rewriteRelativeToBare(spec, definer.rewriteBase);
|
|
258
|
+
}
|
|
259
|
+
if (definer.file === srcPath) {
|
|
260
|
+
return spec; // the child's own import — already relative to its gen file
|
|
261
|
+
}
|
|
262
|
+
// Relative ancestor in another directory — rebase to the child gen-file dir.
|
|
263
|
+
return relativeImport(childDir, path.resolve(path.dirname(definer.file), spec));
|
|
264
|
+
}
|
|
265
|
+
// ─── path helpers ────────────────────────────────────────────────────────────
|
|
266
|
+
/** Rewrite a relative spec into a bare one rooted at `base`'s package subpath
|
|
267
|
+
* (e.g. inside `…/modules/X.js`, `../services/Auth.ts` → `…/services/Auth.js`).
|
|
268
|
+
* The `.ts` source extension is normalized to `.js` (published tree is built). */
|
|
269
|
+
function rewriteRelativeToBare(spec, base) {
|
|
270
|
+
if (!spec.startsWith('.')) {
|
|
271
|
+
return spec;
|
|
272
|
+
}
|
|
273
|
+
const bare = path.posix.join(path.posix.dirname(base), spec);
|
|
274
|
+
return bare.endsWith('.ts') ? `${bare.slice(0, -3)}.js` : bare;
|
|
275
|
+
}
|
|
276
|
+
//# sourceMappingURL=astResolve.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"astResolve.js","sourceRoot":"","sources":["../../src/codegen/astResolve.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Adapter: AST extraction → `ControllerSubtreeSpec` (plan:
|
|
3
|
+
* `.plans/refactor/queued/codegen-ast.md`). Turns a controller's parsed source
|
|
4
|
+
* (`astResolve`) into the same plain spec the runtime builds from an instance,
|
|
5
|
+
* so codegen feeds the SHARED `buildSubtreeFromSpec` → `RouteRegistry.flatten()`
|
|
6
|
+
* — the real resolver, no parallel matcher.
|
|
7
|
+
*
|
|
8
|
+
* The spec carries SYNTHETIC stand-ins: handlers are no-op functions whose
|
|
9
|
+
* `.name` is the handler name, and each middleware is an opaque entry whose
|
|
10
|
+
* `Class.name` is the import BINDING. The registry/flatten treat both opaquely
|
|
11
|
+
* (route by scope, never call the class), and codegen reads only those names —
|
|
12
|
+
* so the live classes the boot path needed (and the identity matching that came
|
|
13
|
+
* with them) are gone. The emittable `binding → specifier` map comes from
|
|
14
|
+
* `astResolve` (`resolved.imports`), never from a live class.
|
|
15
|
+
*/
|
|
16
|
+
import { type ControllerSubtreeSpec } from '../controllers/index.ts';
|
|
17
|
+
import { type ExtractCache, type ResolvedController } from './astResolve.ts';
|
|
18
|
+
export interface AstSpec {
|
|
19
|
+
spec: ControllerSubtreeSpec;
|
|
20
|
+
/** The resolved data (routes + effective middleware + emittable imports). */
|
|
21
|
+
resolved: ResolvedController;
|
|
22
|
+
}
|
|
23
|
+
/** Build a `ControllerSubtreeSpec` from a controller's source (no instance).
|
|
24
|
+
* `prefix` is the controller's folder relative to the controllers root. */
|
|
25
|
+
export declare function specFromExtracted(srcPath: string, prefix?: string, cache?: ExtractCache): Promise<AstSpec>;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Adapter: AST extraction → `ControllerSubtreeSpec` (plan:
|
|
3
|
+
* `.plans/refactor/queued/codegen-ast.md`). Turns a controller's parsed source
|
|
4
|
+
* (`astResolve`) into the same plain spec the runtime builds from an instance,
|
|
5
|
+
* so codegen feeds the SHARED `buildSubtreeFromSpec` → `RouteRegistry.flatten()`
|
|
6
|
+
* — the real resolver, no parallel matcher.
|
|
7
|
+
*
|
|
8
|
+
* The spec carries SYNTHETIC stand-ins: handlers are no-op functions whose
|
|
9
|
+
* `.name` is the handler name, and each middleware is an opaque entry whose
|
|
10
|
+
* `Class.name` is the import BINDING. The registry/flatten treat both opaquely
|
|
11
|
+
* (route by scope, never call the class), and codegen reads only those names —
|
|
12
|
+
* so the live classes the boot path needed (and the identity matching that came
|
|
13
|
+
* with them) are gone. The emittable `binding → specifier` map comes from
|
|
14
|
+
* `astResolve` (`resolved.imports`), never from a live class.
|
|
15
|
+
*/
|
|
16
|
+
import { convertPathSyntax, parseScopeKey, } from "../controllers/index.js";
|
|
17
|
+
import { resolveController, } from "./astResolve.js";
|
|
18
|
+
/** A no-op function whose `.name` is `name` (codegen never calls it). */
|
|
19
|
+
function named(name) {
|
|
20
|
+
return { [name]: () => { } }[name];
|
|
21
|
+
}
|
|
22
|
+
/** Synthetic middleware entry carrying the binding NAME as `Class.name`. */
|
|
23
|
+
function syntheticMiddleware(binding) {
|
|
24
|
+
return { Class: named(binding) };
|
|
25
|
+
}
|
|
26
|
+
/** Build a `ControllerSubtreeSpec` from a controller's source (no instance).
|
|
27
|
+
* `prefix` is the controller's folder relative to the controllers root. */
|
|
28
|
+
export async function specFromExtracted(srcPath, prefix = '', cache) {
|
|
29
|
+
const resolved = await resolveController(srcPath, prefix, cache);
|
|
30
|
+
const handlers = resolved.routes.map((r) => {
|
|
31
|
+
const entry = {
|
|
32
|
+
handler: named(r.handler ?? 'handler'),
|
|
33
|
+
meta: { methodName: r.handler ?? undefined },
|
|
34
|
+
};
|
|
35
|
+
if (r.hasRequest) {
|
|
36
|
+
entry.request = {};
|
|
37
|
+
}
|
|
38
|
+
if (r.hasQuery) {
|
|
39
|
+
entry.query = {};
|
|
40
|
+
}
|
|
41
|
+
if (r.middleware?.length) {
|
|
42
|
+
entry.middlewares = r.middleware.map(syntheticMiddleware);
|
|
43
|
+
}
|
|
44
|
+
return {
|
|
45
|
+
method: r.method.toUpperCase(),
|
|
46
|
+
path: convertPathSyntax(r.path),
|
|
47
|
+
entry,
|
|
48
|
+
};
|
|
49
|
+
});
|
|
50
|
+
const middleware = resolved.middleware.map((scope) => {
|
|
51
|
+
const parsed = parseScopeKey(scope.scope);
|
|
52
|
+
return {
|
|
53
|
+
method: parsed.method,
|
|
54
|
+
path: convertPathSyntax(parsed.path),
|
|
55
|
+
entries: scope.bindings.map(syntheticMiddleware),
|
|
56
|
+
};
|
|
57
|
+
});
|
|
58
|
+
return {
|
|
59
|
+
spec: { ctrlName: resolved.className ?? 'Unknown', handlers, middleware },
|
|
60
|
+
resolved,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=astSpec.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"astSpec.js","sourceRoot":"","sources":["../../src/codegen/astSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,iBAAiB,EACjB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAGL,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAQzB,yEAAyE;AACzE,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,IAAI,CAAiC,CAAC;AACpE,CAAC;AAED,4EAA4E;AAC5E,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAyC,EAAE,CAAC;AAC3E,CAAC;AAED;2EAC2E;AAC3E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,MAAM,GAAG,EAAE,EACX,KAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAsC,QAAQ,CAAC,MAAM,CAAC,GAAG,CACrE,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,KAAK,GAAiB;YAC1B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC;YACtC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE;SAC7C,CAAC;QACF,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACjB,KAAK,CAAC,OAAO,GAAG,EAAsB,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,KAAK,CAAC,KAAK,GAAG,EAAsB,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACzB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,EAAgB;YAC5C,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/B,KAAK;SACN,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,UAAU,GACd,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC;YACpC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC;SACjD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,SAAS,IAAI,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE;QACzE,QAAQ;KACT,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared codegen metadata types. The AST front-end (`astExtract`/`astResolve`/
|
|
3
|
+
* `astEmit`) produces these; `emit` renders from them. (Middleware chains are
|
|
4
|
+
* computed by `RouteRegistry.flatten()`, not here.)
|
|
5
|
+
*/
|
|
6
|
+
/** One middleware reference in a route's chain, by its local import binding. */
|
|
7
|
+
export interface MiddlewareRef {
|
|
8
|
+
/** The local import binding the gen file emits (`typeof <className>`). */
|
|
9
|
+
className: string;
|
|
10
|
+
/** Present when declared as `[Class, params]` in a Map / route-level array. */
|
|
11
|
+
params?: Record<string, unknown>;
|
|
12
|
+
}
|
|
13
|
+
/** One route registered by a controller. */
|
|
14
|
+
export interface RouteMeta {
|
|
15
|
+
method: string;
|
|
16
|
+
path: string;
|
|
17
|
+
/** Method name on the controller (e.g. `'postLogin'`); `null` if unidentifiable. */
|
|
18
|
+
handlerName: string | null;
|
|
19
|
+
/** True when the route entry has a `request` schema. */
|
|
20
|
+
hasSchema: boolean;
|
|
21
|
+
/**
|
|
22
|
+
* Media-type keys when `request` is a content-type map (`{ 'application/json':
|
|
23
|
+
* schema, … }`). Drives the discriminated-union request type. Absent for a
|
|
24
|
+
* single-schema `request`.
|
|
25
|
+
*/
|
|
26
|
+
requestContentTypes?: string[];
|
|
27
|
+
/** True when the route entry has a `query` schema. */
|
|
28
|
+
hasQuerySchema: boolean;
|
|
29
|
+
}
|
|
30
|
+
/** Aggregate metadata for one controller. */
|
|
31
|
+
export interface ControllerMeta {
|
|
32
|
+
/** Class name (e.g. `'Auth'`). */
|
|
33
|
+
className: string;
|
|
34
|
+
/** Folder prefix from the auto-loader (`''` for top-level). */
|
|
35
|
+
prefix: string;
|
|
36
|
+
/** URL prefix the controller mounts at (e.g. `/auth`). */
|
|
37
|
+
urlPrefix: string;
|
|
38
|
+
routes: RouteMeta[];
|
|
39
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared codegen metadata types. The AST front-end (`astExtract`/`astResolve`/
|
|
3
|
+
* `astEmit`) produces these; `emit` renders from them. (Middleware chains are
|
|
4
|
+
* computed by `RouteRegistry.flatten()`, not here.)
|
|
5
|
+
*/
|
|
6
|
+
export {};
|
|
7
|
+
//# sourceMappingURL=collectMetadata.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectMetadata.js","sourceRoot":"","sources":["../../src/codegen/collectMetadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Render one controller's metadata + resolved middleware chains into
|
|
3
|
+
* `<File>.routes.gen.ts` text — per-handler `<Method>Request` aliases over the
|
|
4
|
+
* `InstanceType<typeof Controller>['routes']` navigation pattern.
|
|
5
|
+
*
|
|
6
|
+
* Pure rendering: the caller (the AST front-end in `astEmit.ts`) supplies the
|
|
7
|
+
* resolved chains as binding NAMES plus the `binding → specifier` import map.
|
|
8
|
+
* Framework type paths (`BaseRequestContext`, `StandardSchemaV1`) are computed
|
|
9
|
+
* relative to the controller's location.
|
|
10
|
+
*/
|
|
11
|
+
import type { ControllerMeta, MiddlewareRef } from './collectMetadata.ts';
|
|
12
|
+
/**
|
|
13
|
+
* Inputs for the renderer — resolution (the middleware chains as binding names +
|
|
14
|
+
* the `binding → specifier` import map) is already done by the caller.
|
|
15
|
+
*/
|
|
16
|
+
export interface RenderInput {
|
|
17
|
+
controller: ControllerMeta;
|
|
18
|
+
/** Absolute path to the controller's source `.ts` file. */
|
|
19
|
+
srcPath: string;
|
|
20
|
+
/** Resolved+filtered chains (binding names), parallel to `controller.routes`. */
|
|
21
|
+
filteredChains: MiddlewareRef[][];
|
|
22
|
+
/** `binding → specifier` for every binding referenced in `filteredChains`. */
|
|
23
|
+
importMap: Map<string, string>;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Render the gen.ts text from already-resolved chains + import map. The AST
|
|
27
|
+
* front-end (`astEmit.ts`) resolves the chains (binding names) + the import map
|
|
28
|
+
* from parsed source and feeds them here.
|
|
29
|
+
*/
|
|
30
|
+
export declare function renderGenFile(input: RenderInput): string;
|