@emailmaker/filemanager 0.10.92 → 0.10.94

package/adapters/DataSourceProxyBase.d.ts

@@ -54,6 +54,10 @@ export declare class DataSourceProxyBase implements FileManagerDataProviders {
     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;

package/adapters/DataSourceProxyBase.rename.test.d.ts

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

package/adapters/DataSourceProxyBase.trash.test.d.ts

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

package/adapters/PathAwareStorageAdapter.d.ts

@@ -13,6 +13,7 @@ export declare class PathAwareStorageAdapter implements StorageProvider {
     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;

package/adapters/PathAwareStorageAdapter.trash.test.d.ts

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

package/adapters/TreeCache.d.ts

@@ -1,5 +1,7 @@
 import type { FileSystemItem } from '../types/storage';
+import type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
 import { FailedRequestCache } from './FailedRequestCache';
+export type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
 export interface QueryResult<T> {
     items: T[];
     total?: number;
@@ -8,15 +10,6 @@ export interface QueryResult<T> {
     limit?: number;
     [key: string]: unknown;
 }
-export interface ChildrenQueryParams {
-    page?: number;
-    pageSize?: number | string;
-    sortBy?: string;
-    sortOrder?: string;
-    search?: string;
-    itemType?: 'file' | 'folder' | 'all';
-    [key: string]: unknown;
-}
 /** When `fileManager.cacheStrategy.ttl` is unset: success/error cache and notification dedupe fallback (30 min). */
 export declare const DEFAULT_FILE_MANAGER_CACHE_TTL_MS: number;
 /**
@@ -78,15 +71,6 @@ export declare class EntityCacheManager {
     toJSON(): any;
     static fromJSON(data: any): EntityCacheManager;
 }
-export interface ViewStrategyOptions {
-    allowSortedInsert?: boolean;
-    allowSearchInsert?: boolean;
-    invalidateOnPaginationFull?: boolean;
-    preloadPagesBefore?: number;
-    preloadPagesAfter?: number;
-    comparator?: (a: FileSystemItem, b: FileSystemItem, params?: ChildrenQueryParams) => number;
-    filterMatch?: (entity: FileSystemItem, params?: ChildrenQueryParams) => boolean;
-}
 export declare class ViewCacheManager {
     private readonly views;
     private readonly strategy;
@@ -106,6 +90,8 @@ export declare class ViewCacheManager {
     private isExpired;
     private areEntitiesStale;
     private isEntityTypeCompatible;
+    /** Mark cached view as stale and cancel any in-flight load for this record. */
+    private markViewStaleForReload;
     private cleanupOldViews;
     getOrCreateChildren(parentId: string | null, params: ChildrenQueryParams, loader: (parentId: string | null, params: ChildrenQueryParams) => Promise<QueryResult<FileSystemItem>>, entitiesManager: EntityCacheManager): Promise<QueryResult<FileSystemItem>>;
     /**
@@ -117,7 +103,6 @@ export declare class ViewCacheManager {
     private updateTotalPagesForAllViews;
     private isParamsSame;
     private syncTotalsInSameViews;
-    private canSafelyModifySortedView;
     private cascadeShiftPages;
     private cascadeShiftToNextPage;
     private tryInsertSorted;

package/adapters/TreeCache.sortedView.test.d.ts

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

package/adapters/cacheViewStrategy.d.ts

@@ -0,0 +1,31 @@
+import type { FileSystemItem } from '../types/storage';
+import type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
+type SortOrder = 'asc' | 'desc';
+/**
+ * Resolve sort field defaults for cache compare vs client-side sort callers.
+ * - sortBy omitted → name
+ * - sortOrder omitted + sortBy explicitly set → desc (matches getFiles server default)
+ * - both omitted → asc (legacy client-side default)
+ */
+export declare function resolveSortParams(params?: ChildrenQueryParams): {
+    sortBy: string;
+    sortOrder: SortOrder;
+};
+/**
+ * Compare two file-system items for sorted view cache maintenance.
+ * Aligns with {@link DataSourceProxyBase} client-side sort and default server sort params.
+ */
+export declare function compareFileSystemItems(a: FileSystemItem, b: FileSystemItem, params?: ChildrenQueryParams): number;
+/**
+ * Whether an entity belongs in a cached children view with optional search filter.
+ */
+export declare function matchesChildrenViewFilter(entity: FileSystemItem, params?: ChildrenQueryParams): boolean;
+/** Default comparator for sorted view cache updates. */
+export declare const defaultFileSystemItemComparator: typeof compareFileSystemItems;
+/** Default search filter for cached children views. */
+export declare const defaultChildrenViewFilterMatch: typeof matchesChildrenViewFilter;
+/**
+ * Merge user cache strategy with package defaults for comparator and filterMatch.
+ */
+export declare function resolveViewStrategyOptions(options?: ViewStrategyOptions): ViewStrategyOptions;
+export {};

package/adapters/cacheViewStrategy.test.d.ts

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

package/adapters/cacheViewTypes.d.ts

@@ -0,0 +1,19 @@
+import type { FileSystemItem } from '../types/storage';
+export interface ChildrenQueryParams {
+    page?: number;
+    pageSize?: number | string;
+    sortBy?: string;
+    sortOrder?: string;
+    search?: string;
+    itemType?: 'file' | 'folder' | 'all';
+    [key: string]: unknown;
+}
+export interface ViewStrategyOptions {
+    allowSortedInsert?: boolean;
+    allowSearchInsert?: boolean;
+    invalidateOnPaginationFull?: boolean;
+    preloadPagesBefore?: number;
+    preloadPagesAfter?: number;
+    comparator?: (a: FileSystemItem, b: FileSystemItem, params?: ChildrenQueryParams) => number;
+    filterMatch?: (entity: FileSystemItem, params?: ChildrenQueryParams) => boolean;
+}

package/adapters/systemFolderPath.d.ts

@@ -0,0 +1,27 @@
+import type { FileSystemItem } from '../types/storage';
+/** Tree/cache sentinel id for the trash folder (matches `FolderTree` node key and `TRASH` constant). */
+export declare const TRASH_FOLDER_ID: "Trash";
+export type SystemFolderDefinition = {
+    id: string;
+    name?: string;
+    folderId?: string | null;
+};
+/** Normalize a logical folder path for system-folder lookup (`Trash`, `/Trash/`, `foo\\bar`). */
+export declare function normalizeSystemFolderPath(path: string): string;
+/**
+ * Lookup keys to try with {@link StorageProvider.findItemByPath} for trash system paths.
+ * Adds trash sentinel aliases when `requestPath` normalizes to the configured `trashPath`.
+ */
+export declare function getTrashFolderLookupCandidates(requestPath: string, trashPath: string, trashFolderId?: string): string[];
+/**
+ * Factory for {@link StorageProvider.findItemByPath} — maps logical paths to synthetic folders
+ * (backend-managed trash, etc.) without creating physical folders on the server.
+ *
+ * @example
+ * ```ts
+ * findItemByPath: createSystemFolderByPathResolver({
+ *   Trash: { id: TRASH_FOLDER_ID, folderId: rootId },
+ * }),
+ * ```
+ */
+export declare function createSystemFolderByPathResolver(folders: Record<string, SystemFolderDefinition>): (path: string) => FileSystemItem | undefined;

package/adapters/systemFolderPath.test.d.ts

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