@temboplus/afloat 0.1.57 → 0.1.59

package/esm/src/features/auth/storage/server_token_handler.js

@@ -0,0 +1,115 @@
+import { Profile, User } from "../../../models/index.js";
+import { profileContract } from "../profile/contract.js";
+import { identityContract } from "../identity/contract.js";
+import { TokenRequiredRepository } from "../../../shared/token_required_repository.js";
+import { accessContract } from "../access/contract.js";
+/**
+ * Server-side implementation of TokenHandler.
+ * Manages tokens in memory for the duration of a request.
+ * Uses TokenRequiredRepository instead of repositories that rely on AfloatAuth.
+ * @implements {TokenHandler}
+ */
+export class ServerTokenHandler {
+    /**
+     * Creates a new instance of ServerTokenHandler.
+     * @param {string} [token] - Optional initial token value
+     */
+    constructor(token) {
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "accessRepo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "profileRepo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "identityRepo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.token = token;
+        this.accessRepo = new TokenRequiredRepository("auth", accessContract, this.token);
+        this.profileRepo = new TokenRequiredRepository("profile", profileContract, this.token);
+        this.identityRepo = new TokenRequiredRepository("login", identityContract, this.token);
+    }
+    /**
+     * Returns the stored token.
+     * @returns {string | undefined} The current token or undefined if not set
+     */
+    getUserToken() {
+        return this.token;
+    }
+    /**
+     * Stores the provided token in memory.
+     * @param {string} token - The token to store
+     */
+    setUserToken(token) {
+        this.token = token;
+        this.accessRepo.setToken(token);
+        this.profileRepo.setToken(token);
+        this.identityRepo.setToken(token);
+    }
+    clearToken() {
+        this.token = "";
+        this.accessRepo.setToken("");
+        this.profileRepo.setToken("");
+        this.identityRepo.setToken("");
+    }
+    /**
+     * Fetches and constructs the full user data
+     * @returns {Promise<User>}
+     */
+    async constructUser(token) {
+        if (!this.token) {
+            throw new Error("Token is required to construct user");
+        }
+        this.setUserToken(token);
+        try {
+            // Fetch all data concurrently with Promise.all
+            const [access, profileResult, identityResult] = await Promise.all([
+                this.accessRepo.client.getAccessList(),
+                this.profileRepo.client.getCurrentProfile(),
+                this.identityRepo.client.getUserCredentials(),
+            ]);
+            // Extract and validate response data
+            const accessList = this.accessRepo.handleResponse(access, 200);
+            const profileData = this.profileRepo.handleResponse(profileResult, 200);
+            const identityData = this.identityRepo.handleResponse(identityResult, 200);
+            // Create profile object
+            const profile = Profile.from(profileData);
+            if (!profile) {
+                throw new Error("Failed to create profile from response data");
+            }
+            // Construct and return user object
+            const user = User.from({
+                token: this.token,
+                profile,
+                access: accessList,
+                resetPassword: false,
+                ...identityData,
+            });
+            if (!user) {
+                throw new Error("Failed to construct user");
+            }
+            return user;
+        }
+        catch (error) {
+            const message = error instanceof Error
+                ? error.message
+                : "Unknown error occurred";
+            throw new Error(`Error constructing user: ${message}`);
+        }
+    }
+}

package/{dist → esm/src}/features/auth/storage/types.d.ts

@@ -1,4 +1,4 @@
-import type { User } from "@/models/user.model";
+import type { User } from "../../../models/user/index.js";
 /**
  * Interface defining the contract for auth storage implementations.
  * This allows for different storage strategies in different environments.
@@ -39,3 +39,4 @@ export interface TokenHandler {
      */
     clearToken(): void;
 }
+//# sourceMappingURL=types.d.ts.map

package/esm/src/features/auth/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,IAAI,IAAI,GAAG,SAAS,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS,CAAC;IAEnC;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/esm/src/features/auth/storage/types.js

@@ -0,0 +1 @@
+export {};

package/{dist/features/contact/contact.api-contract.d.ts → esm/src/features/contact/contract.d.ts}

