@temboplus/afloat 0.1.13 → 0.1.30

package/script/src/models/payout/derivatives/payout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payout.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/payout/derivatives/payout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,sBAAsB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG1E;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;OAEG;IACH,OAAO;IAKP,uCAAuC;IACvC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,qDAAqD;IACrD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAClC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,wCAAwC;IACxC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,iDAAiD;IACjD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;;;;;;;;;;OAWG;IACH,IAAI,MAAM,IAAI,aAAa,CAe1B;IAED,2DAA2D;IAC3D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,iDAAiD;IACjD,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,wCAAwC;IACxC,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,6CAA6C;IAC7C,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,4CAA4C;IAC5C,IAAI,cAAc,IAAI,sBAAsB,CAE3C;IAED,+CAA+C;IAC/C,IAAI,SAAS,IAAI,cAAc,GAAG,SAAS,CAE1C;IAED,qDAAqD;IACrD,IAAI,UAAU,IAAI,cAAc,GAAG,SAAS,CAE3C;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CA8BzC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIvC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE;IAIpD;;;OAGG;WACW,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAQzD;;;;;;;;;;;;;;;;;;;;;OAqBG;WACW,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IAO7C;;OAEG;IACI,MAAM,IAAI,UAAU;CAG5B"}
+{"version":3,"file":"payout.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/payout/derivatives/payout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAuB,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,sBAAsB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG1E;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;OAEG;IACH,OAAO;IAKP,uCAAuC;IACvC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,qDAAqD;IACrD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAClC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,wCAAwC;IACxC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,iDAAiD;IACjD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;;;;;;;;;;OAWG;IACH,IAAI,MAAM,IAAI,aAAa,CAe1B;IAED,2DAA2D;IAC3D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,iDAAiD;IACjD,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,wCAAwC;IACxC,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,6CAA6C;IAC7C,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,4CAA4C;IAC5C,IAAI,cAAc,IAAI,sBAAsB,CAE3C;IAED,+CAA+C;IAC/C,IAAI,SAAS,IAAI,cAAc,GAAG,SAAS,CAE1C;IAED,qDAAqD;IACrD,IAAI,UAAU,IAAI,cAAc,GAAG,SAAS,CAE3C;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CA8BzC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIvC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE;IAIpD;;;OAGG;WACW,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAQzD;;;;;;;;;;;;;;;;;;;;;OAqBG;WACW,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IAO7C;;OAEG;IACI,MAAM,IAAI,UAAU;CAG5B"}

package/script/src/models/payout/derivatives/payout.js

