@ones-open/cli 0.0.12-21205.1 → 0.0.12

package/dist/index.js

@@ -3,7 +3,7 @@ import { Command } from "commander";
 import { ErrorCode as ErrorCode$1, AppPackageJSONSchema, throwError, AppManifestJSONSchema, getPublicPath, PUBLIC_FILENAME, AppRcJSONSchema, AppManifestStrictJSONSchema, getCommandOptions, HostedTokenScope, addCommandUsage, addCommandOutput, $create as $create$1, setContext } from "create-ones-app";
 import { dirname, join, resolve, basename } from "node:path";
 import { spawnSync, spawn } from "node:child_process";
-import { readFileSync, createWriteStream } from "node:fs";
+import { readFileSync, createWriteStream, createReadStream } from "node:fs";
 import fse from "fs-extra";
 import archiver from "archiver";
 import { get, merge, random, noop } from "lodash-es";
@@ -22,6 +22,9 @@ import http from "node:http";
 import open from "open";
 import { v4 } from "uuid";
 import PKCEChallenge from "pkce-challenge";
+import { createHash } from "node:crypto";
+import { pipeline } from "node:stream/promises";
+import { homedir } from "node:os";
 const en = {
   "desc.ones": "ONES CLI/{env}",
   "desc.build": "Build your ONES App",
@@ -38,6 +41,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",
@@ -63,7 +73,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
@@ -110,6 +127,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 = () => {
@@ -226,7 +247,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 = resolve(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 : "";
@@ -245,7 +266,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;
@@ -255,7 +276,7 @@ const build = async function() {
   const {
     options
   } = 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]) || "";
@@ -303,7 +324,7 @@ const build = async function() {
   const outputPath = normalizedOptions.output;
   const outputDir = dirname(outputPath);
   const outputFilename = basename(outputPath);
-  ensureDirSync(outputDir);
+  ensureDirSync$1(outputDir);
   const outputStream = 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", {
@@ -818,7 +839,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)
@@ -1182,7 +1203,7 @@ const tunnel = async function() {
   const {
     options
   } = 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, {
@@ -1194,7 +1215,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;
   noop(options);
   return {
@@ -1277,7 +1298,7 @@ const install = async function() {
   const {
     options
   } = getCommandOptions(args, installCommandArguments);
-  const normalizedOptions = await normalize$9(options);
+  const normalizedOptions = await normalize$a(options);
   noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1304,7 +1325,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 : "";
@@ -1375,7 +1396,7 @@ const dev = async function() {
   const {
     options
   } = 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) {
@@ -1601,7 +1622,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)
     ;
@@ -1639,7 +1660,7 @@ const login = async function() {
   const {
     options
   } = getCommandOptions(args, loginCommandArguments);
-  const normalizedOptions = await normalize$7(options);
+  const normalizedOptions = await normalize$8(options);
   const {
     code_verifier,
     code_challenge
@@ -1792,7 +1813,7 @@ const login = async function() {
     return throwError(ErrorCode.INCORRECT_BASE_URL, i18n.t("error.login.incorrectBaseURL"));
   }
 };
-const normalize$6 = async (options) => {
+const normalize$7 = async (options) => {
   noop(options);
   return {};
 };
@@ -1803,12 +1824,12 @@ const logout = async function() {
   const {
     options
   } = getCommandOptions(args, logoutCommandArguments);
-  const normalizedOptions = await normalize$6(options);
+  const normalizedOptions = await normalize$7(options);
   noop(normalizedOptions);
   await setStore({});
   console.log("Logged out successfully!");
 };
-const normalize$5 = async (options) => {
+const normalize$6 = async (options) => {
   noop(options);
   return {};
 };
@@ -1820,7 +1841,7 @@ const whoami = async function() {
   const {
     options
   } = getCommandOptions(args, whoamiCommandArguments);
-  const normalizedOptions = await normalize$5(options);
+  const normalizedOptions = await normalize$6(options);
   noop(normalizedOptions);
   const baseURL = await getBaseURL();
   const cancelWaiting = startWaiting();
@@ -1836,7 +1857,7 @@ const whoami = async function() {
     consoleUnauthorizedMessage();
   }
 };
-const normalize$4 = async (options) => {
+const normalize$5 = async (options) => {
   var _options$appID;
   noop(options);
   return {
@@ -1850,7 +1871,7 @@ const enable = async function() {
   const {
     options
   } = getCommandOptions(args, enableCommandArguments);
-  const normalizedOptions = await normalize$4(options);
+  const normalizedOptions = await normalize$5(options);
   noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1866,7 +1887,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;
   noop(options);
   return {
@@ -1880,7 +1901,7 @@ const disable = async function() {
   const {
     options
   } = getCommandOptions(args, disableCommandArguments);
-  const normalizedOptions = await normalize$3(options);
+  const normalizedOptions = await normalize$4(options);
   noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1896,7 +1917,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;
   noop(options);
   return {
@@ -1910,7 +1931,7 @@ const uninstall = async function() {
   const {
     options
   } = getCommandOptions(args, uninstallCommandArguments);
-  const normalizedOptions = await normalize$2(options);
+  const normalizedOptions = await normalize$3(options);
   noop(normalizedOptions);
   const appInfo = resolveAppInfo({
     appID: options.appID
@@ -1927,7 +1948,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;
@@ -1975,7 +1996,7 @@ const logs = async function() {
   const {
     options
   } = getCommandOptions(args, logsCommandArguments);
-  const normalizedOptions = await normalize$1(options);
+  const normalizedOptions = await normalize$2(options);
   const {
     appID,
     tail
@@ -2009,7 +2030,7 @@ const getTemplatePath = () => {
 const getTemplateLegacy = () => {
   return "legacy";
 };
-const normalize = async (options) => {
+const normalize$1 = async (options) => {
   const projectPathInput = options.projectPath;
   if (projectPathInput)
     ;
@@ -2032,7 +2053,7 @@ const legacy = async function() {
   const {
     options
   } = getCommandOptions(args, legacyCommandArguments);
-  const normalizedOptions = await normalize(options);
+  const normalizedOptions = await normalize$1(options);
   const {
     projectPath
   } = normalizedOptions;
@@ -2047,6 +2068,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 homedir();
+  }
+  if (dir.startsWith("~/")) {
+    return resolve(homedir(), dir.slice(2));
+  }
+  return dir;
+};
+const normalizeBaseURL = (baseURLInput) => {
+  let url;
+  try {
+    url = new URL(baseURLInput);
+  } catch (error) {
+    return throwError(ErrorCode.INCORRECT_SPECS_BASE_URL, i18n.t("error.specs.fetch.incorrectBaseURL"));
+  }
+  if (url.protocol === "http:" || url.protocol === "https:")
+    ;
+  else {
+    return 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 ? resolve(cwd(), expandHomeDirectory(options.dir), ".ones", "ones-app-specs") : resolve(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 = spawnSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", command], {
+      encoding: "utf8"
+    });
+    if (result2.status === 0 && !result2.error) {
+      return;
+    }
+    return throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.extractFailed", {
+      file: archivePath,
+      reason: getExtractErrorOutput(result2)
+    }));
+  }
+  const result = spawnSync("unzip", ["-oq", archivePath, "-d", dir], {
+    encoding: "utf8"
+  });
+  if (result.status === 0 && !result.error) {
+    return;
+  }
+  return 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 = 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 throwError(ErrorCode.INCORRECT_SPECS_CHECKSUM, i18n.t("error.specs.fetch.incorrectChecksum", {
+    preview
+  }));
+};
+const getSHA256 = async (filePath) => {
+  const hash = createHash("sha256");
+  const stream = 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
+  } = getCommandOptions(args, specsFetchCommandArguments);
+  const normalizedOptions = await normalize(options);
+  const baseURL = normalizedOptions.baseUrl;
+  const dir = normalizedOptions.dir;
+  const onesDir = 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 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 = join(dir, parsedChecksum.archiveFilename);
+  const checksumPath = 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 throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.downloadFailed", {
+      url: archiveURL
+    }));
+  });
+  await pipeline(response.data, createWriteStream(archivePath)).catch(async () => {
+    await remove(archivePath).catch(() => void 0);
+    return 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 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 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 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);
 addCommandUsage($build);
@@ -2095,6 +2384,16 @@ const $app = new Command("app").description(i18n.t("desc.app"));
 $app.addCommand($install).addCommand($enable).addCommand($disable).addCommand($uninstall).addCommand($logs);
 addCommandUsage($app);
 addCommandOutput($app);
+const specsFetchCommandArguments = [];
+const $fetch = new 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"));
+addCommandUsage($fetch);
+addCommandOutput($fetch);
+const $specs = new 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"));
+addCommandUsage($specs);
+addCommandOutput($specs);
 const legacyCommandArguments = ["projectPath"];
 const $create = new Command("create").description(i18n.t("desc.legacy.create")).argument("<project-path>", i18n.t("desc.legacy.create.projectPath")).action(legacy);
 addCommandUsage($create);
@@ -2108,7 +2407,7 @@ const version = `${getPackageJSON().version}`;
 const env = `${version} Node/${process.version}`;
 ones.description(i18n.t("desc.ones", {
   env
-})).addCommand($create$1).addCommand($build).addCommand($dev).addCommand($tunnel).addCommand($app).addCommand($login).addCommand($logout).addCommand($whoami).addCommand($legacy).configureHelp({
+})).addCommand($create$1).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()));

package/dist/types/actions/index.d.ts

@@ -13,4 +13,5 @@ export * from './disable';
 export * from './uninstall';
 export * from './logs';
 export * from './legacy';
+export * from './specs-fetch';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA"}

package/dist/types/actions/specs-fetch/index.d.ts

@@ -0,0 +1,4 @@
+import type { CommandArguments } from '../../common/command';
+import type { SpecsFetchCommandOptions } from '../../command';
+export declare const specsFetch: (...args: CommandArguments<SpecsFetchCommandOptions>) => Promise<undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/actions/specs-fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/specs-fetch/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAA8B,wBAAwB,EAAE,MAAM,WAAW,CAAA;AA6GrF,eAAO,MAAM,UAAU,GAAU,GAAG,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,uBA6KnF,CAAA"}

package/dist/types/actions/specs-fetch/normalize.d.ts

@@ -0,0 +1,6 @@
+import type { CommandOptions } from '../../common/command';
+import type { SpecsFetchCommandArguments, SpecsFetchCommandOptions } from '../../command';
+type NormalizeOptions = CommandOptions<SpecsFetchCommandArguments, SpecsFetchCommandOptions>['options'];
+export declare const normalize: (options: NormalizeOptions) => Promise<Required<NormalizeOptions>>;
+export {};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/types/actions/specs-fetch/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/actions/specs-fetch/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAErF,KAAK,gBAAgB,GAAG,cAAc,CACpC,0BAA0B,EAC1B,wBAAwB,CACzB,CAAC,SAAS,CAAC,CAAA;AA4CZ,eAAO,MAAM,SAAS,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAiB7F,CAAA"}

package/dist/types/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,cAAc,qBAM1B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAuCA,eAAO,MAAM,cAAc,qBAM1B,CAAA"}

package/dist/types/command/index.d.ts

@@ -8,10 +8,12 @@ export * from './login';
 export * from './logout';
 export * from './whoami';
 export * from './app';
+export * from './specs';
 export * from './install';
 export * from './enable';
 export * from './disable';
 export * from './uninstall';
 export * from './logs';
 export * from './legacy';
+export * from './specs-fetch';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/command/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/command/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/command/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA"}

package/dist/types/command/specs/index.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const $specs: Command;
+export { $specs };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/command/specs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/command/specs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,QAAA,MAAM,MAAM,SAAyD,CAAA;AAmBrE,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/types/command/specs-fetch/index.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+export declare const specsFetchCommandArguments: readonly [];
+export type SpecsFetchCommandArguments = typeof specsFetchCommandArguments;
+export interface SpecsFetchCommandOptions {
+    baseUrl?: string;
+    dir?: string;
+    extract?: boolean;
+    json?: boolean;
+    force?: boolean;
+}
+declare const $fetch: Command;
+export { $fetch };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/command/specs-fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/command/specs-fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,eAAO,MAAM,0BAA0B,aAAc,CAAA;AAErD,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAA;AAE1E,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,QAAA,MAAM,MAAM,SAOS,CAAA;AAiBrB,OAAO,EAAE,MAAM,EAAE,CAAA"}