@aneuhold/be-ts-db-lib 2.0.78 → 2.0.80

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## 🔖 [2.0.80] (2025-10-17)
+
+### 🏗️ Changed
+
+- Improved and expanded JSDoc comments and documentation for public types and methods throughout the package
+
+## 🔖 [2.0.79] (2025-08-18)
+
+### ✅ Added
+
+- Added `DemoAccountsService` and `DashboardDemoAccountsService` for seeding demo accounts and demo data for dashboard users
+- Utilities to create, reset, and seed demo users with example tasks, collaborators, and user configs
+- Shared and non-shared demo task creation logic for onboarding/testing
+
 ## 🔖 [2.0.78] (2025-07-04)
 
 ### 🏗️ Changed
@@ -38,6 +52,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 <!-- Link References -->
 
+[2.0.80]: https://github.com/aneuhold/ts-libs/compare/be-ts-db-lib-v2.0.79...be-ts-db-lib-v2.0.80
+[2.0.79]: https://github.com/aneuhold/ts-libs/compare/be-ts-db-lib-v2.0.78...be-ts-db-lib-v2.0.79
 [2.0.78]: https://github.com/aneuhold/ts-libs/compare/be-ts-db-lib-v2.0.77...be-ts-db-lib-v2.0.78
 [2.0.77]: https://github.com/aneuhold/ts-libs/compare/be-ts-db-lib-v2.0.76...be-ts-db-lib-v2.0.77
 [2.0.76]: https://github.com/aneuhold/ts-libs/compare/be-ts-db-lib-v2.0.75...be-ts-db-lib-v2.0.76

package/lib/services/DemoAccountsService/DashboardDemoAccountsService.d.ts

@@ -0,0 +1,72 @@
+import { ObjectId } from 'bson';
+/**
+ * Dashboard-specific demo seeding utilities.
+ */
+export default class DashboardDemoAccountsService {
+    /**
+     * Default priorities for known demo tags. If a tag is not listed here,
+     * a fallback priority will be used.
+     */
+    private static readonly TAG_PRIORITY;
+    /**
+     * Seeds the dashboard demo data for two users. This will:
+     * - Ensure both users have configs and are collaborators of each other
+     * - Reset select config flags (enableDevMode, useConfettiForTasks, catImageOnHomePage)
+     * - Wipe all tasks owned by either user
+     * - Create example tasks (shared, nested, completed, with tags)
+     *
+     * Safe to re-run; will produce the same end state.
+     *
+     * @param demoUser1Id The first user
+     * @param demoUser2Id The second user
+     */
+    static seedDemoAccounts(demoUser1Id: ObjectId, demoUser2Id: ObjectId): Promise<void>;
+    /**
+     * Ensures user has a config with the collaborator, and resets specific flags.
+     *
+     * @param ownerId The config owner
+     * @param collaboratorId The collaborator to include
+     */
+    private static ensureCollaboratorsAndResetConfig;
+    /**
+     * Deletes all tasks owned by the provided users. Children are also removed
+     * since they share the same owner.
+     *
+     * @param userIds The users to wipe tasks for
+     */
+    private static wipeTasksForUsers;
+    /**
+     * Creates a task owned by the specified user. Because we wipe all tasks
+     * for the demo users prior to creation, we don't need to check for
+     * existing tasks and can always insert.
+     *
+     * @param ownerId The owning user ID
+     * @param title The task title
+     * @param opts Additional optional task properties
+     * @param opts.description Description text
+     * @param opts.completed Completion flag
+     * @param opts.parentTaskId Parent task reference for subtasks
+     * @param opts.sharedWith Users the task is shared with
+     * @param opts.assignedTo The assigned user
+     * @param opts.tags Tags for the owning user
+     * @param opts.startDate Optional start date
+     * @param opts.dueDate Optional due date
+     * @param opts.category System category
+     */
+    private static createTask;
+    /**
+     * Creates shared demo tasks visible to both users exactly once to avoid duplicates.
+     *
+     * @param user1Id The primary owner of some shared tasks
+     * @param user2Id The collaborator for shared tasks
+     */
+    private static createExampleTasks;
+    /**
+     * Creates non-shared demo tasks for each user.
+     *
+     * @param user1Id The first user
+     * @param user2Id The second user
+     */
+    private static createNonSharedTasks;
+}
+//# sourceMappingURL=DashboardDemoAccountsService.d.ts.map

