@uptime.app/contracts 1.0.13-rc.0 → 1.0.13

package/src/draft-hack/draft-hack.ts

@@ -1,184 +1,184 @@
-import { SupportedLocale } from '../localisation/supported-locales';
-
-export interface DraftHack extends DraftHackContent {
-    /** The unique id of the draft hack. */
-    id: string;
-    /** The locale (language and region) of the draft hack e.g. fr-FR. Mandatory property since 12/01/2023. */
-    locale: SupportedLocale;
-    /** @deprecated Temporarily added in 12/01/2023. Should not be used under any circumstance as only a handful of drafts will contain this property */
-    baseLocaleDraftHackId?: string;
-    /** The id of the hack. Mandatory property since Dec 2022. */
-    hackId: string;
-    /** The id of the hack in its original locale. Mandatory property since 01/02/2023. */
-    baseLocaleHackId: string;
-
-    v: number;
-    createdAt: string;
-    updatedAt: string;
-    publishedAt?: string;
-    publishedVersion?: number;
-    owner?: string;
-    /** workflowStatus was added in May 2022 as we move toward UGC. Older drafts have not been backfilled */
-    workflowStatus?: DraftHackWorkflowStatus;
-    /** added in Nov 2022. Set to true whenever content changes are made to the draft */
-    hasUnpublishedChanges?: boolean;
-    /** added in March 2023. Must be set whenever content changes are made to the draft */
-    contentUpdatedAt?: string;
-    /** added in late April 2023. Only set on translations. Set to the value of contentUpdatedAt of the base locale draft that was translated. Can be used to determine if the translated draft is out of sync with the original draft */
-    baseLocaleContentUpdatedAt?: string;
-}
-
-export interface DraftHackContent {
-    /**
-     * @maxLength 150
-     */
-    title: string;
-    /**
-     * @maxLength 50
-     */
-    sourceId?: string;
-    /**
-     * @maxLength 50
-     */
-    themeId?: string;
-    segments: DraftHackSegments;
-    /**
-     * @maxLength 1000
-     */
-    coverUrl?: string;
-    notifications?: DraftHackNotifications;
-    affiliate?: DraftAffiliate;
-    /**
-     * @maxItems 50
-     */
-    topics?: DraftTopic[];
-    /**
-     * @maxItems 10
-     */
-    contributors?: DraftContributor[];
-    sourceData?: DraftSourceData;
-    /** For creators only. We will tackle this validation once profiles are introduce*/
-    externalLink?: DraftHackExternalLink;
-    /** For recording purpose for now, we will use this value further in the future */
-    contentRating?: DraftHackRating;
-    /**
-     * @maxItems 50
-     * @items.maxLength 150
-     */
-    tags?: string[];
-    type?: DraftHackType;
-    isCopyrightFree?: boolean;
-}
-
-export interface DraftHackNotifications {
-    /**
-     * @maxLength 1000
-     */
-    aiGeneratedText?: string;
-    /**
-     * @maxLength 1000
-     */
-    humanCuratedText?: string;
-}
-
-export interface DraftHackSegments {
-    favouriteQuote?: DraftHackSegment;
-    inANutshell?: DraftHackSegment;
-    introduction?: DraftHackSegment;
-    /**
-     * @maxItems 10
-     */
-    insights?: DraftHackInsightSegment[];
-    conclusion?: DraftHackSegment;
-}
-
-export interface DraftHackCard {
-    /**
-     * @maxLength 2000
-     */
-    markdown: string;
-}
-
-export interface DraftHackSegment {
-    /**
-     * @maxItems 50
-     * @items.maxLength 150
-     */
-    keywords: string[];
-    paragraphCards: DraftHackCard[][];
-    /**
-     * @maxLength 1000
-     */
-    textSummary?: string;
-}
-
-export interface DraftHackInsightSegment extends DraftHackSegment {
-    /**
-     * @maxLength 150
-     */
-    title?: string;
-    /**
-     * @maxItems 50
-     */
-    actions: DraftHackAction[];
-}
-
-export interface DraftHackAction {
-    /**
-     * @maxLength 150
-     */
-    title: string;
-    /**
-     * @maxLength 1000
-     */
-    markdown: string
-}
-
-export interface DraftContributor {
-    /**
-     * @maxLength 150
-     */
-    name: string;
-}
-
-export interface DraftTopic {
-    /**
-     * @maxLength 150
-     */
-    name: string;
-}
-
-export interface DraftAffiliate {
-    /**
-     * @maxLength 1000
-     */
-    url?: string;
-    /**
-     * @maxLength 150
-     */
-    name?: string;
-}
-
-export interface DraftSourceData {
-    /**
-     * @maxLength 150
-     */
-    episodeTitle?: string;
-    /**
-     * @maxLength 50
-     */
-    releaseDate?: string;
-}
-
-export interface DraftHackExternalLink {
-    /**
-     * @maxLength 1000
-     */
-    url: string;
-    type: 'Website' | 'Book' | 'Course' | 'Podcast' | 'Video' | 'Other';
-}
-
-// this status is currently used to present the draft in different columns in the airtable used by the content team
-export type DraftHackWorkflowStatus = 'publishing' | 'published';
-export type DraftHackType = 'book' | 'course' | 'documentary' | 'podcast' | 'original';
-export type DraftHackRating = 'mature' | 'appropriate';
+import { SupportedLocale } from '../localisation/supported-locales';
+
+export interface DraftHack extends DraftHackContent {
+    /** The unique id of the draft hack. */
+    id: string;
+    /** The locale (language and region) of the draft hack e.g. fr-FR. Mandatory property since 12/01/2023. */
+    locale: SupportedLocale;
+    /** @deprecated Temporarily added in 12/01/2023. Should not be used under any circumstance as only a handful of drafts will contain this property */
+    baseLocaleDraftHackId?: string;
+    /** The id of the hack. Mandatory property since Dec 2022. */
+    hackId: string;
+    /** The id of the hack in its original locale. Mandatory property since 01/02/2023. */
+    baseLocaleHackId: string;
+
+    v: number;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string;
+    publishedVersion?: number;
+    owner?: string;
+    /** workflowStatus was added in May 2022 as we move toward UGC. Older drafts have not been backfilled */
+    workflowStatus?: DraftHackWorkflowStatus;
+    /** added in Nov 2022. Set to true whenever content changes are made to the draft */
+    hasUnpublishedChanges?: boolean;
+    /** added in March 2023. Must be set whenever content changes are made to the draft */
+    contentUpdatedAt?: string;
+    /** added in late April 2023. Only set on translations. Set to the value of contentUpdatedAt of the base locale draft that was translated. Can be used to determine if the translated draft is out of sync with the original draft */
+    baseLocaleContentUpdatedAt?: string;
+}
+
+export interface DraftHackContent {
+    /**
+     * @maxLength 150
+     */
+    title: string;
+    /**
+     * @maxLength 50
+     */
+    sourceId?: string;
+    /**
+     * @maxLength 50
+     */
+    themeId?: string;
+    segments: DraftHackSegments;
+    /**
+     * @maxLength 1000
+     */
+    coverUrl?: string;
+    notifications?: DraftHackNotifications;
+    affiliate?: DraftAffiliate;
+    /**
+     * @maxItems 50
+     */
+    topics?: DraftTopic[];
+    /**
+     * @maxItems 10
+     */
+    contributors?: DraftContributor[];
+    sourceData?: DraftSourceData;
+    /** For creators only. We will tackle this validation once profiles are introduce*/
+    externalLink?: DraftHackExternalLink;
+    /** For recording purpose for now, we will use this value further in the future */
+    contentRating?: DraftHackRating;
+    /**
+     * @maxItems 50
+     * @items.maxLength 150
+     */
+    tags?: string[];
+    type?: DraftHackType;
+    isCopyrightFree?: boolean;
+}
+
+export interface DraftHackNotifications {
+    /**
+     * @maxLength 1000
+     */
+    aiGeneratedText?: string;
+    /**
+     * @maxLength 1000
+     */
+    humanCuratedText?: string;
+}
+
+export interface DraftHackSegments {
+    favouriteQuote?: DraftHackSegment;
+    inANutshell?: DraftHackSegment;
+    introduction?: DraftHackSegment;
+    /**
+     * @maxItems 10
+     */
+    insights?: DraftHackInsightSegment[];
+    conclusion?: DraftHackSegment;
+}
+
+export interface DraftHackCard {
+    /**
+     * @maxLength 2000
+     */
+    markdown: string;
+}
+
+export interface DraftHackSegment {
+    /**
+     * @maxItems 50
+     * @items.maxLength 150
+     */
+    keywords: string[];
+    paragraphCards: DraftHackCard[][];
+    /**
+     * @maxLength 1000
+     */
+    textSummary?: string;
+}
+
+export interface DraftHackInsightSegment extends DraftHackSegment {
+    /**
+     * @maxLength 150
+     */
+    title?: string;
+    /**
+     * @maxItems 50
+     */
+    actions: DraftHackAction[];
+}
+
+export interface DraftHackAction {
+    /**
+     * @maxLength 150
+     */
+    title: string;
+    /**
+     * @maxLength 1000
+     */
+    markdown: string
+}
+
+export interface DraftContributor {
+    /**
+     * @maxLength 150
+     */
+    name: string;
+}
+
+export interface DraftTopic {
+    /**
+     * @maxLength 150
+     */
+    name: string;
+}
+
+export interface DraftAffiliate {
+    /**
+     * @maxLength 1000
+     */
+    url?: string;
+    /**
+     * @maxLength 150
+     */
+    name?: string;
+}
+
+export interface DraftSourceData {
+    /**
+     * @maxLength 150
+     */
+    episodeTitle?: string;
+    /**
+     * @maxLength 50
+     */
+    releaseDate?: string;
+}
+
+export interface DraftHackExternalLink {
+    /**
+     * @maxLength 1000
+     */
+    url: string;
+    type: 'Website' | 'Book' | 'Course' | 'Podcast' | 'Video' | 'Other';
+}
+
+// this status is currently used to present the draft in different columns in the airtable used by the content team
+export type DraftHackWorkflowStatus = 'publishing' | 'published';
+export type DraftHackType = 'book' | 'course' | 'documentary' | 'podcast' | 'original';
+export type DraftHackRating = 'mature' | 'appropriate';

