@wildo-ai/zod-decorators 1.0.0

package/dist/esm/files/agent-file-formats.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Agent/Blueprint File Format Registry
+ *
+ * Handles file formats specific to agent/blueprint operations.
+ * Maps AppsBlueprint_FileFormat to extensions and MIME types.
+ *
+ * NOTE: This registry uses string literals that match AppsBlueprint_FileFormat
+ * and AppsBlueprint_FileMimes from @wildo-ai/saas-models to avoid circular
+ * dependencies. The registry methods return/accept these string values which
+ * are compatible with the enums defined in saas-models.
+ */
+/**
+ * Agent/Blueprint file format string literals.
+ * These match AppsBlueprint_FileFormat enum values from @wildo-ai/saas-models.
+ */
+export declare const AgentFileFormat: {
+    readonly TEXT: "text";
+    readonly TYPESCRIPT: "typescript";
+    readonly TYPESCRIPT_JSX: "typescript_react";
+    readonly MARKDOWN: "markdown";
+    readonly JSON: "json";
+    readonly YAML: "yaml";
+};
+/**
+ * Agent/Blueprint file MIME type string literals.
+ * These match AppsBlueprint_FileMimes enum values from @wildo-ai/saas-models.
+ */
+export declare const AgentFileMime: {
+    readonly TEXT_PLAIN: "text/plain";
+    readonly MARKDOWN: "text/markdown";
+    readonly JSON: "application/json";
+    readonly TYPESCRIPT: "application/typescript";
+    readonly TYPESCRIPT_JSX: "application/typescript-jsx";
+    readonly YAML: "application/yaml";
+};
+/**
+ * Type for agent file format (compatible with AppsBlueprint_FileFormat).
+ */
+export type AgentFileFormatType = typeof AgentFileFormat[keyof typeof AgentFileFormat];
+/**
+ * Registry for agent/blueprint file formats.
+ */
+export declare class AgentFileFormatRegistry {
+    /**
+     * Get MIME type for AppsBlueprint_FileFormat.
+     *
+     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @returns MIME type string
+     */
+    static getMimeType(format: string): string;
+    /**
+     * Get extension for AppsBlueprint_FileFormat.
+     *
+     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @returns Extension string (without dot)
+     */
+    static getExtension(format: string): string;
+    /**
+     * Get AppsBlueprint_FileFormat from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     */
+    static getFormatFromExtension(extension: string): string | undefined;
+    /**
+     * Get AppsBlueprint_FileFormat from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     */
+    static getFormatFromMimeType(mimeType: string): string | undefined;
+    /**
+     * Check if extension is an agent file 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 file format.
+     *
+     * @param mimeType - MIME type string
+     * @returns true if MIME type is an agent format
+     */
+    static isAgentMimeType(mimeType: string): boolean;
+    /**
+     * Get all agent format extensions.
+     *
+     * @returns Array of extension strings
+     */
+    static getAllExtensions(): string[];
+    /**
+     * Get all agent format MIME types.
+     *
+     * @returns Array of MIME type strings
+     */
+    static getAllMimeTypes(): string[];
+}
+//# sourceMappingURL=agent-file-formats.d.ts.map

package/dist/esm/files/agent-file-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file-formats.d.ts","sourceRoot":"","sources":["../../../src/files/agent-file-formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAoDvF;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpE;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOlE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAInC;;;;OAIG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM,EAAE;CAGnC"}

package/dist/esm/files/agent-file-formats.js

