@duplojs/utils 1.4.57 → 1.4.59

package/dist/common/toJSON.cjs

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toJSON/index.md}
- */
-function toJSON(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (typeof value === "object"
-        && "toJSON" in value
-        && typeof value.toJSON === "function") {
-        return value.toJSON();
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object
-            .entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toJSON(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map(toJSON);
-    }
-    else {
-        return undefined;
-    }
-}
-
-exports.toJSON = toJSON;

package/dist/common/toJSON.d.ts

@@ -1,44 +0,0 @@
-import { type AnyFunction } from "./types/anyFunction";
-import { type IsEqual } from "./types/isEqual";
-export type ToJSON<GenericValue extends unknown> = GenericValue extends number | string | null | undefined ? GenericValue : GenericValue extends ({
-    toJSON: AnyFunction;
-}) ? ReturnType<GenericValue["toJSON"]> : GenericValue extends [infer InferredFirst, ...infer InferredRest] ? [
-    ToJSON<InferredFirst>,
-    ...(ToJSON<InferredRest> extends infer InferredSubRest extends any[] ? IsEqual<InferredSubRest, never[]> extends false ? InferredSubRest : [] : [])
-] : GenericValue extends any[] ? ToJSON<GenericValue[number]>[] : GenericValue extends object ? {
-    [Prop in keyof GenericValue as GenericValue[Prop] extends AnyFunction ? never : Prop]: ToJSON<GenericValue[Prop]>;
-} : undefined;
-/**
- * The toJSON() function prepares a value for JSON serialization while respecting objects' toJSON methods, traversing arrays/tuples, and excluding functions.
- * 
- * Signature: `toJSON(value)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = toJSON({
- * 	prop: 1,
- * 	prop1: "test",
- * 	prop2: new Date("2025-08-19T15:14:19.467Z"),
- * 	prop3: null,
- * 	prop4: undefined,
- * 	prop5: {
- * 		subProp: [{ prop1: 1 }],
- * 		subProp1: {
- * 			toJSON() {
- * 				return "test";
- * 			},
- * 		},
- * 	},
- * 	method() {
- * 		return void 0;
- * 	},
- * });
- * 
- * // type: { prop: number; prop1: string; prop2: string; prop3: null; prop4: undefined; prop5: { subProp: { prop1: number; }[]; subProp1: "test"; }; }
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/toJSON
- * 
- */
-export declare function toJSON<GenericValue extends unknown>(value: GenericValue): ToJSON<GenericValue>;

package/dist/common/toJSON.mjs

@@ -1,35 +0,0 @@
-/**
- * {@include common/toJSON/index.md}
- */
-function toJSON(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (typeof value === "object"
-        && "toJSON" in value
-        && typeof value.toJSON === "function") {
-        return value.toJSON();
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object
-            .entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toJSON(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map(toJSON);
-    }
-    else {
-        return undefined;
-    }
-}
-
-export { toJSON };

package/dist/common/toString.cjs

@@ -1,10 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toString/index.md}
- */
-function toString(value) {
-    return `${value}`;
-}
-
-exports.toString = toString;

package/dist/common/toString.d.ts

@@ -1,17 +0,0 @@
-/**
- * The toString() function converts a literal (number, string, bigint, boolean, null, undefined) into a typed template string.
- * 
- * Signature: `toString(value)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = toString(42n);
- * 
- * // type: "42"
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/toString
- * 
- */
-export declare function toString<GenericValue extends number | string | bigint | boolean | null | undefined>(value: GenericValue): `${GenericValue}`;

package/dist/common/toString.mjs

@@ -1,8 +0,0 @@
-/**
- * {@include common/toString/index.md}
- */
-function toString(value) {
-    return `${value}`;
-}
-
-export { toString };

package/dist/common/toTransform.cjs

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toTransform/index.md}
- */
-function toTransform(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (value
-        && typeof value === "object"
-        && "toTransform" in value
-        && typeof value.toTransform === "function") {
-        return (value.toTransform());
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object.entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toTransform(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map((subValue) => toTransform(subValue));
-    }
-    else {
-        return value;
-    }
-}
-
-exports.toTransform = toTransform;

package/dist/common/toTransform.d.ts

@@ -1,50 +0,0 @@
-import { type AnyFunction } from "./types/anyFunction";
-import { type IsEqual } from "./types/isEqual";
-export type ToTransform<GenericValue extends unknown> = GenericValue extends number | string | null | undefined ? GenericValue : GenericValue extends ({
-    toTransform: AnyFunction;
-}) ? ReturnType<GenericValue["toTransform"]> : GenericValue extends [infer InferredFirst, ...infer InferredRest] ? [
-    ToTransform<InferredFirst>,
-    ...(ToTransform<InferredRest> extends infer InferredSubRest extends any[] ? IsEqual<InferredSubRest, never[]> extends false ? InferredSubRest : [] : [])
-] : GenericValue extends any[] ? ToTransform<GenericValue[number]>[] : GenericValue extends Record<number, unknown> ? {
-    [Prop in keyof GenericValue]: ToTransform<GenericValue[Prop]>;
-} : GenericValue;
-/**
- * The toTransform() function recursively applies objects' toTransform methods and traverses arrays/tuples to produce a value ready to be transported (DTO).
- * 
- * Signature: `toTransform(value)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * class Money {
- * 	public constructor(
- * 		public amount: number,
- * 		public currency: string,
- * 	) {}
- * 
- * 	public toTransform() {
- * 		return {
- * 			amount: this.amount,
- * 			currency: this.currency,
- * 		};
- * 	}
- * }
- * 
- * const input = {
- * 	id: "INV-1",
- * 	total: new Money(99, "EUR"),
- * 	lines: [
- * 		new Money(49.5, "EUR"),
- * 		new Money(49.5, "EUR"),
- * 	],
- * };
- * 
- * const result = toTransform(input);
- * 
- * // type: { id: string; total: { amount: number; currency: string; }; lines: { amount: number; currency: string; }[]; }
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/toTransform
- * 
- */
-export declare function toTransform<GenericValue extends unknown>(value: GenericValue): ToTransform<GenericValue>;

package/dist/common/toTransform.mjs

@@ -1,35 +0,0 @@
-/**
- * {@include common/toTransform/index.md}
- */
-function toTransform(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (value
-        && typeof value === "object"
-        && "toTransform" in value
-        && typeof value.toTransform === "function") {
-        return (value.toTransform());
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object.entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toTransform(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map((subValue) => toTransform(subValue));
-    }
-    else {
-        return value;
-    }
-}
-
-export { toTransform };

package/dist/date/createTheDate.cjs

@@ -1,13 +0,0 @@
-'use strict';
-
-var makeSafeTimestamp = require('./makeSafeTimestamp.cjs');
-
-/**
- * {@include date/createTheDate/index.md}
- */
-function createTheDate(timestamp) {
-    const safeTimestamp = makeSafeTimestamp.makeSafeTimestamp(timestamp);
-    return `date${Math.abs(safeTimestamp)}${safeTimestamp < 0 ? "-" : "+"}`;
-}
-
-exports.createTheDate = createTheDate;

package/dist/date/createTheDate.d.ts

@@ -1,28 +0,0 @@
-import { type TheDate } from "./types";
-/**
- * Creates a TheDate from a timestamp in milliseconds.
- * 
- * Signature: `createTheDate(input)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = D.createTheDate(1_700_000_000_000);
- * // result: "date1700000000000+"
- * 
- * const result2 = D.createTheDate(-1_700_000_000_000);
- * // result2: "date1700000000000-"
- * 
- * const result3 = D.createTheDate(8_640_000_000_000_500);
- * // result3: "date8640000000000000+"
- * ```
- * 
- * @remarks
- * - The input is rounded and clamped to the supported timestamp range.
- * 
- * @see https://utils.duplojs.dev/en/v1/api/date/createTheDate
- * 
- * @namespace D
- * 
- */
-export declare function createTheDate(timestamp: number): TheDate;

package/dist/date/createTheDate.mjs

@@ -1,11 +0,0 @@
-import { makeSafeTimestamp } from './makeSafeTimestamp.mjs';
-
-/**
- * {@include date/createTheDate/index.md}
- */
-function createTheDate(timestamp) {
-    const safeTimestamp = makeSafeTimestamp(timestamp);
-    return `date${Math.abs(safeTimestamp)}${safeTimestamp < 0 ? "-" : "+"}`;
-}
-
-export { createTheDate };

package/dist/date/createTheTime.cjs

@@ -1,13 +0,0 @@
-'use strict';
-
-var makeSafeTimeValue = require('./makeSafeTimeValue.cjs');
-
-/**
- * {@include date/createTheTime/index.md}
- */
-function createTheTime(timestamp) {
-    const safeTimestamp = makeSafeTimeValue.makeSafeTimeValue(timestamp);
-    return `time${Math.abs(safeTimestamp)}${safeTimestamp < 0 ? "-" : "+"}`;
-}
-
-exports.createTheTime = createTheTime;

package/dist/date/createTheTime.d.ts

@@ -1,25 +0,0 @@
-import { type TheTime } from "./types";
-/**
- * Creates a TheTime from a time value in milliseconds.
- * 
- * Signature: `createTheTime(input)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = D.createTheTime(90_000);
- * // result: "time90000+"
- * 
- * const result2 = D.createTheTime(-90_000);
- * // result2: "time90000-"
- * ```
- * 
- * @remarks
- * - The input is rounded and clamped to the supported time range.
- * 
- * @see https://utils.duplojs.dev/en/v1/api/date/createTheTime
- * 
- * @namespace D
- * 
- */
-export declare function createTheTime(timestamp: number): TheTime;

package/dist/date/createTheTime.mjs

@@ -1,11 +0,0 @@
-import { makeSafeTimeValue } from './makeSafeTimeValue.mjs';
-
-/**
- * {@include date/createTheTime/index.md}
- */
-function createTheTime(timestamp) {
-    const safeTimestamp = makeSafeTimeValue(timestamp);
-    return `time${Math.abs(safeTimestamp)}${safeTimestamp < 0 ? "-" : "+"}`;
-}
-
-export { createTheTime };

package/dist/date/types/theDate.d.ts

@@ -1,11 +0,0 @@
-/**
- * Represents a TheDate string: a UTC timestamp encoded with a sign.
- * It solves common date issues across languages and HTTP by using a single transportable format, independent of local timezone quirks.
- * When you need local time (e.g., Brazil), you convert from the UTC timestamp with getters and a timezone, keeping storage robust and consistent.
- * 
- * @see https://utils.duplojs.dev/en/v1/api/date/theDate
- * 
- * @namespace D
- * 
- */
-export type TheDate = `date${number}${"-" | "+"}`;

package/dist/date/types/theTime.d.ts

@@ -1,10 +0,0 @@
-/**
- * Represents a TheTime string: a constrained number stored as milliseconds with a sign.
- * It gives a single, consistent format for time values so 10 seconds, 3 days, or 1 hour are all just the same unit, making time manipulation predictable.
- * 
- * @see https://utils.duplojs.dev/en/v1/api/date/theTime
- * 
- * @namespace D
- * 
- */
-export type TheTime = `time${number}${"+" | "-"}`;