fix(validation): enforce strict OpenAPI-normalized payload parsing

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Author: vitormattos

src/views/Validation.vue

@@ -217,29 +217,236 @@ function toValidationStatus(value: unknown): ValidationStatus | null {
 	return null
 }
 
+function toSignerStatus(value: unknown): SignerDetailRecord['status'] | null {
+	const normalizedValue = toNumber(value)
+	if (normalizedValue === 0 || normalizedValue === 1 || normalizedValue === 2) {
+		return normalizedValue
+	}
+	return null
+}
+
+function toStringOrNull(value: unknown): string | null {
+	return typeof value === 'string' ? value : null
+}
+
+function isNullableString(value: unknown): value is string | null {
+	return value === null || typeof value === 'string'
+}
+
+function normalizeRequestedBy(value: unknown): ValidationFileRecord['requested_by'] | null {
+	if (!isRecord(value)) {
+		return null
+	}
+	const userId = toStringOrNull(value.userId)
+	const displayName = toStringOrNull(value.displayName)
+	if (!userId || !displayName) {
+		return null
+	}
+	return {
+		userId,
+		displayName,
+	}
+}
+
+function normalizeValidationMetadata(value: unknown): ValidationFileRecord['metadata'] | undefined {
+	if (!isRecord(value)) {
+		return undefined
+	}
+	const extension = toStringOrNull(value.extension)
+	const p = toNumber(value.p)
+	if (!extension || p === null) {
+		return undefined
+	}
+	return {
+		extension,
+		p,
+	}
+}
+
+function normalizeValidationSettings(value: unknown): ValidationFileRecord['settings'] | undefined {
+	if (!isRecord(value)) {
+		return undefined
+	}
+	if (
+		typeof value.canSign !== 'boolean'
+		|| typeof value.canRequestSign !== 'boolean'
+		|| typeof value.phoneNumber !== 'string'
+		|| typeof value.hasSignatureFile !== 'boolean'
+		|| typeof value.needIdentificationDocuments !== 'boolean'
+		|| typeof value.identificationDocumentsWaitingApproval !== 'boolean'
+	) {
+		return undefined
+	}
+	return {
+		canSign: value.canSign,
+		canRequestSign: value.canRequestSign,
+		phoneNumber: value.phoneNumber,
+		hasSignatureFile: value.hasSignatureFile,
+		needIdentificationDocuments: value.needIdentificationDocuments,
+		identificationDocumentsWaitingApproval: value.identificationDocumentsWaitingApproval,
+		isApprover: typeof value.isApprover === 'boolean' ? value.isApprover : undefined,
+	}
+}
+
 function normalizeValidationSigner(signer: unknown): SignerDetailRecord | null {
 	if (!isRecord(signer)) {
 		return null
 	}
-	return { ...signer } as SignerDetailRecord
+
+	const signRequestId = toNumber(signer.signRequestId)
+	const displayName = toStringOrNull(signer.displayName)
+	const email = toStringOrNull(signer.email)
+	const signed = isNullableString(signer.signed) ? signer.signed : null
+	const status = toSignerStatus(signer.status)
+	const statusText = toStringOrNull(signer.statusText)
+	const description = isNullableString(signer.description) ? signer.description : null
+	const requestSignDate = toStringOrNull(signer.request_sign_date)
+	const me = typeof signer.me === 'boolean' ? signer.me : null
+	const visibleElements = Array.isArray(signer.visibleElements) ? signer.visibleElements : null
+
+	if (
+		signRequestId === null
+		|| !displayName
+		|| !email
+		|| status === null
+		|| !statusText
+		|| !requestSignDate
+		|| me === null
+		|| !visibleElements
+	) {
+		return null
+	}
+
+	const normalizedSigner: SignerDetailRecord = {
+		signRequestId,
+		displayName,
+		email,
+		signed,
+		status,
+		statusText,
+		description,
+		request_sign_date: requestSignDate,
+		me,
+		visibleElements,
+	}
+
+	const subject = toStringOrNull(signer.subject)
+	if (subject) {
+		normalizedSigner.subject = subject
+	}
+	const validFrom = toNumber(signer.valid_from)
+	if (validFrom !== null) {
+		normalizedSigner.valid_from = validFrom
+	}
+	const validTo = toNumber(signer.valid_to)
+	if (validTo !== null) {
+		normalizedSigner.valid_to = validTo
+	}
+	const remoteAddress = toStringOrNull(signer.remote_address)
+	if (remoteAddress) {
+		normalizedSigner.remote_address = remoteAddress
+	}
+	const userAgent = toStringOrNull(signer.user_agent)
+	if (userAgent) {
+		normalizedSigner.user_agent = userAgent
+	}
+	const userId = toStringOrNull(signer.userId)
+	if (userId) {
+		normalizedSigner.userId = userId
+	}
+	const signDate = isNullableString(signer.sign_date) ? signer.sign_date : undefined
+	if (signDate !== undefined) {
+		normalizedSigner.sign_date = signDate
+	}
+	const signRequestUuid = toStringOrNull(signer.sign_request_uuid)
+	if (signRequestUuid) {
+		normalizedSigner.sign_request_uuid = signRequestUuid
+	}
+	const hashAlgorithm = toStringOrNull(signer.hash_algorithm)
+	if (hashAlgorithm) {
+		normalizedSigner.hash_algorithm = hashAlgorithm
+	}
+	const signingOrder = toNumber(signer.signingOrder)
+	if (signingOrder !== null) {
+		normalizedSigner.signingOrder = signingOrder
+	}
+
+	return normalizedSigner
 }
 
 function normalizeValidationChildFile(file: unknown): ValidatedChildFileRecord | null {
 	if (!isRecord(file)) {
 		return null
 	}
-	return { ...file } as ValidatedChildFileRecord
+
+	const id = toNumber(file.id)
+	const uuid = toStringOrNull(file.uuid)
+	const name = toStringOrNull(file.name)
+	const status = toValidationStatus(file.status)
+	const statusText = toStringOrNull(file.statusText)
+	const nodeId = toNumber(file.nodeId)
+	const size = toNumber(file.size)
+	const fileUrl = toStringOrNull(file.file)
+	const metadata = isRecord(file.metadata) ? file.metadata : null
+	const metadataExtension = metadata ? toStringOrNull(metadata.extension) : null
+	const metadataPageCount = metadata ? toNumber(metadata.p) : null
+	const signers = Array.isArray(file.signers) ? file.signers : null
+
+	if (
+		id === null
+		|| !uuid
+		|| !name
+		|| status === null
+		|| !statusText
+		|| nodeId === null
+		|| size === null
+		|| !fileUrl
+		|| !metadata
+		|| !metadataExtension
+		|| metadataPageCount === null
+		|| !signers
+	) {
+		return null
+	}
+
+	return {
+		id,
+		uuid,
+		name,
+		status,
+		statusText,
+		nodeId,
+		totalPages: toNumber(file.totalPages) ?? 0,
+		size,
+		pdfVersion: toStringOrNull(file.pdfVersion) ?? '',
+		signers,
+		file: fileUrl,
+		metadata: {
+			extension: metadataExtension,
+			p: metadataPageCount,
+		},
+	}
 }
 
 function normalizeValidationDocument(data: unknown): ValidationFileRecord | null {
 	if (!isRecord(data)) {
 		return null
 	}
 
+	const id = toNumber(data.id)
 	const uuid = typeof data.uuid === 'string' ? data.uuid : null
 	const name = typeof data.name === 'string' ? data.name : null
 	const nodeId = toNumber(data.nodeId)
 	const status = toValidationStatus(data.status)
+	const statusText = toStringOrNull(data.statusText)
+	const signatureFlow = toNumber(data.signatureFlow)
+	const docmdpLevel = toNumber(data.docmdpLevel)
+	const filesCount = toNumber(data.filesCount)
+	const totalPages = toNumber(data.totalPages)
+	const size = toNumber(data.size)
+	const pdfVersion = toStringOrNull(data.pdfVersion)
+	const createdAt = toStringOrNull(data.created_at)
+	const requestedBy = normalizeRequestedBy(data.requested_by)
 	const files = Array.isArray(data.files)
 		? data.files
 			.map(normalizeValidationChildFile)
@@ -249,26 +456,60 @@ function normalizeValidationDocument(data: unknown): ValidationFileRecord | null
 		? data.signers
 			.map(normalizeValidationSigner)
 			.filter((signer): signer is SignerDetailRecord => signer !== null)
-		: undefined
+		: []
 	const nodeType = data.nodeType === 'envelope'
 		? 'envelope'
 		: data.nodeType === 'file'
 			? 'file'
 			: null
 
-	if (!uuid || !name || nodeId === null || status === null || nodeType === null) {
+	if (
+		id === null
+		|| !uuid
+		|| !name
+		|| nodeId === null
+		|| status === null
+		|| !statusText
+		|| nodeType === null
+		|| signatureFlow === null
+		|| docmdpLevel === null
+		|| filesCount === null
+		|| totalPages === null
+		|| size === null
+		|| !pdfVersion
+		|| !createdAt
+		|| !requestedBy
+	) {
 		return null
 	}
 
 	return {
-		...(data as ValidationFileRecord),
+		id,
 		uuid,
 		name,
+		statusText,
 		nodeId,
 		status,
 		nodeType,
+		signatureFlow,
+		docmdpLevel,
+		filesCount,
 		files,
+		totalPages,
+		size,
+		pdfVersion,
+		created_at: createdAt,
+		requested_by: requestedBy,
+		file: toStringOrNull(data.file) ?? undefined,
+		url: toStringOrNull(data.url) ?? undefined,
+		mime: toStringOrNull(data.mime) ?? undefined,
+		metadata: normalizeValidationMetadata(data.metadata),
+		signersCount: toNumber(data.signersCount) ?? undefined,
 		signers,
+		settings: normalizeValidationSettings(data.settings),
+		messages: Array.isArray(data.messages) ? data.messages : undefined,
+		visibleElements: Array.isArray(data.visibleElements) ? data.visibleElements : undefined,
+		pages: Array.isArray(data.pages) ? data.pages : undefined,
 	}
 }