@temboplus/afloat 0.1.77-beta.9 → 0.1.79

package/script/npm/src/src/models/user/managed-user.js

@@ -0,0 +1,260 @@
+"use strict";
+// deno-lint-ignore-file no-explicit-any
+// ====================== Base User Entity ====================== //
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManagedUser = exports.UserEntity = void 0;
+const role_js_1 = require("../role.js");
+/**
+ * Base user entity - represents a user in the system
+ */
+class UserEntity {
+    constructor(data) {
+        Object.defineProperty(this, "id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "identity", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        }); // email or phone
+        Object.defineProperty(this, "profileId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "permissions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.id = data.id;
+        this.name = data.name;
+        this.identity = data.identity;
+        this.profileId = data.profileId;
+        this.permissions = new Set(data.permissions);
+    }
+    /**
+     * Check if user has a specific permission
+     */
+    can(permission) {
+        return this.permissions.has(permission);
+    }
+    /**
+     * Check if user has any of the specified permissions
+     */
+    canAny(permissions) {
+        return permissions.some((p) => this.permissions.has(p));
+    }
+    /**
+     * Check if user has all of the specified permissions
+     */
+    canAll(permissions) {
+        return permissions.every((p) => this.permissions.has(p));
+    }
+}
+exports.UserEntity = UserEntity;
+/**
+ * Represents a user from the admin management perspective.
+ * Same person as AuthenticatedUser but with management metadata and capabilities.
+ */
+class ManagedUser extends UserEntity {
+    constructor(data) {
+        super({
+            id: data.id,
+            name: data.name,
+            identity: data.identity,
+            profileId: data.profileId,
+            permissions: data.role?.access ?? [],
+        });
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "roleId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "resetPassword", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isActive", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isArchived", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "role", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "createdAt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "updatedAt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.type = data.type;
+        this.roleId = data.roleId;
+        this.resetPassword = data.resetPassword;
+        this.isActive = data.isActive;
+        this.isArchived = data.isArchived;
+        this.createdAt = new Date(data.createdAt);
+        this.updatedAt = new Date(data.updatedAt);
+        if (data.role) {
+            try {
+                this.role = new role_js_1.Role(data.role);
+            }
+            catch (_) {
+                //
+            }
+        }
+    }
+    /**
+     * Check if user account is active
+     */
+    isAccountActive() {
+        return this.isActive;
+    }
+    /**
+     * Check if user account is archived
+     */
+    isAccountArchived() {
+        return this.isArchived;
+    }
+    /**
+     * Check if user needs to reset password
+     */
+    needsPasswordReset() {
+        return this.resetPassword;
+    }
+    /**
+     * Get comprehensive account status
+     */
+    getAccountStatus() {
+        if (this.isArchived) {
+            return {
+                status: "archived",
+                label: "Archived",
+                color: "default",
+                description: "Account has been archived and is no longer accessible",
+            };
+        }
+        if (!this.isActive) {
+            return {
+                status: "inactive",
+                label: "Inactive",
+                color: "error",
+                description: "Account has been deactivated by an administrator",
+            };
+        }
+        if (this.resetPassword) {
+            return {
+                status: "password_reset_required",
+                label: "Password Reset Required",
+                color: "warning",
+                description: "User must reset their password on next login",
+            };
+        }
+        return {
+            status: "active",
+            label: "Active",
+            color: "success",
+            description: "Account is active and ready to use",
+        };
+    }
+    /**
+     * Get role display name
+     */
+    getRoleName() {
+        return this.role?.name ?? "";
+    }
+    /**
+     * Get formatted creation date
+     */
+    getCreatedDate() {
+        return this.createdAt.toLocaleDateString();
+    }
+    /**
+     * Get time since last update
+     */
+    getLastUpdateInfo() {
+        const now = new Date();
+        const diffMs = now.getTime() - this.updatedAt.getTime();
+        const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        if (diffDays === 0)
+            return "Today";
+        if (diffDays === 1)
+            return "Yesterday";
+        if (diffDays < 7)
+            return `${diffDays} days ago`;
+        if (diffDays < 30)
+            return `${Math.floor(diffDays / 7)} weeks ago`;
+        return this.updatedAt.toLocaleDateString();
+    }
+    static from(data) {
+        try {
+            if (!data?.id || !data?.name || !data?.identity || !data?.roleId) {
+                console.error("Missing required ManagedUser fields:", data);
+                return undefined;
+            }
+            return new ManagedUser(data);
+        }
+        catch (error) {
+            console.error("Error creating ManagedUser:", error);
+            return undefined;
+        }
+    }
+    static createMany(dataArray) {
+        return dataArray.map((data) => ManagedUser.from(data)).filter(Boolean);
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            identity: this.identity,
+            type: this.type,
+            profileId: this.profileId,
+            roleId: this.roleId,
+            resetPassword: this.resetPassword,
+            isActive: this.isActive,
+            isArchived: this.isArchived,
+            role: this.role?.toJSON(),
+            createdAt: this.createdAt.toISOString(),
+            updatedAt: this.updatedAt.toISOString(),
+        };
+    }
+}
+exports.ManagedUser = ManagedUser;

package/script/npm/src/src/models/user/profile.d.ts

@@ -0,0 +1,161 @@
+import { z } from "zod";
+import { PhoneNumber } from "@temboplus/frontend-core";
+/**
+ * Type definition for profile schema using Zod.
+ * This type helper ensures type safety when implementing the actual schema.
+ */
+type ProfileZodSchemaType = z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    lastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    displayName: z.ZodString;
+    phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    accountNo: z.ZodString;
+    email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}>;
+/**
+ * Zod schema for validating user profile data.
+ * Defines validation rules and constraints for each profile field.
+ *
+ * @const {ProfileType}
+ *
+ * @property {string} id - Unique identifier for the profile
+ * @property {string | null | undefined} firstName - User's first name, can be null or undefined
+ * @property {string | null | undefined} lastName - User's last name, can be null or undefined
+ * @property {string} displayName - User's display name
+ * @property {string | null | undefined} phone - User's contact phone number, can be null or undefined
+ * @property {string} accountNo - User's account number
+ * @property {string | null | undefined} email - User's email address, can be null or undefined
+ */
+export declare const profileSchema: ProfileZodSchemaType;
+/**
+ * TypeScript type representing a validated user profile.
+ * Use this type for profile instances that have been validated against the schema.
+ */
+export type ProfileType = z.infer<typeof profileSchema>;
+/**
+ * Represents a user profile in the system.
+ *
+ * This class provides methods for creating, validating, and manipulating user profile data.
+ * It integrates with the Zod schema validation for data integrity.
+ */
+export declare class Profile {
+    /** Unique identifier for the profile */
+    private _id;
+    /** User's first name */
+    private _firstName?;
+    /** User's last name */
+    private _lastName?;
+    /** User's display name, can be used for presentation */
+    private _displayName;
+    /** User's phone number, stored as a PhoneNumber object */
+    private _phone?;
+    /** User's account number */
+    private _accountNo;
+    /** User's email address */
+    private _email?;
+    /**
+     * Gets the profile schema used for validation.
+     */
+    static get schema(): ProfileZodSchemaType;
+    /**
+     * Creates a new Profile instance with the provided data.
+     *
+     * Private constructor to enforce use of static factory methods.
+     *
+     * @param data - Object containing profile information
+     */
+    private constructor();
+    /**
+     * Creates a new Profile instance with the provided data.
+     *
+     * @param data - Object containing profile information.
+     */
+    static create(data: {
+        id: string;
+        firstName?: string | null;
+        lastName?: string | null;
+        displayName: string;
+        phone?: string | null;
+        accountNo: string;
+        email?: string | null;
+    }): Profile | undefined;
+    /**
+     * Gets the profile's unique identifier.
+     */
+    get id(): string;
+    /**
+     * Gets the user's first name.
+     */
+    get firstName(): string | null | undefined;
+    /**
+     * Gets the user's last name.
+     */
+    get lastName(): string | null | undefined;
+    /**
+     * Gets the user's display name.
+     */
+    get displayName(): string;
+    /**
+     * Gets the user's phone number object.
+     */
+    get phone(): PhoneNumber | null | undefined;
+    /**
+     * Gets the user's account number.
+     */
+    get accountNo(): string;
+    /**
+     * Gets the user's email address.
+     */
+    get email(): string | null | undefined;
+    /**
+     * Gets the user's formatted phone number in international format.
+     */
+    get formattedPhone(): string | null | undefined;
+    /**
+     * Gets the user's name for display purposes.
+     * Returns the display name if it exists, otherwise returns the first and last name combined.
+     */
+    getName(): string;
+    /**
+     * Creates a plain object representation of the profile for validation or serialization.
+     *
+     * @returns A plain object matching the ProfileType interface
+     */
+    toObject(): ProfileType;
+    /**
+     * Converts the profile to a JSON string.
+     *
+     * @returns A JSON string representation of the profile
+     */
+    toJSON(): string;
+    /**
+     * Validates the profile data against the Zod schema.
+     *
+     * @returns True if the profile is valid, false otherwise
+     */
+    validate(): boolean;
+    /**
+     * Creates a Profile instance from a JSON string.
+     *
+     * @param jsonString - JSON string containing profile data
+     * @returns A new Profile instance, or undefined if parsing failed
+     */
+    static fromJSON(jsonString: string): Profile | undefined;
+    /**
+     * Creates a Profile instance from a plain object.
+     *
+     * @param data - Object containing profile data
+     * @returns A new Profile instance, or undefined if parsing failed
+     */
+    static from(data: any): Profile | undefined;
+    /**
+     * Type guard to check if an unknown object is a valid Profile instance.
+     *
+     * @param obj - The object to check
+     * @returns Type predicate indicating if the object is a valid Profile
+     */
+    static is(obj: unknown): obj is Profile;
+}
+export {};
+//# sourceMappingURL=profile.d.ts.map

package/script/npm/src/src/models/user/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../../../src/src/models/user/profile.ts"],"names":[],"mappings":"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"}