eslint-plugin-firebase-ai-logic 1.2.0 → 1.3.0

package/dist/index.js

@@ -239,7 +239,7 @@ const configs = {
 const plugin = {
     meta: {
         name: 'eslint-plugin-firebase-ai-logic',
-        version: '1.2.0',
+        version: '1.3.0',
     },
     rules,
     configs,

package/dist/rules/check-temperature-defaults.d.ts

@@ -1,4 +1,22 @@
 import type { Rule } from 'eslint';
+/**
+ * check-temperature-defaults
+ *
+ * This rule suggests using the default temperature (1.0) for Gemini models,
+ * but with important exceptions:
+ *
+ * EXCEPTIONS (low temperature is valid and recommended):
+ * 1. Structured output (responseMimeType: 'application/json')
+ *    - Low temperature (0.1-0.3) prevents hallucinations in extraction tasks
+ * 2. Classification tasks
+ *    - Deterministic outputs benefit from low temperature
+ * 3. Data extraction
+ *    - Precise extraction needs low temperature
+ *
+ * The rule only warns when:
+ * - Temperature is NOT 1.0
+ * - AND responseMimeType is NOT 'application/json' (structured output)
+ */
 declare const rule: Rule.RuleModule;
 export default rule;
 //# sourceMappingURL=check-temperature-defaults.d.ts.map

package/dist/rules/check-temperature-defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-temperature-defaults.d.ts","sourceRoot":"","sources":["../../src/rules/check-temperature-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAOnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UA6DhB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"check-temperature-defaults.d.ts","sourceRoot":"","sources":["../../src/rules/check-temperature-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAQnC;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAgFhB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/check-temperature-defaults.js

@@ -1,17 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ast_helpers_js_1 = require("../utils/ast-helpers.js");
+/**
+ * check-temperature-defaults
+ *
+ * This rule suggests using the default temperature (1.0) for Gemini models,
+ * but with important exceptions:
+ *
+ * EXCEPTIONS (low temperature is valid and recommended):
+ * 1. Structured output (responseMimeType: 'application/json')
+ *    - Low temperature (0.1-0.3) prevents hallucinations in extraction tasks
+ * 2. Classification tasks
+ *    - Deterministic outputs benefit from low temperature
+ * 3. Data extraction
+ *    - Precise extraction needs low temperature
+ *
+ * The rule only warns when:
+ * - Temperature is NOT 1.0
+ * - AND responseMimeType is NOT 'application/json' (structured output)
+ */
 const rule = {
     meta: {
-        type: 'problem',
+        type: 'suggestion',
         docs: {
-            description: 'Enforce default temperature (1.0) for Gemini 3 models to prevent unexpected behavior',
+            description: 'Suggest default temperature (1.0) for Gemini models, except for structured output tasks',
             recommended: true,
             url: 'https://github.com/Just-mpm/eslint-plugin-firebase-ai-logic#check-temperature-defaults',
         },
         schema: [],
         messages: {
-            nonDefaultTemperature: 'Gemini 3 models are optimized for the default temperature (1.0). Changing this value may lead to unexpected behavior, looping, or degraded reasoning performance.',
+            nonDefaultTemperature: 'Consider using the default temperature (1.0) for Gemini models. Lower values may cause looping or degraded reasoning. Exception: low temperature (0.1-0.3) is appropriate for structured output (JSON extraction) tasks.',
         },
     },
     create(context) {
@@ -34,13 +52,30 @@ const rule = {
                     : configArg;
                 if (!(0, ast_helpers_js_1.isObjectExpression)(configToCheck))
                     return;
+                // Check for responseMimeType - if it's 'application/json', low temperature is valid
+                const responseMimeTypeProp = (0, ast_helpers_js_1.findProperty)(configToCheck, 'responseMimeType');
+                if (responseMimeTypeProp) {
+                    const mimeType = (0, ast_helpers_js_1.getStringValue)(responseMimeTypeProp.value);
+                    if (mimeType === 'application/json') {
+                        // Structured output - low temperature is appropriate, don't warn
+                        return;
+                    }
+                }
+                // Check for responseSchema - if present, it's structured output
+                const responseSchemaProp = (0, ast_helpers_js_1.findProperty)(configToCheck, 'responseSchema');
+                if (responseSchemaProp) {
+                    // Has response schema - structured output, don't warn
+                    return;
+                }
                 // Check for temperature property
                 const temperatureProp = (0, ast_helpers_js_1.findProperty)(configToCheck, 'temperature');
                 if (temperatureProp) {
-                    // If value is literal and not 1.0, report
+                    // If value is literal and not 1.0, suggest (not require) using default
                     if (temperatureProp.value.type === 'Literal' &&
                         typeof temperatureProp.value.value === 'number') {
-                        if (temperatureProp.value.value !== 1.0) {
+                        const temp = temperatureProp.value.value;
+                        // Only warn for non-default temperature when NOT doing structured output
+                        if (temp !== 1.0) {
                             context.report({
                                 node: temperatureProp,
                                 messageId: 'nonDefaultTemperature',

package/dist/rules/check-temperature-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-temperature-defaults.js","sourceRoot":"","sources":["../../src/rules/check-temperature-defaults.ts"],"names":[],"mappings":";;AACA,4DAIiC;AAEjC,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,sFAAsF;YACxF,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,wFAAwF;SAC9F;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,qBAAqB,EACnB,mKAAmK;SACtK;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,oDAAoD;gBACpD,IACE,UAAU,KAAK,oBAAoB;oBACnC,UAAU,KAAK,iBAAiB,EAChC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,+CAA+C;gBAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAA,mCAAkB,EAAC,SAAS,CAAC;oBAAE,OAAO;gBAEzD,6BAA6B;gBAC7B,IAAI,gBAAgB,GAAG,IAAA,6BAAY,EAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;gBACnE,IAAI,aAAa,GAAG,gBAAgB;oBAClC,CAAC,CAAC,gBAAgB,CAAC,KAAK;oBACxB,CAAC,CAAC,SAAS,CAAC;gBAEd,IAAI,CAAC,IAAA,mCAAkB,EAAC,aAAa,CAAC;oBAAE,OAAO;gBAE/C,iCAAiC;gBACjC,MAAM,eAAe,GAAG,IAAA,6BAAY,EAAC,aAAa,EAAE,aAAa,CAAC,CAAC;gBAEnE,IAAI,eAAe,EAAE,CAAC;oBACpB,0CAA0C;oBAC1C,IACE,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;wBACxC,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAC/C,CAAC;wBACD,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;4BACxC,OAAO,CAAC,MAAM,CAAC;gCACb,IAAI,EAAE,eAAe;gCACrB,SAAS,EAAE,uBAAuB;6BACnC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"check-temperature-defaults.js","sourceRoot":"","sources":["../../src/rules/check-temperature-defaults.ts"],"names":[],"mappings":";;AACA,4DAKiC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,yFAAyF;YAC3F,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,wFAAwF;SAC9F;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,qBAAqB,EACnB,0NAA0N;SAC7N;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,oDAAoD;gBACpD,IACE,UAAU,KAAK,oBAAoB;oBACnC,UAAU,KAAK,iBAAiB,EAChC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,+CAA+C;gBAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAA,mCAAkB,EAAC,SAAS,CAAC;oBAAE,OAAO;gBAEzD,6BAA6B;gBAC7B,IAAI,gBAAgB,GAAG,IAAA,6BAAY,EAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;gBACnE,IAAI,aAAa,GAAG,gBAAgB;oBAClC,CAAC,CAAC,gBAAgB,CAAC,KAAK;oBACxB,CAAC,CAAC,SAAS,CAAC;gBAEd,IAAI,CAAC,IAAA,mCAAkB,EAAC,aAAa,CAAC;oBAAE,OAAO;gBAE/C,oFAAoF;gBACpF,MAAM,oBAAoB,GAAG,IAAA,6BAAY,EAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;gBAC7E,IAAI,oBAAoB,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,IAAA,+BAAc,EAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;oBAC5D,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;wBACpC,iEAAiE;wBACjE,OAAO;oBACT,CAAC;gBACH,CAAC;gBAED,gEAAgE;gBAChE,MAAM,kBAAkB,GAAG,IAAA,6BAAY,EAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;gBACzE,IAAI,kBAAkB,EAAE,CAAC;oBACvB,sDAAsD;oBACtD,OAAO;gBACT,CAAC;gBAED,iCAAiC;gBACjC,MAAM,eAAe,GAAG,IAAA,6BAAY,EAAC,aAAa,EAAE,aAAa,CAAC,CAAC;gBAEnE,IAAI,eAAe,EAAE,CAAC;oBACpB,uEAAuE;oBACvE,IACE,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;wBACxC,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAC/C,CAAC;wBACD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;wBACzC,yEAAyE;wBACzE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;4BACjB,OAAO,CAAC,MAAM,CAAC;gCACb,IAAI,EAAE,eAAe;gCACrB,SAAS,EAAE,uBAAuB;6BACnC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/dist/rules/require-app-check-production.d.ts

@@ -1,4 +1,21 @@
 import type { Rule } from 'eslint';
+/**
+ * require-app-check-production
+ *
+ * This rule suggests using App Check to protect AI endpoints from abuse.
+ *
+ * IMPORTANT LIMITATIONS:
+ * - This rule only checks within the SAME FILE
+ * - Many projects use lazy loading where App Check is initialized in a separate file
+ * - Projects using hooks like useAppCheck() or ensureAppCheckReady() are valid
+ *
+ * The rule checks for:
+ * 1. Direct import of 'firebase/app-check'
+ * 2. Calls to initializeAppCheck()
+ * 3. Common patterns: useAppCheck, ensureAppCheckReady, AppCheckProvider
+ *
+ * If none are found in the same file as getAI(), it suggests (not requires) App Check.
+ */
 declare const rule: Rule.RuleModule;
 export default rule;
 //# sourceMappingURL=require-app-check-production.d.ts.map

package/dist/rules/require-app-check-production.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"require-app-check-production.d.ts","sourceRoot":"","sources":["../../src/rules/require-app-check-production.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAmEhB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"require-app-check-production.d.ts","sourceRoot":"","sources":["../../src/rules/require-app-check-production.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnC;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAsGhB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/require-app-check-production.js

@@ -1,6 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ast_helpers_js_1 = require("../utils/ast-helpers.js");
+/**
+ * require-app-check-production
+ *
+ * This rule suggests using App Check to protect AI endpoints from abuse.
+ *
+ * IMPORTANT LIMITATIONS:
+ * - This rule only checks within the SAME FILE
+ * - Many projects use lazy loading where App Check is initialized in a separate file
+ * - Projects using hooks like useAppCheck() or ensureAppCheckReady() are valid
+ *
+ * The rule checks for:
+ * 1. Direct import of 'firebase/app-check'
+ * 2. Calls to initializeAppCheck()
+ * 3. Common patterns: useAppCheck, ensureAppCheckReady, AppCheckProvider
+ *
+ * If none are found in the same file as getAI(), it suggests (not requires) App Check.
+ */
 const rule = {
     meta: {
         type: 'suggestion',
@@ -11,31 +28,62 @@ const rule = {
         },
         schema: [],
         messages: {
-            missingAppCheck: 'Consider using App Check with reCAPTCHA to protect your AI endpoints from abuse. Initialize with initializeAppCheck() before using AI features.',
-            appCheckSuggestion: "import { initializeAppCheck, ReCaptchaV3Provider } from 'firebase/app-check'; initializeAppCheck(app, { provider: new ReCaptchaV3Provider('SITE_KEY') });",
+            missingAppCheck: 'Consider using App Check to protect your AI endpoints from abuse. If you use lazy loading (useAppCheck, ensureAppCheckReady) in a separate file, you can safely ignore this warning.',
+            appCheckSuggestion: "import { initializeAppCheck, ReCaptchaEnterpriseProvider } from 'firebase/app-check'; initializeAppCheck(app, { provider: new ReCaptchaEnterpriseProvider('SITE_KEY') });",
         },
     },
     create(context) {
         let hasAppCheckImport = false;
         let hasAppCheckInit = false;
+        let hasAppCheckHelper = false;
         let hasAIInit = false;
         let aiInitNode = null;
+        // Common App Check helper patterns used in lazy loading
+        const appCheckHelperPatterns = [
+            'useAppCheck',
+            'ensureAppCheckReady',
+            'AppCheckProvider',
+            'getAppCheckInstance',
+            'isAppCheckReady',
+            'initializeAppCheckLazy',
+        ];
         return {
             // Track App Check imports
             ImportDeclaration(node) {
-                if (node.source.value === 'firebase/app-check' &&
-                    node.specifiers.some((spec) => spec.type === 'ImportSpecifier' &&
-                        spec.imported.type === 'Identifier' &&
-                        spec.imported.name === 'initializeAppCheck')) {
+                const source = node.source.value;
+                // Direct firebase/app-check import
+                if (source === 'firebase/app-check') {
                     hasAppCheckImport = true;
                 }
+                // Check for imports from common App Check helper files/hooks
+                if (typeof source === 'string' &&
+                    (source.includes('useAppCheck') ||
+                        source.includes('AppCheck') ||
+                        source.includes('appCheck'))) {
+                    hasAppCheckHelper = true;
+                }
+                // Check imported specifiers for App Check helpers
+                for (const spec of node.specifiers) {
+                    if (spec.type === 'ImportSpecifier' && spec.imported.type === 'Identifier') {
+                        if (appCheckHelperPatterns.includes(spec.imported.name)) {
+                            hasAppCheckHelper = true;
+                        }
+                    }
+                }
             },
-            // Track initializeAppCheck calls
+            // Track function calls
             CallExpression(node) {
                 const calleeName = (0, ast_helpers_js_1.getCalleeName)(node);
+                if (!calleeName)
+                    return;
+                // Direct initializeAppCheck call
                 if (calleeName === 'initializeAppCheck') {
                     hasAppCheckInit = true;
                 }
+                // App Check helper calls
+                if (appCheckHelperPatterns.includes(calleeName)) {
+                    hasAppCheckHelper = true;
+                }
                 // Track getAI calls
                 if (calleeName === 'getAI') {
                     hasAIInit = true;
@@ -44,8 +92,9 @@ const rule = {
             },
             // Check at the end of the program
             'Program:exit'() {
-                // Only warn if AI is being used but App Check is not configured
-                if (hasAIInit && !hasAppCheckImport && !hasAppCheckInit && aiInitNode) {
+                // Only suggest if AI is being used but no App Check patterns found
+                const hasAnyAppCheckPattern = hasAppCheckImport || hasAppCheckInit || hasAppCheckHelper;
+                if (hasAIInit && !hasAnyAppCheckPattern && aiInitNode) {
                     context.report({
                         node: aiInitNode,
                         messageId: 'missingAppCheck',

package/dist/rules/require-app-check-production.js.map

@@ -1 +1 @@
-{"version":3,"file":"require-app-check-production.js","sourceRoot":"","sources":["../../src/rules/require-app-check-production.ts"],"names":[],"mappings":";;AACA,4DAAwD;AAExD,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,iFAAiF;YACnF,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,0FAA0F;SAChG;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,eAAe,EACb,iJAAiJ;YACnJ,kBAAkB,EAChB,2JAA2J;SAC9J;KACF;IAED,MAAM,CAAC,OAAO;QACZ,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,UAAU,GAAqB,IAAI,CAAC;QAExC,OAAO;YACL,0BAA0B;YAC1B,iBAAiB,CAAC,IAAI;gBACpB,IACE,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,oBAAoB;oBAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,IAAI,KAAK,iBAAiB;wBAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;wBACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,oBAAoB,CAC9C,EACD,CAAC;oBACD,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,IAAI,UAAU,KAAK,oBAAoB,EAAE,CAAC;oBACxC,eAAe,GAAG,IAAI,CAAC;gBACzB,CAAC;gBAED,oBAAoB;gBACpB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;oBAC3B,SAAS,GAAG,IAAI,CAAC;oBACjB,UAAU,GAAG,IAAiB,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,kCAAkC;YAClC,cAAc;gBACZ,gEAAgE;gBAChE,IAAI,SAAS,IAAI,CAAC,iBAAiB,IAAI,CAAC,eAAe,IAAI,UAAU,EAAE,CAAC;oBACtE,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,UAAU;wBAChB,SAAS,EAAE,iBAAiB;qBAC7B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"require-app-check-production.js","sourceRoot":"","sources":["../../src/rules/require-app-check-production.ts"],"names":[],"mappings":";;AACA,4DAAwD;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,iFAAiF;YACnF,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,0FAA0F;SAChG;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,eAAe,EACb,sLAAsL;YACxL,kBAAkB,EAChB,2KAA2K;SAC9K;KACF;IAED,MAAM,CAAC,OAAO;QACZ,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,UAAU,GAAqB,IAAI,CAAC;QAExC,wDAAwD;QACxD,MAAM,sBAAsB,GAAG;YAC7B,aAAa;YACb,qBAAqB;YACrB,kBAAkB;YAClB,qBAAqB;YACrB,iBAAiB;YACjB,wBAAwB;SACzB,CAAC;QAEF,OAAO;YACL,0BAA0B;YAC1B,iBAAiB,CAAC,IAAI;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAEjC,mCAAmC;gBACnC,IAAI,MAAM,KAAK,oBAAoB,EAAE,CAAC;oBACpC,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;gBAED,6DAA6D;gBAC7D,IACE,OAAO,MAAM,KAAK,QAAQ;oBAC1B,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;wBAC7B,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAC3B,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAC9B,CAAC;oBACD,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;gBAED,kDAAkD;gBAClD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC3E,IAAI,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;4BACxD,iBAAiB,GAAG,IAAI,CAAC;wBAC3B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,IAAI,CAAC,UAAU;oBAAE,OAAO;gBAExB,iCAAiC;gBACjC,IAAI,UAAU,KAAK,oBAAoB,EAAE,CAAC;oBACxC,eAAe,GAAG,IAAI,CAAC;gBACzB,CAAC;gBAED,yBAAyB;gBACzB,IAAI,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChD,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;gBAED,oBAAoB;gBACpB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;oBAC3B,SAAS,GAAG,IAAI,CAAC;oBACjB,UAAU,GAAG,IAAiB,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,kCAAkC;YAClC,cAAc;gBACZ,mEAAmE;gBACnE,MAAM,qBAAqB,GAAG,iBAAiB,IAAI,eAAe,IAAI,iBAAiB,CAAC;gBAExF,IAAI,SAAS,IAAI,CAAC,qBAAqB,IAAI,UAAU,EAAE,CAAC;oBACtD,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,UAAU;wBAChB,SAAS,EAAE,iBAAiB;qBAC7B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/dist/rules/require-backend.d.ts

@@ -1,4 +1,21 @@
 import type { Rule } from 'eslint';
+/**
+ * require-backend
+ *
+ * IMPORTANT: getAI(app) without a second argument is VALID.
+ * Firebase AI Logic uses GoogleAIBackend by default when no backend is specified.
+ *
+ * This rule only reports when:
+ * - A second argument (config object) exists BUT doesn't have 'backend' property
+ *
+ * Valid usage:
+ * - getAI(app) - Uses GoogleAIBackend by default ✅
+ * - getAI(app, { backend: new GoogleAIBackend() }) ✅
+ * - getAI(app, { backend: new VertexAIBackend() }) ✅
+ *
+ * Invalid usage:
+ * - getAI(app, { someOtherConfig: true }) - Has config but no backend ❌
+ */
 declare const rule: Rule.RuleModule;
 export default rule;
 //# sourceMappingURL=require-backend.d.ts.map

package/dist/rules/require-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"require-backend.d.ts","sourceRoot":"","sources":["../../src/rules/require-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAOnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UA2GhB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"require-backend.d.ts","sourceRoot":"","sources":["../../src/rules/require-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAOnC;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAyEhB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/require-backend.js

@@ -1,21 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ast_helpers_js_1 = require("../utils/ast-helpers.js");
+/**
+ * require-backend
+ *
+ * IMPORTANT: getAI(app) without a second argument is VALID.
+ * Firebase AI Logic uses GoogleAIBackend by default when no backend is specified.
+ *
+ * This rule only reports when:
+ * - A second argument (config object) exists BUT doesn't have 'backend' property
+ *
+ * Valid usage:
+ * - getAI(app) - Uses GoogleAIBackend by default ✅
+ * - getAI(app, { backend: new GoogleAIBackend() }) ✅
+ * - getAI(app, { backend: new VertexAIBackend() }) ✅
+ *
+ * Invalid usage:
+ * - getAI(app, { someOtherConfig: true }) - Has config but no backend ❌
+ */
 const rule = {
     meta: {
-        type: 'problem',
+        type: 'suggestion',
         docs: {
-            description: "Require 'backend' option when calling getAI() - GoogleAIBackend or VertexAIBackend is mandatory",
+            description: "Suggest specifying 'backend' option when calling getAI() with a config object",
             recommended: true,
             url: 'https://github.com/Just-mpm/eslint-plugin-firebase-ai-logic#require-backend',
         },
         hasSuggestions: true,
         schema: [],
         messages: {
-            missingBackend: "The 'backend' option is required when calling getAI(). Use { backend: new GoogleAIBackend() } or { backend: new VertexAIBackend() }.",
-            missingBackendInConfig: "Missing 'backend' property in getAI() config. Firebase AI Logic requires explicitly specifying GoogleAIBackend or VertexAIBackend.",
-            addGoogleAIBackend: "Add '{ backend: new GoogleAIBackend() }' as second argument",
-            addVertexAIBackend: "Add '{ backend: new VertexAIBackend() }' as second argument",
+            missingBackendInConfig: "Config object provided to getAI() is missing 'backend' property. Consider adding { backend: new GoogleAIBackend() } or { backend: new VertexAIBackend() } for explicit backend selection.",
+            addGoogleAIBackend: "Add 'backend: new GoogleAIBackend()' to config",
+            addVertexAIBackend: "Add 'backend: new VertexAIBackend()' to config",
         },
     },
     create(context) {
@@ -25,43 +41,17 @@ const rule = {
                 if (calleeName !== 'getAI')
                     return;
                 const args = node.arguments;
-                // Case 1: No second argument at all
+                // getAI(app) without second argument is VALID - uses GoogleAIBackend by default
+                // Only check if there IS a second argument
                 if (args.length < 2) {
-                    context.report({
-                        node,
-                        messageId: 'missingBackend',
-                        suggest: [
-                            {
-                                messageId: 'addGoogleAIBackend',
-                                fix(fixer) {
-                                    const firstArg = args[0];
-                                    if (!firstArg)
-                                        return null;
-                                    const sourceCode = context.sourceCode;
-                                    const firstArgText = sourceCode.getText(firstArg);
-                                    return fixer.replaceText(node, `getAI(${firstArgText}, { backend: new GoogleAIBackend() })`);
-                                },
-                            },
-                            {
-                                messageId: 'addVertexAIBackend',
-                                fix(fixer) {
-                                    const firstArg = args[0];
-                                    if (!firstArg)
-                                        return null;
-                                    const sourceCode = context.sourceCode;
-                                    const firstArgText = sourceCode.getText(firstArg);
-                                    return fixer.replaceText(node, `getAI(${firstArgText}, { backend: new VertexAIBackend() })`);
-                                },
-                            },
-                        ],
-                    });
-                    return;
+                    return; // This is fine - default backend will be used
                 }
-                // Case 2: Second argument exists but might not have backend
+                // Case: Second argument exists but might not have backend
                 const configArg = args[1];
                 if ((0, ast_helpers_js_1.isObjectExpression)(configArg)) {
                     const backendProp = (0, ast_helpers_js_1.findProperty)(configArg, 'backend');
-                    if (!backendProp) {
+                    // Only report if config object exists but doesn't have backend
+                    if (!backendProp && configArg.properties.length > 0) {
                         context.report({
                             node: configArg,
                             messageId: 'missingBackendInConfig',
@@ -69,14 +59,17 @@ const rule = {
                                 {
                                     messageId: 'addGoogleAIBackend',
                                     fix(fixer) {
-                                        // Insert backend property at the beginning of the object
-                                        if (configArg.properties.length === 0) {
-                                            return fixer.replaceText(configArg, '{ backend: new GoogleAIBackend() }');
-                                        }
                                         const firstProp = configArg.properties[0];
                                         return fixer.insertTextBefore(firstProp, 'backend: new GoogleAIBackend(), ');
                                     },
                                 },
+                                {
+                                    messageId: 'addVertexAIBackend',
+                                    fix(fixer) {
+                                        const firstProp = configArg.properties[0];
+                                        return fixer.insertTextBefore(firstProp, 'backend: new VertexAIBackend(), ');
+                                    },
+                                },
                             ],
                         });
                     }

package/dist/rules/require-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"require-backend.js","sourceRoot":"","sources":["../../src/rules/require-backend.ts"],"names":[],"mappings":";;AACA,4DAIiC;AAEjC,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,iGAAiG;YACnG,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,6EAA6E;SACnF;QACD,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,cAAc,EACZ,sIAAsI;YACxI,sBAAsB,EACpB,oIAAoI;YACtI,kBAAkB,EAAE,6DAA6D;YACjF,kBAAkB,EAAE,6DAA6D;SAClF;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,IAAI,UAAU,KAAK,OAAO;oBAAE,OAAO;gBAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;gBAE5B,oCAAoC;gBACpC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI;wBACJ,SAAS,EAAE,gBAAgB;wBAC3B,OAAO,EAAE;4BACP;gCACE,SAAS,EAAE,oBAAoB;gCAC/B,GAAG,CAAC,KAAK;oCACP,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;oCACzB,IAAI,CAAC,QAAQ;wCAAE,OAAO,IAAI,CAAC;oCAE3B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;oCACtC,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oCAElD,OAAO,KAAK,CAAC,WAAW,CACtB,IAAI,EACJ,SAAS,YAAY,uCAAuC,CAC7D,CAAC;gCACJ,CAAC;6BACF;4BACD;gCACE,SAAS,EAAE,oBAAoB;gCAC/B,GAAG,CAAC,KAAK;oCACP,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;oCACzB,IAAI,CAAC,QAAQ;wCAAE,OAAO,IAAI,CAAC;oCAE3B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;oCACtC,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oCAElD,OAAO,KAAK,CAAC,WAAW,CACtB,IAAI,EACJ,SAAS,YAAY,uCAAuC,CAC7D,CAAC;gCACJ,CAAC;6BACF;yBACF;qBACF,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,4DAA4D;gBAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAE1B,IAAI,IAAA,mCAAkB,EAAC,SAAS,CAAC,EAAE,CAAC;oBAClC,MAAM,WAAW,GAAG,IAAA,6BAAY,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;oBAEvD,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,SAAS;4BACf,SAAS,EAAE,wBAAwB;4BACnC,OAAO,EAAE;gCACP;oCACE,SAAS,EAAE,oBAAoB;oCAC/B,GAAG,CAAC,KAAK;wCACP,yDAAyD;wCACzD,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;4CACtC,OAAO,KAAK,CAAC,WAAW,CACtB,SAAS,EACT,oCAAoC,CACrC,CAAC;wCACJ,CAAC;wCAED,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wCAC1C,OAAO,KAAK,CAAC,gBAAgB,CAC3B,SAAS,EACT,kCAAkC,CACnC,CAAC;oCACJ,CAAC;iCACF;6BACF;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"require-backend.js","sourceRoot":"","sources":["../../src/rules/require-backend.ts"],"names":[],"mappings":";;AACA,4DAIiC;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,+EAA+E;YACjF,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,6EAA6E;SACnF;QACD,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,sBAAsB,EACpB,2LAA2L;YAC7L,kBAAkB,EAAE,gDAAgD;YACpE,kBAAkB,EAAE,gDAAgD;SACrE;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;gBAEvC,IAAI,UAAU,KAAK,OAAO;oBAAE,OAAO;gBAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;gBAE5B,gFAAgF;gBAChF,2CAA2C;gBAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,OAAO,CAAC,8CAA8C;gBACxD,CAAC;gBAED,0DAA0D;gBAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAE1B,IAAI,IAAA,mCAAkB,EAAC,SAAS,CAAC,EAAE,CAAC;oBAClC,MAAM,WAAW,GAAG,IAAA,6BAAY,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;oBAEvD,+DAA+D;oBAC/D,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpD,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,SAAS;4BACf,SAAS,EAAE,wBAAwB;4BACnC,OAAO,EAAE;gCACP;oCACE,SAAS,EAAE,oBAAoB;oCAC/B,GAAG,CAAC,KAAK;wCACP,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wCAC1C,OAAO,KAAK,CAAC,gBAAgB,CAC3B,SAAS,EACT,kCAAkC,CACnC,CAAC;oCACJ,CAAC;iCACF;gCACD;oCACE,SAAS,EAAE,oBAAoB;oCAC/B,GAAG,CAAC,KAAK;wCACP,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wCAC1C,OAAO,KAAK,CAAC,gBAAgB,CAC3B,SAAS,EACT,kCAAkC,CACnC,CAAC;oCACJ,CAAC;iCACF;6BACF;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/dist/rules/require-error-handling.d.ts

@@ -1,4 +1,25 @@
 import type { Rule } from 'eslint';
+/**
+ * require-error-handling
+ *
+ * This rule suggests adding error handling for Firebase AI Logic API calls.
+ *
+ * RECOGNIZED ERROR HANDLING PATTERNS:
+ * 1. Direct try/catch blocks
+ * 2. .catch() chains
+ * 3. .then(onFulfilled, onRejected) with error handler
+ * 4. Wrapper functions with built-in error handling:
+ *    - retryWithBackoff
+ *    - withRetry
+ *    - safeCall
+ *    - handleApiCall
+ *    - executeWithRetry
+ *
+ * The rule checks if the API call is:
+ * - Inside a try/catch block
+ * - Chained with .catch()
+ * - Wrapped in a known error-handling function
+ */
 declare const rule: Rule.RuleModule;
 export default rule;
 //# sourceMappingURL=require-error-handling.d.ts.map

package/dist/rules/require-error-handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"require-error-handling.d.ts","sourceRoot":"","sources":["../../src/rules/require-error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAiHhB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"require-error-handling.d.ts","sourceRoot":"","sources":["../../src/rules/require-error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAgKhB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/require-error-handling.js

@@ -1,11 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ast_helpers_js_1 = require("../utils/ast-helpers.js");
+/**
+ * require-error-handling
+ *
+ * This rule suggests adding error handling for Firebase AI Logic API calls.
+ *
+ * RECOGNIZED ERROR HANDLING PATTERNS:
+ * 1. Direct try/catch blocks
+ * 2. .catch() chains
+ * 3. .then(onFulfilled, onRejected) with error handler
+ * 4. Wrapper functions with built-in error handling:
+ *    - retryWithBackoff
+ *    - withRetry
+ *    - safeCall
+ *    - handleApiCall
+ *    - executeWithRetry
+ *
+ * The rule checks if the API call is:
+ * - Inside a try/catch block
+ * - Chained with .catch()
+ * - Wrapped in a known error-handling function
+ */
 const rule = {
     meta: {
         type: 'suggestion',
         docs: {
-            description: 'Require error handling for Firebase AI Logic API calls, especially for rate limit (429) errors',
+            description: 'Suggest error handling for Firebase AI Logic API calls, especially for rate limit (429) errors',
             recommended: true,
             url: 'https://github.com/Just-mpm/eslint-plugin-firebase-ai-logic#require-error-handling',
         },
@@ -26,6 +47,18 @@ const rule = {
             'countTokens',
             'embedContent',
         ];
+        // Common wrapper functions that provide error handling
+        const errorHandlingWrappers = [
+            'retryWithBackoff',
+            'withRetry',
+            'safeCall',
+            'handleApiCall',
+            'executeWithRetry',
+            'withErrorHandling',
+            'tryCatch',
+            'safeFetch',
+            'retryOperation',
+        ];
         function isInsideTryCatch(node) {
             let current = node.parent;
             while (current) {
@@ -66,6 +99,32 @@ const rule = {
             }
             return false;
         }
+        function isInsideErrorHandlingWrapper(node) {
+            let current = node.parent;
+            while (current) {
+                // Check if we're inside a call to a known error handling wrapper
+                if (current.type === 'CallExpression') {
+                    const wrapperName = (0, ast_helpers_js_1.getCalleeName)(current);
+                    if (wrapperName && errorHandlingWrappers.includes(wrapperName)) {
+                        return true;
+                    }
+                }
+                // Check if we're inside an arrow function or function expression
+                // that is passed to a known error handling wrapper
+                if (current.type === 'ArrowFunctionExpression' ||
+                    current.type === 'FunctionExpression') {
+                    const parent = current.parent;
+                    if (parent?.type === 'CallExpression') {
+                        const wrapperName = (0, ast_helpers_js_1.getCalleeName)(parent);
+                        if (wrapperName && errorHandlingWrappers.includes(wrapperName)) {
+                            return true;
+                        }
+                    }
+                }
+                current = current.parent || null;
+            }
+            return false;
+        }
         return {
             CallExpression(node) {
                 const calleeName = (0, ast_helpers_js_1.getCalleeName)(node);
@@ -74,9 +133,10 @@ const rule = {
                 }
                 // Check if this is an awaited call
                 const isAwaited = node.parent?.type === 'AwaitExpression';
-                // Check if inside try/catch or has .catch()
+                // Check if inside try/catch, has .catch(), or inside error handling wrapper
                 const hasErrorHandling = isInsideTryCatch(node) ||
-                    isInsideAsyncErrorBoundary(node);
+                    isInsideAsyncErrorBoundary(node) ||
+                    isInsideErrorHandlingWrapper(node);
                 if (!hasErrorHandling) {
                     context.report({
                         node,

package/dist/rules/require-error-handling.js.map

@@ -1 +1 @@
-{"version":3,"file":"require-error-handling.js","sourceRoot":"","sources":["../../src/rules/require-error-handling.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"require-error-handling.js","sourceRoot":"","sources":["../../src/rules/require-error-handling.ts"],"names":[],"mappings":"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"}

package/dist/rules/validate-schema-structure.d.ts

@@ -1,4 +1,20 @@
 import type { Rule } from 'eslint';
+/**
+ * validate-schema-structure
+ *
+ * IMPORTANT: The "required" property IS VALID in Firebase AI Logic!
+ *
+ * Firebase AI Logic Schema.object() accepts:
+ * - properties: Define the object properties
+ * - required: Array of required property names (VALID!)
+ * - optionalProperties: Array of optional property names (alternative approach)
+ *
+ * This rule should NOT report errors for using "required" in Schema.object()
+ * because it's a valid and common pattern for function calling parameters.
+ *
+ * The rule now only warns about using BOTH "required" AND "optionalProperties"
+ * in the same schema, which is redundant.
+ */
 declare const rule: Rule.RuleModule;
 export default rule;
 //# sourceMappingURL=validate-schema-structure.d.ts.map

package/dist/rules/validate-schema-structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-schema-structure.d.ts","sourceRoot":"","sources":["../../src/rules/validate-schema-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAMnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAyChB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"validate-schema-structure.d.ts","sourceRoot":"","sources":["../../src/rules/validate-schema-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnC;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,UAqChB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/validate-schema-structure.js

@@ -1,38 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ast_helpers_js_1 = require("../utils/ast-helpers.js");
+/**
+ * validate-schema-structure
+ *
+ * IMPORTANT: The "required" property IS VALID in Firebase AI Logic!
+ *
+ * Firebase AI Logic Schema.object() accepts:
+ * - properties: Define the object properties
+ * - required: Array of required property names (VALID!)
+ * - optionalProperties: Array of optional property names (alternative approach)
+ *
+ * This rule should NOT report errors for using "required" in Schema.object()
+ * because it's a valid and common pattern for function calling parameters.
+ *
+ * The rule now only warns about using BOTH "required" AND "optionalProperties"
+ * in the same schema, which is redundant.
+ */
 const rule = {
     meta: {
-        type: 'problem',
+        type: 'suggestion',
         docs: {
-            description: 'Warn about using standard JSON Schema features like "required" that are handled differently in Firebase AI Logic',
+            description: 'Suggest best practices for Firebase AI Logic schema structure',
             recommended: true,
             url: 'https://github.com/Just-mpm/eslint-plugin-firebase-ai-logic#validate-schema-structure',
         },
         schema: [],
         messages: {
-            redundantRequired: 'In Firebase AI Logic, all properties are required by default. Use "optionalProperties" array to mark fields as optional instead of using "required".',
+            redundantBothRequiredAndOptional: 'Schema has both "required" and "optionalProperties". Consider using only one approach for clarity: either list required fields in "required" array, or list optional fields in "optionalProperties" array.',
         },
     },
     create(context) {
         return {
-            Property(node) {
-                // Check for "required" property in Schema definitions
-                if (node.key.type === 'Identifier' && node.key.name === 'required') {
-                    // Check if we are likely inside a schema definition
-                    // Heuristic: Check if parent object also has "properties" or "type"
-                    // Or if we are inside Schema.object({...}) 
-                    const parent = node.parent;
-                    if ((0, ast_helpers_js_1.isObjectExpression)(parent)) {
-                        const hasProperties = (0, ast_helpers_js_1.findProperty)(parent, 'properties');
-                        const hasType = (0, ast_helpers_js_1.findProperty)(parent, 'type');
-                        if (hasProperties || hasType) {
-                            context.report({
-                                node: node.key,
-                                messageId: 'redundantRequired',
-                            });
-                        }
-                    }
+            // Check for objects that have BOTH required AND optionalProperties
+            ObjectExpression(node) {
+                const hasRequired = (0, ast_helpers_js_1.findProperty)(node, 'required');
+                const hasOptionalProperties = (0, ast_helpers_js_1.findProperty)(node, 'optionalProperties');
+                const hasProperties = (0, ast_helpers_js_1.findProperty)(node, 'properties');
+                // Only check if this looks like a schema definition
+                if (!hasProperties)
+                    return;
+                // Only warn if BOTH are present (redundant)
+                if (hasRequired && hasOptionalProperties) {
+                    context.report({
+                        node: hasOptionalProperties.key,
+                        messageId: 'redundantBothRequiredAndOptional',
+                    });
                 }
             },
         };

package/dist/rules/validate-schema-structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-schema-structure.js","sourceRoot":"","sources":["../../src/rules/validate-schema-structure.ts"],"names":[],"mappings":";;AACA,4DAGiC;AAEjC,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,kHAAkH;YACpH,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,uFAAuF;SAC7F;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,iBAAiB,EACf,sJAAsJ;SACzJ;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,QAAQ,CAAC,IAAI;gBACV,sDAAsD;gBACtD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAClE,oDAAoD;oBACpD,oEAAoE;oBACpE,4CAA4C;oBAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC3B,IAAI,IAAA,mCAAkB,EAAC,MAAM,CAAC,EAAE,CAAC;wBAC9B,MAAM,aAAa,GAAG,IAAA,6BAAY,EAAC,MAAM,EAAE,YAAY,CAAC,CAAC;wBACzD,MAAM,OAAO,GAAG,IAAA,6BAAY,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;wBAE7C,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;4BAC5B,OAAO,CAAC,MAAM,CAAC;gCACZ,IAAI,EAAE,IAAI,CAAC,GAAG;gCACd,SAAS,EAAE,mBAAmB;6BAChC,CAAC,CAAC;wBACN,CAAC;oBACJ,CAAC;gBACJ,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"validate-schema-structure.js","sourceRoot":"","sources":["../../src/rules/validate-schema-structure.ts"],"names":[],"mappings":";;AACA,4DAAuD;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,+DAA+D;YACjE,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,uFAAuF;SAC7F;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,gCAAgC,EAC9B,4MAA4M;SAC/M;KACF;IAED,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,mEAAmE;YACnE,gBAAgB,CAAC,IAAI;gBACnB,MAAM,WAAW,GAAG,IAAA,6BAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACnD,MAAM,qBAAqB,GAAG,IAAA,6BAAY,EAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;gBACvE,MAAM,aAAa,GAAG,IAAA,6BAAY,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBAEvD,oDAAoD;gBACpD,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAE3B,4CAA4C;gBAC5C,IAAI,WAAW,IAAI,qBAAqB,EAAE,CAAC;oBACzC,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,qBAAqB,CAAC,GAAG;wBAC/B,SAAS,EAAE,kCAAkC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/dist/utils/constants.d.ts

@@ -21,11 +21,11 @@ export declare const WRONG_IMPORTS: {
     };
 };
 /** Models that have been retired and return 404 errors */
-export declare const DEPRECATED_MODELS: readonly ["gemini-pro", "gemini-1.0-pro", "gemini-1.0-pro-vision", "gemini-1.5-pro", "gemini-1.5-pro-latest", "gemini-1.5-pro-001", "gemini-1.5-pro-002", "gemini-1.5-flash", "gemini-1.5-flash-latest", "gemini-1.5-flash-001", "gemini-1.5-flash-002", "gemini-1.5-flash-8b", "gemini-2.0-flash", "gemini-2.0-flash-exp", "gemini-2.0-flash-lite", "gemini-2.5-pro", "gemini-2.5-pro-preview", "gemini-2.5-flash", "gemini-2.5-flash-preview", "gemini-2.5-flash-lite", "gemini-2.5-flash-lite-preview"];
+export declare const DEPRECATED_MODELS: readonly ["gemini-pro", "gemini-1.0-pro", "gemini-1.0-pro-vision", "gemini-1.5-pro", "gemini-1.5-pro-latest", "gemini-1.5-pro-001", "gemini-1.5-pro-002", "gemini-1.5-flash", "gemini-1.5-flash-latest", "gemini-1.5-flash-001", "gemini-1.5-flash-002", "gemini-1.5-flash-8b", "gemini-2.0-flash", "gemini-2.0-flash-exp", "gemini-2.0-flash-lite"];
 /** Current recommended model for Firebase AI Logic */
 export declare const RECOMMENDED_MODEL = "gemini-3-flash-preview";
 /** All current valid models */
-export declare const VALID_MODELS: readonly ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-3-pro-image-preview"];
+export declare const VALID_MODELS: readonly ["gemini-2.5-pro", "gemini-2.5-pro-preview", "gemini-2.5-flash", "gemini-2.5-flash-preview", "gemini-2.5-flash-lite", "gemini-2.5-flash-lite-preview", "gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-3-pro-image-preview"];
 /** Schema features not supported by Firebase AI Logic */
 export declare const UNSUPPORTED_SCHEMA_FEATURES: readonly ["minLength", "maxLength", "pattern", "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum", "oneOf", "anyOf", "allOf", "not", "$ref", "if", "then", "else", "default", "const", "minItems", "uniqueItems", "minProperties", "maxProperties", "additionalProperties", "patternProperties"];
 /** Required fields for function declarations */

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,+DAA+D;AAC/D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAMX,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,4eAsBpB,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D,+BAA+B;AAC/B,eAAO,MAAM,YAAY,2FAIf,CAAC;AAMX,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,4SAwB9B,CAAC;AAMX,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,kCAAmC,CAAC;AAEzE,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,+FAS9B,CAAC;AAMX,sCAAsC;AACtC,eAAO,MAAM,0BAA0B,6FAO7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,0BAA0B,qIAU7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,0BAA0B,yGAQ7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,wUAK3B,CAAC;AAMX,yCAAyC;AACzC,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,sHAK1B,CAAC;AAMX,uBAAuB;AACvB,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,sCAAsC;AACtC,eAAO,MAAM,eAAe,KAAK,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,+DAA+D;AAC/D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAMX,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,sVAqBpB,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D,+BAA+B;AAC/B,eAAO,MAAM,YAAY,iPAYf,CAAC;AAMX,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,4SAwB9B,CAAC;AAMX,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,kCAAmC,CAAC;AAEzE,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,+FAS9B,CAAC;AAMX,sCAAsC;AACtC,eAAO,MAAM,0BAA0B,6FAO7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,0BAA0B,qIAU7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,0BAA0B,yGAQ7B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,wUAK3B,CAAC;AAMX,yCAAyC;AACzC,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,sHAK1B,CAAC;AAMX,uBAAuB;AACvB,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,sCAAsC;AACtC,eAAO,MAAM,eAAe,KAAK,CAAC"}

package/dist/utils/constants.js

@@ -31,9 +31,11 @@ exports.WRONG_IMPORTS = {
 // ============================================================================
 /** Models that have been retired and return 404 errors */
 exports.DEPRECATED_MODELS = [
+    // Gemini 1.0 - Fully deprecated
     'gemini-pro',
     'gemini-1.0-pro',
     'gemini-1.0-pro-vision',
+    // Gemini 1.5 - Fully deprecated
     'gemini-1.5-pro',
     'gemini-1.5-pro-latest',
     'gemini-1.5-pro-001',
@@ -43,20 +45,25 @@ exports.DEPRECATED_MODELS = [
     'gemini-1.5-flash-001',
     'gemini-1.5-flash-002',
     'gemini-1.5-flash-8b',
+    // Gemini 2.0 - Fully deprecated
     'gemini-2.0-flash',
     'gemini-2.0-flash-exp',
     'gemini-2.0-flash-lite',
+    // Note: Gemini 2.5 models are NOT deprecated - they are current stable models
+    // gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite are valid
+];
+/** Current recommended model for Firebase AI Logic */
+exports.RECOMMENDED_MODEL = 'gemini-3-flash-preview';
+/** All current valid models */
+exports.VALID_MODELS = [
+    // Gemini 2.5 - Current stable models
     'gemini-2.5-pro',
     'gemini-2.5-pro-preview',
     'gemini-2.5-flash',
     'gemini-2.5-flash-preview',
     'gemini-2.5-flash-lite',
     'gemini-2.5-flash-lite-preview',
-];
-/** Current recommended model for Firebase AI Logic */
-exports.RECOMMENDED_MODEL = 'gemini-3-flash-preview';
-/** All current valid models */
-exports.VALID_MODELS = [
+    // Gemini 3 - Preview models
     'gemini-3-pro-preview',
     'gemini-3-flash-preview',
     'gemini-3-pro-image-preview',

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-firebase-ai-logic",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "ESLint plugin for Firebase AI Logic best practices, detecting deprecated imports, models, and common anti-patterns",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",