Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,106 @@
import type { VMState } from "../index.js";
import type { FilePreviewStatus, FileScanStatus } from "./file-browser.vm.js";
/**
* File detail view-model (AK-P4a §9). Pure function, i18n keys only.
* Preview/download URLs point at the auth-proxy route (AD-23).
*/
export interface FileLinkedEntity {
readonly entityType: string;
readonly entityId: string;
readonly linkRole: string | null;
/** Internal route to the target entity (loader-built) or null. */
readonly href: string | null;
}
export interface FileDetailData {
readonly id: string;
readonly displayName: string;
readonly mimeType: string;
readonly sizeBytes: number;
readonly createdAtIso: string;
readonly tags: readonly string[];
readonly notes: string | null;
readonly source: string;
readonly previewStatus: FilePreviewStatus;
readonly scanStatus: FileScanStatus;
/** Proxy URL of the preview (or null). */
readonly previewUrl: string | null;
/** Proxy URL of the original for download. */
readonly downloadUrl: string;
readonly assignedToUserId: string | null;
readonly linkedEntities: readonly FileLinkedEntity[];
/** Plain-text hint key when previewStatus=not_supported/failed. */
readonly previewFallbackKey: string | null;
/** Plain-text key when scanStatus=infected (download blocked) or pending. */
readonly scanNoticeKey: string | null;
readonly canWrite: boolean;
readonly canDelete: boolean;
readonly canAdmin: boolean;
/** Regenerating the preview only makes sense when it failed. */
readonly canRegeneratePreview: boolean;
}
export type FileDetailVM = VMState<FileDetailData>;
export interface BuildFileDetailVMInput {
readonly id: string;
readonly displayName: string;
readonly mimeType: string;
readonly sizeBytes: number;
readonly createdAtIso: string;
readonly tags: readonly string[];
readonly notes: string | null;
readonly source: string;
readonly previewStatus: FilePreviewStatus;
readonly scanStatus: FileScanStatus;
readonly previewUrl: string | null;
readonly downloadUrl: string;
readonly assignedToUserId: string | null;
readonly linkedEntities: readonly FileLinkedEntity[];
readonly canWrite: boolean;
readonly canDelete: boolean;
readonly canAdmin: boolean;
}
function previewFallbackKey(status: FilePreviewStatus): string | null {
if (status === "not_supported") return "files.detail.preview.notSupported";
if (status === "failed") return "files.detail.preview.failed";
if (status === "pending" || status === "generating") return "files.detail.preview.pending";
return null;
}
function scanNoticeKey(status: FileScanStatus): string | null {
if (status === "infected") return "files.detail.scan.infected";
if (status === "pending") return "files.detail.scan.pending";
return null;
}
export function buildFileDetailVM(input: BuildFileDetailVMInput): FileDetailVM {
return {
status: "ready",
data: {
id: input.id,
displayName: input.displayName,
mimeType: input.mimeType,
sizeBytes: input.sizeBytes,
createdAtIso: input.createdAtIso,
tags: input.tags,
notes: input.notes,
source: input.source,
previewStatus: input.previewStatus,
scanStatus: input.scanStatus,
// An infected file never exposes a preview URL (fail-closed).
previewUrl: input.scanStatus === "infected" ? null : input.previewUrl,
downloadUrl: input.downloadUrl,
assignedToUserId: input.assignedToUserId,
linkedEntities: input.linkedEntities,
previewFallbackKey: previewFallbackKey(input.previewStatus),
scanNoticeKey: scanNoticeKey(input.scanStatus),
canWrite: input.canWrite,
canDelete: input.canDelete,
canAdmin: input.canAdmin,
canRegeneratePreview: input.canWrite && input.previewStatus === "failed",
},
};
}