cdk-local 0.50.0 → 0.51.0

package/README.md

@@ -72,7 +72,7 @@ Full flags, precedence, and `--from-cfn-stack` resolution: [docs/cli-reference.m
 | `cdkl start-service <Service>` | the ECS **service** | just the service's replicas (no load balancer) | workers / queue consumers / Service-Connect-only services, or to hit the containers directly |
 | `cdkl start-alb <Alb>` | the **ALB** | the ECS service(s) behind it **plus** a local **front-door** on each listener port | an `ApplicationLoadBalancedFargateService`-style service you want to reach the way external traffic does |
 
-`start-alb` discovers the ECS service(s) behind the ALB's HTTP listeners, boots their replicas, and stands up a host-side front-door on each listener port that round-robins across the replicas — one stable host endpoint, like behind a real load balancer. It honors **`path-pattern` and `host-header` listener rules**, **weighted** forwards, and **`redirect` / `fixed-response`** actions, so a listener routing `/api/*` (or `api.example.com`) to one service and everything else to another — or returning a redirect / canned response — is reproduced locally. A **`TargetType: lambda`** target group is served by invoking the backing Lambda locally (the request is translated to the ALB `requestContext.elb` event and run through the Lambda RIE), so a forward can mix ECS and Lambda targets.
+`start-alb` discovers the ECS service(s) behind the ALB's HTTP listeners, boots their replicas, and stands up a host-side front-door on each listener port that round-robins across the replicas — one stable host endpoint, like behind a real load balancer. It honors **every ALB listener-rule condition** — `path-pattern`, `host-header`, `http-header`, `http-request-method`, `query-string`, and `source-ip` — plus **weighted** forwards and **`redirect` / `fixed-response`** actions, so a listener routing `/api/*` (or `api.example.com`, or `X-Tenant: acme`, or `POST` writes, or `?version=2`, or `10.0.0.0/8`) to one service and everything else to another — or returning a redirect / canned response — is reproduced locally. A **`TargetType: lambda`** target group is served by invoking the backing Lambda locally (the request is translated to the ALB `requestContext.elb` event and run through the Lambda RIE), so a forward can mix ECS and Lambda targets.
 
 ```bash
 cdkl start-alb MyStack/WebAlb --lb-port 80=8080   # remap the privileged listener port 80 (macOS)
@@ -80,7 +80,7 @@ curl http://127.0.0.1:8080/        # default action -> the default service (roun
 curl http://127.0.0.1:8080/api/x   # path-pattern rule /api/* -> the api service
 ```
 
-Resolution model + scope (HTTP listeners, `path-pattern` + `host-header` rules, weighted forwards, `redirect` / `fixed-response`, ECS **and** Lambda targets; `http-header` / `query-string` / `source-ip` conditions deferred): [docs/cli-reference.md](docs/cli-reference.md#cdkl-start-alb-run-an-alb-fronted-service-locally).
+Resolution model + scope (HTTP listeners, all six ALB rule-condition fields, weighted forwards, `redirect` / `fixed-response`, ECS **and** Lambda targets): [docs/cli-reference.md](docs/cli-reference.md#cdkl-start-alb-run-an-alb-fronted-service-locally).
 
 ## Override env vars without a state source
 
@@ -104,7 +104,7 @@ Format + full precedence: [docs/cli-reference.md](docs/cli-reference.md).
 | `AWS::ECS::TaskDefinition` (run-task) | ✓ |
 | `AWS::ECS::Service` (start-service) | ✓ |
 | `AWS::ServiceDiscovery::*` (Cloud Map / Service Connect) | ✓ |
-| `AWS::ElasticLoadBalancingV2::*` (start-alb: ALB front-door; `path-pattern` + `host-header` rules, weighted forward, redirect / fixed-response; ECS + Lambda targets) | ✓ |
+| `AWS::ElasticLoadBalancingV2::*` (start-alb: ALB front-door; all six listener-rule condition fields, weighted forward, redirect / fixed-response; ECS + Lambda targets) | ✓ |
 | `AWS::BedrockAgentCore::Runtime` (invoke-agentcore, container + fromCodeAsset/fromS3 artifacts, HTTP + MCP) | ✓ |
 
 Lambda runs on every current AWS Lambda runtime — Node.js (18/20/22/24), Python (3.11–3.14), Ruby (3.2/3.3), Java (8.al2/11/17/21), .NET (6/8), and the OS-only `provided.al2` / `provided.al2023`. The retired `go1.x` runtime is rejected with a pointer to migrate to `provided.al2023`.

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { a as createLocalStartApiCommand } from "./cloud-map-resolver-BvhnCkSe.js";
-import { a as createLocalRunTaskCommand, i as createLocalStartServiceCommand, o as createLocalInvokeAgentCoreCommand, r as createLocalStartAlbCommand, s as createLocalInvokeCommand, t as createLocalListCommand } from "./local-list-C6xuYlRB.js";
+import { a as createLocalRunTaskCommand, i as createLocalStartServiceCommand, o as createLocalInvokeAgentCoreCommand, r as createLocalStartAlbCommand, s as createLocalInvokeCommand, t as createLocalListCommand } from "./local-list-DbBCVhla.js";
 import { Command } from "commander";
 
 //#region src/cli/index.ts
 const program = new Command();
-program.name("cdkl").description("Run AWS CDK stacks locally with Docker.").version("0.50.0");
+program.name("cdkl").description("Run AWS CDK stacks locally with Docker.").version("0.51.0");
 program.addCommand(createLocalInvokeCommand());
 program.addCommand(createLocalInvokeAgentCoreCommand());
 program.addCommand(createLocalStartApiCommand());

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cli/commands/local-invoke.ts","../src/cli/commands/local-invoke-agentcore.ts","../src/cli/commands/local-run-task.ts","../src/local/target-lister.ts","../src/cli/commands/local-start-service.ts","../src/cli/commands/local-start-alb.ts","../src/cli/commands/local-list.ts","../src/local/cfn-local-state-provider.ts"],"mappings":";;;;;UA6IiB,+BAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAi6BA,wBAAA,CAAyB,IAAA,GAAM,+BAAA,GAAuC,OAAA;;;UC95BrE,wCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBA6gCA,iCAAA,CACd,IAAA,GAAM,wCAAA,GACL,OAAA;;;UC1jCc,gCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAmhBA,yBAAA,CAA0B,IAAA,GAAM,gCAAA,GAAwC,OAAA;;;UCjnBvE,WAAA;EAEf,SAAA;EAEA,SAAA;EAKA,WAAA;EAMA,WAAA;EAOA,IAAA;AAAA;AAAA,UAOe,aAAA;EAEf,OAAA,EAAS,WAAA;EAMT,IAAA,EAAM,WAAA;EAEN,WAAA,EAAa,WAAA;EAEb,kBAAA,EAAoB,WAAA;EAEpB,iBAAA,EAAmB,WAAA;EAEnB,aAAA,EAAe,WAAA;AAAA;AAAA,iBAkID,WAAA,CAAY,MAAA,WAAiB,SAAA,KAAc,aAAA;AAAA,iBAsC3C,YAAA,CAAa,OAAA,EAAS,aAAA;;;UC3MrB,qCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAmCA,8BAAA,CACd,IAAA,GAAM,qCAAA,GACL,OAAA;;;UChCc,iCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAsQA,0BAAA,CAA2B,IAAA,GAAM,iCAAA,GAAyC,OAAA;;;UClQzE,6BAAA;EAEf,WAAA,GAAc,mBAAA;AAAA;AAAA,UAuCC,0BAAA;EAOf,IAAA;AAAA;AAAA,iBAYc,mBAAA,CACd,OAAA,EAAS,aAAA,EACT,OAAA,UACA,OAAA,GAAS,0BAAA;AAAA,iBAuEK,sBAAA,CAAuB,IAAA,GAAM,6BAAA,GAAqC,OAAA;;;UC/FjE,4BAAA;EAOf,YAAA;EAKA,MAAA;EAiBA,OAAA;AAAA;AAAA,cAGW,qBAAA,YAAiC,kBAAA;EAAA,SAG5B,KAAA;EAAA,iBACC,YAAA;EAAA,iBACA,MAAA;EAAA,QAKT,MAAA;EAAA,QAKA,YAAA;EAAA,QAKA,SAAA;EAAA,iBACS,aAAA;EAAA,QAQT,QAAA;cAEI,IAAA,EAAM,4BAAA;EAAA,QAOV,SAAA;EAAA,QAmBA,eAAA;EAAA,QAaA,YAAA;EA6BK,4BAAA,CACX,QAAA,EAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA;EAsBE,0BAAA,CACX,kBAAA,WACC,OAAA,CAAQ,MAAA;EAmCE,IAAA,CACX,UAAA,UACA,YAAA,uBACC,OAAA,CAAQ,gBAAA;EA2DE,uBAAA,CACX,eAAA,WACC,OAAA,CAAQ,kBAAA;EA8DJ,OAAA,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cli/commands/local-invoke.ts","../src/cli/commands/local-invoke-agentcore.ts","../src/cli/commands/local-run-task.ts","../src/local/target-lister.ts","../src/cli/commands/local-start-service.ts","../src/cli/commands/local-start-alb.ts","../src/cli/commands/local-list.ts","../src/local/cfn-local-state-provider.ts"],"mappings":";;;;;UA6IiB,+BAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAi6BA,wBAAA,CAAyB,IAAA,GAAM,+BAAA,GAAuC,OAAA;;;UC95BrE,wCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBA6gCA,iCAAA,CACd,IAAA,GAAM,wCAAA,GACL,OAAA;;;UC1jCc,gCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAmhBA,yBAAA,CAA0B,IAAA,GAAM,gCAAA,GAAwC,OAAA;;;UCjnBvE,WAAA;EAEf,SAAA;EAEA,SAAA;EAKA,WAAA;EAMA,WAAA;EAOA,IAAA;AAAA;AAAA,UAOe,aAAA;EAEf,OAAA,EAAS,WAAA;EAMT,IAAA,EAAM,WAAA;EAEN,WAAA,EAAa,WAAA;EAEb,kBAAA,EAAoB,WAAA;EAEpB,iBAAA,EAAmB,WAAA;EAEnB,aAAA,EAAe,WAAA;AAAA;AAAA,iBAkID,WAAA,CAAY,MAAA,WAAiB,SAAA,KAAc,aAAA;AAAA,iBAsC3C,YAAA,CAAa,OAAA,EAAS,aAAA;;;UC3MrB,qCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBAmCA,8BAAA,CACd,IAAA,GAAM,qCAAA,GACL,OAAA;;;UChCc,iCAAA;EACf,mBAAA,GAAsB,mBAAA;EAEtB,WAAA,GAAc,mBAAA;AAAA;AAAA,iBA0QA,0BAAA,CAA2B,IAAA,GAAM,iCAAA,GAAyC,OAAA;;;UCtQzE,6BAAA;EAEf,WAAA,GAAc,mBAAA;AAAA;AAAA,UAuCC,0BAAA;EAOf,IAAA;AAAA;AAAA,iBAYc,mBAAA,CACd,OAAA,EAAS,aAAA,EACT,OAAA,UACA,OAAA,GAAS,0BAAA;AAAA,iBAuEK,sBAAA,CAAuB,IAAA,GAAM,6BAAA,GAAqC,OAAA;;;UC/FjE,4BAAA;EAOf,YAAA;EAKA,MAAA;EAiBA,OAAA;AAAA;AAAA,cAGW,qBAAA,YAAiC,kBAAA;EAAA,SAG5B,KAAA;EAAA,iBACC,YAAA;EAAA,iBACA,MAAA;EAAA,QAKT,MAAA;EAAA,QAKA,YAAA;EAAA,QAKA,SAAA;EAAA,iBACS,aAAA;EAAA,QAQT,QAAA;cAEI,IAAA,EAAM,4BAAA;EAAA,QAOV,SAAA;EAAA,QAmBA,eAAA;EAAA,QAaA,YAAA;EA6BK,4BAAA,CACX,QAAA,EAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA;EAsBE,0BAAA,CACX,kBAAA,WACC,OAAA,CAAQ,MAAA;EAmCE,IAAA,CACX,UAAA,UACA,YAAA,uBACC,OAAA,CAAQ,gBAAA;EA2DE,uBAAA,CACX,eAAA,WACC,OAAA,CAAQ,kBAAA;EA8DJ,OAAA,CAAA;AAAA"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { c as getEmbedConfig, l as resetEmbedConfig, u as setEmbedConfig } from "./docker-cmd-voNPrcRh.js";
 import { $t as substituteAgainstState, a as createLocalStartApiCommand, an as LocalStateSourceError, bn as countTargets, cn as rejectExplicitCfnStackWithMultipleStacks, dn as resolveCfnStackName, en as substituteAgainstStateAsync, fn as CfnLocalStateProvider, ln as resolveCfnFallbackRegion, mn as resolveSsmParameters, nn as substituteEnvVarsFromStateAsync, on as createLocalStateProvider, pn as collectSsmParameterRefs, sn as isCfnFlagPresent, tn as substituteEnvVarsFromState, un as resolveCfnRegion, xn as listTargets } from "./cloud-map-resolver-BvhnCkSe.js";
-import { a as createLocalRunTaskCommand, i as createLocalStartServiceCommand, n as formatTargetListing, o as createLocalInvokeAgentCoreCommand, r as createLocalStartAlbCommand, s as createLocalInvokeCommand, t as createLocalListCommand } from "./local-list-C6xuYlRB.js";
+import { a as createLocalRunTaskCommand, i as createLocalStartServiceCommand, n as formatTargetListing, o as createLocalInvokeAgentCoreCommand, r as createLocalStartAlbCommand, s as createLocalInvokeCommand, t as createLocalListCommand } from "./local-list-DbBCVhla.js";
 
 export { CfnLocalStateProvider, LocalStateSourceError, collectSsmParameterRefs, countTargets, createLocalInvokeAgentCoreCommand, createLocalInvokeCommand, createLocalListCommand, createLocalRunTaskCommand, createLocalStartAlbCommand, createLocalStartApiCommand, createLocalStartServiceCommand, createLocalStateProvider, formatTargetListing, getEmbedConfig, isCfnFlagPresent, listTargets, rejectExplicitCfnStackWithMultipleStacks, resetEmbedConfig, resolveCfnFallbackRegion, resolveCfnRegion, resolveCfnStackName, resolveSsmParameters, setEmbedConfig, substituteAgainstState, substituteAgainstStateAsync, substituteEnvVarsFromState, substituteEnvVarsFromStateAsync };

package/dist/{local-list-C6xuYlRB.js → local-list-DbBCVhla.js}

@@ -3670,7 +3670,10 @@ function handleProxyRequest(req, res, opts) {
 	if (opts.route) {
 		const action = opts.route({
 			path: url,
-			...hostHeader(req)
+			...hostHeader(req),
+			headers: req.headers,
+			...req.method !== void 0 && { method: req.method },
+			...req.socket.remoteAddress !== void 0 && { sourceIp: req.socket.remoteAddress }
 		});
 		if (!action) return reply404(req, res, opts);
 		if (action.kind === "redirect" || action.kind === "fixed-response") {
@@ -3949,25 +3952,24 @@ function writeError(res, statusCode, message) {
 * evaluated in ascending priority; the input order is irrelevant.
 *
 * Accepts either a request facts object or a bare path string (the path-only
-* form keeps the original signature working for callers that have no Host).
+* form keeps the original signature working for callers that have no Host /
+* headers / method / source IP).
 */
 function matchAlbPathRule(req, rules) {
-	const { path, host } = typeof req === "string" ? {
-		path: req,
-		host: void 0
-	} : req;
-	const requestPath = pathOf(path);
-	const requestHost = host !== void 0 ? hostOf(host) : void 0;
+	const facts = typeof req === "string" ? { path: req } : req;
+	const requestPath = pathOf(facts.path);
+	const requestQuery = queryOf(facts.path);
+	const requestHost = facts.host !== void 0 ? hostOf(facts.host) : void 0;
 	const ordered = [...rules].sort((a, b) => a.priority - b.priority);
-	for (const rule of ordered) if (ruleMatches(rule, requestPath, requestHost)) return rule.target;
+	for (const rule of ordered) if (ruleMatches(rule, requestPath, requestQuery, requestHost, facts)) return rule.target;
 }
 /**
-* Whether a single rule's conditions all match. A `path-pattern` /
-* `host-header` condition is satisfied when ANY of its values match (OR); a
-* rule with both fields requires both to match (AND). An empty pattern list
-* for a field means "no constraint on that field" (the condition was absent).
+* Whether a single rule's conditions all match. Each present condition field
+* is OR-matched within (multiple values) and AND'd across fields. An empty /
+* absent condition list means "no constraint on that field" (the condition was
+* absent on the rule).
 */
-function ruleMatches(rule, requestPath, requestHost) {
+function ruleMatches(rule, requestPath, requestQuery, requestHost, facts) {
 	if (rule.pathPatterns.length > 0) {
 		if (!rule.pathPatterns.some((pattern) => globToRegExp(pattern, false).test(requestPath))) return false;
 	}
@@ -3976,8 +3978,71 @@ function ruleMatches(rule, requestPath, requestHost) {
 		if (requestHost === void 0) return false;
 		if (!hostPatterns.some((pattern) => globToRegExp(pattern, true).test(requestHost))) return false;
 	}
+	const headerConditions = rule.httpHeaderConditions ?? [];
+	if (headerConditions.length > 0) {
+		if (!headerConditions.every((cond) => httpHeaderConditionMatches(cond, facts.headers))) return false;
+	}
+	const methods = rule.httpRequestMethods ?? [];
+	if (methods.length > 0) {
+		if (facts.method === void 0) return false;
+		if (!methods.includes(facts.method)) return false;
+	}
+	const queryConditions = rule.queryStringConditions ?? [];
+	if (queryConditions.length > 0) {
+		const params = parseQueryParams(requestQuery);
+		if (!queryConditions.some((cond) => queryStringConditionMatches(cond, params))) return false;
+	}
+	const cidrs = rule.sourceIpCidrs ?? [];
+	if (cidrs.length > 0) {
+		if (facts.sourceIp === void 0) return false;
+		const ip = unmapV4MappedV6(facts.sourceIp);
+		if (!cidrs.some((cidr) => albCidrMatches(cidr, ip))) return false;
+	}
 	return true;
 }
+/**
+* Whether an `http-header` condition matches the request's headers. The
+* header name is looked up case-insensitively; each listed value glob is
+* matched case-insensitively against every value of that header (multi-valued
+* headers count each value separately).
+*/
+function httpHeaderConditionMatches(cond, headers) {
+	if (!headers) return false;
+	const rawValue = headerLookup(headers, cond.name.toLowerCase());
+	if (rawValue === void 0) return false;
+	const headerValues = Array.isArray(rawValue) ? rawValue : [rawValue];
+	return cond.values.some((glob) => {
+		const re = globToRegExp(glob, true);
+		return headerValues.some((v) => re.test(v.toLowerCase()));
+	});
+}
+/**
+* Whether a single `query-string` condition `{ Key?, Value }` matches the
+* request's parsed query parameters. Both Key and Value are case-insensitive
+* `*` / `?` globs; when `Key` is absent, ANY parameter whose value matches the
+* Value glob satisfies the condition.
+*/
+function queryStringConditionMatches(cond, params) {
+	const valueRe = globToRegExp(cond.value, true);
+	const keyRe = cond.key !== void 0 ? globToRegExp(cond.key, true) : void 0;
+	return params.some((p) => {
+		if (keyRe !== void 0 && !keyRe.test(p.key.toLowerCase())) return false;
+		return valueRe.test(p.value.toLowerCase());
+	});
+}
+/**
+* Whether an IPv4 or IPv6 address falls inside an IPv4 or IPv6 CIDR. Returns
+* `false` for mismatched families (an IPv4 address tested against an IPv6
+* CIDR, or vice versa) and for unparseable input.
+*/
+function albCidrMatches(cidr, ip) {
+	const parsed = parseCidr(cidr);
+	if (!parsed) return false;
+	const addr = parseIpAddress(ip);
+	if (!addr) return false;
+	if (parsed.family !== addr.family) return false;
+	return matchBitPrefix(parsed.bytes, addr.bytes, parsed.prefixLength);
+}
 /** Strip the query string / fragment so only the URL path is matched. */
 function pathOf(url) {
 	let end = url.length;
@@ -3988,6 +4053,45 @@ function pathOf(url) {
 	return url.slice(0, end);
 }
 /**
+* Pull the raw query string (`a=1&b=2`) out of a URL. Returns the empty string
+* when the URL has no `?`. The fragment is dropped.
+*/
+function queryOf(url) {
+	const q = url.indexOf("?");
+	if (q === -1) return "";
+	const rest = url.slice(q + 1);
+	const h = rest.indexOf("#");
+	return h === -1 ? rest : rest.slice(0, h);
+}
+/**
+* Decode a raw query string into a flat list of `{ key, value }` entries
+* (preserving repeats), URI-decoding both sides and treating `+` as a space
+* (the `application/x-www-form-urlencoded` convention browsers use). Pairs
+* with no `=` are treated as `{ key, value: '' }`.
+*/
+function parseQueryParams(query) {
+	if (!query) return [];
+	const out = [];
+	for (const pair of query.split("&")) {
+		if (!pair) continue;
+		const eq = pair.indexOf("=");
+		const rawKey = eq === -1 ? pair : pair.slice(0, eq);
+		const rawValue = eq === -1 ? "" : pair.slice(eq + 1);
+		out.push({
+			key: decodeQueryPart(rawKey),
+			value: decodeQueryPart(rawValue)
+		});
+	}
+	return out;
+}
+function decodeQueryPart(s) {
+	try {
+		return decodeURIComponent(s.replace(/\+/g, " "));
+	} catch {
+		return s;
+	}
+}
+/**
 * Normalize a `Host` header for matching: drop any `:port` suffix and lower-case
 * it (DNS hostnames are case-insensitive). IPv6 literals (`[::1]:8080`) keep the
 * bracketed address and only the trailing port is removed.
@@ -4002,13 +4106,18 @@ function hostOf(host) {
 	const colon = trimmed.indexOf(":");
 	return (colon === -1 ? trimmed : trimmed.slice(0, colon)).toLowerCase();
 }
+/** Case-insensitive header lookup against a Node-style headers dict. */
+function headerLookup(headers, lowerCaseName) {
+	const direct = headers[lowerCaseName];
+	if (direct !== void 0) return direct;
+	for (const key of Object.keys(headers)) if (key.toLowerCase() === lowerCaseName) return headers[key];
+}
 const REGEXP_META = /[.+^${}()|[\]\\]/;
 /**
 * Translate an ALB `*` / `?` glob into an anchored RegExp: `*` -> `.*`,
-* `?` -> `.`, every other character is escaped and matched literally. Host
-* patterns match case-insensitively (the `i` flag) and the pattern is
-* lower-cased to pair with the lower-cased host; path patterns are
-* case-sensitive.
+* `?` -> `.`, every other character is escaped and matched literally. The
+* `caseInsensitive` form lower-cases the pattern (callers pair it with a
+* lower-cased input); path patterns are case-sensitive.
 */
 function globToRegExp(pattern, caseInsensitive) {
 	const source = caseInsensitive ? pattern.toLowerCase() : pattern;
@@ -4019,6 +4128,131 @@ function globToRegExp(pattern, caseInsensitive) {
 	else body += ch;
 	return new RegExp(`^${body}$`);
 }
+/** Parse a CIDR (`ip/prefix`) into its address bytes + prefix length. */
+function parseCidr(cidr) {
+	const slash = cidr.indexOf("/");
+	if (slash === -1) return void 0;
+	const addrPart = cidr.slice(0, slash);
+	const prefixPart = cidr.slice(slash + 1);
+	if (!/^\d+$/.test(prefixPart)) return void 0;
+	const prefixLength = parseInt(prefixPart, 10);
+	const addr = parseIpAddress(addrPart);
+	if (!addr) return void 0;
+	const maxPrefix = addr.family === "v4" ? 32 : 128;
+	if (prefixLength < 0 || prefixLength > maxPrefix) return void 0;
+	return {
+		family: addr.family,
+		bytes: addr.bytes,
+		prefixLength
+	};
+}
+/** Parse an IPv4 (`1.2.3.4`) or IPv6 address into its byte representation. */
+function parseIpAddress(ip) {
+	if (ip.includes(".") && !ip.includes(":")) return parseIpv4(ip);
+	if (ip.includes(":")) return parseIpv6(ip);
+}
+function parseIpv4(ip) {
+	const parts = ip.split(".");
+	if (parts.length !== 4) return void 0;
+	const bytes = new Uint8Array(4);
+	for (let i = 0; i < 4; i++) {
+		const part = parts[i];
+		if (!/^\d+$/.test(part)) return void 0;
+		const n = parseInt(part, 10);
+		if (n < 0 || n > 255) return void 0;
+		bytes[i] = n;
+	}
+	return {
+		family: "v4",
+		bytes
+	};
+}
+/**
+* Parse a textual IPv6 address (incl. `::` shorthand and IPv4-suffix form like
+* `::ffff:1.2.3.4`) into its 16-byte representation.
+*/
+function parseIpv6(ip) {
+	let s = ip;
+	if (s.startsWith("[") && s.endsWith("]")) s = s.slice(1, -1);
+	let v4Suffix;
+	const lastColon = s.lastIndexOf(":");
+	if (lastColon !== -1 && s.slice(lastColon + 1).includes(".")) {
+		const parsed = parseIpv4(s.slice(lastColon + 1));
+		if (!parsed) return void 0;
+		v4Suffix = parsed.bytes;
+		s = s.slice(0, lastColon) + ":0:0";
+	}
+	const doubleColon = s.indexOf("::");
+	let head;
+	let tail;
+	if (doubleColon === -1) {
+		head = s.split(":");
+		tail = [];
+	} else {
+		head = s.slice(0, doubleColon) === "" ? [] : s.slice(0, doubleColon).split(":");
+		tail = s.slice(doubleColon + 2) === "" ? [] : s.slice(doubleColon + 2).split(":");
+	}
+	if (head.length + tail.length > 8) return void 0;
+	if (doubleColon === -1 && head.length !== 8) return void 0;
+	const groups = new Array(8).fill(0);
+	for (let i = 0; i < head.length; i++) {
+		const g = parseHexGroup(head[i]);
+		if (g === void 0) return void 0;
+		groups[i] = g;
+	}
+	for (let i = 0; i < tail.length; i++) {
+		const g = parseHexGroup(tail[tail.length - 1 - i]);
+		if (g === void 0) return void 0;
+		groups[7 - i] = g;
+	}
+	const bytes = new Uint8Array(16);
+	for (let i = 0; i < 8; i++) {
+		bytes[i * 2] = groups[i] >> 8 & 255;
+		bytes[i * 2 + 1] = groups[i] & 255;
+	}
+	if (v4Suffix) {
+		bytes[12] = v4Suffix[0];
+		bytes[13] = v4Suffix[1];
+		bytes[14] = v4Suffix[2];
+		bytes[15] = v4Suffix[3];
+	}
+	return {
+		family: "v6",
+		bytes
+	};
+}
+function parseHexGroup(g) {
+	if (g.length === 0 || g.length > 4) return void 0;
+	if (!/^[0-9a-fA-F]+$/.test(g)) return void 0;
+	return parseInt(g, 16);
+}
+/**
+* Unmap an IPv4-mapped IPv6 source IP (`::ffff:a.b.c.d` or `::ffff:NNNN:NNNN`)
+* to its bare IPv4 form. Node reports `::ffff:127.0.0.1` for an IPv4 client on
+* a dual-stack listener; rules that name a v4 CIDR should still match.
+*/
+function unmapV4MappedV6(ip) {
+	const m = /^::ffff:(.+)$/i.exec(ip);
+	if (!m) return ip;
+	const suffix = m[1];
+	if (suffix.includes(".")) return suffix;
+	const parts = suffix.split(":");
+	if (parts.length !== 2) return ip;
+	const high = parseInt(parts[0], 16);
+	const low = parseInt(parts[1], 16);
+	if (!Number.isFinite(high) || !Number.isFinite(low)) return ip;
+	return `${high >> 8 & 255}.${high & 255}.${low >> 8 & 255}.${low & 255}`;
+}
+/** Whether the first `prefixLength` bits of `a` equal those of `b`. */
+function matchBitPrefix(a, b, prefixLength) {
+	if (a.length !== b.length) return false;
+	const fullBytes = Math.floor(prefixLength / 8);
+	for (let i = 0; i < fullBytes; i++) if (a[i] !== b[i]) return false;
+	const remainingBits = prefixLength % 8;
+	if (remainingBits === 0) return true;
+	const mask = 255 << 8 - remainingBits;
+	return (a[fullBytes] & mask) === (b[fullBytes] & mask);
+}
 
 //#endregion
 //#region src/local/front-door-lambda-runner.ts
@@ -4511,6 +4745,10 @@ async function buildFrontDoor(plan, options, logger) {
 				priority: r.priority,
 				pathPatterns: r.pathPatterns,
 				hostPatterns: r.hostPatterns,
+				httpHeaderConditions: r.httpHeaderConditions,
+				httpRequestMethods: r.httpRequestMethods,
+				queryStringConditions: r.queryStringConditions,
+				sourceIpCidrs: r.sourceIpCidrs,
 				target: toRouteAction(r.action)
 			}));
 			const route = (req) => matchAlbPathRule(req, ruleRoutes) ?? defaultRoute;
@@ -4552,13 +4790,20 @@ async function buildFrontDoor(plan, options, logger) {
 		lambdaRunners: [...lambdaRegistry.values()]
 	};
 }
-/** Human-readable summary of a planned rule's path / host conditions (for the boot banner). */
+/** Human-readable summary of a planned rule's six ALB condition fields (for the boot banner). */
 function describeConditions(rule) {
 	const parts = [];
 	if (rule.pathPatterns.length > 0) parts.push(`path ${rule.pathPatterns.join(", ")}`);
 	if (rule.hostPatterns.length > 0) parts.push(`host ${rule.hostPatterns.join(", ")}`);
+	for (const h of rule.httpHeaderConditions) parts.push(`header ${h.name}: ${h.values.join(", ")}`);
+	if (rule.httpRequestMethods.length > 0) parts.push(`method ${rule.httpRequestMethods.join(", ")}`);
+	if (rule.queryStringConditions.length > 0) parts.push(`query ${rule.queryStringConditions.map(describeQueryStringCondition).join(", ")}`);
+	if (rule.sourceIpCidrs.length > 0) parts.push(`source-ip ${rule.sourceIpCidrs.join(", ")}`);
 	return parts.join(" AND ") || "(no condition)";
 }
+function describeQueryStringCondition(c) {
+	return c.key !== void 0 ? `${c.key}=${c.value}` : c.value;
+}
 /** Human-readable summary of a planned action (for the boot banner). */
 function describeAction(action) {
 	if (action.kind === "redirect") return `redirect ${action.statusCode}`;
@@ -4787,7 +5032,11 @@ function createLocalStartServiceCommand(opts = {}) {
 *     DefaultActions:[ <action> ] }
 * ElasticLoadBalancingV2::ListenerRule  : { ListenerArn:{Ref:<Listener>}, Priority,
 *     Conditions:[{ Field:"path-pattern", PathPatternConfig:{ Values:["/api/*"] } },
-*                 { Field:"host-header",  HostHeaderConfig:{ Values:["api.example.com"] } }],
+*                 { Field:"host-header",  HostHeaderConfig:{ Values:["api.example.com"] } },
+*                 { Field:"http-header",  HttpHeaderConfig:{ HttpHeaderName:"X-API", Values:["*"] } },
+*                 { Field:"http-request-method", HttpRequestMethodConfig:{ Values:["POST"] } },
+*                 { Field:"query-string", QueryStringConfig:{ Values:[{ Key:"v", Value:"1" }] } },
+*                 { Field:"source-ip",    SourceIpConfig:{ Values:["10.0.0.0/8"] } }],
 *     Actions:[ <action> ] }
 * ElasticLoadBalancingV2::TargetGroup   : { Port, Protocol, TargetType:"ip" }
 * ECS::Service.LoadBalancers[]          -> { ContainerName, ContainerPort, TargetGroupArn:{Ref:<TG>} }
@@ -4805,16 +5054,16 @@ function createLocalStartServiceCommand(opts = {}) {
 * `LoadBalancers[]` references each target group (a reverse scan; there is no
 * direct TG -> service pointer). Output is a per-listener routing table: a
 * default action plus the ordered rules, each carrying its resolved action and
-* its path / host conditions.
+* its full set of routing conditions.
 *
-* Scope: HTTP listeners; `path-pattern` + `host-header` conditions; `forward`
-* (single or weighted) to ECS services AND/OR Lambda functions
-* (`TargetType:"lambda"` target groups — #123: the TG -> backing
+* Scope: HTTP listeners; all six ALB rule-condition fields (`path-pattern`,
+* `host-header`, `http-header`, `http-request-method`, `query-string`,
+* `source-ip`); `forward` (single or weighted) to ECS services AND/OR Lambda
+* functions (`TargetType:"lambda"` target groups — #123: the TG -> backing
 * `AWS::Lambda::Function` is resolved and the front-door invokes it locally per
 * request); `redirect` / `fixed-response` actions. A single weighted forward may
-* mix ECS and Lambda targets. Skipped with a warning: HTTPS/TLS listeners, the
-* other condition fields (http-header / http-request-method / query-string /
-* source-ip), and `authenticate-cognito` / `authenticate-oidc` actions.
+* mix ECS and Lambda targets. Skipped with a warning: HTTPS/TLS listeners and
+* `authenticate-cognito` / `authenticate-oidc` actions.
 */
 const ALB_TYPE = "AWS::ElasticLoadBalancingV2::LoadBalancer";
 const LISTENER_TYPE = "AWS::ElasticLoadBalancingV2::Listener";
@@ -4850,18 +5099,20 @@ function resolveAlbFrontDoor(stack, albLogicalId) {
 		for (const { ruleLogicalId, ruleProps } of rulesByListener.get(listenerLogicalId) ?? []) {
 			const priority = parsePriority(ruleProps["Priority"]);
 			const ruleLabel = `Listener rule '${ruleLogicalId}' (priority ${priority})`;
-			const { pathPatterns, hostPatterns, unsupported } = parseRuleConditions(ruleProps["Conditions"]);
-			if (unsupported.length > 0) {
-				warnings.push(`${ruleLabel} uses unsupported condition(s): ${unsupported.join(", ")}. The local ALB front-door supports path-pattern and host-header conditions only (http-header / query-string / http-request-method / source-ip deferred). Skipping it.`);
-				continue;
-			}
-			if (pathPatterns.length === 0 && hostPatterns.length === 0) continue;
+			const parsed = parseRuleConditions(ruleProps["Conditions"], ruleLabel, warnings);
+			if (!parsed) continue;
+			const { pathPatterns, hostPatterns, httpHeaderConditions, httpRequestMethods, queryStringConditions, sourceIpCidrs } = parsed;
+			if (!(pathPatterns.length > 0 || hostPatterns.length > 0 || httpHeaderConditions.length > 0 || httpRequestMethods.length > 0 || queryStringConditions.length > 0 || sourceIpCidrs.length > 0)) continue;
 			const action = resolveAction(ruleProps["Actions"], resources, tgToService, stackName, `${ruleLabel} action`, warnings);
 			if (!action) continue;
 			rules.push({
 				priority,
 				pathPatterns,
 				hostPatterns,
+				httpHeaderConditions,
+				httpRequestMethods,
+				queryStringConditions,
+				sourceIpCidrs,
 				action
 			});
 		}
@@ -5094,36 +5345,135 @@ function indexRulesByListener(resources) {
 	return index;
 }
 /**
-* Parse a ListenerRule's `Conditions` into its supported `path-pattern` and
-* `host-header` values plus the field names of any unsupported conditions
-* (which make the rule unsupported). ALB ANDs conditions of different fields,
-* so a rule with an unsupported field cannot be honored locally. Multiple
-* conditions of the same field merge their values (each field OR-matches).
+* Parse a ListenerRule's `Conditions` into the six supported fields. Returns
+* `undefined` when an unknown field is encountered or a known field is
+* malformed enough that honoring the rule would silently drop a constraint
+* — both surface a warning and skip the whole rule (ALB ANDs conditions of
+* different fields, so dropping any condition would route requests it should
+* not).
+*
+* Multiple `http-header` conditions on different names are kept (they AND).
+* Multiple `path-pattern` / `host-header` / `http-request-method` /
+* `query-string` / `source-ip` conditions on the same field merge their
+* values (each field OR-matches). A `source-ip` value that does not parse as
+* a CIDR makes the whole rule unsupported (the rule's authoring intent was
+* specific; dropping the invalid range would silently widen the allow list).
 */
-function parseRuleConditions(conditions) {
-	const pathPatterns = [];
-	const hostPatterns = [];
-	const unsupported = [];
-	if (!Array.isArray(conditions)) return {
-		pathPatterns,
-		hostPatterns,
-		unsupported
+function parseRuleConditions(conditions, ruleLabel, warnings) {
+	const out = {
+		pathPatterns: [],
+		hostPatterns: [],
+		httpHeaderConditions: [],
+		httpRequestMethods: [],
+		queryStringConditions: [],
+		sourceIpCidrs: []
 	};
+	if (!Array.isArray(conditions)) return out;
 	for (const cond of conditions) {
 		if (!cond || typeof cond !== "object") continue;
 		const c = cond;
 		const field = typeof c["Field"] === "string" ? c["Field"] : "(unknown)";
-		if (field === "path-pattern") pathPatterns.push(...conditionValues(c, "PathPatternConfig"));
-		else if (field === "host-header") hostPatterns.push(...conditionValues(c, "HostHeaderConfig"));
-		else unsupported.push(field);
+		if (field === "path-pattern") out.pathPatterns.push(...conditionValues(c, "PathPatternConfig"));
+		else if (field === "host-header") out.hostPatterns.push(...conditionValues(c, "HostHeaderConfig"));
+		else if (field === "http-header") {
+			const parsed = parseHttpHeaderCondition(c);
+			if (!parsed) {
+				warnings.push(`${ruleLabel} has an http-header condition with no HttpHeaderName / Values; skipping the rule.`);
+				return;
+			}
+			out.httpHeaderConditions.push(parsed);
+		} else if (field === "http-request-method") out.httpRequestMethods.push(...conditionValues(c, "HttpRequestMethodConfig"));
+		else if (field === "query-string") {
+			const { parsed, hadEntries } = parseQueryStringConditionValues(c);
+			if (hadEntries && parsed.length === 0) {
+				warnings.push(`${ruleLabel} query-string condition has no parseable { Key?, Value } entries; skipping the rule.`);
+				return;
+			}
+			out.queryStringConditions.push(...parsed);
+		} else if (field === "source-ip") {
+			const values = conditionValues(c, "SourceIpConfig");
+			const invalid = values.filter((v) => !isValidCidr(v));
+			if (invalid.length > 0) {
+				warnings.push(`${ruleLabel} source-ip condition has unparseable CIDR(s): ${invalid.join(", ")}. The local ALB front-door requires valid IPv4 / IPv6 CIDRs; skipping the rule.`);
+				return;
+			}
+			out.sourceIpCidrs.push(...values);
+		} else {
+			warnings.push(`${ruleLabel} uses unsupported condition field '${field}'. Skipping the rule.`);
+			return;
+		}
 	}
+	return out;
+}
+/**
+* Parse an `http-header` condition into its `{ name, values }` form. Returns
+* `undefined` when `HttpHeaderName` is missing / non-string or `Values` is
+* empty (either makes the rule's authoring intent unrecoverable).
+*/
+function parseHttpHeaderCondition(cond) {
+	const cfg = cond["HttpHeaderConfig"];
+	if (!cfg || typeof cfg !== "object") return void 0;
+	const c = cfg;
+	const name = c["HttpHeaderName"];
+	if (typeof name !== "string" || name.length === 0) return void 0;
+	const values = (Array.isArray(c["Values"]) ? c["Values"] : []).filter((v) => typeof v === "string");
+	if (values.length === 0) return void 0;
 	return {
-		pathPatterns,
-		hostPatterns,
-		unsupported
+		name,
+		values
 	};
 }
 /**
+* Parse a `query-string` condition's `Values` into `{ key?, value }` pairs.
+* ALB accepts either object entries (`{ Key?, Value }`) or bare strings
+* (legacy v1 shape: a string is treated as `{ value }`). Non-string `Key` /
+* `Value` fields are dropped; an entry with no `Value` is dropped. Returns
+* `hadEntries` so the caller can distinguish an absent / empty `Values` array
+* (drop the field silently) from one whose entries were all unparseable
+* (warn + skip the whole rule — silently dropping would widen routing).
+*/
+function parseQueryStringConditionValues(cond) {
+	const cfg = cond["QueryStringConfig"];
+	const rawValues = cfg && typeof cfg === "object" && Array.isArray(cfg["Values"]) ? cfg["Values"] : Array.isArray(cond["Values"]) ? cond["Values"] : [];
+	const parsed = [];
+	for (const v of rawValues) if (typeof v === "string") parsed.push({ value: v });
+	else if (v && typeof v === "object") {
+		const e = v;
+		const value = e["Value"];
+		if (typeof value !== "string") continue;
+		const key = e["Key"];
+		parsed.push(typeof key === "string" ? {
+			key,
+			value
+		} : { value });
+	}
+	return {
+		parsed,
+		hadEntries: rawValues.length > 0
+	};
+}
+/**
+* Cheap CIDR validity check used at parse time. Mirrors the more permissive
+* matcher (`albCidrMatches`) but only confirms shape; we do not need to
+* remember the parsed bytes here.
+*/
+function isValidCidr(value) {
+	const slash = value.indexOf("/");
+	if (slash === -1) return false;
+	const addr = value.slice(0, slash);
+	const prefix = value.slice(slash + 1);
+	if (!/^\d+$/.test(prefix)) return false;
+	const prefixLen = parseInt(prefix, 10);
+	if (addr.includes(".") && !addr.includes(":")) {
+		const parts = addr.split(".");
+		if (parts.length !== 4) return false;
+		if (!parts.every((p) => /^\d+$/.test(p) && parseInt(p, 10) <= 255)) return false;
+		return prefixLen >= 0 && prefixLen <= 32;
+	}
+	if (addr.includes(":")) return prefixLen >= 0 && prefixLen <= 128;
+	return false;
+}
+/**
 * Extract a condition's string values from either the typed `<Field>Config`
 * sub-object's `Values` or the legacy top-level `Values` array.
 */
@@ -5364,6 +5714,10 @@ function albStrategy(options) {
 							priority: r.priority,
 							pathPatterns: r.pathPatterns,
 							hostPatterns: r.hostPatterns,
+							httpHeaderConditions: r.httpHeaderConditions,
+							httpRequestMethods: r.httpRequestMethods,
+							queryStringConditions: r.queryStringConditions,
+							sourceIpCidrs: r.sourceIpCidrs,
 							action: qualify(r.action)
 						}))
 					});
@@ -5470,4 +5824,4 @@ function createLocalListCommand(opts = {}) {
 
 //#endregion
 export { createLocalRunTaskCommand as a, createLocalStartServiceCommand as i, formatTargetListing as n, createLocalInvokeAgentCoreCommand as o, createLocalStartAlbCommand as r, createLocalInvokeCommand as s, createLocalListCommand as t };
-//# sourceMappingURL=local-list-C6xuYlRB.js.map
+//# sourceMappingURL=local-list-DbBCVhla.js.map