patreon-dl 1.0.0

package/dist/utils/FilenameFormatHelper.d.ts

@@ -0,0 +1,44 @@
+import { Campaign } from '../entities/Campaign.js';
+import { MediaLike } from '../entities/MediaItem.js';
+import { Product } from '../entities/Product.js';
+import { FormatFieldRules } from './Formatter.js';
+import { Attachment } from '../entities/Attachment.js';
+import { Post } from '../entities/Post.js';
+type CampaignDirNameFormatFieldName = 'creator.vanity' | 'creator.name' | 'creator.id' | 'campaign.name' | 'campaign.id';
+export declare const CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA: FormatFieldRules<CampaignDirNameFormatFieldName>;
+type ContentDirNameFormatFieldName = 'content.id' | 'content.type' | 'content.slug' | 'content.name';
+export declare const CONTENT_DIR_NAME_VALIDATION_SCHEMA: FormatFieldRules<ContentDirNameFormatFieldName>;
+type MediaFilenameFormatFieldName = 'media.id' | 'media.type' | 'media.filename' | 'media.variant';
+export declare const MEDIA_FILENAME_VALIDATION_SCHEMA: FormatFieldRules<MediaFilenameFormatFieldName>;
+export default class FilenameFormatHelper {
+    #private;
+    static getCampaignDirName(campaign: Campaign, format: string): string;
+    static getContentDirName(content: Product | Post, format: string): string;
+    static getMediaFilename(media: MediaLike & {
+        variant: string | null;
+    }, format: string): string;
+    static getAttachmentFilename(att: Attachment, format: string): string;
+    static validateCampaignDirNameFormat(format: string): {
+        validateOK: boolean;
+        regex?: undefined;
+    } | {
+        validateOK: boolean | null;
+        regex: RegExp;
+    };
+    static validateContentDirNameFormat(format: string): {
+        validateOK: boolean;
+        regex?: undefined;
+    } | {
+        validateOK: boolean | null;
+        regex: RegExp;
+    };
+    static validateMediaFilenameFormat(format: string): {
+        validateOK: boolean;
+        regex?: undefined;
+    } | {
+        validateOK: boolean | null;
+        regex: RegExp;
+    };
+}
+export {};
+//# sourceMappingURL=FilenameFormatHelper.d.ts.map

package/dist/utils/FilenameFormatHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilenameFormatHelper.d.ts","sourceRoot":"","sources":["../../src/utils/FilenameFormatHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAkB,EAAmB,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AAEjG,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,KAAK,8BAA8B,GACjC,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,eAAe,GACf,aAAa,CAAC;AAEhB,eAAO,MAAM,mCAAmC,EAAE,gBAAgB,CAAC,8BAA8B,CAMhG,CAAC;AAEF,KAAK,6BAA6B,GAChC,YAAY,GACZ,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AAEjB,eAAO,MAAM,kCAAkC,EAAE,gBAAgB,CAAC,6BAA6B,CAK9F,CAAC;AAEF,KAAK,4BAA4B,GAC/B,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,eAAe,CAAC;AAElB,eAAO,MAAM,gCAAgC,EAAE,gBAAgB,CAAC,4BAA4B,CAK3F,CAAC;AAMF,MAAM,CAAC,OAAO,OAAO,oBAAoB;;IAEvC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAYrE,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAqBzE,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAW9F,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAsBrE,MAAM,CAAC,6BAA6B,CAAC,MAAM,EAAE,MAAM;;;;;;;IAInD,MAAM,CAAC,4BAA4B,CAAC,MAAM,EAAE,MAAM;;;;;;;IAIlD,MAAM,CAAC,2BAA2B,CAAC,MAAM,EAAE,MAAM;;;;;;;CAGlD"}

package/dist/utils/FilenameFormatHelper.js

