@dereekb/dbx-cli 13.11.3 → 13.11.5

package/index.esm.js

@@ -1,20 +1,21 @@
 import { existsSync, mkdirSync, writeFileSync, appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 export { CALL_MODEL_APP_FUNCTION_KEY } from '@dereekb/firebase';
-import { expirationDetails, generatePkceCodeVerifier, generatePkceCodeChallenge, noop } from '@dereekb/util';
+import { expirationDetails, generatePkceCodeVerifier, generatePkceCodeChallenge, noop, MS_IN_SECOND } from '@dereekb/util';
+import { durationDataToMilliseconds, parseDurationString } from '@dereekb/date';
 import { readJsonFile, writeJsonFile, createMemoizedJsonFileAsyncKeyedValueCache } from '@dereekb/nestjs';
 import { homedir } from 'node:os';
 import { createInterface } from 'node:readline';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 
-function _array_like_to_array$5(arr, len) {
+function _array_like_to_array$7(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 _array_without_holes$3(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
+function _array_without_holes$4(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$7(arr);
 }
 function _assert_this_initialized(self) {
     if (self === void 0) {
@@ -80,7 +81,7 @@ function _inherits(subClass, superClass) {
     });
     if (superClass) _set_prototype_of(subClass, superClass);
 }
-function _instanceof$5(left, right) {
+function _instanceof$6(left, right) {
     "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
@@ -91,10 +92,10 @@ function _instanceof$5(left, right) {
 function _is_native_function(fn) {
     return Function.toString.call(fn).indexOf("[native code]") !== -1;
 }
-function _iterable_to_array$3(iter) {
+function _iterable_to_array$4(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$3() {
+function _non_iterable_spread$4() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$c(target) {
@@ -113,7 +114,7 @@ function _object_spread$c(target) {
     return target;
 }
 function _possible_constructor_return(self, call) {
-    if (call && (_type_of$2(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$3(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized(self);
@@ -125,20 +126,20 @@ function _set_prototype_of(o, p) {
     };
     return _set_prototype_of(o, p);
 }
-function _to_consumable_array$3(arr) {
-    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread$3();
+function _to_consumable_array$4(arr) {
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$7(arr) || _non_iterable_spread$4();
 }
-function _type_of$2(obj) {
+function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$5(o, minLen) {
+function _unsupported_iterable_to_array$7(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$7(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(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
 }
 function _wrap_native_super(Class) {
     var _cache = typeof Map === "function" ? new Map() : undefined;
@@ -187,7 +188,7 @@ function _is_native_reflect_construct() {
     /id_token[=:]\s*\S+/gi
 ];
 var _outputOptions = {};
-var _secretPatterns = _to_consumable_array$3(DEFAULT_CLI_SECRET_PATTERNS);
+var _secretPatterns = _to_consumable_array$4(DEFAULT_CLI_SECRET_PATTERNS);
 var _errorMapper;
 /**
  * Configures output options from parsed CLI arguments.
@@ -316,13 +317,13 @@ function dumpResponse(data, meta) {
             return pickFromObject(item, fields);
         });
     }
-    if (data != null && (typeof data === "undefined" ? "undefined" : _type_of$2(data)) === 'object') {
+    if (data != null && (typeof data === "undefined" ? "undefined" : _type_of$3(data)) === 'object') {
         return pickFromObject(data, fields);
     }
     return data;
 }
 function pickFromObject(obj, fields) {
-    if (obj == null || (typeof obj === "undefined" ? "undefined" : _type_of$2(obj)) !== 'object') {
+    if (obj == null || (typeof obj === "undefined" ? "undefined" : _type_of$3(obj)) !== 'object') {
         return obj;
     }
     var result = {};
@@ -417,7 +418,7 @@ function pickFromObject(obj, fields) {
             return mapped;
         }
     }
-    if (_instanceof$5(error, CliError)) {
+    if (_instanceof$6(error, CliError)) {
         return _object_spread$c({
             ok: false,
             error: sanitizeString(error.message),
@@ -426,7 +427,7 @@ function pickFromObject(obj, fields) {
             suggestion: error.suggestion
         } : {});
     }
-    if (_instanceof$5(error, Error)) {
+    if (_instanceof$6(error, Error)) {
         return {
             ok: false,
             error: sanitizeString(error.message),
@@ -469,7 +470,7 @@ function _async_to_generator$f(fn) {
         });
     };
 }
-function _type_of$1(obj) {
+function _type_of$2(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -623,7 +624,7 @@ var CALL_MODEL_API_PATH = "/model/call";
                         }
                     }
                     if (!res.ok) {
-                        bodyMessage = (typeof body === "undefined" ? "undefined" : _type_of$1(body)) === 'object' && body && 'message' in body ? body.message : undefined;
+                        bodyMessage = (typeof body === "undefined" ? "undefined" : _type_of$2(body)) === 'object' && body && 'message' in body ? body.message : undefined;
                         messageString = typeof bodyMessage === 'string' ? bodyMessage : undefined;
                         message = messageString !== null && messageString !== void 0 ? messageString : text || "".concat(res.status, " ").concat(res.statusText);
                         throw new CliError({
@@ -1130,7 +1131,7 @@ function _define_property$a(obj, key, value) {
     }
     return obj;
 }
-function _instanceof$4(left, right) {
+function _instanceof$5(left, right) {
     "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
@@ -1301,7 +1302,7 @@ function _ts_generator$d(thisArg, body) {
                                 data = JSON.parse(argv.data);
                             } catch (e) {
                                 throw new CliError({
-                                    message: "--data must be valid JSON: ".concat(_instanceof$4(e, Error) ? e.message : String(e)),
+                                    message: "--data must be valid JSON: ".concat(_instanceof$5(e, Error) ? e.message : String(e)),
                                     code: 'INVALID_DATA_JSON'
                                 });
                             }
@@ -1343,6 +1344,201 @@ function _ts_generator$d(thisArg, body) {
     }
 };
 
+function _array_like_to_array$6(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 _array_with_holes$3(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _instanceof$4(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _iterable_to_array_limit$3(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest$3() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array$3(arr, i) {
+    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$6(arr, i) || _non_iterable_rest$3();
+}
+function _type_of$1(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array$6(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$6(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
+}
+/**
+ * Resolves the manifest entry for `modelType`. Lookup tries
+ * `modelType` first, then falls back to `identityConst` and `collectionPrefix`
+ * so callers can pass any of the three forms a user might type at the CLI.
+ *
+ * @param modelType - identifier to look up.
+ * @param manifest - generated model manifest.
+ * @returns the matching entry, or `undefined` when none exists.
+ * @__NO_SIDE_EFFECTS__
+ */ function findCliModelManifestEntry(modelType, manifest) {
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = manifest[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var entry = _step.value;
+            if (entry.modelType === modelType || entry.identityConst === modelType || entry.collectionPrefix === modelType) {
+                result = entry;
+                break;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Rewrites the persisted (short) keys in `data` to the long-name form
+ * declared in the model's manifest entry. Recurses into nested object-array
+ * and sub-object fields when the manifest captured a nested field map.
+ *
+ * Returns the input untouched when `modelType` is not in the manifest, when
+ * the model has no fields, or when the input is not a plain object/array.
+ * Unknown keys, primitives, `Date`, `null`, and `undefined` pass through
+ * unchanged.
+ *
+ * @param modelType - the model identifier (`modelType`, `identityConst`,
+ *   or `collectionPrefix`) used to look up the rewrite map.
+ * @param data - the value to rewrite (typically a `read`/`query` response
+ *   payload).
+ * @param manifest - generated model manifest.
+ * @returns the rewritten value, or `data` unchanged when no rewrite applies.
+ * @__NO_SIDE_EFFECTS__
+ */ function expandModelKeys(modelType, data, manifest) {
+    var entry = findCliModelManifestEntry(modelType, manifest);
+    if (!entry) return data;
+    return rewriteWithFields(data, entry.fields);
+}
+function rewriteWithFields(value, fields) {
+    if (Array.isArray(value)) {
+        return value.map(function(item) {
+            return rewriteWithFields(item, fields);
+        });
+    }
+    if (!isPlainObject(value)) return value;
+    var fieldByName = new Map();
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = fields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var field = _step.value;
+            fieldByName.set(field.name, field);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    var out = {};
+    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    try {
+        for(var _iterator1 = Object.entries(value)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+            var _step_value = _sliced_to_array$3(_step1.value, 2), key = _step_value[0], raw = _step_value[1];
+            var field1 = fieldByName.get(key);
+            if (!field1) {
+                out[key] = raw;
+                continue;
+            }
+            var longKey = field1.longName.length > 0 ? field1.longName : key;
+            out[longKey] = rewriteFieldValue(raw, field1);
+        }
+    } catch (err) {
+        _didIteratorError1 = true;
+        _iteratorError1 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                _iterator1.return();
+            }
+        } finally{
+            if (_didIteratorError1) {
+                throw _iteratorError1;
+            }
+        }
+    }
+    return out;
+}
+function rewriteFieldValue(value, field) {
+    var nested = field.nestedFields;
+    if (!nested || nested.length === 0) return value;
+    if (field.nestedIsArray) {
+        if (!Array.isArray(value)) return value;
+        return value.map(function(item) {
+            return rewriteWithFields(item, nested);
+        });
+    }
+    if (!isPlainObject(value)) return value;
+    return rewriteWithFields(value, nested);
+}
+function isPlainObject(value) {
+    if (value === null || (typeof value === "undefined" ? "undefined" : _type_of$1(value)) !== 'object') return false;
+    if (Array.isArray(value)) return false;
+    if (_instanceof$4(value, Date)) return false;
+    // Objects from JSON.parse have Object.prototype as their proto. Anything
+    // exotic (Map, Set, Buffer, class instances) we leave untouched.
+    var proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+
 function asyncGeneratorStep$c(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
@@ -2348,7 +2544,7 @@ function trimSlash(url) {
     return url.endsWith('/') ? url.slice(0, -1) : url;
 }
 
-function _array_like_to_array$4(arr, len) {
+function _array_like_to_array$5(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;
@@ -2413,15 +2609,15 @@ function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest$2();
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$2();
 }
-function _unsupported_iterable_to_array$4(o, minLen) {
+function _unsupported_iterable_to_array$5(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$4(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$5(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(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
 }
 function _ts_generator$a(thisArg, body) {
     var f, y, t, _ = {
@@ -2551,6 +2747,15 @@ function _ts_generator$a(thisArg, body) {
         code_challenge_method: 'S256',
         state: input.state
     };
+    if (input.requestedSessionTtlSeconds != null) {
+        if (!Number.isInteger(input.requestedSessionTtlSeconds) || input.requestedSessionTtlSeconds <= 0) {
+            throw new CliError({
+                message: "requestedSessionTtlSeconds must be a positive integer (got ".concat(input.requestedSessionTtlSeconds, ")."),
+                code: 'AUTH_LOGIN_FOR_INVALID'
+            });
+        }
+        authParams.dbx_session_ttl = String(input.requestedSessionTtlSeconds);
+    }
     var endpoint;
     if (input.appClientUrl) {
         endpoint = rebaseUrlOrigin({
@@ -3330,11 +3535,14 @@ function maskEnv$1(env) {
                 type: 'boolean',
                 default: false,
                 describe: 'Drop model.create/model.update/model.delete from the requested scopes (keeps model.read and model.query)'
+            }).option('login-for', {
+                type: 'string',
+                describe: 'Requested login duration with a unit (e.g. 30d, 12h, 3600s). Mixed units are allowed (e.g. "1h30m", "2d 12h"). Subject to server/client caps. Applied to Session, Grant, and RefreshToken.'
             });
         },
         handler: function handler(argv) {
             return _async_to_generator$9(function() {
-                var _argv_code, _tokenResponse_expires_in, _ref, envName, env, meta, _ref1, codeVerifier, codeChallenge, state, requestedScopes, url, pasted, _tmp, code, tokenResponse, expiresAt, entry, e;
+                var _argv_code, _tokenResponse_expires_in, _ref, envName, env, meta, _ref1, codeVerifier, codeChallenge, state, requestedScopes, requestedSessionTtlSeconds, ms, url, pasted, _tmp, code, tokenResponse, expiresAt, entry, e;
                 return _ts_generator$9(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -3379,6 +3587,16 @@ function maskEnv$1(env) {
                             _ref1 = _state.sent(), codeVerifier = _ref1.codeVerifier, codeChallenge = _ref1.codeChallenge;
                             state = generateOAuthState();
                             requestedScopes = argv.readOnlyScopes ? filterReadOnlyModelScopes(env.scopes) : env.scopes;
+                            if (argv.loginFor) {
+                                ms = durationDataToMilliseconds(parseDurationString(argv.loginFor));
+                                if (ms <= 0) {
+                                    throw new CliError({
+                                        message: '--login-for: invalid duration "'.concat(argv.loginFor, '". Use formats like "30d", "12h", "3600s", or mixed units like "1h30m" or "2d 12h".'),
+                                        code: 'AUTH_LOGIN_FOR_INVALID'
+                                    });
+                                }
+                                requestedSessionTtlSeconds = Math.floor(ms / MS_IN_SECOND);
+                            }
                             url = buildAuthorizationUrl({
                                 authorizationEndpoint: meta.authorization_endpoint,
                                 apiBaseUrl: env.apiBaseUrl,
@@ -3387,7 +3605,8 @@ function maskEnv$1(env) {
                                 redirectUri: env.redirectUri,
                                 scopes: requestedScopes,
                                 state: state,
-                                codeChallenge: codeChallenge
+                                codeChallenge: codeChallenge,
+                                requestedSessionTtlSeconds: requestedSessionTtlSeconds
                             });
                             // The CLI never opens a browser itself — it prints the URL and reads the redirect back.
                             // Emit the URL through a clearly-prefixed stderr line so JSON stdout stays parseable.
@@ -3894,13 +4113,13 @@ function maskEnv$1(env) {
     };
 }
 
-function _array_like_to_array$3(arr, len) {
+function _array_like_to_array$4(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 _array_without_holes$2(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$3(arr);
+function _array_without_holes$3(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
 }
 function asyncGeneratorStep$8(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -3952,10 +4171,10 @@ function _instanceof$2(left, right) {
         return left instanceof right;
     }
 }
-function _iterable_to_array$2(iter) {
+function _iterable_to_array$3(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$2() {
+function _non_iterable_spread$3() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$6(target) {
@@ -3973,16 +4192,16 @@ function _object_spread$6(target) {
     }
     return target;
 }
-function _to_consumable_array$2(arr) {
-    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$3(arr) || _non_iterable_spread$2();
+function _to_consumable_array$3(arr) {
+    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$3();
 }
-function _unsupported_iterable_to_array$3(o, minLen) {
+function _unsupported_iterable_to_array$4(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$4(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(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
 }
 function _ts_generator$8(thisArg, body) {
     var f, y, t, _ = {
@@ -4424,7 +4643,7 @@ function _ts_generator$8(thisArg, body) {
  */ function createDoctorCommand(input) {
     var _input_checks;
     var cliName = input.cliName;
-    var checks = _to_consumable_array$2(defaultDoctorChecks()).concat(_to_consumable_array$2((_input_checks = input.checks) !== null && _input_checks !== void 0 ? _input_checks : []));
+    var checks = _to_consumable_array$3(defaultDoctorChecks()).concat(_to_consumable_array$3((_input_checks = input.checks) !== null && _input_checks !== void 0 ? _input_checks : []));
     var defaultEnvs = input.defaultEnvs;
     return {
         command: 'doctor',
@@ -4591,7 +4810,7 @@ function _ts_generator$8(thisArg, body) {
     };
 }
 
-function _array_like_to_array$2(arr, len) {
+function _array_like_to_array$3(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;
@@ -4711,15 +4930,15 @@ function _object_spread_props$4(target, source) {
     return target;
 }
 function _sliced_to_array$1(arr, i) {
-    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$1();
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$3(arr, i) || _non_iterable_rest$1();
 }
-function _unsupported_iterable_to_array$2(o, minLen) {
+function _unsupported_iterable_to_array$3(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$3(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(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
 }
 function _ts_generator$7(thisArg, body) {
     var f, y, t, _ = {
@@ -5288,6 +5507,302 @@ function resolveEnvWithDefault(input) {
     };
 }
 
+function _array_like_to_array$2(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 _array_without_holes$2(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$2(arr);
+}
+function _iterable_to_array$2(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread$2() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array$2(arr) {
+    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$2(arr) || _non_iterable_spread$2();
+}
+function _unsupported_iterable_to_array$2(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$2(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
+}
+/**
+ * Resolves the manifest entry for `query` against `modelType`, `identityConst`,
+ * and `collectionPrefix` in that order.
+ *
+ * Re-exports {@link findCliModelManifestEntry} under a more descriptive name
+ * for the model-info command.
+ *
+ * @param manifest - the generated model manifest.
+ * @param query - identifier to look up.
+ * @returns the matching entry or `undefined`.
+ * @__NO_SIDE_EFFECTS__
+ */ function resolveCliModel(manifest, query) {
+    return findCliModelManifestEntry(query, manifest);
+}
+/**
+ * Produces a column-aligned summary table of every model in the manifest.
+ *
+ * @param manifest - the generated model manifest.
+ * @returns the formatted table as a single string with a trailing newline.
+ * @__NO_SIDE_EFFECTS__
+ */ function renderModelManifestList(manifest) {
+    if (manifest.length === 0) {
+        return 'No models found in the generated manifest.\n';
+    }
+    var rows = [
+        [
+            'MODEL',
+            'PREFIX',
+            'GROUP',
+            'FIELDS',
+            'PACKAGE',
+            'IDENTITY'
+        ]
+    ].concat(_to_consumable_array$2(manifest.map(function(m) {
+        var _m_modelGroup;
+        return [
+            m.modelType,
+            m.collectionPrefix,
+            (_m_modelGroup = m.modelGroup) !== null && _m_modelGroup !== void 0 ? _m_modelGroup : '',
+            String(m.fields.length),
+            m.sourcePackage,
+            m.identityConst
+        ];
+    })));
+    return renderTable(rows);
+}
+/**
+ * Produces a human-readable summary of one model entry: header, description,
+ * and an indented field tree (recursing into `nestedFields`).
+ *
+ * @param entry - the manifest entry to render.
+ * @returns the formatted summary as a single string with a trailing newline.
+ * @__NO_SIDE_EFFECTS__
+ */ function renderModelManifestEntry(entry) {
+    var lines = [];
+    lines.push("# ".concat(entry.modelType) + (entry.modelGroup ? " \xb7 group ".concat(entry.modelGroup) : ''));
+    lines.push("Identity: ".concat(entry.identityConst));
+    lines.push("Collection prefix: ".concat(entry.collectionPrefix));
+    if (entry.parentIdentityConst) lines.push("Parent identity: ".concat(entry.parentIdentityConst));
+    lines.push("Source package: ".concat(entry.sourcePackage));
+    lines.push("Source file: ".concat(entry.sourceFile));
+    if (entry.description) {
+        lines.push('');
+        lines.push(entry.description);
+    }
+    lines.push('');
+    lines.push("Fields (".concat(entry.fields.length, "):"));
+    lines.push(renderFieldsTree(entry.fields, 0));
+    return lines.join('\n') + '\n';
+}
+/**
+ * Produces the field-table portion of {@link renderModelManifestEntry} on its
+ * own, used by the `--fields` flag of the `model-info` command.
+ *
+ * @param entry - the manifest entry whose fields should be rendered.
+ * @returns the formatted field tree as a single string with a trailing newline.
+ * @__NO_SIDE_EFFECTS__
+ */ function renderModelManifestFields(entry) {
+    return renderFieldsTree(entry.fields, 0) + '\n';
+}
+function renderFieldsTree(fields, indent) {
+    var out = [];
+    var rows = [
+        [
+            'NAME',
+            'LONG NAME',
+            'TYPE',
+            'OPTIONAL',
+            'CONVERTER'
+        ]
+    ];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = fields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var field = _step.value;
+            var _field_tsType;
+            rows.push([
+                field.name,
+                field.longName,
+                (_field_tsType = field.tsType) !== null && _field_tsType !== void 0 ? _field_tsType : '',
+                field.optional ? 'yes' : 'no',
+                truncate(field.converter, 60)
+            ]);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    out.push(indentLines$1(renderTable(rows), indent));
+    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    try {
+        for(var _iterator1 = fields[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+            var field1 = _step1.value;
+            if (field1.nestedFields && field1.nestedFields.length > 0) {
+                var label = field1.nestedIsArray ? 'array element' : 'sub-object';
+                out.push(indentLines$1("↳ ".concat(field1.name, " (").concat(label, ", ").concat(field1.nestedFields.length, " field").concat(field1.nestedFields.length === 1 ? '' : 's', ")"), indent + 2));
+                out.push(renderFieldsTree(field1.nestedFields, indent + 4));
+            }
+        }
+    } catch (err) {
+        _didIteratorError1 = true;
+        _iteratorError1 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                _iterator1.return();
+            }
+        } finally{
+            if (_didIteratorError1) {
+                throw _iteratorError1;
+            }
+        }
+    }
+    return out.join('\n');
+}
+function renderTable(rows) {
+    if (rows.length === 0) return '';
+    var widths = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = rows[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var row = _step.value;
+            row.forEach(function(cell, i) {
+                var _widths_i;
+                var cellWidth = cell.length;
+                widths[i] = Math.max((_widths_i = widths[i]) !== null && _widths_i !== void 0 ? _widths_i : 0, cellWidth);
+            });
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return rows.map(function(row) {
+        return row.map(function(cell, i) {
+            var _widths_i;
+            return i === row.length - 1 ? cell : cell.padEnd((_widths_i = widths[i]) !== null && _widths_i !== void 0 ? _widths_i : 0);
+        }).join('  ').replace(/\s+$/, '');
+    }).join('\n');
+}
+function truncate(text, max) {
+    if (text.length <= max) return text;
+    return text.slice(0, max - 1) + '…';
+}
+function indentLines$1(text, indent) {
+    if (indent <= 0) return text;
+    var pad = ' '.repeat(indent);
+    return text.split('\n').map(function(line) {
+        return line.length > 0 ? pad + line : line;
+    }).join('\n');
+}
+
+/**
+ * Default command name for the model-info command. Top-level so it stays out
+ * of the API-call namespace owned by `model <model> <action>`.
+ */ var DEFAULT_MODEL_INFO_COMMAND_NAME = 'model-info';
+/**
+ * Builds the top-level `model-info [model]` command.
+ *
+ * Without an argument: prints a column-aligned table summarising every model
+ * in the manifest. With an argument: looks the model up by `modelType`,
+ * `identityConst`, or `collectionPrefix` and prints its full per-field
+ * documentation, recursing into nested converters when the manifest captured
+ * them.
+ *
+ * Flags:
+ *   - `--json` emits a structured `{ ok, data }` envelope instead of the
+ *     human-readable table (useful for scripting or LLM agents).
+ *   - `--fields` prints only the field table for the resolved model.
+ *
+ * @param manifest - The generated model manifest (e.g. `DEMO_CLI_MODEL_MANIFEST`).
+ * @param options - Optional overrides; see {@link BuildModelInfoCommandOptions}.
+ * @returns A yargs `CommandModule` ready to be passed to `runCli({ configCommands })`.
+ * @__NO_SIDE_EFFECTS__
+ */ function buildModelInfoCommand(manifest, options) {
+    var _ref;
+    var commandName = (_ref = options === null || options === void 0 ? void 0 : options.commandName) !== null && _ref !== void 0 ? _ref : DEFAULT_MODEL_INFO_COMMAND_NAME;
+    return {
+        command: "".concat(commandName, " [model]"),
+        describe: "Show generated catalog and field info for Firestore models (".concat(manifest.length, " model").concat(manifest.length === 1 ? '' : 's', ")."),
+        builder: function builder(yargs) {
+            return yargs.positional('model', {
+                type: 'string',
+                describe: 'Model to inspect (modelType, identity const, or collection prefix). Omit to list every model.'
+            }).option('json', {
+                type: 'boolean',
+                default: false,
+                describe: 'Emit a structured JSON envelope instead of the human-readable table.'
+            }).option('fields', {
+                type: 'boolean',
+                default: false,
+                describe: 'Print only the field table for the resolved model.'
+            });
+        },
+        handler: function handler(argv) {
+            try {
+                runHandler(manifest, argv);
+            } catch (e) {
+                outputError(e);
+                process.exit(1);
+            }
+        }
+    };
+}
+function runHandler(manifest, argv) {
+    var query = typeof argv.model === 'string' && argv.model.length > 0 ? argv.model : undefined;
+    if (!query) {
+        if (argv.json) {
+            outputResult(manifest);
+            return;
+        }
+        process.stdout.write(renderModelManifestList(manifest));
+        return;
+    }
+    var entry = resolveCliModel(manifest, query);
+    if (!entry) {
+        throw new CliError({
+            message: "No model matches '".concat(query, "'. Run `model-info` without an argument to list available models."),
+            code: 'MODEL_INFO_NOT_FOUND'
+        });
+    }
+    if (argv.json) {
+        outputResult(entry);
+        return;
+    }
+    if (argv.fields) {
+        process.stdout.write(renderModelManifestFields(entry));
+        return;
+    }
+    process.stdout.write(renderModelManifestEntry(entry));
+}
+
 function asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
@@ -6715,6 +7230,10 @@ function _ts_generator$2(thisArg, body) {
  * @param input.defaultEnvs - Built-in env presets shipped with the CLI.
  * @param input.argv - Argv to parse. Defaults to `hideBin(process.argv)`.
  * @param input.disableCallPassthrough - When `true`, omits the built-in `call` passthrough.
+ * @param input.modelManifest - Optional Firestore model manifest. When provided, auto-wires the
+ *   built-in `model-info` command. Opt-in per app.
+ * @param input.disableModelInfo - When `true`, suppresses the auto-wired `model-info` command even
+ *   if {@link CreateCliInput.modelManifest} is provided.
  * @returns The configured yargs `Argv` ready to be `.parse()`-d.
  * @__NO_SIDE_EFFECTS__
  */ function createCli(input) {
@@ -6739,6 +7258,9 @@ function _ts_generator$2(thisArg, body) {
             cliName: cliName
         })
     ];
+    if (input.modelManifest && input.disableModelInfo !== true) {
+        builtInConfigCommands.push(buildModelInfoCommand(input.modelManifest));
+    }
     var allConfigCommands = _to_consumable_array$1(builtInConfigCommands).concat(_to_consumable_array$1((_input_configCommands = input.configCommands) !== null && _input_configCommands !== void 0 ? _input_configCommands : []));
     var builtInApiCommands = input.disableCallPassthrough ? [] : [
         callPassthroughCommand
@@ -7196,7 +7718,8 @@ var DATA_HELP_FLAG = '--data-help';
     var context = {
         dataHelpFormat: dataHelpFormat,
         helpMode: helpMode,
-        hideOnFocus: hideOnFocus
+        hideOnFocus: hideOnFocus,
+        modelManifest: options === null || options === void 0 ? void 0 : options.modelManifest
     };
     return [
         {
@@ -7360,6 +7883,7 @@ function buildEntryCommand(entry, context) {
     var fallbackDescribe = "".concat(entry.verb).concat(specPart, " on ").concat(entry.model);
     var describeOneLine = (_oneLineDescription = oneLineDescription(entry.description)) !== null && _oneLineDescription !== void 0 ? _oneLineDescription : fallbackDescribe;
     var epilogue = buildEntryEpilogue(entry, context);
+    var expandKeysAvailable = Boolean(context.modelManifest);
     return {
         command: action,
         describe: describeOneLine,
@@ -7368,6 +7892,13 @@ function buildEntryCommand(entry, context) {
                 type: 'string',
                 describe: 'JSON-encoded payload (defaults to {} when omitted)'
             });
+            if (expandKeysAvailable) {
+                y = y.option('expand-keys', {
+                    type: 'boolean',
+                    default: false,
+                    describe: "Rewrite the response payload's persisted short keys to their long-name form using the generated model manifest."
+                });
+            }
             hideGlobalOptions(y, context.hideOnFocus);
             return epilogue ? y.epilogue(epilogue) : y;
         },
@@ -7385,7 +7916,10 @@ function buildEntryCommand(entry, context) {
                             ]);
                             return [
                                 4,
-                                callEntry(entry, typeof argv.data === 'string' ? argv.data : undefined)
+                                callEntry(entry, typeof argv.data === 'string' ? argv.data : undefined, {
+                                    expandKeys: expandKeysAvailable && argv.expandKeys === true,
+                                    modelManifest: context.modelManifest
+                                })
                             ];
                         case 1:
                             _state.sent();
@@ -7710,9 +8244,9 @@ function readArktypeExpression(entry) {
     }
     return result;
 }
-function callEntry(entry, rawData) {
+function callEntry(entry, rawData, options) {
     return _async_to_generator$1(function() {
-        var ctx, data, params, result;
+        var ctx, data, params, result, finalResult;
         return _ts_generator$1(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -7732,7 +8266,8 @@ function callEntry(entry, rawData) {
                     ];
                 case 1:
                     result = _state.sent();
-                    outputResult(result);
+                    finalResult = options.expandKeys && options.modelManifest ? expandModelKeys(entry.model, result, options.modelManifest) : result;
+                    outputResult(finalResult);
                     return [
                         2
                     ];
@@ -8282,4 +8817,4 @@ function printPaginatedOutput(input) {
     })();
 }
 
-export { CALL_MODEL_API_PATH, CliError, DEFAULT_CLI_OIDC_SCOPES, DEFAULT_CLI_SECRET_PATTERNS, DEFAULT_MANIFEST_HELP_DATA_FORMAT, DEFAULT_MANIFEST_HELP_MODE, DEFAULT_MANIFEST_MODEL_COMMAND_NAME, DUMP_MERGE_MODES, DUMP_OUTPUT_MODES, MODEL_WRITE_OIDC_SCOPES, MULTIPLE_PAGES_OUTPUT_MODES, PROMPT_CANCELLED_ERROR_CODE, STANDARD_GLOBAL_OPTION_NAMES, applyEnvVarOverrides, buildAuthorizationUrl, buildCliPaths, buildDumpFilePath, buildErrorOutput, buildManifestCommands, callModelOverHttp, callPassthroughCommand, configureCliErrorMapper, configureCliSecretPatterns, configureOutputOptions, createAuthCommand, createAuthMiddleware, createCallModelCommand, createCli, createCliContext, createCliTokenCacheStore, createContextSlot, createDoctorCommand, createEnvCommand, createOutputCommand, createOutputMiddleware, defaultDoctorChecks, detectDataHelpFormat, detectHelpMode, discoverOidcMetadata, dumpTimestamp, exchangeAuthorizationCode, fetchUserInfo, filterReadOnlyModelScopes, findCliEnvDefault, generateOAuthState, generatePkceMaterial, getCliContext, getOutputOptions, isCliEnvConfigComplete, isTokenExpired, loadCliConfig, maskSecret, mergeCliConfig, mergeCliEnvWithDefault, mergeOutputConfig, openStreamingDump, outputError, outputResult, parsePastedRedirect, pickFields, promptLine, refreshAccessToken, requireCliContext, resolveActiveEnvName, resolveOutputConfig, revokeToken, runCli, runPaginatedList, sanitizeString, saveCliConfig, setCliContext, withCallModelArgs, withEnv, withMultiplePages, withOutput, wrapCommandHandler };
+export { CALL_MODEL_API_PATH, CliError, DEFAULT_CLI_OIDC_SCOPES, DEFAULT_CLI_SECRET_PATTERNS, DEFAULT_MANIFEST_HELP_DATA_FORMAT, DEFAULT_MANIFEST_HELP_MODE, DEFAULT_MANIFEST_MODEL_COMMAND_NAME, DEFAULT_MODEL_INFO_COMMAND_NAME, DUMP_MERGE_MODES, DUMP_OUTPUT_MODES, MODEL_WRITE_OIDC_SCOPES, MULTIPLE_PAGES_OUTPUT_MODES, PROMPT_CANCELLED_ERROR_CODE, STANDARD_GLOBAL_OPTION_NAMES, applyEnvVarOverrides, buildAuthorizationUrl, buildCliPaths, buildDumpFilePath, buildErrorOutput, buildManifestCommands, buildModelInfoCommand, callModelOverHttp, callPassthroughCommand, configureCliErrorMapper, configureCliSecretPatterns, configureOutputOptions, createAuthCommand, createAuthMiddleware, createCallModelCommand, createCli, createCliContext, createCliTokenCacheStore, createContextSlot, createDoctorCommand, createEnvCommand, createOutputCommand, createOutputMiddleware, defaultDoctorChecks, detectDataHelpFormat, detectHelpMode, discoverOidcMetadata, dumpTimestamp, exchangeAuthorizationCode, expandModelKeys, fetchUserInfo, filterReadOnlyModelScopes, findCliEnvDefault, findCliModelManifestEntry, generateOAuthState, generatePkceMaterial, getCliContext, getOutputOptions, isCliEnvConfigComplete, isTokenExpired, loadCliConfig, maskSecret, mergeCliConfig, mergeCliEnvWithDefault, mergeOutputConfig, openStreamingDump, outputError, outputResult, parsePastedRedirect, pickFields, promptLine, refreshAccessToken, renderModelManifestEntry, renderModelManifestFields, renderModelManifestList, requireCliContext, resolveActiveEnvName, resolveCliModel, resolveOutputConfig, revokeToken, runCli, runPaginatedList, sanitizeString, saveCliConfig, setCliContext, withCallModelArgs, withEnv, withMultiplePages, withOutput, wrapCommandHandler };