@studyportals/domain-client 3.6.0-0 → 3.6.0-2

package/src/models/common/i-internal-link.ts

@@ -0,0 +1,32 @@
+export interface IInternalLink {
+
+	/**
+	 * Get an optional text describing the link (typically <a>-tags contents).
+	 *
+	 * @return string
+	 * @throws PropertyNotAvailableException
+	 */
+	getDescription(): string;
+
+	canShowDescription(): boolean;
+
+	/**
+	 * Returns on which portal a this link should link towards.
+	 *
+	 * @return string
+	 */
+	getPortalType(): string;
+
+	/**
+	 * Get the url to refer to.
+	 *
+	 * Note that the url provided is always a relative URL. A base URL is needed
+	 * to make it a full valid path.
+	 * The only exception is when an external link is provided (meaning, outside
+	 * of StudyPortals-maintained domains). In this case a full url will be
+	 * provided.
+	 *
+	 * @return string
+	 */
+	getUrl(): string;
+}

package/src/models/common/i-logo.ts

@@ -0,0 +1,16 @@
+export interface ILogo {
+
+	/**
+	 * Get the file ID of the logo.
+	 *
+	 * @return number
+	 */
+	getId(): number;
+
+	/**
+	 * Get the imgix URL of the logo.
+	 *
+	 * @return string
+	 */
+	getSource(): string;
+}

package/src/models/common/i-tuition-fee.ts

@@ -0,0 +1,57 @@
+export interface ITuitionFee {
+
+	/**
+	 * Get the tuition amount per unit in the provided currency.
+	 *
+	 * Note: all transformable units will be converted to yearly amounts. This
+	 * includes per semester and full programme tuition fees.
+	 *
+	 * @return number
+	 */
+	getAmount(): number;
+
+	/**
+	 * Get the applicable currency.
+	 *
+	 * @return string
+	 */
+	getCurrency(): string;
+
+	/**
+	 * Get the original tuition amount before any transformation step.
+	 *
+	 * @return number
+	 */
+	getOriginalAmount(): number;
+
+	/**
+	 * Get the original tuition unit before any transformation step.
+	 *
+	 * @return string
+	 */
+	getOriginalUnit(): string;
+
+	/**
+	 * Get targeted audience (national, international, eea, etc).
+	 *
+	 * @return string
+	 */
+	getTarget(): string;
+
+	/**
+	 * Get the unit the tuition fee applies for.
+	 *
+	 * Note: all transformable units will be converted to 'year'. This means
+	 * this value will be either 'year', 'module' or 'credit'.
+	 *
+	 * @return string
+	 */
+	getUnit(): string;
+
+	/**
+	 * True if the study is free for this target audience.
+	 *
+	 * @return boolean
+	 */
+	isFree(): boolean;
+}

package/src/models/dotdigital-organisation/dotdigital-organisation-client.ts

@@ -0,0 +1,16 @@
+import { IDotDigitalOrganisation } from "../../..";
+import { ModelClient } from "../../model-client";
+
+export class DotdigitalOrganisationClient extends ModelClient<IDotDigitalOrganisation> {
+	protected getModelName(): string {
+		return 'dotdigital-organisation';
+	}
+
+	protected getVersion(): string {
+		return 'v1';
+	}
+
+	public isPublic(): boolean {
+		return false;
+	}
+}

package/src/models/dotdigital-organisation/i-dot-digital-organisation.ts

@@ -0,0 +1,59 @@
+import { ICity, ICountry, IReview } from "../../..";
+
+export interface IDotDigitalOrganisation {
+
+	getAboutCareer(): string;
+
+	getAboutEducation(): string;
+
+	getAboutHistory(): string;
+
+	getAboutResearch(): string;
+
+	getAcademicStaff(): number;
+
+	getAmountOfProgrammes(): number;
+
+	getCity(): ICity;
+
+	getCountry(): ICountry;
+
+	getCoverUrl(): string;
+
+	getFemaleStudents(): number;
+
+	getId(): number;
+
+	getAverageStudentRating(): number;
+
+	getLogoUrl(): string;
+
+	getName(): string;
+
+	getOrganisationUrl(): string;
+
+	getReasons(): string[];
+
+	/**
+	 * @return IReview[]
+	 */
+	getReviews(): IReview[];
+
+	getServicesHousing(): string;
+
+	getServicesICT(): string;
+
+	getServicesLibrary(): string;
+
+	getServicesMedical(): string;
+
+	getServicesStudent(): string;
+
+	getStudentLifeCampus(): string;
+
+	getStudentLifeSport(): string;
+
+	getStudents(): number;
+
+	getStudentsInternational(): number;
+}

