@ones-open/cli 0.0.12-21205.1 → 0.0.13

package/dist/index.cjs

@@ -24,6 +24,9 @@ const http = require("node:http");
 const open = require("open");
 const uuid = require("uuid");
 const PKCEChallenge = require("pkce-challenge");
+const node_crypto = require("node:crypto");
+const promises = require("node:stream/promises");
+const node_os = require("node:os");
 var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
 const en = {
   "desc.ones": "ONES CLI/{env}",
@@ -41,6 +44,13 @@ const en = {
   "desc.logout": "Log out of your ONES account",
   "desc.whoami": "Display the account information of the logged in user",
   "desc.app": "Manage app installations",
+  "desc.specs": "Manage ONES app specs resources to build your ONES App",
+  "desc.specs.fetch": "Fetch ONES app specs (download, checksum verify, and extract by default)",
+  "desc.specs.fetch.baseUrl": "Specify the base URL for specs resources",
+  "desc.specs.fetch.dir": "Specify the base directory (specs saved to <dir>/.ones/ones-app-specs)",
+  "desc.specs.fetch.noExtract": "Download only, do not extract archive automatically",
+  "desc.specs.fetch.json": "Output result in JSON format",
+  "desc.specs.fetch.force": "Force fetch even when local checksum is already up to date",
   "desc.install": "Install your ONES App",
   "desc.enable": "Enable your ONES App",
   "desc.disable": "Disable your ONES App",
@@ -66,7 +76,14 @@ const en = {
   "error.store.permission": 'Permission denied, please check the file permission with "{filePath}"',
   "error.hostedToken.requestFailed": "Failed to request hosted token",
   "error.hostedToken.empty": "Hosted token is empty",
-  "error.legacy.create.missingProjectPath": "Project path is required"
+  "error.legacy.create.missingProjectPath": "Project path is required",
+  "error.specs.fetch.incorrectBaseURL": "Incorrect specs base URL",
+  "error.specs.fetch.fetchChecksumFailed": 'Failed to fetch checksum file from "{url}"',
+  "error.specs.fetch.incorrectChecksum": 'Invalid checksum content. Please provide a correct base URL that serves "ones-app-specs.sha256" in format "<sha256>  <zip-file>". Received: "{preview}"',
+  "error.specs.fetch.downloadFailed": 'Failed to download specs archive from "{url}"',
+  "error.specs.fetch.extractFailed": 'Failed to extract archive "{file}": {reason}',
+  "error.specs.fetch.cleanupFailed": 'Failed to cleanup archive "{file}": {reason}',
+  "error.specs.fetch.verifyChecksumFailed": 'SHA256 verification failed, expected "{expected}" but got "{actual}"'
 };
 const map = {
   en
@@ -113,6 +130,10 @@ var ErrorCode = ((ErrorCode2) => {
   ErrorCode2["HOSTED_TOKEN_EMPTY"] = "E14";
   ErrorCode2["INCORRECT_DEV_COMMAND"] = "E15";
   ErrorCode2["INCORRECT_BUILD_COMMAND"] = "E16";
+  ErrorCode2["INCORRECT_SPECS_BASE_URL"] = "E17";
+  ErrorCode2["INCORRECT_SPECS_CHECKSUM"] = "E18";
+  ErrorCode2["SPECS_FETCH_FAILED"] = "E19";
+  ErrorCode2["SPECS_CHECKSUM_MISMATCH"] = "E20";
   return ErrorCode2;
 })(ErrorCode || {});
 const getPackageJSONPath = () => {
@@ -229,7 +250,7 @@ const getAppRcJSON = async () => {
 };
 const isOPKXFilename = /\.opkx$/;
 const defaultOutputPath = "";
-const normalize$b = async (options) => {
+const normalize$c = async (options) => {
   var _options$output, _options$command;
   let output = node_path.resolve(process$1.cwd(), (_options$output = options.output) !== null && _options$output !== void 0 ? _options$output : defaultOutputPath);
   const command = (_options$command = options.command) !== null && _options$command !== void 0 ? _options$command : "";
@@ -248,7 +269,7 @@ const normalize$b = async (options) => {
 };
 const {
   existsSync,
-  ensureDirSync
+  ensureDirSync: ensureDirSync$1
 } = fse;
 const build = async function() {
   var _appRcJSON$dev, _defaultAppRcJSON$dev, _appRcJSON$build$comm, _appRcJSON$build, _currentCommand$, _appRcJSON$build$comp, _appRcJSON$build2;
@@ -258,7 +279,7 @@ const build = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, buildCommandArguments);
-  const normalizedOptions = await normalize$b(options);
+  const normalizedOptions = await normalize$c(options);
   const appManifestJSON = getAppManifestJSON();
   const appRcJSON = await getAppRcJSON();
   const correctCommand = normalizedOptions.command || ((_appRcJSON$dev = appRcJSON.dev) === null || _appRcJSON$dev === void 0 || (_appRcJSON$dev = _appRcJSON$dev.command) === null || _appRcJSON$dev === void 0 ? void 0 : _appRcJSON$dev[0]) || ((_defaultAppRcJSON$dev = defaultAppRcJSON.dev) === null || _defaultAppRcJSON$dev === void 0 || (_defaultAppRcJSON$dev = _defaultAppRcJSON$dev.command) === null || _defaultAppRcJSON$dev === void 0 ? void 0 : _defaultAppRcJSON$dev[0]) || "";
@@ -306,7 +327,7 @@ const build = async function() {
   const outputPath = normalizedOptions.output;
   const outputDir = node_path.dirname(outputPath);
   const outputFilename = node_path.basename(outputPath);
-  ensureDirSync(outputDir);
+  ensureDirSync$1(outputDir);
   const outputStream = node_fs.createWriteStream(outputPath);
   const files = (_appRcJSON$build$comp = (_appRcJSON$build2 = appRcJSON.build) === null || _appRcJSON$build2 === void 0 || (_appRcJSON$build2 = _appRcJSON$build2.compress) === null || _appRcJSON$build2 === void 0 ? void 0 : _appRcJSON$build2.files) !== null && _appRcJSON$build$comp !== void 0 ? _appRcJSON$build$comp : [];
   const archive = archiver("zip", {
@@ -821,7 +842,7 @@ const resolveAppInfo = (input) => {
   process.exit(1);
 };
 const isPortNumber = /^[1-9]\d{0,4}$/;
-const normalize$a = async (options) => {
+const normalize$b = async (options) => {
   var _options$clearStorage;
   const portInput = options.port;
   if (portInput)
@@ -1185,7 +1206,7 @@ const tunnel = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, tunnelCommandArguments);
-  const normalizedOptions = await normalize$a(options);
+  const normalizedOptions = await normalize$b(options);
   const port = Number(normalizedOptions.port);
   const cancelWaiting = startWaiting();
   await invokeTunnel(port, {
@@ -1197,7 +1218,7 @@ const tunnel = async function() {
   const tunnelUrl = await buildTunnelUrl();
   console.log(`Relay endpoint: ${tunnelUrl}`);
 };
-const normalize$9 = async (options) => {
+const normalize$a = async (options) => {
   var _options$appID;
   lodashEs.noop(options);
   return {
@@ -1280,7 +1301,7 @@ const install = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, installCommandArguments);
-  const normalizedOptions = await normalize$9(options);
+  const normalizedOptions = await normalize$a(options);
   lodashEs.noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1307,7 +1328,7 @@ var DevCommandScripts = /* @__PURE__ */ ((DevCommandScripts2) => {
   return DevCommandScripts2;
 })(DevCommandScripts || {});
 const defaultInstall = InstallOptions.AUTO;
-const normalize$8 = async (options) => {
+const normalize$9 = async (options) => {
   var _options$install, _options$command, _options$clearStorage;
   let install2 = (_options$install = options.install) !== null && _options$install !== void 0 ? _options$install : defaultInstall;
   const command = (_options$command = options.command) !== null && _options$command !== void 0 ? _options$command : "";
@@ -1378,7 +1399,7 @@ const dev = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, devCommandArguments);
-  const normalizedOptions = await normalize$8(options);
+  const normalizedOptions = await normalize$9(options);
   const appRcJSON = await getAppRcJSON();
   const correctCommand = normalizedOptions.command || ((_appRcJSON$dev = appRcJSON.dev) === null || _appRcJSON$dev === void 0 || (_appRcJSON$dev = _appRcJSON$dev.command) === null || _appRcJSON$dev === void 0 ? void 0 : _appRcJSON$dev[0]) || ((_defaultAppRcJSON$dev = defaultAppRcJSON.dev) === null || _defaultAppRcJSON$dev === void 0 || (_defaultAppRcJSON$dev = _defaultAppRcJSON$dev.command) === null || _defaultAppRcJSON$dev === void 0 ? void 0 : _defaultAppRcJSON$dev[0]) || "";
   if (!correctCommand) {
@@ -1604,7 +1625,7 @@ const sleep = (number) => {
 };
 const isURL = /^https?:\/\//;
 const HostBlackList = ["ones.cn", "www.ones.cn", "ones.com", "www.ones.com"];
-const normalize$7 = async (options) => {
+const normalize$8 = async (options) => {
   const baseURLInput = options.baseURL;
   if (baseURLInput)
     ;
@@ -1642,7 +1663,7 @@ const login = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, loginCommandArguments);
-  const normalizedOptions = await normalize$7(options);
+  const normalizedOptions = await normalize$8(options);
   const {
     code_verifier,
     code_challenge
@@ -1795,7 +1816,7 @@ const login = async function() {
     return createOnesApp.throwError(ErrorCode.INCORRECT_BASE_URL, i18n.t("error.login.incorrectBaseURL"));
   }
 };
-const normalize$6 = async (options) => {
+const normalize$7 = async (options) => {
   lodashEs.noop(options);
   return {};
 };
@@ -1806,12 +1827,12 @@ const logout = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, logoutCommandArguments);
-  const normalizedOptions = await normalize$6(options);
+  const normalizedOptions = await normalize$7(options);
   lodashEs.noop(normalizedOptions);
   await setStore({});
   console.log("Logged out successfully!");
 };
-const normalize$5 = async (options) => {
+const normalize$6 = async (options) => {
   lodashEs.noop(options);
   return {};
 };
@@ -1823,7 +1844,7 @@ const whoami = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, whoamiCommandArguments);
-  const normalizedOptions = await normalize$5(options);
+  const normalizedOptions = await normalize$6(options);
   lodashEs.noop(normalizedOptions);
   const baseURL = await getBaseURL();
   const cancelWaiting = startWaiting();
@@ -1839,7 +1860,7 @@ const whoami = async function() {
     consoleUnauthorizedMessage();
   }
 };
-const normalize$4 = async (options) => {
+const normalize$5 = async (options) => {
   var _options$appID;
   lodashEs.noop(options);
   return {
@@ -1853,7 +1874,7 @@ const enable = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, enableCommandArguments);
-  const normalizedOptions = await normalize$4(options);
+  const normalizedOptions = await normalize$5(options);
   lodashEs.noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1869,7 +1890,7 @@ const enable = async function() {
     console.error(JSON.stringify(result, null, 2));
   }
 };
-const normalize$3 = async (options) => {
+const normalize$4 = async (options) => {
   var _options$appID;
   lodashEs.noop(options);
   return {
@@ -1883,7 +1904,7 @@ const disable = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, disableCommandArguments);
-  const normalizedOptions = await normalize$3(options);
+  const normalizedOptions = await normalize$4(options);
   lodashEs.noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1899,7 +1920,7 @@ const disable = async function() {
     console.error(JSON.stringify(result, null, 2));
   }
 };
-const normalize$2 = async (options) => {
+const normalize$3 = async (options) => {
   var _options$appID;
   lodashEs.noop(options);
   return {
@@ -1913,7 +1934,7 @@ const uninstall = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, uninstallCommandArguments);
-  const normalizedOptions = await normalize$2(options);
+  const normalizedOptions = await normalize$3(options);
   lodashEs.noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1930,7 +1951,7 @@ const uninstall = async function() {
   }
 };
 const defaultTail = 100;
-const normalize$1 = async (options) => {
+const normalize$2 = async (options) => {
   var _options$appID, _options$fromOpkxJson, _options$tail;
   const appID = (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : "";
   const fromOpkxJSON = (_options$fromOpkxJson = options.fromOpkxJson) !== null && _options$fromOpkxJson !== void 0 ? _options$fromOpkxJson : false;
@@ -1978,7 +1999,7 @@ const logs = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, logsCommandArguments);
-  const normalizedOptions = await normalize$1(options);
+  const normalizedOptions = await normalize$2(options);
   const {
     appID,
     tail
@@ -2012,7 +2033,7 @@ const getTemplatePath = () => {
 const getTemplateLegacy = () => {
   return "legacy";
 };
-const normalize = async (options) => {
+const normalize$1 = async (options) => {
   const projectPathInput = options.projectPath;
   if (projectPathInput)
     ;
@@ -2035,7 +2056,7 @@ const legacy = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, legacyCommandArguments);
-  const normalizedOptions = await normalize(options);
+  const normalizedOptions = await normalize$1(options);
   const {
     projectPath
   } = normalizedOptions;
@@ -2050,6 +2071,274 @@ const legacy = async function() {
   });
   console.log("Plugin created successfully!");
 };
+const defaultBaseURL = "https://open.ones.cn/";
+const defaultDir = "~/.ones/ones-app-specs";
+const expandHomeDirectory = (dir) => {
+  if (dir === "~") {
+    return node_os.homedir();
+  }
+  if (dir.startsWith("~/")) {
+    return node_path.resolve(node_os.homedir(), dir.slice(2));
+  }
+  return dir;
+};
+const normalizeBaseURL = (baseURLInput) => {
+  let url;
+  try {
+    url = new URL(baseURLInput);
+  } catch (error) {
+    return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_BASE_URL, i18n.t("error.specs.fetch.incorrectBaseURL"));
+  }
+  if (url.protocol === "http:" || url.protocol === "https:")
+    ;
+  else {
+    return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_BASE_URL, i18n.t("error.specs.fetch.incorrectBaseURL"));
+  }
+  url.search = "";
+  url.hash = "";
+  if (!url.pathname.endsWith("/")) {
+    url.pathname = `${url.pathname}/`;
+  }
+  return url.toString();
+};
+const normalize = async (options) => {
+  var _options$baseUrl, _options$extract, _context, _options$json, _options$force;
+  const baseUrl = normalizeBaseURL((_options$baseUrl = options.baseUrl) !== null && _options$baseUrl !== void 0 ? _options$baseUrl : defaultBaseURL);
+  const dir = options.dir ? node_path.resolve(process$1.cwd(), expandHomeDirectory(options.dir), ".ones", "ones-app-specs") : node_path.resolve(process$1.cwd(), expandHomeDirectory(defaultDir));
+  const extractString = `${(_options$extract = options.extract) !== null && _options$extract !== void 0 ? _options$extract : "true"}`.toLowerCase();
+  const extract = _includesInstanceProperty(_context = ["false", "0", "no"]).call(_context, extractString) ? false : true;
+  const json = (_options$json = options.json) !== null && _options$json !== void 0 ? _options$json : false;
+  const force = (_options$force = options.force) !== null && _options$force !== void 0 ? _options$force : false;
+  return {
+    baseUrl,
+    dir,
+    extract,
+    json,
+    force
+  };
+};
+const {
+  ensureDirSync,
+  writeFile,
+  remove,
+  pathExists,
+  readFile
+} = fse;
+const CHECKSUM_FILENAME = "ones-app-specs.sha256";
+const DEFAULT_ARCHIVE_FILENAME = "ones-app-specs.zip";
+const DOWNLOAD_TIMEOUT = 6e4;
+const getShellSafePath = (value) => {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+};
+const getExtractErrorOutput = (result) => {
+  var _result$error;
+  const output = [result.stderr, result.stdout].map((item) => typeof item === "string" ? item.trim() : "").filter(Boolean).join("\n");
+  if ((_result$error = result.error) !== null && _result$error !== void 0 && _result$error.message) {
+    return result.error.message;
+  }
+  return output || "unknown error";
+};
+const extractArchive = (archivePath, dir) => {
+  if (process.platform === "win32") {
+    const powershellEscape = (value) => value.replace(/'/g, "''");
+    const command = `Expand-Archive -LiteralPath '${powershellEscape(archivePath)}' -DestinationPath '${powershellEscape(dir)}' -Force`;
+    const result2 = node_child_process.spawnSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", command], {
+      encoding: "utf8"
+    });
+    if (result2.status === 0 && !result2.error) {
+      return;
+    }
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.extractFailed", {
+      file: archivePath,
+      reason: getExtractErrorOutput(result2)
+    }));
+  }
+  const result = node_child_process.spawnSync("unzip", ["-oq", archivePath, "-d", dir], {
+    encoding: "utf8"
+  });
+  if (result.status === 0 && !result.error) {
+    return;
+  }
+  return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.extractFailed", {
+    file: archivePath,
+    reason: getExtractErrorOutput(result)
+  }));
+};
+const parseChecksumValue = (text) => {
+  var _match$;
+  const firstLine = text.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+  if (!firstLine) {
+    return null;
+  }
+  const match = firstLine.match(/^([a-fA-F0-9]{64})(?:\s+\*?(.+))?$/);
+  if (!match) {
+    return null;
+  }
+  const checksum = match[1].toLowerCase();
+  const archiveFilenameInput = ((_match$ = match[2]) !== null && _match$ !== void 0 ? _match$ : DEFAULT_ARCHIVE_FILENAME).trim();
+  const archiveFilename = node_path.basename(archiveFilenameInput);
+  if (!archiveFilename || archiveFilename !== archiveFilenameInput) {
+    return null;
+  }
+  return {
+    checksum,
+    archiveFilename
+  };
+};
+const parseChecksum = (text) => {
+  var _text$split$find$trim, _text$split$find;
+  const parsed = parseChecksumValue(text);
+  if (parsed) {
+    return parsed;
+  }
+  const firstLine = (_text$split$find$trim = (_text$split$find = text.split(/\r?\n/).find(Boolean)) === null || _text$split$find === void 0 ? void 0 : _text$split$find.trim()) !== null && _text$split$find$trim !== void 0 ? _text$split$find$trim : "";
+  const preview = firstLine.slice(0, 120) || "<empty>";
+  return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_CHECKSUM, i18n.t("error.specs.fetch.incorrectChecksum", {
+    preview
+  }));
+};
+const getSHA256 = async (filePath) => {
+  const hash = node_crypto.createHash("sha256");
+  const stream = node_fs.createReadStream(filePath);
+  for await (const chunk of stream) {
+    hash.update(chunk);
+  }
+  return hash.digest("hex");
+};
+const specsFetch = async function() {
+  for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+    args[_key] = arguments[_key];
+  }
+  const {
+    options
+  } = createOnesApp.getCommandOptions(args, specsFetchCommandArguments);
+  const normalizedOptions = await normalize(options);
+  const baseURL = normalizedOptions.baseUrl;
+  const dir = normalizedOptions.dir;
+  const onesDir = node_path.dirname(dir);
+  const shouldExtract = normalizedOptions.extract;
+  const useJSONOutput = normalizedOptions.json;
+  const forceFetch = normalizedOptions.force;
+  ensureDirSync(dir);
+  const checksumURL = new URL(CHECKSUM_FILENAME, baseURL).toString();
+  const checksumText = await axios.get(checksumURL, {
+    responseType: "text",
+    timeout: REQUEST_TIMEOUT
+  }).then((response2) => {
+    var _response2$data;
+    return `${(_response2$data = response2.data) !== null && _response2$data !== void 0 ? _response2$data : ""}`;
+  }).catch(() => {
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.fetchChecksumFailed", {
+      url: checksumURL
+    }));
+  });
+  const parsedChecksum = parseChecksum(checksumText);
+  const archiveURL = new URL(parsedChecksum.archiveFilename, baseURL).toString();
+  const archivePath = node_path.join(dir, parsedChecksum.archiveFilename);
+  const checksumPath = node_path.join(dir, CHECKSUM_FILENAME);
+  const localChecksum = await pathExists(checksumPath).then(async (exists) => {
+    if (!exists) {
+      return null;
+    }
+    const content = await readFile(checksumPath, "utf8");
+    return parseChecksumValue(content);
+  }).catch(() => null);
+  if (!forceFetch && (localChecksum === null || localChecksum === void 0 ? void 0 : localChecksum.checksum) === parsedChecksum.checksum) {
+    if (useJSONOutput) {
+      console.log(JSON.stringify({
+        status: "up_to_date",
+        base_url: baseURL,
+        download_dir: dir,
+        specs_dir: dir,
+        checksum_url: checksumURL,
+        sha256: parsedChecksum.checksum,
+        force: false,
+        message: "Local ones-app-specs is already up to date."
+      }, null, 2));
+      return;
+    }
+    console.log("Local ones-app-specs is already up to date.");
+    console.log(`SHA256: ${parsedChecksum.checksum}`);
+    console.log(`Specs directory: ${dir}`);
+    return;
+  }
+  const response = await axios({
+    url: archiveURL,
+    method: "GET",
+    responseType: "stream",
+    timeout: DOWNLOAD_TIMEOUT
+  }).catch(() => {
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.downloadFailed", {
+      url: archiveURL
+    }));
+  });
+  await promises.pipeline(response.data, node_fs.createWriteStream(archivePath)).catch(async () => {
+    await remove(archivePath).catch(() => void 0);
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.downloadFailed", {
+      url: archiveURL
+    }));
+  });
+  const actualChecksum = await getSHA256(archivePath);
+  if (actualChecksum === parsedChecksum.checksum)
+    ;
+  else {
+    await remove(archivePath).catch(() => void 0);
+    return createOnesApp.throwError(ErrorCode.SPECS_CHECKSUM_MISMATCH, i18n.t("error.specs.fetch.verifyChecksumFailed", {
+      expected: parsedChecksum.checksum,
+      actual: actualChecksum
+    }));
+  }
+  const verifyCommand = `sha256sum -c ${getShellSafePath(checksumPath)}`;
+  if (shouldExtract) {
+    try {
+      ensureDirSync(onesDir);
+      extractArchive(archivePath, onesDir);
+      await writeFile(checksumPath, `${parsedChecksum.checksum}  ${parsedChecksum.archiveFilename}
+`, "utf8");
+      await remove(archivePath).catch(() => void 0);
+    } catch (error) {
+      return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.cleanupFailed", {
+        file: archivePath,
+        reason: `${error}`
+      }));
+    }
+  } else {
+    await writeFile(checksumPath, `${parsedChecksum.checksum}  ${parsedChecksum.archiveFilename}
+`, "utf8");
+  }
+  if (useJSONOutput) {
+    console.log(JSON.stringify({
+      status: "success",
+      base_url: baseURL,
+      download_dir: dir,
+      specs_dir: dir,
+      checksum_url: checksumURL,
+      archive_url: archiveURL,
+      archive_path: archivePath,
+      checksum_path: checksumPath,
+      sha256: actualChecksum,
+      force: forceFetch,
+      extract: shouldExtract,
+      archive_removed: shouldExtract,
+      verify_command: shouldExtract ? null : verifyCommand
+    }, null, 2));
+    return;
+  }
+  console.log("ONES specs fetched successfully!");
+  console.log(`SHA256: ${actualChecksum}`);
+  console.log(`Specs directory: ${dir}`);
+  console.log(`Base URL: ${baseURL}`);
+  console.log(`Checksum URL: ${checksumURL}`);
+  console.log(`Archive URL: ${archiveURL}`);
+  console.log(`Archive path: ${archivePath}`);
+  if (shouldExtract) {
+    console.log("Archive extracted successfully!");
+    console.log("Archive cleanup: enabled (source zip removed)");
+  } else {
+    console.log("Archive extraction: skipped");
+    console.log(`Verify command: ${verifyCommand}`);
+  }
+};
 const buildCommandArguments = [];
 const $build = new commander.Command("build").description(i18n.t("desc.build")).option("-o, --output [file-path]", i18n.t("desc.build.output")).option("-c, --command [string]", i18n.t("desc.build.command")).action(build);
 createOnesApp.addCommandUsage($build);