@@ -0,0 +1,163 @@
+/**
+ * Agent/Blueprint File Format Registry
+ *
+ * Handles file formats specific to agent/blueprint operations.
+ * Maps AppsBlueprint_FileFormat to extensions and MIME types.
+ *
+ * NOTE: This registry uses string literals that match AppsBlueprint_FileFormat
+ * and AppsBlueprint_FileMimes from @wildo-ai/saas-models to avoid circular
+ * dependencies. The registry methods return/accept these string values which
+ * are compatible with the enums defined in saas-models.
+ */
+/**
+ * Agent/Blueprint file format string literals.
+ * These match AppsBlueprint_FileFormat enum values from @wildo-ai/saas-models.
+ */
+export const AgentFileFormat = {
+    TEXT: 'text',
+    TYPESCRIPT: 'typescript',
+    TYPESCRIPT_JSX: 'typescript_react',
+    MARKDOWN: 'markdown',
+    JSON: 'json',
+    YAML: 'yaml',
+};
+/**
+ * Agent/Blueprint file MIME type string literals.
+ * These match AppsBlueprint_FileMimes enum values from @wildo-ai/saas-models.
+ */
+export const AgentFileMime = {
+    TEXT_PLAIN: 'text/plain',
+    MARKDOWN: 'text/markdown',
+    JSON: 'application/json',
+    TYPESCRIPT: 'application/typescript',
+    TYPESCRIPT_JSX: 'application/typescript-jsx',
+    YAML: 'application/yaml',
+};
+/**
+ * Maps AppsBlueprint_FileFormat to MIME types.
+ */
+const FORMAT_TO_MIME = {
+    [AgentFileFormat.TEXT]: AgentFileMime.TEXT_PLAIN,
+    [AgentFileFormat.MARKDOWN]: AgentFileMime.MARKDOWN,
+    [AgentFileFormat.JSON]: AgentFileMime.JSON,
+    [AgentFileFormat.TYPESCRIPT]: AgentFileMime.TYPESCRIPT,
+    [AgentFileFormat.TYPESCRIPT_JSX]: AgentFileMime.TYPESCRIPT_JSX,
+    [AgentFileFormat.YAML]: AgentFileMime.YAML,
+};
+/**
+ * Maps AppsBlueprint_FileFormat to extensions.
+ */
+const FORMAT_TO_EXTENSION = {
+    [AgentFileFormat.TEXT]: 'txt',
+    [AgentFileFormat.MARKDOWN]: 'md',
+    [AgentFileFormat.JSON]: 'json',
+    [AgentFileFormat.TYPESCRIPT]: 'ts',
+    [AgentFileFormat.TYPESCRIPT_JSX]: 'tsx',
+    [AgentFileFormat.YAML]: 'yaml',
+};
+/**
+ * Reverse mapping: extension to AppsBlueprint_FileFormat.
+ */
+const EXTENSION_TO_FORMAT = {
+    'txt': AgentFileFormat.TEXT,
+    'md': AgentFileFormat.MARKDOWN,
+    'json': AgentFileFormat.JSON,
+    'ts': AgentFileFormat.TYPESCRIPT,
+    'tsx': AgentFileFormat.TYPESCRIPT_JSX,
+    'yaml': AgentFileFormat.YAML,
+    'yml': AgentFileFormat.YAML, // Alternative extension for YAML
+};
+/**
+ * Reverse mapping: MIME type to AppsBlueprint_FileFormat.
+ */
+const MIME_TO_FORMAT = {
+    'text/plain': AgentFileFormat.TEXT,
+    'text/markdown': AgentFileFormat.MARKDOWN,
+    'application/json': AgentFileFormat.JSON,
+    'application/typescript': AgentFileFormat.TYPESCRIPT,
+    'application/typescript-jsx': AgentFileFormat.TYPESCRIPT_JSX,
+    'application/yaml': AgentFileFormat.YAML,
+    'text/yaml': AgentFileFormat.YAML, // Alternative MIME type
+};
+/**
+ * Registry for agent/blueprint file formats.
+ */
+export class AgentFileFormatRegistry {
+    /**
+     * Get MIME type for AppsBlueprint_FileFormat.
+     *
+     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @returns MIME type string
+     */
+    static getMimeType(format) {
+        return FORMAT_TO_MIME[format] || '';
+    }
+    /**
+     * Get extension for AppsBlueprint_FileFormat.
+     *
+     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @returns Extension string (without dot)
+     */
+    static getExtension(format) {
+        return FORMAT_TO_EXTENSION[format] || '';
+    }
+    /**
+     * Get AppsBlueprint_FileFormat from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     */
+    static getFormatFromExtension(extension) {
+        if (!extension)
+            return undefined;
+        const normalizedExt = extension.toLowerCase().trim();
+        return EXTENSION_TO_FORMAT[normalizedExt];
+    }
+    /**
+     * Get AppsBlueprint_FileFormat from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     */
+    static getFormatFromMimeType(mimeType) {
+        if (!mimeType)
+            return undefined;
+        const normalizedMime = mimeType.toLowerCase().trim();
+        return MIME_TO_FORMAT[normalizedMime];
+    }
+    /**
+     * Check if extension is an agent file format.
+     *
+     * @param extension - File extension (without dot)
+     * @returns true if extension is an agent format
+     */
+    static isAgentFormat(extension) {
+        return this.getFormatFromExtension(extension) !== undefined;
+    }
+    /**
+     * Check if MIME type is an agent file format.
+     *
+     * @param mimeType - MIME type string
+     * @returns true if MIME type is an agent format
+     */
+    static isAgentMimeType(mimeType) {
+        return this.getFormatFromMimeType(mimeType) !== undefined;
+    }
+    /**
+     * Get all agent format extensions.
+     *
+     * @returns Array of extension strings
+     */
+    static getAllExtensions() {
+        return Object.values(FORMAT_TO_EXTENSION);
+    }
+    /**
+     * Get all agent format MIME types.
+     *
+     * @returns Array of MIME type strings
+     */
+    static getAllMimeTypes() {
+        return Object.values(FORMAT_TO_MIME);
+    }
+}
+//# sourceMappingURL=agent-file-formats.js.map