package/src/enriched-hack/enriched-hack-events.ts

@@ -1,21 +1,21 @@
-import { EnrichedHack } from './enriched-hack';
-
-export interface EnrichedHackCreatedEvent {
-    id: string;
-    type: 'EnrichedHackCreated';
-    payload: EnrichedHack;
-}
-
-export interface EnrichedHackUpdatedEvent {
-    id: string;
-    type: 'EnrichedHackUpdated';
-    payload: EnrichedHack;
-}
-
-export interface EnrichedHackDeletedEvent {
-    id: string;
-    type: 'EnrichedHackDeleted';
-    payload: EnrichedHack;
-}
-
-export type EnrichedHackChangedEvent = EnrichedHackCreatedEvent | EnrichedHackUpdatedEvent | EnrichedHackDeletedEvent;
+import { EnrichedHack } from './enriched-hack';
+
+export interface EnrichedHackCreatedEvent {
+    id: string;
+    type: 'EnrichedHackCreated';
+    payload: EnrichedHack;
+}
+
+export interface EnrichedHackUpdatedEvent {
+    id: string;
+    type: 'EnrichedHackUpdated';
+    payload: EnrichedHack;
+}
+
+export interface EnrichedHackDeletedEvent {
+    id: string;
+    type: 'EnrichedHackDeleted';
+    payload: EnrichedHack;
+}
+
+export type EnrichedHackChangedEvent = EnrichedHackCreatedEvent | EnrichedHackUpdatedEvent | EnrichedHackDeletedEvent;

