@fiado/api-invoker 4.5.0 → 4.7.0

package/src/account-pagoconfiado/AccountPagoConfiadoApi.ts

@@ -1,79 +1,79 @@
-import {IAccountPagoConfiadoApi} from "./interfaces/IAccountPagoConfiadoApi";
-import {AccountCreateRequest, AccountCreateResponse, AccountUpdateBalanceRequest, AccountUpdateRequest, GetAccountResponse, GetAccountResponseList} from "@fiado/type-kit/bin/account";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import { Provider } from "@fiado/type-kit/bin/provider";
-
-@injectable()
-export default class AccountPagoConfiadoApi implements IAccountPagoConfiadoApi {
-    private readonly baseUrl = process.env.ACCOUNT_PAGOCONFIADO_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}    
-
-    async cancelAccount(directoryId:string,accountNumber?: string, documentNumber?: string): Promise<ApiGatewayResponse<void>> {
-        const url = `${this.baseUrl}/cancel`;
-        return await this.httpRequest.post(url, {directoryId,accountNumber,documentNumber});
-    }
-
-    async createAccount(provider: Provider, data: AccountCreateRequest): Promise<ApiGatewayResponse<AccountCreateResponse>> {
-        const url = `${this.baseUrl}`;
-        return await this.httpRequest.post(url, data);
-    }
-
-    async getAccountByDirectoryId(directoryId: string): Promise<ApiGatewayResponse<GetAccountResponse[]>> {
-        const url = `${this.baseUrl}users/${directoryId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async updateAccountBalance(accountId:string, params: AccountUpdateBalanceRequest): Promise<ApiGatewayResponse<Boolean>> {
-        const url = `${this.baseUrl}${accountId}/balance`;
-        return await this.httpRequest.put(url,params);
-    }
-
-    async update(directoryId: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>> {
-        const url = `${this.baseUrl}users/${directoryId}`;
-        return await this.httpRequest.put(url, data);
-    }
-
-    async updateByAccountNumber(accountNumber: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>> {
-        const url = `${this.baseUrl}users/accountNumber/${accountNumber}`;
-        return await this.httpRequest.put(url, data);
-    }
-
-    async getAccountByAccountNumber(accountNumber: string): Promise<ApiGatewayResponse<void>> {
-        const url = `${this.baseUrl}users/accountNumber/${accountNumber}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getAccountListByDateMinorOrEqual(params: { index?: string | null; pageSize?: string; date?: string; }): Promise<ApiGatewayResponse<any>> {
-
-        let queryParams = [];
-
-        if (params.index) {
-            queryParams.push(`index=${params.index}`);
-        }
-
-        if (params.pageSize) {
-            queryParams.push(`pageSize=${params.pageSize}`);
-        }
-
-        if (params.date) {
-            queryParams.push(`date=${params.date}`);
-        }
-
-        const url = `${this.baseUrl}?${queryParams.join('&')}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async scanAccountsByDateRange(startDate: number, endDate: number, limit?: number, lastEvaluatedKey?: string): Promise<ApiGatewayResponse<GetAccountResponseList>> {
-        const queryParams = new URLSearchParams();
-        queryParams.append('startDate', startDate.toString());
-        queryParams.append('endDate', endDate.toString());
-        if (limit) queryParams.append('limit', limit.toString());
-        if (lastEvaluatedKey) queryParams.append('lastEvaluatedKey', lastEvaluatedKey);
-
-        const url = `${this.baseUrl}accounts/scan/by-date-range?${queryParams.toString()}`;
-        return await this.httpRequest.get(url);
-    }
+import {IAccountPagoConfiadoApi} from "./interfaces/IAccountPagoConfiadoApi";
+import {AccountCreateRequest, AccountCreateResponse, AccountUpdateBalanceRequest, AccountUpdateRequest, GetAccountResponse, GetAccountResponseList} from "@fiado/type-kit/bin/account";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import { Provider } from "@fiado/type-kit/bin/provider";
+
+@injectable()
+export default class AccountPagoConfiadoApi implements IAccountPagoConfiadoApi {
+    private readonly baseUrl = process.env.ACCOUNT_PAGOCONFIADO_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}    
+
+    async cancelAccount(directoryId:string,accountNumber?: string, documentNumber?: string): Promise<ApiGatewayResponse<void>> {
+        const url = `${this.baseUrl}/cancel`;
+        return await this.httpRequest.post(url, {directoryId,accountNumber,documentNumber});
+    }
+
+    async createAccount(provider: Provider, data: AccountCreateRequest): Promise<ApiGatewayResponse<AccountCreateResponse>> {
+        const url = `${this.baseUrl}`;
+        return await this.httpRequest.post(url, data);
+    }
+
+    async getAccountByDirectoryId(directoryId: string): Promise<ApiGatewayResponse<GetAccountResponse[]>> {
+        const url = `${this.baseUrl}users/${directoryId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async updateAccountBalance(accountId:string, params: AccountUpdateBalanceRequest): Promise<ApiGatewayResponse<Boolean>> {
+        const url = `${this.baseUrl}${accountId}/balance`;
+        return await this.httpRequest.put(url,params);
+    }
+
+    async update(directoryId: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>> {
+        const url = `${this.baseUrl}users/${directoryId}`;
+        return await this.httpRequest.put(url, data);
+    }
+
+    async updateByAccountNumber(accountNumber: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>> {
+        const url = `${this.baseUrl}users/accountNumber/${accountNumber}`;
+        return await this.httpRequest.put(url, data);
+    }
+
+    async getAccountByAccountNumber(accountNumber: string): Promise<ApiGatewayResponse<void>> {
+        const url = `${this.baseUrl}users/accountNumber/${accountNumber}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getAccountListByDateMinorOrEqual(params: { index?: string | null; pageSize?: string; date?: string; }): Promise<ApiGatewayResponse<any>> {
+
+        let queryParams = [];
+
+        if (params.index) {
+            queryParams.push(`index=${params.index}`);
+        }
+
+        if (params.pageSize) {
+            queryParams.push(`pageSize=${params.pageSize}`);
+        }
+
+        if (params.date) {
+            queryParams.push(`date=${params.date}`);
+        }
+
+        const url = `${this.baseUrl}?${queryParams.join('&')}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async scanAccountsByDateRange(startDate: number, endDate: number, limit?: number, lastEvaluatedKey?: string): Promise<ApiGatewayResponse<GetAccountResponseList>> {
+        const queryParams = new URLSearchParams();
+        queryParams.append('startDate', startDate.toString());
+        queryParams.append('endDate', endDate.toString());
+        if (limit) queryParams.append('limit', limit.toString());
+        if (lastEvaluatedKey) queryParams.append('lastEvaluatedKey', lastEvaluatedKey);
+
+        const url = `${this.baseUrl}accounts/scan/by-date-range?${queryParams.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/account-pagoconfiado/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IAccountPagoConfiadoApi';
-export * from './AccountPagoConfiadoApi';
+export * from './interfaces/IAccountPagoConfiadoApi';
+export * from './AccountPagoConfiadoApi';

package/src/account-pagoconfiado/interfaces/IAccountPagoConfiadoApi.ts

@@ -1,38 +1,38 @@
-import {
-    AccountCreateRequest,
-    AccountCreateResponse,
-    AccountUpdateBalanceRequest,
-    AccountUpdateRequest,
-    GetAccountResponse,
-    GetAccountResponseList
-} from "@fiado/type-kit/bin/account";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import { Provider } from "@fiado/type-kit/bin/provider";
-
-
-export interface IAccountPagoConfiadoApi {
-    createAccount(provider: Provider, data: AccountCreateRequest): Promise<ApiGatewayResponse<AccountCreateResponse>>;
-
-    getAccountByDirectoryId(directoryId: string, provider: string): Promise<ApiGatewayResponse<GetAccountResponse[]>>;
-
-    updateAccountBalance(accountId: string, params: AccountUpdateBalanceRequest): Promise<ApiGatewayResponse<Boolean>>;
-
-    update(directoryId: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>>;
-
-    updateByAccountNumber(accountNumber: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>>;
-
-    getAccountByAccountNumber(accountNumber: string): Promise<ApiGatewayResponse<void>>;
-
-    cancelAccount(directoryId: string, accountNumber?: string, documentNumber?: string): Promise<ApiGatewayResponse<void>>;
-
-    getAccountListByDateMinorOrEqual(
-        params: {
-
-            index?: string | null,
-            pageSize?: string,
-            date?: string,
-        }
-    ): Promise<ApiGatewayResponse<any>>;
-
-    scanAccountsByDateRange(startDate: number, endDate: number, limit?: number, lastEvaluatedKey?: string): Promise<ApiGatewayResponse<GetAccountResponseList>>;
+import {
+    AccountCreateRequest,
+    AccountCreateResponse,
+    AccountUpdateBalanceRequest,
+    AccountUpdateRequest,
+    GetAccountResponse,
+    GetAccountResponseList
+} from "@fiado/type-kit/bin/account";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { Provider } from "@fiado/type-kit/bin/provider";
+
+
+export interface IAccountPagoConfiadoApi {
+    createAccount(provider: Provider, data: AccountCreateRequest): Promise<ApiGatewayResponse<AccountCreateResponse>>;
+
+    getAccountByDirectoryId(directoryId: string, provider: string): Promise<ApiGatewayResponse<GetAccountResponse[]>>;
+
+    updateAccountBalance(accountId: string, params: AccountUpdateBalanceRequest): Promise<ApiGatewayResponse<Boolean>>;
+
+    update(directoryId: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>>;
+
+    updateByAccountNumber(accountNumber: string, data: AccountUpdateRequest): Promise<ApiGatewayResponse<void>>;
+
+    getAccountByAccountNumber(accountNumber: string): Promise<ApiGatewayResponse<void>>;
+
+    cancelAccount(directoryId: string, accountNumber?: string, documentNumber?: string): Promise<ApiGatewayResponse<void>>;
+
+    getAccountListByDateMinorOrEqual(
+        params: {
+
+            index?: string | null,
+            pageSize?: string,
+            date?: string,
+        }
+    ): Promise<ApiGatewayResponse<any>>;
+
+    scanAccountsByDateRange(startDate: number, endDate: number, limit?: number, lastEvaluatedKey?: string): Promise<ApiGatewayResponse<GetAccountResponseList>>;
 }

package/src/activity-business/ActivityApi.ts

@@ -1,36 +1,36 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { inject, injectable } from "inversify";
-import { IActivityApi } from "./interfaces/IActivityApi";
-
-@injectable()
-export default class ActivityApi implements IActivityApi {
-
-    private readonly baseUrl = process.env.ACTIVITY_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-    async correctCounters(): Promise<any> {
-        const url = `${this.baseUrl}activities/counters/correct`;
-        return await this.httpRequest.post(url);
-    }
-    async findByDirectoriesList(directories: string[]): Promise<any> {
-        const url = `${this.baseUrl}activities/history/directories/?directories=${directories.join(',')}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getActivityByDirectoryId(directoryId: string, typeOfActivityIds: string[], table: "PRINCIPAL" | "DETAIL" = "PRINCIPAL"): Promise<any> {
-        const typeOfActivityQuery = typeOfActivityIds.map(id => `typeOfActivity=${encodeURIComponent(id)}`).join('&');
-        const url = `${this.baseUrl}activities/directory/${directoryId}?${typeOfActivityQuery}&table=${table}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getActivityById(typeOfActivityIds: string[]): Promise<any> {
-        const query = typeOfActivityIds.map(id => `typeOfActivity=${encodeURIComponent(id)}`).join('&');
-        const url = `${this.baseUrl}activities?${query}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getActivityHistory(typeOfActivity: string, startDate: string, endDate: string): Promise<any> {
-        const url = `${this.baseUrl}activities/history?typeOfActivity=${typeOfActivity}&startDate=${startDate}&endDate=${endDate}`;
-        return await this.httpRequest.get(url);
-    }
-}
+import { IHttpRequest } from "@fiado/http-client";
+import { inject, injectable } from "inversify";
+import { IActivityApi } from "./interfaces/IActivityApi";
+
+@injectable()
+export default class ActivityApi implements IActivityApi {
+
+    private readonly baseUrl = process.env.ACTIVITY_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+    async correctCounters(): Promise<any> {
+        const url = `${this.baseUrl}activities/counters/correct`;
+        return await this.httpRequest.post(url);
+    }
+    async findByDirectoriesList(directories: string[]): Promise<any> {
+        const url = `${this.baseUrl}activities/history/directories/?directories=${directories.join(',')}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getActivityByDirectoryId(directoryId: string, typeOfActivityIds: string[], table: "PRINCIPAL" | "DETAIL" = "PRINCIPAL"): Promise<any> {
+        const typeOfActivityQuery = typeOfActivityIds.map(id => `typeOfActivity=${encodeURIComponent(id)}`).join('&');
+        const url = `${this.baseUrl}activities/directory/${directoryId}?${typeOfActivityQuery}&table=${table}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getActivityById(typeOfActivityIds: string[]): Promise<any> {
+        const query = typeOfActivityIds.map(id => `typeOfActivity=${encodeURIComponent(id)}`).join('&');
+        const url = `${this.baseUrl}activities?${query}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getActivityHistory(typeOfActivity: string, startDate: string, endDate: string): Promise<any> {
+        const url = `${this.baseUrl}activities/history?typeOfActivity=${typeOfActivity}&startDate=${startDate}&endDate=${endDate}`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/activity-business/index.ts

@@ -1,6 +1,6 @@
-
-
-export * from './interfaces/IActivityApi';
-export * from './queue/IActivityPublisher';
-export * from './queue/ActivityPublisher';
+
+
+export * from './interfaces/IActivityApi';
+export * from './queue/IActivityPublisher';
+export * from './queue/ActivityPublisher';
 export * from './ActivityApi';

package/src/activity-business/interfaces/IActivityApi.ts

@@ -1,14 +1,14 @@
-
-
-export interface IActivityApi {
-
-    getActivityByDirectoryId(directoryId: string, typeOfActivityIds: string[], table?: "PRINCIPAL" | "DETAIL"): Promise<any>
-
-    getActivityById(typeOfActivityIds: string[]): Promise<any>
-
-    getActivityHistory(typeOfActivity: string, startDate: string, endDate: string): Promise<any>
-
-    findByDirectoriesList(directories: string[]): Promise<any>
-
-    correctCounters(): Promise<any>
+
+
+export interface IActivityApi {
+
+    getActivityByDirectoryId(directoryId: string, typeOfActivityIds: string[], table?: "PRINCIPAL" | "DETAIL"): Promise<any>
+
+    getActivityById(typeOfActivityIds: string[]): Promise<any>
+
+    getActivityHistory(typeOfActivity: string, startDate: string, endDate: string): Promise<any>
+
+    findByDirectoriesList(directories: string[]): Promise<any>
+
+    correctCounters(): Promise<any>
 }

package/src/activity-business/queue/ActivityPublisher.ts

@@ -1,30 +1,30 @@
-import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
-import { ActivityQueueMessage } from "@fiado/type-kit/bin/activity";
-import { injectable } from "inversify";
-import { IActivityPublisher } from "./IActivityPublisher";
-
-
-@injectable()
-export default class ActivityPublisher implements IActivityPublisher {
-    private readonly ACTIVITY_QUEUE = process.env.ACTIVITY_QUEUE;
-
-    async publish(message: ActivityQueueMessage): Promise<void> {
-        try {
-
-            const desduplicationId = `${message.message.directoryId}|${message.message.typeOfActivity}|${message.message.date}`;
-
-            const client: SQSClient = new SQSClient();
-            const sendMessageRequest: SendMessageRequest = {
-                QueueUrl: this.ACTIVITY_QUEUE,
-                MessageBody: JSON.stringify(message),
-                MessageGroupId: message.message.directoryId,
-                MessageDeduplicationId: desduplicationId
-            };
-            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
-            await client.send(command);
-        } catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
-        }
-    }
-}
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { ActivityQueueMessage } from "@fiado/type-kit/bin/activity";
+import { injectable } from "inversify";
+import { IActivityPublisher } from "./IActivityPublisher";
+
+
+@injectable()
+export default class ActivityPublisher implements IActivityPublisher {
+    private readonly ACTIVITY_QUEUE = process.env.ACTIVITY_QUEUE;
+
+    async publish(message: ActivityQueueMessage): Promise<void> {
+        try {
+
+            const desduplicationId = `${message.message.directoryId}|${message.message.typeOfActivity}|${message.message.date}`;
+
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.ACTIVITY_QUEUE,
+                MessageBody: JSON.stringify(message),
+                MessageGroupId: message.message.directoryId,
+                MessageDeduplicationId: desduplicationId
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
+        }
+    }
+}

package/src/activity-business/queue/IActivityPublisher.ts

@@ -1,5 +1,5 @@
-import { ActivityQueueMessage } from "@fiado/type-kit/bin/activity";
-
-export interface IActivityPublisher {
-    publish(message: ActivityQueueMessage): Promise<void>
+import { ActivityQueueMessage } from "@fiado/type-kit/bin/activity";
+
+export interface IActivityPublisher {
+    publish(message: ActivityQueueMessage): Promise<void>
 }

package/src/address/AddressApi.ts

@@ -1,47 +1,47 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { AddressCreateRequest, AddressShippingCardResponse } from "@fiado/type-kit/bin/address";
-import { inject, injectable } from "inversify";
-import { IAddressApi } from "./interfaces/IAddressApi";
-
-
-@injectable()
-export class AddressApi implements IAddressApi {
-
-    private readonly baseUrl = process.env.ADDRESS_LAMBDA_URL || "";
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-
-    async getByDirectoryId(directoryId: string): Promise<any> {
-
-        this.validateBaseUrl();
-        this.validateDirectoryId(directoryId);
-
-        const url = `${this.baseUrl}users/${directoryId}`;
-
-        return await this.httpRequest.get(`${url}`, undefined);
-    }
-
-    async create(directoryId: string, address: AddressCreateRequest): Promise<void> {
-        this.validateBaseUrl();
-        this.validateDirectoryId(directoryId);
-        const url = `${this.baseUrl}users/${directoryId}`;
-        await this.httpRequest.post<void>(url, address);
-    }
-
-    async getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> {
-        this.validateBaseUrl();
-        const url = `${this.baseUrl}shipping`;
-        return await this.httpRequest.post<AddressShippingCardResponse>(url, { directoryId });
-    }
-
-    private validateBaseUrl() {
-        if (!this.baseUrl) {
-            throw new Error("Environment variable ADDRESS_LAMBDA_URL value not found");
-        }
-    }
-
-    private validateDirectoryId(directoryId: string) {
-        if (!directoryId) {
-            throw new Error("Directory ID is required.");
-        }
-    }
+import { IHttpRequest } from "@fiado/http-client";
+import { AddressCreateRequest, AddressShippingCardResponse } from "@fiado/type-kit/bin/address";
+import { inject, injectable } from "inversify";
+import { IAddressApi } from "./interfaces/IAddressApi";
+
+
+@injectable()
+export class AddressApi implements IAddressApi {
+
+    private readonly baseUrl = process.env.ADDRESS_LAMBDA_URL || "";
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+
+    async getByDirectoryId(directoryId: string): Promise<any> {
+
+        this.validateBaseUrl();
+        this.validateDirectoryId(directoryId);
+
+        const url = `${this.baseUrl}users/${directoryId}`;
+
+        return await this.httpRequest.get(`${url}`, undefined);
+    }
+
+    async create(directoryId: string, address: AddressCreateRequest): Promise<void> {
+        this.validateBaseUrl();
+        this.validateDirectoryId(directoryId);
+        const url = `${this.baseUrl}users/${directoryId}`;
+        await this.httpRequest.post<void>(url, address);
+    }
+
+    async getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> {
+        this.validateBaseUrl();
+        const url = `${this.baseUrl}shipping`;
+        return await this.httpRequest.post<AddressShippingCardResponse>(url, { directoryId });
+    }
+
+    private validateBaseUrl() {
+        if (!this.baseUrl) {
+            throw new Error("Environment variable ADDRESS_LAMBDA_URL value not found");
+        }
+    }
+
+    private validateDirectoryId(directoryId: string) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+    }
 }

package/src/address/index.ts

@@ -1,4 +1,4 @@
-
-
-export * from './interfaces/IAddressApi';
+
+
+export * from './interfaces/IAddressApi';
 export * from './AddressApi';

package/src/address/interfaces/IAddressApi.ts

@@ -1,31 +1,31 @@
-import { AddressCreateRequest, AddressResponse, AddressShippingCardResponse } from "@fiado/type-kit/bin/address";
-
-export interface IAddressApi {
-
-    /**
-     * Obtiene una lista de direcciones por su ID de directorio.
-     * @param directoryId ID de directorio (UUID) a buscar.
-     * @returns Una promesa que resuelve a un arreglo de objetos de dirección.
-     * Puede devolver un arreglo vacío si no se encuentran coincidencias.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getByDirectoryId(directoryId: string): Promise<AddressResponse[]>;
-
-    /**
-     * Crea una nueva dirección para un directorio.
-     * @param directoryId ID de directorio (UUID) a buscar.
-     * @param address Objeto de dirección a crear.
-     * @returns Una promesa que resuelve a void.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    create(directoryId: string, address: AddressCreateRequest): Promise<void>;
-
-    /**
-     * Obtiene la dirección de envío de una tarjeta.
-     * @param input Objeto de solicitud de dirección de envío.
-     * @returns Una promesa que resuelve a un objeto de respuesta de dirección de envío.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> 
-
+import { AddressCreateRequest, AddressResponse, AddressShippingCardResponse } from "@fiado/type-kit/bin/address";
+
+export interface IAddressApi {
+
+    /**
+     * Obtiene una lista de direcciones por su ID de directorio.
+     * @param directoryId ID de directorio (UUID) a buscar.
+     * @returns Una promesa que resuelve a un arreglo de objetos de dirección.
+     * Puede devolver un arreglo vacío si no se encuentran coincidencias.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getByDirectoryId(directoryId: string): Promise<AddressResponse[]>;
+
+    /**
+     * Crea una nueva dirección para un directorio.
+     * @param directoryId ID de directorio (UUID) a buscar.
+     * @param address Objeto de dirección a crear.
+     * @returns Una promesa que resuelve a void.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    create(directoryId: string, address: AddressCreateRequest): Promise<void>;
+
+    /**
+     * Obtiene la dirección de envío de una tarjeta.
+     * @param input Objeto de solicitud de dirección de envío.
+     * @returns Una promesa que resuelve a un objeto de respuesta de dirección de envío.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> 
+
 }