@duplojs/utils 1.4.47 → 1.4.48

package/dist/dataParser/parsers/time/index.d.ts

@@ -13,7 +13,7 @@ export interface DataParserDefinitionTime extends DataParserDefinition<DataParse
     readonly coerce: boolean;
 }
 export declare const timeKind: import("../../../common").KindHandler<import("../../../common").KindDefinition<"@DuplojsUtilsDataParser/time", unknown>>;
-type _DataParserTime<GenericDefinition extends DataParserDefinitionTime> = (DataParser<GenericDefinition, TheTime, TheTime> & Kind<typeof timeKind.definition>);
+type _DataParserTime<GenericDefinition extends DataParserDefinitionTime> = (DataParser<GenericDefinition, TheTime, TheTime | number> & Kind<typeof timeKind.definition>);
 export interface DataParserTime<GenericDefinition extends DataParserDefinitionTime = DataParserDefinitionTime> extends _DataParserTime<GenericDefinition> {
     addChecker<GenericChecker extends readonly [
         DataParserTimeCheckers,
@@ -24,17 +24,17 @@ export interface DataParserTime<GenericDefinition extends DataParserDefinitionTi
     ], GenericChecker>): DataParserTime<AddCheckersToDefinition<GenericDefinition, GenericChecker>>;
 }
 /**
- * Creates a data parser for TheTime values.
+ * Creates a data parser for TheTime values or safe millisecond numbers.
  * 
  * **Supported call styles:**
  * - Classic: `DP.time(definition?)` -> returns a time parser
  * - Curried: not available
  * 
- * Validates that the input is a TheTime, optionally applies coerce, and runs the configured checkers.
+ * Validates that the input is a TheTime (or a safe millisecond number), optionally applies ISO string coercion, and runs the configured checkers.
  * 
  * ```ts
  * const parser = DP.time();
- * const result = parser.parse("time0+");
+ * const result = parser.parse(60000);
  * if (E.isRight(result)) {
  * 	const value = unwrap(result);
  * 	// value: TheTime

package/dist/dataParser/parsers/time/index.mjs

@@ -1,13 +1,13 @@
 import { dataParserInit } from '../../base.mjs';
 import { SymbolDataParserErrorIssue } from '../../error.mjs';
 import { createDataParserKind } from '../../kind.mjs';
-import { isSafeTimeValue } from '../../../date/isSafeTimeValue.mjs';
-import { createTheTime } from '../../../date/createTheTime.mjs';
 import { isoTimeRegex } from '../../../date/constants.mjs';
 import { createTime } from '../../../date/createTime.mjs';
 import { isLeft } from '../../../either/left/is.mjs';
 import { unwrap } from '../../../common/unwrap.mjs';
 import { isTime } from '../../../date/isTime.mjs';
+import { isSafeTimeValue } from '../../../date/isSafeTimeValue.mjs';
+import { createTheTime } from '../../../date/createTheTime.mjs';
 import { createOverride } from '../../../common/override.mjs';
 
 const timeKind = createDataParserKind("time");
@@ -21,12 +21,6 @@ function time(definition) {
         coerce: definition?.coerce ?? false,
     }, (data, _error, self) => {
         if (self.definition.coerce) {
-            if (typeof data === "number") {
-                if (!isSafeTimeValue(data)) {
-                    return SymbolDataParserErrorIssue;
-                }
-                return createTheTime(data);
-            }
             if (typeof data === "string" && isoTimeRegex.test(data)) {
                 const result = createTime({ value: data });
                 if (isLeft(result)) {
@@ -38,6 +32,12 @@ function time(definition) {
         if (typeof data === "string" && isTime(data)) {
             return data;
         }
+        if (typeof data === "number") {
+            if (!isSafeTimeValue(data)) {
+                return SymbolDataParserErrorIssue;
+            }
+            return createTheTime(data);
+        }
         return SymbolDataParserErrorIssue;
     }, time.overrideHandler);
     return self;

package/dist/index.cjs

@@ -12,7 +12,6 @@ var index$8 = require('./dataParser/parsers/coerce/index.cjs');
 var index$9 = require('./dataParser/extended/index.cjs');
 var index$a = require('./date/index.cjs');
 var index$b = require('./clean/index.cjs');
-var index$c = require('./common/path/index.cjs');
 var addWrappedProperties = require('./common/addWrappedProperties.cjs');
 var asyncPipe = require('./common/asyncPipe.cjs');
 var clone = require('./common/clone.cjs');
@@ -26,6 +25,7 @@ var promiseObject = require('./common/promiseObject.cjs');
 var simpleClone = require('./common/simpleClone.cjs');
 var sleep = require('./common/sleep.cjs');
 var stringToBytes = require('./common/stringToBytes.cjs');
+var mimeType = require('./common/mimeType.cjs');
 var stringToMillisecond = require('./common/stringToMillisecond.cjs');
 var toJSON = require('./common/toJSON.cjs');
 var toTransform = require('./common/toTransform.cjs');
@@ -62,6 +62,7 @@ var hasKinds = require('./common/hasKinds.cjs');
 var toCurriedPredicate = require('./common/toCurriedPredicate.cjs');
 var pipeCall = require('./common/pipeCall.cjs');
 var asserts = require('./common/asserts.cjs');
+var path = require('./common/path.cjs');
 
 
 
@@ -89,7 +90,6 @@ exports.D = index$a;
 exports.DDate = index$a;
 exports.C = index$b;
 exports.DClean = index$b;
-exports.Path = index$c;
 exports.addWrappedProperties = addWrappedProperties.addWrappedProperties;
 exports.asyncPipe = asyncPipe.asyncPipe;
 exports.clone = clone.clone;
@@ -108,6 +108,7 @@ exports.simpleClone = simpleClone.simpleClone;
 exports.sleep = sleep.sleep;
 exports.InvalidBytesInStringError = stringToBytes.InvalidBytesInStringError;
 exports.stringToBytes = stringToBytes.stringToBytes;
+exports.mimeType = mimeType.mimeType;
 exports.InvalidMillisecondInStringError = stringToMillisecond.InvalidMillisecondInStringError;
 exports.stringToMillisecond = stringToMillisecond.stringToMillisecond;
 exports.toJSON = toJSON.toJSON;
@@ -152,3 +153,7 @@ exports.toCurriedPredicate = toCurriedPredicate.toCurriedPredicate;
 exports.pipeCall = pipeCall.pipeCall;
 exports.AssertsError = asserts.AssertsError;
 exports.asserts = asserts.asserts;
+Object.defineProperty(exports, "Path", {
+	enumerable: true,
+	get: function () { return path.Path; }
+});

package/dist/index.mjs

@@ -34,8 +34,6 @@ export { index$a as DDate };
 import * as index$b from './clean/index.mjs';
 export { index$b as C };
 export { index$b as DClean };
-import * as index$c from './common/path/index.mjs';
-export { index$c as Path };
 export { addWrappedProperties } from './common/addWrappedProperties.mjs';
 export { asyncPipe } from './common/asyncPipe.mjs';
 export { clone } from './common/clone.mjs';
@@ -49,6 +47,7 @@ export { promiseObject } from './common/promiseObject.mjs';
 export { simpleClone } from './common/simpleClone.mjs';
 export { sleep } from './common/sleep.mjs';
 export { InvalidBytesInStringError, stringToBytes } from './common/stringToBytes.mjs';
+export { mimeType } from './common/mimeType.mjs';
 export { InvalidMillisecondInStringError, stringToMillisecond } from './common/stringToMillisecond.mjs';
 export { toJSON } from './common/toJSON.mjs';
 export { toTransform } from './common/toTransform.mjs';
@@ -85,3 +84,4 @@ export { hasKinds } from './common/hasKinds.mjs';
 export { toCurriedPredicate } from './common/toCurriedPredicate.mjs';
 export { pipeCall } from './common/pipeCall.mjs';
 export { AssertsError, asserts } from './common/asserts.mjs';
+export { Path } from './common/path.mjs';

package/dist/metadata.json

@@ -999,74 +999,6 @@
     {
       "name": "common",
       "files": [
-        {
-          "name": "path",
-          "files": [
-            {
-              "name": "getBaseName.cjs"
-            },
-            {
-              "name": "getBaseName.d.ts"
-            },
-            {
-              "name": "getBaseName.mjs"
-            },
-            {
-              "name": "getExtensionName.cjs"
-            },
-            {
-              "name": "getExtensionName.d.ts"
-            },
-            {
-              "name": "getExtensionName.mjs"
-            },
-            {
-              "name": "getParentFolderPath.cjs"
-            },
-            {
-              "name": "getParentFolderPath.d.ts"
-            },
-            {
-              "name": "getParentFolderPath.mjs"
-            },
-            {
-              "name": "index.cjs"
-            },
-            {
-              "name": "index.d.ts"
-            },
-            {
-              "name": "index.mjs"
-            },
-            {
-              "name": "isAbsolute.cjs"
-            },
-            {
-              "name": "isAbsolute.d.ts"
-            },
-            {
-              "name": "isAbsolute.mjs"
-            },
-            {
-              "name": "resolveFrom.cjs"
-            },
-            {
-              "name": "resolveFrom.d.ts"
-            },
-            {
-              "name": "resolveFrom.mjs"
-            },
-            {
-              "name": "resolveRelative.cjs"
-            },
-            {
-              "name": "resolveRelative.d.ts"
-            },
-            {
-              "name": "resolveRelative.mjs"
-            }
-          ]
-        },
         {
           "name": "types",
           "files": [
@@ -1483,6 +1415,15 @@
         {
           "name": "memo.mjs"
         },
+        {
+          "name": "mimeType.cjs"
+        },
+        {
+          "name": "mimeType.d.ts"
+        },
+        {
+          "name": "mimeType.mjs"
+        },
         {
           "name": "or.cjs"
         },
@@ -1501,6 +1442,15 @@
         {
           "name": "override.mjs"
         },
+        {
+          "name": "path.cjs"
+        },
+        {
+          "name": "path.d.ts"
+        },
+        {
+          "name": "path.mjs"
+        },
         {
           "name": "pipe.cjs"
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/utils",
-  "version": "1.4.47",
+  "version": "1.4.48",
   "author": {
     "name": "mathcovax",
     "url": "https://github.com/mathcovax"

package/dist/common/path/getBaseName.cjs

@@ -1,25 +0,0 @@
-'use strict';
-
-var split = require('../../string/split.cjs');
-var findLast = require('../../array/findLast.cjs');
-var length = require('../../string/length.cjs');
-var endsWith = require('../../string/endsWith.cjs');
-var slice = require('../../string/slice.cjs');
-
-/**
- * {@include common/path/getBaseName/index.md}
- */
-function getBaseName(path, params) {
-    const segments = split.split(path, "/");
-    const lastSegment = findLast.findLast(segments, (value) => length.length(value) > 0) ?? null;
-    if (!lastSegment || lastSegment === "..") {
-        return null;
-    }
-    if (params?.extension && endsWith.endsWith(lastSegment, params?.extension)) {
-        const extensionLength = length.length(params.extension);
-        return slice.slice(lastSegment, 0, -extensionLength);
-    }
-    return lastSegment;
-}
-
-exports.getBaseName = getBaseName;