package/src/models/dotdigital-organisation/i-review.ts

@@ -0,0 +1,12 @@
+export interface IReview {
+
+	getEndDate(): Date;
+
+	getRating(): number;
+
+	getReview(): string;
+
+	getStartDate(): Date;
+
+	getTitle(): string;
+}

package/src/models/dotdigital-programme/dotdigital-programme-client.ts

@@ -0,0 +1,16 @@
+import { IDotDigitalProgramme } from "../../..";
+import { ModelClient } from "../../model-client";
+
+export class DotdigitalProgrammeClient extends ModelClient<IDotDigitalProgramme> {
+	protected getModelName(): string {
+		return 'dotdigital-programme';
+	}
+
+	protected getVersion(): string {
+		return 'v1';
+	}
+
+	public isPublic(): boolean {
+		return false;
+	}
+}

package/src/models/dotdigital-programme/i-dot-digital-programme.ts

@@ -0,0 +1,108 @@
+import { ICountry, IEnglishRequirements, IInternalLink, ILogo, ITuitionFee } from "../../..";
+
+export interface IDotDigitalProgramme {
+
+	/**
+	 * Campaign type of the campaign the programme is attached to
+	 *
+	 * @return number
+	 */
+	getCampaignType(): number;
+
+	canShowCampaignType(): boolean;
+
+	/**
+	 * Get country the programme is teached in
+	 *
+	 * @return ICountry
+	 */
+	getCountry(): ICountry;
+
+	canShowCountry(): boolean;
+
+	/**
+	 * Education level
+	 *
+	 * @return string
+	 */
+	getEducationalLevel(): string;
+
+	/**
+	 * English level requirements.
+	 *
+	 * @return IEnglishRequirements
+	 */
+	getEnglishRequirements(): IEnglishRequirements;
+
+	/**
+	 * Id of the programme.
+	 *
+	 * @return number
+	 */
+	getId(): number;
+
+	/**
+	 * The last time the programme has been updated and verified
+	 *
+	 * @return Date
+	 */
+	getLastUpdated(): Date;
+
+	/**
+	 * University logo url
+	 *
+	 * @return ILogo
+	 */
+	getLogo(): ILogo;
+
+	canShowLogo(): boolean;
+
+	/**
+	 * Get a link to the programme page.
+	 *
+	 * The link contains the page path as url and the programme name as the
+	 * link description.
+	 *
+	 * @return IInternalLink
+	 */
+	getProgrammeLink(): IInternalLink;
+
+	/**
+	 * The universities review rating
+	 *
+	 * @return number
+	 */
+	getReviewRating(): number;
+
+	canShowReviewRating(): boolean;
+
+	/**
+	 * Title of the programme.
+	 *
+	 * @return string
+	 */
+	getTitle(): string;
+
+	/**
+	 * The programmes tuition fees
+	 *
+	 * @return ITuitionFee[]
+	 */
+	getTuitionFees(): ITuitionFee[];
+
+	canShowTuitionFees(): boolean;
+
+	/**
+	 * University title
+	 *
+	 * @return string
+	 */
+	getUniversityTitle(): string;
+
+	/**
+	 * Is programme public
+	 *
+	 * @return boolean
+	 */
+	isPublic(): boolean;
+}

package/src/models/programme-card/i-click-tracking-data.ts

@@ -0,0 +1,8 @@
+export interface IClickTrackingData {
+
+	getAction(): string;
+
+	getCategory(): string;
+
+	getLabel(): string;
+}

package/src/models/programme-card/i-cover.ts

@@ -0,0 +1,16 @@
+export interface ICover {
+
+	/**
+	 * Get the file ID of the cover (as known in the system)
+	 *
+	 * @return number
+	 */
+	getId(): number;
+
+	/**
+	 * Get the source URL for the cover.
+	 *
+	 * @return string
+	 */
+	getSource(): string;
+}

