@strapi/upload 5.0.3 → 5.0.5

package/dist/admin/src/hooks/useModalQueryParams.d.ts

@@ -0,0 +1,21 @@
+import type { Query, FilterCondition } from '../../../shared/contracts/files';
+declare const useModalQueryParams: (initialState?: Partial<Query>) => ({
+    queryObject: Query;
+    rawQuery: string;
+    onChangeFilters?: undefined;
+    onChangeFolder?: undefined;
+    onChangePage?: undefined;
+    onChangePageSize?: undefined;
+    onChangeSort?: undefined;
+    onChangeSearch?: undefined;
+} | {
+    onChangeFilters: (nextFilters: FilterCondition<string>[]) => void;
+    onChangeFolder: (folder: Query['folder'], folderPath: Query['folderPath']) => void;
+    onChangePage: (page: Query['page']) => void;
+    onChangePageSize: (pageSize: Query['pageSize']) => void;
+    onChangeSort: (sort: Query['sort']) => void;
+    onChangeSearch: (_q: Query['_q']) => void;
+    queryObject?: undefined;
+    rawQuery?: undefined;
+})[];
+export default useModalQueryParams;

package/dist/admin/src/hooks/usePersistentState.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const usePersistentState: <T>(key: string, defaultValue: T) => readonly [T, import("react").Dispatch<import("react").SetStateAction<T>>];
 export { usePersistentState };

package/dist/admin/src/hooks/useRemoveAsset.d.ts

@@ -0,0 +1,66 @@
+import type { DeleteFile } from '../../../shared/contracts/files';
+export declare const useRemoveAsset: (onSuccess: () => void) => {
+    removeAsset: (assetId: number) => Promise<void>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isLoading: false;
+    isSuccess: false;
+    status: "idle";
+    mutate: import("react-query").UseMutateFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    isPaused: boolean;
+    variables: number | undefined;
+    mutateAsync: import("react-query").UseMutateAsyncFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+} | {
+    removeAsset: (assetId: number) => Promise<void>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isLoading: true;
+    isSuccess: false;
+    status: "loading";
+    mutate: import("react-query").UseMutateFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    isPaused: boolean;
+    variables: number | undefined;
+    mutateAsync: import("react-query").UseMutateAsyncFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+} | {
+    removeAsset: (assetId: number) => Promise<void>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isIdle: false;
+    isLoading: false;
+    isSuccess: false;
+    status: "error";
+    mutate: import("react-query").UseMutateFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    isPaused: boolean;
+    variables: number | undefined;
+    mutateAsync: import("react-query").UseMutateAsyncFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+} | {
+    removeAsset: (assetId: number) => Promise<void>;
+    data: import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isLoading: false;
+    isSuccess: true;
+    status: "success";
+    mutate: import("react-query").UseMutateFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    isPaused: boolean;
+    variables: number | undefined;
+    mutateAsync: import("react-query").UseMutateAsyncFunction<import("@strapi/admin/strapi-admin").FetchResponse<DeleteFile.Response>, Error, number, unknown>;
+};

package/dist/admin/src/hooks/useUpload.d.ts

@@ -0,0 +1,12 @@
+import { File, RawFile } from '../../../shared/contracts/files';
+interface Asset extends File {
+    rawFile: RawFile;
+}
+export declare const useUpload: () => {
+    upload: (asset: Asset, folderId: number) => Promise<File[]>;
+    cancel: () => void;
+    error: import("@strapi/utils/dist/errors").ApplicationError<"ApplicationError", string, unknown> | import("@strapi/utils/dist/errors").ValidationError<string, unknown> | null | undefined;
+    progress: number;
+    status: "error" | "success" | "idle" | "loading";
+};
+export {};

package/dist/admin/src/hooks/utils/rename-keys.d.ts

@@ -0,0 +1,6 @@
+type Primitive = string | number | boolean | null | undefined;
+export type DeepRecord<T> = {
+    [K in keyof T]: T[K] extends Primitive ? T[K] : DeepRecord<T[K]>;
+};
+export declare const recursiveRenameKeys: <T extends object>(obj: T, fn: (key: string) => string) => DeepRecord<T>;
+export {};

package/dist/admin/src/newConstants.d.ts