package/dist/common/path/getBaseName.d.ts

@@ -1,26 +0,0 @@
-interface GetBaseNameParams {
-    extension?: string;
-}
-/**
- * Returns the last non-empty segment of a path, optionally without an extension.
- * 
- * **Supported call styles:**
- * - Classic: `getBaseName(path, params?)` -> returns the base name or null
- * 
- * It ignores trailing slashes and returns null when the path has no segment or when the last segment is `..`.
- * When an extension is provided, it is removed only if it matches the end of the base name.
- * 
- * ```ts
- * const defaultResult = Path.getBaseName("/foo/bar.txt");
- * // defaultResult: "bar.txt"
- * const withoutExtResult = Path.getBaseName("/foo/bar.txt", { extension: ".txt" });
- * // withoutExtResult: "bar"
- * const nullResult = Path.getBaseName("..");
- * // nullResult: null
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path/getBaseName
- * 
- */
-export declare function getBaseName<GenericPath extends string>(path: GenericPath, params?: GetBaseNameParams): string | null;
-export {};

package/dist/common/path/getBaseName.mjs

@@ -1,23 +0,0 @@
-import { split } from '../../string/split.mjs';
-import { findLast } from '../../array/findLast.mjs';
-import { length } from '../../string/length.mjs';
-import { endsWith } from '../../string/endsWith.mjs';
-import { slice } from '../../string/slice.mjs';
-
-/**
- * {@include common/path/getBaseName/index.md}
- */
-function getBaseName(path, params) {
-    const segments = split(path, "/");
-    const lastSegment = findLast(segments, (value) => length(value) > 0) ?? null;
-    if (!lastSegment || lastSegment === "..") {
-        return null;
-    }
-    if (params?.extension && endsWith(lastSegment, params?.extension)) {
-        const extensionLength = length(params.extension);
-        return slice(lastSegment, 0, -extensionLength);
-    }
-    return lastSegment;
-}
-
-export { getBaseName };

