@rangojs/router 0.0.0-experimental.0b82333f

package/dist/host/__tests__/testing.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest';
+import { createTestRequest, testPattern } from '../testing';
+describe('createTestRequest', () => {
+    it('should create a request with specified host', () => {
+        const request = createTestRequest({ host: 'example.com' });
+        expect(request.url).toBe('http://example.com/');
+        expect(new URL(request.url).hostname).toBe('example.com');
+    });
+    it('should create a request with path', () => {
+        const request = createTestRequest({
+            host: 'example.com',
+            path: '/admin',
+        });
+        expect(request.url).toBe('http://example.com/admin');
+    });
+    it('should create a request with cookies', () => {
+        const request = createTestRequest({
+            host: 'localhost',
+            cookies: {
+                'x-requested-host': 'admin.example.com',
+                session: 'abc123',
+            },
+        });
+        const cookieHeader = request.headers.get('cookie');
+        expect(cookieHeader).toBeTruthy();
+        expect(cookieHeader).toContain('x-requested-host=admin.example.com');
+        expect(cookieHeader).toContain('session=abc123');
+    });
+    it('should create a request with custom method', () => {
+        const request = createTestRequest({
+            host: 'example.com',
+            method: 'POST',
+        });
+        expect(request.method).toBe('POST');
+    });
+    it('should create a request with custom headers', () => {
+        const request = createTestRequest({
+            host: 'example.com',
+            headers: {
+                Authorization: 'Bearer token',
+            },
+        });
+        expect(request.headers.get('Authorization')).toBe('Bearer token');
+    });
+});
+describe('testPattern', () => {
+    it('should test single patterns', () => {
+        expect(testPattern('.', 'example.com')).toBe(true);
+        expect(testPattern('.', 'www.example.com')).toBe(false);
+        expect(testPattern('admin.*', 'admin.example.com')).toBe(true);
+        expect(testPattern('admin.*', 'example.com')).toBe(false);
+    });
+    it('should test pattern arrays', () => {
+        expect(testPattern(['.', 'www.*'], 'example.com')).toBe(true);
+        expect(testPattern(['.', 'www.*'], 'www.example.com')).toBe(true);
+        expect(testPattern(['.', 'www.*'], 'api.example.com')).toBe(false);
+    });
+    it('should test complex patterns', () => {
+        expect(testPattern('*.', 'api.example.com')).toBe(true);
+        expect(testPattern('**.', 'a.b.example.com')).toBe(true);
+        expect(testPattern('**', 'any.host.example.com')).toBe(true);
+    });
+});
+//# sourceMappingURL=testing.test.js.map

package/dist/host/__tests__/testing.test.js.map

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

package/dist/host/__tests__/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/host/__tests__/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../../src/host/__tests__/utils.test.ts"],"names":[],"mappings":""}

