@temboplus/afloat 0.1.76-beta.0 → 0.1.77-beta.2

package/dist/lib/error/error.permission.d.ts

@@ -1,4 +1,4 @@
-import { Permission } from "@/modules/auth/permission.type.js";
+import { Permission } from "@/modules/login/permission.type.js";
 /**
  * Custom error class representing an error caused by missing required permissions.
  * Extends the built-in {@link Error} class to include the `requiredPermissions` property.

package/dist/modules/auth/auth.contract.d.ts

@@ -54,6 +54,7 @@ export declare const authContract: {
                 resetPassword: z.ZodBoolean;
             }, "strip", z.ZodTypeAny, {
                 resetPassword: boolean;
+                access: string[];
                 profile: {
                     id: string;
                     displayName: string;
@@ -65,9 +66,9 @@ export declare const authContract: {
                     autoApprove?: boolean | null | undefined;
                 };
                 token: string;
-                access: string[];
             }, {
                 resetPassword: boolean;
+                access: string[];
                 profile: {
                     id: string;
                     displayName: string;
@@ -79,7 +80,6 @@ export declare const authContract: {
                     autoApprove?: boolean | null | undefined;
                 };
                 token: string;
-                access: string[];
             }>;
             400: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         };
@@ -97,11 +97,11 @@ export declare const authContract: {
             currentPassword: z.ZodString;
             newPassword: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            currentPassword: string;
             newPassword: string;
-        }, {
             currentPassword: string;
+        }, {
             newPassword: string;
+            currentPassword: string;
         }>;
         path: "/password";
         responses: {};

package/dist/modules/auth/auth.manager.d.ts

@@ -1,4 +1,4 @@
-import { Permission } from "@/modules/auth/permission.type.js";
+import { Permission } from "@/modules/login/permission.type.js";
 import { User } from "@/modules/auth/user.model.js";
 /**
  * Clean authentication manager for client-side usage only.

package/dist/modules/auth/company-membership.model.d.ts

@@ -0,0 +1,58 @@
+import { Profile } from "../profile/profile.model.js";
+import { Role } from "../team-member/role.model.js";
+export interface CompanyMembershipData {
+    companyProfile: Profile;
+    role?: Role;
+}
+/**
+ * Represents a user's membership within a company.
+ *
+ * This class encapsulates the relationship between a user and their company:
+ * - The company profile the user belongs to
+ * - The user's role within that company (optional - depends on permissions)
+ *
+ * Note: Permissions are stored in LogIn.access, not here.
+ * This model focuses purely on the company-user relationship.
+ *
+ * The role may be undefined if the user doesn't have permission to view
+ * role details (Permissions.Role.ViewRole).
+ */
+export declare class CompanyMembership {
+    private readonly _companyProfile;
+    private readonly _role?;
+    private constructor();
+    /**
+     * Creates a CompanyMembership instance from the required data.
+     *
+     * @param data - The membership data
+     * @returns A new CompanyMembership instance, or undefined if invalid
+     *
+     * @example
+     * ```typescript
+     * const membership = CompanyMembership.from({
+     *   companyProfile: profile,
+     *   role: role // optional
+     * });
+     * ```
+     */
+    static from(data: CompanyMembershipData): CompanyMembership | undefined;
+    /**
+     * Gets the company profile.
+     */
+    get companyProfile(): Profile;
+    /**
+     * Gets the user's role (may be undefined if user lacks permission to view it).
+     */
+    get role(): Role | undefined;
+    /**
+     * Converts the membership to a plain object.
+     */
+    toObject(): {
+        companyProfile: ReturnType<Profile['toObject']>;
+        role?: ReturnType<Role['toJSON']>;
+    };
+    /**
+     * Converts the membership to a JSON string.
+     */
+    toJson(): string;
+}

package/dist/modules/auth/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./auth.manager.js";
 export * from "./auth.repository.js";
-export * from "./permission.type.js";
 export * from "./user.model.js";
+export * from "./company-membership.model.js";

package/dist/modules/auth/user.model.d.ts

@@ -1,66 +1,140 @@
-import { Permission } from "./permission.type.js";
+import { Permission } from "../login/permission.type.js";
 import { Profile } from "../profile/profile.model.js";
