@nindroidsystems/pluginator 2.3.0

package/dist/core/errors/workflow-result.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Workflow Result Type
+ *
+ * Standardized result type for workflows that can have partial failures.
+ * Workflows that process multiple items (e.g., syncing plugins, checking updates)
+ * should use this pattern to report both successes and failures.
+ */
+import type { PluginatorError } from './error-types.js';
+/**
+ * Workflow result with typed data and error handling
+ */
+export interface WorkflowResult<T> {
+    /** Whether the workflow completed successfully (no critical errors) */
+    success: boolean;
+    /** Result data (may be partial if some items failed) */
+    data?: T;
+    /** Errors that occurred during execution */
+    errors: PluginatorError[];
+    /** Non-critical warnings */
+    warnings: string[];
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Item-level result for batch operations
+ */
+export interface ItemResult<T> {
+    /** Item identifier (e.g., plugin name) */
+    id: string;
+    /** Whether this item succeeded */
+    success: boolean;
+    /** Item data if successful */
+    data?: T;
+    /** Error if failed */
+    error?: PluginatorError;
+    /** Warning message if applicable */
+    warning?: string;
+}
+/**
+ * Batch workflow result for operations on multiple items
+ */
+export interface BatchWorkflowResult<T> extends WorkflowResult<T[]> {
+    /** Results for each item */
+    items: ItemResult<T>[];
+    /** Count of successful items */
+    successCount: number;
+    /** Count of failed items */
+    failureCount: number;
+    /** Count of skipped items */
+    skippedCount: number;
+}
+/**
+ * Create a successful workflow result
+ */
+export declare function successResult<T>(data: T, duration: number, warnings?: string[]): WorkflowResult<T>;
+/**
+ * Create a failed workflow result
+ */
+export declare function failureResult<T>(errors: PluginatorError[], duration: number, partialData?: T, warnings?: string[]): WorkflowResult<T>;
+/**
+ * Create a batch workflow result from item results
+ */
+export declare function batchResult<T>(items: ItemResult<T>[], duration: number): BatchWorkflowResult<T>;
+/**
+ * Process items in batch with error handling
+ * Executes the processor for each item and collects results
+ */
+export declare function processBatch<TInput, TOutput>(items: TInput[], getId: (item: TInput) => string, processor: (item: TInput) => Promise<TOutput>, options?: {
+    /** Continue processing remaining items after an error */
+    continueOnError?: boolean;
+    /** Called for each item with progress */
+    onProgress?: (current: number, total: number, id: string) => void;
+}): Promise<BatchWorkflowResult<TOutput>>;
+/**
+ * Combine multiple workflow results into one
+ */
+export declare function combineResults<T>(results: WorkflowResult<T>[]): WorkflowResult<T[]>;
+/**
+ * Get a summary of workflow result for logging/display
+ */
+export declare function getResultSummary<T>(result: WorkflowResult<T>): string;
+/**
+ * Get batch result summary
+ */
+export declare function getBatchSummary<T>(result: BatchWorkflowResult<T>): string;
+//# sourceMappingURL=workflow-result.d.ts.map

package/dist/core/errors/workflow-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-result.d.ts","sourceRoot":"","sources":["../../../src/core/errors/workflow-result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,4CAA4C;IAC5C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,sBAAsB;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC;IACjE,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACvB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAQtG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAQzI;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAmB/F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,OAAO,EAChD,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC7C,OAAO,GAAE;IACP,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D,GACL,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAoCvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAsBnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAOrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,CAKzE"}

package/dist/core/export/export-service.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Export Service
+ *
+ * Handles exporting and importing Pluginator configuration.
+ *
+ * @since v1.31.0
+ */
+import { type ExportData, type ExportOptions, type FavoritesExportStore, type GroupsExportStore, type ImportOptions, type ImportPreview, type ImportResult, type ImportSummary, type PluginExportConfig, type ServerExportConfig, type SettingsExport, type TagsExportStore } from './export-types.js';
+/**
+ * Data providers interface for collecting export data
+ */
+export interface ExportDataProviders {
+    getPlugins?: () => PluginExportConfig[];
+    getServers?: () => ServerExportConfig[];
+    getFavorites?: () => FavoritesExportStore;
+    getTags?: () => TagsExportStore;
+    getGroups?: () => GroupsExportStore;
+    getSettings?: () => SettingsExport;
+    getFilterPreferences?: () => {
+        defaultFilters?: string[];
+        savedFilterSets?: Array<{
+            name: string;
+            filters: string[];
+        }>;
+    };
+}
+/**
+ * Data importers interface for applying import data
+ */
+export interface ImportDataHandlers {
+    importPlugins?: (plugins: PluginExportConfig[], mode: 'merge' | 'replace') => ImportSummary;
+    importServers?: (servers: ServerExportConfig[], mode: 'merge' | 'replace') => ImportSummary;
+    importFavorites?: (favorites: FavoritesExportStore, mode: 'merge' | 'replace') => ImportSummary;
+    importTags?: (tags: TagsExportStore, mode: 'merge' | 'replace') => ImportSummary;
+    importGroups?: (groups: GroupsExportStore, mode: 'merge' | 'replace') => ImportSummary;
+    importSettings?: (settings: SettingsExport, mode: 'merge' | 'replace') => void;
+}
+/**
+ * Current data providers interface for preview comparison
+ */
+export interface CurrentDataProviders {
+    getPluginNames?: () => string[];
+    getServerNames?: () => string[];
+    getFavoriteNames?: () => string[];
+    getTagIds?: () => string[];
+    getGroupIds?: () => string[];
+}
+/**
+ * Export service for configuration import/export
+ */
+export declare class ExportService {
+    private pluginatorVersion;
+    private providers;
+    private handlers;
+    private currentData;
+    constructor(pluginatorVersion: string, providers?: ExportDataProviders, handlers?: ImportDataHandlers, currentData?: CurrentDataProviders);
+    /**
+     * Set data providers
+     */
+    setProviders(providers: ExportDataProviders): void;
+    /**
+     * Set import handlers
+     */
+    setHandlers(handlers: ImportDataHandlers): void;
+    /**
+     * Set current data providers for preview
+     */
+    setCurrentDataProviders(providers: CurrentDataProviders): void;
+    /**
+     * Create export data
+     */
+    export(options?: ExportOptions): ExportData;
+    /**
+     * Export to string
+     */
+    exportToString(options?: ExportOptions): string;
+    /**
+     * Export to file
+     */
+    exportToFile(path: string, options?: ExportOptions): Promise<void>;
+    /**
+     * Import from data object
+     */
+    import(data: ExportData, options?: ImportOptions): ImportResult;
+    /**
+     * Import from string
+     */
+    importFromString(content: string, options?: ImportOptions): ImportResult;
+    /**
+     * Import from file
+     */
+    importFromFile(path: string, options?: ImportOptions): Promise<ImportResult>;
+    /**
+     * Import from URL
+     */
+    importFromUrl(url: string, options?: ImportOptions): Promise<ImportResult>;
+    /**
+     * Preview import changes
+     */
+    preview(data: ExportData, sourceName?: string): ImportPreview;
+    /**
+     * Preview from string
+     */
+    previewFromString(content: string, sourceName?: string): ImportPreview | null;
+    /**
+     * Validate export data
+     */
+    validate(data: unknown): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Verify checksum
+     */
+    verifyChecksum(data: ExportData): boolean;
+    /**
+     * Calculate checksum for data
+     */
+    private calculateChecksum;
+    /**
+     * Get change type based on whether item exists
+     */
+    private getChangeType;
+    /**
+     * Simulate import for dry run
+     */
+    private simulateImport;
+    /**
+     * Merge import summary into result
+     */
+    private mergeImportSummary;
+}
+/**
+ * Get the singleton export service
+ */
+export declare function getExportService(pluginatorVersion?: string): ExportService;
+/**
+ * Reset the singleton
+ */
+export declare function resetExportService(): void;
+//# sourceMappingURL=export-service.d.ts.map

package/dist/core/export/export-service.d.ts.map

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

package/dist/core/export/export-types.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Export/Import Types
+ *
+ * Type definitions for configuration export and import functionality.
+ *
+ * @since v1.31.0
+ */
+import type { PluginSourceType } from '../types/plugin.js';
+/**
+ * Export format version
+ */
+export declare const EXPORT_FORMAT_VERSION = "1.0";
+/**
+ * Supported export formats
+ */
+export type ExportFormat = 'json' | 'yaml';
+/**
+ * What's included in an export
+ */
+export interface ExportIncludes {
+    plugins: boolean;
+    servers: boolean;
+    favorites: boolean;
+    tags: boolean;
+    groups: boolean;
+    settings: boolean;
+    filterPreferences: boolean;
+}
+/**
+ * Export manifest with metadata
+ */
+export interface ExportManifest {
+    /** Export format version */
+    version: string;
+    /** Pluginator version that created export */
+    pluginatorVersion: string;
+    /** When the export was created */
+    exportedAt: string;
+    /** What's included in the export */
+    includes: ExportIncludes;
+    /** SHA-256 checksum for integrity verification */
+    checksum: string;
+}
+/**
+ * Plugin configuration for export
+ */
+export interface PluginExportConfig {
+    /** Plugin name */
+    name: string;
+    /** Source type */
+    source: PluginSourceType;
+    /** Source-specific identifier (Modrinth slug, Spigot ID, etc.) */
+    sourceId?: string;
+    /** Currently installed version */
+    version?: string;
+    /** Whether auto-update is enabled */
+    autoUpdate?: boolean;
+}
+/**
+ * Server configuration for export
+ */
+export interface ServerExportConfig {
+    /** Server display name */
+    name: string;
+    /** Server type */
+    type: 'production' | 'test';
+    /** Plugins directory path (sanitized with ${HOME}) */
+    pluginsPath: string;
+}
+/**
+ * Favorite entry for export
+ */
+export interface FavoriteExportEntry {
+    pluginName: string;
+    addedAt: string;
+    note?: string;
+}
+/**
+ * Pinned entry for export
+ */
+export interface PinnedExportEntry {
+    pluginName: string;
+    order: number;
+}
+/**
+ * Favorites store for export
+ */
+export interface FavoritesExportStore {
+    favorites: FavoriteExportEntry[];
+    pinned: PinnedExportEntry[];
+}
+/**
+ * Tag for export
+ */
+export interface TagExportEntry {
+    id: string;
+    name: string;
+    color: string;
+    isSystem?: boolean;
+}
+/**
+ * Tag assignment for export
+ */
+export interface TagAssignmentExport {
+    pluginName: string;
+    tagIds: string[];
+}
+/**
+ * Tags store for export
+ */
+export interface TagsExportStore {
+    tags: TagExportEntry[];
+    assignments: TagAssignmentExport[];
+}
+/**
+ * Group for export
+ */
+export interface GroupExportEntry {
+    id: string;
+    name: string;
+    color?: string;
+    icon?: string;
+    plugins: string[];
+    order: number;
+}
+/**
+ * Groups store for export
+ */
+export interface GroupsExportStore {
+    groups: GroupExportEntry[];
+}
+/**
+ * App settings for export
+ */
+export interface SettingsExport {
+    checkUpdatesOnStartup?: boolean;
+    defaultSource?: PluginSourceType;
+    backupBeforeUpdate?: boolean;
+    maxBackups?: number;
+    retentionDays?: number;
+}
+/**
+ * Filter preferences for export
+ */
+export interface FilterPreferencesExport {
+    defaultFilters?: string[];
+    savedFilterSets?: Array<{
+        name: string;
+        filters: string[];
+    }>;
+}
+/**
+ * Complete export data structure
+ */
+export interface ExportData {
+    manifest: ExportManifest;
+    plugins?: PluginExportConfig[];
+    servers?: ServerExportConfig[];
+    favorites?: FavoritesExportStore;
+    tags?: TagsExportStore;
+    groups?: GroupsExportStore;
+    settings?: SettingsExport;
+    filterPreferences?: FilterPreferencesExport;
+}
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    /** What to include in export */
+    includes?: Partial<ExportIncludes>;
+    /** Output format */
+    format?: ExportFormat;
+    /** Pretty print output */
+    pretty?: boolean;
+    /** Sanitize sensitive data (paths, etc.) */
+    sanitize?: boolean;
+    /** Compress output with gzip */
+    compress?: boolean;
+}
+/**
+ * Import mode
+ */
+export type ImportMode = 'merge' | 'replace';
+/**
+ * Conflict resolution strategy
+ */
+export type ConflictResolution = 'keep' | 'overwrite' | 'ask';
+/**
+ * Import options
+ */
+export interface ImportOptions {
+    /** How to handle existing data (defaults to 'merge') */
+    mode?: ImportMode;
+    /** Validate before import */
+    validate?: boolean;
+    /** Preview without applying */
+    dryRun?: boolean;
+    /** How to resolve conflicts */
+    conflictResolution?: ConflictResolution;
+}
+/**
+ * Import summary counts
+ */
+export interface ImportSummary {
+    plugins: number;
+    servers: number;
+    tags: number;
+    groups: number;
+    favorites: number;
+}
+/**
+ * Import error
+ */
+export interface ImportError {
+    /** Error category */
+    type: 'plugin' | 'server' | 'tag' | 'group' | 'favorite' | 'settings' | 'validation';
+    /** Item that caused the error */
+    item: string;
+    /** Error message */
+    error: string;
+}
+/**
+ * Import result
+ */
+export interface ImportResult {
+    success: boolean;
+    added: ImportSummary;
+    updated: ImportSummary;
+    skipped: ImportSummary;
+    errors: ImportError[];
+    warnings: string[];
+}
+/**
+ * Change type for preview
+ */
+export type ChangeType = 'add' | 'update' | 'unchanged' | 'conflict';
+/**
+ * Preview change item
+ */
+export interface PreviewChange {
+    type: ChangeType;
+    name: string;
+    category: 'plugin' | 'server' | 'tag' | 'group' | 'favorite';
+    details?: string;
+}
+/**
+ * Import preview
+ */
+export interface ImportPreview {
+    source: string;
+    version: string;
+    compatible: boolean;
+    warnings: string[];
+    changes: PreviewChange[];
+    summary: {
+        add: number;
+        update: number;
+        unchanged: number;
+        conflict: number;
+    };
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Compatibility result
+ */
+export interface CompatibilityResult {
+    compatible: boolean;
+    warnings: string[];
+    errors: string[];
+    migrationRequired: boolean;
+}
+/**
+ * Default export includes
+ */
+export declare const DEFAULT_EXPORT_INCLUDES: ExportIncludes;
+/**
+ * Default export options
+ */
+export declare const DEFAULT_EXPORT_OPTIONS: ExportOptions;
+/**
+ * Default import options
+ */
+export declare const DEFAULT_IMPORT_OPTIONS: ImportOptions;
+/**
+ * Create empty import summary
+ */
+export declare function createEmptyImportSummary(): ImportSummary;
+/**
+ * Create empty import result
+ */
+export declare function createEmptyImportResult(): ImportResult;
+//# sourceMappingURL=export-types.d.ts.map

package/dist/core/export/export-types.d.ts.map

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

package/dist/core/export/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Export Module
+ *
+ * Exports for configuration import/export functionality.
+ *
+ * @since v1.31.0
+ */
+export { type ChangeType, type CompatibilityResult, type ConflictResolution, type ExportData, type ExportFormat, type ExportIncludes, type ExportManifest, type ExportOptions, EXPORT_FORMAT_VERSION, type FavoriteExportEntry, type FavoritesExportStore, type FilterPreferencesExport, type GroupExportEntry, type GroupsExportStore, type ImportError, type ImportMode, type ImportOptions, type ImportPreview, type ImportResult, type ImportSummary, type PinnedExportEntry, type PluginExportConfig, type PreviewChange, type ServerExportConfig, type SettingsExport, type TagAssignmentExport, type TagExportEntry, type TagsExportStore, type ValidationResult, DEFAULT_EXPORT_OPTIONS, DEFAULT_IMPORT_OPTIONS, createEmptyImportResult, createEmptyImportSummary, } from './export-types.js';
+export { ExportService, type ExportDataProviders, type ImportDataHandlers, type CurrentDataProviders, getExportService, resetExportService, } from './export-service.js';
+export { validateExportData, checkCompatibility, checkPluginatorCompatibility, validateAndCheckCompatibility, isExportData, } from './validation.js';
+export { sanitizePath, expandPath, sanitizeServer, sanitizeSettings, sanitizeExport, expandExportPaths, containsSensitiveInfo, validateSanitization, HOME_PLACEHOLDER, } from './sanitize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/export/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,6BAA6B,EAC7B,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/core/export/sanitize.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Export Sanitization
+ *
+ * Utilities for sanitizing sensitive data in exports.
+ *
+ * @since v1.31.0
+ */
+import type { ExportData, ServerExportConfig, SettingsExport } from './export-types.js';
+/**
+ * Home directory placeholder used in exports
+ */
+export declare const HOME_PLACEHOLDER = "${HOME}";
+/**
+ * Sanitize a file path by replacing home directory with placeholder
+ */
+export declare function sanitizePath(path: string): string;
+/**
+ * Expand a sanitized path by replacing placeholder with home directory
+ */
+export declare function expandPath(path: string): string;
+/**
+ * Sanitize server configuration
+ */
+export declare function sanitizeServer(server: ServerExportConfig): ServerExportConfig;
+/**
+ * Sanitize settings by removing sensitive fields
+ */
+export declare function sanitizeSettings(settings: SettingsExport | undefined): SettingsExport | undefined;
+/**
+ * Sanitize entire export data
+ */
+export declare function sanitizeExport(data: ExportData): ExportData;
+/**
+ * Expand paths in import data
+ */
+export declare function expandExportPaths(data: ExportData): ExportData;
+/**
+ * Check if a path contains sensitive information
+ */
+export declare function containsSensitiveInfo(path: string): boolean;
+/**
+ * Validate that export data is properly sanitized
+ */
+export declare function validateSanitization(data: ExportData): {
+    valid: boolean;
+    issues: string[];
+};
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/core/export/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/core/export/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAK7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAyBjG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAM3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAQ9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAY3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB3F"}

package/dist/core/export/validation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Export Validation
+ *
+ * Schema validation for import/export data using Zod.
+ *
+ * @since v1.31.0
+ */
+import { type CompatibilityResult, type ExportData, type ValidationResult } from './export-types.js';
+/**
+ * Validate export data
+ */
+export declare function validateExportData(data: unknown): ValidationResult;
+/**
+ * Check compatibility with current version
+ */
+export declare function checkCompatibility(manifestVersion: string, currentVersion: string): CompatibilityResult;
+/**
+ * Check Pluginator version compatibility
+ */
+export declare function checkPluginatorCompatibility(exportVersion: string, currentVersion: string): CompatibilityResult;
+/**
+ * Validate and check compatibility in one call
+ */
+export declare function validateAndCheckCompatibility(data: unknown, currentPluginatorVersion: string): {
+    validation: ValidationResult;
+    compatibility: CompatibilityResult;
+};
+/**
+ * Type guard for ExportData
+ */
+export declare function isExportData(data: unknown): data is ExportData;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/export/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/export/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,mBAAmB,EAAyB,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiK5H;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAqBlE;AAkDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAgBvG;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAuB/G;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,wBAAwB,EAAE,MAAM,GAC/B;IACD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,EAAE,mBAAmB,CAAC;CACpC,CAyBA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE9D"}