package/dist/host/__tests__/utils.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect } from 'vitest';
+import { defineHosts } from '../utils';
+describe('defineHosts', () => {
+    it('should create type-safe host definitions', () => {
+        const hosts = defineHosts({
+            admin: 'admin.*',
+            api: 'api.*',
+            app: ['.', 'www.*'],
+        });
+        expect(hosts.admin).toBe('admin.*');
+        expect(hosts.api).toBe('api.*');
+        expect(hosts.app).toEqual(['.', 'www.*']);
+    });
+    it('should freeze the returned object', () => {
+        const hosts = defineHosts({
+            admin: 'admin.*',
+        });
+        expect(Object.isFrozen(hosts)).toBe(true);
+        expect(() => {
+            hosts.admin = 'modified';
+        }).toThrow();
+    });
+    it('should work with empty object', () => {
+        const hosts = defineHosts({});
+        expect(hosts).toEqual({});
+        expect(Object.isFrozen(hosts)).toBe(true);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/host/__tests__/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../../src/host/__tests__/utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO;YACZ,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE;YACT,KAAa,CAAC,KAAK,GAAG,UAAU,CAAC;QACpC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAE9B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/host/cookie-handler.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cookie Override Handler
+ *
+ * Manages cookie-based host override for development environments.
+ */
+import type { HostOverrideConfig } from './types.js';
+/**
+ * Parse cookies from request
+ */
+export declare function parseCookies(request: Request): Record<string, string>;
+/**
+ * Get cookie value from request
+ */
+export declare function getCookie(request: Request, name: string): string | undefined;
+/**
+ * Create Set-Cookie header to delete a cookie
+ */
+export declare function createDeleteCookieHeader(name: string): string;
+/**
+ * Create error response with cookie deletion
+ */
+export declare function createCookieErrorResponse(cookieName: string, message: string): Response;
+/**
+ * Check if current host is allowed to use override
+ */
+export declare function isHostAllowed(request: Request, allowedHosts: string[]): boolean;
+/**
+ * Handle cookie override logic
+ *
+ * Returns overridden hostname if valid, original hostname if no override.
+ * Throws errors for invalid overrides.
+ */
+export declare function handleCookieOverride(request: Request, config: HostOverrideConfig | undefined, context: any): string;
+//# sourceMappingURL=cookie-handler.d.ts.map

package/dist/host/cookie-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-handler.d.ts","sourceRoot":"","sources":["../../src/host/cookie-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBrE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,QAAQ,CAcV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,OAAO,EAAE,GAAG,GACX,MAAM,CAyDR"}

package/dist/host/cookie-handler.js

@@ -0,0 +1,124 @@
+/**
+ * Cookie Override Handler
+ *
+ * Manages cookie-based host override for development environments.
+ */
+import { matchPattern, parseRequest } from './pattern-matcher.js';
+import { HostOverrideNotAllowedError, InvalidHostnameError, HostValidationError, } from './errors.js';
+/**
+ * Parse cookies from request
+ */
+export function parseCookies(request) {
+    const cookieHeader = request.headers.get('cookie');
+    if (!cookieHeader) {
+        return {};
+    }
+    const cookies = {};
+    const pairs = cookieHeader.split(';');
+    for (const pair of pairs) {
+        const [key, value] = pair.trim().split('=');
+        if (key && value) {
+            cookies[key] = decodeURIComponent(value);
+        }
+    }
+    return cookies;
+}
+/**
+ * Get cookie value from request
+ */
+export function getCookie(request, name) {
+    const cookies = parseCookies(request);
+    return cookies[name];
+}
+/**
+ * Create Set-Cookie header to delete a cookie
+ */
+export function createDeleteCookieHeader(name) {
+    return `${name}=; Max-Age=0; Path=/; Secure; HttpOnly`;
+}
+/**
+ * Create error response with cookie deletion
+ */
+export function createCookieErrorResponse(cookieName, message) {
+    return new Response(JSON.stringify({
+        error: message,
+        message: `The ${cookieName} cookie has been cleared`,
+    }), {
+        status: 400,
+        headers: {
+            'Content-Type': 'application/json',
+            'Set-Cookie': createDeleteCookieHeader(cookieName),
+        },
+    });
+}
+/**
+ * Check if current host is allowed to use override
+ */
+export function isHostAllowed(request, allowedHosts) {
+    const { hostname, pathname, parts } = parseRequest(request);
+    for (const pattern of allowedHosts) {
+        if (matchPattern(pattern, hostname, pathname, parts)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Handle cookie override logic
+ *
+ * Returns overridden hostname if valid, original hostname if no override.
+ * Throws errors for invalid overrides.
+ */
+export function handleCookieOverride(request, config, context) {
+    if (!config) {
+        const { hostname } = parseRequest(request);
+        return hostname;
+    }
+    const { cookieName, allowedHosts, validate } = config;
+    const cookieValue = getCookie(request, cookieName);
+    const { hostname: originalHostname } = parseRequest(request);
+    // No cookie - return original hostname
+    if (!cookieValue) {
+        return originalHostname;
+    }
+    // Check if current host is allowed
+    const allowed = isHostAllowed(request, allowedHosts);
+    // If not allowed, throw error
+    if (!allowed) {
+        throw new HostOverrideNotAllowedError(originalHostname, cookieName, {
+            cause: { cookieValue, currentHost: originalHostname },
+        });
+    }
+    // If allowed and has custom validation, run it
+    if (validate) {
+        try {
+            const validatedHostname = validate(request, cookieValue, context);
+            return validatedHostname;
+        }
+        catch (error) {
+            // Wrap in HostValidationError
+            const message = error instanceof Error ? error.message : String(error);
+            throw new HostValidationError(message, error);
+        }
+    }
+    // Default validation - verify it's a valid hostname using URL constructor
+    try {
+        // Try to construct a URL with the hostname to validate it
+        const testUrl = new URL(`https://${cookieValue}`);
+        // Ensure the hostname matches what we provided (URL constructor normalizes it)
+        if (testUrl.hostname !== cookieValue) {
+            throw new InvalidHostnameError(cookieValue, {
+                cause: { original: cookieValue, normalized: testUrl.hostname },
+            });
+        }
+    }
+    catch (error) {
+        // If URL constructor failed, throw InvalidHostnameError with cause
+        if (error instanceof InvalidHostnameError) {
+            throw error;
+        }
+        throw new InvalidHostnameError(cookieValue, { cause: error });
+    }
+    return cookieValue;
+}
+//# sourceMappingURL=cookie-handler.js.map

package/dist/host/cookie-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-handler.js","sourceRoot":"","sources":["../../src/host/cookie-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,IAAY;IACtD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,GAAG,IAAI,wCAAwC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,OAAe;IAEf,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,OAAO,UAAU,0BAA0B;KACrD,CAAC,EACF;QACE,MAAM,EAAE,GAAG;QACX,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,wBAAwB,CAAC,UAAU,CAAC;SACnD;KACF,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,YAAsB;IAEtB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAE5D,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,MAAsC,EACtC,OAAY;IAEZ,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAE7D,uCAAuC;IACvC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAErD,8BAA8B;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,2BAA2B,CAAC,gBAAgB,EAAE,UAAU,EAAE;YAClE,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8BAA8B;YAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC;QACH,0DAA0D;QAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;QAElD,+EAA+E;QAC/E,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,oBAAoB,CAAC,WAAW,EAAE;gBAC1C,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mEAAmE;QACnE,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,oBAAoB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/host/errors.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Custom Error Classes for Host Router
+ *
+ * All host router errors extend HostRouterError for easy instance checking.
+ */
+/**
+ * Error options with cause
+ */
+interface ErrorOptions {
+    cause?: unknown;
+}
+/**
+ * Base error class for all host router errors
+ */
+export declare class HostRouterError extends Error {
+    cause?: unknown;
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when pattern validation fails
+ */
+export declare class InvalidPatternError extends HostRouterError {
+    constructor(pattern: string, reason: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when cookie override is not allowed
+ */
+export declare class HostOverrideNotAllowedError extends HostRouterError {
+    constructor(currentHost: string, cookieName: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when cookie hostname is invalid
+ */
+export declare class InvalidHostnameError extends HostRouterError {
+    constructor(hostname: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when custom validation fails
+ */
+export declare class HostValidationError extends HostRouterError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error thrown when no route matches
+ */
+export declare class NoRouteMatchError extends HostRouterError {
+    constructor(hostname: string, pathname: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when handler type is invalid
+ */
+export declare class InvalidHandlerError extends HostRouterError {
+    constructor(handler: unknown, options?: ErrorOptions);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/host/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEJ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKpE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;gBAClD,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQ5E;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKrD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKvE;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY;CAKrD"}

package/dist/host/errors.js

@@ -0,0 +1,79 @@
+/**
+ * Custom Error Classes for Host Router
+ *
+ * All host router errors extend HostRouterError for easy instance checking.
+ */
+/**
+ * Base error class for all host router errors
+ */
+export class HostRouterError extends Error {
+    constructor(message, options) {
+        super(message);
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+        this.name = 'HostRouterError';
+        Object.setPrototypeOf(this, HostRouterError.prototype);
+    }
+}
+/**
+ * Error thrown when pattern validation fails
+ */
+export class InvalidPatternError extends HostRouterError {
+    constructor(pattern, reason, options) {
+        super(`Invalid pattern "${pattern}": ${reason}`, options);
+        this.name = 'InvalidPatternError';
+        Object.setPrototypeOf(this, InvalidPatternError.prototype);
+    }
+}
+/**
+ * Error thrown when cookie override is not allowed
+ */
+export class HostOverrideNotAllowedError extends HostRouterError {
+    constructor(currentHost, cookieName, options) {
+        super(`Host override not allowed on "${currentHost}" (cookie: ${cookieName})`, options);
+        this.name = 'HostOverrideNotAllowedError';
+        Object.setPrototypeOf(this, HostOverrideNotAllowedError.prototype);
+    }
+}
+/**
+ * Error thrown when cookie hostname is invalid
+ */
+export class InvalidHostnameError extends HostRouterError {
+    constructor(hostname, options) {
+        super(`Invalid hostname format: "${hostname}"`, options);
+        this.name = 'InvalidHostnameError';
+        Object.setPrototypeOf(this, InvalidHostnameError.prototype);
+    }
+}
+/**
+ * Error thrown when custom validation fails
+ */
+export class HostValidationError extends HostRouterError {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'HostValidationError';
+        Object.setPrototypeOf(this, HostValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when no route matches
+ */
+export class NoRouteMatchError extends HostRouterError {
+    constructor(hostname, pathname, options) {
+        super(`No route matched for ${hostname}${pathname}`, options);
+        this.name = 'NoRouteMatchError';
+        Object.setPrototypeOf(this, NoRouteMatchError.prototype);
+    }
+}
+/**
+ * Error thrown when handler type is invalid
+ */
+export class InvalidHandlerError extends HostRouterError {
+    constructor(handler, options) {
+        super(`Invalid handler type: ${typeof handler}`, options);
+        this.name = 'InvalidHandlerError';
+        Object.setPrototypeOf(this, InvalidHandlerError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/host/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/host/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGxC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAe,EAAE,MAAc,EAAE,OAAsB;QACjE,KAAK,CAAC,oBAAoB,OAAO,MAAM,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAC9D,YAAY,WAAmB,EAAE,UAAkB,EAAE,OAAsB;QACzE,KAAK,CACH,iCAAiC,WAAW,cAAc,UAAU,GAAG,EACvE,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,YAAY,QAAgB,EAAE,OAAsB;QAClD,KAAK,CAAC,6BAA6B,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,QAAgB,EAAE,QAAgB,EAAE,OAAsB;QACpE,KAAK,CAAC,wBAAwB,QAAQ,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAgB,EAAE,OAAsB;QAClD,KAAK,CAAC,yBAAyB,OAAO,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/host/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Host Router
+ *
+ * A routing system for managing multi-application hosting based on
+ * domain/subdomain patterns with support for cookie-based host override
+ * for development environments.
+ *
+ * @example
+ * ```ts
+ * import { createHostRouter } from '@rangojs/router/host';
+ *
+ * const router = createHostRouter();
+ *
+ * router.host(['.']).map(() => import('./apps/main'));
+ * router.host(['admin.*']).map(() => import('./apps/admin'));
+ *
+ * export default {
+ *   fetch(request) {
+ *     return router.match(request);
+ *   }
+ * };
+ * ```
+ */
+export { createHostRouter } from './router.js';
+export { HostRouterRegistry, type HostRouterRegistryEntry } from './router.js';
+export { defineHosts } from './utils.js';
+export { HostRouterError, InvalidPatternError, HostOverrideNotAllowedError, InvalidHostnameError, HostValidationError, NoRouteMatchError, InvalidHandlerError, } from './errors.js';
+export type { HostRouter, HostRouteBuilder, HostRouterOptions, Handler, LazyHandler, Middleware, HostPattern, HostMatchResult, HostOverrideConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/host/index.js

@@ -0,0 +1,32 @@
+/**
+ * Host Router
+ *
+ * A routing system for managing multi-application hosting based on
+ * domain/subdomain patterns with support for cookie-based host override
+ * for development environments.
+ *
+ * @example
+ * ```ts
+ * import { createHostRouter } from '@rangojs/router/host';
+ *
+ * const router = createHostRouter();
+ *
+ * router.host(['.']).map(() => import('./apps/main'));
+ * router.host(['admin.*']).map(() => import('./apps/admin'));
+ *
+ * export default {
+ *   fetch(request) {
+ *     return router.match(request);
+ *   }
+ * };
+ * ```
+ */
+// Core router
+export { createHostRouter } from './router.js';
+// Host router registry for build-time discovery
+export { HostRouterRegistry } from './router.js';
+// Utilities
+export { defineHosts } from './utils.js';
+// Errors
+export { HostRouterError, InvalidPatternError, HostOverrideNotAllowedError, InvalidHostnameError, HostValidationError, NoRouteMatchError, InvalidHandlerError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,gDAAgD;AAChD,OAAO,EAAE,kBAAkB,EAAgC,MAAM,aAAa,CAAC;AAE/E,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,SAAS;AACT,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/host/pattern-matcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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
+ */
+/**
+ * Normalize a pattern by removing trailing slashes from paths
+ */
+export declare function normalizePattern(pattern: string): string;
+/**
+ * Parse hostname and path from request URL
+ */
+export declare function parseRequest(request: Request): {
+    hostname: string;
+    pathname: string;
+    parts: string[];
+};
+/**
+ * Match a single pattern against hostname and path
+ */
+export declare function matchPattern(pattern: string, hostname: string, pathname: string, parts: string[]): boolean;
+/**
+ * Validate pattern format
+ */
+export declare function validatePattern(pattern: string): void;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/host/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../src/host/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAOA;AAmBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAqBT;AAmGD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAiBrD"}