@devbie/apits 0.0.0-stage → 1.0.1

package/dist/esm/core/cli.mjs

@@ -0,0 +1,713 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _templateObject;
+function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
+function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct.bind(); } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _isNativeFunction(fn) { try { return Function.toString.call(fn).indexOf("[native code]") !== -1; } catch (e) { return typeof fn === "function"; } }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+import { register } from "tsx/cjs/api";
+import fs from "fs-extra";
+import path from "path";
+import prompt from "prompts";
+import yargs from "yargs";
+import { dedent } from "../utils/vtilsLite.mjs";
+import { Generator } from "./generator.mjs";
+import chalk from "chalk";
+import * as conso from "../utils/console.mjs";
+import { formatContent } from "../utils/utils.mjs";
+import { spinnerInstance } from "../utils/spinner.mjs";
+import { asyncFnArrayOrderRun, defineConfig } from "../utils/helpers.mjs";
+
+// Register the tsx loader so apits.config.ts / apits.config.local.ts can be
+// required at runtime. tsx transpiles via esbuild (no type-checking) and
+// reads tsconfig.json automatically, so no compilerOptions are needed here.
+register();
+
+/** Flags accepted by the `gen` command. */
+
+// Config file candidates in priority order; the first match wins.
+var CONFIG_FILE_CANDIDATES = ["apits.config.local.ts", "apits.config.ts", "apits.config.local.json", "apits.config.json"];
+/** Raised when neither a CLI input nor a config file can be found. */
+var NoInputError = /*#__PURE__*/function (_Error) {
+  _inherits(NoInputError, _Error);
+  var _super = _createSuper(NoInputError);
+  function NoInputError() {
+    _classCallCheck(this, NoInputError);
+    return _super.apply(this, arguments);
+  }
+  return _createClass(NoInputError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+function isHttpInput(input) {
+  return /^https?:\/\//i.test(input);
+}
+
+/** Normalize a single config or an array into a config array. */
+function normalizeConfig(raw) {
+  return defineConfig(Array.isArray(raw) ? raw : [raw]);
+}
+
+/**
+ * Discover the optional config file. Supports TS/JSON config files and the
+ * `apits` field inside package.json. Returns undefined when nothing exists.
+ */
+function discoverConfigFile() {
+  return _discoverConfigFile.apply(this, arguments);
+}
+/** Load configs from a discovered file. */
+function _discoverConfigFile() {
+  _discoverConfigFile = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
+    var cwd,
+      _iterator,
+      _step,
+      fileName,
+      filePath,
+      packageJsonPath,
+      pkg,
+      _args5 = arguments;
+    return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          cwd = _args5.length > 0 && _args5[0] !== undefined ? _args5[0] : process.cwd();
+          _iterator = _createForOfIteratorHelper(CONFIG_FILE_CANDIDATES);
+          _context5.prev = 2;
+          _iterator.s();
+        case 4:
+          if ((_step = _iterator.n()).done) {
+            _context5.next = 13;
+            break;
+          }
+          fileName = _step.value;
+          filePath = path.join(cwd, fileName);
+          _context5.next = 9;
+          return fs.pathExists(filePath);
+        case 9:
+          if (!_context5.sent) {
+            _context5.next = 11;
+            break;
+          }
+          return _context5.abrupt("return", {
+            filePath: filePath,
+            kind: fileName.endsWith(".json") ? "json" : "ts"
+          });
+        case 11:
+          _context5.next = 4;
+          break;
+        case 13:
+          _context5.next = 18;
+          break;
+        case 15:
+          _context5.prev = 15;
+          _context5.t0 = _context5["catch"](2);
+          _iterator.e(_context5.t0);
+        case 18:
+          _context5.prev = 18;
+          _iterator.f();
+          return _context5.finish(18);
+        case 21:
+          packageJsonPath = path.join(cwd, "package.json");
+          _context5.next = 24;
+          return fs.pathExists(packageJsonPath);
+        case 24:
+          if (!_context5.sent) {
+            _context5.next = 37;
+            break;
+          }
+          _context5.prev = 25;
+          _context5.t1 = JSON;
+          _context5.next = 29;
+          return fs.readFile(packageJsonPath, "utf-8");
+        case 29:
+          _context5.t2 = _context5.sent;
+          pkg = _context5.t1.parse.call(_context5.t1, _context5.t2);
+          if (!pkg.apits) {
+            _context5.next = 33;
+            break;
+          }
+          return _context5.abrupt("return", {
+            filePath: packageJsonPath,
+            kind: "package"
+          });
+        case 33:
+          _context5.next = 37;
+          break;
+        case 35:
+          _context5.prev = 35;
+          _context5.t3 = _context5["catch"](25);
+        case 37:
+          return _context5.abrupt("return", undefined);
+        case 38:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5, null, [[2, 15, 18, 21], [25, 35]]);
+  }));
+  return _discoverConfigFile.apply(this, arguments);
+}
+function loadConfigFile(discovered) {
+  var filePath = discovered.filePath,
+    kind = discovered.kind;
+  if (kind === "ts") {
+    var _mod$default;
+    // tsx is registered at module load time.
+    var mod = require(filePath);
+    return normalizeConfig((_mod$default = mod.default) !== null && _mod$default !== void 0 ? _mod$default : mod);
+  }
+  if (kind === "json") {
+    return normalizeConfig(JSON.parse(fs.readFileSync(filePath, "utf-8")));
+  }
+  var pkg = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  return normalizeConfig(pkg.apits);
+}
+
+/** Build a single ad-hoc config from CLI flags (no config file needed). */
+function buildCliConfig(flags) {
+  var _flags$client;
+  var config = {
+    input: flags.input,
+    output: flags.output || "src/api"
+  };
+  if (flags.name) {
+    config.name = flags.name;
+  }
+  if (flags.baseUrl !== undefined) {
+    config.baseURL = flags.baseUrl;
+  }
+  // CLI mode has no custom import template, so the scaffolded client is on
+  // unless `--no-client` was passed. Defaults to true when unspecified.
+  config.client = (_flags$client = flags.client) !== null && _flags$client !== void 0 ? _flags$client : true;
+  return defineConfig(config)[0];
+}
+
+/**
+ * Ensure every config has a name. Explicit names win; missing names are
+ * derived from the input. A duplicated derived name gets an index suffix
+ * so generated files never overwrite each other.
+ */
+function assignUniqueNames(configs) {
+  var counts = new Map();
+  configs.forEach(function (item) {
+    var _counts$get;
+    var base = item.name || Generator.deriveName(item.input);
+    var seen = (_counts$get = counts.get(base)) !== null && _counts$get !== void 0 ? _counts$get : 0;
+    counts.set(base, seen + 1);
+    if (!item.name) {
+      item.name = seen === 0 ? base : "".concat(base, "_").concat(seen + 1);
+    }
+  });
+}
+
+/**
+ * Resolve the effective config list.
+ * Precedence: CLI flags > config file > built-in defaults.
+ */
+function resolveConfigs(_x) {
+  return _resolveConfigs.apply(this, arguments);
+}
+/** Print an actionable hint when no input is available. */
+function _resolveConfigs() {
+  _resolveConfigs = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(flags) {
+    var configs, discovered, _configs;
+    return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
+        case 0:
+          if (!flags.input) {
+            _context6.next = 4;
+            break;
+          }
+          configs = [buildCliConfig(flags)];
+          assignUniqueNames(configs);
+          return _context6.abrupt("return", {
+            configs: configs,
+            source: "cli"
+          });
+        case 4:
+          _context6.next = 6;
+          return discoverConfigFile();
+        case 6:
+          discovered = _context6.sent;
+          if (!discovered) {
+            _context6.next = 16;
+            break;
+          }
+          _configs = loadConfigFile(discovered); // In config-file mode `--name` filters which source(s) to run.
+          if (!flags.name) {
+            _context6.next = 13;
+            break;
+          }
+          _configs = _configs.filter(function (item) {
+            return item.name === flags.name;
+          });
+          if (!(_configs.length === 0)) {
+            _context6.next = 13;
+            break;
+          }
+          throw new Error("No config found with name: ".concat(flags.name));
+        case 13:
+          // CLI flags override config-file values. `--client` forces true,
+          // `--no-client` forces false; omitting the flag keeps the config value.
+          _configs = _configs.map(function (item) {
+            return _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, item), flags.output ? {
+              output: flags.output
+            } : {}), flags.baseUrl !== undefined ? {
+              baseURL: flags.baseUrl
+            } : {}), flags.client !== undefined ? {
+              client: flags.client
+            } : {});
+          });
+          assignUniqueNames(_configs);
+          return _context6.abrupt("return", {
+            configs: _configs,
+            source: "file",
+            configFile: discovered.filePath
+          });
+        case 16:
+          throw new NoInputError();
+        case 17:
+        case "end":
+          return _context6.stop();
+      }
+    }, _callee6);
+  }));
+  return _resolveConfigs.apply(this, arguments);
+}
+function printNoInputHint() {
+  conso.error(["No OpenAPI input found. Use one of:", "", "  1. Pass document URL or path directly (no config file needed):", "     apits gen http://localhost:3041/api-json -o src/api", "     apits gen ./openapi.yaml", "", "  2. Generate a config file (multi-source / function-based customization):", "     apits init"].join("\n"));
+}
+
+/** Scaffold an optional apits.config.ts template. */
+export function genConfig(_x2) {
+  return _genConfig.apply(this, arguments);
+}
+function _genConfig() {
+  _genConfig = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(prefill) {
+    var cwd, configTSFile, answers, configAnswers, nameLine;
+    return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+      while (1) switch (_context7.prev = _context7.next) {
+        case 0:
+          cwd = process.cwd();
+          configTSFile = path.join(cwd, "apits.config.ts");
+          _context7.next = 4;
+          return fs.pathExists(configTSFile);
+        case 4:
+          if (!_context7.sent) {
+            _context7.next = 11;
+            break;
+          }
+          conso.tips("Config file already exists: ".concat(configTSFile));
+          _context7.next = 8;
+          return prompt({
+            message: "Overwrite existing config file?",
+            name: "override",
+            type: "confirm"
+          });
+        case 8:
+          answers = _context7.sent;
+          if (answers.override) {
+            _context7.next = 11;
+            break;
+          }
+          return _context7.abrupt("return");
+        case 11:
+          _context7.next = 13;
+          return prompt([{
+            message: "API document URL or local JSON/YAML file path",
+            name: "input",
+            type: "text",
+            initial: (prefill === null || prefill === void 0 ? void 0 : prefill.input) || ""
+          }, {
+            message: "Generated file name (optional, derived from input if blank)",
+            name: "name",
+            type: "text",
+            initial: ""
+          }]);
+        case 13:
+          configAnswers = _context7.sent;
+          if (!(!configAnswers || !configAnswers.input)) {
+            _context7.next = 16;
+            break;
+          }
+          return _context7.abrupt("return", conso.tips("Cancelled, config file not written"));
+        case 16:
+          nameLine = configAnswers !== null && configAnswers !== void 0 && configAnswers.name ? "  name: '".concat(configAnswers.name, "',\n") : "";
+          _context7.t0 = fs;
+          _context7.t1 = configTSFile;
+          _context7.next = 21;
+          return formatContent(dedent(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n      import { defineConfig } from '@devbie/apits'\n\n      export default defineConfig([{\n        input: '", "',\n        output: 'src/api',\n      ", "  baseURL: '[code]:process.env.BASE_API_URL',\n        clientImportTemplate: () => \"", "\",\n        // Keep the scaffolded request.ts because the import above points at it.\n        client: true,\n      }])\n    "])), (configAnswers === null || configAnswers === void 0 ? void 0 : configAnswers.input) || "", nameLine, "import request from './request'"));
+        case 21:
+          _context7.t2 = _context7.sent;
+          _context7.next = 24;
+          return _context7.t0.outputFile.call(_context7.t0, _context7.t1, _context7.t2);
+        case 24:
+          conso.success("Config file written");
+        case 25:
+        case "end":
+          return _context7.stop();
+      }
+    }, _callee7);
+  }));
+  return _genConfig.apply(this, arguments);
+}
+function startGenerate(_x3) {
+  return _startGenerate.apply(this, arguments);
+}
+/** Run generation once for every resolved config. */
+function _startGenerate() {
+  _startGenerate = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(config) {
+    var index,
+      outputDir,
+      label,
+      generator,
+      output,
+      _args8 = arguments;
+    return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+      while (1) switch (_context8.prev = _context8.next) {
+        case 0:
+          index = _args8.length > 1 && _args8[1] !== undefined ? _args8[1] : 0;
+          outputDir = config.output;
+          label = chalk.green("".concat(config.input, " elapsed"));
+          console.time(label);
+          spinnerInstance.start();
+          generator = new Generator(config);
+          _context8.next = 8;
+          return generator.generate();
+        case 8:
+          output = _context8.sent;
+          _context8.next = 11;
+          return generator.write(output);
+        case 11:
+          spinnerInstance.clear();
+          conso.log(chalk.yellowBright("\n".concat(index + 1, ".-------------------------")));
+          conso.success("Code generated, output: ".concat(outputDir));
+          console.timeEnd(label);
+          conso.log(chalk.yellowBright("---------------------------\n"));
+          return _context8.abrupt("return", true);
+        case 17:
+        case "end":
+          return _context8.stop();
+      }
+    }, _callee8);
+  }));
+  return _startGenerate.apply(this, arguments);
+}
+function runAll(_x4) {
+  return _runAll.apply(this, arguments);
+}
+/**
+ * Watch local input files and regenerate the affected config on change.
+ * Remote inputs are not watchable; a hint is printed instead.
+ */
+function _runAll() {
+  _runAll = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(configs) {
+    return _regeneratorRuntime().wrap(function _callee10$(_context10) {
+      while (1) switch (_context10.prev = _context10.next) {
+        case 0:
+          _context10.next = 2;
+          return asyncFnArrayOrderRun(configs.map(function (configItem, index) {
+            return /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
+              return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+                while (1) switch (_context9.prev = _context9.next) {
+                  case 0:
+                    _context9.next = 2;
+                    return startGenerate(configItem, index);
+                  case 2:
+                  case "end":
+                    return _context9.stop();
+                }
+              }, _callee9);
+            }));
+          }));
+        case 2:
+        case "end":
+          return _context10.stop();
+      }
+    }, _callee10);
+  }));
+  return _runAll.apply(this, arguments);
+}
+function watchConfigs(configs) {
+  var localConfigs = configs.filter(function (item) {
+    return !isHttpInput(item.input);
+  });
+  if (localConfigs.length === 0) {
+    conso.tips("--watch only supports local files; remote URLs are ignored");
+    return;
+  }
+
+  // Simple debounce so editors that save twice only trigger one rebuild.
+  var timers = new Map();
+  localConfigs.forEach(function (configItem) {
+    var filePath = path.resolve(configItem.input);
+    fs.watch(filePath, /*#__PURE__*/function () {
+      var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(eventType) {
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              // Handle both 'change' and 'rename' — macOS atomic save (e.g. vim's
+              // write-and-rename) triggers 'rename', and the watcher may need to be
+              // re-established after the inode changes. Re-create the watcher on
+              // rename to avoid silently losing subsequent changes.
+              if (eventType === "rename") {
+                try {
+                  fs.watch(filePath, /*#__PURE__*/function () {
+                    var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(ev) {
+                      return _regeneratorRuntime().wrap(function _callee$(_context) {
+                        while (1) switch (_context.prev = _context.next) {
+                          case 0:
+                            scheduleRebuild(filePath, ev);
+                          case 1:
+                          case "end":
+                            return _context.stop();
+                        }
+                      }, _callee);
+                    }));
+                    return function (_x6) {
+                      return _ref2.apply(this, arguments);
+                    };
+                  }());
+                } catch (_unused) {
+                  // File may not exist yet during the rename window; the next save
+                  // will re-establish the watcher.
+                }
+              }
+              scheduleRebuild(filePath, eventType);
+            case 2:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2);
+      }));
+      return function (_x5) {
+        return _ref.apply(this, arguments);
+      };
+    }());
+  });
+  function scheduleRebuild(filePath, eventType) {
+    if (eventType !== "change" && eventType !== "rename") return;
+    var oldTimer = timers.get(filePath);
+    if (oldTimer) clearTimeout(oldTimer);
+    timers.set(filePath, setTimeout( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+      var configItem, idx;
+      return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            configItem = localConfigs.find(function (c) {
+              return path.resolve(c.input) === filePath;
+            });
+            if (configItem) {
+              _context3.next = 3;
+              break;
+            }
+            return _context3.abrupt("return");
+          case 3:
+            idx = localConfigs.indexOf(configItem);
+            conso.tips("Detected change, regenerating: ".concat(filePath));
+            _context3.prev = 5;
+            _context3.next = 8;
+            return startGenerate(configItem, idx);
+          case 8:
+            _context3.next = 13;
+            break;
+          case 10:
+            _context3.prev = 10;
+            _context3.t0 = _context3["catch"](5);
+            conso.error("Regeneration failed: ".concat(_context3.t0.message || _context3.t0));
+          case 13:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3, null, [[5, 10]]);
+    })), 200));
+  }
+  conso.tips("Watching ".concat(localConfigs.length, " local document(s), Ctrl+C to exit"));
+}
+export function start() {
+  return _start.apply(this, arguments);
+}
+
+/** Map parsed yargs argv into GenFlags. */
+function _start() {
+  _start = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11() {
+    var flags,
+      timeLabel,
+      resolved,
+      _args11 = arguments;
+    return _regeneratorRuntime().wrap(function _callee11$(_context11) {
+      while (1) switch (_context11.prev = _context11.next) {
+        case 0:
+          flags = _args11.length > 0 && _args11[0] !== undefined ? _args11[0] : {};
+          timeLabel = chalk.green("Total elapsed");
+          console.time(timeLabel);
+          _context11.prev = 3;
+          _context11.next = 6;
+          return resolveConfigs(flags);
+        case 6:
+          resolved = _context11.sent;
+          _context11.next = 17;
+          break;
+        case 9:
+          _context11.prev = 9;
+          _context11.t0 = _context11["catch"](3);
+          if (!(_context11.t0 instanceof NoInputError)) {
+            _context11.next = 14;
+            break;
+          }
+          printNoInputHint();
+          return _context11.abrupt("return");
+        case 14:
+          spinnerInstance.stop();
+          conso.error("Config resolution failed: ".concat(_context11.t0.message || _context11.t0));
+          return _context11.abrupt("return");
+        case 17:
+          conso.tips(resolved.source === "cli" ? "Using CLI input: ".concat(flags.input) : "Found config file: ".concat(resolved.configFile));
+          _context11.prev = 18;
+          spinnerInstance.start("Generating code...\n");
+          _context11.next = 22;
+          return runAll(resolved.configs);
+        case 22:
+          spinnerInstance.stop();
+          _context11.next = 33;
+          break;
+        case 25:
+          _context11.prev = 25;
+          _context11.t1 = _context11["catch"](18);
+          spinnerInstance.stop();
+          conso.error("Execution failed:");
+          conso.error("Error: ".concat(_context11.t1.message || _context11.t1));
+          if (_context11.t1.stack) {
+            conso.error("Stack: ".concat(_context11.t1.stack));
+          }
+          if (_context11.t1.cause) {
+            conso.error("Cause: ".concat(_context11.t1.cause));
+          }
+          return _context11.abrupt("return", conso.error("Code generation failed, see error details above"));
+        case 33:
+          console.timeEnd(timeLabel);
+          if (flags.watch) {
+            watchConfigs(resolved.configs);
+          }
+          return _context11.abrupt("return", null);
+        case 36:
+        case "end":
+          return _context11.stop();
+      }
+    }, _callee11, null, [[3, 9], [18, 25]]);
+  }));
+  return _start.apply(this, arguments);
+}
+function toFlags(argv) {
+  return {
+    input: typeof argv.input === "string" && argv.input ? argv.input : undefined,
+    output: typeof argv.output === "string" ? argv.output : undefined,
+    name: typeof argv.name === "string" ? argv.name : undefined,
+    baseUrl: typeof argv.baseUrl === "string" ? argv.baseUrl : undefined,
+    client: typeof argv.client === "boolean" ? argv.client : undefined,
+    watch: Boolean(argv.watch)
+  };
+}
+var CLI = /*#__PURE__*/function () {
+  function CLI() {
+    _classCallCheck(this, CLI);
+  }
+  _createClass(CLI, [{
+    key: "run",
+    value: function run(args) {
+      var cli = this.init();
+      if (args.length === 0) {
+        cli.showHelp();
+      }
+      return cli.parse(args);
+    }
+  }, {
+    key: "genBuilder",
+    value: function genBuilder(y) {
+      return y.positional("input", {
+        type: "string",
+        describe: "OpenAPI document URL or local JSON/YAML file path"
+      }).option("output", {
+        alias: "o",
+        type: "string",
+        describe: "Output directory (default: src/api)"
+      }).option("name", {
+        alias: "n",
+        type: "string",
+        describe: "Generated file name; filters by name in config-file mode"
+      }).option("base-url", {
+        type: "string",
+        describe: "Runtime baseURL (supports [code]: prefix for code emission)"
+      }).option("client", {
+        type: "boolean",
+        describe: "Generate default request.ts (use --no-client to disable, --client to force-enable)"
+      }).option("watch", {
+        alias: "w",
+        type: "boolean",
+        default: false,
+        describe: "Watch local document for changes and auto-regenerate"
+      });
+    }
+  }, {
+    key: "init",
+    value: function init() {
+      var _this = this;
+      return yargs.scriptName("apits").usage("Usage: $0 [gen] [input] [options]")
+      // `init` must be declared before the default command so it is not
+      // captured as the `input` positional.
+      .command("init [input]", "Scaffold an optional apits.config.ts file", function (y) {
+        y.positional("input", {
+          type: "string",
+          describe: "Prefilled document URL or local file path"
+        });
+      }, /*#__PURE__*/function () {
+        var _ref4 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(argv) {
+          return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+            while (1) switch (_context4.prev = _context4.next) {
+              case 0:
+                _context4.next = 2;
+                return genConfig({
+                  input: typeof argv.input === "string" ? argv.input : undefined
+                });
+              case 2:
+              case "end":
+                return _context4.stop();
+            }
+          }, _callee4);
+        }));
+        return function (_x7) {
+          return _ref4.apply(this, arguments);
+        };
+      }())
+      // `gen` is also the default command: `apits <input>` works.
+      // The default-command alias is hidden from help to keep it clean.
+      .command("gen [input]", "Generate TypeScript types and request functions from an OpenAPI document", function (y) {
+        return _this.genBuilder(y);
+      }, function (argv) {
+        start(toFlags(argv));
+      }).command("$0 [input]", false, function (y) {
+        return _this.genBuilder(y);
+      }, function (argv) {
+        start(toFlags(argv));
+      }).help();
+    }
+  }]);
+  return CLI;
+}();
+export { CLI as default };