+import { LogIn } from "../login/login.model.js";
+import { CompanyMembership } from "./company-membership.model.js";
+import { Role } from "../team-member/role.model.js";
+export interface UserData {
+    logIn: LogIn;
+    companyProfile: Profile;
+    role?: Role;
+    token: string;
+}
 /**
- * Represents a user in Afloat.
+ * Represents the currently authenticated user session.
+ *
+ * This class combines:
+ * - LogIn: User account data (identity, permissions, resetPassword, etc.)
+ * - CompanyMembership: User's relationship to their company (company profile + role)
+ * - Token: Session authentication token
+ *
+ * The User represents "who is logged in right now" with their full context.
  *
- * This class centralizes user-related logic, simplifying interaction
- * with user-related data and ensuring consistent access checks across the application.
+ * Note: The role in CompanyMembership may be undefined if the user doesn't have
+ * permission to view role details (Permissions.Role.ViewRole).
  */
 export declare class User {
+    private readonly _logIn;
+    private readonly _membership;
+    private readonly _token;
+    private readonly _permissionMap;
+    private constructor();
     /**
-     * Logged-in user name.
+     * Creates a User instance from the provided data.
+     *
+     * @param data - User session data
+     * @returns A new User instance, or undefined if data is invalid
+     *
+     * @example
+     * ```typescript
+     * const user = User.from({
+     *   logIn: logIn,
+     *   companyProfile: profile,
+     *   role: role, // optional
+     *   token: "auth-token"
+     * });
+     * ```
      */
-    name: string;
+    static from(data: UserData): User | undefined;
     /**
-     * Logged-in identity: phone number or email address.
+     * Creates a User instance from a JSON string.
+     *
+     * @param jsonString - JSON string containing user data
+     * @returns A new User instance, or undefined if parsing failed
      */
-    identity: string;
+    static fromJson(jsonString: string): User | undefined;
     /**
-     * The user's Afloat profile.
+     * Gets the user's login data.
      */
-    profile: Profile;
+    get logIn(): LogIn;
     /**
-     * The user's authentication token.
+     * Gets the user's company membership (includes company profile and role).
      */
-    token: string;
+    get membership(): CompanyMembership;
     /**
-     * Indicates whether the user must change their default password.
+     * Gets the user's authentication token.
      */
-    resetPassword: boolean;
+    get token(): string;
     /**
-     * A list of granted access keys (permissions).
+     * Convenience getter for the user's ID.
      */
-    access: Permission[];
+    get id(): string;
     /**
-     * A map of access keys to boolean values for fast permission checks.
+     * Convenience getter for the user's name.
      */
-    private accessMap;
+    get name(): string;
     /**
-     * Creates a new `User` instance.
+     * Convenience getter for the user's identity (email).
      */
-    private constructor();
+    get identity(): string;
+    /**
+     * Convenience getter for the user's role ID.
+     */
+    get roleId(): string;
+    /**
+     * Convenience getter for whether the user must reset their password.
+     */
+    get resetPassword(): boolean;
+    /**
+     * Convenience getter for the company profile.
+     */
+    get profile(): Profile;
+    /**
+     * Convenience getter for the user's role (may be undefined).
+     */
+    get role(): Role | undefined;
+    /**
+     * Convenience getter for permissions array.
+     */
+    get access(): ReadonlyArray<string>;
     /**
-     * Checks if the user has a specific access permission.
+     * Checks if the user has a specific permission.
      *
-     * @param key - The access key to check.
-     * @returns `true` if the user has the specified access, otherwise `false`.
+     * @param permission - The permission to check
+     * @returns true if the user has the permission
      */
-    can(key: Permission): boolean;
+    can(permission: Permission): boolean;
     /**
-     * Returns a plain object representation of the user.
-     * This can safely be embedded in a JWT payload.
+     * Checks if the user has any of the specified permissions.
+     *
+     * @param permissions - Array of permissions to check
+     * @returns true if the user has at least one permission
      */
-    toObject(): Record<string, any>;
+    canAny(permissions: Permission[]): boolean;
     /**
-     * Serializes the `User` instance to a JSON string.
+     * Checks if the user has all of the specified permissions.
+     *
+     * @param permissions - Array of permissions to check
+     * @returns true if the user has all permissions
      */
-    toJSON(): string;
+    canAll(permissions: Permission[]): boolean;
     /**
-     * Creates a new `User` instance from a JSON string.
+     * Checks if the user can manage team members.
      */
-    static fromJSON(jsonString: string): User | undefined;
+    canManageTeam(): boolean;
     /**
-     * Creates a new `User` instance from a plain object.
+     * Checks if the user can view role details.
+     */
+    canViewRoles(): boolean;
+    /**
+     * Converts the User instance to a plain object.
+     *
+     * @returns A plain object representation suitable for serialization
+     */
+    toObject(): Record<string, any>;
+    /**
+     * Converts the User instance to a JSON string.
+     *
+     * @returns A JSON string representation
      */
-    static from(data: any): User | undefined;
+    toJson(): string;
 }

package/dist/modules/contact/contact.api-contract.d.ts

@@ -44,19 +44,19 @@ export declare const contract: {
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }, {
                 type: import("./contact.dtos.js").ContactType;
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }>;
         };
     };
@@ -95,19 +95,19 @@ export declare const contract: {
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }, {
                 type: import("./contact.dtos.js").ContactType;
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }>;
         };
     };
