@xrystal/core 3.32.1 → 3.37.4
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/README.md +676 -136
- package/package.json +27 -24
- package/tsconfig.base.json +15 -0
- package/x/bin/commands/create.mjs +34 -5
- package/x/bin/commands/doctor.mjs +115 -25
- package/x/bin/commands/hooks.mjs +55 -0
- package/x/bin/commands/project.mjs +75 -42
- package/x/bin/commands/release.mjs +8 -3
- package/x/bin/commands/sync-toolchain.mjs +43 -0
- package/x/bin/commands/tmp.mjs +13 -4
- package/x/bin/helpers/.generated/.generated-from +1 -0
- package/x/bin/helpers/.generated/tmp-schema.mjs +192 -0
- package/x/bin/helpers/banner.mjs +66 -12
- package/x/bin/helpers/build-config.mjs +342 -0
- package/x/bin/helpers/cli-help.mjs +164 -0
- package/x/bin/helpers/create-target.mjs +18 -2
- package/x/bin/helpers/project-artifacts.mjs +142 -0
- package/x/bin/helpers/runtime-info.mjs +172 -0
- package/x/bin/helpers/tmp-config.mjs +11 -10
- package/x/bin/helpers/tmp-layout.mjs +10 -16
- package/x/bin/helpers/tmp-schema.mjs +9 -0
- package/x/bin/helpers/toolchain-config.mjs +233 -0
- package/x/bin/main-cli.js +31 -3
- package/x/bin/scripts/clean-source-types.mjs +19 -0
- package/x/bin/scripts/fix-dist-imports.mjs +80 -0
- package/x/bin/scripts/install-git-hooks.mjs +86 -0
- package/x/bin/scripts/minify-dist.mjs +50 -0
- package/x/bin/scripts/prepare-npm-publish.mjs +39 -0
- package/x/bin/scripts/publish-guard.mjs +113 -0
- package/x/bin/scripts/verify-npm-pack.mjs +12 -0
- package/x/bin/scripts/verify-publish-config.mjs +10 -0
- package/x/bin/scripts/verify-version-bump.mjs +27 -0
- package/x/bin/scripts/version-check.mjs +173 -0
- package/x/dist/index.js +1 -0
- package/x/dist/loader/clients/index.js +1 -0
- package/x/dist/loader/configs/index.js +1 -0
- package/{source → x/dist}/loader/controller/index.d.ts +20 -17
- package/x/dist/loader/controller/index.js +1 -0
- package/x/dist/loader/dto/index.js +1 -0
- package/x/dist/loader/events/index.js +1 -0
- package/x/dist/loader/index.d.ts +11 -0
- package/x/dist/loader/index.js +1 -0
- package/{source → x/dist}/loader/kafka/index.d.ts +1 -0
- package/x/dist/loader/kafka/index.js +1 -0
- package/x/dist/loader/localizations/index.js +1 -0
- package/{source → x/dist}/loader/logger/index.d.ts +1 -0
- package/x/dist/loader/logger/index.js +2 -0
- package/x/dist/loader/service/index.js +1 -0
- package/x/dist/loader/system/index.js +1 -0
- package/x/dist/project/index.d.ts +12 -0
- package/x/dist/project/index.js +1 -0
- package/x/dist/utils/constants/defaults.json +44 -0
- package/x/dist/utils/constants/index.js +1 -0
- package/x/dist/utils/helpers/configs/index.js +1 -0
- package/x/dist/utils/helpers/context/controller-store.js +1 -0
- package/x/dist/utils/helpers/context/index.js +1 -0
- package/{source → x/dist}/utils/helpers/core/index.d.ts +1 -1
- package/x/dist/utils/helpers/core/index.js +1 -0
- package/x/dist/utils/helpers/core/paths.js +1 -0
- package/x/dist/utils/helpers/core/tmp-layout.js +1 -0
- package/x/dist/utils/helpers/date/index.js +1 -0
- package/x/dist/utils/helpers/dispatch/index.js +1 -0
- package/x/dist/utils/helpers/dto/index.js +1 -0
- package/x/dist/utils/helpers/filters/index.js +1 -0
- package/x/dist/utils/helpers/framework/index.js +1 -0
- package/x/dist/utils/helpers/handlers/adapters.js +1 -0
- package/x/dist/utils/helpers/handlers/execute.js +1 -0
- package/x/dist/utils/helpers/handlers/index.js +1 -0
- package/x/dist/utils/helpers/hash/crypto.js +1 -0
- package/x/dist/utils/helpers/id/index.js +1 -0
- package/x/dist/utils/helpers/index.js +1 -0
- package/x/dist/utils/helpers/ip/index.js +1 -0
- package/x/dist/utils/helpers/is/index.js +1 -0
- package/x/dist/utils/helpers/locales/index.js +1 -0
- package/x/dist/utils/helpers/math/index.js +1 -0
- package/{source → x/dist}/utils/helpers/middleware/index.d.ts +2 -2
- package/x/dist/utils/helpers/middleware/index.js +1 -0
- package/x/dist/utils/helpers/objects/index.js +1 -0
- package/x/dist/utils/helpers/path/index.js +1 -0
- package/{source → x/dist}/utils/helpers/protocol/index.d.ts +2 -10
- package/x/dist/utils/helpers/protocol/index.js +1 -0
- package/x/dist/utils/helpers/protocol/options.js +1 -0
- package/x/dist/utils/helpers/regex/checkSpecialRegexControl.js +1 -0
- package/x/dist/utils/helpers/runtime/dto-access.js +1 -0
- package/x/dist/utils/helpers/runtime/dto-types.js +1 -0
- package/{source → x/dist}/utils/helpers/runtime/index.d.ts +1 -0
- package/x/dist/utils/helpers/runtime/index.js +1 -0
- package/x/dist/utils/helpers/runtime/shutdown.d.ts +3 -0
- package/x/dist/utils/helpers/runtime/shutdown.js +1 -0
- package/x/dist/utils/helpers/state/index.js +1 -0
- package/x/dist/utils/helpers/state/props-from-tmp.js +1 -0
- package/x/dist/utils/helpers/state/request-key-guard.js +1 -0
- package/x/dist/utils/helpers/state/scopes.js +1 -0
- package/x/dist/utils/helpers/string/index.js +1 -0
- package/x/dist/utils/helpers/tests/tmp-schema.test.js +1 -0
- package/x/dist/utils/helpers/tests/tmp-watch.test.d.ts +1 -0
- package/x/dist/utils/helpers/tests/tmp-watch.test.js +1 -0
- package/x/dist/utils/helpers/timer/index.js +1 -0
- package/x/dist/utils/helpers/tmp/index.d.ts +5 -0
- package/x/dist/utils/helpers/tmp/index.js +1 -0
- package/x/dist/utils/helpers/tmp/loader-tmp-sync.js +1 -0
- package/{source → x/dist}/utils/helpers/tmp/runtime-tmp.d.ts +2 -6
- package/x/dist/utils/helpers/tmp/runtime-tmp.js +1 -0
- package/{source → x/dist}/utils/helpers/tmp/tmp-loader.d.ts +1 -0
- package/x/dist/utils/helpers/tmp/tmp-loader.js +1 -0
- package/x/dist/utils/helpers/tmp/tmp-schema.d.ts +47 -0
- package/x/dist/utils/helpers/tmp/tmp-schema.js +1 -0
- package/x/dist/utils/helpers/tmp/tmp-watch.d.ts +1 -0
- package/x/dist/utils/helpers/tmp/tmp-watch.js +1 -0
- package/x/dist/utils/helpers/validates/index.js +1 -0
- package/x/dist/utils/index.js +1 -0
- package/x/dist/utils/models/classes/class.clients.js +1 -0
- package/x/dist/utils/models/classes/class.interfaces.js +1 -0
- package/x/dist/utils/models/classes/class.service-locator.js +1 -0
- package/{source → x/dist}/utils/models/classes/class.tmp-file-loader.d.ts +3 -2
- package/x/dist/utils/models/classes/class.tmp-file-loader.js +1 -0
- package/x/dist/utils/models/classes/class.x.js +1 -0
- package/x/dist/utils/models/enums/index.js +1 -0
- package/x/dist/utils/models/index.js +1 -0
- package/x/dist/utils/models/types/index.js +1 -0
- package/x/dist/utils/package-root.js +1 -0
- package/x/tmp.yml +51 -42
- package/source/index.js +0 -11
- package/source/loader/clients/index.js +0 -22
- package/source/loader/configs/index.js +0 -88
- package/source/loader/controller/index.js +0 -236
- package/source/loader/dto/index.js +0 -92
- package/source/loader/events/index.js +0 -44
- package/source/loader/index.d.ts +0 -11
- package/source/loader/index.js +0 -11
- package/source/loader/kafka/index.js +0 -137
- package/source/loader/localizations/index.js +0 -46
- package/source/loader/logger/index.js +0 -217
- package/source/loader/service/index.js +0 -7
- package/source/loader/system/index.js +0 -25
- package/source/project/index.d.ts +0 -8
- package/source/project/index.js +0 -70
- package/source/utils/constants/defaults.json +0 -15
- package/source/utils/constants/defaults.mjs +0 -10
- package/source/utils/constants/index.js +0 -22
- package/source/utils/helpers/configs/index.js +0 -1
- package/source/utils/helpers/context/controller-store.js +0 -12
- package/source/utils/helpers/context/index.js +0 -24
- package/source/utils/helpers/core/index.js +0 -58
- package/source/utils/helpers/core/paths.js +0 -78
- package/source/utils/helpers/core/tmp-layout.js +0 -241
- package/source/utils/helpers/date/index.js +0 -48
- package/source/utils/helpers/dispatch/index.js +0 -53
- package/source/utils/helpers/dto/index.js +0 -10
- package/source/utils/helpers/filters/index.js +0 -44
- package/source/utils/helpers/framework/index.js +0 -17
- package/source/utils/helpers/handlers/adapters.js +0 -40
- package/source/utils/helpers/handlers/execute.js +0 -82
- package/source/utils/helpers/handlers/index.js +0 -31
- package/source/utils/helpers/hash/crypto.js +0 -22
- package/source/utils/helpers/id/index.js +0 -24
- package/source/utils/helpers/index.js +0 -26
- package/source/utils/helpers/ip/index.js +0 -21
- package/source/utils/helpers/is/index.js +0 -35
- package/source/utils/helpers/locales/index.js +0 -82
- package/source/utils/helpers/math/index.js +0 -14
- package/source/utils/helpers/middleware/index.js +0 -36
- package/source/utils/helpers/objects/index.js +0 -55
- package/source/utils/helpers/path/index.js +0 -4
- package/source/utils/helpers/protocol/index.js +0 -99
- package/source/utils/helpers/protocol/options.js +0 -13
- package/source/utils/helpers/regex/checkSpecialRegexControl.js +0 -3
- package/source/utils/helpers/runtime/dto-access.js +0 -5
- package/source/utils/helpers/runtime/index.js +0 -1
- package/source/utils/helpers/state/index.js +0 -185
- package/source/utils/helpers/state/props-from-tmp.js +0 -44
- package/source/utils/helpers/state/request-key-guard.js +0 -42
- package/source/utils/helpers/state/scopes.js +0 -69
- package/source/utils/helpers/string/index.js +0 -9
- package/source/utils/helpers/timer/index.js +0 -5
- package/source/utils/helpers/tmp/index.d.ts +0 -3
- package/source/utils/helpers/tmp/index.js +0 -3
- package/source/utils/helpers/tmp/loader-tmp-sync.js +0 -13
- package/source/utils/helpers/tmp/runtime-tmp.js +0 -30
- package/source/utils/helpers/tmp/tmp-loader.js +0 -48
- package/source/utils/helpers/validates/index.js +0 -20
- package/source/utils/index.js +0 -3
- package/source/utils/models/classes/class.clients.js +0 -142
- package/source/utils/models/classes/class.interfaces.js +0 -10
- package/source/utils/models/classes/class.service-locator.js +0 -16
- package/source/utils/models/classes/class.tmp-file-loader.js +0 -38
- package/source/utils/models/classes/class.x.js +0 -180
- package/source/utils/models/enums/index.js +0 -148
- package/source/utils/models/index.js +0 -9
- package/source/utils/models/types/index.js +0 -2
- package/source/utils/models/types/shims.d.ts +0 -123
- package/source/utils/package-root.js +0 -5
- package/x/tests/cli.test.ts +0 -85
- package/x/tests/context.test.ts +0 -25
- package/x/tests/dispatch.test.ts +0 -84
- package/x/tests/fixtures/locales/en/translation.json +0 -8
- package/x/tests/fixtures/locales/tr/translation.json +0 -8
- package/x/tests/frameworks.integration.test.ts +0 -185
- package/x/tests/helpers/i18n-setup.ts +0 -52
- package/x/tests/helpers/middleware.ts +0 -23
- package/x/tests/helpers/register-test-dto.ts +0 -52
- package/x/tests/i18n.integration.test.ts +0 -77
- package/x/tests/i18n.test.ts +0 -96
- package/x/tests/middleware.test.ts +0 -83
- package/x/tests/project-layout.test.ts +0 -65
- package/x/tests/protocol.test.ts +0 -75
- package/x/tests/realtime.examples.test.ts +0 -198
- package/x/tests/runtime-tmp.test.ts +0 -49
- package/x/tests/socket.integration.test.ts +0 -174
- package/x/tests/state.test.ts +0 -183
- package/x/tests/tmp-layout-guard.test.ts +0 -40
- /package/{source → x/dist}/index.d.ts +0 -0
- /package/{source → x/dist}/loader/clients/index.d.ts +0 -0
- /package/{source → x/dist}/loader/configs/index.d.ts +0 -0
- /package/{source → x/dist}/loader/dto/index.d.ts +0 -0
- /package/{source → x/dist}/loader/events/index.d.ts +0 -0
- /package/{source → x/dist}/loader/localizations/index.d.ts +0 -0
- /package/{source → x/dist}/loader/service/index.d.ts +0 -0
- /package/{source → x/dist}/loader/system/index.d.ts +0 -0
- /package/{source → x/dist}/utils/constants/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/configs/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/context/controller-store.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/context/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/core/paths.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/core/tmp-layout.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/date/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/dispatch/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/dto/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/filters/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/framework/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/handlers/adapters.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/handlers/execute.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/handlers/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/hash/crypto.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/id/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/ip/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/is/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/locales/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/math/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/objects/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/path/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/protocol/options.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/regex/checkSpecialRegexControl.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/runtime/dto-access.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/runtime/dto-types.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/state/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/state/props-from-tmp.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/state/request-key-guard.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/state/scopes.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/string/index.d.ts +0 -0
- /package/{source/utils/helpers/runtime/dto-types.js → x/dist/utils/helpers/tests/tmp-schema.test.d.ts} +0 -0
- /package/{source → x/dist}/utils/helpers/timer/index.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/tmp/loader-tmp-sync.d.ts +0 -0
- /package/{source → x/dist}/utils/helpers/validates/index.d.ts +0 -0
- /package/{source → x/dist}/utils/index.d.ts +0 -0
- /package/{source → x/dist}/utils/models/classes/class.clients.d.ts +0 -0
- /package/{source → x/dist}/utils/models/classes/class.interfaces.d.ts +0 -0
- /package/{source → x/dist}/utils/models/classes/class.service-locator.d.ts +0 -0
- /package/{source → x/dist}/utils/models/classes/class.x.d.ts +0 -0
- /package/{source → x/dist}/utils/models/enums/index.d.ts +0 -0
- /package/{source → x/dist}/utils/models/index.d.ts +0 -0
- /package/{source → x/dist}/utils/models/types/index.d.ts +0 -0
- /package/{source → x/dist}/utils/package-root.d.ts +0 -0
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import chalk from 'chalk'
|
|
2
|
+
import { printCommandHeader } from '../helpers/banner.mjs'
|
|
3
|
+
import { readCliPackageJson } from '../helpers/project-root.mjs'
|
|
4
|
+
|
|
5
|
+
import { syncProjectToolchain, auditTsconfigAlignment } from '../helpers/toolchain-config.mjs'
|
|
6
|
+
import { getProjectRoot } from '../helpers/project-root.mjs'
|
|
7
|
+
|
|
8
|
+
export function registerSyncToolchainCommand(cli, { cliName = 'xcore' } = {}) {
|
|
9
|
+
cli
|
|
10
|
+
.command('sync-toolchain')
|
|
11
|
+
.description('Sync tsconfig paths from tmp.yml layout')
|
|
12
|
+
.option('--dry-run', 'Show changes without writing tsconfig.json')
|
|
13
|
+
.action((options) => {
|
|
14
|
+
const root = getProjectRoot()
|
|
15
|
+
const auditBefore = auditTsconfigAlignment(root)
|
|
16
|
+
|
|
17
|
+
printCommandHeader({ cliName, command: 'sync-toolchain', version: readCliPackageJson().version })
|
|
18
|
+
console.log(chalk.gray(` root: ${root}`))
|
|
19
|
+
|
|
20
|
+
const lo = auditBefore.layoutOptions ?? {}
|
|
21
|
+
console.log(chalk.gray(' tmp.yml layout:'))
|
|
22
|
+
console.log(chalk.gray(` paths.root: ${lo.rootFolderPath ?? 'x'}`))
|
|
23
|
+
console.log(chalk.gray(` paths.source: ${lo.mainFolderPath ?? './source'}`))
|
|
24
|
+
console.log(chalk.gray(` paths.dist: ${lo.pathsDist ?? 'dist'}`))
|
|
25
|
+
|
|
26
|
+
if (options.dryRun) {
|
|
27
|
+
const preview = syncProjectToolchain(root, { write: false })
|
|
28
|
+
console.log(chalk.gray('\n would write tsconfig.json:'))
|
|
29
|
+
console.log(chalk.gray(` include: ${JSON.stringify(preview.merged.include)}`))
|
|
30
|
+
console.log(chalk.gray(` outDir: ${preview.merged.compilerOptions.outDir}`))
|
|
31
|
+
console.log(chalk.gray(` paths: ${JSON.stringify(preview.merged.compilerOptions.paths)}`))
|
|
32
|
+
console.log(chalk.gray(`\n bunfig.toml → ${preview.paths.bunfigAliasLine}\n`))
|
|
33
|
+
return
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const result = syncProjectToolchain(root, { write: true })
|
|
37
|
+
console.log(result.created ? chalk.green(` created ${result.tsconfigRel}`) : chalk.green(` updated ${result.tsconfigRel}`))
|
|
38
|
+
console.log(chalk.gray(` include → ${JSON.stringify(result.merged.include)}`))
|
|
39
|
+
console.log(chalk.gray(` outDir → ${result.merged.compilerOptions.outDir}`))
|
|
40
|
+
console.log(chalk.gray(` eslint → ${result.paths.eslintFiles.join(', ')}`))
|
|
41
|
+
console.log(chalk.yellow(`\n bunfig.toml [resolve.alias]: ${result.paths.bunfigAliasLine}\n`))
|
|
42
|
+
})
|
|
43
|
+
}
|
package/x/bin/commands/tmp.mjs
CHANGED
|
@@ -2,29 +2,33 @@ import fs from 'node:fs'
|
|
|
2
2
|
import chalk from 'chalk'
|
|
3
3
|
import yaml from 'yaml'
|
|
4
4
|
|
|
5
|
+
import { printCommandHeader } from '../helpers/banner.mjs'
|
|
5
6
|
import { resolveObjWithHandlebars } from '../helpers/index.mjs'
|
|
7
|
+
import { getProjectRoot, readCliPackageJson } from '../helpers/project-root.mjs'
|
|
6
8
|
import {
|
|
7
9
|
ensureTmpFile,
|
|
8
10
|
ownerTmpFilePath,
|
|
9
11
|
relativeFromRoot,
|
|
10
12
|
resolveTmpLayoutOrDefaults,
|
|
11
13
|
} from '../helpers/tmp-layout.mjs'
|
|
12
|
-
import { getProjectRoot } from '../helpers/project-root.mjs'
|
|
13
14
|
import { formatLoaderSummary, summarizeLoaders } from '../helpers/tmp-config.mjs'
|
|
14
15
|
|
|
15
16
|
export function registerTmpCommand(cli, { cliName = 'xcore' } = {}) {
|
|
16
17
|
cli
|
|
17
18
|
.command('tmp')
|
|
18
|
-
.description('Ensure
|
|
19
|
+
.description('Ensure tmp.yml exists (seed from @xrystal/core)')
|
|
19
20
|
.option('--dry-run', 'Show target path without writing')
|
|
20
21
|
.action((options) => {
|
|
21
22
|
const root = getProjectRoot()
|
|
23
|
+
const version = readCliPackageJson().version
|
|
22
24
|
|
|
23
25
|
if (options.dryRun) {
|
|
24
26
|
const layout = resolveTmpLayoutOrDefaults(root)
|
|
25
27
|
const target = layout.tmpFilePath ?? ownerTmpFilePath(root, layout)
|
|
26
28
|
const exists = fs.existsSync(target)
|
|
27
|
-
|
|
29
|
+
|
|
30
|
+
printCommandHeader({ cliName, command: 'tmp (dry-run)', version })
|
|
31
|
+
console.log(chalk.gray(` root: ${root}`))
|
|
28
32
|
console.log(` ${exists ? 'exists' : 'would create'}: ${target}`)
|
|
29
33
|
console.log('')
|
|
30
34
|
return
|
|
@@ -33,14 +37,19 @@ export function registerTmpCommand(cli, { cliName = 'xcore' } = {}) {
|
|
|
33
37
|
const result = ensureTmpFile(root)
|
|
34
38
|
const rel = relativeFromRoot(root, result.tmpFilePath)
|
|
35
39
|
|
|
36
|
-
|
|
40
|
+
printCommandHeader({ cliName, command: 'tmp', version })
|
|
41
|
+
console.log(chalk.gray(` root: ${root}`))
|
|
37
42
|
console.log(result.created ? chalk.green(` created ${rel}`) : chalk.gray(` ok ${rel}`))
|
|
38
43
|
|
|
39
44
|
try {
|
|
40
45
|
const tmp = yaml.parse(fs.readFileSync(result.tmpFilePath, 'utf8'))
|
|
41
46
|
const summary = summarizeLoaders(resolveObjWithHandlebars(tmp, tmp))
|
|
42
47
|
console.log(chalk.gray(` root: ${result.layout.rootFolderPath} · service: ${summary.service ?? '-'}`))
|
|
48
|
+
if (summary.items?.length) {
|
|
49
|
+
console.log(chalk.gray(` loaders: ${formatLoaderSummary(summary)}`))
|
|
50
|
+
}
|
|
43
51
|
} catch {
|
|
52
|
+
// summary optional
|
|
44
53
|
}
|
|
45
54
|
|
|
46
55
|
console.log('')
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
source/utils/helpers/tmp/tmp-schema.ts
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
// source/utils/constants/index.ts
|
|
2
|
+
import path2 from "node:path";
|
|
3
|
+
|
|
4
|
+
// source/utils/package-root.ts
|
|
5
|
+
import path from "node:path";
|
|
6
|
+
import { fileURLToPath } from "node:url";
|
|
7
|
+
var utilsDir = path.dirname(fileURLToPath(import.meta.url));
|
|
8
|
+
var sourceDir = path.resolve(utilsDir, "..");
|
|
9
|
+
var packageRootDir = path.resolve(utilsDir, "..", "..");
|
|
10
|
+
// source/utils/constants/defaults.json
|
|
11
|
+
var defaults_default = {
|
|
12
|
+
packageName: "@xrystal/core",
|
|
13
|
+
packageRootFolder: "x",
|
|
14
|
+
tmpBaseName: "tmp",
|
|
15
|
+
tmpExtension: ".yml",
|
|
16
|
+
mainSourceFolder: "./source",
|
|
17
|
+
layoutPaths: {
|
|
18
|
+
tests: "tests",
|
|
19
|
+
environments: "environments",
|
|
20
|
+
dist: "dist"
|
|
21
|
+
},
|
|
22
|
+
buildDefaults: {
|
|
23
|
+
tsconfig: "tsconfig.json",
|
|
24
|
+
typecheck: false,
|
|
25
|
+
tscLenient: false,
|
|
26
|
+
declarations: false,
|
|
27
|
+
sourcemap: false,
|
|
28
|
+
minify: false
|
|
29
|
+
},
|
|
30
|
+
tsconfigDefaults: {
|
|
31
|
+
pathAliasKey: "@/*",
|
|
32
|
+
compilerOptions: {
|
|
33
|
+
noEmit: false,
|
|
34
|
+
noEmitOnError: false,
|
|
35
|
+
declaration: true,
|
|
36
|
+
emitDeclarationOnly: false,
|
|
37
|
+
sourceMap: false,
|
|
38
|
+
declarationMap: false,
|
|
39
|
+
strict: true,
|
|
40
|
+
noImplicitAny: true
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
eslintDefaults: {
|
|
44
|
+
restrictedImportDepth: 2
|
|
45
|
+
},
|
|
46
|
+
tmpWatchDefaults: {
|
|
47
|
+
intervalMs: 500,
|
|
48
|
+
minIntervalMs: 100,
|
|
49
|
+
maxIntervalMs: 1e4
|
|
50
|
+
},
|
|
51
|
+
publicFolderName: "public",
|
|
52
|
+
kafkaLogsTopic: "log",
|
|
53
|
+
templateRepoUri: "https://github.com/xdloper/api-gpt-svc"
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
// source/utils/constants/index.ts
|
|
57
|
+
var packageDefaults = Object.freeze({
|
|
58
|
+
...defaults_default,
|
|
59
|
+
layoutPaths: Object.freeze({ ...defaults_default.layoutPaths })
|
|
60
|
+
});
|
|
61
|
+
var tmpFileName = `${packageDefaults.tmpBaseName}${packageDefaults.tmpExtension}`;
|
|
62
|
+
|
|
63
|
+
class Constants {
|
|
64
|
+
static packageName = packageDefaults.packageName;
|
|
65
|
+
static packageRootFolder = packageDefaults.packageRootFolder;
|
|
66
|
+
static tmpBaseName = packageDefaults.tmpBaseName;
|
|
67
|
+
static tmpExtension = packageDefaults.tmpExtension;
|
|
68
|
+
static mainSourceFolder = packageDefaults.mainSourceFolder;
|
|
69
|
+
static layoutPaths = packageDefaults.layoutPaths;
|
|
70
|
+
static publicFolderName = packageDefaults.publicFolderName;
|
|
71
|
+
static kafkaLogsTopic = packageDefaults.kafkaLogsTopic;
|
|
72
|
+
static templateRepoUri = packageDefaults.templateRepoUri;
|
|
73
|
+
static bundledCoreTmpPath = path2.join(packageRootDir, packageDefaults.packageRootFolder, tmpFileName);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// source/utils/helpers/tmp/tmp-schema.ts
|
|
77
|
+
function isRecord(value) {
|
|
78
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
79
|
+
}
|
|
80
|
+
function readWatchIntervalValue(raw) {
|
|
81
|
+
if (typeof raw === "number" || typeof raw === "string")
|
|
82
|
+
return raw;
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
function normalizeRootFolder(value) {
|
|
86
|
+
if (!value?.trim())
|
|
87
|
+
return Constants.packageRootFolder;
|
|
88
|
+
return value.trim().replace(/^\.\/+/, "");
|
|
89
|
+
}
|
|
90
|
+
function normalizeSourceFolder(value) {
|
|
91
|
+
if (!value?.trim())
|
|
92
|
+
return Constants.mainSourceFolder;
|
|
93
|
+
const trimmed = value.trim();
|
|
94
|
+
if (trimmed.startsWith("./") || trimmed.startsWith("../"))
|
|
95
|
+
return trimmed;
|
|
96
|
+
return `./${trimmed}`;
|
|
97
|
+
}
|
|
98
|
+
function readTmpCoreBlock(configs) {
|
|
99
|
+
const core = isRecord(configs?.core) ? configs.core : {};
|
|
100
|
+
const tmp = isRecord(core.tmp) ? core.tmp : {};
|
|
101
|
+
return {
|
|
102
|
+
tmp: {
|
|
103
|
+
fileWatchIntervalMs: readWatchIntervalValue(tmp.fileWatchIntervalMs)
|
|
104
|
+
}
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
function readTmpServiceBlock(configs) {
|
|
108
|
+
const service = isRecord(configs?.service) ? configs.service : {};
|
|
109
|
+
const pathsRaw = isRecord(service.paths) ? service.paths : {};
|
|
110
|
+
const special = isRecord(pathsRaw.special) ? pathsRaw.special : {};
|
|
111
|
+
let loaders = isRecord(service.loaders) ? { ...service.loaders } : undefined;
|
|
112
|
+
let build = isRecord(service.build) ? service.build : undefined;
|
|
113
|
+
if (loaders && isRecord(loaders.build)) {
|
|
114
|
+
const { build: nestedBuild, ...rest } = loaders;
|
|
115
|
+
loaders = rest;
|
|
116
|
+
if (!build && isRecord(nestedBuild)) {
|
|
117
|
+
build = nestedBuild;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return {
|
|
121
|
+
name: typeof service.name === "string" ? service.name : undefined,
|
|
122
|
+
framework: typeof service.framework === "string" ? service.framework : undefined,
|
|
123
|
+
paths: {
|
|
124
|
+
root: typeof pathsRaw.root === "string" ? pathsRaw.root : undefined,
|
|
125
|
+
source: typeof pathsRaw.source === "string" ? pathsRaw.source : undefined,
|
|
126
|
+
special: {
|
|
127
|
+
tests: typeof special.tests === "string" ? special.tests : undefined,
|
|
128
|
+
environments: typeof special.environments === "string" ? special.environments : undefined,
|
|
129
|
+
dist: typeof special.dist === "string" ? special.dist : undefined
|
|
130
|
+
}
|
|
131
|
+
},
|
|
132
|
+
protocols: service.protocols,
|
|
133
|
+
loaders,
|
|
134
|
+
build
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
function resolveServiceLayoutPaths(service) {
|
|
138
|
+
const special = service.paths?.special ?? {};
|
|
139
|
+
return {
|
|
140
|
+
tests: special.tests?.trim() || Constants.layoutPaths.tests,
|
|
141
|
+
environments: special.environments?.trim() || Constants.layoutPaths.environments,
|
|
142
|
+
dist: special.dist?.trim() || Constants.layoutPaths.dist
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
function buildNormalizedService(service) {
|
|
146
|
+
const layoutPaths = resolveServiceLayoutPaths(service);
|
|
147
|
+
return {
|
|
148
|
+
name: service.name,
|
|
149
|
+
framework: service.framework ?? "elysia",
|
|
150
|
+
paths: {
|
|
151
|
+
root: service.paths?.root ?? Constants.packageRootFolder,
|
|
152
|
+
source: service.paths?.source ?? Constants.mainSourceFolder,
|
|
153
|
+
special: layoutPaths
|
|
154
|
+
},
|
|
155
|
+
protocols: service.protocols,
|
|
156
|
+
loaders: service.loaders,
|
|
157
|
+
build: service.build
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
function buildNormalizedCore(core) {
|
|
161
|
+
return {
|
|
162
|
+
tmp: {
|
|
163
|
+
fileWatchIntervalMs: core.tmp?.fileWatchIntervalMs
|
|
164
|
+
}
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
function resolveTmpRuntimeConfigs(tmp) {
|
|
168
|
+
const configs = isRecord(tmp?.configs) ? tmp.configs : {};
|
|
169
|
+
const service = readTmpServiceBlock(configs);
|
|
170
|
+
const core = readTmpCoreBlock(configs);
|
|
171
|
+
const normalizedService = buildNormalizedService(service);
|
|
172
|
+
return {
|
|
173
|
+
service: normalizedService,
|
|
174
|
+
core: buildNormalizedCore(core),
|
|
175
|
+
rootFolderPath: normalizeRootFolder(normalizedService.paths.root)
|
|
176
|
+
};
|
|
177
|
+
}
|
|
178
|
+
function normalizeTmpDocument(tmp) {
|
|
179
|
+
return {
|
|
180
|
+
...tmp,
|
|
181
|
+
configs: resolveTmpRuntimeConfigs(tmp)
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
export {
|
|
185
|
+
resolveTmpRuntimeConfigs,
|
|
186
|
+
resolveServiceLayoutPaths,
|
|
187
|
+
readTmpServiceBlock,
|
|
188
|
+
readTmpCoreBlock,
|
|
189
|
+
normalizeTmpDocument,
|
|
190
|
+
normalizeSourceFolder,
|
|
191
|
+
normalizeRootFolder
|
|
192
|
+
};
|
package/x/bin/helpers/banner.mjs
CHANGED
|
@@ -1,26 +1,80 @@
|
|
|
1
1
|
import chalk from 'chalk'
|
|
2
|
-
import { CLI_PRIMARY_NAME } from './cli-identity.mjs'
|
|
3
2
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
3
|
+
import { CLI_BIN_NAMES, CLI_PRIMARY_NAME } from './cli-identity.mjs'
|
|
4
|
+
|
|
5
|
+
/** figlet standard — lowercase wordmark, split for two-tone print */
|
|
6
|
+
const XRYSTAL_LINES = [
|
|
7
|
+
' _ _ ',
|
|
8
|
+
' __ ___ __ _ _ ___| |_ __ _| |',
|
|
9
|
+
" \\ \\/ / '__| | | / __| __/ _` | |",
|
|
10
|
+
' > <| | | |_| \\__ \\ || (_| | |',
|
|
11
|
+
' /_/\\_\\_| \\__, |___/\\__\\__,_|_|',
|
|
12
|
+
' |___/ ',
|
|
13
|
+
]
|
|
14
|
+
|
|
15
|
+
const CORE_LINES = [
|
|
16
|
+
'',
|
|
17
|
+
' ___ ___ _ __ ___ ',
|
|
18
|
+
" / __/ _ \\| '__/ _ \\",
|
|
19
|
+
' | (_| (_) | | | __/',
|
|
20
|
+
' \\___\\___/|_| \\___/',
|
|
21
|
+
'',
|
|
8
22
|
]
|
|
9
23
|
|
|
10
|
-
const
|
|
24
|
+
const WORDMARK_WIDTH = Math.max(...XRYSTAL_LINES.map((line) => line.length))
|
|
25
|
+
const BIN_ALIASES_LABEL = CLI_BIN_NAMES.join(' · ')
|
|
26
|
+
export function printWordmark() {
|
|
27
|
+
const rows = Math.max(XRYSTAL_LINES.length, CORE_LINES.length)
|
|
28
|
+
for (let i = 0; i < rows; i += 1) {
|
|
29
|
+
const left = (XRYSTAL_LINES[i] ?? '').padEnd(WORDMARK_WIDTH)
|
|
30
|
+
const right = CORE_LINES[i] ?? ''
|
|
31
|
+
console.log(` ${chalk.bold.white(left)}${chalk.bold.magenta(right)}`)
|
|
32
|
+
}
|
|
33
|
+
}
|
|
11
34
|
|
|
35
|
+
export function brandTitle() {
|
|
36
|
+
return `${chalk.bold.white('xrystal ')}${chalk.bold.magenta('core')}`
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Full banner — bare `xcore` / `xcore -h` (root help). */
|
|
12
40
|
export function printBanner({ version, runtimeName, invokedAs } = {}) {
|
|
41
|
+
const bin = invokedAs && invokedAs !== 'main-cli.js' ? invokedAs : CLI_PRIMARY_NAME
|
|
42
|
+
const versionLabel = version ? chalk.bold.green(`v${version}`) : chalk.gray('v?')
|
|
43
|
+
const runtimeLabel = runtimeName ? chalk.bold.white(runtimeName) : ''
|
|
44
|
+
|
|
13
45
|
console.log('')
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
console.log(
|
|
17
|
-
console.log(chalk.
|
|
46
|
+
|
|
47
|
+
printWordmark()
|
|
48
|
+
console.log('')
|
|
49
|
+
console.log(chalk.bold.gray(' microservice runtime library'))
|
|
50
|
+
|
|
51
|
+
console.log('')
|
|
52
|
+
console.log(
|
|
53
|
+
` ${chalk.bold.cyan(bin)} ${chalk.gray('·')} ${chalk.bold('@xrystal/core')} ${versionLabel}${runtimeLabel ? ` ${chalk.gray('·')} ${runtimeLabel}` : ''}`,
|
|
54
|
+
)
|
|
55
|
+
console.log(chalk.bold.gray(' loaders · tmp.yml · dto · i18n · multi-protocol · scaffold'))
|
|
56
|
+
console.log(chalk.dim(` bin aliases: ${BIN_ALIASES_LABEL}`))
|
|
57
|
+
console.log('')
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** One-line header for subcommands (build, dev, doctor, …). */
|
|
61
|
+
export function printCommandHeader({ cliName, command, version } = {}) {
|
|
62
|
+
const label = cliName || CLI_PRIMARY_NAME
|
|
63
|
+
const versionLabel = version ? chalk.green(`v${version}`) : ''
|
|
18
64
|
console.log('')
|
|
65
|
+
console.log(
|
|
66
|
+
`${chalk.bold.cyan(`${label} ${command}`)} ${chalk.gray('·')} ${brandTitle()} ${versionLabel}`.trim(),
|
|
67
|
+
)
|
|
19
68
|
}
|
|
20
69
|
|
|
70
|
+
/**
|
|
71
|
+
* Root banner: bare CLI, or root-level -h / --help / help.
|
|
72
|
+
* Subcommands keep compact headers only.
|
|
73
|
+
*/
|
|
21
74
|
export function shouldShowBanner(argv = process.argv) {
|
|
22
75
|
const args = argv.slice(2)
|
|
23
76
|
if (!args.length) return true
|
|
24
|
-
if (args.
|
|
25
|
-
return
|
|
77
|
+
if (args.length === 1 && ['-h', '--help', 'help'].includes(args[0])) return true
|
|
78
|
+
if (args.some((a) => ['-V', '--version'].includes(a))) return false
|
|
79
|
+
return false
|
|
26
80
|
}
|