Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions eslint.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ module.exports = tseslint.config(
'test-site/*',
'config/*',
'docs/*',
'test-types/*',
],
},
);
7 changes: 7 additions & 0 deletions runtime/analytics/types.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
export interface AnalyticsService {
sendTrackingLogEvent(eventName: string, properties: object): Promise<void>,
identifyAuthenticatedUser(userId: string | number, traits?: Record<string, unknown>): void,
identifyAnonymousUser(traits?: Record<string, unknown>): void,
sendTrackEvent(eventName?: string, properties?: Record<string, unknown>): void,
sendPageEvent(category: string, name: string, properties?: Record<string, unknown>): void,
}
13 changes: 13 additions & 0 deletions runtime/auth/types.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
export interface AuthService {
getAuthenticatedHttpClient(options?: Record<string, unknown>): unknown,
getHttpClient(options?: Record<string, unknown>): unknown,
getLoginRedirectUrl(redirectUrl?: string): string,
redirectToLogin(redirectUrl?: string): void,
getLogoutRedirectUrl(redirectUrl?: string): string,
redirectToLogout(redirectUrl?: string): void,
getAuthenticatedUser(): Record<string, unknown> | null,
setAuthenticatedUser(authUser: Record<string, unknown>): void,
fetchAuthenticatedUser(options?: Record<string, unknown>): Promise<Record<string, unknown> | null>,
ensureAuthenticatedUser(redirectUrl?: string): Promise<Record<string, unknown>>,
hydrateAuthenticatedUser(): Promise<null>,
}
18 changes: 18 additions & 0 deletions test-types/site-config-service-overrides.typecheck.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
import { SiteConfig } from '../types';
import NewRelicLoggingService from '../runtime/logging/NewRelicLoggingService';
import SegmentAnalyticsService from '../runtime/analytics/SegmentAnalyticsService';
import AxiosJwtAuthService from '../runtime/auth/AxiosJwtAuthService';

const config: SiteConfig = {
loggingService: NewRelicLoggingService,
analyticsService: SegmentAnalyticsService,
authService: AxiosJwtAuthService,
siteId: '',
siteName: '',
baseUrl: '',
lmsBaseUrl: '',
loginUrl: '',
logoutUrl: '',
}

export default config;
37 changes: 37 additions & 0 deletions types.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@ import { FC, ReactElement, ReactNode } from 'react';
import { MessageDescriptor } from 'react-intl';
import { RouteObject } from 'react-router';
import { SlotOperation } from './runtime/slots/types';
import { LoggingService } from './runtime/logging/types';
import { AnalyticsService } from './runtime/analytics/types';
import { AuthService } from './runtime/auth/types';

// Apps

Expand Down Expand Up @@ -59,6 +62,35 @@ export interface RequiredSiteConfig {
export type LocalizedMessages = Record<string, Record<string, string>>;
export type SiteMessages = LocalizedMessages[];

export type { LoggingService, AnalyticsService, AuthService };

// Logging instantiated
export type LoggingServiceClass = new (options: {
config: SiteConfig,
}) => LoggingService;

// Analytics instantiated
export type AnalyticsServiceClass = new (options: {
config: SiteConfig,
loggingService: LoggingService,
httpClient: unknown,
}) => AnalyticsService;

// Auth instantiated
export type AuthServiceClass = new (options: {
config: {
baseUrl: string,
lmsBaseUrl: string,
loginUrl: string,
logoutUrl: string,
refreshAccessTokenApiPath: string,
accessTokenCookieName: string,
csrfTokenApiPath: string,
},
loggingService: object,
middleware?: unknown[],
}) => AuthService;

export interface OptionalSiteConfig {
// Site environment
environment: EnvironmentTypes,
Expand Down Expand Up @@ -92,6 +124,11 @@ export interface OptionalSiteConfig {

// Analytics
segmentKey: string | null,

// Services
loggingService: LoggingServiceClass,
analyticsService: AnalyticsServiceClass,
authService: AuthServiceClass,
}

export type SiteConfig = RequiredSiteConfig & Partial<OptionalSiteConfig>;
Expand Down