@wildo-ai/zod-decorators 1.0.0

package/dist/esm/files/mime-registry.js

@@ -0,0 +1,174 @@
+/**
+ * File MIME Type Registry
+ *
+ * Core registry for general file types (images, videos, documents, etc.).
+ * Uses the `mime` library for authoritative extension ↔ MIME type mapping.
+ */
+import mime from 'mime';
+import { ExtensionToNatureMap } from './extension-nature-map.js';
+/**
+ * Extension normalization map.
+ * Maps common extension variations to canonical format names.
+ * Examples: 'jpg' → 'jpeg', 'jfif' → 'jpeg', 'm4a' → 'aac'
+ */
+const EXTENSION_NORMALIZATION_MAP = {
+    // Image formats
+    'jpg': 'jpeg',
+    'jpeg': 'jpeg',
+    'jfif': 'jpeg',
+    'png': 'png',
+    'gif': 'gif',
+    'webp': 'webp',
+    'svg': 'svg',
+    // Video formats
+    'mp4': 'mp4',
+    'webm': 'webm',
+    'mov': 'mov',
+    // Audio formats
+    'mp3': 'mp3',
+    'wav': 'wav',
+    'ogg': 'ogg',
+    'aac': 'aac',
+    'm4a': 'aac',
+    'm4b': 'aac',
+};
+/**
+ * Custom MIME type mappings for formats not well-supported by mime library.
+ */
+const CUSTOM_MIME_MAPPINGS = {
+// Add custom mappings here if needed
+// Example: 'custom': 'application/x-custom',
+};
+/**
+ * Core registry for general file types.
+ */
+export class FileMimeTypeRegistry {
+    /**
+     * Get MIME type from extension (using mime library + custom mappings).
+     *
+     * @param extension - File extension (without dot, case-insensitive)
+     * @returns MIME type string or undefined if not found
+     */
+    static getMimeType(extension) {
+        if (!extension)
+            return undefined;
+        const normalizedExt = extension.toLowerCase().trim();
+        // Check custom mappings first
+        if (CUSTOM_MIME_MAPPINGS[normalizedExt]) {
+            return CUSTOM_MIME_MAPPINGS[normalizedExt];
+        }
+        // Use mime library
+        const mimeType = mime.getType(normalizedExt);
+        return mimeType || undefined;
+    }
+    /**
+     * Get all extensions for a MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensions(mimeType) {
+        if (!mimeType)
+            return [];
+        const extensions = mime.getExtension(mimeType);
+        if (!extensions)
+            return [];
+        // mime.getExtension returns a single extension, but we want all possible extensions
+        // For now, return the primary extension. Full reverse mapping would require mime-db
+        return [extensions];
+    }
+    /**
+     * Normalize extension to canonical format name.
+     * Maps common extension variations to standard format names.
+     * Examples: 'jpg' → 'jpeg', 'jfif' → 'jpeg', 'm4a' → 'aac'
+     *
+     * @param extension - File extension (without dot)
+     * @returns Normalized format name
+     */
+    static normalizeExtension(extension) {
+        if (!extension)
+            return extension;
+        const normalizedExt = extension.toLowerCase().trim();
+        return EXTENSION_NORMALIZATION_MAP[normalizedExt] || normalizedExt;
+    }
+    /**
+     * Get FileNature from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns FileNature or undefined if not found
+     */
+    static getNatureFromExtension(extension) {
+        if (!extension)
+            return undefined;
+        const normalizedExt = extension.toLowerCase().trim();
+        return ExtensionToNatureMap[normalizedExt];
+    }
+    /**
+     * Get FileNature from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns FileNature or undefined if not found
+     */
+    static getNatureFromMimeType(mimeType) {
+        if (!mimeType)
+            return undefined;
+        // Get primary extension from MIME type
+        const extension = mime.getExtension(mimeType);
+        if (!extension)
+            return undefined;
+        return this.getNatureFromExtension(extension);
+    }
+    /**
+     * Validate that extension matches MIME type.
+     *
+     * @param extension - File extension (without dot)
+     * @param mimeType - MIME type string
+     * @returns true if extension matches MIME type, false otherwise
+     */
+    static validateExtensionMimeMatch(extension, mimeType) {
+        if (!extension || !mimeType)
+            return false;
+        const expectedMimeType = this.getMimeType(extension);
+        if (!expectedMimeType)
+            return false;
+        // Exact match
+        if (expectedMimeType === mimeType)
+            return true;
+        // Check for wildcard match (e.g., image/*)
+        const [expectedType] = expectedMimeType.split('/');
+        const [actualType] = mimeType.split('/');
+        if (expectedType === actualType && mimeType.endsWith('/*')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get extensions for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensionsForNature(nature) {
+        return Object.entries(ExtensionToNatureMap)
+            .filter(([_, n]) => n === nature)
+            .map(([ext]) => ext);
+    }
+    /**
+     * Get MIME types for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of MIME type strings
+     */
+    static getMimeTypesForNature(nature) {
+        const extensions = this.getExtensionsForNature(nature);
+        const mimeTypes = new Set();
+        for (const ext of extensions) {
+            const mimeType = this.getMimeType(ext);
+            if (mimeType) {
+                mimeTypes.add(mimeType);
+            }
+        }
+        return Array.from(mimeTypes);
+    }
+}
+//# sourceMappingURL=mime-registry.js.map

package/dist/esm/files/mime-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-registry.js","sourceRoot":"","sources":["../../../src/files/mime-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,2BAA2B,GAA2B;IAC1D,gBAAgB;IAChB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,KAAK;IACZ,gBAAgB;IAChB,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,KAAK;IACZ,gBAAgB;IAChB,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAA2B;AACnD,qCAAqC;AACrC,6CAA6C;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAiB;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAErD,8BAA8B;QAC9B,IAAI,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;YACxC,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7C,OAAO,QAAQ,IAAI,SAAS,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAE3B,oFAAoF;QACpF,oFAAoF;QACpF,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAiB;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,2BAA2B,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAiB;QAC7C,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAgB;QAC3C,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,uCAAuC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAiB,EAAE,QAAgB;QACnE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAEpC,cAAc;QACd,IAAI,gBAAgB,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE/C,2CAA2C;QAC3C,MAAM,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,YAAY,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAkB;QAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAkB;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/files/unified-registry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Unified File Format Registry
+ *
+ * Unified registry that handles both general files and agent/blueprint formats.
+ * Provides a single API for all file format operations.
+ */
+import { FileNature } from '../zod-decorators.types.js';
+/**
+ * Result type for format type detection.
+ * format is a string compatible with AppsBlueprint_FileFormat enum.
+ */
+export type FormatTypeResult = {
+    type: 'nature';
+    nature: FileNature;
+} | {
+    type: 'agent';
+    format: string;
+} | undefined;
+/**
+ * Unified registry for all file formats (general + agent).
+ */
+export declare class UnifiedFileFormatRegistry {
+    /**
+     * Extract file extension from filename (without dot, lowercase).
+     *
+     * @param filename - Full filename or path
+     * @returns File extension (without dot) or empty string if not found
+     */
+    static getFileExtension(filename: string): string;
+    /**
+     * Get MIME type from extension (works for both general files and agent formats).
+     *
+     * @param extension - File extension (without dot)
+     * @returns MIME type string or undefined if not found
+     */
+    static getMimeType(extension: string): string | undefined;
+    /**
+     * Get all extensions for a MIME type.
+     * Works for both general files and agent formats.
+     *
+     * @param mimeType - MIME type string
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensions(mimeType: string): string[];
+    /**
+     * Get format type (FileNature or AppsBlueprint_FileFormat) from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatType(extension: string): FormatTypeResult;
+    /**
+     * Get format type from extension (alias for getFormatType for consistency).
+     *
+     * @param extension - File extension (without dot)
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatTypeFromExtension(extension: string): FormatTypeResult;
+    /**
+     * Get format type from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatTypeFromMimeType(mimeType: string): FormatTypeResult;
+    /**
+     * Check if file is an agent/blueprint format.
+     *
+     * @param extension - File extension (without dot)
+     * @returns true if extension is an agent format
+     */
+    static isAgentFormat(extension: string): boolean;
+    /**
+     * Check if MIME type is an agent/blueprint format.
+     *
+     * @param mimeType - MIME type string
+     * @returns true if MIME type is an agent format
+     */
+    static isAgentMimeType(mimeType: string): boolean;
+    /**
+     * Validate that extension matches MIME type.
+     * Works for both general files and agent formats.
+     *
+     * @param extension - File extension (without dot)
+     * @param mimeType - MIME type string
+     * @returns true if extension matches MIME type
+     */
+    static validateExtensionMimeMatch(extension: string, mimeType: string): boolean;
+    /**
+     * Normalize extension to canonical format name.
+     * Works for both general files and agent formats.
+     *
+     * @param extension - File extension (without dot)
+     * @returns Normalized format name
+     */
+    static normalizeExtension(extension: string): string;
+    /**
+     * Get all extensions for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensionsForNature(nature: FileNature): string[];
+    /**
+     * Get all MIME types for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of MIME type strings
+     */
+    static getMimeTypesForNature(nature: FileNature): string[];
+}
+//# sourceMappingURL=unified-registry.d.ts.map

package/dist/esm/files/unified-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-registry.d.ts","sourceRoot":"","sources":["../../../src/files/unified-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAI7D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAOjD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAazD;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAchD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAkBzD;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAItE;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAkBpE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;;;;OAOG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAc/E;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAcpD;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;IAI3D;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;CAG3D"}

package/dist/esm/files/unified-registry.js

@@ -0,0 +1,190 @@
+/**
+ * Unified File Format Registry
+ *
+ * Unified registry that handles both general files and agent/blueprint formats.
+ * Provides a single API for all file format operations.
+ */
+import { FileMimeTypeRegistry } from './mime-registry.js';
+import { AgentFileFormatRegistry } from './agent-file-formats.js';
+/**
+ * Unified registry for all file formats (general + agent).
+ */
+export class UnifiedFileFormatRegistry {
+    /**
+     * Extract file extension from filename (without dot, lowercase).
+     *
+     * @param filename - Full filename or path
+     * @returns File extension (without dot) or empty string if not found
+     */
+    static getFileExtension(filename) {
+        if (!filename)
+            return '';
+        const lastDot = filename.lastIndexOf('.');
+        if (lastDot === -1 || lastDot === filename.length - 1)
+            return '';
+        return filename.substring(lastDot + 1).toLowerCase();
+    }
+    /**
+     * Get MIME type from extension (works for both general files and agent formats).
+     *
+     * @param extension - File extension (without dot)
+     * @returns MIME type string or undefined if not found
+     */
+    static getMimeType(extension) {
+        if (!extension)
+            return undefined;
+        // Check agent formats first (more specific)
+        const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);
+        if (agentFormat) {
+            return AgentFileFormatRegistry.getMimeType(agentFormat);
+        }
+        // Fall back to general file registry
+        return FileMimeTypeRegistry.getMimeType(extension);
+    }
+    /**
+     * Get all extensions for a MIME type.
+     * Works for both general files and agent formats.
+     *
+     * @param mimeType - MIME type string
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensions(mimeType) {
+        if (!mimeType)
+            return [];
+        // Check agent formats first
+        const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);
+        if (agentFormat) {
+            const ext = AgentFileFormatRegistry.getExtension(agentFormat);
+            return ext ? [ext] : [];
+        }
+        // Fall back to general file registry
+        return FileMimeTypeRegistry.getExtensions(mimeType);
+    }
+    /**
+     * Get format type (FileNature or AppsBlueprint_FileFormat) from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatType(extension) {
+        if (!extension)
+            return undefined;
+        // Check agent formats first (more specific)
+        const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);
+        if (agentFormat) {
+            return { type: 'agent', format: agentFormat };
+        }
+        // Check general file nature
+        const nature = FileMimeTypeRegistry.getNatureFromExtension(extension);
+        if (nature) {
+            return { type: 'nature', nature };
+        }
+        return undefined;
+    }
+    /**
+     * Get format type from extension (alias for getFormatType for consistency).
+     *
+     * @param extension - File extension (without dot)
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatTypeFromExtension(extension) {
+        return this.getFormatType(extension);
+    }
+    /**
+     * Get format type from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns FormatTypeResult indicating whether it's a nature or agent format
+     */
+    static getFormatTypeFromMimeType(mimeType) {
+        if (!mimeType)
+            return undefined;
+        // Check agent formats first (more specific)
+        const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);
+        if (agentFormat) {
+            return { type: 'agent', format: agentFormat };
+        }
+        // Check general file nature
+        const nature = FileMimeTypeRegistry.getNatureFromMimeType(mimeType);
+        if (nature) {
+            return { type: 'nature', nature };
+        }
+        return undefined;
+    }
+    /**
+     * Check if file is an agent/blueprint format.
+     *
+     * @param extension - File extension (without dot)
+     * @returns true if extension is an agent format
+     */
+    static isAgentFormat(extension) {
+        return AgentFileFormatRegistry.isAgentFormat(extension);
+    }
+    /**
+     * Check if MIME type is an agent/blueprint format.
+     *
+     * @param mimeType - MIME type string
+     * @returns true if MIME type is an agent format
+     */
+    static isAgentMimeType(mimeType) {
+        return AgentFileFormatRegistry.isAgentMimeType(mimeType);
+    }
+    /**
+     * Validate that extension matches MIME type.
+     * Works for both general files and agent formats.
+     *
+     * @param extension - File extension (without dot)
+     * @param mimeType - MIME type string
+     * @returns true if extension matches MIME type
+     */
+    static validateExtensionMimeMatch(extension, mimeType) {
+        if (!extension || !mimeType)
+            return false;
+        // Check agent formats first
+        const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);
+        if (agentFormat) {
+            const expectedMime = AgentFileFormatRegistry.getMimeType(agentFormat);
+            return expectedMime === mimeType;
+        }
+        // Fall back to general file validation
+        return FileMimeTypeRegistry.validateExtensionMimeMatch(extension, mimeType);
+    }
+    /**
+     * Normalize extension to canonical format name.
+     * Works for both general files and agent formats.
+     *
+     * @param extension - File extension (without dot)
+     * @returns Normalized format name
+     */
+    static normalizeExtension(extension) {
+        if (!extension)
+            return extension;
+        // Check if it's an agent format
+        const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);
+        if (agentFormat) {
+            // For agent formats, return the format name directly
+            return agentFormat;
+        }
+        // Use general file normalization
+        return FileMimeTypeRegistry.normalizeExtension(extension);
+    }
+    /**
+     * Get all extensions for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensionsForNature(nature) {
+        return FileMimeTypeRegistry.getExtensionsForNature(nature);
+    }
+    /**
+     * Get all MIME types for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of MIME type strings
+     */
+    static getMimeTypesForNature(nature) {
+        return FileMimeTypeRegistry.getMimeTypesForNature(nature);
+    }
+}
+//# sourceMappingURL=unified-registry.js.map