package/lib/services/DemoAccountsService/DashboardDemoAccountsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardDemoAccountsService.d.ts","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/DashboardDemoAccountsService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAIhC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,4BAA4B;IAC/C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAUlC;IAEF;;;;;;;;;;;OAWG;WACU,gBAAgB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1F;;;;;OAKG;mBACkB,iCAAiC;IA4BtD;;;;;OAKG;mBACkB,iBAAiB;IAYtC;;;;;;;;;;;;;;;;;OAiBG;mBACkB,UAAU;IAgC/B;;;;;OAKG;mBACkB,kBAAkB;IAqCvC;;;;;OAKG;mBACkB,oBAAoB;CAwD1C"}

package/lib/services/DemoAccountsService/DashboardDemoAccountsService.js

@@ -0,0 +1,234 @@
+import { DashboardTask, DashboardUserConfig } from '@aneuhold/core-ts-db-lib';
+import DashboardTaskRepository from '../../repositories/dashboard/DashboardTaskRepository.js';
+import DashboardUserConfigRepository from '../../repositories/dashboard/DashboardUserConfigRepository.js';
+/**
+ * Dashboard-specific demo seeding utilities.
+ */
+export default class DashboardDemoAccountsService {
+    /**
+     * Default priorities for known demo tags. If a tag is not listed here,
+     * a fallback priority will be used.
+     */
+    static TAG_PRIORITY = {
+        planning: 9,
+        fun: 8,
+        booking: 7,
+        food: 6,
+        home: 5,
+        bbq: 4,
+        admin: 3,
+        paint: 2,
+        electric: 1
+    };
+    /**
+     * Seeds the dashboard demo data for two users. This will:
+     * - Ensure both users have configs and are collaborators of each other
+     * - Reset select config flags (enableDevMode, useConfettiForTasks, catImageOnHomePage)
+     * - Wipe all tasks owned by either user
+     * - Create example tasks (shared, nested, completed, with tags)
+     *
+     * Safe to re-run; will produce the same end state.
+     *
+     * @param demoUser1Id The first user
+     * @param demoUser2Id The second user
+     */
+    static async seedDemoAccounts(demoUser1Id, demoUser2Id) {
+        await this.ensureCollaboratorsAndResetConfig(demoUser1Id, demoUser2Id);
+        await this.ensureCollaboratorsAndResetConfig(demoUser2Id, demoUser1Id);
+        await this.wipeTasksForUsers([demoUser1Id, demoUser2Id]);
+        // Create shared tasks (visible to both users) exactly once
+        await this.createExampleTasks(demoUser1Id, demoUser2Id);
+        // Create non-shared tasks for each user
+        await this.createNonSharedTasks(demoUser1Id, demoUser2Id);
+    }
+    /**
+     * Ensures user has a config with the collaborator, and resets specific flags.
+     *
+     * @param ownerId The config owner
+     * @param collaboratorId The collaborator to include
+     */
+    static async ensureCollaboratorsAndResetConfig(ownerId, collaboratorId) {
+        const cfgRepo = DashboardUserConfigRepository.getRepo();
+        let cfg = await cfgRepo.getForUser(ownerId);
+        let isNew = false;
+        if (!cfg) {
+            cfg = new DashboardUserConfig(ownerId);
+            isNew = true;
+        }
+        // Ensure collaborator and reset flags
+        cfg.collaborators = [collaboratorId];
+        cfg.enableDevMode = true;
+        cfg.enabledFeatures.useConfettiForTasks = true;
+        cfg.enabledFeatures.catImageOnHomePage = false;
+        // Reset tag settings and seed priorities for demo tags
+        cfg.tagSettings = {};
+        for (const [tag, priority] of Object.entries(this.TAG_PRIORITY)) {
+            cfg.tagSettings[tag] = { priority };
+        }
+        if (isNew) {
+            await cfgRepo.insertNew(cfg);
+        }
+        else {
+            await cfgRepo.update(cfg);
+        }
+    }
+    /**
+     * Deletes all tasks owned by the provided users. Children are also removed
+     * since they share the same owner.
+     *
+     * @param userIds The users to wipe tasks for
+     */
+    static async wipeTasksForUsers(userIds) {
+        const taskRepo = DashboardTaskRepository.getRepo();
+        // Delete per-user using repo.deleteList to leverage child cleanup logic.
+        for (const userId of userIds) {
+            const allVisible = await taskRepo.getAllForUser(userId);
+            const owned = allVisible.filter((t) => t.userId.equals(userId));
+            if (owned.length === 0)
+                continue;
+            const ids = owned.map((t) => t._id);
+            await taskRepo.deleteList(ids);
+        }
+    }
+    /**
+     * Creates a task owned by the specified user. Because we wipe all tasks
+     * for the demo users prior to creation, we don't need to check for
+     * existing tasks and can always insert.
+     *
+     * @param ownerId The owning user ID
+     * @param title The task title
+     * @param opts Additional optional task properties
+     * @param opts.description Description text
+     * @param opts.completed Completion flag
+     * @param opts.parentTaskId Parent task reference for subtasks
+     * @param opts.sharedWith Users the task is shared with
+     * @param opts.assignedTo The assigned user
+     * @param opts.tags Tags for the owning user
+     * @param opts.startDate Optional start date
+     * @param opts.dueDate Optional due date
+     * @param opts.category System category
+     */
+    static async createTask(ownerId, title, opts) {
+        const taskRepo = DashboardTaskRepository.getRepo();
+        const task = new DashboardTask(ownerId);
+        task.title = title;
+        if (opts?.description)
+            task.description = opts.description;
+        if (opts?.completed !== undefined)
+            task.completed = opts.completed;
+        if (opts?.parentTaskId)
+            task.parentTaskId = opts.parentTaskId;
+        if (opts?.sharedWith)
+            task.sharedWith = opts.sharedWith;
+        if (opts?.assignedTo)
+            task.assignedTo = opts.assignedTo;
+        if (opts?.category)
+            task.category = opts.category;
+        if (opts?.startDate)
+            task.startDate = opts.startDate;
+        if (opts?.dueDate)
+            task.dueDate = opts.dueDate;
+        task.tags[ownerId.toString()] = opts?.tags ?? [];
+        const inserted = await taskRepo.insertNew(task);
+        return inserted ?? task;
+    }
+    /**
+     * Creates shared demo tasks visible to both users exactly once to avoid duplicates.
+     *
+     * @param user1Id The primary owner of some shared tasks
+     * @param user2Id The collaborator for shared tasks
+     */
+    static async createExampleTasks(user1Id, user2Id) {
+        // Shared parent task (owned by user1, shared with user2)
+        const parent = await this.createTask(user1Id, 'Plan weekend trip', {
+            description: 'Decide destination and plan activities for the weekend.',
+            sharedWith: [user2Id],
+            tags: ['planning', 'fun']
+        });
+        const child1 = await this.createTask(user1Id, 'Book hotel', {
+            parentTaskId: parent._id,
+            tags: ['booking']
+        });
+        await this.createTask(user1Id, 'Create itinerary', {
+            parentTaskId: parent._id,
+            tags: ['planning']
+        });
+        await this.createTask(user1Id, 'Pack bags', { parentTaskId: parent._id });
+        await this.createTask(user1Id, 'Buy snacks', {
+            parentTaskId: child1._id,
+            completed: true,
+            tags: ['food']
+        });
+        // Shared task assigned to user2 (owned by user1)
+        await this.createTask(user1Id, 'Buy groceries for BBQ', {
+            sharedWith: [user2Id],
+            assignedTo: user2Id,
+            tags: ['home', 'bbq']
+        });
+        // A shared planning task owned by user2
+        await this.createTask(user2Id, 'Plan potluck dinner', {
+            sharedWith: [user1Id],
+            assignedTo: user1Id,
+            tags: ['food', 'planning']
+        });
+    }
+    /**
+     * Creates non-shared demo tasks for each user.
+     *
+     * @param user1Id The first user
+     * @param user2Id The second user
+     */
+    static async createNonSharedTasks(user1Id, user2Id) {
+        const now = new Date();
+        const futureDue = new Date(now.getTime());
+        futureDue.setMonth(futureDue.getMonth() + 4);
+        const pastDue = new Date(now.getTime());
+        const pastDueStart = new Date(now.getTime());
+        pastDue.setDate(pastDue.getDate() - 7);
+        pastDueStart.setDate(pastDueStart.getDate() - 14);
+        // User 1: A completed solo task
+        await this.createTask(user1Id, 'Renew car registration', {
+            completed: true,
+            tags: ['admin']
+        });
+        // User 2: Own parent task with subtasks (not shared)
+        const u2Parent = await this.createTask(user2Id, 'Home improvement project', {
+            description: 'Small updates around the house.',
+            tags: ['home']
+        });
+        await this.createTask(user2Id, 'Paint living room walls', {
+            parentTaskId: u2Parent._id,
+            completed: true,
+            tags: ['paint']
+        });
+        await this.createTask(user2Id, 'Replace light fixtures', {
+            parentTaskId: u2Parent._id,
+            tags: ['electric']
+        });
+        // Root task with a future due date (>= 4 months out)
+        await this.createTask(user1Id, 'Schedule annual physical', {
+            description: 'Book an appointment and add to calendar.',
+            dueDate: futureDue,
+            tags: ['admin']
+        });
+        await this.createTask(user2Id, 'Schedule annual physical', {
+            description: 'Book an appointment and add to calendar.',
+            dueDate: futureDue,
+            tags: ['admin']
+        });
+        // Past-due task
+        await this.createTask(user1Id, 'Submit expense report', {
+            description: 'Collect receipts and submit to finance.',
+            startDate: pastDueStart,
+            dueDate: pastDue,
+            tags: ['admin']
+        });
+        await this.createTask(user2Id, 'Submit expense report', {
+            description: 'Collect receipts and submit to finance.',
+            startDate: pastDueStart,
+            dueDate: pastDue,
+            tags: ['admin']
+        });
+    }
+}
+//# sourceMappingURL=DashboardDemoAccountsService.js.map

