patreon-dl 1.0.0

package/dist/parsers/Parser.js

@@ -0,0 +1,439 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Parser_logger;
+import capitalize from 'capitalize';
+import { isTypeDownloadable } from '../entities/Downloadable.js';
+import { commonLog } from '../utils/logging/Logger.js';
+import ObjectHelper from '../utils/ObjectHelper.js';
+export default class Parser {
+    constructor(logger) {
+        _Parser_logger.set(this, void 0);
+        __classPrivateFieldSet(this, _Parser_logger, logger, "f");
+    }
+    /**
+     *
+     * @param relationships `data[index].relationships`, where `data[index]` corresponds
+     * to a product or post returned in an API response.
+     * @param targets Fields in `relationships` to process, e.g. `audio`, `images`
+     * @param included The `included` array of API response
+     * @param parentName The name of the parent item containing `relationships`; for logging purpose.
+     * @returns
+     */
+    fetchDownloadablesFromRelationships(relationships, targets, included, parentName, warnOnTargetNotFound = true) {
+        const result = {};
+        for (const [target, targetName] of Object.entries(targets)) {
+            this.log('debug', `Fetch downloadable ${targetName} from ${parentName} ('relationships.${target}')`);
+            const rel = relationships[target];
+            /**
+             * A relationship is an object that takes one of two forms.
+             * E.g. for 'images':
+             * { "data": [ { "id": "12345", "type": "media" } ...] }
+             *
+             * For 'audio':
+             *
+             * { "data": { "id": "246113102", "type": "media" } }
+             *
+             * So `rel` must consist of `data`, which can be an object or an array of objects,
+             * with each object having `id` and `type`.
+             */
+            const relData = rel && typeof rel === 'object' ? rel.data : null;
+            let rData = null; // Normalized data
+            if (relData) {
+                if (Array.isArray(relData)) {
+                    if (relData.every((r) => typeof r === 'object' && r.id && r.type)) {
+                        rData = relData;
+                    }
+                }
+                else if (typeof relData === 'object') {
+                    if (relData.id && relData.type) {
+                        rData = [relData];
+                    }
+                }
+            }
+            if (!rData || rData.length === 0) {
+                if (warnOnTargetNotFound) {
+                    this.log('warn', `${capitalize(targetName)} not found in API data of ${parentName} ('relationships.${target}')`);
+                }
+                continue;
+            }
+            this.log('debug', `Parse ${targetName}`);
+            const fetched = [];
+            let total = 0;
+            let found = 0;
+            for (const m of rData) {
+                const { id, type } = m;
+                if (id && type && isTypeDownloadable(type)) {
+                    total++;
+                    let mi;
+                    if (type === 'media') {
+                        const unknownMediaTypeAs = target === 'audio' ? 'audio' :
+                            target === 'audio_preview' ? 'audio' :
+                                target === 'images' ? 'image' :
+                                    undefined;
+                        mi = this.findInAPIResponseIncludedArray(included, id, type, unknownMediaTypeAs);
+                    }
+                    else {
+                        mi = this.findInAPIResponseIncludedArray(included, id, type);
+                    }
+                    if (mi) {
+                        found++;
+                        fetched.push(mi);
+                    }
+                }
+                else {
+                    this.log('debug', `Skipped non-downloadable item #${id} (type: ${type})`);
+                }
+            }
+            if (total === found) {
+                this.log('debug', `All ${total} downloadable ${targetName} parsed`);
+            }
+            else {
+                this.log('warn', `${found} / ${total} downloadable ${targetName} parsed for ${parentName}`);
+            }
+            result[target] = fetched;
+        }
+        return result;
+    }
+    findInAPIResponseIncludedArray(included, id, matchType, ...args) {
+        this.log('debug', `Find ${matchType} item #${id} in API response`);
+        for (const inc of included) {
+            if (inc && typeof inc === 'object' && inc.id === id && inc.type === matchType) {
+                this.log('debug', 'Found - parse item data');
+                if (matchType === 'media') {
+                    return this.parseMediaItemAPIDataInIncludedArray(inc, args[0]);
+                }
+                else if (matchType === 'campaign') {
+                    return this.parseCampaignAPIDataInIncludedArray(inc, included);
+                }
+                else if (matchType === 'user') {
+                    return this.parseUserAPIDataInIncludedArray(inc, args[0]);
+                }
+                else if (matchType === 'reward') {
+                    return this.parseRewardAPIDataInIncludedArray(inc);
+                }
+                else if (matchType === 'attachment') {
+                    return this.parseAttachmentAPIDataInIncludedArray(inc);
+                }
+            }
+        }
+        this.log('warn', `Item #${id} not found in API response or has invalid data`);
+        return null;
+    }
+    parseMediaItemAPIDataInIncludedArray(data, unknownMediaTypeAs) {
+        const { id, attributes } = data;
+        if (!id) {
+            this.log('error', 'Parse error: \'id\' field missing in API data of media item');
+            return null;
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            this.log('error', `Parse error: 'attributes' field missing in API data of media item #${id} or has incorrect type`);
+            return null;
+        }
+        const { file_name: filename = null, mimetype: mimeType = null, media_type: mediaType = null, created_at: createdAt = null } = attributes;
+        let mi = null;
+        if (mimeType === 'application/x-mpegURL' || mimeType?.startsWith('video/') || mediaType === 'video' || unknownMediaTypeAs === 'video') {
+            mi = {
+                type: 'video',
+                id,
+                filename,
+                createdAt,
+                mimeType,
+                size: {
+                    width: ObjectHelper.getProperty(attributes, 'display.width') || null,
+                    height: ObjectHelper.getProperty(attributes, 'display.height') || null
+                },
+                duration: ObjectHelper.getProperty(attributes, 'display.duration') || null,
+                /**
+                 * `attributes.download_url` in `included` array returns 404. Need to use `display.url`.
+                 * For posts, actual download URL for accessible videos is encapsulated in `data.attributes.post_file`.
+                 * That part is handled by `PostParser`.
+                 */
+                // DownloadURL: attributes.download_url || null,
+                downloadURL: null,
+                displayURLs: {
+                    thumbnail: ObjectHelper.getProperty(attributes, 'display.default_thumbnail.url') || null,
+                    video: ObjectHelper.getProperty(attributes, 'display.url') || null
+                }
+            };
+        }
+        else if (mimeType?.startsWith('image/') || mediaType === 'image' || unknownMediaTypeAs === 'image') {
+            mi = {
+                type: 'image',
+                imageType: 'default',
+                id,
+                filename,
+                createdAt,
+                mimeType,
+                downloadURL: attributes.download_url || null,
+                imageURLs: {
+                    default: ObjectHelper.getProperty(attributes, 'image_urls.default') || null,
+                    defaultSmall: ObjectHelper.getProperty(attributes, 'image_urls.default_small') || null,
+                    original: ObjectHelper.getProperty(attributes, 'image_urls.original') || null,
+                    thumbnail: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail') || null,
+                    thumbnailLarge: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_large') || null,
+                    thumbnailSmall: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_small') || null
+                }
+            };
+        }
+        else if (mimeType?.startsWith('audio/') || mediaType === 'audio' || unknownMediaTypeAs === 'audio') {
+            mi = {
+                type: 'audio',
+                id,
+                filename,
+                createdAt,
+                mimeType,
+                /**
+                 * Audio item data in API response can have identical structure as image, i.e. with `image_urls.thumbnail`,
+                 * `image_urls.original`, etc. These URLs all point to the same file, so it's only necessary to return
+                 * a single URL.
+                 */
+                url: ObjectHelper.getProperty(attributes, 'image_urls.original') ||
+                    ObjectHelper.getProperty(attributes, 'image_urls.default') ||
+                    attributes.download_url ||
+                    ObjectHelper.getProperty(attributes, 'image_urls.default_small') ||
+                    ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_large') ||
+                    ObjectHelper.getProperty(attributes, 'image_urls.thumbnail') ||
+                    ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_small') ||
+                    null
+            };
+        }
+        else if (mediaType === 'file' || unknownMediaTypeAs === 'file') {
+            mi = {
+                type: 'file',
+                id,
+                filename,
+                createdAt,
+                mimeType,
+                downloadURL: attributes.download_url || null // TODO: test this
+            };
+        }
+        else {
+            this.log('warn', `Media item #${id} has unrecognized media type '${mediaType}' or mime type '${mimeType}'`);
+        }
+        if (mi) {
+            this.log('debug', `Done parsing media item #${id} (type: ${mi.type})`);
+        }
+        return mi;
+    }
+    parseCampaignAPIDataInIncludedArray(data, included) {
+        const { id, attributes } = data;
+        if (!id) {
+            this.log('error', 'Parse error: \'id\' field missing in API data of campaign');
+            return null;
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            this.log('error', `Parse error: 'attributes' field missing in API data of campaign #${id} or has incorrect type`);
+            return null;
+        }
+        const rewards = [];
+        const rewardsData = ObjectHelper.getProperty(data, 'relationships.rewards.data');
+        if (rewardsData && Array.isArray(rewardsData)) {
+            let invalidRewardDataCount = 0;
+            for (const rewardData of rewardsData) {
+                if (typeof rewardData === 'object') {
+                    const { id: rewardId, type } = rewardData;
+                    if (type !== 'reward') {
+                        continue;
+                    }
+                    if (rewardId === undefined) {
+                        invalidRewardDataCount++;
+                        continue;
+                    }
+                    const reward = this.findInAPIResponseIncludedArray(included, rewardId, 'reward');
+                    if (reward) {
+                        rewards.push(reward);
+                    }
+                    else {
+                        invalidRewardDataCount++;
+                    }
+                }
+                else {
+                    invalidRewardDataCount++;
+                }
+            }
+            if (invalidRewardDataCount > 0) {
+                this.log('warn', `${invalidRewardDataCount} rewards for campaign #${id} could not be parsed due to invalid data`);
+            }
+        }
+        else {
+            this.log('warn', `Rewards data for campaign #${id} is missing or has incorrect type`);
+        }
+        const creatorId = ObjectHelper.getProperty(data, 'relationships.creator.data.id');
+        const creatorType = ObjectHelper.getProperty(data, 'relationships.creator.data.type');
+        let creator = null;
+        if (!creatorId) {
+            this.log('warn', `Creator ID missing in API data of campaign #${id} - no creator info will be available`);
+        }
+        else if (creatorType !== 'user') {
+            this.log('warn', `Creator of campaign #${id} has incorrect type (expecting 'user' but got '${creatorType}') - no creator info will be available`);
+        }
+        else {
+            this.log('debug', `Obtain creator info (user ID '${creatorId}')`);
+            creator = this.findInAPIResponseIncludedArray(included, creatorId, 'user', true);
+        }
+        const avatarImage = {
+            type: 'image',
+            id,
+            filename: 'avatar',
+            createdAt: null,
+            mimeType: null,
+            downloadURL: null,
+            imageType: 'default',
+            imageURLs: {
+                default: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.default') || null,
+                defaultSmall: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.default_small') || null,
+                original: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.original') || null,
+                thumbnail: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail') || null,
+                thumbnailLarge: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail_large') || null,
+                thumbnailSmall: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail_small') || null
+            }
+        };
+        const coverPhoto = {
+            type: 'image',
+            id,
+            filename: 'cover-photo',
+            mimeType: null,
+            imageType: 'campaignCoverPhoto',
+            imageURLs: {
+                large: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.large') || null,
+                medium: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.medium') || null,
+                small: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.small') || null,
+                xlarge: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.xlarge') || null,
+                xsmall: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.xsmall') || null
+            }
+        };
+        const campaign = {
+            type: 'campaign',
+            id,
+            name: attributes.name,
+            createdAt: attributes.created_at || null,
+            publishedAt: attributes.published_at || null,
+            avatarImage,
+            coverPhoto,
+            summary: attributes.summary,
+            url: attributes.url || null,
+            currency: attributes.currency || null,
+            rewards,
+            creator,
+            raw: data
+        };
+        this.log('debug', `Done parsing campaign #${id}`);
+        return campaign;
+    }
+    parseUserAPIDataInIncludedArray(data, asCreator = false) {
+        const { id, attributes } = data;
+        if (!id) {
+            this.log('error', 'Parse error: \'id\' field missing in API data of user');
+            return null;
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            this.log('error', `Parse error: 'attributes' field missing in API data of user #${id} or has incorrect type`);
+            return null;
+        }
+        const image = {
+            type: 'image',
+            id,
+            filename: asCreator ? 'creator-image' : 'user-image',
+            mimeType: null,
+            imageType: 'single',
+            imageURL: attributes.image_url || null
+        };
+        const thumbnail = {
+            type: 'image',
+            id,
+            filename: asCreator ? 'creator-thumbnail' : 'user-thumbnail',
+            mimeType: null,
+            imageType: 'single',
+            imageURL: attributes.thumb_url || null
+        };
+        const user = {
+            type: 'user',
+            id,
+            firstName: attributes.first_name,
+            lastName: attributes.last_name,
+            fullName: attributes.full_name,
+            createdAt: attributes.created || null,
+            image,
+            thumbnail,
+            url: attributes.url,
+            vanity: attributes.vanity,
+            raw: data
+        };
+        this.log('debug', `Done parsing user #${id}`);
+        return user;
+    }
+    parseRewardAPIDataInIncludedArray(data) {
+        const { id, attributes } = data;
+        if (!id) {
+            this.log('error', 'Parse error: \'id\' field missing in API data of reward');
+            return null;
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            this.log('error', `Parse error: 'attributes' field missing in API data of reward #${id} or has incorrect type`);
+            return null;
+        }
+        const amountCents = attributes.amount_cents !== undefined ? attributes.amount_cents : null;
+        const amountCurrency = attributes.currency || null;
+        let amount = null;
+        if (amountCents !== null && !isNaN(Number(amountCents)) && amountCurrency !== null) {
+            amount = `${Number(amountCents) / 100} ${amountCurrency}`;
+        }
+        const title = attributes.title || null;
+        const rewardFilenameSuffix = title ? ` (${title})` : `-${id}`;
+        const image = attributes.image_url ? {
+            type: 'image',
+            id,
+            filename: `reward${rewardFilenameSuffix}`,
+            mimeType: null,
+            imageType: 'single',
+            imageURL: attributes.image_url
+        } : null;
+        const reward = {
+            type: 'reward',
+            id,
+            title,
+            description: attributes.description || null,
+            amount,
+            createdAt: attributes.created_at || null,
+            publishedAt: attributes.published_at || null,
+            editedAt: attributes.edited_at || null,
+            image,
+            url: attributes.url || null
+        };
+        this.log('debug', `Done parsing reward #${id}`);
+        return reward;
+    }
+    parseAttachmentAPIDataInIncludedArray(data) {
+        const { id, attributes } = data;
+        if (!id) {
+            this.log('error', 'Parse error: \'id\' field missing in API data of attachment');
+            return null;
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            this.log('error', `Parse error: 'attributes' field missing in API data of attachment #${id} or has incorrect type`);
+            return null;
+        }
+        const attachment = {
+            type: 'attachment',
+            id,
+            name: attributes.name || null,
+            url: attributes.url || null
+        };
+        this.log('debug', `Done parsing attachment #${id}`);
+        return attachment;
+    }
+    log(level, ...msg) {
+        commonLog(__classPrivateFieldGet(this, _Parser_logger, "f"), level, this.name, ...msg);
+    }
+}
+_Parser_logger = new WeakMap();
+//# sourceMappingURL=Parser.js.map