@@ -0,0 +1,45 @@
+export declare enum AssetType {
+    Video = "video",
+    Image = "image",
+    Document = "doc",
+    Audio = "audio"
+}
+export declare enum AssetSource {
+    Url = "url",
+    Computer = "computer"
+}
+export declare const PERMISSIONS: {
+    main: {
+        action: string;
+        subject: null;
+    }[];
+    copyLink: {
+        action: string;
+        subject: null;
+    }[];
+    create: {
+        action: string;
+        subject: null;
+    }[];
+    download: {
+        action: string;
+        subject: null;
+    }[];
+    read: {
+        action: string;
+        subject: null;
+    }[];
+    configureView: {
+        action: string;
+        subject: null;
+    }[];
+    settings: {
+        action: string;
+        subject: null;
+    }[];
+    update: {
+        action: string;
+        subject: null;
+        fields: null;
+    }[];
+};

package/dist/admin/src/pluginId.d.ts

@@ -0,0 +1,2 @@
+export declare const pluginId: string;
+export default pluginId;

package/dist/admin/src/utils/appendSearchParamsToUrl.d.ts

@@ -0,0 +1,6 @@
+interface AppendSearchParamsToUrlProps {
+    url?: string;
+    params?: Record<string, string | null | undefined> | string;
+}
+declare const appendSearchParamsToUrl: ({ url, params }: AppendSearchParamsToUrlProps) => string | undefined;
+export { appendSearchParamsToUrl };

package/dist/admin/src/utils/containsAssetFilter.d.ts

@@ -0,0 +1,2 @@
+import type { Query } from '../../../shared/contracts/files';
+export declare const containsAssetFilter: (query: Query | null) => boolean;

package/dist/admin/src/utils/createAssetUrl.d.ts

@@ -0,0 +1,2 @@
+import type { File } from '../../../shared/contracts/files';
+export declare const createAssetUrl: (asset: File, forThumbnail?: boolean) => string | undefined;

package/dist/admin/src/utils/displayedFilters.d.ts

@@ -0,0 +1,22 @@
+export declare const displayedFilters: ({
+    name: string;
+    fieldSchema: {
+        type: string;
+        options?: undefined;
+    };
+    metadatas: {
+        label: string;
+    };
+} | {
+    name: string;
+    fieldSchema: {
+        type: string;
+        options: {
+            label: string;
+            value: string;
+        }[];
+    };
+    metadatas: {
+        label: string;
+    };
+})[];

package/dist/admin/src/utils/downloadFile.d.ts

@@ -0,0 +1 @@
+export declare const downloadFile: (url: string, fileName: string) => Promise<void>;

package/dist/admin/src/utils/findRecursiveFolderByValue.d.ts

@@ -0,0 +1,10 @@
+import type { FolderNode } from '../../../shared/contracts/folders';
+interface FolderStructureValue extends Omit<FolderNode, 'children'> {
+    value: number | null;
+    children?: FolderStructureValue[];
+}
+type Value = number | null | {
+    value: number | null;
+};
+export declare function findRecursiveFolderByValue(data: FolderStructureValue[], value: Value): undefined;
+export {};

package/dist/admin/src/utils/formatBytes.d.ts

@@ -0,0 +1 @@
+export declare function formatBytes(receivedBytes: number | string, decimals?: number): string;

package/dist/admin/src/utils/formatDuration.d.ts

@@ -0,0 +1 @@
+export declare const formatDuration: (durationInSecond: number) => string;

package/dist/admin/src/utils/getAPIInnerErrors.d.ts

@@ -0,0 +1,14 @@
+import type { FetchError } from '@strapi/admin/strapi-admin';
+import type { MessageDescriptor } from 'react-intl';
+type GetAPIInnerErrorsReturn = {
+    [key: string]: MessageDescriptor;
+};
+/**
+ *
+ * Returns a normalized error message
+ *
+ */
+export declare function getAPIInnerErrors(error: FetchError, { getTrad }: {
+    getTrad: (key: string) => string;
+}): string | GetAPIInnerErrorsReturn | undefined;
+export {};

package/dist/admin/src/utils/getAllowedFiles.d.ts

@@ -0,0 +1,15 @@
+import type { File } from '../../../shared/contracts/files';
+/**
+ * Returns the files that can be added to the media field
+ * @param {Object[]} pluralTypes Array of string (allowedTypes)
+ * @param {Object[]} files Array of files
+ * @returns Object[]
+ */
+interface AllowedFiles extends File {
+    documentId: string;
+    isSelectable: boolean;
+    locale: string | null;
+    type: string;
+}
+export declare const getAllowedFiles: (pluralTypes: string[], files: AllowedFiles[]) => AllowedFiles[];
+export {};

