@w0s/paapi-item-image-url-parser/dist/PaapiItemImageUrl.js

Parsing a PA-API 5.0 Item Image URL

/**
 * Parsing a PA-API 5.0 Item Image URL
 */
export default class {
    #url;
    #dir;
    #id;
    #size;
    #extension;
    /**
     * @param inputUrl - Image URL (e.g. new URL('https://m.media-amazon.com/images/I/5198TOs+rnL._SL160_.jpg') )
     */
    constructor(inputUrl) {
        this.#url = inputUrl;
        const matchGroups = /(?<dir>\/images\/[A-Z])\/(?<id>[a-zA-Z0-9\-_+%]+)(\._SL(?<size>[0-9]+)_)?(?<ext>\.[a-zA-Z0-9]+)$/u.exec(decodeURIComponent(inputUrl.pathname))?.groups;
        if (matchGroups === undefined) {
            throw new Error('The format of the URL does not seem to be that of an Amazon product image.');
        }
        const { dir, id, size, ext } = matchGroups;
        this.#dir = dir;
        this.#id = id;
        this.#size = size !== undefined ? Number(size) : undefined;
        this.#extension = ext;
    }
    /**
     * Common process to change values
     *
     * @param data - Value to change
     * @param data.size - Image size (e.g. 160)
     */
    #set(data) {
        this.#size = data?.size;
        if (data?.size === undefined) {
            this.#url.pathname = `${this.#dir}/${this.#id}${this.#extension}`;
        }
        else {
            this.#url.pathname = `${this.#dir}/${this.#id}._SL${String(data.size)}_${this.#extension}`;
        }
    }
    /**
     * Get the entire Image URL string
     *
     * @returns Image URL string
     */
    toString() {
        return this.#url.toString();
    }
    /**
     * Get the entire Image URL
     *
     * @returns Image URL
     */
    getURL() {
        return new URL(this.#url);
    }
    /**
     * Get the ID part of URL
     *
     * @returns ID of the image file name (e.g. '5198TOs+rnL')
     */
    getId() {
        return this.#id;
    }
    /**
     * Get the size part of URL
     *
     * @returns Image size (e.g. 160)
     */
    getSize() {
        return this.#size ?? null;
    }
    /**
     * Set the image size (Used to get images of different sizes)
     *
     * @param size - Image size (e.g. 160)
     */
    setSize(size) {
        if (!Number.isInteger(size)) {
            throw new TypeError('The image size must be specified as an integer.');
        }
        if (size < 1) {
            throw new RangeError('The image size must be a value greater than or equal to 1 (px).');
        }
        this.#set({
            size: size,
        });
    }
    /**
     * Remove the image size (Used to get the original size image)
     */
    removeSize() {
        this.#set();
    }
    /**
     * Multiply the size of the image (Used to get images of different sizes)
     *
     * @param multiply - Numerical value to multiply the image size
     */
    setSizeMultiply(multiply) {
        if (multiply <= 0) {
            throw new RangeError('The value to be multiply must be greater than zero.');
        }
        if (this.#size === undefined) {
            throw new Error('It is not possible to multiply the size of an image whose size is not specified. Please execute the `setSize()` method before this.');
        }
        const size = Math.round(this.#size * multiply);
        this.#set({
            size: size < 1 ? 1 : size,
        });
    }
    /**
     * Division the size of the image (Used to get images of different sizes)
     *
     * @param division - Numerical value to division the image size
     */
    setSizeDivision(division) {
        if (division <= 0) {
            throw new RangeError('The value to be division must be greater than zero.');
        }
        if (this.#size === undefined) {
            throw new Error('It is not possible to division the size of an image whose size is not specified. Please execute the `setSize()` method before this.');
        }
        const size = Math.round(this.#size / division);
        this.#set({
            size: size < 1 ? 1 : size,
        });
    }
    /**
     * Get the extension part of URL
     *
     * @returns Image file extension (e.g. '.jpg')
     */
    getExtension() {
        return this.#extension;
    }
}
//# sourceMappingURL=PaapiItemImageUrl.js.map