package/src/enriched-hack/enriched-hack.ts

@@ -1,101 +1,101 @@
-import { HackAffiliate, HackContributor, HackExternalLink, HackSourceData, HackTopic, HackType } from '../hack/hack';
-import { KnowledgeSource } from '../knowledge-source/knowledge-source';
-import { Profile } from '../profile/profile';
-import { Theme } from '../theme/theme';
-import { HackWithVoice } from '../hack/hack-with-voice';
-import { ExtractedSubject } from '../hack/extracted-subject';
-import { SegmentType, SegmentAction, SegmentSpeech, SegmentSection, SegmentTextCard } from '../segment/segment';
-
-export interface EnrichedHack {
-    /** The hack id */
-    id: string;
-    /** The hack language e.g. 'fr' if it is French */
-    language: string;
-    /** The locale (language and region) of the hack e.g. fr-FR. Use @uptime.app/localisation-contracts */
-    locale: string;
-    /** The id of the hack in its original locale. */
-    baseLocaleHackId: string;
-    v: number;
-    hackVersion: number;
-    createdAt: string;
-    updatedAt: string;
-
-    /** introduced Oct 2023 **/
-    draftHackId: string;
-    draftHackVersion: number;
-
-    //@todo: Deprecate
-    source?: KnowledgeSource;
-    owner: string;
-    acl: string[];
-    theme: Theme;
-    title: string;
-    isHidden?: boolean;
-    editorialTags?: string[];
-    coverUrl?: string;
-    notifications?: EnrichedHackNotifications;
-    /* currently contains the inANutshell segment markdown */
-    description: string;
-    // ...
-
-    segments: HackWithVoice['segments']; // Use the 'HackWithVoice' type
-    affiliate?: HackAffiliate;
-    topics: HackTopic[];
-    contributors?: HackContributor[];
-    type: HackType;
-    sourceData?: HackSourceData;
-    externalLink?: HackExternalLink;
-    profile: EnrichHackProfile;
-
-    /** added April 2024 */
-    // TODO make it mandatory after a republish
-    subjects?: EnrichedHackSubjects;
-
-    // distribution
-    includeInEmailNotifications: boolean;
-    includeInPushNotifications: boolean;
-    includeInRecommendations: boolean;
-    includeInSearchResults: boolean;
-    includeInTrending: boolean;
-    includeInHackOfTheDay: boolean;
-    includeInWebsite: boolean;
-
-    /**
-     * Time saved in minutes by consuming the hack rather than the underlying knowledge source.
-     * calculated using the knowledge source page count / duration
-     * */
-    timeSaved?: number;
-    /**
-     * An estimation of the time saved in minutes when no reliable information is available on the knowledge source.
-     */
-    estimatedTimeSaved?: number;
-}
-
-export interface EnrichedHackNotifications {
-    aiGeneratedText?: string;
-    humanCuratedText?: string;
-}
-
-export interface EnrichedHackSubjects {
-    aiGenerated: ExtractedSubject[];
-    humanCurated?: ExtractedSubject[];
-}
-
-export interface EnrichedHackSegment {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    title: string;
-    type: SegmentType;
-    keywords: string[];
-    actions: SegmentAction[];
-    speech: SegmentSpeech[];
-    sections: SegmentSection[];
-    storyMode?: {
-        cards: SegmentTextCard[];
-        speech: SegmentSpeech[];
-    },
-    textSummary?: string;
-}
-
-export type EnrichHackProfile = Profile | { deleted: boolean, uptimeOwned: boolean, avatarUrl: string };
+import { HackAffiliate, HackContributor, HackExternalLink, HackSourceData, HackTopic, HackType } from '../hack/hack';
+import { KnowledgeSource } from '../knowledge-source/knowledge-source';
+import { Profile } from '../profile/profile';
+import { Theme } from '../theme/theme';
+import { HackWithVoice } from '../hack/hack-with-voice';
+import { ExtractedSubject } from '../hack/extracted-subject';
+import { SegmentType, SegmentAction, SegmentSpeech, SegmentSection, SegmentTextCard } from '../segment/segment';
+
+export interface EnrichedHack {
+    /** The hack id */
+    id: string;
+    /** The hack language e.g. 'fr' if it is French */
+    language: string;
+    /** The locale (language and region) of the hack e.g. fr-FR. Use @uptime.app/localisation-contracts */
+    locale: string;
+    /** The id of the hack in its original locale. */
+    baseLocaleHackId: string;
+    v: number;
+    hackVersion: number;
+    createdAt: string;
+    updatedAt: string;
+
+    /** introduced Oct 2023 **/
+    draftHackId: string;
+    draftHackVersion: number;
+
+    //@todo: Deprecate
+    source?: KnowledgeSource;
+    owner: string;
+    acl: string[];
+    theme: Theme;
+    title: string;
+    isHidden?: boolean;
+    editorialTags?: string[];
+    coverUrl?: string;
+    notifications?: EnrichedHackNotifications;
+    /* currently contains the inANutshell segment markdown */
+    description: string;
+    // ...
+
+    segments: HackWithVoice['segments']; // Use the 'HackWithVoice' type
+    affiliate?: HackAffiliate;
+    topics: HackTopic[];
+    contributors?: HackContributor[];
+    type: HackType;
+    sourceData?: HackSourceData;
+    externalLink?: HackExternalLink;
+    profile: EnrichHackProfile;
+
+    /** added April 2024 */
+    // TODO make it mandatory after a republish
+    subjects?: EnrichedHackSubjects;
+
+    // distribution
+    includeInEmailNotifications: boolean;
+    includeInPushNotifications: boolean;
+    includeInRecommendations: boolean;
+    includeInSearchResults: boolean;
+    includeInTrending: boolean;
+    includeInHackOfTheDay: boolean;
+    includeInWebsite: boolean;
+
+    /**
+     * Time saved in minutes by consuming the hack rather than the underlying knowledge source.
+     * calculated using the knowledge source page count / duration
+     * */
+    timeSaved?: number;
+    /**
+     * An estimation of the time saved in minutes when no reliable information is available on the knowledge source.
+     */
+    estimatedTimeSaved?: number;
+}
+
+export interface EnrichedHackNotifications {
+    aiGeneratedText?: string;
+    humanCuratedText?: string;
+}
+
+export interface EnrichedHackSubjects {
+    aiGenerated: ExtractedSubject[];
+    humanCurated?: ExtractedSubject[];
+}
+
+export interface EnrichedHackSegment {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    title: string;
+    type: SegmentType;
+    keywords: string[];
+    actions: SegmentAction[];
+    speech: SegmentSpeech[];
+    sections: SegmentSection[];
+    storyMode?: {
+        cards: SegmentTextCard[];
+        speech: SegmentSpeech[];
+    },
+    textSummary?: string;
+}
+
+export type EnrichHackProfile = Profile | { deleted: boolean, uptimeOwned: boolean, avatarUrl: string };