@@ -9,61 +9,54 @@ import { z } from "zod";
  * @property {Object} deleteContact - Delete a contact (DELETE /:id)
  */
 export declare const contract: {
-    createContact: {
+    postContact: {
         method: "POST";
         body: z.ZodObject<{
             displayName: z.ZodString;
             accountNo: z.ZodString;
             channel: z.ZodString;
-            countryCode: z.ZodDefault<z.ZodString>;
-            type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-        }, "strip", z.ZodTypeAny, {
-            type: import("./contact.dtos").ContactType;
+            type: z.ZodEnum<["Bank", "Mobile"]>;
+        }, z.UnknownKeysParam, z.ZodTypeAny, {
+            type: "Bank" | "Mobile";
             displayName: string;
             accountNo: string;
             channel: string;
-            countryCode: string;
         }, {
-            type: import("./contact.dtos").ContactType;
+            type: "Bank" | "Mobile";
             displayName: string;
             accountNo: string;
             channel: string;
-            countryCode?: string | undefined;
         }>;
         path: "/";
         responses: {
             [x: number]: import("@ts-rest/core").AppRouteResponse;
             201: z.ZodObject<{
-                id: z.ZodString;
-                profileId: z.ZodString;
-                createdAt: z.ZodString;
-                updatedAt: z.ZodString;
-            } & {
                 displayName: z.ZodString;
                 accountNo: z.ZodString;
                 channel: z.ZodString;
-                countryCode: z.ZodDefault<z.ZodString>;
-                type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-            }, "strip", z.ZodTypeAny, {
-                type: import("./contact.dtos").ContactType;
+                type: z.ZodEnum<["Bank", "Mobile"]>;
+                id: z.ZodString;
+                profileId: z.ZodString;
+                createdAt: z.ZodDate;
+                updatedAt: z.ZodDate;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                countryCode: string;
-                createdAt: string;
-                updatedAt: string;
+                createdAt: Date;
+                updatedAt: Date;
             }, {
-                type: import("./contact.dtos").ContactType;
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                createdAt: string;
-                updatedAt: string;
-                countryCode?: string | undefined;
+                createdAt: Date;
+                updatedAt: Date;
             }>;
         };
     };
@@ -73,55 +66,48 @@ export declare const contract: {
             displayName: z.ZodString;
             accountNo: z.ZodString;
             channel: z.ZodString;
-            countryCode: z.ZodDefault<z.ZodString>;
-            type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-        }, "strip", z.ZodTypeAny, {
-            type: import("./contact.dtos").ContactType;
+            type: z.ZodEnum<["Bank", "Mobile"]>;
+        }, z.UnknownKeysParam, z.ZodTypeAny, {
+            type: "Bank" | "Mobile";
             displayName: string;
             accountNo: string;
             channel: string;
-            countryCode: string;
         }, {
-            type: import("./contact.dtos").ContactType;
+            type: "Bank" | "Mobile";
             displayName: string;
             accountNo: string;
             channel: string;
-            countryCode?: string | undefined;
         }>;
         path: "/:id";
         responses: {
             [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodObject<{
-                id: z.ZodString;
-                profileId: z.ZodString;
-                createdAt: z.ZodString;
-                updatedAt: z.ZodString;
-            } & {
                 displayName: z.ZodString;
                 accountNo: z.ZodString;
                 channel: z.ZodString;
-                countryCode: z.ZodDefault<z.ZodString>;
-                type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-            }, "strip", z.ZodTypeAny, {
-                type: import("./contact.dtos").ContactType;
+                type: z.ZodEnum<["Bank", "Mobile"]>;
+                id: z.ZodString;
+                profileId: z.ZodString;
+                createdAt: z.ZodDate;
+                updatedAt: z.ZodDate;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                countryCode: string;
-                createdAt: string;
-                updatedAt: string;
+                createdAt: Date;
+                updatedAt: Date;
             }, {
-                type: import("./contact.dtos").ContactType;
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                createdAt: string;
-                updatedAt: string;
-                countryCode?: string | undefined;
+                createdAt: Date;
+                updatedAt: Date;
             }>;
         };
     };
@@ -138,76 +124,33 @@ export declare const contract: {
         responses: {
             [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                profileId: z.ZodString;
-                createdAt: z.ZodString;
-                updatedAt: z.ZodString;
-            } & {
                 displayName: z.ZodString;
                 accountNo: z.ZodString;
                 channel: z.ZodString;
-                countryCode: z.ZodDefault<z.ZodString>;
-                type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-            }, "strip", z.ZodTypeAny, {
-                type: import("./contact.dtos").ContactType;
-                id: string;
-                displayName: string;
-                accountNo: string;
-                channel: string;
-                profileId: string;
-                countryCode: string;
-                createdAt: string;
-                updatedAt: string;
-            }, {
-                type: import("./contact.dtos").ContactType;
-                id: string;
-                displayName: string;
-                accountNo: string;
-                channel: string;
-                profileId: string;
-                createdAt: string;
-                updatedAt: string;
-                countryCode?: string | undefined;
-            }>, "many">;
-        };
-    };
-    getByID: {
-        method: "GET";
-        path: "/:id";
-        responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
-            200: z.ZodObject<{
+                type: z.ZodEnum<["Bank", "Mobile"]>;
                 id: z.ZodString;
                 profileId: z.ZodString;
-                createdAt: z.ZodString;
-                updatedAt: z.ZodString;
-            } & {
-                displayName: z.ZodString;
-                accountNo: z.ZodString;
-                channel: z.ZodString;
-                countryCode: z.ZodDefault<z.ZodString>;
-                type: z.ZodNativeEnum<typeof import("./contact.dtos").ContactType>;
-            }, "strip", z.ZodTypeAny, {
-                type: import("./contact.dtos").ContactType;
+                createdAt: z.ZodDate;
+                updatedAt: z.ZodDate;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                countryCode: string;
-                createdAt: string;
-                updatedAt: string;
+                createdAt: Date;
+                updatedAt: Date;
             }, {
-                type: import("./contact.dtos").ContactType;
+                type: "Bank" | "Mobile";
                 id: string;
                 displayName: string;
                 accountNo: string;
                 channel: string;
                 profileId: string;
-                createdAt: string;
-                updatedAt: string;
-                countryCode?: string | undefined;
-            }>;
+                createdAt: Date;
+                updatedAt: Date;
+            }>, "many">;
         };
     };
     deleteContact: {
@@ -224,3 +167,4 @@ export declare const contract: {
  * Export type for use in client implementations
  */
 export type ContactAPI = typeof contract;
+//# sourceMappingURL=contract.d.ts.map

package/esm/src/features/contact/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/src/features/contact/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCnB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,QAAQ,CAAC"}

package/esm/src/features/contact/contract.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { initContract } from "@ts-rest/core";
+import { commonAPIResponses } from "../../shared/index.js";
+import { ContactSchemas } from "../../models/index.js";
+/**
+ * Contact API contract
+ * Defines the REST endpoints for managing contacts
+ *
+ * @property {Object} postContact - Create a new contact (POST /)
+ * @property {Object} editContact - Update an existing contact (PATCH /:id)
+ * @property {Object} getContacts - Retrieve contacts list (GET /)
+ * @property {Object} deleteContact - Delete a contact (DELETE /:id)
+ */
+export const contract = initContract().router({
+    postContact: {
+        method: "POST",
+        path: "/",
+        body: ContactSchemas.contactInput,
+        responses: {
+            201: ContactSchemas.contactData,
+        },
+    },
+    editContact: {
+        method: "PATCH",
+        path: "/:id",
+        body: ContactSchemas.contactInput,
+        responses: {
+            200: ContactSchemas.contactData,
+        },
+    },
+    getContacts: {
+        method: "GET",
+        path: "/",
+        query: z.object({ orderByDesc: z.string() }),
+        responses: {
+            200: z.array(ContactSchemas.contactData),
+        },
+    },
+    deleteContact: {
+        method: "DELETE",
+        path: "/:id",
+        body: z.object({}),
+        responses: {
+            200: z.object({}),
+        },
+    },
+}, {
+    commonResponses: commonAPIResponses,
+});

package/esm/src/features/contact/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./repository.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/features/contact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/features/contact/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/esm/src/features/contact/index.js

@@ -0,0 +1 @@
+export * from "./repository.js";

package/esm/src/features/contact/repository.d.ts

@@ -0,0 +1,58 @@
+import { BaseRepository } from "../../shared/base_repository.js";
+import { contract } from "./contract.js";
+import { Contact, type ContactInput } from "../../models/contact/index.js";
+import type { AfloatAuth } from "../auth/manager.js";
+/**
+ * Repository class for managing `Contact` data through API interactions.
+ * Extends the `BaseRepository` to leverage shared functionality.
+ */
+export declare class ContactRepository extends BaseRepository<typeof contract> {
+    /**
+     * Creates an instance of `ContactRepository` using the contact contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
+     * @param {string} [props.root] - Optional API root URL
+     */
+    constructor(props?: {
+        auth?: AfloatAuth;
+        root?: string;
+    });
+    /**
+     * Creates a new contact record.
+     * @param {ContactInput} input - The data required to create a new contact.
+     * @returns {Promise<Contact>} A promise that resolves to the newly created contact.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 201.
+     */
+    create(input: ContactInput): Promise<Contact>;
+    /**
+     * Updates an existing contact record by ID.
+     * @param {string} id - The unique identifier of the contact to edit.
+     * @param {ContactInput} input - The data to update the contact with.
+     * @returns {Promise<Contact>} A promise that resolves to the updated contact.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200.
+     */
+    edit(id: string, input: ContactInput): Promise<Contact>;
+    /**
+     * Deletes a contact record by ID.
+     * @param {string} id - The unique identifier of the contact to remove.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200.
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Retrieves all contacts
+     * Results are ordered in descending order by default.
+     *
+     * @returns {Promise<Contact[]>} A promise that resolves to an array of contacts.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200 or the range is invalid.
+     * @example
+     * const repository = new ContactRepository();
+     * repository.getAll().then(contacts => console.log(contacts));
+     */
+    getAll(): Promise<Contact[]>;
+}
+//# sourceMappingURL=repository.d.ts.map

package/esm/src/features/contact/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/contact/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,OAAO,EAEP,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IACpE;;;;;OAKG;gBACS,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAIxD;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBnD;;;;;;;OAOG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB7D;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevC;;;;;;;;;;OAUG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAgBnC"}

package/esm/src/features/contact/repository.js

@@ -0,0 +1,108 @@
+import { BaseRepository } from "../../shared/base_repository.js";
+import { contract } from "./contract.js";
+import { Contact, } from "../../models/contact/index.js";
+import { Permissions } from "../../models/index.js";
+import { PermissionError } from "../../errors/index.js";
+/**
+ * Repository class for managing `Contact` data through API interactions.
+ * Extends the `BaseRepository` to leverage shared functionality.
+ */
+export class ContactRepository extends BaseRepository {
+    /**
+     * Creates an instance of `ContactRepository` using the contact contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
+     * @param {string} [props.root] - Optional API root URL
+     */
+    constructor(props) {
+        super("contact", contract, props);
+    }
+    /**
+     * Creates a new contact record.
+     * @param {ContactInput} input - The data required to create a new contact.
+     * @returns {Promise<Contact>} A promise that resolves to the newly created contact.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 201.
+     */
+    async create(input) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Create;
+        if (!auth.checkPermission(requiredPerm)) {
+            throw new PermissionError({
+                message: "You are not authorized to add contacts.",
+                requiredPermissions: [requiredPerm],
+            });
+        }
+        const result = await this.client.postContact({ body: input });
+        const data = this.handleResponse(result, 201);
+        return Contact.create(data);
+    }
+    /**
+     * Updates an existing contact record by ID.
+     * @param {string} id - The unique identifier of the contact to edit.
+     * @param {ContactInput} input - The data to update the contact with.
+     * @returns {Promise<Contact>} A promise that resolves to the updated contact.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200.
+     */
+    async edit(id, input) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Update;
+        if (!auth.checkPermission(requiredPerm)) {
+            throw new PermissionError({
+                message: "You are not authorized to update contacts.",
+                requiredPermissions: [requiredPerm],
+            });
+        }
+        const result = await this.client.editContact({
+            params: { id },
+            body: input,
+        });
+        const data = this.handleResponse(result, 200);
+        return Contact.create(data);
+    }
+    /**
+     * Deletes a contact record by ID.
+     * @param {string} id - The unique identifier of the contact to remove.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200.
+     */
+    async remove(id) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Delete;
+        if (!auth.checkPermission(requiredPerm)) {
+            throw new PermissionError({
+                message: "You are not authorized to delete contacts.",
+                requiredPermissions: [requiredPerm],
+            });
+        }
+        const result = await this.client.deleteContact({ params: { id } });
+        this.handleResponse(result, 200);
+    }
+    /**
+     * Retrieves all contacts
+     * Results are ordered in descending order by default.
+     *
+     * @returns {Promise<Contact[]>} A promise that resolves to an array of contacts.
+     * @throws {PermissionError} If the user lacks required permissions
+     * @throws {APIError} If the response status code is not 200 or the range is invalid.
+     * @example
+     * const repository = new ContactRepository();
+     * repository.getAll().then(contacts => console.log(contacts));
+     */
+    async getAll() {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.List;
+        if (!auth.checkPermission(requiredPerm)) {
+            throw new PermissionError({
+                message: "You are not authorized to view contacts.",
+                requiredPermissions: [requiredPerm],
+            });
+        }
+        const query = { orderByDesc: "createdAt" };
+        const result = await this.client.getContacts({ query });
+        const data = this.handleResponse(result, 200);
+        return Contact.createMany(data);
+    }
+}