package/src/models/programme-card/i-deadline.ts

@@ -0,0 +1,23 @@
+export interface IDeadline {
+
+	/**
+	 * Get the date this deadline expires on.
+	 *
+	 * @return Date
+	 */
+	getDate(): Date;
+
+	/**
+	 * Get the deadline type (e.g. general, national, eea, etc).
+	 *
+	 * @return string
+	 */
+	getType(): string;
+
+	/**
+	 * True if the deadline has passed (e.g. you can't apply anymore).
+	 *
+	 * @return boolean
+	 */
+	isPassed(): boolean;
+}

package/src/models/programme-card/i-duration.ts

@@ -0,0 +1,46 @@
+export interface IDuration {
+
+	/**
+	 * Get the amount of periods the programme takes to complete.
+	 *
+	 * Note: Durations of more than 70 days (with period === 'days') are
+	 * automatically calculated back to an amount of months.
+	 *
+	 * @return number
+	 */
+	getAmount(): number;
+
+	/**
+	 * Get an optional textual description of the duration.
+	 *
+	 * @return string
+	 * @throws PropertyNotAvailableException
+	 */
+	getDescription(): string;
+
+	canShowDescription(): boolean;
+
+	/**
+	 * Get the original duration amount before any calculations.
+	 *
+	 * @return number
+	 */
+	getOriginalDuration(): number;
+
+	/**
+	 * Get the original duration period before any calculations.
+	 *
+	 * @return string
+	 */
+	getOriginalPeriod(): string;
+
+	/**
+	 * Get the period this duration is provided in (days or months).
+	 *
+	 * Note: Durations of more than 70 days (with period === 'days') are
+	 * automatically calculated back to an amount of months.
+	 *
+	 * @return string
+	 */
+	getPeriod(): string;
+}

package/src/models/programme-card/i-link.ts

@@ -0,0 +1,25 @@
+export interface ILink {
+
+	/**
+	 * Get an optional text describing the link (typically <a>-tags contents).
+	 *
+	 * @return string
+	 * @throws PropertyNotAvailableException
+	 */
+	getDescription(): string;
+
+	canShowDescription(): boolean;
+
+	/**
+	 * Get the url to refer to.
+	 *
+	 * Note that the url provided is always a relative URL. A base URL is needed
+	 * to make it a full valid path.
+	 * The only exception is when an external link is provided (meaning, outside
+	 * of StudyPortals-maintained domains). In this case a full url will be
+	 * provided.
+	 *
+	 * @return string
+	 */
+	getUrl(): string;
+}

package/src/models/programme-card/i-location.ts

@@ -0,0 +1,12 @@
+import { IOptionalLink } from "../../..";
+
+export interface ILocation {
+
+	getArea(): IOptionalLink;
+
+	canShowArea(): boolean;
+
+	getCity(): IOptionalLink;
+
+	getCountry(): IOptionalLink;
+}

package/src/models/programme-card/i-optional-link.ts

@@ -0,0 +1,27 @@
+export interface IOptionalLink {
+
+	/**
+	 * Get an optional text describing the link (typically <a>-tags contents).
+	 *
+	 * @return string
+	 * @throws PropertyNotAvailableException
+	 */
+	getDescription(): string;
+
+	canShowDescription(): boolean;
+
+	/**
+	 * Get the url to refer to.
+	 *
+	 * Note that the url provided is always a relative URL. A base URL is needed
+	 * to make it a full valid path.
+	 * The only exception is when an external link is provided (meaning, outside
+	 * of StudyPortals-maintained domains). In this case a full url will be
+	 * provided.
+	 *
+	 * @return string
+	 */
+	getUrl(): string;
+
+	canShowUrl(): boolean;
+}

package/src/models/programme-card/i-programme-card.ts

