@dereekb/firebase 13.12.7 → 13.12.9

package/eslint/index.cjs.js

@@ -1863,10 +1863,10 @@ function _unsupported_iterable_to_array$e(o, minLen) {
             return result;
         }
         function pushFrame(node) {
-            var _ref;
+            var _stack_at, _ref;
             var anchor = getFunctionJsdocAnchor(node);
             var tagged = anchor ? jsdocHasMarker(anchor) : false;
-            var parent = stack.length > 0 ? stack[stack.length - 1] : null;
+            var parent = (_stack_at = stack.at(-1)) !== null && _stack_at !== void 0 ? _stack_at : null;
             var taggedDeep = tagged || ((_ref = parent === null || parent === void 0 ? void 0 : parent.taggedDeep) !== null && _ref !== void 0 ? _ref : false);
             stack.push({
                 node: node,
@@ -1875,7 +1875,8 @@ function _unsupported_iterable_to_array$e(o, minLen) {
             });
         }
         function popFrame(node) {
-            if (stack.length > 0 && stack[stack.length - 1].node === node) {
+            var _stack_at;
+            if (((_stack_at = stack.at(-1)) === null || _stack_at === void 0 ? void 0 : _stack_at.node) === node) {
                 stack.pop();
             }
         }
@@ -2137,6 +2138,19 @@ var DEFAULT_KNOWN_COMPANIONS = [
     'Path',
     'Helper'
 ];
+function extractGenericIdentifier(callNode) {
+    var _callNode_typeArguments;
+    var params = (_callNode_typeArguments = callNode.typeArguments) !== null && _callNode_typeArguments !== void 0 ? _callNode_typeArguments : callNode.typeParameters;
+    var result = null;
+    if (params && Array.isArray(params.params) && params.params.length > 0) {
+        var _first_typeName;
+        var first = params.params[0];
+        if ((first === null || first === void 0 ? void 0 : first.type) === 'TSTypeReference' && ((_first_typeName = first.typeName) === null || _first_typeName === void 0 ? void 0 : _first_typeName.type) === 'Identifier') {
+            result = first.typeName.name;
+        }
+    }
+    return result;
+}
 /**
  * ESLint rule enforcing `@dbxModelFirebaseIndex` companion tags and body coherence.
  * Mirrors the scanner schema at
@@ -2552,19 +2566,6 @@ var DEFAULT_KNOWN_COMPANIONS = [
                 }
             }
         }
-        function extractGenericIdentifier(callNode) {
-            var _callNode_typeArguments;
-            var params = (_callNode_typeArguments = callNode.typeArguments) !== null && _callNode_typeArguments !== void 0 ? _callNode_typeArguments : callNode.typeParameters;
-            var result = null;
-            if (params && Array.isArray(params.params) && params.params.length > 0) {
-                var _first_typeName;
-                var first = params.params[0];
-                if ((first === null || first === void 0 ? void 0 : first.type) === 'TSTypeReference' && ((_first_typeName = first.typeName) === null || _first_typeName === void 0 ? void 0 : _first_typeName.type) === 'Identifier') {
-                    result = first.typeName.name;
-                }
-            }
-            return result;
-        }
         function checkBody(node, parsed) {
             if (!checkBodyCoherence) return;
             var skip = getSkipTagValue(parsed);
@@ -2653,6 +2654,15 @@ function _type_of$8(obj) {
 /**
  * Default suffix used to recognise a presumed-tagged query factory by name (single-file scope).
  */ var DEFAULT_PRESUMED_TAGGED_SUFFIX = 'Query';
+function recordVariableDeclarator(node, emptyArrayDeclarators) {
+    var _node_id, _node_init;
+    if (((_node_id = node.id) === null || _node_id === void 0 ? void 0 : _node_id.type) === 'Identifier' && ((_node_init = node.init) === null || _node_init === void 0 ? void 0 : _node_init.type) === 'ArrayExpression' && Array.isArray(node.init.elements) && node.init.elements.length === 0) {
+        emptyArrayDeclarators.push({
+            node: node,
+            name: node.id.name
+        });
+    }
+}
 /**
  * ESLint rule enforcing that `@dbxModelFirebaseIndexDispatcher`-tagged factories delegate to
  * other `@dbxModelFirebaseIndex`-tagged query factories instead of building constraints directly.
@@ -2776,15 +2786,6 @@ function _type_of$8(obj) {
                 pushReceivers.add(node.callee.object.name);
             }
         }
-        function recordVariableDeclarator(node, emptyArrayDeclarators) {
-            var _node_id, _node_init;
-            if (((_node_id = node.id) === null || _node_id === void 0 ? void 0 : _node_id.type) === 'Identifier' && ((_node_init = node.init) === null || _node_init === void 0 ? void 0 : _node_init.type) === 'ArrayExpression' && Array.isArray(node.init.elements) && node.init.elements.length === 0) {
-                emptyArrayDeclarators.push({
-                    node: node,
-                    name: node.id.name
-                });
-            }
-        }
         function scanBody(body) {
             var constraintCalls = [];
             var emptyArrayDeclarators = [];
@@ -2952,6 +2953,11 @@ function _unsupported_iterable_to_array$d(o, minLen) {
     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$d(o, minLen);
 }
+function hasTypeArgument(node) {
+    var _node_typeArguments;
+    var args = (_node_typeArguments = node.typeArguments) !== null && _node_typeArguments !== void 0 ? _node_typeArguments : node.typeParameters;
+    return Boolean(args && Array.isArray(args.params) && args.params.length > 0);
+}
 /**
  * ESLint rule that warns when an `@dereekb/firebase` field-path-narrowing constraint factory
  * (`where`, `orderBy`) is called without a generic type argument. Without `<Model>`, the
@@ -3026,11 +3032,6 @@ function _unsupported_iterable_to_array$d(o, minLen) {
             }
             return result;
         }
-        function hasTypeArgument(node) {
-            var _node_typeArguments;
-            var args = (_node_typeArguments = node.typeArguments) !== null && _node_typeArguments !== void 0 ? _node_typeArguments : node.typeParameters;
-            return Boolean(args && Array.isArray(args.params) && args.params.length > 0);
-        }
         return {
             ImportDeclaration: function ImportDeclaration(node) {
                 return trackImportDeclaration(registry, node);
@@ -12649,29 +12650,29 @@ var PATH_SEPARATOR = '/';
         var env = new Map();
         bindParamsAsWildcards((_fn_params = fn.params) !== null && _fn_params !== void 0 ? _fn_params : [], env);
         var body = functionBodyExpression(fn);
-        if (!body) {
-            result = {
-                ok: false,
-                reason: 'buildUploadPath body is not a single return expression'
-            };
-        } else {
+        if (body) {
             var frags = foldFrags(body, {
                 scope: scope,
                 env: env
             }, 0);
-            if (!frags) {
-                result = {
-                    ok: false,
-                    reason: 'buildUploadPath does not fold to a constant path (unknown const, unmodeled call, or runtime value)'
-                };
-            } else {
+            if (frags) {
                 result = {
                     ok: true,
                     path: {
                         segments: fragsToSegments(frags)
                     }
                 };
+            } else {
+                result = {
+                    ok: false,
+                    reason: 'buildUploadPath does not fold to a constant path (unknown const, unmodeled call, or runtime value)'
+                };
             }
+        } else {
+            result = {
+                ok: false,
+                reason: 'buildUploadPath body is not a single return expression'
+            };
         }
     }
     return result;
@@ -13611,9 +13612,7 @@ function applyNumericOperator(operator, left, right) {
     for(var i = 0; result && i < folded.segments.length; i++){
         var a = folded.segments[i];
         var b = ruleSegments[i];
-        if (a.kind !== b.kind) {
-            result = false;
-        } else if (a.kind === 'literal' && a.value !== b.value) {
+        if (a.kind !== b.kind || a.kind === 'literal' && a.value !== b.value) {
             result = false;
         }
     }
@@ -17243,20 +17242,19 @@ var SPEC_SUFFIX = '.spec.ts';
  */ function classifySpecFile(config) {
     var filename = config.filename, parentFolderName = config.parentFolderName;
     var result;
-    if (!filename.endsWith(SPEC_SUFFIX)) {
-        result = {
-            filename: filename,
-            group: '',
-            kind: 'non-spec',
-            subgroups: [],
-            isCanonical: false
-        };
-    } else {
+    if (filename.endsWith(SPEC_SUFFIX)) {
         var _parts_;
         var stem = filename.slice(0, -SPEC_SUFFIX.length);
         var parts = stem.split('.');
         var group = (_parts_ = parts[0]) !== null && _parts_ !== void 0 ? _parts_ : '';
-        if (group !== parentFolderName) {
+        if (group === parentFolderName) {
+            var rest = parts.slice(1);
+            result = classifyRemainingSegments({
+                filename: filename,
+                group: group,
+                rest: rest
+            });
+        } else {
             result = {
                 filename: filename,
                 group: group,
@@ -17264,14 +17262,15 @@ var SPEC_SUFFIX = '.spec.ts';
                 subgroups: [],
                 isCanonical: false
             };
-        } else {
-            var rest = parts.slice(1);
-            result = classifyRemainingSegments({
-                filename: filename,
-                group: group,
-                rest: rest
-            });
         }
+    } else {
+        result = {
+            filename: filename,
+            group: '',
+            kind: 'non-spec',
+            subgroups: [],
+            isCanonical: false
+        };
     }
     return result;
 }
@@ -17638,6 +17637,282 @@ function hasCrudSpec(groupDir, group) {
     }
 };
 
+/**
+ * JSDoc marker tag that every CRUD params interface should carry so the dbx-components manifest
+ * extractor (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) records it as an
+ * intentionally-exposed API params type rather than an untagged one.
+ */ var DBX_MODEL_API_PARAMS_MARKER = 'dbxModelApiParams';
+/**
+ * Suffix on the type alias that declares a model-group CRUD function config (e.g.
+ * `GuestbookModelCrudFunctionsConfig`). Its referenced params interfaces are the ones the marker
+ * tag is required on.
+ */ var DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX = 'ModelCrudFunctionsConfig';
+/**
+ * Suffix on the type alias that declares a group's standalone function type map (e.g.
+ * `GuestbookFunctionTypeMap`). Each entry's params type is also subject to the marker tag.
+ */ var DEFAULT_FUNCTION_TYPE_MAP_SUFFIX = 'FunctionTypeMap';
+/**
+ * Returns the first element type node of a `TSTupleType`, normalizing across `@typescript-eslint`
+ * versions (`elementTypes` historically, `elements` in newer releases). CRUD config tuples take the
+ * form `[Params, Result]`, so element 0 is always the params type.
+ *
+ * @param node - A `TSTupleType` node.
+ * @returns The first element type node, or null when the tuple is empty.
+ */ function tupleFirstElement(node) {
+    var _ref, _ref1;
+    var elements = (_ref = node === null || node === void 0 ? void 0 : node.elementTypes) !== null && _ref !== void 0 ? _ref : node === null || node === void 0 ? void 0 : node.elements;
+    return (_ref1 = elements === null || elements === void 0 ? void 0 : elements[0]) !== null && _ref1 !== void 0 ? _ref1 : null;
+}
+/**
+ * Recursively collects the params type-reference names declared by a CRUD config / function-type-map
+ * type node into `out`, mirroring the resolution in `extract-crud.ts`. A bare `TSTypeReference`
+ * (`create: CreateGuestbookParams`) contributes its referenced name; a `TSTupleType`
+ * (`query: [QueryGuestbooksParams, OnCallQueryModelResult<...>]`) contributes element 0 only, since
+ * element 1 is the result type; and a `TSTypeLiteral` (model literal, verb literal, or
+ * `{ specifier: ... }` object) is recursed into per property-signature value. Generic type arguments
+ * on a reference are intentionally not descended into — only the params type itself is collected.
+ *
+ * @param node - The type node to inspect.
+ * @param out - The accumulating set of params type-reference names.
+ */ function collectParamsTypeNames(node, out) {
+    if (!node) {
+        return;
+    }
+    if (node.type === 'TSTypeReference') {
+        var name = typeReferenceTypeName$1(node);
+        if (name) {
+            out.add(name);
+        }
+    } else if (node.type === 'TSTupleType') {
+        collectParamsTypeNames(tupleFirstElement(node), out);
+    } else if (node.type === 'TSTypeLiteral' && Array.isArray(node.members)) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = node.members[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var member = _step.value;
+                if ((member === null || member === void 0 ? void 0 : member.type) === 'TSPropertySignature') {
+                    var _member_typeAnnotation;
+                    collectParamsTypeNames((_member_typeAnnotation = member.typeAnnotation) === null || _member_typeAnnotation === void 0 ? void 0 : _member_typeAnnotation.typeAnnotation, out);
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+}
+/**
+ * Returns the inner declaration node when `statement` is (or wraps) a `TSInterfaceDeclaration`, along
+ * with the statement-level anchor ESLint attaches leading comments to.
+ *
+ * @param statement - A top-level `Program.body` statement.
+ * @returns The interface declaration + its JSDoc anchor, or null when the statement is not an interface.
+ */ function interfaceFromStatement(statement) {
+    var _statement_declaration;
+    var result = null;
+    if ((statement === null || statement === void 0 ? void 0 : statement.type) === 'TSInterfaceDeclaration') {
+        result = {
+            decl: statement,
+            anchor: statement
+        };
+    } else if (((statement === null || statement === void 0 ? void 0 : statement.type) === 'ExportNamedDeclaration' || (statement === null || statement === void 0 ? void 0 : statement.type) === 'ExportDefaultDeclaration') && ((_statement_declaration = statement.declaration) === null || _statement_declaration === void 0 ? void 0 : _statement_declaration.type) === 'TSInterfaceDeclaration') {
+        result = {
+            decl: statement.declaration,
+            anchor: statement
+        };
+    }
+    return result;
+}
+/**
+ * Returns true when the interface's leading JSDoc carries the given marker tag.
+ *
+ * @param sourceCode - The ESLint `SourceCode` object.
+ * @param anchor - The interface's JSDoc anchor node.
+ * @param tagName - The marker tag name (without the leading `@`).
+ * @returns True when the marker tag is present on the interface's JSDoc.
+ */ function interfaceHasMarker(sourceCode, anchor, tagName) {
+    var jsdoc = leadingJsdocFor(sourceCode, anchor);
+    var result = false;
+    if (jsdoc) {
+        var parsed = parseJsdocComment(jsdoc.value);
+        result = parsed.tags.some(function(tag) {
+            return tag.tag === tagName;
+        });
+    }
+    return result;
+}
+/**
+ * ESLint rule that requires every params interface referenced by a `*ModelCrudFunctionsConfig` (and,
+ * by default, `*FunctionTypeMap`) type alias and declared in the same file to carry the
+ * `@dbxModelApiParams` JSDoc marker tag.
+ *
+ * The marker is the signal the dbx-components manifest extractor
+ * (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) reads to distinguish an
+ * intentionally-exposed API params type from an untagged one — missing it produces the
+ * `[no-api-params-tag]` build warning and the "Missing `@dbxModelApiParams` marker" hint in the
+ * `dbx_model_api_lookup` MCP tool. This rule surfaces the same gap in-editor at lint time.
+ *
+ * Same-file resolution only — matching the extractor, which itself resolves params interfaces from a
+ * single in-memory source file. Params types declared in another file (e.g. shared base params like
+ * `TargetModelParams`) are skipped, exactly as the extractor reports them as unresolved.
+ *
+ * @example
+ * ```ts
+ * export type GuestbookModelCrudFunctionsConfig = {
+ *   guestbook: { create: CreateGuestbookParams };
+ * };
+ *
+ * // OK
+ * /**
+ *  * @dbxModelApiParams
+ *  *\/
+ * export interface CreateGuestbookParams { readonly name: string; }
+ *
+ * // WARN — missingApiParamsTag
+ * export interface CreateGuestbookParams { readonly name: string; }
+ * ```
+ */ var FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE = {
+    meta: {
+        type: 'suggestion',
+        fixable: undefined,
+        docs: {
+            description: 'Require the `@dbxModelApiParams` marker tag on params interfaces referenced by a `*ModelCrudFunctionsConfig` / `*FunctionTypeMap` alias and declared in the same file, mirroring the manifest extractor that reads the tag.',
+            recommended: true
+        },
+        messages: {
+            missingApiParamsTag: 'Params interface "{{name}}" is referenced by the CRUD config "{{configName}}" but is missing the `@{{tag}}` marker. Add `@{{tag}}` to its JSDoc so the manifest extractor records it as an intentionally-exposed API params type.'
+        },
+        schema: [
+            {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    configTypeSuffix: {
+                        type: 'string'
+                    },
+                    alsoFunctionTypeMap: {
+                        type: 'boolean'
+                    },
+                    tagName: {
+                        type: 'string'
+                    }
+                }
+            }
+        ]
+    },
+    create: function create(context) {
+        var _context_options_, _options_configTypeSuffix, _options_tagName;
+        var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
+        var configTypeSuffix = (_options_configTypeSuffix = options.configTypeSuffix) !== null && _options_configTypeSuffix !== void 0 ? _options_configTypeSuffix : DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX;
+        var alsoFunctionTypeMap = options.alsoFunctionTypeMap !== false;
+        var tagName = (_options_tagName = options.tagName) !== null && _options_tagName !== void 0 ? _options_tagName : DBX_MODEL_API_PARAMS_MARKER;
+        var sourceCode = context.sourceCode;
+        function isConfigAliasName(name) {
+            return name.endsWith(configTypeSuffix) || alsoFunctionTypeMap && name.endsWith(DEFAULT_FUNCTION_TYPE_MAP_SUFFIX);
+        }
+        return {
+            Program: function Program(programNode) {
+                var _ref;
+                var body = (_ref = programNode === null || programNode === void 0 ? void 0 : programNode.body) !== null && _ref !== void 0 ? _ref : [];
+                // Index the interfaces declared in this file by name (same-file resolution, like the extractor).
+                var interfaces = new Map();
+                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(var _iterator = body[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        var statement = _step.value;
+                        var _found_decl_id, _found_decl;
+                        var found = interfaceFromStatement(statement);
+                        if ((found === null || found === void 0 ? void 0 : (_found_decl = found.decl) === null || _found_decl === void 0 ? void 0 : (_found_decl_id = _found_decl.id) === null || _found_decl_id === void 0 ? void 0 : _found_decl_id.type) === 'Identifier') {
+                            interfaces.set(found.decl.id.name, found);
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = body[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var statement1 = _step1.value;
+                        var _statement_declaration, _alias_id;
+                        var alias = (statement1 === null || statement1 === void 0 ? void 0 : statement1.type) === 'TSTypeAliasDeclaration' ? statement1 : (statement1 === null || statement1 === void 0 ? void 0 : statement1.type) === 'ExportNamedDeclaration' && ((_statement_declaration = statement1.declaration) === null || _statement_declaration === void 0 ? void 0 : _statement_declaration.type) === 'TSTypeAliasDeclaration' ? statement1.declaration : null;
+                        if (!alias || ((_alias_id = alias.id) === null || _alias_id === void 0 ? void 0 : _alias_id.type) !== 'Identifier' || !isConfigAliasName(alias.id.name)) {
+                            continue;
+                        }
+                        var paramsNames = new Set();
+                        collectParamsTypeNames(alias.typeAnnotation, paramsNames);
+                        var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+                        try {
+                            for(var _iterator2 = paramsNames[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+                                var paramsName = _step2.value;
+                                var target = interfaces.get(paramsName);
+                                // Skip params types not declared in this file — the extractor cannot resolve them either.
+                                if (target && !interfaceHasMarker(sourceCode, target.anchor, tagName)) {
+                                    context.report({
+                                        node: target.decl.id,
+                                        messageId: 'missingApiParamsTag',
+                                        data: {
+                                            name: paramsName,
+                                            configName: alias.id.name,
+                                            tag: tagName
+                                        }
+                                    });
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError2 = true;
+                            _iteratorError2 = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                                    _iterator2.return();
+                                }
+                            } finally{
+                                if (_didIteratorError2) {
+                                    throw _iteratorError2;
+                                }
+                            }
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
+                }
+            }
+        };
+    }
+};
+
 /**
  * ESLint plugin for `@dereekb/firebase` rules.
  *
@@ -17659,7 +17934,8 @@ function hasCrudSpec(groupDir, group) {
         'require-service-factory-for-dbx-model': FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE,
         'require-dbx-model-companion-tags': FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE,
         'require-canonical-api-spec-filename': FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE,
-        'require-api-crud-spec-for-group': FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE
+        'require-api-crud-spec-for-group': FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE,
+        'require-dbx-model-api-params-tag': FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE
     }
 };
 /**
@@ -17669,10 +17945,12 @@ function hasCrudSpec(groupDir, group) {
  */ var firebaseESLintPlugin = FIREBASE_ESLINT_PLUGIN;
 
 exports.API_DETAILS_IMPORT_MODULE = API_DETAILS_IMPORT_MODULE;
+exports.DBX_MODEL_API_PARAMS_MARKER = DBX_MODEL_API_PARAMS_MARKER;
 exports.DBX_MODEL_FIREBASE_INDEX_MARKER = DBX_MODEL_FIREBASE_INDEX_MARKER;
 exports.DBX_MODEL_SERVICE_FACTORY_TAG = DBX_MODEL_SERVICE_FACTORY_TAG;
 exports.DEFAULT_API_DETAILS_FACTORY_NAME = DEFAULT_API_DETAILS_FACTORY_NAME;
 exports.DEFAULT_CONSTRAINT_FACTORY_NAMES = DEFAULT_CONSTRAINT_FACTORY_NAMES;
+exports.DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX = DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX;
 exports.DEFAULT_CRUD_FUNCTION_TYPE_VERBS = DEFAULT_CRUD_FUNCTION_TYPE_VERBS;
 exports.DEFAULT_CRUD_VERB_NAMES = DEFAULT_CRUD_VERB_NAMES;
 exports.DEFAULT_DISCOVERY_EXCLUDED_DIRS = DEFAULT_DISCOVERY_EXCLUDED_DIRS;
@@ -17680,6 +17958,7 @@ exports.DEFAULT_FACTORY_SEARCH_ROOTS = DEFAULT_FACTORY_SEARCH_ROOTS;
 exports.DEFAULT_FACTORY_TAG = DEFAULT_FACTORY_TAG;
 exports.DEFAULT_FIRESTORE_RULES_FILENAME = DEFAULT_FIRESTORE_RULES_FILENAME;
 exports.DEFAULT_FUNCTION_DIR_SEGMENT = DEFAULT_FUNCTION_DIR_SEGMENT;
+exports.DEFAULT_FUNCTION_TYPE_MAP_SUFFIX = DEFAULT_FUNCTION_TYPE_MAP_SUFFIX;
 exports.DEFAULT_IDENTITY_FACTORY_NAME = DEFAULT_IDENTITY_FACTORY_NAME;
 exports.DEFAULT_INDEX_AFFECTING_CONSTRAINT_NAMES = DEFAULT_INDEX_AFFECTING_CONSTRAINT_NAMES;
 exports.DEFAULT_MODEL_MARKER_TAG = DEFAULT_MODEL_MARKER_TAG;
@@ -17696,6 +17975,7 @@ exports.FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE = FIREBASE_REQUIRE_API_CRU
 exports.FIREBASE_REQUIRE_API_DETAILS_FOR_CRUD_FUNCTION_RULE = FIREBASE_REQUIRE_API_DETAILS_FOR_CRUD_FUNCTION_RULE;
 exports.FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE = FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE;
 exports.FIREBASE_REQUIRE_COMPLETE_CRUD_FUNCTION_CONFIG_MAP_RULE = FIREBASE_REQUIRE_COMPLETE_CRUD_FUNCTION_CONFIG_MAP_RULE;
+exports.FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE = FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE;
 exports.FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE = FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE;
 exports.FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_COMPANION_TAGS_RULE = FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_COMPANION_TAGS_RULE;
 exports.FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_QUERY_SUFFIX_RULE = FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_QUERY_SUFFIX_RULE;

package/eslint/index.esm.js

@@ -1861,10 +1861,10 @@ function _unsupported_iterable_to_array$e(o, minLen) {
             return result;
         }
         function pushFrame(node) {
-            var _ref;
+            var _stack_at, _ref;
             var anchor = getFunctionJsdocAnchor(node);
             var tagged = anchor ? jsdocHasMarker(anchor) : false;
-            var parent = stack.length > 0 ? stack[stack.length - 1] : null;
+            var parent = (_stack_at = stack.at(-1)) !== null && _stack_at !== void 0 ? _stack_at : null;
             var taggedDeep = tagged || ((_ref = parent === null || parent === void 0 ? void 0 : parent.taggedDeep) !== null && _ref !== void 0 ? _ref : false);
             stack.push({
                 node: node,
@@ -1873,7 +1873,8 @@ function _unsupported_iterable_to_array$e(o, minLen) {
             });
         }
         function popFrame(node) {
-            if (stack.length > 0 && stack[stack.length - 1].node === node) {
+            var _stack_at;
+            if (((_stack_at = stack.at(-1)) === null || _stack_at === void 0 ? void 0 : _stack_at.node) === node) {
                 stack.pop();
             }
         }
@@ -2135,6 +2136,19 @@ var DEFAULT_KNOWN_COMPANIONS = [
     'Path',
     'Helper'
 ];
+function extractGenericIdentifier(callNode) {
+    var _callNode_typeArguments;
+    var params = (_callNode_typeArguments = callNode.typeArguments) !== null && _callNode_typeArguments !== void 0 ? _callNode_typeArguments : callNode.typeParameters;
+    var result = null;
+    if (params && Array.isArray(params.params) && params.params.length > 0) {
+        var _first_typeName;
+        var first = params.params[0];
+        if ((first === null || first === void 0 ? void 0 : first.type) === 'TSTypeReference' && ((_first_typeName = first.typeName) === null || _first_typeName === void 0 ? void 0 : _first_typeName.type) === 'Identifier') {
+            result = first.typeName.name;
+        }
+    }
+    return result;
+}
 /**
  * ESLint rule enforcing `@dbxModelFirebaseIndex` companion tags and body coherence.
  * Mirrors the scanner schema at
@@ -2550,19 +2564,6 @@ var DEFAULT_KNOWN_COMPANIONS = [
                 }
             }
         }
-        function extractGenericIdentifier(callNode) {
-            var _callNode_typeArguments;
-            var params = (_callNode_typeArguments = callNode.typeArguments) !== null && _callNode_typeArguments !== void 0 ? _callNode_typeArguments : callNode.typeParameters;
-            var result = null;
-            if (params && Array.isArray(params.params) && params.params.length > 0) {
-                var _first_typeName;
-                var first = params.params[0];
-                if ((first === null || first === void 0 ? void 0 : first.type) === 'TSTypeReference' && ((_first_typeName = first.typeName) === null || _first_typeName === void 0 ? void 0 : _first_typeName.type) === 'Identifier') {
-                    result = first.typeName.name;
-                }
-            }
-            return result;
-        }
         function checkBody(node, parsed) {
             if (!checkBodyCoherence) return;
             var skip = getSkipTagValue(parsed);
@@ -2651,6 +2652,15 @@ function _type_of$8(obj) {
 /**
  * Default suffix used to recognise a presumed-tagged query factory by name (single-file scope).
  */ var DEFAULT_PRESUMED_TAGGED_SUFFIX = 'Query';
+function recordVariableDeclarator(node, emptyArrayDeclarators) {
+    var _node_id, _node_init;
+    if (((_node_id = node.id) === null || _node_id === void 0 ? void 0 : _node_id.type) === 'Identifier' && ((_node_init = node.init) === null || _node_init === void 0 ? void 0 : _node_init.type) === 'ArrayExpression' && Array.isArray(node.init.elements) && node.init.elements.length === 0) {
+        emptyArrayDeclarators.push({
+            node: node,
+            name: node.id.name
+        });
+    }
+}
 /**
  * ESLint rule enforcing that `@dbxModelFirebaseIndexDispatcher`-tagged factories delegate to
  * other `@dbxModelFirebaseIndex`-tagged query factories instead of building constraints directly.
@@ -2774,15 +2784,6 @@ function _type_of$8(obj) {
                 pushReceivers.add(node.callee.object.name);
             }
         }
-        function recordVariableDeclarator(node, emptyArrayDeclarators) {
-            var _node_id, _node_init;
-            if (((_node_id = node.id) === null || _node_id === void 0 ? void 0 : _node_id.type) === 'Identifier' && ((_node_init = node.init) === null || _node_init === void 0 ? void 0 : _node_init.type) === 'ArrayExpression' && Array.isArray(node.init.elements) && node.init.elements.length === 0) {
-                emptyArrayDeclarators.push({
-                    node: node,
-                    name: node.id.name
-                });
-            }
-        }
         function scanBody(body) {
             var constraintCalls = [];
             var emptyArrayDeclarators = [];
@@ -2950,6 +2951,11 @@ function _unsupported_iterable_to_array$d(o, minLen) {
     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$d(o, minLen);
 }
+function hasTypeArgument(node) {
+    var _node_typeArguments;
+    var args = (_node_typeArguments = node.typeArguments) !== null && _node_typeArguments !== void 0 ? _node_typeArguments : node.typeParameters;
+    return Boolean(args && Array.isArray(args.params) && args.params.length > 0);
+}
 /**
  * ESLint rule that warns when an `@dereekb/firebase` field-path-narrowing constraint factory
  * (`where`, `orderBy`) is called without a generic type argument. Without `<Model>`, the
@@ -3024,11 +3030,6 @@ function _unsupported_iterable_to_array$d(o, minLen) {
             }
             return result;
         }
-        function hasTypeArgument(node) {
-            var _node_typeArguments;
-            var args = (_node_typeArguments = node.typeArguments) !== null && _node_typeArguments !== void 0 ? _node_typeArguments : node.typeParameters;
-            return Boolean(args && Array.isArray(args.params) && args.params.length > 0);
-        }
         return {
             ImportDeclaration: function ImportDeclaration(node) {
                 return trackImportDeclaration(registry, node);
@@ -12647,29 +12648,29 @@ var PATH_SEPARATOR = '/';
         var env = new Map();
         bindParamsAsWildcards((_fn_params = fn.params) !== null && _fn_params !== void 0 ? _fn_params : [], env);
         var body = functionBodyExpression(fn);
-        if (!body) {
-            result = {
-                ok: false,
-                reason: 'buildUploadPath body is not a single return expression'
-            };
-        } else {
+        if (body) {
             var frags = foldFrags(body, {
                 scope: scope,
                 env: env
             }, 0);
-            if (!frags) {
-                result = {
-                    ok: false,
-                    reason: 'buildUploadPath does not fold to a constant path (unknown const, unmodeled call, or runtime value)'
-                };
-            } else {
+            if (frags) {
                 result = {
                     ok: true,
                     path: {
                         segments: fragsToSegments(frags)
                     }
                 };
+            } else {
+                result = {
+                    ok: false,
+                    reason: 'buildUploadPath does not fold to a constant path (unknown const, unmodeled call, or runtime value)'
+                };
             }
+        } else {
+            result = {
+                ok: false,
+                reason: 'buildUploadPath body is not a single return expression'
+            };
         }
     }
     return result;
@@ -13609,9 +13610,7 @@ function applyNumericOperator(operator, left, right) {
     for(var i = 0; result && i < folded.segments.length; i++){
         var a = folded.segments[i];
         var b = ruleSegments[i];
-        if (a.kind !== b.kind) {
-            result = false;
-        } else if (a.kind === 'literal' && a.value !== b.value) {
+        if (a.kind !== b.kind || a.kind === 'literal' && a.value !== b.value) {
             result = false;
         }
     }
@@ -17241,20 +17240,19 @@ var SPEC_SUFFIX = '.spec.ts';
  */ function classifySpecFile(config) {
     var filename = config.filename, parentFolderName = config.parentFolderName;
     var result;
-    if (!filename.endsWith(SPEC_SUFFIX)) {
-        result = {
-            filename: filename,
-            group: '',
-            kind: 'non-spec',
-            subgroups: [],
-            isCanonical: false
-        };
-    } else {
+    if (filename.endsWith(SPEC_SUFFIX)) {
         var _parts_;
         var stem = filename.slice(0, -SPEC_SUFFIX.length);
         var parts = stem.split('.');
         var group = (_parts_ = parts[0]) !== null && _parts_ !== void 0 ? _parts_ : '';
-        if (group !== parentFolderName) {
+        if (group === parentFolderName) {
+            var rest = parts.slice(1);
+            result = classifyRemainingSegments({
+                filename: filename,
+                group: group,
+                rest: rest
+            });
+        } else {
             result = {
                 filename: filename,
                 group: group,
@@ -17262,14 +17260,15 @@ var SPEC_SUFFIX = '.spec.ts';
                 subgroups: [],
                 isCanonical: false
             };
-        } else {
-            var rest = parts.slice(1);
-            result = classifyRemainingSegments({
-                filename: filename,
-                group: group,
-                rest: rest
-            });
         }
+    } else {
+        result = {
+            filename: filename,
+            group: '',
+            kind: 'non-spec',
+            subgroups: [],
+            isCanonical: false
+        };
     }
     return result;
 }
@@ -17636,6 +17635,282 @@ function hasCrudSpec(groupDir, group) {
     }
 };
 
+/**
+ * JSDoc marker tag that every CRUD params interface should carry so the dbx-components manifest
+ * extractor (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) records it as an
+ * intentionally-exposed API params type rather than an untagged one.
+ */ var DBX_MODEL_API_PARAMS_MARKER = 'dbxModelApiParams';
+/**
+ * Suffix on the type alias that declares a model-group CRUD function config (e.g.
+ * `GuestbookModelCrudFunctionsConfig`). Its referenced params interfaces are the ones the marker
+ * tag is required on.
+ */ var DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX = 'ModelCrudFunctionsConfig';
+/**
+ * Suffix on the type alias that declares a group's standalone function type map (e.g.
+ * `GuestbookFunctionTypeMap`). Each entry's params type is also subject to the marker tag.
+ */ var DEFAULT_FUNCTION_TYPE_MAP_SUFFIX = 'FunctionTypeMap';
+/**
+ * Returns the first element type node of a `TSTupleType`, normalizing across `@typescript-eslint`
+ * versions (`elementTypes` historically, `elements` in newer releases). CRUD config tuples take the
+ * form `[Params, Result]`, so element 0 is always the params type.
+ *
+ * @param node - A `TSTupleType` node.
+ * @returns The first element type node, or null when the tuple is empty.
+ */ function tupleFirstElement(node) {
+    var _ref, _ref1;
+    var elements = (_ref = node === null || node === void 0 ? void 0 : node.elementTypes) !== null && _ref !== void 0 ? _ref : node === null || node === void 0 ? void 0 : node.elements;
+    return (_ref1 = elements === null || elements === void 0 ? void 0 : elements[0]) !== null && _ref1 !== void 0 ? _ref1 : null;
+}
+/**
+ * Recursively collects the params type-reference names declared by a CRUD config / function-type-map
+ * type node into `out`, mirroring the resolution in `extract-crud.ts`. A bare `TSTypeReference`
+ * (`create: CreateGuestbookParams`) contributes its referenced name; a `TSTupleType`
+ * (`query: [QueryGuestbooksParams, OnCallQueryModelResult<...>]`) contributes element 0 only, since
+ * element 1 is the result type; and a `TSTypeLiteral` (model literal, verb literal, or
+ * `{ specifier: ... }` object) is recursed into per property-signature value. Generic type arguments
+ * on a reference are intentionally not descended into — only the params type itself is collected.
+ *
+ * @param node - The type node to inspect.
+ * @param out - The accumulating set of params type-reference names.
+ */ function collectParamsTypeNames(node, out) {
+    if (!node) {
+        return;
+    }
+    if (node.type === 'TSTypeReference') {
+        var name = typeReferenceTypeName$1(node);
+        if (name) {
+            out.add(name);
+        }
+    } else if (node.type === 'TSTupleType') {
+        collectParamsTypeNames(tupleFirstElement(node), out);
+    } else if (node.type === 'TSTypeLiteral' && Array.isArray(node.members)) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = node.members[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var member = _step.value;
+                if ((member === null || member === void 0 ? void 0 : member.type) === 'TSPropertySignature') {
+                    var _member_typeAnnotation;
+                    collectParamsTypeNames((_member_typeAnnotation = member.typeAnnotation) === null || _member_typeAnnotation === void 0 ? void 0 : _member_typeAnnotation.typeAnnotation, out);
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+}
+/**
+ * Returns the inner declaration node when `statement` is (or wraps) a `TSInterfaceDeclaration`, along
+ * with the statement-level anchor ESLint attaches leading comments to.
+ *
+ * @param statement - A top-level `Program.body` statement.
+ * @returns The interface declaration + its JSDoc anchor, or null when the statement is not an interface.
+ */ function interfaceFromStatement(statement) {
+    var _statement_declaration;
+    var result = null;
+    if ((statement === null || statement === void 0 ? void 0 : statement.type) === 'TSInterfaceDeclaration') {
+        result = {
+            decl: statement,
+            anchor: statement
+        };
+    } else if (((statement === null || statement === void 0 ? void 0 : statement.type) === 'ExportNamedDeclaration' || (statement === null || statement === void 0 ? void 0 : statement.type) === 'ExportDefaultDeclaration') && ((_statement_declaration = statement.declaration) === null || _statement_declaration === void 0 ? void 0 : _statement_declaration.type) === 'TSInterfaceDeclaration') {
+        result = {
+            decl: statement.declaration,
+            anchor: statement
+        };
+    }
+    return result;
+}
+/**
+ * Returns true when the interface's leading JSDoc carries the given marker tag.
+ *
+ * @param sourceCode - The ESLint `SourceCode` object.
+ * @param anchor - The interface's JSDoc anchor node.
+ * @param tagName - The marker tag name (without the leading `@`).
+ * @returns True when the marker tag is present on the interface's JSDoc.
+ */ function interfaceHasMarker(sourceCode, anchor, tagName) {
+    var jsdoc = leadingJsdocFor(sourceCode, anchor);
+    var result = false;
+    if (jsdoc) {
+        var parsed = parseJsdocComment(jsdoc.value);
+        result = parsed.tags.some(function(tag) {
+            return tag.tag === tagName;
+        });
+    }
+    return result;
+}
+/**
+ * ESLint rule that requires every params interface referenced by a `*ModelCrudFunctionsConfig` (and,
+ * by default, `*FunctionTypeMap`) type alias and declared in the same file to carry the
+ * `@dbxModelApiParams` JSDoc marker tag.
+ *
+ * The marker is the signal the dbx-components manifest extractor
+ * (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) reads to distinguish an
+ * intentionally-exposed API params type from an untagged one — missing it produces the
+ * `[no-api-params-tag]` build warning and the "Missing `@dbxModelApiParams` marker" hint in the
+ * `dbx_model_api_lookup` MCP tool. This rule surfaces the same gap in-editor at lint time.
+ *
+ * Same-file resolution only — matching the extractor, which itself resolves params interfaces from a
+ * single in-memory source file. Params types declared in another file (e.g. shared base params like
+ * `TargetModelParams`) are skipped, exactly as the extractor reports them as unresolved.
+ *
+ * @example
+ * ```ts
+ * export type GuestbookModelCrudFunctionsConfig = {
+ *   guestbook: { create: CreateGuestbookParams };
+ * };
+ *
+ * // OK
+ * /**
+ *  * @dbxModelApiParams
+ *  *\/
+ * export interface CreateGuestbookParams { readonly name: string; }
+ *
+ * // WARN — missingApiParamsTag
+ * export interface CreateGuestbookParams { readonly name: string; }
+ * ```
+ */ var FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE = {
+    meta: {
+        type: 'suggestion',
+        fixable: undefined,
+        docs: {
+            description: 'Require the `@dbxModelApiParams` marker tag on params interfaces referenced by a `*ModelCrudFunctionsConfig` / `*FunctionTypeMap` alias and declared in the same file, mirroring the manifest extractor that reads the tag.',
+            recommended: true
+        },
+        messages: {
+            missingApiParamsTag: 'Params interface "{{name}}" is referenced by the CRUD config "{{configName}}" but is missing the `@{{tag}}` marker. Add `@{{tag}}` to its JSDoc so the manifest extractor records it as an intentionally-exposed API params type.'
+        },
+        schema: [
+            {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    configTypeSuffix: {
+                        type: 'string'
+                    },
+                    alsoFunctionTypeMap: {
+                        type: 'boolean'
+                    },
+                    tagName: {
+                        type: 'string'
+                    }
+                }
+            }
+        ]
+    },
+    create: function create(context) {
+        var _context_options_, _options_configTypeSuffix, _options_tagName;
+        var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
+        var configTypeSuffix = (_options_configTypeSuffix = options.configTypeSuffix) !== null && _options_configTypeSuffix !== void 0 ? _options_configTypeSuffix : DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX;
+        var alsoFunctionTypeMap = options.alsoFunctionTypeMap !== false;
+        var tagName = (_options_tagName = options.tagName) !== null && _options_tagName !== void 0 ? _options_tagName : DBX_MODEL_API_PARAMS_MARKER;
+        var sourceCode = context.sourceCode;
+        function isConfigAliasName(name) {
+            return name.endsWith(configTypeSuffix) || alsoFunctionTypeMap && name.endsWith(DEFAULT_FUNCTION_TYPE_MAP_SUFFIX);
+        }
+        return {
+            Program: function Program(programNode) {
+                var _ref;
+                var body = (_ref = programNode === null || programNode === void 0 ? void 0 : programNode.body) !== null && _ref !== void 0 ? _ref : [];
+                // Index the interfaces declared in this file by name (same-file resolution, like the extractor).
+                var interfaces = new Map();
+                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(var _iterator = body[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        var statement = _step.value;
+                        var _found_decl_id, _found_decl;
+                        var found = interfaceFromStatement(statement);
+                        if ((found === null || found === void 0 ? void 0 : (_found_decl = found.decl) === null || _found_decl === void 0 ? void 0 : (_found_decl_id = _found_decl.id) === null || _found_decl_id === void 0 ? void 0 : _found_decl_id.type) === 'Identifier') {
+                            interfaces.set(found.decl.id.name, found);
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = body[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var statement1 = _step1.value;
+                        var _statement_declaration, _alias_id;
+                        var alias = (statement1 === null || statement1 === void 0 ? void 0 : statement1.type) === 'TSTypeAliasDeclaration' ? statement1 : (statement1 === null || statement1 === void 0 ? void 0 : statement1.type) === 'ExportNamedDeclaration' && ((_statement_declaration = statement1.declaration) === null || _statement_declaration === void 0 ? void 0 : _statement_declaration.type) === 'TSTypeAliasDeclaration' ? statement1.declaration : null;
+                        if (!alias || ((_alias_id = alias.id) === null || _alias_id === void 0 ? void 0 : _alias_id.type) !== 'Identifier' || !isConfigAliasName(alias.id.name)) {
+                            continue;
+                        }
+                        var paramsNames = new Set();
+                        collectParamsTypeNames(alias.typeAnnotation, paramsNames);
+                        var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+                        try {
+                            for(var _iterator2 = paramsNames[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+                                var paramsName = _step2.value;
+                                var target = interfaces.get(paramsName);
+                                // Skip params types not declared in this file — the extractor cannot resolve them either.
+                                if (target && !interfaceHasMarker(sourceCode, target.anchor, tagName)) {
+                                    context.report({
+                                        node: target.decl.id,
+                                        messageId: 'missingApiParamsTag',
+                                        data: {
+                                            name: paramsName,
+                                            configName: alias.id.name,
+                                            tag: tagName
+                                        }
+                                    });
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError2 = true;
+                            _iteratorError2 = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                                    _iterator2.return();
+                                }
+                            } finally{
+                                if (_didIteratorError2) {
+                                    throw _iteratorError2;
+                                }
+                            }
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
+                }
+            }
+        };
+    }
+};
+
 /**
  * ESLint plugin for `@dereekb/firebase` rules.
  *
@@ -17657,7 +17932,8 @@ function hasCrudSpec(groupDir, group) {
         'require-service-factory-for-dbx-model': FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE,
         'require-dbx-model-companion-tags': FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE,
         'require-canonical-api-spec-filename': FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE,
-        'require-api-crud-spec-for-group': FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE
+        'require-api-crud-spec-for-group': FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE,
+        'require-dbx-model-api-params-tag': FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE
     }
 };
 /**
@@ -17666,4 +17942,4 @@ function hasCrudSpec(groupDir, group) {
  * @dbxAllowConstantName
  */ var firebaseESLintPlugin = FIREBASE_ESLINT_PLUGIN;
 
-export { API_DETAILS_IMPORT_MODULE, DBX_MODEL_FIREBASE_INDEX_MARKER, DBX_MODEL_SERVICE_FACTORY_TAG, DEFAULT_API_DETAILS_FACTORY_NAME, DEFAULT_CONSTRAINT_FACTORY_NAMES, DEFAULT_CRUD_FUNCTION_TYPE_VERBS, DEFAULT_CRUD_VERB_NAMES, DEFAULT_DISCOVERY_EXCLUDED_DIRS, DEFAULT_FACTORY_SEARCH_ROOTS, DEFAULT_FACTORY_TAG, DEFAULT_FIRESTORE_RULES_FILENAME, DEFAULT_FUNCTION_DIR_SEGMENT, DEFAULT_IDENTITY_FACTORY_NAME, DEFAULT_INDEX_AFFECTING_CONSTRAINT_NAMES, DEFAULT_MODEL_MARKER_TAG, DEFAULT_MODEL_SEARCH_ROOTS, DEFAULT_PAGINATION_CONSTRAINT_NAMES, DEFAULT_REGISTRY_FACTORY_CALL_NAME, DEFAULT_STORAGE_FILE_UPLOAD_POLICY_TYPE_NAME, DEFAULT_STORAGE_RULES_FILENAME, FIREBASE_ESLINT_PLUGIN, FIREBASE_MODEL_SERVICE_FACTORY_MODULE, FIREBASE_MODEL_SERVICE_FACTORY_NAME, FIREBASE_MODULE, FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE, FIREBASE_REQUIRE_API_DETAILS_FOR_CRUD_FUNCTION_RULE, FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE, FIREBASE_REQUIRE_COMPLETE_CRUD_FUNCTION_CONFIG_MAP_RULE, FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_COMPANION_TAGS_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_QUERY_SUFFIX_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_VALID_DISPATCHER_RULE, FIREBASE_REQUIRE_DBX_MODEL_SERVICE_FACTORY_TAG_RULE, FIREBASE_REQUIRE_FIRESTORE_CONSTRAINT_TYPE_PARAMETER_RULE, FIREBASE_REQUIRE_FIRESTORE_RULE_FOR_SERVICE_MODEL_RULE, FIREBASE_REQUIRE_INPUT_TYPE_FOR_API_DETAILS_RULE, FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE, FIREBASE_REQUIRE_STORAGEFILE_POLICY_MATCHES_RULES_RULE, FIREBASE_REQUIRE_TAGGED_FIRESTORE_CONSTRAINTS_RULE, INPUT_TYPE_PROPERTY_NAME, MIRRORS_POLICY_KEY_MARKER_REGEX, MODEL_FIREBASE_CRUD_FUNCTION_CONFIG_MAP_TYPE_NAME, QUERY_SUFFIX, discoveryGlobExcludeFilter, firebaseESLintPlugin, parseFirestoreRules, parseStorageRules };
+export { API_DETAILS_IMPORT_MODULE, DBX_MODEL_API_PARAMS_MARKER, DBX_MODEL_FIREBASE_INDEX_MARKER, DBX_MODEL_SERVICE_FACTORY_TAG, DEFAULT_API_DETAILS_FACTORY_NAME, DEFAULT_CONSTRAINT_FACTORY_NAMES, DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX, DEFAULT_CRUD_FUNCTION_TYPE_VERBS, DEFAULT_CRUD_VERB_NAMES, DEFAULT_DISCOVERY_EXCLUDED_DIRS, DEFAULT_FACTORY_SEARCH_ROOTS, DEFAULT_FACTORY_TAG, DEFAULT_FIRESTORE_RULES_FILENAME, DEFAULT_FUNCTION_DIR_SEGMENT, DEFAULT_FUNCTION_TYPE_MAP_SUFFIX, DEFAULT_IDENTITY_FACTORY_NAME, DEFAULT_INDEX_AFFECTING_CONSTRAINT_NAMES, DEFAULT_MODEL_MARKER_TAG, DEFAULT_MODEL_SEARCH_ROOTS, DEFAULT_PAGINATION_CONSTRAINT_NAMES, DEFAULT_REGISTRY_FACTORY_CALL_NAME, DEFAULT_STORAGE_FILE_UPLOAD_POLICY_TYPE_NAME, DEFAULT_STORAGE_RULES_FILENAME, FIREBASE_ESLINT_PLUGIN, FIREBASE_MODEL_SERVICE_FACTORY_MODULE, FIREBASE_MODEL_SERVICE_FACTORY_NAME, FIREBASE_MODULE, FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE, FIREBASE_REQUIRE_API_DETAILS_FOR_CRUD_FUNCTION_RULE, FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE, FIREBASE_REQUIRE_COMPLETE_CRUD_FUNCTION_CONFIG_MAP_RULE, FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE, FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_COMPANION_TAGS_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_QUERY_SUFFIX_RULE, FIREBASE_REQUIRE_DBX_MODEL_FIREBASE_INDEX_VALID_DISPATCHER_RULE, FIREBASE_REQUIRE_DBX_MODEL_SERVICE_FACTORY_TAG_RULE, FIREBASE_REQUIRE_FIRESTORE_CONSTRAINT_TYPE_PARAMETER_RULE, FIREBASE_REQUIRE_FIRESTORE_RULE_FOR_SERVICE_MODEL_RULE, FIREBASE_REQUIRE_INPUT_TYPE_FOR_API_DETAILS_RULE, FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE, FIREBASE_REQUIRE_STORAGEFILE_POLICY_MATCHES_RULES_RULE, FIREBASE_REQUIRE_TAGGED_FIRESTORE_CONSTRAINTS_RULE, INPUT_TYPE_PROPERTY_NAME, MIRRORS_POLICY_KEY_MARKER_REGEX, MODEL_FIREBASE_CRUD_FUNCTION_CONFIG_MAP_TYPE_NAME, QUERY_SUFFIX, discoveryGlobExcludeFilter, firebaseESLintPlugin, parseFirestoreRules, parseStorageRules };

package/eslint/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@dereekb/firebase/eslint",
-  "version": "13.12.7",
+  "version": "13.12.9",
   "peerDependencies": {
-    "@dereekb/util": "13.12.7",
+    "@dereekb/util": "13.12.9",
     "@marcbachmann/cel-js": "^7.6.1",
     "@typescript-eslint/parser": "8.59.3",
     "@typescript-eslint/utils": "8.59.3"
   },
   "devDependencies": {
-    "@dereekb/firebase": "13.12.7",
+    "@dereekb/firebase": "13.12.9",
     "eslint": "10.4.0",
     "firebase": "^12.12.1"
   },

package/eslint/src/lib/index.d.ts

@@ -13,6 +13,7 @@ export { FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE, DEFAULT_FACTORY_SE
 export { FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE, type FirebaseRequireDbxModelCompanionTagsRuleOptions, type FirebaseRequireDbxModelCompanionTagsRuleDefinition } from './require-dbx-model-companion-tags.rule';
 export { FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE, DEFAULT_FUNCTION_DIR_SEGMENT, type FirebaseRequireCanonicalApiSpecFilenameRuleOptions, type FirebaseRequireCanonicalApiSpecFilenameRuleDefinition } from './require-canonical-api-spec-filename.rule';
 export { FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE, type FirebaseRequireApiCrudSpecForGroupRuleOptions, type FirebaseRequireApiCrudSpecForGroupRuleDefinition } from './require-api-crud-spec-for-group.rule';
+export { FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE, DBX_MODEL_API_PARAMS_MARKER, DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX, DEFAULT_FUNCTION_TYPE_MAP_SUFFIX, type FirebaseRequireDbxModelApiParamsTagRuleOptions, type FirebaseRequireDbxModelApiParamsTagRuleDefinition } from './require-dbx-model-api-params-tag.rule';
 export { parseStorageRules, MIRRORS_POLICY_KEY_MARKER_REGEX, type ParsedRuleBranch, type ParsedStorageRulesBlock } from './storage-rules-parser';
 export { parseFirestoreRules, type ParsedFirestoreMatchBlock } from './firestore-rules-parser';
 export { FIREBASE_ESLINT_PLUGIN, firebaseESLintPlugin, type FirebaseEslintPlugin } from './plugin';

package/eslint/src/lib/plugin.d.ts

@@ -13,6 +13,7 @@ import { FIREBASE_REQUIRE_SERVICE_FACTORY_FOR_DBX_MODEL_RULE } from './require-s
 import { FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE } from './require-dbx-model-companion-tags.rule';
 import { FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE } from './require-canonical-api-spec-filename.rule';
 import { FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE } from './require-api-crud-spec-for-group.rule';
+import { FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE } from './require-dbx-model-api-params-tag.rule';
 /**
  * ESLint plugin interface for `@dereekb/firebase` rules.
  */
@@ -33,6 +34,7 @@ export interface FirebaseEslintPlugin {
         readonly 'require-dbx-model-companion-tags': typeof FIREBASE_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE;
         readonly 'require-canonical-api-spec-filename': typeof FIREBASE_REQUIRE_CANONICAL_API_SPEC_FILENAME_RULE;
         readonly 'require-api-crud-spec-for-group': typeof FIREBASE_REQUIRE_API_CRUD_SPEC_FOR_GROUP_RULE;
+        readonly 'require-dbx-model-api-params-tag': typeof FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE;
     };
 }
 /**

package/eslint/src/lib/require-dbx-model-api-params-tag.rule.d.ts

@@ -0,0 +1,91 @@
+import { type AstNode } from './util';
+/**
+ * JSDoc marker tag that every CRUD params interface should carry so the dbx-components manifest
+ * extractor (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) records it as an
+ * intentionally-exposed API params type rather than an untagged one.
+ */
+export declare const DBX_MODEL_API_PARAMS_MARKER = "dbxModelApiParams";
+/**
+ * Suffix on the type alias that declares a model-group CRUD function config (e.g.
+ * `GuestbookModelCrudFunctionsConfig`). Its referenced params interfaces are the ones the marker
+ * tag is required on.
+ */
+export declare const DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX = "ModelCrudFunctionsConfig";
+/**
+ * Suffix on the type alias that declares a group's standalone function type map (e.g.
+ * `GuestbookFunctionTypeMap`). Each entry's params type is also subject to the marker tag.
+ */
+export declare const DEFAULT_FUNCTION_TYPE_MAP_SUFFIX = "FunctionTypeMap";
+/**
+ * Options for the require-dbx-model-api-params-tag rule.
+ */
+export interface FirebaseRequireDbxModelApiParamsTagRuleOptions {
+    /**
+     * Suffix identifying the CRUD functions config type alias. Defaults to {@link DEFAULT_CRUD_FUNCTIONS_CONFIG_SUFFIX}.
+     */
+    readonly configTypeSuffix?: string;
+    /**
+     * Whether to also inspect `*FunctionTypeMap` aliases for params types. Defaults to `true`.
+     */
+    readonly alsoFunctionTypeMap?: boolean;
+    /**
+     * Marker tag name (without the leading `@`). Defaults to {@link DBX_MODEL_API_PARAMS_MARKER}.
+     */
+    readonly tagName?: string;
+}
+/**
+ * ESLint rule definition for require-dbx-model-api-params-tag.
+ */
+export interface FirebaseRequireDbxModelApiParamsTagRuleDefinition {
+    readonly meta: {
+        readonly type: 'suggestion';
+        readonly fixable: undefined;
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: Readonly<Record<string, string>>;
+        readonly schema: readonly object[];
+    };
+    create(context: {
+        options: FirebaseRequireDbxModelApiParamsTagRuleOptions[];
+        report: (descriptor: {
+            node: AstNode;
+            messageId: string;
+            data?: Record<string, string>;
+        }) => void;
+        sourceCode: AstNode;
+    }): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint rule that requires every params interface referenced by a `*ModelCrudFunctionsConfig` (and,
+ * by default, `*FunctionTypeMap`) type alias and declared in the same file to carry the
+ * `@dbxModelApiParams` JSDoc marker tag.
+ *
+ * The marker is the signal the dbx-components manifest extractor
+ * (`packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts`) reads to distinguish an
+ * intentionally-exposed API params type from an untagged one — missing it produces the
+ * `[no-api-params-tag]` build warning and the "Missing `@dbxModelApiParams` marker" hint in the
+ * `dbx_model_api_lookup` MCP tool. This rule surfaces the same gap in-editor at lint time.
+ *
+ * Same-file resolution only — matching the extractor, which itself resolves params interfaces from a
+ * single in-memory source file. Params types declared in another file (e.g. shared base params like
+ * `TargetModelParams`) are skipped, exactly as the extractor reports them as unresolved.
+ *
+ * @example
+ * ```ts
+ * export type GuestbookModelCrudFunctionsConfig = {
+ *   guestbook: { create: CreateGuestbookParams };
+ * };
+ *
+ * // OK
+ * /**
+ *  * @dbxModelApiParams
+ *  *\/
+ * export interface CreateGuestbookParams { readonly name: string; }
+ *
+ * // WARN — missingApiParamsTag
+ * export interface CreateGuestbookParams { readonly name: string; }
+ * ```
+ */
+export declare const FIREBASE_REQUIRE_DBX_MODEL_API_PARAMS_TAG_RULE: FirebaseRequireDbxModelApiParamsTagRuleDefinition;

package/index.cjs.js

@@ -11717,6 +11717,7 @@ function _unsupported_iterable_to_array$7(o, minLen) {
                     addCallFunctions('update', _callFn, modelType);
                     addCallFunctions('delete', _callFn, modelType);
                     addCallFunctions('query', _callFn, modelType);
+                    addCallFunctions('invoke', _callFn, modelType);
                     // tslint:disable-next-line
                     x[modelType] = modelTypeCalls;
                 });

package/index.esm.js

@@ -11715,6 +11715,7 @@ function _unsupported_iterable_to_array$7(o, minLen) {
                     addCallFunctions('update', _callFn, modelType);
                     addCallFunctions('delete', _callFn, modelType);
                     addCallFunctions('query', _callFn, modelType);
+                    addCallFunctions('invoke', _callFn, modelType);
                     // tslint:disable-next-line
                     x[modelType] = modelTypeCalls;
                 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase",
-  "version": "13.12.7",
+  "version": "13.12.9",
   "sideEffects": false,
   "exports": {
     "./test": {
@@ -24,10 +24,10 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/date": "13.12.7",
-    "@dereekb/model": "13.12.7",
-    "@dereekb/rxjs": "13.12.7",
-    "@dereekb/util": "13.12.7",
+    "@dereekb/date": "13.12.9",
+    "@dereekb/model": "13.12.9",
+    "@dereekb/rxjs": "13.12.9",
+    "@dereekb/util": "13.12.9",
     "@firebase/rules-unit-testing": "5.0.0",
     "@marcbachmann/cel-js": "^7.6.1",
     "@typescript-eslint/parser": "8.59.3",

package/src/lib/client/function/model.function.factory.d.ts

@@ -43,6 +43,11 @@ export type ModelFirebaseUpdateFunction<I, O = void> = ModelFirebaseCrudFunction
  * Delete function for a model. Returns void by default.
  */
 export type ModelFirebaseDeleteFunction<I, O = void> = ModelFirebaseCrudFunction<I, O>;
+/**
+ * Invoke function for a model. Covers RPC-style operations that don't fit
+ * a CRUD verb (e.g. regenerate-thumbnails, resync-with-external). Returns void by default.
+ */
+export type ModelFirebaseInvokeFunction<I, O = void> = ModelFirebaseCrudFunction<I, O>;
 /**
  * Query function for a model. Returns {@link OnCallQueryModelResult} (a paged, cursorable
  * collection) by default. The input type defaults to {@link OnCallQueryModelRequestParams}
@@ -64,7 +69,7 @@ export type ModelFirebaseCrudFunctionTypeMap<T extends FirestoreModelIdentity =
  * Can be `null`/`undefined` (no CRUD functions for this model) or a partial record of
  * create/read/update/delete/query configurations, each optionally with specifiers.
  */
-export type ModelFirebaseCrudFunctionTypeMapEntry = MaybeNot | Partial<ModelFirebaseCrudFunctionCreateTypeConfig & ModelFirebaseCrudFunctionReadTypeConfig & ModelFirebaseCrudFunctionUpdateTypeConfig & ModelFirebaseCrudFunctionDeleteTypeConfig & ModelFirebaseCrudFunctionQueryTypeConfig>;
+export type ModelFirebaseCrudFunctionTypeMapEntry = MaybeNot | Partial<ModelFirebaseCrudFunctionCreateTypeConfig & ModelFirebaseCrudFunctionReadTypeConfig & ModelFirebaseCrudFunctionUpdateTypeConfig & ModelFirebaseCrudFunctionDeleteTypeConfig & ModelFirebaseCrudFunctionQueryTypeConfig & ModelFirebaseCrudFunctionInvokeTypeConfig>;
 export type ModelFirebaseCrudFunctionTypeMapEntryWithReturnType<I = unknown, O = unknown> = [I, O];
 export type ModelFirebaseCrudFunctionTypeSpecifierConfig = Record<string | number, unknown | ModelFirebaseCrudFunctionTypeMapEntryWithReturnType>;
 export type ModelFirebaseCrudFunctionCreateTypeConfig = {
@@ -82,6 +87,9 @@ export type ModelFirebaseCrudFunctionDeleteTypeConfig = {
 export type ModelFirebaseCrudFunctionQueryTypeConfig = {
     readonly query: unknown;
 };
+export type ModelFirebaseCrudFunctionInvokeTypeConfig = {
+    readonly invoke: unknown;
+};
 /**
  * Default specifier string (`'_'`) used when a CRUD operation has specifiers but one
  * should map to the base function name without a specifier suffix.

package/test/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/firebase/test",
-  "version": "13.12.7",
+  "version": "13.12.9",
   "peerDependencies": {
-    "@dereekb/date": "13.12.7",
-    "@dereekb/firebase": "13.12.7",
-    "@dereekb/model": "13.12.7",
-    "@dereekb/rxjs": "13.12.7",
-    "@dereekb/util": "13.12.7",
+    "@dereekb/date": "13.12.9",
+    "@dereekb/firebase": "13.12.9",
+    "@dereekb/model": "13.12.9",
+    "@dereekb/rxjs": "13.12.9",
+    "@dereekb/util": "13.12.9",
     "@firebase/rules-unit-testing": "5.0.0",
     "date-fns": "^4.1.0",
     "firebase": "^12.12.1",