package/dist/esm/files/unified-registry.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare function initZodDecorators(zodInstance?: typeof z): typeof z;
+export * from './commons.js';
+export * from './zod-color.js';
+export * from './zod-range.js';
+export * from './zod-money.js';
+export * from './zod-bigdecimal.js';
+export * from './zod-duration.js';
+export * from './zod-phone.js';
+export * from './zod-code.js';
+export * from './zod-file.js';
+export * from './zod-versioned.js';
+export * from './currencies.shared.schemas.js';
+export * from './zod-utils.shared.js';
+export * from './zod-decorators.types.js';
+export * from './zod.module-override.js';
+export * from './files/file-extensions.enum.js';
+export * from './files/extension-nature-map.js';
+export * from './files/mime-registry.js';
+export * from './files/agent-file-formats.js';
+export * from './files/unified-registry.js';
+/**
+ * Initialize Zod decorators for the current Zod instance.
+ * Safe to call multiple times - will only apply decorators once.
+ *
+ * This function should be called early in your application startup,
+ * especially when using custom-shared-lib or custom-backend-lib packages.
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,OAAO,CAAK,GAAG,OAAO,CAAC,CAErE;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG"}

package/dist/esm/index.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { ensureZodDecoratorsLoaded } from './zod.module-override.js';
+// CRITICAL: Apply decorators immediately when this module is imported.
+// This ensures z.string().isUnique() etc. work without needing to call initZodDecorators().
+// The bundler may tree-shake the call in zod.module-override.ts, so we duplicate it here.
+ensureZodDecoratorsLoaded(z);
+export function initZodDecorators(zodInstance = z) {
+    return ensureZodDecoratorsLoaded(zodInstance);
+}
+export * from './commons.js';
+export * from './zod-color.js';
+export * from './zod-range.js';
+export * from './zod-money.js';
+export * from './zod-bigdecimal.js';
+export * from './zod-duration.js';
+export * from './zod-phone.js';
+export * from './zod-code.js';
+export * from './zod-file.js';
+export * from './zod-versioned.js';
+export * from './currencies.shared.schemas.js';
+export * from './zod-utils.shared.js';
+export * from './zod-decorators.types.js';
+export * from './zod.module-override.js';
+export * from './files/file-extensions.enum.js';
+export * from './files/extension-nature-map.js';
+export * from './files/mime-registry.js';
+export * from './files/agent-file-formats.js';
+export * from './files/unified-registry.js';
+/**
+ * Initialize Zod decorators for the current Zod instance.
+ * Safe to call multiple times - will only apply decorators once.
+ *
+ * This function should be called early in your application startup,
+ * especially when using custom-shared-lib or custom-backend-lib packages.
+ */
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,uEAAuE;AACvE,4FAA4F;AAC5F,0FAA0F;AAC1F,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAAC,cAAwB,CAAC;IACzD,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG"}