@@ -136,7 +136,7 @@ class Payout {
     get contactInfo() {
         let contactInfo;
         // extracting mobile contact information
-        const phone = frontend_core_1.PhoneNumber.from(this.data.msisdn);
+        const phone = frontend_core_1.TZPhoneNumber.from(this.data.msisdn);
         if (phone) {
             contactInfo = new index_js_1.MobileContactInfo(this.data.payeeName, phone);
         }

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

@@ -1,16 +1,17 @@
 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 ProfileType = z.ZodObject<{
+type ProfileZodSchemaType = z.ZodObject<{
     id: z.ZodString;
-    firstName: z.ZodString;
-    lastName: z.ZodString;
+    firstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    lastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     displayName: z.ZodString;
-    phone: z.ZodString;
+    phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     accountNo: z.ZodString;
-    email: z.ZodString;
+    email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }>;
 /**
  * Zod schema for validating user profile data.
@@ -19,20 +20,142 @@ type ProfileType = z.ZodObject<{
  * @const {ProfileType}
  *
  * @property {string} id - Unique identifier for the profile
- * @property {string} firstName - User's first name
- * @property {string} lastName - User's last name
+ * @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} phone - User's contact phone number
+ * @property {string | null | undefined} phone - User's contact phone number, can be null or undefined
  * @property {string} accountNo - User's account number
- * @property {string} email - User's email address
+ * @property {string | null | undefined} email - User's email address, can be null or undefined
  */
-export declare const profileSchema: ProfileType;
+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.
  *
- * @see {@link profileSchema} for validation rules
+ * This class provides methods for creating, validating, and manipulating user profile data.
+ * It integrates with the Zod schema validation for data integrity.
  */
-export type Profile = z.infer<typeof profileSchema>;
+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/src/models/user/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/src/models/user/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC;IAC7B,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;IACtB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,WAS1B,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/src/models/user/profile.ts"],"names":[],"mappings":"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"}

package/script/src/models/user/profile.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.profileSchema = void 0;
+exports.Profile = exports.profileSchema = void 0;
 const zod_1 = require("zod");
+const frontend_core_1 = require("@temboplus/frontend-core");
 /**
  * Zod schema for validating user profile data.
  * Defines validation rules and constraints for each profile field.
@@ -9,20 +10,326 @@ const zod_1 = require("zod");
  * @const {ProfileType}
  *
  * @property {string} id - Unique identifier for the profile
- * @property {string} firstName - User's first name
- * @property {string} lastName - User's last name
+ * @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} phone - User's contact phone number
+ * @property {string | null | undefined} phone - User's contact phone number, can be null or undefined
  * @property {string} accountNo - User's account number
- * @property {string} email - User's email address
+ * @property {string | null | undefined} email - User's email address, can be null or undefined
  */
 exports.profileSchema = zod_1.z.object({
-    id: zod_1.z.string().uuid("Invalid profile ID format"),
-    firstName: zod_1.z.string().min(1, "First name is required"),
-    lastName: zod_1.z.string().min(1, "Last name is required"),
-    displayName: zod_1.z.string().min(1, "Display name is required"),
-    phone: zod_1.z.string().min(1, "Phone number is required")
-        .regex(/^\+?[\d\s-]+$/, "Invalid phone number format"),
-    accountNo: zod_1.z.string().min(1, "Account number is required"),
-    email: zod_1.z.string().email("Invalid email format"),
+    id: zod_1.z.string(),
+    firstName: zod_1.z.string().optional().nullable(),
+    lastName: zod_1.z.string().optional().nullable(),
+    displayName: zod_1.z.string(),
+    phone: zod_1.z.string().optional().nullable(),
+    accountNo: zod_1.z.string().min(1),
+    email: zod_1.z.string().email().optional().nullable(),
 });
+/**
+ * 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.
+ */
+class Profile {
+    /**
+     * Gets the profile schema used for validation.
+     */
+    static get schema() {
+        return exports.profileSchema;
+    }
+    /**
+     * Creates a new Profile instance with the provided data.
+     *
+     * Private constructor to enforce use of static factory methods.
+     *
+     * @param data - Object containing profile information
+     */
+    constructor(data) {
+        /** Unique identifier for the profile */
+        Object.defineProperty(this, "_id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's first name */
+        Object.defineProperty(this, "_firstName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's last name */
+        Object.defineProperty(this, "_lastName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's display name, can be used for presentation */
+        Object.defineProperty(this, "_displayName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's phone number, stored as a PhoneNumber object */
+        Object.defineProperty(this, "_phone", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's account number */
+        Object.defineProperty(this, "_accountNo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** User's email address */
+        Object.defineProperty(this, "_email", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this._id = data.id;
+        this._firstName = data.firstName;
+        this._lastName = data.lastName;
+        this._displayName = data.displayName;
+        this._phone = data.phone;
+        this._accountNo = data.accountNo;
+        this._email = data.email;
+    }
+    /**
+     * Creates a new Profile instance with the provided data.
+     *
+     * @param data - Object containing profile information.
+     */
+    static create(data) {
+        let phoneObj = undefined;
+        if (data.phone !== undefined && data.phone !== null) {
+            phoneObj = frontend_core_1.PhoneNumber.from(data.phone);
+            if (!phoneObj) {
+                console.error("Failed to parse phone number:", data.phone);
+                return undefined;
+            }
+        }
+        else {
+            phoneObj = data.phone; // Preserve null or undefined
+        }
+        return new Profile({
+            id: data.id,
+            firstName: data.firstName,
+            lastName: data.lastName,
+            displayName: data.displayName,
+            phone: phoneObj,
+            accountNo: data.accountNo,
+            email: data.email,
+        });
+    }
+    /**
+     * Gets the profile's unique identifier.
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * Gets the user's first name.
+     */
+    get firstName() {
+        return this._firstName;
+    }
+    /**
+     * Gets the user's last name.
+     */
+    get lastName() {
+        return this._lastName;
+    }
+    /**
+     * Gets the user's display name.
+     */
+    get displayName() {
+        return this._displayName;
+    }
+    /**
+     * Gets the user's phone number object.
+     */
+    get phone() {
+        return this._phone;
+    }
+    /**
+     * Gets the user's account number.
+     */
+    get accountNo() {
+        return this._accountNo;
+    }
+    /**
+     * Gets the user's email address.
+     */
+    get email() {
+        return this._email;
+    }
+    /**
+     * Gets the user's formatted phone number in international format.
+     */
+    get formattedPhone() {
+        if (this._phone === undefined) {
+            return undefined;
+        }
+        return this._phone?.label ?? null;
+    }
+    /**
+     * Gets the user's name for display purposes.
+     * Returns the display name if it exists, otherwise returns the first and last name combined.
+     */
+    getName() {
+        if (this._displayName && this._displayName.trim() !== "") {
+            return this._displayName;
+        }
+        const firstName = this._firstName ?? "";
+        const lastName = this._lastName ?? "";
+        return `${firstName} ${lastName}`.trim();
+    }
+    /**
+     * Creates a plain object representation of the profile for validation or serialization.
+     *
+     * @returns A plain object matching the ProfileType interface
+     */
+    toObject() {
+        // Handle the phone specially to ensure we preserve undefined vs null
+        let phoneString = undefined;
+        if (this._phone !== undefined) {
+            phoneString = this._phone?.label ?? null;
+        }
+        return {
+            id: this._id,
+            firstName: this._firstName,
+            lastName: this._lastName,
+            displayName: this._displayName,
+            phone: phoneString,
+            accountNo: this._accountNo,
+            email: this._email,
+        };
+    }
+    /**
+     * Converts the profile to a JSON string.
+     *
+     * @returns A JSON string representation of the profile
+     */
+    toJSON() {
+        return JSON.stringify(this.toObject());
+    }
+    /**
+     * Validates the profile data against the Zod schema.
+     *
+     * @returns True if the profile is valid, false otherwise
+     */
+    validate() {
+        try {
+            const result = Profile.schema.safeParse(this.toObject());
+            return result.success;
+        }
+        catch (error) {
+            console.error("Profile validation error:", error);
+            return false;
+        }
+    }
+    /**
+     * 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) {
+        try {
+            const data = JSON.parse(jsonString);
+            return Profile.from(data);
+        }
+        catch (error) {
+            console.error("Error parsing profile JSON:", error);
+            return 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
+     */
+    // deno-lint-ignore no-explicit-any
+    static from(data) {
+        try {
+            if (!data) {
+                console.error("Data is null or undefined");
+                return undefined;
+            }
+            if (typeof data !== "object") {
+                console.error("Data is not an object");
+                return undefined;
+            }
+            if (!data.id || !data.accountNo || !data.displayName) {
+                console.error("Missing required profile fields");
+                return undefined;
+            }
+            return Profile.create({
+                id: data.id,
+                firstName: data.firstName,
+                lastName: data.lastName,
+                displayName: data.displayName,
+                phone: data.phone,
+                accountNo: data.accountNo,
+                email: data.email,
+            });
+        }
+        catch (error) {
+            console.error("Error creating profile from object:", error);
+            return 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) {
+        if (!obj || typeof obj !== "object")
+            return false;
+        const maybeProfile = obj;
+        // Check required properties
+        if (typeof maybeProfile._id !== "string" ||
+            typeof maybeProfile._displayName !== "string" ||
+            typeof maybeProfile._accountNo !== "string") {
+            return false;
+        }
+        // Check nullable/optional properties have the right type when present
+        if (maybeProfile._firstName !== null &&
+            maybeProfile._firstName !== undefined &&
+            typeof maybeProfile._firstName !== "string") {
+            return false;
+        }
+        if (maybeProfile._lastName !== null &&
+            maybeProfile._lastName !== undefined &&
+            typeof maybeProfile._lastName !== "string") {
+            return false;
+        }
+        if (maybeProfile._email !== null &&
+            maybeProfile._email !== undefined &&
+            typeof maybeProfile._email !== "string") {
+            return false;
+        }
+        // Check phone number
+        const phone = maybeProfile._phone;
+        if (phone !== null &&
+            phone !== undefined &&
+            !frontend_core_1.PhoneNumber.is(phone)) {
+            return false;
+        }
+        return true;
+    }
+}
+exports.Profile = Profile;

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

@@ -1,6 +1,6 @@
-import type { Profile } from "./profile.js";
+import { Profile } from "./profile.js";
 /**
- * Represents a user in Afloat
+ * Represents a user in Afloat.
  *
  * This class centralizes user-related logic, simplifying interaction
  * with user-related data and ensuring consistent permission checks across the application.
@@ -38,19 +38,10 @@ export declare class User {
     /**
      * Creates a new instance of the `User` class.
      *
-     * @param userData - An object of type `CoreUser` containing the user's profile, token,
+     * @param userData - An object containing the user's profile, token,
      * permissions (access list), and the `resetPassword` flag.
      */
-    constructor(data: {
-        profile: Profile;
-        token: string;
-        access: string[];
-        resetPassword: boolean;
-        loginCredentials: {
-            name: string;
-            identity: string;
-        };
-    });
+    private constructor();
     /**
      * Checks if the user has a specific permission.
      *
@@ -62,7 +53,7 @@ export declare class User {
      * Serializes the `User` instance to a JSON string.
      *
      * @returns A JSON string representation of the `User` instance, including:
-     * - `profile`: The user's profile information.
+     * - `profile`: The user's profile information. (Requires profile.toJSON() method)
      * - `token`: The user's authentication token.
      * - `resetPassword`: Indicates whether the user must reset their password.
      * - `permissions`: An array of permission keys the user has.
@@ -72,9 +63,15 @@ export declare class User {
      * Creates a new `User` instance from a JSON string.
      *
      * @param jsonString - A JSON string containing user data.
-     * @returns A `User` instance reconstructed from the JSON data.
-     * @throws Will throw an error if the JSON data is invalid or incomplete.
+     * @returns A `User` instance reconstructed from the JSON data, or undefined if jsonString is invalid.
      */
-    static fromJSON(jsonString: string): User;
+    static fromJSON(jsonString: string): User | undefined;
+    /**
+     * Creates a new `User` instance from a data object, JSON string, or object with a Profile instance/object.
+     *
+     * @param data - The data object, JSON string, or object with Profile instance/object containing user information.
+     * @returns A `User` instance, or undefined if data is invalid.
+     */
+    static from(data: any): User | undefined;
 }
 //# sourceMappingURL=user.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/src/models/user/user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,IAAI;IACf;;OAEG;IACI,IAAI,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;OAEG;IACI,OAAO,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACI,KAAK,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACI,aAAa,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA0B;IAEhD;;;;;OAKG;gBACS,IAAI,EAAE;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH;IAqBD;;;;;OAKG;IACI,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;;;OAQG;IACI,MAAM,IAAI,MAAM;IAavB;;;;;;OAMG;WACW,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CA4BjD"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/src/models/user/user.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,IAAI;IACf;;OAEG;IACI,IAAI,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;OAEG;IACI,OAAO,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACI,KAAK,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACI,aAAa,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA0B;IAEhD;;;;;OAKG;IACH,OAAO;IA6BP;;;;;OAKG;IACI,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;;;OAQG;IACI,MAAM,IAAI,MAAM;IAavB;;;;;OAKG;WACW,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAS5D;;;;;OAKG;WACW,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS;CA4FhD"}