@batype/chainspec 2.0.0 → 2.1.0

package/README.md

@@ -15,7 +15,7 @@ React + Vite本地生成器，普通Node/browser SDK与React/SWR入口分开。*
 
 ## 一次完整流程
 
-导入或粘贴JSON → 配置命名空间/分组/服务地址 → 生成 → 搜索接口并预览调用、类型与诊断 → 下载完整SDK ZIP。输入与配置改动后，旧结果暂停复制/下载。输入面板可以折叠。支持亮色、暗色、系统主题和手机布局。
+导入文件、粘贴JSON或从URL获取 → 编辑可复用的JSON配置 → 生成 → 搜索接口并预览调用、类型与诊断 → 下载完整SDK ZIP。输入与配置改动后，旧结果暂停复制/下载。输入面板可以折叠。支持亮色、暗色、系统主题和手机布局。
 
 支持Swagger2.0、OpenAPI3.0/3.1 JSON的常见子集，本地引用、递归模型、枚举、组合类型、参数与JSON/平面表单。没有模型的响应使用unknown并提示；不是完整的OpenAPI或JSON Schema实现。远程引用、YAML和Swagger UI HTML需先转换。
 
@@ -111,7 +111,7 @@ npm run dev
 # http://127.0.0.1:4184/chainspec/
 ```
 
-CLI从本地JSON生成一个**新目录**，不会覆盖已有目录：
+CLI支持本地JSON、HTTP(S) JSON链接和配置文件。默认创建新目录；重复生成显式加`--update`，只替换未经修改、无额外文件的CLI生成目录：
 
 ```sh
 npm run build:core
@@ -119,12 +119,60 @@ node bin/chainspec.mjs --in openapi.json --out ./new-sdk --namespace main --stri
 # --group-by tag / --base-url URL / --no-hooks
 ```
 
+### 一份 JSON 配置，网页与代码库共用
+
+网页的配置区直接编辑JSON，支持导入/导出，完整SDK ZIP也包含`chainspec.config.json`。配置格式版本`version: 1`与生成器npm版本独立。
+
+```json
+{
+  "version": 1,
+  "input": "https://example.com/api-json",
+  "output": "./src/api",
+  "namespace": "main",
+  "groupBy": "tag",
+  "hooks": true,
+  "controllerNames": {
+    "短信管理": "sms"
+  }
+}
+```
+
+```sh
+npm install -D @batype/chainspec@^2.1.0
+npx chainspec --config chainspec.config.json
+# 接口更新后重新生成：
+npx chainspec --config chainspec.config.json --update
+# 也可直接从链接生成：
+npx chainspec --in https://example.com/api-json --out ./new-sdk
+```
+
+加入你项目的package.json：`"sdk:generate": "chainspec --config chainspec.config.json --update"`，以后执行`npm run sdk:generate`即可。
+
+`input`也可以是`./openapi.json`，在代码库保留对应文件即可。配置文件中的本地input/output路径相对于配置文件；显式CLI参数覆盖JSON，并相对于当前工作目录。还可配置`stripPrefix`、`baseUrl`。未知键及错误类型直接报错，配置文件不执行JavaScript。网页只读取当前导入的JSON，不根据本地路径自动读磁盘；配置中的URL需要点击“获取JSON”。输出目录只用于CLI。
+
+首个Tag保留为分组依据，中文标签仍保留在说明和搜索中。调用链只生成ASCII标识符：显式`controllerNames`优先，未映射的非ASCII分组从路径推导并提示；同一Tag保持同一分组，重名使用稳定后缀。建议为中文Tag显式映射并提交配置，让名字在路径变化后仍保持稳定。2.0已有中文调用名的SDK需重新生成并修改调用；原有英文别名与v2入参约定保持不变。
+
+`--update`通过CLI生成的文件清单和SHA256检查所有生成文件；手改文件、额外文件、符号链接、未由CLI管理的旧目录会拒绝更新。自定义请求与业务代码放在SDK目录外。没有`--update`仍不会覆盖已有目录。
+
+`path`与`query`可以同时存在。例如`/users/{id}/orders?page=1`：
+
+```ts
+API.main.users.listOrders.request({
+  path: { id: '42' },
+  query: { page: 1 }
+}, { headers: { 'X-Client': 'web' } });
+// 如果文档还声明body：request({path, query}, body, options)。
+// useRequest使用同样的位置；具体字段由文档推导。
+```
+
 Node生成器API：
 
 ```ts
