@wordpress/media-utils 5.7.0 → 5.8.0

package/build-types/utils/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * A media attachment object in a REST API context.
+ *
+ * Simplified version of what's defined in the wp-types package.
+ *
+ * @see https://www.npmjs.com/package/wp-types
+ */
+interface WP_REST_API_Attachment {
+    /**
+     * Unique identifier for the attachment.
+     */
+    id: number;
+    /**
+     * The ID of the featured media for the post.
+     */
+    featured_media: number;
+    /**
+     * URL to the attachment.
+     */
+    link: string;
+    /**
+     * The date the attachment was published, in the site's timezone.
+     */
+    date: string;
+    /**
+     * The date the attachment was published, as GMT.
+     */
+    date_gmt: string;
+    /**
+     * The date the attachment was last modified, in the site's timezone.
+     */
+    modified: string;
+    /**
+     * The date the attachment was last modified, as GMT.
+     */
+    modified_gmt: string;
+    /**
+     * An alphanumeric identifier for the attachment unique to its type.
+     */
+    slug: string;
+    /**
+     * A named status for the attachment.
+     */
+    status: string;
+    /**
+     * Type of Post for the attachment.
+     */
+    type: 'attachment';
+    /**
+     * Alternative text to display when attachment is not displayed.
+     */
+    alt_text: string;
+    /**
+     * The attachment caption.
+     */
+    caption: {
+        /**
+         * Caption for the attachment, as it exists in the database. Only present when using the 'edit' context.
+         */
+        raw?: string;
+        /**
+         * HTML caption for the attachment, transformed for display.
+         */
+        rendered: string;
+    };
+    /**
+     * The attachment description.
+     */
+    description: {
+        /**
+         * Description for the attachment, as it exists in the database. Only present when using the 'edit' context.
+         */
+        raw?: string;
+        /**
+         * HTML description for the attachment, transformed for display.
+         */
+        rendered: string;
+    };
+    /**
+     * Attachment type.
+     */
+    media_type: 'image' | 'file';
+    /**
+     * The attachment MIME type.
+     */
+    mime_type: string;
+    /**
+     * Details about the media file, specific to its type.
+     */
+    media_details: {
+        [k: string]: unknown;
+    };
+    /**
+     * The ID for the associated post of the attachment.
+     */
+    post: number | null;
+    /**
+     * URL to the original attachment file.
+     */
+    source_url: string;
+    /**
+     * List of the missing image sizes of the attachment.  Only present when using the 'edit' context.
+     */
+    missing_image_sizes?: string[];
+    /**
+     * Permalink template for the attachment. Only present when using the 'edit' context and the post type is public.
+     */
+    permalink_template?: string;
+    /**
+     * Slug automatically generated from the attachment title. Only present when using the 'edit' context and the post type is public.
+     */
+    generated_slug?: string;
+    /**
+     * An array of the class names for the post container element.
+     */
+    class_list: string[];
+    /**
+     * The title for the attachment.
+     */
+    title: {
+        /**
+         * Title for the attachment, as it exists in the database. Only present when using the 'edit' context.
+         */
+        raw?: string;
+        /**
+         * HTML title for the attachment, transformed for display.
+         */
+        rendered: string;
+    };
+    /**
+     * The ID for the author of the attachment.
+     */
+    author: number;
+    /**
+     * Whether or not comments are open on the attachment.
+     */
+    comment_status: string;
+    /**
+     * Whether or not the attachment can be pinged.
+     */
+    ping_status: string;
+    /**
+     * Meta fields.
+     */
+    meta: [] | {
+        [k: string]: unknown;
+    };
+    /**
+     * The theme file to use to display the attachment.
+     */
+    template: string;
+    _links: {
+        [k: string]: {
+            href: string;
+            embeddable?: boolean;
+            [k: string]: unknown;
+        }[];
+    };
+    /**
+     * The embedded representation of relations. Only present when the '_embed' query parameter is set.
+     */
+    _embedded?: {
+        /**
+         * The author of the post.
+         */
+        author: unknown[];
+        /**
+         * The featured image post.
+         */
+        'wp:featuredmedia'?: WP_REST_API_Attachment[];
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+/**
+ * REST API attachment object with additional fields added by this project.
+ */
+export interface RestAttachment extends WP_REST_API_Attachment {
+}
+type BetterOmit<T, K extends PropertyKey> = {
+    [P in keyof T as P extends K ? never : P]: T[P];
+};
+/**
+ * Transformed attachment object.
+ */
+export type Attachment = BetterOmit<RestAttachment, 'alt_text' | 'source_url' | 'caption' | 'title'> & {
+    alt: WP_REST_API_Attachment['alt_text'];
+    caption: WP_REST_API_Attachment['caption']['raw'] & string;
+    title: WP_REST_API_Attachment['title']['raw'];
+    url: WP_REST_API_Attachment['source_url'];
+    poster?: WP_REST_API_Attachment['source_url'];
+};
+export type OnChangeHandler = (attachments: Partial<Attachment>[]) => void;
+export type OnSuccessHandler = (attachments: Partial<Attachment>[]) => void;
+export type OnErrorHandler = (error: Error) => void;
+export type CreateRestAttachment = Partial<RestAttachment>;
+export type AdditionalData = BetterOmit<CreateRestAttachment, 'meta'>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/build-types/utils/types.d.ts.map

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

package/build-types/utils/upload-error.d.ts

@@ -0,0 +1,19 @@
+interface UploadErrorArgs {
+    code: string;
+    message: string;
+    file: File;
+    cause?: Error;
+}
+/**
+ * MediaError class.
+ *
+ * Small wrapper around the `Error` class
+ * to hold an error code and a reference to a file object.
+ */
+export declare class UploadError extends Error {
+    code: string;
+    file: File;
+    constructor({ code, message, file, cause }: UploadErrorArgs);
+}
+export {};
+//# sourceMappingURL=upload-error.d.ts.map

package/build-types/utils/upload-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-error.d.ts","sourceRoot":"","sources":["../../src/utils/upload-error.ts"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;gBAEE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,eAAe;CAQ5D"}

package/build-types/utils/upload-media.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal dependencies
+ */
+import type { AdditionalData, OnChangeHandler, OnErrorHandler, OnSuccessHandler } from './types';
+interface UploadMediaArgs {
+    additionalData?: AdditionalData;
+    allowedTypes?: string[];
+    filesList: File[];
+    maxUploadFileSize?: number;
+    onError?: OnErrorHandler;
+    onFileChange?: OnChangeHandler;
+    onSuccess?: OnSuccessHandler;
+    wpAllowedMimeTypes?: Record<string, string> | null;
+    signal?: AbortSignal;
+}
+/**
+ * Upload a media file when the file upload button is activated
+ * or when adding a file to the editor via drag & drop.
+ *
+ * @param $0                    Parameters object passed to the function.
+ * @param $0.allowedTypes       Array with the types of media that can be uploaded, if unset all types are allowed.
+ * @param $0.additionalData     Additional data to include in the request.
+ * @param $0.filesList          List of files.
+ * @param $0.maxUploadFileSize  Maximum upload size in bytes allowed for the site.
+ * @param $0.onError            Function called when an error happens.
+ * @param $0.onFileChange       Function called each time a file or a temporary representation of the file is available.
+ * @param $0.wpAllowedMimeTypes List of allowed mime types and file extensions.
+ * @param $0.signal             Abort signal.
+ */
+export declare function uploadMedia({ wpAllowedMimeTypes, allowedTypes, additionalData, filesList, maxUploadFileSize, onError, onFileChange, signal, }: UploadMediaArgs): void;
+export {};
+//# sourceMappingURL=upload-media.d.ts.map

package/build-types/utils/upload-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-media.d.ts","sourceRoot":"","sources":["../../src/utils/upload-media.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,OAAO,KAAK,EACX,cAAc,EAEd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,MAAM,SAAS,CAAC;AAOjB,UAAU,eAAe;IAExB,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,SAAS,EAAE,IAAI,EAAE,CAAC;IAElB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB,YAAY,CAAC,EAAE,eAAe,CAAC;IAE/B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,kBAAkB,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,GAAG,IAAI,CAAC;IAErD,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAE,EAC5B,kBAAkB,EAClB,YAAY,EACZ,cAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,MAAM,GACN,EAAE,eAAe,QAkFjB"}

package/build-types/utils/upload-to-server.d.ts

@@ -0,0 +1,3 @@
+import type { CreateRestAttachment } from './types';
+export declare function uploadToServer(file: File, additionalData?: CreateRestAttachment, signal?: AbortSignal): Promise<import("./types").Attachment>;
+//# sourceMappingURL=upload-to-server.d.ts.map

package/build-types/utils/upload-to-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-to-server.d.ts","sourceRoot":"","sources":["../../src/utils/upload-to-server.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,SAAS,CAAC;AAEpE,wBAAsB,cAAc,CACnC,IAAI,EAAE,IAAI,EACV,cAAc,GAAE,oBAAyB,EACzC,MAAM,CAAC,EAAE,WAAW,yCAsBpB"}

package/build-types/utils/validate-file-size.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Verifies whether the file is within the file upload size limits for the site.
+ *
+ * @param file              File object.
+ * @param maxUploadFileSize Maximum upload size in bytes allowed for the site.
+ */
+export declare function validateFileSize(file: File, maxUploadFileSize?: number): void;
+//# sourceMappingURL=validate-file-size.d.ts.map

package/build-types/utils/validate-file-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-file-size.d.ts","sourceRoot":"","sources":["../../src/utils/validate-file-size.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,MAAM,QA2BvE"}

package/build-types/utils/validate-mime-type-for-user.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Verifies if the user is allowed to upload this mime type.
+ *
+ * @param file               File object.
+ * @param wpAllowedMimeTypes List of allowed mime types and file extensions.
+ */
+export declare function validateMimeTypeForUser(file: File, wpAllowedMimeTypes?: Record<string, string> | null): void;
+//# sourceMappingURL=validate-mime-type-for-user.d.ts.map

package/build-types/utils/validate-mime-type-for-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mime-type-for-user.d.ts","sourceRoot":"","sources":["../../src/utils/validate-mime-type-for-user.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,IAAI,EACV,kBAAkB,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,GAAG,IAAI,QA0BpD"}

package/build-types/utils/validate-mime-type.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Verifies if the caller (e.g. a block) supports this mime type.
+ *
+ * @param file         File object.
+ * @param allowedTypes List of allowed mime types.
+ */
+export declare function validateMimeType(file: File, allowedTypes?: string[]): void;
+//# sourceMappingURL=validate-mime-type.d.ts.map

package/build-types/utils/validate-mime-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mime-type.d.ts","sourceRoot":"","sources":["../../src/utils/validate-mime-type.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QA0BpE"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/media-utils",
-	"version": "5.7.0",
+	"version": "5.8.0",
 	"description": "WordPress Media Upload Utils.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -14,7 +14,7 @@
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/WordPress/gutenberg.git",
-		"directory": "packages/url"
+		"directory": "packages/media-utils"
 	},
 	"bugs": {
 		"url": "https://github.com/WordPress/gutenberg/issues"
@@ -25,15 +25,16 @@
 	},
 	"main": "build/index.js",
 	"module": "build-module/index.js",