package/dist/esm/testing/decorated-test-schemas.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Canonical decorated Zod shapes for cross-layer tests (engine packages, apps).
+ *
+ * Importing this file runs `ensureZodDecoratorsLoaded(z)` for the current `zod` instance,
+ * then builds schemas using chainable decorators (same pattern as package tests).
+ */
+import { z } from 'zod';
+/**
+ * Minimal “resource row” with primary key, summary, FK, and backend-only fields.
+ */
+export declare const decoratedTestEntitySchema: z.ZodObject<{
+    _id: import("../index.js").DecoratedPrimitiveZodType<z.ZodString>;
+    title: import("../index.js").DecoratedPrimitiveZodType<z.ZodString>;
+    ownerId: import("../index.js").DecoratedPrimitiveZodType<z.ZodString>;
+    internalNote: import("../index.js").DecoratedPrimitiveZodType<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/**
+ * Variant-style row with a discriminator enum + summary field.
+ */
+export declare const decoratedTestVariantSchema: z.ZodObject<{
+    kind: import("../index.js").DecoratedPrimitiveZodType<z.ZodEnum<{
+        B: "B";
+        A: "A";
+    }>>;
+    label: import("../index.js").DecoratedPrimitiveZodType<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+//# sourceMappingURL=decorated-test-schemas.d.ts.map

package/dist/esm/testing/decorated-test-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorated-test-schemas.d.ts","sourceRoot":"","sources":["../../../src/testing/decorated-test-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;uCAKpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;uCAGrC,CAAC"}

package/dist/esm/testing/decorated-test-schemas.js

@@ -0,0 +1,26 @@
+/**
+ * Canonical decorated Zod shapes for cross-layer tests (engine packages, apps).
+ *
+ * Importing this file runs `ensureZodDecoratorsLoaded(z)` for the current `zod` instance,
+ * then builds schemas using chainable decorators (same pattern as package tests).
+ */
+import { z } from 'zod';
+import { ensureZodDecoratorsLoaded } from '../zod.module-override.js';
+ensureZodDecoratorsLoaded(z);
+/**
+ * Minimal “resource row” with primary key, summary, FK, and backend-only fields.
+ */
+export const decoratedTestEntitySchema = z.object({
+    _id: z.string().isPrimaryKey(),
+    title: z.string().isSummaryField(),
+    ownerId: z.string().isForeignKey(),
+    internalNote: z.string().isBackendOnly(),
+});
+/**
+ * Variant-style row with a discriminator enum + summary field.
+ */
+export const decoratedTestVariantSchema = z.object({
+    kind: z.enum(['A', 'B']).isDiscriminator(),
+    label: z.string().isSummaryField(),
+});
+//# sourceMappingURL=decorated-test-schemas.js.map

package/dist/esm/testing/decorated-test-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorated-test-schemas.js","sourceRoot":"","sources":["../../../src/testing/decorated-test-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE;CACzC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE;CACnC,CAAC,CAAC"}

package/dist/esm/testing.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public testing surface for @wildo-ai/zod-decorators.
+ * Import from `@wildo-ai/zod-decorators/testing`.
+ */
+export * from './testing/decorated-test-schemas.js';
+//# sourceMappingURL=testing.d.ts.map

package/dist/esm/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kCAAkC,CAAC"}

package/dist/esm/testing.js

@@ -0,0 +1,6 @@
+/**
+ * Public testing surface for @wildo-ai/zod-decorators.
+ * Import from `@wildo-ai/zod-decorators/testing`.
+ */
+export * from './testing/decorated-test-schemas.js';
+//# sourceMappingURL=testing.js.map

package/dist/esm/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kCAAkC,CAAC"}