Update getWithChildren to use stela

slifty · slifty · commit 22c3d467f44a · 2025-09-15T16:18:24.000-04:00
diff --git a/src/app/shared/services/api/folder.repo.ts b/src/app/shared/services/api/folder.repo.ts
@@ -1,7 +1,17 @@
 import { FolderVO, FolderVOData, ItemVO } from '@root/app/models';
 import { BaseResponse, BaseRepo } from '@shared/services/api/base';
-import { Observable } from 'rxjs';
+import { firstValueFrom, Observable } from 'rxjs';
 import { DataStatus } from '@models/data-status.enum';
+import {
+	convertStelaLocationToLocnVOData,
+	convertStelaRecordToRecordVO,
+	convertStelaSharetoShareVO,
+	convertStelaTagToTagVO,
+	StelaLocation,
+	StelaShare,
+	StelaTag,
+	type StelaRecord,
+} from './record.repo';
 
 const MIN_WHITELIST: (keyof FolderVO)[] = [
 	'folderId',
@@ -17,6 +27,115 @@ const DEFAULT_WHITELIST: (keyof FolderVO)[] = [
 	'view',
 ];
 
+interface StelaFolder {
+	folderId: string;
+	size: number;
+	location: StelaLocation;
+	parentFolder: {
+		id: string;
+	};
+	shares: Array<StelaShare>;
+	tags: Array<StelaTag>;
+	archive: {
+		id: string;
+		name: string;
+	};
+	createdAt: string;
+	updatedAt: string;
+	description: string;
+	displayTimestamp: string;
+	displayEndTimestamp: string;
+	displayName: string;
+	downloadName: string;
+	imageRatio: number;
+	paths: {
+		names: string[];
+	};
+	publicAt: string;
+	sort: string;
+	thumbnailUrls: {
+		'200': string;
+		'256': string;
+		'500': string;
+		'1000': string;
+		'2000': string;
+	};
+	type: string;
+	status: string;
+	view: string;
+	children?: StelaFolderChild[];
+}
+
+interface PagedStelaResponse<T> {
+	items: Array<T>;
+}
+
+type StelaFolderChild = StelaFolder | StelaRecord;
+
+const isStelaRecord = (child: StelaFolderChild): child is StelaRecord =>
+	child && 'recordId' in child;
+
+const convertStelaFolderToFolderVO = (stelaFolder: StelaFolder): FolderVO => {
+	stelaFolder.children ??= [];
+	const childFolderVOs = stelaFolder.children
+		.filter((child): child is StelaFolder => !isStelaRecord(child))
+		.map(convertStelaFolderToFolderVO);
+	const childRecordVOs = stelaFolder.children
+		.filter(isStelaRecord)
+		.map(convertStelaRecordToRecordVO);
+	return new FolderVO({
+		...stelaFolder,
+		folderId: stelaFolder.folderId,
+		archiveId: stelaFolder.archive.id,
+		displayName: stelaFolder.displayName,
+		displayDT: stelaFolder.displayTimestamp,
+		displayEndDT: stelaFolder.displayEndTimestamp,
+		derivedDT: stelaFolder.displayTimestamp,
+		derivedEndDT: stelaFolder.displayEndTimestamp,
+		note: '',
+		description: stelaFolder.description,
+		sort: stelaFolder.sort,
+		locnId: stelaFolder.location.id,
+		timeZoneId: 88, // Hard coded for now
+		view: stelaFolder.view,
+		imageRatio: stelaFolder.imageRatio,
+		type: stelaFolder.type,
+		thumbStatus: stelaFolder.status,
+		thumbURL200: stelaFolder.thumbnailUrls['200'],
+		thumbURL500: stelaFolder.thumbnailUrls['500'],
+		thumbURL1000: stelaFolder.thumbnailUrls['1000'],
+		thumbURL2000: stelaFolder.thumbnailUrls['2000'],
+		thumbDT: stelaFolder.displayTimestamp,
+		thumbnail256: stelaFolder.thumbnailUrls['256'],
+		thumbnail256CloudPath: stelaFolder.thumbnailUrls['256'],
+		status: stelaFolder.status,
+		publicDT: stelaFolder.publicAt,
+		parentFolderId: stelaFolder.parentFolder.id,
+		pathAsText: stelaFolder.paths.names,
+		ParentFolderVOs: [new FolderVO({ folderId: stelaFolder.parentFolder.id })],
+		ChildFolderVOs: childFolderVOs,
+		RecordVOs: childRecordVOs,
+		LocnVO: convertStelaLocationToLocnVOData(stelaFolder.location),
+		TimezoneVO: {
+			timeZoneId: 88,
+			displayName: 'Central Time',
+			timeZonePlace: 'America/Chicago',
+			stdName: 'Central Standard Time',
+			stdAbbrev: 'CST',
+			stdOffset: '-06:00',
+			dstName: 'Central Daylight Time',
+			dstAbbrev: 'CDT',
+			dstOffset: '-05:00',
+		},
+		TagVOs: (stelaFolder.tags ?? []).map((stelaTag) =>
+			convertStelaTagToTagVO(stelaTag, stelaFolder.archive.id),
+		),
+		ChildItemVOs: [...childRecordVOs, ...childFolderVOs],
+		ShareVOs: (stelaFolder.shares ?? []).map(convertStelaSharetoShareVO),
+		isFolder: true,
+	});
+};
+
 export class FolderRepo extends BaseRepo {
 	public async getRoot(): Promise<FolderResponse> {
 		return await this.http.sendRequestPromise<FolderResponse>(
@@ -46,20 +165,73 @@ export class FolderRepo extends BaseRepo {
 		);
 	}
 
+	private async getStelaFolder(folderVO: FolderVO): Promise<StelaFolder> {
+		const queryData = {
+			folderIds: [folderVO.folderId],
+		};
+		const folderResponse = (
+			await firstValueFrom(
+				this.httpV2.get<PagedStelaResponse<StelaFolder>>(
+					`v2/folder`,
+					queryData,
+				),
+			)
+		)[0];
+		return folderResponse.items[0];
+	}
+
+	private async getStelaFolderChildren(
+		folderVO: FolderVO,
+	): Promise<StelaFolderChild[]> {
+		const queryData = {
+			pageSize: 99999999, // We want all results in one request
+		};
+		const childrenResponse = (
+			await firstValueFrom(
+				this.httpV2.get<PagedStelaResponse<StelaFolderChild>>(
+					`v2/folder/${folderVO.folderId}/children`,
+					queryData,
+				),
+			)
+		)[0];
+		return childrenResponse.items;
+	}
+
 	public async getWithChildren(folderVOs: FolderVO[]): Promise<FolderResponse> {
-		const data = folderVOs.map((folderVO) => ({
-			FolderVO: {
-				archiveNbr: folderVO.archiveNbr,
-				folder_linkId: folderVO.folder_linkId,
-				folderId: folderVO.folderId,
-			},
-		}));
+		// Stela has two separate endpoints -- one for loading the folder, one for loading the children.
+		const requests = folderVOs.map(async (folderVO) => {
+			const stelaFolder = await this.getStelaFolder(folderVO);
+			const stelaFolderChildren = await this.getStelaFolderChildren(folderVO);
+			return {
+				...stelaFolder,
+				children: stelaFolderChildren,
+			};
+		});
 
-		return await this.http.sendRequestPromise<FolderResponse>(
-			'/folder/getWithChildren',
-			data,
-			{ responseClass: FolderResponse },
+		const stelaFolders = (await Promise.all(requests)).flat();
+
+		// We need the `Results` to look the way v1 results look, for now.
+		const simulatedV1FolderResponseResults = stelaFolders.map(
+			(stelaFolder) => ({
+				data: [
+					{
+						FolderVO: convertStelaFolderToFolderVO(stelaFolder),
+					},
+				],
+				message: ['Folder retrieved'],
+				status: true,
+				resultDT: new Date().toISOString(),
+				createdDT: null,
+				updatedDT: null,
+			}),
 		);
+
+		const folderResponse = new FolderResponse({
+			isSuccessful: true,
+			isSystemUp: true,
+			Results: simulatedV1FolderResponseResults,
+		});
+		return folderResponse;
 	}
 
 	public navigate(folderVO: FolderVO): Observable<FolderResponse> {
@@ -94,13 +266,7 @@ export class FolderRepo extends BaseRepo {
 	}
 
 	public getLeanItems(folderVOs: FolderVO[]): Observable<FolderResponse> {
-		const data = folderVOs.map((folderVO) => ({
-			FolderVO: new FolderVO(folderVO),
-		}));
-
-		return this.http.sendRequest<FolderResponse>('/folder/getLeanItems', data, {
-			responseClass: FolderResponse,
-		});
+		return this.getWithChildren(folderVOs);
 	}
 
 	public async post(folderVOs: FolderVO[]): Promise<FolderResponse> {
diff --git a/src/app/shared/services/api/record.repo.ts b/src/app/shared/services/api/record.repo.ts
@@ -52,7 +52,7 @@ class MultipartUploadUrlsList {
 // to simply use what stela provides, but there is work to be done regarding
 // overall type safety in this code base before we want to take that project
 // on.
-interface StelaTag {
+export interface StelaTag {
 	id: string;
 	name: string;
 	type: string;
@@ -67,8 +67,8 @@ interface StelaFile {
 	updatedAt: string;
 	downloadUrl: string;
 }
-interface StelaLocation {
-	id: number;
+export interface StelaLocation {
+	id: string;
 	streetNumber: string;
 	streetName: string;
 	locality: string;
@@ -85,17 +85,17 @@ interface StelaArchive {
 	archiveNumber: string;
 	name: string;
 }
-interface StelaShare {
+export interface StelaShare {
 	id: string;
 	status: ShareStatus;
 	accessRole: AccessRoleType;
 	archive: {
-		id: number;
-		name: string;
+		id: string;
 		thumbUrl200: string;
+		name: string;
 	};
 }
-type StelaRecord = Omit<RecordVO, 'files'> & {
+export type StelaRecord = Omit<RecordVO, 'files'> & {
 	tags: Array<StelaTag>;
 	archiveNumber: string;
 	displayDate: string;
@@ -122,7 +122,10 @@ const resolveTagName = (tag: StelaTag): string => {
 	return tag.name;
 };
 
-const convertStelaTagToTagVO = (stelaTag: StelaTag, archiveId: string): TagVO =>
+export const convertStelaTagToTagVO = (
+	stelaTag: StelaTag,
+	archiveId: string,
+): TagVO =>
 	new TagVO({
 		tagId: Number.parseInt(stelaTag.id),
 		name: resolveTagName(stelaTag),
@@ -138,7 +141,7 @@ const convertStelaFileToPermanentFile = (
 	downloadURL: stelaFile.downloadUrl,
 });
 
-const convertStelaSharetoShareVO = (stelaShare: StelaShare): ShareVO =>
+export const convertStelaSharetoShareVO = (stelaShare: StelaShare): ShareVO =>
 	new ShareVO({
 		shareId: stelaShare.id,
 		status: stelaShare.status,
@@ -150,17 +153,19 @@ const convertStelaSharetoShareVO = (stelaShare: StelaShare): ShareVO =>
 		},
 	});
 
-const convertStelaLocationToLocnVOData = (
+export const convertStelaLocationToLocnVOData = (
 	stelaLocation: StelaLocation,
 ): LocnVOData =>
 	stelaLocation.id
 		? {
 				...stelaLocation,
-				locnId: stelaLocation.id,
+				locnId: Number.parseInt(stelaLocation.id, 10),
 			}
 		: null;
 
-const convertStelaRecordToRecordVO = (stelaRecord: StelaRecord): RecordVO =>
+export const convertStelaRecordToRecordVO = (
+	stelaRecord: StelaRecord,
+): RecordVO =>
 	new RecordVO({
 		...stelaRecord,
 		TagVOs: stelaRecord.tags.map((stelaTag) =>
