@emailmaker/filemanager 1.1.75 → 1.1.81

package/hooks/core/files/useFilesAPI.d.ts

@@ -26,7 +26,7 @@ export interface UseFilesAPIActions {
             }>;
         }) => void;
     }) => Promise<void>;
-    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif') => Promise<AppFile | void>;
+    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
     handleDroppedFiles: (droppedFiles: globalThis.File[]) => Promise<void>;
     getFileData: (fileId: string, silent?: boolean) => Promise<Blob | undefined>;
     findFileByUrl: (url: string, silent?: boolean) => Promise<AppFile | null>;

package/hooks/core/useFiles.d.ts

@@ -35,7 +35,7 @@ export interface UseFilesActions {
             }>;
         }) => void;
     }) => Promise<void>;
-    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif') => Promise<AppFile | void>;
+    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
     toggleFileSelection: (fileId: string, opts?: {
         metaKey?: boolean;
         ctrlKey?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailmaker/filemanager",
-  "version": "1.1.75",
+  "version": "1.1.81",
   "main": "./file-manager.js",
   "module": "./file-manager.esm.js",
   "types": "./index.d.ts",

package/types.d.ts

@@ -682,6 +682,8 @@ export interface UnsplashImage {
     width?: number;
     height?: number;
     description: string;
+    /** Короткая подпись к снимку. У `description` бывает `null` и целый авторский абзац. */
+    alt_description?: string | null;
     urls: {
         raw: string;
         small: string;

package/utils/buildSourceFileName.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Читаемое имя от источника: заголовок плюс короткий id. Id нужен потому, что заголовки у стоков и
+ * Giphy повторяются, а имя файла — единственное, что отличает их в каталоге.
+ * Без заголовка возвращает `undefined`: чем его заменить, знает вызывающий.
+ */
+export declare function buildSourceFileName(title: string | null | undefined, id: string): string | undefined;

package/utils/buildSourceFileName.test.d.ts

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

package/utils/fileExtensions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Оканчивается ли имя известным расширением. Проверять шаблоном «точка и что-нибудь» нельзя:
+ * под него подходит версия библиотеки в query вроде `ixlib=rb-4.1.0`.
+ */
+export declare function hasKnownExtension(name: string): boolean;
+/** Имя, разобранное на базу и известное расширение; неизвестное остаётся частью базы. */
+export declare function splitKnownExtension(name: string): {
+    base: string;
+    extension?: string;
+};

package/utils/fileExtensions.test.d.ts

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

package/utils/resolveUploadFileName.d.ts

@@ -0,0 +1,15 @@
+interface UploadFileNameInput {
+    /** Имя, известное источнику загрузки: галерее стоков, GIF, вставке по ссылке. */
+    preferredName?: string;
+    url?: string;
+    /** MIME скачанного блоба — самый достоверный источник расширения. */
+    mimeType?: string;
+}
+/**
+ * Итоговое имя загружаемого файла. База — от источника, потом из ссылки. Известное расширение в
+ * имени остаётся как есть, иначе берётся по содержимому: подменять `.jpg` на `.jpeg` только
+ * потому, что так назвал MIME, — переименование на ровном месте.
+ * Нормализацию делает вызывающий: она зависит от конфига.
+ */
+export declare function resolveUploadFileName({ preferredName, url, mimeType }: UploadFileNameInput): string;
+export {};

package/utils/resolveUploadFileName.test.d.ts

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

package/utils/urlNormalization.d.ts

@@ -8,7 +8,7 @@ export declare function safeNormalizeExternalFileUrl(url: string): string;
 /** Один ли это источник: URL сравниваются после нормализации, а не побайтово. */
 export declare function isSameExternalFileUrl(a: string | null | undefined, b: string | null | undefined): boolean;
 /**
- * Имя файла из URL: сегмент пути, а если расширения там нет — значение
+ * Имя файла из URL: сегмент пути, а если известного расширения там нет — значение
  * query-параметра (CDN вида `/image/<id>?p=Catalog/file.jpg`).
  */
 export declare function extractFileNameFromUrl(url: string): string | undefined;