@dereekb/dbx-cli 13.11.14 → 13.11.16

package/manifest-extract/index.esm.js

@@ -12,8 +12,8 @@ var SUPPORTED_VERBS = new Set([
  * callable leaf (CRUD or standalone). Best-effort: malformed configs return
  * fewer entries rather than throwing.
  *
- * @param source - in-memory source name + text pair to extract
- * @returns the CRUD extraction with group name, model keys, entries, and
+ * @param source - In-memory source name + text pair to extract.
+ * @returns The CRUD extraction with group name, model keys, entries, and
  *   `*Functions` class name (when present).
  */ // eslint-disable-next-line sonarjs/cognitive-complexity
 function extractCrudEntries(source) {
@@ -31,17 +31,18 @@ function extractCrudEntries(source) {
     var functionsClassName = findFunctionsClassName(sourceFile);
     var typeDocsCache = new Map();
     var resolveTypeDocs = function resolveTypeDocs(typeName) {
-        if (!typeName) {
-            return undefined;
-        }
-        if (typeDocsCache.has(typeName)) {
-            return typeDocsCache.get(typeName);
-        }
-        var docs = readTypeDocs(sourceFile, typeName);
-        if (docs) {
-            typeDocsCache.set(typeName, docs);
+        var result;
+        if (typeName) {
+            if (typeDocsCache.has(typeName)) {
+                result = typeDocsCache.get(typeName);
+            } else {
+                result = readTypeDocs(sourceFile, typeName);
+                if (result) {
+                    typeDocsCache.set(typeName, result);
+                }
+            }
         }
-        return docs;
+        return result;
     };
     if (crudConfigType) {
         var literal = crudConfigType.getTypeNode();
@@ -174,12 +175,14 @@ function extractCrudEntries(source) {
     };
 }
 function findTypeAliasByEnding(sourceFile, ending) {
+    var result;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = sourceFile.getTypeAliases()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var alias = _step.value;
             if (alias.getName().endsWith(ending) && alias.getTypeNode()) {
-                return alias;
+                result = alias;
+                break;
             }
         }
     } catch (err) {
@@ -196,9 +199,10 @@ function findTypeAliasByEnding(sourceFile, ending) {
             }
         }
     }
-    return undefined;
+    return result;
 }
 function findFunctionsClassName(sourceFile) {
+    var result;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = sourceFile.getClasses()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
@@ -208,7 +212,8 @@ function findFunctionsClassName(sourceFile) {
             }
             var name = cls.getName();
             if (name === null || name === void 0 ? void 0 : name.endsWith('Functions')) {
-                return name;
+                result = name;
+                break;
             }
         }
     } catch (err) {
@@ -225,9 +230,10 @@ function findFunctionsClassName(sourceFile) {
             }
         }
     }
-    return undefined;
+    return result;
 }
 function inferGroupName(sourceFile) {
+    var result;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = sourceFile.getTypeAliases()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
@@ -236,7 +242,8 @@ function inferGroupName(sourceFile) {
             if (name.endsWith('ModelCrudFunctionsConfig')) {
                 var stem = name.slice(0, -'ModelCrudFunctionsConfig'.length);
                 if (stem.length > 0) {
-                    return stem;
+                    result = stem;
+                    break;
                 }
             }
         }
@@ -254,42 +261,46 @@ function inferGroupName(sourceFile) {
             }
         }
     }