package/src/hack/extracted-subject.ts

@@ -1,5 +1,5 @@
-
-// defined in @uptime.app/subject-extraction-service but trying to avoid too many dependencies
-export interface ExtractedSubject {
-    name: string;
+
+// defined in @uptime.app/subject-extraction-service but trying to avoid too many dependencies
+export interface ExtractedSubject {
+    name: string;
 }

package/src/hack/hack-events.ts

@@ -1,21 +1,21 @@
-import { Hack } from './hack';
-
-export interface HackCreatedEvent {
-    id: string;
-    type: 'HackCreated';
-    payload: Hack;
-}
-
-export interface HackUpdatedEvent {
-    id: string;
-    type: 'HackUpdated';
-    payload: Hack;
-}
-
-export interface HackDeletedEvent {
-    id: string;
-    type: 'HackDeleted';
-    payload: Hack;
-}
-
-export type HackChangedEvent = HackCreatedEvent | HackUpdatedEvent | HackDeletedEvent;
+import { Hack } from './hack';
+
+export interface HackCreatedEvent {
+    id: string;
+    type: 'HackCreated';
+    payload: Hack;
+}
+
+export interface HackUpdatedEvent {
+    id: string;
+    type: 'HackUpdated';
+    payload: Hack;
+}
+
+export interface HackDeletedEvent {
+    id: string;
+    type: 'HackDeleted';
+    payload: Hack;
+}
+
+export type HackChangedEvent = HackCreatedEvent | HackUpdatedEvent | HackDeletedEvent;