@uptime.app/contracts 3.0.52 → 3.0.53-rc.0

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

@@ -1,52 +1,52 @@
-import { GeneratedDraftHackContent } from './draft-hack-generation';
-
-export interface DraftHackGenerated {
-    id: string;
-    type: 'DraftHackGenerated';
-    payload: {
-        // the draft hack id
-        id: string;
-        // the version
-        v: number;
-        reference: string;
-        draftHackId: string;
-        draftHackContent: GeneratedDraftHackContent;
-
-        hackGenerationTriggerId: string;
-
-        // introduced 11/09/2024
-        researchNotes?: {
-            insight1: string;
-            insight2: string;
-            insight3: string;
-        };
-    }
-}
-
-export interface DraftHackGenerationFailed {
-    id: string;
-    type: 'DraftHackGenerationFailed';
-    payload: {
-        reference: string;
-        hackGenerationTriggerId: string;
-        errorMessage: string;
-    }
-}
-
-export interface GeneratedDraftHackSavedToGoogleDrive {
-    id: string;
-    type: 'GeneratedDraftHackSavedToGoogleDrive';
-    payload: {
-        // the draft hack id
-        id: string;
-        // the version
-        v: number;
-        reference: string;
-        draftHackId: string;
-        draftHackContent: GeneratedDraftHackContent;
-        driveFile: {
-            id: string;
-            parentId: string;
-        }
-    }
-}
+import { GeneratedDraftHackContent } from './draft-hack-generation';
+
+export interface DraftHackGenerated {
+    id: string;
+    type: 'DraftHackGenerated';
+    payload: {
+        // the draft hack id
+        id: string;
+        // the version
+        v: number;
+        reference: string;
+        draftHackId: string;
+        draftHackContent: GeneratedDraftHackContent;
+
+        hackGenerationTriggerId: string;
+
+        // introduced 11/09/2024
+        researchNotes?: {
+            insight1: string;
+            insight2: string;
+            insight3: string;
+        };
+    }
+}
+
+export interface DraftHackGenerationFailed {
+    id: string;
+    type: 'DraftHackGenerationFailed';
+    payload: {
+        reference: string;
+        hackGenerationTriggerId: string;
+        errorMessage: string;
+    }
+}
+
+export interface GeneratedDraftHackSavedToGoogleDrive {
+    id: string;
+    type: 'GeneratedDraftHackSavedToGoogleDrive';
+    payload: {
+        // the draft hack id
+        id: string;
+        // the version
+        v: number;
+        reference: string;
+        draftHackId: string;
+        draftHackContent: GeneratedDraftHackContent;
+        driveFile: {
+            id: string;
+            parentId: string;
+        }
+    }
+}

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

@@ -1,39 +1,39 @@
-export interface GeneratedDraftHackContent {
-    title: string;
-    segments: GeneratedDraftHackSegments;
-    coverUrl?: string;
-    copyrightFreeCoverUrl?: string;
-    topics: GeneratedDraftTopic[];
-    notification: GeneratedDraftHackNotification;
-    contributors: GeneratedDraftContributor[];
-}
-export interface GeneratedDraftHackSegments {
-    favouriteQuote: GeneratedDraftHackSegment;
-    inANutshell: GeneratedDraftHackSegment;
-    introduction: GeneratedDraftHackSegment;
-    insights: GeneratedDraftHackInsightSegment[];
-    conclusion: GeneratedDraftHackSegment;
-}
-export interface GeneratedDraftHackSegment {
-    paragraphCards: GeneratedDraftHackCard[][];
-}
-export interface GeneratedDraftHackCard {
-    markdown: string;
-}
-export interface GeneratedDraftHackInsightSegment extends GeneratedDraftHackSegment {
-    title: string;
-    actions: GeneratedDraftHackAction[];
-}
-export interface GeneratedDraftHackAction {
-    title: string;
-    markdown: string;
-}
-export interface GeneratedDraftTopic {
-    name: string;
-}
-export interface GeneratedDraftHackNotification {
-    aiGeneratedText: string;
-}
-export interface GeneratedDraftContributor {
-    name: string;
-}
+export interface GeneratedDraftHackContent {
+    title: string;
+    segments: GeneratedDraftHackSegments;
+    coverUrl?: string;
+    copyrightFreeCoverUrl?: string;
+    topics: GeneratedDraftTopic[];
+    notification: GeneratedDraftHackNotification;
+    contributors: GeneratedDraftContributor[];
+}
+export interface GeneratedDraftHackSegments {
+    favouriteQuote: GeneratedDraftHackSegment;
+    inANutshell: GeneratedDraftHackSegment;
+    introduction: GeneratedDraftHackSegment;
+    insights: GeneratedDraftHackInsightSegment[];
+    conclusion: GeneratedDraftHackSegment;
+}
+export interface GeneratedDraftHackSegment {
+    paragraphCards: GeneratedDraftHackCard[][];
+}
+export interface GeneratedDraftHackCard {
+    markdown: string;
+}
+export interface GeneratedDraftHackInsightSegment extends GeneratedDraftHackSegment {
+    title: string;
+    actions: GeneratedDraftHackAction[];
+}
+export interface GeneratedDraftHackAction {
+    title: string;
+    markdown: string;
+}
+export interface GeneratedDraftTopic {
+    name: string;
+}
+export interface GeneratedDraftHackNotification {
+    aiGeneratedText: string;
+}
+export interface GeneratedDraftContributor {
+    name: string;
+}

