@de-otio/trellis 0.4.0

package/dist/lib/routes/taxonomy.js

@@ -0,0 +1,370 @@
+"use strict";
+/**
+ * Taxonomy Routes
+ *
+ * API endpoints for taxonomy management:
+ * - List dimensions
+ * - Get dimension by code
+ * - Search taxons
+ * - Get taxon by ID
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxonomyRoutes = void 0;
+const zod_1 = require("zod");
+const database_wrapper_helper_1 = require("../database-wrapper-helper");
+const input_sanitizer_1 = require("../input-sanitizer");
+const logger_1 = require("../logger");
+const middleware_1 = require("../middleware");
+const rate_limit_1 = require("../rate-limit");
+const region_detection_1 = require("../region-detection");
+const request_context_1 = require("../request-context");
+const taxonomy_handler_1 = require("../taxonomy-handler");
+const taxonomy_search_metrics_1 = require("../taxonomy-search-metrics");
+const tenant_context_1 = require("../tenant-context");
+/**
+ * Get tenant ID from request context
+ */
+async function getTenantId(request, env) {
+    try {
+        const ctx = await (0, request_context_1.createRequestContext)(request, env);
+        const tenantCtx = await (0, tenant_context_1.getRequestContext)(request, ctx.session || null);
+        if (!tenantCtx.tenant?.id) {
+            // For MVP, default to 'trellis' tenant
+            return "trellis";
+        }
+        return tenantCtx.tenant.id;
+    }
+    catch (error) {
+        // Fallback to default tenant for MVP
+        return "trellis";
+    }
+}
+/**
+ * Taxonomy routes
+ */
+exports.taxonomyRoutes = [
+    // List dimensions
+    {
+        path: "/api/taxonomy/dimensions",
+        method: "GET",
+        handler: async (request, env) => {
+            try {
+                const tenantId = await getTenantId(request, env);
+                const region = (0, region_detection_1.detectRegionSync)(request, env);
+                const db = (0, database_wrapper_helper_1.getWrappedDatabase)(region, env, request);
+                const handler = new taxonomy_handler_1.TaxonomyHandler(db, tenantId, env.TAXONOMY_CACHE_KV);
+                const includeCategories = request.url.includes("includeCategories=true");
+                const includeTaxons = request.url.includes("includeTaxons=true");
+                const dimensions = await handler.getDimensions({
+                    includeCategories,
+                    includeTaxons,
+                });
+                return new Response(JSON.stringify({ dimensions }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            catch (error) {
+                logger_1.Logger.getInstance(env).error("Error listing dimensions:", error);
+                return new Response(JSON.stringify({ error: error.message || "Internal server error" }), {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+        },
+        middleware: [(0, middleware_1.corsMiddleware)()],
+        description: "List all taxonomy dimensions",
+    },
+    // Get dimension by code
+    {
+        path: "/api/taxonomy/dimensions/:dimensionCode",
+        method: "GET",
+        handler: async (request, env, params) => {
+            try {
+                const tenantId = await getTenantId(request, env);
+                const region = (0, region_detection_1.detectRegionSync)(request, env);
+                const db = (0, database_wrapper_helper_1.getWrappedDatabase)(region, env, request);
+                const handler = new taxonomy_handler_1.TaxonomyHandler(db, tenantId, env.TAXONOMY_CACHE_KV);
+                const dimensionCode = params?.params?.dimensionCode;
+                if (!dimensionCode) {
+                    return new Response(JSON.stringify({ error: "Dimension code required" }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                // Validate dimension code format
+                if (!/^[a-z-]+$/.test(dimensionCode)) {
+                    return new Response(JSON.stringify({
+                        error: "Invalid dimension code format",
+                        message: "Dimension code must contain only lowercase letters and hyphens",
+                    }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                const includeCategories = request.url.includes("includeCategories=true");
+                const includeTaxons = request.url.includes("includeTaxons=true");
+                const dimension = await handler.getDimensionByCode(dimensionCode, {
+                    includeCategories,
+                    includeTaxons,
+                });
+                if (!dimension) {
+                    return new Response(JSON.stringify({ error: "Dimension not found" }), {
+                        status: 404,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                return new Response(JSON.stringify({ dimension }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            catch (error) {
+                logger_1.Logger.getInstance(env).error("Error getting dimension:", error);
+                return new Response(JSON.stringify({ error: error.message || "Internal server error" }), {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+        },
+        middleware: [(0, middleware_1.corsMiddleware)()],
+        description: "Get dimension by code with categories and taxons",
+    },
+    // Search taxons
+    {
+        path: "/api/taxonomy/taxons/search",
+        method: "GET",
+        handler: async (request, env) => {
+            const startTime = Date.now();
+            let searchMetrics = null;
+            try {
+                const tenantId = await getTenantId(request, env);
+                const region = (0, region_detection_1.detectRegionSync)(request, env);
+                const db = (0, database_wrapper_helper_1.getWrappedDatabase)(region, env, request);
+                const handler = new taxonomy_handler_1.TaxonomyHandler(db, tenantId, env.TAXONOMY_CACHE_KV);
+                const url = new URL(request.url);
+                // Validate query parameters using Zod schema
+                const searchQuerySchema = zod_1.z.object({
+                    q: zod_1.z
+                        .string()
+                        .min(1)
+                        .max(200)
+                        .describe("Search query (1-200 characters)"),
+                    dimension: zod_1.z
+                        .string()
+                        .regex(/^[a-z-]+$/)
+                        .optional()
+                        .describe("Dimension code (lowercase letters and hyphens only)"),
+                    category: zod_1.z
+                        .string()
+                        .regex(/^[a-z-]+$/)
+                        .optional()
+                        .describe("Category code (lowercase letters and hyphens only)"),
+                    limit: zod_1.z.coerce
+                        .number()
+                        .int()
+                        .min(1)
+                        .transform((val) => Math.min(val, 50))
+                        .default(20)
+                        .describe("Result limit (1-50, capped at 50)"),
+                });
+                const params = {};
+                url.searchParams.forEach((value, key) => {
+                    params[key] = value;
+                });
+                let validatedParams;
+                try {
+                    validatedParams = searchQuerySchema.parse(params);
+                }
+                catch (error) {
+                    if (error.errors) {
+                        return new Response(JSON.stringify({
+                            error: "Invalid query parameters",
+                            details: error.errors.map((e) => ({
+                                path: e.path.join("."),
+                                message: e.message,
+                            })),
+                        }), {
+                            status: 400,
+                            headers: { "content-type": "application/json" },
+                        });
+                    }
+                    return new Response(JSON.stringify({ error: "Invalid query parameters" }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                const { q: query, dimension, category, limit } = validatedParams;
+                // Check query complexity (prevent DoS via complex queries)
+                // Count special characters that could make queries expensive
+                const specialCharCount = (query.match(/[^\w\s-]/g) || []).length;
+                if (specialCharCount > 20) {
+                    return new Response(JSON.stringify({
+                        error: "Query contains too many special characters",
+                        message: "Please simplify your search query",
+                    }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                // Sanitize query (prevent XSS)
+                const sanitizedQuery = input_sanitizer_1.InputSanitizer.sanitizeText(query.trim());
+                if (sanitizedQuery.length === 0) {
+                    return new Response(JSON.stringify({ error: "Invalid query" }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                // Apply rate limiting
+                const rateLimiter = new rate_limit_1.RateLimiter();
+                const rateLimitResponse = await rateLimiter.applyRateLimitKV(env, request, "/api/taxonomy/taxons/search", 100, // 100 searches per hour
+                3600);
+                if (rateLimitResponse) {
+                    return rateLimitResponse;
+                }
+                // Execute search with timeout
+                const searchPromise = handler.searchTaxons(sanitizedQuery, {
+                    dimension,
+                    category,
+                    limit: Math.min(limit, 50), // Max 50 results
+                });
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error("Search query timeout"));
+                    }, 5000); // 5 second timeout
+                });
+                const taxons = await Promise.race([searchPromise, timeoutPromise]);
+                // Track metrics
+                const metrics = new taxonomy_search_metrics_1.TaxonomySearchMetrics(env.SEARCH_METRICS_KV, true);
+                searchMetrics = {
+                    query: sanitizedQuery,
+                    resultCount: taxons.length,
+                    timestamp: Date.now(),
+                    dimension,
+                    category,
+                    tenantId,
+                };
+                await metrics.trackSearch(searchMetrics);
+                // Sanitize output
+                const sanitizedTaxons = taxons.map((taxon) => ({
+                    id: taxon.id,
+                    taxonId: taxon.taxonId,
+                    displayName: input_sanitizer_1.InputSanitizer.sanitizeText(taxon.displayName),
+                    description: taxon.description
+                        ? input_sanitizer_1.InputSanitizer.sanitizeText(taxon.description)
+                        : null,
+                    category: taxon.category
+                        ? {
+                            code: taxon.category.code,
+                            displayName: input_sanitizer_1.InputSanitizer.sanitizeText(taxon.category.displayName),
+                            dimension: taxon.category.dimension
+                                ? {
+                                    code: taxon.category.dimension.code,
+                                    displayName: input_sanitizer_1.InputSanitizer.sanitizeText(taxon.category.dimension.displayName),
+                                }
+                                : null,
+                        }
+                        : null,
+                }));
+                const responseTime = Date.now() - startTime;
+                return new Response(JSON.stringify({
+                    taxons: sanitizedTaxons,
+                    query: sanitizedQuery,
+                    count: sanitizedTaxons.length,
+                    responseTime,
+                }), {
+                    status: 200,
+                    headers: {
+                        "content-type": "application/json",
+                        "X-Response-Time": `${responseTime}ms`,
+                    },
+                });
+            }
+            catch (error) {
+                const responseTime = Date.now() - startTime;
+                // Track error metrics if we have the query
+                if (searchMetrics) {
+                    try {
+                        const metrics = new taxonomy_search_metrics_1.TaxonomySearchMetrics(env.SEARCH_METRICS_KV, true);
+                        await metrics.trackSearch({
+                            ...searchMetrics,
+                            resultCount: 0,
+                            error: error.message,
+                        });
+                    }
+                    catch (metricsError) {
+                        logger_1.Logger.getInstance(env).error("Error tracking search error metrics:", metricsError);
+                    }
+                }
+                logger_1.Logger.getInstance(env).error("Error searching taxons:", error);
+                // Don't expose internal error details
+                const errorMessage = error.message === "Search query timeout"
+                    ? "Search query timeout"
+                    : "Internal server error";
+                return new Response(JSON.stringify({
+                    error: errorMessage,
+                    responseTime,
+                }), {
+                    status: error.message === "Search query timeout" ? 504 : 500,
+                    headers: {
+                        "content-type": "application/json",
+                        "X-Response-Time": `${responseTime}ms`,
+                    },
+                });
+            }
+        },
+        middleware: [(0, middleware_1.corsMiddleware)()],
+        description: "Search taxonomy taxons by query string with full-text search",
+    },
+    // Get taxon by taxonId
+    {
+        path: "/api/taxonomy/taxons/:taxonId",
+        method: "GET",
+        handler: async (request, env, params) => {
+            try {
+                const tenantId = await getTenantId(request, env);
+                const region = (0, region_detection_1.detectRegionSync)(request, env);
+                const db = (0, database_wrapper_helper_1.getWrappedDatabase)(region, env, request);
+                const handler = new taxonomy_handler_1.TaxonomyHandler(db, tenantId, env.TAXONOMY_CACHE_KV);
+                const taxonId = params?.params?.taxonId;
+                if (!taxonId) {
+                    return new Response(JSON.stringify({ error: "Taxon ID required" }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                // Validate taxon ID format
+                if (!/^[a-z-]+:[a-z-]+:[a-z-]+$/.test(taxonId)) {
+                    return new Response(JSON.stringify({
+                        error: "Invalid taxon ID format",
+                        message: "Taxon ID must be in format: dimension:category:taxon",
+                    }), {
+                        status: 400,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                const taxon = await handler.getTaxonByTaxonId(taxonId);
+                if (!taxon) {
+                    return new Response(JSON.stringify({ error: "Taxon not found" }), {
+                        status: 404,
+                        headers: { "content-type": "application/json" },
+                    });
+                }
+                return new Response(JSON.stringify({ taxon }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            catch (error) {
+                logger_1.Logger.getInstance(env).error("Error getting taxon:", error);
+                return new Response(JSON.stringify({ error: error.message || "Internal server error" }), {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+        },
+        middleware: [(0, middleware_1.corsMiddleware)()],
+        description: "Get taxon by taxonId",
+    },
+];
+//# sourceMappingURL=taxonomy.js.map

package/dist/lib/routes/taxonomy.js.map

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

package/dist/lib/routes/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Route Types
+ *
+ * Shared types and interfaces for route definitions.
+ */
+import type { Env } from "../../env";
+import type { RequestContext } from "../request-context";
+import type { Middleware } from "../middleware";
+import type { RoutePattern } from "../route-matcher";
+export interface Route {
+    /**
+     * Route pattern (exact path, prefix with *, or regex)
+     * Examples:
+     * - '/health' (exact)
+     * - '/auth/*' (prefix)
+     * - '/api/users/:id' (with parameter)
+     * - /^\/api\/posts\/(\d+)$/ (regex)
+     */
+    path: RoutePattern;
+    /**
+     * HTTP method(s) - '*' for all methods, or specific method(s)
+     */
+    method?: string | string[];
+    /**
+     * Route handler function
+     */
+    handler: (request: Request, env: Env, context: {
+        url: URL;
+        pathname: string;
+        params: Record<string, string>;
+        requestContext?: RequestContext;
+    }) => Promise<Response>;
+    /**
+     * Middleware to apply (executed in order)
+     */
+    middleware?: Middleware[];
+    /**
+     * Route description (for documentation)
+     */
+    description?: string;
+    /**
+     * API version (for versioning support)
+     */
+    version?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/routes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/routes/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB;;;;;;;OAOG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE;QACP,GAAG,EAAE,GAAG,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/lib/routes/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Route Types
+ *
+ * Shared types and interfaces for route definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/routes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/routes/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/lib/routes/upload-sessions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Upload Session Routes
+ *
+ * Handles upload session management for optimistic image uploads.
+ * Provides endpoints for creating, managing, and completing upload sessions.
+ */
+import type { Route } from "./types";
+export declare const uploadSessionRoutes: Route[];
+//# sourceMappingURL=upload-sessions.d.ts.map

package/dist/lib/routes/upload-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-sessions.d.ts","sourceRoot":"","sources":["../../../src/lib/routes/upload-sessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAmWrC,eAAO,MAAM,mBAAmB,EAAE,KAAK,EAKtC,CAAC"}