package/dist/parsers/Parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parser.js","sourceRoot":"","sources":["../../src/parsers/Parser.ts"],"names":[],"mappings":"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","sourcesContent":["import capitalize from 'capitalize';\nimport { Campaign } from '../entities/Campaign.js';\nimport { DOWNLOADABLE_TYPES, Downloadable, isTypeDownloadable } from '../entities/Downloadable.js';\nimport { CampaignCoverPhotoMediaItem, DefaultImageMediaItem, MediaItem, SingleImageMediaItem } from '../entities/MediaItem.js';\nimport { User } from '../entities/User.js';\nimport Logger, { LogLevel, commonLog } from '../utils/logging/Logger.js';\nimport ObjectHelper from '../utils/ObjectHelper.js';\nimport { Attachment } from '../entities/Attachment.js';\nimport { Reward } from '../entities/Reward.js';\n\nexport default abstract class Parser {\n\n  protected abstract name: string;\n\n  #logger?: Logger | null;\n\n  constructor(logger?: Logger | null) {\n    this.#logger = logger;\n  }\n\n  /**\n   *\n   * @param relationships `data[index].relationships`, where `data[index]` corresponds\n   * to a product or post returned in an API response.\n   * @param targets Fields in `relationships` to process, e.g. `audio`, `images`\n   * @param included The `included` array of API response\n   * @param parentName The name of the parent item containing `relationships`; for logging purpose.\n   * @returns\n   */\n  protected fetchDownloadablesFromRelationships<T extends Record<string, string>>(\n    relationships: any,\n    targets: T,\n    included: any,\n    parentName: string,\n    warnOnTargetNotFound = true): Partial<Record<keyof T, Downloadable[]>> {\n\n    const result: Partial<Record<keyof T, Downloadable[]>> = {};\n\n    for (const [ target, targetName ] of Object.entries<string>(targets)) {\n      this.log('debug', `Fetch downloadable ${targetName} from ${parentName} ('relationships.${target}')`);\n      const rel = relationships[target];\n      /**\n       * A relationship is an object that takes one of two forms.\n       * E.g. for 'images':\n       * { \"data\": [ { \"id\": \"12345\", \"type\": \"media\" } ...] }\n       *\n       * For 'audio':\n       *\n       * { \"data\": { \"id\": \"246113102\", \"type\": \"media\" } }\n       *\n       * So `rel` must consist of `data`, which can be an object or an array of objects,\n       * with each object having `id` and `type`.\n       */\n      const relData = rel && typeof rel === 'object' ? rel.data : null;\n      let rData: { id: any; type: any }[] | null = null; // Normalized data\n      if (relData) {\n        if (Array.isArray(relData)) {\n          if (relData.every((r) => typeof r === 'object' && r.id && r.type)) {\n            rData = relData;\n          }\n        }\n        else if (typeof relData === 'object') {\n          if (relData.id && relData.type) {\n            rData = [ relData ];\n          }\n        }\n      }\n\n      if (!rData || rData.length === 0) {\n        if (warnOnTargetNotFound) {\n          this.log('warn', `${capitalize(targetName)} not found in API data of ${parentName} ('relationships.${target}')`);\n        }\n        continue;\n      }\n\n      this.log('debug', `Parse ${targetName}`);\n      const fetched: Downloadable[] = [];\n      let total = 0;\n      let found = 0;\n      for (const m of rData) {\n        const { id, type } = m;\n        if (id && type && isTypeDownloadable(type)) {\n          total++;\n          let mi;\n          if (type === 'media') {\n            const unknownMediaTypeAs =\n              target === 'audio' ? 'audio' :\n                target === 'audio_preview' ? 'audio' :\n                  target === 'images' ? 'image' :\n                    undefined;\n            mi = this.findInAPIResponseIncludedArray(included, id, type, unknownMediaTypeAs);\n          }\n          else {\n            mi = this.findInAPIResponseIncludedArray(included, id, type);\n          }\n          if (mi) {\n            found++;\n            fetched.push(mi);\n          }\n        }\n        else {\n          this.log('debug', `Skipped non-downloadable item #${id} (type: ${type})`);\n        }\n      }\n      if (total === found) {\n        this.log('debug', `All ${total} downloadable ${targetName} parsed`);\n      }\n      else {\n        this.log('warn', `${found} / ${total} downloadable ${targetName} parsed for ${parentName}`);\n      }\n      result[target as keyof T] = fetched;\n    }\n\n    return result;\n  }\n\n  /**\n   * A JSON API response typically contain an `included` field, which is an array\n   * of items (media, campaign, reward, etc.) that are referenced through its `id`\n   * by items contained in the `data` field of the same response.\n   *\n   * Items in the `included` field contain extra info, such as media URLs,\n   * not provided in the `data` items referencing it.\n   */\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: typeof DOWNLOADABLE_TYPES[number]): Downloadable | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: 'media', unknownMediaTypeAs?: 'image' | 'video' | 'audio' | 'file'): MediaItem | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: 'reward'): Reward | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: 'user', asCreator?: boolean): User | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: 'campaign'): Campaign | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: 'attachment'): Attachment | null;\n  protected findInAPIResponseIncludedArray(included: Array<any>, id: string, matchType: string, ...args: any[]): any {\n    this.log('debug', `Find ${matchType} item #${id} in API response`);\n    for (const inc of included) {\n      if (inc && typeof inc === 'object' && inc.id === id && inc.type === matchType) {\n        this.log('debug', 'Found - parse item data');\n\n        if (matchType === 'media') {\n          return this.parseMediaItemAPIDataInIncludedArray(inc, args[0]);\n        }\n        else if (matchType === 'campaign') {\n          return this.parseCampaignAPIDataInIncludedArray(inc, included);\n        }\n        else if (matchType === 'user') {\n          return this.parseUserAPIDataInIncludedArray(inc, args[0]);\n        }\n        else if (matchType === 'reward') {\n          return this.parseRewardAPIDataInIncludedArray(inc);\n        }\n        else if (matchType === 'attachment') {\n          return this.parseAttachmentAPIDataInIncludedArray(inc);\n        }\n      }\n    }\n\n    this.log('warn', `Item #${id} not found in API response or has invalid data`);\n    return null;\n  }\n\n  protected parseMediaItemAPIDataInIncludedArray(data: any, unknownMediaTypeAs?: 'image' | 'video' | 'audio' | 'file') {\n    const { id, attributes } = data;\n    if (!id) {\n      this.log('error', 'Parse error: \\'id\\' field missing in API data of media item');\n      return null;\n    }\n    if (!attributes || typeof attributes !== 'object') {\n      this.log('error', `Parse error: 'attributes' field missing in API data of media item #${id} or has incorrect type`);\n      return null;\n    }\n\n    const {\n      file_name: filename = null,\n      mimetype: mimeType = null,\n      media_type: mediaType = null,\n      created_at: createdAt = null\n    } = attributes;\n\n    let mi: MediaItem | null = null;\n    if (mimeType === 'application/x-mpegURL' || mimeType?.startsWith('video/') || mediaType === 'video' || unknownMediaTypeAs === 'video') {\n      mi = {\n        type: 'video',\n        id,\n        filename,\n        createdAt,\n        mimeType,\n        size: {\n          width: ObjectHelper.getProperty(attributes, 'display.width') || null,\n          height: ObjectHelper.getProperty(attributes, 'display.height') || null\n        },\n        duration: ObjectHelper.getProperty(attributes, 'display.duration') || null,\n        /**\n         * `attributes.download_url` in `included` array returns 404. Need to use `display.url`.\n         * For posts, actual download URL for accessible videos is encapsulated in `data.attributes.post_file`.\n         * That part is handled by `PostParser`.\n         */\n        // DownloadURL: attributes.download_url || null,\n        downloadURL: null,\n        displayURLs: {\n          thumbnail: ObjectHelper.getProperty(attributes, 'display.default_thumbnail.url') || null,\n          video: ObjectHelper.getProperty(attributes, 'display.url') || null\n        }\n      };\n    }\n    else if (mimeType?.startsWith('image/') || mediaType === 'image' || unknownMediaTypeAs === 'image') {\n      mi = {\n        type: 'image',\n        imageType: 'default',\n        id,\n        filename,\n        createdAt,\n        mimeType,\n        downloadURL: attributes.download_url || null,\n        imageURLs: {\n          default: ObjectHelper.getProperty(attributes, 'image_urls.default') || null,\n          defaultSmall: ObjectHelper.getProperty(attributes, 'image_urls.default_small') || null,\n          original: ObjectHelper.getProperty(attributes, 'image_urls.original') || null,\n          thumbnail: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail') || null,\n          thumbnailLarge: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_large') || null,\n          thumbnailSmall: ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_small') || null\n        }\n      };\n    }\n    else if (mimeType?.startsWith('audio/') || mediaType === 'audio' || unknownMediaTypeAs === 'audio') {\n      mi = {\n        type: 'audio',\n        id,\n        filename,\n        createdAt,\n        mimeType,\n        /**\n         * Audio item data in API response can have identical structure as image, i.e. with `image_urls.thumbnail`,\n         * `image_urls.original`, etc. These URLs all point to the same file, so it's only necessary to return\n         * a single URL.\n         */\n        url: ObjectHelper.getProperty(attributes, 'image_urls.original') ||\n                  ObjectHelper.getProperty(attributes, 'image_urls.default') ||\n                  attributes.download_url ||\n                  ObjectHelper.getProperty(attributes, 'image_urls.default_small') ||\n                  ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_large') ||\n                  ObjectHelper.getProperty(attributes, 'image_urls.thumbnail') ||\n                  ObjectHelper.getProperty(attributes, 'image_urls.thumbnail_small') ||\n                  null\n      };\n    }\n    else if (mediaType === 'file' || unknownMediaTypeAs === 'file') {\n      mi = {\n        type: 'file',\n        id,\n        filename,\n        createdAt,\n        mimeType,\n        downloadURL: attributes.download_url || null // TODO: test this\n      };\n    }\n    else {\n      this.log('warn', `Media item #${id} has unrecognized media type '${mediaType}' or mime type '${mimeType}'`);\n    }\n\n    if (mi) {\n      this.log('debug', `Done parsing media item #${id} (type: ${mi.type})`);\n    }\n\n    return mi;\n  }\n\n  protected parseCampaignAPIDataInIncludedArray(data: any, included: Array<any>) {\n    const { id, attributes } = data;\n    if (!id) {\n      this.log('error', 'Parse error: \\'id\\' field missing in API data of campaign');\n      return null;\n    }\n    if (!attributes || typeof attributes !== 'object') {\n      this.log('error', `Parse error: 'attributes' field missing in API data of campaign #${id} or has incorrect type`);\n      return null;\n    }\n\n    const rewards: Reward[] = [];\n    const rewardsData = ObjectHelper.getProperty(data, 'relationships.rewards.data');\n    if (rewardsData && Array.isArray(rewardsData)) {\n      let invalidRewardDataCount = 0;\n      for (const rewardData of rewardsData) {\n        if (typeof rewardData === 'object') {\n          const { id: rewardId, type } = rewardData;\n          if (type !== 'reward') {\n            continue;\n          }\n          if (rewardId === undefined) {\n            invalidRewardDataCount++;\n            continue;\n          }\n          const reward = this.findInAPIResponseIncludedArray(included, rewardId, 'reward');\n          if (reward) {\n            rewards.push(reward);\n          }\n          else {\n            invalidRewardDataCount++;\n          }\n        }\n        else {\n          invalidRewardDataCount++;\n        }\n      }\n      if (invalidRewardDataCount > 0) {\n        this.log('warn', `${invalidRewardDataCount} rewards for campaign #${id} could not be parsed due to invalid data`);\n      }\n    }\n    else {\n      this.log('warn', `Rewards data for campaign #${id} is missing or has incorrect type`);\n    }\n\n    const creatorId = ObjectHelper.getProperty(data, 'relationships.creator.data.id');\n    const creatorType = ObjectHelper.getProperty(data, 'relationships.creator.data.type');\n    let creator: User | null = null;\n    if (!creatorId) {\n      this.log('warn', `Creator ID missing in API data of campaign #${id} - no creator info will be available`);\n    }\n    else if (creatorType !== 'user') {\n      this.log('warn', `Creator of campaign #${id} has incorrect type (expecting 'user' but got '${creatorType}') - no creator info will be available`);\n    }\n    else {\n      this.log('debug', `Obtain creator info (user ID '${creatorId}')`);\n      creator = this.findInAPIResponseIncludedArray(included, creatorId, 'user', true);\n    }\n    const avatarImage: DefaultImageMediaItem = {\n      type: 'image',\n      id, // Use campaign ID\n      filename: 'avatar',\n      createdAt: null,\n      mimeType: null,\n      downloadURL: null,\n      imageType: 'default',\n      imageURLs: {\n        default: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.default') || null,\n        defaultSmall: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.default_small') || null,\n        original: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.original') || null,\n        thumbnail: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail') || null,\n        thumbnailLarge: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail_large') || null,\n        thumbnailSmall: ObjectHelper.getProperty(attributes, 'avatar_photo_image_urls.thumbnail_small') || null\n      }\n    };\n    const coverPhoto: CampaignCoverPhotoMediaItem = {\n      type: 'image',\n      id, // Use campaign ID\n      filename: 'cover-photo',\n      mimeType: null,\n      imageType: 'campaignCoverPhoto',\n      imageURLs: {\n        large: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.large') || null,\n        medium: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.medium') || null,\n        small: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.small') || null,\n        xlarge: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.xlarge') || null,\n        xsmall: ObjectHelper.getProperty(attributes, 'cover_photo_url_sizes.xsmall') || null\n      }\n    };\n\n    const campaign: Campaign = {\n      type: 'campaign',\n      id,\n      name: attributes.name,\n      createdAt: attributes.created_at || null,\n      publishedAt: attributes.published_at || null,\n      avatarImage,\n      coverPhoto,\n      summary: attributes.summary,\n      url: attributes.url || null,\n      currency: attributes.currency || null,\n      rewards,\n      creator,\n      raw: data\n    };\n    this.log('debug', `Done parsing campaign #${id}`);\n    return campaign;\n  }\n\n  protected parseUserAPIDataInIncludedArray(data: any, asCreator = false) {\n    const { id, attributes } = data;\n    if (!id) {\n      this.log('error', 'Parse error: \\'id\\' field missing in API data of user');\n      return null;\n    }\n    if (!attributes || typeof attributes !== 'object') {\n      this.log('error', `Parse error: 'attributes' field missing in API data of user #${id} or has incorrect type`);\n      return null;\n    }\n    const image: SingleImageMediaItem = {\n      type: 'image',\n      id,\n      filename: asCreator ? 'creator-image' : 'user-image',\n      mimeType: null,\n      imageType: 'single',\n      imageURL: attributes.image_url || null\n    };\n    const thumbnail: SingleImageMediaItem = {\n      type: 'image',\n      id,\n      filename: asCreator ? 'creator-thumbnail' : 'user-thumbnail',\n      mimeType: null,\n      imageType: 'single',\n      imageURL: attributes.thumb_url || null\n    };\n    const user: User = {\n      type: 'user',\n      id,\n      firstName: attributes.first_name,\n      lastName: attributes.last_name,\n      fullName: attributes.full_name,\n      createdAt: attributes.created || null,\n      image,\n      thumbnail,\n      url: attributes.url,\n      vanity: attributes.vanity,\n      raw: data\n    };\n    this.log('debug', `Done parsing user #${id}`);\n    return user;\n  }\n\n  protected parseRewardAPIDataInIncludedArray(data: any) {\n    const { id, attributes } = data;\n    if (!id) {\n      this.log('error', 'Parse error: \\'id\\' field missing in API data of reward');\n      return null;\n    }\n    if (!attributes || typeof attributes !== 'object') {\n      this.log('error', `Parse error: 'attributes' field missing in API data of reward #${id} or has incorrect type`);\n      return null;\n    }\n    const amountCents = attributes.amount_cents !== undefined ? attributes.amount_cents : null;\n    const amountCurrency = attributes.currency || null;\n    let amount: string | null = null;\n    if (amountCents !== null && !isNaN(Number(amountCents)) && amountCurrency !== null) {\n      amount = `${Number(amountCents) / 100} ${amountCurrency}`;\n    }\n    const title = attributes.title || null;\n    const rewardFilenameSuffix = title ? ` (${title})` : `-${id}`;\n    const image: SingleImageMediaItem | null = attributes.image_url ? {\n      type: 'image',\n      id,\n      filename: `reward${rewardFilenameSuffix}`,\n      mimeType: null,\n      imageType: 'single',\n      imageURL: attributes.image_url\n    } : null;\n    const reward: Reward = {\n      type: 'reward',\n      id,\n      title,\n      description: attributes.description || null,\n      amount,\n      createdAt: attributes.created_at || null,\n      publishedAt: attributes.published_at || null,\n      editedAt: attributes.edited_at || null,\n      image,\n      url: attributes.url || null\n    };\n    this.log('debug', `Done parsing reward #${id}`);\n    return reward;\n  }\n\n  protected parseAttachmentAPIDataInIncludedArray(data: any) {\n    const { id, attributes } = data;\n    if (!id) {\n      this.log('error', 'Parse error: \\'id\\' field missing in API data of attachment');\n      return null;\n    }\n    if (!attributes || typeof attributes !== 'object') {\n      this.log('error', `Parse error: 'attributes' field missing in API data of attachment #${id} or has incorrect type`);\n      return null;\n    }\n    const attachment: Attachment = {\n      type: 'attachment',\n      id,\n      name: attributes.name || null,\n      url: attributes.url || null\n    };\n    this.log('debug', `Done parsing attachment #${id}`);\n    return attachment;\n  }\n\n  protected log(level: LogLevel, ...msg: Array<any>) {\n    commonLog(this.#logger, level, this.name, ...msg);\n  }\n}\n"]}

package/dist/parsers/PostParser.d.ts

@@ -0,0 +1,7 @@
+import { PostCollection } from '../entities/Post.js';
+import Parser from './Parser.js';
+export default class PostParser extends Parser {
+    protected name: string;
+    parsePostsAPIResponse(json: any, _url: string): PostCollection;
+}
+//# sourceMappingURL=PostParser.d.ts.map

package/dist/parsers/PostParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostParser.d.ts","sourceRoot":"","sources":["../../src/parsers/PostParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAQ,cAAc,EAAa,MAAM,qBAAqB,CAAC;AAGtE,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,MAAM;IAE5C,SAAS,CAAC,IAAI,SAAgB;IAE9B,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;CA4R/D"}