package/lib/services/DemoAccountsService/DashboardDemoAccountsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardDemoAccountsService.js","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/DashboardDemoAccountsService.ts"],"names":[],"mappings":"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"}

package/lib/services/DemoAccountsService/DashboardDemoAccountsService.ts

@@ -0,0 +1,257 @@
+import { DashboardTask, DashboardUserConfig } from '@aneuhold/core-ts-db-lib';
+import { ObjectId } from 'bson';
+import DashboardTaskRepository from '../../repositories/dashboard/DashboardTaskRepository.js';
+import DashboardUserConfigRepository from '../../repositories/dashboard/DashboardUserConfigRepository.js';
+
+/**
+ * Dashboard-specific demo seeding utilities.
+ */
+export default class DashboardDemoAccountsService {
+  /**
+   * Default priorities for known demo tags. If a tag is not listed here,
+   * a fallback priority will be used.
+   */
+  private static readonly TAG_PRIORITY: Record<string, number> = {
+    planning: 9,
+    fun: 8,
+    booking: 7,
+    food: 6,
+    home: 5,
+    bbq: 4,
+    admin: 3,
+    paint: 2,
+    electric: 1
+  };
+
+  /**
+   * Seeds the dashboard demo data for two users. This will:
+   * - Ensure both users have configs and are collaborators of each other
+   * - Reset select config flags (enableDevMode, useConfettiForTasks, catImageOnHomePage)
+   * - Wipe all tasks owned by either user
+   * - Create example tasks (shared, nested, completed, with tags)
+   *
+   * Safe to re-run; will produce the same end state.
+   *
+   * @param demoUser1Id The first user
+   * @param demoUser2Id The second user
+   */
+  static async seedDemoAccounts(demoUser1Id: ObjectId, demoUser2Id: ObjectId): Promise<void> {
+    await this.ensureCollaboratorsAndResetConfig(demoUser1Id, demoUser2Id);
+    await this.ensureCollaboratorsAndResetConfig(demoUser2Id, demoUser1Id);
+
+    await this.wipeTasksForUsers([demoUser1Id, demoUser2Id]);
+
+    // Create shared tasks (visible to both users) exactly once
+    await this.createExampleTasks(demoUser1Id, demoUser2Id);
+    // Create non-shared tasks for each user
+    await this.createNonSharedTasks(demoUser1Id, demoUser2Id);
+  }
+
+  /**
+   * Ensures user has a config with the collaborator, and resets specific flags.
+   *
+   * @param ownerId The config owner
+   * @param collaboratorId The collaborator to include
+   */
+  private static async ensureCollaboratorsAndResetConfig(
+    ownerId: ObjectId,
+    collaboratorId: ObjectId
+  ): Promise<void> {
+    const cfgRepo = DashboardUserConfigRepository.getRepo();
+    let cfg = await cfgRepo.getForUser(ownerId);
+    let isNew = false;
+    if (!cfg) {
+      cfg = new DashboardUserConfig(ownerId);
+      isNew = true;
+    }
+    // Ensure collaborator and reset flags
+    cfg.collaborators = [collaboratorId];
+    cfg.enableDevMode = true;
+    cfg.enabledFeatures.useConfettiForTasks = true;
+    cfg.enabledFeatures.catImageOnHomePage = false;
+    // Reset tag settings and seed priorities for demo tags
+    cfg.tagSettings = {};
+    for (const [tag, priority] of Object.entries(this.TAG_PRIORITY)) {
+      cfg.tagSettings[tag] = { priority };
+    }
+    if (isNew) {
+      await cfgRepo.insertNew(cfg);
+    } else {
+      await cfgRepo.update(cfg);
+    }
+  }
+
+  /**
+   * Deletes all tasks owned by the provided users. Children are also removed
+   * since they share the same owner.
+   *
+   * @param userIds The users to wipe tasks for
+   */
+  private static async wipeTasksForUsers(userIds: ObjectId[]): Promise<void> {
+    const taskRepo = DashboardTaskRepository.getRepo();
+    // Delete per-user using repo.deleteList to leverage child cleanup logic.
+    for (const userId of userIds) {
+      const allVisible = await taskRepo.getAllForUser(userId);
+      const owned = allVisible.filter((t) => t.userId.equals(userId));
+      if (owned.length === 0) continue;
+      const ids = owned.map((t) => t._id);
+      await taskRepo.deleteList(ids);
+    }
+  }
+
+  /**
+   * Creates a task owned by the specified user. Because we wipe all tasks
+   * for the demo users prior to creation, we don't need to check for
+   * existing tasks and can always insert.
+   *
+   * @param ownerId The owning user ID
+   * @param title The task title
+   * @param opts Additional optional task properties
+   * @param opts.description Description text
+   * @param opts.completed Completion flag
+   * @param opts.parentTaskId Parent task reference for subtasks
+   * @param opts.sharedWith Users the task is shared with
+   * @param opts.assignedTo The assigned user
+   * @param opts.tags Tags for the owning user
+   * @param opts.startDate Optional start date
+   * @param opts.dueDate Optional due date
+   * @param opts.category System category
+   */
+  private static async createTask(
+    ownerId: ObjectId,
+    title: string,
+    opts?: {
+      description?: string;
+      completed?: boolean;
+      parentTaskId?: ObjectId;
+      sharedWith?: ObjectId[];
+      assignedTo?: ObjectId;
+      tags?: string[];
+      startDate?: Date;
+      dueDate?: Date;
+      category?: string;
+    }
+  ): Promise<DashboardTask> {
+    const taskRepo = DashboardTaskRepository.getRepo();
+    const task = new DashboardTask(ownerId);
+    task.title = title;
+    if (opts?.description) task.description = opts.description;
+    if (opts?.completed !== undefined) task.completed = opts.completed;
+    if (opts?.parentTaskId) task.parentTaskId = opts.parentTaskId;
+    if (opts?.sharedWith) task.sharedWith = opts.sharedWith;
+    if (opts?.assignedTo) task.assignedTo = opts.assignedTo;
+    if (opts?.category) task.category = opts.category;
+    if (opts?.startDate) task.startDate = opts.startDate;
+    if (opts?.dueDate) task.dueDate = opts.dueDate;
+    task.tags[ownerId.toString()] = opts?.tags ?? [];
+
+    const inserted = await taskRepo.insertNew(task);
+    return inserted ?? task;
+  }
+
+  /**
+   * Creates shared demo tasks visible to both users exactly once to avoid duplicates.
+   *
+   * @param user1Id The primary owner of some shared tasks
+   * @param user2Id The collaborator for shared tasks
+   */
+  private static async createExampleTasks(user1Id: ObjectId, user2Id: ObjectId) {
+    // Shared parent task (owned by user1, shared with user2)
+    const parent = await this.createTask(user1Id, 'Plan weekend trip', {
+      description: 'Decide destination and plan activities for the weekend.',
+      sharedWith: [user2Id],
+      tags: ['planning', 'fun']
+    });
+    const child1 = await this.createTask(user1Id, 'Book hotel', {
+      parentTaskId: parent._id,
+      tags: ['booking']
+    });
+    await this.createTask(user1Id, 'Create itinerary', {
+      parentTaskId: parent._id,
+      tags: ['planning']
+    });
+    await this.createTask(user1Id, 'Pack bags', { parentTaskId: parent._id });
+    await this.createTask(user1Id, 'Buy snacks', {
+      parentTaskId: child1._id,
+      completed: true,
+      tags: ['food']
+    });
+
+    // Shared task assigned to user2 (owned by user1)
+    await this.createTask(user1Id, 'Buy groceries for BBQ', {
+      sharedWith: [user2Id],
+      assignedTo: user2Id,
+      tags: ['home', 'bbq']
+    });
+
+    // A shared planning task owned by user2
+    await this.createTask(user2Id, 'Plan potluck dinner', {
+      sharedWith: [user1Id],
+      assignedTo: user1Id,
+      tags: ['food', 'planning']
+    });
+  }
+
+  /**
+   * Creates non-shared demo tasks for each user.
+   *
+   * @param user1Id The first user
+   * @param user2Id The second user
+   */
+  private static async createNonSharedTasks(user1Id: ObjectId, user2Id: ObjectId) {
+    const now = new Date();
+    const futureDue = new Date(now.getTime());
+    futureDue.setMonth(futureDue.getMonth() + 4);
+    const pastDue = new Date(now.getTime());
+    const pastDueStart = new Date(now.getTime());
+    pastDue.setDate(pastDue.getDate() - 7);
+    pastDueStart.setDate(pastDueStart.getDate() - 14);
+
+    // User 1: A completed solo task
+    await this.createTask(user1Id, 'Renew car registration', {
+      completed: true,
+      tags: ['admin']
+    });
+
+    // User 2: Own parent task with subtasks (not shared)
+    const u2Parent = await this.createTask(user2Id, 'Home improvement project', {
+      description: 'Small updates around the house.',
+      tags: ['home']
+    });
+    await this.createTask(user2Id, 'Paint living room walls', {
+      parentTaskId: u2Parent._id,
+      completed: true,
+      tags: ['paint']
+    });
+    await this.createTask(user2Id, 'Replace light fixtures', {
+      parentTaskId: u2Parent._id,
+      tags: ['electric']
+    });
+
+    // Root task with a future due date (>= 4 months out)
+    await this.createTask(user1Id, 'Schedule annual physical', {
+      description: 'Book an appointment and add to calendar.',
+      dueDate: futureDue,
+      tags: ['admin']
+    });
+    await this.createTask(user2Id, 'Schedule annual physical', {
+      description: 'Book an appointment and add to calendar.',
+      dueDate: futureDue,
+      tags: ['admin']
+    });
+
+    // Past-due task
+    await this.createTask(user1Id, 'Submit expense report', {
+      description: 'Collect receipts and submit to finance.',
+      startDate: pastDueStart,
+      dueDate: pastDue,
+      tags: ['admin']
+    });
+    await this.createTask(user2Id, 'Submit expense report', {
+      description: 'Collect receipts and submit to finance.',
+      startDate: pastDueStart,
+      dueDate: pastDue,
+      tags: ['admin']
+    });
+  }
+}

