@temboplus/afloat 0.1.77-beta.2 → 0.1.77-beta.20

package/dist/lib/api/base-repository.d.ts

@@ -1,5 +1,7 @@
 import { AppRouter } from "@ts-rest/core";
 import { InitClientArgs } from "@ts-rest/core";
+export type TokenGetter = () => string | undefined;
+export declare const setGlobalTokenGetter: (getter: TokenGetter) => void;
 /**
  * BaseRepository - Generic base class for API repositories
  *
@@ -75,7 +77,7 @@ export declare class BaseRepository<TContract extends AppRouter> {
      *
      * Uses a fallback chain to find a valid token:
      * 1. Instance token (set in constructor)
-     * 2. Global authentication state via getCurrentToken()
+     * 2. Global token getter (set by host app)
      * 3. Return an empty string if no token is found (e.g., for public/unauthenticated endpoints)
      *
      * @protected

package/dist/lib/query/query.builder.d.ts

@@ -27,7 +27,11 @@ export declare class QueryBuilder {
     whereLessThan(field: string, value: any): this;
     whereLessThanOrEqual(field: string, value: any): this;
     whereBetween(field: string, min: any, max: any): this;
-    whereDateBetween(startDate?: string | null, endDate?: string | null): this;
+    /**
+     * Filter by date range with support for Date objects, strings, and null
+     * Internally converts to createdAt:gte and createdAt:lte filters
+     */
+    whereDateBetween(startDate?: string | Date | null, endDate?: string | Date | null): this;
     addSort(criteria: SortCriteria): this;
     orderBy(field: string, direction?: SortDirection): this;
     orderByAsc(field: string): this;

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

@@ -53,6 +53,7 @@ export declare const authContract: {
                 access: z.ZodArray<z.ZodString, "many">;
                 resetPassword: z.ZodBoolean;
             }, "strip", z.ZodTypeAny, {
+                token: string;
                 resetPassword: boolean;
                 access: string[];
                 profile: {
@@ -65,8 +66,8 @@ export declare const authContract: {
                     email?: string | null | undefined;
                     autoApprove?: boolean | null | undefined;
                 };
-                token: string;
             }, {
+                token: string;
                 resetPassword: boolean;
                 access: string[];
                 profile: {
@@ -79,7 +80,6 @@ export declare const authContract: {
                     email?: string | null | undefined;
                     autoApprove?: boolean | null | undefined;
                 };
-                token: string;
             }>;
             400: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         };

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

@@ -1,9 +1,117 @@
+import z from "zod";
 import { Profile } from "../profile/profile.model.js";
 import { Role } from "../team-member/role.model.js";
-export interface CompanyMembershipData {
+/**
+ * Zod schema for CompanyMembership JSON serialization
+ */
+export declare const CompanyMembershipJSONSchema: z.ZodObject<{
+    companyProfile: z.ZodObject<{
+        id: z.ZodString;
+        firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        displayName: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        accountNo: z.ZodString;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        autoApprove: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        version: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+    }, {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+        version?: string | undefined;
+    }>;
+    role: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        access: z.ZodArray<z.ZodString, "many">;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        updatedAt: string;
+        access: string[];
+        description?: string | undefined;
+    }, {
+        name: string;
+        createdAt: string;
+        id: string;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+        description?: string | undefined;
+    }>>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    companyProfile: {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        version: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+    };
+    role?: {
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        updatedAt: string;
+        access: string[];
+        description?: string | undefined;
+    } | undefined;
+}, {
+    companyProfile: {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+        version?: string | undefined;
+    };
+    version?: string | undefined;
+    role?: {
+        name: string;
+        createdAt: string;
+        id: string;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+        description?: string | undefined;
+    } | undefined;
+}>;
+export type CompanyMembershipJSON = z.infer<typeof CompanyMembershipJSONSchema>;
+export type CompanyMembershipData = {
     companyProfile: Profile;
     role?: Role;
-}
+};
 /**
  * Represents a user's membership within a company.
  *
@@ -45,14 +153,19 @@ export declare class CompanyMembership {
      */
     get role(): Role | undefined;
     /**
-     * Converts the membership to a plain object.
+    * Serializes the CompanyMembership instance to a JSON-compatible object
+    */
+    toJSON(): CompanyMembershipJSON;
+    /**
+     * Serializes the CompanyMembership instance to a JSON string
      */
-    toObject(): {
-        companyProfile: ReturnType<Profile['toObject']>;
-        role?: ReturnType<Role['toJSON']>;
-    };
+    toJSONString(): string;
+    /**
+     * Creates a CompanyMembership instance from a JSON-compatible object or string
+     */
+    static fromJSON(json: CompanyMembershipJSON | string): CompanyMembership | undefined;
     /**
-     * Converts the membership to a JSON string.
+     * Type guard using Zod schema validation
      */
-    toJson(): string;
+    static isCompanyMembershipJSON(obj: unknown): obj is CompanyMembershipJSON;
 }

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

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

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

