mcp-wordpress 2.4.2 → 2.5.1

package/dist/src/utils/streaming.js

@@ -0,0 +1,331 @@
+/**
+ * Streaming utilities for handling large result sets
+ * Implements streaming responses for better performance and memory usage
+ */
+// Node.js streaming imports removed - not currently used but available for future enhancement
+import { sanitizeHtml } from "./validation/security.js";
+/**
+ * Creates a streaming response for large datasets
+ */
+export class DataStreamer {
+    batchSize;
+    delay;
+    transformItem;
+    filterItem;
+    constructor(options = {}) {
+        this.batchSize = options.batchSize || 50;
+        this.delay = options.delay || 0;
+        this.transformItem = options.transformItem || undefined;
+        this.filterItem = options.filterItem || undefined;
+    }
+    /**
+     * Processes data in batches with streaming
+     */
+    async *streamBatches(data, processor) {
+        const total = data.length;
+        let processed = 0;
+        for (let i = 0; i < data.length; i += this.batchSize) {
+            const batch = data.slice(i, i + this.batchSize);
+            // Apply filtering if provided
+            const filteredBatch = this.filterItem ? batch.filter(this.filterItem) : batch;
+            // Process the batch
+            const processedBatch = await processor(filteredBatch);
+            // Apply transformation if provided
+            const transformedBatch = this.transformItem
+                ? processedBatch.map((item) => this.transformItem(item))
+                : processedBatch;
+            processed += batch.length;
+            const hasMore = processed < total;
+            yield {
+                data: transformedBatch,
+                hasMore,
+                cursor: hasMore ? String(i + this.batchSize) : undefined,
+                total,
+                processed,
+            };
+            // Add delay between batches if specified
+            if (this.delay > 0 && hasMore) {
+                await new Promise((resolve) => setTimeout(resolve, this.delay));
+            }
+        }
+    }
+    /**
+     * Processes large datasets with pagination
+     */
+    async *streamPages(fetcher, processor) {
+        let page = 1;
+        let totalProcessed = 0;
+        while (true) {
+            const result = await fetcher(page, this.batchSize);
+            if (result.data.length === 0) {
+                break;
+            }
+            // Apply filtering if provided
+            const filteredData = this.filterItem ? result.data.filter(this.filterItem) : result.data;
+            // Process the data
+            const processedData = await processor(filteredData);
+            // Apply transformation if provided
+            const transformedData = this.transformItem
+                ? processedData.map((item) => this.transformItem(item))
+                : processedData;
+            totalProcessed += result.data.length;
+            yield {
+                data: transformedData,
+                hasMore: result.hasMore,
+                cursor: result.hasMore ? String(page + 1) : undefined,
+                total: undefined, // Unknown for paginated results
+                processed: totalProcessed,
+            };
+            if (!result.hasMore) {
+                break;
+            }
+            page++;
+            // Add delay between pages if specified
+            if (this.delay > 0) {
+                await new Promise((resolve) => setTimeout(resolve, this.delay));
+            }
+        }
+    }
+}
+/**
+ * Streaming formatter for WordPress data
+ */
+export class WordPressDataStreamer {
+    /**
+     * Streams WordPress posts with author and taxonomy information
+     */
+    static async *streamPosts(posts, options = {}) {
+        const streamer = new DataStreamer({
+            batchSize: options.batchSize || 20,
+            transformItem: (post) => {
+                const p = post;
+                const title = p.title;
+                const excerpt = p.excerpt;
+                return {
+                    id: p.id,
+                    title: title?.rendered || "Untitled",
+                    excerpt: excerpt?.rendered ? sanitizeHtml(String(excerpt.rendered)).substring(0, 150) + "..." : "No excerpt",
+                    status: p.status,
+                    date: new Date(String(p.date)).toLocaleDateString(),
+                    link: p.link,
+                    author: options.includeAuthor ? p.author : undefined,
+                    categories: options.includeCategories ? p.categories : undefined,
+                    tags: options.includeTags ? p.tags : undefined,
+                };
+            },
+            filterItem: (post) => {
+                const p = post;
+                return p.status !== "trash";
+            }, // Filter out trashed posts
+        });
+        const processor = async (batch) => {
+            // Simulate processing time for large datasets
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            return batch;
+        };
+        for await (const result of streamer.streamBatches(posts, processor)) {
+            yield result;
+        }
+    }
+    /**
+     * Streams WordPress users with role information
+     */
+    static async *streamUsers(users, options = {}) {
+        const streamer = new DataStreamer({
+            batchSize: options.batchSize || 30,
+            transformItem: (user) => {
+                const u = user;
+                return {
+                    id: u.id,
+                    name: u.name || "No name",
+                    username: u.slug || "unknown",
+                    email: u.email || "No email",
+                    roles: options.includeRoles ? u.roles : undefined,
+                    capabilities: options.includeCapabilities
+                        ? Object.keys(u.capabilities || {})
+                        : undefined,
+                    registeredDate: u.registered_date ? new Date(String(u.registered_date)).toLocaleDateString() : "Unknown",
+                };
+            },
+        });
+        const processor = async (batch) => {
+            // Add user processing logic here if needed
+            return batch;
+        };
+        for await (const result of streamer.streamBatches(users, processor)) {
+            yield result;
+        }
+    }
+    /**
+     * Streams WordPress comments with moderation status
+     */
+    static async *streamComments(comments, options = {}) {
+        const streamer = new DataStreamer({
+            batchSize: options.batchSize || 40,
+            transformItem: (comment) => {
+                const c = comment;
+                const content = c.content;
+                return {
+                    id: c.id,
+                    content: content?.rendered ? sanitizeHtml(String(content.rendered)).substring(0, 200) + "..." : "No content",
+                    status: c.status,
+                    date: new Date(String(c.date)).toLocaleDateString(),
+                    author: options.includeAuthor
+                        ? {
+                            name: c.author_name,
+                            email: c.author_email,
+                            url: c.author_url,
+                        }
+                        : undefined,
+                    post: options.includePost ? c.post : undefined,
+                };
+            },
+            filterItem: (comment) => {
+                const c = comment;
+                return c.status !== "spam";
+            }, // Filter out spam comments
+        });
+        const processor = async (batch) => {
+            // Add comment processing logic here if needed
+            return batch;
+        };
+        for await (const result of streamer.streamBatches(comments, processor)) {
+            yield result;
+        }
+    }
+}
+/**
+ * Utility functions for streaming responses
+ */
+export class StreamingUtils {
+    /**
+     * Formats streaming results for display
+     */
+    static formatStreamingResponse(results, type = "posts") {
+        const allData = results.flatMap((result) => result.data);
+        const totalProcessed = results[results.length - 1]?.processed || 0;
+        const hasMore = results[results.length - 1]?.hasMore || false;
+        const typeEmojis = {
+            posts: "📄",
+            users: "👥",
+            comments: "💬",
+            media: "📎",
+        };
+        const emoji = typeEmojis[type];
+        const typeName = type.charAt(0).toUpperCase() + type.slice(1);
+        let response = `${emoji} **${typeName} Results** (Streamed)\n\n`;
+        response += `📊 **Summary**: ${allData.length} items displayed, ${totalProcessed} processed total\n`;
+        if (hasMore) {
+            response += `⏳ **Status**: More data available (streaming in progress)\n`;
+        }
+        else {
+            response += `✅ **Status**: Complete\n`;
+        }
+        response += `🕐 **Retrieved**: ${new Date().toLocaleString()}\n\n`;
+        // Format individual items
+        allData.forEach((item, index) => {
+            // Type-safe property access
+            const itemObj = item;
+            const title = itemObj.title || itemObj.name || itemObj.content?.substring(0, 50) || "Item";
+            response += `${index + 1}. **${title}**\n`;
+            if (itemObj.excerpt)
+                response += `   📝 ${itemObj.excerpt}\n`;
+            if (itemObj.email)
+                response += `   📧 ${itemObj.email}\n`;
+            if (itemObj.status)
+                response += `   🏷️ Status: ${itemObj.status}\n`;
+            if (itemObj.date)
+                response += `   📅 Date: ${itemObj.date}\n`;
+            response += "\n";
+        });
+        return response;
+    }
+    /**
+     * Implements progressive loading for large datasets
+     */
+    static async loadProgressively(fetcher, options = {}) {
+        const initialLoad = options.initialLoad || 50;
+        const batchSize = options.batchSize || 25;
+        const maxItems = options.maxItems || 1000;
+        const results = [];
+        let offset = 0;
+        // Initial load
+        const initialBatch = await fetcher(offset, initialLoad);
+        results.push(...initialBatch);
+        offset += initialLoad;
+        if (options.onProgress) {
+            options.onProgress(results.length);
+        }
+        // Progressive loading
+        while (results.length < maxItems) {
+            const batch = await fetcher(offset, batchSize);
+            if (batch.length === 0) {
+                break;
+            }
+            results.push(...batch);
+            offset += batchSize;
+            if (options.onProgress) {
+                options.onProgress(results.length, maxItems);
+            }
+            // Small delay to prevent overwhelming the server
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        return results.slice(0, maxItems);
+    }
+}
+/**
+ * Memory-efficient data processor
+ */
+export class MemoryEfficientProcessor {
+    /**
+     * Processes large datasets with memory monitoring
+     */
+    static async processLargeDataset(dataProvider, processor, options = {}) {
+        const maxMemory = options.maxMemoryUsage || 100; // 100MB default
+        const batchSize = options.batchSize || 50;
+        const results = [];
+        let processed = 0;
+        for await (const batch of dataProvider()) {
+            // Check memory usage
+            const memoryUsage = process.memoryUsage();
+            const memoryUsageMB = memoryUsage.heapUsed / 1024 / 1024;
+            if (memoryUsageMB > maxMemory) {
+                // If memory usage is too high, process in smaller batches
+                const smallerBatches = this.chunkArray(batch, Math.floor(batchSize / 2));
+                for (const smallBatch of smallerBatches) {
+                    const processed_batch = await processor(smallBatch);
+                    results.push(...processed_batch);
+                    processed += smallBatch.length;
+                    if (options.onProgress) {
+                        options.onProgress(processed);
+                    }
+                    // Force garbage collection if available
+                    if (global.gc) {
+                        global.gc();
+                    }
+                }
+            }
+            else {
+                // Normal processing
+                const processed_batch = await processor(batch);
+                results.push(...processed_batch);
+                processed += batch.length;
+                if (options.onProgress) {
+                    options.onProgress(processed);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Helper method to split arrays into chunks
+     */
+    static chunkArray(array, chunkSize) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += chunkSize) {
+            chunks.push(array.slice(i, i + chunkSize));
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/src/utils/streaming.js.map

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

package/dist/src/utils/toolWrapper.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tool Wrapper Utility
+ * Standardizes error handling and reduces repetitive try-catch blocks
+ */
+import type { IWordPressClient } from '../types/client.js';
+import type { BaseToolParams } from '../types/tools.js';
+/**
+ * Wrapper for tool methods that standardizes error handling
+ */
+export declare function withErrorHandling<T extends readonly unknown[], R>(operation: string, fn: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+/**
+ * Wrapper for tool methods with validation
+ */
+export declare function withValidation<T extends readonly unknown[], R>(operation: string, validator: (...args: T) => void, fn: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+/**
+ * Common validation functions
+ */
+export declare const validators: {
+    requireSite: (client: IWordPressClient | null | undefined, params: BaseToolParams) => void;
+    requireId: (params: {
+        id?: number | string;
+    }) => void;
+    requireNonEmpty: (value: unknown, fieldName: string) => void;
+    requireFields: (params: Record<string, unknown>, fields: readonly string[]) => void;
+};
+/**
+ * Decorator for class methods to add error handling
+ */
+export declare function errorHandler(operation: string): (target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Helper to format success responses consistently
+ */
+export declare function formatSuccessResponse(content: string): string;
+/**
+ * Helper to format error responses consistently
+ */
+export declare function formatErrorResponse(operation: string, error: unknown): never;
+/**
+ * Simple tool wrapper for standalone async functions
+ */
+export declare function toolWrapper<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=toolWrapper.d.ts.map

package/dist/src/utils/toolWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolWrapper.d.ts","sourceRoot":"","sources":["../../../src/utils/toolWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EAC/D,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAQ5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EAC5D,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EAC/B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAS5B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;0BACC,gBAAgB,GAAG,IAAI,GAAG,SAAS,UAAU,cAAc;wBAM7D;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;6BAMnB,OAAO,aAAa,MAAM;4BAM3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,SAAS,MAAM,EAAE;CAO3E,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,IAC3B,QAAQ,OAAO,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAatF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAG5E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMrE"}

package/dist/src/utils/toolWrapper.js

@@ -0,0 +1,101 @@
+/**
+ * Tool Wrapper Utility
+ * Standardizes error handling and reduces repetitive try-catch blocks
+ */
+import { getErrorMessage } from "./error.js";
+/**
+ * Wrapper for tool methods that standardizes error handling
+ */
+export function withErrorHandling(operation, fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            throw new Error(`${operation}: ${getErrorMessage(error)}`);
+        }
+    };
+}
+/**
+ * Wrapper for tool methods with validation
+ */
+export function withValidation(operation, validator, fn) {
+    return async (...args) => {
+        try {
+            validator(...args);
+            return await fn(...args);
+        }
+        catch (error) {
+            throw new Error(`${operation}: ${getErrorMessage(error)}`);
+        }
+    };
+}
+/**
+ * Common validation functions
+ */
+export const validators = {
+    requireSite: (client, params) => {
+        if (!client) {
+            throw new Error("WordPress client is required");
+        }
+    },
+    requireId: (params) => {
+        if (!params.id) {
+            throw new Error("ID parameter is required");
+        }
+    },
+    requireNonEmpty: (value, fieldName) => {
+        if (!value || (typeof value === "string" && value.trim() === "")) {
+            throw new Error(`${fieldName} cannot be empty`);
+        }
+    },
+    requireFields: (params, fields) => {
+        for (const field of fields) {
+            if (params[field] === undefined || params[field] === null) {
+                throw new Error(`${field} is required`);
+            }
+        }
+    },
+};
+/**
+ * Decorator for class methods to add error handling
+ */
+export function errorHandler(operation) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            try {
+                return await originalMethod.apply(this, args);
+            }
+            catch (error) {
+                throw new Error(`${operation}: ${getErrorMessage(error)}`);
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Helper to format success responses consistently
+ */
+export function formatSuccessResponse(content) {
+    return content;
+}
+/**
+ * Helper to format error responses consistently
+ */
+export function formatErrorResponse(operation, error) {
+    const message = getErrorMessage(error);
+    throw new Error(`${operation}: ${message}`);
+}
+/**
+ * Simple tool wrapper for standalone async functions
+ */
+export async function toolWrapper(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw new Error(getErrorMessage(error));
+    }
+}
+//# sourceMappingURL=toolWrapper.js.map

package/dist/src/utils/toolWrapper.js.map

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

package/dist/src/utils/validation/core.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Core Validation Utilities
+ *
+ * Basic validation functions for common data types including IDs, strings, and arrays.
+ * These validators form the foundation for more specific validation logic.
+ */
+import { WordPressId } from "../../types/enhanced.js";
+/**
+ * Validates and sanitizes numeric IDs with comprehensive edge case handling
+ * Returns branded WordPress ID type for enhanced type safety
+ */
+export declare function validateId(id: unknown, fieldName?: string): WordPressId;
+/**
+ * Validates string length within bounds
+ */
+export declare function validateString(value: unknown, fieldName: string, minLength?: number, maxLength?: number): string;
+/**
+ * Validates arrays with size constraints and type safety
+ */
+export declare function validateArray<T>(value: unknown, fieldName: string, minItems?: number, maxItems?: number): T[];
+//# sourceMappingURL=core.d.ts.map

package/dist/src/utils/validation/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/utils/validation/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAqB,MAAM,yBAAyB,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,GAAE,MAAa,GAAG,WAAW,CA6C7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAa,GACvB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAY,GAAG,CAAC,EAAE,CAkBrH"}

package/dist/src/utils/validation/core.js

@@ -0,0 +1,71 @@
+/**
+ * Core Validation Utilities
+ *
+ * Basic validation functions for common data types including IDs, strings, and arrays.
+ * These validators form the foundation for more specific validation logic.
+ */
+import { WordPressAPIError } from "../../types/client.js";
+import { createWordPressId } from "../../types/enhanced.js";
+/**
+ * Validates and sanitizes numeric IDs with comprehensive edge case handling
+ * Returns branded WordPress ID type for enhanced type safety
+ */
+export function validateId(id, fieldName = "id") {
+    // Handle null/undefined
+    if (id === null || id === undefined) {
+        throw new WordPressAPIError(`${fieldName} is required`, 400, "MISSING_PARAMETER");
+    }
+    // Convert to string first to handle various input types
+    const strId = String(id).trim();
+    // Check for empty string after trim
+    if (strId === "") {
+        throw new WordPressAPIError(`${fieldName} cannot be empty`, 400, "INVALID_PARAMETER");
+    }
+    // Handle decimal inputs
+    if (strId.includes(".")) {
+        throw new WordPressAPIError(`${fieldName} must be a whole number, not a decimal`, 400, "INVALID_PARAMETER");
+    }
+    const numId = parseInt(strId, 10);
+    // Check for NaN
+    if (isNaN(numId)) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: "${id}" is not a valid number`, 400, "INVALID_PARAMETER");
+    }
+    // Check for negative or zero
+    if (numId <= 0) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: must be a positive number (got ${numId})`, 400, "INVALID_PARAMETER");
+    }
+    // Check for max int32 limit (WordPress database limit)
+    if (numId > 2147483647) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: exceeds maximum allowed value (2147483647)`, 400, "INVALID_PARAMETER");
+    }
+    return createWordPressId(numId);
+}
+/**
+ * Validates string length within bounds
+ */
+export function validateString(value, fieldName, minLength = 1, maxLength = 1000) {
+    if (typeof value !== "string") {
+        throw new WordPressAPIError(`Invalid ${fieldName}: must be a string`, 400, "INVALID_PARAMETER");
+    }
+    const trimmed = value.trim();
+    if (trimmed.length < minLength || trimmed.length > maxLength) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: length must be between ${minLength} and ${maxLength} characters`, 400, "INVALID_PARAMETER");
+    }
+    return trimmed;
+}
+/**
+ * Validates arrays with size constraints and type safety
+ */
+export function validateArray(value, fieldName, minItems = 0, maxItems = 100) {
+    if (!Array.isArray(value)) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: must be an array`, 400, "INVALID_PARAMETER");
+    }
+    if (value.length < minItems) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: must have at least ${minItems} items`, 400, "INVALID_PARAMETER");
+    }
+    if (value.length > maxItems) {
+        throw new WordPressAPIError(`Invalid ${fieldName}: cannot have more than ${maxItems} items`, 400, "INVALID_PARAMETER");
+    }
+    return value;
+}
+//# sourceMappingURL=core.js.map

package/dist/src/utils/validation/core.js.map

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

package/dist/src/utils/validation/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Validation Utilities - Modular Export Index
+ *
+ * This module re-exports all validation functions from their focused modules
+ * for backward compatibility and convenient imports.
+ *
+ * @example
+ * ```typescript
+ * // Import all validators (backward compatible)
+ * import { validateId, validateUrl, validatePostParams } from "./utils/validation";
+ *
+ * // Or import from specific modules
+ * import { validateId } from "./utils/validation/core";
+ * import { validateUrl } from "./utils/validation/network";
+ * import { validatePostParams } from "./utils/validation/wordpress";
+ * ```
+ */
+export { validateId, validateString, validateArray } from "./core.js";
+export { validateFilePath, validateFileSize, validateMimeType, sanitizeHtml } from "./security.js";
+export { validateUrl, validateEmail, validateUsername } from "./network.js";
+export { validatePostStatus, validateSearchQuery, validatePaginationParams, validatePostParams } from "./wordpress.js";
+export { RateLimiter, authRateLimiter } from "./rateLimit.js";
+export type { WordPressId } from "../../types/enhanced.js";
+export { WordPressAPIError } from "../../types/client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGnG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGvH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG9D,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}