package/lib/services/DemoAccountsService/DemoAccountsService.d.ts

@@ -0,0 +1,17 @@
+import { ObjectId } from 'bson';
+/**
+ * Entry point for seeding demo accounts across projects.
+ *
+ * This class exposes static helpers that delegate to project-specific
+ * implementations (e.g., dashboard).
+ */
+export default class DemoAccountsService {
+    /**
+     * Seeds demo accounts for the Dashboard project only.
+     *
+     * @param demoUser1Id The first demo user ID
+     * @param demoUser2Id The second demo user ID
+     */
+    static seedDashboardDemoAccounts(demoUser1Id: ObjectId, demoUser2Id: ObjectId): Promise<void>;
+}
+//# sourceMappingURL=DemoAccountsService.d.ts.map

package/lib/services/DemoAccountsService/DemoAccountsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoAccountsService.d.ts","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/DemoAccountsService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGhC;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC;;;;;OAKG;WACU,yBAAyB,CACpC,WAAW,EAAE,QAAQ,EACrB,WAAW,EAAE,QAAQ,GACpB,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/lib/services/DemoAccountsService/DemoAccountsService.js

@@ -0,0 +1,19 @@
+import DashboardDemoAccountsService from './DashboardDemoAccountsService.js';
+/**
+ * Entry point for seeding demo accounts across projects.
+ *
+ * This class exposes static helpers that delegate to project-specific
+ * implementations (e.g., dashboard).
+ */
+export default class DemoAccountsService {
+    /**
+     * Seeds demo accounts for the Dashboard project only.
+     *
+     * @param demoUser1Id The first demo user ID
+     * @param demoUser2Id The second demo user ID
+     */
+    static async seedDashboardDemoAccounts(demoUser1Id, demoUser2Id) {
+        await DashboardDemoAccountsService.seedDemoAccounts(demoUser1Id, demoUser2Id);
+    }
+}
+//# sourceMappingURL=DemoAccountsService.js.map