package/dist/esm/files/agent-file-formats.js.map

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

package/dist/esm/files/extension-nature-map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extension to FileNature Mapping
+ *
+ * Maps file extensions to their FileNature classification.
+ * Used for automatic nature detection from file extensions.
+ */
+import { FileNature } from '../zod-decorators.types.js';
+/**
+ * Maps file extensions (lowercase, without dot) to FileNature.
+ */
+export declare const ExtensionToNatureMap: Record<string, FileNature>;
+//# sourceMappingURL=extension-nature-map.d.ts.map

package/dist/esm/files/extension-nature-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-nature-map.d.ts","sourceRoot":"","sources":["../../../src/files/extension-nature-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAwD3D,CAAC"}

package/dist/esm/files/extension-nature-map.js

@@ -0,0 +1,63 @@
+/**
+ * Extension to FileNature Mapping
+ *
+ * Maps file extensions to their FileNature classification.
+ * Used for automatic nature detection from file extensions.
+ */
+import { FileNature } from '../zod-decorators.types.js';
+/**
+ * Maps file extensions (lowercase, without dot) to FileNature.
+ */
+export const ExtensionToNatureMap = {
+    // Images
+    'jpeg': FileNature.IMAGE,
+    'jpg': FileNature.IMAGE,
+    'jfif': FileNature.IMAGE,
+    'png': FileNature.IMAGE,
+    'gif': FileNature.IMAGE,
+    'webp': FileNature.IMAGE,
+    'svg': FileNature.IMAGE,
+    'bmp': FileNature.IMAGE,
+    'tiff': FileNature.IMAGE,
+    'tif': FileNature.IMAGE,
+    'ico': FileNature.IMAGE,
+    'heic': FileNature.IMAGE,
+    'heif': FileNature.IMAGE,
+    // Videos
+    'mp4': FileNature.VIDEO,
+    'webm': FileNature.VIDEO,
+    'ogg': FileNature.VIDEO,
+    'avi': FileNature.VIDEO,
+    'mov': FileNature.VIDEO,
+    'wmv': FileNature.VIDEO,
+    'mpeg': FileNature.VIDEO,
+    'mpg': FileNature.VIDEO,
+    '3gp': FileNature.VIDEO,
+    '3gpp': FileNature.VIDEO,
+    // Audio
+    'mp3': FileNature.AUDIO,
+    'wav': FileNature.AUDIO,
+    'aac': FileNature.AUDIO,
+    'flac': FileNature.AUDIO,
+    'm4a': FileNature.AUDIO,
+    'm4b': FileNature.AUDIO,
+    // PDF
+    'pdf': FileNature.PDF,
+    // Office documents
+    'doc': FileNature.OFFICE,
+    'docx': FileNature.OFFICE,
+    'xls': FileNature.OFFICE,
+    'xlsx': FileNature.OFFICE,
+    'ppt': FileNature.OFFICE,
+    'pptx': FileNature.OFFICE,
+    'odt': FileNature.OFFICE,
+    'ods': FileNature.OFFICE,
+    'odp': FileNature.OFFICE,
+    // Archives
+    'zip': FileNature.ARCHIVE,
+    'rar': FileNature.ARCHIVE,
+    '7z': FileNature.ARCHIVE,
+    'gz': FileNature.ARCHIVE,
+    'tar': FileNature.ARCHIVE,
+};
+//# sourceMappingURL=extension-nature-map.js.map

