complexqa_frontend_core 1.25.1 → 1.26.1

package/publish/types/family_elements/typeTeamDomain.js

@@ -0,0 +1,172 @@
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+import { echo, is_object } from "../../utils/utils.js";
+import { typeTeamDomain_i18n } from "../element_translate/typeTeamDomain.i18n.js";
+
+
+/**
+ * Team-owned domain (cqa_team.team_domains). Shared across projects of the team.
+ * Verify/revoke via ApiService.team_domain; url.inspect requires VERIFIED.
+ * Backend: test_site/docs/team/team-domains.md
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class typeTeamDomain extends familyGeneralElement
+{
+	team_domain_id;
+	team_id;
+	domain_canon;
+	display_name;
+	verification_method;
+	domain_status;
+	verification_token;
+	last_error_message;
+	verified_at;
+	created_at;
+	updated_at;
+	file_url_https;
+	file_url_http;
+	file_body;
+	dns_host;
+	dns_txt_value;
+	instruction;
+
+	primary_key = 'team_domain_id';
+	api_key     = 'team_domain';
+
+	structure_scheme = {
+		team_domain_id     : 'integer | optional',
+		team_id            : 'integer | optional',
+		domain_canon       : 'string | max:255 | require',
+		display_name       : 'string | max:255 | optional',
+		verification_method: 'string | enum | require',
+		domain_status      : 'string | enum | optional',
+		verification_token : 'string | optional',
+		last_error_message : 'string | optional',
+		verified_at        : 'timestamp | optional',
+		created_at         : 'timestamp | optional',
+		updated_at         : 'timestamp | optional',
+		file_url_https     : 'string | optional',
+		file_url_http      : 'string | optional',
+		file_body          : 'string | optional',
+		dns_host           : 'string | optional',
+		dns_txt_value      : 'string | optional',
+		instruction        : 'string | optional',
+	};
+
+	create_scheme = [
+		'domain_canon',
+		'display_name',
+		'verification_method',
+	];
+
+	available_enum_values = {
+		verification_method: [ 'FILE', 'DNS_TXT' ],
+		domain_status      : [ 'PENDING', 'VERIFIED', 'FAILED', 'REVOKED' ],
+	};
+
+	enum_value_translate_matrix = typeTeamDomain_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeTeamDomain_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING : '#4D92FA',
+		VERIFIED: '#009688',
+		FAILED  : '#E66565',
+		REVOKED : '#9E9E9E',
+	};
+
+	clone_element      = false;
+	delete_mass        = false;
+	update_properties  = false;
+	update             = false;
+	clone_element_mass = false;
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	verify(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].verify(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback?.success({ response, payload });
+			}
+		}).catch((error) =>
+		{
+			echo({ error });
+			if (typeof callback?.error === 'function')
+			{
+				callback?.error({ error, payload });
+			}
+		}).finally((response) =>
+		{
+			if (typeof callback?.final === 'function')
+			{
+				callback?.final({ response, payload });
+			}
+		});
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	revoke(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].revoke(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback?.success({ response, payload });
+			}
+		}).catch((error) =>
+		{
+			echo({ error });
+			if (typeof callback?.error === 'function')
+			{
+				callback?.error({ error, payload });
+			}
+		}).finally((response) =>
+		{
+			if (typeof callback?.final === 'function')
+			{
+				callback?.final({ response, payload });
+			}
+		});
+	}
+}

package/publish/types/family_utils/typeUtilExecutionUrlInspect.js

@@ -0,0 +1,199 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { typeUtilExecutionUrlInspect_i18n } from "../element_translate/typeUtilExecutionUrlInspect.i18n.js";
+import { typeUtilExecutionUrlInspectCheck } from "./typeUtilExecutionUrlInspectCheck.js";
+import { familyUtil_i18n } from "../element_translate/_familyUtil.i18n.js";
+import { create_type_file_from_wire } from "../family_files/typeFileFactory.js";
+
+
+/**
+ * url.inspect suite — one "Check now" run (family of probes). Always has project_id.
+ * Create/details/search via ApiService.url_inspect, not browser_tools_* APIs.
+ * Backend: test_site/docs/util_service/api-url-inspect.md
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class typeUtilExecutionUrlInspect extends familyUtil
+{
+	util_execution_id;
+	util_action_id;
+	util_action_key;
+	project_id;
+	user_id;
+	team_id;
+	execution_status;
+	error_message;
+	submitted_at;
+	completed_at;
+	created_at;
+	team_domain_id;
+	domain_canon;
+	page_path;
+	suite_status;
+	checks;
+	browser;
+
+	primary_key = 'util_execution_id';
+	api_key     = 'url_inspect';
+
+	structure_scheme = {
+		util_execution_id: 'integer | optional',
+		util_action_id   : 'integer | optional',
+		util_action_key  : 'string | optional',
+		project_id       : 'integer | require',
+		user_id          : 'integer | optional',
+		team_id          : 'integer | optional',
+		execution_status : 'string | enum | optional',
+		error_message    : 'string | optional',
+		submitted_at     : 'timestamp | optional',
+		completed_at     : 'timestamp | optional',
+		created_at       : 'timestamp | optional',
+		team_domain_id   : 'integer | require',
+		domain_canon     : 'string | optional',
+		page_path        : 'string | optional',
+		suite_status     : 'string | enum | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'team_domain_id',
+		'page_path',
+	];
+
+	available_enum_values = {
+		execution_status: familyUtil.get_execution_status_values(),
+		suite_status    : [ 'CREATED', 'QUEUED', 'RUNNING', 'COMPLETED', 'PARTIAL', 'FAILED', 'SUBMIT_FAILED' ],
+	};
+
+	enum_value_translate_matrix = {
+		...typeUtilExecutionUrlInspect_i18n.enum_value_translate_matrix,
+		execution_status: familyUtil_i18n.execution_status,
+	};
+
+	attribute_name_translate_matrix = typeUtilExecutionUrlInspect_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		CREATED      : '#4D92FA',
+		QUEUED       : '#009688',
+		RUNNING      : '#4D92FA',
+		COMPLETED    : '#009688',
+		PARTIAL      : '#F0A202',
+		FAILED       : '#E66565',
+		SUBMIT_FAILED: '#E66565',
+	};
+
+	clone_element      = false;
+	delete_mass        = false;
+	update_properties  = false;
+	update             = false;
+	clone_element_mass = false;
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (key === 'checks' && Array.isArray(value))
+				{
+					this.checks = value.map((row) => new typeUtilExecutionUrlInspectCheck(row));
+				}
+				else if (key === 'browser')
+				{
+					this.browser = typeUtilExecutionUrlInspect.hydrateBrowser(value);
+				}
+				else if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 *
+	 * @returns {typeUtilExecutionUrlInspect|false}
+	 */
+	static composeDetails(data)
+	{
+		if (!data || !is_object(data))
+		{
+			return false;
+		}
+
+		return new typeUtilExecutionUrlInspect(data);
+	}
+
+
+	/**
+	 * @param {object|null|undefined} value
+	 *
+	 * @returns {object|null}
+	 */
+	static hydrateBrowser(value)
+	{
+		if (!value || !is_object(value))
+		{
+			return null;
+		}
+
+		return {
+			...value,
+			screenshot_file: value.screenshot_file
+				? create_type_file_from_wire(value.screenshot_file)
+				: false,
+			har_file: value.har_file
+				? create_type_file_from_wire(value.har_file)
+				: false,
+			console: Array.isArray(value.console) ? value.console : [],
+			mixed_content: Array.isArray(value.mixed_content) ? value.mixed_content : [],
+			screenshots: Array.isArray(value.screenshots)
+				? value.screenshots.map((row) => ({
+					...row,
+					file: row?.file ? create_type_file_from_wire(row.file) : false,
+				}))
+				: [],
+		};
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {Function|false} [callback]
+	 *
+	 * @returns {Promise<*>}
+	 */
+	async details(payload, callback = false)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].details(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback?.success({ response, payload });
+			}
+			return response;
+		}).catch((error) =>
+		{
+			if (typeof callback?.error === 'function')
+			{
+				callback?.error({ error, payload });
+			}
+			throw error;
+		});
+	}
+}