+	"types": "build-types",
 	"dependencies": {
 		"@babel/runtime": "^7.16.0",
-		"@wordpress/api-fetch": "^7.7.0",
-		"@wordpress/blob": "^4.7.0",
-		"@wordpress/element": "^6.7.0",
-		"@wordpress/i18n": "^5.7.0"
+		"@wordpress/api-fetch": "^7.8.0",
+		"@wordpress/blob": "^4.8.0",
+		"@wordpress/element": "^6.8.0",
+		"@wordpress/i18n": "^5.8.0"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "c90d920de07c53dff82c5914635b56fafa503b7f"
+	"gitHead": "cecf5e14d317aa67407f77a7e5c8b6a43016bd42"
 }

package/src/index.ts

@@ -0,0 +1,9 @@
+export * from './components';
+
+export { uploadMedia } from './utils/upload-media';
+export { transformAttachment } from './utils/transform-attachment';
+export { validateFileSize } from './utils/validate-file-size';
+export { validateMimeType } from './utils/validate-mime-type';
+export { validateMimeTypeForUser } from './utils/validate-mime-type-for-user';
+
+export type { Attachment, RestAttachment } from './utils/types';

package/src/utils/flatten-form-data.ts

@@ -0,0 +1,33 @@
+/**
+ * Determines whether the passed argument appears to be a plain object.
+ *
+ * @param data The object to inspect.
+ */
+function isPlainObject( data: unknown ): data is Record< string, unknown > {
+	return (
+		data !== null &&
+		typeof data === 'object' &&
+		Object.getPrototypeOf( data ) === Object.prototype
+	);
+}
+
+/**
+ * Recursively flatten data passed to form data, to allow using multi-level objects.
+ *
+ * @param {FormData}      formData Form data object.
+ * @param {string}        key      Key to amend to form data object
+ * @param {string|Object} data     Data to be amended to form data.
+ */
+export function flattenFormData(
+	formData: FormData,
+	key: string,
+	data: string | undefined | Record< string, string >
+) {
+	if ( isPlainObject( data ) ) {
+		for ( const [ name, value ] of Object.entries( data ) ) {
+			flattenFormData( formData, `${ key }[${ name }]`, value );
+		}
+	} else if ( data !== undefined ) {
+		formData.append( key, String( data ) );
+	}
+}