package/dist/esm/files/extension-nature-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-nature-map.js","sourceRoot":"","sources":["../../../src/files/extension-nature-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B;IAC9D,SAAS;IACT,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,MAAM,EAAE,UAAU,CAAC,KAAK;IAExB,SAAS;IACT,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IAExB,QAAQ;IACR,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IAEvB,MAAM;IACN,KAAK,EAAE,UAAU,CAAC,GAAG;IAErB,mBAAmB;IACnB,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,KAAK,EAAE,UAAU,CAAC,MAAM;IAExB,WAAW;IACX,KAAK,EAAE,UAAU,CAAC,OAAO;IACzB,KAAK,EAAE,UAAU,CAAC,OAAO;IACzB,IAAI,EAAE,UAAU,CAAC,OAAO;IACxB,IAAI,EAAE,UAAU,CAAC,OAAO;IACxB,KAAK,EAAE,UAAU,CAAC,OAAO;CAC1B,CAAC"}

package/dist/esm/files/file-extensions.enum.d.ts

@@ -0,0 +1,58 @@
+/**
+ * File Extension Enum
+ *
+ * Common file extensions grouped by category.
+ * Used for type-safe extension handling and validation.
+ */
+export declare enum FileExtension {
+    JPEG = "jpeg",
+    JPG = "jpg",
+    PNG = "png",
+    GIF = "gif",
+    WEBP = "webp",
+    SVG = "svg",
+    BMP = "bmp",
+    TIFF = "tiff",
+    ICO = "ico",
+    HEIC = "heic",
+    HEIF = "heif",
+    JFIF = "jfif",
+    MP4 = "mp4",
+    WEBM = "webm",
+    OGG_VIDEO = "ogg",
+    AVI = "avi",
+    MOV = "mov",
+    WMV = "wmv",
+    MPEG = "mpeg",
+    THREE_GP = "3gp",
+    MP3 = "mp3",
+    WAV = "wav",
+    OGG_AUDIO = "ogg",
+    AAC = "aac",
+    FLAC = "flac",
+    M4A = "m4a",
+    M4B = "m4b",
+    PDF = "pdf",
+    DOC = "doc",
+    DOCX = "docx",
+    XLS = "xls",
+    XLSX = "xlsx",
+    PPT = "ppt",
+    PPTX = "pptx",
+    ODT = "odt",
+    ODS = "ods",
+    ODP = "odp",
+    ZIP = "zip",
+    RAR = "rar",
+    SEVEN_Z = "7z",
+    GZ = "gz",
+    TAR = "tar",
+    TXT = "txt",
+    MD = "md",
+    JSON = "json",
+    TS = "ts",
+    TSX = "tsx",
+    YAML = "yaml",
+    YML = "yml"
+}
+//# sourceMappingURL=file-extensions.enum.d.ts.map

package/dist/esm/files/file-extensions.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-extensions.enum.d.ts","sourceRoot":"","sources":["../../../src/files/file-extensions.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,aAAa;IAEvB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IAGb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,SAAS,QAAQ;IACjB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,QAAQ,QAAQ;IAGhB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,SAAS,QAAQ;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IAGX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IAGX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,OAAO,OAAO;IACd,EAAE,OAAO;IACT,GAAG,QAAQ;IAGX,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,IAAI,SAAS;IACb,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ"}

package/dist/esm/files/file-extensions.enum.js