package/dist/common/path/getExtensionName.cjs

@@ -1,17 +0,0 @@
-'use strict';
-
-var minElements = require('../../array/minElements.cjs');
-
-const extensionNameRegex = /\.([^./]+)$/;
-/**
- * {@include common/path/getExtensionName/index.md}
- */
-function getExtensionName(path) {
-    const match = extensionNameRegex.exec(path);
-    if (!!match && minElements.minElements(match, 2)) {
-        return match[1];
-    }
-    return null;
-}
-
-exports.getExtensionName = getExtensionName;

package/dist/common/path/getExtensionName.d.ts

@@ -1,21 +0,0 @@
-/**
- * Returns the last extension of a path, without the leading dot.
- * 
- * **Supported call styles:**
- * - Classic: `getExtensionName(path)` -> returns the extension or null
- * 
- * It returns null when no extension is found, when the path ends with a dot, or when the path is `..`.
- * 
- * ```ts
- * const txtResult = Path.getExtensionName("/foo/bar.txt");
- * // txtResult: "txt"
- * const tarResult = Path.getExtensionName("archive.tar.gz");
- * // tarResult: "gz"
- * const dotResult = Path.getExtensionName("file.");
- * // dotResult: null
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path/getExtensionName
- * 
- */
-export declare function getExtensionName<GenericPath extends string>(path: GenericPath): string | null;