package/src/utils/get-mime-types-array.ts

@@ -0,0 +1,29 @@
+/**
+ * Browsers may use unexpected mime types, and they differ from browser to browser.
+ * This function computes a flexible array of mime types from the mime type structured provided by the server.
+ * Converts { jpg|jpeg|jpe: "image/jpeg" } into [ "image/jpeg", "image/jpg", "image/jpeg", "image/jpe" ]
+ *
+ * @param {?Object} wpMimeTypesObject Mime type object received from the server.
+ *                                    Extensions are keys separated by '|' and values are mime types associated with an extension.
+ *
+ * @return An array of mime types or null
+ */
+export function getMimeTypesArray(
+	wpMimeTypesObject?: Record< string, string > | null
+) {
+	if ( ! wpMimeTypesObject ) {
+		return null;
+	}
+	return Object.entries( wpMimeTypesObject ).flatMap(
+		( [ extensionsString, mime ] ) => {
+			const [ type ] = mime.split( '/' );
+			const extensions = extensionsString.split( '|' );
+			return [
+				mime,
+				...extensions.map(
+					( extension ) => `${ type }/${ extension }`
+				),
+			];
+		}
+	);
+}

package/src/utils/test/flatten-form-data.ts

@@ -0,0 +1,49 @@
+/**
+ * Internal dependencies
+ */
+import { flattenFormData } from '../flatten-form-data';
+
+describe( 'flattenFormData', () => {
+	it( 'should flatten nested data structure', () => {
+		const data = new FormData();
+
+		class RichTextData {
+			toString() {
+				return 'i am rich text';
+			}
+		}
+
+		const additionalData = {
+			foo: null,
+			bar: 1234,
+			meta: {
+				nested: 'foo',
+				dothis: true,
+				dothat: false,
+				supermeta: {
+					nested: 'baz',
+				},
+			},
+			customClass: new RichTextData(),
+		};
+
+		for ( const [ key, value ] of Object.entries( additionalData ) ) {
+			flattenFormData(
+				data,
+				key,
+				value as Parameters< typeof flattenFormData >[ 2 ]
+			);
+		}
+
+		const actual = Object.fromEntries( data.entries() );
+		expect( actual ).toStrictEqual( {
+			bar: '1234',
+			foo: 'null',
+			'meta[dothat]': 'false',
+			'meta[dothis]': 'true',
+			'meta[nested]': 'foo',
+			'meta[supermeta][nested]': 'baz',
+			customClass: 'i am rich text',
+		} );
+	} );
+} );

