@xrystal/core 3.44.0 → 3.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,20 +3,19 @@
3
3
  > **EN** — Microservice runtime: Express or Elysia HTTP, DI loaders, live `tmp.yml`, standardized API responses.
4
4
  > **TR** — Microservice runtime: Express veya Elysia HTTP, DI loader'lar, canlı `tmp.yml`, standart API cevapları.
5
5
 
6
- **CLI:** `xry` · **Version:** `3.44.0` · [npm](https://www.npmjs.com/package/@xrystal/core)
6
+ **CLI:** `xry` · **Version:** `3.45.0` · [npm](https://www.npmjs.com/package/@xrystal/core)
7
7
 
8
8
  ---
9
9
 
10
- ## What's new in 3.44.0 / 3.44.0'da ne değişti
10
+ ## What's new in 3.45.0 / 3.45.0'da ne değişti
11
11
 
12
12
  | Change / Değişiklik | EN | TR |
13
13
  |---------------------|----|----|
14
- | **Layout auto-sync** | Path changes in `tmp.yml` → tsconfig heals live (and on any `xry` entry) | Klasör/path değişince tsconfig otomatik |
15
- | **`xry sync`** | Force / dry-run / CI — not a daily ritual | Elle force; günlük zorunluluk değil |
16
- | **CLI banner** | Leads with `@xrystal/core` (bin still `xry`) | Banner paket adıyla açılır |
17
- | **Runtime coverage** | bun + node runners / bundler `auto` tested | Her iki runtime doğrulandı |
14
+ | **CLI identity** | Commander / help / logs lead with `@xrystal/core` | Kimlik = paket adı |
15
+ | **No brand hardcodes** | Errors use `packageName`; invoke bin stays `xry` | Hardcode temizliği |
16
+ | **Publish helpers** | Source/dist paths from defaults + tmp seed | Publish path SSOT |
18
17
 
19
- Carried from **3.43.0:** `configs.global.runtime` (`bun`\|`node`), `configs.global.vars`, `build.bundler` (`auto`\|`bun`\|`tsc`\|`esbuild`).
18
+ Carried from **3.44.0:** layout auto-sync, banner package name, bun/node runtime coverage.
20
19
 
21
20
  ```bash
22
21
  npx xry sync # force-apply tmp.yml → tsconfig (usually auto)
@@ -81,7 +80,7 @@ npx xry doctor # EN: optional health check · TR: isteğe bağlı sağlı
81
80
  ```json
82
81
  {
83
82
  "dependencies": {
84
- "@xrystal/core": "^3.44.0",
83
+ "@xrystal/core": "^3.45.0",
85
84
  "elysia": "^1.4.19"
86
85
  },
87
86
  "scripts": {
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "author": "Yusuf Yasir KAYGUSUZ",
3
3
  "name": "@xrystal/core",
4
- "version": "3.44.0",
5
- "description": "Project core for xrystal",
4
+ "version": "3.45.0",
5
+ "description": "microservice runtime library",
6
6
  "publishConfig": {
7
7
  "access": "public",
8
8
  "registry": "https://registry.npmjs.org/"
@@ -41,7 +41,7 @@ function resolveTestTarget(root) {
41
41
  export function registerProjectCommands(cli, { cliName = CLI_PRIMARY_NAME } = {}) {
42
42
  cli
43
43
  .command('dev')
44
- .description('Watch source/index.ts with dev env files')
44
+ .description('Watch TypeScript entry with dev env files')
45
45
  .action(() => {
46
46
  const root = getProjectRoot()
47
47
  const { layout, runtime } = readTmpBuildContext(root)
@@ -1,7 +1,7 @@
1
1
  import chalk from 'chalk'
2
2
  import { readCliPackageJson, readProjectPackageJson, getProjectRoot } from '../helpers/project-root.mjs'
3
3
  import { compareSemver, getVersionState, resolveVersionBaseline, runTagRelease } from '../scripts/version-check.mjs'
4
- import { CLI_PRIMARY_NAME } from '../helpers/cli-identity.mjs'
4
+ import { CLI_PRIMARY_NAME, PACKAGE_NAME } from '../helpers/cli-identity.mjs'
5
5
  import { packageDefaults } from '../helpers/package-defaults.mjs'
6
6
 
7
7
  export function registerTagCommand(cli, { cliName = CLI_PRIMARY_NAME } = {}) {
@@ -40,7 +40,7 @@ export function registerVersionCommand(cli, { cliName = CLI_PRIMARY_NAME } = {})
40
40
  const projectPkg = readProjectPackageJson(root)
41
41
  const state = getVersionState('HEAD', root)
42
42
 
43
- console.log(chalk.cyan(`\n${cliName} version\n`))
43
+ console.log(chalk.cyan(`\n${PACKAGE_NAME} version\n`))
44
44
  console.log(chalk.gray(' CLI (tool)'))
45
45
  console.log(` ${packageDefaults.packageName}: ${chalk.bold(`${cliPkg.name}@${cliPkg.version}`)}`)
46
46
  console.log('')
@@ -11,6 +11,7 @@ var defaults_default = {
11
11
  cliBinNames: [
12
12
  "xry"
13
13
  ],
14
+ cliBinFile: "main-cli.js",
14
15
  tmpBaseName: "tmp",
15
16
  tmpExtension: ".yml",
16
17
  templateRepoUri: "https://github.com/xdloper/api-gpt-svc",
@@ -6,6 +6,7 @@ var defaults_default = {
6
6
  cliBinNames: [
7
7
  "xry"
8
8
  ],
9
+ cliBinFile: "main-cli.js",
9
10
  tmpBaseName: "tmp",
10
11
  tmpExtension: ".yml",
11
12
  templateRepoUri: "https://github.com/xdloper/api-gpt-svc",
@@ -1,6 +1,6 @@
1
1
  import chalk from 'chalk'
2
2
 
3
- import { CLI_BIN_NAMES, CLI_PRIMARY_NAME } from './cli-identity.mjs'
3
+ import { CLI_BIN_NAMES, CLI_PRIMARY_NAME, PACKAGE_NAME } from './cli-identity.mjs'
4
4
 
5
5
  export const LIST_BULLET = chalk.cyan('◆')
6
6
  import { brandTitle } from './banner.mjs'
@@ -8,7 +8,7 @@ import { packageDefaults } from './package-defaults.mjs'
8
8
 
9
9
  const QUICK_COMMANDS = [
10
10
  { cmd: 'create', hint: '<name> [path]', desc: 'Scaffold service · path defaults to cwd' },
11
- { cmd: 'dev', desc: 'Watch source/index.ts + dev env' },
11
+ { cmd: 'dev', desc: 'Watch TypeScript entry + dev env' },
12
12
  { cmd: 'build', desc: 'Bundle to dist/ (tmp.yml layout)' },
13
13
  { cmd: 'start', desc: 'Run production dist/index.js' },
14
14
  { cmd: 'test', desc: 'Run tests folder from tmp.yml' },
@@ -31,7 +31,7 @@ const COMMAND_GROUPS = [
31
31
  { cmd: 'tmp', desc: 'Ensure tmp.yml exists (runtime config seed)' },
32
32
  { cmd: 'hooks install', desc: 'Install .git/hooks pre-commit version check' },
33
33
  { cmd: 'hooks status', desc: 'Show whether pre-commit hook is installed' },
34
- { cmd: 'sync', desc: 'Sync tsconfig include/outDir/@/* from tmp.yml' },
34
+ { cmd: 'sync', desc: 'Force-sync tsconfig from tmp.yml (auto-heals otherwise)' },
35
35
  ],
36
36
  },
37
37
  {
@@ -112,7 +112,8 @@ export function formatRootHelp({ cliName = CLI_PRIMARY_NAME } = {}) {
112
112
 
113
113
  return [
114
114
  chalk.bold.white(`\n Usage`),
115
- chalk.gray(` ${cliName} [options] [command]`),
115
+ chalk.gray(` ${PACKAGE_NAME} [options] [command]`),
116
+ chalk.dim(` invoke: ${cliName}`),
116
117
  ...sections,
117
118
  formatOptionsSection(cliName),
118
119
  ].join('\n')
@@ -1,6 +1,12 @@
1
1
  export {
2
+ PACKAGE_NAME,
2
3
  CLI_PRIMARY_NAME,
3
4
  CLI_BIN_NAMES,
5
+ CLI_BIN_FILE,
6
+ packageCliDescription,
7
+ packageLogTag,
8
+ resolveCliBinEntry,
9
+ resolveMainSourceRel,
4
10
  resolveInvokedAs,
5
11
  isKnownCliBin,
6
12
  packageDefaults,
@@ -43,12 +43,38 @@ export const packageDefaults = Object.freeze({
43
43
  export const coreVersionPattern = /^\d{2}\.\d{2}\.\d{2}-v\d+$/
44
44
  export const semverVersionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/
45
45
 
46
+ export const PACKAGE_NAME = packageDefaults.packageName
46
47
  export const CLI_PRIMARY_NAME = packageDefaults.cliName
47
48
  export const CLI_BIN_NAMES = packageDefaults.cliBinNames
49
+ export const CLI_BIN_FILE = packageDefaults.cliBinFile ?? 'main-cli.js'
50
+
51
+ /** Commander / banner description from brand SSOT. */
52
+ export function packageCliDescription() {
53
+ const brand = packageDefaults.brand ?? {}
54
+ const title = [brand.primary, brand.secondary].filter(Boolean).join(' ')
55
+ const tagline = brand.tagline ? String(brand.tagline) : ''
56
+ if (title && tagline) return `${title} — ${tagline}`
57
+ return tagline || PACKAGE_NAME
58
+ }
59
+
60
+ /** Log / error prefix: always the npm package name. */
61
+ export function packageLogTag() {
62
+ return PACKAGE_NAME
63
+ }
64
+
65
+ /** Relative bin entry for package.json / manifests. */
66
+ export function resolveCliBinEntry() {
67
+ return `./${packageDefaults.packageRootFolder}/bin/${CLI_BIN_FILE}`
68
+ }
69
+
70
+ /** Authored main source folder segment without ./ */
71
+ export function resolveMainSourceRel() {
72
+ return String(packageDefaults.mainSourceFolder ?? 'source').replace(/^\.\//, '')
73
+ }
48
74
 
49
75
  export function resolveInvokedAs(argv = process.argv) {
50
76
  const base = path.basename(argv[1] || CLI_PRIMARY_NAME)
51
- if (base === 'main-cli.js') return CLI_PRIMARY_NAME
77
+ if (base === CLI_BIN_FILE) return CLI_PRIMARY_NAME
52
78
  if (CLI_BIN_NAMES.includes(base)) return base
53
79
  return CLI_PRIMARY_NAME
54
80
  }
@@ -6,7 +6,7 @@ import { fileURLToPath } from 'node:url'
6
6
  import { isCorePackageName } from './build-config.mjs'
7
7
  import { auditTsconfigAlignment, syncProjectToolchain } from './toolchain-config.mjs'
8
8
  import { ensureTmpFile, relativeFromRoot } from './tmp-layout.mjs'
9
- import { packageDefaults } from './package-defaults.mjs'
9
+ import { packageDefaults, resolveCliBinEntry } from './package-defaults.mjs'
10
10
 
11
11
  const CLI_BIN_DIR = path.dirname(fileURLToPath(import.meta.url))
12
12
  const CLI_GENERATED_DIR = path.join(CLI_BIN_DIR, '.generated')
@@ -175,7 +175,7 @@ export function syncPackageManifest(root = process.cwd(), { write = true } = {})
175
175
  }
176
176
 
177
177
  const { distPrefix, distRel } = resolveDistLayout(root)
178
- const binEntry = `./${packageDefaults.packageRootFolder}/bin/main-cli.js`
178
+ const binEntry = resolveCliBinEntry()
179
179
  const bin = Object.fromEntries(packageDefaults.cliBinNames.map((name) => [name, binEntry]))
180
180
 
181
181
  const next = {
package/x/bin/main-cli.js CHANGED
@@ -12,7 +12,11 @@ import { registerTagCommand, registerVersionCommand } from './commands/release.m
12
12
  import { registerHooksCommand } from './commands/hooks.mjs'
13
13
  import { printBanner, shouldShowBanner } from './helpers/banner.mjs'
14
14
  import { formatRootHelp, formatCreateCommandHelp, isCreateHelpRequest, isRootHelpRequest, printQuickStartGuide } from './helpers/cli-help.mjs'
15
- import { resolveInvokedAs } from './helpers/cli-identity.mjs'
15
+ import {
16
+ PACKAGE_NAME,
17
+ packageCliDescription,
18
+ resolveInvokedAs,
19
+ } from './helpers/cli-identity.mjs'
16
20
  import { readCliPackageJson, getProjectRoot } from './helpers/project-root.mjs'
17
21
  import { ensureProjectArtifacts } from './helpers/project-artifacts.mjs'
18
22
 
@@ -49,9 +53,9 @@ if (isCreateHelpRequest()) {
49
53
  const cli = new Command()
50
54
 
51
55
  cli
52
- .name(cliName)
53
- .description('xrystal core — microservice runtime library')
54
- .version(pkg.version, '-V, --version', `Show ${pkg.name} CLI version`)
56
+ .name(PACKAGE_NAME)
57
+ .description(packageCliDescription())
58
+ .version(pkg.version, '-V, --version', `Show ${PACKAGE_NAME} version`)
55
59
  .configureHelp({
56
60
  helpWidth: () => Math.min(100, Math.max(56, process.stdout.columns || 80)),
57
61
  sortSubcommands: true,
@@ -1,9 +1,12 @@
1
1
  import fs from 'node:fs'
2
2
  import path from 'node:path'
3
3
 
4
+ import { resolveMainSourceRel } from '../helpers/package-defaults.mjs'
5
+
4
6
  const root = process.cwd()
5
- const sourceRoot = path.join(root, 'source')
6
- const keepRel = path.join('source', 'utils', 'models', 'types', 'shims.d.ts')
7
+ const sourceRel = resolveMainSourceRel()
8
+ const sourceRoot = path.join(root, sourceRel)
9
+ const keepRel = path.join(sourceRel, 'utils', 'models', 'types', 'shims.d.ts')
7
10
 
8
11
  function walk(dir) {
9
12
  for (const name of fs.readdirSync(dir)) {
@@ -1,17 +1,18 @@
1
1
  #!/usr/bin/env node
2
2
  import fs from 'node:fs'
3
3
  import path from 'node:path'
4
+ import { packageDefaults, resolveMainSourceRel } from '../helpers/package-defaults.mjs'
4
5
  import { PublishGuardError, runPublishGuards } from './publish-guard.mjs'
5
6
 
6
7
  const root = process.cwd()
7
8
 
8
9
  const pathsToRemove = [
9
- 'source',
10
- 'x/tests',
10
+ resolveMainSourceRel(),
11
+ `${packageDefaults.packageRootFolder}/tests`,
11
12
  '.github',
12
13
  '.vscode',
13
- 'x/logs',
14
- 'x/docker',
14
+ `${packageDefaults.packageRootFolder}/logs`,
15
+ `${packageDefaults.packageRootFolder}/docker`,
15
16
  'tsconfig.json',
16
17
  'eslint.config.js',
17
18
  '.gitignore',
@@ -25,14 +26,15 @@ for (const rel of pathsToRemove) {
25
26
  console.log(`prepare-npm-publish: removed ${rel}`)
26
27
  }
27
28
 
28
- if (!fs.existsSync(path.join(root, 'x', 'dist'))) {
29
- console.error('prepare-npm-publish: x/dist missing — run build first')
29
+ const distRel = path.join(packageDefaults.packageRootFolder, packageDefaults.layoutPaths.dist)
30
+ if (!fs.existsSync(path.join(root, distRel))) {
31
+ console.error(`prepare-npm-publish: ${distRel} missing — run build first`)
30
32
  process.exit(1)
31
33
  }
32
34
 
33
35
  try {
34
36
  const { jsCount } = runPublishGuards(root, { strictDisk: true })
35
- console.log(`prepare-npm-publish: ready (${jsCount} .js in x/dist, verified)`)
37
+ console.log(`prepare-npm-publish: ready (${jsCount} .js in ${distRel}, verified)`)
36
38
  } catch (error) {
37
39
  console.error(`prepare-npm-publish: ✗ ${error instanceof PublishGuardError ? error.message : error.message}`)
38
40
  process.exit(1)
@@ -2,7 +2,7 @@ import { execSync } from 'node:child_process'
2
2
  import fs from 'node:fs'
3
3
  import path from 'node:path'
4
4
 
5
- import { packageDefaults } from '../helpers/package-defaults.mjs'
5
+ import { packageDefaults, resolveMainSourceRel } from '../helpers/package-defaults.mjs'
6
6
 
7
7
  export class PublishGuardError extends Error {
8
8
  constructor(message) {
@@ -34,10 +34,11 @@ export function assertFilesListNoSource(pkg) {
34
34
  const files = Array.isArray(pkg.files) ? pkg.files : []
35
35
  const bad = files.filter((entry) => {
36
36
  const normalized = String(entry).replace(/^\.\//, '').replace(/\\/g, '/')
37
- return normalized === 'source' || normalized.startsWith('source/')
37
+ const sourceRel = resolveMainSourceRel()
38
+ return normalized === sourceRel || normalized.startsWith(`${sourceRel}/`)
38
39
  })
39
40
  if (bad.length > 0) {
40
- throw new PublishGuardError(`package.json files must not include source/ (found: ${bad.join(', ')})`)
41
+ throw new PublishGuardError(`package.json files must not include ${resolveMainSourceRel()}/ (found: ${bad.join(', ')})`)
41
42
  }
42
43
  }
43
44
 
@@ -65,8 +66,9 @@ export function assertMainExportsPointToDist(pkg) {
65
66
  }
66
67
 
67
68
  export function assertSourceAbsentOnDisk(root = process.cwd()) {
68
- if (fs.existsSync(path.join(root, 'source'))) {
69
- throw new PublishGuardError('source/ must not exist on disk at publish time')
69
+ const sourceRel = resolveMainSourceRel()
70
+ if (fs.existsSync(path.join(root, sourceRel))) {
71
+ throw new PublishGuardError(`${sourceRel}/ must not exist on disk at publish time`)
70
72
  }
71
73
  }
72
74
 
@@ -1 +1 @@
1
- import y from"qs";import C from"../../loader/logger";import S from"../../loader/system";import{bindLoaderTmpSync as T,getClientIp as E,getConfiguredProtocols as D,isRealtimeProtocol as h,LoggerLayerEnum as O,parseResponseMessage as j,ProtocolEnum as g,x as q,controllerContextStorage,getControllerCtx,runControllerStore as P,adapterBagFromRequest as B,isFetchRequest as I,toHandler as M,toRealtimeHandler as H,resolveCtrOptions as A}from"../../utils";export{controllerContextStorage,getControllerCtx};export const runController=P;function x(t){return t instanceof Response||t instanceof Blob||t instanceof Uint8Array||t instanceof ArrayBuffer}function l(t){if(!t||typeof t!=="object")return null;return t}function b(t,e){const r=l(e);if(!r)return;if(r.statusCode!==void 0)return void t.httpStatus(Number(r.statusCode));if(r.code!==void 0){const a=Number(r.code);if(a>=100)t.httpStatus(a);else t.code(a)}}function w(t){const e=l(t);if(!e)return{data:void 0,extraData:void 0,message:void 0};const r=l(e.payload);if(r)return{data:r.data!==void 0?r.data:r,extraData:r.extraData,message:e.message};if(e.data!==void 0||e.extraData!==void 0)return{data:e.data,extraData:e.extraData,message:e.message};if(!(e.status!==void 0||e.message!==void 0||e.code!==void 0||e.statusCode!==void 0)&&Object.keys(e).length>0)return{data:e,extraData:void 0,message:e.message};return{data:void 0,extraData:void 0,message:e.message}}function F(t){return t instanceof ReadableStream||typeof t==="object"&&t!==null&&typeof t.getReader==="function"}function R(t){if(Array.isArray(t))return t[0]??"";return t??""}export function resolveBuilder(t){const e=t.ctx?.builder??t.res?.builder??t.socket?.builder;if(e)return e;throw Error("[xrystal] use dtoMiddleware() — builder attaches at request start via @xrystal/dto adapter")}export class BaseController{system=q.get(S);logger=q.get(C);supportedProtocols=[g.HTTP,g.WEBSOCKET];get store(){return getControllerCtx()}get protocol(){return this.store?.protocol||g.HTTP}get req(){const t=this.store,e=t?.ctx||{},r=t?.req||{},a=I(e.request)?e.request:void 0,o=B(e.request),n=e.headers??r.headers??a?.headers??o?.headers,s=n instanceof Headers?Object.fromEntries(n.entries()):n??{},i=a?.url??o?.url??r.url??e.url??"";let c=t?.metadata?.parsedQuery||e.query||r.query||o?.query||{};if(!Object.keys(c).length&&i.includes("?"))c=y.parse(i.split("?")[1]);let u=e.cookies||r.cookies||o?.cookies||{};const d=s.cookie;if(!Object.keys(u).length&&typeof d==="string")u=Object.fromEntries(d.split(";").map((f)=>{const[m,p]=f.trim().split("=");return[decodeURIComponent(m),decodeURIComponent(p||"")]}));return{url:i,method:(e.method||r.method||a?.method||o?.method||"").toUpperCase(),headers:s,body:t?.metadata?.parsedBody||e.body||r.body||o?.body||{},query:c,params:{...r.params,...e.params,...o?.params,...o?.routeParams},cookies:u,ip:E(r,e),lang:e.lang||r.lang||"en",requestId:t?.requestId??e.requestId??r.ctx?.requestId??String(s["x-request-id"]??s["x-correlation-id"]??""),startTime:e.startTime??r.ctx?.startTime??Date.now(),t:e.t||r.t||((f)=>f),accounts:e.accounts||r.accounts||e.user}}get res(){const t=this.store;if(!t)throw Error("[xrystal] controller context missing");const e=t.metadata?.locals??{};return{builder:resolveBuilder(t),locals:e}}async parseRequestBody(){const t=this.store;if(!t)return;const e=t.ctx?.request,r=t.req||e||t.ctx?.req,a=this.req,o=R(a.headers["content-type"]).toLowerCase(),n=parseInt(R(a.headers["content-length"])||"-1",10);let s=a.body;const i=(d)=>{if(!d)return{};if(o.includes("application/json"))try{return JSON.parse(d)}catch{return d}if(o.includes("application/x-www-form-urlencoded"))return y.parse(d);try{return JSON.parse(d)}catch{try{return y.parse(d)}catch{return d}}},c=F,u=s&&typeof s==="object"&&!c(s)&&Object.keys(s).length>0;if(!h(this.protocol)&&!["GET","HEAD","OPTIONS"].includes(a.method)&&!u){if(r instanceof Request&&(c(s)||n>0))try{s=i(await r.clone().text())}catch{if(typeof s==="string")s=i(s)}else if(r&&typeof r==="object"&&"on"in r&&typeof r.on==="function"&&n!==0){const d=r;s=await new Promise((f)=>{let m="";const p=setTimeout(()=>f({}),200);d.on("data",(k)=>{m+=String(k)});d.on("end",()=>{clearTimeout(p);f(i(m))});d.on("error",()=>{clearTimeout(p);f({})})})}else if(typeof s==="string"&&s.length)s=i(s)}if(typeof FormData<"u"&&s instanceof FormData)s=Object.fromEntries(s.entries());if(!t.metadata)t.metadata={locals:{}};t.metadata.parsedBody=s||{};t.metadata.parsedQuery=a.query}}export default class Controller extends BaseController{async onInit(){await this.syncFromTmp();T(this)}syncFromTmp=()=>{this.supportedProtocols=D()};parseMessage(t,e,r=!1){return j(t,e,r)}args(t){const e=this.req,r=this.store.metadata?.locals??{};return{req:e,res:{builder:t,locals:r},builder:t,body:e.body,query:e.query,queries:e.query,params:e.params,cookies:e.cookies,locals:r,t:e.t}}fail(t,e,r){b(t,e);const{data:a,extraData:o}=w(e),n=l(e),s=this.parseMessage(n?.message??e,r,!0),i=a!==void 0||o!==void 0?{data:a,extraData:o}:void 0;return(a!==void 0?t.as.fail(a,s,i):t.as.fail(s,i)).build()}ok(t,e,r,a){let o="success_process",n=e!==void 0?e:r;if(typeof e==="string"){o=e;n=r}const{data:s,extraData:i,message:c}=w(n);if(typeof c==="string")o=c;b(t,n);return t.as.ok(s,this.parseMessage(o,a,!1),i!==void 0?{extraData:i}:void 0).build()}async schema({checks:t,logic:e,response:r}){const a=resolveBuilder(this.store);try{await this.parseRequestBody();const n=this.args(a);if(t){const u=await t(n);if(u!==!0)return this.fail(a,u,n.req.t)}let s=e?await e(n):{};const i=l(s);if(i&&typeof i.response==="function")s=await i.response();if(x(s))return s;if(i?.status===!1)return this.fail(a,s,n.req.t);const c=r?await r({...n,logicResult:s}):s;if(x(c))return c;return this.ok(a,c,s,n.req.t)}catch(o){const n=o instanceof Error?o.message:String(o);this.logger?.log(O.ERROR,`Controller Error: ${n}`);return a.as.internalServerError(this.parseMessage(n,this.req.t,!0)).build()}}ctr(t,e){const{framework:r,protocol:a}=A(e),o=()=>this.schema(t);if(h(a))return H(o,a);return M(o,r)}}
1
+ import{Constants as h}from"../../utils/constants";import g from"qs";import S from"../../loader/logger";import T from"../../loader/system";import{bindLoaderTmpSync as E,getClientIp as D,getConfiguredProtocols as O,isRealtimeProtocol as q,LoggerLayerEnum as j,parseResponseMessage as P,ProtocolEnum as y,x,controllerContextStorage,getControllerCtx,runControllerStore as B,adapterBagFromRequest as I,isFetchRequest as M,toHandler as H,toRealtimeHandler as N,resolveCtrOptions as A}from"../../utils";export{controllerContextStorage,getControllerCtx};export const runController=B;function b(t){return t instanceof Response||t instanceof Blob||t instanceof Uint8Array||t instanceof ArrayBuffer}function l(t){if(!t||typeof t!=="object")return null;return t}function w(t,e){const r=l(e);if(!r)return;if(r.statusCode!==void 0)return void t.httpStatus(Number(r.statusCode));if(r.code!==void 0){const a=Number(r.code);if(a>=100)t.httpStatus(a);else t.code(a)}}function R(t){const e=l(t);if(!e)return{data:void 0,extraData:void 0,message:void 0};const r=l(e.payload);if(r)return{data:r.data!==void 0?r.data:r,extraData:r.extraData,message:e.message};if(e.data!==void 0||e.extraData!==void 0)return{data:e.data,extraData:e.extraData,message:e.message};if(!(e.status!==void 0||e.message!==void 0||e.code!==void 0||e.statusCode!==void 0)&&Object.keys(e).length>0)return{data:e,extraData:void 0,message:e.message};return{data:void 0,extraData:void 0,message:e.message}}function F(t){return t instanceof ReadableStream||typeof t==="object"&&t!==null&&typeof t.getReader==="function"}function k(t){if(Array.isArray(t))return t[0]??"";return t??""}export function resolveBuilder(t){const e=t.ctx?.builder??t.res?.builder??t.socket?.builder;if(e)return e;throw Error(`[${h.packageName}] use dtoMiddleware() — builder attaches at request start via @xrystal/dto adapter`)}export class BaseController{system=x.get(T);logger=x.get(S);supportedProtocols=[y.HTTP,y.WEBSOCKET];get store(){return getControllerCtx()}get protocol(){return this.store?.protocol||y.HTTP}get req(){const t=this.store,e=t?.ctx||{},r=t?.req||{},a=M(e.request)?e.request:void 0,o=I(e.request),n=e.headers??r.headers??a?.headers??o?.headers,s=n instanceof Headers?Object.fromEntries(n.entries()):n??{},i=a?.url??o?.url??r.url??e.url??"";let c=t?.metadata?.parsedQuery||e.query||r.query||o?.query||{};if(!Object.keys(c).length&&i.includes("?"))c=g.parse(i.split("?")[1]);let u=e.cookies||r.cookies||o?.cookies||{};const d=s.cookie;if(!Object.keys(u).length&&typeof d==="string")u=Object.fromEntries(d.split(";").map((f)=>{const[m,p]=f.trim().split("=");return[decodeURIComponent(m),decodeURIComponent(p||"")]}));return{url:i,method:(e.method||r.method||a?.method||o?.method||"").toUpperCase(),headers:s,body:t?.metadata?.parsedBody||e.body||r.body||o?.body||{},query:c,params:{...r.params,...e.params,...o?.params,...o?.routeParams},cookies:u,ip:D(r,e),lang:e.lang||r.lang||"en",requestId:t?.requestId??e.requestId??r.ctx?.requestId??String(s["x-request-id"]??s["x-correlation-id"]??""),startTime:e.startTime??r.ctx?.startTime??Date.now(),t:e.t||r.t||((f)=>f),accounts:e.accounts||r.accounts||e.user}}get res(){const t=this.store;if(!t)throw Error(`[${h.packageName}] controller context missing`);const e=t.metadata?.locals??{};return{builder:resolveBuilder(t),locals:e}}async parseRequestBody(){const t=this.store;if(!t)return;const e=t.ctx?.request,r=t.req||e||t.ctx?.req,a=this.req,o=k(a.headers["content-type"]).toLowerCase(),n=parseInt(k(a.headers["content-length"])||"-1",10);let s=a.body;const i=(d)=>{if(!d)return{};if(o.includes("application/json"))try{return JSON.parse(d)}catch{return d}if(o.includes("application/x-www-form-urlencoded"))return g.parse(d);try{return JSON.parse(d)}catch{try{return g.parse(d)}catch{return d}}},c=F,u=s&&typeof s==="object"&&!c(s)&&Object.keys(s).length>0;if(!q(this.protocol)&&!["GET","HEAD","OPTIONS"].includes(a.method)&&!u){if(r instanceof Request&&(c(s)||n>0))try{s=i(await r.clone().text())}catch{if(typeof s==="string")s=i(s)}else if(r&&typeof r==="object"&&"on"in r&&typeof r.on==="function"&&n!==0){const d=r;s=await new Promise((f)=>{let m="";const p=setTimeout(()=>f({}),200);d.on("data",(C)=>{m+=String(C)});d.on("end",()=>{clearTimeout(p);f(i(m))});d.on("error",()=>{clearTimeout(p);f({})})})}else if(typeof s==="string"&&s.length)s=i(s)}if(typeof FormData<"u"&&s instanceof FormData)s=Object.fromEntries(s.entries());if(!t.metadata)t.metadata={locals:{}};t.metadata.parsedBody=s||{};t.metadata.parsedQuery=a.query}}export default class Controller extends BaseController{async onInit(){await this.syncFromTmp();E(this)}syncFromTmp=()=>{this.supportedProtocols=O()};parseMessage(t,e,r=!1){return P(t,e,r)}args(t){const e=this.req,r=this.store.metadata?.locals??{};return{req:e,res:{builder:t,locals:r},builder:t,body:e.body,query:e.query,queries:e.query,params:e.params,cookies:e.cookies,locals:r,t:e.t}}fail(t,e,r){w(t,e);const{data:a,extraData:o}=R(e),n=l(e),s=this.parseMessage(n?.message??e,r,!0),i=a!==void 0||o!==void 0?{data:a,extraData:o}:void 0;return(a!==void 0?t.as.fail(a,s,i):t.as.fail(s,i)).build()}ok(t,e,r,a){let o="success_process",n=e!==void 0?e:r;if(typeof e==="string"){o=e;n=r}const{data:s,extraData:i,message:c}=R(n);if(typeof c==="string")o=c;w(t,n);return t.as.ok(s,this.parseMessage(o,a,!1),i!==void 0?{extraData:i}:void 0).build()}async schema({checks:t,logic:e,response:r}){const a=resolveBuilder(this.store);try{await this.parseRequestBody();const n=this.args(a);if(t){const u=await t(n);if(u!==!0)return this.fail(a,u,n.req.t)}let s=e?await e(n):{};const i=l(s);if(i&&typeof i.response==="function")s=await i.response();if(b(s))return s;if(i?.status===!1)return this.fail(a,s,n.req.t);const c=r?await r({...n,logicResult:s}):s;if(b(c))return c;return this.ok(a,c,s,n.req.t)}catch(o){const n=o instanceof Error?o.message:String(o);this.logger?.log(j.ERROR,`Controller Error: ${n}`);return a.as.internalServerError(this.parseMessage(n,this.req.t,!0)).build()}}ctr(t,e){const{framework:r,protocol:a}=A(e),o=()=>this.schema(t);if(q(a))return N(o,a);return H(o,r)}}
@@ -5,6 +5,7 @@
5
5
  "cliBinNames": [
6
6
  "xry"
7
7
  ],
8
+ "cliBinFile": "main-cli.js",
8
9
  "tmpBaseName": "tmp",
9
10
  "tmpExtension": ".yml",
10
11
  "templateRepoUri": "https://github.com/xdloper/api-gpt-svc",
@@ -36,6 +36,9 @@ export declare class Constants {
36
36
  environments: string;
37
37
  dist: string;
38
38
  };
39
+ static readonly cliBinFile: string;
40
+ /** Prefer package name in logs/errors (not a short brand alias). */
41
+ static readonly logTag: string;
39
42
  static readonly bundledCoreTmpPath: string;
40
43
  }
41
44
  export { seedFromTmp, loadSeedFromBundledTmp } from '../../utils/helpers/tmp/seed-from-tmp';
@@ -1 +1 @@
1
- import n from"node:path";import{packageRootDir as q}from"../../utils/package-root";import b from"./defaults.json" with { type: 'json' };import{seedFromTmp as j}from"../../utils/helpers/tmp/seed-from-tmp";export const packageDefaults=Object.freeze({...b,mainSourceFolder:j.sourceFolder,framework:j.framework,layoutPaths:Object.freeze({...j.layout}),brand:Object.freeze({...b.brand}),buildDefaults:Object.freeze({...b.buildDefaults}),tmpWatchDefaults:Object.freeze({...b.tmpWatchDefaults}),cliBinNames:Object.freeze([...b.cliBinNames??[b.cliName]])}),coreVersionPattern=/^\d{2}\.\d{2}\.\d{2}-v\d+$/,semverVersionPattern=/^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;const v=`${packageDefaults.tmpBaseName}${packageDefaults.tmpExtension}`;export class Constants{static packageName=packageDefaults.packageName;static packageRootFolder=packageDefaults.packageRootFolder;static tmpBaseName=packageDefaults.tmpBaseName;static tmpExtension=packageDefaults.tmpExtension;static publicFolderName=packageDefaults.publicFolderName;static kafkaLogsTopic=packageDefaults.kafkaLogsTopic;static templateRepoUri=packageDefaults.templateRepoUri;static cliName=packageDefaults.cliName;static cliBinNames=packageDefaults.cliBinNames;static pathAliasKey=packageDefaults.pathAliasKey;static brand=packageDefaults.brand;static mainSourceFolder=packageDefaults.mainSourceFolder;static framework=packageDefaults.framework;static layoutPaths=packageDefaults.layoutPaths;static bundledCoreTmpPath=n.join(q,packageDefaults.packageRootFolder,v)}export{seedFromTmp,loadSeedFromBundledTmp}from"../../utils/helpers/tmp/seed-from-tmp";
1
+ import n from"node:path";import{packageRootDir as q}from"../../utils/package-root";import b from"./defaults.json" with { type: 'json' };import{seedFromTmp as j}from"../../utils/helpers/tmp/seed-from-tmp";export const packageDefaults=Object.freeze({...b,mainSourceFolder:j.sourceFolder,framework:j.framework,layoutPaths:Object.freeze({...j.layout}),brand:Object.freeze({...b.brand}),buildDefaults:Object.freeze({...b.buildDefaults}),tmpWatchDefaults:Object.freeze({...b.tmpWatchDefaults}),cliBinNames:Object.freeze([...b.cliBinNames??[b.cliName]])}),coreVersionPattern=/^\d{2}\.\d{2}\.\d{2}-v\d+$/,semverVersionPattern=/^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;const v=`${packageDefaults.tmpBaseName}${packageDefaults.tmpExtension}`;export class Constants{static packageName=packageDefaults.packageName;static packageRootFolder=packageDefaults.packageRootFolder;static tmpBaseName=packageDefaults.tmpBaseName;static tmpExtension=packageDefaults.tmpExtension;static publicFolderName=packageDefaults.publicFolderName;static kafkaLogsTopic=packageDefaults.kafkaLogsTopic;static templateRepoUri=packageDefaults.templateRepoUri;static cliName=packageDefaults.cliName;static cliBinNames=packageDefaults.cliBinNames;static pathAliasKey=packageDefaults.pathAliasKey;static brand=packageDefaults.brand;static mainSourceFolder=packageDefaults.mainSourceFolder;static framework=packageDefaults.framework;static layoutPaths=packageDefaults.layoutPaths;static cliBinFile=packageDefaults.cliBinFile??"main-cli.js";static logTag=packageDefaults.packageName;static bundledCoreTmpPath=n.join(q,packageDefaults.packageRootFolder,v)}export{seedFromTmp,loadSeedFromBundledTmp}from"../../utils/helpers/tmp/seed-from-tmp";
@@ -1 +1 @@
1
- import{FrameworkEnum as G,ProtocolEnum as K}from"../../../utils/models";import{detectSocketProtocol as L}from"../../../utils/helpers/protocol";import{getFramework as M}from"../../../utils/helpers/framework";import{runAction as I}from"../../../utils/helpers/handlers/execute";export function toRealtimeHandler(z,D){const B=(b)=>{const J=L(b,D);return I({socket:b,ctx:{ws:b},protocol:J},z)},j=(b)=>B(b);j.with=(b)=>()=>B(b);return j}export const toHandler=(z,D)=>{const B=D??M();switch(B){case G.ELYSIA:return(j)=>I({framework:B,ctx:j},z);case G.FETCH:return(j,b)=>I({framework:B,ctx:{request:j,...b}},z);case G.NODE:return(j,b)=>I({framework:B,req:j,res:b},z,b);case G.EXPRESS:return(j,b,J)=>{I({framework:B,req:j,res:b,metadata:{locals:b.locals||{}}},z,b).catch(J)};case G.WEBSOCKET:case G.SOCKETIO:throw Error('[xrystal] realtime: ctr({ ... }, { protocol: "ws" | "socketio" })');default:return(j)=>I({framework:G.ELYSIA,ctx:j},z)}},toWebSocket=(z,D)=>toRealtimeHandler(D,K.WEBSOCKET)(z),toSocketIo=(z,D)=>toRealtimeHandler(D,K.SOCKETIO)(z);
1
+ import{FrameworkEnum as G,ProtocolEnum as K}from"../../../utils/models";import{detectSocketProtocol as L}from"../../../utils/helpers/protocol";import{getFramework as M}from"../../../utils/helpers/framework";import{runAction as I}from"../../../utils/helpers/handlers/execute";import{Constants as N}from"../../../utils/constants";export function toRealtimeHandler(z,D){const B=(b)=>{const J=L(b,D);return I({socket:b,ctx:{ws:b},protocol:J},z)},j=(b)=>B(b);j.with=(b)=>()=>B(b);return j}export const toHandler=(z,D)=>{const B=D??M();switch(B){case G.ELYSIA:return(j)=>I({framework:B,ctx:j},z);case G.FETCH:return(j,b)=>I({framework:B,ctx:{request:j,...b}},z);case G.NODE:return(j,b)=>I({framework:B,req:j,res:b},z,b);case G.EXPRESS:return(j,b,J)=>{I({framework:B,req:j,res:b,metadata:{locals:b.locals||{}}},z,b).catch(J)};case G.WEBSOCKET:case G.SOCKETIO:throw Error(`[${N.packageName}] realtime: ctr({ ... }, { protocol: "ws" | "socketio" })`);default:return(j)=>I({framework:G.ELYSIA,ctx:j},z)}},toWebSocket=(z,D)=>toRealtimeHandler(D,K.WEBSOCKET)(z),toSocketIo=(z,D)=>toRealtimeHandler(D,K.SOCKETIO)(z);
@@ -1,6 +1,6 @@
1
1
  import { ProtocolEnum } from '../../../utils/models/enums';
2
2
  import { getRuntimeTmpConfigs } from '../../../utils/helpers/tmp/runtime-tmp';
3
- declare const REALTIME_MIDDLEWARE_HINT = "[xrystal] tmp.yml lists both ws and socketio \u2014 use realtimeMiddleware(\"ws\") or realtimeMiddleware(\"socketio\")";
3
+ declare const REALTIME_MIDDLEWARE_HINT: string;
4
4
  export declare function parseProtocol(value: unknown): ProtocolEnum;
5
5
  export declare function isRealtimeProtocol(protocol?: ProtocolEnum): boolean;
6
6
  export declare function isHttpProtocol(protocol?: ProtocolEnum): boolean;
@@ -1 +1 @@
1
- import{ProtocolEnum as h}from"../../../utils/models/enums";import{getRuntimeTmpConfigs as J}from"../../../utils/helpers/tmp/runtime-tmp";const G={http:h.HTTP,https:h.HTTPS,ws:h.WEBSOCKET,websocket:h.WEBSOCKET,socketio:h.SOCKETIO,socket:h.SOCKETIO},REALTIME_MIDDLEWARE_HINT='[xrystal] tmp.yml lists both ws and socketio — use realtimeMiddleware("ws") or realtimeMiddleware("socketio")';export function parseProtocol(b){if(!b)return h.HTTP;const j=String(b).toLowerCase().replace(/[-_\s.]/g,"");if(G[j])return G[j];return Object.values(h).includes(String(b))?b:h.HTTP}export function isRealtimeProtocol(b){return b===h.WEBSOCKET||b===h.SOCKETIO}export function isHttpProtocol(b){return!b||b===h.HTTP||b===h.HTTPS}function B(){return J()?.service}export function resolveProtocolsFromConfig(b){const j=b?.protocols;if(!j)return[h.HTTP];return(Array.isArray(j)?j:[j]).map(parseProtocol)}export function getConfiguredProtocols(){try{return resolveProtocolsFromConfig(B())}catch{return[h.HTTP,h.WEBSOCKET]}}export function getConfiguredRealtimeProtocols(b){return resolveProtocolsFromConfig(b).filter(isRealtimeProtocol)}export function defaultRealtimeProtocolFromConfig(b){const j=getConfiguredRealtimeProtocols(b);if(j.length===1)return j[0];if(j.length>1)return;return h.WEBSOCKET}export function getDefaultRealtimeProtocol(){try{return defaultRealtimeProtocolFromConfig(B())}catch{return h.WEBSOCKET}}export function resolveRealtimeMiddlewareProtocol(b,j){if(b!==void 0&&b!==null&&b!=="")return parseProtocol(b);let q=j;if(!q)try{q=B()}catch{return h.WEBSOCKET}const z=getConfiguredRealtimeProtocols(q);if(z.length===1)return z[0];if(z.length>1)throw Error(REALTIME_MIDDLEWARE_HINT);return h.WEBSOCKET}export function detectSocketProtocol(b,j){if(j)return j;const q=b;if(q?.__xrystalProtocol)return q.__xrystalProtocol;return h.WEBSOCKET}export function attachSocketTransport(b,j,q){const z=b;if(j===h.SOCKETIO)q.attachSocketIo(b);else q.attachWebSocket(b);z.__xrystalProtocol=j}export{REALTIME_MIDDLEWARE_HINT};
1
+ import{Constants as J}from"../../../utils/constants";import{ProtocolEnum as h}from"../../../utils/models/enums";import{getRuntimeTmpConfigs as K}from"../../../utils/helpers/tmp/runtime-tmp";const G={http:h.HTTP,https:h.HTTPS,ws:h.WEBSOCKET,websocket:h.WEBSOCKET,socketio:h.SOCKETIO,socket:h.SOCKETIO},REALTIME_MIDDLEWARE_HINT=`[${J.packageName}] tmp.yml lists both ws and socketio — use realtimeMiddleware("ws") or realtimeMiddleware("socketio")`;export function parseProtocol(b){if(!b)return h.HTTP;const j=String(b).toLowerCase().replace(/[-_\s.]/g,"");if(G[j])return G[j];return Object.values(h).includes(String(b))?b:h.HTTP}export function isRealtimeProtocol(b){return b===h.WEBSOCKET||b===h.SOCKETIO}export function isHttpProtocol(b){return!b||b===h.HTTP||b===h.HTTPS}function B(){return K()?.service}export function resolveProtocolsFromConfig(b){const j=b?.protocols;if(!j)return[h.HTTP];return(Array.isArray(j)?j:[j]).map(parseProtocol)}export function getConfiguredProtocols(){try{return resolveProtocolsFromConfig(B())}catch{return[h.HTTP,h.WEBSOCKET]}}export function getConfiguredRealtimeProtocols(b){return resolveProtocolsFromConfig(b).filter(isRealtimeProtocol)}export function defaultRealtimeProtocolFromConfig(b){const j=getConfiguredRealtimeProtocols(b);if(j.length===1)return j[0];if(j.length>1)return;return h.WEBSOCKET}export function getDefaultRealtimeProtocol(){try{return defaultRealtimeProtocolFromConfig(B())}catch{return h.WEBSOCKET}}export function resolveRealtimeMiddlewareProtocol(b,j){if(b!==void 0&&b!==null&&b!=="")return parseProtocol(b);let q=j;if(!q)try{q=B()}catch{return h.WEBSOCKET}const z=getConfiguredRealtimeProtocols(q);if(z.length===1)return z[0];if(z.length>1)throw Error(REALTIME_MIDDLEWARE_HINT);return h.WEBSOCKET}export function detectSocketProtocol(b,j){if(j)return j;const q=b;if(q?.__xrystalProtocol)return q.__xrystalProtocol;return h.WEBSOCKET}export function attachSocketTransport(b,j,q){const z=b;if(j===h.SOCKETIO)q.attachSocketIo(b);else q.attachWebSocket(b);z.__xrystalProtocol=j}export{REALTIME_MIDDLEWARE_HINT};
@@ -4,6 +4,6 @@ export type GStoreBoot = {
4
4
  warnOnRequestKeys: boolean;
5
5
  vars: Record<string, unknown>;
6
6
  };
7
- export declare const G_PROP_NOT_ALLOWED = "[xrystal] G prop not declared in tmp.yml vars \u2014 set autoCreateProps: true to allow runtime keys";
7
+ export declare const G_PROP_NOT_ALLOWED: string;
8
8
  export declare function resolveGStoreBoot(tmp?: Record<string, unknown>): GStoreBoot;
9
9
  export declare function propsFromTmp(tmp?: Record<string, unknown>): Record<string, unknown>;
@@ -1 +1 @@
1
- import{readTmpServiceBlock as I}from"../../../utils/helpers/tmp/tmp-schema";export const G_PROP_NOT_ALLOWED="[xrystal] G prop not declared in tmp.yml vars — set autoCreateProps: true to allow runtime keys";const F=()=>({});function J(j){return I(j).loaders?.system?.gStore}function L(j){if(typeof j.bootstrap==="boolean")return j.bootstrap;return!0}function M(j){if(typeof j.autoCreateProps==="boolean")return j.autoCreateProps;return!0}function Q(j){if(typeof j.warnOnRequestKeys==="boolean")return j.warnOnRequestKeys;return!0}export function resolveGStoreBoot(j={}){const x=j.configs??j,z=J(x);if(!z)return{bootstrap:!0,allowAutoCreateProps:!0,warnOnRequestKeys:!0,vars:F()};const E=z.options??{},D=z.vars,H=D&&typeof D==="object"&&!Array.isArray(D)?{...D}:F();return{bootstrap:L(E),allowAutoCreateProps:M(E),warnOnRequestKeys:Q(E),vars:H}}export function propsFromTmp(j={}){const x=resolveGStoreBoot(j);return x.bootstrap?x.vars:F()}
1
+ import{Constants as I}from"../../../utils/constants";import{readTmpServiceBlock as J}from"../../../utils/helpers/tmp/tmp-schema";export const G_PROP_NOT_ALLOWED=`[${I.packageName}] G prop not declared in tmp.yml vars — set autoCreateProps: true to allow runtime keys`;const F=()=>({});function L(j){return J(j).loaders?.system?.gStore}function M(j){if(typeof j.bootstrap==="boolean")return j.bootstrap;return!0}function Q(j){if(typeof j.autoCreateProps==="boolean")return j.autoCreateProps;return!0}function U(j){if(typeof j.warnOnRequestKeys==="boolean")return j.warnOnRequestKeys;return!0}export function resolveGStoreBoot(j={}){const x=j.configs??j,z=L(x);if(!z)return{bootstrap:!0,allowAutoCreateProps:!0,warnOnRequestKeys:!0,vars:F()};const E=z.options??{},D=z.vars,H=D&&typeof D==="object"&&!Array.isArray(D)?{...D}:F();return{bootstrap:M(E),allowAutoCreateProps:Q(E),warnOnRequestKeys:U(E),vars:H}}export function propsFromTmp(j={}){const x=resolveGStoreBoot(j);return x.bootstrap?x.vars:F()}
@@ -1,3 +1,3 @@
1
- export declare const G_REQUEST_KEY_WARN = "[xrystal] G: key looks request-scoped \u2014 use run/controller context, not global G";
1
+ export declare const G_REQUEST_KEY_WARN: string;
2
2
  export declare function looksLikeRequestScopedKey(key: string): boolean;
3
3
  export declare function warnIfRequestScopedKey(key: string, enabled: boolean): void;
@@ -1 +1 @@
1
- import{getRunContext as B}from"../../../utils/helpers/context";import{getControllerCtx as D}from"../../../utils/helpers/context/controller-store";export const G_REQUEST_KEY_WARN="[xrystal] G: key looks request-scoped — use run/controller context, not global G";const F=new Set(["requestid","reqid","correlationid","cookies","cookie","headers","header","body","query","queries","params","locals","session","sessionid"]);export function looksLikeRequestScopedKey(j){const z=j.trim();if(!z)return!1;const f=z.toLowerCase();if(F.has(f))return!0;if(f.endsWith("requestid")||f.endsWith("correlationid"))return!0;if(f==="req"||f==="res")return!0;return!1}export function warnIfRequestScopedKey(j,z){if(!z||!looksLikeRequestScopedKey(j))return;const f=B()?"run":D()?"controller":"outside-request";console.warn(`${G_REQUEST_KEY_WARN} (key: ${j}, scope: ${f})`)}
1
+ import{Constants as B}from"../../../utils/constants";import{getRunContext as D}from"../../../utils/helpers/context";import{getControllerCtx as F}from"../../../utils/helpers/context/controller-store";export const G_REQUEST_KEY_WARN=`[${B.packageName}] G: key looks request-scoped — use run/controller context, not global G`;const H=new Set(["requestid","reqid","correlationid","cookies","cookie","headers","header","body","query","queries","params","locals","session","sessionid"]);export function looksLikeRequestScopedKey(j){const z=j.trim();if(!z)return!1;const f=z.toLowerCase();if(H.has(f))return!0;if(f.endsWith("requestid")||f.endsWith("correlationid"))return!0;if(f==="req"||f==="res")return!0;return!1}export function warnIfRequestScopedKey(j,z){if(!z||!looksLikeRequestScopedKey(j))return;const f=D()?"run":F()?"controller":"outside-request";console.warn(`${G_REQUEST_KEY_WARN} (key: ${j}, scope: ${f})`)}
@@ -1 +1 @@
1
- import{onRuntimeTmpChange as k}from"../../../utils/helpers/tmp/runtime-tmp";export function bindLoaderTmpSync(c){const f=c.constructor.name;k(async()=>{try{await c.syncFromTmp()}catch(b){const j=b instanceof Error?b.message:String(b);console.warn(`[xrystal] ${f} tmp reload failed: ${j}`)}})}
1
+ import{packageDefaults as w}from"../../../utils/constants";import{onRuntimeTmpChange as x}from"../../../utils/helpers/tmp/runtime-tmp";export function bindLoaderTmpSync(j){const q=j.constructor.name;x(async()=>{try{await j.syncFromTmp()}catch(b){const v=b instanceof Error?b.message:String(b);console.warn(`[${w.packageName}] ${q} tmp reload failed: ${v}`)}})}
@@ -1 +1 @@
1
- import{healToolchainIfLayoutNeedsSync as z,resetToolchainHealState as A}from"../../../utils/helpers/tmp/toolchain-heal";let q;const v=[];export function setRuntimeTmpConfigs(j){q=j}export function getRuntimeTmpConfigs(){return q}export function onRuntimeTmpChange(j){v.push(j);return()=>{const b=v.indexOf(j);if(b>=0)v.splice(b,1)}}export async function notifyRuntimeTmpChange(j){if(j)q=j;const b=q;if(!b)return;if(b.rootFolderPath&&b.service?.paths)try{z(process.cwd(),b)}catch(k){const w=k instanceof Error?k.message:String(k);console.warn(`[xrystal] toolchain auto-sync skipped: ${w}`)}for(const k of v)await k(b)}export function clearRuntimeTmpConfigs(){q=void 0;v.length=0;A()}
1
+ import{packageDefaults as A}from"../../../utils/constants";import{healToolchainIfLayoutNeedsSync as B,resetToolchainHealState as E}from"../../../utils/helpers/tmp/toolchain-heal";let v;const w=[];export function setRuntimeTmpConfigs(j){v=j}export function getRuntimeTmpConfigs(){return v}export function onRuntimeTmpChange(j){w.push(j);return()=>{const b=w.indexOf(j);if(b>=0)w.splice(b,1)}}export async function notifyRuntimeTmpChange(j){if(j)v=j;const b=v;if(!b)return;if(b.rootFolderPath&&b.service?.paths)try{B(process.cwd(),b)}catch(q){const z=q instanceof Error?q.message:String(q);console.warn(`[${A.packageName}] toolchain auto-sync skipped: ${z}`)}for(const q of w)await q(b)}export function clearRuntimeTmpConfigs(){v=void 0;w.length=0;E()}