eslint-plugin-express-security 4.0.2 → 4.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md ADDED
@@ -0,0 +1,128 @@
1
+ <!-- Generated by scripts/generate-plugin-agents-md.ts from package.json and the plugin exports. Do not edit by hand; run `npm run agents-md`. -->
2
+
3
+ # eslint-plugin-express-security
4
+
5
+ Guide for AI coding assistants using this plugin in a project. To change the plugin's own source, read https://github.com/ofri-peretz/eslint/blob/main/AGENTS.md instead.
6
+
7
+ > ESLint Express security rules — detects permissive CORS, missing CSRF protection, missing helmet headers, insecure cookies, and GraphQL introspection in production.
8
+
9
+ ## Enable it
10
+
11
+ ```bash
12
+ npm install --save-dev eslint-plugin-express-security
13
+ ```
14
+
15
+ Requires ESLint ^8.40.0 || ^9.0.0 || ^10.0.0 and Node >=22.13.0.
16
+
17
+ Flat config files (`eslint.config.*`) are found by ESLint 8.57 and newer; on ESLint 9 and 10 they are the default.
18
+
19
+ ```js
20
+ // eslint.config.mjs
21
+ import expressSecurity from 'eslint-plugin-express-security';
22
+
23
+ export default [expressSecurity.configs.recommended];
24
+ ```
25
+
26
+ Each preset is one flat config object: put it in the array as an element, do not spread it. Rule ids are prefixed `express-security/`. Add it to the config you already have; do not remove other plugins. TypeScript files need a TypeScript parser in the config (`typescript-eslint`).
27
+
28
+ Use it alongside `eslint-plugin-security`, not instead of it: keep that plugin if the project has it. Measured overlap and the limits of both: https://eslint.interlace.tools/docs/getting-started/with-eslint-plugin-security
29
+
30
+ ## Presets
31
+
32
+ | Preset | Rules | Errors | Warnings |
33
+ | ------------- | ----- | ------ | -------- |
34
+ | `recommended` | 25 | 16 | 9 |
35
+ | `strict` | 28 | 28 | 0 |
36
+ | `api` | 9 | 9 | 0 |
37
+ | `graphql` | 1 | 1 | 0 |
38
+
39
+ ### `recommended`
40
+
41
+ 25 rules:
42
+
43
+ - `require-helmet` (error): Require helmet middleware for security headers in Express.js applications.
44
+ - `no-permissive-cors` (error): Disallow overly permissive CORS configurations (wildcard origin, origin: true).
45
+ - `require-csrf-protection` (warn): Require CSRF protection middleware for state-changing HTTP methods.
46
+ - `no-insecure-cookie-options` (error): Require secure cookie flags (httpOnly, secure, sameSite) in Express.js.
47
+ - `require-rate-limiting` (error): Require rate-limiting middleware in Express.js applications.
48
+ - `no-graphql-introspection-production` (warn): Disallow GraphQL introspection in production environments.
49
+ - `no-cors-credentials-wildcard` (error): Disallow credentials: true with wildcard CORS origin (CVE-2024-25124).
50
+ - `require-express-body-parser-limits` (warn): Require size limits on Express.js body parsers to prevent DoS attacks.
51
+ - `no-express-unsafe-regex-route` (error): Disallow ReDoS-vulnerable regular expressions in Express.js route patterns.
52
+ - `no-exposed-debug-endpoints` (error): Detect debug endpoints without auth in Express applications.
53
+ - `no-user-controlled-redirect` (error): Disallow res.redirect() with values directly from req.query / req.body / req.params.
54
+ - `no-host-header-in-links` (error): Disallow building absolute URLs (reset/verification links) from the Host or X-Forwarded-Host request header.
55
+ - `no-error-details-in-response` (error): Disallow sending caught error objects, stacks, or spreads of them in HTTP responses.
56
+ - `no-sensitive-data-in-query` (warn): Disallow reading sensitive-named parameters (password, token, secret, ...) from req.query.
57
+ - `no-user-controlled-render-locals` (error): Disallow res.render() with locals or view names sourced wholesale from req.body / req.query / req.params.
58
+ - `no-static-root-exposure` (error): Disallow express.static() roots that expose the application directory and any serve-index usage.
59
+ - `require-case-insensitive-path-guard` (warn): Require case-insensitive comparison when guarding protected paths via req.path / req.url / req.originalUrl.
60
+ - `require-query-type-guard` (warn): Require a type guard or String() coercion before calling string methods on req.query values.
61
+ - `no-disabled-helmet-protections` (error): Disallow disabling helmet security-header defaults: contentSecurityPolicy, frameguard/xFrameOptions, noSniff/xContentTypeOptions, referrerPolicy, hidePoweredBy/xPoweredBy, crossOriginResourcePolicy, crossOriginOpenerPolicy.
62
+ - `require-strict-transport-security` (error): Require a Strict-Transport-Security header with a long max-age and includeSubDomains.
63
+ - `no-unsafe-csp-directives` (error): Disallow Content-Security-Policy directives that permit 'unsafe-inline', 'unsafe-eval', wildcard sources, or unrestricted framing.
64
+ - `no-permissive-trust-proxy` (error): Disallow unconditional 'trust proxy' — it makes req.ip client-controlled.
65
+ - `require-route-authentication` (warn): Require authentication on routes that expose a critical function (account, credential, payment, configuration).
66
+ - `no-client-controlled-authorization` (warn): Disallow authorization decisions taken on request-supplied role, permission or identity values.
67
+ - `no-idor-resource-access` (warn): Disallow fetching a resource by a request-supplied key in a handler with no principal in scope.
68
+
69
+ ### `strict`
70
+
71
+ Everything in `recommended` plus 3 more (some shared rules run at a different severity here):
72
+
73
+ - `no-missing-cors-check` (error): Detects missing CORS validation (wildcard CORS, missing origin check).
74
+ - `no-missing-csrf-protection` (error): Detects missing CSRF token validation in POST/PUT/DELETE requests.
75
+ - `no-missing-security-headers` (error): Detects missing security headers in HTTP responses.
76
+
77
+ ### `api`
78
+
79
+ 9 rules:
80
+
81
+ - `require-helmet` (error): Require helmet middleware for security headers in Express.js applications.
82
+ - `no-disabled-helmet-protections` (error): Disallow disabling helmet security-header defaults: contentSecurityPolicy, frameguard/xFrameOptions, noSniff/xContentTypeOptions, referrerPolicy, hidePoweredBy/xPoweredBy, crossOriginResourcePolicy, crossOriginOpenerPolicy.
83
+ - `require-strict-transport-security` (error): Require a Strict-Transport-Security header with a long max-age and includeSubDomains.
84
+ - `no-unsafe-csp-directives` (error): Disallow Content-Security-Policy directives that permit 'unsafe-inline', 'unsafe-eval', wildcard sources, or unrestricted framing.
85
+ - `no-permissive-trust-proxy` (error): Disallow unconditional 'trust proxy' — it makes req.ip client-controlled.
86
+ - `no-permissive-cors` (error): Disallow overly permissive CORS configurations (wildcard origin, origin: true).
87
+ - `require-csrf-protection` (error): Require CSRF protection middleware for state-changing HTTP methods.
88
+ - `no-insecure-cookie-options` (error): Require secure cookie flags (httpOnly, secure, sameSite) in Express.js.
89
+ - `require-rate-limiting` (error): Require rate-limiting middleware in Express.js applications.
90
+
91
+ ### `graphql`
92
+
93
+ 1 rule:
94
+
95
+ - `no-graphql-introspection-production` (error): Disallow GraphQL introspection in production environments.
96
+
97
+ ## Other Interlace plugins by dependency
98
+
99
+ If the project also depends on one of these, add the matching plugin the same way:
100
+
101
+ - `express`, `fastify`, `koa`, `@hapi/hapi`, `restify`, `hono`, `next`, `@nestjs/core`, `@nestjs/common`, `aws-lambda`, `@types/aws-lambda`, `@middy/core`, `commander`, `yargs`, `@oclif/core`, `@modelcontextprotocol/*`: `eslint-plugin-node-security`
102
+ - `@nestjs/common`, `@nestjs/core`: `eslint-plugin-nestjs-security`
103
+ - `react`, `react-dom`, `preact`, `vue`, `svelte`, `@angular/core`, `solid-js`, `lit`, `next`, `nuxt`: `eslint-plugin-browser-security`
104
+ - `jsonwebtoken`, `jose`, `express-jwt`, `@nestjs/jwt`, `jwks-rsa`, `jwt-decode`: `eslint-plugin-jwt-security`
105
+ - `pg`, `pg-pool`, `pg-promise`, `postgres`, `slonik`: `eslint-plugin-postgresql-security`
106
+ - `mysql2`, `mysql`: `eslint-plugin-mysql-security`
107
+ - `mongodb`, `mongoose`: `eslint-plugin-mongodb-security`
108
+ - `better-sqlite3`, `sqlite3`: `eslint-plugin-sqlite-security`
109
+ - `knex`: `eslint-plugin-knex-security`
110
+ - `@prisma/client`, `prisma`: `eslint-plugin-prisma-security`
111
+ - `drizzle-orm`: `eslint-plugin-drizzle-security`
112
+ - `sequelize`: `eslint-plugin-sequelize-security`
113
+ - `typeorm`: `eslint-plugin-typeorm-security`
114
+ - `@supabase/supabase-js`: `eslint-plugin-supabase-security`
115
+ - `@modelcontextprotocol/*`: `eslint-plugin-mcp-sdk-security`
116
+ - `openai`, `@openai/agents`: `eslint-plugin-openai-security`
117
+ - `@anthropic-ai/sdk`, `@anthropic-ai/claude-agent-sdk`: `eslint-plugin-anthropic-security`
118
+ - `@google/genai`: `eslint-plugin-gemini-security`
119
+ - `ai`: `eslint-plugin-vercel-ai-security`
120
+ - `aws-lambda`, `@types/aws-lambda`, `@middy/core`: `eslint-plugin-lambda-security`
121
+
122
+ The full stack-to-plugin playbook (with config rendering and a proof step) is the `security-linting` skill: https://github.com/ofri-peretz/eslint/tree/main/skills/security-linting
123
+
124
+ ## More
125
+
126
+ - Docs: https://eslint.interlace.tools/docs/security/plugin-express-security
127
+ - README.md in this package: every rule with examples.
128
+ - `eslint-plugin-express-security/oxlint` is an entry point for oxlint's JS plugin support; see the README.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eslint-plugin-express-security",
3
- "version": "4.0.2",
3
+ "version": "4.0.4",
4
4
  "description": "ESLint Express security rules — detects permissive CORS, missing CSRF protection, missing helmet headers, insecure cookies, and GraphQL introspection in production.",
