@sodiumlabs/duration 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sodiumlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+<div align="center">
+    <h1>@sodiumlabs/duration</h1>
+    <p>
+        <a href="https://discord.gg/8PDXWSHH7k"><img src="https://img.shields.io/badge/join_us-on_discord-5865F2?logo=discord&logoColor=white" alt="Discord server" /></a>
+        <a href="https://www.npmjs.com/package/@sodiumlabs/duration"><img src="https://img.shields.io/npm/v/@sodiumlabs/duration.svg?maxAge=3600" alt="npm version" /></a>
+        <a href="https://www.npmjs.com/package/@sodiumlabs/duration"><img src="https://img.shields.io/npm/dt/@sodiumlabs/duration.svg?maxAge=3600" alt="npm downloads" /></a>
+        <a href="https://github.com/sodium-labs/duration/commits/main"><img alt="Last commit" src="https://img.shields.io/github/last-commit/sodium-labs/duration?logo=github&logoColor=ffffff" /></a>
+    </p>
+</div>
+
+## About
+
+Time and duration utility package.
+
+## Installation
+
+Node.js 18 or newer is required.
+
+```sh
+npm install @sodiumlabs/duration
+```
+
+## Usage
+
+```ts
+import { Time } from "@sodiumlabs/duration";
+
+setInterval(() => {
+    console.log("Called every 2 hours!");
+}, Time.Hour * 2);
+```
+
+## Links
+
+- [Documentation](https://docs.sodiumlabs.xyz/docs/packages/duration/stable)
+- [Discord server](https://discord.gg/8PDXWSHH7k)
+- [GitHub](https://github.com/sodium-labs/utilities/tree/main/packages/duration)
+- [npm](https://npmjs.com/package/@sodiumlabs/duration)
+- [Sodium Labs](https://sodiumlabs.xyz)
+
+## Help
+
+Need help with the module? Ask on our [support server!](https://discord.gg/8PDXWSHH7k)

package/dist/index.d.mts

@@ -0,0 +1,60 @@
+/**
+ * Common time constants, expressed in milliseconds.
+ */
+declare enum Time {
+    Nanosecond = 0.000001,
+    Microsecond = 0.001,
+    Millisecond = 1,
+    Second = 1000,
+    Minute = 60000,
+    Hour = 3600000,
+    Day = 86400000,
+    Week = 604800000,
+    /**
+     * 30 days
+     */
+    Month = 2592000000,
+    /**
+     * 365 days
+     */
+    Year = 31536000000,
+    /**
+     * Average month (365.25d / 12)
+     */
+    AverageMonth = 2629800000,
+    /**
+     * Average year (365.25d, accounting for leap years)
+     */
+    AverageYear = 31557600000
+}
+/**
+ * Common time constants, expressed in seconds.
+ */
+declare enum TimeSeconds {
+    Nanosecond = 1e-9,
+    Microsecond = 0.000001,
+    Millisecond = 0.001,
+    Second = 1,
+    Minute = 60,
+    Hour = 3600,
+    Day = 86400,
+    Week = 604800,
+    /**
+     * 30 days
+     */
+    Month = 2592000,
+    /**
+     * 365 days
+     */
+    Year = 31536000,
+    /**
+     * Average month (365.25d / 12)
+     */
+    AverageMonth = 2629800,
+    /**
+     * Average year (365.25d, accounting for leap years)
+     */
+    AverageYear = 31557600
+}
+
+export { Time, TimeSeconds };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Common time constants, expressed in milliseconds.
+ */
+declare enum Time {
+    Nanosecond = 0.000001,
+    Microsecond = 0.001,
+    Millisecond = 1,
+    Second = 1000,
+    Minute = 60000,
+    Hour = 3600000,
+    Day = 86400000,
+    Week = 604800000,
+    /**
+     * 30 days
+     */
+    Month = 2592000000,
+    /**
+     * 365 days
+     */
+    Year = 31536000000,
+    /**
+     * Average month (365.25d / 12)
+     */
+    AverageMonth = 2629800000,
+    /**
+     * Average year (365.25d, accounting for leap years)
+     */
+    AverageYear = 31557600000
+}
+/**
+ * Common time constants, expressed in seconds.
+ */
+declare enum TimeSeconds {
+    Nanosecond = 1e-9,
+    Microsecond = 0.000001,
+    Millisecond = 0.001,
+    Second = 1,
+    Minute = 60,
+    Hour = 3600,
+    Day = 86400,
+    Week = 604800,
+    /**
+     * 30 days
+     */
+    Month = 2592000,
+    /**
+     * 365 days
+     */
+    Year = 31536000,
+    /**
+     * Average month (365.25d / 12)
+     */
+    AverageMonth = 2629800,
+    /**
+     * Average year (365.25d, accounting for leap years)
+     */
+    AverageYear = 31557600
+}
+
+export { Time, TimeSeconds };

package/dist/index.js

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Time: () => Time,
+  TimeSeconds: () => TimeSeconds
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/constants.ts
+var Time = /* @__PURE__ */ ((Time2) => {
+  Time2[Time2["Nanosecond"] = 1e-6] = "Nanosecond";
+  Time2[Time2["Microsecond"] = 1e-3] = "Microsecond";
+  Time2[Time2["Millisecond"] = 1] = "Millisecond";
+  Time2[Time2["Second"] = 1e3] = "Second";
+  Time2[Time2["Minute"] = 6e4] = "Minute";
+  Time2[Time2["Hour"] = 36e5] = "Hour";
+  Time2[Time2["Day"] = 864e5] = "Day";
+  Time2[Time2["Week"] = 6048e5] = "Week";
+  Time2[Time2["Month"] = 2592e6] = "Month";
+  Time2[Time2["Year"] = 31536e6] = "Year";
+  Time2[Time2["AverageMonth"] = 26298e5] = "AverageMonth";
+  Time2[Time2["AverageYear"] = 315576e5] = "AverageYear";
+  return Time2;
+})(Time || {});
+var TimeSeconds = /* @__PURE__ */ ((TimeSeconds2) => {
+  TimeSeconds2[TimeSeconds2["Nanosecond"] = 1e-9] = "Nanosecond";
+  TimeSeconds2[TimeSeconds2["Microsecond"] = 1e-6] = "Microsecond";
+  TimeSeconds2[TimeSeconds2["Millisecond"] = 1e-3] = "Millisecond";
+  TimeSeconds2[TimeSeconds2["Second"] = 1] = "Second";
+  TimeSeconds2[TimeSeconds2["Minute"] = 60] = "Minute";
+  TimeSeconds2[TimeSeconds2["Hour"] = 3600] = "Hour";
+  TimeSeconds2[TimeSeconds2["Day"] = 86400] = "Day";
+  TimeSeconds2[TimeSeconds2["Week"] = 604800] = "Week";
+  TimeSeconds2[TimeSeconds2["Month"] = 2592e3] = "Month";
+  TimeSeconds2[TimeSeconds2["Year"] = 31536e3] = "Year";
+  TimeSeconds2[TimeSeconds2["AverageMonth"] = 2629800] = "AverageMonth";
+  TimeSeconds2[TimeSeconds2["AverageYear"] = 31557600] = "AverageYear";
+  return TimeSeconds2;
+})(TimeSeconds || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Time,
+  TimeSeconds
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts"],"sourcesContent":["export * from \"./constants\";\n","/**\n * Common time constants, expressed in milliseconds.\n */\nexport enum Time {\n    Nanosecond = 0.000_001,\n    Microsecond = 0.001,\n    Millisecond = 1,\n    Second = 1_000,\n    Minute = 60_000,\n    Hour = 3_600_000,\n    Day = 86_400_000,\n    Week = 604_800_000,\n    /**\n     * 30 days\n     */\n    Month = 2_592_000_000,\n    /**\n     * 365 days\n     */\n    Year = 31_536_000_000,\n    /**\n     * Average month (365.25d / 12)\n     */\n    AverageMonth = 2_629_800_000,\n    /**\n     * Average year (365.25d, accounting for leap years)\n     */\n    AverageYear = 31_557_600_000,\n}\n\n/**\n * Common time constants, expressed in seconds.\n */\nexport enum TimeSeconds {\n    Nanosecond = 0.000_000_001,\n    Microsecond = 0.000_001,\n    Millisecond = 0.001,\n    Second = 1,\n    Minute = 60,\n    Hour = 3_600,\n    Day = 86_400,\n    Week = 604_800,\n    /**\n     * 30 days\n     */\n    Month = 2_592_000,\n    /**\n     * 365 days\n     */\n    Year = 31_536_000,\n    /**\n     * Average month (365.25d / 12)\n     */\n    AverageMonth = 2_629_800,\n    /**\n     * Average year (365.25d, accounting for leap years)\n     */\n    AverageYear = 31_557_600,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAK,OAAL,kBAAKA,UAAL;AACH,EAAAA,YAAA,gBAAa,QAAb;AACA,EAAAA,YAAA,iBAAc,QAAd;AACA,EAAAA,YAAA,iBAAc,KAAd;AACA,EAAAA,YAAA,YAAS,OAAT;AACA,EAAAA,YAAA,YAAS,OAAT;AACA,EAAAA,YAAA,UAAO,QAAP;AACA,EAAAA,YAAA,SAAM,SAAN;AACA,EAAAA,YAAA,UAAO,UAAP;AAIA,EAAAA,YAAA,WAAQ,UAAR;AAIA,EAAAA,YAAA,UAAO,WAAP;AAIA,EAAAA,YAAA,kBAAe,WAAf;AAIA,EAAAA,YAAA,iBAAc,YAAd;AAxBQ,SAAAA;AAAA,GAAA;AA8BL,IAAK,cAAL,kBAAKC,iBAAL;AACH,EAAAA,0BAAA,gBAAa,QAAb;AACA,EAAAA,0BAAA,iBAAc,QAAd;AACA,EAAAA,0BAAA,iBAAc,QAAd;AACA,EAAAA,0BAAA,YAAS,KAAT;AACA,EAAAA,0BAAA,YAAS,MAAT;AACA,EAAAA,0BAAA,UAAO,QAAP;AACA,EAAAA,0BAAA,SAAM,SAAN;AACA,EAAAA,0BAAA,UAAO,UAAP;AAIA,EAAAA,0BAAA,WAAQ,UAAR;AAIA,EAAAA,0BAAA,UAAO,WAAP;AAIA,EAAAA,0BAAA,kBAAe,WAAf;AAIA,EAAAA,0BAAA,iBAAc,YAAd;AAxBQ,SAAAA;AAAA,GAAA;","names":["Time","TimeSeconds"]}

package/dist/index.mjs

@@ -0,0 +1,36 @@
+// src/constants.ts
+var Time = /* @__PURE__ */ ((Time2) => {
+  Time2[Time2["Nanosecond"] = 1e-6] = "Nanosecond";
+  Time2[Time2["Microsecond"] = 1e-3] = "Microsecond";
+  Time2[Time2["Millisecond"] = 1] = "Millisecond";
+  Time2[Time2["Second"] = 1e3] = "Second";
+  Time2[Time2["Minute"] = 6e4] = "Minute";
+  Time2[Time2["Hour"] = 36e5] = "Hour";
+  Time2[Time2["Day"] = 864e5] = "Day";
+  Time2[Time2["Week"] = 6048e5] = "Week";
+  Time2[Time2["Month"] = 2592e6] = "Month";
+  Time2[Time2["Year"] = 31536e6] = "Year";
+  Time2[Time2["AverageMonth"] = 26298e5] = "AverageMonth";
+  Time2[Time2["AverageYear"] = 315576e5] = "AverageYear";
+  return Time2;
+})(Time || {});
+var TimeSeconds = /* @__PURE__ */ ((TimeSeconds2) => {
+  TimeSeconds2[TimeSeconds2["Nanosecond"] = 1e-9] = "Nanosecond";
+  TimeSeconds2[TimeSeconds2["Microsecond"] = 1e-6] = "Microsecond";
+  TimeSeconds2[TimeSeconds2["Millisecond"] = 1e-3] = "Millisecond";
+  TimeSeconds2[TimeSeconds2["Second"] = 1] = "Second";
+  TimeSeconds2[TimeSeconds2["Minute"] = 60] = "Minute";
+  TimeSeconds2[TimeSeconds2["Hour"] = 3600] = "Hour";
+  TimeSeconds2[TimeSeconds2["Day"] = 86400] = "Day";
+  TimeSeconds2[TimeSeconds2["Week"] = 604800] = "Week";
+  TimeSeconds2[TimeSeconds2["Month"] = 2592e3] = "Month";
+  TimeSeconds2[TimeSeconds2["Year"] = 31536e3] = "Year";
+  TimeSeconds2[TimeSeconds2["AverageMonth"] = 2629800] = "AverageMonth";
+  TimeSeconds2[TimeSeconds2["AverageYear"] = 31557600] = "AverageYear";
+  return TimeSeconds2;
+})(TimeSeconds || {});
+export {
+  Time,
+  TimeSeconds
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Common time constants, expressed in milliseconds.\n */\nexport enum Time {\n    Nanosecond = 0.000_001,\n    Microsecond = 0.001,\n    Millisecond = 1,\n    Second = 1_000,\n    Minute = 60_000,\n    Hour = 3_600_000,\n    Day = 86_400_000,\n    Week = 604_800_000,\n    /**\n     * 30 days\n     */\n    Month = 2_592_000_000,\n    /**\n     * 365 days\n     */\n    Year = 31_536_000_000,\n    /**\n     * Average month (365.25d / 12)\n     */\n    AverageMonth = 2_629_800_000,\n    /**\n     * Average year (365.25d, accounting for leap years)\n     */\n    AverageYear = 31_557_600_000,\n}\n\n/**\n * Common time constants, expressed in seconds.\n */\nexport enum TimeSeconds {\n    Nanosecond = 0.000_000_001,\n    Microsecond = 0.000_001,\n    Millisecond = 0.001,\n    Second = 1,\n    Minute = 60,\n    Hour = 3_600,\n    Day = 86_400,\n    Week = 604_800,\n    /**\n     * 30 days\n     */\n    Month = 2_592_000,\n    /**\n     * 365 days\n     */\n    Year = 31_536_000,\n    /**\n     * Average month (365.25d / 12)\n     */\n    AverageMonth = 2_629_800,\n    /**\n     * Average year (365.25d, accounting for leap years)\n     */\n    AverageYear = 31_557_600,\n}\n"],"mappings":";AAGO,IAAK,OAAL,kBAAKA,UAAL;AACH,EAAAA,YAAA,gBAAa,QAAb;AACA,EAAAA,YAAA,iBAAc,QAAd;AACA,EAAAA,YAAA,iBAAc,KAAd;AACA,EAAAA,YAAA,YAAS,OAAT;AACA,EAAAA,YAAA,YAAS,OAAT;AACA,EAAAA,YAAA,UAAO,QAAP;AACA,EAAAA,YAAA,SAAM,SAAN;AACA,EAAAA,YAAA,UAAO,UAAP;AAIA,EAAAA,YAAA,WAAQ,UAAR;AAIA,EAAAA,YAAA,UAAO,WAAP;AAIA,EAAAA,YAAA,kBAAe,WAAf;AAIA,EAAAA,YAAA,iBAAc,YAAd;AAxBQ,SAAAA;AAAA,GAAA;AA8BL,IAAK,cAAL,kBAAKC,iBAAL;AACH,EAAAA,0BAAA,gBAAa,QAAb;AACA,EAAAA,0BAAA,iBAAc,QAAd;AACA,EAAAA,0BAAA,iBAAc,QAAd;AACA,EAAAA,0BAAA,YAAS,KAAT;AACA,EAAAA,0BAAA,YAAS,MAAT;AACA,EAAAA,0BAAA,UAAO,QAAP;AACA,EAAAA,0BAAA,SAAM,SAAN;AACA,EAAAA,0BAAA,UAAO,UAAP;AAIA,EAAAA,0BAAA,WAAQ,UAAR;AAIA,EAAAA,0BAAA,UAAO,WAAP;AAIA,EAAAA,0BAAA,kBAAe,WAAf;AAIA,EAAAA,0BAAA,iBAAc,YAAd;AAxBQ,SAAAA;AAAA,GAAA;","names":["Time","TimeSeconds"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "$schema": "https://json.schemastore.org/package.json",
+    "name": "@sodiumlabs/duration",
+    "version": "1.0.0",
+    "description": "Time and duration utility package",
+    "keywords": [
+        "duration",
+        "sodium",
+        "sodiumlabs",
+        "time",
+        "typescript"
+    ],
+    "homepage": "https://github.com/sodium-labs/utilities/tree/main/packages/duration",
+    "bugs": {
+        "url": "https://github.com/sodium-labs/utilities/issues"
+    },
+    "license": "MIT",
+    "author": "sodiumlabs",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/sodium-labs/utilities.git",
+        "directory": "packages/duration"
+    },
+    "files": [
+        "dist"
+    ],
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "require": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            },
+            "import": {
+                "types": "./dist/index.d.mts",
+                "default": "./dist/index.mjs"
+            }
+        }
+    },
+    "scripts": {
+        "build": "tsup",
+        "build:docs": "tsc -p tsconfig.docs.json",
+        "lint": "tsc --noEmit && oxlint && oxfmt --check",
+        "fmt": "oxfmt",
+        "docs": "npm run build:docs && api-extractor run --local"
+    },
+    "devDependencies": {
+        "@microsoft/api-extractor": "^7.55.2",
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}