package/dist/common/path/getExtensionName.mjs

@@ -1,15 +0,0 @@
-import { minElements } from '../../array/minElements.mjs';
-
-const extensionNameRegex = /\.([^./]+)$/;
-/**
- * {@include common/path/getExtensionName/index.md}
- */
-function getExtensionName(path) {
-    const match = extensionNameRegex.exec(path);
-    if (!!match && minElements(match, 2)) {
-        return match[1];
-    }
-    return null;
-}
-
-export { getExtensionName };

package/dist/common/path/getParentFolderPath.cjs

@@ -1,21 +0,0 @@
-'use strict';
-
-var pipe = require('../pipe.cjs');
-var isAbsolute = require('./isAbsolute.cjs');
-var slice = require('../../array/slice.cjs');
-var split = require('../../string/split.cjs');
-var replace = require('../../string/replace.cjs');
-var join = require('../../array/join.cjs');
-
-/**
- * {@include common/path/getParentFolderPath/index.md}
- */
-function getParentFolderPath(path) {
-    const segments = pipe.pipe(path, replace.replace(/\/$/, ""), split.split("/"), slice.slice(0, -1));
-    return join.join(segments, "/")
-        || (isAbsolute.isAbsolute(path)
-            ? "/"
-            : ".");
-}
-
-exports.getParentFolderPath = getParentFolderPath;

package/dist/common/path/getParentFolderPath.d.ts

