@nestia/sdk 14.1.0 → 14.2.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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ORGANIZATION/PROJECT-api",
3
- "version": "14.1.0",
3
+ "version": "14.2.1",
4
4
  "description": "SDK library generated by Nestia",
5
5
  "main": "lib/index.js",
6
6
  "typings": "lib/index.d.ts",
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Returns the runtime release linked into the selected core package's Go host.
3
+ *
4
+ * New descriptors publish that release independently of the installed runtime,
5
+ * so the dependencies command can repair an upgrade admitted by a range. Older
6
+ * descriptors lack this metadata and retain their exact-dependency lookup.
7
+ * Reading the exported value never executes the descriptor factory or its
8
+ * guard.
9
+ *
10
+ * @evidence contracts/common.md#principled-implementation The selected installed core descriptor supplies its pinned transform release. Only legacy descriptors without that field fall back to their resolved runtime manifest; malformed declared metadata rejects instead of selecting an incompatible installed version.
11
+ * @evidence contracts/common.md#clear-and-simple-design One operation owns descriptor metadata admission and the legacy manifest fallback, replacing the CLI's assumption that every dependency is exact.
12
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Ordinary Node module resolution and manifest reads supply the version. The descriptor factory is not executed, and no resolver, package manager or installed module is patched.
13
+ * @evidence contracts/common.md#meaningful-documentation The comment distinguishes pinned transform metadata from legacy runtime lookup and explains why the guard factory stays unexecuted.
14
+ * @evidence contracts/portability.md#os-neutral-implementation Native path.dirname and path.join locate the descriptor from the caller-resolved core manifest; Node resolution anchors the legacy runtime to that installed core on Windows and POSIX without shell parsing.
15
+ */
16
+ export declare function getLinkedTypiaVersion(corePackageFile: string): string;
@@ -0,0 +1,34 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.getLinkedTypiaVersion = getLinkedTypiaVersion;
7
+ const fs_1 = __importDefault(require("fs"));
8
+ const path_1 = __importDefault(require("path"));
9
+ /**
10
+ * Returns the runtime release linked into the selected core package's Go host.
11
+ *
12
+ * New descriptors publish that release independently of the installed runtime,
13
+ * so the dependencies command can repair an upgrade admitted by a range. Older
14
+ * descriptors lack this metadata and retain their exact-dependency lookup.
15
+ * Reading the exported value never executes the descriptor factory or its
16
+ * guard.
17
+ *
18
+ * @evidence contracts/common.md#principled-implementation The selected installed core descriptor supplies its pinned transform release. Only legacy descriptors without that field fall back to their resolved runtime manifest; malformed declared metadata rejects instead of selecting an incompatible installed version.
19
+ * @evidence contracts/common.md#clear-and-simple-design One operation owns descriptor metadata admission and the legacy manifest fallback, replacing the CLI's assumption that every dependency is exact.
20
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Ordinary Node module resolution and manifest reads supply the version. The descriptor factory is not executed, and no resolver, package manager or installed module is patched.
21
+ * @evidence contracts/common.md#meaningful-documentation The comment distinguishes pinned transform metadata from legacy runtime lookup and explains why the guard factory stays unexecuted.
22
+ * @evidence contracts/portability.md#os-neutral-implementation Native path.dirname and path.join locate the descriptor from the caller-resolved core manifest; Node resolution anchors the legacy runtime to that installed core on Windows and POSIX without shell parsing.
23
+ */
24
+ function getLinkedTypiaVersion(corePackageFile) {
25
+ const core = path_1.default.dirname(corePackageFile);
26
+ const descriptor = require(path_1.default.join(core, "native/transform.cjs"));
27
+ const version = "typiaVersion" in descriptor
28
+ ? descriptor.typiaVersion
29
+ : JSON.parse(fs_1.default.readFileSync(require.resolve("typia/package.json", { paths: [core] }), "utf8")).version;
30
+ if (typeof version !== "string" || version.length === 0)
31
+ throw new Error(`Invalid typia transform version for ${corePackageFile}.`);
32
+ return version;
33
+ }
34
+ //# sourceMappingURL=getLinkedTypiaVersion.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getLinkedTypiaVersion.js","sourceRoot":"","sources":["../../../src/executable/internal/getLinkedTypiaVersion.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAExB;;;;;;;;;;;;;;GAcG;AACH,+BAAsC,eAAuB;IAC3D,MAAM,IAAI,GAAG,cAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GACX,cAAc,IAAI,UAAU;QAC1B,CAAC,CAAC,UAAU,CAAC,YAAY;QACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,YAAE,CAAC,YAAY,CACb,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EACxD,MAAM,CACP,CACF,CAAC,OAAO,CAAC;IAChB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,uCAAuC,eAAe,GAAG,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -48,9 +48,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
48
48
  Object.defineProperty(exports, "__esModule", { value: true });