-import {generateSDK} from '@batype/chainspec';
+import {generateSDK, parseConfig, fetchDocument} from '@batype/chainspec';
 const project=generateSDK(jsonText,{namespace:'main',groupBy:'path',hooks:true});
 // project.files: 文件名→内容；operations与diagnostics供自定义工具展示
+// const config = parseConfig(configJSON);
+// const remote = generateSDK(await fetchDocument(config.input), config);
 ```
 
 已正式发布到[npm：@batype/chainspec](https://www.npmjs.com/package/@batype/chainspec)，也可下载[GitHub Release tarball](https://github.com/batype/chainspec/releases)。
@@ -138,7 +186,7 @@ npx --yes --package=@batype/chainspec chainspec --in openapi.json --out ./new-sd
 
 ## 数据与安全边界
 
-生产CSP `connect-src 'none'`；Worker只解析本地文档。仅主题持久化，无云历史或遥测。输入最大8MiB、5000操作/模型。清空后移除当前输入和结果。不要未经检查就公开包含业务模型、地址和枚举的生成SDK。仓库、截图和测试使用合成API；用户提供的文档不进入公开源码。
+只有点击获取链接或执行CLI时才GET指定的JSON；浏览器不携带Cookie/认证、不经过代理，目标站需允许CORS，HTTPS页面不能获取HTTP资源。生产CSP仅为URL导入允许HTTP(S)连接；Worker仍只解析文档，不获取外部引用。URL导入有20秒超时及8MiB流式限制，可取消。仅主题持久化，无云历史或遥测。输入最大8MiB、5000操作/模型。清空后移除当前输入和结果。不要未经检查就公开包含业务模型、地址和枚举的生成SDK。仓库、截图和测试使用合成API；用户提供的文档不进入公开源码。
 
 类型不验证服务端数据；不猜鉴权凭据；不保证复杂序列化和所有Schema约束。int64依然是JS number，需要精度时由服务器返回string。参阅[限制](docs/limits.md)。
 

package/bin/chainspec.mjs

@@ -1,81 +1,95 @@
 #!/usr/bin/env node
-import { readFile, mkdir, writeFile, lstat, rm } from "node:fs/promises";
-import { resolve } from "node:path";
-import { generateSDK, MAX_BYTES, VERSION } from "../lib/core/index.js";
-const args = process.argv.slice(2),
-  opts = {};
-let inputPath, output;
+import { readFile, mkdir, writeFile, lstat, rm, readdir, rename } from "node:fs/promises";
+import { resolve, dirname, basename, join } from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { generateSDK, parseConfig, fetchDocument, MAX_BYTES, VERSION } from "../lib/core/index.js";
+const args = process.argv.slice(2), opts = {};
+const marker = ".chainspec-generated.json";
+const digest = text => createHash("sha256").update(text).digest("hex");
+let inputPath, output, configPath, update = false;
+async function localJSON(path) {
+  const stat = await lstat(path);
+  if (!stat.isFile() || stat.size > MAX_BYTES)
+    throw Error("Input must be a regular JSON file of at most 8 MiB");
+  return new TextDecoder("utf-8", { fatal: true }).decode(await readFile(path));
+}
+async function exists(path) {
+  try { return await lstat(path); }
+  catch (e) { if (e.code === "ENOENT") return null; throw e; }
+}
 try {
   if (args.includes("--help") || !args.length) {
-    console.log(
-      "chainspec --in openapi.json --out ./new-sdk [--namespace main] [--strip-prefix /v1/api] [--group-by path|tag] [--base-url URL] [--no-hooks]\nReads local JSON only; creates a new output directory, never overwrites it.",
-    );
-    process.exit(0);
-  }
-  if (args.includes("--version")) {
-    console.log(VERSION);
+    console.log("chainspec --config chainspec.config.json [--update]\nchainspec --in openapi.json|https://example.com/api-json --out ./new-sdk [--namespace main] [--strip-prefix /v1/api] [--group-by path|tag] [--base-url URL] [--no-hooks]\nPaths in JSON resolve relative to the config file; explicit CLI flags override JSON.\nCreates a new directory. --update replaces only an unchanged CLI-generated directory.");
     process.exit(0);
   }
+  if (args.includes("--version")) { console.log(VERSION); process.exit(0); }
   for (let i = 0; i < args.length; i++) {
     const flag = args[i];
-    if (flag === "--no-hooks") {
-      opts.hooks = false;
-      continue;
-    }
-    if (
-      ![
-        "--in",
-        "--out",
-        "--namespace",
-        "--strip-prefix",
-        "--group-by",
-        "--base-url",
-      ].includes(flag)
-    )
+    if (flag === "--no-hooks") { opts.hooks = false; continue; }
+    if (flag === "--update") { update = true; continue; }
+    if (!["--config", "--in", "--out", "--namespace", "--strip-prefix", "--group-by", "--base-url"].includes(flag))
       throw Error("Unknown option; use --help");
     const val = args[++i];
     if (!val || val.startsWith("--")) throw Error("Missing option value");
-    if (flag === "--in") inputPath = val;
+    if (flag === "--config") configPath = resolve(val);
+    else if (flag === "--in") inputPath = val;
     else if (flag === "--out") output = val;
-    else
-      opts[
-        {
-          "--namespace": "namespace",
-          "--strip-prefix": "stripPrefix",
-          "--group-by": "groupBy",
-          "--base-url": "baseUrl",
-        }[flag]
-      ] = val;
+    else opts[{"--namespace":"namespace", "--strip-prefix":"stripPrefix", "--group-by":"groupBy", "--base-url":"baseUrl"}[flag]] = val;
   }
-  if (!inputPath || !output) throw Error("--in and --out are required");
-  if (opts.groupBy && !["path", "tag"].includes(opts.groupBy))
-    throw Error("--group-by must be path or tag");
-  const stat = await lstat(inputPath);
-  if (!stat.isFile() || stat.size > MAX_BYTES)
-    throw Error("Input must be a regular JSON file of at most 8 MiB");
-  const result = generateSDK(
-    new TextDecoder("utf-8", { fatal: true }).decode(await readFile(inputPath)),
-    opts,
-  );
-  const dir = resolve(output);
-  await mkdir(dir, { mode: 0o700 });
+  const config = configPath ? parseConfig(await localJSON(configPath)) : undefined;
+  const base = configPath ? dirname(configPath) : process.cwd();
+  const source = inputPath ?? config?.input;
+  const destination = output ? resolve(output) : config ? resolve(base, config.output) : undefined;
+  if (!source || !destination) throw Error("--in and --out, or --config, are required");
+  const settings = { ...config, ...opts };
+  if (settings.groupBy && !["path", "tag"].includes(settings.groupBy)) throw Error("--group-by must be path or tag");
+  const text = /^[a-z][a-z\d+.-]*:/i.test(source)
+    ? await fetchDocument(source)
+    : await localJSON(resolve(inputPath ? process.cwd() : base, source));
+  const result = generateSDK(text, settings);
+  const dir = destination;
+  const old = await exists(dir);
+  if (old) {
+    if (!update) throw Object.assign(Error("Output already exists; choose a new directory or use --update."), { code: "EEXIST" });
+    if (!old.isDirectory() || old.isSymbolicLink()) throw Error("Refusing to update a symlink or non-directory");
+    const ownerStat = await exists(join(dir, marker));
+    if (!ownerStat?.isFile() || ownerStat.isSymbolicLink()) throw Error("Output is not managed by this CLI; choose a new directory");
+    const owner = JSON.parse(await localJSON(join(dir, marker)));
+    if (owner.generator !== "ChainSpec" || !owner.files || typeof owner.files !== "object" || Array.isArray(owner.files))
+      throw Error("Invalid generated-directory marker");
+    const names = await readdir(dir);
+    if (names.some(name => name !== marker && !Object.hasOwn(owner.files, name)))
+      throw Error("Output contains extra files; move custom code outside the generated directory");
+    for (const [name, hash] of Object.entries(owner.files)) {
+      if (name !== basename(name) || name === marker || !names.includes(name)) throw Error("Generated files changed; choose a new directory");
+      const stat = await lstat(join(dir, name));
+      if (!stat.isFile() || stat.isSymbolicLink() || digest(await readFile(join(dir, name))) !== hash)
+        throw Error("Generated files changed; choose a new directory to preserve edits");
+    }
+  }
+  await mkdir(dirname(dir), { recursive: true });
+  const stage = join(dirname(dir), `.${basename(dir)}.chainspec-${randomUUID()}`);
+  await mkdir(stage, { mode: 0o700 });
   try {
+    const files = Object.fromEntries(Object.entries(result.files).map(([name, text]) => [name, digest(text)]));
     for (const [file, text] of Object.entries(result.files))
-      await writeFile(resolve(dir, file), text, { flag: "wx", mode: 0o600 });
-  } catch (e) {
-    await rm(dir, { recursive: true, force: true });
-    throw e;
-  }
-  console.log(
-    `Generated ${result.operations.length} operations, ${result.schemaCount} schemas, ${result.diagnostics.length} diagnostics.\nOutput: ${dir}`,
-  );
+      await writeFile(join(stage, file), text, { flag: "wx", mode: 0o600 });
+    await writeFile(join(stage, marker), JSON.stringify({ generator: "ChainSpec", version: VERSION, files }, null, 2), { flag: "wx", mode: 0o600 });
+    if (old) {
+      const backup = `${stage}.previous`;
+      await rename(dir, backup);
+      try { await rename(stage, dir); }
+      catch (e) { await rename(backup, dir); throw e; }
+      await rm(backup, { recursive: true });
+    } else {
+      // Reserve destination first so a concurrently created directory is never replaced.
+      await mkdir(dir, { mode: 0o700 });
+      try { for (const name of await readdir(stage)) await rename(join(stage, name), join(dir, name)); }
+      catch (e) { await rm(dir, { recursive: true, force: true }); throw e; }
+    }
+  } finally { await rm(stage, { recursive: true, force: true }); }
+  console.log(`Generated ${result.operations.length} operations, ${result.schemaCount} schemas, ${result.diagnostics.length} diagnostics.\nOutput: ${dir}`);
 } catch (error) {
-  console.error(
-    error?.code === "EEXIST"
-      ? "Output already exists; choose a new directory."
-      : error instanceof Error
-        ? error.message
-        : "Generation failed",
-  );
+  console.error(error?.code === "EEXIST" ? "Output already exists; choose a new directory or use --update." : error instanceof Error ? error.message : "Generation failed");
   process.exitCode = 1;
 }

package/lib/core/config.d.ts

@@ -0,0 +1,10 @@
+import type { GeneratorOptions } from "./model.js";
+/** Shared by the web editor and CLI. Paths resolve relative to the config file. */
+export type ChainSpecConfig = GeneratorOptions & {
+    version: 1;
+    input: string;
+    output: string;
+};
+export declare const DEFAULT_CONFIG: ChainSpecConfig;
+export declare function parseConfig(input: string | unknown): ChainSpecConfig;
+export declare function documentURL(input: string): URL;

package/lib/core/config.js

@@ -0,0 +1,67 @@
+export const DEFAULT_CONFIG = {
+    version: 1,
+    input: "./openapi.json",
+    output: "./src/api",
+    namespace: "main",
+    groupBy: "path",
+    hooks: true,
+    controllerNames: {},
+};
+const keys = new Set([
+    "version", "input", "output", "namespace", "groupBy", "stripPrefix",
+    "controllerNames", "baseUrl", "hooks",
+]);
+export function parseConfig(input) {
+    let value = input;
+    if (typeof input === "string") {
+        try {
+            value = JSON.parse(input);
+        }
+        catch {
+            throw new Error("配置必须是有效 JSON");
+        }
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("配置必须是 JSON 对象");
+    for (const key of Object.keys(value))
+        if (!keys.has(key))
+            throw new Error(`未知配置项：${key}`);
+    if (value.version !== 1)
+        throw new Error("配置 version 必须为 1");
+    for (const key of ["input", "output"])
+        if (typeof value[key] !== "string" || !value[key].trim())
+            throw new Error(`配置 ${key} 必须为非空字符串`);
+    for (const key of ["namespace", "stripPrefix", "baseUrl"])
+        if (value[key] !== undefined && typeof value[key] !== "string")
+            throw new Error(`配置 ${key} 必须为字符串`);
+    if (value.namespace !== undefined && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value.namespace))
+        throw new Error("命名空间需为英文标识符");
+    if (value.groupBy !== undefined && !["path", "tag"].includes(value.groupBy))
+        throw new Error("groupBy 必须为 path 或 tag");
+    if (value.hooks !== undefined && typeof value.hooks !== "boolean")
+        throw new Error("hooks 必须为布尔值");
+    if (value.stripPrefix && !value.stripPrefix.startsWith("/"))
+        throw new Error("stripPrefix 必须以 / 开头");
+    if (value.controllerNames !== undefined) {
+        if (!value.controllerNames || typeof value.controllerNames !== "object" || Array.isArray(value.controllerNames))
+            throw new Error("controllerNames 必须为原分组到英文名称的对象");
+        for (const alias of Object.values(value.controllerNames))
+            if (typeof alias !== "string" || !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(alias))
+                throw new Error("controllerNames 的值必须为英文标识符，例如 sms");
+    }
+    if (/^[a-z][a-z\d+.-]*:/i.test(value.input))
+        documentURL(value.input);
+    return { ...value, controllerNames: { ...value.controllerNames } };
+}
+export function documentURL(input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw new Error("请输入完整的 HTTP(S) JSON 地址");
+    }
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.hash)
+        throw new Error("文档地址仅支持 HTTP(S)，不能包含用户名、密码或片段");
+    return url;
+}

package/lib/core/index.d.ts

@@ -1,5 +1,8 @@
 import type { GeneratorOptions, GeneratedProject } from "./model.js";
 export type { GeneratorOptions, GeneratedProject, Diagnostic, Operation, } from "./model.js";
 export { MAX_BYTES, MAX_OPERATIONS } from "./model.js";
-export declare const VERSION = "2.0.0";
+export { parseConfig, DEFAULT_CONFIG } from "./config.js";
+export type { ChainSpecConfig } from "./config.js";
+export { fetchDocument } from "./source.js";
+export declare const VERSION = "2.1.0";
 export declare function generateSDK(input: string | Record<string, any>, options?: GeneratorOptions): GeneratedProject;

package/lib/core/index.js

@@ -2,7 +2,9 @@ import { parseDocument, normalize } from "./parse.js";
 import { createSchemaWriter } from "./schema.js";
 import { RUNTIME_SOURCE, HOOKS_SOURCE, RUNTIME_LICENSE } from "./templates.js";
 export { MAX_BYTES, MAX_OPERATIONS } from "./model.js";
-export const VERSION = "2.0.0";
+export { parseConfig, DEFAULT_CONFIG } from "./config.js";
+export { fetchDocument } from "./source.js";
+export const VERSION = "2.1.0";
 const q = JSON.stringify;
 const banner = "// Generated by ChainSpec. Do not edit; regenerate from your OpenAPI document.\n";
 export function generateSDK(input, options = {}) {

package/lib/core/parse.js

@@ -14,12 +14,12 @@ const reserved = new Set(["__proto__", "prototype", "constructor", "then"]);
 export function nameOf(value, fallback = "endpoint") {
     const words = value
         .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-        .split(/[^\p{ID_Continue}$]+/u)
+        .split(/[^A-Za-z0-9_$]+/)
         .filter(Boolean);
     let result = words
         .map((w, i) => i ? w[0].toUpperCase() + w.slice(1) : w[0].toLowerCase() + w.slice(1))
         .join("") || fallback;
-    if (!/^[\p{ID_Start}_$]/u.test(result))
+    if (!/^[A-Za-z_$]/.test(result))
         result = "_" + result;
     return reserved.has(result) ? result + "Api" : result;
 }
@@ -52,7 +52,7 @@ export function parseDocument(input) {
 }
 export function normalize(doc, options, diagnostics) {
     const namespace = options.namespace ?? "main";
-    if (!/^[\p{ID_Start}_$][\p{ID_Continue}$]*$/u.test(namespace) ||
+    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(namespace) ||
         reserved.has(namespace))
         throw new Error("命名空间需是有效标识符，不能使用保留的对象属性");
     const candidates = [
@@ -71,6 +71,7 @@ export function normalize(doc, options, diagnostics) {
     const operations = [];
     const used = new Set();
     const groupSources = new Map();
+    const assignedGroups = new Map();
     for (const path of Object.keys(doc.paths).sort()) {
         if (!path.startsWith("/") || path.includes("?") || path.includes("#"))
             throw new Error("paths中的路径需以/开头且不能包含query/hash");
@@ -92,7 +93,16 @@ export function normalize(doc, options, diagnostics) {
                 "default";
             const originalGroup = op["x-sdk-controller"] ??
                 (options.groupBy === "tag" ? (tags[0] ?? pathGroup) : pathGroup);
-            let controller = nameOf(options.controllerNames?.[originalGroup] ?? originalGroup, "default");
+            const alias = options.controllerNames?.[originalGroup];
+            if (alias !== undefined && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(alias))
+                throw new Error(`分组「${originalGroup}」的别名需为英文标识符`);
+            let controller = assignedGroups.get(originalGroup) ?? nameOf(alias ?? (/^[\x00-\x7F]+$/.test(originalGroup) ? originalGroup : pathGroup), "group_" + hash(originalGroup));
+            if (!assignedGroups.has(originalGroup) && alias === undefined && /[^\x00-\x7F]/.test(originalGroup))
+                diagnostics.push({
+                    level: "warning", code: "group-name-fallback",
+                    message: `分组「${originalGroup}」使用路径推导名称 ${controller}；可在 controllerNames 中显式映射`,
+                    location: path,
+                });
             if (groupSources.has(controller) &&
                 groupSources.get(controller) !== originalGroup) {
                 controller += "_" + hash(originalGroup);
@@ -104,8 +114,10 @@ export function normalize(doc, options, diagnostics) {
                 });
             }
             groupSources.set(controller, originalGroup);
+            assignedGroups.set(originalGroup, controller);
             const originalId = typeof op.operationId === "string" ? op.operationId : undefined;
-            let name = nameOf(originalId ?? method + " " + stripped.replace(/\{([^}]+)\}/g, "by $1"));
+            const methodSource = method + " " + stripped.replace(/\{([^}]+)\}/g, "by $1");
+            let name = nameOf(originalId && /^[\x00-\x7F]+$/.test(originalId) ? originalId : methodSource);
             if (used.has(`${controller}.${name}`)) {
                 name += "_" + method + "_" + hash(path);
                 diagnostics.push({

package/lib/core/source.d.ts

@@ -0,0 +1,2 @@
+/** Only called after an explicit URL import / CLI invocation. Never fetches refs. */
+export declare function fetchDocument(input: string, signal?: AbortSignal): Promise<string>;

package/lib/core/source.js

@@ -0,0 +1,43 @@
+import { MAX_BYTES } from "./model.js";
+import { parseDocument } from "./parse.js";
+import { documentURL } from "./config.js";
+/** Only called after an explicit URL import / CLI invocation. Never fetches refs. */
+export async function fetchDocument(input, signal) {
+    const url = documentURL(input);
+    const abort = AbortSignal.any([AbortSignal.timeout(20_000), ...(signal ? [signal] : [])]);
+    const response = await fetch(url, {
+        method: "GET", credentials: "omit", referrerPolicy: "no-referrer",
+        headers: { Accept: "application/json" }, signal: abort,
+    });
+    if (!response.ok) {
+        await response.body?.cancel();
+        throw new Error(`获取文档失败：HTTP ${response.status}`);
+    }
+    if (Number(response.headers.get("content-length")) > MAX_BYTES) {
+        await response.body?.cancel();
+        throw new Error("远程文档最大 8 MiB");
+    }
+    if (!response.body)
+        throw new Error("远程文档为空");
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let bytes = 0, text = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytes += value.byteLength;
+            if (bytes > MAX_BYTES)
+                throw new Error("远程文档最大 8 MiB");
+            text += decoder.decode(value, { stream: true });
+        }
+        text += decoder.decode();
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+    parseDocument(text);
+    return text;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@batype/chainspec",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Generate typed chainable TypeScript SDKs and SWR hooks from OpenAPI JSON, locally.",
   "type": "module",
   "license": "MIT",