package/lib/services/DemoAccountsService/DemoAccountsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoAccountsService.js","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/DemoAccountsService.ts"],"names":[],"mappings":"AACA,OAAO,4BAA4B,MAAM,mCAAmC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,yBAAyB,CACpC,WAAqB,EACrB,WAAqB;QAErB,MAAM,4BAA4B,CAAC,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAChF,CAAC;CACF"}

package/lib/services/DemoAccountsService/DemoAccountsService.ts

@@ -0,0 +1,23 @@
+import { ObjectId } from 'bson';
+import DashboardDemoAccountsService from './DashboardDemoAccountsService.js';
+
+/**
+ * Entry point for seeding demo accounts across projects.
+ *
+ * This class exposes static helpers that delegate to project-specific
+ * implementations (e.g., dashboard).
+ */
+export default class DemoAccountsService {
+  /**
+   * Seeds demo accounts for the Dashboard project only.
+   *
+   * @param demoUser1Id The first demo user ID
+   * @param demoUser2Id The second demo user ID
+   */
+  static async seedDashboardDemoAccounts(
+    demoUser1Id: ObjectId,
+    demoUser2Id: ObjectId
+  ): Promise<void> {
+    await DashboardDemoAccountsService.seedDemoAccounts(demoUser1Id, demoUser2Id);
+  }
+}