@@ -137,19 +137,19 @@ export declare const contract: {
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }, {
                 type: import("./contact.dtos.js").ContactType;
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }>, "many">;
         };
     };
@@ -172,19 +172,19 @@ export declare const contract: {
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }, {
                 type: import("./contact.dtos.js").ContactType;
                 id: string;
                 displayName: string;
                 accountNo: string;
-                createdAt: string;
                 profileId: string;
-                channel: string;
+                createdAt: string;
                 updatedAt: string;
+                channel: string;
             }>;
         };
     };

package/dist/modules/contact/contact.dtos.d.ts

@@ -48,19 +48,19 @@ export declare const ContactDTOSchemas: {
         id: string;
         displayName: string;
         accountNo: string;
-        createdAt: string;
         profileId: string;
-        channel: string;
+        createdAt: string;
         updatedAt: string;
+        channel: string;
     }, {
         type: ContactType;
         id: string;
         displayName: string;
         accountNo: string;
-        createdAt: string;
         profileId: string;
-        channel: string;
+        createdAt: string;
         updatedAt: string;
+        channel: string;
     }>;
     /** Schema for contact input validation */
     contactInputDTO: z.ZodObject<{

package/dist/modules/login/index.d.ts

@@ -1,2 +1,4 @@
+export * from "./login.dtos.js";
 export * from "./login.model.js";
 export * from "./login.repository.js";
+export * from "./permission.type.js";

package/dist/modules/login/login.api-contract.d.ts

@@ -1,4 +1,3 @@
-import { z } from "zod";
 /**
  * Identity API contract
  */
@@ -7,15 +6,45 @@ export declare const identityContract: {
         method: "GET";
         path: "/me";
         responses: {
-            200: z.ZodObject<{
-                name: z.ZodString;
-                identity: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
+            200: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                profileId: import("zod").ZodString;
+                name: import("zod").ZodString;
+                identity: import("zod").ZodString;
+                type: import("zod").ZodString;
+                roleId: import("zod").ZodString;
+                isActive: import("zod").ZodBoolean;
+                isArchived: import("zod").ZodBoolean;
+                resetPassword: import("zod").ZodBoolean;
+                createdAt: import("zod").ZodString;
+                updatedAt: import("zod").ZodString;
+                access: import("zod").ZodArray<import("zod").ZodString, "many">;
+            }, "strip", import("zod").ZodTypeAny, {
+                type: string;
                 name: string;
+                id: string;
+                profileId: string;
                 identity: string;
+                roleId: string;
+                isActive: boolean;
+                isArchived: boolean;
+                resetPassword: boolean;
+                createdAt: string;
+                updatedAt: string;
+                access: string[];
             }, {
+                type: string;
                 name: string;
+                id: string;
+                profileId: string;
                 identity: string;
+                roleId: string;
+                isActive: boolean;
+                isArchived: boolean;
+                resetPassword: boolean;
+                createdAt: string;
+                updatedAt: string;
+                access: string[];
             }>;
         };
     };

package/dist/modules/login/login.dtos.d.ts

@@ -0,0 +1,85 @@
+import z from "zod";
+declare const LogInDTOSchema: z.ZodObject<{
+    id: z.ZodString;
+    profileId: z.ZodString;
+    name: z.ZodString;
+    identity: z.ZodString;
+    type: z.ZodString;
+    roleId: z.ZodString;
+    isActive: z.ZodBoolean;
+    isArchived: z.ZodBoolean;
+    resetPassword: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    access: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    id: string;
+    profileId: string;
+    identity: string;
+    roleId: string;
+    isActive: boolean;
+    isArchived: boolean;
+    resetPassword: boolean;
+    createdAt: string;
+    updatedAt: string;
+    access: string[];
+}, {
+    type: string;
+    name: string;
+    id: string;
+    profileId: string;
+    identity: string;
+    roleId: string;
+    isActive: boolean;
+    isArchived: boolean;
+    resetPassword: boolean;
+    createdAt: string;
+    updatedAt: string;
+    access: string[];
+}>;
+export declare const LogInSchemas: {
+    loginDTO: z.ZodObject<{
+        id: z.ZodString;
+        profileId: z.ZodString;
+        name: z.ZodString;
+        identity: z.ZodString;
+        type: z.ZodString;
+        roleId: z.ZodString;
+        isActive: z.ZodBoolean;
+        isArchived: z.ZodBoolean;
+        resetPassword: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        access: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        id: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        createdAt: string;
+        updatedAt: string;
+        access: string[];
+    }, {
+        type: string;
+        name: string;
+        id: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        createdAt: string;
+        updatedAt: string;
+        access: string[];
+    }>;
+};
+export type LogInDTO = z.infer<typeof LogInDTOSchema>;
+export {};