@viaalink/caddy-api-client 0.10.1 → 0.10.2

package/dist/generated/extension-assets.js

@@ -1,4 +1,4 @@
-var a="0.5.2",o="2026-04-01T16:38:14.519Z",t={buildLocalIdentityStore:{name:"buildLocalIdentityStore",description:`Build a local identity store configuration
+var s="0.10.1",a="2026-10-31T23:06:36.575Z",r={buildLocalIdentityStore:{name:"buildLocalIdentityStore",description:`Build a local identity store configuration
 
 Creates a local JSON file-based identity store for user credentials.
 Uses the authcrunch wrapper structure: name, kind, params`,params:[{name:"name",type:"string",required:false,description:"Name of the identity store (used to reference it in portals)",default:"local"},{name:"path",type:"string",required:true,description:"Path to the JSON file containing user credentials"},{name:"realm",type:"string",required:false,description:"Realm name for this identity store",default:"local"}],returnType:"LocalIdentityStore",example:`import { buildLocalIdentityStore } from "@.../caddy-api-client/plugins/caddy-security";
@@ -7,7 +7,7 @@ const store = buildLocalIdentityStore({
   name: "localdb",
   path: "/etc/caddy/users.json",
   realm: "local",
-});`,snippet:{prefix:"caddy-local-identity-store",body:["buildLocalIdentityStore({","  // name: ${1:local},","  path: ${2:/etc/caddy/config.json},","  // realm: ${3:local}","})"],description:"Build Local Identity Store"}},buildLdapIdentityStore:{name:"buildLdapIdentityStore",description:`Build an LDAP identity store configuration
+});`,snippet:{prefix:"caddy-local-identity-store",body:["buildLocalIdentityStore({",'  path: "${1:/etc/caddy/users.json}",',"  // optional: name, realm","})$0"],description:"Build Local Identity Store"}},buildLdapIdentityStore:{name:"buildLdapIdentityStore",description:`Build an LDAP identity store configuration
 
 Creates an LDAP-based identity store for user authentication.
 Uses the authcrunch wrapper structure: name, kind, params`,params:[{name:"name",type:"string",required:false,description:"Name of the identity store (used to reference it in portals)",default:"ldapdb"},{name:"realm",type:"string",required:false,description:"Realm name for this identity store",default:"ldap"},{name:"servers",type:"LdapServerConfig[]",required:true,description:"LDAP server(s) to connect to"},{name:"bindUsername",type:"string",required:true,description:"Bind username for LDAP queries (full DN)",example:"cn=admin,dc=example,dc=com"},{name:"bindPassword",type:"string",required:true,description:"Bind password for LDAP authentication"},{name:"searchBaseDn",type:"string",required:true,description:"Base DN for user searches",example:"ou=users,dc=example,dc=com"},{name:"searchUserFilter",type:"string",required:false,description:"LDAP search filter template for users",default:"(uid={username})"},{name:"groups",type:"LdapGroupConfig[]",required:false,description:"Group to role mappings",default:"[]"}],returnType:"LdapIdentityStore",example:`import { buildLdapIdentityStore } from "@.../caddy-api-client/plugins/caddy-security";
@@ -19,7 +19,7 @@ const store = buildLdapIdentityStore({
   bindPassword: "secret",
   searchBaseDn: "ou=users,dc=example,dc=com",
   searchUserFilter: "(uid={username})",
-});`,snippet:{prefix:"caddy-ldap-identity-store",body:["buildLdapIdentityStore({","  // name: ${1:ldapdb},","  // realm: ${2:ldap},",'  servers: ${3:""},',"  bindUsername: ${4:my-name},",'  bindPassword: ${5:""},','  searchBaseDn: ${6:""},',"  // searchUserFilter: ${7:(uid={username})},","  // groups: ${8:[]}","})"],description:"Build LDAP Identity Store"}},buildOAuth2Provider:{name:"buildOAuth2Provider",description:`Build an OAuth2 identity provider configuration
+});`,snippet:{prefix:"caddy-ldap-identity-store",body:["buildLdapIdentityStore({",'  servers: [{ address: "${1:ldap.example.com}" }],','  bindUsername: "${2:cn=admin,dc=example,dc=com}",','  bindPassword: "${3:change-me}",','  searchBaseDn: "${4:ou=users,dc=example,dc=com}",',"  // optional: name, realm, searchUserFilter, groups","})$0"],description:"Build LDAP Identity Store"}},buildOAuth2Provider:{name:"buildOAuth2Provider",description:`Build an OAuth2 identity provider configuration
 
 Uses the authcrunch wrapper structure: name, kind, params`,params:[{name:"name",type:"string",required:false,description:"Name of the identity provider (used to reference it in portals)"},{name:"realm",type:"string",required:false,description:"Realm name for this provider"},{name:"provider",type:"string",required:true,description:"Provider name/driver (github, google, facebook, etc.)"},{name:"clientId",type:"string",required:true,description:"OAuth client ID"},{name:"clientSecret",type:"string",required:true,description:"OAuth client secret"},{name:"scopes",type:"string[]",required:false,description:"OAuth scopes to request",default:'["openid", "email", "profile"]'},{name:"authorizationUrl",type:"string",required:false,description:"Authorization URL (for non-standard providers)"},{name:"tokenUrl",type:"string",required:false,description:"Token URL (for non-standard providers)"}],returnType:"OAuth2IdentityProvider",example:`import { buildOAuth2Provider } from "@.../caddy-api-client/plugins/caddy-security";
 
@@ -29,7 +29,7 @@ const provider = buildOAuth2Provider({
   clientId: "your-client-id",
   clientSecret: "your-client-secret",
   scopes: ["user:email", "read:user"],
-});`,snippet:{prefix:"caddy-oauth2-provider",body:["buildOAuth2Provider({",'  provider: ${1:""},',"  clientId: ${2:your-client-id},","  clientSecret: ${3:your-client-secret},",'  // scopes: ${4:["openid", "email", "profile"]},',"})"],description:"Build OAuth2 Provider"}},buildOidcProvider:{name:"buildOidcProvider",description:`Build an OIDC identity provider configuration
+});`,snippet:{prefix:"caddy-oauth2-provider",body:["buildOAuth2Provider({",'  provider: "${1:github}",','  clientId: "${2:your-client-id}",','  clientSecret: "${3:your-client-secret}",',"  // optional: name, realm, scopes, authorizationUrl, tokenUrl","})$0"],description:"Build OAuth2 Provider"}},buildOidcProvider:{name:"buildOidcProvider",description:`Build an OIDC identity provider configuration
 
 Uses the authcrunch wrapper structure: name, kind, params`,params:[{name:"name",type:"string",required:false,description:"Name of the identity provider (used to reference it in portals)"},{name:"realm",type:"string",required:false,description:"Realm name for this provider"},{name:"provider",type:"string",required:true,description:"OIDC provider name (keycloak, okta, auth0, etc.)"},{name:"clientId",type:"string",required:true,description:"Client ID"},{name:"clientSecret",type:"string",required:true,description:"Client secret"},{name:"metadataUrl",type:"string",required:true,description:"OIDC metadata/discovery URL (.well-known/openid-configuration)",example:"https://keycloak.example.com/realms/myrealm/.well-known/openid-configuration"},{name:"scopes",type:"string[]",required:false,description:"Scopes to request",default:'["openid", "email", "profile"]'}],returnType:"OidcIdentityProvider",example:`import { buildOidcProvider } from "@.../caddy-api-client/plugins/caddy-security";
 
@@ -39,14 +39,14 @@ const provider = buildOidcProvider({
   clientId: "my-app",
   clientSecret: "secret",
   metadataUrl: "https://keycloak.example.com/realms/myrealm/.well-known/openid-configuration",
-});`,snippet:{prefix:"caddy-oidc-provider",body:["buildOidcProvider({",'  provider: ${1:""},',"  clientId: ${2:your-client-id},","  clientSecret: ${3:your-client-secret},",'  metadataUrl: ${4:""},','  // scopes: ${5:["openid", "email", "profile"]},',"})"],description:"Build OIDC Provider"}},buildAuthenticationPortal:{name:"buildAuthenticationPortal",description:"Build an authentication portal configuration",params:[{name:"name",type:"string",required:true,description:"Portal name (referenced by portal_name in handlers)"},{name:"ui",type:"PortalUiOptions",required:false,description:"UI customization settings"},{name:"cookie",type:"CookieOptions",required:false,description:"Cookie settings"},{name:"identityStores",type:"string[]",required:false,description:"Identity store names enabled for this portal"},{name:"identityProviders",type:"string[]",required:false,description:"Identity provider names enabled for this portal"},{name:"transformUser",type:"Record<string, unknown>",required:false,description:"Transform rules for user claims"}],returnType:"AuthenticationPortal",example:`import { buildAuthenticationPortal } from "@.../caddy-api-client/plugins/caddy-security";
+});`,snippet:{prefix:"caddy-oidc-provider",body:["buildOidcProvider({",'  provider: "${1:github}",','  clientId: "${2:your-client-id}",','  clientSecret: "${3:your-client-secret}",','  metadataUrl: "${4:https://idp.example.com}",',"  // optional: name, realm, scopes","})$0"],description:"Build OIDC Provider"}},buildAuthenticationPortal:{name:"buildAuthenticationPortal",description:"Build an authentication portal configuration",params:[{name:"name",type:"string",required:true,description:"Portal name (referenced by portal_name in handlers)"},{name:"ui",type:"PortalUiOptions",required:false,description:"UI customization settings"},{name:"cookie",type:"CookieOptions",required:false,description:"Cookie settings"},{name:"identityStores",type:"string[]",required:false,description:"Identity store names enabled for this portal"},{name:"identityProviders",type:"string[]",required:false,description:"Identity provider names enabled for this portal"},{name:"transformUser",type:"Record<string, unknown>",required:false,description:"Transform rules for user claims"}],returnType:"AuthenticationPortal",example:`import { buildAuthenticationPortal } from "@.../caddy-api-client/plugins/caddy-security";
 
 const portal = buildAuthenticationPortal({
   name: "myportal",
   identityStores: ["localdb"],
   identityProviders: ["keycloak"],
   cookie: { domain: ".example.com", lifetime: "24h" },
-});`,snippet:{prefix:"caddy-authentication-portal",body:["buildAuthenticationPortal({","  name: ${1:my-name},","})"],description:"Build Authentication Portal"}},buildAuthorizationPolicy:{name:"buildAuthorizationPolicy",description:"Build an authorization policy (gatekeeper) configuration",params:[{name:"name",type:"string",required:true,description:"Policy name (referenced by gatekeeper_name in handlers)"},{name:"accessLists",type:"AccessListEntry[]",required:false,description:"Access control lists"},{name:"cryptoKey",type:"CryptoKeyConfig",required:false,description:"Crypto key configuration for JWT validation"},{name:"bypass",type:"string[]",required:false,description:"Bypass paths (no auth required)"}],returnType:"AuthorizationPolicy",example:`import { buildAuthorizationPolicy } from "@.../caddy-api-client/plugins/caddy-security";
+});`,snippet:{prefix:"caddy-authentication-portal",body:["buildAuthenticationPortal({",'  name: "${1:myportal}",',"  // optional: ui, cookie, identityStores, identityProviders, transformUser","})$0"],description:"Build Authentication Portal"}},buildAuthorizationPolicy:{name:"buildAuthorizationPolicy",description:"Build an authorization policy (gatekeeper) configuration",params:[{name:"name",type:"string",required:true,description:"Policy name (referenced by gatekeeper_name in handlers)"},{name:"accessLists",type:"AccessListEntry[]",required:false,description:"Access control lists"},{name:"cryptoKey",type:"CryptoKeyConfig",required:false,description:"Crypto key configuration for JWT validation"},{name:"bypass",type:"string[]",required:false,description:"Bypass paths (no auth required)"}],returnType:"AuthorizationPolicy",example:`import { buildAuthorizationPolicy } from "@.../caddy-api-client/plugins/caddy-security";
 
 const policy = buildAuthorizationPolicy({
   name: "admin-policy",
@@ -54,7 +54,7 @@ const policy = buildAuthorizationPolicy({
     { claim: "roles", values: ["admin", "editor"], action: "allow" },
   ],
   bypass: ["/health", "/metrics"],
-});`,snippet:{prefix:"caddy-authorization-policy",body:["buildAuthorizationPolicy({","  name: ${1:my-name},","})"],description:"Build Authorization Policy"}},buildSecurityConfig:{name:"buildSecurityConfig",description:"Build a security configuration",params:[{name:"portals",type:"AuthenticationPortal[]",required:false,description:"Authentication portals"},{name:"policies",type:"AuthorizationPolicy[]",required:false,description:"Authorization policies (gatekeepers)"},{name:"identityStores",type:"(LocalIdentityStore | LdapIdentityStore)[]",required:false,description:"Identity stores"},{name:"identityProviders",type:"(OAuth2IdentityProvider | OidcIdentityProvider)[]",required:false,description:"Identity providers"}],returnType:"SecurityConfig",example:`import {
+});`,snippet:{prefix:"caddy-authorization-policy",body:["buildAuthorizationPolicy({",'  name: "${1:mypolicy}",',"  // optional: accessLists, cryptoKey, bypass","})$0"],description:"Build Authorization Policy"}},buildSecurityConfig:{name:"buildSecurityConfig",description:"Build a security configuration",params:[{name:"portals",type:"AuthenticationPortal[]",required:false,description:"Authentication portals"},{name:"policies",type:"AuthorizationPolicy[]",required:false,description:"Authorization policies (gatekeepers)"},{name:"identityStores",type:"(LocalIdentityStore | LdapIdentityStore)[]",required:false,description:"Identity stores"},{name:"identityProviders",type:"(OAuth2IdentityProvider | OidcIdentityProvider)[]",required:false,description:"Identity providers"}],returnType:"SecurityConfig",example:`import {
   buildSecurityConfig,
   buildLocalIdentityStore,
   buildAuthenticationPortal,
@@ -77,7 +77,7 @@ const config = buildSecurityConfig({
       accessLists: [{ claim: "roles", values: ["user"] }],
     }),
   ],