5
5
  "type": "commonjs",
6
6
  "sideEffects": false,
@@ -37,7 +37,8 @@
37
37
  "files": [
38
38
  "src/",
39
39
  "README.md",
40
- "LICENSE"
40
+ "LICENSE",
41
+ "AGENTS.md"
41
42
  ],
42
43
  "keywords": [
43
44
  "eslint",
package/src/index.js CHANGED
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");exports.rules={get"require-helmet"(){return require("./rules/require-helmet").requireHelmet},get"no-permissive-cors"(){return require("./rules/no-permissive-cors").noPermissiveCors},get"require-csrf-protection"(){return require("./rules/require-csrf-protection").requireCsrfProtection},get"no-insecure-cookie-options"(){return require("./rules/no-insecure-cookie-options").noInsecureCookieOptions},get"require-rate-limiting"(){return require("./rules/require-rate-limiting").requireRateLimiting},get"no-graphql-introspection-production"(){return require("./rules/no-graphql-introspection-production").noGraphqlIntrospectionProduction},get"no-cors-credentials-wildcard"(){return require("./rules/no-cors-credentials-wildcard").noCorsCredentialsWildcard},get"require-express-body-parser-limits"(){return require("./rules/require-express-body-parser-limits").requireExpressBodyParserLimits},get"no-express-unsafe-regex-route"(){return require("./rules/no-express-unsafe-regex-route").noExpressUnsafeRegexRoute},get"no-exposed-debug-endpoints"(){return require("./rules/no-exposed-debug-endpoints").noExposedDebugEndpoints},get"no-missing-cors-check"(){return require("./rules/no-missing-cors-check").noMissingCorsCheck},get"no-missing-csrf-protection"(){return require("./rules/no-missing-csrf-protection").noMissingCsrfProtection},get"no-missing-security-headers"(){return require("./rules/no-missing-security-headers").noMissingSecurityHeaders},get"no-user-controlled-redirect"(){return require("./rules/no-user-controlled-redirect").noUserControlledRedirect},get"no-host-header-in-links"(){return require("./rules/no-host-header-in-links").noHostHeaderInLinks},get"no-error-details-in-response"(){return require("./rules/no-error-details-in-response").noErrorDetailsInResponse},get"no-sensitive-data-in-query"(){return require("./rules/no-sensitive-data-in-query").noSensitiveDataInQuery},get"no-user-controlled-render-locals"(){return require("./rules/no-user-controlled-render-locals").noUserControlledRenderLocals},get"no-static-root-exposure"(){return require("./rules/no-static-root-exposure").noStaticRootExposure},get"require-case-insensitive-path-guard"(){return require("./rules/require-case-insensitive-path-guard").requireCaseInsensitivePathGuard},get"require-query-type-guard"(){return require("./rules/require-query-type-guard").requireQueryTypeGuard},get"no-disabled-helmet-protections"(){return require("./rules/no-disabled-helmet-protections").noDisabledHelmetProtections},get"require-strict-transport-security"(){return require("./rules/require-strict-transport-security").requireStrictTransportSecurity},get"no-unsafe-csp-directives"(){return require("./rules/no-unsafe-csp-directives").noUnsafeCspDirectives},get"no-permissive-trust-proxy"(){return require("./rules/no-permissive-trust-proxy").noPermissiveTrustProxy},get"require-route-authentication"(){return require("./rules/require-route-authentication").requireRouteAuthentication},get"no-client-controlled-authorization"(){return require("./rules/no-client-controlled-authorization").noClientControlledAuthorization},get"no-idor-resource-access"(){return require("./rules/no-idor-resource-access").noIdorResourceAccess}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-express-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-express-security",version:"4.0.2"},rules:exports.rules};const recommendedRules={"express-security/require-helmet":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"warn","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error","express-security/no-graphql-introspection-production":"warn","express-security/no-cors-credentials-wildcard":"error","express-security/require-express-body-parser-limits":"warn","express-security/no-express-unsafe-regex-route":"error","express-security/no-exposed-debug-endpoints":"error","express-security/no-user-controlled-redirect":"error","express-security/no-host-header-in-links":"error","express-security/no-error-details-in-response":"error","express-security/no-sensitive-data-in-query":"warn","express-security/no-user-controlled-render-locals":"error","express-security/no-static-root-exposure":"error","express-security/require-case-insensitive-path-guard":"warn","express-security/require-query-type-guard":"warn","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/require-route-authentication":"warn","express-security/no-client-controlled-authorization":"warn","express-security/no-idor-resource-access":"warn"};exports.configs={recommended:{plugins:{"express-security":exports.plugin},rules:recommendedRules},strict:{plugins:{"express-security":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`express-security/${ruleName}`,"error"]))},api:{plugins:{"express-security":exports.plugin},rules:{"express-security/require-helmet":"error","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"error","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error"}},graphql:{plugins:{"express-security":exports.plugin},rules:{"express-security/no-graphql-introspection-production":"error"}}};exports.default=exports.plugin;
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");exports.rules={get"require-helmet"(){return require("./rules/require-helmet").requireHelmet},get"no-permissive-cors"(){return require("./rules/no-permissive-cors").noPermissiveCors},get"require-csrf-protection"(){return require("./rules/require-csrf-protection").requireCsrfProtection},get"no-insecure-cookie-options"(){return require("./rules/no-insecure-cookie-options").noInsecureCookieOptions},get"require-rate-limiting"(){return require("./rules/require-rate-limiting").requireRateLimiting},get"no-graphql-introspection-production"(){return require("./rules/no-graphql-introspection-production").noGraphqlIntrospectionProduction},get"no-cors-credentials-wildcard"(){return require("./rules/no-cors-credentials-wildcard").noCorsCredentialsWildcard},get"require-express-body-parser-limits"(){return require("./rules/require-express-body-parser-limits").requireExpressBodyParserLimits},get"no-express-unsafe-regex-route"(){return require("./rules/no-express-unsafe-regex-route").noExpressUnsafeRegexRoute},get"no-exposed-debug-endpoints"(){return require("./rules/no-exposed-debug-endpoints").noExposedDebugEndpoints},get"no-missing-cors-check"(){return require("./rules/no-missing-cors-check").noMissingCorsCheck},get"no-missing-csrf-protection"(){return require("./rules/no-missing-csrf-protection").noMissingCsrfProtection},get"no-missing-security-headers"(){return require("./rules/no-missing-security-headers").noMissingSecurityHeaders},get"no-user-controlled-redirect"(){return require("./rules/no-user-controlled-redirect").noUserControlledRedirect},get"no-host-header-in-links"(){return require("./rules/no-host-header-in-links").noHostHeaderInLinks},get"no-error-details-in-response"(){return require("./rules/no-error-details-in-response").noErrorDetailsInResponse},get"no-sensitive-data-in-query"(){return require("./rules/no-sensitive-data-in-query").noSensitiveDataInQuery},get"no-user-controlled-render-locals"(){return require("./rules/no-user-controlled-render-locals").noUserControlledRenderLocals},get"no-static-root-exposure"(){return require("./rules/no-static-root-exposure").noStaticRootExposure},get"require-case-insensitive-path-guard"(){return require("./rules/require-case-insensitive-path-guard").requireCaseInsensitivePathGuard},get"require-query-type-guard"(){return require("./rules/require-query-type-guard").requireQueryTypeGuard},get"no-disabled-helmet-protections"(){return require("./rules/no-disabled-helmet-protections").noDisabledHelmetProtections},get"require-strict-transport-security"(){return require("./rules/require-strict-transport-security").requireStrictTransportSecurity},get"no-unsafe-csp-directives"(){return require("./rules/no-unsafe-csp-directives").noUnsafeCspDirectives},get"no-permissive-trust-proxy"(){return require("./rules/no-permissive-trust-proxy").noPermissiveTrustProxy},get"require-route-authentication"(){return require("./rules/require-route-authentication").requireRouteAuthentication},get"no-client-controlled-authorization"(){return require("./rules/no-client-controlled-authorization").noClientControlledAuthorization},get"no-idor-resource-access"(){return require("./rules/no-idor-resource-access").noIdorResourceAccess}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-express-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-express-security",version:"4.0.4"},rules:exports.rules};const recommendedRules={"express-security/require-helmet":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"warn","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error","express-security/no-graphql-introspection-production":"warn","express-security/no-cors-credentials-wildcard":"error","express-security/require-express-body-parser-limits":"warn","express-security/no-express-unsafe-regex-route":"error","express-security/no-exposed-debug-endpoints":"error","express-security/no-user-controlled-redirect":"error","express-security/no-host-header-in-links":"error","express-security/no-error-details-in-response":"error","express-security/no-sensitive-data-in-query":"warn","express-security/no-user-controlled-render-locals":"error","express-security/no-static-root-exposure":"error","express-security/require-case-insensitive-path-guard":"warn","express-security/require-query-type-guard":"warn","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/require-route-authentication":"warn","express-security/no-client-controlled-authorization":"warn","express-security/no-idor-resource-access":"warn"};exports.configs={recommended:{plugins:{"express-security":exports.plugin},rules:recommendedRules},strict:{plugins:{"express-security":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`express-security/${ruleName}`,"error"]))},api:{plugins:{"express-security":exports.plugin},rules:{"express-security/require-helmet":"error","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"error","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error"}},graphql:{plugins:{"express-security":exports.plugin},rules:{"express-security/no-graphql-introspection-production":"error"}}};exports.default=exports.plugin;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noInsecureCookieOptions=void 0;exports.checkCookieOptions=checkCookieOptions;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");function cookieOptionKey(property){if(property.type!=="Property")return void 0;if(property.key.type==="Identifier"&&!property.computed){return property.key.name.toLowerCase()}const staticText=(0,eslint_devkit_1.staticString)(property.key);if(staticText!==null){return staticText.toLowerCase()}return void 0}function flagState(node,name,hasSpread){const property=[...node.properties].reverse().find(p=>cookieOptionKey(p)===name);if(property===void 0)return hasSpread?"unknown":"absent";const value=property.value;if(value.type!=="Literal")return"unknown";return value.value===true?"on":"off"}function checkCookieOptions(node,options){const issues=[];const hasSpread=node.properties.some(p=>p.type==="SpreadElement");if(options.requireHttpOnly!==false){const state=flagState(node,"httponly",hasSpread);if(state==="absent"||state==="off"){issues.push("missing httpOnly flag (prevents XSS access to cookie)")}}if(options.requireSecure!==false){const state=flagState(node,"secure",hasSpread);if(state==="absent"||state==="off"){issues.push("missing secure flag (cookie sent over HTTPS only)")}}if(options.requireSameSite!==false){const acceptableValues=options.acceptableSameSiteValues||["strict","lax"];const property=[...node.properties].reverse().find(p=>cookieOptionKey(p)==="samesite");if(property===void 0){if(!hasSpread)issues.push("missing sameSite flag (prevents CSRF)")}else if(property.value.type==="Literal"&&typeof property.value.value==="string"){const value=property.value.value;if(!acceptableValues.includes(value.toLowerCase())){issues.push(`sameSite should be 'strict' or 'lax', not '${value}'`)}}}return{issues,hasSuggestions:issues.length>0}}exports.noInsecureCookieOptions=(0,eslint_devkit_1.createRule)({name:"no-insecure-cookie-options",meta:{interop:{runtimes:["eslint","oxlint"]},type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-insecure-cookie-options.md",description:"Require secure cookie flags (httpOnly, secure, sameSite) in Express.js",cwe:"CWE-614",cvss:5.3},hasSuggestions:true,messages:{insecureCookie:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Insecure Cookie Configuration",cwe:"CWE-614",description:"{{issues}}",severity:"HIGH",fix:'Set httpOnly: true, secure: true, sameSite: "strict"',documentationLink:"https://owasp.org/www-community/controls/SecureCookieAttribute"}),addSecureFlags:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Secure Cookie Flags",description:"Add missing security flags to cookie options",severity:"LOW",fix:'{ httpOnly: true, secure: true, sameSite: "strict" }',documentationLink:"https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#security"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false},requireHttpOnly:{type:"boolean",default:true},requireSecure:{type:"boolean",default:true},requireSameSite:{type:"boolean",default:true},acceptableSameSiteValues:{type:"array",items:{type:"string"},default:["strict","lax"]}},additionalProperties:false}]},defaultOptions:[{allowInTests:false,requireHttpOnly:true,requireSecure:true,requireSameSite:true,acceptableSameSiteValues:["strict","lax"]}],createOnce(context,currentOptions){let options;return{before(){[options]=currentOptions();if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return false;const{allowInTests=false}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return false}return true},CallExpression(node){const callee=node.callee;if(callee.type==="MemberExpression"&&(0,eslint_devkit_1.propertyName)(callee)==="cookie"){const optionsArg=node.arguments[2];if(!optionsArg){context.report({node,messageId:"insecureCookie",data:{issues:"Cookie set without options - missing httpOnly, secure, sameSite flags"},suggest:[{messageId:"addSecureFlags",fix:fixer=>{const lastArg=node.arguments[node.arguments.length-1];return fixer.insertTextAfter(lastArg,', { httpOnly: true, secure: true, sameSite: "strict" }')}}]});return}if(optionsArg.type==="ObjectExpression"){const{issues}=checkCookieOptions(optionsArg,options);if(issues.length>0){context.report({node:optionsArg,messageId:"insecureCookie",data:{issues:issues.join("; ")}})}}}}}}});
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noInsecureCookieOptions=void 0;exports.checkCookieOptions=checkCookieOptions;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");function cookieOptionKey(property){if(property.type!=="Property")return void 0;if(property.key.type==="Identifier"&&!property.computed){return property.key.name.toLowerCase()}const staticText=(0,eslint_devkit_1.staticString)(property.key);if(staticText!==null){return staticText.toLowerCase()}return void 0}function flagState(node,name,hasSpread){const property=[...node.properties].reverse().find(p=>cookieOptionKey(p)===name);if(property===void 0)return hasSpread?"unknown":"absent";const value=property.value;if(value.type!=="Literal")return"unknown";return value.value===true?"on":"off"}function checkCookieOptions(node,options){const issues=[];const hasSpread=node.properties.some(p=>p.type==="SpreadElement");if(options.requireHttpOnly!==false){const state=flagState(node,"httponly",hasSpread);if(state==="absent"||state==="off"){issues.push("missing httpOnly flag (prevents XSS access to cookie)")}}if(options.requireSecure!==false){const state=flagState(node,"secure",hasSpread);if(state==="absent"||state==="off"){issues.push("missing secure flag (cookie sent over HTTPS only)")}}if(options.requireSameSite!==false){const acceptableValues=options.acceptableSameSiteValues||["strict","lax"];const property=[...node.properties].reverse().find(p=>cookieOptionKey(p)==="samesite");if(property===void 0){if(!hasSpread)issues.push("missing sameSite flag (prevents CSRF)")}else if(property.value.type==="Literal"&&typeof property.value.value==="string"){const value=property.value.value;if(!acceptableValues.includes(value.toLowerCase())){issues.push(`sameSite should be 'strict' or 'lax', not '${value}'`)}}}return{issues,hasSuggestions:issues.length>0}}exports.noInsecureCookieOptions=(0,eslint_devkit_1.createRule)({name:"no-insecure-cookie-options",meta:{interop:{runtimes:["eslint","oxlint"]},type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-insecure-cookie-options.md",description:"Require secure cookie flags (httpOnly, secure, sameSite) in Express.js",cwe:"CWE-614",cvss:5.3},hasSuggestions:true,messages:{insecureCookie:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Insecure Cookie Configuration",cwe:"CWE-614",description:"{{issues}}",severity:"HIGH",fix:'Set httpOnly: true, secure: true, sameSite: "strict"',documentationLink:"https://owasp.org/www-community/controls/SecureCookieAttribute"}),addSecureFlags:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Secure Cookie Flags",description:"Add missing security flags to cookie options",severity:"LOW",fix:'{ httpOnly: true, secure: true, sameSite: "strict" }',documentationLink:"https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#security"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false},requireHttpOnly:{type:"boolean",default:true},requireSecure:{type:"boolean",default:true},requireSameSite:{type:"boolean",default:true},acceptableSameSiteValues:{type:"array",items:{type:"string"},default:["strict","lax"]}},additionalProperties:false}]},defaultOptions:[{allowInTests:false,requireHttpOnly:true,requireSecure:true,requireSameSite:true,acceptableSameSiteValues:["strict","lax"]}],createOnce(context,currentOptions){let options;return{before(){[options]=currentOptions();if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return false;const{allowInTests=false}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return false}return true},CallExpression(node){const callee=node.callee;if(callee.type==="MemberExpression"&&(0,eslint_devkit_1.propertyName)(callee)==="cookie"&&node.arguments.length>=2){const optionsArg=node.arguments[2];if(!optionsArg){context.report({node,messageId:"insecureCookie",data:{issues:"Cookie set without options - missing httpOnly, secure, sameSite flags"},suggest:[{messageId:"addSecureFlags",fix:fixer=>{const lastArg=node.arguments[node.arguments.length-1];return fixer.insertTextAfter(lastArg,', { httpOnly: true, secure: true, sameSite: "strict" }')}}]});return}if(optionsArg.type==="ObjectExpression"){const{issues}=checkCookieOptions(optionsArg,options);if(issues.length>0){context.report({node:optionsArg,messageId:"insecureCookie",data:{issues:issues.join("; ")}})}}}}}}});