@emailmaker/emailmaker 1.1.64 → 1.1.69

package/README.md

@@ -486,7 +486,7 @@ emailmaker.init({
 | handleNotify | Произвольное уведомление. |
 | handleError | Ошибка (можно переопределить UI). |
 | handleSuccess | Успешная операция. |
-| handleReadLocale | Язык интерфейса (**`AppConfigMixin`**). |
+| handleReadLocale | Язык интерфейса (**`AppConfigMixin`**). Каталог возвращается текстом **`.po`**, JSON-строкой или готовым объектом **`LocaleData`**. |
 | handleTranslate | Пользовательский перевод строк. |
 | handleLimitUsage | Отображение квот / лимитов. |
 

package/{emailmaker-core.ac3e9ba7.js → emailmaker-core.d61049ba.js}

@@ -2,17 +2,17 @@ __emailmaker__.define("core", [
 	"require",
 	"exports",
 	"module",
-	"static/core/c64d880f.js",
-	"static/core/573a6be1.js",
-	"static/core/f5d89da5.js",
-	"static/core/ec3963f6.js"
+	"static/core/7df48ae1.js",
+	"static/core/544cf3ed.js",
+	"static/core/fe1de7b4.js",
+	"static/core/f4a40744.js"
 ], function(f, E, me) {
 	Object.defineProperties(E, {
 		__esModule: { value: !0 },
 		[Symbol.toStringTag]: { value: "Module" }
 	});
-	f("./static/core/c64d880f.js");
-	const n = f("./static/core/573a6be1.js"), l = f("./static/core/f5d89da5.js"), m = f("./static/core/ec3963f6.js");
+	f("./static/core/7df48ae1.js");
+	const n = f("./static/core/544cf3ed.js"), l = f("./static/core/fe1de7b4.js"), m = f("./static/core/f4a40744.js");
 	var A = "Editor instance was destroyed and cannot be reused. A fresh instance will be created instead.";
 	function w() {
 		const e = new Error(A);
@@ -534,7 +534,7 @@ __emailmaker__.define("core", [
 		R
 	];
 	async function Z() {
-		return (await Promise.resolve().then(() => f("./static/core/6081e8cd.js"))).default;
+		return (await Promise.resolve().then(() => f("./static/core/ade8d653.js"))).default;
 	}
 	var ee = (e) => {
 		let t = null, o = !1;
@@ -669,5 +669,5 @@ __emailmaker__.define("core", [
 			ampHtml: o
 		};
 	}
-	E.init = ae, E.parseAMP = le, E.version = "1.1.64";
+	E.init = ae, E.parseAMP = le, E.version = "1.1.69";
 });

package/emailmaker-esm.js

@@ -76,7 +76,7 @@ import { a as w, i as ke, n as Ue, r as J, t as _ } from "./static/esm/7cd4296a.
 		} catch {
 			return y.slice(-1) !== "/" && (y += "/"), t(y + m);
 		}
-	}), e.version || (e.version = "1.1.64");
+	}), e.version || (e.version = "1.1.69");
 	var n = e.modules = /* @__PURE__ */ Object.create(null), r = import("./runtime/index.js"), s = import("./ui-kit/index.js");
 	n.React = r.then(function(o) {
 		return o.React;
@@ -785,7 +785,7 @@ import { a as w, i as ke, n as Ue, r as J, t as _ } from "./static/esm/7cd4296a.
 })();
 `)(e), typeof e.require == "function" && typeof e.require.config == "function" && e.require.config({
 		baseUrl: "./",
-		paths: { core: "emailmaker-core.ac3e9ba7.js" }
+		paths: { core: "emailmaker-core.d61049ba.js" }
 	});
 	var p = typeof e.prefetch == "function" ? e.prefetch : void 0;
 	if (e.prefetch = function() {
@@ -1758,7 +1758,7 @@ function N(e, ...n) {
 	const r = _.get(e);
 	n.some((s) => s !== void 0 && s === r) && _.delete(e);
 }
-var Er = "1.1.64";
+var Er = "1.1.69";
 async function Ir(e) {
 	await de(typeof window.__emailmaker__ < "u" ? window.__emailmaker__ : void 0);
 }

package/emailmaker.d.ts

@@ -1351,8 +1351,16 @@ export declare namespace ExportedApi {
     syntax: string[];
     items: MergeTag[];
   }
-  type LimitName = 'AiImgCount' | 'AiChatCount' | 'AiGeneratorCount' | 'OptimizationCount';
-  type LocaleListener = AppListener<string, string>;
+  type LimitName = 'AiImgCount' | 'AiChatCount' | 'AiGeneratorCount' |
+  /** @deprecated For plugin hosts: use per-type `LinkCheckCount` / `ImageCheckCount` / `SpamCheckCount` instead. */
+  'OptimizationCount' | 'LinkCheckCount' | 'ImageCheckCount' | 'SpamCheckCount';
+  /** Jed-shaped catalog: the object `@wordpress/i18n` consumes, as served by `/translations/{locale}.json`. */
+  type LocaleData = Record<string, unknown>;
+  /**
+   * Supplies the interface catalog for a locale: a gettext `.po` text, a JSON string, or an
+   * already parsed {@link LocaleData}. Returning `.po` keeps working — the JSON forms are additions.
+   */
+  type LocaleListener = AppListener<string, string | LocaleData>;
   type LimitListener = AppListener<{
     name: LimitName;
     count: number;
@@ -1368,8 +1376,17 @@ export declare namespace ExportedApi {
   }
   /** Usage counters returned to the host for quota / billing UI (**`handleLimitUsage`**). */
   interface Counters {
-    /** Optimization analyzer runs consumed in the current billing period. */
+    /**
+     * Optimization analyzer runs consumed in the current billing period (legacy aggregate).
+     * @deprecated For plugin integrations — use per-type counters instead.
+     */
     optimization_counter: number;
+    /** Link validation runs consumed (per-type; optional until host/backend supports it). */
+    link_check_counter?: number;
+    /** Image validation runs consumed (per-type; optional until host/backend supports it). */
+    image_check_counter?: number;
+    /** SpamAssassin validation runs consumed (per-type; optional until host/backend supports it). */
+    spam_check_counter?: number;
     /** AI chat / completion requests consumed. */
     ai_counter: number;
     /** AI image generations consumed. */
@@ -1379,8 +1396,17 @@ export declare namespace ExportedApi {
   }
   /** Quota ceilings paired with **`counters`** for limit messaging. */
   interface Limits {
-    /** Max optimization runs per period (`undefined`/`0` = unlimited). */
+    /**
+     * Max optimization runs per period (`undefined`/`0` = unlimited; legacy aggregate).
+     * @deprecated For plugin integrations — use per-type limits instead.
+     */
     optimization_limit: number;
+    /** Link validation cap per period (per-type; optional until host/backend supports it). */
+    link_check_limit?: number;
+    /** Image validation cap per period (per-type; optional until host/backend supports it). */
+    image_check_limit?: number;
+    /** SpamAssassin validation cap per period (per-type; optional until host/backend supports it). */
+    spam_check_limit?: number;
     /** AI chat / completion cap per period. */
     ai_limit: number;
     /** AI image generations cap per period. */

package/emailmaker.js

@@ -689,7 +689,7 @@ var __amdEnv = window.__emailmaker__ || (window.__emailmaker__ = {});
 
 
 // Configure AMD loader
-__amdEnv.require.config({ baseUrl: "./", paths: {"core":"emailmaker-core.ac3e9ba7.js"} });
+__amdEnv.require.config({ baseUrl: "./", paths: {"core":"emailmaker-core.d61049ba.js"} });
 
 // PublicPath (script detection: entry script lookup → document.currentScript)
 if (!__emailmaker__.publicPath) {
@@ -1037,7 +1037,7 @@ if (!ns.assetUrl) {
 }
 
 if (!ns.version) {
-  ns.version = "1.1.64";
+  ns.version = "1.1.69";
 }
 
   var modules = ns.modules = Object.create(null);
@@ -2785,7 +2785,7 @@ __emailmaker__.define("emailmaker.js", [
 		const r = S.get(e);
 		t.some((n) => n !== void 0 && n === r) && S.delete(e);
 	}
-	var rn = "1.1.64";
+	var rn = "1.1.69";
 	async function nn(e) {
 		await _e(typeof __emailmaker__ < "u" ? __emailmaker__ : void 0);
 	}

package/file-manager/.build-meta.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "hash": "3f662b4b8ddc2c2b20d9d4f6b524c3a9f2316bc1042fa8fb2489707e2fec1af9",
+  "prefix": "em"
+}

package/file-manager/adapters/DataSourceProxyBase.clearCache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/adapters/DataSourceProxyBase.d.ts

@@ -0,0 +1,229 @@
+import type { ApiPaginationResponse, BatchResult, File, FileManagerDataProviders, Folder, SortState, UploadFileResultData, UploadFilesRequest } from '../types';
+import type { FileSystemItem, GetFileDataOptions, StorageProvider, StorageProviderController } from '../types/storage';
+import { ViewStrategyOptions } from './TreeCache';
+/**
+ * DI config for {@link DataSourceProxyBase}.
+ * All fields are optional — the class works standalone with EN-only defaults.
+ */
+export interface DataSourceProxyConfig {
+    /**
+     * Custom fetch implementation (e.g. with CDN proxy, auth headers, retries).
+     * Used when loading file binary data via URL.
+     * Falls back to global `fetch` when omitted.
+     */
+    fetchWithProxy?: (url: string, init?: RequestInit) => Promise<Response>;
+}
+/**
+ * Subset of FileManager options used by {@link DataSourceProxyBase}.
+ */
+export interface FileManagerProxyOptions {
+    enableTrash?: boolean;
+    enablePagination?: boolean;
+    unifiedCatalogFetch?: boolean;
+    clientSideFilter?: boolean | ((items: FileSystemItem[], search?: string) => FileSystemItem[]);
+    clientSideSorting?: boolean | ((items: FileSystemItem[], sortBy?: SortState['sortBy'], sortOrder?: SortState['sortOrder']) => FileSystemItem[]);
+    clientSidePaging?: boolean | ((items: FileSystemItem[], page?: number, limit?: number) => FileSystemItem[]);
+    cacheStrategy?: ViewStrategyOptions & {
+        ttl?: number;
+        errorTtl?: number;
+    };
+}
+export interface DataSourceProxyOptions {
+    rootId?: string;
+    trashPath?: string;
+    tempPath?: string;
+    useSoftDelete?: boolean;
+    batchOperationFallback?: boolean;
+    validateDuplicates?: boolean;
+}
+/**
+ * Caching adapter: wraps a {@link StorageProvider} and exposes a {@link FileManagerDataProviders} interface.
+ * Handles client-side caching (TreeCache), soft-delete, pagination, and deduplication.
+ * Extend this class in a consumer app to add backend-specific logic.
+ */
+export declare class DataSourceProxyBase implements FileManagerDataProviders {
+    private readonly _dataProvider;
+    private readonly _options;
+    private readonly _pathOptions;
+    private readonly _cache;
+    private readonly _rootId;
+    private readonly _useSoftDelete;
+    private readonly _enableTrash;
+    private readonly _validateDuplicates;
+    /** Next `getFileData` for this normalized file id uses HTTP no-store (e.g. after overwrite). */
+    private readonly _blobFetchForceReloadOnceIds;
+    /** Frontend-only guard against reads racing with delete operations. */
+    private readonly _mutationRegistry;
+    private _getTrashPath;
+    private _getPathLookupCandidates;
+    private _folderFromResolvedPath;
+    private _resolveFolderByPath;
+    private _findOrCreateFolderByPath;
+    private getTrashFolder;
+    private getTempFolder;
+    private readonly _config;
+    constructor(_dataProvider: StorageProvider, _options: FileManagerProxyOptions | undefined, _pathOptions: DataSourceProxyOptions, config?: DataSourceProxyConfig);
+    setController(controller: StorageProviderController): void;
+    clearCache(pathFolder?: string | null): Promise<void>;
+    /**
+     * After save/overwrite, the next `getFileData` for this file id will use `forceReload` (HTTP no-store).
+     */
+    markNextFileBlobFetchBypassHttpCache(fileId: string): void;
+    /**
+     * Нормализует идентификатор с использованием текущих rootId
+     */
+    normalizeId(id: string | null | undefined): string;
+    private _isDeletingId;
+    private _collectDeletingIds;
+    private _emptyFilesResult;
+    /**
+     * Проверяет валидность имени файла/папки
+     */
+    private _validateName;
+    /**
+     * Проверяет, что целевая папка в кэше является папкой (если она есть в кэше)
+     * Не проверяет существование, так как отсутствие в кэше не означает отсутствие на бэкенде
+     */
+    private _validateTargetFolderType;
+    /**
+     * Проверяет, существует ли элемент с указанным именем в целевой папке (только через кэш, без обращения к бэку)
+     */
+    private _checkNameExistsInCache;
+    private _getUrl;
+    private _getThumbnailUrl;
+    private _mapItem;
+    /**
+     * Проверяет, является ли targetFolderId дочерней папкой sourceFolderId (циклическая ссылка)
+     */
+    private _isAncestor;
+    getFile(folderId: string, name: string): Promise<FileSystemItem | null>;
+    /**
+     * File metadata by id: entity cache first; on miss, loads parent listing via {@link getFile} / {@link getFiles} (i.e. provider `getItems`).
+     * Only practical when ids are path-shaped and {@link StorageProvider.pathMode} is true; otherwise cache-only.
+     */
+    getFileById(fileId: string): Promise<File | null>;
+    private _getFileByPathStyleId;
+    getFileUrl(folderId: string | null | undefined, name: string): Promise<string | undefined>;
+    /**
+     * Получает список файлов и папок с поддержкой пагинации, фильтрации и сортировки
+     */
+    getFiles({ folderId, search, sortBy, sortOrder, page, limit, itemType, noFolder, }: {
+        folderId?: string | null;
+        search?: string;
+        sortBy?: SortState['sortBy'];
+        sortOrder?: SortState['sortOrder'];
+        page?: number;
+        limit?: number;
+        itemType: 'file' | 'folder' | 'all';
+        noFolder?: boolean;
+    }): Promise<{
+        files: File[];
+        pagination: Partial<ApiPaginationResponse>;
+    }>;
+    /**
+     * Стандартная клиентская сортировка файлов
+     */
+    private _defaultClientSideSort;
+    /**
+     * Получает данные файла в виде Blob
+     */
+    getFileData(fileId: string, options?: GetFileDataOptions): Promise<Blob>;
+    getFileData(file: File, options?: GetFileDataOptions): Promise<Blob>;
+    findFileByUrl(url: string): Promise<File | null>;
+    /**
+     * Получает количество элементов в папке
+     */
+    getChildrenCount(folderId?: string): Promise<number>;
+    private _isPathFolderNotFoundError;
+    /**
+     * Загружает файл на сервер
+     */
+    _uploadFile(file: {
+        name: string;
+        size: number;
+        type: string;
+        folderId?: string | null;
+        data: Blob | globalThis.File;
+    }): Promise<File>;
+    uploadFiles(request: UploadFilesRequest): Promise<BatchResult<UploadFileResultData>>;
+    /**
+     * Удаляет файл (либо полностью, либо перемещает в корзину в зависимости от настроек)
+     */
+    deleteFile(fileId: string): Promise<boolean>;
+    /**
+     * Удаляет файл (либо полностью, либо перемещает в корзину в зависимости от настроек)
+     */
+    deleteItems(itemIds: string[], options: {
+        permanent: boolean;
+    }): Promise<BatchResult<{}>>;
+    /**
+     * Полностью удаляет файлы
+     */
+    private hardDeleteItems;
+    /**
+     * Полностью удаляет файл без возможности восстановления
+     */
+    private hardDeleteItem;
+    /**
+     * Очищает корзину (удаляет все файлы из корзины)
+     */
+    cleanTrash(): Promise<{
+        success: boolean;
+        deletedCount?: number;
+    }>;
+    /**
+     * Создает новую папку
+     */
+    createFolder({ name, parentId, is_force_create, }: {
+        name: string;
+        parentId?: string | null;
+        is_force_create?: boolean;
+    }): Promise<Folder>;
+    /**
+     * Удаляет папку (либо полностью, либо перемещает в корзину в зависимости от настроек)
+     */
+    deleteFolder(folderId: string): Promise<boolean>;
+    /**
+     * Переименовывает папку
+     */
+    renameFolder(folderId: string, newName: string): Promise<Folder>;
+    /**
+     * Переименовывает файл
+     */
+    renameFile(fileId: string, newName: string): Promise<File>;
+    /**
+     * Перемещает элемент (файл или папку)
+     */
+    moveItem({ itemId, targetFolderId, isFolder, }: {
+        itemId: string;
+        targetFolderId: string | null;
+        isFolder: boolean;
+    }): Promise<boolean>;
+    moveItems(targetFolderId: string, itemIds: string[]): Promise<BatchResult<{}>>;
+    /**
+     * Копирует элемент (файл или папку)
+     */
+    copyItem({ itemId, targetFolderId, }: {
+        itemId: string;
+        targetFolderId: string | null;
+        isFolder: boolean;
+    }): Promise<boolean>;
+    copyItems(targetFolderId: string, items: Array<{
+        id: string;
+        newName?: string;
+    }> | string[]): Promise<BatchResult<{}>>;
+    /**
+     * Загружает файл по URL
+     */
+    uploadFileByUrl(data: {
+        url: string;
+        folderId?: string | null;
+        noFolder?: boolean;
+        name?: string;
+        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+    }): Promise<File>;
+    /**
+     * Обновляет данные файла
+     */
+    updateFile(fileId: string, updates: Partial<Omit<File, 'id'>>): Promise<File>;
+}

package/file-manager/adapters/DataSourceProxyBase.rename.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/adapters/DataSourceProxyBase.trash.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/adapters/DataSourceProxyBase.upload.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/adapters/FailedRequestCache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Single store for short-lived cached request failures (negative cache).
+ * Used by {@link TreeCache} for children views and children counts; can be extended for other GETs.
+ */
+export declare class FailedRequestCache {
+    private readonly map;
+    /** Errors from {@link ViewCacheManager.getOrCreateChildren} */
+    static childrenViewKey(pKey: string, qKey: string): string;
+    /** Errors from {@link TreeCache.getChildrenCount} */
+    static childrenCountKey(normalizedParentKey: string): string;
+    /**
+     * Returns the cached error if still within TTL, otherwise null (entry may be removed).
+     */
+    getFreshError(key: string, errorTtlMs: number): unknown | null;
+    setError(key: string, error: unknown): void;
+    delete(key: string): void;
+    /** All list-view errors for one parent bucket (pKey). */
+    clearChildrenViewErrorsForParent(pKey: string): void;
+    clearAll(): void;
+}

package/file-manager/adapters/MutationRegistry.d.ts

@@ -0,0 +1,6 @@
+export declare class MutationRegistry {
+    private readonly deletingIds;
+    beginDeleting(ids: Iterable<string>): void;
+    endDeleting(ids: Iterable<string>): void;
+    isDeleting(id: string | null | undefined): boolean;
+}

package/file-manager/adapters/PathAwareStorageAdapter.d.ts

@@ -0,0 +1,71 @@
+import type { FileSystemItem, StorageProvider, FileSystemItemUpdate, GetFileDataOptions, MayBePromise, StorageProviderController, BatchResult, StorageUploadFilesRequest as UploadFilesRequest, StorageSortState as SortState, StorageApiPaginationResponse as ApiPaginationResponse } from '../types/storage';
+export declare class PathAwareStorageAdapter implements StorageProvider {
+    private readonly _inner;
+    readonly rootPath: string;
+    readonly trashId: string;
+    readonly trashPath: string;
+    readonly ensureFolderTrailingSlash: boolean;
+    private readonly _pathToId;
+    private readonly _idToPath;
+    getUrl?: (file: FileSystemItem) => MayBePromise<string>;
+    getThumbnailUrl?: (file: FileSystemItem) => MayBePromise<string>;
+    validateDuplicates?: boolean;
+    constructor(_inner: StorageProvider, rootPath?: string, trashId?: string, trashPath?: string, ensureFolderTrailingSlash?: boolean);
+    setController(controller: StorageProviderController): void;
+    clearCache?(pathFolder?: string | null): MayBePromise<void>;
+    findItemByPath?(path: string): MayBePromise<FileSystemItem | undefined>;
+    private _getOrGenerateId;
+    pathForId(id: string, isFolder: boolean, silent?: boolean): string;
+    private _updateIdMapping;
+    getItems(options: {
+        folderId?: string;
+        search?: string;
+        sortBy?: SortState['sortBy'];
+        sortOrder?: SortState['sortOrder'];
+        page?: number;
+        limit?: number;
+        itemType: 'all' | 'file' | 'folder';
+    }): Promise<{
+        items: FileSystemItem[];
+        pagination?: Partial<ApiPaginationResponse>;
+    }>;
+    createFolder(name: string, parent?: string, is_force_create?: boolean): Promise<FileSystemItem>;
+    renameItem(item: FileSystemItem, newName: string): Promise<FileSystemItemUpdate>;
+    deleteItem(item: FileSystemItem, options: {
+        permanent: boolean;
+    }): Promise<void>;
+    uploadFile(file: {
+        name: string;
+        size: number;
+        type: string;
+        folderId?: string | null;
+        data: Blob | globalThis.File;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
+        extension?: string;
+    }): Promise<FileSystemItemUpdate>;
+    uploadFiles(request: UploadFilesRequest): Promise<BatchResult<FileSystemItem>>;
+    findFileByUrl(url: string, folderId?: string): Promise<FileSystemItem | undefined>;
+    uploadFileByUrl(url: string, folderId?: string | null, options?: {
+        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+    }): Promise<FileSystemItem>;
+    moveItem(item: FileSystemItem, targetFolderId?: string): Promise<FileSystemItemUpdate>;
+    moveItems(items: FileSystemItem[], targetFolderId?: string): Promise<BatchResult<FileSystemItemUpdate>>;
+    copyItems(items: FileSystemItem[], targetFolderId?: string): Promise<BatchResult<FileSystemItemUpdate>>;
+    deleteItems(items: FileSystemItem[], options: {
+        permanent: boolean;
+    }): Promise<BatchResult<never>>;
+    private remapCachedFolderContents;
+    private recursivelyRemoveMappings;
+    copyItem(item: FileSystemItem, targetFolderId?: string): Promise<FileSystemItemUpdate>;
+    updateFile(file: FileSystemItem, updates: {
+        name?: string;
+        data?: Blob | string;
+    }): Promise<FileSystemItemUpdate>;
+    getFileData(file: FileSystemItem, options?: GetFileDataOptions): Promise<Blob>;
+    cleanTrash(): Promise<{
+        success: boolean;
+        deletedCount?: number;
+    }>;
+}

package/file-manager/adapters/PathAwareStorageAdapter.trash.test.d.ts

@@ -0,0 +1 @@
+export {};