package/lib/services/DemoAccountsService/index.d.ts

@@ -0,0 +1,2 @@
+export { default as DemoAccountsService } from './DemoAccountsService.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/services/DemoAccountsService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/services/DemoAccountsService/index.js

@@ -0,0 +1,2 @@
+export { default as DemoAccountsService } from './DemoAccountsService.js';
+//# sourceMappingURL=index.js.map

package/lib/services/DemoAccountsService/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/DemoAccountsService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/services/DemoAccountsService/index.ts

@@ -0,0 +1 @@
+export { default as DemoAccountsService } from './DemoAccountsService.js';

package/lib/util/DocumentDb.d.ts

@@ -7,8 +7,24 @@ export default class DocumentDb {
     private static DB_NAME;
     private static mongoClient;
     private static db;
+    /**
+     * Gets or creates the MongoDB client instance.
+     *
+     * @returns A promise that resolves to the MongoDB client.
+     */
     private static getClient;
+    /**
+     * Gets a MongoDB collection with the specified type.
+     *
+     * @param collectionName - The name of the collection to retrieve.
+     * @returns A promise that resolves to the typed MongoDB collection.
+     */
     static getCollection<TDocType extends Document>(collectionName: string): Promise<Collection<TDocType>>;
+    /**
+     * Closes the active MongoDB connection.
+     *
+     * @returns A promise that resolves when the connection is closed.
+     */
     static closeDbConnection(): Promise<void>;
 }
 //# sourceMappingURL=DocumentDb.d.ts.map