@@ -0,0 +1,152 @@
+import { ICover, IDuration, IInternalLink, ILink, ILocation, ILogo, ITiming, ITrackedLink, ITracking, ITuitionFee } from "../../..";
+
+export interface IProgrammeCard {
+
+	/**
+	 * Get the Cover of the programme if available.
+	 *
+	 * @return ICover
+	 */
+	getCover(): ICover;
+
+	canShowCover(): boolean;
+
+	/**
+	 * Get the degree name of the programme.
+	 *
+	 * @return string
+	 */
+	getDegree(): string;
+
+	/**
+	 * Get duration of the programme.
+	 *
+	 * @return IDuration
+	 */
+	getDuration(): IDuration;
+
+	canShowDuration(): boolean;
+
+	/**
+	 * Get the programme id.
+	 *
+	 * @return number
+	 */
+	getId(): number;
+
+	/**
+	 * Get the programme level.
+	 *
+	 * @return string
+	 */
+	getLevel(): string;
+
+	/**
+	 * Get the locaiton the programme is located in.
+	 *
+	 * Uses the country based on the programmes venues.
+	 *
+	 * @return ILocation
+	 */
+	getLocation(): ILocation;
+
+	canShowLocation(): boolean;
+
+	/**
+	 * Get the Logo of the programme if available.
+	 *
+	 * @return ILogo
+	 */
+	getLogo(): ILogo;
+
+	canShowLogo(): boolean;
+
+	/**
+	 * Returns premium type
+	 * Such as Super premium, premium, light, etc..
+	 *
+	 * @return string
+	 */
+	getPremiumType(): string;
+
+	/**
+	 * Get a link to the programme page.
+	 *
+	 * The link contains the page path as url and the programme name as the
+	 * link description.
+	 *
+	 * @return IInternalLink
+	 */
+	getProgrammeLink(): IInternalLink;
+
+	/**
+	 * Get programme's referral link
+	 *
+	 * @return ITrackedLink
+	 */
+	getReferralLink(): ITrackedLink;
+
+	canShowReferralLink(): boolean;
+
+	/**
+	 * Get the summary of the programme.
+	 *
+	 * @return string
+	 */
+	getSummary(): string;
+
+	/**
+	 * Get all start dates
+	 *
+	 * @return ITiming[]
+	 */
+	getTimings(): ITiming[];
+
+	canShowTimings(): boolean;
+
+	/**
+	 * Get the programme title.
+	 *
+	 * @return string
+	 */
+	getTitle(): string;
+
+	/**
+	 * Get the tracking information needed to track the impression on the card.
+	 *
+	 * @return ITracking
+	 */
+	getTracking(): ITracking;
+
+	/**
+	 * Get all tuition fees of the programme.
+	 * @return ITuitionFee[]
+	 */
+	getTuitionFees(): ITuitionFee[];
+
+	canShowTuitionFees(): boolean;
+
+	/**
+	 * Get the programme's university id
+	 *
+	 * @return number
+	 */
+	getUniversityId(): number;
+
+	/**
+	 * Get a link to the programme's university page.
+	 *
+	 * The link contains the page path as url and the university name as the
+	 * link description.
+	 *
+	 * @return ILink
+	 */
+	getUniversityLink(): ILink;
+
+	/**
+	 * Public status of the programme.
+	 *
+	 * @return boolean
+	 */
+	isPublic(): boolean;
+}

package/src/models/programme-card/i-start-date.ts

@@ -0,0 +1,39 @@
+import { IDeadline } from "../../..";
+
+export interface IStartDate {
+
+	/**
+	 * Get the date the programme starts on.
+	 *
+	 * @return Date
+	 */
+	getDate(): Date;
+
+	/**
+	 * Get a list of deadlines that apply to this start date.
+	 *
+	 * Note: In case of extendable start dates, all information in the
+	 * Deadline objects has already been extended to the first available start
+	 * date.
+	 *
+	 * @return IDeadline[]
+	 * @throws PropertyNotAvailableException
+	 */
+	getDeadlines(): IDeadline[];
+
+	canShowDeadlines(): boolean;
+
+	/**
+	 * True if you can apply at any time for this programme (rolling admission)
+	 *
+	 * @return boolean
+	 */
+	isApplyingAnytime(): boolean;
+
+	/**
+	 * True if the start date has passed (you can't start at this date anymore).
+	 *
+	 * @return boolean
+	 */
+	isPassed(): boolean;
+}