package/src/enriched-b2b-organisation/enriched-b2b-organisation-events.ts

@@ -1,21 +1,21 @@
-import { EnrichedB2BOrganisation } from './enriched-b2b-organisation';
-
-export interface EnrichedB2BOrganisationCreatedEvent {
-    id: string;
-    type: 'EnrichedB2BOrganisationCreated';
-    payload: EnrichedB2BOrganisation;
-}
-
-export interface EnrichedB2BOrganisationUpdatedEvent {
-    id: string;
-    type: 'EnrichedB2BOrganisationUpdated';
-    payload: EnrichedB2BOrganisation;
-}
-
-export interface EnrichedB2BOrganisationDeletedEvent {
-    id: string;
-    type: 'EnrichedB2BOrganisationDeleted';
-    payload: EnrichedB2BOrganisation;
-}
-
-export type EnrichedB2BOrganisationChangedEvent = EnrichedB2BOrganisationCreatedEvent | EnrichedB2BOrganisationUpdatedEvent | EnrichedB2BOrganisationDeletedEvent;
+import { EnrichedB2BOrganisation } from './enriched-b2b-organisation';
+
+export interface EnrichedB2BOrganisationCreatedEvent {
+    id: string;
+    type: 'EnrichedB2BOrganisationCreated';
+    payload: EnrichedB2BOrganisation;
+}
+
+export interface EnrichedB2BOrganisationUpdatedEvent {
+    id: string;
+    type: 'EnrichedB2BOrganisationUpdated';
+    payload: EnrichedB2BOrganisation;
+}
+
+export interface EnrichedB2BOrganisationDeletedEvent {
+    id: string;
+    type: 'EnrichedB2BOrganisationDeleted';
+    payload: EnrichedB2BOrganisation;
+}
+
+export type EnrichedB2BOrganisationChangedEvent = EnrichedB2BOrganisationCreatedEvent | EnrichedB2BOrganisationUpdatedEvent | EnrichedB2BOrganisationDeletedEvent;

package/src/enriched-b2b-organisation/enriched-b2b-organisation.ts