@@ -1,23 +0,0 @@
-/**
- * Returns the parent folder path of a POSIX path.
- * 
- * **Supported call styles:**
- * - Classic: `getParentFolderPath(path)` -> returns the parent folder
- * 
- * It removes a trailing slash, drops the last segment, and falls back to `/` for absolute paths or `.` for relative paths when needed.
- * 
- * ```ts
- * const result = Path.getParentFolderPath("/foo/bar/baz");
- * // result: "/foo/bar"
- * const trailingResult = Path.getParentFolderPath("/foo/bar/");
- * // trailingResult: "/foo"
- * const relativeResult = Path.getParentFolderPath("foo");
- * // relativeResult: "."
- * const absoluteResult = Path.getParentFolderPath("/foo");
- * // absoluteResult: "/"
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path/getParentFolderPath
- * 
- */
-export declare function getParentFolderPath<GenericPath extends string>(path: GenericPath): string;

package/dist/common/path/getParentFolderPath.mjs

@@ -1,19 +0,0 @@
-import { pipe } from '../pipe.mjs';
-import { isAbsolute } from './isAbsolute.mjs';
-import { slice } from '../../array/slice.mjs';
-import { split } from '../../string/split.mjs';
-import { replace } from '../../string/replace.mjs';
-import { join } from '../../array/join.mjs';
-
-/**
- * {@include common/path/getParentFolderPath/index.md}
- */
-function getParentFolderPath(path) {
-    const segments = pipe(path, replace(/\/$/, ""), split("/"), slice(0, -1));
-    return join(segments, "/")
-        || (isAbsolute(path)
-            ? "/"
-            : ".");
-}
-
-export { getParentFolderPath };

package/dist/common/path/index.cjs

@@ -1,19 +0,0 @@
-'use strict';
-
-var isAbsolute = require('./isAbsolute.cjs');
-var getParentFolderPath = require('./getParentFolderPath.cjs');
-var getBaseName = require('./getBaseName.cjs');
-var getExtensionName = require('./getExtensionName.cjs');
-var resolveFrom = require('./resolveFrom.cjs');
-var resolveRelative = require('./resolveRelative.cjs');
-
-/**
- * {@include common/path/index.md}
- */
-
-exports.isAbsolute = isAbsolute.isAbsolute;
-exports.getParentFolderPath = getParentFolderPath.getParentFolderPath;
-exports.getBaseName = getBaseName.getBaseName;
-exports.getExtensionName = getExtensionName.getExtensionName;
-exports.resolveFrom = resolveFrom.resolveFrom;
-exports.resolveRelative = resolveRelative.resolveRelative;

package/dist/common/path/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * Path utilities to resolve and inspect POSIX paths.
- * They preserve input strings and return new values.
- * 
- * **How to import:**
- * - From the main common namespace
- * - Via direct import for tree-shaking
- * 
- * ```ts
- * import { Path } from "@duplojs/utils";
- * import * as Path from "@duplojs/utils/common/path";
- * ```
- * 
- * What you will find in this namespace:
- * - checks (`Path.isAbsolute`)
- * - resolution (`Path.resolveFrom`, `Path.resolveRelative`)
- * - path parsing (`Path.getParentFolderPath`, `Path.getBaseName`, `Path.getExtensionName`)
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path
- * 
- */
-export * from "./isAbsolute";
-export * from "./getParentFolderPath";
-export * from "./getBaseName";
-export * from "./getExtensionName";
-export * from "./resolveFrom";
-export * from "./resolveRelative";

package/dist/common/path/index.mjs

@@ -1,10 +0,0 @@
-export { isAbsolute } from './isAbsolute.mjs';
-export { getParentFolderPath } from './getParentFolderPath.mjs';
-export { getBaseName } from './getBaseName.mjs';
-export { getExtensionName } from './getExtensionName.mjs';
-export { resolveFrom } from './resolveFrom.mjs';
-export { resolveRelative } from './resolveRelative.mjs';
-
-/**
- * {@include common/path/index.md}
- */

package/dist/common/path/isAbsolute.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-var startsWith = require('../../string/startsWith.cjs');
-var test = require('../../string/test.cjs');
-
-const isRelativeRegex = /(^|\/)\.\.(?=\/|$)/;
-/**
- * {@include common/path/isAbsolute/index.md}
- */
-function isAbsolute(path) {
-    return startsWith.startsWith(path, "/")
-        && !test.test(path, isRelativeRegex);
-}
-
-exports.isAbsolute = isAbsolute;

