@develia/commons 0.4.2 → 0.4.3

package/src/type.ts

@@ -1,19 +1,372 @@
+import TypeCode from "./type-code.js";
+import {type Constructor} from "./types.js";
 
-/**
- * Represents different types in JavaScript.
- * @enum {string}
- */
-enum Type {
-    Undefined = "undefined",
-    Number = "number",
-    String = "string",
-    Boolean = "boolean",
-    Object = "object",
-    Function = "function",
-    Symbol = "symbol",
-    BigInt = "bigint",
-    Null = "null"
-}
-
-export default Type;
+export default class Type<T = unknown> {
 
+    // ──────────────────────────────────────────────
+    //  Caché (Flyweight)
+    // ──────────────────────────────────────────────
+
+    private static readonly _cache = new Map<unknown, Type>();
+
+    // ──────────────────────────────────────────────
+    //  Tipos predefinidos
+    // ──────────────────────────────────────────────
+
+    public static readonly String = Type._getOrCreate<string>('string', undefined, TypeCode.String, 'string');
+    public static readonly Number = Type._getOrCreate<number>('number', undefined, TypeCode.Number, 'number');
+    public static readonly Boolean = Type._getOrCreate<boolean>('boolean', undefined, TypeCode.Boolean, 'boolean');
+    public static readonly Symbol = Type._getOrCreate<symbol>('symbol', undefined, TypeCode.Symbol, 'symbol');
+    public static readonly BigInt = Type._getOrCreate<bigint>('bigint', undefined, TypeCode.BigInt, 'bigint');
+    public static readonly Null = Type._getOrCreate<null>('null', undefined, TypeCode.Null, 'null');
+    public static readonly Undefined = Type._getOrCreate<undefined>('undefined', undefined, TypeCode.Undefined, 'undefined');
+    public static readonly Object = Type._getOrCreate<object>(Object, Object, TypeCode.Object, 'Object');
+    public static readonly Function = Type._getOrCreate<Function>(Function, Function, TypeCode.Function, 'Function');
+    public static readonly Array = Type._getOrCreate<unknown[]>(Array, Array, TypeCode.Array, 'Array');
+
+    // ──────────────────────────────────────────────
+    //  Propiedades inmutables
+    // ──────────────────────────────────────────────
+
+    public readonly name: string;
+    public readonly constructorRef:
+        Constructor<T> | undefined;
+    public readonly typeCode: TypeCode;
+
+    private constructor(
+        name: string,
+        constructorRef: Constructor<T> | undefined,
+        typeCode: TypeCode,
+    ) {
+        this.name = name;
+        this.constructorRef = constructorRef;
+        this.typeCode = typeCode;
+    }
+
+    // ══════════════════════════════════════════════
+    //  ÚNICO PUNTO DE ENTRADA
+    // ══════════════════════════════════════════════
+
+    /**
+     * Obtiene el `Type` de cualquier valor, constructor o primitivo.
+     *
+     * Unifica `typeof()` y `.GetType()` de C# en un solo método.
+     *
+     * **Reglas de resolución:**
+     * 1. `null` / `undefined` → tipo nullish correspondiente
+     * 2. Primitivo (`number`, `string`, etc.) → tipo primitivo
+     * 3. Array → `Type.Array`
+     * 4. Función/Constructor → tipo del constructor (no "Function")
+     * 5. Objeto → tipo basado en su constructor
+     *
+     * @example
+     * ```ts
+     * Type.of(42)           // Type<number>   — primitivo
+     * Type.of('hello')      // Type<string>   — primitivo
+     * Type.of(new Date())   // Type<Date>     — desde instancia
+     * Type.of(Date)         // Type<Date>     — desde constructor
+     * Type.of(null)         // Type<null>
+     * Type.of([1, 2, 3])   // Type<Array>
+     * ```
+     */
+    public static of<U>(target: U | Constructor<U>): Type<U> {
+        // ── Nullish ──
+        if (target === null) return Type.Null as Type<U>;
+        if (target === undefined) return Type.Undefined as Type<U>;
+
+        const jsType = typeof target;
+
+        // ── Primitivos ──
+        if (jsType !== 'object' && jsType !== 'function') {
+            return this._getOrCreate<U>(jsType, undefined, jsType as TypeCode);
+        }
+
+        // ── Funciones y Constructores ──
+        if (jsType === 'function') {
+            return this._resolveFunction<U>(target as Function & Constructor<U>);
+        }
+
+        // ── Arrays ──
+        if (Array.isArray(target)) {
+            return Type.Array as Type<U>;
+        }
+
+        // ── Objetos ──
+        return this._resolveObject<U>(target as object);
+    }
+
+    // ──────────────────────────────────────────────
+    //  Resolvers privados (separan la lógica compleja)
+    // ──────────────────────────────────────────────
+
+    /**
+     * Resuelve funciones y constructores.
+     *
+     * Decisión clave: si la función tiene un `prototype` con
+     * miembros propios o empieza con `class`, es un constructor
+     * y devolvemos el tipo que construye. Si no, es una función.
+     */
+    private static _resolveFunction<U>(fn: Function & Constructor<U>): Type<U> {
+        const isConstructor = this._isConstructorLike(fn);
+
+        if (isConstructor) {
+            // Constructor → devuelve el tipo que construye
+            return this._getOrCreate<U>(
+                fn,                          // cacheamos por referencia al constructor
+                fn as Constructor<U>,
+                TypeCode.Object,
+                fn.name || 'AnonymousClass',
+            );
+        }
+
+        // Función pura → devuelve Type<Function>
+        return Type.Function as Type<U>;
+    }
+
+    /**
+     * Resuelve objetos por su cadena de prototipos.
+     */
+    private static _resolveObject<U>(obj: object): Type<U> {
+        const proto = Object.getPrototypeOf(obj) as { constructor?: Constructor<U> } | null;
+        const ctor = proto?.constructor as Constructor<U> | undefined;
+        const name = ctor?.name || 'Object';
+
+        if (!ctor || ctor === (Object as unknown)) {
+            return Type.Object as Type<U>;
+        }
+
+        return this._getOrCreate<U>(ctor, ctor, TypeCode.Object, name);
+    }
+
+    /**
+     * Heurística para distinguir constructores de funciones planas.
+     *
+     * Un "constructor" cumple al menos una de:
+     *  - Su `toString()` empieza con "class "
+     *  - Tiene propiedades propias en su prototype (más allá de constructor)
+     *  - Es un built-in conocido (Date, Map, Set, etc.)
+     */
+    private static _isConstructorLike(fn: Function): boolean {
+        // 1. Clase ES6 explícita
+        try {
+            if (fn.toString().startsWith('class ')) return true;
+        } catch {
+            // toString puede fallar en Proxy, etc.
+        }
+
+        // 2. Built-ins conocidos con prototype significativo
+        if (fn === Object || fn === Function || fn === Array) return true;
+
+        const proto = fn.prototype;
+        if (!proto || typeof proto !== 'object') return false;
+
+        // 3. Prototype con miembros propios (señal de constructor)
+        const ownKeys = Object.getOwnPropertyNames(proto);
+        return ownKeys.length > 1 || (ownKeys.length === 1 && ownKeys[0] !== 'constructor');
+    }
+
+    // ══════════════════════════════════════════════
+    //  PROPIEDADES COMPUTADAS
+    // ══════════════════════════════════════════════
+
+    public get isPrimitive(): boolean {
+        return (
+            this.typeCode === TypeCode.String ||
+            this.typeCode === TypeCode.Number ||
+            this.typeCode === TypeCode.Boolean ||
+            this.typeCode === TypeCode.Symbol ||
+            this.typeCode === TypeCode.BigInt
+        );
+    }
+
+    public get isNullish(): boolean {
+        return this.typeCode === TypeCode.Null || this.typeCode === TypeCode.Undefined;
+    }
+
+    public get isReferenceType(): boolean {
+        return !this.isPrimitive && !this.isNullish;
+    }
+
+    public get isArray(): boolean {
+        return this.typeCode === TypeCode.Array ||
+            this.constructorRef === (Array as unknown as Constructor<T>);
+    }
+
+    public get isFunction(): boolean {
+        return this.typeCode === TypeCode.Function;
+    }
+
+    public get isValueType(): boolean {
+        return this.isPrimitive;
+    }
+
+    public get isClass(): boolean {
+        if (!this.constructorRef) return false;
+        try {
+            return this.constructorRef.toString().startsWith('class ');
+        } catch {
+            return false;
+        }
+    }
+
+    public get fullName(): string {
+        if (this.isPrimitive || this.isNullish) {
+            return `System.${this.name.charAt(0).toUpperCase()}${this.name.slice(1)}`;
+        }
+        return this.name;
+    }
+
+    // ══════════════════════════════════════════════
+    //  JERARQUÍA
+    // ══════════════════════════════════════════════
+
+    public get baseType(): Type | undefined {
+        if (!this.constructorRef) return undefined;
+
+        const parentProto = Object.getPrototypeOf(this.constructorRef.prototype);
+        if (!parentProto || parentProto === Object.prototype) {
+            return this === Type.Object ? undefined : Type.Object;
+        }
+
+        const parentCtor = parentProto.constructor as Constructor;
+        return Type.of(parentCtor);
+    }
+
+    public getInheritanceChain(): ReadonlyArray<Type> {
+        const chain: Type[] = [this];
+        let current: Type | undefined = this.baseType;
+
+        while (current && !chain.includes(current)) {
+            chain.push(current);
+            current = current.baseType;
+        }
+
+        return Object.freeze(chain);
+    }
+
+    public isAssignableTo(target: Type): boolean {
+        if (this === target) return true;
+        if (!this.constructorRef || !target.constructorRef) return false;
+
+        let proto: object | null = this.constructorRef.prototype;
+        while (proto) {
+            if (proto.constructor === target.constructorRef) return true;
+            proto = Object.getPrototypeOf(proto) as object | null;
+        }
+        return false;
+    }
+
+    public isAssignableFrom(source: Type): boolean {
+        return source.isAssignableTo(this);
+    }
+
+    public isSubclassOf(parent: Type): boolean {
+        if (this === parent) return false;
+        return this.isAssignableTo(parent);
+    }
+
+
+    // ══════════════════════════════════════════════
+    //  REFLEXIÓN
+    // ══════════════════════════════════════════════
+
+    public getMethodNames(): ReadonlyArray<string> {
+        if (!this.constructorRef?.prototype) return Object.freeze([]);
+        return Object.freeze(
+            Object.getOwnPropertyNames(this.constructorRef.prototype)
+                  .filter(n => n !== 'constructor' &&
+                      typeof Object.getOwnPropertyDescriptor(
+                          this.constructorRef!.prototype, n
+                      )?.value === 'function'
+                  )
+        );
+    }
+
+    public getPropertyNames(): ReadonlyArray<string> {
+        if (!this.constructorRef?.prototype) return Object.freeze([]);
+        return Object.freeze(
+            Object.getOwnPropertyNames(this.constructorRef.prototype)
+                  .filter(n => n !== 'constructor' &&
+                      typeof Object.getOwnPropertyDescriptor(
+                          this.constructorRef!.prototype, n
+                      )?.value !== 'function'
+                  )
+        );
+    }
+
+    public getMemberNames(): ReadonlyArray<string> {
+        if (!this.constructorRef?.prototype) return Object.freeze([]);
+        return Object.freeze(
+            Object.getOwnPropertyNames(this.constructorRef.prototype)
+                  .filter(n => n !== 'constructor')
+        );
+    }
+
+    public hasMethod(name: string): boolean {
+        if (!this.constructorRef?.prototype) return false;
+        return typeof this.constructorRef.prototype[name] === 'function';
+    }
+
+    public hasProperty(name: string): boolean {
+        if (!this.constructorRef?.prototype) return false;
+        return name in this.constructorRef.prototype && !this.hasMethod(name);
+    }
+
+    public getStaticMemberNames(): ReadonlyArray<string> {
+        if (!this.constructorRef) return Object.freeze([]);
+        const skip = new Set(['prototype', 'length', 'name', 'caller', 'arguments']);
+        return Object.freeze(
+            Object.getOwnPropertyNames(this.constructorRef)
+                  .filter(n => !skip.has(n))
+        );
+    }
+
+
+    // ══════════════════════════════════════════════
+    //  SERIALIZACIÓN
+    // ══════════════════════════════════════════════
+
+    public toString(): string {
+        return `Type [${this.name}]`;
+    }
+
+
+    public [Symbol.toPrimitive](hint: string): string | number {
+
+        let hash = 0;
+        for (let i = 0; i < this.name.length; i++) {
+            hash = ((hash << 5) - hash + this.name.charCodeAt(i)) | 0;
+        }
+
+        return hint === 'number' ? hash : this.toString();
+    }
+
+    public get [Symbol.toStringTag](): string {
+        return `Type<${this.name}>`;
+    }
+
+    // ──────────────────────────────────────────────
+    //  FACTORY INTERNA
+    // ──────────────────────────────────────────────
+
+    private static _getOrCreate<V>(
+        key: unknown,
+        constructorRef: Constructor<V> | unknown,
+        typeCode: TypeCode,
+        customName?: string,
+    ): Type<V> {
+        const cached = this._cache.get(key);
+        if (cached) return cached as Type<V>;
+
+        const name = customName
+            ?? (typeof key === 'string' ? key : 'unknown');
+
+        const ref = typeof constructorRef === 'function'
+            ? constructorRef as Constructor<V>
+            : undefined;
+
+        const instance = new Type<V>(name, ref, typeCode);
+        this._cache.set(key, instance as Type);
+        return instance;
+    }
+}

