@duplojs/utils 1.1.16 → 1.2.17

package/dist/dataParser/parsers/transform.mjs

@@ -1,10 +1,11 @@
 import { dataParserInit, SymbolDataParserError } from '../base.mjs';
 import { SymbolDataParserErrorPromiseIssue } from '../error.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { createOverride } from '../../common/override.mjs';
 
 const transformKind = createDataParserKind("transform");
 function transform(inner, theFunction, definition) {
-    return dataParserInit(transformKind, {
+    const self = dataParserInit(transformKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
@@ -35,6 +36,8 @@ function transform(inner, theFunction, definition) {
             return result;
         },
     });
+    return transform.overrideHandler.apply(self);
 }
+transform.overrideHandler = createOverride("@duplojs/utils/data-parser/transform");
 
 export { transform, transformKind };

package/dist/dataParser/parsers/tuple.cjs

@@ -3,10 +3,11 @@
 var base = require('../base.cjs');
 var error = require('../error.cjs');
 var kind = require('../kind.cjs');
+var override = require('../../common/override.cjs');
 
 const tupleKind = kind.createDataParserKind("tuple");
 function tuple(shape, definition) {
-    return base.dataParserInit(tupleKind, {
+    const self = base.dataParserInit(tupleKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
@@ -77,7 +78,9 @@ function tuple(shape, definition) {
             return output;
         },
     });
+    return tuple.overrideHandler.apply(self);
 }
+tuple.overrideHandler = override.createOverride("@duplojs/utils/data-parser/tuple");
 
 exports.tuple = tuple;
 exports.tupleKind = tupleKind;

package/dist/dataParser/parsers/tuple.d.ts

@@ -40,4 +40,7 @@ export interface DataParserTuple<GenericDefinition extends DataParserDefinitionT
 export declare function tuple<GenericShape extends TupleShape, const GenericDefinition extends Partial<Omit<DataParserDefinitionTuple, "shape">> = never>(shape: GenericShape, definition?: GenericDefinition): DataParserTuple<MergeDefinition<DataParserDefinitionTuple, NeverCoalescing<GenericDefinition, {}> & {
     shape: GenericShape;
 }>>;
+export declare namespace tuple {
+    var overrideHandler: import("../../common").OverrideHandler<DataParserTuple<DataParserDefinitionTuple>>;
+}
 export {};

package/dist/dataParser/parsers/tuple.mjs

@@ -1,10 +1,11 @@
 import { dataParserInit, SymbolDataParserError } from '../base.mjs';
 import { SymbolDataParserErrorIssue, setErrorPath, popErrorPath } from '../error.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { createOverride } from '../../common/override.mjs';
 
 const tupleKind = createDataParserKind("tuple");
 function tuple(shape, definition) {
-    return dataParserInit(tupleKind, {
+    const self = dataParserInit(tupleKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
@@ -75,6 +76,8 @@ function tuple(shape, definition) {
             return output;
         },
     });
+    return tuple.overrideHandler.apply(self);
 }
+tuple.overrideHandler = createOverride("@duplojs/utils/data-parser/tuple");
 
 export { tuple, tupleKind };

package/dist/dataParser/parsers/union.cjs

@@ -3,10 +3,11 @@
 var base = require('../base.cjs');
 var error = require('../error.cjs');
 var kind = require('../kind.cjs');
+var override = require('../../common/override.cjs');
 
 const unionKind = kind.createDataParserKind("union");
 function union(options, definition) {
-    return base.dataParserInit(unionKind, {
+    const self = base.dataParserInit(unionKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
@@ -32,7 +33,9 @@ function union(options, definition) {
             return error.SymbolDataParserErrorIssue;
         },
     });
+    return union.overrideHandler.apply(self);
 }
+union.overrideHandler = override.createOverride("@duplojs/utils/data-parser/union");
 
 exports.union = union;
 exports.unionKind = unionKind;

package/dist/dataParser/parsers/union.d.ts

@@ -24,4 +24,7 @@ export interface DataParserUnion<GenericDefinition extends DataParserDefinitionU
 export declare function union<GenericOptions extends UnionOptions, const GenericDefinition extends Partial<Omit<DataParserDefinitionUnion, "options">> = never>(options: GenericOptions, definition?: GenericDefinition): DataParserUnion<MergeDefinition<DataParserDefinitionUnion, NeverCoalescing<GenericDefinition, {}> & {
     options: GenericOptions;
 }>>;
+export declare namespace union {
+    var overrideHandler: import("../../common").OverrideHandler<DataParserUnion<DataParserDefinitionUnion>>;
+}
 export {};

package/dist/dataParser/parsers/union.mjs

@@ -1,10 +1,11 @@
 import { dataParserInit, SymbolDataParserError } from '../base.mjs';
 import { SymbolDataParserErrorIssue } from '../error.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { createOverride } from '../../common/override.mjs';
 
 const unionKind = createDataParserKind("union");
 function union(options, definition) {
-    return dataParserInit(unionKind, {
+    const self = dataParserInit(unionKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
@@ -30,6 +31,8 @@ function union(options, definition) {
             return SymbolDataParserErrorIssue;
         },
     });
+    return union.overrideHandler.apply(self);
 }
+union.overrideHandler = createOverride("@duplojs/utils/data-parser/union");
 
 export { union, unionKind };

package/dist/dataParser/parsers/unknown.cjs

@@ -2,16 +2,19 @@
 
 var base = require('../base.cjs');
 var kind = require('../kind.cjs');
+var override = require('../../common/override.cjs');
 
 const unknownKind = kind.createDataParserKind("unknown");
 function unknown(definition) {
-    return base.dataParserInit(unknownKind, {
+    const self = base.dataParserInit(unknownKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
         },
     }, (data) => data);
+    return unknown.overrideHandler.apply(self);
 }
+unknown.overrideHandler = override.createOverride("@duplojs/utils/data-parser/unknown");
 
 exports.unknown = unknown;
 exports.unknownKind = unknownKind;

package/dist/dataParser/parsers/unknown.d.ts

@@ -20,4 +20,7 @@ export interface DataParserUnknown<GenericDefinition extends DataParserDefinitio
     ], GenericChecker>): DataParserUnknown<AddCheckersToDefinition<GenericDefinition, GenericChecker>>;
 }
 export declare function unknown<const GenericDefinition extends Partial<DataParserDefinitionUnknown> = never>(definition?: GenericDefinition): DataParserUnknown<MergeDefinition<DataParserDefinitionUnknown, NeverCoalescing<GenericDefinition, {}>>>;
+export declare namespace unknown {
+    var overrideHandler: import("../../common").OverrideHandler<DataParserUnknown<DataParserDefinitionUnknown>>;
+}
 export {};

package/dist/dataParser/parsers/unknown.mjs

@@ -1,14 +1,17 @@
 import { dataParserInit } from '../base.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { createOverride } from '../../common/override.mjs';
 
 const unknownKind = createDataParserKind("unknown");
 function unknown(definition) {
-    return dataParserInit(unknownKind, {
+    const self = dataParserInit(unknownKind, {
         definition: {
             errorMessage: definition?.errorMessage,
             checkers: definition?.checkers ?? [],
         },
     }, (data) => data);
+    return unknown.overrideHandler.apply(self);
 }
+unknown.overrideHandler = createOverride("@duplojs/utils/data-parser/unknown");
 
 export { unknown, unknownKind };

package/dist/dataParser/types/dataParsers.d.ts

@@ -6,8 +6,8 @@ import { type DataParserExtended } from "../baseExtended";
 export interface DataParserCustom {
     base: DataParser;
 }
-export type DataParsers = (DataParserCustom[GetPropsWithValueExtends<DataParserCustom, DataParser>] | AllDataParser.DataParserString | AllDataParser.DataParserObject | AllDataParser.DataParserNumber | AllDataParser.DataParserLiteral | AllDataParser.DataParserUnion | AllDataParser.DataParserArray | AllDataParser.DataParserBigInt | AllDataParser.DataParserTuple | AllDataParser.DataParserTransform | AllDataParser.DataParserBoolean | AllDataParser.DataParserNil | AllDataParser.DataParserEmpty | AllDataParser.DataParserTemplateLiteral | AllDataParser.DataParserPipe | AllDataParser.DataParserNullable | AllDataParser.DataParserOptional | AllDataParser.DataParserLazy | AllDataParser.DataParserUnknown | AllDataParser.DataParserRecord | AllDataParser.DataParserRecover);
+export type DataParsers = (DataParserCustom[GetPropsWithValueExtends<DataParserCustom, DataParser>] | AllDataParser.DataParserString | AllDataParser.DataParserObject | AllDataParser.DataParserNumber | AllDataParser.DataParserLiteral | AllDataParser.DataParserUnion | AllDataParser.DataParserArray | AllDataParser.DataParserBigInt | AllDataParser.DataParserTuple | AllDataParser.DataParserTransform | AllDataParser.DataParserBoolean | AllDataParser.DataParserDate | AllDataParser.DataParserNil | AllDataParser.DataParserEmpty | AllDataParser.DataParserTemplateLiteral | AllDataParser.DataParserPipe | AllDataParser.DataParserNullable | AllDataParser.DataParserOptional | AllDataParser.DataParserLazy | AllDataParser.DataParserUnknown | AllDataParser.DataParserRecord | AllDataParser.DataParserRecover);
 export interface DataParserExtendedCustom {
     base: DataParserExtended;
 }
-export type DataParsersExtended = (DataParserExtendedCustom[GetPropsWithValueExtends<DataParserExtendedCustom, DataParserExtended>] | AllDataParserExtended.DataParserStringExtended | AllDataParserExtended.DataParserObjectExtended | AllDataParserExtended.DataParserNumberExtended | AllDataParserExtended.DataParserLiteralExtended | AllDataParserExtended.DataParserUnionExtended | AllDataParserExtended.DataParserArrayExtended | AllDataParserExtended.DataParserBigIntExtended | AllDataParserExtended.DataParserTupleExtended | AllDataParserExtended.DataParserTransformExtended | AllDataParserExtended.DataParserBooleanExtended | AllDataParserExtended.DataParserNilExtended | AllDataParserExtended.DataParserEmptyExtended | AllDataParserExtended.DataParserTemplateLiteralExtended | AllDataParserExtended.DataParserPipeExtended | AllDataParserExtended.DataParserNullableExtended | AllDataParserExtended.DataParserOptionalExtended | AllDataParserExtended.DataParserLazyExtended | AllDataParserExtended.DataParserUnknownExtended | AllDataParserExtended.DataParserRecordExtended | AllDataParserExtended.DataParserRecoverExtended);
+export type DataParsersExtended = (DataParserExtendedCustom[GetPropsWithValueExtends<DataParserExtendedCustom, DataParserExtended>] | AllDataParserExtended.DataParserStringExtended | AllDataParserExtended.DataParserObjectExtended | AllDataParserExtended.DataParserNumberExtended | AllDataParserExtended.DataParserLiteralExtended | AllDataParserExtended.DataParserUnionExtended | AllDataParserExtended.DataParserArrayExtended | AllDataParserExtended.DataParserBigIntExtended | AllDataParserExtended.DataParserTupleExtended | AllDataParserExtended.DataParserTransformExtended | AllDataParserExtended.DataParserBooleanExtended | AllDataParserExtended.DataParserDateExtended | AllDataParserExtended.DataParserNilExtended | AllDataParserExtended.DataParserEmptyExtended | AllDataParserExtended.DataParserTemplateLiteralExtended | AllDataParserExtended.DataParserPipeExtended | AllDataParserExtended.DataParserNullableExtended | AllDataParserExtended.DataParserOptionalExtended | AllDataParserExtended.DataParserLazyExtended | AllDataParserExtended.DataParserUnknownExtended | AllDataParserExtended.DataParserRecordExtended | AllDataParserExtended.DataParserRecoverExtended);

package/dist/date/closestTo.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var toTimestamp = require('./toTimestamp.cjs');
+
+function closestTo(...args) {
+    if (typeof args[0] === "string") {
+        const [target, params] = args;
+        return (input) => closestTo(input, target, params);
+    }
+    const [input, target, params] = args;
+    const { tieBreaker } = params ?? {};
+    const targetTimestamp = toTimestamp.toTimestamp(target);
+    let closest = undefined;
+    let smallestDiff = Number.POSITIVE_INFINITY;
+    for (const value of input) {
+        const valueTimestamp = toTimestamp.toTimestamp(value);
+        if (tieBreaker === "favorPast" && valueTimestamp > targetTimestamp) {
+            continue;
+        }
+        if (tieBreaker === "favorFuture" && valueTimestamp < targetTimestamp) {
+            continue;
+        }
+        const distance = Math.abs(valueTimestamp - targetTimestamp);
+        if (distance < smallestDiff) {
+            smallestDiff = distance;
+            closest = value;
+        }
+    }
+    return closest;
+}
+
+exports.closestTo = closestTo;

package/dist/date/closestTo.d.ts

@@ -0,0 +1,7 @@
+import type { TheDate } from "./types";
+interface ClosestToParams {
+    tieBreaker?: "favorPast" | "favorFuture";
+}
+export declare function closestTo<GenericIterable extends Iterable<TheDate>>(target: TheDate, params?: ClosestToParams): (input: GenericIterable) => TheDate | undefined;
+export declare function closestTo<GenericIterable extends Iterable<TheDate>>(input: GenericIterable, target: TheDate, params?: ClosestToParams): TheDate | undefined;
+export {};

package/dist/date/closestTo.mjs

@@ -0,0 +1,30 @@
+import { toTimestamp } from './toTimestamp.mjs';
+
+function closestTo(...args) {
+    if (typeof args[0] === "string") {
+        const [target, params] = args;
+        return (input) => closestTo(input, target, params);
+    }
+    const [input, target, params] = args;
+    const { tieBreaker } = params ?? {};
+    const targetTimestamp = toTimestamp(target);
+    let closest = undefined;
+    let smallestDiff = Number.POSITIVE_INFINITY;
+    for (const value of input) {
+        const valueTimestamp = toTimestamp(value);
+        if (tieBreaker === "favorPast" && valueTimestamp > targetTimestamp) {
+            continue;
+        }
+        if (tieBreaker === "favorFuture" && valueTimestamp < targetTimestamp) {
+            continue;
+        }
+        const distance = Math.abs(valueTimestamp - targetTimestamp);
+        if (distance < smallestDiff) {
+            smallestDiff = distance;
+            closest = value;
+        }
+    }
+    return closest;
+}
+
+export { closestTo };

package/dist/date/constants.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const minTimestamp = -864e13;
+const maxTimestamp = 8640000000000000;
+const millisecondInOneWeek = 604800000;
+const millisecondsInOneDay = 86400000;
+const millisecondInOneHour = 3600000;
+const millisecondInOneMinute = 60000;
+const daysInOneWeek = 7;
+const monthtsInOneYear = 12;
+const minutesInOneHour = 60;
+const secondsInOneMinute = 60;
+const millisecondsInOneSecond = 1000;
+const hoursInOneDay = 24;
+const theDateRegex = /^date(?<value>\d{1,16})(?<sign>[+-])$/;
+
+exports.daysInOneWeek = daysInOneWeek;
+exports.hoursInOneDay = hoursInOneDay;
+exports.maxTimestamp = maxTimestamp;
+exports.millisecondInOneHour = millisecondInOneHour;
+exports.millisecondInOneMinute = millisecondInOneMinute;
+exports.millisecondInOneWeek = millisecondInOneWeek;
+exports.millisecondsInOneDay = millisecondsInOneDay;
+exports.millisecondsInOneSecond = millisecondsInOneSecond;
+exports.minTimestamp = minTimestamp;
+exports.minutesInOneHour = minutesInOneHour;
+exports.monthtsInOneYear = monthtsInOneYear;
+exports.secondsInOneMinute = secondsInOneMinute;
+exports.theDateRegex = theDateRegex;

package/dist/date/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const minTimestamp = -8640000000000000;
+export declare const maxTimestamp = 8640000000000000;
+export declare const millisecondInOneWeek = 604800000;
+export declare const millisecondsInOneDay = 86400000;
+export declare const millisecondInOneHour = 3600000;
+export declare const millisecondInOneMinute = 60000;
+export declare const daysInOneWeek = 7;
+export declare const monthtsInOneYear = 12;
+export declare const minutesInOneHour = 60;
+export declare const secondsInOneMinute = 60;
+export declare const millisecondsInOneSecond = 1000;
+export declare const hoursInOneDay = 24;
+export declare const theDateRegex: RegExp;

package/dist/date/constants.mjs

@@ -0,0 +1,15 @@
+const minTimestamp = -864e13;
+const maxTimestamp = 8640000000000000;
+const millisecondInOneWeek = 604800000;
+const millisecondsInOneDay = 86400000;
+const millisecondInOneHour = 3600000;
+const millisecondInOneMinute = 60000;
+const daysInOneWeek = 7;
+const monthtsInOneYear = 12;
+const minutesInOneHour = 60;
+const secondsInOneMinute = 60;
+const millisecondsInOneSecond = 1000;
+const hoursInOneDay = 24;
+const theDateRegex = /^date(?<value>\d{1,16})(?<sign>[+-])$/;
+
+export { daysInOneWeek, hoursInOneDay, maxTimestamp, millisecondInOneHour, millisecondInOneMinute, millisecondInOneWeek, millisecondsInOneDay, millisecondsInOneSecond, minTimestamp, minutesInOneHour, monthtsInOneYear, secondsInOneMinute, theDateRegex };

package/dist/date/create.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var constants = require('./constants.cjs');
+var isSafeTimestamp = require('./isSafeTimestamp.cjs');
+var create$1 = require('../either/left/create.cjs');
+var create$2 = require('../either/right/create.cjs');
+
+const safeDateRegex = /^(?<year>-?[0-9]+)-(?<monthWithDay>[0-1][0-9]-[0-3][0-9])$/;
+function create(input, params) {
+    if (input instanceof Date) {
+        const timestamp = input.getTime();
+        if (!isSafeTimestamp.isSafeTimestamp(timestamp)) {
+            return create$1.left("date-created-error", null);
+        }
+        const isNegative = timestamp < 0;
+        return create$2.right("date-created", `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`);
+    }
+    if (typeof input === "number") {
+        if (!isSafeTimestamp.isSafeTimestamp(input)) {
+            return create$1.left("date-created-error", null);
+        }
+        const isNegative = input < 0;
+        return create$2.right("date-created", `date${Math.abs(input)}${isNegative ? "-" : "+"}`);
+    }
+    const theDateMatch = typeof input === "string" && input.match(constants.theDateRegex);
+    if (theDateMatch) {
+        const { value, sign } = theDateMatch.groups;
+        const magnitude = Number(value);
+        const timestamp = sign === "-" ? -magnitude : magnitude;
+        if (!isSafeTimestamp.isSafeTimestamp(timestamp)) {
+            return create$1.left("date-created-error", null);
+        }
+        return create$2.right("date-created", input);
+    }
+    const safeDateMatch = typeof input === "string" && input.match(safeDateRegex);
+    if (safeDateMatch) {
+        const { year, monthWithDay } = safeDateMatch.groups;
+        const date = new Date(`0000-${monthWithDay}T${params?.hour ?? "00"}:${params?.minute ?? "00"}:${params?.second ?? "00"}.${params?.millisecond ?? "000"}Z`);
+        date.setUTCFullYear(Number(year));
+        const timestamp = date.getTime();
+        if (!isSafeTimestamp.isSafeTimestamp(timestamp)) {
+            return "date0+";
+        }
+        const isNegative = timestamp < 0;
+        return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+    }
+    return create$1.left("date-created-error", null);
+}
+
+exports.create = create;

package/dist/date/create.d.ts

@@ -0,0 +1,16 @@
+import type { Hour, IsLeapYear, Millisecond, Minute, Second, TheDate } from "./types";
+import { type EitherLeft, type EitherRight } from "../either";
+import { type MonthWithDay } from "./types/month";
+export type MayBe = EitherRight<"date-created", TheDate> | EitherLeft<"date-created-error", null>;
+declare const SymbolErrorIsNotLeapYear: unique symbol;
+interface SafeDateParams {
+    hour?: Hour;
+    minute?: Minute;
+    second?: Second;
+    millisecond?: Millisecond;
+}
+export declare function create<GenericInput extends TheDate | Date | number>(input: GenericInput): MayBe;
+export declare function create<GenericInput extends `${"-" | ""}${number}-${MonthWithDay}`>(input: GenericInput & (GenericInput extends `${"-" | ""}${infer InferredYear extends `${number}`}-02-29` ? IsLeapYear<InferredYear> extends true ? GenericInput : {
+    [SymbolErrorIsNotLeapYear]: "Is not a leap year.";
+} : GenericInput), params?: SafeDateParams): TheDate;
+export {};

package/dist/date/create.mjs

@@ -0,0 +1,48 @@
+import { theDateRegex } from './constants.mjs';
+import { isSafeTimestamp } from './isSafeTimestamp.mjs';
+import { left } from '../either/left/create.mjs';
+import { right } from '../either/right/create.mjs';
+
+const safeDateRegex = /^(?<year>-?[0-9]+)-(?<monthWithDay>[0-1][0-9]-[0-3][0-9])$/;
+function create(input, params) {
+    if (input instanceof Date) {
+        const timestamp = input.getTime();
+        if (!isSafeTimestamp(timestamp)) {
+            return left("date-created-error", null);
+        }
+        const isNegative = timestamp < 0;
+        return right("date-created", `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`);
+    }
+    if (typeof input === "number") {
+        if (!isSafeTimestamp(input)) {
+            return left("date-created-error", null);
+        }
+        const isNegative = input < 0;
+        return right("date-created", `date${Math.abs(input)}${isNegative ? "-" : "+"}`);
+    }
+    const theDateMatch = typeof input === "string" && input.match(theDateRegex);
+    if (theDateMatch) {
+        const { value, sign } = theDateMatch.groups;
+        const magnitude = Number(value);
+        const timestamp = sign === "-" ? -magnitude : magnitude;
+        if (!isSafeTimestamp(timestamp)) {
+            return left("date-created-error", null);
+        }
+        return right("date-created", input);
+    }
+    const safeDateMatch = typeof input === "string" && input.match(safeDateRegex);
+    if (safeDateMatch) {
+        const { year, monthWithDay } = safeDateMatch.groups;
+        const date = new Date(`0000-${monthWithDay}T${params?.hour ?? "00"}:${params?.minute ?? "00"}:${params?.second ?? "00"}.${params?.millisecond ?? "000"}Z`);
+        date.setUTCFullYear(Number(year));
+        const timestamp = date.getTime();
+        if (!isSafeTimestamp(timestamp)) {
+            return "date0+";
+        }
+        const isNegative = timestamp < 0;
+        return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+    }
+    return left("date-created-error", null);
+}
+
+export { create };

package/dist/date/createOrThrow.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var create = require('./create.cjs');
+var kind = require('../common/kind.cjs');
+var is = require('../either/left/is.cjs');
+var unwrap = require('../common/unwrap.cjs');
+var errorKindNamespace = require('../common/errorKindNamespace.cjs');
+
+class CreateTheDateError extends kind.kindHeritage("create-the-date-error", errorKindNamespace.createErrorKind("create-the-date-error"), Error) {
+    input;
+    constructor(input) {
+        super({}, [`Invalid input: ${input.toString()}`]);
+        this.input = input;
+    }
+}
+function createOrThrow(input) {
+    const result = create.create(input);
+    if (is.isLeft(result)) {
+        throw new CreateTheDateError(input);
+    }
+    return unwrap.unwrap(result);
+}
+
+exports.CreateTheDateError = CreateTheDateError;
+exports.createOrThrow = createOrThrow;

package/dist/date/createOrThrow.d.ts

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

package/dist/date/createOrThrow.mjs

@@ -0,0 +1,22 @@
+import { create } from './create.mjs';
+import { kindHeritage } from '../common/kind.mjs';
+import { isLeft } from '../either/left/is.mjs';
+import { unwrap } from '../common/unwrap.mjs';
+import { createErrorKind } from '../common/errorKindNamespace.mjs';
+
+class CreateTheDateError extends kindHeritage("create-the-date-error", createErrorKind("create-the-date-error"), Error) {
+    input;
+    constructor(input) {
+        super({}, [`Invalid input: ${input.toString()}`]);
+        this.input = input;
+    }
+}
+function createOrThrow(input) {
+    const result = create(input);
+    if (isLeft(result)) {
+        throw new CreateTheDateError(input);
+    }
+    return unwrap(result);
+}
+
+export { CreateTheDateError, createOrThrow };

package/dist/date/each.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+var loop = require('../generator/loop.cjs');
+var constants = require('./constants.cjs');
+var toTimestamp = require('./toTimestamp.cjs');
+var createOrThrow = require('./createOrThrow.cjs');
+
+const stepMapper = {
+    millisecond: (timestamp, direction) => timestamp + direction,
+    second: (timestamp, direction) => timestamp + (direction * constants.millisecondsInOneSecond),
+    minute: (timestamp, direction) => timestamp + (direction * constants.millisecondInOneMinute),
+    hour: (timestamp, direction) => timestamp + (direction * constants.millisecondInOneHour),
+    day: (timestamp, direction) => timestamp + (direction * constants.millisecondsInOneDay),
+    month: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCMonth(date.getUTCMonth() + direction);
+        return date.getTime();
+    },
+    year: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCFullYear(date.getUTCFullYear() + direction);
+        return date.getTime();
+    },
+};
+function each(range, unit = "day") {
+    const startTimestamp = toTimestamp.toTimestamp(range.start);
+    const endTimestamp = toTimestamp.toTimestamp(range.end);
+    const direction = startTimestamp <= endTimestamp ? 1 : -1;
+    const advanceTimestamp = stepMapper[unit];
+    return loop.loop(({ exit, next, previousOutput, }) => {
+        if (!previousOutput) {
+            return next(range.start);
+        }
+        const currentTimestamp = advanceTimestamp(toTimestamp.toTimestamp(previousOutput), direction);
+        const isWithinRange = direction === 1
+            ? currentTimestamp < endTimestamp
+            : currentTimestamp > endTimestamp;
+        if (!isWithinRange) {
+            return exit(currentTimestamp === endTimestamp
+                ? createOrThrow.createOrThrow(currentTimestamp)
+                : undefined);
+        }
+        return next(createOrThrow.createOrThrow(currentTimestamp));
+    });
+}
+
+exports.each = each;

package/dist/date/each.d.ts

@@ -0,0 +1,5 @@
+import type { TheDate, Unit } from "./types";
+export declare function each(range: {
+    start: TheDate;
+    end: TheDate;
+}, unit?: Unit): Generator<`date${number}-` | `date${number}+`, unknown, unknown>;

package/dist/date/each.mjs

@@ -0,0 +1,45 @@
+import { loop } from '../generator/loop.mjs';
+import { millisecondsInOneDay, millisecondInOneHour, millisecondInOneMinute, millisecondsInOneSecond } from './constants.mjs';
+import { toTimestamp } from './toTimestamp.mjs';
+import { createOrThrow } from './createOrThrow.mjs';
+
+const stepMapper = {
+    millisecond: (timestamp, direction) => timestamp + direction,
+    second: (timestamp, direction) => timestamp + (direction * millisecondsInOneSecond),
+    minute: (timestamp, direction) => timestamp + (direction * millisecondInOneMinute),
+    hour: (timestamp, direction) => timestamp + (direction * millisecondInOneHour),
+    day: (timestamp, direction) => timestamp + (direction * millisecondsInOneDay),
+    month: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCMonth(date.getUTCMonth() + direction);
+        return date.getTime();
+    },
+    year: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCFullYear(date.getUTCFullYear() + direction);
+        return date.getTime();
+    },
+};
+function each(range, unit = "day") {
+    const startTimestamp = toTimestamp(range.start);
+    const endTimestamp = toTimestamp(range.end);
+    const direction = startTimestamp <= endTimestamp ? 1 : -1;
+    const advanceTimestamp = stepMapper[unit];
+    return loop(({ exit, next, previousOutput, }) => {
+        if (!previousOutput) {
+            return next(range.start);
+        }
+        const currentTimestamp = advanceTimestamp(toTimestamp(previousOutput), direction);
+        const isWithinRange = direction === 1
+            ? currentTimestamp < endTimestamp
+            : currentTimestamp > endTimestamp;
+        if (!isWithinRange) {
+            return exit(currentTimestamp === endTimestamp
+                ? createOrThrow(currentTimestamp)
+                : undefined);
+        }
+        return next(createOrThrow(currentTimestamp));
+    });
+}
+
+export { each };

package/dist/date/getters/getDayOfMonth.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var toNative = require('../toNative.cjs');
+
+function getDayOfMonth(input, timezone = "UTC") {
+    const nativeDate = toNative.toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCDate();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        day: "numeric",
+    });
+    return Number(formatter.format(nativeDate));
+}
+
+exports.getDayOfMonth = getDayOfMonth;

package/dist/date/getters/getDayOfMonth.d.ts

@@ -0,0 +1,2 @@
+import { type TheDate, type Timezone } from "..";
+export declare function getDayOfMonth<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;