@@ -1,38 +1,38 @@
-import { B2BOrganisation } from '../b2b-organisation/b2b-organisation';
-import { SupportedLocale } from '../localisation/supported-locales';
-
-/**
- * An enriched model of B2BOrganisation containing data that can be consumed by a public (unauthenticated) endpoint
- */
-export interface EnrichedB2BOrganisation extends B2BOrganisation {
-    identityProviders: EnrichedB2BOrganisationIdentityProvider[];
-    skinId?: string;
-    brandWebAppDomain?: string;
-    brandAppName?: {
-        [K in SupportedLocale]?: string
-    };
-    ssoEnforcement?: SSOEnforcement;
-}
-
-export interface EnrichedB2BOrganisationIdentityProvider {
-    id?: string;
-    providerName: string;
-    verifiedDomains: string[];
-    /** Matching verifiedDomains should require to be authenticated via IdP or not */
-    enforceIdpAuth: boolean;
-}
-
-export enum SSOEnforcement {
-    /**
-     * Means that no identity provider is configured for the organisation
-     */
-    NONE = 'NONE',
-    /**
-     *  Means that it has at least 1 identity provider but not all identity providers have enforceIdpAuth set to true
-     */
-    OPTIONAL = 'OPTIONAL',
-    /**
-     * Means it has at least 1 identity provider and that all identity providers enforceIdpAuth
-     */
-    ENFORCED = 'ENFORCED'
+import { B2BOrganisation } from '../b2b-organisation/b2b-organisation';
+import { SupportedLocale } from '../localisation/supported-locales';
+
+/**
+ * An enriched model of B2BOrganisation containing data that can be consumed by a public (unauthenticated) endpoint
+ */
+export interface EnrichedB2BOrganisation extends B2BOrganisation {
+    identityProviders: EnrichedB2BOrganisationIdentityProvider[];
+    skinId?: string;
+    brandWebAppDomain?: string;
+    brandAppName?: {
+        [K in SupportedLocale]?: string
+    };
+    ssoEnforcement?: SSOEnforcement;
+}
+
+export interface EnrichedB2BOrganisationIdentityProvider {
+    id?: string;
+    providerName: string;
+    verifiedDomains: string[];
+    /** Matching verifiedDomains should require to be authenticated via IdP or not */
+    enforceIdpAuth: boolean;
+}
+
+export enum SSOEnforcement {
+    /**
+     * Means that no identity provider is configured for the organisation
+     */
+    NONE = 'NONE',
+    /**
+     *  Means that it has at least 1 identity provider but not all identity providers have enforceIdpAuth set to true
+     */
+    OPTIONAL = 'OPTIONAL',
+    /**
+     * Means it has at least 1 identity provider and that all identity providers enforceIdpAuth
+     */
+    ENFORCED = 'ENFORCED'
 }

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,109 +1,111 @@
-import { HackAffiliate, HackContributor, HackExternalLink, HackSourceData, HackTopic, HackType } from '../hack/hack';
-import { KnowledgeSource } from '../knowledge-source/knowledge-source';
-import { Profile, ProfileMetadata } 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;
-    tenant?: string;
-    acl: string[];
-    theme: Theme;
-    title: string;
-    isHidden?: boolean;
-    editorialTags?: string[];
-    coverUrl?: string;
-    /** Added in July 2024. This is the URL of the cover image that is free to use without any copyright. */
-    copyrightFreeCoverUrl?: 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;
-
-    /**
-     * Tenant display name, from the display name of its b2b-organisation, if any
-     */
-    tenantDisplayName?: string;
-}
-
-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 | ProfileMetadata;
+import { HackAffiliate, HackContributor, HackExternalLink, HackSourceData, HackTopic, HackType } from '../hack/hack';
+import { KnowledgeSource } from '../knowledge-source/knowledge-source';
+import { Profile, ProfileMetadata } 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';
+import { PrimaryTopic } from '../topics/primary-topic';
+
+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;
+    tenant?: string;
+    acl: string[];
+    theme: Theme;
+    title: string;
+    isHidden?: boolean;
+    editorialTags?: string[];
+    coverUrl?: string;
+    /** Added in July 2024. This is the URL of the cover image that is free to use without any copyright. */
+    copyrightFreeCoverUrl?: string;
+    notifications?: EnrichedHackNotifications;
+    /* currently contains the inANutshell segment markdown */
+    description: string;
+    // ...
+
+    segments: HackWithVoice['segments']; // Use the 'HackWithVoice' type
+    affiliate?: HackAffiliate;
+    topics: HackTopic[];
+    primaryTopics: PrimaryTopic[];
+    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;
+
+    /**
+     * Tenant display name, from the display name of its b2b-organisation, if any
+     */
+    tenantDisplayName?: string;
+}
+
+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 | ProfileMetadata;