valia/src/schema/services/cloner.ts

A runtime data validator in TypeScript with advanced type inference, built-in validation functions, and seamless integration for server and client environments.

import type { SetableCriteria } from "../formats";
import { isArray, isBasicObject } from "../../testers";
import { isMountedCriteria } from "./mounter";

interface CloningTask {
	src: unknown;
	cpy: any;
}

function processTask(
	queue: CloningTask[],
	{ src, cpy }: CloningTask
) {
	if (isBasicObject(src)) {
		if (isMountedCriteria(src)) {
			cpy = {...src};
		}
		else {
			const keys = Reflect.ownKeys(src);
			for (let i = 0; i < keys.length; i++) {
				const key = keys[i];

				if (isBasicObject(src[key])) {
					if (isMountedCriteria(src[key])) {
						cpy[key] = {...src[key]};
					} else {
						cpy[key] = {};

						queue.push({
							src: src[key],
							cpy: cpy[key]
						});
					}
				} else if (isArray(src[key])) {
					cpy[key] = [];

					queue.push({
						src: src[key],
						cpy: cpy[key]
					});
				} else {
					cpy[key] = src[key];
				}
			}
		}
	}
	else if (isArray(src)) {
		for (let i = 0; i < src.length; i++) {
			const index = i;

			if (isBasicObject(src[index])) {
				if (isMountedCriteria(src[index])) {
					cpy[i] = {...src[index]};
				} else {
					cpy[i] = {};

					queue.push({
						src: src[index],
						cpy: cpy[index]
					});
				}
			} else if (isArray(src[index])) {
				cpy[index] = [];

				queue.push({
					src: src[index],
					cpy: cpy[index]
				});
			} else {
				cpy[index] = src[index];
			}
		}
	}
	else {
		cpy = src;
	}
}

/**
 * Clones the object starting from the root and stops traversing a branch
 * when a mounted criteria node is encountered. In such cases, the mounted
 * object encountered see its internal properties copied to a new reference
 * so that the junction is a unique reference in the tree.
 * 
 * @param src Source object of the clone
 * @returns Clone of the source object
 */
export function cloner<T extends SetableCriteria>(
	src: T
): T {
	let cpy = {};
	let queue: CloningTask[] = [{ src, cpy }];

	while (queue.length > 0) {
		const currentTask = queue.pop()!;

		processTask(queue, currentTask);
	}

	return (cpy as T);
};