feat: Add DatabaseItem base type and require all DB records to have id and timestamp fields

Author: 3urobeat

src/composables/getItemsToShow.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-09-17 17:25:36
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-29 18:44:22
+ * Last Modified: 2026-05-04 22:52:51
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -15,7 +15,7 @@
  */
 
 
-import type { Item } from "~/model/item";
+import type { WardrobeItem } from "~/model/item";
 import { SortMode } from "~/model/sort-modes";
 import { State } from "./state";
 
@@ -26,7 +26,7 @@ import { State } from "./state";
  * @param selectedSort
  * @param selectedFilters
  */
-export default function(storedItems: Item[], selectedSort?: SortMode, selectedFilters?: string[]): Item[] {
+export default function(storedItems: WardrobeItem[], selectedSort?: SortMode, selectedFilters?: string[]): WardrobeItem[] {
 
     // Get search string ref from app.vue
     const searchStr: Ref<string|null> = useState(State.GLOBAL_SEARCH_STRING);

src/model/Implements.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-09-08 15:45:56
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-01 19:04:46
+ * Last Modified: 2026-05-04 22:52:22
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -15,38 +15,30 @@
  */
 
 
-import type { Implements } from "./Implements";
+import type { DatabaseItem } from "./storage";
 
 
 // Base type for Clothing & Outfit, used by generic components & composables.
-export type Item = {
-    id: string,
-    title: string,          // Used for sorting
-    labelIDs: string[], // Label[],        // Used as filters/for filtering
-    addedTimestamp: number,  // Used for sorting
-    modifiedTimestamp: number
+export interface WardrobeItem extends DatabaseItem {
+    title: string,      // Used for sorting
+    labelIDs: string[], // Used as filters/for filtering
 }
 
 
-// Implements Item
-export type Clothing = Implements<Item, {
+// Implements WardrobeItem
+export interface Clothing extends WardrobeItem {
     id: string,
     title: string,
     description: string,
     imgPath: string,
-    labelIDs: string[], // IMPORTANT: May reference non-existent labels if dataCleanUp job did not run yet!
-    addedTimestamp: number,
-    modifiedTimestamp: number
-}>
+    labelIDs: string[] // IMPORTANT: May reference non-existent labels if dataCleanUp job did not run yet!
+}
 
 
-// Implements Item
-export type Outfit = Implements<Item, {
-    id: string,
+// Implements WardrobeItem
+export interface Outfit extends WardrobeItem {
     title: string,
     clothes: { order: number, clothingID: string }[], // IMPORTANT: May reference non-existent clothes if dataCleanUp job did not run yet!
     labelIDs: string[],                               // IMPORTANT: May reference non-existent labels if dataCleanUp job did not run yet!
-    previewImgPath: string,
-    addedTimestamp: number,
-    modifiedTimestamp: number
-}>
+    previewImgPath: string
+}

src/model/item.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-12-31 17:00:33
  * Author: 3urobeat
  *
- * Last Modified: 2026-03-27 19:01:56
+ * Last Modified: 2026-05-04 22:52:23
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -16,11 +16,11 @@
 
 
 import type { Label } from "./label";
+import type { DatabaseItem } from "./storage";
 import type { TemperatureKelvin } from "./unit";
 
 
-export type Category = {
-    id: string,
+export interface Category extends DatabaseItem {
     name: string,
     specialityID: CategorySpecialityID
 }

src/model/label-category.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-09-09 21:59:50
  * Author: 3urobeat
  *
- * Last Modified: 2026-03-30 17:00:01
+ * Last Modified: 2026-05-04 22:52:28
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -14,17 +14,18 @@
  * You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 
+
 import type { Category } from "./label-category";
 import { CategorySpecialityMap } from "./label-category";
+import type { DatabaseItem } from "./storage";
 
 
 /**
  * Implements type definitions and operations on labels
  */
 
 
-export type Label = {
-    id: string,
+export interface Label extends DatabaseItem {
     name: string,
     orderIndex: number,         // Floating point number
     categoryID: string,         // IMPORTANT: May reference non-existent category if dataCleanUp job did not run yet!

src/model/label.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-09-08 15:21:35
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-29 18:48:38
+ * Last Modified: 2026-05-04 22:52:27
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -22,6 +22,25 @@ import { SortMode } from "./sort-modes";
 import type { Unit } from "./unit";
 
 
+// Fields every database record is required to have
+export interface DatabaseItem {
+    id: string,
+    addedTimestamp: number,
+    modifiedTimestamp: number
+}
+
+/**
+ * Updates metadata fields of a database item
+ * @param item Item to update
+ */
+export function updateDatabaseItemMetadata(item: DatabaseItem) {
+    if (!item.addedTimestamp) {
+        item.addedTimestamp = Date.now();
+    }
+    item.modifiedTimestamp = Date.now();
+}
+
+
 // Storage kinds used by Wardrobe
 export enum StorageKind {
     // LOCAL_STORAGE,          // Stored in Browser of user

src/model/storage.ts

@@ -5,7 +5,7 @@
  * Created Date: 2025-09-08 15:39:55
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-30 09:12:47
+ * Last Modified: 2026-05-04 22:52:32
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -224,7 +224,9 @@
                 name: name,
                 orderIndex: getNewLastLabelOrderIndex(getLabelsOfCategory(storedLabels.value.document!, thisCategory.id)),
                 categoryID: thisCategory.id,
-                specialityValue: CategorySpecialityMap[thisCategory.specialityID].value // Init val
+                specialityValue: CategorySpecialityMap[thisCategory.specialityID].value, // Init val
+                addedTimestamp: 0,
+                modifiedTimestamp: 0
             };
 
             // Send new label to server

src/pages/clothing/view.vue

@@ -5,7 +5,7 @@
  * Created Date: 2025-09-09 17:13:32
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-28 21:57:36
+ * Last Modified: 2026-05-04 22:52:34
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -209,7 +209,9 @@
             name: "",
             orderIndex: getNewLastLabelOrderIndex(labelsPerCategory[category.id]!),
             categoryID: category.id,
-            specialityValue: CategorySpecialityMap[category.specialityID].value // Init val
+            specialityValue: CategorySpecialityMap[category.specialityID].value, // Init val
+            addedTimestamp: 0,
+            modifiedTimestamp: 0
         };
 
         localLabels.value.push(newLabel);
@@ -269,7 +271,9 @@
         const e: Category = {
             id: await getUUIDFromServer(),
             name: "",
-            specialityID: CategorySpecialityID.No_Speciality
+            specialityID: CategorySpecialityID.No_Speciality,
+            addedTimestamp: 0,
+            modifiedTimestamp: 0
         };
 
         localCategories.value.push(e);

src/pages/labels/index.vue

@@ -4,7 +4,7 @@
  * Created Date: 2025-12-06 17:28:44
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-01 18:32:45
+ * Last Modified: 2026-05-04 22:52:38
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -19,7 +19,7 @@ import nedb from "@seald-io/nedb";
 import crypto from "node:crypto";
 import { SubscriptionEventAction } from "~/model/api";
 import type { Clothing } from "~/model/item";
-import { StorageKind } from "~/model/storage";
+import { StorageKind, updateDatabaseItemMetadata } from "~/model/storage";
 import { updateImagesOfAffectedOutfits } from "~/server/utils/outfitPreviewImage";
 
 
@@ -50,11 +50,7 @@ export async function upsertClothing(clothing: Clothing): Promise<Clothing | nul
     }
 
     // Update metadata
-    if (!clothing.addedTimestamp) {
-        clothing.addedTimestamp = Date.now();
-    }
-
-    clothing.modifiedTimestamp = Date.now();
+    updateDatabaseItemMetadata(clothing);
 
     // Unused image will be deleted by periodic database cleanup job
 

src/server/utils/useClothesDb.ts

@@ -4,7 +4,7 @@
  * Created Date: 2025-12-06 17:28:44
  * Author: 3urobeat
  *
- * Last Modified: 2026-04-01 18:32:48
+ * Last Modified: 2026-05-04 22:52:40
  * Modified By: 3urobeat
  *
  * Copyright (c) 2025 - 2026 3urobeat <https://github.com/3urobeat>
@@ -19,7 +19,7 @@ import nedb from "@seald-io/nedb";
 import { SubscriptionEventAction } from "~/model/api";
 import type { Label } from "~/model/label";
 import type { Category } from "~/model/label-category";
-import { StorageKind } from "~/model/storage";
+import { StorageKind, updateDatabaseItemMetadata } from "~/model/storage";
 
 
 // Load database
@@ -49,6 +49,9 @@ async function upsertLabel(label: Label): Promise<Label | null> {
         label.id = crypto.randomUUID();
     }
 
+    // Update metadata
+    updateDatabaseItemMetadata(label);
+
     const res      = await labelsDb.updateAsync({ id: label.id }, { $set: label }, { upsert: true, returnUpdatedDocs: true });
     const affected = res.affectedDocuments ? res.affectedDocuments as unknown as Label : null;
 
@@ -132,6 +135,9 @@ async function upsertLabelCategory(category: Category): Promise<Category | null>
         category.id = crypto.randomUUID();
     }
 
+    // Update metadata
+    updateDatabaseItemMetadata(category);
+
     const res      = await labelCategoriesDb.updateAsync({ id: category.id }, { $set: category }, { upsert: true, returnUpdatedDocs: true });
     const affected = res.affectedDocuments ? res.affectedDocuments as unknown as Category : null;