49
49
  const child_process_1 = __importDefault(require("child_process"));
50
50
  const fs_1 = __importDefault(require("fs"));
51
- const path_1 = __importDefault(require("path"));
52
51
  const process_1 = __importDefault(require("process"));
53
52
  const CommandParser_1 = require("./internal/CommandParser");
53
+ const getLinkedTypiaVersion_1 = require("./internal/getLinkedTypiaVersion");
54
54
  const USAGE = `Wrong command has been detected. Use like below:
55
55
 
56
56
  npx @nestia/sdk [command] [options?]
@@ -79,21 +79,13 @@ function dependencies(argv) {
79
79
  for (const lib of [
80
80
  "@nestia/e2e",
81
81
  "@nestia/fetcher",
82
- `typia@${linkedTypiaVersion()} -E`,
82
+ `typia@${(0, getLinkedTypiaVersion_1.getLinkedTypiaVersion)(require.resolve("@nestia/core/package.json"))} -E`,
83
83
  ]) {
84
84
  const command = `${prefix} ${lib}`;
85
85
  console.log(`\n$ ${command}`);
86
86
  child_process_1.default.execSync(command, { stdio: "inherit" });
87
87
  }
88
88
  }
89
- /**
90
- * The typia release the Nestia transform links: the one `@nestia/core`
91
- * resolves, which its exact dependency holds at that release.
92
- */
93
- function linkedTypiaVersion() {
94
- const core = path_1.default.dirname(require.resolve("@nestia/core/package.json"));
95
- return JSON.parse(fs_1.default.readFileSync(require.resolve("typia/package.json", { paths: [core] }), "utf8")).version;
96
- }
97
89
  function initialize() {
98
90
  return __awaiter(this, void 0, void 0, function* () {
99
91
  if (fs_1.default.existsSync("nestia.config.ts") === true)
@@ -1 +1 @@
1
- {"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/executable/sdk.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/executable/sdk.ts"],"names":[],"mappings":"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"}
package/native/go.mod CHANGED
@@ -9,7 +9,7 @@ require (
9
9
  github.com/microsoft/typescript-go/shim/scanner v0.0.0
10
10
  github.com/samchon/nestia/packages/core/native v0.0.0
11
11
  github.com/samchon/ttsc/packages/ttsc v0.0.0
12
- github.com/samchon/typia/packages/typia/native v0.0.0-20261023133454-6432cda78a43
12
+ github.com/samchon/typia/packages/typia/native v0.0.0-20261106144738-f69ad674d6c8
13
13
  )
14
14
 
15
15
  require (
package/native/go.sum CHANGED
@@ -42,8 +42,8 @@ github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20261022210737-6
42
42
  github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20261022210737-6c732c27442a/go.mod h1:DaCDdbH+CHIFe/q892vC4j3mZRUStrIusZ+GYvKlyt8=
43
43
  github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20261022210737-6c732c27442a h1:8nE4S9Us6IjW5enNNfS87Y0sv3hsJumG2aBxP2z66Cw=
44
44
  github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20261022210737-6c732c27442a/go.mod h1:+yDn4SWLNFqwazlFuoW6/Q68j17MZSoUBvRDvFzwKSk=
45
- github.com/samchon/typia/packages/typia/native v0.0.0-20261023133454-6432cda78a43 h1:qqOqlBpRP8pNvdrU5Jx4o7/Jq8jJpAAELExhaNOPBNo=
46
- github.com/samchon/typia/packages/typia/native v0.0.0-20261023133454-6432cda78a43/go.mod h1:wpHKKDEHhiK4yKFbNhq0KYmaSkzU4SIxGjFxqydWp8U=
45
+ github.com/samchon/typia/packages/typia/native v0.0.0-20261106144738-f69ad674d6c8 h1:lWKR8g853idEIk3tyf74dnKPeUrj2c4IA3JBl73eUnA=
46
+ github.com/samchon/typia/packages/typia/native v0.0.0-20261106144738-f69ad674d6c8/go.mod h1:QhVfMyXEyLx5rSXeY7HaPlpmjxSzkBvqSJapoBXKZPU=
47
47
  github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
48
48
  github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
49
49
  github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
@@ -1257,6 +1257,7 @@ func nestiaSDKMarkReadonlySchemaType(prog *driver.Program, typ *shimchecker.Type
1257
1257
  if visiting[key] { return }
1258
1258
  visiting[key] = true
1259
1259
  if typ.Flags() & (shimchecker.TypeFlagsUnion | shimchecker.TypeFlagsIntersection) != 0 {
1260
+ if typ.Flags() & shimchecker.TypeFlagsUnion != 0 && nestiaSDKReadonlyScalarUnion(target) { return }
1260
1261
  for _, child := range typ.AsUnionOrIntersectionType().Types() {
1261
1262
  matched := false
1262
1263
  if typ.Flags() & shimchecker.TypeFlagsUnion != 0 {
@@ -1339,6 +1340,51 @@ func nestiaSDKMarkReadonlySchemaType(prog *driver.Program, typ *shimchecker.Type
1339
1340
  }
1340
1341
  }
1341
1342
 
1343
+ // nestiaSDKReadonlyScalarUnion reports whether a union schema has only
1344
+ // terminal scalar branches, so no constituent can own a readonly array marker.
1345
+ //
1346
+ // Readonly markers attach to array and tuple positions. A branch whose type is
1347
+ // string, number, integer, boolean or null and which carries no reference,
1348
+ // composition, object or array keyword contains no such position, so pairing
1349
+ // its constituent through MetadataFactory.Analyze cannot change the document.
1350
+ // A branch without an explicit scalar type, and every other shape, keeps the
1351
+ // constituent probe.
1352
+ func nestiaSDKReadonlyScalarUnion(schema map[string]any) bool {
1353
+ if !nestiaSDKReadonlyScalarShape(schema, true) { return false }
1354
+ found := false
1355
+ for _, keyword := range []string{"oneOf", "anyOf"} {
1356
+ if _, exists := schema[keyword]; !exists { continue }
1357
+ branches := nestiaSDKSchemaList(schema[keyword])
1358
+ if len(branches) == 0 { return false }
1359
+ found = true
1360
+ for _, branch := range branches {
1361
+ if !nestiaSDKReadonlyScalarShape(nestiaSDKSchemaMap(branch), false) { return false }
1362
+ }
1363
+ }
1364
+ return found
1365
+ }
1366
+
1367
+ // nestiaSDKReadonlyScalarShape reports whether one schema has no position that
1368
+ // could hold a readonly array marker. allowUnion admits the oneOf/anyOf parent
1369
+ // whose branches nestiaSDKReadonlyScalarUnion checks separately.
1370
+ func nestiaSDKReadonlyScalarShape(schema map[string]any, allowUnion bool) bool {
1371
+ if schema == nil { return false }
1372
+ if value, exists := schema["type"]; exists {
1373
+ switch value {
1374
+ case "string", "number", "integer", "boolean", "null":
1375
+ default: return false
1376
+ }
1377
+ } else if !allowUnion { return false }
1378
+ for _, key := range []string{"$ref", "$dynamicRef", "$recursiveRef", "allOf", "not", "if", "then", "else", "properties", "patternProperties", "additionalProperties", "unevaluatedProperties", "dependentSchemas", "propertyNames", "items", "prefixItems", "additionalItems", "contains", "unevaluatedItems", "$defs", "definitions"} {
1379
+ if _, exists := schema[key]; exists { return false }
1380
+ }
1381
+ if !allowUnion {
1382
+ if _, exists := schema["oneOf"]; exists { return false }
1383
+ if _, exists := schema["anyOf"]; exists { return false }
1384
+ }
1385
+ return true
1386
+ }
1387
+
1342
1388
  // nestiaSDKReadonlySchemaEquivalent compares the native writer's branch shape,
1343
1389
  // ignoring only the readonly facts this traversal has already attached.
1344
1390
  func nestiaSDKReadonlySchemaEquivalent(expected any, actual any) bool {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nestia/sdk",
3
- "version": "14.1.0",
3
+ "version": "14.2.1",
4
4
  "description": "Nestia SDK and Swagger generator",
5
5
  "main": "lib/index.js",
6
6
  "bin": {
@@ -45,23 +45,23 @@
45
45
  },
46
46
  "homepage": "https://nestia.io",
47
47
  "dependencies": {
48
- "@ttsc/factory": "^0.34.1",
49
- "@typia/interface": "^15.2.0",
50
- "@typia/utils": "^15.2.0",
48
+ "@ttsc/factory": "^0.36.3",
49
+ "@typia/interface": "^15.3.0",
50
+ "@typia/utils": "^15.3.0",
51
51
  "get-function-location": "^2.0.0",
52
52
  "glob": "^11.0.3",
53
53
  "path-to-regexp": "^6.2.1",
54
54
  "prettier": "^3.8.1",
55
55
  "tgrid": "^1.2.1",
56
- "ttsc": "^0.34.1",
56
+ "ttsc": "^0.36.3",
57
57
  "tstl": "^3.0.0",
58
- "typia": "15.2.0",
58
+ "typia": "^15.3.0",
59
59
  "@babel/parser": "^7.29.8",
60
- "@nestia/core": "^14.1.0",
61
- "@nestia/fetcher": "^14.1.0"
60
+ "@nestia/core": "^14.2.1",
61
+ "@nestia/fetcher": "^14.2.1"
62
62
  },
63
63
  "peerDependencies": {
64
- "@nestia/core": "^14.1.0"
64
+ "@nestia/core": "^14.2.1"
65
65
  },
66
66
  "devDependencies": {
67
67
  "@modelcontextprotocol/sdk": "^1.18.0",
@@ -0,0 +1,34 @@
1
+ import fs from "fs";
2
+ import path from "path";
3
+
4
+ /**
5
+ * Returns the runtime release linked into the selected core package's Go host.
6
+ *
7
+ * New descriptors publish that release independently of the installed runtime,
8
+ * so the dependencies command can repair an upgrade admitted by a range. Older
9
+ * descriptors lack this metadata and retain their exact-dependency lookup.
10
+ * Reading the exported value never executes the descriptor factory or its
11
+ * guard.
12
+ *
13
+ * @evidence contracts/common.md#principled-implementation The selected installed core descriptor supplies its pinned transform release. Only legacy descriptors without that field fall back to their resolved runtime manifest; malformed declared metadata rejects instead of selecting an incompatible installed version.
14
+ * @evidence contracts/common.md#clear-and-simple-design One operation owns descriptor metadata admission and the legacy manifest fallback, replacing the CLI's assumption that every dependency is exact.
15
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Ordinary Node module resolution and manifest reads supply the version. The descriptor factory is not executed, and no resolver, package manager or installed module is patched.
16
+ * @evidence contracts/common.md#meaningful-documentation The comment distinguishes pinned transform metadata from legacy runtime lookup and explains why the guard factory stays unexecuted.
17
+ * @evidence contracts/portability.md#os-neutral-implementation Native path.dirname and path.join locate the descriptor from the caller-resolved core manifest; Node resolution anchors the legacy runtime to that installed core on Windows and POSIX without shell parsing.
18
+ */
19
+ export function getLinkedTypiaVersion(corePackageFile: string): string {
20
+ const core = path.dirname(corePackageFile);
21
+ const descriptor = require(path.join(core, "native/transform.cjs"));
22
+ const version =
23
+ "typiaVersion" in descriptor
24
+ ? descriptor.typiaVersion
25
+ : JSON.parse(
26
+ fs.readFileSync(
27
+ require.resolve("typia/package.json", { paths: [core] }),
28
+ "utf8",
29
+ ),
30
+ ).version;
31
+ if (typeof version !== "string" || version.length === 0)
32
+ throw new Error(`Invalid typia transform version for ${corePackageFile}.`);
33
+ return version;
34
+ }
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import cp from "child_process";
3
3
  import fs from "fs";
4
- import path from "path";
5
4
  import process from "process";
6
5
 
7
6
  import { CommandParser } from "./internal/CommandParser";
8
7
  import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
8
+ import { getLinkedTypiaVersion } from "./internal/getLinkedTypiaVersion";
9
9
 
10
10
  const USAGE = `Wrong command has been detected. Use like below:
11
11
 
@@ -37,7 +37,7 @@ function dependencies(argv: string[]): void {
37
37
  for (const lib of [
38
38
  "@nestia/e2e",
39
39
  "@nestia/fetcher",
40
- `typia@${linkedTypiaVersion()} -E`,
40
+ `typia@${getLinkedTypiaVersion(require.resolve("@nestia/core/package.json"))} -E`,
41
41
  ]) {
42
42
  const command: string = `${prefix} ${lib}`;
43
43
  console.log(`\n$ ${command}`);
@@ -45,22 +45,6 @@ function dependencies(argv: string[]): void {
45
45
  }
46
46
  }
47
47
 
48
- /**
49
- * The typia release the Nestia transform links: the one `@nestia/core`
50
- * resolves, which its exact dependency holds at that release.
51
- */
52
- function linkedTypiaVersion(): string {
53
- const core: string = path.dirname(
54
- require.resolve("@nestia/core/package.json"),
55
- );
56
- return JSON.parse(
57
- fs.readFileSync(
58
- require.resolve("typia/package.json", { paths: [core] }),
59
- "utf8",
60
- ),
61
- ).version;
62
- }
63
-
64
48
  async function initialize(): Promise<void> {
65
49
  if (fs.existsSync("nestia.config.ts") === true)
66
50
  halt(