// Custom scripts go here /** * * Use this function to adjust the logic which is used when an issue is displayed as locked. * An issue will always be displayed as locked if it is purchasable: true and purchased: false. * The checks defined here are run if the mandatory first check returns false. * * @param issue * @param purpleService * * @returns {boolean} */ window.isIssueLocked = async function(issue, purpleService) { return false; } /** * @typedef {object} StorefrontHooks as defined in purple.service.ts * @property {Function} [onPurpleServiceInit] called when the purple service is initialized, e.g. ready to serve requests */ /** * @type {StorefrontHooks} */ window.storefrontHooks = {} /** * Add here functions that are accessible under $functions. in any string * where you can use $context. * * It's possible to nest $functions calls or place $context parts (or the whole context) * in the function (examples: `$functions.func1($functions.func2($context.attr1), $context.attr2)`) * * @type { { [identifier: string]: (...args) => string | undefined } } */ window.$functions = { getOptionalSourceIssueId: issue => (issue && issue.sourceIssue) ? issue.sourceIssue.id : '', }; /** * Custom UserTags from user data such as bought subscriptions, issues and products. * Type hints are copied from purple/purpleInterface.js * See calculateStorefrontUserTags on how to use this feature. * * >>> Typings copied from gitlab / purple / purple-javascript-api / purpleInterface.js * >>> copies from merge requests are noted before the block */ // >>> AppSubscription part from MergeReq #42 /** * @typedef {Object} EligibilityInfo * * @property {boolean} [trial] Is user eligible for trial periods. Returns true/false if the server knows that the user can/cannot use a trial or null if not enough data is available to determine eligibility. Trial is only available when returned in store.getPrice-API (PriceInfo). * @property {boolean} introductoryPricing Is user eligible for introductory pricing for this subscription. Introductory pricing is only available when returned in store.getPrice-API (PriceInfo). * @property {boolean} discountOffers Is user eligible for discounted pricing for this subscription. Discounted pricing is only available when returned in store.getPrice-API (PriceInfo). * * * @typedef {Object} CurrentReceiptInfo * * @property {boolean} isTrialPeriod Current subscription period is a trial period. * @property {boolean} isIntroOfferPeriod Current subscription period is a introductory pricing period. * @property {number} expirationDate When purchased, the date of expiration for the current period, in milliseconds since epoch. * @property {number} [autoResumeDate] For paused subscription, the date when the subscription would resume, in milliseconds since epoch. NOTE: A paused subscription will have purchased set to false and a non-null value of autoResumeDate. * @property {boolean} autoRenewing When false the subscription was cancelled by the user and will end after the current subscription period. * * * @typedef {Object} HistoricReceiptInfo * * @property {boolean} hadPurchased User has purchased this subscription in the past. * @property {boolean} hadIntroductoryPricing User has previously used introductory pricing for this subscription. * @property {boolean} hadTrial User has previously used a trial for this subscription. * * * @typedef {Object} AppSubscription * * @property {string} id * @property {string} name * @property {string} description * @property {string} type * @property {"ONE_MONTH" | "TWO_MONTHS" | "THREE_MONTHS" | "SIX_MONTHS" | "ONE_YEAR"} duration * @property {boolean} hidden * @property {string} productId * @property {string} [groupId] iOS only: The group identifier for this subscription. * @property {boolean} purchased * @property {number} [expirationDate] When purchased, the date of expiration for the current period, in milliseconds since epoch. * @property {number} [autoResumeDate] For paused subscription, the date when the subscription would resume, in milliseconds since epoch. NOTE: A paused subscription will have purchased set to false and a non-null value of autoResumeDate. * @property {boolean} autoRenewing When false the subscription was cancelled by the user and will end after the current subscription period. * @property {boolean} [isEligibleForTrial] Is user eligible for trial periods. Returns true/false if the server knows that the user can/cannot use a trial or null if not enough data is available to determine eligibility. Trial is only available when returned in store.getPrice-API (PriceInfo). * @property {boolean} isEligibleForIntroductoryPrice Is user eligible for introductory pricing for this subscription. Introductory pricing is only available when returned in store.getPrice-API (PriceInfo). * @property {EligibilityInfo} eligibilityInfo Information about eligibility for trials, introductory pricing and discount offers. * @property {CurrentReceiptInfo} [currentReceiptInfo] Current or latest receipt for this subscription. If subscription lapsed it will still provide information about the last subscription period. * @property {HistoricReceiptInfo} historicReceiptInfo Historic data for this subscription. Contains information about the complete history of the subscription. * * @property {Map} thumbnails The default thumbnail is always available under the default-key. Additional thumbnails can be available under separate unique keys. * @property {Map} properties * @property {Object} publications * * * @typedef {Object} CatalogIssue * * @property {string} id * @property {string} publicationId * @property {number} version * @property {string} name * @property {string} [description] * @property {string} [alias] null, if not available * @property {string} [externalIssueId] null, if not available * @property {number} publicationDate * @property {boolean} comingSoon * @property {number} index * @property {number} contentLength * @property {number} numberOfPages * @property {boolean} purchasable * @property {boolean} purchased * @property {("APP_STORE_PURCHASE", "APP_STORE_SUBSCRIPTION", "ENTITLEMENT", "SUBSCRIPTION_CODE", "TRIAL")[]} purchasedBy * @property {string} [productId] * @property {Map} properties * @property {Map} thumbnails The default thumbnail is always available under the default-key. Additional thumbnails can be available under separate unique keys. * @property {string[]} categories * @property {string[]} tags * @property {CatalogPreviewIssue} [previewIssue] * @property {CatalogIssueState} state * * >>> from MergeReq #37 * * @typedef {("BACK_ISSUE_COMPLETION")} PublicationProductType * * @typedef {Object} PublicationProduct * * @property {string} id * @property {string} name * @property {string} description * @property {PublicationProductType} type * @property {boolean} hidden * @property {string} productId * @property {boolean} purchased * @property {number} orderIndex * * @property {Map} thumbnails The default thumbnail is always available under the default-key. Additional thumbnails can be available under separate unique keys. * @property {Map} properties * * @property {Object} publications * * @typedef {Object} PublicationProductPublication * @property {string} publicationId * @property {UnlockableIssue[]} unlockableIssues all unpurchased issues older than current pub issue (currentIssueId) * * This function gets called to calculate the user tags. * Tags, which are set to true can be accessed through $context.userTags. IS_SET * !!! Must always return all possible tags, else the tracking service can't remove unused tags. !!! * @param {AppSubscription[]} subs purchased subscriptions * @param {CatalogIssue[]} issues all purchased Issues * @param {PublicationProduct[]} pubProds all purchased publication products (TODO: check typedef after merge of #37) */ /* window.calculateStorefrontUserTags = (subs, issues, pubProds) => { return {} } */

Latest Issues

null

null

null

Latest Articles