package/lib/util/DocumentDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentDb.d.ts","sourceRoot":"","sources":["../../src/util/DocumentDb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAa;IAEnC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA0B;IAEpD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAiB;mBAEb,SAAS;WAiBjB,aAAa,CAAC,QAAQ,SAAS,QAAQ,EAClD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;WAQnB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhD"}
+{"version":3,"file":"DocumentDb.d.ts","sourceRoot":"","sources":["../../src/util/DocumentDb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAa;IAEnC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA0B;IAEpD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAiB;IAElC;;;;OAIG;mBACkB,SAAS;IAiB9B;;;;;OAKG;WACU,aAAa,CAAC,QAAQ,SAAS,QAAQ,EAClD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAQhC;;;;OAIG;WACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhD"}

package/lib/util/DocumentDb.js

@@ -7,6 +7,11 @@ export default class DocumentDb {
     static DB_NAME = 'default';
     static mongoClient;
     static db;
+    /**
+     * Gets or creates the MongoDB client instance.
+     *
+     * @returns A promise that resolves to the MongoDB client.
+     */
     static async getClient() {
         if (!ConfigService.isInitialized) {
             // Hard-coded local for now until there are move envs.
@@ -23,6 +28,12 @@ export default class DocumentDb {
         await this.mongoClient.connect();
         return this.mongoClient;
     }
+    /**
+     * Gets a MongoDB collection with the specified type.
+     *
+     * @param collectionName - The name of the collection to retrieve.
+     * @returns A promise that resolves to the typed MongoDB collection.
+     */
     static async getCollection(collectionName) {
         const client = await this.getClient();
         if (!DocumentDb.db) {
@@ -30,6 +41,11 @@ export default class DocumentDb {
         }
         return DocumentDb.db.collection(collectionName);
     }
+    /**
+     * Closes the active MongoDB connection.
+     *
+     * @returns A promise that resolves when the connection is closed.
+     */
     static async closeDbConnection() {
         if (DocumentDb.mongoClient) {
             await DocumentDb.mongoClient.close();

package/lib/util/DocumentDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentDb.js","sourceRoot":"","sources":["../../src/util/DocumentDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkB,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IACrB,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;IAE3B,MAAM,CAAC,WAAW,CAA0B;IAE5C,MAAM,CAAC,EAAE,CAAiB;IAE1B,MAAM,CAAC,KAAK,CAAC,SAAS;QAC5B,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;YACjC,sDAAsD;YACtD,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,uBAAuB,GAAG,iBAAiB,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,QAAQ,+BAA+B,CAAC;YACxJ,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAC9D,CAAC;QACD,uEAAuE;QACvE,mEAAmE;QACnE,aAAa;QACb,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,cAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,CAAC,UAAU,CAAW,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,iBAAiB;QAC5B,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACvC,CAAC;IACH,CAAC"}
+{"version":3,"file":"DocumentDb.js","sourceRoot":"","sources":["../../src/util/DocumentDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkB,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IACrB,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;IAE3B,MAAM,CAAC,WAAW,CAA0B;IAE5C,MAAM,CAAC,EAAE,CAAiB;IAElC;;;;OAIG;IACK,MAAM,CAAC,KAAK,CAAC,SAAS;QAC5B,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;YACjC,sDAAsD;YACtD,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,uBAAuB,GAAG,iBAAiB,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,QAAQ,+BAA+B,CAAC;YACxJ,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAC9D,CAAC;QACD,uEAAuE;QACvE,mEAAmE;QACnE,aAAa;QACb,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,cAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,CAAC,UAAU,CAAW,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB;QAC5B,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACvC,CAAC;IACH,CAAC"}

package/lib/util/DocumentDb.ts

@@ -12,6 +12,11 @@ export default class DocumentDb {
 
   private static db: Db | undefined;
 
+  /**
+   * Gets or creates the MongoDB client instance.
+   *
+   * @returns A promise that resolves to the MongoDB client.
+   */
   private static async getClient(): Promise<MongoClient> {
     if (!ConfigService.isInitialized) {
       // Hard-coded local for now until there are move envs.
@@ -29,6 +34,12 @@ export default class DocumentDb {
     return this.mongoClient;
   }
 
+  /**
+   * Gets a MongoDB collection with the specified type.
+   *
+   * @param collectionName - The name of the collection to retrieve.
+   * @returns A promise that resolves to the typed MongoDB collection.
+   */
   static async getCollection<TDocType extends Document>(
     collectionName: string
   ): Promise<Collection<TDocType>> {
@@ -39,6 +50,11 @@ export default class DocumentDb {
     return DocumentDb.db.collection<TDocType>(collectionName);
   }
 
+  /**
+   * Closes the active MongoDB connection.
+   *
+   * @returns A promise that resolves when the connection is closed.
+   */
   static async closeDbConnection(): Promise<void> {
     if (DocumentDb.mongoClient) {
       await DocumentDb.mongoClient.close();

package/package.json

@@ -2,7 +2,7 @@
   "name": "@aneuhold/be-ts-db-lib",
   "author": "Anton G. Neuhold Jr.",
   "license": "MIT",
-  "version": "2.0.78",
+  "version": "2.0.80",
   "description": "A backend database library meant to actually interact with various databases in personal projects",
   "packageManager": "pnpm@10.12.1",
   "type": "module",