package/dist/admin/src/utils/getBreadcrumbDataCM.d.ts

@@ -0,0 +1,19 @@
+import type { Folder } from '../../../shared/contracts/folders';
+import type { MessageDescriptor } from 'react-intl';
+interface BreadcrumbDataFolder extends Omit<Folder, 'children' | 'files' | 'parent'> {
+    parent?: BreadcrumbDataFolder;
+    children?: {
+        count: number;
+    };
+    files?: {
+        count: number;
+    };
+}
+interface BreadcrumbItem {
+    id?: number | null;
+    label?: MessageDescriptor | string;
+    path?: string;
+}
+type BreadcrumbData = BreadcrumbItem | [];
+export declare const getBreadcrumbDataCM: (folder: BreadcrumbDataFolder | null) => BreadcrumbData[];
+export {};

package/dist/admin/src/utils/getBreadcrumbDataML.d.ts

@@ -0,0 +1,18 @@
+import type { Query } from '../../../shared/contracts/files';
+import type { Folder } from '../../../shared/contracts/folders';
+import type { MessageDescriptor } from 'react-intl';
+interface GetBreadcrumbDataMLProps {
+    folder: Folder;
+    options: {
+        pathname: string;
+        query?: Query;
+    };
+}
+interface GetBreadcrumbDataMLReturn {
+    id: number | null;
+    label: string | MessageDescriptor;
+    href?: string;
+}
+type BreadcrumbData = GetBreadcrumbDataMLReturn | [];
+export declare const getBreadcrumbDataML: (folder: GetBreadcrumbDataMLProps['folder'] | null, { pathname, query }: GetBreadcrumbDataMLProps['options']) => BreadcrumbData[];
+export default getBreadcrumbDataML;

package/dist/admin/src/utils/getFileExtension.d.ts

@@ -0,0 +1 @@
+export declare const getFileExtension: (ext?: string | null) => string | null | undefined;

package/dist/admin/src/utils/getFolderParents.d.ts

@@ -0,0 +1,10 @@
+import type { FolderNode } from '../../../shared/contracts/folders';
+interface FolderStructureValue extends Omit<FolderNode, 'children'> {
+    value: number | null;
+    children?: FolderStructureValue[];
+}
+export declare const getFolderParents: (folders: FolderStructureValue[], currentFolderId: number) => {
+    id: number | null | undefined;
+    label: string | undefined;
+}[];
+export {};

package/dist/admin/src/utils/getFolderURL.d.ts

@@ -0,0 +1,5 @@
+import type { Query } from '../../../shared/contracts/files';
+export declare const getFolderURL: (pathname: string, currentQuery: Query, { folder, folderPath }?: {
+    folder?: string;
+    folderPath?: string;
+}) => string;

package/dist/admin/src/utils/getTrad.d.ts

@@ -0,0 +1 @@
+export declare const getTrad: (id: string) => string;

package/dist/admin/src/utils/index.d.ts

@@ -0,0 +1,25 @@
+export * from './appendSearchParamsToUrl';
+export * from './containsAssetFilter';
+export * from './createAssetUrl';
+export * from './displayedFilters';
+export * from './downloadFile';
+export * from './findRecursiveFolderByValue';
+export * from './formatBytes';
+export * from './formatDuration';
+export * from './getAllowedFiles';
+export * from './getAPIInnerErrors';
+export * from './getBreadcrumbDataCM';
+export * from './getBreadcrumbDataML';
+export * from './getFileExtension';
+export * from './getFolderParents';
+export * from './getFolderURL';
+export * from './getTrad';
+export * from './moveElement';
+export * from './normalizeAPIError';
+export * from './prefixFileUrlWithBackendUrl';
+export * from './prefixPluginTranslations';
+export * from './rawFileToAsset';
+export * from './toSingularTypes';
+export * from './typeFromMime';
+export * from './urlsToAssets';
+export * from './urlYupSchema';

package/dist/admin/src/utils/moveElement.d.ts

@@ -0,0 +1 @@
+export declare const moveElement: (array: number[], index: number, offset: number) => number[];

package/dist/admin/src/utils/normalizeAPIError.d.ts

