@dereekb/firebase 14.0.1 → 14.2.0

package/eslint/index.esm.js

@@ -1,4 +1,3 @@
-import 'typescript';
 import { createRequire } from 'node:module';
 import { existsSync, readFileSync, globSync, readdirSync } from 'node:fs';
 import { join, dirname, isAbsolute, resolve, sep, basename } from 'node:path';
@@ -51,199 +50,6 @@ import { parse as parse$2 } from '@typescript-eslint/parser';
     return result;
 }
 
-/**
- * Default maximum positional parameters before the warn-level rule suggests a config object.
- * Triggers a warning when a function has more than 2 positional parameters (i.e. 3+ args).
- */ var DEFAULT_MAX_PARAMS_WARN = 2;
-/**
- * Default maximum positional parameters before the hard-error rule rejects the signature.
- * Triggers an error when a function has more than 4 positional parameters (i.e. 5+ args).
- */ var DEFAULT_MAX_PARAMS_HARD = 4;
-/**
- * Default JSDoc tag that opts a function out of this rule.
- */ var DEFAULT_ALLOW_JSDOC_TAG = '@dbxAllowMultiParams';
-/**
- * Returns a human-readable display name for the function-like node, or `<anonymous>`.
- *
- * @param node - The function-like AST node.
- * @returns The identifier string used in diagnostic messages.
- */ function getFunctionDisplayName(node) {
-    var _node_id;
-    var name = '<anonymous>';
-    if (((_node_id = node.id) === null || _node_id === void 0 ? void 0 : _node_id.type) === 'Identifier') {
-        name = node.id.name;
-    } else if (node.parent) {
-        var _parent_id, _parent_key, _parent_key1, _parent_left;
-        var parent = node.parent;
-        if (parent.type === 'VariableDeclarator' && ((_parent_id = parent.id) === null || _parent_id === void 0 ? void 0 : _parent_id.type) === 'Identifier') {
-            name = parent.id.name;
-        } else if (parent.type === 'Property' && ((_parent_key = parent.key) === null || _parent_key === void 0 ? void 0 : _parent_key.type) === 'Identifier') {
-            name = parent.key.name;
-        } else if (parent.type === 'MethodDefinition' && ((_parent_key1 = parent.key) === null || _parent_key1 === void 0 ? void 0 : _parent_key1.type) === 'Identifier') {
-            name = parent.key.name;
-        } else if (parent.type === 'AssignmentExpression' && ((_parent_left = parent.left) === null || _parent_left === void 0 ? void 0 : _parent_left.type) === 'Identifier') {
-            name = parent.left.name;
-        }
-    }
-    return name;
-}
-/**
- * Returns true if a parameter has any decorators (NestJS handler/Inject pattern).
- *
- * @param param - The parameter AST node.
- * @returns True when the parameter carries at least one decorator.
- */ function paramHasDecorator(param) {
-    var _param_decorators;
-    var decorators = (_param_decorators = param.decorators) !== null && _param_decorators !== void 0 ? _param_decorators : [];
-    return Array.isArray(decorators) && decorators.length > 0;
-}
-/**
- * Returns true when the function is the constructor of a class.
- *
- * @param node - The function-like AST node.
- * @returns True if `node` is the `constructor` body of a class.
- */ function isConstructor(node) {
-    var _node_parent;
-    return ((_node_parent = node.parent) === null || _node_parent === void 0 ? void 0 : _node_parent.type) === 'MethodDefinition' && node.parent.kind === 'constructor';
-}
-/**
- * Returns true if any leading JSDoc block above `anchor` contains the allow tag.
- *
- * @param sourceCode - The ESLint `SourceCode` instance.
- * @param anchor - The AST node whose leading comments are scanned.
- * @param allowTag - The JSDoc tag string that opts the function out.
- * @returns True when a JSDoc with the allow tag is present.
- */ function hasAllowJsdoc(sourceCode, anchor, allowTag) {
-    var comments = sourceCode.getCommentsBefore(anchor) || [];
-    var allow = false;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = comments[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var comment = _step.value;
-            if (comment.type === 'Block' && comment.value.startsWith('*') && comment.value.includes(allowTag)) {
-                allow = true;
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return allow;
-}
-/**
- * Builds a prefer-config-object-style rule with a configurable default `maxParams` threshold.
- * Class constructors and decorated parameters (e.g. NestJS `@Inject`) are exempted. Functions can
- * opt out via a leading JSDoc block carrying the configured allow tag (default `@dbxAllowMultiParams`).
- *
- * @param config - Default threshold and rule description.
- * @returns A complete ESLint rule definition that emits `tooManyParams` reports.
- */ function createPreferConfigObjectRule(config) {
-    return {
-        meta: {
-            type: 'suggestion',
-            docs: {
-                description: config.description,
-                recommended: true
-            },
-            messages: {
-                tooManyParams: "Function '{{name}}' takes {{count}} positional parameters; use a single config object instead (see dbx__note__typescript-programming → Prefer Single Config Object)."
-            },
-            schema: [
-                {
-                    type: 'object',
-                    properties: {
-                        maxParams: {
-                            type: 'number',
-                            minimum: 0,
-                            description: 'Maximum number of positional parameters before the rule fires.'
-                        },
-                        allowJsdocTag: {
-                            type: 'string',
-                            description: 'JSDoc tag that opts a function out of this rule.'
-                        }
-                    },
-                    additionalProperties: false
-                }
-            ]
-        },
-        create: function create(context) {
-            var _context_options_, _options_maxParams, _options_allowJsdocTag;
-            var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
-            var maxParams = (_options_maxParams = options.maxParams) !== null && _options_maxParams !== void 0 ? _options_maxParams : config.defaultMaxParams;
-            var allowTag = (_options_allowJsdocTag = options.allowJsdocTag) !== null && _options_allowJsdocTag !== void 0 ? _options_allowJsdocTag : DEFAULT_ALLOW_JSDOC_TAG;
-            var sourceCode = context.sourceCode;
-            function checkFunction(node) {
-                if (!isConstructor(node)) {
-                    var _node_params;
-                    var params = (_node_params = node.params) !== null && _node_params !== void 0 ? _node_params : [];
-                    // Decorated parameters indicate framework-driven signatures (NestJS handlers, Angular DI inside
-                    // constructors which we already skip — but standalone decorated functions exist too).
-                    if (!params.some(paramHasDecorator) && params.length > maxParams) {
-                        var _node_parent, _node_parent_parent;
-                        // Anchor for JSDoc lookup: prefer the enclosing export statement, then a VariableDeclaration
-                        // (for `const fn = () => ...`), otherwise the function node itself.
-                        var anchor = node;
-                        if (((_node_parent = node.parent) === null || _node_parent === void 0 ? void 0 : _node_parent.type) === 'VariableDeclarator' && ((_node_parent_parent = node.parent.parent) === null || _node_parent_parent === void 0 ? void 0 : _node_parent_parent.type) === 'VariableDeclaration') {
-                            anchor = node.parent.parent;
-                        }
-                        if (anchor.parent && (anchor.parent.type === 'ExportNamedDeclaration' || anchor.parent.type === 'ExportDefaultDeclaration')) {
-                            anchor = anchor.parent;
-                        }
-                        if (!hasAllowJsdoc(sourceCode, anchor, allowTag)) {
-                            var _node_id;
-                            var name = getFunctionDisplayName(node);
-                            context.report({
-                                node: (_node_id = node.id) !== null && _node_id !== void 0 ? _node_id : node,
-                                messageId: 'tooManyParams',
-                                data: {
-                                    name: name,
-                                    count: String(params.length)
-                                }
-                            });
-                        }
-                    }
-                }
-            }
-            return {
-                FunctionDeclaration: checkFunction,
-                FunctionExpression: checkFunction,
-                ArrowFunctionExpression: checkFunction
-            };
-        }
-    };
-}
-/**
- * ESLint rule recommending a single config object when a function takes more than two positional
- * parameters (default `maxParams: 2`, i.e. fires at 3+ args). Intended to be configured at the
- * `warn` severity. Pair with `prefer-config-object-hard` for a stricter cap.
- *
- * @see `dbx__note__typescript-programming` → Prefer Single Config Object
- */ createPreferConfigObjectRule({
-    defaultMaxParams: DEFAULT_MAX_PARAMS_WARN,
-    description: 'Prefer a single config object when a function takes more than two positional parameters.'
-});
-/**
- * Hard-stop variant of `prefer-config-object`. Fires when a function takes more than four positional
- * parameters (default `maxParams: 4`, i.e. fires at 5+ args). Intended to be configured at the
- * `error` severity so genuinely unwieldy signatures break the build even when the softer warn-level
- * rule is disabled or downgraded.
- *
- * @see `dbx__note__typescript-programming` → Prefer Single Config Object
- */ createPreferConfigObjectRule({
-    defaultMaxParams: DEFAULT_MAX_PARAMS_HARD,
-    description: 'Reject function signatures with more than four positional parameters; require a single config object.'
-});
-
 function _array_like_to_array$h(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];

package/eslint/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@dereekb/firebase/eslint",
-  "version": "14.0.1",
+  "version": "14.2.0",
+  "sideEffects": false,
   "type": "module",
   "peerDependencies": {
-    "@dereekb/util": "14.0.1",
+    "@dereekb/util": "14.2.0",
     "@marcbachmann/cel-js": "^8.0.0",
     "@typescript-eslint/parser": "8.69.0",
     "@typescript-eslint/utils": "8.69.0",
     "typescript": "6.0.3"
   },
   "devDependencies": {
-    "@dereekb/firebase": "14.0.1",
+    "@dereekb/firebase": "14.2.0",
     "eslint": "10.9.1",
     "firebase": "^12.18.0"
   },