package/dist/common/path/isAbsolute.d.ts

@@ -1,21 +0,0 @@
-/**
- * Checks whether a path is absolute (POSIX).
- * 
- * **Supported call styles:**
- * - Classic: `isAbsolute(path)` -> returns a boolean
- * 
- * It returns true when the path starts with `/` and does not contain `..` segments.
- * 
- * ```ts
- * const absolutePath = Path.isAbsolute("/var/log");
- * // absolutePath: true
- * const parentTraversal = Path.isAbsolute("/var/../log");
- * // parentTraversal: false
- * const relativePath = Path.isAbsolute("var/log");
- * // relativePath: false
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path/isAbsolute
- * 
- */
-export declare function isAbsolute<GenericPath extends string>(path: GenericPath): boolean;

package/dist/common/path/isAbsolute.mjs

@@ -1,13 +0,0 @@
-import { startsWith } from '../../string/startsWith.mjs';
-import { test } from '../../string/test.mjs';
-
-const isRelativeRegex = /(^|\/)\.\.(?=\/|$)/;
-/**
- * {@include common/path/isAbsolute/index.md}
- */
-function isAbsolute(path) {
-    return startsWith(path, "/")
-        && !test(path, isRelativeRegex);
-}
-
-export { isAbsolute };

package/dist/common/path/resolveFrom.cjs

@@ -1,18 +0,0 @@
-'use strict';
-
-var isAbsolute = require('./isAbsolute.cjs');
-var resolveRelative = require('./resolveRelative.cjs');
-var success = require('../../either/right/success.cjs');
-var fail = require('../../either/left/fail.cjs');
-
-/**
- * {@include common/path/resolveFrom/index.md}
- */
-function resolveFrom(origin, segments) {
-    const result = resolveRelative.resolveRelative([origin, ...segments]);
-    return isAbsolute.isAbsolute(result)
-        ? success.success(result)
-        : fail.fail();
-}
-
-exports.resolveFrom = resolveFrom;

package/dist/common/path/resolveFrom.d.ts

@@ -1,27 +0,0 @@
-import * as DEither from "../../either";
-import type { AnyTuple } from "../types";
-/**
- * Resolves a list of path segments from an origin and returns an Either.
- * 
- * **Supported call styles:**
- * - Classic: `resolveFrom(origin, segments)` -> returns an Either
- * 
- * Segments are resolved in order using `resolveRelative`.
- * The result is an `Either` that is `success` only when the resolved path is absolute; otherwise it returns `fail`.
- * 
- * ```ts
- * const absoluteResult = Path.resolveFrom("/root", ["alpha", "beta"]);
- * // absoluteResult: DEither.success<"/root/alpha/beta">
- * const result = unwrap(absoluteResult);
- * // result: "/root/alpha/beta"
- * 
- * const overrideResult = Path.resolveFrom("gamma", ["alpha", "/root", "beta"]);
- * // overrideResult: DEither.success<"/root/beta">
- * const relativeResult = Path.resolveFrom("alpha", ["..", ".."]);
- * // relativeResult: DEither.fail
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/path/resolveFrom
- * 
- */
-export declare function resolveFrom<GenericSegment extends string>(origin: string, segments: AnyTuple<GenericSegment>): DEither.Fail | DEither.Success<string>;

package/dist/common/path/resolveFrom.mjs

@@ -1,16 +0,0 @@
-import { isAbsolute } from './isAbsolute.mjs';
-import { resolveRelative } from './resolveRelative.mjs';
-import { success } from '../../either/right/success.mjs';
-import { fail } from '../../either/left/fail.mjs';
-
-/**
- * {@include common/path/resolveFrom/index.md}
- */
-function resolveFrom(origin, segments) {
-    const result = resolveRelative([origin, ...segments]);
-    return isAbsolute(result)
-        ? success(result)
-        : fail();
-}
-
-export { resolveFrom };