@@ -3,12 +3,200 @@ 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 {
+import z from "zod";
+/**
+ * Zod schema for User JSON serialization
+ * Composes the schemas from nested objects
+ */
+export declare const UserJSONSchema: z.ZodObject<{
+    logIn: 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">;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        updatedAt: string;
+        access: string[];
+    }, {
+        type: string;
+        name: string;
+        createdAt: string;
+        id: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+    }>;
+    companyProfile: z.ZodObject<{
+        id: z.ZodString;
+        firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        displayName: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        accountNo: z.ZodString;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        autoApprove: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        version: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+    }, {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+        version?: string | undefined;
+    }>;
+    role: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        access: z.ZodArray<z.ZodString, "many">;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        updatedAt: string;
+        access: string[];
+        description?: string | undefined;
+    }, {
+        name: string;
+        createdAt: string;
+        id: string;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+        description?: string | undefined;
+    }>>;
+    token: z.ZodString;
+    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    version: string;
+    companyProfile: {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        version: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+    };
+    logIn: {
+        type: string;
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        updatedAt: string;
+        access: string[];
+    };
+    role?: {
+        name: string;
+        createdAt: string;
+        id: string;
+        version: string;
+        updatedAt: string;
+        access: string[];
+        description?: string | undefined;
+    } | undefined;
+}, {
+    token: string;
+    companyProfile: {
+        id: string;
+        displayName: string;
+        accountNo: string;
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        phone?: string | null | undefined;
+        email?: string | null | undefined;
+        autoApprove?: boolean | null | undefined;
+        version?: string | undefined;
+    };
+    logIn: {
+        type: string;
+        name: string;
+        createdAt: string;
+        id: string;
+        profileId: string;
+        identity: string;
+        roleId: string;
+        isActive: boolean;
+        isArchived: boolean;
+        resetPassword: boolean;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+    };
+    version?: string | undefined;
+    role?: {
+        name: string;
+        createdAt: string;
+        id: string;
+        updatedAt: string;
+        access: string[];
+        version?: string | undefined;
+        description?: string | undefined;
+    } | undefined;
+}>;
+/**
+ * Infer the UserJSON type from the schema
+ */
+export type UserJSON = z.infer<typeof UserJSONSchema>;
+export type UserData = {
     logIn: LogIn;
     companyProfile: Profile;
     role?: Role;
     token: string;
-}
+};
 /**
  * Represents the currently authenticated user session.
  *
@@ -45,13 +233,6 @@ export declare class User {
      * ```
      */
     static from(data: UserData): User | undefined;
-    /**
-     * 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
-     */
-    static fromJson(jsonString: string): User | undefined;
     /**
      * Gets the user's login data.
      */
@@ -126,15 +307,57 @@ export declare class User {
      */
     canViewRoles(): boolean;
     /**
-     * Converts the User instance to a plain object.
+   * Serializes the User instance to a JSON-compatible object
+   *
+   * This method creates a complete snapshot of the user session including
+   * all nested objects (LogIn, Profile, Role). All data can be reconstructed
+   * from this JSON representation without needing backend calls.
+   *
+   * @returns {UserJSON} A plain object containing all necessary User data
+   *
+   * @example
+   * ```typescript
+   * const user = User.from({ ... });
+   * const json = user.toJSON();
+   * // Store in localStorage
+   * localStorage.setItem('currentUser', JSON.stringify(json));
+   * ```
+   */
+    toJSON(): UserJSON;
+    /**
+     * Serializes the User instance to a JSON string
      *
-     * @returns A plain object representation suitable for serialization
+     * @returns {string} JSON string representation of the User
      */
-    toObject(): Record<string, any>;
+    toJSONString(): string;
     /**
-     * Converts the User instance to a JSON string.
+     * Creates a User instance from a JSON-compatible object or string
+     *
+     * This static method reconstructs a complete User instance from data that was
+     * previously serialized using toJSON(). It validates the input data and
+     * ensures all nested objects (LogIn, Profile, Role) are properly reconstructed.
+     *
+     * @param {UserJSON | string} json - Either a UserJSON object or a JSON string
+     * @returns {User | undefined} A User instance if valid, undefined otherwise
      *
-     * @returns A JSON string representation
+     * @example
+     * ```typescript
+     * // From localStorage
+     * const stored = localStorage.getItem('currentUser');
+     * const user = User.fromJSON(stored!);
+     *
+     * // From object
+     * const userJson = {
+     *   logIn: { id: "...", ... },
+     *   companyProfile: { id: "...", ... },
+     *   token: "..."
+     * };
+     * const user = User.fromJSON(userJson);
+     * ```
+     */
+    static fromJSON(json: UserJSON | string): User | undefined;
+    /**
+     * Type guard using Zod schema validation
      */
-    toJson(): string;
+    static isUserJSON(obj: unknown): obj is UserJSON;
 }