@@ -0,0 +1,22 @@
+import type { FetchError } from '@strapi/admin/strapi-admin';
+interface NormalizeErrorOptions {
+    name?: string;
+    intlMessagePrefixCallback?: (id: string) => string;
+}
+interface NormalizeErrorReturn {
+    id: string;
+    defaultMessage: string;
+    name?: string;
+    values: Record<'path', string> | Record<string, never>;
+}
+/**
+ * Normalize the format of `ResponseError`
+ * in places where the hook `useAPIErrorHandler` can not called
+ * (e.g. outside of a React component).
+ */
+export declare function normalizeAPIError(apiError: FetchError, intlMessagePrefixCallback?: NormalizeErrorOptions['intlMessagePrefixCallback']): NormalizeErrorReturn | {
+    name: string;
+    message: string | null;
+    errors: NormalizeErrorReturn[];
+} | null;
+export {};

package/dist/admin/src/utils/prefixFileUrlWithBackendUrl.d.ts

@@ -0,0 +1 @@
+export declare const prefixFileUrlWithBackendUrl: (fileURL?: string) => string | undefined;

package/dist/admin/src/utils/prefixPluginTranslations.d.ts

@@ -0,0 +1,5 @@
+type Translations = {
+    [key: string]: string;
+};
+export declare const prefixPluginTranslations: (trad: Translations, pluginId?: string) => Translations;
+export {};

package/dist/admin/src/utils/rawFileToAsset.d.ts

@@ -0,0 +1,14 @@
+import { AssetSource } from '../newConstants';
+import type { RawFile } from '../../../shared/contracts/files';
+export declare const rawFileToAsset: (rawFile: RawFile, assetSource: AssetSource) => {
+    size: number;
+    createdAt: string;
+    name: string;
+    source: AssetSource;
+    type: import("../newConstants").AssetType;
+    url: string;
+    ext: string | undefined;
+    mime: string;
+    rawFile: RawFile;
+    isLocal: boolean;
+};

package/dist/admin/src/utils/toSingularTypes.d.ts

@@ -0,0 +1,2 @@
+export declare const toSingularTypes: (types?: string[]) => string[];
+export default toSingularTypes;

package/dist/admin/src/utils/typeFromMime.d.ts

@@ -0,0 +1,2 @@
+import { AssetType } from '../newConstants';
+export declare const typeFromMime: (mime: string) => AssetType;

package/dist/admin/src/utils/urlYupSchema.d.ts

@@ -0,0 +1,8 @@
+import * as yup from 'yup';
+export declare const urlSchema: yup.default<import("yup/lib/object").Assign<import("yup/lib/object").ObjectShape, {
+    urls: yup.default<string | undefined, Record<string, any>, string | undefined>;
+}>, Record<string, any>, import("yup/lib/object").TypeOfShape<import("yup/lib/object").Assign<import("yup/lib/object").ObjectShape, {
+    urls: yup.default<string | undefined, Record<string, any>, string | undefined>;
+}>>, import("yup/lib/object").AssertsShape<import("yup/lib/object").Assign<import("yup/lib/object").ObjectShape, {
+    urls: yup.default<string | undefined, Record<string, any>, string | undefined>;
+}>>>;

package/dist/admin/src/utils/urlsToAssets.d.ts

@@ -0,0 +1,10 @@
+import { AssetSource } from '../newConstants';
+export declare const urlsToAssets: (urls: string[]) => Promise<{
+    source: AssetSource;
+    name: string;
+    type: import("../newConstants").AssetType;
+    url: string;
+    ext: string | undefined;
+    mime: string | null;
+    rawFile: File;
+}[]>;

package/dist/shared/contracts/files.d.ts

@@ -1,6 +1,44 @@
 import { errors } from '@strapi/utils';
 type SortOrder = 'ASC' | 'DESC';
