Build-CLI/cli/src/contracts.ts at 2a81eca74d610eeb22b540a9d1c05f6368024f13 · microsoft/Build-CLI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
// Shared types for the CLI

export interface RawSession {
  sessionCode?: string;
  title?: string;
  description?: string;
  speakerNames?: string | string[];
  TimeSlot?: string;
  startDateTime?: string;
  endDateTime?: string;
  location?: Array<{ displayValue?: string; logicalValue?: string } | string>
    | { displayValue?: string; logicalValue?: string }
    | string;
  sessionLevel?: Array<{ displayValue?: string; logicalValue?: string }> | string;
  sessionType?: { displayValue?: string; logicalValue?: string } | string;
  topic?: Array<{ displayValue?: string; logicalValue?: string }> | string;
  solutionArea?: Array<{ displayValue?: string; logicalValue?: string }> | string;
  product?: Array<{ displayValue?: string; logicalValue?: string } | string>;
  programmingLanguages?: Array<{ displayValue?: string; logicalValue?: string } | string>;
  tags?: Array<{ displayValue?: string; logicalValue?: string } | string>;
  deliveryTypes?: Array<{ displayValue?: string; logicalValue?: string } | string>;
  viewingOptions?: Array<{ displayValue?: string; logicalValue?: string } | string>;
  hasLiveStream?: boolean;
  hasOnDemand?: boolean;
  relatedSessionCodes?: string[];
  slideDeck?: string;
  onDemand?: string;
  [key: string]: unknown;
}

export interface Session {
  sessionCode: string;
  title: string;
  description: string;
  speakers: string;
  timeSlot: string;
  startDateTime: string;
  endDateTime: string;
  location: string;
  level: string;
  type: string;
  topic: string;
  solutionArea: string;
  product: string;
  languages: string;
  tags: string;
  deliveryTypes: string;
  viewingOptions: string;
  hasLiveStream: boolean;
  hasOnDemand: boolean;
  relatedSessionCodes: string;
  slideDeck: string;
  onDemand: string;
  event: string;
}

export interface EventConfig {
  id: string;
  name: string;
  endpoint: string;
}

export type CacheCheckStatus = 'updated' | 'not-modified' | 'failed';

export interface CacheMeta {
  eventId: string;
  /** Cache schema version — triggers a full re-fetch when it doesn't match the CLI's current version. */
  schemaVersion?: number;
  /**
   * When session content was last downloaded and written locally.
   * Kept as fetchedAt for compatibility with existing cache metadata.
   */
  fetchedAt: string;
  /** Last time the remote catalog was checked, including 304 responses. */
  checkedAt?: string;
  /** Next time search commands may revalidate this cache. */
  nextCheckAt?: string;
  sessionCount: number;
  etag?: string;
  lastModified?: string;
  lastCheckStatus?: CacheCheckStatus;
  consecutiveFailures?: number;
}

export interface SearchResult {
  session: Session;
  score: number;
}