@@ -0,0 +1,98 @@
+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 _a, _FilenameFormatHelper_getFilename;
+import sanitizeFilename from 'sanitize-filename';
+import Formatter from './Formatter.js';
+import URLHelper from './URLHelper.js';
+export const CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA = [
+    { name: 'creator.vanity', atLeastOneOf: true },
+    { name: 'creator.name', atLeastOneOf: true },
+    { name: 'creator.id', atLeastOneOf: true },
+    { name: 'campaign.name', atLeastOneOf: true },
+    { name: 'campaign.id', atLeastOneOf: true }
+];
+export const CONTENT_DIR_NAME_VALIDATION_SCHEMA = [
+    { name: 'content.id', atLeastOneOf: true },
+    { name: 'content.type', atLeastOneOf: false },
+    { name: 'content.slug', atLeastOneOf: true },
+    { name: 'content.name', atLeastOneOf: false }
+];
+export const MEDIA_FILENAME_VALIDATION_SCHEMA = [
+    { name: 'media.id', atLeastOneOf: true },
+    { name: 'media.type', atLeastOneOf: false },
+    { name: 'media.filename', atLeastOneOf: true },
+    { name: 'media.variant', atLeastOneOf: false }
+];
+const CAMPAIGN_DIR_NAME_FALLBACK_FORMAT = 'campaign-{campaign.id}';
+const CONTENT_DIR_NAME_FALLBACK_FORMAT = '{content.type}-{content.id}';
+const MEDIA_FILENAME_FALLBACK_FORMAT = '{media.type}-{media.id}';
+export default class FilenameFormatHelper {
+    static getCampaignDirName(campaign, format) {
+        const dict = {
+            'creator.vanity': campaign.creator?.vanity,
+            'creator.name': campaign.creator?.fullName,
+            'creator.id': campaign.creator?.id,
+            'campaign.name': campaign.name,
+            'campaign.id': campaign.id
+        };
+        return __classPrivateFieldGet(this, _a, "m", _FilenameFormatHelper_getFilename).call(this, format, dict, CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA, CAMPAIGN_DIR_NAME_FALLBACK_FORMAT);
+    }
+    static getContentDirName(content, format) {
+        const dict = {
+            'content.id': content.id,
+            'content.type': content.type,
+            'content.slug': null,
+            'content.name': null
+        };
+        if (content.type === 'post') {
+            const urlAnalysis = content.url ? URLHelper.analyzeURL(content.url) : null;
+            dict['content.slug'] = urlAnalysis && urlAnalysis.type === 'post' ? urlAnalysis.slug : null;
+            dict['content.name'] = content.title;
+        }
+        else if (content.type === 'product') {
+            const urlAnalysis = URLHelper.analyzeURL(content.url);
+            dict['content.slug'] = urlAnalysis && urlAnalysis.type === 'product' ? urlAnalysis.slug : null;
+            dict['content.name'] = content.name;
+        }
+        return __classPrivateFieldGet(this, _a, "m", _FilenameFormatHelper_getFilename).call(this, format, dict, CONTENT_DIR_NAME_VALIDATION_SCHEMA, CONTENT_DIR_NAME_FALLBACK_FORMAT);
+    }
+    static getMediaFilename(media, format) {
+        const dict = {
+            'media.id': media.id,
+            'media.type': media.type,
+            'media.filename': media.filename,
+            'media.variant': media.variant
+        };
+        return __classPrivateFieldGet(this, _a, "m", _FilenameFormatHelper_getFilename).call(this, format, dict, MEDIA_FILENAME_VALIDATION_SCHEMA, MEDIA_FILENAME_FALLBACK_FORMAT);
+    }
+    static getAttachmentFilename(att, format) {
+        const dict = {
+            'media.id': att.id,
+            'media.type': att.type,
+            'media.filename': att.name,
+            'media.variant': null
+        };
+        return __classPrivateFieldGet(this, _a, "m", _FilenameFormatHelper_getFilename).call(this, format, dict, MEDIA_FILENAME_VALIDATION_SCHEMA, MEDIA_FILENAME_FALLBACK_FORMAT);
+    }
+    static validateCampaignDirNameFormat(format) {
+        return Formatter.validate(format, CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA);
+    }
+    static validateContentDirNameFormat(format) {
+        return Formatter.validate(format, CONTENT_DIR_NAME_VALIDATION_SCHEMA);
+    }
+    static validateMediaFilenameFormat(format) {
+        return Formatter.validate(format, MEDIA_FILENAME_VALIDATION_SCHEMA);
+    }
+}
+_a = FilenameFormatHelper, _FilenameFormatHelper_getFilename = function _FilenameFormatHelper_getFilename(format, dict, rules, fallbackFormat) {
+    const { validateOK, result } = Formatter.format(format, dict, rules);
+    if (validateOK === false) {
+        const fallback = Formatter.format(fallbackFormat, dict).result;
+        return sanitizeFilename(fallback);
+    }
+    return sanitizeFilename(result);
+};
+//# sourceMappingURL=FilenameFormatHelper.js.map