@@ -0,0 +1,65 @@
+/**
+ * File Extension Enum
+ *
+ * Common file extensions grouped by category.
+ * Used for type-safe extension handling and validation.
+ */
+export var FileExtension;
+(function (FileExtension) {
+    // Images
+    FileExtension["JPEG"] = "jpeg";
+    FileExtension["JPG"] = "jpg";
+    FileExtension["PNG"] = "png";
+    FileExtension["GIF"] = "gif";
+    FileExtension["WEBP"] = "webp";
+    FileExtension["SVG"] = "svg";
+    FileExtension["BMP"] = "bmp";
+    FileExtension["TIFF"] = "tiff";
+    FileExtension["ICO"] = "ico";
+    FileExtension["HEIC"] = "heic";
+    FileExtension["HEIF"] = "heif";
+    FileExtension["JFIF"] = "jfif";
+    // Videos
+    FileExtension["MP4"] = "mp4";
+    FileExtension["WEBM"] = "webm";
+    FileExtension["OGG_VIDEO"] = "ogg";
+    FileExtension["AVI"] = "avi";
+    FileExtension["MOV"] = "mov";
+    FileExtension["WMV"] = "wmv";
+    FileExtension["MPEG"] = "mpeg";
+    FileExtension["THREE_GP"] = "3gp";
+    // Audio
+    FileExtension["MP3"] = "mp3";
+    FileExtension["WAV"] = "wav";
+    FileExtension["OGG_AUDIO"] = "ogg";
+    FileExtension["AAC"] = "aac";
+    FileExtension["FLAC"] = "flac";
+    FileExtension["M4A"] = "m4a";
+    FileExtension["M4B"] = "m4b";
+    // Documents
+    FileExtension["PDF"] = "pdf";
+    FileExtension["DOC"] = "doc";
+    FileExtension["DOCX"] = "docx";
+    FileExtension["XLS"] = "xls";
+    FileExtension["XLSX"] = "xlsx";
+    FileExtension["PPT"] = "ppt";
+    FileExtension["PPTX"] = "pptx";
+    FileExtension["ODT"] = "odt";
+    FileExtension["ODS"] = "ods";
+    FileExtension["ODP"] = "odp";
+    // Archives
+    FileExtension["ZIP"] = "zip";
+    FileExtension["RAR"] = "rar";
+    FileExtension["SEVEN_Z"] = "7z";
+    FileExtension["GZ"] = "gz";
+    FileExtension["TAR"] = "tar";
+    // Agent/Blueprint formats (text-based)
+    FileExtension["TXT"] = "txt";
+    FileExtension["MD"] = "md";
+    FileExtension["JSON"] = "json";
+    FileExtension["TS"] = "ts";
+    FileExtension["TSX"] = "tsx";
+    FileExtension["YAML"] = "yaml";
+    FileExtension["YML"] = "yml";
+})(FileExtension || (FileExtension = {}));
+//# sourceMappingURL=file-extensions.enum.js.map

package/dist/esm/files/file-extensions.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-extensions.enum.js","sourceRoot":"","sources":["../../../src/files/file-extensions.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAN,IAAY,aA6DX;AA7DD,WAAY,aAAa;IACvB,SAAS;IACT,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,8BAAa,CAAA;IAEb,SAAS;IACT,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,iCAAgB,CAAA;IAEhB,QAAQ;IACR,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,4BAAW,CAAA;IAEX,YAAY;IACZ,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;IAEX,WAAW;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,+BAAc,CAAA;IACd,0BAAS,CAAA;IACT,4BAAW,CAAA;IAEX,uCAAuC;IACvC,4BAAW,CAAA;IACX,0BAAS,CAAA;IACT,8BAAa,CAAA;IACb,0BAAS,CAAA;IACT,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,4BAAW,CAAA;AACb,CAAC,EA7DW,aAAa,KAAb,aAAa,QA6DxB"}

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

@@ -0,0 +1,72 @@
+/**
+ * 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 { FileNature } from '../zod-decorators.types.js';
+/**
+ * Core registry for general file types.
+ */
+export declare 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: string): string | undefined;
+    /**
+     * Get all extensions for a MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensions(mimeType: string): string[];
+    /**
+     * 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: string): string;
+    /**
+     * Get FileNature from extension.
+     *
+     * @param extension - File extension (without dot)
+     * @returns FileNature or undefined if not found
+     */
+    static getNatureFromExtension(extension: string): FileNature | undefined;
+    /**
+     * Get FileNature from MIME type.
+     *
+     * @param mimeType - MIME type string
+     * @returns FileNature or undefined if not found
+     */
+    static getNatureFromMimeType(mimeType: string): FileNature | undefined;
+    /**
+     * 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: string, mimeType: string): boolean;
+    /**
+     * Get extensions for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of extensions (without dots)
+     */
+    static getExtensionsForNature(nature: FileNature): string[];
+    /**
+     * Get MIME types for a FileNature.
+     *
+     * @param nature - FileNature enum value
+     * @returns Array of MIME type strings
+     */
+    static getMimeTypesForNature(nature: FileNature): string[];
+}
+//# sourceMappingURL=mime-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mime-registry.d.ts","sourceRoot":"","sources":["../../../src/files/mime-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAsC7D;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAezD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAWhD;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOpD;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOxE;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAUtE;;;;;;OAMG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAoB/E;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;IAM3D;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;CAa3D"}