@viaalink/caddy-api-client 0.10.0 → 0.10.2

package/dist/{client-Bf2QoSWQ.d.ts → client--uI2vvWr.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { C as CaddyClientOptions, k as CaddyRoute, U as UpstreamStatus } from './types-DIjkvykh.js';
-import { a7 as Config, S as Server } from './caddy-http-DLxwstYo.js';
+import { C as CaddyClientOptions, e as CaddyRoute, a2 as UpstreamStatus } from './types-WSyYaJZ9.js';
+import { s as Config, aA as Server } from './caddy-http-jhg7B7CZ.js';
 
 /**
  * Zod schemas for runtime validation
@@ -48,22 +48,30 @@ import { a7 as Config, S as Server } from './caddy-http-DLxwstYo.js';
  */
 declare const DomainSchema: z.ZodString;
 /**
- * Dial address schema - validates host:port format for upstream targets
+ * Dial address schema: a Caddy network address for an upstream.
+ *
+ * Accepts the forms Caddy's `reverse_proxy` dials:
+ * - `host:port`, `[ipv6]:port`
+ * - `tcp/host:port` (also `tcp4`, `tcp6`, `udp`, `udp4`, `udp6`)
+ * - `unix//abs/path.sock` (also `unix+h2c/`, `unixgram/`, `unixpacket/`); a unix
+ *   address is a socket path and has no port
+ * - anything with a `{placeholder}`, which Caddy resolves per request
  *
  * @example
  * ```typescript
  * import { DialAddressSchema } from "@viaalink/caddy-api-client";
  *
  * // Valid addresses
- * DialAddressSchema.parse("localhost:3000");     // OK
- * DialAddressSchema.parse("192.168.1.1:8080");  // OK
- * DialAddressSchema.parse("api-server:443");     // OK
+ * DialAddressSchema.parse("localhost:3000");          // OK
+ * DialAddressSchema.parse("192.168.1.1:8080");        // OK
+ * DialAddressSchema.parse("unix//run/app/web.sock");  // OK
+ * DialAddressSchema.parse("tcp6/[::1]:8080");         // OK
  *
  * // Invalid - missing port
  * DialAddressSchema.parse("localhost");  // throws
  * ```
  */
-declare const DialAddressSchema: z.ZodString;
+declare const DialAddressSchema: z.ZodEffects<z.ZodString, string, string>;
 /**
  * HTTP method schema, for Caddy's method matcher (`match.method`).
  *
@@ -790,7 +798,7 @@ declare const ServiceRouteOptionsSchema: z.ZodObject<{
     host: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
     pathRouteHost: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    dial: z.ZodString;
+    dial: z.ZodEffects<z.ZodString, string, string>;
     serviceId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     enableHostRoute: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     enablePathRoute: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -929,7 +937,7 @@ declare const HealthCheckRouteOptionsSchema: z.ZodObject<{
  */
 declare const HostRouteOptionsSchema: z.ZodObject<{
     host: z.ZodString;
-    dial: z.ZodString;
+    dial: z.ZodEffects<z.ZodString, string, string>;
     securityHeaders: z.ZodOptional<z.ZodObject<{
         enableHsts: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         hstsMaxAge: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -1028,7 +1036,7 @@ declare const HostRouteOptionsSchema: z.ZodObject<{
 declare const PathRouteOptionsSchema: z.ZodObject<{
     path: z.ZodString;
     host: z.ZodString;
-    dial: z.ZodString;
+    dial: z.ZodEffects<z.ZodString, string, string>;
     stripPrefix: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     securityHeaders: z.ZodOptional<z.ZodObject<{
         enableHsts: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1131,7 +1139,7 @@ declare const PathRouteOptionsSchema: z.ZodObject<{
  */
 declare const LoadBalancerRouteOptionsSchema: z.ZodObject<{
     host: z.ZodString;
-    upstreams: z.ZodArray<z.ZodString, "many">;
+    upstreams: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     healthCheckPath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     healthCheckInterval: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     policy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["first", "random", "least_conn", "round_robin"]>>>;
@@ -2220,7 +2228,11 @@ declare const StaticResponseHandlerSchema: z.ZodObject<{
     abort?: boolean | undefined;
 }>;
 /**
- * Authentication handler schema - HTTP basic auth
+ * Authentication handler schema - HTTP basic auth, or caddy-security's
+ * `authorizer` provider (`http.authentication.providers.authorizer`), which
+ * plugs into this same core handler. Without `authorizer` here, a route built
+ * by `buildProtectedRoute()` failed the route JSON schema the VS Code
+ * extension applies to `*.caddy.json`.
  *
  * @example
  * ```typescript
@@ -2276,7 +2288,21 @@ declare const AuthenticationHandlerSchema: z.ZodObject<{
                 algorithm?: string | undefined;
             } | undefined;
         }>>;
+        authorizer: z.ZodOptional<z.ZodObject<{
+            gatekeeper_name: z.ZodOptional<z.ZodString>;
+            route_matcher: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -2288,6 +2314,10 @@ declare const AuthenticationHandlerSchema: z.ZodObject<{
             } | undefined;
         } | undefined;
     }, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -2302,6 +2332,10 @@ declare const AuthenticationHandlerSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -2316,6 +2350,10 @@ declare const AuthenticationHandlerSchema: z.ZodObject<{
 }, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -4003,7 +4041,21 @@ declare const KnownCaddyHandlerSchema: z.ZodDiscriminatedUnion<"handler", [z.Zod
                 algorithm?: string | undefined;
             } | undefined;
         }>>;
+        authorizer: z.ZodOptional<z.ZodObject<{
+            gatekeeper_name: z.ZodOptional<z.ZodString>;
+            route_matcher: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -4015,6 +4067,10 @@ declare const KnownCaddyHandlerSchema: z.ZodDiscriminatedUnion<"handler", [z.Zod
             } | undefined;
         } | undefined;
     }, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -4029,6 +4085,10 @@ declare const KnownCaddyHandlerSchema: z.ZodDiscriminatedUnion<"handler", [z.Zod
 }, "strip", z.ZodTypeAny, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -4043,6 +4103,10 @@ declare const KnownCaddyHandlerSchema: z.ZodDiscriminatedUnion<"handler", [z.Zod
 }, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -5489,7 +5553,21 @@ declare const CaddyHandlerSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"handler",
                 algorithm?: string | undefined;
             } | undefined;
         }>>;
+        authorizer: z.ZodOptional<z.ZodObject<{
+            gatekeeper_name: z.ZodOptional<z.ZodString>;
+            route_matcher: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }, {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -5501,6 +5579,10 @@ declare const CaddyHandlerSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"handler",
             } | undefined;
         } | undefined;
     }, {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -5515,6 +5597,10 @@ declare const CaddyHandlerSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"handler",
 }, "strip", z.ZodTypeAny, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -5529,6 +5615,10 @@ declare const CaddyHandlerSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"handler",
 }, {
     handler: "authentication";
     providers?: {
+        authorizer?: {
+            route_matcher?: string | undefined;
+            gatekeeper_name?: string | undefined;
+        } | undefined;
         http_basic?: {
             realm?: string | undefined;
             accounts?: {
@@ -6709,4 +6799,4 @@ declare class CaddyClient {
     applyConfig(config: Config | (Config & Record<string, unknown>)): Promise<void>;
 }
 
-export { SubrouteHandlerSchema as $, AdaptOptionsSchema as A, BasicAuthOptionsSchema as B, CaddyRouteMatcherSchema as C, DomainSchema as D, ExtendedRouteMatcherSchema as E, FrameOptionsSchema as F, FileServerHandlerSchema as G, HttpMethodSchema as H, TemplatesHandlerSchema as I, MapHandlerSchema as J, PushHandlerSchema as K, LoadBalancerRouteOptionsSchema as L, MatchQuerySchema as M, RequestBodyHandlerSchema as N, InterceptHandlerSchema as O, PathRouteOptionsSchema as P, InvokeHandlerSchema as Q, RedirectModeSchema as R, SecurityHeadersSchema as S, TlsIssuerSchema as T, UpdateDomainOptionsSchema as U, VarsHandlerSchema as V, TracingHandlerSchema as W, LogAppendHandlerSchema as X, ErrorHandlerSchema as Y, CopyResponseHandlerSchema as Z, CopyResponseHeadersHandlerSchema as _, DialAddressSchema as a, KnownCaddyHandlerSchema as a0, CaddyHandlerSchema as a1, UpstreamStatusSchema as a2, UpstreamStatusArraySchema as a3, MitmwebOptionsSchema as a4, validate as a5, CaddyClient as a6, RedirectStatusCodeSchema as b, MatchHeaderSchema as c, CaddyRouteHandlerSchema as d, CaddyRouteSchema as e, CaddyClientOptionsSchema as f, CaddyAdapterSchema as g, AddDomainWithAutoTlsOptionsSchema as h, AddDomainWithTlsOptionsSchema as i, DeleteDomainOptionsSchema as j, ServiceRouteOptionsSchema as k, HealthCheckRouteOptionsSchema as l, HostRouteOptionsSchema as m, CaddyDurationSchema as n, ActiveHealthChecksSchema as o, PassiveHealthChecksSchema as p, HealthChecksSchema as q, LoadBalancingSchema as r, UpstreamSchema as s, HeaderRegexpSchema as t, ReverseProxyHandlerSchema as u, HeadersHandlerSchema as v, StaticResponseHandlerSchema as w, AuthenticationHandlerSchema as x, RewriteHandlerSchema as y, EncodeHandlerSchema as z };
+export { TlsIssuerSchema as $, ActiveHealthChecksSchema as A, BasicAuthOptionsSchema as B, CaddyAdapterSchema as C, DeleteDomainOptionsSchema as D, EncodeHandlerSchema as E, FileServerHandlerSchema as F, MatchHeaderSchema as G, HeaderRegexpSchema as H, InterceptHandlerSchema as I, MatchQuerySchema as J, KnownCaddyHandlerSchema as K, LoadBalancerRouteOptionsSchema as L, MapHandlerSchema as M, MitmwebOptionsSchema as N, PathRouteOptionsSchema as O, PassiveHealthChecksSchema as P, PushHandlerSchema as Q, RedirectModeSchema as R, RedirectStatusCodeSchema as S, RequestBodyHandlerSchema as T, ReverseProxyHandlerSchema as U, RewriteHandlerSchema as V, SecurityHeadersSchema as W, ServiceRouteOptionsSchema as X, StaticResponseHandlerSchema as Y, SubrouteHandlerSchema as Z, TemplatesHandlerSchema as _, AdaptOptionsSchema as a, TracingHandlerSchema as a0, UpdateDomainOptionsSchema as a1, UpstreamSchema as a2, UpstreamStatusArraySchema as a3, UpstreamStatusSchema as a4, VarsHandlerSchema as a5, validate as a6, AddDomainWithAutoTlsOptionsSchema as b, AddDomainWithTlsOptionsSchema as c, AuthenticationHandlerSchema as d, CaddyClient as e, CaddyClientOptionsSchema as f, CaddyDurationSchema as g, CaddyHandlerSchema as h, CaddyRouteHandlerSchema as i, CaddyRouteMatcherSchema as j, CaddyRouteSchema as k, CopyResponseHandlerSchema as l, CopyResponseHeadersHandlerSchema as m, DialAddressSchema as n, DomainSchema as o, ErrorHandlerSchema as p, ExtendedRouteMatcherSchema as q, FrameOptionsSchema as r, HeadersHandlerSchema as s, HealthCheckRouteOptionsSchema as t, HealthChecksSchema as u, HostRouteOptionsSchema as v, HttpMethodSchema as w, InvokeHandlerSchema as x, LoadBalancingSchema as y, LogAppendHandlerSchema as z };

package/dist/generated/extension-assets.d.ts

@@ -6,8 +6,8 @@
  * Run: npm run generate:extension
  *
  * @generated
- * @version 0.5.2
- * @generatedAt 2026-04-01T16:38:14.519Z
+ * @version 0.10.1
+ * @generatedAt 2026-10-31T23:06:36.575Z
  */
 interface ParamMetadata {
     name: string;
@@ -41,11 +41,11 @@ interface HandlerMetadata {
 /**
  * Library version this metadata was generated from
  */
-declare const METADATA_VERSION = "0.5.2";
+declare const METADATA_VERSION = "0.10.1";
 /**
  * Timestamp when this metadata was generated
  */
-declare const GENERATED_AT = "2026-04-01T16:38:14.519Z";
+declare const GENERATED_AT = "2026-10-31T23:06:36.575Z";
 /**
  * Builder function metadata extracted from JSDoc and type definitions
  *