-type SortKey = 'createdAt' | 'name';
+type SortKey = 'createdAt' | 'name' | 'updatedAt';
+type ComparisonOperators<T> = {
+    [operator: string]: T | T[] | boolean;
+};
+export type FilterCondition<T> = {
+    [field: string]: T | ComparisonOperators<T> | FilterCondition<T>;
+};
+type Filters<T> = {
+    [logicOperator: string]: FilterCondition<T>[];
+};
+export type Query = {
+    _q?: string;
+    folderPath?: string;
+    folder?: null | number | {
+        id: number;
+    };
+    page?: string | number | {
+        id: string | number;
+    };
+    pageSize?: string | number;
+    pagination?: {
+        pageSize: number;
+    };
+    sort?: `${SortKey}:${SortOrder}`;
+    filters?: Filters<string | number | boolean>;
+    state?: boolean;
+};
+type FileFormat = {
+    name: string;
+    hash: string;
+    ext: string;
+    mime: string;
+    path: null | string;
+    width: number;
+    height: number;
+    size: number;
+    sizeInBytes: number;
+    url: string;
+};
 export interface File {
     id: number;
     name: string;
@@ -8,7 +46,7 @@ export interface File {
     caption?: string | null;
     width?: number;
     height?: number;
-    formats?: Record<string, unknown>;
+    formats?: Record<string, FileFormat>;
     hash: string;
     ext?: string;
     mime?: string;
@@ -20,7 +58,7 @@ export interface File {
     provider?: string;
     provider_metadata?: Record<string, unknown>;
     isUrlSigned?: boolean;
-    folder?: number;
+    folder?: number | null;
     folderPath?: string;
     related?: {
         id: string | number;
@@ -32,11 +70,10 @@ export interface File {
     createdAt?: string;
     updatedAt?: string;
     createdBy?: number;
+    publishedAt?: string;
     updatedBy?: number;
+    isLocal?: boolean;
 }
-/**
- * GET /upload/files - Get files
- */
 export interface RawFile extends Blob {
     size: number;
     lastModified: number;
@@ -49,6 +86,9 @@ export interface Pagination {
     pageCount: number;
     total: number;
 }
+/**
+ * GET /upload/files - Get files
+ */
 export declare namespace GetFiles {
     interface Request {
         body: {};

package/dist/shared/contracts/folders.d.ts

@@ -5,19 +5,19 @@ import type { File } from './files';
 export interface Folder {
     id: number;
     name: string;
-    pathId: number;
+    pathId?: number;
     /**
      * parent id
      */
-    parent?: number;
+    parent?: number | null | Folder;
     /**
      * children ids
      */
     children?: number[];
-    path: string;
+    path?: string;
     files?: File[];
 }
-type FolderNode = Partial<Folder> & {
+export type FolderNode = Partial<Omit<Folder, 'children'>> & {
     children: FolderNode[];
 };
 /**
@@ -88,7 +88,7 @@ export declare namespace UpdateFolder {
  *
  * Return the structure of a folder.
  */
-export declare namespace FolderStructureNamespace {
+export declare namespace GetFolderStructure {
     interface Request {
         query?: {};
     }
@@ -138,4 +138,3 @@ export declare namespace BulkMoveFolders {
         error?: errors.ApplicationError | errors.ValidationError;
     }
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/upload",
-  "version": "5.0.3",
+  "version": "5.0.5",
   "description": "Makes it easy to upload images and files to your Strapi Application.",
   "license": "SEE LICENSE IN LICENSE",
   "author": {
@@ -58,8 +58,8 @@
   "dependencies": {
     "@strapi/design-system": "2.0.0-rc.11",
     "@strapi/icons": "2.0.0-rc.11",
-    "@strapi/provider-upload-local": "5.0.3",
-    "@strapi/utils": "5.0.3",
+    "@strapi/provider-upload-local": "5.0.5",
+    "@strapi/utils": "5.0.5",
     "byte-size": "8.1.1",
     "cropperjs": "1.6.1",
     "date-fns": "2.30.0",
@@ -81,12 +81,13 @@
     "yup": "0.32.9"
   },
   "devDependencies": {
-    "@strapi/admin": "5.0.3",
+    "@strapi/admin": "5.0.5",
     "@strapi/pack-up": "5.0.0",
-    "@strapi/types": "5.0.3",
+    "@strapi/types": "5.0.5",
     "@testing-library/dom": "10.1.0",
     "@testing-library/react": "15.0.7",
     "@testing-library/user-event": "14.5.2",
+    "@types/byte-size": "8.1.2",
     "@types/fs-extra": "11.0.4",
     "@types/koa": "2.13.4",
     "@types/koa-range": "0.3.5",
@@ -108,7 +109,7 @@
     "styled-components": "^6.0.0"
   },
   "engines": {
-    "node": ">=18.0.0 <=20.x.x",
+    "node": ">=18.0.0 <=22.x.x",
     "npm": ">=6.0.0"
   },
   "strapi": {
@@ -118,5 +119,5 @@
     "required": true,
     "kind": "plugin"
   },
-  "gitHead": "3e37ea0306e6faf2c214a654ab00a2323d7e3ab7"
+  "gitHead": "9cbf0e65dc4979f0db4355c05a03917f21448367"
 }