package/src/utils/test/get-mime-types-array.ts

@@ -0,0 +1,47 @@
+/**
+ * Internal dependencies
+ */
+import { getMimeTypesArray } from '../get-mime-types-array';
+
+describe( 'getMimeTypesArray', () => {
+	it( 'should return null if it is "falsy" e.g: undefined or null', () => {
+		expect( getMimeTypesArray( null ) ).toEqual( null );
+		expect( getMimeTypesArray( undefined ) ).toEqual( null );
+	} );
+
+	it( 'should return an empty array if an empty object is passed', () => {
+		expect( getMimeTypesArray( {} ) ).toEqual( [] );
+	} );
+
+	it( 'should return the type plus a new mime type with type and subtype with the extension if a type is passed', () => {
+		expect( getMimeTypesArray( { ext: 'chicken' } ) ).toEqual( [
+			'chicken',
+			'chicken/ext',
+		] );
+	} );
+
+	it( 'should return the mime type passed and a new mime type with type and the extension as subtype', () => {
+		expect( getMimeTypesArray( { ext: 'chicken/ribs' } ) ).toEqual( [
+			'chicken/ribs',
+			'chicken/ext',
+		] );
+	} );
+
+	it( 'should return the mime type passed and an additional mime type per extension supported', () => {
+		expect( getMimeTypesArray( { 'jpg|jpeg|jpe': 'image/jpeg' } ) ).toEqual(
+			[ 'image/jpeg', 'image/jpg', 'image/jpeg', 'image/jpe' ]
+		);
+	} );
+
+	it( 'should handle multiple mime types', () => {
+		expect(
+			getMimeTypesArray( { 'ext|aaa': 'chicken/ribs', aaa: 'bbb' } )
+		).toEqual( [
+			'chicken/ribs',
+			'chicken/ext',
+			'chicken/aaa',
+			'bbb',
+			'bbb/aaa',
+		] );
+	} );
+} );

package/src/utils/test/upload-error.ts

@@ -0,0 +1,24 @@
+/**
+ * Internal dependencies
+ */
+import { UploadError } from '../upload-error';
+
+describe( 'UploadError', () => {
+	it( 'holds error code and file name', () => {
+		const file = new File( [], 'example.jpg', {
+			lastModified: 1234567891,
+			type: 'image/jpeg',
+		} );
+
+		const error = new UploadError( {
+			code: 'some_error',
+			message: 'An error occurred',
+			file,
+		} );
+
+		expect( error ).toStrictEqual( expect.any( Error ) );
+		expect( error.code ).toBe( 'some_error' );
+		expect( error.message ).toBe( 'An error occurred' );
+		expect( error.file ).toBe( file );
+	} );
+} );