package/dist/utils/FilenameFormatHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilenameFormatHelper.js","sourceRoot":"","sources":["../../src/utils/FilenameFormatHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import sanitizeFilename from 'sanitize-filename';\nimport { Campaign } from '../entities/Campaign.js';\nimport { MediaLike } from '../entities/MediaItem.js';\nimport { Product } from '../entities/Product.js';\nimport Formatter, { FormatFieldName, FormatFieldRules, FormatFieldValues } from './Formatter.js';\nimport URLHelper from './URLHelper.js';\nimport { Attachment } from '../entities/Attachment.js';\nimport { Post } from '../entities/Post.js';\n\ntype CampaignDirNameFormatFieldName =\n  'creator.vanity' |\n  'creator.name' |\n  'creator.id' |\n  'campaign.name' |\n  'campaign.id';\n\nexport const CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA: FormatFieldRules<CampaignDirNameFormatFieldName> = [\n  { name: 'creator.vanity', atLeastOneOf: true },\n  { name: 'creator.name', atLeastOneOf: true },\n  { name: 'creator.id', atLeastOneOf: true },\n  { name: 'campaign.name', atLeastOneOf: true },\n  { name: 'campaign.id', atLeastOneOf: true }\n];\n\ntype ContentDirNameFormatFieldName =\n  'content.id' |\n  'content.type' |\n  'content.slug' |\n  'content.name';\n\nexport const CONTENT_DIR_NAME_VALIDATION_SCHEMA: FormatFieldRules<ContentDirNameFormatFieldName> = [\n  { name: 'content.id', atLeastOneOf: true },\n  { name: 'content.type', atLeastOneOf: false },\n  { name: 'content.slug', atLeastOneOf: true },\n  { name: 'content.name', atLeastOneOf: false }\n];\n\ntype MediaFilenameFormatFieldName =\n  'media.id' |\n  'media.type' |\n  'media.filename' |\n  'media.variant';\n\nexport const MEDIA_FILENAME_VALIDATION_SCHEMA: FormatFieldRules<MediaFilenameFormatFieldName> = [\n  { name: 'media.id', atLeastOneOf: true },\n  { name: 'media.type', atLeastOneOf: false },\n  { name: 'media.filename', atLeastOneOf: true },\n  { name: 'media.variant', atLeastOneOf: false }\n];\n\nconst CAMPAIGN_DIR_NAME_FALLBACK_FORMAT = 'campaign-{campaign.id}';\nconst CONTENT_DIR_NAME_FALLBACK_FORMAT = '{content.type}-{content.id}';\nconst MEDIA_FILENAME_FALLBACK_FORMAT = '{media.type}-{media.id}';\n\nexport default class FilenameFormatHelper {\n\n  static getCampaignDirName(campaign: Campaign, format: string): string {\n    const dict: FormatFieldValues<CampaignDirNameFormatFieldName> = {\n      'creator.vanity': campaign.creator?.vanity,\n      'creator.name': campaign.creator?.fullName,\n      'creator.id': campaign.creator?.id,\n      'campaign.name': campaign.name,\n      'campaign.id': campaign.id\n    };\n\n    return this.#getFilename(format, dict, CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA, CAMPAIGN_DIR_NAME_FALLBACK_FORMAT);\n  }\n\n  static getContentDirName(content: Product | Post, format: string): string {\n    const dict: FormatFieldValues<ContentDirNameFormatFieldName> = {\n      'content.id': content.id,\n      'content.type': content.type,\n      'content.slug': null,\n      'content.name': null\n    };\n    if (content.type === 'post') {\n      const urlAnalysis = content.url ? URLHelper.analyzeURL(content.url) : null;\n      dict['content.slug'] = urlAnalysis && urlAnalysis.type === 'post' ? urlAnalysis.slug : null;\n      dict['content.name'] = content.title;\n    }\n    else if (content.type === 'product') {\n      const urlAnalysis = URLHelper.analyzeURL(content.url);\n      dict['content.slug'] = urlAnalysis && urlAnalysis.type === 'product' ? urlAnalysis.slug : null;\n      dict['content.name'] = content.name;\n    }\n\n    return this.#getFilename(format, dict, CONTENT_DIR_NAME_VALIDATION_SCHEMA, CONTENT_DIR_NAME_FALLBACK_FORMAT);\n  }\n\n  static getMediaFilename(media: MediaLike & { variant: string | null }, format: string): string {\n    const dict: FormatFieldValues<MediaFilenameFormatFieldName> = {\n      'media.id': media.id,\n      'media.type': media.type,\n      'media.filename': media.filename,\n      'media.variant': media.variant\n    };\n\n    return this.#getFilename(format, dict, MEDIA_FILENAME_VALIDATION_SCHEMA, MEDIA_FILENAME_FALLBACK_FORMAT);\n  }\n\n  static getAttachmentFilename(att: Attachment, format: string): string {\n    const dict: FormatFieldValues<MediaFilenameFormatFieldName> = {\n      'media.id': att.id,\n      'media.type': att.type,\n      'media.filename': att.name,\n      'media.variant': null\n    };\n\n    return this.#getFilename(format, dict, MEDIA_FILENAME_VALIDATION_SCHEMA, MEDIA_FILENAME_FALLBACK_FORMAT);\n  }\n\n  static #getFilename<T extends FormatFieldName>(format: string, dict: FormatFieldValues<T>, rules: FormatFieldRules<T>, fallbackFormat: string) {\n    const { validateOK, result } = Formatter.format(format, dict, rules);\n\n    if (validateOK === false) {\n      const fallback = Formatter.format(fallbackFormat, dict).result;\n      return sanitizeFilename(fallback);\n    }\n\n    return sanitizeFilename(result);\n  }\n\n  static validateCampaignDirNameFormat(format: string) {\n    return Formatter.validate(format, CAMPAIGN_DIR_NAME_VALIDATION_SCHEMA);\n  }\n\n  static validateContentDirNameFormat(format: string) {\n    return Formatter.validate(format, CONTENT_DIR_NAME_VALIDATION_SCHEMA);\n  }\n\n  static validateMediaFilenameFormat(format: string) {\n    return Formatter.validate(format, MEDIA_FILENAME_VALIDATION_SCHEMA);\n  }\n}\n"]}

package/dist/utils/FllenameResolver.d.ts

@@ -0,0 +1,20 @@
+import { Response } from 'node-fetch';
+/**
+ * Used by `Fetcher.download()` to resolve the destination filename
+ * of the downloaded item. The resolver implementation depends on the
+ * type of target being downloaded. `resolve()` is called with the
+ * `Response` object fetched by `Fetcher`, since filename resolution could
+ * use data provided in the response headers.
+ */
+export default abstract class FilenameResolver<T> {
+    protected target: T;
+    protected srcURL: string;
+    constructor(target: T, srcURL: string);
+    abstract resolve(response: Response): string;
+    protected getFilenamePartsFromResponse(response: Response): {
+        name: string;
+        ext: string;
+    };
+    protected getExtensionByContentType(type: string): string;
+}
+//# sourceMappingURL=FllenameResolver.d.ts.map

package/dist/utils/FllenameResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FllenameResolver.d.ts","sourceRoot":"","sources":["../../src/utils/FllenameResolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC;;;;;;GAMG;AAEH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,gBAAgB,CAAC,CAAC;IAE9C,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM;IAKrC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAE5C,SAAS,CAAC,4BAA4B,CAAC,QAAQ,EAAE,QAAQ;;;;IA6BzD,SAAS,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM;CAWjD"}

package/dist/utils/FllenameResolver.js

@@ -0,0 +1,55 @@
+import contentDisposition from 'content-disposition';
+import mimeTypes from 'mime-types';
+import path from 'path';
+import URLHelper from './URLHelper.js';
+/**
+ * Used by `Fetcher.download()` to resolve the destination filename
+ * of the downloaded item. The resolver implementation depends on the
+ * type of target being downloaded. `resolve()` is called with the
+ * `Response` object fetched by `Fetcher`, since filename resolution could
+ * use data provided in the response headers.
+ */
+export default class FilenameResolver {
+    constructor(target, srcURL) {
+        this.target = target;
+        this.srcURL = srcURL;
+    }
+    getFilenamePartsFromResponse(response) {
+        const parts = {
+            name: '',
+            ext: ''
+        };
+        const disposition = response.headers.get('content-disposition');
+        if (disposition) {
+            const parsedDisposition = contentDisposition.parse(disposition);
+            const filename = parsedDisposition.parameters['filename'] || null;
+            if (filename) {
+                const parsed = path.parse(filename);
+                parts.name = parsed.name;
+                parts.ext = parsed.ext;
+            }
+        }
+        // Filename obtained from content-disposition could have wrong extension.
+        // Always use extension derived from headers content-type if available.
+        const contentType = response.headers.get('content-type') || null;
+        if (contentType) {
+            const extByContentType = this.getExtensionByContentType(contentType);
+            if (extByContentType) {
+                parts.ext = extByContentType;
+            }
+        }
+        return parts;
+    }
+    getExtensionByContentType(type) {
+        // Mime-types does not recognize 'application/x-mpegURL'
+        if (type === 'application/x-mpegURL' && URLHelper.getExtensionFromURL(this.srcURL) === '.m3u8') {
+            return '.m3u8';
+        }
+        let ext = mimeTypes.extension(type);
+        if (ext === 'jpeg') {
+            ext = 'jpg';
+        }
+        return ext ? `.${ext}` : '';
+    }
+}
+//# sourceMappingURL=FllenameResolver.js.map

package/dist/utils/FllenameResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FllenameResolver.js","sourceRoot":"","sources":["../../src/utils/FllenameResolver.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,qBAAqB,CAAC;AACrD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC;;;;;;GAMG;AAEH,MAAM,CAAC,OAAO,OAAgB,gBAAgB;IAK5C,YAAY,MAAS,EAAE,MAAc;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAIS,4BAA4B,CAAC,QAAkB;QACvD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,EAAE;SACR,CAAC;QAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAChE,IAAI,WAAW,EAAE;YACf,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;YAClE,IAAI,QAAQ,EAAE;gBACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzB,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;aACxB;SACF;QACD,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC;QACjE,IAAI,WAAW,EAAE;YACf,MAAM,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;YACrE,IAAI,gBAAgB,EAAE;gBACpB,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC;aAC9B;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAES,yBAAyB,CAAC,IAAY;QAC9C,wDAAwD;QACxD,IAAI,IAAI,KAAK,uBAAuB,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE;YAC9F,OAAO,OAAO,CAAC;SAChB;QACD,IAAI,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,MAAM,EAAE;YAClB,GAAG,GAAG,KAAK,CAAC;SACb;QACD,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,CAAC;CACF","sourcesContent":["import contentDisposition from 'content-disposition';\nimport mimeTypes from 'mime-types';\nimport { Response } from 'node-fetch';\nimport path from 'path';\nimport URLHelper from './URLHelper.js';\n\n/**\n * Used by `Fetcher.download()` to resolve the destination filename\n * of the downloaded item. The resolver implementation depends on the\n * type of target being downloaded. `resolve()` is called with the\n * `Response` object fetched by `Fetcher`, since filename resolution could\n * use data provided in the response headers.\n */\n\nexport default abstract class FilenameResolver<T> {\n\n  protected target: T;\n  protected srcURL: string;\n\n  constructor(target: T, srcURL: string) {\n    this.target = target;\n    this.srcURL = srcURL;\n  }\n\n  abstract resolve(response: Response): string;\n\n  protected getFilenamePartsFromResponse(response: Response) {\n    const parts = {\n      name: '',\n      ext: ''\n    };\n\n    const disposition = response.headers.get('content-disposition');\n    if (disposition) {\n      const parsedDisposition = contentDisposition.parse(disposition);\n      const filename = parsedDisposition.parameters['filename'] || null;\n      if (filename) {\n        const parsed = path.parse(filename);\n        parts.name = parsed.name;\n        parts.ext = parsed.ext;\n      }\n    }\n    // Filename obtained from content-disposition could have wrong extension.\n    // Always use extension derived from headers content-type if available.\n    const contentType = response.headers.get('content-type') || null;\n    if (contentType) {\n      const extByContentType = this.getExtensionByContentType(contentType);\n      if (extByContentType) {\n        parts.ext = extByContentType;\n      }\n    }\n\n    return parts;\n  }\n\n  protected getExtensionByContentType(type: string) {\n    // Mime-types does not recognize 'application/x-mpegURL'\n    if (type === 'application/x-mpegURL' && URLHelper.getExtensionFromURL(this.srcURL) === '.m3u8') {\n      return '.m3u8';\n    }\n    let ext = mimeTypes.extension(type);\n    if (ext === 'jpeg') {\n      ext = 'jpg';\n    }\n    return ext ? `.${ext}` : '';\n  }\n}\n"]}

package/dist/utils/Formatter.d.ts

@@ -0,0 +1,21 @@
+export type FormatFieldName = string;
+export type FormatFieldRules<T extends FormatFieldName> = {
+    name: T;
+    atLeastOneOf: boolean;
+}[];
+export type FormatFieldValues<T extends FormatFieldName> = Record<T, any>;
+export default class Formatter {
+    #private;
+    static format<T extends FormatFieldName>(format: string, dict: FormatFieldValues<T>, rules?: FormatFieldRules<T>): {
+        result: string;
+        validateOK: boolean | null;
+    };
+    static validate<T extends FormatFieldName>(format: string, schema: FormatFieldRules<T>): {
+        validateOK: boolean;
+        regex?: undefined;
+    } | {
+        validateOK: boolean | null;
+        regex: RegExp;
+    };
+}
+//# sourceMappingURL=Formatter.d.ts.map

package/dist/utils/Formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatter.d.ts","sourceRoot":"","sources":["../../src/utils/Formatter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,eAAe,IAAI;IACxD,IAAI,EAAE,CAAC,CAAC;IACR,YAAY,EAAE,OAAO,CAAC;CACvB,EAAE,CAAC;AAEJ,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAE1E,MAAM,CAAC,OAAO,OAAO,SAAS;;IAE5B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;;;;IA2FhH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;;;;;;;CAwBvF"}

package/dist/utils/Formatter.js

@@ -0,0 +1,112 @@
+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 _a, _Formatter_getFieldRegex;
+import escapeStringRegexp from 'escape-string-regexp';
+export default class Formatter {
+    static format(format, dict, rules) {
+        let result = '';
+        const fieldRegex = __classPrivateFieldGet(this, _a, "m", _Formatter_getFieldRegex).call(this, Object.keys(dict));
+        const emptyValuePlaceHolder = '//';
+        const emptyValAdjCondSepRegex = /\[[^[]*?]\?\s*?\/\/\s*?\[.*?\]\?|\[[^[]*?]\?\s*?\/\/|\/\/\s*?\[.*?]\?/g;
+        const condSepRegex = /\[(.*?)]\?/g;
+        const fields = Object.keys(dict);
+        const consumedFields = [];
+        const __findPositionOfFirstField = (s) => {
+            const match = fieldRegex.exec(s);
+            if (match) {
+                const foundField = s.substring(match.index + 1, match.index + match[0].length - 1);
+                const placeholder = s.substring(match.index, match.index + match[0].length);
+                if (fields.includes(foundField)) {
+                    return {
+                        field: foundField,
+                        placeholder,
+                        placeholderPosition: match.index
+                    };
+                }
+            }
+            return {
+                field: null,
+                placeholder: null,
+                placeholderPosition: -1
+            };
+        };
+        let { field, placeholder, placeholderPosition } = __findPositionOfFirstField(format);
+        while (field && placeholder && placeholderPosition >= 0) {
+            result += format.substring(0, placeholderPosition);
+            const fieldValue = dict[field];
+            if (fieldValue) {
+                result += fieldValue;
+                if (!consumedFields.includes(field)) {
+                    consumedFields.push(field);
+                }
+            }
+            else {
+                result += emptyValuePlaceHolder;
+            }
+            format = format.substring(placeholderPosition + placeholder.length);
+            if (format.length === 0) {
+                break;
+            }
+            ({ field, placeholder, placeholderPosition } = __findPositionOfFirstField(format));
+        }
+        result += format;
+        // Handle conditional separators
+        // - Strip empty value placeholders  + adjacent separators
+        result = result.replaceAll(emptyValAdjCondSepRegex, '');
+        // - Strip remaining empty value placeholders
+        result = result.replaceAll(emptyValuePlaceHolder, '');
+        // - Remove []? around conditional separators
+        result = result.replace(condSepRegex, '$1');
+        result = result.trim();
+        // Validate
+        let validateOK = null;
+        if (rules) {
+            const atLeastOneOfFields = rules.reduce((result, f) => {
+                if (f.atLeastOneOf) {
+                    result.push(f.name);
+                }
+                return result;
+            }, []);
+            validateOK = false;
+            if (result) {
+                for (const field of consumedFields) {
+                    if (atLeastOneOfFields.includes(field)) {
+                        validateOK = true;
+                        break;
+                    }
+                }
+            }
+        }
+        return {
+            result,
+            validateOK
+        };
+    }
+    static validate(format, schema) {
+        const fieldNames = schema.reduce((result, s) => {
+            if (s.atLeastOneOf) {
+                result.push(s.name);
+            }
+            return result;
+        }, []);
+        if (fieldNames.length === 0) {
+            return {
+                validateOK: true
+            };
+        }
+        const fieldRegex = __classPrivateFieldGet(this, _a, "m", _Formatter_getFieldRegex).call(this, fieldNames, 'g');
+        const match = fieldRegex.exec(format);
+        return {
+            validateOK: match && match.length > 0,
+            regex: fieldRegex
+        };
+    }
+}
+_a = Formatter, _Formatter_getFieldRegex = function _Formatter_getFieldRegex(fieldNames, flags) {
+    const pattern = fieldNames.map((k) => `{${escapeStringRegexp(k)}}`).join('|');
+    return new RegExp(pattern, flags);
+};
+//# sourceMappingURL=Formatter.js.map

package/dist/utils/Formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatter.js","sourceRoot":"","sources":["../../src/utils/Formatter.ts"],"names":[],"mappings":"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","sourcesContent":["import escapeStringRegexp from 'escape-string-regexp';\n\nexport type FormatFieldName = string;\n\nexport type FormatFieldRules<T extends FormatFieldName> = {\n  name: T;\n  atLeastOneOf: boolean;\n}[];\n\nexport type FormatFieldValues<T extends FormatFieldName> = Record<T, any>;\n\nexport default class Formatter {\n\n  static format<T extends FormatFieldName>(format: string, dict: FormatFieldValues<T>, rules?: FormatFieldRules<T>) {\n\n    let result = '';\n\n    const fieldRegex = this.#getFieldRegex(Object.keys(dict));\n    const emptyValuePlaceHolder = '//';\n    const emptyValAdjCondSepRegex = /\\[[^[]*?]\\?\\s*?\\/\\/\\s*?\\[.*?\\]\\?|\\[[^[]*?]\\?\\s*?\\/\\/|\\/\\/\\s*?\\[.*?]\\?/g;\n    const condSepRegex = /\\[(.*?)]\\?/g;\n\n    const fields = Object.keys(dict);\n    const consumedFields: string[] = [];\n\n    const __findPositionOfFirstField = (s: string) => {\n      const match = fieldRegex.exec(s);\n      if (match) {\n        const foundField = s.substring(match.index + 1, match.index + match[0].length - 1);\n        const placeholder = s.substring(match.index, match.index + match[0].length);\n        if (fields.includes(foundField)) {\n          return {\n            field: foundField as T,\n            placeholder,\n            placeholderPosition: match.index\n          };\n        }\n      }\n      return {\n        field: null,\n        placeholder: null,\n        placeholderPosition: -1\n      };\n    };\n\n    let { field, placeholder, placeholderPosition } = __findPositionOfFirstField(format);\n    while (field && placeholder && placeholderPosition >= 0) {\n      result += format.substring(0, placeholderPosition);\n      const fieldValue = dict[field];\n      if (fieldValue) {\n        result += fieldValue;\n        if (!consumedFields.includes(field)) {\n          consumedFields.push(field);\n        }\n      }\n      else {\n        result += emptyValuePlaceHolder;\n      }\n      format = format.substring(placeholderPosition + placeholder.length);\n\n      if (format.length === 0) {\n        break;\n      }\n      ({ field, placeholder, placeholderPosition } = __findPositionOfFirstField(format));\n    }\n    result += format;\n\n    // Handle conditional separators\n    // - Strip empty value placeholders  + adjacent separators\n    result = result.replaceAll(emptyValAdjCondSepRegex, '');\n    // - Strip remaining empty value placeholders\n    result = result.replaceAll(emptyValuePlaceHolder, '');\n    // - Remove []? around conditional separators\n    result = result.replace(condSepRegex, '$1');\n\n    result = result.trim();\n\n    // Validate\n    let validateOK: boolean | null = null;\n    if (rules) {\n      const atLeastOneOfFields = rules.reduce<string[]>((result, f) => {\n        if (f.atLeastOneOf) {\n          result.push(f.name);\n        }\n        return result;\n      }, []);\n\n      validateOK = false;\n      if (result) {\n        for (const field of consumedFields) {\n          if (atLeastOneOfFields.includes(field)) {\n            validateOK = true;\n            break;\n          }\n        }\n      }\n    }\n\n    return {\n      result,\n      validateOK\n    };\n  }\n\n  static validate<T extends FormatFieldName>(format: string, schema: FormatFieldRules<T>) {\n    const fieldNames = schema.reduce<string[]>((result, s) => {\n      if (s.atLeastOneOf) {\n        result.push(s.name);\n      }\n      return result;\n    }, []);\n    if (fieldNames.length === 0) {\n      return {\n        validateOK: true\n      };\n    }\n    const fieldRegex = this.#getFieldRegex(fieldNames, 'g');\n    const match = fieldRegex.exec(format);\n    return {\n      validateOK: match && match.length > 0,\n      regex: fieldRegex\n    };\n  }\n\n  static #getFieldRegex(fieldNames: string[], flags?: string) {\n    const pattern = fieldNames.map((k) => `{${escapeStringRegexp(k)}}`).join('|');\n    return new RegExp(pattern, flags);\n  }\n}\n"]}

package/dist/utils/MediaFilenameResolver.d.ts

@@ -0,0 +1,9 @@
+import { MediaLike } from '../entities/MediaItem.js';
+import { Response } from 'node-fetch';
+import FilenameResolver from './FllenameResolver.js';
+export default class MediaFilenameResolver<T extends MediaLike> extends FilenameResolver<T> {
+    #private;
+    constructor(target: T, srcURL: string, format: string, variant: string | null, ensureVariant: boolean);
+    resolve(response: Response): string;
+}
+//# sourceMappingURL=MediaFilenameResolver.d.ts.map

package/dist/utils/MediaFilenameResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaFilenameResolver.d.ts","sourceRoot":"","sources":["../../src/utils/MediaFilenameResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AAIrD,MAAM,CAAC,OAAO,OAAO,qBAAqB,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;;gBAK7E,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,EAAE,OAAO;IAUrG,OAAO,CAAC,QAAQ,EAAE,QAAQ;CAmE3B"}

package/dist/utils/MediaFilenameResolver.js

@@ -0,0 +1,90 @@
+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 _MediaFilenameResolver_format, _MediaFilenameResolver_variant;
+import path from 'path';
+import FilenameResolver from './FllenameResolver.js';
+import URLHelper from './URLHelper.js';
+import FilenameFormatHelper from './FilenameFormatHelper.js';
+export default class MediaFilenameResolver extends FilenameResolver {
+    constructor(target, srcURL, format, variant, ensureVariant) {
+        super(target, srcURL);
+        _MediaFilenameResolver_format.set(this, void 0);
+        _MediaFilenameResolver_variant.set(this, void 0);
+        __classPrivateFieldSet(this, _MediaFilenameResolver_format, format, "f");
+        __classPrivateFieldSet(this, _MediaFilenameResolver_variant, variant, "f");
+        if (ensureVariant && !__classPrivateFieldGet(this, _MediaFilenameResolver_format, "f").includes('{media.variant}')) {
+            __classPrivateFieldSet(this, _MediaFilenameResolver_format, `${format}[-]?{media.variant}`, "f");
+        }
+    }
+    resolve(response) {
+        const mi = this.target;
+        const miFilenameParts = mi.filename ? path.parse(mi.filename) : null;
+        const resFilenameParts = this.getFilenamePartsFromResponse(response);
+        const filenameParts = {
+            name: '',
+            ext: ''
+        };
+        /**
+         * Obtain `name` part from (in order of priority):
+         * 1. Media filename
+         * 2. Filename from response headers
+         * 3. If none of the above is available, fallback to using the media ID
+        */
+        if (miFilenameParts?.name) {
+            filenameParts.name = miFilenameParts.name;
+        }
+        else if (resFilenameParts.name) {
+            filenameParts.name = resFilenameParts.name;
+        }
+        else if (!__classPrivateFieldGet(this, _MediaFilenameResolver_format, "f").includes('{media.id}')) {
+            filenameParts.name = mi.id;
+        }
+        /**
+         * Obtain `extension` from (in order of priority):
+         * 1. Response headers
+         * 2. Media filename
+         * 3. Media mimetype
+         * 4. Src URL
+         */
+        if (resFilenameParts.ext) {
+            // Use media item filename if the same (preserves case)
+            if (miFilenameParts?.ext?.toLowerCase() === resFilenameParts.ext.toLowerCase() &&
+                filenameParts.name === miFilenameParts.name && __classPrivateFieldGet(this, _MediaFilenameResolver_format, "f").includes('{media.filename}')) {
+                filenameParts.ext = miFilenameParts.ext;
+            }
+            else {
+                filenameParts.ext = resFilenameParts.ext;
+            }
+        }
+        else if (miFilenameParts?.ext) {
+            filenameParts.ext = miFilenameParts.ext;
+        }
+        else if (mi.mimeType) {
+            filenameParts.ext = this.getExtensionByContentType(mi.mimeType);
+        }
+        else {
+            filenameParts.ext = URLHelper.getExtensionFromURL(this.srcURL);
+        }
+        const tmpMI = {
+            ...mi,
+            filename: filenameParts.name,
+            variant: __classPrivateFieldGet(this, _MediaFilenameResolver_variant, "f")
+        };
+        let resolvedFilename = FilenameFormatHelper.getMediaFilename(tmpMI, __classPrivateFieldGet(this, _MediaFilenameResolver_format, "f"));
+        if (filenameParts.ext) {
+            resolvedFilename += filenameParts.ext;
+        }
+        return resolvedFilename;
+    }
+}
+_MediaFilenameResolver_format = new WeakMap(), _MediaFilenameResolver_variant = new WeakMap();
+//# sourceMappingURL=MediaFilenameResolver.js.map

package/dist/utils/MediaFilenameResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaFilenameResolver.js","sourceRoot":"","sources":["../../src/utils/MediaFilenameResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport { MediaLike } from '../entities/MediaItem.js';\nimport { Response } from 'node-fetch';\nimport FilenameResolver from './FllenameResolver.js';\nimport URLHelper from './URLHelper.js';\nimport FilenameFormatHelper from './FilenameFormatHelper.js';\n\nexport default class MediaFilenameResolver<T extends MediaLike> extends FilenameResolver<T> {\n\n  #format: string;\n  #variant: string | null;\n\n  constructor(target: T, srcURL: string, format: string, variant: string | null, ensureVariant: boolean) {\n    super(target, srcURL);\n    this.#format = format;\n    this.#variant = variant;\n\n    if (ensureVariant && !this.#format.includes('{media.variant}')) {\n      this.#format = `${format}[-]?{media.variant}`;\n    }\n  }\n\n  resolve(response: Response) {\n    const mi = this.target;\n    const miFilenameParts = mi.filename ? path.parse(mi.filename) : null;\n    const resFilenameParts = this.getFilenamePartsFromResponse(response);\n\n    const filenameParts = {\n      name: '',\n      ext: ''\n    };\n\n    /**\n     * Obtain `name` part from (in order of priority):\n     * 1. Media filename\n     * 2. Filename from response headers\n     * 3. If none of the above is available, fallback to using the media ID\n    */\n    if (miFilenameParts?.name) {\n      filenameParts.name = miFilenameParts.name;\n    }\n    else if (resFilenameParts.name) {\n      filenameParts.name = resFilenameParts.name;\n    }\n    else if (!this.#format.includes('{media.id}')) {\n      filenameParts.name = mi.id;\n    }\n\n    /**\n     * Obtain `extension` from (in order of priority):\n     * 1. Response headers\n     * 2. Media filename\n     * 3. Media mimetype\n     * 4. Src URL\n     */\n    if (resFilenameParts.ext) {\n      // Use media item filename if the same (preserves case)\n      if (miFilenameParts?.ext?.toLowerCase() === resFilenameParts.ext.toLowerCase() &&\n        filenameParts.name === miFilenameParts.name && this.#format.includes('{media.filename}')) {\n\n        filenameParts.ext = miFilenameParts.ext;\n      }\n      else {\n        filenameParts.ext = resFilenameParts.ext;\n      }\n    }\n    else if (miFilenameParts?.ext) {\n      filenameParts.ext = miFilenameParts.ext;\n    }\n    else if (mi.mimeType) {\n      filenameParts.ext = this.getExtensionByContentType(mi.mimeType);\n    }\n    else {\n      filenameParts.ext = URLHelper.getExtensionFromURL(this.srcURL);\n    }\n\n    const tmpMI = {\n      ...mi,\n      filename: filenameParts.name,\n      variant: this.#variant\n    };\n\n    let resolvedFilename = FilenameFormatHelper.getMediaFilename(tmpMI, this.#format);\n    if (filenameParts.ext) {\n      resolvedFilename += filenameParts.ext;\n    }\n\n    return resolvedFilename;\n  }\n}\n"]}

package/dist/utils/Misc.d.ts

@@ -0,0 +1,14 @@
+export type DeepRequired<T> = {
+    [P in keyof T]-?: DeepRequired<T[P]>;
+};
+export type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+export type RecursivePropsTo<T, U> = T extends object ? {
+    [P in keyof T]: RecursivePropsTo<T[P], U>;
+} : T extends undefined | null ? never : U;
+export declare function pickDefined<T>(value1: T | undefined, value2: T): T;
+export declare function pickDefined<T>(value1: T, value2: T | undefined): T;
+export declare function pickDefined(value1: undefined, value2: undefined): undefined;
+export declare function pickDefined<T>(value1?: T, value2?: T): T | undefined;
+//# sourceMappingURL=Misc.d.ts.map

package/dist/utils/Misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Misc.d.ts","sourceRoot":"","sources":["../../src/utils/Misc.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACrC,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,CAAA;AAGD,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAC/B,CAAC,SAAS,MAAM,GAAG;KAAI,CAAC,IAAI,MAAM,CAAC,GAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAAE,GAClE,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,KAAK,GAClC,CAAC,CAAA;AAGH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;AACpE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;AACpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC"}

package/dist/utils/Misc.js

@@ -0,0 +1,4 @@
+export function pickDefined(value1, value2) {
+    return value1 !== undefined ? value1 : value2;
+}
+//# sourceMappingURL=Misc.js.map

package/dist/utils/Misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Misc.js","sourceRoot":"","sources":["../../src/utils/Misc.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,WAAW,CAAI,MAAU,EAAE,MAAU;IACnD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC","sourcesContent":["// https://stackoverflow.com/questions/57835286/deep-recursive-requiredt-on-specific-properties\nexport type DeepRequired<T> = {\n  [P in keyof T]-?: DeepRequired<T[P]>\n}\n\nexport type DeepPartial<T> = {\n  [P in keyof T]?: DeepPartial<T[P]>\n}\n\n// Recursively sets properties of T to U\nexport type RecursivePropsTo<T, U> =\n  T extends object ? { [ P in keyof T ]: RecursivePropsTo<T[P], U> } :\n  T extends undefined | null ? never :\n  U\n\n\nexport function pickDefined<T>(value1: T | undefined, value2: T): T;\nexport function pickDefined<T>(value1: T, value2: T | undefined): T;\nexport function pickDefined(value1: undefined, value2: undefined): undefined;\nexport function pickDefined<T>(value1?: T, value2?: T): T | undefined;\nexport function pickDefined<T>(value1?: T, value2?: T) {\n  return value1 !== undefined ? value1 : value2;\n}\n"]}

package/dist/utils/ObjectHelper.d.ts

@@ -0,0 +1,4 @@
+export default class ObjectHelper {
+    static getProperty(obj: any, prop: string, required?: boolean): any;
+}
+//# sourceMappingURL=ObjectHelper.d.ts.map

package/dist/utils/ObjectHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectHelper.d.ts","sourceRoot":"","sources":["../../src/utils/ObjectHelper.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAY;IAE/B,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAQ;CAoB5D"}

package/dist/utils/ObjectHelper.js

@@ -0,0 +1,30 @@
+export default class ObjectHelper {
+    static getProperty(obj, prop, required = false) {
+        const props = prop.split('.');
+        let v = obj;
+        while (props.length > 0) {
+            const p = props.shift();
+            if (v && typeof v === 'object') {
+                v = v[p];
+                if (v === undefined) {
+                    if (required) {
+                        throw new ObjectPropertyNotFoundError(prop);
+                    }
+                    return v;
+                }
+            }
+            else if (required) {
+                throw new ObjectPropertyNotFoundError(prop);
+            }
+        }
+        return v;
+    }
+}
+class ObjectPropertyNotFoundError extends Error {
+    constructor(prop) {
+        super();
+        this.name = 'ObjectPropertyNotFoundError';
+        this.prop = prop;
+    }
+}
+//# sourceMappingURL=ObjectHelper.js.map

package/dist/utils/ObjectHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectHelper.js","sourceRoot":"","sources":["../../src/utils/ObjectHelper.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAY;IAE/B,MAAM,CAAC,WAAW,CAAC,GAAQ,EAAE,IAAY,EAAE,QAAQ,GAAG,KAAK;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,CAAC;QACZ,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;YACvB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAY,CAAC;YAClC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;gBAC9B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACT,IAAI,CAAC,KAAK,SAAS,EAAE;oBACnB,IAAI,QAAQ,EAAE;wBACZ,MAAM,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;qBAC7C;oBACD,OAAO,CAAC,CAAC;iBACV;aACF;iBACI,IAAI,QAAQ,EAAE;gBACjB,MAAM,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;aAC7C;SACF;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,MAAM,2BAA4B,SAAQ,KAAK;IAI7C,YAAY,IAAY;QACtB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["export default class ObjectHelper {\n\n  static getProperty(obj: any, prop: string, required = false) {\n    const props = prop.split('.');\n    let v = obj;\n    while (props.length > 0) {\n      const p = props.shift() as string;\n      if (v && typeof v === 'object') {\n        v = v[p];\n        if (v === undefined) {\n          if (required) {\n            throw new ObjectPropertyNotFoundError(prop);\n          }\n          return v;\n        }\n      }\n      else if (required) {\n        throw new ObjectPropertyNotFoundError(prop);\n      }\n    }\n    return v;\n  }\n}\n\nclass ObjectPropertyNotFoundError extends Error {\n\n  prop: string;\n\n  constructor(prop: string) {\n    super();\n    this.name = 'ObjectPropertyNotFoundError';\n    this.prop = prop;\n  }\n}\n"]}

package/dist/utils/PackageInfo.d.ts

@@ -0,0 +1,10 @@
+export interface PackageInfo {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    repository: string;
+    banner: string;
+}
+export declare function getPackageInfo(): PackageInfo;
+//# sourceMappingURL=PackageInfo.d.ts.map

package/dist/utils/PackageInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageInfo.d.ts","sourceRoot":"","sources":["../../src/utils/PackageInfo.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,cAAc,gBA4B7B"}