@de-otio/trellis 0.4.0

package/dist/lib/relationship-handler.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Relationship Handler
+ *
+ * CRUD operations for scored user relationships (circles model).
+ * Replaces the old follow/unfollow system with scored, tiered relationships.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationshipHandler = void 0;
+class RelationshipHandler {
+    async handleCreateRelationship(request, session, env, _requestContext) {
+        try {
+            const { z } = await Promise.resolve().then(() => __importStar(require("zod")));
+            const body = await request.json();
+            const schema = z.object({
+                targetType: z.enum(["user", "entity"]),
+                targetId: z.string().min(1).max(100),
+                connectionMethod: z.enum(["code", "import", "suggestion", "discovery"]).optional().default("discovery"),
+            });
+            const parsed = schema.safeParse(body);
+            if (!parsed.success) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            // Cannot create relationship with yourself
+            if (parsed.data.targetType === "user" && parsed.data.targetId === session.userId) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "Cannot create relationship with yourself" }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            const relationship = await graphService.createRelationship({
+                userId: session.userId,
+                targetType: parsed.data.targetType,
+                targetId: parsed.data.targetId,
+                connectionMethod: parsed.data.connectionMethod,
+            });
+            return new Response(JSON.stringify(relationship), {
+                status: 201,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async handleRemoveRelationship(request, session, env, _requestContext) {
+        try {
+            const url = new URL(request.url);
+            const targetType = url.searchParams.get("targetType");
+            const targetId = url.searchParams.get("targetId");
+            if (!targetType || !targetId || !["user", "entity"].includes(targetType)) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "targetType and targetId are required" }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            await graphService.removeRelationship(session.userId, targetType, targetId);
+            return new Response(null, { status: 204 });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async handleUpdateScore(request, session, env, _requestContext) {
+        try {
+            const { z } = await Promise.resolve().then(() => __importStar(require("zod")));
+            const body = await request.json();
+            const schema = z.object({
+                targetType: z.enum(["user", "entity"]),
+                targetId: z.string().min(1).max(100),
+                manualScore: z.number().min(0).max(1).nullable(),
+            });
+            const parsed = schema.safeParse(body);
+            if (!parsed.success) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            const relationship = await graphService.updateRelationshipScore({
+                userId: session.userId,
+                targetType: parsed.data.targetType,
+                targetId: parsed.data.targetId,
+                manualScore: parsed.data.manualScore,
+            });
+            return new Response(JSON.stringify(relationship), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async handleGetRelationship(request, session, env, _requestContext) {
+        try {
+            const url = new URL(request.url);
+            const targetType = url.searchParams.get("targetType");
+            const targetId = url.searchParams.get("targetId");
+            if (!targetType || !targetId || !["user", "entity"].includes(targetType)) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "targetType and targetId are required" }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            const relationship = await graphService.getRelationship(session.userId, targetType, targetId);
+            if (!relationship) {
+                return new Response(JSON.stringify({ error: "NOT_FOUND", message: "Relationship not found" }), { status: 404, headers: { "content-type": "application/json" } });
+            }
+            return new Response(JSON.stringify(relationship), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async handleGetRelationships(request, session, env, _requestContext) {
+        try {
+            const url = new URL(request.url);
+            const tierStr = url.searchParams.get("tier");
+            const targetType = url.searchParams.get("targetType") || undefined;
+            const limitStr = url.searchParams.get("limit");
+            const cursor = url.searchParams.get("cursor");
+            const tier = tierStr !== null ? parseInt(tierStr, 10) : undefined;
+            if (tier !== undefined && (isNaN(tier) || tier < 0 || tier > 3)) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "tier must be 0, 1, 2, or 3" }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            if (targetType && !["user", "entity"].includes(targetType)) {
+                return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "targetType must be 'user' or 'entity'" }), { status: 400, headers: { "content-type": "application/json" } });
+            }
+            const limit = Math.min(Math.max(parseInt(limitStr || "20", 10) || 20, 1), 100);
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            const result = await graphService.getRelationships(session.userId, {
+                tier: tier,
+                targetType: targetType,
+                pagination: { limit, cursor: cursor || undefined },
+            });
+            return new Response(JSON.stringify(result), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async handleGetGraph(_request, session, env, _requestContext) {
+        try {
+            // TODO: Implement session-age check once the Session type includes issuedAt.
+            // The previous check used (session as any).issuedAt which is always undefined,
+            // causing the re-auth guard to silently never fire. Removed to avoid false security.
+            const logger = logger_1.Logger.getInstance(env);
+            logger.warn("[RelationshipHandler] handleGetGraph: session-age check not yet implemented — Session type lacks issuedAt field");
+            const { createGraphServiceFromEnv } = await Promise.resolve().then(() => __importStar(require("./graph")));
+            const graphService = await createGraphServiceFromEnv(env);
+            const graphData = await graphService.getRelationshipGraph(session.userId);
+            return new Response(JSON.stringify(graphData), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            return await this.mapGraphError(error, env);
+        }
+    }
+    async mapGraphError(error, env) {
+        const logger = logger_1.Logger.getInstance(env);
+        if (error instanceof SyntaxError) {
+            return new Response(JSON.stringify({ error: "VALIDATION_ERROR", message: "Invalid JSON body" }), { status: 400, headers: { "content-type": "application/json" } });
+        }
+        if (error?.constructor?.name === "GraphNotFoundError") {
+            logger.warn("[RelationshipHandler] Not found:", error.message);
+            return new Response(JSON.stringify({ error: "NOT_FOUND", message: "Relationship not found" }), { status: 404, headers: { "content-type": "application/json" } });
+        }
+        if (error?.constructor?.name === "GraphConflictError") {
+            logger.warn("[RelationshipHandler] Conflict:", error.message);
+            return new Response(JSON.stringify({ error: "CONFLICT", message: "Relationship already exists" }), { status: 409, headers: { "content-type": "application/json" } });
+        }
+        if (error?.constructor?.name === "GraphConnectionError") {
+            const isPoolTimeout = typeof error.message === "string" &&
+                error.message.includes("connection acquisition timed out");
+            if (isPoolTimeout) {
+                logger.warn("graph_pool_acquire_timeout", { code: error.code, name: error.constructor.name });
+                await new Promise((r) => setTimeout(r, 50 + Math.random() * 100));
+            }
+            else {
+                logger.warn("[RelationshipHandler] Graph connection error", { code: error.code, name: error.constructor.name });
+            }
+            return new Response(JSON.stringify({ error: "service_unavailable" }), {
+                status: 503,
+                headers: { "content-type": "application/json", "Retry-After": "1" },
+            });
+        }
+        logger.error("[RelationshipHandler] Unexpected error:", error);
+        return new Response(JSON.stringify({ error: "INTERNAL_ERROR", message: "Internal server error" }), { status: 500, headers: { "content-type": "application/json" } });
+    }
+}
+exports.RelationshipHandler = RelationshipHandler;
+// Import at bottom to avoid circular dependency
+const logger_1 = require("./logger");
+//# sourceMappingURL=relationship-handler.js.map

package/dist/lib/relationship-handler.js.map

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

package/dist/lib/request-context.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Request Context Module
+ *
+ * Provides request context including region detection and configuration.
+ * This allows handlers to access region-specific settings throughout the request lifecycle.
+ */
+import { type RegionConfig } from "./region-config";
+import { type Region } from "./region-detection";
+import type { Session, SessionManager } from "./session-manager";
+/**
+ * Extended environment interface for request context
+ */
+export interface RequestContextEnv {
+    DEFAULT_REGION?: string;
+    ENABLE_IP_GEOLOCATION?: string;
+    IP_GEOLOCATION_API_KEY?: string;
+    IP_GEOLOCATION_SERVICE?: "cloudflare" | "ipapi" | "ip-api";
+    SESSION_SECRET?: string;
+    US_API_ENDPOINT?: string;
+    US_FRONTEND_ENDPOINT?: string;
+    US_CDN_ENDPOINT?: string;
+    EU_API_ENDPOINT?: string;
+    EU_FRONTEND_ENDPOINT?: string;
+    EU_CDN_ENDPOINT?: string;
+    CN_API_ENDPOINT?: string;
+    CN_FRONTEND_ENDPOINT?: string;
+    CN_CDN_ENDPOINT?: string;
+}
+/**
+ * Request context containing region and configuration
+ */
+export interface RequestContext {
+    region: Region;
+    config: RegionConfig;
+    session?: Session | null;
+}
+/**
+ * Request Context Manager class
+ */
+export declare class RequestContextManager {
+    private regionDetector;
+    private regionConfigManager;
+    private env;
+    constructor(env: RequestContextEnv);
+    /**
+     * Create request context with region detection and configuration
+     *
+     * This is the main function to call at the start of request handling.
+     * It detects the region, loads configuration, and optionally fetches the session.
+     *
+     * Performance: Optimized to use sync detection when possible (99% of cases).
+     * Only uses async if external IP geolocation is configured (rare).
+     *
+     * @param request - Request object
+     * @param sessionManager - Optional session manager (for user preference detection)
+     * @param session - Optional existing session (to avoid re-fetching)
+     * @returns Request context with region and configuration
+     */
+    createRequestContext(request: Request, sessionManager?: SessionManager, session?: Session | null): Promise<RequestContext>;
+    /**
+     * Create request context synchronously (for simple cases)
+     *
+     * Uses only synchronous detection methods (CloudFront-Viewer-Country / CF-IPCountry, Accept-Language).
+     * Does not fetch session or use external IP geolocation.
+     *
+     * @param request - Request object
+     * @returns Request context with region and configuration
+     */
+    createRequestContextSync(request: Request): RequestContext;
+    /**
+     * Add region headers to response for debugging
+     *
+     * Adds X-Region and X-Region-Detected headers to help with debugging.
+     * These headers are safe to expose and help identify region detection issues.
+     *
+     * @param response - Response object
+     * @param context - Request context
+     * @returns New response with region headers added
+     */
+    addRegionHeaders(response: Response, context: RequestContext): Response;
+    /**
+     * Add region headers to response (async version that handles body reading)
+     *
+     * This version can handle responses that have already been created.
+     *
+     * PERFORMANCE: Only reads body if response has already been created.
+     * For new responses, use addRegionHeaders() instead to avoid body reading.
+     *
+     * @param response - Response object
+     * @param context - Request context
+     * @returns New response with region headers added
+     */
+    addRegionHeadersAsync(response: Response, context: RequestContext): Promise<Response>;
+}
+/**
+ * Legacy functions for backward compatibility
+ * @deprecated Use new RequestContextManager class instead
+ */
+export declare function createRequestContext(request: Request, env: RequestContextEnv, sessionManager?: SessionManager, session?: Session | null): Promise<RequestContext>;
+export declare function createRequestContextSync(request: Request, env: RequestContextEnv): RequestContext;
+export declare function addRegionHeaders(response: Response, context: RequestContext): Response;
+export declare function addRegionHeadersAsync(response: Response, context: RequestContext): Promise<Response>;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/lib/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/lib/request-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,MAAM,EAGZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IAG3D,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,GAAG,CAAoB;gBAEnB,GAAG,EAAE,iBAAiB;IAMlC;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CACxB,OAAO,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE,cAAc,EAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,cAAc,CAAC;IA+B1B;;;;;;;;OAQG;IACH,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc;IAc1D;;;;;;;;;OASG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ;IAkBvE;;;;;;;;;;;OAWG;IACG,qBAAqB,CACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,QAAQ,CAAC;CAsCrB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,iBAAiB,EACtB,cAAc,CAAC,EAAE,cAAc,EAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,iBAAiB,GACrB,cAAc,CAGhB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,GACtB,QAAQ,CAGV;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,QAAQ,CAAC,CAGnB"}

package/dist/lib/request-context.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Request Context Module
+ *
+ * Provides request context including region detection and configuration.
+ * This allows handlers to access region-specific settings throughout the request lifecycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContextManager = void 0;
+exports.createRequestContext = createRequestContext;
+exports.createRequestContextSync = createRequestContextSync;
+exports.addRegionHeaders = addRegionHeaders;
+exports.addRegionHeadersAsync = addRegionHeadersAsync;
+const region_config_1 = require("./region-config");
+const region_detection_1 = require("./region-detection");
+/**
+ * Request Context Manager class
+ */
+class RequestContextManager {
+    regionDetector;
+    regionConfigManager;
+    env;
+    constructor(env) {
+        this.env = env;
+        this.regionDetector = new region_detection_1.RegionDetector(env);
+        this.regionConfigManager = new region_config_1.RegionConfigManager(env);
+    }
+    /**
+     * Create request context with region detection and configuration
+     *
+     * This is the main function to call at the start of request handling.
+     * It detects the region, loads configuration, and optionally fetches the session.
+     *
+     * Performance: Optimized to use sync detection when possible (99% of cases).
+     * Only uses async if external IP geolocation is configured (rare).
+     *
+     * @param request - Request object
+     * @param sessionManager - Optional session manager (for user preference detection)
+     * @param session - Optional existing session (to avoid re-fetching)
+     * @returns Request context with region and configuration
+     */
+    async createRequestContext(request, sessionManager, session) {
+        // PERFORMANCE: Fast path - use sync version if external IP geolocation not configured
+        // This avoids Promise overhead for 99% of requests
+        if (!this.env.IP_GEOLOCATION_API_KEY ||
+            this.env.IP_GEOLOCATION_SERVICE !== "ipapi") {
+            const region = this.regionDetector.detectRegionSync(request);
+            const config = this.regionConfigManager.getRegionConfig(region);
+            return {
+                region,
+                config,
+                session: session || undefined,
+            };
+        }
+        // Slow path: Only if external IP geolocation is configured (rare)
+        const region = await this.regionDetector.detectRegion(request, sessionManager, session);
+        const config = this.regionConfigManager.getRegionConfig(region);
+        return {
+            region,
+            config,
+            session: session || undefined,
+        };
+    }
+    /**
+     * Create request context synchronously (for simple cases)
+     *
+     * Uses only synchronous detection methods (CloudFront-Viewer-Country / CF-IPCountry, Accept-Language).
+     * Does not fetch session or use external IP geolocation.
+     *
+     * @param request - Request object
+     * @returns Request context with region and configuration
+     */
+    createRequestContextSync(request) {
+        // Detect region synchronously
+        const region = this.regionDetector.detectRegionSync(request);
+        // Get region configuration
+        const config = this.regionConfigManager.getRegionConfig(region);
+        // Return context
+        return {
+            region,
+            config,
+        };
+    }
+    /**
+     * Add region headers to response for debugging
+     *
+     * Adds X-Region and X-Region-Detected headers to help with debugging.
+     * These headers are safe to expose and help identify region detection issues.
+     *
+     * @param response - Response object
+     * @param context - Request context
+     * @returns New response with region headers added
+     */
+    addRegionHeaders(response, context) {
+        // Clone response to add headers
+        const newHeaders = new Headers(response.headers);
+        // Add region headers (safe to expose)
+        newHeaders.set("X-Region", context.region);
+        newHeaders.set("X-Region-Detected", context.region);
+        // Return new response with headers
+        // Note: We can't clone the body easily, so this is best used before response is created
+        // For existing responses, we'd need to read the body first
+        return new Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: newHeaders,
+        });
+    }
+    /**
+     * Add region headers to response (async version that handles body reading)
+     *
+     * This version can handle responses that have already been created.
+     *
+     * PERFORMANCE: Only reads body if response has already been created.
+     * For new responses, use addRegionHeaders() instead to avoid body reading.
+     *
+     * @param response - Response object
+     * @param context - Request context
+     * @returns New response with region headers added
+     */
+    async addRegionHeadersAsync(response, context) {
+        // PERFORMANCE: Try to add headers without reading body first
+        // If response.body is null or already consumed, we'll need to read it
+        if (response.body === null) {
+            // Body already consumed, can't clone
+            // In practice, this function should be called before the body is consumed
+            const newHeaders = new Headers(response.headers);
+            newHeaders.set("X-Region", context.region);
+            newHeaders.set("X-Region-Detected", context.region);
+            // Return response with headers but no body (body was already consumed)
+            return new Response(null, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: newHeaders,
+            });
+        }
+        // PERFORMANCE: If body is available, try to clone it first
+        // If cloning fails (body already consumed), handle gracefully
+        let body = null;
+        try {
+            const clonedResponse = response.clone();
+            body = await clonedResponse.arrayBuffer();
+        }
+        catch (error) {
+            // Body was consumed between check and clone, handle gracefully
+            body = null;
+        }
+        const newHeaders = new Headers(response.headers);
+        newHeaders.set("X-Region", context.region);
+        newHeaders.set("X-Region-Detected", context.region);
+        return new Response(body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: newHeaders,
+        });
+    }
+}
+exports.RequestContextManager = RequestContextManager;
+/**
+ * Legacy functions for backward compatibility
+ * @deprecated Use new RequestContextManager class instead
+ */
+async function createRequestContext(request, env, sessionManager, session) {
+    const manager = new RequestContextManager(env);
+    return manager.createRequestContext(request, sessionManager, session);
+}
+function createRequestContextSync(request, env) {
+    const manager = new RequestContextManager(env);
+    return manager.createRequestContextSync(request);
+}
+function addRegionHeaders(response, context) {
+    const manager = new RequestContextManager({});
+    return manager.addRegionHeaders(response, context);
+}
+async function addRegionHeadersAsync(response, context) {
+    const manager = new RequestContextManager({});
+    return manager.addRegionHeadersAsync(response, context);
+}
+//# sourceMappingURL=request-context.js.map

package/dist/lib/request-context.js.map

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

package/dist/lib/route-helpers.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Route Helpers
+ *
+ * Common helper functions for route handlers to reduce duplication.
+ */
+import type { Env } from "../env";
+import type { RequestContext } from "./request-context";
+export interface RouteHandlerContext {
+    request: Request;
+    env: Env;
+    url: URL;
+    pathname: string;
+    params: Record<string, string>;
+    requestContext?: RequestContext;
+}
+/**
+ * Route Helpers class
+ */
+export declare class RouteHelpers {
+    private env;
+    private sessionManager;
+    private secretResolver;
+    private securityHeaders;
+    private validator;
+    private logger;
+    constructor(env: Env);
+    /**
+     * Get session from request (returns null if not authenticated)
+     *
+     * Supports two authentication strategies:
+     * 1. Cognito JWT in Authorization: Bearer header (preferred for new clients)
+     * 2. Encrypted session cookie/token (legacy, for existing clients)
+     *
+     * @param request - Request object
+     */
+    getSessionFromRequest(request: Request): Promise<{
+        userId: string;
+        email: string;
+    } | null>;
+    /**
+     * Require authentication - returns error response if not authenticated
+     */
+    requireAuth(context: RouteHandlerContext): Promise<Response | null>;
+    /**
+     * Wrap handler with error handling and security headers
+     */
+    wrapHandler(handler: (context: RouteHandlerContext & {
+        session: {
+            userId: string;
+            email: string;
+        };
+    }) => Promise<Response>, context: RouteHandlerContext, requireAuthFlag?: boolean): Promise<Response>;
+    /**
+     * Extract parameter from pathname
+     */
+    extractPathParam(pathname: string, prefix: string): string | null;
+}
+/**
+ * Legacy functions for backward compatibility
+ * @deprecated Use new RouteHelpers class instead
+ */
+export declare function getSession(request: Request, env: Env): Promise<{
+    userId: string;
+    email: string;
+} | null>;
+export declare function requireAuth(context: RouteHandlerContext): Promise<Response | null>;
+export declare function wrapHandler(handler: (context: RouteHandlerContext & {
+    session: {
+        userId: string;
+        email: string;
+    };
+}) => Promise<Response>, context: RouteHandlerContext, requireAuthFlag?: boolean): Promise<Response>;
+export declare function extractPathParam(pathname: string, prefix: string): string | null;
+//# sourceMappingURL=route-helpers.d.ts.map

package/dist/lib/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/route-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,GAAG,EAAE,GAAG;IASpB;;;;;;;;OAQG;IACG,qBAAqB,CACzB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA6CpD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAWzE;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,CACP,OAAO,EAAE,mBAAmB,GAAG;QAC7B,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,KACE,OAAO,CAAC,QAAQ,CAAC,EACtB,OAAO,EAAE,mBAAmB,EAC5B,eAAe,GAAE,OAAc,GAC9B,OAAO,CAAC,QAAQ,CAAC;IAoDpB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAOlE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAGnD;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAG1B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,CACP,OAAO,EAAE,mBAAmB,GAAG;IAC7B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,KACE,OAAO,CAAC,QAAQ,CAAC,EACtB,OAAO,EAAE,mBAAmB,EAC5B,eAAe,GAAE,OAAc,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAGf"}