package/src/types.ts

@@ -25,8 +25,4 @@ export type QuaternaryFunction<T1, T2, T3, T4, R> = (
     arg4: T4
 ) => R;
 
-export type Constructor<T = object, A extends any[] = any[]> =
-  new (...args: A) => T;
-
-export type AbstractConstructor<T = object, A extends any[] = any[]> =
-  abstract new (...args: A) => T;
+export type Constructor<T = unknown> = abstract new (...args: any[]) => T;

package/src/utilities.ts

@@ -134,56 +134,7 @@ export function deepEqual(a: any, b: any): boolean {
  * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').
  * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').
  */
-export function submitForm(
-    url: string,
-    data: Record<string, any>,
-    method: 'POST' | 'GET' = 'POST',
-    target?: '_blank' | '_self' | '_parent' | '_top'
-): void {
-
-    const form = document.createElement('form');
-    form.method = method.toUpperCase();
-    form.action = url;
-    form.style.display = 'none';
-
-    if (target) {
-        form.target = target;
-    }
-
-    /**
-     * Recursively appends inputs to the form, supporting nested keys and arrays.
-     * @param keyPrefix - Key path, e.g., 'user[name]' or 'tags[]'
-     * @param value - The value to append (can be nested)
-     */
-    const appendInputs = (keyPrefix: string, value: any) => {
-        if (Array.isArray(value)) {
-            value.forEach(val => {
-                appendInputs(`${keyPrefix}[]`, val);
-            });
-        } else if (typeof value === 'object' && value !== null) {
-            for (const subKey in value) {
-                if (value.hasOwnProperty(subKey)) {
-                    appendInputs(`${keyPrefix}[${subKey}]`, value[subKey]);
-                }
-            }
-        } else {
-            const input = document.createElement('input');
-            input.type = 'hidden';
-            input.name = keyPrefix;
-            input.value = String(value);
-            form.appendChild(input);
-        }
-    };
 
-    for (const key in data) {
-        if (data.hasOwnProperty(key)) {
-            appendInputs(key, data[key]);
-        }
-    }
-
-    document.body.appendChild(form);
-    form.submit();
-}
 
 /**
  * Compares two objects or arrays to check if they have the same immediate fields and values,
@@ -319,29 +270,7 @@ export function isEmptyOrWhitespace(value: any): boolean {
 }
 
 
-/**
- * Submits a form via AJAX and returns a Promise that resolves to the Response object.
- *
- * @param {HTMLFormElement | string} selectorOrElement - The form element or selector.
- * @return {Promise<Response>} A Promise that resolves to the Response object.
- * @throws {Error} If the element is invalid.
- */
-export async function ajaxSubmit(selectorOrElement: HTMLFormElement | string): Promise<Response> {
 
-    const form = typeof selectorOrElement === 'string'
-        ? document.querySelector(selectorOrElement)
-        : selectorOrElement;
-
-    if (!(form instanceof HTMLFormElement)) {
-        throw new Error("Invalid element.");
-    }
-
-    // Crear un objeto FormData a partir del formulario
-    return await fetch(form.action, {
-        method: form.method,
-        body: new FormData(form),
-    });
-}
 
 /**
  * Converts an object into an array of key-value pairs.
@@ -386,33 +315,6 @@ export function promisify<T>(thing: Resolvable<T>): Promise<T> {
 }
 
 
-export function ajaxSubmission(selectorOrElement: HTMLFormElement | string,
-                               onSuccess: Optional<Supplier<any>> = undefined,
-                               onFailure: Optional<Supplier<any>> = undefined): void {
-
-    const form = typeof selectorOrElement === 'string'
-        ? document.querySelector(selectorOrElement)
-        : selectorOrElement;
-
-    if (!(form instanceof HTMLFormElement)) {
-        return;
-    }
-
-    form.addEventListener('submit', async (event) => {
-        event.preventDefault();
-        let promise = ajaxSubmit(form);
-        if (promise) {
-            if (onSuccess)
-                promise = promise.then(onSuccess);
-            if (onFailure)
-                promise.catch(onFailure);
-        }
-
-    });
-
-
-}
-
 
 /**
  * Creates a deep clone of the given object.
@@ -447,77 +349,12 @@ export function deepClone<T>(obj: T): T {
  *
  * @param {any} value - The value to determine the type of.
  * @return {Type} - The type of the given value.
+ * @deprecated use Type.of(...)
  */
 export function getType(value: any): Type {
 
-    return value === null ? Type.Null : Type[typeof value as keyof typeof Type];
-}
-
-export function formToObject(form: HTMLFormElement): Record<string, FormDataEntryValue | FormDataEntryValue[]> {
-    const fd = new FormData(form);
-    const out: Record<string, FormDataEntryValue | FormDataEntryValue[]> = {};
-
-    for (const [key, value] of fd.entries()) {
-        if (key in out) {
-            const current = out[key];
-            if (Array.isArray(current)) {
-                current.push(value);
-            } else {
-                out[key] = [current, value];
-            }
-        } else {
-            out[key] = value;
-        }
-    }
-
-    return out;
+    return Type.of(value);
 }
 
-/**
- * Converts an object to `FormData` format recursively.
- *
- * @param {Record<string, any>} data - The object data to convert.
- * @param {FormData} formData - The `FormData` instance to append data to.
- * @param {string} parentKey - The parent key to append to child keys in the `FormData`.
- * @returns {FormData} - The `FormData` instance with the converted data.
- */
-function _objectToFormData(data: Record<string, any>, formData: FormData, parentKey: string = ''): FormData {
-
-    for (const key in data) {
-        if (data.hasOwnProperty(key)) {
-            const value = data[key];
-
-            if (value instanceof Date) {
-                formData.append(parentKey ? `${parentKey}[${key}]` : key, value.toISOString());
-            } else if (value instanceof File) {
-                formData.append(parentKey ? `${parentKey}[${key}]` : key, value);
-            } else if (typeof value === 'object' && !Array.isArray(value)) {
-                _objectToFormData(value, formData, parentKey ? `${parentKey}[${key}]` : key);
-            } else if (Array.isArray(value)) {
-                value.forEach((item, index) => {
-                    const arrayKey = `${parentKey ? `${parentKey}[${key}]` : key}[${index}]`;
-                    if (typeof item === 'object' && !Array.isArray(item)) {
-                        _objectToFormData(item, formData, arrayKey);
-                    } else {
-                        formData.append(arrayKey, item);
-                    }
-                });
-            } else {
-                formData.append(parentKey ? `${parentKey}[${key}]` : key, value);
-            }
-        }
-    }
 
-    return formData;
-}
 
-/**
- * Converts an object into FormData.
- *
- * @param {Record<string, any>} data - The object to be converted into FormData.
- * @return {FormData} - The FormData object representing the converted data.
- */
-export function objectToFormData(data: Record<string, any>): FormData {
-    let formData = new FormData();
-    return _objectToFormData(data, formData);
-}