package/publish/types/family_utils/typeUtilExecutionUrlInspectCheck.js

@@ -0,0 +1,100 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { typeUtilExecutionUrlInspectCheck_i18n } from "../element_translate/typeUtilExecutionUrlInspectCheck.i18n.js";
+
+
+/**
+ * One probe inside url.inspect suite (check_kind + check_status + finding_code).
+ * finding_code is not a status. Viewport screenshots live on suite.browser, not on this type.
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class typeUtilExecutionUrlInspectCheck extends familyUtil
+{
+	url_inspect_check_id;
+	util_execution_id;
+	sort_order;
+	check_kind;
+	check_status;
+	finding_code;
+	summary_message;
+	detail_message;
+
+	primary_key = 'url_inspect_check_id';
+	api_key     = 'url_inspect';
+
+	structure_scheme = {
+		url_inspect_check_id: 'integer | optional',
+		util_execution_id   : 'integer | optional',
+		sort_order          : 'integer | optional',
+		check_kind          : 'string | enum | optional',
+		check_status        : 'string | enum | optional',
+		finding_code        : 'string | enum | optional',
+		summary_message     : 'string | optional',
+		detail_message      : 'string | optional',
+	};
+
+	available_enum_values = {
+		check_kind  : [ 'DNS', 'TCP_80', 'TCP_443', 'TLS', 'HTTP', 'HTTPS', 'SECURITY_HEADERS', 'BROWSER' ],
+		check_status: [ 'PENDING', 'QUEUED', 'RUNNING', 'COMPLETED', 'SKIPPED', 'ERROR' ],
+		finding_code: [
+			'SUCCESS',
+			'ERR_NAME_NOT_RESOLVED',
+			'ERR_CONNECTION_REFUSED',
+			'ERR_CONNECTION_TIMED_OUT',
+			'ERR_CERT_DATE_INVALID',
+			'ERR_CERT_AUTHORITY_INVALID',
+			'ERR_CERT_COMMON_NAME_INVALID',
+			'ERR_SSL_PROTOCOL_ERROR',
+			'ERR_TOO_MANY_REDIRECTS',
+			'HTTP_STATUS',
+			'NO_TLS',
+			'EMPTY_BODY',
+			'PROTOTYPE_BROWSER_SKIPPED',
+			'NO_PUBLIC_ADDRESS',
+			'UNKNOWN_CHECK_KIND',
+			'BROWSER_FAILED',
+			'BROWSER_SUBMIT_FAILED',
+		],
+	};
+
+	enum_value_translate_matrix = typeUtilExecutionUrlInspectCheck_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeUtilExecutionUrlInspectCheck_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING  : '#4D92FA',
+		QUEUED   : '#009688',
+		RUNNING  : '#4D92FA',
+		COMPLETED: '#009688',
+		SKIPPED  : '#9E9E9E',
+		ERROR    : '#E66565',
+	};
+
+	clone_element      = false;
+	delete_mass        = false;
+	update_properties  = false;
+	update             = false;
+	clone_element_mass = false;
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}