-});`,snippet:{prefix:"caddy-security-config",body:["buildSecurityConfig({","})"],description:"Build Security Config"}},buildSecurityApp:{name:"buildSecurityApp",description:"Build a complete security app configuration\n\nCreates the full security app configuration for `/config/apps/security`.",params:[{name:"config",type:"SecurityConfig",required:true,description:"Security configuration"}],returnType:"SecurityApp",example:`import { buildSecurityApp, buildSecurityConfig } from "@.../caddy-api-client/plugins/caddy-security";
+});`,snippet:{prefix:"caddy-security-config",body:["buildSecurityConfig({",'  portals: [{ name: "${1:myportal}" }],','  policies: [{ name: "${2:mypolicy}" }],','  identityStores: [{ name: "${3:local}", params: { path: "${4:/etc/caddy/users.json}" }, kind: "local" }],',"  // optional: identityProviders","})$0"],description:"Build Security Config"}},buildSecurityApp:{name:"buildSecurityApp",description:"Build a complete security app configuration\n\nCreates the full security app configuration for `/config/apps/security`.",params:[{name:"config",type:"SecurityConfig",required:true,description:"Security configuration"}],returnType:"SecurityApp",example:`import { buildSecurityApp, buildSecurityConfig } from "@.../caddy-api-client/plugins/caddy-security";
 
 const app = buildSecurityApp({
   config: buildSecurityConfig({
@@ -89,7 +89,7 @@ const app = buildSecurityApp({
 await client.request("/config/apps/security", {
   method: "PUT",
   body: JSON.stringify(app),
-});`,snippet:{prefix:"caddy-security-app",body:["buildSecurityApp({",'  config: ${1:""}',"})"],description:"Build Security App"}},buildAuthenticatorHandler:{name:"buildAuthenticatorHandler",description:`Build an authenticator portal handler
+});`,snippet:{prefix:"caddy-security-app",body:["buildSecurityApp({","  config: {},","})$0"],description:"Build Security App"}},buildAuthenticatorHandler:{name:"buildAuthenticatorHandler",description:`Build an authenticator portal handler
 
 Creates a caddy-security authenticator handler that serves the login portal
 and handles credential validation.`,params:[{name:"portalName",type:"string",required:true,description:"Name of the authentication portal defined in security app config"},{name:"routeMatcher",type:"string",required:false,description:"Optional route matcher pattern"}],returnType:"SecurityAuthenticatorHandler",example:`import { buildAuthenticatorHandler } from "@.../caddy-api-client/plugins/caddy-security";
@@ -103,7 +103,7 @@ const route: CaddyRoute = {
   match: [{ host: ["auth.example.com"] }],
   handle: [handler],
   terminal: true,
-};`,snippet:{prefix:"caddy-authenticator-handler",body:["buildAuthenticatorHandler({",'  portalName: ${1:""},',"})"],description:"Build Authenticator Handler"}},buildAuthorizationHandler:{name:"buildAuthorizationHandler",description:`Build an authorization handler
+};`,snippet:{prefix:"caddy-authenticator-handler",body:["buildAuthenticatorHandler({",'  portalName: "${1:myportal}",',"  // optional: routeMatcher","})$0"],description:"Build Authenticator Handler"}},buildAuthorizationHandler:{name:"buildAuthorizationHandler",description:`Build an authorization handler
 
 Creates a caddy-security authorization handler that validates JWT/PASETO
 tokens and enforces access control policies.
@@ -123,7 +123,7 @@ const route: CaddyRoute = {
     { handler: "reverse_proxy", upstreams: [{ dial: "localhost:3000" }] },
   ],
   terminal: true,
-};`,snippet:{prefix:"caddy-authorization-handler",body:["buildAuthorizationHandler({",'  gatekeeperName: ${1:""},',"})"],description:"Build Authorization Handler"}},buildAuthenticatorRoute:{name:"buildAuthenticatorRoute",description:`Build a complete authentication portal route
+};`,snippet:{prefix:"caddy-authorization-handler",body:["buildAuthorizationHandler({",'  gatekeeperName: "${1:mypolicy}",',"  // optional: routeMatcher","})$0"],description:"Build Authorization Handler"}},buildAuthenticatorRoute:{name:"buildAuthenticatorRoute",description:`Build a complete authentication portal route
 
 Creates a Caddy route that serves the authentication portal on specified hosts.`,params:[{name:"hosts",type:"string[]",required:true,description:"Host(s) to match for the authentication portal"},{name:"portalName",type:"string",required:true,description:"Name of the authentication portal"},{name:"routeId",type:"string",required:false,description:"Route ID for tracking"}],returnType:"CaddyRoute",example:`import { buildAuthenticatorRoute } from "@.../caddy-api-client/plugins/caddy-security";
 
@@ -133,7 +133,7 @@ const route = buildAuthenticatorRoute({
   routeId: "auth-portal",
 });
 
-await client.addRoute("https_server", route);`,snippet:{prefix:"caddy-authenticator-route",body:["buildAuthenticatorRoute({","  hosts: ${1:example.com},",'  portalName: ${2:""},',"})"],description:"Build Authenticator Route"}},buildProtectedRoute:{name:"buildProtectedRoute",description:`Build a protected route with authorization
+await client.addRoute("https_server", route);`,snippet:{prefix:"caddy-authenticator-route",body:["buildAuthenticatorRoute({",'  hosts: ["${1:example.com}"],','  portalName: "${2:myportal}",',"  // optional: routeId","})$0"],description:"Build Authenticator Route"}},buildProtectedRoute:{name:"buildProtectedRoute",description:`Build a protected route with authorization
 
 Creates a Caddy route that requires valid JWT/PASETO tokens before
 proxying to the upstream service.`,params:[{name:"hosts",type:"string[]",required:true,description:"Host(s) to match"},{name:"paths",type:"string[]",required:false,description:"Path(s) to match (optional)"},{name:"gatekeeperName",type:"string",required:true,description:"Name of the gatekeeper/policy for authorization"},{name:"dial",type:"string",required:true,description:"Upstream dial address (host:port)"},{name:"routeId",type:"string",required:false,description:"Route ID for tracking"}],returnType:"CaddyRoute",example:`import { buildProtectedRoute } from "@.../caddy-api-client/plugins/caddy-security";
@@ -146,39 +146,134 @@ const route = buildProtectedRoute({
   routeId: "protected-admin-api",
 });
 
-await client.addRoute("https_server", route);`,snippet:{prefix:"caddy-protected-route",body:["buildProtectedRoute({","  hosts: ${1:example.com},",'  gatekeeperName: ${2:""},',"  dial: ${3:localhost:3000},","})"],description:"Build Protected Route"}},buildServiceRoutes:{name:"buildServiceRoutes",description:"Build routes for a service (host-based and/or path-based)",params:[],returnType:"CaddyRoute[]",snippet:{prefix:"caddy-service-routes",body:["buildServiceRoutes({","})"],description:"Build Service Routes"}},buildHealthCheckRoute:{name:"buildHealthCheckRoute",description:"Build a health check route",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-health-check-route",body:["buildHealthCheckRoute({","})"],description:"Build Health Check Route"}},buildHostRoute:{name:"buildHostRoute",description:"Build a host-based route",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-host-route",body:["buildHostRoute({","})"],description:"Build Host Route"}},buildPathRoute:{name:"buildPathRoute",description:"Build a path-based route",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-path-route",body:["buildPathRoute({","})"],description:"Build Path Route"}},buildLoadBalancerRoute:{name:"buildLoadBalancerRoute",description:"Build a load balancer route",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-load-balancer-route",body:["buildLoadBalancerRoute({","})"],description:"Build Load Balancer Route"}},buildReverseProxyHandler:{name:"buildReverseProxyHandler",description:"Build a reverse proxy handler",params:[],returnType:"CaddyRouteHandler",example:`// HTTP backend (default)
-buildReverseProxyHandler("nginx:80")`,snippet:{prefix:"caddy-reverse-proxy-handler",body:["buildReverseProxyHandler({","})"],description:"Build Reverse Proxy Handler"}},buildSecurityHeadersHandler:{name:"buildSecurityHeadersHandler",description:"Build a security headers handler",params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-security-headers-handler",body:["buildSecurityHeadersHandler({","})"],description:"Build Security Headers Handler"}},buildBasicAuthHandler:{name:"buildBasicAuthHandler",description:`Build a basic auth handler
-Supports both single account (legacy) and multiple accounts`,params:[],returnType:"CaddyRouteHandler",example:`// Single account (legacy)
+await client.addRoute("https_server", route);`,snippet:{prefix:"caddy-protected-route",body:["buildProtectedRoute({",'  hosts: ["${1:example.com}"],','  gatekeeperName: "${2:mypolicy}",','  dial: "${3:localhost:3000}",',"  // optional: paths, routeId","})$0"],description:"Build Protected Route"}},buildServiceRoutes:{name:"buildServiceRoutes",description:"Build routes for a service (host-based and/or path-based)",params:[{name:"host",type:"string",required:false,description:"Host for host-based route"},{name:"path",type:"string",required:false,description:"Path for path-based route"},{name:"pathRouteHost",type:"string",required:false,description:"Host for path-based route",default:"asd.localhost"},{name:"dial",type:"string",required:true,description:"Dial address (host:port)"},{name:"serviceId",type:"string",required:false,description:"Service identifier for health checks"},{name:"enableHostRoute",type:"boolean",required:false,description:"Enable host-based route",default:"true"},{name:"enablePathRoute",type:"boolean",required:false,description:"Enable path-based route",default:"true"},{name:"stripPrefix",type:"boolean",required:false,description:"Strip path prefix",default:"true"},{name:"priority",type:"number",required:false,description:"Route priority (higher = matches first)",default:"50"},{name:"securityHeaders",type:"SecurityHeaders",required:false,description:"Security headers configuration"},{name:"basicAuth",type:"BasicAuthOptions",required:false,description:"Basic authentication configuration"},{name:"ingressTag",type:"string",required:false,description:`Ingress tag value for X-ASD-Ingress header
+Set to null to explicitly disable`},{name:"iframeOrigin",type:"string",required:false,description:`Origin for iframe embedding headers (CORS + CSP)
+Set to null to explicitly disable`},{name:"deleteResponseHeaders",type:"string[]",required:false,description:`Response headers to delete from reverse proxy response
+(e.g., ["Content-Security-Policy"] for iframe support)`},{name:"serviceType",type:"string",required:false,description:"Service type for X-ASD-Service-Type header"},{name:"isTunnelDomain",type:"boolean",required:false,description:`Whether this is a tunnel domain route
+Used for selective auth (tunnel vs host route type)`},{name:"flushInterval",type:"number",required:false,description:`Flush interval for reverse proxy streaming support.
+Set to -1 to disable buffering (required for WebSocket/SSE).`},{name:"projectId",type:"string",required:false,description:`Project identifier for X-ASD-Project header.
+Used to identify which project's Caddy handled the request.`}],returnType:"CaddyRoute[]",snippet:{prefix:"caddy-service-routes",body:["buildServiceRoutes({",'  dial: "${1:localhost:3000}",',"  // optional: host, path, pathRouteHost, serviceId, enableHostRoute, enablePathRoute, ...","})$0"],description:"Build Service Routes"}},buildHealthCheckRoute:{name:"buildHealthCheckRoute",description:"Build a health check route",params:[{name:"host",type:"string",required:true,description:""},{name:"serviceId",type:"string",required:true,description:""},{name:"priority",type:"number",required:false,description:""},{name:"ingressTag",type:"string",required:false,description:"Ingress tag value for X-ASD-Ingress header"},{name:"dial",type:"string",required:false,description:"Upstream dial address. When set, health check uses reverse_proxy instead of static_response"},{name:"projectId",type:"string",required:false,description:"Project identifier for X-ASD-Project header"}],returnType:"CaddyRoute",snippet:{prefix:"caddy-health-check-route",body:["buildHealthCheckRoute({",'  host: "${1:example.com}",','  serviceId: "${2:my-id}",',"  // optional: priority, ingressTag, dial, projectId","})$0"],description:"Build Health Check Route"}},buildHostRoute:{name:"buildHostRoute",description:"Build a host-based route",params:[{name:"host",type:"string",required:true,description:""},{name:"dial",type:"string",required:true,description:""},{name:"securityHeaders",type:"SecurityHeaders",required:false,description:""},{name:"basicAuth",type:"BasicAuthOptions",required:false,description:""},{name:"priority",type:"number",required:false,description:""},{name:"ingressTag",type:"string",required:false,description:"Ingress tag value for X-ASD-Ingress header"},{name:"iframeOrigin",type:"string",required:false,description:"Origin for iframe embedding headers"},{name:"deleteResponseHeaders",type:"string[]",required:false,description:"Response headers to delete from reverse proxy"},{name:"serviceId",type:"string",required:false,description:"Service ID for X-ASD-Service-ID header"},{name:"serviceType",type:"string",required:false,description:"Service type for X-ASD-Service-Type header"},{name:"flushInterval",type:"number",required:false,description:"Flush interval for reverse proxy streaming (-1 disables buffering)"},{name:"projectId",type:"string",required:false,description:"Project identifier for X-ASD-Project header"}],returnType:"CaddyRoute",snippet:{prefix:"caddy-host-route",body:["buildHostRoute({",'  host: "${1:example.com}",','  dial: "${2:localhost:3000}",',"  // optional: securityHeaders, basicAuth, priority, ingressTag, iframeOrigin, deleteResponseHeaders, ...","})$0"],description:"Build Host Route"}},buildPathRoute:{name:"buildPathRoute",description:"Build a path-based route",params:[{name:"path",type:"string",required:true,description:""},{name:"host",type:"string",required:true,description:""},{name:"dial",type:"string",required:true,description:""},{name:"stripPrefix",type:"boolean",required:false,description:""},{name:"securityHeaders",type:"SecurityHeaders",required:false,description:""},{name:"basicAuth",type:"BasicAuthOptions",required:false,description:""},{name:"priority",type:"number",required:false,description:""},{name:"ingressTag",type:"string",required:false,description:"Ingress tag value for X-ASD-Ingress header"},{name:"iframeOrigin",type:"string",required:false,description:"Origin for iframe embedding headers"},{name:"deleteResponseHeaders",type:"string[]",required:false,description:"Response headers to delete from reverse proxy"},{name:"serviceId",type:"string",required:false,description:"Service ID for X-ASD-Service-ID header"},{name:"serviceType",type:"string",required:false,description:"Service type for X-ASD-Service-Type header"},{name:"flushInterval",type:"number",required:false,description:"Flush interval for reverse proxy streaming (-1 disables buffering)"},{name:"projectId",type:"string",required:false,description:"Project identifier for X-ASD-Project header"}],returnType:"CaddyRoute",snippet:{prefix:"caddy-path-route",body:["buildPathRoute({",'  path: "${1:/api/*}",','  host: "${2:example.com}",','  dial: "${3:localhost:3000}",',"  // optional: stripPrefix, securityHeaders, basicAuth, priority, ingressTag, iframeOrigin, ...","})$0"],description:"Build Path Route"}},buildLoadBalancerRoute:{name:"buildLoadBalancerRoute",description:"Build a load balancer route",params:[{name:"host",type:"string",required:true,description:""},{name:"upstreams",type:"string[]",required:true,description:""},{name:"healthCheckPath",type:"string",required:false,description:""},{name:"healthCheckInterval",type:"string",required:false,description:""},{name:"policy",type:'"first" | "random" | "least_conn" | "round_robin"',required:false,description:""},{name:"priority",type:"number",required:false,description:""}],returnType:"CaddyRoute",snippet:{prefix:"caddy-load-balancer-route",body:["buildLoadBalancerRoute({",'  host: "${1:example.com}",','  upstreams: ["${2:localhost:3000}"],',"  // optional: healthCheckPath, healthCheckInterval, policy, priority","})$0"],description:"Build Load Balancer Route"}},buildReverseProxyHandler:{name:"buildReverseProxyHandler",description:"Build a reverse proxy handler",params:[{name:"toString",type:"() => string",required:true,description:"Returns a string representation of a string."},{name:"charAt",type:"(pos: number) => string",required:true,description:"Returns the character at the specified index."},{name:"charCodeAt",type:"(index: number) => number",required:true,description:"Returns the Unicode value of the character at the specified location."},{name:"concat",type:"(...strings: string[]) => string",required:true,description:"Returns a string that contains the concatenation of two or more strings."},{name:"indexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the position of the first occurrence of a substring."},{name:"lastIndexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the last occurrence of a substring in the string."},{name:"localeCompare",type:"{ (that: string): number; (that: string, locales?: string | string[] | undefined, options?: CollatorOptions | undefined): number; (that: string, locales?: LocalesArgument, options?: CollatorOptions | undefined): number; }",required:true,description:`Determines whether two strings are equivalent in the current locale.
+Determines whether two strings are equivalent in the current or specified locale.`},{name:"match",type:"{ (regexp: string | RegExp): RegExpMatchArray | null; (matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null; }",required:true,description:`Matches a string with a regular expression, and returns an array containing the results of that search.
+Matches a string or an object that supports being matched against, and returns an array
+containing the results of that search, or null if no matches are found.`},{name:"replace",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; (searchValue: { ...; }, replaceValue: string): string; (searchValue: { ...; }, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replaces text in a string, using a regular expression or search string.\nPasses a string and {@linkcode replaceValue} to the `[Symbol.replace]` method on {@linkcode searchValue}. This method is expected to implement its own replacement algorithm.\nReplaces text in a string, using an object that supports replacement within a string."},{name:"search",type:"{ (regexp: string | RegExp): number; (searcher: { [Symbol.search](string: string): number; }): number; }",required:true,description:"Finds the first substring match in a regular expression search."},{name:"slice",type:"(start?: number | undefined, end?: number | undefined) => string",required:true,description:"Returns a section of a string."},{name:"split",type:"{ (separator: string | RegExp, limit?: number | undefined): string[]; (splitter: { [Symbol.split](string: string, limit?: number | undefined): string[]; }, limit?: number | undefined): string[]; }",required:true,description:"Split a string into substrings using the specified separator and return them as an array."},{name:"substring",type:"(start: number, end?: number | undefined) => string",required:true,description:"Returns the substring at the specified location within a String object."},{name:"toLowerCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to lowercase."},{name:"toLocaleLowerCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Converts all alphabetic characters to lowercase, taking into account the host environment's current locale."},{name:"toUpperCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to uppercase."},{name:"toLocaleUpperCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale."},{name:"trim",type:"() => string",required:true,description:"Removes the leading and trailing white space and line terminator characters from a string."},{name:"length",type:"number",required:true,description:"Returns the length of a String object."},{name:"substr",type:"(from: number, length?: number | undefined) => string",required:true,description:"Gets a substring beginning at the specified location and having the specified length."},{name:"valueOf",type:"() => string",required:true,description:"Returns the primitive value of the specified object."},{name:"codePointAt",type:"(pos: number) => number | undefined",required:true,description:`Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
+value of the UTF-16 encoded code point starting at the string element at position pos in
+the String resulting from converting this object to a String.
+If there is no element at that position, the result is undefined.
+If a valid UTF-16 surrogate pair does not begin at pos, the result is the code unit at pos.`},{name:"includes",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if searchString appears as a substring of the result of converting this
+object to a String, at one or more positions that are
+greater than or equal to position; otherwise, returns false.`},{name:"endsWith",type:"(searchString: string, endPosition?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+endPosition \u2013 length(this). Otherwise returns false.`},{name:"normalize",type:'{ (form: "NFC" | "NFD" | "NFKC" | "NFKD"): string; (form?: string | undefined): string; }',required:true,description:`Returns the String value result of normalizing the string into the normalization form
+named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.`},{name:"repeat",type:"(count: number) => string",required:true,description:`Returns a String value that is made from count copies appended together. If count is 0,
+the empty string is returned.`},{name:"startsWith",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+position. Otherwise returns false.`},{name:"anchor",type:"(name: string) => string",required:true,description:"Returns an `<a>` HTML anchor element and sets the name attribute to the text value"},{name:"big",type:"() => string",required:true,description:"Returns a `<big>` HTML element"},{name:"blink",type:"() => string",required:true,description:"Returns a `<blink>` HTML element"},{name:"bold",type:"() => string",required:true,description:"Returns a `<b>` HTML element"},{name:"fixed",type:"() => string",required:true,description:"Returns a `<tt>` HTML element"},{name:"fontcolor",type:"(color: string) => string",required:true,description:"Returns a `<font>` HTML element and sets the color attribute value"},{name:"fontsize",type:"{ (size: number): string; (size: string): string; }",required:true,description:"Returns a `<font>` HTML element and sets the size attribute value"},{name:"italics",type:"() => string",required:true,description:"Returns an `<i>` HTML element"},{name:"link",type:"(url: string) => string",required:true,description:"Returns an `<a>` HTML element and sets the href attribute value"},{name:"small",type:"() => string",required:true,description:"Returns a `<small>` HTML element"},{name:"strike",type:"() => string",required:true,description:"Returns a `<strike>` HTML element"},{name:"sub",type:"() => string",required:true,description:"Returns a `<sub>` HTML element"},{name:"sup",type:"() => string",required:true,description:"Returns a `<sup>` HTML element"},{name:"padStart",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the start (left) of the current string.`},{name:"padEnd",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the end (right) of the current string.`},{name:"trimEnd",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"trimStart",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimLeft",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimRight",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"matchAll",type:"(regexp: RegExp) => RegExpStringIterator<RegExpExecArray>",required:true,description:`Matches a string with a regular expression, and returns an iterable of matches
+containing the results of that search.`},{name:"replaceAll",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replace all instances of a substring in a string, using a regular expression or search string."},{name:"at",type:"(index: number) => string | undefined",required:true,description:"Returns a new String consisting of the single UTF-16 code unit located at the specified index."},{name:"__@iterator@16",type:"() => StringIterator<string>",required:true,description:"Iterator"}],returnType:"CaddyRouteHandler",example:`// HTTP backend (default)
+buildReverseProxyHandler("nginx:80")`,snippet:{prefix:"caddy-reverse-proxy-handler",body:['buildReverseProxyHandler("${1:localhost:3000}")$0'],description:"Build Reverse Proxy Handler"}},buildSecurityHeadersHandler:{name:"buildSecurityHeadersHandler",description:"Build a security headers handler",params:[{name:"enableHsts",type:"boolean",required:false,description:"Enable HSTS (HTTP Strict Transport Security)",default:"false"},{name:"hstsMaxAge",type:"number",required:false,description:"HSTS max-age in seconds",default:"31536000 (1 year)"},{name:"frameOptions",type:"FrameOptions",required:false,description:"X-Frame-Options header value",default:"DENY"},{name:"enableCompression",type:"boolean",required:false,description:"Enable gzip/brotli compression",default:"true"}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-security-headers-handler",body:["buildSecurityHeadersHandler({","  enableHsts: ${1|false,true|},","  hstsMaxAge: ${2:1},",'  frameOptions: "${3|DENY,SAMEORIGIN|}",',"  // optional: enableCompression","})$0"],description:"Build Security Headers Handler"}},buildBasicAuthHandler:{name:"buildBasicAuthHandler",description:`Build a basic auth handler
+Supports both single account (legacy) and multiple accounts`,params:[{name:"enabled",type:"boolean",required:true,description:""},{name:"username",type:"string",required:false,description:"Single username (legacy - use accounts instead)"},{name:"passwordHash",type:"string",required:false,description:"Single password hash (legacy - use accounts instead)"},{name:"accounts",type:"BasicAuthAccount[]",required:false,description:"Multiple accounts (recommended)"},{name:"realm",type:"string",required:false,description:"Authentication realm"},{name:"hash",type:'{ algorithm?: "bcrypt" | undefined; cost?: number | undefined; }',required:false,description:"Hash algorithm (default: bcrypt)"},{name:"routes",type:'("path" | "host" | "tunnel")[]',required:false,description:"Which route types should have auth applied (default: all)"}],returnType:"CaddyRouteHandler",example:`// Single account (legacy)
 buildBasicAuthHandler({
   enabled: true,
   username: "admin",
   passwordHash: "$2a$10$...",
   realm: "Admin Area"
-})`,snippet:{prefix:"caddy-basic-auth-handler",body:["buildBasicAuthHandler({","})"],description:"Build Basic Auth Handler"}},buildRewriteHandler:{name:"buildRewriteHandler",description:"Build a rewrite handler (strip path prefix)",params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-rewrite-handler",body:["buildRewriteHandler({","})"],description:"Build Rewrite Handler"}},buildServiceMetadataHeadersHandler:{name:"buildServiceMetadataHeadersHandler",description:`Build a service metadata headers handler
-Sets X-ASD-Service-ID and X-ASD-Service-Type headers`,params:[],returnType:"CaddyRouteHandler | null",snippet:{prefix:"caddy-service-metadata-headers-handler",body:["buildServiceMetadataHeadersHandler({","})"],description:"Build Service Metadata Headers Handler"}},buildIngressTagHeadersHandler:{name:"buildIngressTagHeadersHandler",description:"Build an ingress tag header handler",params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-ingress-tag-headers-handler",body:["buildIngressTagHeadersHandler({","})"],description:"Build Ingress Tag Headers Handler"}},buildProjectIdHeadersHandler:{name:"buildProjectIdHeadersHandler",description:"Build a project identity header handler",params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-project-id-headers-handler",body:["buildProjectIdHeadersHandler({","})"],description:"Build Project Id Headers Handler"}},buildIframeHeadersHandler:{name:"buildIframeHeadersHandler",description:"Build CORS/CSP headers for iframe embedding",params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-iframe-headers-handler",body:["buildIframeHeadersHandler({","})"],description:"Build Iframe Headers Handler"}},buildRedirectRoute:{name:"buildRedirectRoute",description:"Build a redirect route for domain redirects (www <-> non-www)",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-redirect-route",body:["buildRedirectRoute({","})"],description:"Build Redirect Route"}},buildCompressionHandler:{name:"buildCompressionHandler",description:`Build a compression (encode) handler
-Supports gzip, zstd, and brotli compression`,params:[],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-compression-handler",body:["buildCompressionHandler({","})"],description:"Build Compression Handler"}},buildWwwRedirect:{name:"buildWwwRedirect",description:`Build a WWW redirect route (www.example.com \u2194 example.com)
+})`,snippet:{prefix:"caddy-basic-auth-handler",body:["buildBasicAuthHandler({","  enabled: ${1|true,false|},","  // optional: username, passwordHash, accounts, realm, hash, routes","})$0"],description:"Build Basic Auth Handler"}},buildRewriteHandler:{name:"buildRewriteHandler",description:"Build a rewrite handler (strip path prefix)",params:[{name:"toString",type:"() => string",required:true,description:"Returns a string representation of a string."},{name:"charAt",type:"(pos: number) => string",required:true,description:"Returns the character at the specified index."},{name:"charCodeAt",type:"(index: number) => number",required:true,description:"Returns the Unicode value of the character at the specified location."},{name:"concat",type:"(...strings: string[]) => string",required:true,description:"Returns a string that contains the concatenation of two or more strings."},{name:"indexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the position of the first occurrence of a substring."},{name:"lastIndexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the last occurrence of a substring in the string."},{name:"localeCompare",type:"{ (that: string): number; (that: string, locales?: string | string[] | undefined, options?: CollatorOptions | undefined): number; (that: string, locales?: LocalesArgument, options?: CollatorOptions | undefined): number; }",required:true,description:`Determines whether two strings are equivalent in the current locale.
+Determines whether two strings are equivalent in the current or specified locale.`},{name:"match",type:"{ (regexp: string | RegExp): RegExpMatchArray | null; (matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null; }",required:true,description:`Matches a string with a regular expression, and returns an array containing the results of that search.
+Matches a string or an object that supports being matched against, and returns an array
+containing the results of that search, or null if no matches are found.`},{name:"replace",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; (searchValue: { ...; }, replaceValue: string): string; (searchValue: { ...; }, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replaces text in a string, using a regular expression or search string.\nPasses a string and {@linkcode replaceValue} to the `[Symbol.replace]` method on {@linkcode searchValue}. This method is expected to implement its own replacement algorithm.\nReplaces text in a string, using an object that supports replacement within a string."},{name:"search",type:"{ (regexp: string | RegExp): number; (searcher: { [Symbol.search](string: string): number; }): number; }",required:true,description:"Finds the first substring match in a regular expression search."},{name:"slice",type:"(start?: number | undefined, end?: number | undefined) => string",required:true,description:"Returns a section of a string."},{name:"split",type:"{ (separator: string | RegExp, limit?: number | undefined): string[]; (splitter: { [Symbol.split](string: string, limit?: number | undefined): string[]; }, limit?: number | undefined): string[]; }",required:true,description:"Split a string into substrings using the specified separator and return them as an array."},{name:"substring",type:"(start: number, end?: number | undefined) => string",required:true,description:"Returns the substring at the specified location within a String object."},{name:"toLowerCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to lowercase."},{name:"toLocaleLowerCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Converts all alphabetic characters to lowercase, taking into account the host environment's current locale."},{name:"toUpperCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to uppercase."},{name:"toLocaleUpperCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale."},{name:"trim",type:"() => string",required:true,description:"Removes the leading and trailing white space and line terminator characters from a string."},{name:"length",type:"number",required:true,description:"Returns the length of a String object."},{name:"substr",type:"(from: number, length?: number | undefined) => string",required:true,description:"Gets a substring beginning at the specified location and having the specified length."},{name:"valueOf",type:"() => string",required:true,description:"Returns the primitive value of the specified object."},{name:"codePointAt",type:"(pos: number) => number | undefined",required:true,description:`Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
+value of the UTF-16 encoded code point starting at the string element at position pos in
+the String resulting from converting this object to a String.
+If there is no element at that position, the result is undefined.
+If a valid UTF-16 surrogate pair does not begin at pos, the result is the code unit at pos.`},{name:"includes",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if searchString appears as a substring of the result of converting this
+object to a String, at one or more positions that are
+greater than or equal to position; otherwise, returns false.`},{name:"endsWith",type:"(searchString: string, endPosition?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+endPosition \u2013 length(this). Otherwise returns false.`},{name:"normalize",type:'{ (form: "NFC" | "NFD" | "NFKC" | "NFKD"): string; (form?: string | undefined): string; }',required:true,description:`Returns the String value result of normalizing the string into the normalization form
+named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.`},{name:"repeat",type:"(count: number) => string",required:true,description:`Returns a String value that is made from count copies appended together. If count is 0,
+the empty string is returned.`},{name:"startsWith",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+position. Otherwise returns false.`},{name:"anchor",type:"(name: string) => string",required:true,description:"Returns an `<a>` HTML anchor element and sets the name attribute to the text value"},{name:"big",type:"() => string",required:true,description:"Returns a `<big>` HTML element"},{name:"blink",type:"() => string",required:true,description:"Returns a `<blink>` HTML element"},{name:"bold",type:"() => string",required:true,description:"Returns a `<b>` HTML element"},{name:"fixed",type:"() => string",required:true,description:"Returns a `<tt>` HTML element"},{name:"fontcolor",type:"(color: string) => string",required:true,description:"Returns a `<font>` HTML element and sets the color attribute value"},{name:"fontsize",type:"{ (size: number): string; (size: string): string; }",required:true,description:"Returns a `<font>` HTML element and sets the size attribute value"},{name:"italics",type:"() => string",required:true,description:"Returns an `<i>` HTML element"},{name:"link",type:"(url: string) => string",required:true,description:"Returns an `<a>` HTML element and sets the href attribute value"},{name:"small",type:"() => string",required:true,description:"Returns a `<small>` HTML element"},{name:"strike",type:"() => string",required:true,description:"Returns a `<strike>` HTML element"},{name:"sub",type:"() => string",required:true,description:"Returns a `<sub>` HTML element"},{name:"sup",type:"() => string",required:true,description:"Returns a `<sup>` HTML element"},{name:"padStart",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the start (left) of the current string.`},{name:"padEnd",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the end (right) of the current string.`},{name:"trimEnd",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"trimStart",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimLeft",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimRight",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"matchAll",type:"(regexp: RegExp) => RegExpStringIterator<RegExpExecArray>",required:true,description:`Matches a string with a regular expression, and returns an iterable of matches
+containing the results of that search.`},{name:"replaceAll",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replace all instances of a substring in a string, using a regular expression or search string."},{name:"at",type:"(index: number) => string | undefined",required:true,description:"Returns a new String consisting of the single UTF-16 code unit located at the specified index."},{name:"__@iterator@16",type:"() => StringIterator<string>",required:true,description:"Iterator"}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-rewrite-handler",body:['buildRewriteHandler("${1:/api}")$0'],description:"Build Rewrite Handler"}},buildIngressTagHeadersHandler:{name:"buildIngressTagHeadersHandler",description:"Build an ingress tag header handler",params:[{name:"toString",type:"() => string",required:true,description:"Returns a string representation of a string."},{name:"charAt",type:"(pos: number) => string",required:true,description:"Returns the character at the specified index."},{name:"charCodeAt",type:"(index: number) => number",required:true,description:"Returns the Unicode value of the character at the specified location."},{name:"concat",type:"(...strings: string[]) => string",required:true,description:"Returns a string that contains the concatenation of two or more strings."},{name:"indexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the position of the first occurrence of a substring."},{name:"lastIndexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the last occurrence of a substring in the string."},{name:"localeCompare",type:"{ (that: string): number; (that: string, locales?: string | string[] | undefined, options?: CollatorOptions | undefined): number; (that: string, locales?: LocalesArgument, options?: CollatorOptions | undefined): number; }",required:true,description:`Determines whether two strings are equivalent in the current locale.
+Determines whether two strings are equivalent in the current or specified locale.`},{name:"match",type:"{ (regexp: string | RegExp): RegExpMatchArray | null; (matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null; }",required:true,description:`Matches a string with a regular expression, and returns an array containing the results of that search.
+Matches a string or an object that supports being matched against, and returns an array
+containing the results of that search, or null if no matches are found.`},{name:"replace",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; (searchValue: { ...; }, replaceValue: string): string; (searchValue: { ...; }, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replaces text in a string, using a regular expression or search string.\nPasses a string and {@linkcode replaceValue} to the `[Symbol.replace]` method on {@linkcode searchValue}. This method is expected to implement its own replacement algorithm.\nReplaces text in a string, using an object that supports replacement within a string."},{name:"search",type:"{ (regexp: string | RegExp): number; (searcher: { [Symbol.search](string: string): number; }): number; }",required:true,description:"Finds the first substring match in a regular expression search."},{name:"slice",type:"(start?: number | undefined, end?: number | undefined) => string",required:true,description:"Returns a section of a string."},{name:"split",type:"{ (separator: string | RegExp, limit?: number | undefined): string[]; (splitter: { [Symbol.split](string: string, limit?: number | undefined): string[]; }, limit?: number | undefined): string[]; }",required:true,description:"Split a string into substrings using the specified separator and return them as an array."},{name:"substring",type:"(start: number, end?: number | undefined) => string",required:true,description:"Returns the substring at the specified location within a String object."},{name:"toLowerCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to lowercase."},{name:"toLocaleLowerCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Converts all alphabetic characters to lowercase, taking into account the host environment's current locale."},{name:"toUpperCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to uppercase."},{name:"toLocaleUpperCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale."},{name:"trim",type:"() => string",required:true,description:"Removes the leading and trailing white space and line terminator characters from a string."},{name:"length",type:"number",required:true,description:"Returns the length of a String object."},{name:"substr",type:"(from: number, length?: number | undefined) => string",required:true,description:"Gets a substring beginning at the specified location and having the specified length."},{name:"valueOf",type:"() => string",required:true,description:"Returns the primitive value of the specified object."},{name:"codePointAt",type:"(pos: number) => number | undefined",required:true,description:`Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
+value of the UTF-16 encoded code point starting at the string element at position pos in
+the String resulting from converting this object to a String.
+If there is no element at that position, the result is undefined.
+If a valid UTF-16 surrogate pair does not begin at pos, the result is the code unit at pos.`},{name:"includes",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if searchString appears as a substring of the result of converting this
+object to a String, at one or more positions that are
+greater than or equal to position; otherwise, returns false.`},{name:"endsWith",type:"(searchString: string, endPosition?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+endPosition \u2013 length(this). Otherwise returns false.`},{name:"normalize",type:'{ (form: "NFC" | "NFD" | "NFKC" | "NFKD"): string; (form?: string | undefined): string; }',required:true,description:`Returns the String value result of normalizing the string into the normalization form
+named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.`},{name:"repeat",type:"(count: number) => string",required:true,description:`Returns a String value that is made from count copies appended together. If count is 0,
+the empty string is returned.`},{name:"startsWith",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+position. Otherwise returns false.`},{name:"anchor",type:"(name: string) => string",required:true,description:"Returns an `<a>` HTML anchor element and sets the name attribute to the text value"},{name:"big",type:"() => string",required:true,description:"Returns a `<big>` HTML element"},{name:"blink",type:"() => string",required:true,description:"Returns a `<blink>` HTML element"},{name:"bold",type:"() => string",required:true,description:"Returns a `<b>` HTML element"},{name:"fixed",type:"() => string",required:true,description:"Returns a `<tt>` HTML element"},{name:"fontcolor",type:"(color: string) => string",required:true,description:"Returns a `<font>` HTML element and sets the color attribute value"},{name:"fontsize",type:"{ (size: number): string; (size: string): string; }",required:true,description:"Returns a `<font>` HTML element and sets the size attribute value"},{name:"italics",type:"() => string",required:true,description:"Returns an `<i>` HTML element"},{name:"link",type:"(url: string) => string",required:true,description:"Returns an `<a>` HTML element and sets the href attribute value"},{name:"small",type:"() => string",required:true,description:"Returns a `<small>` HTML element"},{name:"strike",type:"() => string",required:true,description:"Returns a `<strike>` HTML element"},{name:"sub",type:"() => string",required:true,description:"Returns a `<sub>` HTML element"},{name:"sup",type:"() => string",required:true,description:"Returns a `<sup>` HTML element"},{name:"padStart",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the start (left) of the current string.`},{name:"padEnd",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the end (right) of the current string.`},{name:"trimEnd",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"trimStart",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimLeft",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimRight",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"matchAll",type:"(regexp: RegExp) => RegExpStringIterator<RegExpExecArray>",required:true,description:`Matches a string with a regular expression, and returns an iterable of matches
+containing the results of that search.`},{name:"replaceAll",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replace all instances of a substring in a string, using a regular expression or search string."},{name:"at",type:"(index: number) => string | undefined",required:true,description:"Returns a new String consisting of the single UTF-16 code unit located at the specified index."},{name:"__@iterator@16",type:"() => StringIterator<string>",required:true,description:"Iterator"}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-ingress-tag-headers-handler",body:['buildIngressTagHeadersHandler("${1:production}")$0'],description:"Build Ingress Tag Headers Handler"}},buildProjectIdHeadersHandler:{name:"buildProjectIdHeadersHandler",description:"Build a project identity header handler",params:[{name:"toString",type:"() => string",required:true,description:"Returns a string representation of a string."},{name:"charAt",type:"(pos: number) => string",required:true,description:"Returns the character at the specified index."},{name:"charCodeAt",type:"(index: number) => number",required:true,description:"Returns the Unicode value of the character at the specified location."},{name:"concat",type:"(...strings: string[]) => string",required:true,description:"Returns a string that contains the concatenation of two or more strings."},{name:"indexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the position of the first occurrence of a substring."},{name:"lastIndexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the last occurrence of a substring in the string."},{name:"localeCompare",type:"{ (that: string): number; (that: string, locales?: string | string[] | undefined, options?: CollatorOptions | undefined): number; (that: string, locales?: LocalesArgument, options?: CollatorOptions | undefined): number; }",required:true,description:`Determines whether two strings are equivalent in the current locale.
+Determines whether two strings are equivalent in the current or specified locale.`},{name:"match",type:"{ (regexp: string | RegExp): RegExpMatchArray | null; (matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null; }",required:true,description:`Matches a string with a regular expression, and returns an array containing the results of that search.
+Matches a string or an object that supports being matched against, and returns an array
+containing the results of that search, or null if no matches are found.`},{name:"replace",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; (searchValue: { ...; }, replaceValue: string): string; (searchValue: { ...; }, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replaces text in a string, using a regular expression or search string.\nPasses a string and {@linkcode replaceValue} to the `[Symbol.replace]` method on {@linkcode searchValue}. This method is expected to implement its own replacement algorithm.\nReplaces text in a string, using an object that supports replacement within a string."},{name:"search",type:"{ (regexp: string | RegExp): number; (searcher: { [Symbol.search](string: string): number; }): number; }",required:true,description:"Finds the first substring match in a regular expression search."},{name:"slice",type:"(start?: number | undefined, end?: number | undefined) => string",required:true,description:"Returns a section of a string."},{name:"split",type:"{ (separator: string | RegExp, limit?: number | undefined): string[]; (splitter: { [Symbol.split](string: string, limit?: number | undefined): string[]; }, limit?: number | undefined): string[]; }",required:true,description:"Split a string into substrings using the specified separator and return them as an array."},{name:"substring",type:"(start: number, end?: number | undefined) => string",required:true,description:"Returns the substring at the specified location within a String object."},{name:"toLowerCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to lowercase."},{name:"toLocaleLowerCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Converts all alphabetic characters to lowercase, taking into account the host environment's current locale."},{name:"toUpperCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to uppercase."},{name:"toLocaleUpperCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale."},{name:"trim",type:"() => string",required:true,description:"Removes the leading and trailing white space and line terminator characters from a string."},{name:"length",type:"number",required:true,description:"Returns the length of a String object."},{name:"substr",type:"(from: number, length?: number | undefined) => string",required:true,description:"Gets a substring beginning at the specified location and having the specified length."},{name:"valueOf",type:"() => string",required:true,description:"Returns the primitive value of the specified object."},{name:"codePointAt",type:"(pos: number) => number | undefined",required:true,description:`Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
+value of the UTF-16 encoded code point starting at the string element at position pos in
+the String resulting from converting this object to a String.
+If there is no element at that position, the result is undefined.
+If a valid UTF-16 surrogate pair does not begin at pos, the result is the code unit at pos.`},{name:"includes",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if searchString appears as a substring of the result of converting this
+object to a String, at one or more positions that are
+greater than or equal to position; otherwise, returns false.`},{name:"endsWith",type:"(searchString: string, endPosition?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+endPosition \u2013 length(this). Otherwise returns false.`},{name:"normalize",type:'{ (form: "NFC" | "NFD" | "NFKC" | "NFKD"): string; (form?: string | undefined): string; }',required:true,description:`Returns the String value result of normalizing the string into the normalization form
+named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.`},{name:"repeat",type:"(count: number) => string",required:true,description:`Returns a String value that is made from count copies appended together. If count is 0,
+the empty string is returned.`},{name:"startsWith",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+position. Otherwise returns false.`},{name:"anchor",type:"(name: string) => string",required:true,description:"Returns an `<a>` HTML anchor element and sets the name attribute to the text value"},{name:"big",type:"() => string",required:true,description:"Returns a `<big>` HTML element"},{name:"blink",type:"() => string",required:true,description:"Returns a `<blink>` HTML element"},{name:"bold",type:"() => string",required:true,description:"Returns a `<b>` HTML element"},{name:"fixed",type:"() => string",required:true,description:"Returns a `<tt>` HTML element"},{name:"fontcolor",type:"(color: string) => string",required:true,description:"Returns a `<font>` HTML element and sets the color attribute value"},{name:"fontsize",type:"{ (size: number): string; (size: string): string; }",required:true,description:"Returns a `<font>` HTML element and sets the size attribute value"},{name:"italics",type:"() => string",required:true,description:"Returns an `<i>` HTML element"},{name:"link",type:"(url: string) => string",required:true,description:"Returns an `<a>` HTML element and sets the href attribute value"},{name:"small",type:"() => string",required:true,description:"Returns a `<small>` HTML element"},{name:"strike",type:"() => string",required:true,description:"Returns a `<strike>` HTML element"},{name:"sub",type:"() => string",required:true,description:"Returns a `<sub>` HTML element"},{name:"sup",type:"() => string",required:true,description:"Returns a `<sup>` HTML element"},{name:"padStart",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the start (left) of the current string.`},{name:"padEnd",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the end (right) of the current string.`},{name:"trimEnd",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"trimStart",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimLeft",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimRight",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"matchAll",type:"(regexp: RegExp) => RegExpStringIterator<RegExpExecArray>",required:true,description:`Matches a string with a regular expression, and returns an iterable of matches
+containing the results of that search.`},{name:"replaceAll",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replace all instances of a substring in a string, using a regular expression or search string."},{name:"at",type:"(index: number) => string | undefined",required:true,description:"Returns a new String consisting of the single UTF-16 code unit located at the specified index."},{name:"__@iterator@16",type:"() => StringIterator<string>",required:true,description:"Iterator"}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-project-id-headers-handler",body:['buildProjectIdHeadersHandler("${1:my-project}")$0'],description:"Build Project Id Headers Handler"}},buildIframeHeadersHandler:{name:"buildIframeHeadersHandler",description:"Build CORS/CSP headers for iframe embedding\n\n`allowedOrigin` is a CSP `frame-ancestors` source list: one source or\nseveral, space-separated, wildcards allowed. CORS headers are added only\nwhen it is `*` or one exact origin, because `Access-Control-Allow-Origin`\ntakes nothing else; a list there is invalid, and a browser rejects it.",params:[{name:"toString",type:"() => string",required:true,description:"Returns a string representation of a string."},{name:"charAt",type:"(pos: number) => string",required:true,description:"Returns the character at the specified index."},{name:"charCodeAt",type:"(index: number) => number",required:true,description:"Returns the Unicode value of the character at the specified location."},{name:"concat",type:"(...strings: string[]) => string",required:true,description:"Returns a string that contains the concatenation of two or more strings."},{name:"indexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the position of the first occurrence of a substring."},{name:"lastIndexOf",type:"(searchString: string, position?: number | undefined) => number",required:true,description:"Returns the last occurrence of a substring in the string."},{name:"localeCompare",type:"{ (that: string): number; (that: string, locales?: string | string[] | undefined, options?: CollatorOptions | undefined): number; (that: string, locales?: LocalesArgument, options?: CollatorOptions | undefined): number; }",required:true,description:`Determines whether two strings are equivalent in the current locale.
+Determines whether two strings are equivalent in the current or specified locale.`},{name:"match",type:"{ (regexp: string | RegExp): RegExpMatchArray | null; (matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null; }",required:true,description:`Matches a string with a regular expression, and returns an array containing the results of that search.
+Matches a string or an object that supports being matched against, and returns an array
+containing the results of that search, or null if no matches are found.`},{name:"replace",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; (searchValue: { ...; }, replaceValue: string): string; (searchValue: { ...; }, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replaces text in a string, using a regular expression or search string.\nPasses a string and {@linkcode replaceValue} to the `[Symbol.replace]` method on {@linkcode searchValue}. This method is expected to implement its own replacement algorithm.\nReplaces text in a string, using an object that supports replacement within a string."},{name:"search",type:"{ (regexp: string | RegExp): number; (searcher: { [Symbol.search](string: string): number; }): number; }",required:true,description:"Finds the first substring match in a regular expression search."},{name:"slice",type:"(start?: number | undefined, end?: number | undefined) => string",required:true,description:"Returns a section of a string."},{name:"split",type:"{ (separator: string | RegExp, limit?: number | undefined): string[]; (splitter: { [Symbol.split](string: string, limit?: number | undefined): string[]; }, limit?: number | undefined): string[]; }",required:true,description:"Split a string into substrings using the specified separator and return them as an array."},{name:"substring",type:"(start: number, end?: number | undefined) => string",required:true,description:"Returns the substring at the specified location within a String object."},{name:"toLowerCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to lowercase."},{name:"toLocaleLowerCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Converts all alphabetic characters to lowercase, taking into account the host environment's current locale."},{name:"toUpperCase",type:"() => string",required:true,description:"Converts all the alphabetic characters in a string to uppercase."},{name:"toLocaleUpperCase",type:"{ (locales?: string | string[] | undefined): string; (locales?: LocalesArgument): string; }",required:true,description:"Returns a string where all alphabetic characters have been converted to uppercase, taking into account the host environment's current locale."},{name:"trim",type:"() => string",required:true,description:"Removes the leading and trailing white space and line terminator characters from a string."},{name:"length",type:"number",required:true,description:"Returns the length of a String object."},{name:"substr",type:"(from: number, length?: number | undefined) => string",required:true,description:"Gets a substring beginning at the specified location and having the specified length."},{name:"valueOf",type:"() => string",required:true,description:"Returns the primitive value of the specified object."},{name:"codePointAt",type:"(pos: number) => number | undefined",required:true,description:`Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
+value of the UTF-16 encoded code point starting at the string element at position pos in
+the String resulting from converting this object to a String.
+If there is no element at that position, the result is undefined.
+If a valid UTF-16 surrogate pair does not begin at pos, the result is the code unit at pos.`},{name:"includes",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if searchString appears as a substring of the result of converting this
+object to a String, at one or more positions that are
+greater than or equal to position; otherwise, returns false.`},{name:"endsWith",type:"(searchString: string, endPosition?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+endPosition \u2013 length(this). Otherwise returns false.`},{name:"normalize",type:'{ (form: "NFC" | "NFD" | "NFKC" | "NFKD"): string; (form?: string | undefined): string; }',required:true,description:`Returns the String value result of normalizing the string into the normalization form
+named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.`},{name:"repeat",type:"(count: number) => string",required:true,description:`Returns a String value that is made from count copies appended together. If count is 0,
+the empty string is returned.`},{name:"startsWith",type:"(searchString: string, position?: number | undefined) => boolean",required:true,description:`Returns true if the sequence of elements of searchString converted to a String is the
+same as the corresponding elements of this object (converted to a String) starting at
+position. Otherwise returns false.`},{name:"anchor",type:"(name: string) => string",required:true,description:"Returns an `<a>` HTML anchor element and sets the name attribute to the text value"},{name:"big",type:"() => string",required:true,description:"Returns a `<big>` HTML element"},{name:"blink",type:"() => string",required:true,description:"Returns a `<blink>` HTML element"},{name:"bold",type:"() => string",required:true,description:"Returns a `<b>` HTML element"},{name:"fixed",type:"() => string",required:true,description:"Returns a `<tt>` HTML element"},{name:"fontcolor",type:"(color: string) => string",required:true,description:"Returns a `<font>` HTML element and sets the color attribute value"},{name:"fontsize",type:"{ (size: number): string; (size: string): string; }",required:true,description:"Returns a `<font>` HTML element and sets the size attribute value"},{name:"italics",type:"() => string",required:true,description:"Returns an `<i>` HTML element"},{name:"link",type:"(url: string) => string",required:true,description:"Returns an `<a>` HTML element and sets the href attribute value"},{name:"small",type:"() => string",required:true,description:"Returns a `<small>` HTML element"},{name:"strike",type:"() => string",required:true,description:"Returns a `<strike>` HTML element"},{name:"sub",type:"() => string",required:true,description:"Returns a `<sub>` HTML element"},{name:"sup",type:"() => string",required:true,description:"Returns a `<sup>` HTML element"},{name:"padStart",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the start (left) of the current string.`},{name:"padEnd",type:"(maxLength: number, fillString?: string | undefined) => string",required:true,description:`Pads the current string with a given string (possibly repeated) so that the resulting string reaches a given length.
+The padding is applied from the end (right) of the current string.`},{name:"trimEnd",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"trimStart",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimLeft",type:"() => string",required:true,description:"Removes the leading white space and line terminator characters from a string."},{name:"trimRight",type:"() => string",required:true,description:"Removes the trailing white space and line terminator characters from a string."},{name:"matchAll",type:"(regexp: RegExp) => RegExpStringIterator<RegExpExecArray>",required:true,description:`Matches a string with a regular expression, and returns an iterable of matches
+containing the results of that search.`},{name:"replaceAll",type:"{ (searchValue: string | RegExp, replaceValue: string): string; (searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string; }",required:true,description:"Replace all instances of a substring in a string, using a regular expression or search string."},{name:"at",type:"(index: number) => string | undefined",required:true,description:"Returns a new String consisting of the single UTF-16 code unit located at the specified index."},{name:"__@iterator@16",type:"() => StringIterator<string>",required:true,description:"Iterator"}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-iframe-headers-handler",body:['buildIframeHeadersHandler("${1:*}")$0'],description:"Build Iframe Headers Handler"}},buildRedirectRoute:{name:"buildRedirectRoute",description:"Build a redirect route for domain redirects (www <-> non-www)",params:[{name:"fromHost",type:"string",required:true,description:""},{name:"toHost",type:"string",required:true,description:""},{name:"permanent",type:"boolean",required:false,description:""},{name:"statusCode",type:"301 | 302 | 307 | 308",required:false,description:""},{name:"id",type:"string",required:false,description:""}],returnType:"CaddyRoute",snippet:{prefix:"caddy-redirect-route",body:["buildRedirectRoute({",'  fromHost: "${1:example.com}",','  toHost: "${2:example.com}",',"  // optional: permanent, statusCode, id","})$0"],description:"Build Redirect Route"}},buildCompressionHandler:{name:"buildCompressionHandler",description:`Build a compression (encode) handler
+Supports gzip, zstd, and brotli compression`,params:[{name:"gzip",type:"boolean",required:false,description:""},{name:"zstd",type:"boolean",required:false,description:""},{name:"brotli",type:"boolean",required:false,description:""}],returnType:"CaddyRouteHandler",snippet:{prefix:"caddy-compression-handler",body:["buildCompressionHandler({","  gzip: ${1|true,false|},","  zstd: ${2|true,false|},","  brotli: ${3|true,false|},","})$0"],description:"Build Compression Handler"}},buildWwwRedirect:{name:"buildWwwRedirect",description:`Build a WWW redirect route (www.example.com \u2194 example.com)
 
 Common patterns:
 - "www-to-domain": www.example.com \u2192 example.com
-- "domain-to-www": example.com \u2192 www.example.com`,params:[],returnType:"CaddyRoute",example:`// Redirect www.example.com \u2192 example.com
+- "domain-to-www": example.com \u2192 www.example.com`,params:[{name:"domain",type:"string",required:true,description:""},{name:"mode",type:'"www-to-domain" | "domain-to-www"',required:true,description:""},{name:"permanent",type:"boolean",required:false,description:""},{name:"priority",type:"number",required:false,description:""}],returnType:"CaddyRoute",example:`// Redirect www.example.com \u2192 example.com
 const route = buildWwwRedirect({
   domain: "example.com",
   mode: "www-to-domain",
   permanent: true
-});`,snippet:{prefix:"caddy-www-redirect",body:["buildWwwRedirect({","})"],description:"Build Www Redirect"}},buildMitmproxyRoute:{name:"buildMitmproxyRoute",description:`Build a route that forwards traffic through MITMproxy for inspection
+});`,snippet:{prefix:"caddy-www-redirect",body:["buildWwwRedirect({",'  domain: "${1:example.com}",','  mode: "${2|www-to-domain,domain-to-www|}",',"  // optional: permanent, priority","})$0"],description:"Build Www Redirect"}},buildMitmproxyRoute:{name:"buildMitmproxyRoute",description:`Build a route that forwards traffic through MITMproxy for inspection
 
 This is a convenience function that creates a route pointing to a MITMproxy
 instance running in reverse proxy mode. Use this to transparently intercept
-and inspect HTTP traffic for debugging without modifying client or backend code.`,params:[],returnType:"CaddyRoute",example:`// Route traffic for api.example.com through MITMproxy
+and inspect HTTP traffic for debugging without modifying client or backend code.`,params:[{name:"host",type:"string",required:true,description:'Host pattern to match (e.g., "api.example.com")'},{name:"mitmproxyHost",type:"string",required:true,description:'MITMproxy host (e.g., "localhost" or "mitmproxy-container")'},{name:"mitmproxyPort",type:"number",required:false,description:"MITMproxy proxy port (default: 8080)"},{name:"backendHost",type:"string",required:false,description:"Backend host that MITMproxy should forward to (optional, for documentation)"},{name:"backendPort",type:"number",required:false,description:"Backend port that MITMproxy should forward to (optional, for documentation)"},{name:"id",type:"string",required:false,description:"Route ID for Caddy (optional)"},{name:"priority",type:"number",required:false,description:"Route priority (optional)"}],returnType:"CaddyRoute",example:`// Route traffic for api.example.com through MITMproxy
 const route = buildMitmproxyRoute({
   host: "api.example.com",
   mitmproxyHost: "localhost",
   mitmproxyPort: 8080,
 });
-await client.addRoute("https_server", route, "api_debug");`,snippet:{prefix:"caddy-mitmproxy-route",body:["buildMitmproxyRoute({","})"],description:"Build Mitmproxy Route"}},buildMitmproxyRoutePair:{name:"buildMitmproxyRoutePair",description:`Create a hot-swappable route pair for enabling/disabling MITMproxy interception
+await client.addRoute("https_server", route, "api_debug");`,snippet:{prefix:"caddy-mitmproxy-route",body:["buildMitmproxyRoute({",'  host: "${1:example.com}",','  mitmproxyHost: "${2:example.com}",',"  // optional: mitmproxyPort, backendHost, backendPort, id, priority","})$0"],description:"Build Mitmproxy Route"}},buildMitmproxyRoutePair:{name:"buildMitmproxyRoutePair",description:`Create a hot-swappable route pair for enabling/disabling MITMproxy interception
 
 Returns both a direct route and a MITMproxy-intercepted route with the same ID.
-Use this to easily toggle between direct and intercepted traffic at runtime.`,params:[],returnType:`{
+Use this to easily toggle between direct and intercepted traffic at runtime.`,params:[{name:"host",type:"string",required:true,description:"Host pattern to match"},{name:"backendHost",type:"string",required:true,description:"Backend service host"},{name:"backendPort",type:"number",required:true,description:"Backend service port"},{name:"mitmproxyHost",type:"string",required:true,description:"MITMproxy host"},{name:"mitmproxyPort",type:"number",required:false,description:"MITMproxy proxy port (default: 8080)"},{name:"routeId",type:"string",required:true,description:"Route ID (used for both routes)"},{name:"priority",type:"number",required:false,description:"Route priority (optional)"}],returnType:`{
   /** Direct route (Client \u2192 Caddy \u2192 Backend) */
   direct: CaddyRoute;
   /** Proxied route (Client \u2192 Caddy \u2192 MITMproxy \u2192 Backend) */
@@ -200,7 +295,7 @@ await client.addRoute("https_server", routes.proxied, routes.proxied["@id"]);
 
 // Hot-swap back to direct (disable interception)
 await client.removeRouteById("https_server", routes.proxied["@id"]);
-await client.addRoute("https_server", routes.direct, routes.direct["@id"]);`,snippet:{prefix:"caddy-mitmproxy-route-pair",body:["buildMitmproxyRoutePair({","})"],description:"Build Mitmproxy Route Pair"}},buildIframeProxyRoute:{name:"buildIframeProxyRoute",description:`Build a route for proxying a web UI with iframe embedding support
+await client.addRoute("https_server", routes.direct, routes.direct["@id"]);`,snippet:{prefix:"caddy-mitmproxy-route-pair",body:["buildMitmproxyRoutePair({",'  host: "${1:example.com}",','  backendHost: "${2:example.com}",',"  backendPort: ${3:3000},",'  mitmproxyHost: "${4:example.com}",','  routeId: "${5:my-id}",',"  // optional: mitmproxyPort, priority","})$0"],description:"Build Mitmproxy Route Pair"}},buildIframeProxyRoute:{name:"buildIframeProxyRoute",description:`Build a route for proxying a web UI with iframe embedding support
 
 This creates a route that proxies a web interface and optionally adds
 headers to allow embedding in iframes. Can also override Host/Origin
@@ -218,7 +313,7 @@ const mitmRoute = buildIframeProxyRoute({
   upstreamHost: "mitmproxy",
   upstreamPort: 8081,
   overrideHost: "127.0.0.1:8081",
-});`,snippet:{prefix:"caddy-iframe-proxy-route",body:["buildIframeProxyRoute({",'  pathPrefix: ${1:""},','  upstreamHost: ${2:""},',"  upstreamPort: ${3:0},","})"],description:"Build Iframe Proxy Route"}},buildMitmproxyWebUiRoute:{name:"buildMitmproxyWebUiRoute",description:"",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-mitmproxy-web-ui-route",body:["buildMitmproxyWebUiRoute({","})"],description:"Build Mitmproxy Web Ui Route"}},buildWebSocketProxyRoute:{name:"buildWebSocketProxyRoute",description:`Build a route for WebSocket proxy
+});`,snippet:{prefix:"caddy-iframe-proxy-route",body:["buildIframeProxyRoute({",'  pathPrefix: "${1:/app}",','  upstreamHost: "${2:localhost}",',"  upstreamPort: ${3:3000},","  // optional: routeId, iframeEmbed, overrideHost","})$0"],description:"Build Iframe Proxy Route"}},buildMitmproxyWebUiRoute:{name:"buildMitmproxyWebUiRoute",description:"",params:[{name:"pathPrefix",type:"string",required:true,description:""},{name:"mitmproxyHost",type:"string",required:true,description:""},{name:"mitmproxyWebPort",type:"number",required:false,description:""},{name:"routeId",type:"string",required:false,description:""},{name:"iframeEmbed",type:"boolean",required:false,description:""}],returnType:"CaddyRoute",snippet:{prefix:"caddy-mitmproxy-web-ui-route",body:["buildMitmproxyWebUiRoute({",'  pathPrefix: "${1:/app}",','  mitmproxyHost: "${2:example.com}",',"  // optional: mitmproxyWebPort, routeId, iframeEmbed","})$0"],description:"Build Mitmproxy Web Ui Route"}},buildWebSocketProxyRoute:{name:"buildWebSocketProxyRoute",description:`Build a route for WebSocket proxy
 
 This creates a route that proxies WebSocket connections to an upstream
 service. Can optionally override Host/Origin headers for services
@@ -235,16 +330,16 @@ const mitmRoute = buildWebSocketProxyRoute({
   upstreamHost: "mitmproxy",
   upstreamPort: 8081,
   overrideHost: "127.0.0.1:8081",
-});`,snippet:{prefix:"caddy-web-socket-proxy-route",body:["buildWebSocketProxyRoute({","  path: ${1:/etc/caddy/config.json},",'  upstreamHost: ${2:""},',"  upstreamPort: ${3:0},","})"],description:"Build Web Socket Proxy Route"}},buildMitmproxyWebSocketRoute:{name:"buildMitmproxyWebSocketRoute",description:"",params:[],returnType:"CaddyRoute",snippet:{prefix:"caddy-mitmproxy-web-socket-route",body:["buildMitmproxyWebSocketRoute({","})"],description:"Build Mitmproxy Web Socket Route"}},buildIframePermissiveHandler:{name:"buildIframePermissiveHandler",description:`Build a header handler that removes restrictive headers for iframe embedding
+});`,snippet:{prefix:"caddy-web-socket-proxy-route",body:["buildWebSocketProxyRoute({",'  path: "${1:/api/*}",','  upstreamHost: "${2:localhost}",',"  upstreamPort: ${3:3000},","  // optional: routeId, overrideHost","})$0"],description:"Build Web Socket Proxy Route"}},buildMitmproxyWebSocketRoute:{name:"buildMitmproxyWebSocketRoute",description:"",params:[{name:"path",type:"string",required:false,description:""},{name:"mitmproxyHost",type:"string",required:true,description:""},{name:"mitmproxyWebPort",type:"number",required:false,description:""},{name:"routeId",type:"string",required:false,description:""}],returnType:"CaddyRoute",snippet:{prefix:"caddy-mitmproxy-web-socket-route",body:["buildMitmproxyWebSocketRoute({",'  mitmproxyHost: "${1:example.com}",',"  // optional: path, mitmproxyWebPort, routeId","})$0"],description:"Build Mitmproxy Web Socket Route"}},buildIframePermissiveHandler:{name:"buildIframePermissiveHandler",description:`Build a header handler that removes restrictive headers for iframe embedding
 
 Removes X-Frame-Options, Content-Security-Policy, and X-Xss-Protection
-headers while adding permissive CORS and frame-ancestors headers.`,params:[],returnType:"CaddyRouteHandler",example:`const handler = buildIframePermissiveHandler();
-// Use in a route's handle array`,snippet:{prefix:"caddy-iframe-permissive-handler",body:["buildIframePermissiveHandler({","})"],description:"Build Iframe Permissive Handler"}},buildDnsRebindingBypassHandler:{name:"buildDnsRebindingBypassHandler",description:`Build a header handler for DNS rebinding bypass
+headers while adding permissive CORS and frame-ancestors headers.`,params:[{name:"deleteHeaders",type:"string[]",required:false,description:'Headers to delete (default: ["X-Frame-Options", "Content-Security-Policy", "X-Xss-Protection"])'},{name:"corsOrigin",type:"string",required:false,description:'CORS origin (default: "*")'}],returnType:"CaddyRouteHandler",example:`const handler = buildIframePermissiveHandler();
+// Use in a route's handle array`,snippet:{prefix:"caddy-iframe-permissive-handler",body:["buildIframePermissiveHandler({",'  deleteHeaders: ["${1:deleteHeader}"],','  corsOrigin: "${2:corsOrigin}",',"})$0"],description:"Build Iframe Permissive Handler"}},buildDnsRebindingBypassHandler:{name:"buildDnsRebindingBypassHandler",description:`Build a header handler for DNS rebinding bypass
 
 Sets Host and Origin headers to bypass MITMproxy's DNS rebinding protection.
-Use this when proxying to MITMproxy from a different hostname.`,params:[],returnType:"CaddyRouteHandler",example:`const handler = buildDnsRebindingBypassHandler({
+Use this when proxying to MITMproxy from a different hostname.`,params:[{name:"targetHost",type:"string",required:true,description:'Target host:port (e.g., "127.0.0.1:8081")'}],returnType:"CaddyRouteHandler",example:`const handler = buildDnsRebindingBypassHandler({
   targetHost: "127.0.0.1:8081",
-});`,snippet:{prefix:"caddy-dns-rebinding-bypass-handler",body:["buildDnsRebindingBypassHandler({","})"],description:"Build Dns Rebinding Bypass Handler"}},buildFileServerRoute:{name:"buildFileServerRoute",description:"Build a file server route for serving static files",params:[{name:"path",type:"string",required:true,description:'Path prefix to match (e.g., "/static/*")'},{name:"root",type:"string",required:true,description:"Root directory to serve files from"},{name:"browse",type:"boolean",required:false,description:"Enable directory browsing"},{name:"browseTemplate",type:"string",required:false,description:"Custom browse template file path"},{name:"hidePatterns",type:"string[]",required:false,description:'File patterns to hide (e.g., [".git", ".env"])'},{name:"indexNames",type:"string[]",required:false,description:'Index file names (default: ["index.html"])'},{name:"precompressed",type:"boolean",required:false,description:"Enable precompressed file support (gzip, brotli)"},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Basic static file serving
+});`,snippet:{prefix:"caddy-dns-rebinding-bypass-handler",body:["buildDnsRebindingBypassHandler({",'  targetHost: "${1:example.com}",',"})$0"],description:"Build Dns Rebinding Bypass Handler"}},buildFileServerRoute:{name:"buildFileServerRoute",description:"Build a file server route for serving static files",params:[{name:"path",type:"string",required:true,description:'Path prefix to match (e.g., "/static/*")'},{name:"root",type:"string",required:true,description:"Root directory to serve files from"},{name:"browse",type:"boolean",required:false,description:"Enable directory browsing"},{name:"browseTemplate",type:"string",required:false,description:"Custom browse template file path"},{name:"hidePatterns",type:"string[]",required:false,description:'File patterns to hide (e.g., [".git", ".env"])'},{name:"indexNames",type:"string[]",required:false,description:'Index file names (default: ["index.html"])'},{name:"precompressed",type:"boolean",required:false,description:"Enable precompressed file support (gzip, brotli)"},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Basic static file serving
 const route = buildFileServerRoute({
   path: "/static/*",
   root: "/var/www/static",
@@ -257,7 +352,7 @@ const route = buildFileServerRoute({
   browse: true,
   hidePatterns: [".git", ".env", "*.secret"],
   precompressed: true,
-});`,snippet:{prefix:"caddy-file-server-route",body:["buildFileServerRoute({","  path: ${1:/etc/caddy/config.json},",'  root: ${2:""},',"})"],description:"Build File Server Route"}},buildTemplatesRoute:{name:"buildTemplatesRoute",description:"Build a templates route for server-side template rendering",params:[{name:"path",type:"string",required:true,description:'Path prefix to match (e.g., "/*.html")'},{name:"fileRoot",type:"string",required:true,description:"Root directory for template files"},{name:"mimeTypes",type:"string[]",required:false,description:"MIME types to process as templates"},{name:"delimiters",type:"[string, string]",required:false,description:'Custom delimiters (default: ["{{", "}}"])'},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Process HTML files as templates
+});`,snippet:{prefix:"caddy-file-server-route",body:["buildFileServerRoute({",'  path: "${1:/api/*}",','  root: "${2:/var/www/html}",',"  // optional: browse, browseTemplate, hidePatterns, indexNames, precompressed, id, ...","})$0"],description:"Build File Server Route"}},buildTemplatesRoute:{name:"buildTemplatesRoute",description:"Build a templates route for server-side template rendering",params:[{name:"path",type:"string",required:true,description:'Path prefix to match (e.g., "/*.html")'},{name:"fileRoot",type:"string",required:true,description:"Root directory for template files"},{name:"mimeTypes",type:"string[]",required:false,description:"MIME types to process as templates"},{name:"delimiters",type:"[string, string]",required:false,description:'Custom delimiters (default: ["{{", "}}"])'},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Process HTML files as templates
 const route = buildTemplatesRoute({
   path: "/*.html",
   fileRoot: "/var/www/templates",
@@ -269,7 +364,7 @@ const route = buildTemplatesRoute({
   path: "/*.tmpl",
   fileRoot: "/templates",
   delimiters: ["<%", "%>"],
-});`,snippet:{prefix:"caddy-templates-route",body:["buildTemplatesRoute({","  path: ${1:/etc/caddy/config.json},",'  fileRoot: ${2:""},',"})"],description:"Build Templates Route"}},buildErrorRoute:{name:"buildErrorRoute",description:"Build an error route that returns a static error response",params:[{name:"match",type:"{ path?: string[]; host?: string[] }",required:false,description:"Route matchers (optional, applies to all requests if not specified)"},{name:"statusCode",type:"number",required:true,description:"HTTP status code"},{name:"message",type:"string",required:false,description:"Error message body"},{name:"headers",type:"Record<string, string[]>",required:false,description:"Custom headers to include"},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Simple 404 handler
+});`,snippet:{prefix:"caddy-templates-route",body:["buildTemplatesRoute({",'  path: "${1:/api/*}",','  fileRoot: "${2:/var/www/html}",',"  // optional: mimeTypes, delimiters, id, priority","})$0"],description:"Build Templates Route"}},buildErrorRoute:{name:"buildErrorRoute",description:"Build an error route that returns a static error response",params:[{name:"match",type:"{ path?: string[]; host?: string[] }",required:false,description:"Route matchers (optional, applies to all requests if not specified)"},{name:"statusCode",type:"number",required:true,description:"HTTP status code"},{name:"message",type:"string",required:false,description:"Error message body"},{name:"headers",type:"Record<string, string[]>",required:false,description:"Custom headers to include"},{name:"id",type:"string",required:false,description:"Route ID"},{name:"priority",type:"number",required:false,description:"Route priority"}],returnType:"CaddyRoute",example:`// Simple 404 handler
 const route = buildErrorRoute({
   statusCode: 404,
   message: "Page not found",
@@ -281,15 +376,15 @@ const route = buildErrorRoute({
   statusCode: 500,
   message: '{"error":"Internal server error"}',
   headers: { "Content-Type": ["application/json"] },
-});`,snippet:{prefix:"caddy-error-route",body:["buildErrorRoute({","  statusCode: ${1:0},","})"],description:"Build Error Route"}},buildRequestBodyHandler:{name:"buildRequestBodyHandler",description:"Build a request body handler for limiting request body size",params:[{name:"maxSize",type:"number",required:true,description:"Maximum request body size in bytes"}],returnType:"CaddyRouteHandler",example:`// Limit request body to 10MB
-const handler = buildRequestBodyHandler({ maxSize: 10 * 1024 * 1024 });`,snippet:{prefix:"caddy-request-body-handler",body:["buildRequestBodyHandler({","  maxSize: ${1:0}","})"],description:"Build Request Body Handler"}},buildVarsHandler:{name:"buildVarsHandler",description:"Build a vars handler for setting request variables",params:[{name:"vars",type:"Record<string, string>",required:true,description:"Variables to set (key-value pairs)"}],returnType:"CaddyRouteHandler",example:`// Set custom variables for downstream handlers
+});`,snippet:{prefix:"caddy-error-route",body:["buildErrorRoute({","  statusCode: ${1:404},","  // optional: match, message, headers, id, priority","})$0"],description:"Build Error Route"}},buildRequestBodyHandler:{name:"buildRequestBodyHandler",description:"Build a request body handler for limiting request body size",params:[{name:"maxSize",type:"number",required:true,description:"Maximum request body size in bytes"}],returnType:"CaddyRouteHandler",example:`// Limit request body to 10MB
+const handler = buildRequestBodyHandler({ maxSize: 10 * 1024 * 1024 });`,snippet:{prefix:"caddy-request-body-handler",body:["buildRequestBodyHandler({","  maxSize: ${1:10485760},","})$0"],description:"Build Request Body Handler"}},buildVarsHandler:{name:"buildVarsHandler",description:"Build a vars handler for setting request variables",params:[{name:"vars",type:"Record<string, string>",required:true,description:"Variables to set (key-value pairs)"}],returnType:"CaddyRouteHandler",example:`// Set custom variables for downstream handlers
 const handler = buildVarsHandler({
   vars: {
     root: "/var/www",
     backend: "api-server",
     environment: "production",
   }
-});`,snippet:{prefix:"caddy-vars-handler",body:["buildVarsHandler({",'  vars: ${1:""}',"})"],description:"Build Vars Handler"}},buildTracingHandler:{name:"buildTracingHandler",description:"Build a tracing handler for distributed tracing",params:[{name:"span",type:"string",required:false,description:"Span name for tracing"}],returnType:"CaddyRouteHandler",example:'const handler = buildTracingHandler({ span: "http.request" });',snippet:{prefix:"caddy-tracing-handler",body:["buildTracingHandler({","})"],description:"Build Tracing Handler"}},buildMapHandler:{name:"buildMapHandler",description:"Build a map handler for variable mapping",params:[{name:"source",type:"string",required:true,description:'Source placeholder (e.g., "{http.request.uri.path}")'},{name:"destinations",type:"string[]",required:true,description:'Destination placeholder names (e.g., ["{my_var}"])'},{name:"mappings",type:"{ input: string; outputs: string[] }[]",required:true,description:"Mappings from input patterns to outputs"},{name:"defaults",type:"string[]",required:false,description:"Default outputs if no mappings match"}],returnType:"CaddyRouteHandler",example:`// Map request paths to backend names
+});`,snippet:{prefix:"caddy-vars-handler",body:["buildVarsHandler({","  vars: {},","})$0"],description:"Build Vars Handler"}},buildTracingHandler:{name:"buildTracingHandler",description:"Build a tracing handler for distributed tracing",params:[{name:"span",type:"string",required:false,description:"Span name for tracing"}],returnType:"CaddyRouteHandler",example:'const handler = buildTracingHandler({ span: "http.request" });',snippet:{prefix:"caddy-tracing-handler",body:["buildTracingHandler({",'  span: "${1:span}",',"})$0"],description:"Build Tracing Handler"}},buildMapHandler:{name:"buildMapHandler",description:"Build a map handler for variable mapping",params:[{name:"source",type:"string",required:true,description:'Source placeholder (e.g., "{http.request.uri.path}")'},{name:"destinations",type:"string[]",required:true,description:'Destination placeholder names (e.g., ["{my_var}"])'},{name:"mappings",type:"{ input: string; outputs: string[] }[]",required:true,description:"Mappings from input patterns to outputs"},{name:"defaults",type:"string[]",required:false,description:"Default outputs if no mappings match"}],returnType:"CaddyRouteHandler",example:`// Map request paths to backend names
 const handler = buildMapHandler({
   source: "{http.request.uri.path}",
   destinations: ["{backend}"],
@@ -298,5 +393,5 @@ const handler = buildMapHandler({
     { input: "/admin/*", outputs: ["admin-server"] },
   ],
   defaults: ["default-server"],
-});`,snippet:{prefix:"caddy-map-handler",body:["buildMapHandler({",'  source: ${1:""},','  destinations: ${2:["value"]},','  mappings: ${3:["value"]},',"})"],description:"Build Map Handler"}}},i={authenticator:{name:"authenticator",displayName:"Authenticator (caddy-security)",description:"Serve authentication portal for caddy-security plugin",discriminator:"authenticator",commonFields:["portal_name","route_matcher"],caddyDocsPath:"https://github.com/greenpau/caddy-security"},authentication:{name:"authentication",displayName:"Authentication",description:"HTTP Basic authentication or custom auth providers",discriminator:"authentication",commonFields:["providers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/authentication/"},reverse_proxy:{name:"reverse_proxy",displayName:"Reverse Proxy",description:"Proxy requests to upstream backend servers with load balancing",discriminator:"reverse_proxy",commonFields:["upstreams","transport","load_balancing","health_checks","headers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/reverse_proxy/"},headers:{name:"headers",displayName:"Headers",description:"Modify request and response headers",discriminator:"headers",commonFields:["request","response"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/headers/"},static_response:{name:"static_response",displayName:"Static Response",description:"Return a static response without proxying",discriminator:"static_response",commonFields:["status_code","body","headers","close","abort"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/static_response/"},rewrite:{name:"rewrite",displayName:"Rewrite",description:"Rewrite the request URI before processing",discriminator:"rewrite",commonFields:["uri","strip_path_prefix","strip_path_suffix","uri_substring"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/rewrite/"},encode:{name:"encode",displayName:"Encode",description:"Compress responses with gzip, zstd, or brotli",discriminator:"encode",commonFields:["encodings","prefer","minimum_length"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/encode/"},subroute:{name:"subroute",displayName:"Subroute",description:"Process requests through nested routes",discriminator:"subroute",commonFields:["routes"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/subroute/"},file_server:{name:"file_server",displayName:"File Server",description:"Serve static files from disk",discriminator:"file_server",commonFields:["root","index_names","browse","hide"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/file_server/"},templates:{name:"templates",displayName:"Templates",description:"Render Go templates in responses",discriminator:"templates",commonFields:["file_root","mime_types","delimiters"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/templates/"},map:{name:"map",displayName:"Map",description:"Map input to output values for use in other handlers",discriminator:"map",commonFields:["source","destinations","mappings","defaults"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/map/"},push:{name:"push",displayName:"HTTP/2 Push",description:"Push resources to clients over HTTP/2",discriminator:"push",commonFields:["resources","headers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/push/"},request_body:{name:"request_body",displayName:"Request Body",description:"Configure request body size limits",discriminator:"request_body",commonFields:["max_size"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/request_body/"},vars:{name:"vars",displayName:"Variables",description:"Set variables for use in other handlers",discriminator:"vars",commonFields:[],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/vars/"},intercept:{name:"intercept",displayName:"Intercept",description:"Intercept and modify responses from upstreams",discriminator:"intercept",commonFields:["handle_response"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/intercept/"},invoke:{name:"invoke",displayName:"Invoke",description:"Invoke a named route by reference",discriminator:"invoke",commonFields:["name"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/invoke/"},tracing:{name:"tracing",displayName:"Tracing",description:"Add distributed tracing spans",discriminator:"tracing",commonFields:["span"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/tracing/"},log_append:{name:"log_append",displayName:"Log Append",description:"Append custom fields to access logs",discriminator:"log_append",commonFields:["key","value"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/log_append/"},error:{name:"error",displayName:"Error",description:"Trigger an error response",discriminator:"error",commonFields:["error","status_code"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/error/"},copy_response:{name:"copy_response",displayName:"Copy Response",description:"Copy response from another handler",discriminator:"copy_response",commonFields:["status_code"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/copy_response/"},copy_response_headers:{name:"copy_response_headers",displayName:"Copy Response Headers",description:"Copy specific headers from another response",discriminator:"copy_response_headers",commonFields:["include","exclude"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/copy_response_headers/"}},d=Object.keys(i),s=Object.keys(t);function p(){let e={};for(let[n,r]of Object.entries(t))e[n]={prefix:r.snippet.prefix,body:r.snippet.body,description:r.snippet.description};return e}function u(){return Object.values(i).map(e=>({label:e.name,detail:e.displayName,documentation:e.description}))}
-export{t as BUILDER_METADATA,s as BUILDER_NAMES,o as GENERATED_AT,i as HANDLER_METADATA,d as HANDLER_NAMES,a as METADATA_VERSION,u as getHandlerCompletions,p as getVSCodeSnippets};
+});`,snippet:{prefix:"caddy-map-handler",body:["buildMapHandler({",'  source: "${1:{http.request.host\\}}",','  destinations: ["${2:destination}"],','  mappings: [{ input: "${3:input}", outputs: ["${4:output}"] }],',"  // optional: defaults","})$0"],description:"Build Map Handler"}}},i={authenticator:{name:"authenticator",displayName:"Authenticator (caddy-security)",description:"Serve authentication portal for caddy-security plugin",discriminator:"authenticator",commonFields:["portal_name","route_matcher"],caddyDocsPath:"https://github.com/greenpau/caddy-security"},authentication:{name:"authentication",displayName:"Authentication",description:"HTTP Basic authentication or custom auth providers",discriminator:"authentication",commonFields:["providers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/authentication/"},reverse_proxy:{name:"reverse_proxy",displayName:"Reverse Proxy",description:"Proxy requests to upstream backend servers with load balancing",discriminator:"reverse_proxy",commonFields:["upstreams","transport","load_balancing","health_checks","headers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/reverse_proxy/"},headers:{name:"headers",displayName:"Headers",description:"Modify request and response headers",discriminator:"headers",commonFields:["request","response"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/headers/"},static_response:{name:"static_response",displayName:"Static Response",description:"Return a static response without proxying",discriminator:"static_response",commonFields:["status_code","body","headers","close","abort"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/static_response/"},rewrite:{name:"rewrite",displayName:"Rewrite",description:"Rewrite the request URI before processing",discriminator:"rewrite",commonFields:["uri","strip_path_prefix","strip_path_suffix","uri_substring"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/rewrite/"},encode:{name:"encode",displayName:"Encode",description:"Compress responses with gzip, zstd, or brotli",discriminator:"encode",commonFields:["encodings","prefer","minimum_length"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/encode/"},subroute:{name:"subroute",displayName:"Subroute",description:"Process requests through nested routes",discriminator:"subroute",commonFields:["routes"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/subroute/"},file_server:{name:"file_server",displayName:"File Server",description:"Serve static files from disk",discriminator:"file_server",commonFields:["root","index_names","browse","hide"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/file_server/"},templates:{name:"templates",displayName:"Templates",description:"Render Go templates in responses",discriminator:"templates",commonFields:["file_root","mime_types","delimiters"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/templates/"},map:{name:"map",displayName:"Map",description:"Map input to output values for use in other handlers",discriminator:"map",commonFields:["source","destinations","mappings","defaults"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/map/"},push:{name:"push",displayName:"HTTP/2 Push",description:"Push resources to clients over HTTP/2",discriminator:"push",commonFields:["resources","headers"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/push/"},request_body:{name:"request_body",displayName:"Request Body",description:"Configure request body size limits",discriminator:"request_body",commonFields:["max_size"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/request_body/"},vars:{name:"vars",displayName:"Variables",description:"Set variables for use in other handlers",discriminator:"vars",commonFields:[],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/vars/"},intercept:{name:"intercept",displayName:"Intercept",description:"Intercept and modify responses from upstreams",discriminator:"intercept",commonFields:["handle_response"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/intercept/"},invoke:{name:"invoke",displayName:"Invoke",description:"Invoke a named route by reference",discriminator:"invoke",commonFields:["name"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/invoke/"},tracing:{name:"tracing",displayName:"Tracing",description:"Add distributed tracing spans",discriminator:"tracing",commonFields:["span"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/tracing/"},log_append:{name:"log_append",displayName:"Log Append",description:"Append custom fields to access logs",discriminator:"log_append",commonFields:["key","value"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/log_append/"},error:{name:"error",displayName:"Error",description:"Trigger an error response",discriminator:"error",commonFields:["error","status_code"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/error/"},copy_response:{name:"copy_response",displayName:"Copy Response",description:"Copy response from another handler",discriminator:"copy_response",commonFields:["status_code"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/copy_response/"},copy_response_headers:{name:"copy_response_headers",displayName:"Copy Response Headers",description:"Copy specific headers from another response",discriminator:"copy_response_headers",commonFields:["include","exclude"],caddyDocsPath:"/docs/json/apps/http/servers/routes/handle/copy_response_headers/"}},o=Object.keys(i),d=Object.keys(r);function u(){let e={};for(let[n,t]of Object.entries(r))e[n]={prefix:t.snippet.prefix,body:t.snippet.body,description:t.snippet.description};return e}function p(){return Object.values(i).map(e=>({label:e.name,detail:e.displayName,documentation:e.description}))}
+export{r as BUILDER_METADATA,d as BUILDER_NAMES,a as GENERATED_AT,i as HANDLER_METADATA,o as HANDLER_NAMES,s as METADATA_VERSION,p as getHandlerCompletions,u as getVSCodeSnippets};