@rangojs/router 0.0.0-experimental.2 → 0.0.0-experimental.21

package/dist/host/pattern-matcher.js

@@ -0,0 +1,172 @@
+/**
+ * Pattern Matching Engine
+ *
+ * Handles matching of hostnames and paths against various patterns:
+ * - `.` or `*` - any apex domain
+ * - `**` - any domain (apex + subdomains)
+ * - `*.` - any single-level subdomain
+ * - `**.` - any multi-level subdomain
+ * - `example.com` - exact domain
+ * - `*.com` - any apex .com domain
+ * - `*.example.com` - subdomain of example.com
+ * - `**.example.com` - any depth subdomain
+ * - `admin.*` - admin subdomain of any apex
+ * - `example.com/admin` - specific domain with path prefix
+ */
+import { InvalidPatternError } from './errors.js';
+/**
+ * Normalize a pattern by removing trailing slashes from paths
+ */
+export function normalizePattern(pattern) {
+    // If pattern has a path component, remove trailing slash
+    const slashIndex = pattern.indexOf('/');
+    if (slashIndex !== -1) {
+        const domain = pattern.slice(0, slashIndex);
+        const path = pattern.slice(slashIndex).replace(/\/$/, '');
+        return domain + path;
+    }
+    return pattern;
+}
+/**
+ * Parse hostname and path from request URL
+ */
+export function parseRequest(request) {
+    const url = new URL(request.url);
+    const hostname = url.hostname;
+    const pathname = url.pathname;
+    const parts = hostname.split('.');
+    return { hostname, pathname, parts };
+}
+/**
+ * Count subdomain levels (0 for apex, 1+ for subdomains)
+ */
+function getSubdomainLevel(parts) {
+    // Apex domain has 2 parts (example.com)
+    // Single subdomain has 3 parts (www.example.com)
+    // Multi-level has 4+ parts (a.b.example.com)
+    return Math.max(0, parts.length - 2);
+}
+/**
+ * Check if hostname is an apex domain (no subdomains)
+ */
+function isApexDomain(parts) {
+    return parts.length === 2;
+}
+/**
+ * Match a single pattern against hostname and path
+ */
+export function matchPattern(pattern, hostname, pathname, parts) {
+    const normalized = normalizePattern(pattern);
+    // Check if pattern has path component
+    const slashIndex = normalized.indexOf('/');
+    const hasPath = slashIndex !== -1;
+    const domainPattern = hasPath ? normalized.slice(0, slashIndex) : normalized;
+    const pathPattern = hasPath ? normalized.slice(slashIndex) : null;
+    // First match domain
+    const domainMatch = matchDomainPattern(domainPattern, hostname, parts);
+    if (!domainMatch) {
+        return false;
+    }
+    // Then match path (prefix match)
+    if (pathPattern) {
+        return pathname === pathPattern || pathname.startsWith(pathPattern + '/');
+    }
+    return true;
+}
+/**
+ * Match domain pattern against hostname
+ */
+function matchDomainPattern(pattern, hostname, parts) {
+    // Exact match
+    if (pattern === hostname) {
+        return true;
+    }
+    // `.` or `*` - any apex domain
+    if (pattern === '.' || pattern === '*') {
+        return isApexDomain(parts);
+    }
+    // `**` - any domain (apex + all subdomains)
+    if (pattern === '**') {
+        return true;
+    }
+    // `*.` - any single-level subdomain
+    if (pattern === '*.') {
+        return getSubdomainLevel(parts) === 1;
+    }
+    // `**.` - any multi-level subdomain (2+ levels)
+    if (pattern === '**.') {
+        return getSubdomainLevel(parts) >= 2;
+    }
+    // `*.tld` - any apex domain with specific TLD (e.g., *.com)
+    if (pattern.startsWith('*.') && !pattern.includes('.', 2)) {
+        const tld = pattern.slice(2);
+        return isApexDomain(parts) && hostname.endsWith('.' + tld);
+    }
+    // `*.example.com` - single subdomain of specific domain
+    if (pattern.startsWith('*.')) {
+        const baseDomain = pattern.slice(2);
+        if (hostname.endsWith('.' + baseDomain)) {
+            // Count parts: if pattern is *.example.com (3 parts),
+            // hostname should have exactly 4 parts (www.example.com)
+            const patternParts = baseDomain.split('.');
+            return parts.length === patternParts.length + 1;
+        }
+        return false;
+    }
+    // `**.example.com` - any depth subdomain of specific domain
+    if (pattern.startsWith('**.')) {
+        const baseDomain = pattern.slice(3);
+        if (hostname.endsWith('.' + baseDomain)) {
+            const patternParts = baseDomain.split('.');
+            // Must have more parts than the base domain (i.e., has subdomains)
+            return parts.length > patternParts.length;
+        }
+        return false;
+    }
+    // `subdomain.*` - specific subdomain of any apex domain
+    // e.g., admin.* matches admin.example.com, admin.google.com
+    if (pattern.endsWith('.*')) {
+        const subdomain = pattern.slice(0, -2);
+        // Must be single-level subdomain (3 parts total)
+        if (parts.length === 3 && parts[0] === subdomain) {
+            return true;
+        }
+        return false;
+    }
+    // `subdomain.**` - specific subdomain of any domain (including multi-level)
+    // e.g., admin.** matches admin.example.com, admin.sub.example.com
+    if (pattern.endsWith('.**')) {
+        const subdomain = pattern.slice(0, -3);
+        if (parts.length >= 3 && parts[0] === subdomain) {
+            return true;
+        }
+        return false;
+    }
+    // `subdomain.` - specific subdomain of any apex domain (no wildcard)
+    // e.g., admin. matches admin.example.com, admin.google.com
+    if (pattern.endsWith('.') && !pattern.includes('*')) {
+        const subdomain = pattern.slice(0, -1);
+        // Must be exactly 3 parts (subdomain.domain.tld)
+        if (parts.length === 3 && parts[0] === subdomain) {
+            return true;
+        }
+        return false;
+    }
+    return false;
+}
+/**
+ * Validate pattern format
+ */
+export function validatePattern(pattern) {
+    if (!pattern || typeof pattern !== 'string') {
+        throw new InvalidPatternError(pattern, 'Pattern must be a non-empty string', { cause: { type: typeof pattern, value: pattern } });
+    }
+    // Check for invalid characters (spaces, etc.)
+    if (/\s/.test(pattern)) {
+        throw new InvalidPatternError(pattern, 'contains whitespace', {
+            cause: { pattern },
+        });
+    }
+    // Additional validation can be added here
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/host/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../src/host/pattern-matcher.ts"],"names":[],"mappings":"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"}

package/dist/host/router.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Host Router Implementation
+ *
+ * Main router that handles host-based routing with middleware and cookie override.
+ */
+import type { HostRouter, HostRouterOptions, RouteEntry } from './types.js';
+/**
+ * Registry entry for a host router instance.
+ * Stores references to the live routes array and fallback, so the discovery
+ * plugin can iterate handlers registered after createHostRouter() returns.
+ */
+export interface HostRouterRegistryEntry {
+    routes: RouteEntry[];
+    fallback: RouteEntry | null;
+}
+/**
+ * Global registry for host routers (parallel to RouterRegistry for RSC routers).
+ * Populated by createHostRouter() so the build-time discovery plugin can find
+ * host routers and resolve their lazy handlers to trigger sub-app createRouter() calls.
+ */
+export declare const HostRouterRegistry: Map<string, HostRouterRegistryEntry>;
+/**
+ * Create a host router
+ */
+export declare function createHostRouter(options?: HostRouterOptions): HostRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/host/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/host/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EAKjB,UAAU,EAEX,MAAM,YAAY,CAAC;AAiBpB;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAa,CAAC;AAIlF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAkR5E"}

package/dist/host/router.js

@@ -0,0 +1,218 @@
+/**
+ * Host Router Implementation
+ *
+ * Main router that handles host-based routing with middleware and cookie override.
+ */
+import { matchPattern, parseRequest, normalizePattern, validatePattern, } from './pattern-matcher.js';
+import { handleCookieOverride, createCookieErrorResponse, } from './cookie-handler.js';
+import { HostRouterError, NoRouteMatchError, InvalidHandlerError, } from './errors.js';
+/**
+ * Global registry for host routers (parallel to RouterRegistry for RSC routers).
+ * Populated by createHostRouter() so the build-time discovery plugin can find
+ * host routers and resolve their lazy handlers to trigger sub-app createRouter() calls.
+ */
+export const HostRouterRegistry = new Map();
+let hostRouterAutoId = 0;
+/**
+ * Create a host router
+ */
+export function createHostRouter(options = {}) {
+    const routes = [];
+    const globalMiddleware = [];
+    let fallbackRoute = null;
+    const { debug = false, hostOverride } = options;
+    function log(message, ...args) {
+        if (debug) {
+            console.log(`[HostRouter] ${message}`, ...args);
+        }
+    }
+    /**
+     * Create a route builder for chaining
+     */
+    function createRouteBuilder(patterns, isFallback = false) {
+        const middleware = [];
+        return {
+            use(...mw) {
+                middleware.push(...mw);
+                return this;
+            },
+            map(handler) {
+                const entry = {
+                    patterns,
+                    middleware,
+                    handler,
+                    isFallback,
+                };
+                if (isFallback) {
+                    fallbackRoute = entry;
+                }
+                else {
+                    routes.push(entry);
+                }
+                log(`Registered ${isFallback ? 'fallback' : 'route'}:`, patterns.join(', '));
+                return router;
+            },
+        };
+    }
+    /**
+     * Find matching route for hostname and path
+     */
+    function findMatchingRoute(hostname, pathname) {
+        const parts = hostname.split('.');
+        for (const route of routes) {
+            for (const pattern of route.patterns) {
+                if (matchPattern(pattern, hostname, pathname, parts)) {
+                    log(`Matched pattern: "${pattern}"`);
+                    return route;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Execute middleware chain
+     */
+    async function executeMiddleware(middleware, request, context, finalHandler) {
+        let index = 0;
+        async function next() {
+            if (index >= middleware.length) {
+                return finalHandler();
+            }
+            const mw = middleware[index++];
+            if (!mw) {
+                return finalHandler();
+            }
+            return mw(request, context, next);
+        }
+        return next();
+    }
+    /**
+     * Execute handler (lazy or direct)
+     */
+    async function executeHandler(handler, request, context) {
+        // Check if it's a lazy handler (function that returns promise)
+        if (typeof handler === 'function') {
+            const result = handler(request, context);
+            // If it returns a promise with default export
+            if (result && typeof result === 'object' && 'then' in result) {
+                const module = await result;
+                if (typeof module === 'object' &&
+                    module !== null &&
+                    'default' in module) {
+                    const defaultExport = module
+                        .default;
+                    // If default export is a router with match method
+                    if (typeof defaultExport === 'object' &&
+                        defaultExport !== null &&
+                        'match' in defaultExport) {
+                        return defaultExport.match(request, context);
+                    }
+                    // Otherwise treat as handler
+                    return defaultExport(request, context);
+                }
+                // If promise resolves to Response
+                return result;
+            }
+            // Direct handler
+            return result;
+        }
+        throw new InvalidHandlerError(handler, {
+            cause: { handlerType: typeof handler },
+        });
+    }
+    /**
+     * Router instance
+     */
+    const router = {
+        host(patterns) {
+            const patternsArray = Array.isArray(patterns) ? patterns : [patterns];
+            // Validate and normalize patterns
+            const normalized = patternsArray.map((p) => {
+                validatePattern(p);
+                return normalizePattern(p);
+            });
+            return createRouteBuilder(normalized, false);
+        },
+        use(...middleware) {
+            globalMiddleware.push(...middleware);
+            log(`Registered global middleware (${middleware.length})`);
+            return router;
+        },
+        fallback() {
+            return createRouteBuilder([], true);
+        },
+        test(hostname) {
+            const parts = hostname.split('.');
+            const pathname = '/';
+            for (const route of routes) {
+                for (const pattern of route.patterns) {
+                    if (matchPattern(pattern, hostname, pathname, parts)) {
+                        return {
+                            pattern,
+                            handler: route.handler,
+                        };
+                    }
+                }
+            }
+            return null;
+        },
+        async match(request, context = {}) {
+            log(`Request: ${request.url}`);
+            let effectiveHostname;
+            try {
+                // Handle cookie override (may throw HostRouterError)
+                effectiveHostname = handleCookieOverride(request, hostOverride, context);
+            }
+            catch (error) {
+                // If it's a HostRouterError from cookie override
+                if (error instanceof HostRouterError) {
+                    log(`Cookie override error: ${error.message}`);
+                    // If fallback exists, use it
+                    if (fallbackRoute) {
+                        context.error = error;
+                        const allMiddleware = [
+                            ...globalMiddleware,
+                            ...fallbackRoute.middleware,
+                        ];
+                        return executeMiddleware(allMiddleware, request, context, () => executeHandler(fallbackRoute.handler, request, context));
+                    }
+                    // Otherwise return error response with cookie deletion
+                    if (hostOverride) {
+                        return createCookieErrorResponse(hostOverride.cookieName, error.message);
+                    }
+                }
+                // Re-throw non-HostRouterErrors
+                throw error;
+            }
+            const { pathname } = parseRequest(request);
+            if (effectiveHostname !== parseRequest(request).hostname) {
+                log(`Cookie override: ${effectiveHostname}`);
+            }
+            // Find matching route
+            const matchedRoute = findMatchingRoute(effectiveHostname, pathname);
+            if (!matchedRoute) {
+                log(`No route matched`);
+                throw new NoRouteMatchError(effectiveHostname, pathname, {
+                    cause: {
+                        hostname: effectiveHostname,
+                        pathname,
+                    },
+                });
+            }
+            // Combine global and route-specific middleware
+            const allMiddleware = [...globalMiddleware, ...matchedRoute.middleware];
+            // Execute middleware chain and handler
+            return executeMiddleware(allMiddleware, request, context, () => executeHandler(matchedRoute.handler, request, context));
+        },
+    };
+    // Register in the global HostRouterRegistry for build-time discovery.
+    // The routes array and fallbackRoute ref are live - they reflect routes
+    // added via .host().map() after this point.
+    const registryId = `host-router-${hostRouterAutoId++}`;
+    HostRouterRegistry.set(registryId, {
+        get routes() { return routes; },
+        get fallback() { return fallbackRoute; },
+    });
+    return router;
+}
+//# sourceMappingURL=router.js.map

package/dist/host/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/host/router.ts"],"names":[],"mappings":"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"}

package/dist/host/testing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Testing Utilities for Host Router
+ *
+ * Helper functions for testing host routing.
+ */
+export interface CreateTestRequestOptions {
+    host: string;
+    path?: string;
+    method?: string;
+    cookies?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+/**
+ * Create a test request with specific host and cookies
+ *
+ * @example
+ * ```ts
+ * const request = createTestRequest({
+ *   host: 'admin.example.com',
+ *   path: '/dashboard',
+ *   cookies: { 'x-requested-host': 'api.example.com' }
+ * });
+ * ```
+ */
+export declare function createTestRequest(options: CreateTestRequestOptions): Request;
+/**
+ * Test if a pattern matches a hostname
+ *
+ * @example
+ * ```ts
+ * expect(testPattern('admin.*', 'admin.example.com')).toBe(true);
+ * expect(testPattern(['*', 'www.*'], 'example.com')).toBe(true);
+ * ```
+ */
+export declare function testPattern(pattern: string | string[], hostname: string): boolean;
+//# sourceMappingURL=testing.d.ts.map

package/dist/host/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/host/testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAwB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAYT"}

package/dist/host/testing.js

@@ -0,0 +1,55 @@
+/**
+ * Testing Utilities for Host Router
+ *
+ * Helper functions for testing host routing.
+ */
+import { matchPattern } from './pattern-matcher.js';
+/**
+ * Create a test request with specific host and cookies
+ *
+ * @example
+ * ```ts
+ * const request = createTestRequest({
+ *   host: 'admin.example.com',
+ *   path: '/dashboard',
+ *   cookies: { 'x-requested-host': 'api.example.com' }
+ * });
+ * ```
+ */
+export function createTestRequest(options) {
+    const { host, path = '/', method = 'GET', cookies = {}, headers = {}, } = options;
+    const url = `http://${host}${path}`;
+    const requestHeaders = new Headers(headers);
+    // Add cookies if provided
+    if (Object.keys(cookies).length > 0) {
+        const cookieString = Object.entries(cookies)
+            .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+            .join('; ');
+        requestHeaders.set('cookie', cookieString);
+    }
+    return new Request(url, {
+        method,
+        headers: requestHeaders,
+    });
+}
+/**
+ * Test if a pattern matches a hostname
+ *
+ * @example
+ * ```ts
+ * expect(testPattern('admin.*', 'admin.example.com')).toBe(true);
+ * expect(testPattern(['*', 'www.*'], 'example.com')).toBe(true);
+ * ```
+ */
+export function testPattern(pattern, hostname) {
+    const patterns = Array.isArray(pattern) ? pattern : [pattern];
+    const parts = hostname.split('.');
+    const pathname = '/';
+    for (const p of patterns) {
+        if (matchPattern(p, hostname, pathname, parts)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=testing.js.map

package/dist/host/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/host/testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EACJ,IAAI,EACJ,IAAI,GAAG,GAAG,EACV,MAAM,GAAG,KAAK,EACd,OAAO,GAAG,EAAE,EACZ,OAAO,GAAG,EAAE,GACb,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,UAAU,IAAI,GAAG,IAAI,EAAE,CAAC;IACpC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;aAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACtB,MAAM;QACN,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,QAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,GAAG,CAAC;IAErB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/host/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Host Router Types
+ *
+ * Type definitions for the host-based routing system.
+ */
+/**
+ * Handler function that processes a request and returns a response
+ */
+export type Handler = (request: Request, context: any) => Response | Promise<Response>;
+/**
+ * Lazy handler that dynamically imports a module with a default handler or router
+ */
+export type LazyHandler = () => Promise<{
+    default: Handler | HostRouter;
+}>;
+/**
+ * Middleware function that can intercept and modify requests/responses
+ */
+export type Middleware = (request: Request, context: any, next: () => Promise<Response>) => Promise<Response>;
+/**
+ * Host pattern - can be a string or array of strings
+ */
+export type HostPattern = string | string[];
+/**
+ * Result from testing a hostname against patterns
+ */
+export interface HostMatchResult {
+    pattern: string;
+    handler: Handler | LazyHandler;
+}
+/**
+ * Host route builder for chaining middleware and handler
+ */
+export interface HostRouteBuilder {
+    /**
+     * Add middleware to this host pattern
+     */
+    use(...middleware: Middleware[]): HostRouteBuilder;
+    /**
+     * Map to a handler or lazy import
+     */
+    map(handler: Handler | LazyHandler): HostRouter;
+}
+/**
+ * Main host router interface
+ */
+export interface HostRouter {
+    /**
+     * Register a host pattern
+     */
+    host(patterns: HostPattern): HostRouteBuilder;
+    /**
+     * Register global middleware
+     */
+    use(...middleware: Middleware[]): HostRouter;
+    /**
+     * Match an incoming request
+     */
+    match(request: Request, context?: any): Promise<Response>;
+    /**
+     * Register fallback handler for allowed hosts without valid cookie
+     */
+    fallback(): HostRouteBuilder;
+    /**
+     * Test which handler would match a hostname
+     */
+    test(hostname: string): HostMatchResult | null;
+}
+/**
+ * Host override configuration
+ */
+export interface HostOverrideConfig {
+    /**
+     * Cookie name to read for host override
+     */
+    cookieName: string;
+    /**
+     * Hosts that are allowed to use override
+     */
+    allowedHosts: string[];
+    /**
+     * Optional validation function
+     */
+    validate?: (request: Request, cookieValue: string, context: any) => string;
+}
+/**
+ * Host router options
+ */
+export interface HostRouterOptions {
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Cookie-based host override configuration
+     */
+    hostOverride?: HostOverrideConfig;
+}
+/**
+ * Internal route entry
+ */
+export interface RouteEntry {
+    patterns: string[];
+    middleware: Middleware[];
+    handler: Handler | LazyHandler;
+    isFallback?: boolean;
+}
+/**
+ * Pattern match result (internal)
+ */
+export interface PatternMatchResult {
+    matched: boolean;
+    routeEntry?: RouteEntry;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/host/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/host/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,GAAG,KACT,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC;IAEnD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,CAAC;IAE9C;;OAEG;IACH,GAAG,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,QAAQ,IAAI,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/host/types.js

@@ -0,0 +1,7 @@
+/**
+ * Host Router Types
+ *
+ * Type definitions for the host-based routing system.
+ */
+export {};
+//# sourceMappingURL=types.js.map