-    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-    try {
-        for(var _iterator1 = sourceFile.getTypeAliases()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-            var alias1 = _step1.value;
-            var name1 = alias1.getName();
-            if (name1.endsWith('FunctionTypeMap')) {
-                var stem1 = name1.slice(0, -'FunctionTypeMap'.length);
-                if (stem1.length > 0) {
-                    return stem1;
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError1 = true;
-        _iteratorError1 = err;
-    } finally{
+    if (result === undefined) {
+        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
         try {
-            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                _iterator1.return();
+            for(var _iterator1 = sourceFile.getTypeAliases()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                var alias1 = _step1.value;
+                var name1 = alias1.getName();
+                if (name1.endsWith('FunctionTypeMap')) {
+                    var stem1 = name1.slice(0, -'FunctionTypeMap'.length);
+                    if (stem1.length > 0) {
+                        result = stem1;
+                        break;
+                    }
+                }
             }
+        } catch (err) {
+            _didIteratorError1 = true;
+            _iteratorError1 = err;
         } finally{
-            if (_didIteratorError1) {
-                throw _iteratorError1;
+            try {
+                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                    _iterator1.return();
+                }
+            } finally{
+                if (_didIteratorError1) {
+                    throw _iteratorError1;
+                }
             }
         }
     }
-    return undefined;
+    return result;
 }
 function isNullLiteralType(node) {
+    var result = false;
     if (Node.isLiteralTypeNode(node)) {
         var literal = node.getLiteral();
         if (Node.isNullLiteral(literal)) {
-            return true;
+            result = true;
         }
     }
-    return false;
+    return result;
 }
 function collectVerbEntries(input) {
     var _readTupleParamsResult;
@@ -356,39 +367,40 @@ function collectVerbEntries(input) {
     });
 }
 function readTupleParamsResult(node) {
-    if (!Node.isTupleTypeNode(node)) {
-        return undefined;
-    }
-    var elements = node.getElements();
-    if (elements.length === 0) {
-        return undefined;
+    var pair;
+    if (Node.isTupleTypeNode(node)) {
+        var elements = node.getElements();
+        if (elements.length > 0) {
+            var params = elements[0] ? typeNodeName(elements[0]) : undefined;
+            var result = elements[1] ? typeNodeName(elements[1]) : undefined;
+            pair = {
+                params: params,
+                result: result
+            };
+        }
     }
-    var params = elements[0] ? typeNodeName(elements[0]) : undefined;
-    var result = elements[1] ? typeNodeName(elements[1]) : undefined;
-    return {
-        params: params,
-        result: result
-    };
+    return pair;
 }
 function readBareParams(node) {
     var params = typeNodeName(node);
-    if (!params) {
-        return undefined;
-    }
-    return {
+    return params ? {
         params: params,
         result: undefined
-    };
+    } : undefined;
 }
 function typeNodeName(node) {
+    var result;
     if (Node.isTypeReference(node)) {
-        return node.getTypeName().getText();
+        result = node.getTypeName().getText();
+    } else {
+        // Fall back to the raw text for primitive / inline types like `boolean`.
+        var text = node.getText().trim();
+        result = text.length > 0 ? text : undefined;
     }
-    // Fall back to the raw text for primitive / inline types like `boolean`.
-    var text = node.getText().trim();
-    return text.length > 0 ? text : undefined;
+    return result;
 }
 function readTypeDocs(sourceFile, typeName) {
+    var result;
     var interfaceDecl = sourceFile.getInterface(typeName);
     if (interfaceDecl) {
         var typeDescription = readJsDocSummary(interfaceDecl);
@@ -426,31 +438,36 @@ function readTypeDocs(sourceFile, typeName) {
                 }
             }
         }
-        if (!typeDescription && fields.length === 0) {
-            return undefined;
+        if (typeDescription || fields.length > 0) {
+            result = {
+                typeDescription: typeDescription,
+                fields: fields.length > 0 ? fields : undefined
+            };
+        }
+    } else {
+        var typeAlias = sourceFile.getTypeAlias(typeName);
+        if (typeAlias) {
+            var typeDescription1 = readJsDocSummary(typeAlias);
+            if (typeDescription1) {
+                result = {
+                    typeDescription: typeDescription1
+                };
+            }
         }
-        return {
-            typeDescription: typeDescription,
-            fields: fields.length > 0 ? fields : undefined
-        };
     }
-    var typeAlias = sourceFile.getTypeAlias(typeName);
-    if (typeAlias) {
-        var typeDescription1 = readJsDocSummary(typeAlias);
-        return typeDescription1 ? {
-            typeDescription: typeDescription1
-        } : undefined;
-    }
-    return undefined;
+    return result;
 }
 function readJsDocSummary(node) {
+    var result;
     var docs = node.getJsDocs();
-    if (docs.length === 0) {
-        return undefined;
+    if (docs.length > 0) {
+        var last = docs[docs.length - 1];
+        var description = last.getDescription().trim();
+        if (description.length > 0) {
+            result = description;
+        }
     }
-    var last = docs[docs.length - 1];
-    var description = last.getDescription().trim();
-    return description.length > 0 ? description : undefined;
+    return result;
 }
 
 function _define_property(obj, key, value) {
@@ -516,8 +533,8 @@ var OBJECT_FIELD_KEY = 'objectField';
  * Best-effort: a malformed call shape leaves the corresponding entry out
  * rather than throwing.
  *
- * @param input - in-memory `{ name, text }` source pair.
- * @returns the per-file extraction. Aggregation across files happens in the
+ * @param input - In-memory `{ name, text }` source pair.
+ * @returns The per-file extraction. Aggregation across files happens in the
  *   firebase-api-manifest orchestrator so cross-file converter consts can be
  *   resolved against a global registry.
  */ function extractModelsFromSource(input) {
@@ -714,8 +731,8 @@ function buildInterface(decl) {
  * through utility-wrapped declarations like
  * `extends Partial<MaybeMap<Omit<Base, '…'>>>`.
  *
- * @param expr - the `ExpressionWithTypeArguments` produced by `getExtends()`
- * @returns the resolved interface name, or the original leftmost identifier when no inner reference is reachable
+ * @param expr - The `ExpressionWithTypeArguments` produced by `getExtends()`
+ * @returns The resolved interface name, or the original leftmost identifier when no inner reference is reachable.
  */ function resolveExtendsName(expr) {
     var head = expr.getExpression().getText();
     var result = head;
@@ -820,20 +837,25 @@ function readGenericInterfaceName(call) {
 function readConverterFields(call) {
     var fnName = call.getExpression().getText();
     var args = call.getArguments();
-    if (args.length === 0) return undefined;
-    var config = args[0];
-    if (!Node.isObjectLiteralExpression(config)) return undefined;
-    var fieldsLiteral;
-    if (fnName === SNAPSHOT_FN) {
-        fieldsLiteral = readObjectProperty(config, FIELDS_LITERAL_KEY);
-    } else {
-        var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
-        if (objectField && Node.isObjectLiteralExpression(objectField)) {
-            fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
+    var result;
+    if (args.length > 0) {
+        var config = args[0];
+        if (Node.isObjectLiteralExpression(config)) {
+            var fieldsLiteral;
+            if (fnName === SNAPSHOT_FN) {
+                fieldsLiteral = readObjectProperty(config, FIELDS_LITERAL_KEY);
+            } else {
+                var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
+                if (objectField && Node.isObjectLiteralExpression(objectField)) {
+                    fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
+                }
+            }
+            if (fieldsLiteral) {
+                result = readFieldEntries(fieldsLiteral);
+            }
         }
     }
-    if (!fieldsLiteral) return undefined;
-    return readFieldEntries(fieldsLiteral);
+    return result;
 }
 function readFieldEntries(fields) {
     var out = [];
@@ -877,36 +899,41 @@ function readFieldEntries(fields) {
     return out;
 }
 function readNestedFromExpression(expr) {
-    if (!Node.isCallExpression(expr)) return undefined;
-    var fnName = expr.getExpression().getText();
-    if (fnName !== SUB_OBJECT_FN && fnName !== OBJECT_ARRAY_FN) return undefined;
-    var args = expr.getArguments();
-    if (args.length === 0) return undefined;
-    var config = args[0];
-    if (!Node.isObjectLiteralExpression(config)) return undefined;
-    var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
-    if (!objectField) return undefined;
-    var isArray = fnName === OBJECT_ARRAY_FN;
     var result;
-    if (Node.isIdentifier(objectField)) {
-        result = {
-            ref: objectField.getText(),
-            isArray: isArray
-        };
-    } else if (Node.isObjectLiteralExpression(objectField)) {
-        var fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
-        if (fieldsLiteral) {
-            var inlineFields = readFieldEntries(fieldsLiteral);
-            result = {
-                inline: {
-                    converterConst: undefined,
-                    factory: fnName,
-                    interfaceName: readGenericInterfaceName(expr),
-                    fields: inlineFields,
-                    line: expr.getStartLineNumber()
-                },
-                isArray: isArray
-            };
+    if (Node.isCallExpression(expr)) {
+        var fnName = expr.getExpression().getText();
+        if (fnName === SUB_OBJECT_FN || fnName === OBJECT_ARRAY_FN) {
+            var args = expr.getArguments();
+            if (args.length > 0) {
+                var config = args[0];
+                if (Node.isObjectLiteralExpression(config)) {
+                    var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
+                    if (objectField) {
+                        var isArray = fnName === OBJECT_ARRAY_FN;
+                        if (Node.isIdentifier(objectField)) {
+                            result = {
+                                ref: objectField.getText(),
+                                isArray: isArray
+                            };
+                        } else if (Node.isObjectLiteralExpression(objectField)) {
+                            var fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
+                            if (fieldsLiteral) {
+                                var inlineFields = readFieldEntries(fieldsLiteral);
+                                result = {
+                                    inline: {
+                                        converterConst: undefined,
+                                        factory: fnName,
+                                        interfaceName: readGenericInterfaceName(expr),
+                                        fields: inlineFields,
+                                        line: expr.getStartLineNumber()
+                                    },
+                                    isArray: isArray
+                                };
+                            }
+                        }
+                    }
+                }
+            }
         }
     }
     return result;

package/manifest-extract/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli/manifest-extract",
-  "version": "13.11.14",
+  "version": "13.11.16",
   "sideEffects": false,
   "peerDependencies": {
     "ts-morph": "^21.0.0"

package/manifest-extract/src/lib/extract-crud.d.ts

@@ -29,8 +29,8 @@ export interface ExtractCrudInput {
  * callable leaf (CRUD or standalone). Best-effort: malformed configs return
  * fewer entries rather than throwing.
  *
- * @param source - in-memory source name + text pair to extract
- * @returns the CRUD extraction with group name, model keys, entries, and
+ * @param source - In-memory source name + text pair to extract.
+ * @returns The CRUD extraction with group name, model keys, entries, and
  *   `*Functions` class name (when present).
  */
 export declare function extractCrudEntries(source: ExtractCrudInput): CrudExtraction;

package/manifest-extract/src/lib/extract-models.d.ts

@@ -25,8 +25,8 @@ export interface ExtractModelsFromSourceInput {
  * Best-effort: a malformed call shape leaves the corresponding entry out
  * rather than throwing.
  *
- * @param input - in-memory `{ name, text }` source pair.
- * @returns the per-file extraction. Aggregation across files happens in the
+ * @param input - In-memory `{ name, text }` source pair.
+ * @returns The per-file extraction. Aggregation across files happens in the
  *   firebase-api-manifest orchestrator so cross-file converter consts can be
  *   resolved against a global registry.
  */

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@dereekb/dbx-cli",
-  "version": "13.11.14",
+  "version": "13.11.16",
   "sideEffects": false,
   "bin": {
-    "dbx-cli-generate-firebase-api-manifest": "firebase-api-manifest/main.js"
+    "dbx-cli-generate-firebase-api-manifest": "firebase-api-manifest/main.js",
+    "dbx-cli-generate-firestore-indexes": "generate-firestore-indexes/main.js",
+    "dbx-cli-lint-cache": "lint-cache/main.js"
   },
   "exports": {
     "./firebase-api-manifest": {
       "default": "./firebase-api-manifest/main.js"
     },
+    "./generate-firestore-indexes": {
+      "default": "./generate-firestore-indexes/main.js"
+    },
+    "./lint-cache": {
+      "default": "./lint-cache/main.js"
+    },
     "./manifest-extract": {
       "module": "./manifest-extract/index.esm.js",
       "types": "./manifest-extract/index.d.ts",
@@ -30,15 +38,16 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/date": "13.11.14",
-    "@dereekb/firebase": "13.11.14",
-    "@dereekb/nestjs": "13.11.14",
-    "@dereekb/util": "13.11.14",
+    "@dereekb/date": "13.11.16",
+    "@dereekb/firebase": "13.11.16",
+    "@dereekb/nestjs": "13.11.16",
+    "@dereekb/util": "13.11.16",
     "arktype": "^2.2.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@types/yargs": "^17.0.35"
+    "@types/yargs": "^17.0.35",
+    "eslint": "10.4.0"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/lib/action/iterate.d.ts

@@ -203,6 +203,9 @@ export interface IterateDbxCliCallModelResult<TItem, TItemResult, TPageResult> {
  * Concurrency: pages are fetched serially (cursor dependency); items within a page can run
  * in parallel via `maxParallelPerPage` (forwarded to `performAsyncTasks`).
  *
+ * @param config - Iterator configuration.
+ * @returns The aggregate result.
+ *
  * @example
  * ```ts
  * // Exhaust every published Guestbook entry for a single Guestbook.
@@ -212,7 +215,6 @@ export interface IterateDbxCliCallModelResult<TItem, TItemResult, TPageResult> {
  *   params: { guestbook: 'gb/abc', published: true }
  * });
  * ```
- *
  * @example
  * ```ts
  * // Fan out to a child action per Guestbook, with 4-way parallelism per page.
@@ -224,8 +226,5 @@ export interface IterateDbxCliCallModelResult<TItem, TItemResult, TPageResult> {
  *   iterateItem: ({ context, key }) => queryGuestbookEntriesForGuestbook({ context, guestbook: key, published: true })
  * });
  * ```
- *
- * @param config - Iterator configuration.
- * @returns The aggregate result.
  */
 export declare function iterateDbxCliCallModel<TParams, TItem, TRaw = OnCallQueryModelResult<TItem>, TItemResult = void, TPageResult = void>(config: IterateDbxCliCallModelConfig<TParams, TItem, TRaw, TItemResult, TPageResult>): Promise<IterateDbxCliCallModelResult<TItem, TItemResult, TPageResult>>;

package/src/lib/api/call.passthrough.command.d.ts

@@ -5,4 +5,4 @@ import type { CommandModule } from 'yargs';
  * Provides direct access to the demo-api's typed model dispatch without typed wrappers — useful
  * for ad-hoc admin tasks, scripting, and the MVP demo CLI before model-specific commands ship.
  */
-export declare const callPassthroughCommand: CommandModule;
+export declare const CALL_PASSTHROUGH_COMMAND: CommandModule;

package/src/lib/api/expand-keys.d.ts

@@ -4,9 +4,10 @@ import type { CliModelManifest, CliModelManifestEntry } from '../manifest/types'
  * `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.
+ * @param modelType - Identifier to look up.
+ * @param manifest - Generated model manifest.
+ * @returns The matching entry, or `undefined` when none exists.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function findCliModelManifestEntry(modelType: string, manifest: CliModelManifest): CliModelManifestEntry | undefined;
@@ -20,12 +21,13 @@ export declare function findCliModelManifestEntry(modelType: string, manifest: C
  * Unknown keys, primitives, `Date`, `null`, and `undefined` pass through
  * unchanged.
  *
- * @param modelType - the model identifier (`modelType`, `identityConst`,
+ * @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
+ * @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.
+ * @param manifest - Generated model manifest.
+ * @returns The rewritten value, or `data` unchanged when no rewrite applies.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function expandModelKeys(modelType: string, data: unknown, manifest: CliModelManifest): unknown;

package/src/lib/api/get-args.helper.d.ts

@@ -26,10 +26,13 @@ export interface ParsedGetManyArgs {
  *    {@link CliError} if the manifest is missing, the prefix is unresolved, or the leaf
  *    has no `modelType`.
  *
+ * @param input - Positionals captured by yargs plus the optional model manifest.
  * @param input.modelOrKey - The first positional from yargs.
  * @param input.key - The optional second positional from yargs.
  * @param input.manifest - The generated model manifest (for prefix lookup).
  * @returns The parsed `{ modelType, key }` pair.
+ * @throws {CliError} When `modelOrKey` is missing, when no manifest is wired but inference is required, when the bare positional is not a full key, or when the manifest cannot resolve the key's prefix.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function parseGetArgs(input: {
@@ -48,10 +51,13 @@ export declare function parseGetArgs(input: {
  *
  * Always rejects empty key lists and lists exceeding 50 keys.
  *
+ * @param input - Positionals captured by yargs plus the optional model manifest.
  * @param input.firstArg - The first positional from yargs.
  * @param input.rest - The remaining positionals from yargs.
  * @param input.manifest - The generated model manifest (used only in the inferred-key branch).
  * @returns The parsed `{ modelType, keys }` pair.
+ * @throws {CliError} When positionals are missing, when an inferred-key call lacks a manifest, when one or more keys cannot be resolved, or when the keys span multiple `modelType`s.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function parseGetManyArgs(input: {

package/src/lib/api/get-many.command.d.ts

@@ -12,4 +12,4 @@ import type { CommandModule } from 'yargs';
  *
  * Backend: `POST <apiBaseUrl>/model/<modelType>/get` with body `{ keys }` (ModelApiController.getMany).
  */
-export declare const getManyCommand: CommandModule;
+export declare const GET_MANY_COMMAND: CommandModule;

package/src/lib/api/get.command.d.ts

@@ -9,4 +9,4 @@ import type { CommandModule } from 'yargs';
  *
  * Backend: `GET <apiBaseUrl>/model/<modelType>/get?key=<key>` (ModelApiController.getOne).
  */
-export declare const getCommand: CommandModule;
+export declare const GET_COMMAND: CommandModule;

package/src/lib/auth/oidc.flow.d.ts

@@ -68,6 +68,8 @@ export interface BuildAuthorizationUrlInput {
  * @param input.state - The opaque OAuth state token used for CSRF protection.
  * @param input.codeChallenge - The PKCE code challenge derived from the verifier.
  * @returns The full authorization URL with all OAuth params merged in.
+ * @throws {CliError} When `requestedSessionTtlSeconds` is provided but is not a positive integer.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function buildAuthorizationUrl(input: BuildAuthorizationUrlInput): string;
@@ -104,5 +106,6 @@ export interface ParsedRedirect {
  * @param input.pasted - The redirect URL or bare authorization code pasted by the user.
  * @param input.expectedState - Optional state value to assert against `state` when present in the URL.
  * @returns The {@link ParsedRedirect} containing `code` and (when present) `state`.
+ * @throws {CliError} When `pasted` is empty, when the URL contains no `code` parameter, or when `expectedState` does not match the URL's `state`.
  */
 export declare function parsePastedRedirect(input: ParsePastedRedirectInput): ParsedRedirect;

package/src/lib/manifest/build-manifest-commands.d.ts

@@ -125,7 +125,7 @@ export declare function buildManifestCommands(manifest: CliApiManifest, options?
  * value is needed when each command's builder runs — which is before yargs
  * parses argv. Unrecognized values fall back to the default.
  *
- * @param argv - argv to inspect (defaults to `process.argv`).
+ * @param argv - Argv to inspect (defaults to `process.argv`).
  * @returns The detected format, or {@link DEFAULT_MANIFEST_HELP_DATA_FORMAT}.
  */
 export declare function detectDataHelpFormat(argv?: readonly string[]): ManifestHelpDataFormat;
@@ -138,7 +138,7 @@ export declare function detectDataHelpFormat(argv?: readonly string[]): Manifest
  * value is needed when each command's builder runs — which is before yargs
  * parses argv.
  *
- * @param argv - argv to inspect (defaults to `process.argv`).
+ * @param argv - Argv to inspect (defaults to `process.argv`).
  * @returns The detected mode, or {@link DEFAULT_MANIFEST_HELP_MODE}.
  */
 export declare function detectHelpMode(argv?: readonly string[]): ManifestHelpMode;
@@ -162,6 +162,8 @@ export declare function detectHelpMode(argv?: readonly string[]): ManifestHelpMo
  * @param manifest - The generated model manifest used to look up the model's `collectionPrefix`
  *   and `parentIdentityConst`. When omitted, the key passes through unchanged.
  * @returns The resolved Firestore model key ready for `context.getModel(model, key)`.
+ * @throws {CliError} When `model` resolves to a subcollection entry and only a bare doc id is supplied.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function resolvePerModelGetKey(model: string, key: string, manifest: CliModelManifest | undefined): string;