@viaalink/caddy-api-client 0.10.1 → 0.10.2

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { C as CaddyClientOptions, e as CaddyRoute, a2 as UpstreamStatus } from './types-CccPerBC.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';
 
 /**
@@ -48,22 +48,30 @@ import { s as Config, aA as Server } from './caddy-http-jhg7B7CZ.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?: {

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
  *