@duplojs/utils 1.1.15 → 1.2.16

package/dist/date/operators/subtractWeeks.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var constants = require('../constants.cjs');
+var toNative = require('../toNative.cjs');
+
+function subtractWeeks(...args) {
+    if (args.length === 1) {
+        const [week] = args;
+        return (input) => subtractWeeks(input, week);
+    }
+    const [input, week] = args;
+    const date = toNative.toNative(input);
+    const absoluteWeek = Math.abs(week);
+    date.setTime(date.getTime() - (absoluteWeek * constants.millisecondInOneWeek));
+    const timestamp = date.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+exports.subtractWeeks = subtractWeeks;

package/dist/date/operators/subtractWeeks.d.ts

@@ -0,0 +1,4 @@
+import type { TheDate } from "../types";
+import type { PositiveNumber } from "../../number/types";
+export declare function subtractWeeks<GenericInput extends TheDate, GenericWeek extends number>(week: PositiveNumber<GenericWeek>): (input: GenericInput) => TheDate;
+export declare function subtractWeeks<GenericInput extends TheDate, GenericWeek extends number>(input: GenericInput, week: PositiveNumber<GenericWeek>): TheDate;

package/dist/date/operators/subtractWeeks.mjs

@@ -0,0 +1,18 @@
+import { millisecondInOneWeek } from '../constants.mjs';
+import { toNative } from '../toNative.mjs';
+
+function subtractWeeks(...args) {
+    if (args.length === 1) {
+        const [week] = args;
+        return (input) => subtractWeeks(input, week);
+    }
+    const [input, week] = args;
+    const date = toNative(input);
+    const absoluteWeek = Math.abs(week);
+    date.setTime(date.getTime() - (absoluteWeek * millisecondInOneWeek));
+    const timestamp = date.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+export { subtractWeeks };

package/dist/date/operators/subtractYears.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var toNative = require('../toNative.cjs');
+
+function subtractYears(...args) {
+    if (args.length === 1) {
+        const [year] = args;
+        return (input) => subtractYears(input, year);
+    }
+    const [input, year] = args;
+    const date = toNative.toNative(input);
+    const absoluteYear = Math.abs(year);
+    date.setUTCFullYear(date.getUTCFullYear() - absoluteYear);
+    const timestamp = date.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+exports.subtractYears = subtractYears;

package/dist/date/operators/subtractYears.d.ts

@@ -0,0 +1,4 @@
+import type { TheDate } from "../types";
+import type { PositiveNumber } from "../../number/types";
+export declare function subtractYears<GenericInput extends TheDate, GenericYear extends number>(year: PositiveNumber<GenericYear>): (input: GenericInput) => TheDate;
+export declare function subtractYears<GenericInput extends TheDate, GenericYear extends number>(input: GenericInput, year: PositiveNumber<GenericYear>): TheDate;

package/dist/date/operators/subtractYears.mjs

@@ -0,0 +1,17 @@
+import { toNative } from '../toNative.mjs';
+
+function subtractYears(...args) {
+    if (args.length === 1) {
+        const [year] = args;
+        return (input) => subtractYears(input, year);
+    }
+    const [input, year] = args;
+    const date = toNative(input);
+    const absoluteYear = Math.abs(year);
+    date.setUTCFullYear(date.getUTCFullYear() - absoluteYear);
+    const timestamp = date.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+export { subtractYears };

package/dist/date/round.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+var toNative = require('./toNative.cjs');
+
+const stepMapper = {
+    second: (date) => date.setUTCMilliseconds(0),
+    minute: (date) => date.setUTCSeconds(0, 0),
+    hour: (date) => date.setUTCMinutes(0, 0, 0),
+    day: (date) => date.setUTCHours(0, 0, 0, 0),
+    month: (date) => new Date(date.setUTCDate(1)).setUTCHours(0, 0, 0, 0),
+    year: (date) => {
+        date.setUTCMonth(0, 1);
+        return date.setUTCHours(0, 0, 0, 0);
+    },
+};
+function round(input, unit = "day") {
+    const date = toNative.toNative(input);
+    const timestamp = stepMapper[unit](date);
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+exports.round = round;

package/dist/date/round.d.ts

@@ -0,0 +1,3 @@
+import type { TheDate, Unit } from "./types";
+export type RoundUnit = Exclude<Unit, "millisecond">;
+export declare function round(input: TheDate, unit?: RoundUnit): `date${number}-` | `date${number}+`;

package/dist/date/round.mjs

@@ -0,0 +1,21 @@
+import { toNative } from './toNative.mjs';
+
+const stepMapper = {
+    second: (date) => date.setUTCMilliseconds(0),
+    minute: (date) => date.setUTCSeconds(0, 0),
+    hour: (date) => date.setUTCMinutes(0, 0, 0),
+    day: (date) => date.setUTCHours(0, 0, 0, 0),
+    month: (date) => new Date(date.setUTCDate(1)).setUTCHours(0, 0, 0, 0),
+    year: (date) => {
+        date.setUTCMonth(0, 1);
+        return date.setUTCHours(0, 0, 0, 0);
+    },
+};
+function round(input, unit = "day") {
+    const date = toNative(input);
+    const timestamp = stepMapper[unit](date);
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+export { round };

package/dist/date/toISOString.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+var toNative = require('./toNative.cjs');
+
+function toISOString(input) {
+    const date = toNative.toNative(input);
+    return date.toISOString();
+}
+
+exports.toISOString = toISOString;

package/dist/date/toISOString.d.ts

@@ -0,0 +1,2 @@
+import type { TheDate } from "./types";
+export declare function toISOString<GenericInput extends TheDate>(input: GenericInput): string;

package/dist/date/toISOString.mjs

@@ -0,0 +1,8 @@
+import { toNative } from './toNative.mjs';
+
+function toISOString(input) {
+    const date = toNative(input);
+    return date.toISOString();
+}
+
+export { toISOString };

package/dist/date/toNative.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+var toTimestamp = require('./toTimestamp.cjs');
+
+function toNative(input) {
+    const timestamp = toTimestamp.toTimestamp(input);
+    return new Date(timestamp);
+}
+
+exports.toNative = toNative;

package/dist/date/toNative.d.ts

@@ -0,0 +1,2 @@
+import type { TheDate } from "./types";
+export declare function toNative<GenericInput extends TheDate>(input: GenericInput): Date;

package/dist/date/toNative.mjs

@@ -0,0 +1,8 @@
+import { toTimestamp } from './toTimestamp.mjs';
+
+function toNative(input) {
+    const timestamp = toTimestamp(input);
+    return new Date(timestamp);
+}
+
+export { toNative };

package/dist/date/toTimestamp.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+var kind = require('../common/kind.cjs');
+require('../common/stringToBytes.cjs');
+require('../common/stringToMillisecond.cjs');
+require('../common/globalStore.cjs');
+require('../common/builder.cjs');
+require('../either/bool/falsy.cjs');
+require('../either/bool/truthy.cjs');
+require('../either/bool/base.cjs');
+require('../either/left/create.cjs');
+require('../either/left/error.cjs');
+require('../either/left/fail.cjs');
+require('../either/kind.cjs');
+require('../either/right/success.cjs');
+require('../either/right/create.cjs');
+require('../either/right/ok.cjs');
+require('../either/future/success.cjs');
+require('../either/future/error.cjs');
+require('../either/future/base.cjs');
+require('../either/nullable/empty.cjs');
+require('../either/nullable/filled.cjs');
+require('../either/nullable/base.cjs');
+require('../either/nullish/empty.cjs');
+require('../either/nullish/filled.cjs');
+require('../either/nullish/base.cjs');
+require('../either/optional/empty.cjs');
+require('../either/optional/filled.cjs');
+require('../either/optional/base.cjs');
+require('../common/override.cjs');
+var errorKindNamespace = require('../common/errorKindNamespace.cjs');
+var constants = require('./constants.cjs');
+var isSafeTimestamp = require('./isSafeTimestamp.cjs');
+
+class InvalidTheDateError extends kind.kindHeritage("invalid-the-Date-error", errorKindNamespace.createErrorKind("invalid-the-Date-error"), Error) {
+    theDate;
+    constructor(theDate) {
+        super({}, ["TheDate is invalid."]);
+        this.theDate = theDate;
+    }
+}
+function toTimestamp(input) {
+    const match = input.match(constants.theDateRegex);
+    if (!match) {
+        throw new InvalidTheDateError(input);
+    }
+    const { value, sign } = match.groups;
+    const timestamp = Number(sign === "-"
+        ? `-${value}`
+        : value);
+    if (!isSafeTimestamp.isSafeTimestamp(timestamp)) {
+        throw new InvalidTheDateError(input);
+    }
+    return timestamp;
+}
+
+exports.InvalidTheDateError = InvalidTheDateError;
+exports.toTimestamp = toTimestamp;

package/dist/date/toTimestamp.d.ts

@@ -0,0 +1,10 @@
+import type { TheDate } from "./types";
+declare const InvalidTheDateError_base: new (params: {
+    "@DuplojsUtilsError/invalid-the-Date-error"?: unknown;
+}, parentParams: [message?: string | undefined, options?: ErrorOptions | undefined]) => Error & import("../common").Kind<import("../common").KindDefinition<"invalid-the-Date-error", unknown>, unknown> & import("../common").Kind<import("../common").KindDefinition<"@DuplojsUtilsError/invalid-the-Date-error", unknown>, unknown>;
+export declare class InvalidTheDateError extends InvalidTheDateError_base {
+    theDate: TheDate;
+    constructor(theDate: TheDate);
+}
+export declare function toTimestamp<GenericInput extends TheDate>(input: GenericInput): number;
+export {};

package/dist/date/toTimestamp.mjs

@@ -0,0 +1,55 @@
+import { kindHeritage } from '../common/kind.mjs';
+import '../common/stringToBytes.mjs';
+import '../common/stringToMillisecond.mjs';
+import '../common/globalStore.mjs';
+import '../common/builder.mjs';
+import '../either/bool/falsy.mjs';
+import '../either/bool/truthy.mjs';
+import '../either/bool/base.mjs';
+import '../either/left/create.mjs';
+import '../either/left/error.mjs';
+import '../either/left/fail.mjs';
+import '../either/kind.mjs';
+import '../either/right/success.mjs';
+import '../either/right/create.mjs';
+import '../either/right/ok.mjs';
+import '../either/future/success.mjs';
+import '../either/future/error.mjs';
+import '../either/future/base.mjs';
+import '../either/nullable/empty.mjs';
+import '../either/nullable/filled.mjs';
+import '../either/nullable/base.mjs';
+import '../either/nullish/empty.mjs';
+import '../either/nullish/filled.mjs';
+import '../either/nullish/base.mjs';
+import '../either/optional/empty.mjs';
+import '../either/optional/filled.mjs';
+import '../either/optional/base.mjs';
+import '../common/override.mjs';
+import { createErrorKind } from '../common/errorKindNamespace.mjs';
+import { theDateRegex } from './constants.mjs';
+import { isSafeTimestamp } from './isSafeTimestamp.mjs';
+
+class InvalidTheDateError extends kindHeritage("invalid-the-Date-error", createErrorKind("invalid-the-Date-error"), Error) {
+    theDate;
+    constructor(theDate) {
+        super({}, ["TheDate is invalid."]);
+        this.theDate = theDate;
+    }
+}
+function toTimestamp(input) {
+    const match = input.match(theDateRegex);
+    if (!match) {
+        throw new InvalidTheDateError(input);
+    }
+    const { value, sign } = match.groups;
+    const timestamp = Number(sign === "-"
+        ? `-${value}`
+        : value);
+    if (!isSafeTimestamp(timestamp)) {
+        throw new InvalidTheDateError(input);
+    }
+    return timestamp;
+}
+
+export { InvalidTheDateError, toTimestamp };

package/dist/date/today.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+function today() {
+    const timestamp = new Date().setUTCHours(0, 0, 0, 0);
+    return `date${timestamp}+`;
+}
+
+exports.today = today;

package/dist/date/today.d.ts

@@ -0,0 +1 @@
+export declare function today(): `date${number}+`;

package/dist/date/today.mjs

@@ -0,0 +1,6 @@
+function today() {
+    const timestamp = new Date().setUTCHours(0, 0, 0, 0);
+    return `date${timestamp}+`;
+}
+
+export { today };

package/dist/date/tomorrow.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+var constants = require('./constants.cjs');
+
+function tomorrow() {
+    const timestamp = Date.now() + constants.millisecondsInOneDay;
+    return `date${timestamp}+`;
+}
+
+exports.tomorrow = tomorrow;

package/dist/date/tomorrow.d.ts

@@ -0,0 +1 @@
+export declare function tomorrow(): `date${number}+`;

package/dist/date/tomorrow.mjs

@@ -0,0 +1,8 @@
+import { millisecondsInOneDay } from './constants.mjs';
+
+function tomorrow() {
+    const timestamp = Date.now() + millisecondsInOneDay;
+    return `date${timestamp}+`;
+}
+
+export { tomorrow };

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

@@ -0,0 +1,6 @@
+export * from "./theDate";
+export * from "./isLeapYear";
+export * from "./timezone";
+export * from "./unit";
+export * from "./month";
+export * from "./time";

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

@@ -0,0 +1,8 @@
+import { type Digit } from "../../string";
+type TenEven = "" | "2" | "4" | "6" | "8";
+type OddTen = "1" | "3" | "5" | "7" | "9";
+type MultipleOf4 = `${TenEven}${"0" | "4" | "8"}` | `${OddTen}${"2" | "6"}`;
+type MultipleOf100 = `${Exclude<Digit, "0">}00`;
+type MultipleOf400 = `${Exclude<MultipleOf4, "0">}00`;
+export type IsLeapYear<GenericYear extends `${number}`> = GenericYear extends `${number | ""}${MultipleOf4}` ? GenericYear extends `${number | ""}${MultipleOf100}` ? GenericYear extends `${number | ""}${MultipleOf400}` ? true : false : true : false;
+export {};

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

@@ -0,0 +1,9 @@
+import { type Digit } from "../../string";
+export type Month = `0${Exclude<Digit, "0">}` | "10" | "11" | "12";
+export type Day29 = Exclude<`${"0" | "1" | "2"}${Digit}`, "00">;
+export type Day30 = Day29 | "30";
+export type Day31 = Day30 | "31";
+export type MonthWithDay29 = "02";
+export type MonthWithDay30 = "04" | "06" | "09" | "11";
+export type MonthWithDay31 = "01" | "03" | "05" | "07" | "08" | "10" | "12";
+export type MonthWithDay = Month extends infer InferredMonth ? InferredMonth extends MonthWithDay29 ? `${InferredMonth}-${Day29}` : InferredMonth extends MonthWithDay30 ? `${InferredMonth}-${Day30}` : InferredMonth extends MonthWithDay31 ? `${InferredMonth}-${Day31}` : never : never;

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

@@ -0,0 +1 @@
+export type TheDate = `date${number}${"-" | "+"}`;

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

@@ -0,0 +1,5 @@
+import { type Digit } from "../../string";
+export type Hour = `${"0" | "1"}${Digit}` | "20" | "21" | "22" | "23";
+export type Minute = `${"0" | "1" | "2" | "3" | "4" | "5"}${Digit}`;
+export type Second = `${"0" | "1" | "2" | "3" | "4" | "5"}${Digit}`;
+export type Millisecond = `${Digit}${Digit}${Digit}`;