@revealui/core 0.0.0-canary-20260409021642

package/dist/api/payload-optimization.js

@@ -0,0 +1,320 @@
+/**
+ * API Payload Optimization
+ *
+ * Reduces payload size through field selection, pagination, and data transformation
+ */
+/**
+ * Paginate array of items
+ */
+export function paginateArray(items, options = {}) {
+    const { page = 1, limit = options.defaultLimit || 20, maxLimit = 100 } = options;
+    // Enforce max limit
+    const effectiveLimit = Math.min(limit, maxLimit);
+    // Calculate offset
+    const offset = (page - 1) * effectiveLimit;
+    // Slice data
+    const data = items.slice(offset, offset + effectiveLimit);
+    return {
+        data,
+        pagination: {
+            page,
+            limit: effectiveLimit,
+            total: items.length,
+            hasMore: offset + effectiveLimit < items.length,
+        },
+    };
+}
+/**
+ * Create cursor for cursor-based pagination
+ */
+export function createCursor(item, field = 'id') {
+    const value = item[field];
+    return Buffer.from(JSON.stringify({ field, value })).toString('base64');
+}
+/**
+ * Parse cursor
+ */
+export function parseCursor(cursor) {
+    try {
+        const decoded = Buffer.from(cursor, 'base64').toString('utf-8');
+        return JSON.parse(decoded);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Select fields from object
+ */
+export function selectFields(obj, options) {
+    const { include, exclude, defaultFields } = options;
+    // If include is specified, only include those fields
+    if (include && include.length > 0) {
+        const result = {};
+        for (const field of include) {
+            if (field in obj) {
+                result[field] = obj[field];
+            }
+        }
+        return result;
+    }
+    // If exclude is specified, exclude those fields
+    if (exclude && exclude.length > 0) {
+        const result = { ...obj };
+        for (const field of exclude) {
+            delete result[field];
+        }
+        return result;
+    }
+    // Use default fields
+    if (defaultFields && defaultFields.length > 0) {
+        const result = {};
+        for (const field of defaultFields) {
+            if (field in obj) {
+                result[field] = obj[field];
+            }
+        }
+        return result;
+    }
+    // Return all fields
+    return obj;
+}
+/**
+ * Select fields from array of objects
+ */
+export function selectFieldsFromArray(items, options) {
+    return items.map((item) => selectFields(item, options));
+}
+/**
+ * Remove null and undefined values
+ */
+export function removeEmpty(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== null && value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Flatten nested object
+ */
+export function flattenObject(obj, prefix = '') {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const newKey = prefix ? `${prefix}.${key}` : key;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            Object.assign(result, flattenObject(value, newKey));
+        }
+        else {
+            result[newKey] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Minimize JSON response size
+ */
+export function minimizeJSON(data) {
+    return JSON.stringify(data, null, 0);
+}
+/**
+ * Format JSON response (for development)
+ */
+export function formatJSON(data) {
+    return JSON.stringify(data, null, 2);
+}
+/**
+ * Remove sensitive fields
+ */
+export function sanitizeResponse(obj, sensitiveFields = ['password', 'secret', 'token', 'apiKey']) {
+    return selectFields(obj, { exclude: sensitiveFields });
+}
+/**
+ * Transform timestamps to ISO strings
+ */
+export function transformDates(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value instanceof Date) {
+            result[key] = value.toISOString();
+        }
+        else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            result[key] = transformDates(value);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map((item) => typeof item === 'object' && item !== null
+                ? transformDates(item)
+                : item);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Calculate payload size in bytes
+ */
+export function getPayloadSize(data) {
+    const json = JSON.stringify(data);
+    return new Blob([json]).size;
+}
+/**
+ * Get payload size in human-readable format
+ */
+export function formatPayloadSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+export function optimizePayload(data, options = {}) {
+    const originalSize = getPayloadSize(data);
+    let optimized = data;
+    // Select fields
+    if (Array.isArray(data)) {
+        optimized = selectFieldsFromArray(data, options);
+    }
+    else if (typeof data === 'object' && data !== null) {
+        optimized = selectFields(data, options);
+    }
+    // Remove empty values
+    if (options.removeEmpty) {
+        if (Array.isArray(optimized)) {
+            optimized = optimized.map((item) => removeEmpty(item));
+        }
+        else if (optimized !== null && typeof optimized === 'object') {
+            optimized = removeEmpty(optimized);
+        }
+    }
+    // Transform dates
+    if (options.transformDates) {
+        if (Array.isArray(optimized)) {
+            optimized = optimized.map((item) => transformDates(item));
+        }
+        else if (optimized !== null && typeof optimized === 'object') {
+            optimized = transformDates(optimized);
+        }
+    }
+    // Sanitize
+    if (options.sanitize) {
+        if (Array.isArray(optimized)) {
+            optimized = optimized.map((item) => sanitizeResponse(item));
+        }
+        else if (optimized !== null && typeof optimized === 'object') {
+            optimized = sanitizeResponse(optimized);
+        }
+    }
+    const optimizedSize = getPayloadSize(optimized);
+    const savings = originalSize - optimizedSize;
+    const savingsPercent = (savings / originalSize) * 100;
+    return {
+        data: optimized,
+        originalSize,
+        optimizedSize,
+        savings,
+        savingsPercent,
+    };
+}
+/**
+ * Create API response with optimized payload
+ */
+export function createOptimizedResponse(data, options = {}) {
+    let result = data;
+    // Paginate if array
+    if (Array.isArray(data) && options.pagination) {
+        const paginated = paginateArray(data, options.pagination);
+        result = {
+            data: paginated.data,
+            meta: {
+                pagination: paginated.pagination,
+            },
+        };
+    }
+    // Optimize payload
+    if (options.optimize) {
+        const optimized = optimizePayload(result, options.fields || {});
+        const resultWithMeta = result;
+        return {
+            data: optimized.data,
+            meta: {
+                ...(resultWithMeta.meta && typeof resultWithMeta.meta === 'object'
+                    ? resultWithMeta.meta
+                    : {}),
+                size: {
+                    original: formatPayloadSize(optimized.originalSize),
+                    optimized: formatPayloadSize(optimized.optimizedSize),
+                    savings: `${optimized.savingsPercent.toFixed(1)}%`,
+                },
+            },
+        };
+    }
+    return { data: result };
+}
+/**
+ * Parse field selection from query params
+ */
+export function parseFieldsFromQuery(query) {
+    const params = new URLSearchParams(query);
+    const include = params.get('fields')?.split(',').filter(Boolean);
+    const exclude = params.get('exclude')?.split(',').filter(Boolean);
+    return {
+        include,
+        exclude,
+    };
+}
+/**
+ * Parse pagination from query params
+ */
+export function parsePaginationFromQuery(query) {
+    const params = new URLSearchParams(query);
+    const page = parseInt(params.get('page') || '1', 10);
+    const limit = parseInt(params.get('limit') || '20', 10);
+    const cursor = params.get('cursor') || undefined;
+    return {
+        page,
+        limit,
+        cursor,
+    };
+}
+/**
+ * Batch responses to reduce round trips
+ */
+export function batchResponses(responses) {
+    const result = {};
+    for (const { key, data } of responses) {
+        result[key] = data;
+    }
+    return result;
+}
+/**
+ * Create partial response (for large objects)
+ */
+export function createPartialResponse(obj, maxDepth = 2, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return '[truncated]';
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (Array.isArray(value)) {
+            result[key] = value
+                .slice(0, 10)
+                .map((item) => typeof item === 'object' && item !== null
+                ? createPartialResponse(item, maxDepth, currentDepth + 1)
+                : item);
+            if (value.length > 10) {
+                result[`${key}_count`] = value.length;
+            }
+        }
+        else if (value !== null && typeof value === 'object') {
+            result[key] = createPartialResponse(value, maxDepth, currentDepth + 1);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/api/rate-limit.d.ts

@@ -0,0 +1,114 @@
+/**
+ * API Rate Limiting
+ *
+ * Implements rate limiting to prevent API abuse
+ */
+import { type NextRequest, NextResponse } from 'next/server';
+interface RateLimitConfig {
+    windowMs: number;
+    maxRequests: number;
+    keyGenerator?: (request: NextRequest) => string;
+    skip?: (request: NextRequest) => boolean;
+    handler?: (request: NextRequest) => NextResponse;
+}
+interface RateLimitEntry {
+    count: number;
+    resetTime: number;
+}
+/**
+ * Check if rate limit exceeded
+ */
+export declare function checkRateLimit(request: NextRequest, config: RateLimitConfig): {
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    resetTime: number;
+};
+/**
+ * Create rate limit middleware
+ */
+export declare function createRateLimitMiddleware(config: RateLimitConfig): (request: NextRequest, next: () => Promise<NextResponse>) => Promise<NextResponse<unknown>>;
+/**
+ * Cleanup expired rate limit entries across all stores
+ */
+export declare function cleanupRateLimits(): number;
+/**
+ * Start rate limit cleanup interval
+ */
+export declare function startRateLimitCleanup(intervalMs?: number): NodeJS.Timeout;
+/**
+ * Get rate limit stats
+ */
+export declare function getRateLimitStats(): {
+    total: number;
+    active: number;
+    expired: number;
+};
+/**
+ * Rate limit preset configuration
+ */
+export interface RateLimitPresetConfig {
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Maximum requests per window */
+    maxRequests: number;
+}
+/**
+ * Override one or more rate limit presets.
+ *
+ * Unknown keys create new presets; existing keys are merged with defaults.
+ */
+export declare function configureRateLimitPresets(overrides: Record<string, Partial<RateLimitPresetConfig>>): void;
+/**
+ * Get the current (possibly overridden) rate limit presets.
+ */
+export declare function getRateLimitPresets(): Readonly<Record<string, RateLimitPresetConfig>>;
+/**
+ * Reset all presets to their defaults.
+ */
+export declare function resetRateLimitPresets(): void;
+/**
+ * Rate limit presets — backward-compatible accessor.
+ *
+ * Reads from the mutable `rateLimitPresets` so overrides from
+ * `configureRateLimitPresets()` are reflected automatically.
+ */
+export declare const RATE_LIMIT_PRESETS: Record<string, RateLimitPresetConfig>;
+/**
+ * Rate limit by user ID
+ */
+export declare function createUserRateLimit(config: Omit<RateLimitConfig, 'keyGenerator'>): (request: NextRequest, next: () => Promise<NextResponse>) => Promise<NextResponse<unknown>>;
+/**
+ * Rate limit by API key
+ */
+export declare function createAPIKeyRateLimit(config: Omit<RateLimitConfig, 'keyGenerator'>): (request: NextRequest, next: () => Promise<NextResponse>) => Promise<NextResponse<unknown>>;
+/**
+ * Rate limit by endpoint
+ */
+export declare function createEndpointRateLimit(config: Omit<RateLimitConfig, 'keyGenerator'>): (request: NextRequest, next: () => Promise<NextResponse>) => Promise<NextResponse<unknown>>;
+export declare function checkSlidingWindowRateLimit(request: NextRequest, config: RateLimitConfig): {
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+};
+export declare function checkTokenBucketRateLimit(request: NextRequest, config: RateLimitConfig & {
+    refillRate: number;
+}): {
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+};
+/**
+ * Clear rate limit for specific key
+ */
+export declare function clearRateLimit(key: string): void;
+/**
+ * Clear all rate limits
+ */
+export declare function clearAllRateLimits(): void;
+/**
+ * Get rate limit info for key
+ */
+export declare function getRateLimitInfo(key: string): RateLimitEntry | null;
+export {};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/api/rate-limit.d.ts.map

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