@@ -2098,6 +2387,16 @@ const $app = new commander.Command("app").description(i18n.t("desc.app"));
 $app.addCommand($install).addCommand($enable).addCommand($disable).addCommand($uninstall).addCommand($logs);
 createOnesApp.addCommandUsage($app);
 createOnesApp.addCommandOutput($app);
+const specsFetchCommandArguments = [];
+const $fetch = new commander.Command("fetch").description(i18n.t("desc.specs.fetch")).option("-u, --base-url <url>", i18n.t("desc.specs.fetch.baseUrl")).option("-d, --dir <directory>", i18n.t("desc.specs.fetch.dir")).option("--no-extract", i18n.t("desc.specs.fetch.noExtract")).option("--json", i18n.t("desc.specs.fetch.json")).option("--force", i18n.t("desc.specs.fetch.force")).action(specsFetch);
+$fetch.addHelpText("after", ["", "Examples:", "  ones specs fetch", "  ones specs fetch --json", "  ones specs fetch --no-extract", "  ones specs fetch --force", "  ones specs fetch --base-url http://open-preview.myones.net/ --dir /path/to/project"].join("\n"));
+createOnesApp.addCommandUsage($fetch);
+createOnesApp.addCommandOutput($fetch);
+const $specs = new commander.Command("specs").description(i18n.t("desc.specs"));
+$specs.addCommand($fetch);
+$specs.addHelpText("after", ["", "Examples:", "  ones specs fetch", "  ones specs fetch --json", "  ones specs fetch --no-extract", "  ones specs fetch --force", "  ones specs fetch --base-url https://docs.ones.com/developer/ --dir /path/to/project"].join("\n"));
+createOnesApp.addCommandUsage($specs);
+createOnesApp.addCommandOutput($specs);
 const legacyCommandArguments = ["projectPath"];
 const $create = new commander.Command("create").description(i18n.t("desc.legacy.create")).argument("<project-path>", i18n.t("desc.legacy.create.projectPath")).action(legacy);
 createOnesApp.addCommandUsage($create);
@@ -2111,7 +2410,7 @@ const version = `${getPackageJSON().version}`;
 const env = `${version} Node/${process.version}`;
 ones.description(i18n.t("desc.ones", {
   env
-})).addCommand(createOnesApp.$create).addCommand($build).addCommand($dev).addCommand($tunnel).addCommand($app).addCommand($login).addCommand($logout).addCommand($whoami).addCommand($legacy).configureHelp({
+})).addCommand(createOnesApp.$create).addCommand($build).addCommand($dev).addCommand($tunnel).addCommand($app).addCommand($login).addCommand($logout).addCommand($whoami).addCommand($specs).addCommand($legacy).configureHelp({
   visibleCommands: (cmd) => {
     const blackList = ["legacy"];
     return cmd.commands.filter((command) => !_includesInstanceProperty(blackList).call(blackList, command.name()));