feat: ⌚ add duration object and duration parsing

apps/server/package.json

@@ -145,7 +145,7 @@
     "tildify": "^3.0.0",
     "tslib": "^2.6.2",
     "type-fest": "^4.9.0",
-    "typia": "^5.3.10",
+    "typia": "^5.4.1",
     "untildify": "^5.0.0"
   },
   "devDependencies": {

apps/server/src/common/modules/documentation/swagger/public/api/openapi3.json

@@ -348,7 +348,7 @@
             "required": true,
             "in": "query",
             "description": "Email of created account to which verification email should be sent",
-            "example": "Karen_Howell@gmail.com",
+            "example": "Adele.Flatley@hotmail.com",
             "schema": {
               "type": "string"
             }
@@ -628,7 +628,7 @@
           "email": {
             "type": "string",
             "description": "The domain's email address",
-            "example": "Karen_Howell@gmail.com",
+            "example": "Adele.Flatley@hotmail.com",
             "examples": [
               "[email protected]",
               "[email protected]",
@@ -648,11 +648,11 @@
           "username": {
             "type": "string",
             "description": "The account's username",
-            "example": "Amari.Zulauf",
+            "example": "Princess.Thompson",
             "examples": [
-              "Alexandro52",
-              "Delaney62",
-              "Blanche_Collins"
+              "Laurence.Olson11",
+              "Pascale.Jacobs",
+              "Selena4"
             ]
           }
         },
@@ -718,11 +718,11 @@
           "username": {
             "type": "string",
             "description": "The account's username",
-            "example": "Amari.Zulauf",
+            "example": "Princess.Thompson",
             "examples": [
-              "Alexandro52",
-              "Delaney62",
-              "Blanche_Collins"
+              "Laurence.Olson11",
+              "Pascale.Jacobs",
+              "Selena4"
             ]
           },
           "method": {
@@ -753,11 +753,11 @@
           "refreshToken": {
             "type": "string",
             "description": "...",
-            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
             "examples": [
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA"
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc"
             ]
           }
         },
@@ -774,11 +774,11 @@
           "refreshToken": {
             "type": "string",
             "description": "...",
-            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
             "examples": [
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA",
-              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MTU4NzQ1fQ.43iFIkGgTth7qeIJUq8aDszrANX5yS6atPMXgiYi-bA"
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc",
+              "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7fSwiaWF0IjoxNzA2MzY5NjI2fQ.pbghKh1uOH0MwXNKAccoEKHZt_Vf-29zAqkaDQGW2Mc"
             ]
           }
         },
@@ -797,7 +797,7 @@
           "email": {
             "type": "string",
             "description": "The domain's email address",
-            "example": "Karen_Howell@gmail.com",
+            "example": "Adele.Flatley@hotmail.com",
             "examples": [
               "[email protected]",
               "[email protected]",
@@ -807,16 +807,16 @@
           "emailVerified": {
             "type": "boolean",
             "description": "Indicates whether the email associated with a user domain has been verified",
-            "example": false
+            "example": true
           },
           "username": {
             "type": "string",
             "description": "The account's username",
-            "example": "Amari.Zulauf",
+            "example": "Princess.Thompson",
             "examples": [
-              "Alexandro52",
-              "Delaney62",
-              "Blanche_Collins"
+              "Laurence.Olson11",
+              "Pascale.Jacobs",
+              "Selena4"
             ]
           }
         },
@@ -834,21 +834,21 @@
           "username": {
             "type": "string",
             "description": "The account's username",
-            "example": "Amari.Zulauf",
+            "example": "Princess.Thompson",
             "examples": [
-              "Alexandro52",
-              "Delaney62",
-              "Blanche_Collins"
+              "Laurence.Olson11",
+              "Pascale.Jacobs",
+              "Selena4"
             ]
           },
           "password": {
             "type": "string",
             "description": "The account's password",
             "example": "SuperSecretPassword123!",
             "examples": [
-              "qgiqSFs8oWOu3ih",
-              "QDqADSHlHjHhHPu",
-              "mNsksiKfMgGWlql"
+              "6oShwbLlYXbonm3",
+              "XFWGOvXnglyN3M2",
+              "xNLUKsYo4m34yIO"
             ]
           }
         },

apps/server/src/common/std/duration/duration-class.ts

@@ -0,0 +1,25 @@
+import {ImmutableClass}     from '../../libraries/dst/data-class/data-class.js'
+import type {DurationString} from './duration-string.js'
+
+
+class Duration extends ImmutableClass   {
+	readonly years?: Duration.Years
+	readonly months?: Duration.Months
+	readonly days?: Duration.Days
+	readonly hours?: Duration.Hours
+	readonly minutes?: Duration.Minutes
+	readonly seconds?: Duration.Seconds
+	readonly milliseconds?: Duration.Milliseconds
+
+	static parse(duration: DurationLike): DurationX
+		{
+			// TODO: Create implementation of parsing duration objects
+
+			return DurationX.create({})
+		}
+
+	serialize(): DurationString
+		{
+			return "" as DurationString
+		}
+}

apps/server/src/common/std/duration/duration-string.ts

@@ -0,0 +1,6 @@
+import {tags} from 'typia'
+import type {Opaque} from '../../libraries/opaque.js'
+
+
+
+export type DurationString = Opaque<string & tags.Format<"duration">, 'duration'>

apps/server/src/common/std/duration/duration.ts

@@ -0,0 +1,88 @@
+import {tags}        from 'typia'
+import {ImmutableClass} from '../../libraries/dst/data-class/data-class.js'
+import type {Opaque} from '../../libraries/opaque.ts'
+import DurationString = Duration.DurationString
+import DurationString = Duration.DurationString
+
+export namespace Duration {
+
+	export type DurationString = Opaque<string & tags.Format<"duration">, 'duration'>
+
+	export type Years = Opaque<number, 'year'>
+
+	export namespace Years {
+		export function createYear(year: number): Years
+		{
+			return year as Years
+		}
+	}
+
+	export type Months = Opaque<number, 'month'>
+
+	export namespace Months {
+		export function createMonth(month: number): Months
+		{
+			return month as Months
+		}
+	}
+
+	export type Days = Opaque<number, 'day'>
+
+	export namespace Days {
+		export function createDay(day: number): Days
+		{
+			return day as Days
+		}
+	}
+
+	export type Hours = Opaque<number, 'hour'>
+
+	export namespace Hours {
+		export function createHour(hour: number): Hours
+		{
+			return hour as Hours
+		}
+	}
+
+	export type Minutes = Opaque<number, 'minute'>
+
+	export namespace Minutes {
+		export function createMinute(minute: number): Minutes
+		{
+			return minute as Minutes
+		}
+	}
+
+	export type Seconds = Opaque<number, 'second'>
+
+	export namespace Seconds {
+		export function createSecond(second: number): Seconds
+		{
+			return second as Seconds
+		}
+	}
+
+	export type Milliseconds = Opaque<number, 'millisecond'>
+
+	export namespace Milliseconds {
+		export function createMillisecond(millisecond: number): Milliseconds
+		{
+			return millisecond as Milliseconds
+		}
+	}
+
+	export type DurationUnit = Years | Months | Days | Hours | Minutes | Seconds | Milliseconds
+
+	export function parse(duration: DurationLike): Duration
+	{
+		return DurationX.parse(duration)
+	}
+
+
+}
+
+
+
+
+export type DurationLike = DurationObject | number | string | Duration.Milliseconds | DurationString
+

apps/server/src/main.ts

@@ -1,5 +1,5 @@
-import { bootstrap }            from './bootstrap.js'
-import { __appConfig }          from './configs/global/__config.js'
+import { bootstrap }   from './bootstrap.js'
+import { __appConfig } from './configs/global/__config.js'
 import { isProduction }         from './configs/helper/is-production.js'
 import { acquireProcessLock }   from './hooks/pre-start/acquire-process-lock.js'
 import { initializeSentry }     from './hooks/pre-start/initialize-sentry.js'